@ciphore/radiocli 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.7] - 2026-06-29
+
+### Changed
+
+- Search results can now be navigated with `Up` / `Down` while editing the
+  search query; search-history recall remains available with
+  `Ctrl+Up` / `Ctrl+Down`.
+- The listening stats activity heatmap now renders day cells as square markers
+  and uses a capped contribution scale so one unusually long listening day does
+  not flatten the rest of the Less/More color range.
+
 ## [0.1.6] - 2026-06-17
 
 ### Added
@@ -146,6 +157,7 @@ Initial public release.
 
 [0.1.5]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.5
 [0.1.6]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.6
+[0.1.7]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.7
 [0.1.4]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.4
 [0.1.3]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.3
 [0.1.2]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.2

package/README.md

@@ -279,7 +279,7 @@ Page-specific footer controls:
 | Screen | Controls |
 | --- | --- |
 | Home | `↑` / `↓` move, `Enter` open, number jump, `:` command |
-| Search input | type query, `Backspace` edit, `Enter` search or tune, `Esc` finish |
+| Search input | type query, `Backspace` edit, `Up` / `Down` move results, `Ctrl+Up` / `Ctrl+Down` recall search history, `Enter` search or tune, `Esc` finish |
 | Search results | `/` edit query, `↑` / `↓` or `n` / `p` move, `Enter` tune, `f` favorite, `b` home |
 | Explore | click map, `WASD` fine move, `Shift+WASD` jump, `↑` / `↓` station, `Enter` tune, `f` favorite, `[` / `]` page, `b` home |
 | Countries | `/` filter, `↑` / `↓` move, `Enter` open stations, `w` map, `b` home |

package/dist/ui/app-state.js

