@ciphore/radiocli 0.1.9 → 0.2.1

package/dist/ui/screens/StatsScreen.js

@@ -2,19 +2,17 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import React from 'react';
 import { Box, Text } from 'ink';
 import { computeListeningStats } from '../../activity/stats.js';
-import { panelBorder, textHighlight, textMuted, themeAccent, themeContributionColors } from '../theme.js';
+import { panelBorder, textMuted, themeAccent, themeContributionColors } from '../theme.js';
 import { panelBorderStyle, useDisplay } from '../display-context.js';
 import { ScreenHeader } from '../components/ScreenHeader.js';
 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: '' }
-];
-const compactHeatmapCell = ' ';
-const compactHeatmapGap = '';
-const tallHeatmapMinHeight = 26;
+// Two terminal columns are approximately one row high in common monospace
+// fonts, so 2x1 cells remain visually square. Narrow screens show fewer recent
+// weeks instead of distorting the cells.
+const heatmapCell = '  ';
+const heatmapGap = '';
 export function StatsScreen({ library, theme, width, height }) {
     const { panel: panelBackground, ascii } = useDisplay();
     const stats = computeListeningStats(library.activity.sessions);
@@ -26,9 +24,7 @@ export function StatsScreen({ library, theme, width, height }) {
     const metricWidth = Math.max(28, Math.floor((contentWidth - 2) / 2));
     const favoriteWidth = Math.max(8, metricWidth - 18);
     const compact = height < 30;
-    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] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Listening stats", subtitle: "Local listening history \u00B7 never leaves this machine", width: width, theme: theme }), _jsxs(Box, { marginTop: 1, paddingBottom: 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}`, 'Stations counted after', '2 min', 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" })] })] })] }));
 }
 function renderContributionCells(cells, graphColors, cellGap) {
     const runs = [];
@@ -69,20 +65,17 @@ 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, height = tallHeatmapMinHeight) {
+export function buildContributionGraph(days, width, _height = 26) {
     const year = graphYear(days);
-    const weeks = calendarYearWeeks(year);
-    const largestCell = heatmapCellOptions.find(option => dayLabelWidth + weeks.length * (option.cell.length + option.gap.length) <= width);
-    const selectedCell = largestCell ?? { cell: compactHeatmapCell, gap: compactHeatmapGap };
-    const largeCellWidth = selectedCell.cell.length + selectedCell.gap.length;
-    const compactCellWidth = compactHeatmapCell.length + compactHeatmapGap.length;
-    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 endDate = days.length > 0 ? parseLocalDay(days[days.length - 1].date) : new Date();
+    const availableWeekCount = Math.max(1, Math.floor((width - dayLabelWidth) / heatmapCell.length));
+    const weeks = rollingCalendarWeeks(endDate, availableWeekCount);
+    const cellWidth = heatmapCell.length;
+    const cellText = heatmapCell;
+    const cellGap = heatmapGap;
+    const tileHeight = 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);
+    const scaleSeconds = contributionScaleSeconds(days);
     const labels = ['', 'Mon', '', 'Wed', '', 'Fri', ''];
     const rows = Array.from({ length: 7 }, (_, dayIndex) => ({
         key: `day-${dayIndex}`,
@@ -99,10 +92,10 @@ export function buildContributionGraph(days, width, height = tallHeatmapMinHeigh
             }
             const date = localDay(day.date);
             const level = day.visible ? contributionLevel(secondsByDate.get(date) ?? 0, scaleSeconds) : 0;
-            return { key: date, level, text: cellText, visible: true };
+            return { key: date, level, text: cellText, visible: day.visible };
         })
     }));
