@ciphore/radiocli 0.1.8 → 0.2.0

package/dist/ui/screen-items.js

@@ -23,6 +23,7 @@ export const settingsItems = [
     'Transparent background',
     'ASCII-safe display',
     'Reduce motion',
+    'Check for updates',
     'Refresh provider health',
     'Learn previous media key',
     'Learn play/pause media key',

package/dist/ui/screens/CountriesScreen.js

@@ -4,7 +4,13 @@ import { Menu, Pointer } from '../components/Menu.js';
 import { ScreenHeader } from '../components/ScreenHeader.js';
 import { textMuted, themeAccent } from '../theme.js';
 import { visibleWindow } from '../list-window.js';
+import { truncate } from '../format.js';
 export function CountriesScreen({ countries, selected, loading, filter, editingFilter, theme, pageSize, width }) {
     const window = visibleWindow(countries, selected, pageSize);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Countries", subtitle: editingFilter ? 'Filtering countries — type to narrow the list' : 'Browse the worldwide country directory', width: width, theme: theme, right: `filter: ${filter || 'all'}` }), loading ? _jsx(Text, { color: textMuted, children: "Loading countries from Radio Browser\u2026" }) : null, !loading ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: textMuted, children: ["Showing ", countries.length ? window.start + 1 : 0, "-", window.end, " of ", countries.length] }), _jsx(Menu, { items: window.items, selected: selected - window.start, keyFor: country => country.code, render: (country, _index, active) => (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsx(Text, { color: active ? themeAccent(theme) : undefined, bold: active, children: country.name }), _jsxs(Text, { color: textMuted, children: [" \u00B7 ", country.code, " \u00B7 ", country.stationCount.toLocaleString(), " stations"] })] })) })] })) : null] }));
+    const rowWidth = Math.max(24, width - 2);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Countries", subtitle: editingFilter ? 'Filtering countries — type to narrow the list' : 'Browse the worldwide country directory', width: width, theme: theme, right: `filter: ${filter || 'all'}` }), loading ? _jsx(Text, { color: textMuted, children: "Loading countries from Radio Browser\u2026" }) : null, !loading ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: textMuted, children: ["Showing ", countries.length ? window.start + 1 : 0, "-", window.end, " of ", countries.length] }), _jsx(Menu, { items: window.items, selected: selected - window.start, keyFor: country => country.code, render: (country, _index, active) => {
+                            const meta = ` · ${country.code} · ${country.stationCount.toLocaleString()} stations`;
+                            const nameWidth = Math.max(4, rowWidth - 2 - meta.length);
+                            return (_jsxs(Box, { height: 1, width: rowWidth, children: [_jsx(Pointer, { active: active }), _jsx(Text, { color: active ? themeAccent(theme) : undefined, bold: active, children: truncate(country.name, nameWidth) }), _jsx(Text, { color: textMuted, children: truncate(meta, Math.max(0, rowWidth - 2 - nameWidth)) })] }));
+                        } })] })) : null] }));
 }

package/dist/ui/screens/SettingsScreen.js

@@ -8,16 +8,35 @@ import { textMuted, themeAccent } from '../theme.js';
 import { playbackBackendCapabilities } from '../../player/backend-install.js';
 import { airPlayReceiverSettingValue } from '../airplay-settings.js';
 import { audioOutputLabel, audioOutputSettingValue } from '../audio-output.js';
