hn-bits 0.2.1 → 0.4.0

package/dist/ui/SubscriptionForm.js

@@ -0,0 +1,104 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Box, Text, useInput, useWindowSize } from 'ink';
+import { searchRecent } from '../api/algolia.js';
+import { addSubscription, updateSubscription } from '../db/subscriptions.js';
+import { truncateTitle } from '../lib/format.js';
+import { useTheme } from './theme.js';
+const PREVIEW_DEBOUNCE_MS = 300;
+const PREVIEW_WINDOW_DAYS = 7;
+const PREVIEW_LIMIT = 5;
+const FIELD_ORDER = ['name', 'query', 'minPoints'];
+function windowStart() {
+    return Math.floor(Date.now() / 1000) - PREVIEW_WINDOW_DAYS * 24 * 60 * 60;
+}
+export function SubscriptionForm({ mode, subscription, prefillQuery, onSave, onCancel, }) {
+    const theme = useTheme();
+    const { columns } = useWindowSize();
+    const [name, setName] = useState(subscription?.name ?? '');
+    const [query, setQuery] = useState(subscription?.query ?? prefillQuery ?? '');
+    const [minPoints, setMinPoints] = useState(String(subscription?.minPoints ?? 0));
+    const [field, setField] = useState('name');
+    const [error, setError] = useState('');
+    const [preview, setPreview] = useState([]);
+    const debounceRef = useRef(null);
+    const previewToken = useRef(0);
+    useEffect(() => {
+        if (debounceRef.current)
+            clearTimeout(debounceRef.current);
+        if (!query.trim()) {
+            setPreview([]);
+            return;
+        }
+        debounceRef.current = setTimeout(() => void loadPreview(), PREVIEW_DEBOUNCE_MS);
+        return () => {
+            if (debounceRef.current)
+                clearTimeout(debounceRef.current);
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [query, minPoints]);
+    async function loadPreview() {
+        const myToken = ++previewToken.current;
+        const points = Number(minPoints) || 0;
+        try {
+            const results = await searchRecent(query, { createdAfter: windowStart(), minPoints: points, hitsPerPage: PREVIEW_LIMIT });
+            if (myToken === previewToken.current)
+                setPreview(results);
+        }
+        catch {
+            if (myToken === previewToken.current)
+                setPreview([]);
+        }
+    }
+    function save() {
+        const trimmedName = name.trim();
+        const trimmedQuery = query.trim();
+        if (!trimmedName)
+            return setError('name is required');
+        if (!trimmedQuery)
+            return setError('query is required');
+        const points = Number(minPoints) || 0;
+        try {
+            if (mode === 'add')
+                addSubscription(trimmedName, trimmedQuery, points);
+            else
+                updateSubscription(subscription.id, { name: trimmedName, query: trimmedQuery, minPoints: points });
+            onSave();
+        }
+        catch (err) {
+            setError(err.message);
+        }
+    }
+    function handleInput(input, key) {
+        if (key.escape)
+            return onCancel();
+        if (key.tab) {
+            const index = FIELD_ORDER.indexOf(field);
+            return setField(FIELD_ORDER[(index + 1) % FIELD_ORDER.length]);
+        }
+        if (key.return)
+            return save();
+        if (key.backspace || key.delete) {
+            if (field === 'name')
+                setName((v) => v.slice(0, -1));
+            if (field === 'query')
+                setQuery((v) => v.slice(0, -1));
+            if (field === 'minPoints')
+                setMinPoints((v) => v.slice(0, -1));
+            return;
+        }
+        if (input && !key.ctrl && !key.meta) {
+            if (field === 'name')
+                setName((v) => v + input);
+            if (field === 'query')
+                setQuery((v) => v + input);
+            if (field === 'minPoints' && /^\d+$/.test(input)) {
+                setMinPoints((v) => (v === '0' ? input : v + input));
+            }
+        }
+    }
+    useInput(handleInput);
+    const cursor = (f) => (field === f ? '▏' : '');
+    const previewLabel = Number(minPoints) > 0 ? `≥${minPoints} pts` : 'any points';
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.colors.title, children: mode === 'add' ? 'New subscription' : 'Edit subscription' }), _jsx(Text, { children: " " }), _jsxs(Text, { children: ["name:        ", name, cursor('name')] }), _jsxs(Text, { children: ["query:       ", query, cursor('query')] }), _jsxs(Text, { children: ["min points:  ", minPoints, cursor('minPoints')] }), _jsx(Text, { children: " " }), query.trim() && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["preview (last 7 days, ", previewLabel, "):"] }), preview.length === 0 && _jsx(Text, { dimColor: true, children: " no matches" }), preview.map((story, i) => (_jsxs(Text, { children: [' ', i + 1, ". ", truncateTitle(story.title, Math.max(1, columns - 24)), "  ", story.score, " pts"] }, story.id)))] })), error && _jsx(Text, { color: theme.colors.error, children: error }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "tab next field \u00B7 enter save \u00B7 esc cancel" })] }));
+}

