@ciphore/radiocli 0.2.2 → 0.2.4

package/dist/ui/screens/ExploreScreen.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from 'react';
 import { Box, Text } from 'ink';
+import { formatExploreCursor } from '../app-state.js';
 import { StationList } from '../components/StationList.js';
 import { buildCosmoWorldMap } from '../cosmo-world-map.js';
 import { computeExploreMapLayout } from '../explore-map-layout.js';
@@ -14,7 +15,7 @@ export function ExploreScreen({ title, subtitle, stations, selected, loading, er
     const { contentWidth, headerRows, bodyRows, split, listPanelWidth, mapPanelWidth, mapRows, mapColumns, mapOffsetX, listRows, listPageSize } = computeExploreMapLayout(width, height, pageSize);
     const cursorMarker = React.useMemo(() => [{ lat: cursor.latitude, lon: cursor.longitude, selected: true }], [cursor.latitude, cursor.longitude]);
     const map = React.useMemo(() => buildCosmoWorldMap(mapColumns, mapRows, cursorMarker), [mapColumns, mapRows, cursorMarker]);
-    return (_jsxs(Box, { flexDirection: "column", height: height, width: contentWidth, overflow: "hidden", flexShrink: 0, children: [_jsx(Box, { height: headerRows, flexDirection: "column", flexShrink: 0, children: _jsx(ScreenHeader, { title: title, subtitle: subtitle, width: contentWidth, theme: theme, right: filterLabel === 'none' ? undefined : `filters: ${filterLabel}` }) }), _jsxs(Box, { marginTop: 1, height: bodyRows, width: contentWidth, flexDirection: split ? 'row' : 'column', flexShrink: 0, children: [_jsx(Box, { borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: mapPanelWidth, height: split ? bodyRows : mapRows + 2, flexDirection: "column", children: _jsx(Box, { marginLeft: mapOffsetX, flexDirection: "column", flexShrink: 0, children: map.map((row, index) => (_jsx(CosmoMapLine, { row: row, theme: theme }, `map-${index}`))) }) }), _jsxs(Box, { marginLeft: split ? 1 : 0, marginTop: split ? 0 : 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: listPanelWidth, height: split ? bodyRows : Math.max(5, listRows + 2), flexDirection: "column", children: [_jsxs(Box, { justifyContent: "space-between", width: Math.max(20, listPanelWidth - 2), children: [_jsx(Text, { color: themeAccent(theme), bold: true, children: "Stations" }), _jsx(Text, { color: textMuted, children: stations.length.toLocaleString() })] }), _jsx(Box, { height: 1, flexShrink: 0, children: _jsx(Text, { color: textMuted, children: loading
+    return (_jsxs(Box, { flexDirection: "column", height: height, width: contentWidth, overflow: "hidden", flexShrink: 0, children: [_jsx(Box, { height: headerRows, flexDirection: "column", flexShrink: 0, children: _jsx(ScreenHeader, { title: title, subtitle: subtitle, width: contentWidth, theme: theme, right: filterLabel === 'none' ? undefined : `filters: ${filterLabel}` }) }), _jsxs(Box, { marginTop: 1, height: bodyRows, width: contentWidth, flexDirection: split ? 'row' : 'column', flexShrink: 0, children: [_jsx(Box, { borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: mapPanelWidth, height: split ? bodyRows : mapRows + 2, flexDirection: "column", "aria-label": `World map cursor: ${formatExploreCursor(cursor)}`, children: _jsx(Box, { marginLeft: mapOffsetX, flexDirection: "column", flexShrink: 0, children: map.map((row, index) => (_jsx(CosmoMapLine, { row: row, theme: theme }, `map-${index}`))) }) }), _jsxs(Box, { marginLeft: split ? 1 : 0, marginTop: split ? 0 : 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: listPanelWidth, height: split ? bodyRows : Math.max(5, listRows + 2), flexDirection: "column", children: [_jsxs(Box, { justifyContent: "space-between", width: Math.max(20, listPanelWidth - 2), children: [_jsx(Text, { color: themeAccent(theme), bold: true, children: "Stations" }), _jsx(Text, { color: textMuted, children: stations.length.toLocaleString() })] }), _jsx(Box, { height: 1, flexShrink: 0, children: _jsx(Text, { color: textMuted, children: loading
                                         ? (ascii ? toAsciiSafe('Loading stations…') : 'Loading stations…')
                                         : error
                                             ? truncate(ascii ? toAsciiSafe(error) : error, Math.max(1, listPanelWidth - 2))

package/dist/ui/screens/HelpScreen.js

@@ -5,7 +5,11 @@ import { ScreenHeader } from '../components/ScreenHeader.js';
 import { commandHelp, keyHelpSections } from '../help-content.js';
 import { padDisplayEnd, truncate } from '../format.js';
 import { visibleWindow } from '../list-window.js';
+import { useDisplay } from '../display-context.js';
+import { toAsciiSafe } from '../ascii.js';
 export function HelpScreen({ theme, width, height, selected }) {
+    const { ascii } = useDisplay();
+    const a = (value) => ascii ? toAsciiSafe(value) : value;
     const accent = themeAccent(theme);
     const keyColumnWidth = 16;
     const lineWidth = Math.max(28, width - 2);
@@ -22,5 +26,5 @@ export function HelpScreen({ theme, width, height, selected }) {
         }))
     ];
     const window = visibleWindow(rows, selected, Math.max(3, height - 4));
-    return (_jsxs(Box, { flexDirection: "column", height: height, overflow: "hidden", children: [_jsx(ScreenHeader, { title: "Help", subtitle: "Keyboard shortcuts and : commands \u00B7 b or Esc to close", width: width, theme: theme }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: window.items.map(row => row.heading ? (_jsx(Text, { color: accent, bold: true, children: row.heading }, row.key)) : (_jsxs(Text, { children: [_jsx(Text, { color: accent, children: padDisplayEnd(truncate(row.keys ?? '', keyColumnWidth - 1), keyColumnWidth) }), _jsx(Text, { color: textMuted, children: truncate(row.description ?? '', Math.max(1, lineWidth - keyColumnWidth)) })] }, row.key))) }), _jsxs(Text, { color: textMuted, children: ["Showing ", window.start + 1, "-", window.end, " of ", rows.length, " \u00B7 \u2191/\u2193 scroll"] })] }));
+    return (_jsxs(Box, { flexDirection: "column", height: height, overflow: "hidden", children: [_jsx(ScreenHeader, { title: "Help", subtitle: "Keyboard shortcuts and : commands \u00B7 b or Esc to close", width: width, theme: theme }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: window.items.map(row => row.heading ? (_jsx(Text, { color: accent, bold: true, children: row.heading }, row.key)) : (_jsxs(Text, { children: [_jsx(Text, { color: accent, children: a(padDisplayEnd(truncate(row.keys ?? '', keyColumnWidth - 1), keyColumnWidth)) }), _jsx(Text, { color: textMuted, children: a(truncate(row.description ?? '', Math.max(1, lineWidth - keyColumnWidth))) })] }, row.key))) }), _jsx(Text, { color: textMuted, children: a(`Showing ${window.start + 1}-${window.end} of ${rows.length} · ↑/↓ scroll`) })] }));
 }

package/dist/ui/screens/HomeScreen.js

@@ -4,6 +4,12 @@ import { Logo } from '../components/Logo.js';
 import { Menu, Pointer } from '../components/Menu.js';
 import { textMuted, themeAccent } from '../theme.js';
 import { homeItems } from '../screen-items.js';
+import { displayWidth } from '../format.js';
+import { useDisplay } from '../display-context.js';
+import { toAsciiSafe } from '../ascii.js';
 export function HomeScreen({ selected, theme, library }) {
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Logo, {}), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Menu, { items: homeItems, selected: selected, keyFor: item => item.screen, render: (item, index, active) => (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsxs(Text, { color: textMuted, children: [index + 1, " "] }), _jsx(Text, { color: active ? themeAccent(theme) : undefined, bold: active, children: item.label }), _jsxs(Text, { color: textMuted, children: [" \u00B7 ", item.detail] })] })) }) }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: textMuted, children: [library.recent.length, " recent \u00B7 ", library.favorites.length, " favorites \u00B7 ", library.imported.length, " imported"] }) })] }));
+    const { ascii } = useDisplay();
+    const summary = `${library.recent.length} recent · ${library.favorites.length} favorites · ${library.imported.length} imported`;
+    const titleWidth = Math.max(...homeItems.map(item => displayWidth(item.label))) + 2;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Logo, {}), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Menu, { items: homeItems, selected: selected, keyFor: item => item.screen, render: (item, index, active) => (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsxs(Text, { color: textMuted, children: [index + 1, " "] }), _jsx(Box, { width: titleWidth, children: _jsx(Text, { color: active ? themeAccent(theme) : undefined, bold: active, children: item.label }) }), _jsxs(Text, { color: textMuted, children: ["  ", item.detail] })] })) }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: textMuted, children: ascii ? toAsciiSafe(summary) : summary }) })] }));
 }