-    return { year, months: monthLine(weeks, cellWidth, year), cellText, cellGap, tileHeight, rows };
+    return { year, months: monthLine(weeks, cellWidth), cellText, cellGap, tileHeight, rows };
 }
 export function contributionScaleSeconds(days) {
     const activeSeconds = days
@@ -135,29 +128,27 @@ function graphYear(days) {
     const lastDay = days[days.length - 1];
     return lastDay ? parseLocalDay(lastDay.date).getFullYear() : new Date().getFullYear();
 }
-function calendarYearWeeks(year) {
-    const yearStart = new Date(year, 0, 1);
-    const yearEnd = new Date(year, 11, 31);
-    const gridStart = addLocalDays(yearStart, -yearStart.getDay());
-    const gridEnd = addLocalDays(yearEnd, 6 - yearEnd.getDay());
-    const weeks = [];
-    for (let cursor = gridStart; cursor.getTime() <= gridEnd.getTime(); cursor = addLocalDays(cursor, 7)) {
-        weeks.push(Array.from({ length: 7 }, (_, dayIndex) => {
-            const date = addLocalDays(cursor, dayIndex);
-            return { date, visible: date.getFullYear() === year };
-        }));
-    }
-    return weeks;
+function rollingCalendarWeeks(endDate, availableWeekCount) {
+    const gridEnd = addLocalDays(endDate, 6 - endDate.getDay());
+    const weekCount = Math.min(53, availableWeekCount);
+    const gridStart = addLocalDays(gridEnd, -(weekCount * 7 - 1));
+    return Array.from({ length: weekCount }, (_, weekIndex) => Array.from({ length: 7 }, (_, dayIndex) => {
+        const date = addLocalDays(gridStart, weekIndex * 7 + dayIndex);
+        return {
+            date,
+            visible: true
+        };
+    }));
 }
-function monthLine(weeks, cellWidth, year) {
+function monthLine(weeks, cellWidth) {
     const cells = Array.from({ length: weeks.length * cellWidth }, () => ' ');
-    for (let month = 0; month < 12; month += 1) {
-        const label = monthLabels[month];
-        const firstOfMonth = localDay(new Date(year, month, 1));
-        const weekIndex = weeks.findIndex(week => week.some(day => localDay(day.date) === firstOfMonth));
-        if (weekIndex < 0) {
+    for (let weekIndex = 0; weekIndex < weeks.length; weekIndex += 1) {
+        const week = weeks[weekIndex];
+        const firstOfMonth = week?.find(day => day.date.getDate() === 1);
+        if (!firstOfMonth) {
             continue;
         }
+        const label = monthLabels[firstOfMonth.date.getMonth()];
         const start = weekIndex * cellWidth;
         for (let index = 0; index < label.length && start + index < cells.length; index += 1) {
             cells[start + index] = label[index];

package/dist/ui/system-actions.js

@@ -1,13 +1,14 @@
 import { spawn } from 'node:child_process';
 import { resolveCommand } from '../player/command.js';
+import { safeExternalHttpUrl } from '../safety.js';
 // The command used to open a URL in the platform's default handler.
 export function openExternalCommand(platform = process.platform) {
     if (platform === 'darwin') {
         return { command: 'open', args: [] };
     }
     if (platform === 'win32') {
-        // The empty "" is the window title argument `start` expects before the URL.
-        return { command: 'cmd', args: ['/c', 'start', ''] };
+        // Direct invocation avoids cmd.exe interpreting URL query characters.
+        return { command: 'explorer', args: [] };
     }
     return { command: 'xdg-open', args: [] };
 }
@@ -27,14 +28,20 @@ export function clipboardCommands(platform = process.platform) {
     ];
 }
 export function openExternal(url, platform = process.platform) {
+    const safeUrl = safeExternalHttpUrl(url);
+    if (!safeUrl) {
+        return false;
+    }
     const { command, args } = openExternalCommand(platform);
     try {
-        const child = spawn(resolveCommand(command) ?? command, [...args, url], { stdio: 'ignore', detached: true });
+        const child = spawn(resolveCommand(command) ?? command, [...args, safeUrl], { stdio: 'ignore', detached: true });
         child.on('error', () => undefined);
         child.unref();
+        return true;
     }
     catch {
         // Opening a browser is best-effort; never crash the TUI over it.
+        return false;
     }
 }
 export function copyToClipboard(text, platform = process.platform) {

package/dist/ui/terminal-mouse.js

@@ -11,9 +11,53 @@ export function parseSgrMouseEvents(input) {
         pressed: match[4] === 'M'
     })).filter(event => Number.isFinite(event.button) && Number.isFinite(event.x) && Number.isFinite(event.y));
 }
+/** Parse modern SGR mouse reports and the legacy X10 form used by older terminals. */
+export function parseTerminalMouseEvents(input) {
+    const text = String(input);
+    const events = parseSgrMouseEvents(text);
+    if (!(input instanceof Uint8Array))
+        return events;
+    for (let index = 0; index <= input.length - 6; index += 1) {
+        if (input[index] !== 0x1b || input[index + 1] !== 0x5b || input[index + 2] !== 0x4d)
+            continue;
+        const button = (input[index + 3] ?? 32) - 32;
+        const x = (input[index + 4] ?? 32) - 32;
+        const y = (input[index + 5] ?? 32) - 32;
+        if (button < 0 || x < 1 || y < 1)
+            continue;
+        events.push({ button, x, y, pressed: (button & 3) !== 3 });
+        index += 5;
+    }
+    return events;
+}
+const selectableMouseScreens = new Set([
+    'home', 'countries', 'map', 'stations', 'search', 'nearby', 'explore',
+    'library', 'settings', 'help', 'airplay-settings'
+]);
+export function shouldEnableMouseReporting(screen, itemCount, visibleRows, mouseSupport = true) {
+    if (!mouseSupport || !selectableMouseScreens.has(screen))
+        return false;
+    // Explore also needs mouse clicks for map placement when its station list is short.
+    return screen === 'explore' || itemCount > Math.max(0, visibleRows);
+}
 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/theme.js

@@ -9,7 +9,6 @@ export const panelBorder = '#28313c';
 // named gray maps to terminal-palette "bright black" and can become unreadable.
 export const textMuted = '#aab4c2';
 export const textDim = '#8a96a8';
-export const textHighlight = '#d8c66f';
 export const mapLand = '#33414f';
 export const mapWater = '#1a2430';
 export const mapMarker = '#7dd3fc';

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

@@ -2,9 +2,9 @@ import { useEffect } from 'react';
 import { useInput } from 'ink';
 import { homeItems, settingsItems } from './screen-items.js';
 import { applyTextInput, clamp, favoriteTarget, isEditableInput, isPlainPrintableInput, mediaTransportActionForInput, searchEditingArrowAction, shouldHandleKeyboardEvent, shouldToggleNearbyLocationShortcut } from './app-state.js';
-import { parseSgrMouseEvents, primaryMousePress } from './terminal-mouse.js';
+import { parseTerminalMouseEvents, 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, confirmCtrlCExit, 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, toggleDirectoryVoting, toggleRadioGarden, toggleSkipBrokenStreams, updateFromSettings }) {
     useEffect(() => {
         const onData = (data) => {
             const rawInput = String(data);
@@ -20,10 +20,15 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
                 saveLearnedTransportKey(capturingTransportAction, rawInput);
                 return;
             }
-            const mouseEvents = parseSgrMouseEvents(rawInput);
+            const mouseEvents = parseTerminalMouseEvents(data);
             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);
                 }
@@ -70,7 +75,7 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
     ]);
     useInput((input, key) => {
         if (key.ctrl && input === 'c') {
-            shutdown();
+            confirmCtrlCExit();
             return;
         }
         if (!shouldHandleKeyboardEvent(key.eventType)) {
@@ -289,8 +294,8 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
             setSelected(value => clamp(value - 10, currentItemCount(screen) - 1));
             return;
         }
-        if (screen === 'home' && (/^[1-9]$/.test(input) || input === '0')) {
-            const menuIndex = input === '0' ? 9 : Number(input) - 1;
+        if (screen === 'home' && /^[1-8]$/.test(input)) {
+            const menuIndex = Number(input) - 1;
             setSelected(menuIndex);
             const target = homeItems[menuIndex]?.screen;
             if (target) {
@@ -396,6 +401,9 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
                 else if (item === 'Toggle nearby location lookup') {
                     toggleNearbyLocation();
                 }
+                else if (item === 'Share favorite votes with Radio Browser') {
+                    toggleDirectoryVoting();
+                }
                 else if (item === 'Audio output') {
                     cycleAudioOutput();
                 }
@@ -426,6 +434,20 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
                 else if (item === 'Reduce motion') {
                     toggleSetting('reduceMotion');
                 }
+                else if (item === 'Mouse and trackpad scrolling') {
+                    toggleSetting('mouseSupport');
+                }
+                else if (item === 'Export preferences and library') {
+                    setCommandText('export ');
+                    setCommandMode(true);
+                }
+                else if (item === 'Import preferences and library') {
+                    setCommandText('import ');
+                    setCommandMode(true);
+                }
+                else if (item === 'Check for updates') {
+                    void updateFromSettings();
+                }
                 else if (item === 'Refresh provider health') {
                     refreshProviderHealth();
                     setMessage('Provider health refreshed.');
@@ -461,6 +483,15 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
         }
     });
 }
+function shouldScrollSelectionWithWheel(screen, commandMode, editingCountryFilter) {
+    if (commandMode || editingCountryFilter) {
+        return false;
+    }
+    return [
+        'home', 'countries', 'map', 'stations', 'search', 'nearby', 'explore',
+        'library', 'settings', 'help', 'airplay-settings'
+    ].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,38 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
             go('settings');
             return;
         }
+        if (name === 'export' || name === 'backup') {
+            try {
+                const backupPath = store.exportBackup(value || undefined);
+                setMessage(`Backup exported: ${backupPath}`);
+            }
+            catch (error) {
+                setMessage(error instanceof Error ? error.message : 'Could not export the RadioCLI backup.');
+            }
+            return;
+        }
+        if (name === 'import' || name === 'restore') {
+            if (!value.trim()) {
+                setMessage('Usage: :import <backup.json>');
+                return;
+            }
+            try {
+                const result = store.importBackup(value);
+                settingsRef.current = result.state.settings;
+                setLibrary(result.state);
+                setMessage(result.safetyBackupPath
+                    ? `Backup imported. Previous library saved to ${result.safetyBackupPath}`
+                    : `Backup imported: ${result.sourcePath}`);
+            }
+            catch (error) {
+                setMessage(error instanceof Error ? error.message : 'Could not import the RadioCLI backup.');
+            }
+            return;
+        }
+        if (name === 'update') {
+            await updateCommand();
+            return;
+        }
         if (name === 'stop') {
             setLibrary(store.finishActiveListeningSession());
             await player.stop();
@@ -189,6 +221,7 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
         store,
         toggleFavorite,
         toggleMute,
+        updateCommand,
         updateSettings
     ]);
 }

package/dist/ui/visualizers/receiver-style-registry.js

@@ -0,0 +1,101 @@
+/** Canonical receiver-style metadata used by rendering, sizing, UI cycling, and migration. */
+export const receiverStyleRegistry = [
+    { id: 'ultracode', maxRows: 14, minRows: 7, resetPulse: true },
+    { id: 'pulse-grid', maxRows: 12, minRows: 7 },
+    { id: 'hex-pulse', maxRows: 12, minRows: 7 },
+    { id: 'moire', maxRows: 14, minRows: 7 },
+    { id: 'galaxy', maxRows: 14, minRows: 7 },
+    { id: 'cyclone', maxRows: 14, minRows: 7 },
+    { id: 'nebula', maxRows: 14, minRows: 7 },
+    { id: 'lava-lamp', maxRows: 14, minRows: 7 },
+    { id: 'motion-contour', maxRows: 14, minRows: 8 },
+    { id: 'ribbon', maxRows: 12, minRows: 7 },
+    { id: 'braille-wave', maxRows: 12, minRows: 7 },
+    { id: 'silk', maxRows: 14, minRows: 7 },
+    { id: 'lissajous', maxRows: 14, minRows: 7 },
+    { id: 'harmonograph', maxRows: 14, minRows: 7 },
+    { id: 'spirograph', maxRows: 14, minRows: 7 },
+    { id: 'goniometer', maxRows: 14, minRows: 7 },
+    { id: 'radial-eq', maxRows: 14, minRows: 7 },
+    { id: 'spectrogram', maxRows: 12, minRows: 7 },
+    { id: 'caustics', maxRows: 14, minRows: 7 },
+    { id: 'ripple-tank', maxRows: 14, minRows: 7 },
+    { id: 'leds', maxRows: 10, minRows: 7 },
+    { id: 'matrix', maxRows: 14, minRows: 7 },
+    { id: 'cascade', maxRows: 14, minRows: 7 },
+    { id: 'ordered-dither', maxRows: 14, minRows: 7 },
+    { id: 'xor-texture', maxRows: 14, minRows: 7 },
+    { id: 'pixel-crush', maxRows: 14, minRows: 7 },
+    { id: 'copper-bars', maxRows: 14, minRows: 7 },
+    { id: 'rotozoomer', maxRows: 14, minRows: 7 },
+    { id: 'mesh', maxRows: 14, minRows: 7 },
+    { id: 'hologram', maxRows: 12, minRows: 7 },
+    { id: 'mirror', maxRows: 12, minRows: 7 },
+    { id: 'tunnel', maxRows: 14, minRows: 7 },
+    { id: 'kaleidoscope', maxRows: 14, minRows: 7 },
+    { id: 'phosphene', maxRows: 14, minRows: 7 },
+    { id: 'phyllotaxis', maxRows: 14, minRows: 7 },
+    { id: 'chladni', maxRows: 14, minRows: 7 },
+    { id: 'newton', maxRows: 14, minRows: 7 },
+    { id: 'cube', maxRows: 14, minRows: 8 },
+    { id: 'spinning-donut', maxRows: 14, minRows: 8 },
+    { id: 'tesseract', maxRows: 14, minRows: 7 },
+    { id: 'torus-knot', maxRows: 14, minRows: 7 },
+    { id: 'twister', maxRows: 14, minRows: 7 },
+    { id: 'lorenz', maxRows: 14, minRows: 7 },
+    { id: 'fern', maxRows: 14, minRows: 7 },
+    { id: 'fractal-tree', maxRows: 14, minRows: 7 },
+    { id: 'julia', maxRows: 14, minRows: 7 },
+    { id: 'neural-net', maxRows: 14, minRows: 7 },
+    { id: 'constellation', maxRows: 12, minRows: 7 },
+    { id: 'starfield', maxRows: 14, minRows: 7 },
+    { id: 'fireworks', maxRows: 14, minRows: 7 },
+    { id: 'fire', maxRows: 14, minRows: 7 },
+    { id: 'aurora', maxRows: 14, minRows: 7 },
+    { id: 'stormfront', maxRows: 14, minRows: 7 },
+    { id: 'planetarium', maxRows: 14, minRows: 7 },
+    { id: 'sumi-ocean', maxRows: 14, minRows: 7 },
+    { id: 'liftoff', maxRows: 14, minRows: 8, resetPulse: true },
+    { id: 'flyover', maxRows: 14, minRows: 7 },
+    { id: 'skyline', maxRows: 14, minRows: 7 },
+    { id: 'golden-gate', maxRows: 14, minRows: 7 },
+    { id: 'manhattan', maxRows: 14, minRows: 7 },
+    { id: 'alpine', maxRows: 14, minRows: 7 }
+];
+export const receiverStyleNames = receiverStyleRegistry.map(style => style.id);
+export const defaultReceiverStyle = 'ultracode';
+export const receiverStyleMetadata = Object.fromEntries(receiverStyleRegistry.map(style => [style.id, style]));
+const retiredReceiverStyleNames = [
+    'scope', 'spectrum', 'oscilloscope', 'sdr', 'signal', 'retro', 'neon', 'waterfall',
+    'cassette', 'casette', 'stars', 'radio-waves', 'raindrops', 'vinyl', 'soundwave',
+    'spectrum-3d', 'tuning-dial', 'rf-constellation', 'rf-constelation', 'sphere', 'mobius',
+    's-meter', 'jellyfish', 'prism', 'motion-bars', 'motion-dots', 'motion-braid', 'radar',
+    'dual-ripple', 'perspective-floor', 'bloom-bars', 'coral', 'bokeh', 'vector-balls',
+    'smoke', 'running-horse', 'tesla-arcs', 'isometric', 'clockwork', 'starlink',
+    'stained-glass', 'barcode', 'inkblot', 'wave-stack', 'glitch-blocks', 'motion-area',
+    'circuit-pulse', 'shard-field', 'honeycomb', 'magma', 'oil-slick', 'warp-streak',
+    'blocks', 'vu-meters', 'dejong', 'truchet', 'termflix-fire', 'termflix-matrix',
+    'termflix-plasma', 'termflix-starfield', 'termflix-waterfall', 'termflix-radar', 'wave',
+    'life', 'particles', 'pendulum', 'rain', 'fountain', 'flow', 'spiral', 'ocean',
+    'lightning', 'ripple', 'snow', 'garden', 'fireflies', 'dna', 'pulse', 'boids', 'lava',
+    'sandstorm', 'petals', 'campfire', 'eclipse', 'blackhole', 'rainforest', 'crystallize',
+    'hackerman', 'visualizer', 'cells', 'atom', 'automata', 'globe', 'dragon', 'sierpinski',
+    'sierpinksi', 'mandelbrot', 'maze', 'nbody', 'langton', 'sort', 'tetris', 'snake',
+    'invaders', 'pong', 'flappy-bird', 'reaction-diffusion', 'voronoi', 'orbits',
+    'chromatic', 'ferro-crown', 'nautilus', 'vortex-street', 'kinetic-mobile',
+    'harmonic-harp', 'neon-transit', 'lantern-drift', 'murmuration', 'koi-shoal',
+    'calligraphy', 'aperture-bloom', 'kintsugi', 'sonic-loom', 'river-delta',
+    'peacock-plume', 'eclipse-corona', 'cloud-chamber', 'origami-tide', 'tv-static',
+    'sunspot', 'plasma', 'metaballs', 'moonlit-tide', 'motion-blob', 'clifford', 'paris',
+    'kyoto', 'sahara'
+];
+const retiredReceiverStyles = new Set(retiredReceiverStyleNames);
+export function migrateReceiverStyle(value) {
+    if (value === 'equalizer') {
+        return 'ultracode';
+    }
+    if (value === 'sumi-mountains' || value === 'moonlit-tide') {
+        return 'sumi-ocean';
+    }
+    return typeof value === 'string' && retiredReceiverStyles.has(value) ? defaultReceiverStyle : value;
+}