@ciphore/radiocli 0.2.4 → 0.2.6

package/dist/ui/screens/NowPlayingScreen.js

@@ -7,6 +7,7 @@ import { toAsciiSafe } from '../ascii.js';
 import { ScreenHeader } from '../components/ScreenHeader.js';
 import { buildVisualizer, visualizerHeight } from '../visualizers/receiver-visualizers.js';
 import { useReceiverPulse } from '../receiver-animation.js';
+import { ReceiverVisualRow } from '../components/ReceiverVisualRow.js';
 // Terminal rows are roughly twice as tall as columns are wide. One vertical
 // row and three horizontal columns produce a closer optical inset around the
 // highest and lowest visible text than a mechanically equal cell count.
@@ -40,18 +41,8 @@ export function NowPlayingScreen({ station, playback, metadata, theme, favorite,
         : station
             ? 'Waiting for ICY track metadata'
             : 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", "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))) }) : 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 {
-        ...row,
-        text: toAsciiSafe(row.text),
-        segments: row.segments?.map(segment => ({ ...segment, text: toAsciiSafe(segment.text) }))
-    };
+    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: visualRows.map((row, index) => (_jsx(ReceiverVisualRow, { row: row, width: innerWidth, ascii: ascii, backgroundColor: panelBackground }, 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] })] }));
 }
 export function recentTracksForStation(history, station, limit) {
     if (!station) {
@@ -74,13 +65,3 @@ export function receiverStationIdentity(station, width) {
         location: truncate(stationLocation(station).toUpperCase(), locationWidth)
     };
 }
-function renderSegments(segments) {
-    let offset = 0;
-    return segments.map(segment => {
-        // Keep identity tied to geometry, not animated color. Color-bearing keys
-        // forced React to unmount and recreate hundreds of Text nodes per frame.
-        const key = offset;
-        offset += segment.text.length;
-        return (_jsx(Text, { color: segment.color, backgroundColor: segment.backgroundColor, bold: segment.bold, children: segment.text }, key));
-    });
-}

package/dist/ui/screens/SettingsScreen.js

@@ -4,7 +4,7 @@ import { defaultAgentControlSettings } from '../../types.js';
 import { Menu, Pointer } from '../components/Menu.js';
 import { ScreenHeader } from '../components/ScreenHeader.js';
 import { truncate } from '../format.js';
-import { settingsGroup, settingsGroups, settingsItemsForPage } from '../screen-items.js';
+import { settingsGroup, settingsGroupsForAirPlay, settingsItemsForPage } from '../screen-items.js';
 import { textMuted, themeAccent } from '../theme.js';
 import { playbackBackendCapabilities } from '../../player/backend-install.js';
 import { airPlayReceiverSettingValue } from '../airplay-settings.js';
@@ -12,17 +12,17 @@ import { audioOutputLabel, audioOutputSettingValue } from '../audio-output.js';
 import { updateStatusText } from '../../update-check.js';
 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 }) {
+export function SettingsScreen({ platform = process.platform, 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 group = settingsGroup(page);
-    const pageItems = settingsItemsForPage(page);
+    const group = settingsGroup(page, airPlaySupported);
+    const pageItems = settingsItemsForPage(page, airPlaySupported);
     const menuWindow = settingsMenuWindow(pageItems, selected, height);
     const selectedItem = pageItems[selected];
     const detail = page === 'root' && selectedItem !== 'Check for updates'
-        ? settingsGroupsDescription(selectedItem)
+        ? settingsGroupsDescription(selectedItem, airPlaySupported)
         : settingDetail({
             item: selectedItem,
             appVersion,
@@ -39,8 +39,8 @@ export function SettingsScreen({ page = 'root', selected, settings, appVersion,
     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);
+                            ? settingsRootValue(item, airPlaySupported)
+                            : settingValue(item, settings, diagnostics, backends, airPlayDevices, updateCheck, appVersion, platform);
                         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)) })] })] }));
 }
@@ -56,17 +56,17 @@ function settingsMenuWindow(items, selected, height) {
         selectedOffset: clampedSelected - pageStart
     };
 }
