github-search-cli 9.4.1 → 9.4.3

package/src/trending.ts

@@ -1,462 +1,481 @@
-#!/usr/bin/env node
-/** trending.ts — "Trending Repositories" view for the GitHub repo browser CLI. */
-import {
-  createCliRenderer,
-  BoxRenderable,
-  TextRenderable,
-  ScrollBoxRenderable,
-  StyledText,
-  bold,
-  fg,
-  dim,
-  t,
-} from "@opentui/core";
-import type { Repo, ParsedQuery } from "./types";
-import { openUrl } from "./open-url";
-import { SearchModule, TrendingAdapter } from "./search";
-// ─── Tokyo Night palette ──────────────────────────────────────────────
-const C = {
-  bg: "#1a1b26",
-  surface: "#16161e",
-  text: "#a9b1d6",
-  muted: "#565f89",
-  cyan: "#7dcfff",
-  purple: "#bb9af7",
-  green: "#9ece6a",
-  gold: "#e0af68",
-  orange: "#ff9e64",
-  red: "#f7768e",
-  blue: "#7aa2f7",
-  lightBlue: "#b4f9f8",
-  selectionBg: "#3b6ce8",
-  selectionText: "#c0caf5",
-  border: "#363b54",
-  descText: "#6c7086", // lighter muted for descriptions
-  rankBg: "#2a2e42",
-  rankTop1: "#e0af68", // gold
-  rankTop2: "#9ece6a", // silver-ish green
-  rankTop3: "#ff9e64", // bronze-ish orange
-  rankRest: "#565f89", // muted gray
-};
-// ─── Language → color mapping ─────────────────────────────────────────
-const LANG_COLORS: Record<string, string> = {
-  Rust: "#e0af68",
-  TypeScript: "#7dcfff",
-  JavaScript: "#e0d068",
-  Python: "#7aa2f7",
-  Go: "#73daca",
-  Java: "#f7768e",
-  Ruby: "#f7768e",
-  C: "#f7768e",
-  "C++": "#f7768e",
-  "C#": "#f7768e",
-  Shell: "#9ece6a",
-  Zig: "#e0af68",
-  Lua: "#7dcfff",
-  Haskell: "#bb9af7",
-  Elixir: "#bb9af7",
-  Dart: "#73daca",
-  Swift: "#f7768e",
-  Kotlin: "#7aa2f7",
-};
-function langColor(lang: string): string {
-  return LANG_COLORS[lang] ?? C.muted;
-}
-function rankColor(rank: number): string {
-  if (rank === 1) return C.rankTop1;
-  if (rank === 2) return C.rankTop2;
-  if (rank === 3) return C.rankTop3;
-  return C.rankRest;
-}
-// ─── Tab definitions ──────────────────────────────────────────────────
-export const TAB_NAMES = ["Today", "This Week", "This Month"] as const;
-export type TabName = (typeof TAB_NAMES)[number];
-/** Map TabName to github.com/trending?since= param */
-export function tabSince(tab: TabName): "daily" | "weekly" | "monthly" {
-  switch (tab) {
-    case "Today":     return "daily";
-    case "This Week": return "weekly";
-    default:          return "monthly";
-  }
-}
-// ─── Number formatting ────────────────────────────────────────────────
-/** 1234 → "1.2k", 1234567 → "1.2M", 999999 → "1M" */
-export function fmtStars(n: number): string {
-  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1).replace(/\.0$/, "")}M`;
-  if (n >= 999_500) return "1M"; // ponytail: round 999500+ up before showing 1000k
-  if (n >= 1_000) return `${(n / 1_000).toFixed(1).replace(/\.0$/, "")}k`;
-  return String(n);
-}
-/** Format signed number: 1204 → "+1.2k" */
-export function fmtSigned(n: number): string {
-  const abs = fmtStars(Math.abs(n));
-  return n >= 0 ? `+${abs}` : `-${abs}`;
-}
-// ─── Row formatting ───────────────────────────────────────────────────
-/**
- * Format one repo as a StyledText for per-chunk coloring.
- *
- * Layout (two lines):
- *   "[01] owner/name  ● Rust  ★ 89.2k  ▲ +235 today"
- *   "  Build smaller, faster desktop apps."
- *
- * Uses OpenTUI's StyledText + bold/fg/dim helpers for per-element colors:
- *   - Rank badge: colored background via bracket style, rank color
- *   - owner/name: bold white
- *   - Language dot: language-specific color
- *   - Stars: gold
- *   - Growth: green bold
- *   - Description: dim muted gray
- */
-export function formatRepoLine(repo: Repo, rank: number): StyledText {
-  const rankStr = String(rank).padStart(2, "0");
-  const full = `${repo.owner}/${repo.name}`;
-  const lc = langColor(repo.language ?? "");
-  const rc = rankColor(rank);
-  const star = "★";
-  const arrow = repo.score > 0 ? "▲" : repo.score < 0 ? "▼" : "—";
-  const growth = `${arrow} ${fmtSigned(repo.score)} today`;
-  const desc = (repo.description ?? "").length > 60
-    ? (repo.description ?? "").slice(0, 57) + "..."
-    : (repo.description ?? "");
-  const line1 = t`${dim(fg(C.rankBg)(`[${rankStr}]`))} ${bold(fg("#c0caf5")(full))}  ${fg(lc)(`● ${repo.language}`)}  ${fg(C.gold)(`${star} ${fmtStars(repo.stars)}`)}  ${bold(fg(C.green)(growth))}`;
-  const line2 = t`  ${dim(fg(C.muted)(desc))}`;
-  const chunks = [
-    ...line1.chunks,
-    { text: "\n", __isChunk: true as const, fg: C.text },
-    ...line2.chunks,
-  ];
-  return new StyledText(chunks);
-}
-// ─── Tab query builder ────────────────────────────────────────────────
-/**
- * Build a GitHub search query string for the given time range tab.
- *
- * Examples:
- *   "Today"      → "created:>2026-07-09 sort:stars"
- *   "This Week"  → "created:>2026-07-03 sort:stars"
- *   "All Time"   → "sort:stars"
- */
-export function getTrendingQuery(tab: TabName): string {
-  const now = Date.now();
-  const msPerDay = 86_400_000;
-  const ranges: Record<TabName, number> = {
-    Today: 1,
-    "This Week": 7,
-    "This Month": 30,
-  };
-  const days = ranges[tab];
-  if (days === 0) return "sort:stars";
-  const d = new Date(now - days * msPerDay);
-  return `created:>${d.toISOString().slice(0, 10)} sort:stars`;
-}
-// ─── Main TUI entry ───────────────────────────────────────────────────
-export async function launchTrending(): Promise<void> {
-  let renderer;
-  try {
-    renderer = await createCliRenderer();
-  } catch (err) {
-    console.error(
-      "Failed to start the interactive browser.\n",
-      `Reason: ${err instanceof Error ? err.message : String(err)}\n`,
-    );
-    process.exit(1);
-    return;
-  }
-  const root = renderer.root;
-  root.flexDirection = "column";
-  root.backgroundColor = C.bg;
-  // ── State ──
-  let selectedTab = 1; // "This Week" default
-  let currentPeriod = "this week";
-  let repos: Repo[] = [];
-  let selectedRepoIdx = 0;
-  let isLoading = false;
-  // ── Fetch from github.com/trending ──
-  async function loadTab(index: number) {
-    if (index < 0 || index >= TAB_NAMES.length) return;
-    selectedTab = index;
-    const since = tabSince(TAB_NAMES[index]);
-    currentPeriod = since === "daily" ? "today" : since === "weekly" ? "this week" : "this month";
-    isLoading = true;
-    for (const rb of rowBoxes) scrollBox.remove(rb);
-    rowBoxes.length = 0;
-    rowTexts.length = 0;
-    const loadingText = new TextRenderable(renderer, {
-      content: t`${dim(fg(C.muted)(`  Loading trending repos...`))}`,
-      backgroundColor: C.bg,
-      height: 1,
-    });
-    scrollBox.add(loadingText);
-    renderer.requestRender();
-    try {
-      const searchModule = new SearchModule(new TrendingAdapter());
-      const parsed: ParsedQuery = { keywords: [], qualifiers: [], raw: "trending" };
-      const response = await searchModule.search(parsed, {
-        limit: 25,
-        sort: "stars",
-        json: false,
-        verbose: false,
-        trendingSince: tabSince(TAB_NAMES[index]),
-      });
-      scrollBox.remove(loadingText);
-      repos = response.repos;
-      selectedRepoIdx = 0;
-      rebuildList();
-    } catch (err) {
-      scrollBox.remove(loadingText);
-      const msg = err instanceof Error ? err.message : String(err);
-      const errText = new TextRenderable(renderer, {
-        content: t`${fg(C.red)(`  Error: ${msg.slice(0, 70)}`)}`,
-        backgroundColor: C.bg,
-        height: 1,
-      });
-      scrollBox.add(errText);
-    }
-    isLoading = false;
-    renderTabBar();
-    renderer.requestRender();
-  }
-  // ── Switch tab ──
-  function switchTab(index: number) {
-    if (index < 0 || index >= TAB_NAMES.length || index === selectedTab) return;
-    loadTab(index);
-  }
-  // ── Outer frame ──
-  const outerBox = new BoxRenderable(renderer, {
-    flexGrow: 1,
-    flexDirection: "column",
-    backgroundColor: C.bg,
-    border: true,
-    borderColor: C.border,
-    borderStyle: "rounded",
-    paddingX: 0,
-    paddingY: 0,
-  });
-  // ── Header bar ──
-  const headerBox = new BoxRenderable(renderer, {
-    height: 1,
-    backgroundColor: C.bg,
-    paddingX: 1,
-  });
-  const headerText = new TextRenderable(renderer, {
-    content: t`${bold(fg(C.purple)("⟠ tulipsearch"))}${fg(C.muted)(" — Trending")}`,
-    height: 1,
-  });
-  headerBox.add(headerText);
-  outerBox.add(headerBox);
-  // ── Tab bar ──
-  const tabBox = new BoxRenderable(renderer, {
-    flexDirection: "row",
-    height: 1,
-    backgroundColor: C.bg,
-    paddingX: 1,
-  });
-  const tabTexts: TextRenderable[] = [];
-  const underlineBox = new BoxRenderable(renderer, {
-    height: 1,
-    backgroundColor: C.bg,
-    paddingX: 1,
-  });
-  function tabWidth(name: string): number {
-    return name.length + 2; // " name " padding
-  }
-  function renderTabBar() {
-    for (const t of tabTexts) tabBox.remove(t);
-    tabTexts.length = 0;
-    TAB_NAMES.forEach((name, i) => {
-      const isActive = i === selectedTab;
-      const label = ` ${name} `;
-      const tt = new TextRenderable(renderer, {
-        content: isActive ? t`${bold(fg(C.bg)(label))}` : t`${fg(C.muted)(label)}`,
-        fg: isActive ? C.bg : C.muted,
-        bg: isActive ? C.cyan : C.bg,
-        height: 1,
-      });
-      tabTexts.push(tt);
-      tabBox.add(tt);
-      if (i < TAB_NAMES.length - 1) {
-        const sp = new TextRenderable(renderer, {
-          content: "  ",
-          fg: C.muted,
-          bg: C.bg,
-          height: 1,
-        });
-        tabTexts.push(sp);
-        tabBox.add(sp);
-      }
-    });
-    // ── cyan underline bar under active tab ──
-    let offset = 1; // paddingX
-    for (let i = 0; i < selectedTab; i++) {
-      offset += tabWidth(TAB_NAMES[i]) + 2; // tab + separator
-    }
-    const w = tabWidth(TAB_NAMES[selectedTab]);
-    const dots = "┉".repeat(w);
-    underlineBox.remove(underlineText);
-    underlineText.content = t`${fg(C.cyan)(dots)}`;
-    underlineText.left = offset;
-  }
-  const underlineText = new TextRenderable(renderer, {
-    content: "",
-    fg: C.cyan,
-    bg: C.bg,
-    height: 1,
-  });
-  underlineBox.add(underlineText);
-  renderTabBar();
-  outerBox.add(tabBox);
-  outerBox.add(underlineBox);
-  const divider = new TextRenderable(renderer, {
-    content: "─".repeat(80),
-    color: C.border,
-    height: 1,
-    backgroundColor: C.bg,
-  });
-  outerBox.add(divider);
-  // ── Repo list (scrollable) ──
-  const scrollBox = new ScrollBoxRenderable(renderer, {
-    flexGrow: 1,
-    backgroundColor: C.bg,
-    scrollY: true,
-    scrollX: false,
-    viewportCulling: true,
-  });
-  const rowBoxes: BoxRenderable[] = [];
-  const rowTexts: TextRenderable[] = [];
-  function rebuildList() {
-    for (const rb of rowBoxes) scrollBox.remove(rb);
-    rowBoxes.length = 0;
-    rowTexts.length = 0;
-    repos.forEach((r, i) => {
-      const isEven = i % 2 === 0;
-      const isSelected = i === selectedRepoIdx;
-      const rowBg = isSelected ? C.selectionBg : (isEven ? C.bg : C.surface);
-      const rank = i + 1;
-      const rc = rankColor(rank);
-      const lc = langColor(r.language ?? "");
-      const desc = (r.description ?? "").length > 55
-        ? (r.description ?? "").slice(0, 52) + "..."
-        : (r.description ?? "");
-      const arrow = r.score > 0 ? "▲" : r.score < 0 ? "▼" : "—";
-      const growthStr = `${arrow} ${fmtStars(Math.abs(r.score))} ${currentPeriod}`;
-      const rankStr = `[${String(rank).padStart(2, "0")}]`;
-      const nameStr = `${r.owner}/${r.name}`.padEnd(30).slice(0, 30);
-      const langStr = `● ${r.language || "—"}`.padEnd(14).slice(0, 14);
-      const starsStr = `★ ${fmtStars(r.stars)}`.padEnd(12).slice(0, 12);
-      const rankText = new TextRenderable(renderer, {
-        content: t`${bold(fg(rc)(rankStr))}`,
-        backgroundColor: C.rankBg,
-        color: rc,
-        height: 1,
-      });
-      const descStr = desc.length > 60 ? desc.slice(0, 57) + "..." : desc;
-      const pad = "     ";
-      const line1 = t`${bold(fg("#c0caf5")(nameStr))}${fg(lc)(langStr)}${fg(C.muted)(starsStr)}${bold(fg(C.green)(growthStr))}`;
-      const line2 = t`${fg(C.descText)(`${pad}${descStr}`)}`;
-      const chunks = [
-        ...line1.chunks,
-        { text: "\n", __isChunk: true as const, fg: C.text },
-        ...line2.chunks,
-      ];
-      const rowText = new TextRenderable(renderer, {
-        content: new StyledText(chunks),
-        backgroundColor: rowBg,
-        height: 2,
-      });
-      const rowBox = new BoxRenderable(renderer, {
-        flexDirection: "row",
-        backgroundColor: rowBg,
-      });
-      rowBox.add(rankText);
-      rowBox.add(rowText);
-      rowBoxes.push(rowBox);
-      rowTexts.push(rowText);
-      scrollBox.add(rowBox);
-    });
-  }
-  outerBox.add(scrollBox);
-  // ── Footer bar ──
-  const footerBox = new BoxRenderable(renderer, {
-    height: 1,
-    backgroundColor: C.bg,
-    paddingX: 1,
-  });
-  const footerText = new TextRenderable(renderer, {
-    content: " ↑↓ navigate  ↵ open  / search  1-3 tab  q quit  r refresh",
-    color: C.muted,
-    height: 1,
-  });
-  footerBox.add(footerText);
-  outerBox.add(footerBox);
-  root.add(outerBox);
-  // ── Helpers ──
-  function openSelectedRepo() {
-    if (selectedRepoIdx < 0 || selectedRepoIdx >= repos.length) return;
-    const r = repos[selectedRepoIdx];
-    openUrl(`https://github.com/${r.owner}/${r.name}`);
-  }
-  function moveSelection(delta: number) {
-    const oldIdx = selectedRepoIdx;
-    const newIdx = Math.max(0, Math.min(repos.length - 1, oldIdx + delta));
-    if (newIdx === oldIdx) return;
-    selectedRepoIdx = newIdx;
-    const setBg = (idx: number, selected: boolean) => {
-      if (idx < 0 || idx >= rowBoxes.length) return;
-      const bg = selected ? C.selectionBg : (idx % 2 === 0 ? C.bg : C.surface);
-      rowBoxes[idx].backgroundColor = bg;
-      if (rowTexts[idx]) rowTexts[idx].backgroundColor = bg;
-    };
-    setBg(oldIdx, false);
-    setBg(newIdx, true);
-    renderer.requestRender();
-  }
-  // ── Global key events ──
-  renderer.keyInput.on("keypress", (key) => {
-    const name = key.name || "";
-    if (name === "q") {
-      process.exit(0);
-      return;
-    }
-    if (/^[1-3]$/.test(name)) {
-      switchTab(parseInt(name, 10) - 1);
-      return;
-    }
-    if (name === "left" || name === "h") {
-      switchTab(selectedTab - 1);
-      return;
-    }
-    if (name === "right" || name === "l") {
-      switchTab(selectedTab + 1);
-      return;
-    }
-    if (name === "up" || name === "k") {
-      moveSelection(-1);
-      return;
-    }
-    if (name === "down" || name === "j") {
-      moveSelection(1);
-      return;
-    }
-    if (name === "enter" || name === "return" || name === "o") {
-      openSelectedRepo();
-      return;
-    }
-    if (name === "/") {
-      moveSelection(-selectedRepoIdx);
-      return;
-    }
-    if (name === "r") {
-      loadTab(selectedTab);
-      return;
-    }
-  });
-  // ── Start ──
-  renderer.start();
-  renderer.requestRender();
-  loadTab(selectedTab);
-}
-// ── Auto-run ──────────────────────────────────────────────────────────
-if (import.meta.main && !process.env.GHFIND_BUNDLED) {
-  launchTrending();
-}
+#!/usr/bin/env node
+/** trending.ts — "Trending Repositories" view for the GitHub repo browser CLI. */
+import {
+  createCliRenderer,
+  BoxRenderable,
+  TextRenderable,
+  ScrollBoxRenderable,
+  StyledText,
+  bold,
+  fg,
+  dim,
+  t,
+} from "@opentui/core";
+import type { CliRenderer } from "@opentui/core";
+import type { Repo, ParsedQuery } from "./types";
+import { openUrl } from "./open-url";
+import { SearchModule, TrendingAdapter } from "./search";
+import { detectTerminalBackground, deriveSurfaceLayers } from "./themes";
+// ─── Tokyo Night palette ──────────────────────────────────────────────
+const C = {
+  bg: "#1a1b26",
+  surface: "#16161e",
+  text: "#a9b1d6",
+  muted: "#565f89",
+  cyan: "#7dcfff",
+  purple: "#bb9af7",
+  green: "#9ece6a",
+  gold: "#e0af68",
+  orange: "#ff9e64",
+  red: "#f7768e",
+  blue: "#7aa2f7",
+  lightBlue: "#b4f9f8",
+  selectionBg: "#3b6ce8",
+  selectionText: "#c0caf5",
+  border: "#363b54",
+  descText: "#6c7086", // lighter muted for descriptions
+  rankBg: "#2a2e42",
+  rankTop1: "#e0af68", // gold
+  rankTop2: "#9ece6a", // silver-ish green
+  rankTop3: "#ff9e64", // bronze-ish orange
+  rankRest: "#565f89", // muted gray
+};
+// ─── Language → color mapping ─────────────────────────────────────────
+const LANG_COLORS: Record<string, string> = {
+  Rust: "#e0af68",
+  TypeScript: "#7dcfff",
+  JavaScript: "#e0d068",
+  Python: "#7aa2f7",
+  Go: "#73daca",
+  Java: "#f7768e",
+  Ruby: "#f7768e",
+  C: "#f7768e",
+  "C++": "#f7768e",
+  "C#": "#f7768e",
+  Shell: "#9ece6a",
+  Zig: "#e0af68",
+  Lua: "#7dcfff",
+  Haskell: "#bb9af7",
+  Elixir: "#bb9af7",
+  Dart: "#73daca",
+  Swift: "#f7768e",
+  Kotlin: "#7aa2f7",
+};
+function langColor(lang: string): string {
+  return LANG_COLORS[lang] ?? C.muted;
+}
+function rankColor(rank: number): string {
+  if (rank === 1) return C.rankTop1;
+  if (rank === 2) return C.rankTop2;
+  if (rank === 3) return C.rankTop3;
+  return C.rankRest;
+}
+// ─── Tab definitions ──────────────────────────────────────────────────
+export const TAB_NAMES = ["Today", "This Week", "This Month"] as const;
+export type TabName = (typeof TAB_NAMES)[number];
+/** Map TabName to github.com/trending?since= param */
+export function tabSince(tab: TabName): "daily" | "weekly" | "monthly" {
+  switch (tab) {
+    case "Today":
+      return "daily";
+    case "This Week":
+      return "weekly";
+    default:
+      return "monthly";
+  }
+}
+// ─── Number formatting ────────────────────────────────────────────────
+/** 1234 → "1.2k", 1234567 → "1.2M", 999999 → "1M" */
+export function fmtStars(n: number): string {
+  if (n >= 1_000_000)
+    return `${(n / 1_000_000).toFixed(1).replace(/\.0$/, "")}M`;
+  if (n >= 999_500) return "1M"; // ponytail: round 999500+ up before showing 1000k
+  if (n >= 1_000) return `${(n / 1_000).toFixed(1).replace(/\.0$/, "")}k`;
+  return String(n);
+}
+/** Format signed number: 1204 → "+1.2k" */
+export function fmtSigned(n: number): string {
+  const abs = fmtStars(Math.abs(n));
+  return n >= 0 ? `+${abs}` : `-${abs}`;
+}
+// ─── Row formatting ───────────────────────────────────────────────────
+/**
+ * Format one repo as a StyledText for per-chunk coloring.
+ *
+ * Layout (two lines):
+ *   "[01] owner/name  ● Rust  ★ 89.2k  ▲ +235 today"
+ *   "  Build smaller, faster desktop apps."
+ *
+ * Uses OpenTUI's StyledText + bold/fg/dim helpers for per-element colors:
+ *   - Rank badge: colored background via bracket style, rank color
+ *   - owner/name: bold white
+ *   - Language dot: language-specific color
+ *   - Stars: gold
+ *   - Growth: green bold
+ *   - Description: dim muted gray
+ */
+export function formatRepoLine(repo: Repo, rank: number): StyledText {
+  const rankStr = String(rank).padStart(2, "0");
+  const full = `${repo.owner}/${repo.name}`;
+  const lc = langColor(repo.language ?? "");
+  const rc = rankColor(rank);
+  const star = "★";
+  const arrow = repo.score > 0 ? "▲" : repo.score < 0 ? "▼" : "—";
+  const growth = `${arrow} ${fmtSigned(repo.score)} today`;
+  const desc =
+    (repo.description ?? "").length > 60
+      ? (repo.description ?? "").slice(0, 57) + "..."
+      : (repo.description ?? "");
+  const line1 = t`${dim(fg(C.rankBg)(`[${rankStr}]`))} ${bold(fg("#c0caf5")(full))}  ${fg(lc)(`● ${repo.language}`)}  ${fg(C.gold)(`${star} ${fmtStars(repo.stars)}`)}  ${bold(fg(C.green)(growth))}`;
+  const line2 = t`  ${dim(fg(C.muted)(desc))}`;
+  const chunks = [...line1.chunks, fg(C.text)("\n"), ...line2.chunks];
+  return new StyledText(chunks);
+}
+// ─── Tab query builder ────────────────────────────────────────────────
+/**
+ * Build a GitHub search query string for the given time range tab.
+ *
+ * Examples:
+ *   "Today"      → "created:>2026-07-09 sort:stars"
+ *   "This Week"  → "created:>2026-07-03 sort:stars"
+ *   "All Time"   → "sort:stars"
+ */
+export function getTrendingQuery(tab: TabName): string {
+  const now = Date.now();
+  const msPerDay = 86_400_000;
+  const ranges: Record<TabName, number> = {
+    Today: 1,
+    "This Week": 7,
+    "This Month": 30,
+  };
+  const days = ranges[tab];
+  if (days === 0) return "sort:stars";
+  const d = new Date(now - days * msPerDay);
+  return `created:>${d.toISOString().slice(0, 10)} sort:stars`;
+}
+// ─── Main TUI entry ───────────────────────────────────────────────────
+export async function launchTrending(): Promise<void> {
+  // Match the app backdrop to the terminal's own background (OSC 11), before
+  // the renderer takes over stdin. Falls back to the Tokyo Night bg. Surface
+  // and border layers are blended toward that background for a seamless look.
+  const terminalBg = await detectTerminalBackground();
+  if (terminalBg) {
+    C.bg = terminalBg;
+    Object.assign(C, deriveSurfaceLayers(terminalBg));
+  }
+  let renderer: CliRenderer;
+  try {
+    renderer = await createCliRenderer();
+  } catch (err) {
+    console.error(
+      "Failed to start the interactive browser.\n",
+      `Reason: ${err instanceof Error ? err.message : String(err)}\n`,
+    );
+    process.exit(1);
+    return;
+  }
+  const root = renderer.root;
+  root.flexDirection = "column";
+  renderer.setBackgroundColor(C.bg);
+  // ── State ──
+  let selectedTab = 1; // "This Week" default
+  let currentPeriod = "this week";
+  let repos: Repo[] = [];
+  let selectedRepoIdx = 0;
+  let isLoading = false;
+  // ── Fetch from github.com/trending ──
+  async function loadTab(index: number) {
+    if (index < 0 || index >= TAB_NAMES.length) return;
+    selectedTab = index;
+    const since = tabSince(TAB_NAMES[index]);
+    currentPeriod =
+      since === "daily"
+        ? "today"
+        : since === "weekly"
+          ? "this week"
+          : "this month";
+    isLoading = true;
+    for (const rb of rowBoxes) scrollBox.remove(rb);
+    rowBoxes.length = 0;
+    rowTexts.length = 0;
+    const loadingText = new TextRenderable(renderer, {
+      content: t`${dim(fg(C.muted)(`  Loading trending repos...`))}`,
+      bg: C.bg,
+      height: 1,
+    });
+    scrollBox.add(loadingText);
+    renderer.requestRender();
+    try {
+      const searchModule = new SearchModule(new TrendingAdapter());
+      const parsed: ParsedQuery = {
+        keywords: [],
+        qualifiers: [],
+        raw: "trending",
+      };
+      const response = await searchModule.search(parsed, {
+        limit: 25,
+        sort: "stars",
+        json: false,
+        verbose: false,
+        trendingSince: tabSince(TAB_NAMES[index]),
+      });
+      scrollBox.remove(loadingText);
+      repos = response.repos;
+      selectedRepoIdx = 0;
+      rebuildList();
+    } catch (err) {
+      scrollBox.remove(loadingText);
+      const msg = err instanceof Error ? err.message : String(err);
+      const errText = new TextRenderable(renderer, {
+        content: t`${fg(C.red)(`  Error: ${msg.slice(0, 70)}`)}`,
+        bg: C.bg,
+        height: 1,
+      });
+      scrollBox.add(errText);
+    }
+    isLoading = false;
+    renderTabBar();
+    renderer.requestRender();
+  }
+  // ── Switch tab ──
+  function switchTab(index: number) {
+    if (index < 0 || index >= TAB_NAMES.length || index === selectedTab) return;
+    loadTab(index);
+  }
+  // ── Outer frame ──
+  const outerBox = new BoxRenderable(renderer, {
+    flexGrow: 1,
+    flexDirection: "column",
+    backgroundColor: C.bg,
+    border: true,
+    borderColor: C.border,
+    borderStyle: "rounded",
+    paddingX: 0,
+    paddingY: 0,
+  });
+  // ── Header bar ──
+  const headerBox = new BoxRenderable(renderer, {
+    height: 1,
+    backgroundColor: C.bg,
+    paddingX: 1,
+  });
+  const headerText = new TextRenderable(renderer, {
+    content: t`${bold(fg(C.purple)("⟠ tulipsearch"))}${fg(C.muted)(" — Trending")}`,
+    height: 1,
+  });
+  headerBox.add(headerText);
+  outerBox.add(headerBox);
+  // ── Tab bar ──
+  const tabBox = new BoxRenderable(renderer, {
+    flexDirection: "row",
+    height: 1,
+    backgroundColor: C.bg,
+    paddingX: 1,
+  });
+  const tabTexts: TextRenderable[] = [];
+  const underlineBox = new BoxRenderable(renderer, {
+    height: 1,
+    backgroundColor: C.bg,
+    paddingX: 1,
+  });
+  function tabWidth(name: string): number {
+    return name.length + 2; // " name " padding
+  }
+  function renderTabBar() {
+    for (const t of tabTexts) tabBox.remove(t);
+    tabTexts.length = 0;
+    TAB_NAMES.forEach((name, i) => {
+      const isActive = i === selectedTab;
+      const label = ` ${name} `;
+      const tt = new TextRenderable(renderer, {
+        content: isActive
+          ? t`${bold(fg(C.bg)(label))}`
+          : t`${fg(C.muted)(label)}`,
+        fg: isActive ? C.bg : C.muted,
+        bg: isActive ? C.cyan : C.bg,
+        height: 1,
+      });
+      tabTexts.push(tt);
+      tabBox.add(tt);
+      if (i < TAB_NAMES.length - 1) {
+        const sp = new TextRenderable(renderer, {
+          content: "  ",
+          fg: C.muted,
+          bg: C.bg,
+          height: 1,
+        });
+        tabTexts.push(sp);
+        tabBox.add(sp);
+      }
+    });
+    // ── cyan underline bar under active tab ──
+    let offset = 1; // paddingX
+    for (let i = 0; i < selectedTab; i++) {
+      offset += tabWidth(TAB_NAMES[i]) + 2; // tab + separator
+    }
+    const w = tabWidth(TAB_NAMES[selectedTab]);
+    const dots = "┉".repeat(w);
+    underlineBox.remove(underlineText);
+    underlineText.content = t`${fg(C.cyan)(dots)}`;
+    underlineText.left = offset;
+  }
+  const underlineText = new TextRenderable(renderer, {
+    content: "",
+    fg: C.cyan,
+    bg: C.bg,
+    height: 1,
+  });
+  underlineBox.add(underlineText);
+  renderTabBar();
+  outerBox.add(tabBox);
+  outerBox.add(underlineBox);
+  const divider = new TextRenderable(renderer, {
+    content: "─".repeat(80),
+    fg: C.border,
+    height: 1,
+    bg: C.bg,
+  });
+  outerBox.add(divider);
+  // ── Repo list (scrollable) ──
+  const scrollBox = new ScrollBoxRenderable(renderer, {
+    flexGrow: 1,
+    backgroundColor: C.bg,
+    scrollY: true,
+    scrollX: false,
+    viewportCulling: true,
+  });
+  const rowBoxes: BoxRenderable[] = [];
+  const rowTexts: TextRenderable[] = [];
+  function rebuildList() {
+    for (const rb of rowBoxes) scrollBox.remove(rb);
+    rowBoxes.length = 0;
+    rowTexts.length = 0;
+    repos.forEach((r, i) => {
+      const isEven = i % 2 === 0;
+      const isSelected = i === selectedRepoIdx;
+      const rowBg = isSelected ? C.selectionBg : isEven ? C.bg : C.surface;
+      const rank = i + 1;
+      const rc = rankColor(rank);
+      const lc = langColor(r.language ?? "");
+      const desc =
+        (r.description ?? "").length > 55
+          ? (r.description ?? "").slice(0, 52) + "..."
+          : (r.description ?? "");
+      const arrow = r.score > 0 ? "▲" : r.score < 0 ? "▼" : "—";
+      const growthStr = `${arrow} ${fmtStars(Math.abs(r.score))} ${currentPeriod}`;
+      const rankStr = `[${String(rank).padStart(2, "0")}]`;
+      const nameStr = `${r.owner}/${r.name}`.padEnd(30).slice(0, 30);
+      const langStr = `● ${r.language || "—"}`.padEnd(14).slice(0, 14);
+      const starsStr = `★ ${fmtStars(r.stars)}`.padEnd(12).slice(0, 12);
+      const rankText = new TextRenderable(renderer, {
+        content: t`${bold(fg(rc)(rankStr))}`,
+        bg: C.rankBg,
+        fg: rc,
+        height: 1,
+      });
+      const descStr = desc.length > 60 ? desc.slice(0, 57) + "..." : desc;
+      const pad = "     ";
+      const line1 = t`${bold(fg("#c0caf5")(nameStr))}${fg(lc)(langStr)}${fg(C.muted)(starsStr)}${bold(fg(C.green)(growthStr))}`;
+      const line2 = t`${fg(C.descText)(`${pad}${descStr}`)}`;
+      const chunks = [...line1.chunks, fg(C.text)("\n"), ...line2.chunks];
+      const rowText = new TextRenderable(renderer, {
+        content: new StyledText(chunks),
+        bg: rowBg,
+        height: 2,
+      });
+      const rowBox = new BoxRenderable(renderer, {
+        flexDirection: "row",
+        backgroundColor: rowBg,
+      });
+      rowBox.add(rankText);
+      rowBox.add(rowText);
+      rowBoxes.push(rowBox);
+      rowTexts.push(rowText);
+      scrollBox.add(rowBox);
+    });
+  }
+  outerBox.add(scrollBox);
+  // ── Footer bar ──
+  const footerBox = new BoxRenderable(renderer, {
+    height: 1,
+    backgroundColor: C.bg,
+    paddingX: 1,
+  });
+  const footerText = new TextRenderable(renderer, {
+    content: " ↑↓ navigate  ↵ open  / search  1-3 tab  q quit  r refresh",
+    fg: C.muted,
+    height: 1,
+  });
+  footerBox.add(footerText);
+  outerBox.add(footerBox);
+  root.add(outerBox);
+  // ── Helpers ──
+  function openSelectedRepo() {
+    if (selectedRepoIdx < 0 || selectedRepoIdx >= repos.length) return;
+    const r = repos[selectedRepoIdx];
+    openUrl(`https://github.com/${r.owner}/${r.name}`);
+  }
+  function moveSelection(delta: number) {
+    const oldIdx = selectedRepoIdx;
+    const newIdx = Math.max(0, Math.min(repos.length - 1, oldIdx + delta));
+    if (newIdx === oldIdx) return;
+    selectedRepoIdx = newIdx;
+    const setBg = (idx: number, selected: boolean) => {
+      if (idx < 0 || idx >= rowBoxes.length) return;
+      const bg = selected ? C.selectionBg : idx % 2 === 0 ? C.bg : C.surface;
+      rowBoxes[idx].backgroundColor = bg;
+      if (rowTexts[idx]) rowTexts[idx].bg = bg;
+    };
+    setBg(oldIdx, false);
+    setBg(newIdx, true);
+    renderer.requestRender();
+  }
+  // ── Global key events ──
+  renderer.keyInput.on("keypress", (key) => {
+    const name = key.name || "";
+    if (name === "q") {
+      process.exit(0);
+      return;
+    }
+    if (/^[1-3]$/.test(name)) {
+      switchTab(parseInt(name, 10) - 1);
+      return;
+    }
+    if (name === "left" || name === "h") {
+      switchTab(selectedTab - 1);
+      return;
+    }
+    if (name === "right" || name === "l") {
+      switchTab(selectedTab + 1);
+      return;
+    }
+    if (name === "up" || name === "k") {
+      moveSelection(-1);
+      return;
+    }
+    if (name === "down" || name === "j") {
+      moveSelection(1);
+      return;
+    }
+    if (name === "enter" || name === "return" || name === "o") {
+      openSelectedRepo();
+      return;
+    }
+    if (name === "/") {
+      moveSelection(-selectedRepoIdx);
+      return;
+    }
+    if (name === "r") {
+      loadTab(selectedTab);
+      return;
+    }
+  });
+  // ── Start ──
+  renderer.start();
+  renderer.requestRender();
+  loadTab(selectedTab);
+}
+// ── Auto-run ──────────────────────────────────────────────────────────
+if (import.meta.main && !process.env.GHFIND_BUNDLED) {
+  launchTrending();
+}