package/dist/ui/SubscriptionMatches.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Box, Text, useInput, useWindowSize } from 'ink';
+import open from 'open';
+import { buildListSummaryPrompt } from '../ai/summaryPrompts.js';
+import { searchRecent } from '../api/algolia.js';
+import { hnItemUrl } from '../api/firebase.js';
+import { toggleBookmark } from '../db/bookmarks.js';
+import { clampSelection } from '../lib/listNavigation.js';
+import { ensureVisibleLines } from '../lib/viewport.js';
+import { footerRows, SUB_MATCHES_KEYS } from './keymap.js';
+import { HEADER_ROWS } from './Layout.js';
+import { LoadingIndicator } from './LoadingIndicator.js';
+import { STORY_ROW_HEIGHT } from './StoryRow.js';
+import { StoryListView } from './StoryListView.js';
+import { SummaryPanel } from './SummaryPanel.js';
+import { useTheme } from './theme.js';
+import { useFlash } from './useFlash.js';
+const WINDOW_DAYS = 7;
+const HEADER_LINES = 1;
+function windowStart() {
+    return Math.floor(Date.now() / 1000) - WINDOW_DAYS * 24 * 60 * 60;
+}
+export function SubscriptionMatches({ subscription, config, onSelectStory, onBack, onAskAI, }) {
+    const theme = useTheme();
+    const { columns, rows } = useWindowSize();
+    const bodyHeight = Math.max(1, rows - HEADER_ROWS - footerRows(SUB_MATCHES_KEYS, columns) - HEADER_LINES);
+    const [stories, setStories] = useState([]);
+    const [selected, setSelected] = useState(0);
+    const [status, setStatus] = useState('loading');
+    const [error, setError] = useState('');
+    const [summaryOpen, setSummaryOpen] = useState(false);
+    const [flashMessage, flash] = useFlash();
+    const pendingTopJump = useRef(false);
+    const topLineRef = useRef(0);
+    useEffect(() => {
+        void load();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [subscription.id]);
+    async function load() {
+        setStatus('loading');
+        setSelected(0);
+        try {
+            const results = await searchRecent(subscription.query, {
+                createdAfter: windowStart(),
+                minPoints: subscription.minPoints,
+            });
+            setStories(results);
+            setStatus('ready');
+        }
+        catch (err) {
+            setStatus('error');
+            setError(err.message);
+        }
+    }
+    function openSelectedStory() {
+        const story = stories[selected];
+        if (story)
+            void open(story.url ?? hnItemUrl(story.id));
+    }
+    function handleInput(input, key) {
+        const isG = input === 'g';
+        if (isG && pendingTopJump.current) {
+            pendingTopJump.current = false;
+            return setSelected(0);
+        }
+        pendingTopJump.current = isG;
+        if (key.escape)
+            return onBack();
+        if (input === 'j' || key.downArrow)
+            return setSelected((s) => clampSelection(s, 1, stories.length));
+        if (input === 'k' || key.upArrow)
+            return setSelected((s) => clampSelection(s, -1, stories.length));
+        if (input === 'G')
+            return setSelected(Math.max(0, stories.length - 1));
+        if (input === 'o')
+            return openSelectedStory();
+        if (input === 'r')
+            return void load();
+        if (input === 's' && stories[selected])
+            return setSummaryOpen(true);
+        if (input === 'a' && stories[selected])
+            return onAskAI(stories[selected]);
+        if (input === 'B' && stories[selected]) {
+            return flash(toggleBookmark(stories[selected]) ? 'bookmarked ✓' : 'bookmark removed');
+        }
+        if (key.return && stories[selected])
+            return onSelectStory(stories[selected]);
+    }
+    useInput(handleInput, { isActive: !summaryOpen });
+    if (status === 'loading')
+        return _jsx(LoadingIndicator, { label: "Loading matches..." });
+    if (status === 'error')
+        return _jsxs(Text, { color: theme.colors.error, children: [error, " (r to retry)"] });
+    const panelHeight = summaryOpen ? Math.max(6, Math.floor(bodyHeight / 2)) : 0;
+    const statusLineHeight = flashMessage ? 1 : 0;
+    const listHeight = Math.max(1, bodyHeight - statusLineHeight - panelHeight);
+    const heights = stories.map(() => STORY_ROW_HEIGHT);
+    const topLine = ensureVisibleLines(heights, selected, topLineRef.current, listHeight);
+    topLineRef.current = topLine;
+    const selectedStory = stories[selected];
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["sub: ", subscription.name, " \"", subscription.query, "\""] }), stories.length === 0 ? (_jsx(Text, { dimColor: true, children: "no matches in the last 7 days" })) : (_jsx(StoryListView, { stories: stories, selected: selected, topLine: topLine, height: listHeight, width: columns })), flashMessage && _jsx(Text, { dimColor: true, children: flashMessage }), summaryOpen && selectedStory && (_jsx(SummaryPanel, { config: config, buildPrompt: (signal) => buildListSummaryPrompt(selectedStory, signal), height: panelHeight, width: columns, onClose: () => setSummaryOpen(false) }))] }));
+}