@@ -52,6 +52,15 @@ export const topTabs = [
 export function clamp(value, max) {
     return Math.min(Math.max(value, 0), Math.max(max, 0));
 }
+export function searchEditingArrowAction(key, hasResults) {
+    if (key.upArrow) {
+        return key.ctrl || !hasResults ? 'history-older' : 'select-previous';
+    }
+    if (key.downArrow) {
+        return key.ctrl || !hasResults ? 'history-newer' : 'select-next';
+    }
+    return null;
+}
 export function clampVolume(value) {
     return Math.min(100, Math.max(0, Math.round(value)));
 }

package/dist/ui/page-footer.js

@@ -10,7 +10,7 @@ export function pageFooterText({ capturingTransportAction, commandMode, commandT
         return '↑/↓ move · Enter open · number jump · : command';
     }
     if (screen === 'search' && editingSearch) {
-        return 'Type query · ↑/↓ history · Enter search/tune · Esc finish';
+        return 'Type query · ↑/↓ move results · Ctrl+↑/↓ history · Enter search/tune · Esc finish';
     }
     if (screen === 'search') {
         return '/ edit query · ↑/↓ or n/p move · Enter tune · f favorite · b home';

package/dist/ui/screens/StatsScreen.js

@@ -6,6 +6,7 @@ import { panelBorderStyle, useDisplay } from '../display-context.js';
 import { ScreenHeader } from '../components/ScreenHeader.js';
 import { truncate } from '../format.js';
 const monthLabels = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+const heatmapSquare = '■';
 export function StatsScreen({ library, theme, width, height }) {
     const { panel: panelBackground, ascii } = useDisplay();
     const stats = computeListeningStats(library.activity.sessions);
@@ -17,7 +18,7 @@ export function StatsScreen({ library, theme, width, height }) {
     const metricWidth = Math.max(28, Math.floor((contentWidth - 2) / 2));
     const favoriteWidth = Math.max(8, metricWidth - 18);
     const compact = height < 30;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Listening stats", subtitle: "Local listening history \u00B7 never leaves this machine", width: width, theme: theme, right: `${formatHours(totalHours)} · ${stats.sessions.toLocaleString()} sessions` }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: width, flexDirection: "column", children: [_jsx(Box, { children: _jsx(Text, { color: themeAccent(theme), bold: true, children: "Activity \u2014 last 53 weeks" }) }), _jsxs(Box, { marginTop: compact ? 0 : 1, flexDirection: "column", children: [_jsxs(Text, { color: "gray", children: ["      ", graph.months] }), graph.rows.map(row => (_jsxs(Box, { children: [_jsx(Text, { color: "gray", children: row.label.padEnd(5) }), row.cells.map(cell => (_jsx(Text, { color: graphColors[cell.level], children: cell.text }, cell.key)))] }, row.key)))] })] }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: width, flexDirection: "column", children: [_jsx(Text, { color: themeAccent(theme), bold: true, children: "Summary" }), _jsxs(Box, { marginTop: compact ? 0 : 1, flexDirection: "column", width: contentWidth, children: [metricPair('Favorite station', truncate(favorite, favoriteWidth), 'Total hours listened', formatHours(totalHours), metricWidth, theme), metricPair('Sessions', stats.sessions.toLocaleString(), 'Longest streak', formatDays(stats.longestStreak), metricWidth, theme), metricPair('Current streak', formatDays(stats.currentStreak), 'Stations listened', stats.listenedStationCount.toLocaleString(), metricWidth, theme), metricPair('Active days', `${stats.activeDays}/${stats.totalTrackedDays}`, 'Station threshold', '>= 120s total', metricWidth, theme)] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "gray", children: "Less \u00B7 " }), graphColors.map(color => (_jsxs(Text, { color: color, children: ["\u2588\u2588", _jsx(Text, { children: " " })] }, color))), _jsx(Text, { color: "gray", children: "More" })] }), !compact ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: textHighlight, children: stats.totalSeconds > 0
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ScreenHeader, { title: "Listening stats", subtitle: "Local listening history \u00B7 never leaves this machine", width: width, theme: theme, right: `${formatHours(totalHours)} · ${stats.sessions.toLocaleString()} sessions` }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: width, flexDirection: "column", children: [_jsx(Box, { children: _jsx(Text, { color: themeAccent(theme), bold: true, children: "Activity \u2014 last 53 weeks" }) }), _jsxs(Box, { marginTop: compact ? 0 : 1, flexDirection: "column", children: [_jsxs(Text, { color: "gray", children: ["      ", graph.months] }), graph.rows.map(row => (_jsxs(Box, { children: [_jsx(Text, { color: "gray", children: row.label.padEnd(5) }), row.cells.map(cell => (_jsx(Text, { color: graphColors[cell.level], children: cell.text }, cell.key)))] }, row.key)))] })] }), _jsxs(Box, { marginTop: 1, borderStyle: panelBorderStyle(ascii, 'single'), borderColor: panelBorder, borderBackgroundColor: panelBackground, backgroundColor: panelBackground, width: width, flexDirection: "column", children: [_jsx(Text, { color: themeAccent(theme), bold: true, children: "Summary" }), _jsxs(Box, { marginTop: compact ? 0 : 1, flexDirection: "column", width: contentWidth, children: [metricPair('Favorite station', truncate(favorite, favoriteWidth), 'Total hours listened', formatHours(totalHours), metricWidth, theme), metricPair('Sessions', stats.sessions.toLocaleString(), 'Longest streak', formatDays(stats.longestStreak), metricWidth, theme), metricPair('Current streak', formatDays(stats.currentStreak), 'Stations listened', stats.listenedStationCount.toLocaleString(), metricWidth, theme), metricPair('Active days', `${stats.activeDays}/${stats.totalTrackedDays}`, 'Station threshold', '>= 120s total', metricWidth, theme)] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "gray", children: "Less \u00B7 " }), graphColors.map(color => (_jsxs(Text, { color: color, children: [heatmapSquare, _jsx(Text, { children: " " })] }, color))), _jsx(Text, { color: "gray", children: "More" })] }), !compact ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: textHighlight, children: stats.totalSeconds > 0
                                 ? `Your total listening time is ${formatHours(totalHours)} across public radio streams.`
                                 : 'Start a station to begin filling the listening graph.' }) })) : null] })] }));
 }