-function settingsRootValue(item) {
-    const group = settingsGroupByLabel(item);
+function settingsRootValue(item, airPlayVisible) {
+    const group = settingsGroupByLabel(item, airPlayVisible);
     return group ? `${group.items.length} settings ›` : undefined;
 }
-function settingsGroupByLabel(label) {
-    return settingsGroups.find(group => group.label === label);
+function settingsGroupByLabel(label, airPlayVisible) {
+    return settingsGroupsForAirPlay(airPlayVisible).find(group => group.label === label);
 }
-function settingsGroupsDescription(label) {
-    return label ? settingsGroupByLabel(label)?.description ?? 'Press Enter to open this category.' : '';
+function settingsGroupsDescription(label, airPlayVisible) {
+    return label ? settingsGroupByLabel(label, airPlayVisible)?.description ?? 'Press Enter to open this category.' : '';
 }
-export function settingValue(item, settings, diagnostics, backends, airPlayDevices, updateCheck, currentVersion) {
+export function settingValue(item, settings, diagnostics, backends, airPlayDevices, updateCheck, currentVersion, platform = process.platform) {
     switch (item) {
         case 'Cycle display color':
             return settings.theme;
@@ -81,7 +81,7 @@ export function settingValue(item, settings, diagnostics, backends, airPlayDevic
         case 'Audio output':
             return audioOutputSettingValue(settings, diagnostics, backends);
         case 'AirPlay receiver':
-            return airPlayReceiverSettingValue(settings, airPlayDevices, backends);
+            return airPlayReceiverSettingValue(settings, airPlayDevices, backends, platform);
         case 'Mute or unmute':
             if (!playbackBackendCapabilities(diagnostics.backend).supportsMute) {
                 return 'requires mpv';
@@ -123,7 +123,7 @@ export function settingValue(item, settings, diagnostics, backends, airPlayDevic
 }
 export function settingLabel(item, updateCheck, currentVersion, airPlaySupported = true) {
     if (item === 'AirPlay receiver' && !airPlaySupported) {
-        return 'AirPlay receiver (macOS only)';
+        return 'AirPlay receiver (unavailable)';
     }
     if (item === 'Check for updates') {
         return updateStatusText(updateCheck, currentVersion).endsWith('available') ? 'Install update' : 'Check now';

package/dist/ui/screens/StatsScreen.js

@@ -26,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: _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" })] })] })] }));
+    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), _jsxs(Text, { children: [_jsx(Text, { color: textMuted, children: "Active days: " }), _jsxs(Text, { color: themeAccent(theme), children: [stats.activeDays, "/", stats.totalTrackedDays] })] })] }), _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/text-direction.js

@@ -0,0 +1,9 @@
+import { rightToLeftPattern, strongDirectionPattern } from './bidi-ranges.js';
+/** First-strong direction for single-line text sanitized by sanitizeTerminalText. */
+export function textDirection(text) {
+    // UAX #9 P2/P3: numbers, combining marks, emoji and punctuation generally
+    // don't establish direction. Inspect the whole name, never the moving slice.
+    // Pinned bidi classes avoid relying on locale or the host's ICU version.
+    const first = strongDirectionPattern.exec(text)?.[0];
+    return first && rightToLeftPattern.test(first) ? 'rtl' : 'ltr';
+}

package/dist/ui/theme.js

@@ -13,7 +13,46 @@ export const mapLand = '#33414f';
 export const mapWater = '#1a2430';
 export const mapMarker = '#7dd3fc';
 export const exploreMapLand = '#a0a0c0';
+const additionalThemeAccents = {
+    'acid-yellow': '#f4ff45',
+    'blaze-orange': '#ff8a1f',
+    'hot-magenta': '#ff2bd6',
+    ultramarine: '#6670ff',
+    vermilion: '#dc322f',
+    'dracula-pink': '#ff79c6',
+    'dusty-mauve': '#c49ab3',
+    parchment: '#ddd0aa',
+    'laser-green': '#39ff14',
+    heather: '#b48ead',
+    'soft-silver': '#bfc8cd',
+    tangerine: '#ff5900',
+    scarlet: '#ff1010',
+    raspberry: '#d02068',
+    indigo: '#5540d8',
+    periwinkle: '#9aa8ff',
+    jade: '#299e8c',
+    cobalt: '#0050ff',
+    plum: '#b02e94',
+    cocoa: '#946645',
+    ivory: '#fff4dc',
+    sunflower: '#ffd600',
+    butter: '#fff0a0',
+    olive: '#858e35',
+    apricot: '#ffb875',
+    blush: '#f0c3cb',
+    aubergine: '#793b71',
+    pistachio: '#c5d879',
+    wineberry: '#7e174b',
+    'midnight-teal': '#005d65',
+    'neon-violet': '#7200ff',
+    pine: '#006b3c',
+    chartreuse: '#c8ff00',
+    bronze: '#967400'
+};
 export function themeAccent(theme) {
+    const additionalAccent = additionalThemeAccents[theme];
+    if (additionalAccent)
+        return additionalAccent;
     if (theme === 'amber') {
         return '#ffb000';
     }
@@ -57,6 +96,13 @@ export function themeAccent(theme) {
 }
 export function themeContributionColors(theme) {
     const emptyContribution = '#1c1c1c';
+    const additionalAccent = additionalThemeAccents[theme];
+    if (additionalAccent) {
+        const channels = [1, 3, 5].map(offset => Number.parseInt(additionalAccent.slice(offset, offset + 2), 16));
+        // Blend from the empty cell so dark accents still have visible low levels.
+        const shades = [0.25, 0.5, 0.75].map(intensity => `#${channels.map(channel => Math.round(28 + (channel - 28) * intensity).toString(16).padStart(2, '0')).join('')}`);
+        return [emptyContribution, ...shades, additionalAccent];
+    }
     if (theme === 'amber') {
         return [emptyContribution, '#5f3700', '#9a6200', '#d68a00', '#ffb000'];
     }

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

@@ -3,7 +3,12 @@ import { applyTextInput, clamp, isEditableInput } from './app-state.js';
 import { adjustTime, alarmEditorFields, alarmInputFromDraft, alarmTextFields, cycleWeekdays, defaultAlarmDraft, draftFromAlarm, toggleWeekday, validateAlarmDraft } from './alarm-editor.js';
 import { alarmPickerChoices } from './screens/AlarmsScreen.js';
 export function useAlarmTui(params) {
-    const { service, store, library, setLibrary, screen, selected, setSelected, go, setMessage, playingStation, previewStation } = params;
+    const { service, store, library, setLibrary, screen, screenRef, selected, selectedRef, setSelected: setSelectionState, go, setMessage, playingStation, previewStation } = params;
+    const setSelected = useCallback(next => {
+        const value = typeof next === 'function' ? next(selectedRef.current) : next;
+        selectedRef.current = value;
+        setSelectionState(value);
+    }, [selectedRef, setSelectionState]);
     const [draft, setDraft] = useState(null);
     const [editingField, setEditingField] = useState(false);
     const [editorControl, setEditorControl] = useState(null);
@@ -38,8 +43,6 @@ export function useAlarmTui(params) {
     const activeSelectedKeyRef = useRef(undefined);
     const pendingActiveActionsRef = useRef(new Set());
     const acknowledgedActiveKeysRef = useRef(new Set());
-    const screenRef = useRef(screen);
-    screenRef.current = screen;
     const alarmsRef = useRef(library.alarms);
     alarmsRef.current = library.alarms;
     const visibleFields = useMemo(() => alarmEditorFields.filter(field => {
@@ -67,14 +70,16 @@ export function useAlarmTui(params) {
         for (const key of pendingActiveActionsRef.current)
             if (!liveKeys.has(key))
                 pendingActiveActionsRef.current.delete(key);
-        activeAlarmsRef.current = sessions;
-        setActiveAlarms(sessions);
+        if (JSON.stringify(activeAlarmsRef.current) !== JSON.stringify(sessions)) {
+            activeAlarmsRef.current = sessions;
+            setActiveAlarms(sessions);
+        }
         if (sessions.length > 0 && activeCountRef.current === 0 && screenRef.current !== 'alarm-ringing') {
             returnScreenRef.current = screenRef.current;
             go('alarm-ringing', { resetSelection: true, clearMessage: false });
         }
         activeCountRef.current = sessions.length;
-    }, [go]);
+    }, [go, screenRef]);
     const refreshActive = useCallback(async () => {
         if (activePollingRef.current)
             return;
@@ -186,14 +191,14 @@ export function useAlarmTui(params) {
         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 disabled = await 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);
+            await store.removeAlarm(alarm.id);
             const snapshot = store.snapshot();
             alarmStateRef.current = snapshot.alarms;
             setLibrary(snapshot);
@@ -214,7 +219,7 @@ export function useAlarmTui(params) {
         await refreshRuntime();
         setMessage(message);
     }, [refreshRuntime, service, setLibrary, setMessage, setSelected, store]);
-    const saveDraft = useCallback(() => {
+    const saveDraft = useCallback(async () => {
         if (!draft || savingRef.current)
             return;
         const error = validateAlarmDraft(draft);
@@ -227,7 +232,7 @@ export function useAlarmTui(params) {
         setSaving(true);
         try {
             const input = alarmInputFromDraft(draft);
-            const alarm = draft.id ? store.updateAlarm(draft.id, input) : store.addAlarm(input);
+            const alarm = draft.id ? await store.updateAlarm(draft.id, input) : await store.addAlarm(input);
             setLibrary(store.snapshot());
             setValidationError(null);
             go('alarms', { resetSelection: true, clearMessage: false });
@@ -246,7 +251,7 @@ export function useAlarmTui(params) {
         setSaving(false);
     }, [draft, go, setLibrary, setMessage, store, syncPersisted]);
     const editSelected = useCallback(() => {
-        const alarm = alarmStateRef.current[selected - 1];
+        const alarm = alarmStateRef.current[selectedRef.current - 1];
         if (!alarm)
             return;
         setDraft(draftFromAlarm(alarm));
@@ -260,7 +265,7 @@ export function useAlarmTui(params) {
         setValidationError(null);
         setSelected(0);
         go('alarm-editor', { resetSelection: true });
-    }, [go, library.alarms, selected, setSelected]);
+    }, [go, selectedRef, setSelected]);
     const runVerification = useCallback(() => {
         if (verificationRunningRef.current)
             return;
@@ -277,6 +282,9 @@ export function useAlarmTui(params) {
         void service.verifySetup(alarm, library.settings, update => setVerification(update)).then(report => { setVerification(report); setMessage(report.state === 'passed' ? 'Alarm setup verified. This machine completed every rehearsal step.' : report.state === 'warning' ? 'Alarm setup works, with limitations shown in the verification report.' : 'Alarm setup verification found blockers. Review the failed steps before relying on it.'); }).catch(error => { setVerification(current => ({ ...current ?? initial, state: 'failed', finishedAt: new Date().toISOString(), steps: [...(current?.steps ?? []), { id: 'internal', label: 'Verification runner', state: 'failed', detail: messageOf(error), critical: true }] })); setMessage(`Alarm setup verification failed: ${messageOf(error)}`); }).finally(() => { verificationRunningRef.current = false; void refreshRuntime(); });
     }, [library.settings, refreshRuntime, service, setMessage, store]);
     const handleInput = useCallback((input, key) => {
+        const screen = screenRef.current;
+        const selected = selectedRef.current;
+        const editorField = visibleFields[clamp(selected, visibleFields.length - 1)] ?? 'label';
         if (!['alarms', 'alarm-editor', 'alarm-picker', 'alarm-ringing'].includes(screen))
             return false;
         if (key.scrollDelta) {
@@ -355,11 +363,7 @@ export function useAlarmTui(params) {
                 return true;
             }
             if (input === ' ' && alarm) {
-                const updated = store.toggleAlarm(alarm.id);
-                const snapshot = store.snapshot();
-                alarmStateRef.current = snapshot.alarms;
-                setLibrary(snapshot);
-                void syncPersisted(updated, `${updated.enabled ? 'Enabled' : 'Disabled'} ${updated.label}.`);
+                void (async () => { const updated = await store.toggleAlarm(alarm.id); const snapshot = store.snapshot(); alarmStateRef.current = snapshot.alarms; setLibrary(snapshot); await syncPersisted(updated, `${updated.enabled ? 'Enabled' : 'Disabled'} ${updated.label}.`); })().catch(error => setMessage(`Alarm save failed: ${messageOf(error)}`));
                 return true;
             }
             if (input === 'x' && alarm) {
@@ -408,11 +412,7 @@ export function useAlarmTui(params) {
                 return true;
             }
             if (input === 'g' && alarm) {
-                const updated = store.updateAlarm(alarm.id, { reliability: { ...alarm.reliability, keepAwakeUntilAlarm: !alarm.reliability.keepAwakeUntilAlarm } });
-                const snapshot = store.snapshot();
-                alarmStateRef.current = snapshot.alarms;
-                setLibrary(snapshot);
-                void syncPersisted(updated, `Alarm Guard ${updated.reliability.keepAwakeUntilAlarm ? 'on' : 'off'} for ${alarm.label}.`);
+                void (async () => { const updated = await store.updateAlarm(alarm.id, { reliability: { ...alarm.reliability, keepAwakeUntilAlarm: !alarm.reliability.keepAwakeUntilAlarm } }); const snapshot = store.snapshot(); alarmStateRef.current = snapshot.alarms; setLibrary(snapshot); await syncPersisted(updated, `Alarm Guard ${updated.reliability.keepAwakeUntilAlarm ? 'on' : 'off'} for ${alarm.label}.`); })().catch(error => setMessage(`Alarm save failed: ${messageOf(error)}`));
                 return true;
             }
             if (input === 'b' || key.escape) {
@@ -692,7 +692,7 @@ export function useAlarmTui(params) {
             return true;
         }
         return false;
-    }, [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]);
+    }, [activeAlarms, deleteAlarm, deletingId, draft, editSelected, editingField, editorControl, go, library.alarms, openForStation, pickerChoices, pickerFallback, previewStation, refreshActive, refreshRuntime, runVerification, saveDraft, screenRef, selectedRef, service, setLibrary, setMessage, setSelected, snoozeMinutes, store, syncPersisted, timeSegment, verification, visibleFields, weekdayIndex]);
     const openActive = useCallback(() => {
         if (!activeAlarms.length) {
             setMessage('No alarm is currently playing.');
@@ -704,7 +704,7 @@ export function useAlarmTui(params) {
         activeSelectedKeyRef.current = activeAlarms[0]?.key;
         setActiveSelected(0);
         go('alarm-ringing', { resetSelection: true, clearMessage: false });
-    }, [activeAlarms, go, setMessage]);
+    }, [activeAlarms, go, screenRef, setMessage]);
     return { draft, editorField, editingField, editorControl, timeSegment, weekdayIndex, validationError, saving, pickerChoices, pickerFallback, runtime, verification, activeAlarms, activeSelected, snoozeMinutes, deletingId, busyAlarmIds, itemCount(current) { if (current === 'alarms')
             return library.alarms.length + 2; if (current === 'alarm-editor')
             return visibleFields.length; if (current === 'alarm-picker')

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

@@ -1,25 +1,26 @@
 import { useCallback, useEffect } from 'react';
-import { useInput } from 'ink';
+import { useInput, usePaste } from 'ink';
 import { homeItems, settingsItemsForPage, settingsPageForRootItem } from './screen-items.js';
 import { applyTextInput, favoriteTarget, isEditableInput, isPlainPrintableInput, isSearchFavoriteShortcut, mediaTransportActionForInput, searchEditingArrowAction, shouldHandleKeyboardEvent, shouldTuneSearchResult, shouldToggleNearbyLocationShortcut } from './app-state.js';
 import { parseTerminalMouseEvents, primaryMousePress, wheelScrollDelta } from './terminal-mouse.js';
-import { completeCommand } from './help-content.js';
+import { completeCommand, commandNamesForAirPlay } from './help-content.js';
 import { commitImmediateSelection } from './selection-state.js';
 import { sanitizeTerminalText } from '../safety.js';
-export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, cancelPendingAutoSkip, beginLearningTransportKey, capturingTransportAction, commandMode, commandText, confirmCtrlCExit, copyStationUrl, openStationHomepage, currentItemCount, cycleDisplayColor, cycleAudioOutput, cycleReceiverStyle, cycleSleepTimer, editingCountryFilter, editingSearch, executeCommand, filteredCountries, go, lastRawTransportAtRef, lastSubmittedSearchRef, loadCountry, openAdjacentTab, openAirPlayCode, openAirPlaySettings, openSettingsPage, closeSettingsPage, openScreen, handleAlarmInput, openAlarmForStation, openActiveAlarms, playAdjacent, playStation, player, playingStation, recallSearchHistory, moveExploreCursor, moveExploreCursorToCell, refreshAirPlayTargets, refreshProviderHealth, resetLearnedTransportKeys, repairMcpIntegrations, setAgentIntegrationEnabled, runSearch, saveLearnedTransportKey, screen, settingsPage, searchQuery, selectedRef, selectedStationForInput, selectAirPlayDeviceAt, setCapturingTransportAction, setAirPlayCode, setCommandMode, setCommandText, setCountryFilter, setEditingCountryFilter, setEditingSearch, setMessage, setSearchQuery, setSelected, setShowDiagnostics, submitAirPlayCode, settingsRef, shutdown, stdin, toggleFavorite, toggleMute, togglePause, toggleSetting, toggleAgentSetting, toggleNearbyLocation, toggleDirectoryVoting, toggleRadioGarden, toggleSkipBrokenStreams, updateFromSettings }) {
+export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, airPlaySupported, cancelPendingAutoSkip, beginLearningTransportKey, capturingTransportAction, commandMode, commandText, confirmCtrlCExit, copyStationUrl, openStationHomepage, currentItemCount, cycleDisplayColor, cycleAudioOutput, cycleReceiverStyle, cycleSleepTimer, editingCountryFilter, editingSearch, executeCommand, filteredCountries, go, lastRawTransportAtRef, lastSubmittedSearchRef, loadCountry, openAdjacentTab, openAirPlayCode, openAirPlaySettings, openSettingsPage, closeSettingsPage, openScreen, handleAlarmInput, openAlarmForStation, openActiveAlarms, playAdjacent, playStation, player, playingStation, recallSearchHistory, moveExploreCursor, moveExploreCursorToCell, refreshAirPlayTargets, refreshProviderHealth, resetLearnedTransportKeys, repairMcpIntegrations, setAgentIntegrationEnabled, runSearch, saveLearnedTransportKey, screen, screenRef, settingsPageRef, searchQuery, selectedRef, selectedStationForInput, selectAirPlayDeviceAt, setCapturingTransportAction, setAirPlayCode, setCommandMode, setCommandText, setCountryFilter, setEditingCountryFilter, setEditingSearch, setMessage, setSearchQuery, setSelected, setShowDiagnostics, submitAirPlayCode, settingsRef, shutdown, stdin, toggleFavorite, toggleMute, togglePause, toggleSetting, toggleAgentSetting, toggleNearbyLocation, toggleDirectoryVoting, toggleRadioGarden, toggleSkipBrokenStreams, updateFromSettings }) {
     const reportInputError = useCallback((error) => {
         setMessage(sanitizeTerminalText(error instanceof Error ? error.message : String(error)) ?? 'Could not complete this action.');
     }, [setMessage]);
     const commitSelection = (next) => {
-        commitImmediateSelection(selectedRef, setSelected, next, currentItemCount(screen));
+        commitImmediateSelection(selectedRef, setSelected, next, currentItemCount(screenRef.current));
     };
     const moveSelection = (delta) => {
-        if (hasStationSelection(screen))
+        if (hasStationSelection(screenRef.current))
             cancelPendingAutoSkip();
         commitSelection(selectedRef.current + delta);
     };
     useEffect(() => {
         const handleData = (data) => {
+            const screen = screenRef.current;
             const rawInput = String(data);
             if (capturingTransportAction) {
                 if (rawInput === '\u001B') {
@@ -94,6 +95,7 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, ca
         moveExploreCursorToCell,
         saveLearnedTransportKey,
         screen,
+        screenRef,
         selectedRef,
         setCapturingTransportAction,
         setMessage,
@@ -103,6 +105,8 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, ca
         togglePause
     ]);
     const handleInput = async (input, key) => {
+        const screen = screenRef.current;
+        const settingsPage = settingsPageRef.current;
         if (key.ctrl && input === 'c') {
             confirmCtrlCExit();
             return;
@@ -113,7 +117,10 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, ca
         if (capturingTransportAction) {
             return;
         }
-        if (Date.now() - lastRawTransportAtRef.current < 50) {
+        // Suppress only the mouse/media event already handled by the raw listener.
+        // Other keys in the same chunk (or immediately afterward) must still work.
+        const editingPlainText = isPlainPrintableInput(input) && (commandMode || (screen === 'search' && editingSearch) || ((screen === 'countries' || screen === 'map') && editingCountryFilter));
+        if (!editingPlainText && Date.now() - lastRawTransportAtRef.current < 50 && isRawInputEcho(input, key, settingsRef.current)) {
             return;
         }
         if (commandMode) {
@@ -130,7 +137,7 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, ca
             }
             if (key.tab) {
                 // Complete the command name only while still typing it (no args yet).
-                setCommandText(value => (/\s/.test(value) ? value : completeCommand(value)));
+                setCommandText(value => (/\s/.test(value) ? value : completeCommand(value, commandNamesForAirPlay(airPlaySupported))));
                 return;
             }
             if (isEditableInput(input, key)) {
@@ -440,7 +447,7 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, ca
                 return;
             }
             if (screen === 'settings') {
-                const item = settingsItemsForPage(settingsPage)[selectedRef.current];
+                const item = settingsItemsForPage(settingsPage, airPlaySupported)[selectedRef.current];
                 if (settingsPage === 'root') {
                     const targetPage = settingsPageForRootItem(item);
                     if (targetPage) {
@@ -558,8 +565,35 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, ca
         }
     };
     useInput((input, key) => {
+        // Ink preserves non-escape text chunks for paste, including repeated Tab
+        // bytes. Only a chunk consisting entirely of Tabs represents navigation.
+        if (/^\t{2,}$/.test(input)) {
+            for (let index = 0; index < input.length; index += 1) {
+                void handleInput('', { ...key, tab: true }).catch(reportInputError);
+            }
+            return;
+        }
         void handleInput(input, key).catch(reportInputError);
     });
+    // Keep bracketed paste on its own channel so pasted Tabs stay text. The
+    // existing text/command handling still receives each complete pasted string.
+    usePaste(input => {
+        void handleInput(input, pasteInputKey).catch(reportInputError);
+    });
+}
+const pasteInputKey = {
+    upArrow: false, downArrow: false, leftArrow: false, rightArrow: false,
+    pageDown: false, pageUp: false, home: false, end: false,
+    return: false, escape: false, ctrl: false, shift: false, tab: false,
+    backspace: false, delete: false, meta: false,
+    super: false, hyper: false, capsLock: false, numLock: false
+};
+function isRawInputEcho(input, key, settings) {
+    return Boolean(mediaTransportActionForInput(input, settings.mediaKeys) ||
+        mediaTransportActionForInput(`\u001B${input}`, settings.mediaKeys) ||
+        ((key.shift || key.ctrl || key.meta) && (key.leftArrow || key.rightArrow)) ||
+        /^\[<\d+;\d+;\d+[Mm]$/.test(input) ||
+        input.startsWith('[M'));
 }
 function shouldScrollSelectionWithWheel(screen, commandMode, editingCountryFilter) {
     if (commandMode || editingCountryFilter) {

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

@@ -1,7 +1,7 @@
 import { useCallback } from 'react';
 import { favoriteTarget, normalizeMediaKeyBindings, parseMediaActionName } from './app-state.js';
 import { importStreamUrl } from '../streams/import-stream.js';
-export function useCommandExecutor({ beginLearningTransportKey, countries, go, loadCountry, openAirPlaySettings, openLibrary, persistLibrary, player, playingStation, providers, resetLearnedTransportKeys, runSearch, screen, selectedStation, setCountries, setFilters, setLibrary, setMessage, setSearchQuery, setSleepUntil, setVolume, settingsRef, store, toggleFavorite, toggleMute, updateCommand, updateSettings }) {
+export function useCommandExecutor({ beginLearningTransportKey, cancelPendingTune, countries, go, loadCountry, openAirPlaySettings, openAirPlayCode, openLibrary, persistLibrary, player, playingStation, providers, resetLearnedTransportKeys, runSearch, screen, screenRef, selectedStation, setCountries, setFilters, setLibrary, setMessage, setSearchQuery, setSleepUntil, setVolume, settingsRef, store, toggleFavorite, toggleMute, updateCommand, updateSettings }) {
     return useCallback(async (rawCommand) => {
         const trimmed = rawCommand.trim();
         if (!trimmed) {
@@ -20,16 +20,18 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
                 setMessage('Usage: :country <name or code>');
                 return;
             }
+            const origin = screenRef.current;
             const availableCountries = countries.length > 0 ? countries : await providers.countries();
             if (countries.length === 0) {
                 setCountries(availableCountries);
             }
             const match = availableCountries.find(country => `${country.code} ${country.name}`.toLowerCase().includes(value.toLowerCase()));
             if (!match) {
-                setMessage(`Country not found: ${value}`);
+                if (screenRef.current === origin)
+                    setMessage(`Country not found: ${value}`);
                 return;
             }
-            await loadCountry(match);
+            await loadCountry(match, screenRef.current === origin);
             return;
         }
         if (name === 'codec') {
@@ -63,20 +65,20 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
         }
         if (name === 'location') {
             const enabled = value === 'on' || value === 'true' || value === '1';
-            updateSettings({ enableNearbyLocation: enabled });
+            await updateSettings({ enableNearbyLocation: enabled });
             setMessage(`Nearby location lookup ${enabled ? 'enabled' : 'disabled'}.`);
             return;
         }
         if (name === 'timeout') {
             const seconds = Number(value);
             if (Number.isFinite(seconds)) {
-                updateSettings({ tuneTimeoutSeconds: Math.min(45, Math.max(3, seconds)) });
+                await updateSettings({ tuneTimeoutSeconds: Math.min(45, Math.max(3, seconds)) });
             }
             return;
         }
         if (name === 'skip') {
             const enabled = value !== 'off' && value !== 'false' && value !== '0';
-            updateSettings({ skipBrokenStreams: enabled });
+            await updateSettings({ skipBrokenStreams: enabled });
             return;
         }
         if (name === 'learn' || name === 'bind' || name === 'key') {
@@ -99,10 +101,10 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
         }
         if (name === 'airplay-code' || name === 'airplay-passcode') {
             if (!value.trim()) {
-                go('airplay-code');
+                openAirPlayCode();
                 return;
             }
-            const result = player.submitAirPlayPasscode(value.trim());
+            const result = await player.submitAirPlayPasscode(value.trim());
             if (result.message) {
                 setMessage(result.message);
             }
@@ -139,7 +141,7 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
         }
         if (name === 'export' || name === 'backup') {
             try {
-                const backupPath = store.exportBackup(value || undefined);
+                const backupPath = await store.exportBackup(value || undefined);
                 setMessage(`Backup exported: ${backupPath}`);
             }
             catch (error) {
@@ -156,7 +158,7 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
                 const [url = '', ...nameParts] = rest;
                 setMessage('Reading stream metadata...');
                 const result = await importStreamUrl(url, nameParts.join(' ') || undefined);
-                const nextLibrary = persistLibrary(() => store.addImported([result.station]));
+                const nextLibrary = await persistLibrary(() => store.addImported([result.station]));
                 if (!nextLibrary)
                     return;
                 openLibrary();
@@ -175,7 +177,7 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
                 return;
             }
             try {
-                const result = store.importBackup(value);
+                const result = await store.importBackup(value);
                 settingsRef.current = result.state.settings;
                 setLibrary(result.state);
                 setMessage(result.safetyBackupPath
@@ -192,6 +194,7 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
             return;
         }
         if (name === 'stop') {
+            cancelPendingTune();
             persistLibrary(() => store.finishActiveListeningSession());
             await player.stop();
             return;
@@ -213,18 +216,21 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
                     : name === 'motion'
                         ? 'reduceMotion'
                         : 'transparentBackground';
-            const enabled = value === '' ? !settingsRef.current[key] : value === 'on' || value === 'true' || value === '1';
-            updateSettings({ [key]: enabled });
-            setMessage(`${name} ${enabled ? 'on' : 'off'}.`);
+            const saved = await updateSettings(value === ''
+                ? current => ({ [key]: !current[key] })
+                : { [key]: value === 'on' || value === 'true' || value === '1' });
+            setMessage(`${name} ${saved.settings[key] ? 'on' : 'off'}.`);
             return;
         }
         setMessage(`Unknown command: ${name}`);
     }, [
         beginLearningTransportKey,
+        cancelPendingTune,
         countries,
         go,
         loadCountry,
         openAirPlaySettings,
+        openAirPlayCode,
         openLibrary,
         persistLibrary,
         player,
@@ -233,6 +239,7 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
         resetLearnedTransportKeys,
         runSearch,
         screen,
+        screenRef,
         selectedStation,
         setCountries,
         setFilters,