package/dist/ui/SubscriptionsView.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef, useState } from 'react';
+import { Box, Text, useInput, useWindowSize } from 'ink';
+import { listSubscriptions, removeSubscription } from '../db/subscriptions.js';
+import { formatAge } from '../lib/format.js';
+import { clampSelection, mapFeedKey } from '../lib/listNavigation.js';
+import { ensureVisibleLines, sliceByLines } from '../lib/viewport.js';
+import { footerRows, SUBS_KEYS } from './keymap.js';
+import { HEADER_ROWS } from './Layout.js';
+import { useTheme } from './theme.js';
+function pointsLabel(minPoints) {
+    return minPoints === 0 ? 'any' : `≥${minPoints} pts`;
+}
+export function SubscriptionsView({ onSelectMatches, onAdd, onEdit, onFeedChange, onTabChange, }) {
+    const theme = useTheme();
+    const { columns, rows } = useWindowSize();
+    const bodyHeight = Math.max(1, rows - HEADER_ROWS - footerRows(SUBS_KEYS, columns));
+    const [subs, setSubs] = useState(() => listSubscriptions());
+    const [selected, setSelected] = useState(0);
+    const [deleteConfirm, setDeleteConfirm] = useState(null);
+    const pendingTopJump = useRef(false);
+    const topLineRef = useRef(0);
+    function reload() {
+        const next = listSubscriptions();
+        setSubs(next);
+        setSelected((s) => clampSelection(s, 0, next.length));
+    }
+    function handleInput(input, key) {
+        if (deleteConfirm) {
+            if (input === 'y') {
+                removeSubscription(deleteConfirm);
+                reload();
+            }
+            setDeleteConfirm(null);
+            return;
+        }
+        const isG = input === 'g';
+        if (isG && pendingTopJump.current) {
+            pendingTopJump.current = false;
+            return setSelected(0);
+        }
+        pendingTopJump.current = isG;
+        const targetFeed = mapFeedKey(input);
+        if (targetFeed)
+            return onFeedChange(targetFeed);
+        if (key.leftArrow)
+            return onTabChange(-1);
+        if (key.rightArrow)
+            return onTabChange(1);
+        if (input === 'j' || key.downArrow)
+            return setSelected((s) => clampSelection(s, 1, subs.length));
+        if (input === 'k' || key.upArrow)
+            return setSelected((s) => clampSelection(s, -1, subs.length));
+        if (input === 'G')
+            return setSelected(Math.max(0, subs.length - 1));
+        if (key.return && subs[selected])
+            return onSelectMatches(subs[selected]);
+        if (input === 'a')
+            return onAdd();
+        if (input === 'e' && subs[selected])
+            return onEdit(subs[selected]);
+        if (input === 'd' && subs[selected])
+            return setDeleteConfirm(subs[selected].name);
+    }
+    useInput(handleInput);
+    if (subs.length === 0) {
+        return _jsx(Text, { dimColor: true, children: "no subscriptions yet - press a to add" });
+    }
+    const statusLineHeight = deleteConfirm ? 1 : 0;
+    const listHeight = Math.max(1, bodyHeight - statusLineHeight);
+    const heights = subs.map(() => 1);
+    const topLine = ensureVisibleLines(heights, selected, topLineRef.current, listHeight);
+    topLineRef.current = topLine;
+    const { first, last } = sliceByLines(heights, topLine, listHeight);
+    const nameWidth = Math.max(...subs.map((s) => s.name.length));
+    return (_jsxs(Box, { flexDirection: "column", children: [subs.slice(first, last + 1).map((sub, i) => {
+                const index = first + i;
+                const isSelected = index === selected;
+                const marker = isSelected ? theme.glyphs.selection : ' ';
+                const background = isSelected ? theme.colors.selectionBackground : undefined;
+                return (_jsxs(Text, { backgroundColor: background, children: [marker, " ", sub.name.padEnd(nameWidth), "  \"", sub.query, "\"  ", pointsLabel(sub.minPoints).padEnd(9), "  added", ' ', formatAge(sub.createdAt), " ago"] }, sub.id));
+            }), deleteConfirm && _jsxs(Text, { dimColor: true, children: ["delete '", deleteConfirm, "'? y/n"] })] }));
+}