package/dist/ui/screens/MapScreen.js

@@ -18,7 +18,7 @@ export function MapScreen({ countries, selected, loading, filter, editingFilter,
     const graph = buildWorldMap(countries, selectedCountry, mode, contentWidth);
     const topWidth = mode === 'full' ? 50 : contentWidth;
     const listWidth = Math.max(28, Math.min(contentWidth - topWidth - 4, 56));
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "World map", subtitle: editingFilter ? 'Filtering country list — type to narrow' : 'Station density by country', width: contentWidth, theme: theme, right: filter ? `filter: ${filter}` : undefined }), loading ? _jsx(Text, { color: textMuted, children: asciify('Loading country density…') }) : null, _jsx(Box, { marginTop: 1, flexDirection: "column", children: graph.rows.map((row, index) => (_jsx(MapLine, { row: row, theme: theme }, `map-row-${index}`))) }), _jsx(Text, { color: textMuted, children: asciify(`${graph.plotted} plotted · ${graph.unplotted} unplaced · labels show highest station counts`) }), _jsxs(Box, { marginTop: 1, flexDirection: mode === 'full' ? 'row' : 'column', children: [_jsxs(Box, { width: topWidth, flexDirection: "column", children: [_jsx(Text, { color: textMuted, children: "Highest station counts" }), topCountries.map(country => (_jsxs(Text, { children: [_jsx(Text, { color: themeAccent(theme), children: country.code.padEnd(3) }), _jsx(Text, { children: padDisplayEnd(truncate(country.name, 30), 31) }), _jsx(Text, { color: textMuted, children: country.stationCount.toLocaleString().padStart(7) })] }, country.code)))] }), _jsx(Box, { marginLeft: mode === 'full' ? 3 : 0, marginTop: mode === 'full' ? 0 : 1, width: listWidth, flexDirection: "column", children: _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.code }), _jsx(Text, { color: textMuted, children: asciify(` · ${truncate(country.name, Math.max(8, listWidth - 8))}`) })] })) }) })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "World map", subtitle: editingFilter ? 'Filtering country list — type to narrow' : 'Station density by country', width: contentWidth, theme: theme, right: filter ? `filter: ${filter}` : undefined }), loading ? _jsx(Text, { color: textMuted, children: asciify('Loading country density…') }) : null, _jsx(Box, { marginTop: 1, flexDirection: "column", "aria-hidden": true, children: graph.rows.map((row, index) => (_jsx(MapLine, { row: row, theme: theme }, `map-row-${index}`))) }), _jsx(Text, { color: textMuted, children: asciify(`${graph.plotted} plotted · ${graph.unplotted} unplaced · labels show highest station counts`) }), _jsxs(Box, { marginTop: 1, flexDirection: mode === 'full' ? 'row' : 'column', children: [_jsxs(Box, { width: topWidth, flexDirection: "column", children: [_jsx(Text, { color: textMuted, children: "Highest station counts" }), topCountries.map(country => (_jsxs(Text, { children: [_jsx(Text, { color: themeAccent(theme), children: country.code.padEnd(3) }), _jsx(Text, { children: padDisplayEnd(truncate(country.name, 30), 31) }), _jsx(Text, { color: textMuted, children: country.stationCount.toLocaleString().padStart(7) })] }, country.code)))] }), _jsx(Box, { marginLeft: mode === 'full' ? 3 : 0, marginTop: mode === 'full' ? 0 : 1, width: listWidth, flexDirection: "column", children: _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.code }), _jsx(Text, { color: textMuted, children: asciify(` · ${truncate(country.name, Math.max(8, listWidth - 8))}`) })] })) }) })] })] }));
 }
 function MapLine({ row, theme }) {
     const { ascii } = useDisplay();

package/dist/ui/screens/NowPlayingScreen.js

@@ -14,7 +14,7 @@ const receiverPaddingX = 3;
 const receiverPaddingY = 1;
 export function NowPlayingScreen({ station, playback, metadata, theme, favorite, diagnostics, showDiagnostics, stationTime, receiverStyle, trackHistory, width, height }) {
     const pulse = useReceiverPulse();
-    const { panel: panelBackground, ascii } = useDisplay();
+    const { panel: panelBackground, ascii, screenReader } = useDisplay();
     // In ASCII mode route every rendered string through the glyph mapper so no
     // braille, block, box-drawing, or punctuation (·, ★) leaks to the terminal.
     const a = (value) => (ascii ? toAsciiSafe(value) : value);
@@ -28,7 +28,7 @@ export function NowPlayingScreen({ station, playback, metadata, theme, favorite,
     // visualization equally separated from the header and track title.
     const visualizerGutterRows = 1;
     const visualHeight = visualizerHeight(receiverStyle, panelHeight - (showDiagnostics ? 10 : 5) - visualizerGutterRows, innerWidth);
-    const visualRows = buildVisualizer(receiverStyle, pulse, innerWidth, visualHeight, station, playback, theme);
+    const visualRows = screenReader ? [] : buildVisualizer(receiverStyle, pulse, innerWidth, visualHeight, station, playback, theme);
     const receiverState = playback.state.toUpperCase();
     const identityWidth = Math.max(8, innerWidth - displayWidth(receiverState) - 2);
     const stationIdentity = receiverStationIdentity(station, identityWidth);
@@ -42,9 +42,9 @@ export function NowPlayingScreen({ station, playback, metadata, theme, favorite,
             : infoFallback;
     const renderRows = ascii ? visualRows.map(asciifyVisualRow) : visualRows;
     const favoriteText = favorite ? '★ Favorite' : '☆ Favorite';
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Now playing", width: panelWidth, theme: theme }), _jsxs(Box, { borderStyle: panelBorderStyle(ascii), borderColor: accent, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, flexDirection: "column", paddingX: receiverPaddingX, paddingY: receiverPaddingY, width: panelWidth, height: panelHeight, children: [_jsxs(Box, { justifyContent: "space-between", width: innerWidth, flexShrink: 0, children: [_jsxs(Box, { width: identityWidth, overflow: "hidden", children: [_jsx(Text, { color: accent, bold: true, children: a(stationIdentity.name) }), stationIdentity.location ? _jsx(Text, { color: textMuted, children: a(` · ${stationIdentity.location}`) }) : null] }), _jsx(Text, { color: accent, children: receiverState })] }), _jsx(Box, { marginTop: visualizerGutterRows, flexDirection: "column", flexShrink: 1, overflow: "hidden", children: renderRows.map((row, index) => (_jsx(Text, { color: row.segments ? undefined : row.color, children: row.segments
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Now playing", width: panelWidth, theme: theme }), _jsxs(Box, { borderStyle: panelBorderStyle(ascii), borderColor: accent, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, flexDirection: "column", paddingX: receiverPaddingX, paddingY: receiverPaddingY, width: panelWidth, height: panelHeight, children: [_jsxs(Box, { justifyContent: "space-between", width: innerWidth, flexShrink: 0, children: [_jsxs(Box, { width: identityWidth, overflow: "hidden", "aria-label": `Station: ${station?.name ?? 'No station tuned'}${station ? `, ${stationLocation(station)}` : ''}`, children: [_jsx(Text, { color: accent, bold: true, children: a(stationIdentity.name) }), stationIdentity.location ? _jsx(Text, { color: textMuted, children: a(` · ${stationIdentity.location}`) }) : null] }), _jsx(Text, { color: accent, "aria-label": `Playback: ${playback.state}, ${playback.muted ? 'muted' : `volume ${playback.volume}`}`, children: receiverState })] }), !screenReader ? _jsx(Box, { marginTop: visualizerGutterRows, flexDirection: "column", flexShrink: 1, overflow: "hidden", "aria-hidden": true, children: renderRows.map((row, index) => (_jsx(Text, { color: row.segments ? undefined : row.color, children: row.segments
                                 ? renderSegments(row.segments)
-                                : row.text }, index))) }), _jsxs(Box, { marginTop: visualizerGutterRows, justifyContent: "space-between", width: innerWidth, flexShrink: 0, children: [_jsx(Text, { color: metadata?.title ? accent : textMuted, children: a(metadataLine) }), _jsx(Text, { color: favorite ? 'yellow' : textMuted, children: a(favoriteText) })] }), showDiagnostics ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, children: "Diagnostics" }), _jsx(Text, { color: textMuted, children: a(`Stream: ${diagnostics.streamUrl ? truncate(diagnostics.streamUrl, innerWidth - 8) : 'none'}`) }), _jsx(Text, { color: textMuted, children: a(`Station time: ${stationTime}`) }), _jsx(Text, { color: textMuted, children: a(`Started: ${diagnostics.startedAt ? new Date(diagnostics.startedAt).toLocaleTimeString() : 'not playing'} · available ${diagnostics.availableBackends.join(', ') || 'none'}`) }), stationTracks.length > 0 ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: textMuted, children: "Recent tracks" }), stationTracks.map(track => (_jsx(Text, { color: textMuted, children: a(`· ${truncate(track.title, innerWidth - 2)}`) }, `${track.at}-${track.title}`)))] })) : null] })) : null] })] }));
+                                : row.text }, index))) }) : null, _jsxs(Box, { marginTop: visualizerGutterRows, justifyContent: "space-between", width: innerWidth, flexShrink: 0, children: [_jsx(Text, { color: metadata?.title ? accent : textMuted, "aria-label": metadata?.title ? `Track: ${metadata.title}` : undefined, children: a(metadataLine) }), _jsx(Text, { color: favorite ? 'yellow' : textMuted, "aria-label": favorite ? 'Favorite' : 'Not a favorite', children: a(favoriteText) })] }), showDiagnostics ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, children: "Diagnostics" }), _jsx(Text, { color: textMuted, children: a(`Stream: ${diagnostics.streamUrl ? truncate(diagnostics.streamUrl, innerWidth - 8) : 'none'}`) }), _jsx(Text, { color: textMuted, children: a(`Station time: ${stationTime}`) }), _jsx(Text, { color: textMuted, children: a(`Started: ${diagnostics.startedAt ? new Date(diagnostics.startedAt).toLocaleTimeString() : 'not playing'} · available ${diagnostics.availableBackends.join(', ') || 'none'}`) }), stationTracks.length > 0 ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: textMuted, children: "Recent tracks" }), stationTracks.map(track => (_jsx(Text, { color: textMuted, children: a(`· ${truncate(track.title, innerWidth - 2)}`) }, `${track.at}-${track.title}`)))] })) : null] })) : null] })] }));
 }
 function asciifyVisualRow(row) {
     return {

package/dist/ui/screens/SearchScreen.js

@@ -5,10 +5,12 @@ import { ScreenHeader } from '../components/ScreenHeader.js';
 import { panelBorder, textMuted, themeAccent } from '../theme.js';
 import { panelBorderStyle, useDisplay } from '../display-context.js';
 import { truncate } from '../format.js';
+import { toAsciiSafe } from '../ascii.js';
 export function SearchScreen({ query, editing, loading, stations, selected, theme, favorites, experimentalOn, filterLabel, pageSize, width }) {
     const { panel: panelBackground, ascii } = useDisplay();
+    const a = (value) => ascii ? toAsciiSafe(value) : value;
     const contentWidth = Math.max(40, width);
     const inputWidth = Math.max(34, Math.min(contentWidth, 96));
     const inputTextWidth = Math.max(8, inputWidth - 8);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Search", subtitle: `Radio Browser${experimentalOn ? ' + Radio Garden experimental' : ''}`, width: width, theme: theme, right: filterLabel === 'none' ? undefined : `filters: ${filterLabel}` }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: editing ? themeAccent(theme) : panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: inputWidth, height: 3, marginBottom: 1, flexShrink: 0, children: [_jsx(Text, { color: editing ? themeAccent(theme) : textMuted, children: editing ? '› ' : '  ' }), _jsx(Text, { color: query ? themeAccent(theme) : textMuted, children: truncate(query || 'Search stations, genres, languages, places…', inputTextWidth) })] }), loading ? _jsx(Text, { color: textMuted, children: "Searching station directories\u2026" }) : null, !loading || stations.length > 0 ? (_jsx(StationList, { stations: stations, selected: selected, theme: theme, favorites: favorites, pageSize: pageSize, width: width, emptyTitle: query ? `No matches for “${query}”.` : 'Search for a station, genre, language, or place.', emptyHint: query ? 'Try fewer words or clear active filters.' : 'Type above and press Enter.' })) : null] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Search", subtitle: `Radio Browser${experimentalOn ? ' + Radio Garden experimental' : ''}`, width: width, theme: theme, right: filterLabel === 'none' ? undefined : `filters: ${filterLabel}` }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: editing ? themeAccent(theme) : panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: inputWidth, height: 3, marginBottom: 1, flexShrink: 0, children: [_jsx(Text, { color: editing ? themeAccent(theme) : textMuted, children: a(editing ? '› ' : '  ') }), _jsx(Text, { color: query ? themeAccent(theme) : textMuted, children: a(truncate(query || 'Search stations, genres, languages, places…', inputTextWidth)) })] }), loading ? _jsx(Text, { color: textMuted, children: a('Searching station directories…') }) : null, !loading || stations.length > 0 ? (_jsx(StationList, { stations: stations, selected: selected, theme: theme, favorites: favorites, pageSize: pageSize, width: width, emptyTitle: query ? `No matches for “${query}”.` : 'Search for a station, genre, language, or place.', emptyHint: query ? 'Try fewer words or clear active filters.' : 'Type above and press Enter.' })) : null] }));
 }