-export function SettingsScreen({ selected, settings, storePath, playback, backends, airPlayDevices, providerHealth, theme, diagnostics, width }) {
+import { updateStatusText } from '../../update-check.js';
+export function SettingsScreen({ selected, settings, appVersion, updateCheck, storePath, playback, backends, airPlayDevices, providerHealth, theme, diagnostics, width, height }) {
     const accent = themeAccent(theme);
     const lineWidth = Math.max(32, width - 4);
     const health = Object.entries(providerHealth);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Settings", subtitle: "Enter changes the highlighted setting \u00B7 shortcuts in the footer", width: width, theme: theme }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Menu, { items: settingsItems, selected: selected, keyFor: item => item, render: (item, _index, active) => {
-                        const value = settingValue(item, settings, diagnostics, backends, airPlayDevices);
-                        return (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsx(Text, { color: active ? accent : undefined, bold: active, children: item }), value ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: textMuted, children: " \u00B7 " }), _jsx(Text, { color: accent, children: value })] })) : null] }));
-                    } }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, bold: true, children: "Status" }), _jsxs(Text, { color: textMuted, children: ["Output: ", _jsx(Text, { color: accent, children: audioOutputLabel(playback.backend) }), " / ", playback.state, " \u00B7", ' ', "Selected: ", _jsx(Text, { color: accent, children: audioOutputLabel(settings.preferredBackend) }), " \u00B7", ' ', diagnostics.muted ? 'muted' : `vol ${diagnostics.volume}`, " \u00B7 tune timeout ", settings.tuneTimeoutSeconds, "s"] }), _jsxs(Text, { color: textMuted, children: ["Provider health: ", health.length ? health.map(([provider, status]) => `${provider} ${status}`).join(' · ') : 'not checked yet'] }), _jsxs(Text, { color: textMuted, children: ["Active stream: ", truncate(diagnostics.streamUrl ?? 'none', lineWidth - 15)] }), _jsxs(Text, { color: textMuted, children: ["Library: ", truncate(storePath, lineWidth - 9)] })] })] }));
+    const menuWindow = settingsMenuWindow(selected, height);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Settings", subtitle: "Enter changes the highlighted setting \u00B7 shortcuts in the footer", width: width, theme: theme }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Menu, { items: menuWindow.items, selected: selected - menuWindow.start, keyFor: ({ item }) => item, render: (item, _index, active) => {
+                        const label = settingLabel(item.item, updateCheck);
+                        const value = settingValue(item.item, settings, diagnostics, backends, airPlayDevices, updateCheck);
+                        return (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsx(Text, { color: active ? accent : undefined, bold: active, children: label }), value ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: textMuted, children: " \u00B7 " }), _jsx(Text, { color: accent, children: value })] })) : null] }));
+                    } }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, bold: true, children: "Status" }), _jsxs(Text, { color: textMuted, children: ["Output: ", _jsx(Text, { color: accent, children: audioOutputLabel(playback.backend) }), " / ", playback.state, " \u00B7", ' ', "Selected: ", _jsx(Text, { color: accent, children: audioOutputLabel(settings.preferredBackend) }), " \u00B7", ' ', diagnostics.muted ? 'muted' : `vol ${diagnostics.volume}`, " \u00B7 tune timeout ", settings.tuneTimeoutSeconds, "s"] }), _jsxs(Text, { color: textMuted, children: ["Provider health: ", health.length ? health.map(([provider, status]) => `${provider} ${status}`).join(' · ') : 'not checked yet'] }), _jsxs(Text, { color: textMuted, children: ["Version: ", _jsxs(Text, { color: accent, children: ["v", appVersion] }), " \u00B7 Update: ", updateStatusText(updateCheck)] }), _jsxs(Text, { color: textMuted, children: ["Active stream: ", truncate(diagnostics.streamUrl ?? 'none', lineWidth - 15)] }), _jsxs(Text, { color: textMuted, children: ["Library: ", truncate(storePath, lineWidth - 9)] })] })] }));
 }