@@ -27,34 +28,45 @@ function metricPair(leftLabel, leftValue, rightLabel, rightValue, metricWidth, t
     return (_jsxs(Box, { height: 1, width: metricWidth * 2 + 2, children: [_jsx(Box, { width: metricWidth, children: _jsxs(Text, { children: [_jsxs(Text, { color: "gray", children: [leftLabel, ": "] }), _jsx(Text, { color: accent, children: leftValue })] }) }), _jsx(Text, { children: ' '.repeat(leftPadding > 2 ? 2 : leftPadding) }), _jsx(Box, { width: metricWidth, children: _jsxs(Text, { children: [_jsxs(Text, { color: "gray", children: [rightLabel, ": "] }), _jsx(Text, { color: accent, children: rightValue })] }) })] }));
 }
 function buildContributionGraph(days, width) {
-    const cellWidth = width >= 168 ? 3 : width >= 120 ? 2 : 1;
+    const cellWidth = width >= 112 ? 2 : 1;
     const weeks = Array.from({ length: 53 }, (_, weekIndex) => days.slice(weekIndex * 7, weekIndex * 7 + 7)).filter(week => week.length > 0);
-    const maxSeconds = Math.max(1, ...days.map(day => day.seconds));
+    const scaleSeconds = contributionScaleSeconds(days);
     const labels = ['', 'Mon', '', 'Wed', '', 'Fri', ''];
     const rows = Array.from({ length: 7 }, (_, dayIndex) => ({
         key: `day-${dayIndex}`,
         label: labels[dayIndex] ?? '',
         cells: weeks.map(week => {
             const day = week[dayIndex];
-            const level = contributionLevel(day?.seconds ?? 0, maxSeconds);
-            const text = cellWidth > 1 ? `${'█'.repeat(cellWidth - 1)} ` : '█';
+            const level = contributionLevel(day?.seconds ?? 0, scaleSeconds);
+            const text = cellWidth > 1 ? `${heatmapSquare} ` : heatmapSquare;
             return { key: day?.date ?? `${week[0]?.date ?? 'empty'}-${dayIndex}`, level, text };
         })
     }));
     return { months: monthLine(weeks, cellWidth), rows };
 }