package/dist/ui/screens/SettingsScreen.js

@@ -1,73 +1,72 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
+import { defaultAgentControlSettings } from '../../types.js';
 import { Menu, Pointer } from '../components/Menu.js';
 import { ScreenHeader } from '../components/ScreenHeader.js';
 import { truncate } from '../format.js';
-import { settingsItems, settingsSectionFor } from '../screen-items.js';
+import { settingsGroup, settingsGroups, settingsItemsForPage } from '../screen-items.js';
 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';
 import { updateStatusText } from '../../update-check.js';
-export function SettingsScreen({ selected, settings, appVersion, updateCheck, storePath, playback, backends, airPlayDevices, providerHealth, theme, diagnostics, width, height }) {
+import { useDisplay } from '../display-context.js';
+import { toAsciiSafe } from '../ascii.js';
+export function SettingsScreen({ page = 'root', selected, settings, appVersion, updateCheck, storePath, playback, backends, airPlayDevices, providerHealth, theme, diagnostics, width, height, airPlaySupported = true }) {
+    const { ascii } = useDisplay();
+    const a = (value) => ascii ? toAsciiSafe(value) : value;
     const accent = themeAccent(theme);
     const lineWidth = Math.max(32, width - 4);
-    const menuWindow = settingsMenuWindow(selected, height);
-    const selectedItem = settingsItems[selected];
-    const activeSection = settingsSectionFor(selectedItem);
-    const detail = settingDetail({
-        item: selectedItem,
-        appVersion,
-        updateCheck,
-        storePath,
-        playback,
-        providerHealth,
-        diagnostics,
-        lineWidth
-    });
+    const group = settingsGroup(page);
+    const pageItems = settingsItemsForPage(page);
+    const menuWindow = settingsMenuWindow(pageItems, selected, height);
+    const selectedItem = pageItems[selected];
+    const detail = page === 'root' && selectedItem !== 'Check for updates'
+        ? settingsGroupsDescription(selectedItem)
+        : settingDetail({
+            item: selectedItem,
+            appVersion,
+            updateCheck,
+            storePath,
+            playback,
+            providerHealth,
+            diagnostics,
+            lineWidth
+        });
     const valueGap = 3;
     const labelWidth = Math.min(34, Math.max(20, lineWidth - valueGap - 24));
     const valueWidth = Math.max(12, Math.min(34, lineWidth - labelWidth - valueGap - 2));
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Settings", subtitle: activeSection, width: width, theme: theme }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Menu, { items: menuWindow.items, selected: menuWindow.selectedOffset, 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, { flexDirection: "column", children: [item.showSection ? (_jsx(Text, { color: textMuted, bold: true, children: item.section })) : null, _jsxs(Box, { width: lineWidth, children: [_jsx(Pointer, { active: active }), _jsx(Box, { width: labelWidth, children: _jsx(Text, { color: active ? accent : undefined, bold: active, children: truncate(label, labelWidth) }) }), _jsx(Box, { width: valueGap }), _jsx(Box, { width: valueWidth, children: _jsx(Text, { color: value ? accent : textMuted, children: truncate(value ?? '', valueWidth) }) })] })] }));
-                    } }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, bold: true, children: "Selected" }), _jsx(Text, { color: textMuted, children: truncate(detail, lineWidth) })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Settings", subtitle: group ? `Settings › ${group.label}` : 'Choose a category', width: width, theme: theme }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsx(Menu, { items: menuWindow.items, selected: menuWindow.selectedOffset, keyFor: item => item, render: (item, _index, active) => {
+                        const label = settingLabel(item, updateCheck, appVersion, airPlaySupported);
+                        const value = page === 'root'
+                            ? settingsRootValue(item)
+                            : settingValue(item, settings, diagnostics, backends, airPlayDevices, updateCheck, appVersion);
+                        return (_jsxs(Box, { width: lineWidth, children: [_jsx(Pointer, { active: active }), _jsx(Box, { width: labelWidth, children: _jsx(Text, { color: active ? accent : undefined, bold: active, children: a(truncate(label, labelWidth)) }) }), _jsx(Box, { width: valueGap }), _jsx(Box, { width: valueWidth, children: _jsx(Text, { color: value ? accent : textMuted, children: a(truncate(value ?? '', valueWidth)) }) })] }));
+                    } }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, bold: true, children: "Selected" }), _jsx(Text, { color: textMuted, children: a(truncate(detail, lineWidth)) })] })] }));
 }