-function settingValue(item, settings, diagnostics, backends, airPlayDevices) {
+function settingsMenuWindow(selected, height) {
+    if (!height) {
+        return { start: 0, items: settingsItems.map(item => ({ item })) };
+    }
+    const reservedRows = 10;
+    const maxRows = Math.max(5, height - reservedRows);
+    if (settingsItems.length <= maxRows) {
+        return { start: 0, items: settingsItems.map(item => ({ item })) };
+    }
+    const clampedSelected = Math.min(Math.max(selected, 0), settingsItems.length - 1);
+    const start = Math.min(Math.floor(clampedSelected / maxRows) * maxRows, Math.max(0, settingsItems.length - maxRows));
+    return {
+        start,
+        items: settingsItems.slice(start, start + maxRows).map(item => ({ item }))
+    };
+}
+function settingValue(item, settings, diagnostics, backends, airPlayDevices, updateCheck) {
     switch (item) {
         case 'Cycle display color':
             return settings.theme;
@@ -46,9 +65,17 @@ function settingValue(item, settings, diagnostics, backends, airPlayDevices) {
             return settings.asciiMode ? 'on' : 'off';
         case 'Reduce motion':
             return settings.reduceMotion ? 'on' : 'off';
+        case 'Check for updates':
+            return updateStatusText(updateCheck);
         case 'Reset learned media keys':
             return `prev ${settings.mediaKeys.previous.length} · play ${settings.mediaKeys.playPause.length} · next ${settings.mediaKeys.next.length}`;
         default:
             return undefined;
     }
 }
+function settingLabel(item, updateCheck) {
+    if (item === 'Check for updates' && updateCheck?.updateAvailable) {
+        return 'Install update';
+    }
+    return item;
+}

package/dist/ui/screens/StatsScreen.js

@@ -9,37 +9,54 @@ import { truncate } from '../format.js';
 const monthLabels = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
 const dayLabelWidth = 5;
 const heatmapCellOptions = [
-    { cell: '  ', gap: ' ' },
     { cell: '  ', gap: '' },
-    { cell: '■', gap: '' }
+    { cell: ' ', gap: '' }
 ];
-const compactHeatmapCell = '■';
+const compactHeatmapCell = ' ';
 const compactHeatmapGap = '';
+const tallHeatmapMinHeight = 26;
 export function StatsScreen({ library, theme, width, height }) {
     const { panel: panelBackground, ascii } = useDisplay();
     const stats = computeListeningStats(library.activity.sessions);
     const contentWidth = Math.max(20, width - 4);
-    const graph = buildContributionGraph(stats.days, contentWidth);
+    const graph = buildContributionGraph(stats.days, contentWidth, height);
     const graphColors = themeContributionColors(theme);
     const favorite = stats.favoriteStation?.name ?? 'none yet';
     const totalHours = stats.totalSeconds / 3600;
     const metricWidth = Math.max(28, Math.floor((contentWidth - 2) / 2));
     const favoriteWidth = Math.max(8, metricWidth - 18);
     const compact = height < 30;
-    const tileHeight = graph.cellText.trim().length === 0 ? 2 : 1;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Listening stats", subtitle: "Local listening history \u00B7 never leaves this machine", width: width, theme: theme, right: `${formatHours(totalHours)} · ${stats.sessions.toLocaleString()} sessions` }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: width, flexDirection: "column", children: [_jsx(Box, { children: _jsxs(Text, { color: themeAccent(theme), bold: true, children: ["Activity \u2014 ", graph.year] }) }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: textMuted, children: [' '.repeat(dayLabelWidth), graph.months] }), graph.rows.map(row => (_jsx(React.Fragment, { children: Array.from({ length: tileHeight }, (_, tileLine) => (_jsxs(Box, { children: [_jsx(Text, { color: textMuted, children: tileLine === 0 ? row.label.padEnd(dayLabelWidth) : ' '.repeat(dayLabelWidth) }), row.cells.map(cell => renderContributionCell(cell, graphColors, graph.cellGap))] }, `${row.key}-${tileLine}`))) }, row.key)))] })] }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: width, flexDirection: "column", children: [_jsx(Text, { color: themeAccent(theme), bold: true, children: "Summary" }), _jsxs(Box, { marginTop: compact ? 0 : 1, flexDirection: "column", width: contentWidth, children: [metricPair('Favorite station', truncate(favorite, favoriteWidth), 'Total hours listened', formatHours(totalHours), metricWidth, theme), metricPair('Sessions', stats.sessions.toLocaleString(), 'Longest streak', formatDays(stats.longestStreak), metricWidth, theme), metricPair('Current streak', formatDays(stats.currentStreak), 'Stations listened', stats.listenedStationCount.toLocaleString(), metricWidth, theme), metricPair('Active days', `${stats.activeDays}/${stats.totalTrackedDays}`, 'Station threshold', '>= 120s total', metricWidth, theme)] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: textMuted, children: "Less \u00B7 " }), graphColors.map(color => (_jsxs(React.Fragment, { children: [renderLegendCell(color, graph.cellText, graph.cellGap), _jsx(Text, { children: " " })] }, color))), _jsx(Text, { color: textMuted, children: "More" })] }), !compact ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: textHighlight, children: stats.totalSeconds > 0
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Listening stats", subtitle: "Local listening history \u00B7 never leaves this machine", width: width, theme: theme, right: `${formatHours(totalHours)} · ${stats.sessions.toLocaleString()} sessions` }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: width, flexDirection: "column", children: [_jsx(Box, { children: _jsxs(Text, { color: themeAccent(theme), bold: true, children: ["Activity \u2014 ", graph.year] }) }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: textMuted, children: [' '.repeat(dayLabelWidth), graph.months] }), graph.rows.map(row => (_jsx(React.Fragment, { children: Array.from({ length: graph.tileHeight }, (_, tileLine) => (_jsxs(Box, { children: [_jsx(Text, { color: textMuted, children: tileLine === 0 ? row.label.padEnd(dayLabelWidth) : ' '.repeat(dayLabelWidth) }), renderContributionCells(row.cells, graphColors, graph.cellGap)] }, `${row.key}-${tileLine}`))) }, row.key)))] })] }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: width, flexDirection: "column", children: [_jsx(Text, { color: themeAccent(theme), bold: true, children: "Summary" }), _jsxs(Box, { marginTop: compact ? 0 : 1, flexDirection: "column", width: contentWidth, children: [metricPair('Favorite station', truncate(favorite, favoriteWidth), 'Total hours listened', formatHours(totalHours), metricWidth, theme), metricPair('Sessions', stats.sessions.toLocaleString(), 'Longest streak', formatDays(stats.longestStreak), metricWidth, theme), metricPair('Current streak', formatDays(stats.currentStreak), 'Stations listened', stats.listenedStationCount.toLocaleString(), metricWidth, theme), metricPair('Active days', `${stats.activeDays}/${stats.totalTrackedDays}`, 'Station threshold', '>= 120s total', metricWidth, theme)] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: textMuted, children: "Less \u00B7 " }), graphColors.map(color => (_jsxs(React.Fragment, { children: [renderLegendCell(color, graph.cellText, graph.cellGap), _jsx(Text, { children: " " })] }, color))), _jsx(Text, { color: textMuted, children: "More" })] }), !compact ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: textHighlight, children: stats.totalSeconds > 0
                                 ? `Your total listening time is ${formatHours(totalHours)} across public radio streams.`
                                 : 'Start a station to begin filling the listening graph.' }) })) : null] })] }));
 }