package/dist/ui/SummaryPanel.js

@@ -4,9 +4,10 @@ import { Box, Text, useInput } from 'ink';
 import { chatStream, describeError } from '../ai/ollama.js';
 import { AI_SETUP_HINT_LINES } from '../lib/config.js';
 import { wrapPlainText } from '../lib/viewport.js';
-import { theme } from './theme.js';
+import { useTheme } from './theme.js';
 const SYSTEM_PROMPT = 'You are a concise assistant summarizing Hacker News content. Plain text only, no markdown headers. Max ~150 words.';
 export function SummaryPanel({ config, buildPrompt, height, width, onClose }) {
+    const theme = useTheme();
     const [status, setStatus] = useState(config ? 'preparing' : 'setup-hint');
     const [content, setContent] = useState('');
     const [notice, setNotice] = useState('');

package/dist/ui/TabBar.js

@@ -1,18 +1,20 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text, useWindowSize } from 'ink';
-import { theme } from './theme.js';
+import { useTheme } from './theme.js';
 const TABS = [
-    { feed: 'top', label: 'Top' },
-    { feed: 'new', label: 'New' },
-    { feed: 'best', label: 'Best' },
-    { feed: 'ask', label: 'Ask' },
-    { feed: 'show', label: 'Show' },
+    { id: 'top', label: 'Top' },
+    { id: 'new', label: 'New' },
+    { id: 'best', label: 'Best' },
+    { id: 'ask', label: 'Ask' },
+    { id: 'show', label: 'Show' },
+    { id: 'saved', label: 'Saved' },
+    { id: 'subs', label: 'Subs' },
 ];
 const BRAND = 'Hacker News';
 const HELP_HINT = '? help';
 const TAB_GAP = '   ';
 function tabSegment(tab, active) {
-    if (tab.feed !== active)
+    if (tab.id !== active)
         return { segment: { text: tab.label, color: 'muted' }, width: tab.label.length };
     const inner = ` ${tab.label} `;
     return { segment: { text: `│${inner}│`, color: 'accent', bold: true }, width: inner.length };
@@ -29,7 +31,7 @@ function buildTabSegments(active) {
         }
         const { segment, width } = tabSegment(tab, active);
         segments.push(segment);
-        if (tab.feed === active) {
+        if (tab.id === active) {
             activeWallColumn = column;
             activeInnerWidth = width;
         }
@@ -69,11 +71,12 @@ function buildBottomRuleSegments(columns, wallColumn, innerWidth) {
     const line = base.slice(0, wallColumn) + notch + base.slice(wallColumn + notch.length);
     return [{ text: line, color: 'accent' }];
 }
-function segmentColor(color) {
+function segmentColor(color, theme) {
     return color === 'accent' ? theme.colors.accent : theme.colors.muted;
 }
 function SegmentRow({ segments }) {
-    return (_jsx(Box, { children: segments.map((segment, index) => (_jsx(Text, { bold: segment.bold, color: segmentColor(segment.color), children: segment.text }, index))) }));
+    const theme = useTheme();
+    return (_jsx(Box, { children: segments.map((segment, index) => (_jsx(Text, { bold: segment.bold, color: segmentColor(segment.color, theme), children: segment.text }, index))) }));
 }
 export function TabBar({ active }) {
     const { columns } = useWindowSize();

package/dist/ui/ThemePicker.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Text, useInput } from 'ink';
+import { clampSelection } from '../lib/listNavigation.js';
+import { paletteNames, useTheme } from './theme.js';
+export function ThemePicker({ current, onSelect, onCancel }) {
+    const theme = useTheme();
+    const names = paletteNames();
+    const [selected, setSelected] = useState(() => Math.max(0, names.indexOf(current)));
+    function handleInput(input, key) {
+        if (key.escape)
+            return onCancel();
+        if (input === 'j' || key.downArrow)
+            return setSelected((s) => clampSelection(s, 1, names.length));
+        if (input === 'k' || key.upArrow)
+            return setSelected((s) => clampSelection(s, -1, names.length));
+        if (key.return)
+            return onSelect(names[selected]);
+    }
+    useInput(handleInput);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.colors.title, children: "theme" }), names.map((name, index) => {
+                const isSelected = index === selected;
+                const marker = isSelected ? theme.glyphs.selection : ' ';
+                const background = isSelected ? theme.colors.selectionBackground : undefined;
+                const suffix = name === current ? ' (current)' : '';
+                return (_jsxs(Text, { backgroundColor: background, children: [marker, " ", name, suffix] }, name));
+            })] }));
+}