-function settingsMenuWindow(selected, height) {
+function settingsMenuWindow(items, selected, height) {
     const reservedRows = 6;
     const maxRows = height ? Math.max(5, height - reservedRows) : Number.POSITIVE_INFINITY;
-    const clampedSelected = Math.min(Math.max(selected, 0), settingsItems.length - 1);
-    const pages = [];
-    let page = [];
-    let pageRows = 0;
-    let previousSection = '';
-    settingsItems.forEach((item, index) => {
-        const section = settingsSectionFor(item);
-        let showSection = section !== previousSection;
-        let rowCost = 1 + (showSection ? 1 : 0);
-        if (page.length > 0 && pageRows + rowCost > maxRows) {
-            pages.push(page);
-            page = [];
-            pageRows = 0;
-            previousSection = '';
-            showSection = true;
-            rowCost = 2;
-        }
-        page.push({ item, section, showSection, index });
-        pageRows += rowCost;
-        previousSection = section;
-    });
-    if (page.length > 0) {
-        pages.push(page);
-    }
-    const selectedPage = pages.find(candidate => candidate.some(entry => entry.index === clampedSelected)) ?? pages[0] ?? [];
+    const clampedSelected = Math.min(Math.max(selected, 0), items.length - 1);
+    const pageSize = Number.isFinite(maxRows) ? Math.max(1, Math.floor(maxRows)) : items.length;
+    const pageStart = Math.floor(clampedSelected / pageSize) * pageSize;
+    const selectedPage = items.slice(pageStart, pageStart + pageSize);
     return {
-        items: selectedPage,
-        selectedOffset: Math.max(0, selectedPage.findIndex(entry => entry.index === clampedSelected))
+        items: [...selectedPage],
+        selectedOffset: clampedSelected - pageStart
     };
 }
-export function settingValue(item, settings, diagnostics, backends, airPlayDevices, updateCheck) {
+function settingsRootValue(item) {
+    const group = settingsGroupByLabel(item);
+    return group ? `${group.items.length} settings ›` : undefined;
+}
+function settingsGroupByLabel(label) {
+    return settingsGroups.find(group => group.label === label);
+}
+function settingsGroupsDescription(label) {
+    return label ? settingsGroupByLabel(label)?.description ?? 'Press Enter to open this category.' : '';
+}
+export function settingValue(item, settings, diagnostics, backends, airPlayDevices, updateCheck, currentVersion) {
     switch (item) {
         case 'Cycle display color':
             return settings.theme;
@@ -100,21 +99,34 @@ export function settingValue(item, settings, diagnostics, backends, airPlayDevic
             return settings.reduceMotion ? 'on' : 'off';
         case 'Mouse and trackpad scrolling':
             return settings.mouseSupport === false ? 'off' : 'auto';
+        case 'Automatically check for updates':
+            return settings.automaticUpdateChecks === false ? 'off' : 'on';
+        case 'Allow local agent control':
+            return (settings.agentControl ?? defaultAgentControlSettings).enabled ? 'on' : 'off';
+        case 'Install or repair MCP integrations':
+            return 'run repair';
+        case 'Open TUI for agent playback':
+            return (settings.agentControl ?? defaultAgentControlSettings).openUiOnPlay ? 'on' : 'off';
+        case 'Show Now Playing for agent playback':
+            return (settings.agentControl ?? defaultAgentControlSettings).focusNowPlaying ? 'on' : 'off';
         case 'Check for updates':
-            return updateStatusText(updateCheck);
+            return updateStatusText(updateCheck, currentVersion);
         case 'Reset learned media keys':
             return `prev ${settings.mediaKeys.previous.length} · play ${settings.mediaKeys.playPause.length} · next ${settings.mediaKeys.next.length}`;
         case 'Export preferences and library':
             return 'JSON backup';
-        case 'Import preferences and library':
+        case 'Restore preferences and library':
             return 'restore JSON backup';
         default:
             return undefined;
     }
 }
-export function settingLabel(item, updateCheck) {
-    if (item === 'Check for updates' && updateCheck?.updateAvailable) {
-        return 'Install update';
+export function settingLabel(item, updateCheck, currentVersion, airPlaySupported = true) {
+    if (item === 'AirPlay receiver' && !airPlaySupported) {
+        return 'AirPlay receiver (macOS only)';
+    }
+    if (item === 'Check for updates') {
+        return updateStatusText(updateCheck, currentVersion).endsWith('available') ? 'Install update' : 'Check now';
     }
     return settingDisplayLabels[item] ?? item;
 }
@@ -135,9 +147,12 @@ function settingDetail(input) {
         return health.length ? health.map(([provider, status]) => `${provider}: ${status}`).join(' · ') : 'Press Enter to check station providers.';
     }
     if (item === 'Check for updates') {
-        return `RadioCLI v${appVersion} · ${updateStatusText(updateCheck)}`;
+        return `RadioCLI v${appVersion} · ${updateStatusText(updateCheck, appVersion)}`;
+    }
+    if (item === 'Automatically check for updates') {
+        return 'When enabled, RadioCLI checks the registry once whenever the app launches.';
     }
-    if (item === 'Export preferences and library' || item === 'Import preferences and library') {
+    if (item === 'Export preferences and library' || item === 'Restore preferences and library') {
         return `Library file: ${truncate(storePath, Math.max(8, lineWidth - 14))}`;
     }
     if (item === 'Share favorite votes with Radio Browser') {
@@ -149,5 +164,14 @@ function settingDetail(input) {
     if (item === 'Reduce motion') {
         return 'Freezes animated receiver displays for calmer, lower-power rendering.';
     }
+    if (item === 'Allow local agent control') {
+        return 'Press Enter to set up or remove agent and Codex Voice control across detected clients.';
+    }
+    if (item === 'Install or repair MCP integrations') {
+        return 'Checks and repairs every detected client. Restart open Codex or agent clients afterward.';
+    }
+    if (item === 'Open TUI for agent playback') {
+        return 'Opt in to a separate terminal window. On macOS, the agent app must approve a one-time Automation prompt.';
+    }
     return 'Press Enter to change this setting.';
 }

package/dist/ui/screens/StatsScreen.js

@@ -6,6 +6,7 @@ import { panelBorder, textMuted, themeAccent, themeContributionColors } from '..
 import { panelBorderStyle, useDisplay } from '../display-context.js';
 import { ScreenHeader } from '../components/ScreenHeader.js';
 import { truncate } from '../format.js';
+import { toAsciiSafe } from '../ascii.js';
 const monthLabels = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
 const dayLabelWidth = 5;
 // Two terminal columns are approximately one row high in common monospace
@@ -15,6 +16,7 @@ const heatmapCell = '  ';
 const heatmapGap = '';
 export function StatsScreen({ library, theme, width, height }) {
     const { panel: panelBackground, ascii } = useDisplay();
+    const a = (value) => ascii ? toAsciiSafe(value) : value;
     const stats = computeListeningStats(library.activity.sessions);
     const contentWidth = Math.max(20, width - 4);
     const graph = buildContributionGraph(stats.days, contentWidth, height);
@@ -24,7 +26,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 }), _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" })] })] })] }));
+    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: _jsx(Text, { color: themeAccent(theme), bold: true, children: a(`Activity — ${graph.year}`) }) }), _jsxs(Box, { flexDirection: "column", "aria-label": `Activity graph: ${stats.activeDays} active days in ${graph.year}`, 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', a(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, "aria-hidden": true, children: [_jsx(Text, { color: textMuted, children: a('Less · ') }), 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 = [];

package/dist/ui/system-actions.js

@@ -1,65 +1,93 @@
 import { spawn } from 'node:child_process';
-import { resolveCommand } from '../player/command.js';
+import { resolveCommand } from '../platform/executables.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') {
-        // Direct invocation avoids cmd.exe interpreting URL query characters.
-        return { command: 'explorer', args: [] };
-    }
-    return { command: 'xdg-open', args: [] };
-}
-// Candidate clipboard tools per platform, in priority order. pbcopy/clip ship
-// with macOS/Windows; Linux/BSD rely on whichever of these is installed.
-export function clipboardCommands(platform = process.platform) {
-    if (platform === 'darwin') {
-        return [{ command: 'pbcopy', args: [] }];
-    }
-    if (platform === 'win32') {
-        return [{ command: 'clip', args: [] }];
-    }
-    return [
-        { command: 'wl-copy', args: [] },
-        { command: 'xclip', args: ['-selection', 'clipboard'] },
-        { command: 'xsel', args: ['--clipboard', '--input'] }
-    ];
-}
-export function openExternal(url, platform = process.platform) {
+import { browserCommands, clipboardCandidates, hasGraphicalSession } from '../platform/desktop.js';
+import { identifyPlatform } from '../platform/runtime.js';
+import { waitForLaunch } from '../platform/launch-command.js';
+export async function openExternal(url, platform = process.platform, deps = {}) {
     const safeUrl = safeExternalHttpUrl(url);
-    if (!safeUrl) {
+    const env = deps.env ?? process.env;
+    const host = identifyPlatform({ platform, env });
+    if (!safeUrl || !hasGraphicalSession(host, env))
         return false;
+    for (const { command, args } of browserCommands(host)) {
+        const executable = (deps.resolve ?? resolveCommand)(command);
+        if (!executable)
+            continue;
+        try {
+            // xdg-open may run for the browser's entire lifetime. Observe startup
+            // failure, then let the desktop application own its detached process.
+            const child = (deps.spawn ?? spawn)(executable, [...args, safeUrl], { stdio: 'ignore', env, detached: true, windowsHide: true });
+            await waitForLaunch(child);
+            return true;
+        }
+        catch { /* Try the next available opener after a launch failure. */ }
     }
-    const { command, args } = openExternalCommand(platform);
-    try {
-        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 async function copyToClipboard(text, platform = process.platform, deps = {}) {
+    const env = deps.env ?? process.env;
+    const host = identifyPlatform({ platform, env });
+    if (!hasGraphicalSession(host, env))
         return false;
+    for (const { command, args } of clipboardCandidates(host)) {
+        const executable = (deps.resolve ?? resolveCommand)(command);
+        if (executable && await runHelper(executable, args, text, deps))
+            return true;
     }
+    return false;
 }
-export function copyToClipboard(text, platform = process.platform) {
-    for (const { command, args } of clipboardCommands(platform)) {
-        const resolved = resolveCommand(command);
-        if (!resolved) {
-            continue;
-        }
+function runHelper(command, args, input, deps) {
+    return new Promise(resolve => {
+        let child;
+        let settled = false;
+        let stopping = false;
+        let forceTimer;
+        let cleanupTimer;
+        const signal = (value) => {
+            try {
+                child?.kill(value);
+            }
+            catch { /* The failed action remains false; cleanup is still bounded. */ }
+        };
+        const finish = (ok) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            clearTimeout(forceTimer);
+            clearTimeout(cleanupTimer);
+            resolve(ok);
+        };
+        const stop = () => {
+            if (settled || stopping)
+                return;
+            stopping = true;
+            forceTimer = setTimeout(() => signal('SIGKILL'), 250);
+            cleanupTimer = setTimeout(() => {
+                // Even an uninterruptible OS process must not keep RadioCLI alive.
+                child?.unref();
+                finish(false);
+            }, 1_000);
+            child?.stdin?.destroy();
+            signal('SIGTERM');
+        };
+        const timer = setTimeout(stop, deps.timeoutMs ?? 5000);
         try {
-            const child = spawn(resolved, args, { stdio: ['pipe', 'ignore', 'ignore'] });
-            child.on('error', () => undefined);
-            child.stdin.write(text);
-            child.stdin.end();
-            return true;
+            child = (deps.spawn ?? spawn)(command, args, { stdio: ['pipe', 'ignore', 'ignore'], env: deps.env ?? process.env, windowsHide: true });
+            child.on('error', () => { if (child?.pid)
+                stop();
+            else
+                finish(false); });
+            child.once('close', code => finish(!stopping && code === 0));
+            child.stdin?.on('error', stop);
+            child.stdin?.end(input);
         }
         catch {
-            continue;
+            if (child?.pid)
+                stop();
+            else
+                finish(false);
         }
-    }
-    return false;
+    });
 }

package/dist/ui/terminal-renderer.js

@@ -0,0 +1,16 @@
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+import { resolveTerminalCapabilities } from '../platform/terminal.js';
+/**
+ * Ink uses Chalk's shared instance for both text and panel fills. FORCE_COLOR
+ * is a minimum in Chalk, so setting it cannot cap a Windows/CI/truecolor host
+ * at 16 or 256 colors. Set the instance's level before the first Ink render.
+ * Resolve from Ink itself so nested dependency installations work as well.
+ */
+export async function configureTerminalRenderer(env = process.env, evidence = {}) {
+    const terminal = resolveTerminalCapabilities(env, evidence);
+    const inkRequire = createRequire(import.meta.resolve('ink'));
+    const { default: chalk } = await import(pathToFileURL(inkRequire.resolve('chalk')).href);
+    chalk.level = terminal.colorLevel;
+    return terminal;
+}

package/dist/ui/use-alarm-tui.js

@@ -180,6 +180,40 @@ export function useAlarmTui(params) {
         }
         await refreshRuntime();
     }, [refreshRuntime, service, setMessage]);
+    const deleteAlarm = useCallback(async (alarm) => {
+        let phase = 'disable';
+        let message;
+        try {
+            // Persist the safe state before touching native jobs. A failed cleanup
+            // can then be retried without another write in the error handler.
+            const disabled = store.toggleAlarm(alarm.id, false);
+            const disabledSnapshot = store.snapshot();
+            alarmStateRef.current = disabledSnapshot.alarms;
+            setLibrary(disabledSnapshot);
+            phase = 'native';
+            await service.remove(disabled);
+            phase = 'definition';
+            store.removeAlarm(alarm.id);
+            const snapshot = store.snapshot();
+            alarmStateRef.current = snapshot.alarms;
+            setLibrary(snapshot);
+            setSelected(value => clamp(value, snapshot.alarms.length + 1));
+            message = `Deleted ${alarm.label}.`;
+        }
+        catch (error) {
+            message = phase === 'disable'
+                ? `Delete canceled: ${messageOf(error)}. Alarm and native jobs unchanged.`
+                : phase === 'native'
+                    ? `Delete cleanup failed: ${messageOf(error)}. ${alarm.label} was kept disabled; press r to repair.`
+                    : `Native cleanup completed. Save failed: ${messageOf(error)}. ${alarm.label} was kept disabled; retry deletion.`;
+        }
+        finally {
+            busyAlarmIdsRef.current.delete(alarm.id);
+            setBusyAlarmIds(new Set(busyAlarmIdsRef.current));
+        }
+        await refreshRuntime();
+        setMessage(message);
+    }, [refreshRuntime, service, setLibrary, setMessage, setSelected, store]);
     const saveDraft = useCallback(() => {
         if (!draft || savingRef.current)
             return;
@@ -343,26 +377,7 @@ export function useAlarmTui(params) {
                 setDeletingId(undefined);
                 busyAlarmIdsRef.current.add(alarm.id);
                 setBusyAlarmIds(new Set(busyAlarmIdsRef.current));
-                void service.remove(alarm).then(() => {
-                    if (store.getAlarm(alarm.id))
-                        store.removeAlarm(alarm.id);
-                    const snapshot = store.snapshot();
-                    alarmStateRef.current = snapshot.alarms;
-                    setLibrary(snapshot);
-                    setSelected(value => clamp(value, snapshot.alarms.length + 1));
-                    setMessage(`Deleted ${alarm.label}.`);
-                }).catch(error => {
-                    const existing = store.getAlarm(alarm.id);
-                    if (existing) {
-                        const disabled = store.toggleAlarm(alarm.id, false);
-                        const snapshot = store.snapshot();
-                        alarmStateRef.current = snapshot.alarms;
-                        setLibrary(snapshot);
-                        setMessage(`Delete cleanup failed; ${disabled.label} was kept disabled so Repair can retry: ${messageOf(error)}`);
-                    }
-                    else
-                        setMessage(`Delete cleanup failed after the local alarm disappeared: ${messageOf(error)}`);
-                }).finally(() => { busyAlarmIdsRef.current.delete(alarm.id); setBusyAlarmIds(new Set(busyAlarmIdsRef.current)); void refreshRuntime(); });
+                void deleteAlarm(alarm).catch(error => setMessage(`Unexpected alarm deletion failure: ${messageOf(error)}`));
                 return true;
             }
             if (input !== 'x') {
@@ -461,6 +476,10 @@ export function useAlarmTui(params) {
             if (!active)
                 return false;
             if (key.return) {
+                if (active.status.state === 'starting') {
+                    setMessage(`Still preparing ${active.status.stationName}; handoff will be available once playback starts.`);
+                    return true;
+                }
                 if (pendingActiveActionsRef.current.has(active.key)) {
                     setMessage(`An alarm control request is already pending for ${active.status.stationName}.`);
                     return true;
@@ -673,7 +692,7 @@ export function useAlarmTui(params) {
             return true;
         }
         return false;
-    }, [activeAlarms, deletingId, draft, editSelected, editingField, editorControl, editorField, go, library.alarms, openForStation, pickerChoices, pickerFallback, previewStation, refreshActive, refreshRuntime, runVerification, saveDraft, screen, selected, service, setLibrary, setMessage, setSelected, snoozeMinutes, store, syncPersisted, timeSegment, verification, visibleFields, weekdayIndex]);
+    }, [activeAlarms, deleteAlarm, deletingId, draft, editSelected, editingField, editorControl, editorField, go, library.alarms, openForStation, pickerChoices, pickerFallback, previewStation, refreshActive, refreshRuntime, runVerification, saveDraft, screen, selected, service, setLibrary, setMessage, setSelected, snoozeMinutes, store, syncPersisted, timeSegment, verification, visibleFields, weekdayIndex]);
     const openActive = useCallback(() => {
         if (!activeAlarms.length) {
             setMessage('No alarm is currently playing.');