@ciphore/radiocli 0.2.3 → 0.2.5

package/dist/ui/rtl-output.js

@@ -0,0 +1,137 @@
+import { stripVTControlCharacters } from 'node:util';
+import { rightToLeftPattern, strongDirectionPattern } from './bidi-ranges.js';
+import { displayWidth } from './format.js';
+// Ink writes complete VT sequences. Keep OSC payloads (titles, hyperlinks) out
+// of text analysis, and treat cursor controls as boundaries between text runs.
+const controls = /\u001B(?:\[[0-?]*[ -/]*[@-~]|\][^\u0007\u001B]*(?:\u0007|\u001B\\)|[78@-_])|[\u0000-\u001F\u007F]/gu;
+const sgr = /^\u001B\[[\d;:]*m$/u;
+const segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+/**
+ * Yoga's boxes become a single terminal row, not independently positioned
+ * fields. Guard fixed fields and borders against terminal-side shaping in
+ * mixed RTL rows by explicitly positioning the columns around each RTL run.
+ * Apple Terminal's xterm profile also gets Unicode isolates to contain stored
+ * row reordering independently of cursor reports. Keep those opt-in: older
+ * Linux/BSD consoles may print unsupported format marks.
+ * Ordinary LTR output stays byte-for-byte unchanged.
+ *
+ * Apply only to Ink's interactive stdout, after its cell layout/tokenization:
+ * inserting zero-width bidi marks into Text would itself consume Ink cells.
+ */
+export function rtlSafeOutput(stdout, env = process.env) {
+    const isolate = env.TERM_PROGRAM === 'Apple_Terminal' && /^xterm(?:-|$)/i.test(env.TERM ?? '');
+    let column = 0;
+    let savedColumn;
+    const position = (control) => {
+        if (control === '\n' || control === '\r')
+            column = 0;
+        else if (control === '\b' && column !== undefined)
+            column = Math.max(0, column - 1);
+        else if (control === '\t' && column !== undefined)
+            column = (Math.floor(column / 8) + 1) * 8;
+        else if (control === '\u001B7' || control === '\u001B[s')
+            savedColumn = column;
+        else if (control === '\u001B8' || control === '\u001B[u')
+            column = savedColumn;
+        else {
+            const csi = /^\u001B\[([\d;]*)([G`CDaHEFf])$/u.exec(control);
+            if (!csi)
+                return;
+            const parameters = csi[1].split(';').map(value => Number(value) || 1);
+            const command = csi[2];
+            if (command === 'G' || command === '`')
+                column = parameters[0] - 1;
+            else if (command === 'H' || command === 'f')
+                column = (parameters[1] ?? 1) - 1;
+            else if (command === 'E' || command === 'F')
+                column = 0;
+            else if (column !== undefined)
+                column = Math.max(0, column + (command === 'D' ? -1 : 1) * parameters[0]);
+        }
+    };
+    const text = (span, endsRow = false) => {
+        const plain = stripVTControlCharacters(span);
+        const hasRtl = rightToLeftPattern.test(plain);
+        // Animation frames contain many art-only rows. Their next newline resets
+        // the column, so do not remeasure thousands of unchanged visualizer cells.
+        if (!hasRtl && endsRow)
+            return span;
+        const startColumn = column;
+        if (column !== undefined)
+            column += displayWidth(plain);
+        if (startColumn === undefined || !hasRtl)
+            return span;
+        const runs = [];
+        let first;
+        let last;
+        let offset = startColumn;
+        const finish = () => {
+            if (first && last)
+                runs.push({ first, last });
+            first = undefined;
+            last = undefined;
+        };
+        // Segment the complete visible text: SGR can occur inside a combining or
+        // emoji cluster. Map its UTF-16 edges back to the original styled span.
+        const indices = [];
+        let from = 0;
+        for (const match of span.matchAll(new RegExp(controls))) {
+            for (let index = from; index < match.index; index++)
+                indices.push(index);
+            from = match.index + match[0].length;
+        }
+        for (let index = from; index < span.length; index++)
+            indices.push(index);
+        // Neutral characters between RTL words belong to the same run, preserving
+        // Arabic word order without absorbing trailing padding or fixed fields.
+        for (const part of segmenter.segment(plain)) {
+            const width = displayWidth(part.segment);
+            const strong = strongDirectionPattern.exec(part.segment)?.[0];
+            if (strong && rightToLeftPattern.test(strong)) {
+                first ??= { index: indices[part.index], column: offset };
+                last = { index: indices[part.index + part.segment.length - 1] + 1, column: offset + width };
+            }
+            else if (strong)
+                finish();
+            offset += width;
+        }
+        finish();
+        const at = (value) => `\u001B[${value + 1}G`;
+        let result = '';
+        from = 0;
+        for (const run of runs) {
+            result += span.slice(from, run.first.index) + at(run.first.column)
+                + (isolate ? '\u2067' : '') + span.slice(run.first.index, run.last.index)
+                + (isolate ? '\u2069' : '') + at(run.last.column);
+            from = run.last.index;
+        }
+        return result + span.slice(from);
+    };
+    const transform = (value) => {
+        let result = '';
+        let from = 0;
+        for (const match of value.matchAll(new RegExp(controls))) {
+            if (sgr.test(match[0]))
+                continue;
+            result += text(value.slice(from, match.index), match[0] === '\n' || match[0] === '\r') + match[0];
+            position(match[0]);
+            from = match.index + match[0].length;
+        }
+        return result + text(value.slice(from));
+    };
+    const write = (chunk, ...args) => {
+        // Ink frames are strings. Preserve other writes and their encoding/callback
+        // contract; resume anchoring only after a known cursor position or newline.
+        if (typeof chunk !== 'string')
+            column = undefined;
+        return Reflect.apply(stdout.write, stdout, [typeof chunk === 'string' ? transform(chunk) : chunk, ...args]);
+    };
+    return new Proxy(stdout, {
+        get(target, key) {
+            if (key === 'write')
+                return write;
+            const value = Reflect.get(target, key, target);
+            return typeof value === 'function' ? value.bind(target) : value;
+        }
+    });
+}

package/dist/ui/screen-items.js

@@ -1,6 +1,6 @@
 export const homeItems = [
     { screen: 'now-playing', label: 'Playing', detail: 'Receiver display and controls' },
-    { screen: 'library', label: 'Library', detail: 'Favorites, recent stations, imported streams' },
+    { screen: 'library', label: 'Library', detail: 'Favorites, imported streams, recent stations' },
     { screen: 'explore', label: 'Explore', detail: 'Move a map cursor through geotagged stations' },
     { screen: 'search', label: 'Search', detail: 'Find stations by name, genre, language, place' },
     { screen: 'countries', label: 'Countries', detail: 'Browse by country list with a world-map toggle' },
@@ -54,7 +54,7 @@ export const settingsGroups = [
         description: 'Back up or restore preferences and saved stations',
         items: [
             'Export preferences and library',
-            'Import preferences and library'
+            'Restore preferences and library'
         ]
     },
     {
@@ -91,11 +91,17 @@ export const settingsGroups = [
 ];
 export const settingsItems = settingsGroups.flatMap(group => group.items);
 export const settingsRootItems = settingsGroups.map(group => group.label);
-export function settingsGroup(page) {
-    return settingsGroups.find(group => group.id === page);
+export function settingsGroupsForAirPlay(visible = true) {
+    return settingsGroups.map(group => ({ ...group,
+        description: !visible && group.id === 'playback' ? 'Output, volume, and startup behavior' : group.description,
+        items: group.items.filter(item => visible || item !== 'AirPlay receiver')
+    }));
 }
-export function settingsItemsForPage(page) {
-    return page === 'root' ? settingsRootItems : settingsGroup(page)?.items ?? [];
+export function settingsGroup(page, airPlayVisible = true) {
+    return settingsGroupsForAirPlay(airPlayVisible).find(group => group.id === page);
+}
+export function settingsItemsForPage(page, airPlayVisible = true) {
+    return page === 'root' ? settingsRootItems : settingsGroup(page, airPlayVisible)?.items ?? [];
 }
 export function settingsPageForRootItem(item) {
     return settingsGroups.find(group => group.label === item)?.id;

package/dist/ui/screen-meta.js

@@ -12,7 +12,7 @@ export const primaryScreens = [
 export const screenMetadata = {
     home: { tabLabel: 'Overview', title: 'Overview', description: 'Your listening at a glance' },
     'now-playing': { tabLabel: 'Playing', title: 'Now playing', description: 'Receiver and playback controls' },
-    library: { tabLabel: 'Library', title: 'Library', description: 'Favorites, recents, and imported streams' },
+    library: { tabLabel: 'Library', title: 'Library', description: 'Favorites, imported streams, and recents' },
     explore: { tabLabel: 'Explore', title: 'Explore', description: 'Discover stations on the world map' },
     search: { tabLabel: 'Search', title: 'Search', description: 'Find stations, genres, languages, or places' },
     countries: { tabLabel: 'Countries', title: 'Countries', description: 'Browse stations by country' },

package/dist/ui/screens/AirPlayCodeScreen.js

@@ -2,16 +2,20 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { ScreenHeader } from '../components/ScreenHeader.js';
 import { truncate } from '../format.js';
+import { useDisplay } from '../display-context.js';
+import { toAsciiSafe } from '../ascii.js';
 import { textDim, textMuted, themeAccent } from '../theme.js';
 export function AirPlayCodeScreen({ code, playback, selectedDevice, theme, width }) {
+    const { ascii } = useDisplay();
+    const a = (value) => ascii ? toAsciiSafe(value) : value;
     const accent = themeAccent(theme);
     const lineWidth = Math.max(24, width - 4);
     const promptActive = isAirPlayCodePromptActive(playback);
     const receiverName = playback.airPlayDeviceName ?? selectedDevice?.name ?? 'selected receiver';
     const masked = code.length > 0 ? '*'.repeat(code.length) : '';
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "AirPlay Code", subtitle: "Enter the code shown on the receiver", right: promptActive ? 'Waiting for code' : 'Not requested', width: width, theme: theme }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: textMuted, children: ["Receiver: ", _jsx(Text, { color: accent, children: truncate(receiverName, Math.max(8, lineWidth - 10)) })] }), _jsxs(Text, { color: textMuted, children: ["Playback: ", _jsx(Text, { color: accent, children: playback.backend }), " / ", playback.state] }), _jsx(Text, { color: promptActive ? accent : 'yellow', children: promptActive
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "AirPlay Code", subtitle: "Enter the code shown on the receiver", right: promptActive ? 'Waiting for code' : 'Not requested', width: width, theme: theme }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: textMuted, children: ["Receiver: ", _jsx(Text, { color: accent, children: a(truncate(receiverName, Math.max(8, lineWidth - 10))) })] }), _jsxs(Text, { color: textMuted, children: ["Playback: ", _jsx(Text, { color: accent, children: playback.backend }), " / ", playback.state] }), _jsx(Text, { color: promptActive ? accent : 'yellow', children: promptActive
                             ? 'The receiver is asking for a code now.'
-                            : 'Tune a station with AirPlay first; this screen is used once the receiver asks for a code.' })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, bold: true, children: "Code" }), _jsx(Text, { color: code ? accent : textDim, children: code ? masked : 'type the code from the receiver' }), _jsx(Text, { color: textDim, children: "Enter submits \u00B7 Backspace edits \u00B7 Esc returns to AirPlay" })] })] }));
+                            : 'Tune a station with AirPlay first; this screen is used once the receiver asks for a code.' })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, bold: true, children: "Code" }), _jsx(Text, { color: code ? accent : textDim, children: code ? masked : 'type the code from the receiver' }), _jsx(Text, { color: textDim, children: a('Enter submits · Backspace edits · Esc returns to AirPlay') })] })] }));
 }
 export function isAirPlayCodePromptActive(playback) {
     return playback.backend === 'airplay' && playback.message === 'AirPlay code required. Use :airplay-code 1234.';

package/dist/ui/screens/AirPlaySettingsScreen.js

@@ -7,20 +7,24 @@ import { ScreenHeader } from '../components/ScreenHeader.js';
 import { truncate } from '../format.js';
 import { textDim, textMuted, themeAccent } from '../theme.js';
 import { visibleWindow } from '../list-window.js';
-export function AirPlaySettingsScreen({ selected, settings, backends, devices, theme, width, height }) {
+import { useDisplay } from '../display-context.js';
+import { toAsciiSafe } from '../ascii.js';
+export function AirPlaySettingsScreen({ platform = process.platform, selected, settings, backends, devices, theme, width, height }) {
+    const { ascii } = useDisplay();
+    const a = (value) => ascii ? toAsciiSafe(value) : value;
     const accent = themeAccent(theme);
-    const availability = airPlayAvailability(backends, devices);
+    const availability = airPlayAvailability(backends, devices, platform);
     const selectedDevice = selectedAirPlayDevice(settings, devices);
     const selectedMissing = Boolean(settings.preferredAirPlayDevice && !selectedDevice);
     const canEnterCode = availability.ready && selectedDevice?.requiresPassword && !selectedDevice.local;
     const lineWidth = Math.max(24, width - 4);
     const preferredOutput = audioOutputLabel(settings.preferredBackend);
     const deviceWindow = visibleWindow(devices, selected, height ? Math.max(1, height - 9) : Math.max(1, devices.length));
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "AirPlay", subtitle: "Choose where AirPlay playback should go", right: availability.label, width: width, theme: theme }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: textMuted, children: ["Audio output: ", _jsx(Text, { color: accent, children: preferredOutput }), " \u00B7 Streaming:", ' ', _jsx(Text, { color: availability.ready ? accent : 'yellow', children: availability.ready ? 'ready' : 'unavailable' }), " \u00B7 Receivers:", ' ', _jsx(Text, { color: accent, children: devices.length })] }), _jsx(Text, { color: availability.ready ? textMuted : 'yellow', children: truncate(availability.detail, lineWidth) }), _jsxs(Text, { color: textMuted, children: ["Selected: ", _jsx(Text, { color: selectedDevice ? accent : textDim, children: truncate(selectedDevice?.name ?? 'none', Math.max(4, lineWidth - 10)) })] }), availability.ready && selectedDevice?.requiresPassword && !selectedDevice.local ? (_jsxs(Text, { color: textMuted, children: ["Code: ", _jsx(Text, { color: accent, children: "if the receiver shows a code while tuning, RadioCLI will ask for it" })] })) : null, selectedMissing ? (_jsxs(Text, { color: "yellow", children: ["Saved receiver is not visible: ", truncate(settings.preferredAirPlayDevice ?? '', Math.max(8, lineWidth - 31))] })) : null] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, bold: true, children: "Receivers" }), devices.length > 0 ? (_jsx(Menu, { items: deviceWindow.items, selected: selected - deviceWindow.start, keyFor: device => device.id, render: (device, _index, active) => {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "AirPlay", subtitle: "Choose where AirPlay playback should go", right: availability.label, width: width, theme: theme }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: textMuted, children: ["Audio output: ", _jsx(Text, { color: accent, children: preferredOutput }), a(' · Streaming: '), _jsx(Text, { color: availability.ready ? accent : 'yellow', children: availability.ready ? 'ready' : 'unavailable' }), a(' · Receivers: '), _jsx(Text, { color: accent, children: devices.length })] }), _jsx(Text, { color: availability.ready ? textMuted : 'yellow', children: a(truncate(availability.detail, lineWidth)) }), _jsxs(Text, { color: textMuted, children: ["Selected: ", _jsx(Text, { color: selectedDevice ? accent : textDim, children: a(truncate(selectedDevice?.name ?? 'none', Math.max(4, lineWidth - 10))) })] }), availability.ready && selectedDevice?.requiresPassword && !selectedDevice.local ? (_jsxs(Text, { color: textMuted, children: ["Code: ", _jsx(Text, { color: accent, children: "if the receiver shows a code while tuning, RadioCLI will ask for it" })] })) : null, selectedMissing ? (_jsxs(Text, { color: "yellow", children: ["Saved receiver is not visible: ", a(truncate(settings.preferredAirPlayDevice ?? '', Math.max(8, lineWidth - 31)))] })) : null] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: textMuted, bold: true, children: "Receivers" }), devices.length > 0 ? (_jsx(Menu, { items: deviceWindow.items, selected: selected - deviceWindow.start, keyFor: device => device.id, render: (device, _index, active) => {
                             const isSelected = device.id === settings.preferredAirPlayDevice;
                             const name = truncate(device.name, Math.max(8, Math.floor(lineWidth * 0.35)));
                             const selectedLabel = isSelected ? ' selected' : '';
-                            const detail = truncate(airPlayDeviceDetail(device), Math.max(12, lineWidth - name.length - selectedLabel.length - 5));
-                            return (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsx(Text, { color: active ? accent : undefined, bold: active, children: name }), isSelected ? _jsx(Text, { color: accent, children: selectedLabel }) : null, _jsxs(Text, { color: textMuted, children: [" \u00B7 ", detail] })] }));
-                        } })) : (_jsx(Text, { color: textMuted, children: "No receivers discovered." })), _jsx(Text, { color: textDim, children: canEnterCode ? 'Enter selects · c opens code entry · r refreshes receivers' : 'Enter selects · r refreshes receivers' })] })] }));
+                            const detail = truncate(airPlayDeviceDetail(device, platform), Math.max(12, lineWidth - name.length - selectedLabel.length - 5));
+                            return (_jsxs(Box, { children: [_jsx(Pointer, { active: active }), _jsx(Text, { color: active ? accent : undefined, bold: active, children: a(name) }), isSelected ? _jsx(Text, { color: accent, children: selectedLabel }) : null, _jsx(Text, { color: textMuted, children: a(` · ${detail}`) })] }));
+                        } })) : (_jsx(Text, { color: textMuted, children: "No receivers discovered." })), _jsx(Text, { color: textDim, children: a(canEnterCode ? 'Enter selects · c opens code entry · r refreshes receivers' : 'Enter selects · r refreshes receivers') })] })] }));
 }