-function renderContributionCell(cell, graphColors, cellGap) {
-    if (!cell.visible) {
-        return _jsx(Text, { children: cell.text }, cell.key);
-    }
-    const color = graphColors[cell.level] ?? graphColors[0] ?? textMuted;
-    if (cell.text.trim().length === 0) {
-        return (_jsxs(React.Fragment, { children: [_jsx(Text, { backgroundColor: color, children: cell.text }), cellGap ? _jsx(Text, { children: cellGap }) : null] }, cell.key));
+function renderContributionCells(cells, graphColors, cellGap) {
+    const runs = [];
+    for (const cell of cells) {
+        const text = cellGap ? `${cell.text}${cell.visible ? cellGap : ''}` : cell.text;
+        const previous = runs[runs.length - 1];
+        if (previous && previous.visible === cell.visible && previous.level === cell.level) {
+            previous.text += text;
+        }
+        else {
+            runs.push({
+                key: `${runs.length}-${cell.key}`,
+                level: cell.level,
+                text,
+                visible: cell.visible
+            });
+        }
     }
-    return (_jsxs(React.Fragment, { children: [_jsx(Text, { color: color, children: cell.text }), cellGap ? _jsx(Text, { children: cellGap }) : null] }, cell.key));
+    return runs.map(run => {
+        if (!run.visible) {
+            return _jsx(Text, { children: run.text }, run.key);
+        }
+        const color = graphColors[run.level] ?? graphColors[0] ?? textMuted;
+        if (run.text.trim().length === 0) {
+            return _jsx(Text, { backgroundColor: color, children: run.text }, run.key);
+        }
+        return _jsx(Text, { color: color, children: run.text }, run.key);
+    });
 }
 function renderLegendCell(color, text, cellGap) {
     if (text.trim().length === 0) {
@@ -52,7 +69,7 @@ function metricPair(leftLabel, leftValue, rightLabel, rightValue, metricWidth, t
     const leftPadding = Math.max(2, metricWidth - leftLabel.length - leftValue.length - 2);
     return (_jsxs(Box, { height: 1, width: metricWidth * 2 + 2, children: [_jsx(Box, { width: metricWidth, children: _jsxs(Text, { children: [_jsxs(Text, { color: textMuted, children: [leftLabel, ": "] }), _jsx(Text, { color: accent, children: leftValue })] }) }), _jsx(Text, { children: ' '.repeat(leftPadding > 2 ? 2 : leftPadding) }), _jsx(Box, { width: metricWidth, children: _jsxs(Text, { children: [_jsxs(Text, { color: textMuted, children: [rightLabel, ": "] }), _jsx(Text, { color: accent, children: rightValue })] }) })] }));
 }
-export function buildContributionGraph(days, width) {
+export function buildContributionGraph(days, width, height = tallHeatmapMinHeight) {
     const year = graphYear(days);
     const weeks = calendarYearWeeks(year);
     const largestCell = heatmapCellOptions.find(option => dayLabelWidth + weeks.length * (option.cell.length + option.gap.length) <= width);
@@ -62,6 +79,7 @@ export function buildContributionGraph(days, width) {
     const cellWidth = largeCellWidth > 0 ? largeCellWidth : compactCellWidth;
     const cellText = selectedCell.cell;
     const cellGap = selectedCell.gap;
+    const tileHeight = cellText.trim().length === 0 && height >= tallHeatmapMinHeight ? 2 : 1;
     const secondsByDate = new Map(days.map(day => [day.date, day.seconds]));
     const yearDays = days.filter(day => parseLocalDay(day.date).getFullYear() === year);
     const scaleSeconds = contributionScaleSeconds(yearDays);
@@ -84,7 +102,7 @@ export function buildContributionGraph(days, width) {
             return { key: date, level, text: cellText, visible: true };
         })
     }));
-    return { year, months: monthLine(weeks, cellWidth, year), cellText, cellGap, rows };
+    return { year, months: monthLine(weeks, cellWidth, year), cellText, cellGap, tileHeight, rows };
 }
 export function contributionScaleSeconds(days) {
     const activeSeconds = days

package/dist/ui/screens/screen-render.test.js

@@ -6,6 +6,7 @@ import { HelpScreen } from './HelpScreen.js';
 import { NowPlayingScreen } from './NowPlayingScreen.js';
 import { SettingsScreen } from './SettingsScreen.js';
 import { ExploreScreen } from './ExploreScreen.js';
+import { CountriesScreen } from './CountriesScreen.js';
 import { buildContributionGraph, contributionLevel, contributionScaleSeconds, StatsScreen } from './StatsScreen.js';
 import { settingsItems } from '../screen-items.js';
 import { defaultExploreCursor } from '../app-state.js';
@@ -60,13 +61,34 @@ const settings = {
 describe('SettingsScreen rendering', () => {
     it('renders the new display and playback toggles with their values', () => {
         const settingsIndex = Math.max(0, settingsItems.indexOf('Resume last station on launch'));
-        const { lastFrame } = render(_jsx(SettingsScreen, { selected: settingsIndex, settings: settings, storePath: "/tmp/radiocli.json", playback: playback, backends: ['mpv'], airPlayDevices: [], providerHealth: {}, theme: "green", diagnostics: diagnostics, width: 80 }));
+        const { lastFrame } = render(_jsx(SettingsScreen, { selected: settingsIndex, settings: settings, appVersion: "0.1.9", updateCheck: { checkedAt: '2026-07-07T00:00:00.000Z', currentVersion: '0.1.9', latestVersion: '0.1.9', updateAvailable: false }, storePath: "/tmp/radiocli.json", playback: playback, backends: ['mpv'], airPlayDevices: [], providerHealth: {}, theme: "green", diagnostics: diagnostics, width: 80 }));
         const frame = lastFrame() ?? '';
         expect(frame).toContain('Resume last station on launch');
         expect(frame).toContain('ASCII-safe display');
         expect(frame).toContain('Reduce motion');
         expect(frame).toContain('Transparent background');
     });
+    it('changes the update settings row when an update is available', () => {
+        const settingsIndex = Math.max(0, settingsItems.indexOf('Check for updates'));
+        const { lastFrame } = render(_jsx(SettingsScreen, { selected: settingsIndex, settings: settings, appVersion: "0.1.9", updateCheck: { checkedAt: '2026-07-07T00:00:00.000Z', currentVersion: '0.1.9', latestVersion: '0.1.10', updateAvailable: true }, storePath: "/tmp/radiocli.json", playback: playback, backends: ['mpv'], airPlayDevices: [], providerHealth: {}, theme: "green", diagnostics: diagnostics, width: 80 }));
+        const frame = lastFrame() ?? '';
+        expect(frame).toContain('Install update');
+        expect(frame).toContain('v0.1.10 available');
+    });
+    it('keeps the selected update row visible in a constrained Settings pane', () => {
+        const settingsIndex = Math.max(0, settingsItems.indexOf('Check for updates'));
+        const { lastFrame } = render(_jsx(SettingsScreen, { selected: settingsIndex, settings: settings, appVersion: "0.1.9", updateCheck: { checkedAt: '2026-07-07T00:00:00.000Z', currentVersion: '0.1.9', latestVersion: '0.1.9', updateAvailable: false }, storePath: "/tmp/radiocli.json", playback: playback, backends: ['mpv'], airPlayDevices: [], providerHealth: {}, theme: "green", diagnostics: diagnostics, width: 80, height: 18 }));
+        const frame = lastFrame() ?? '';
+        expect(frame).toContain('> Check for updates');
+    });
+    it('keeps Reduce motion visible between ASCII-safe display and update checks', () => {
+        const settingsIndex = Math.max(0, settingsItems.indexOf('Reduce motion'));
+        const { lastFrame } = render(_jsx(SettingsScreen, { selected: settingsIndex, settings: settings, appVersion: "0.1.9", updateCheck: { checkedAt: '2026-07-07T00:00:00.000Z', currentVersion: '0.1.9', latestVersion: '0.1.9', updateAvailable: false }, storePath: "/tmp/radiocli.json", playback: playback, backends: ['mpv'], airPlayDevices: [], providerHealth: {}, theme: "green", diagnostics: diagnostics, width: 80, height: 18 }));
+        const frame = lastFrame() ?? '';
+        expect(frame).toContain('  ASCII-safe display');
+        expect(frame).toContain('> Reduce motion');
+        expect(frame).toContain('  Check for updates');
+    });
 });
 function renderExplore(asciiMode) {
     const mode = resolveDisplayMode({ asciiMode }, {});
@@ -82,6 +104,20 @@ describe('Explore world map rendering', () => {
         expect(/[⠀-⣿]/.test(frame)).toBe(false);
     });
 });
+describe('CountriesScreen rendering', () => {
+    it('keeps long country rows to one terminal line', () => {
+        const frame = render(_jsx(CountriesScreen, { countries: [
+                {
+                    name: 'The Extremely Long Democratic Republic Of The Country With A Very Long Name',
+                    code: 'TL',
+                    stationCount: 123456789
+                }
+            ], selected: 0, loading: false, filter: "", editingFilter: false, theme: "green", pageSize: 1, width: 48 })).lastFrame() ?? '';
+        expect(frame).toContain('>');
+        expect(frame).toContain('…');
+        expect(frame).not.toContain('Very Long Name');
+    });
+});
 describe('StatsScreen rendering', () => {
     it('renders activity heatmap as large calendar-year cells with readable month labels', () => {
         const library = {
@@ -115,7 +151,8 @@ describe('StatsScreen rendering', () => {
         expect(graph.months.startsWith('Jan')).toBe(true);
         expect(graph.months).toContain('Dec');
         expect(graph.cellText).toBe('  ');
-        expect(graph.cellGap).toBe(' ');
+        expect(graph.cellGap).toBe('');
+        expect(graph.tileHeight).toBe(2);
         expect(graph.rows[4]?.cells[0]).toMatchObject({
             level: 4,
             text: '  ',
@@ -137,6 +174,21 @@ describe('StatsScreen rendering', () => {
         ], 128);
         expect(normalWidthGraph.cellText).toBe('  ');
         expect(normalWidthGraph.cellGap).toBe('');
+        const compactWidthGraph = buildContributionGraph([
+            { date: '2026-01-01', seconds: 3600 },
+            { date: '2026-12-31', seconds: 0 }
+        ], 80);
+        expect(compactWidthGraph.cellText).toBe(' ');
+        expect(compactWidthGraph.cellGap).toBe('');
+    });
+    it('uses one-line heatmap cells when the stats panel is height constrained', () => {
+        const graph = buildContributionGraph([
+            { date: '2026-01-01', seconds: 3600 },
+            { date: '2026-12-31', seconds: 0 }
+        ], 170, 20);
+        expect(graph.cellText).toBe('  ');
+        expect(graph.cellGap).toBe('');
+        expect(graph.tileHeight).toBe(1);
     });
     it('caps contribution color scaling so one outlier does not flatten normal active days', () => {
         const days = [

package/dist/ui/terminal-mouse.js

@@ -14,6 +14,21 @@ export function parseSgrMouseEvents(input) {
 export function primaryMousePress(events) {
     return events.find(event => event.pressed && (event.button & 3) === 0 && (event.button & 96) === 0) ?? null;
 }
+export function wheelScrollDelta(events) {
+    return events.reduce((delta, event) => {
+        if (!event.pressed) {
+            return delta;
+        }
+        const button = event.button & 127;
+        if (button === 64) {
+            return delta - 1;
+        }
+        if (button === 65) {
+            return delta + 1;
+        }
+        return delta;
+    }, 0);
+}
 export function exploreCursorForMouseCell(x, y, frameWidth, layout) {
     if (layout.compact) {
         return null;

package/dist/ui/use-app-input.js

@@ -1,10 +1,10 @@
 import { useEffect } from 'react';
 import { useInput } from 'ink';
 import { homeItems, settingsItems } from './screen-items.js';
-import { applyTextInput, clamp, favoriteTarget, isEditableInput, isPlainPrintableInput, mediaTransportActionForInput, searchEditingArrowAction, shouldHandleKeyboardEvent } from './app-state.js';
-import { parseSgrMouseEvents, primaryMousePress } from './terminal-mouse.js';
+import { applyTextInput, clamp, favoriteTarget, isEditableInput, isPlainPrintableInput, mediaTransportActionForInput, searchEditingArrowAction, shouldHandleKeyboardEvent, shouldToggleNearbyLocationShortcut } from './app-state.js';
+import { parseSgrMouseEvents, primaryMousePress, wheelScrollDelta } from './terminal-mouse.js';
 import { completeCommand } from './help-content.js';
-export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, beginLearningTransportKey, capturingTransportAction, commandMode, commandText, copyStationUrl, openStationHomepage, currentItemCount, cycleDisplayColor, cycleAudioOutput, cycleReceiverStyle, cycleSleepTimer, editingCountryFilter, editingSearch, executeCommand, filteredCountries, go, lastRawTransportAtRef, lastSubmittedSearchRef, loadCountry, openAdjacentTab, openAirPlayCode, openAirPlaySettings, openScreen, playAdjacent, playStation, player, playingStation, recallSearchHistory, moveExploreCursor, moveExploreCursorToCell, refreshAirPlayTargets, refreshProviderHealth, resetLearnedTransportKeys, runSearch, saveLearnedTransportKey, screen, searchQuery, selected, selectedStation, selectAirPlayDeviceAt, setCapturingTransportAction, setAirPlayCode, setCommandMode, setCommandText, setCountryFilter, setEditingCountryFilter, setEditingSearch, setMessage, setSearchQuery, setSelected, setShowDiagnostics, submitAirPlayCode, settingsRef, shutdown, stdin, toggleFavorite, toggleMute, togglePause, toggleSetting, toggleNearbyLocation, toggleRadioGarden, toggleSkipBrokenStreams }) {
+export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, beginLearningTransportKey, capturingTransportAction, commandMode, commandText, copyStationUrl, openStationHomepage, currentItemCount, cycleDisplayColor, cycleAudioOutput, cycleReceiverStyle, cycleSleepTimer, editingCountryFilter, editingSearch, executeCommand, filteredCountries, go, lastRawTransportAtRef, lastSubmittedSearchRef, loadCountry, openAdjacentTab, openAirPlayCode, openAirPlaySettings, openScreen, playAdjacent, playStation, player, playingStation, recallSearchHistory, moveExploreCursor, moveExploreCursorToCell, refreshAirPlayTargets, refreshProviderHealth, resetLearnedTransportKeys, runSearch, saveLearnedTransportKey, screen, searchQuery, selected, selectedStation, selectAirPlayDeviceAt, setCapturingTransportAction, setAirPlayCode, setCommandMode, setCommandText, setCountryFilter, setEditingCountryFilter, setEditingSearch, setMessage, setSearchQuery, setSelected, setShowDiagnostics, submitAirPlayCode, settingsRef, shutdown, stdin, toggleFavorite, toggleMute, togglePause, toggleSetting, toggleNearbyLocation, toggleRadioGarden, toggleSkipBrokenStreams, updateFromSettings }) {
     useEffect(() => {
         const onData = (data) => {
             const rawInput = String(data);
@@ -22,8 +22,13 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
             }
             const mouseEvents = parseSgrMouseEvents(rawInput);
             if (mouseEvents.length > 0) {
+                const wheelDelta = wheelScrollDelta(mouseEvents);
                 const click = primaryMousePress(mouseEvents);
                 lastRawTransportAtRef.current = Date.now();
+                if (wheelDelta !== 0 && shouldScrollSelectionWithWheel(screen, commandMode, editingCountryFilter)) {
+                    setSelected(value => clamp(value + wheelDelta * 3, currentItemCount(screen) - 1));
+                    return;
+                }
                 if (!commandMode && screen === 'explore' && click) {
                     moveExploreCursorToCell(click.x, click.y);
                 }
@@ -256,7 +261,7 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
             toggleRadioGarden();
             return;
         }
-        if (input === 'l') {
+        if (shouldToggleNearbyLocationShortcut(input, screen)) {
             toggleNearbyLocation();
             return;
         }
@@ -303,6 +308,10 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
             return;
         }
         if (input === 'b' || key.escape) {
+            if (screen === 'stations') {
+                go('countries');
+                return;
+            }
             go('home');
             return;
         }
@@ -422,6 +431,9 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
                 else if (item === 'Reduce motion') {
                     toggleSetting('reduceMotion');
                 }
+                else if (item === 'Check for updates') {
+                    void updateFromSettings();
+                }
                 else if (item === 'Refresh provider health') {
                     refreshProviderHealth();
                     setMessage('Provider health refreshed.');
@@ -457,6 +469,12 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
         }
     });
 }
+function shouldScrollSelectionWithWheel(screen, commandMode, editingCountryFilter) {
+    if (commandMode || editingCountryFilter) {
+        return false;
+    }
+    return ['countries', 'map', 'stations', 'search', 'nearby', 'explore', 'library'].includes(screen);
+}
 function exploreMoveForInput(input) {
     const normalized = input.toLowerCase();
     if (normalized === 'w') {

package/dist/ui/use-command-executor.js

@@ -1,6 +1,6 @@
 import { useCallback } from 'react';
 import { favoriteTarget, normalizeMediaKeyBindings, parseMediaActionName } from './app-state.js';
-export function useCommandExecutor({ beginLearningTransportKey, countries, go, loadCountry, openAirPlaySettings, openLibrary, player, playingStation, providers, resetLearnedTransportKeys, runSearch, screen, selectedStation, setCountries, setFilters, setLibrary, setMessage, setSearchQuery, setSleepUntil, setVolume, settingsRef, store, toggleFavorite, toggleMute, updateSettings }) {
+export function useCommandExecutor({ beginLearningTransportKey, countries, go, loadCountry, openAirPlaySettings, openLibrary, player, playingStation, providers, resetLearnedTransportKeys, runSearch, screen, selectedStation, setCountries, setFilters, setLibrary, setMessage, setSearchQuery, setSleepUntil, setVolume, settingsRef, store, toggleFavorite, toggleMute, updateCommand, updateSettings }) {
     return useCallback(async (rawCommand) => {
         const trimmed = rawCommand.trim();
         if (!trimmed) {
@@ -136,6 +136,10 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
             go('settings');
             return;
         }
+        if (name === 'update') {
+            await updateCommand();
+            return;
+        }
         if (name === 'stop') {
             setLibrary(store.finishActiveListeningSession());
             await player.stop();
@@ -189,6 +193,7 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
         store,
         toggleFavorite,
         toggleMute,
+        updateCommand,
         updateSettings
     ]);
 }

package/dist/update-check.js

@@ -0,0 +1,122 @@
+import { realpathSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { appVersion } from './version.js';
+const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const UPDATE_PACKAGE_NAME = '@ciphore/radiocli';
+export async function checkForUpdate({ currentVersion = appVersion(), fetchImpl = fetch, now = new Date(), packageName = UPDATE_PACKAGE_NAME, timeoutMs = 3000 } = {}) {
+    try {
+        const response = await fetchWithTimeout(registryLatestUrl(packageName), fetchImpl, timeoutMs);
+        if (!response.ok) {
+            throw new Error(`npm registry returned ${response.status}`);
+        }
+        const parsed = await response.json();
+        const latestVersion = typeof parsed.version === 'string' ? parsed.version : undefined;
+        if (!latestVersion) {
+            throw new Error('npm registry response did not include a version');
+        }
+        return {
+            checkedAt: now.toISOString(),
+            currentVersion,
+            latestVersion,
+            updateAvailable: compareSemver(latestVersion, currentVersion) > 0
+        };
+    }
+    catch (error) {
+        return {
+            checkedAt: now.toISOString(),
+            currentVersion,
+            updateAvailable: false,
+            error: error instanceof Error ? error.message : 'Update check failed'
+        };
+    }
+}
+export function shouldCheckForUpdate(updateCheck, now = Date.now()) {
+    if (process.env.RADIOCLI_DISABLE_UPDATE_CHECK === '1' || process.env.CI === 'true') {
+        return false;
+    }
+    if (!updateCheck?.checkedAt) {
+        return true;
+    }
+    const checkedAt = Date.parse(updateCheck.checkedAt);
+    return !Number.isFinite(checkedAt) || now - checkedAt >= UPDATE_CHECK_INTERVAL_MS;
+}
+export function updateStatusText(updateCheck) {
+    if (!updateCheck) {
+        return 'not checked yet';
+    }
+    if (updateCheck.updateAvailable && updateCheck.latestVersion) {
+        return `v${updateCheck.latestVersion} available`;
+    }
+    if (updateCheck.error) {
+        return `check failed: ${updateCheck.error}`;
+    }
+    return updateCheck.latestVersion ? `current at v${updateCheck.latestVersion}` : 'not checked yet';
+}
+export function updateCommandForInstall(entryPath = process.argv[1]) {
+    const resolved = resolvePath(entryPath);
+    const haystack = [entryPath, resolved].filter(Boolean).join('\n');
+    if (/\/(?:opt\/homebrew|usr\/local)\/(?:Cellar|Homebrew)\//.test(haystack) || /\/\.linuxbrew\/(?:Cellar|Homebrew)\//.test(haystack)) {
+        return { method: 'homebrew', command: 'brew update && brew upgrade radiocli' };
+    }
+    if (/\/node_modules\/@ciphore\/radiocli\//.test(haystack)) {
+        return { method: 'npm', command: 'npm install -g @ciphore/radiocli@latest' };
+    }
+    return { method: 'unknown', command: 'npm install -g @ciphore/radiocli@latest' };
+}
+export function installUpdate(command = updateCommandForInstall().command) {
+    return new Promise(resolve => {
+        const shell = process.platform === 'win32' ? 'cmd.exe' : 'sh';
+        const args = process.platform === 'win32' ? ['/d', '/s', '/c', command] : ['-lc', command];
+        const child = spawn(shell, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        const chunks = [];
+        child.stdout.on('data', chunk => chunks.push(Buffer.from(chunk)));
+        child.stderr.on('data', chunk => chunks.push(Buffer.from(chunk)));
+        child.on('error', error => {
+            resolve({ ok: false, command, output: error.message });
+        });
+        child.on('close', code => {
+            const output = Buffer.concat(chunks).toString('utf8').trim();
+            resolve({ ok: code === 0, command, output });
+        });
+    });
+}
+export function compareSemver(left, right) {
+    const leftParts = semverParts(left);
+    const rightParts = semverParts(right);
+    for (let index = 0; index < 3; index += 1) {
+        const delta = leftParts[index] - rightParts[index];
+        if (delta !== 0) {
+            return delta;
+        }
+    }
+    return 0;
+}
+function registryLatestUrl(packageName) {
+    return `https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`;
+}
+async function fetchWithTimeout(url, fetchImpl, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetchImpl(url, { signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function semverParts(version) {
+    const normalized = version.trim().replace(/^v/i, '').split(/[+-]/)[0] ?? '';
+    const [major = '0', minor = '0', patch = '0'] = normalized.split('.');
+    return [Number(major) || 0, Number(minor) || 0, Number(patch) || 0];
+}
+function resolvePath(path) {
+    if (!path) {
+        return undefined;
+    }
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return path;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciphore/radiocli",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "A terminal-first world radio receiver built with Ink, mpv, and resilient public-radio providers.",
   "type": "module",
   "license": "MIT",