package/dist/ui/keymap.js

@@ -2,6 +2,7 @@ import { wrapPlainText } from '../lib/viewport.js';
 export const GLOBAL_KEYS = [
     { key: 'q', label: 'quit' },
     { key: '?', label: 'help' },
+    { key: 'T', label: 'theme' },
 ];
 export const LIST_KEYS = [
     { key: 'j/k', label: 'move' },
@@ -14,6 +15,7 @@ export const LIST_KEYS = [
     { key: '/', label: 'search' },
     { key: 's', label: 'summary' },
     { key: 'a', label: 'ask ai' },
+    { key: 'B', label: 'bookmark' },
 ];
 export const COMMENTS_KEYS = [
     { key: 'j/k', label: 'move' },
@@ -24,6 +26,7 @@ export const COMMENTS_KEYS = [
     { key: 'r', label: 'reload' },
     { key: 's', label: 'summary' },
     { key: 'a', label: 'ask ai' },
+    { key: 'B', label: 'bookmark' },
     { key: 'esc', label: 'back' },
 ];
 export const SEARCH_RESULTS_KEYS = [
@@ -34,8 +37,53 @@ export const SEARCH_RESULTS_KEYS = [
     { key: '/', label: 'new search' },
     { key: 's', label: 'summary' },
     { key: 'a', label: 'ask ai' },
+    { key: 'B', label: 'bookmark' },
+    { key: 'S', label: 'subscribe' },
     { key: 'esc', label: 'back/quit' },
 ];
+export const SUBS_KEYS = [
+    { key: 'j/k', label: 'move' },
+    { key: '←/→', label: 'tab' },
+    { key: 't/n/b', label: 'feed' },
+    { key: 'enter', label: 'matches' },
+    { key: 'a', label: 'add' },
+    { key: 'e', label: 'edit' },
+    { key: 'd', label: 'delete' },
+];
+export const SUB_MATCHES_KEYS = [
+    { key: 'j/k', label: 'move' },
+    { key: 'gg/G', label: 'top/bottom' },
+    { key: 'enter', label: 'comments' },
+    { key: 'o', label: 'browser' },
+    { key: 'B', label: 'bookmark' },
+    { key: 's', label: 'summary' },
+    { key: 'a', label: 'ask ai' },
+    { key: 'r', label: 'refetch' },
+    { key: 'esc', label: 'back' },
+];
+export const SUB_FORM_KEYS = [
+    { key: 'tab', label: 'next field' },
+    { key: 'enter', label: 'save' },
+    { key: 'esc', label: 'cancel' },
+];
+export const THEME_PICKER_KEYS = [
+    { key: 'j/k', label: 'move' },
+    { key: 'enter', label: 'apply' },
+    { key: 'esc', label: 'cancel' },
+];
+export const SAVED_KEYS = [
+    { key: 'j/k', label: 'move' },
+    { key: '←/→', label: 'tab' },
+    { key: 't/n/b', label: 'feed' },
+    { key: 'gg/G', label: 'top/bottom' },
+    { key: 'enter', label: 'comments' },
+    { key: 'o', label: 'browser' },
+    { key: 'r', label: 'reload' },
+    { key: '/', label: 'search' },
+    { key: 's', label: 'summary' },
+    { key: 'a', label: 'ask ai' },
+    { key: 'B', label: 'remove' },
+];
 /** Footer hint string: view keys followed by the global keys. */
 export function footerHint(viewKeys) {
     return [...viewKeys, ...GLOBAL_KEYS].map((binding) => `${binding.key} ${binding.label}`).join(' · ');

package/dist/ui/theme.js

@@ -1,8 +1,11 @@
+import { createContext, useContext } from 'react';
+import { loadConfig } from '../lib/config.js';
 const glyphs = {
     selection: '❯',
     foldOpen: '▾',
     foldClosed: '▸',
     upvote: '▲',
+    bookmark: '★',
 };
 function ansi256(code) {
     return `ansi256(${code})`;
@@ -80,6 +83,18 @@ const palettes = {
         link: LINK,
         email: EMAIL,
     },
+    // Ported from chojs23/concord's ratatui color constants (src/tui/ui/types.rs, message/format.rs).
+    concord: {
+        accent: ansi256(44),
+        title: ansi256(255),
+        muted: ansi256(243),
+        error: ansi256(196),
+        score: ansi256(208),
+        comment: ansi256(80),
+        selectionBackground: SELECTION_BACKGROUND,
+        link: LINK,
+        email: EMAIL,
+    },
 };
 const DEFAULT_PALETTE = 'hn';
 export function paletteNames() {
@@ -88,11 +103,32 @@ export function paletteNames() {
 function isPaletteName(name) {
     return name in palettes;
 }
+/** First defined candidate across flag > HN_THEME env > ui.theme config, with where it came from. */
+function candidatePaletteName(name) {
+    if (name !== undefined)
+        return { raw: name, source: 'flag' };
+    const env = process.env['HN_THEME'];
+    if (env !== undefined)
+        return { raw: env, source: 'env' };
+    const configured = loadConfig()?.ui?.theme;
+    if (configured !== undefined)
+        return { raw: configured, source: 'config' };
+    return { source: 'default' };
+}
 export function resolvePaletteName(name) {
-    const candidate = name ?? process.env['HN_THEME'] ?? DEFAULT_PALETTE;
-    return isPaletteName(candidate) ? candidate : DEFAULT_PALETTE;
+    const { raw } = candidatePaletteName(name);
+    return raw !== undefined && isPaletteName(raw) ? raw : DEFAULT_PALETTE;
+}
+/** Where the active theme choice came from, for `hn theme`'s status line. */
+export function resolvePaletteSource(name) {
+    const { raw, source } = candidatePaletteName(name);
+    return raw !== undefined && isPaletteName(raw) ? source : 'default';
 }
 export function resolveTheme(name) {
     return { colors: palettes[resolvePaletteName(name)], glyphs };
 }
 export const theme = resolveTheme();
+export const ThemeContext = createContext(theme);
+export function useTheme() {
+    return useContext(ThemeContext);
+}

package/dist/ui/useFlash.js

@@ -0,0 +1,14 @@
+import { useRef, useState } from 'react';
+const FLASH_MS = 1500;
+/** Transient status text (e.g. "bookmarked ✓") that self-clears after FLASH_MS. */
+export function useFlash() {
+    const [message, setMessage] = useState(null);
+    const timer = useRef(null);
+    function flash(text) {
+        if (timer.current)
+            clearTimeout(timer.current);
+        setMessage(text);
+        timer.current = setTimeout(() => setMessage(null), FLASH_MS);
+    }
+    return [message, flash];
+}

package/dist/watch.js

@@ -0,0 +1,96 @@
+import { searchRecent } from './api/algolia.js';
+import { isSeen, markSeen } from './db/seen.js';
+import { listSubscriptions, touchLastRun } from './db/subscriptions.js';
+import { loadConfig } from './lib/config.js';
+import { createTelegramNotifier } from './notify/telegram.js';
+const SIX_HOURS = 6 * 60 * 60;
+const TWENTY_FOUR_HOURS = 24 * 60 * 60;
+function log(message) {
+    console.log(`[${new Date().toISOString()}] ${message}`);
+}
+function windowStart(lastRunAt, now) {
+    if (lastRunAt == null)
+        return now - TWENTY_FOUR_HOURS;
+    return Math.max(lastRunAt - SIX_HOURS, 0);
+}
+function buildNotifiers() {
+    const config = loadConfig();
+    const telegram = config?.telegram;
+    if (telegram?.enabled && telegram.botToken && telegram.chatId) {
+        return [createTelegramNotifier({ botToken: telegram.botToken, chatId: telegram.chatId })];
+    }
+    return [];
+}
+async function notifyStory(sub, story, notifiers) {
+    try {
+        for (const notifier of notifiers)
+            await notifier.send({ subscription: sub, story });
+        return true;
+    }
+    catch (err) {
+        log(`${sub.name}: notify failed for ${story.id} - ${err.message}`);
+        return false;
+    }
+}
+async function processSubscription(sub, notifiers, now, dryRun) {
+    let stories;
+    try {
+        stories = await searchRecent(sub.query, { createdAfter: windowStart(sub.lastRunAt, now), minPoints: sub.minPoints });
+    }
+    catch (err) {
+        log(`${sub.name}: query failed - ${err.message}`);
+        return { notified: 0, hadFailure: true };
+    }
+    const matches = stories.filter((story) => !isSeen(story.id, sub.id)).sort((a, b) => a.time - b.time);
+    if (matches.length === 0) {
+        log(`${sub.name}: no new matches`);
+        if (!dryRun)
+            touchLastRun(sub.id, now);
+        return { notified: 0, hadFailure: false };
+    }
+    log(`${sub.name}: ${matches.length} new matches`);
+    let notified = 0;
+    let hadFailure = false;
+    for (const story of matches) {
+        if (dryRun) {
+            log(`would notify: [${sub.name}] ${story.title} (${story.score} pts)`);
+            continue;
+        }
+        const sent = await notifyStory(sub, story, notifiers);
+        if (!sent) {
+            hadFailure = true;
+            continue;
+        }
+        markSeen(story.id, sub.id, now);
+        log(`${sub.name}: notified ${story.id} "${story.title}" (${story.score} pts)`);
+        notified++;
+    }
+    if (!dryRun)
+        touchLastRun(sub.id, now);
+    return { notified, hadFailure };
+}
+/** hn watch --once: one-shot pass over all subscriptions. Returns the process exit code. */
+export async function runWatch(options) {
+    const notifiers = buildNotifiers();
+    if (notifiers.length === 0) {
+        console.error('no notifier configured: hn config set telegram.enabled true (and botToken/chatId)');
+        return 2;
+    }
+    const subs = listSubscriptions();
+    if (subs.length === 0) {
+        log('no subscriptions');
+        return 0;
+    }
+    log(`watch: ${subs.length} subscriptions`);
+    const now = Math.floor(Date.now() / 1000);
+    let totalNotified = 0;
+    let failedSubs = 0;
+    for (const sub of subs) {
+        const result = await processSubscription(sub, notifiers, now, options.dryRun);
+        totalNotified += result.notified;
+        if (result.hadFailure)
+            failedSubs++;
+    }
+    log(`done: ${totalNotified} notified, ${failedSubs} failed`);
+    return failedSubs > 0 ? 1 : 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hn-bits",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Terminal-first Hacker News client",
   "type": "module",
   "repository": {
@@ -26,6 +26,7 @@
   "license": "MIT",
   "dependencies": {
     "@mozilla/readability": "^0.6.0",
+    "better-sqlite3": "^12.11.1",
     "commander": "^15.0.0",
     "ink": "^7.1.0",
     "jsdom": "^29.1.1",
@@ -33,6 +34,7 @@
     "react": "^19.2.7"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/jsdom": "^28.0.3",
     "@types/node": "^26.1.0",
     "@types/react": "^19.2.17",