package/dist/ui/screens/AlarmsScreen.js

@@ -1,7 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from 'react';
 import { Box, Text } from 'ink';
 import { draftNextOccurrence } from '../alarm-editor.js';
-import { nextOccurrenceForAlarm } from '../../alarms/schedule.js';
+import { AlarmOccurrenceCache } from '../../alarms/occurrence-cache.js';
 import { stationKey } from '../../storage/store.js';
 import { visibleWindow } from '../list-window.js';
 import { ScreenHeader } from '../components/ScreenHeader.js';
@@ -15,10 +16,12 @@ export function AlarmsScreen({ alarms, selected, runtime, verification, deleting
     const { ascii, reduceMotion } = useDisplay();
     const a = (value) => ascii ? toAsciiSafe(value) : value;
     const mode = requestedMode ?? (width < 34 ? 'micro' : width < 68 ? 'compact' : 'full');
+    const occurrenceCache = useMemo(() => new AlarmOccurrenceCache(), []);
     if (verification)
         return _jsx(AlarmVerificationScreen, { report: verification, theme: theme, width: width, height: height });
     const status = schedulerStatus(runtime, mode);
-    const next = alarms.map(alarm => ({ alarm, occurrence: nextOccurrenceForAlarm(alarm, new Date()) })).filter(item => item.occurrence).sort((a, b) => a.occurrence.getTime() - b.occurrence.getTime())[0];
+    const now = new Date();
+    const next = alarms.map(alarm => ({ alarm, occurrence: occurrenceCache.next(alarm, now) })).filter(item => item.occurrence).sort((a, b) => a.occurrence.getTime() - b.occurrence.getTime())[0];
     const noticeRows = height >= 11 ? 2 : 1;
     const rows = Math.max(1, height - 5 - noticeRows);
     const items = [{ kind: 'create' }, ...alarms.map(alarm => ({ kind: 'alarm', alarm })), { kind: 'verify' }];

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

@@ -2,10 +2,14 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { textMuted, themeAccent } from '../theme.js';
 import { ScreenHeader } from '../components/ScreenHeader.js';
-import { commandHelp, keyHelpSections } from '../help-content.js';
+import { commandHelpForAirPlay, keyHelpSections } from '../help-content.js';
 import { padDisplayEnd, truncate } from '../format.js';
 import { visibleWindow } from '../list-window.js';
-export function HelpScreen({ theme, width, height, selected }) {
+import { useDisplay } from '../display-context.js';
+import { toAsciiSafe } from '../ascii.js';
+export function HelpScreen({ theme, width, height, selected, airPlaySupported = true }) {
+    const { ascii } = useDisplay();
+    const a = (value) => ascii ? toAsciiSafe(value) : value;
     const accent = themeAccent(theme);
     const keyColumnWidth = 16;
     const lineWidth = Math.max(28, width - 2);
@@ -15,12 +19,12 @@ export function HelpScreen({ theme, width, height, selected }) {
             ...section.entries.map(entry => ({ key: `${section.title}-${entry.keys}`, ...entry }))
         ]),
         { key: 'commands', heading: 'Commands (press : then type)' },
-        ...commandHelp.map(command => ({
+        ...commandHelpForAirPlay(airPlaySupported).map(command => ({
             key: `command-${command.name}`,
             keys: `:${command.name}${command.args ? ` ${command.args}` : ''}`,
             description: command.description
         }))
     ];
     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

@@ -5,7 +5,11 @@ 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 }) {
+    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: _jsxs(Text, { color: textMuted, children: [library.recent.length, " recent \u00B7 ", library.favorites.length, " favorites \u00B7 ", library.imported.length, " imported"] }) })] }));
+    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

@@ -4,21 +4,25 @@ 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';
 import { audioOutputLabel, audioOutputSettingValue } from '../audio-output.js';
 import { updateStatusText } from '../../update-check.js';
-export function SettingsScreen({ page = 'root', 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({ 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,
@@ -33,12 +37,12 @@ export function SettingsScreen({ page = 'root', selected, settings, appVersion,
     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: 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);
+                        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: 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) })] })] }));
+                            ? 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)) })] })] }));
 }
 function settingsMenuWindow(items, selected, height) {
     const reservedRows = 6;
@@ -52,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;
@@ -77,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';
@@ -111,13 +115,16 @@ export function settingValue(item, settings, diagnostics, backends, airPlayDevic
             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, currentVersion) {
+export function settingLabel(item, updateCheck, currentVersion, airPlaySupported = true) {
+    if (item === 'AirPlay receiver' && !airPlaySupported) {
+        return 'AirPlay receiver (unavailable)';
+    }
     if (item === 'Check for updates') {
         return updateStatusText(updateCheck, currentVersion).endsWith('available') ? 'Install update' : 'Check now';
     }
@@ -145,7 +152,7 @@ function settingDetail(input) {
     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') {

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), _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 = [];