-function contributionLevel(seconds, maxSeconds) {
+export function contributionScaleSeconds(days) {
+    const activeSeconds = days
+        .map(day => day.seconds)
+        .filter(seconds => seconds > 0)
+        .sort((left, right) => left - right);
+    if (activeSeconds.length === 0) {
+        return 1;
+    }
+    const percentileIndex = Math.min(activeSeconds.length - 1, Math.ceil(activeSeconds.length * 0.95) - 1);
+    return Math.max(1, activeSeconds[percentileIndex] ?? activeSeconds[activeSeconds.length - 1] ?? 1);
+}
+export function contributionLevel(seconds, scaleSeconds) {
     if (seconds <= 0) {
         return 0;
     }
-    const ratio = seconds / maxSeconds;
-    if (ratio > 0.75) {
+    const ratio = seconds / Math.max(1, scaleSeconds);
+    if (ratio >= 0.75) {
         return 4;
     }
-    if (ratio > 0.45) {
+    if (ratio >= 0.5) {
         return 3;
     }
-    if (ratio > 0.2) {
+    if (ratio >= 0.25) {
         return 2;
     }
     return 1;

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

@@ -6,6 +6,7 @@ import { HelpScreen } from './HelpScreen.js';
 import { NowPlayingScreen } from './NowPlayingScreen.js';
 import { SettingsScreen } from './SettingsScreen.js';
 import { ExploreScreen } from './ExploreScreen.js';
+import { contributionLevel, contributionScaleSeconds, StatsScreen } from './StatsScreen.js';
 import { settingsItems } from '../screen-items.js';
 import { defaultExploreCursor } from '../app-state.js';
 const station = {
@@ -81,6 +82,43 @@ describe('Explore world map rendering', () => {
         expect(/[⠀-⣿]/.test(frame)).toBe(false);
     });
 });
+describe('StatsScreen rendering', () => {
+    it('renders activity heatmap days as square markers instead of stretched blocks', () => {
+        const library = {
+            recent: [],
+            favorites: [],
+            imported: [],
+            trackHistory: [],
+            searchHistory: [],
+            activity: {
+                sessions: [
+                    {
+                        id: 'listen',
+                        station,
+                        startedAt: new Date(2026, 4, 24, 12).toISOString(),
+                        endedAt: new Date(2026, 4, 24, 13).toISOString(),
+                        listenedSeconds: 3600
+                    }
+                ]
+            },
+            settings
+        };
+        const frame = render(_jsx(DisplayContext.Provider, { value: resolveDisplayMode({ asciiMode: false }, {}), children: _jsx(StatsScreen, { library: library, theme: "green", width: 132, height: 32 }) })).lastFrame() ?? '';
+        expect(frame).toContain('■');
+        expect(frame).not.toContain('██');
+    });
+    it('caps contribution color scaling so one outlier does not flatten normal active days', () => {
+        const days = [
+            ...Array.from({ length: 19 }, (_, index) => ({ date: `2026-05-${String(index + 1).padStart(2, '0')}`, seconds: 3600 })),
+            { date: '2026-05-20', seconds: 36_000 }
+        ];
+        const scaleSeconds = contributionScaleSeconds(days);
+        expect(scaleSeconds).toBe(3600);
+        expect(contributionLevel(3600, scaleSeconds)).toBe(4);
+        expect(contributionLevel(900, scaleSeconds)).toBe(2);
+        expect(contributionLevel(0, scaleSeconds)).toBe(0);
+    });
+});
 describe('HelpScreen rendering', () => {
     it('lists keybinding sections and : commands', () => {
         const { lastFrame } = render(_jsx(HelpScreen, { theme: "green", width: 80 }));

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

@@ -1,7 +1,7 @@
 import { useEffect } from 'react';
 import { useInput } from 'ink';
 import { homeItems, settingsItems } from './screen-items.js';
-import { applyTextInput, clamp, favoriteTarget, isEditableInput, isPlainPrintableInput, mediaTransportActionForInput, shouldHandleKeyboardEvent } from './app-state.js';
+import { applyTextInput, clamp, favoriteTarget, isEditableInput, isPlainPrintableInput, mediaTransportActionForInput, searchEditingArrowAction, shouldHandleKeyboardEvent } from './app-state.js';
 import { parseSgrMouseEvents, primaryMousePress } from './terminal-mouse.js';
 import { completeCommand } from './help-content.js';
 export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, beginLearningTransportKey, capturingTransportAction, commandMode, commandText, copyStationUrl, openStationHomepage, currentItemCount, cycleDisplayColor, cycleAudioOutput, cycleReceiverStyle, cycleSleepTimer, editingCountryFilter, editingSearch, executeCommand, filteredCountries, go, lastRawTransportAtRef, lastSubmittedSearchRef, loadCountry, openAdjacentTab, openAirPlayCode, openAirPlaySettings, openScreen, playAdjacent, playStation, player, playingStation, recallSearchHistory, moveExploreCursor, moveExploreCursorToCell, refreshAirPlayTargets, refreshProviderHealth, resetLearnedTransportKeys, runSearch, saveLearnedTransportKey, screen, searchQuery, selected, selectedStation, selectAirPlayDeviceAt, setCapturingTransportAction, setAirPlayCode, setCommandMode, setCommandText, setCountryFilter, setEditingCountryFilter, setEditingSearch, setMessage, setSearchQuery, setSelected, setShowDiagnostics, submitAirPlayCode, settingsRef, shutdown, stdin, toggleFavorite, toggleMute, togglePause, toggleSetting, toggleNearbyLocation, toggleRadioGarden, toggleSkipBrokenStreams }) {
@@ -138,12 +138,20 @@ export function useAppInput({ adjustVolume, airPlayCode, canEnterAirPlayCode, be
                 setEditingSearch(false);
                 return;
             }
-            if (key.upArrow) {
-                recallSearchHistory('older');
-                return;
-            }
-            if (key.downArrow) {
-                recallSearchHistory('newer');
+            const arrowAction = searchEditingArrowAction(key, currentItemCount('search') > 0);
+            if (arrowAction) {
+                if (arrowAction === 'history-older') {
+                    recallSearchHistory('older');
+                }
+                else if (arrowAction === 'history-newer') {
+                    recallSearchHistory('newer');
+                }
+                else if (arrowAction === 'select-previous') {
+                    setSelected(value => clamp(value - 1, currentItemCount(screen) - 1));
+                }
+                else {
+                    setSelected(value => clamp(value + 1, currentItemCount(screen) - 1));
+                }
                 return;
             }
             if (isEditableInput(input, key)) {

package/package.json

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