feat: terminal-native torrent discovery TUI

Curated, multi-source torrent search and download from the terminal: concurrent search across built-in sources with streamed, source-tagged results; a download-only webtorrent engine with true pause/resume and restart recovery; magnet paste; and a calm Ink + React TUI. No indexer server, no setup.
2026-07-08 18:28:22 +02:00 · 2026-06-27 02:03:19 -04:00
commit 60d7a9a755
71 changed files with 11293 additions and 0 deletions
@@ -0,0 +1,62 @@
+import { Box, Text } from "ink";
+import { HELP_GROUPS } from "../keymap";
+import { useStore } from "../store";
+import { COLOR, RULE, lerpHex } from "../theme";
+
+const CARD_BORDER = lerpHex(COLOR.accent, RULE, 0.55);
+
+const KEY_GAP = 2;
+const COL_GAP = 2;
+const KEY_W = HELP_GROUPS.map(
+  (g) => Math.max(...g.hints.map((h) => h.keys.length)) + KEY_GAP,
+);
+const COL_W = HELP_GROUPS.map(
+  (g, i) => KEY_W[i]! + Math.max(...g.hints.map((h) => h.label.length)),
+);
+const CARD_W =
+  COL_W.reduce((a, b) => a + b, 0) + (HELP_GROUPS.length - 1) * COL_GAP + 4;
+const KEY_W_STACKED = Math.max(...KEY_W);
+
+export function HelpOverlay() {
+  const { cols } = useStore();
+  const columns = cols >= CARD_W;
+
+  return (
+    <Box
+      flexDirection="column"
+      alignSelf="flex-start"
+      borderStyle="round"
+      borderColor={CARD_BORDER}
+      paddingX={columns ? 1 : 2}
+      paddingY={1}
+    >
+      <Text bold color={COLOR.accent}>
+        Keyboard
+      </Text>
+      <Box marginTop={1} flexDirection={columns ? "row" : "column"}>
+        {HELP_GROUPS.map((group, gi) => (
+          <Box
+            key={group.title}
+            flexDirection="column"
+            width={columns ? COL_W[gi] : undefined}
+            marginRight={columns && gi < HELP_GROUPS.length - 1 ? COL_GAP : 0}
+            marginTop={!columns && gi > 0 ? 1 : 0}
+          >
+            <Text bold>{group.title}</Text>
+            {group.hints.map((h) => (
+              <Box key={h.keys + h.label}>
+                <Box width={columns ? KEY_W[gi] : KEY_W_STACKED} flexShrink={0}>
+                  <Text color={COLOR.alt}>{h.keys}</Text>
+                </Box>
+                <Text dimColor>{h.label}</Text>
+              </Box>
+            ))}
+          </Box>
+        ))}
+      </Box>
+      <Box marginTop={1}>
+        <Text dimColor>Press ? or esc to close</Text>
+      </Box>
+    </Box>
+  );
+}