github-search-cli 9.9.0 → 9.10.1

package/dist/cli.js

@@ -1569,6 +1569,7 @@ async function launchPackageBrowser() {
   renderer.keyInput.on("keypress", (key) => {
     const name = key.name || "";
     if (name === "q" || name === "escape") {
+      renderer.destroy();
       process.exit(0);
       return;
     }
@@ -2153,7 +2154,7 @@ var cached = null;
 function getVersion() {
   if (cached) return cached;
   if (true) {
-    cached = "9.9.0";
+    cached = "9.10.1";
     return cached;
   }
   try {
@@ -2322,6 +2323,7 @@ function reportError(err, context = {
 
 // src/output.ts
 import { writeFileSync as writeFileSync2 } from "fs";
+var PIPE_TARGETS = ["open", "clone"];
 var FORMATS = /* @__PURE__ */ new Map([
   // Export formats
   ["json", formatJson],
@@ -2335,6 +2337,7 @@ var FORMATS = /* @__PURE__ */ new Map([
   ["clone-commands", formatCloneCommands],
   ["ids", formatIds]
 ]);
+var FORMAT_VALUES = [...FORMATS.keys()];
 function formatJson(repos) {
   return JSON.stringify(repos, null, 2);
 }
@@ -2407,6 +2410,13 @@ async function pipeExec(repos, target) {
 }
 
 // src/watch.ts
+function resolveTrendingSince(opts) {
+  if (opts.since === "weekly" || opts.since === "monthly") return opts.since;
+  if (opts.since === "daily") return "daily";
+  if (opts.query === "weekly") return "weekly";
+  if (opts.query === "monthly") return "monthly";
+  return "daily";
+}
 var MAX_FAILS = 5;
 async function runWatch(opts, onChange, onError) {
   let previous = [];
@@ -2419,7 +2429,7 @@ async function runWatch(opts, onChange, onError) {
     try {
       let repos;
       if (opts.trending) {
-        const since = opts.query === "weekly" ? "weekly" : opts.query === "monthly" ? "monthly" : "daily";
+        const since = resolveTrendingSince(opts);
         const trendingSearch = createTrendingSearch();
         const response = await trendingSearch.search(trendingQuery(), {
           limit: opts.limit,
@@ -3874,6 +3884,135 @@ if (import.meta.main && false) {
   launchTrending();
 }
 
+// src/tui/mouse.ts
+var DOUBLE_CLICK_MS = 400;
+function hitIndexForY(geometry, screenY) {
+  const pitch = geometry.linesPerItem;
+  if (pitch <= 0) return -1;
+  if (geometry.optionCount <= 0) return -1;
+  const localY = screenY - geometry.screenY;
+  if (localY < 0 || localY >= geometry.height) return -1;
+  const row = Math.floor(localY / pitch);
+  const index = geometry.scrollOffset + row;
+  const last = geometry.optionCount - 1;
+  if (index < 0) return 0;
+  return index > last ? last : index;
+}
+function selectRowGeometry(select) {
+  const internal = select;
+  return {
+    screenY: select.screenY,
+    height: select.height,
+    optionCount: select.options.length,
+    scrollOffset: internal.scrollOffset ?? 0,
+    linesPerItem: internal.linesPerItem ?? 0
+  };
+}
+function attachClickToSelect(renderer, select, options = {}) {
+  const wheelStep = options.wheelStep ?? 3;
+  let lastClickIndex = -1;
+  let lastClickAt = 0;
+  let lastHovered = -1;
+  select.onMouseDown = (event) => {
+    event.stopPropagation();
+    if (options.keepFocus) event.preventDefault();
+    const index = hitIndexForY(selectRowGeometry(select), event.y);
+    if (index < 0) {
+      lastClickIndex = -1;
+      options.onClickMiss?.();
+      return;
+    }
+    const now = Date.now();
+    const alreadySelected = select.getSelectedIndex() === index;
+    const isDouble = alreadySelected && index === lastClickIndex && now - lastClickAt < DOUBLE_CLICK_MS;
+    lastClickIndex = index;
+    lastClickAt = now;
+    if (isDouble) {
+      lastClickIndex = -1;
+      options.onOpen?.();
+      return;
+    }
+    select.setSelectedIndex(index);
+  };
+  select.onMouseScroll = (event) => {
+    event.stopPropagation();
+    const direction = event.scroll?.direction;
+    if (direction === "up") select.moveUp(wheelStep);
+    else if (direction === "down") select.moveDown(wheelStep);
+    else return;
+    renderer.requestRender();
+  };
+  attachHoverHighlight(renderer, select, {
+    onHover: (index) => {
+      lastHovered = index;
+      options.onHoverRow?.(index);
+    },
+    // A stale row must never outlive the options it pointed at.
+    onLeave: () => {
+      lastHovered = -1;
+    }
+  });
+  return {
+    reset() {
+      lastClickIndex = -1;
+      lastClickAt = 0;
+    },
+    get lastHovered() {
+      return lastHovered;
+    }
+  };
+}
+function attachHoverHighlight(renderer, select, options = {}) {
+  const idleBackground = select.backgroundColor;
+  const hoverBackground = "#ffffff0f";
+  let hovered = -1;
+  select.onMouseOver = () => {
+    renderer.setMousePointer("pointer");
+    select.backgroundColor = hoverBackground;
+    renderer.requestRender();
+  };
+  select.onMouseOut = () => {
+    renderer.setMousePointer("default");
+    select.backgroundColor = idleBackground;
+    if (hovered !== -1) {
+      hovered = -1;
+      options.onLeave?.();
+    }
+    renderer.requestRender();
+  };
+  select.onMouseMove = (event) => {
+    const index = hitIndexForY(selectRowGeometry(select), event.y);
+    if (index === hovered) return;
+    hovered = index;
+    options.onHover?.(index);
+  };
+}
+function attachClickOutside(target, onDismiss) {
+  target.onMouseDown = (event) => {
+    event.stopPropagation();
+    onDismiss();
+  };
+}
+function attachClickableBox(renderer, box, handlers) {
+  box.onMouseDown = (event) => {
+    event.stopPropagation();
+    handlers.onActivate();
+  };
+  box.onMouseOver = () => {
+    renderer.setMousePointer("pointer");
+    box.borderColor = handlers.activeBorder;
+    handlers.onStateChange?.();
+    renderer.requestRender();
+  };
+  box.onMouseOut = () => {
+    renderer.setMousePointer("default");
+    box.borderColor = handlers.idleBorder;
+    handlers.onStateChange?.();
+    renderer.requestRender();
+  };
+}
+var NON_INTERACTIVE_TEXT = { selectable: false };
+
 // src/help.ts
 function buildHelpSections() {
   return [
@@ -3895,7 +4034,7 @@ function buildHelpSections() {
         { keys: "\u2191 \u2193 / j k", action: "Move selection" },
         { keys: "Enter", action: "Open repo in browser" },
         { keys: "/", action: "Focus search input" },
-        { keys: "Space", action: "Open command menu" },
+        { keys: "Esc", action: "Open command menu" },
         { keys: "? / Ctrl+H", action: "Toggle this help screen" },
         { keys: "q", action: "Quit" }
       ]
@@ -3929,7 +4068,8 @@ function buildHelpSections() {
       rows: [
         { keys: "1-5", action: "Switch tab: Today \u2192 Week \u2192 Month \u2192 \u2026" },
         { keys: "\u2190 \u2192 / h l", action: "Navigate tabs" }
-      ]
+      ],
+      note: "Tabs are also clickable."
     },
     {
       title: " Packages Mode ",
@@ -3938,12 +4078,12 @@ function buildHelpSections() {
         { keys: "/", action: "Search npm packages" },
         { keys: "\u2191 \u2193 / j k", action: "Move selection" },
         { keys: "Enter", action: "View package details" },
-        { keys: "Space", action: "Open command menu" }
+        { keys: "Esc", action: "Open command menu" }
       ],
       note: "Search by name, description, or tags. Sort by downloads or score."
     },
     {
-      title: " Command Menu (Space)",
+      title: " Command Menu (Esc)",
       titleColor: "purple",
       rows: [
         { keys: "Sort", action: "Cycle sort: best-match \u2192 stars \u2192 \u2026" },
@@ -3968,7 +4108,7 @@ function buildHelpSections() {
         { keys: "History", action: "View search history" },
         { keys: "Help", action: "Show this help screen" }
       ],
-      note: "Navigate menu with \u2191 \u2193, select with Enter, back with \u2190 / Esc"
+      note: "Navigate menu with \u2191 \u2193, select with Enter, back with \u2190 / Esc. Clicking a row runs it directly. Esc (or the \u2630 menu button) opens this menu; Space types a space in the query."
     },
     {
       title: " Bookmarks Page ",
@@ -3981,6 +4121,22 @@ function buildHelpSections() {
       ],
       note: "A full page, not an overlay \u2014 Esc returns to the mode menu."
     },
+    {
+      title: " Mouse ",
+      titleColor: "green",
+      rows: [
+        { keys: "Click", action: "Select a row / card / tab" },
+        { keys: "Double-click", action: "Open the repo or run the action" },
+        { keys: "Scroll wheel", action: "Move the selection / scroll a pane" },
+        { keys: "Click outside", action: "Dismiss an open overlay" },
+        { keys: "Click query box", action: "Focus the search input" },
+        {
+          keys: "\u2630 menu button",
+          action: "Open the command menu (bottom-right)"
+        }
+      ],
+      note: "Every list is fully clickable; keyboard and mouse are interchangeable."
+    },
     {
       title: " Overlay Keys ",
       titleColor: "teal",
@@ -4724,10 +4880,12 @@ var StatusManager = class {
   type = "idle";
   message = "";
   onUpdate;
+  disposed = false;
   constructor(onUpdate) {
     this.onUpdate = onUpdate;
   }
   set(type, message) {
+    if (this.disposed) return;
     this.stopSpinner();
     this.type = type;
     this.message = message;
@@ -4740,6 +4898,7 @@ var StatusManager = class {
     }
   }
   startSpinner(frames) {
+    if (this.disposed) return;
     this.spinnerIndex = 0;
     this.emit(frames[0]);
     this.spinnerInterval = setInterval(() => {
@@ -4754,14 +4913,23 @@ var StatusManager = class {
     }
   }
   emit(spinner) {
+    if (this.disposed) return;
     const icon = this.type === "searching" ? "\u{1F50D}" : this.type === "loading" ? "\u{1F4E6}" : this.type === "success" ? "\u2713" : this.type === "error" ? "\u26A0" : " ";
     const prefix = spinner ?? "";
     this.onUpdate(`${icon} ${this.message}  ${prefix}`.trim());
   }
   dispose() {
+    this.disposed = true;
     this.stopSpinner();
   }
 };
+function createStatusManager(bar, onFrame) {
+  return new StatusManager((text) => {
+    if (bar.isDestroyed) return;
+    bar.content = ` ${text}`;
+    onFrame();
+  });
+}
 
 // src/share.ts
 import { spawn as spawn3 } from "child_process";
@@ -5124,13 +5292,15 @@ function createTuiLogger() {
   };
 }
 var logger = createTuiLogger();
+var activeStatusMgr = null;
+var activeRenderer = null;
 var SORT_MODES = [
   { key: "best-match", label: "best-match" },
   { key: "stars", label: "stars" },
   { key: "updated", label: "updated" },
   { key: "forks", label: "forks" }
 ];
-async function launchBrowser(theme_override) {
+async function launchBrowser(theme_override, startMode) {
   const terminalBg = await detectTerminalBackground();
   let renderer;
   try {
@@ -5166,6 +5336,7 @@ async function launchBrowser(theme_override) {
     return;
   }
   const root = renderer.root;
+  activeRenderer = renderer;
   root.flexDirection = "column";
   const config = loadConfig();
   let githubToken = config.githubToken || process.env.GITHUB_TOKEN;
@@ -5197,7 +5368,7 @@ async function launchBrowser(theme_override) {
   const compareList = [];
   const _quitArmed = false;
   const header = new TextRenderable5(renderer, {
-    content: " ghfind \u2014 GitHub repo browser   [/]search  [Space]menu  [\u2192]open  [?]help  [q]uit",
+    content: " ghfind \u2014 GitHub repo browser   [/]search  [Esc]menu  [\u2192]open  [?]help  [q]uit   \xB7   click select \xB7 dbl-click open",
     bg: colors.bg,
     fg: colors.muted,
     height: 1
@@ -5218,15 +5389,25 @@ async function launchBrowser(theme_override) {
       const isActive = name === trendingTab;
       const label = ` ${name} `;
       const tt = new TextRenderable5(renderer, {
+        ...NON_INTERACTIVE_TEXT,
         content: label,
         fg: isActive ? colors.bg : colors.muted,
         bg: isActive ? colors.blue : colors.bg,
         height: 1
       });
+      tt.onMouseDown = (event) => {
+        event.stopPropagation();
+        if (name === trendingTab) return;
+        trendingTab = name;
+        loadTrending();
+      };
+      tt.onMouseOver = () => renderer.setMousePointer("pointer");
+      tt.onMouseOut = () => renderer.setMousePointer("default");
       trendingTabTexts.push(tt);
       trendingTabBox.add(tt);
       if (i < TAB_NAMES.length - 1) {
         const sp = new TextRenderable5(renderer, {
+          ...NON_INTERACTIVE_TEXT,
           content: "  ",
           fg: colors.muted,
           bg: colors.bg,
@@ -5314,7 +5495,10 @@ async function launchBrowser(theme_override) {
   const detailText = new TextRenderable5(renderer, {
     content: "",
     fg: colors.text,
-    wrapMode: "none"
+    wrapMode: "none",
+    // Non-interactive: a left-press here would otherwise be swallowed as a
+    // text-selection drag instead of reaching the click handlers.
+    selectable: false
   });
   detailBox.add(detailText);
   body.add(resultsBox);
@@ -5329,6 +5513,7 @@ async function launchBrowser(theme_override) {
   });
   root.add(landingBox);
   const landingBanner = new TextRenderable5(renderer, {
+    ...NON_INTERACTIVE_TEXT,
     content: [
       " \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
       "\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557",
@@ -5406,7 +5591,8 @@ async function launchBrowser(theme_override) {
     card.add(spacerBot);
   }
   const landingHint = new TextRenderable5(renderer, {
-    content: "   \u2191\u2193 Navigate  \u21E9 Select  [b]ookmarks  [?]help  [q]uit",
+    ...NON_INTERACTIVE_TEXT,
+    content: "   \u2191\u2193 Navigate  \u21E9 Select  [b]ookmarks  [?]help  [q]uit   \xB7   click to pick a mode",
     fg: colors.muted,
     bg: colors.bg,
     height: 1,
@@ -5434,6 +5620,28 @@ async function launchBrowser(theme_override) {
       }
     }
   }
+  landingCards.forEach((card, i) => {
+    let lastClickAt = 0;
+    card.onMouseDown = (event) => {
+      event.stopPropagation();
+      const now = Date.now();
+      const isDouble = landingSelected === i && now - lastClickAt < DOUBLE_CLICK_MS;
+      lastClickAt = now;
+      if (isDouble) {
+        landingOptions[i].action();
+        return;
+      }
+      landingSelected = i;
+      updateLandingCards();
+      renderer.requestRender();
+    };
+    card.onMouseOver = () => {
+      renderer.setMousePointer("pointer");
+    };
+    card.onMouseOut = () => {
+      renderer.setMousePointer("default");
+    };
+  });
   renderer.keyInput.on("keypress", (key) => {
     if (!landingKeysActive(currentMode, currentOverlay)) return;
     if (key.name === "up" || key.name === "k") {
@@ -5494,10 +5702,12 @@ async function launchBrowser(theme_override) {
     leaderBox.visible = false;
     leaderDim.visible = false;
     readmeBox.visible = false;
+    orgBox.visible = false;
     updateBox.visible = false;
     updateDim.visible = false;
     if (type === "none") {
       currentOverlay = "none";
+      menuButton.visible = true;
       if (currentMode === "landing") {
         landingBox.visible = true;
         body.visible = false;
@@ -5511,6 +5721,7 @@ async function launchBrowser(theme_override) {
       return;
     }
     currentOverlay = type;
+    menuButton.visible = false;
     landingBox.visible = false;
     if (type !== "leader") {
       hideMainContent();
@@ -5772,7 +5983,8 @@ async function launchBrowser(theme_override) {
   const compareText = new TextRenderable5(renderer, {
     content: "",
     fg: colors.text,
-    bg: colors.bg
+    bg: colors.bg,
+    selectable: false
   });
   compareBox.add(compareText);
   root.add(compareBox);
@@ -5901,7 +6113,8 @@ async function launchBrowser(theme_override) {
     itemSpacing: 0
   });
   const leaderFooter = new TextRenderable5(renderer, {
-    content: " \u2191\u2193 select   Enter run   Esc/q close ",
+    ...NON_INTERACTIVE_TEXT,
+    content: " \u2191\u2193 select   Enter run   Esc/q close   \xB7   click to run   click outside to close ",
     fg: colors.muted,
     bg: colors.surfaceDim,
     height: 1,
@@ -6033,10 +6246,59 @@ async function launchBrowser(theme_override) {
     neverText.fg = updateSelectedOption === 2 ? colors.yellow : colors.text;
     renderer.requestRender();
   }
+  function runUpdateOption(index) {
+    updateSelectedOption = index;
+    renderUpdateOptions();
+    const action = ["now", "later", "never"][index];
+    if (action === "now") {
+      showOverlay("none");
+      recordPreUpdateState(cachedVersion ?? "");
+      performUpdate().then((ok) => {
+        if (ok) {
+          setStatus("\u2713 Update complete \u2014 restart ghfind");
+        } else {
+          setStatus("\u2717 Update failed \u2014 check terminal output");
+        }
+      }).catch(() => {
+        setStatus("\u2717 Update failed \u2014 check terminal output");
+      });
+    } else if (action === "never") {
+      suppressUpdateNotices();
+      showOverlay("none");
+      setStatus("Update notices suppressed");
+    } else {
+      snoozeUpdateNotices(3);
+      showOverlay("none");
+      setStatus("Update reminder snoozed for 3 days");
+    }
+    renderer.requestRender();
+  }
+  const updateCards = [
+    [updateNowBox, 0],
+    [laterBox, 1],
+    [neverBox, 2]
+  ];
+  for (const [box, index] of updateCards) {
+    attachClickableBox(renderer, box, {
+      onActivate: () => runUpdateOption(index),
+      idleBorder: updateSelectedOption === index ? colors.yellow : colors.border,
+      activeBorder: colors.yellow,
+      // Hovering must not fight the selection highlight, so it only moves the
+      // pointer cursor; the border stays owned by renderUpdateOptions().
+      onStateChange: () => {
+        box.borderColor = updateSelectedOption === index ? colors.yellow : colors.border;
+      }
+    });
+  }
+  attachClickOutside(updateDim, () => {
+    showOverlay("none");
+    renderer.requestRender();
+  });
   updateOptionsRow.add(updateNowBox);
   updateOptionsRow.add(laterBox);
   const updateFooter = new TextRenderable5(renderer, {
-    content: "  \u2191\u2193/jk/PgUp/PgDn scroll  \u2190\u2192 select  Enter  Esc/q close",
+    ...NON_INTERACTIVE_TEXT,
+    content: "  \u2191\u2193/jk/PgUp/PgDn scroll  \u2190\u2192 select  Enter  Esc/q close  \xB7  click a button  click outside to close",
     fg: colors.muted,
     bg: colors.surfaceDim,
     height: 1,
@@ -6525,6 +6787,7 @@ async function launchBrowser(theme_override) {
     }
   });
   const orgText = new TextRenderable5(renderer, {
+    ...NON_INTERACTIVE_TEXT,
     content: "",
     fg: colors.text,
     bg: colors.bg
@@ -6532,6 +6795,7 @@ async function launchBrowser(theme_override) {
   orgScroll.add(orgText);
   orgBox.add(orgScroll);
   const orgFooter = new TextRenderable5(renderer, {
+    ...NON_INTERACTIVE_TEXT,
     content: "  \u2191\u2193/jk scroll  Esc/q close",
     fg: colors.muted,
     bg: colors.bg,
@@ -6671,10 +6935,46 @@ async function launchBrowser(theme_override) {
     paddingX: 1
   });
   root.add(statusBar);
-  const statusMgr = new StatusManager((text) => {
-    statusBar.content = ` ${text}`;
-    renderer.requestRender();
+  const menuButton = new BoxRenderable5(renderer, {
+    position: "absolute",
+    bottom: 1,
+    right: 1,
+    height: 1,
+    paddingX: 1,
+    backgroundColor: colors.surface,
+    focusable: false
+  });
+  const menuButtonLabel = new TextRenderable5(renderer, {
+    ...NON_INTERACTIVE_TEXT,
+    content: "\u2630 menu",
+    fg: colors.muted,
+    bg: colors.surface,
+    height: 1
   });
+  menuButton.add(menuButtonLabel);
+  root.add(menuButton);
+  menuButton.onMouseDown = (event) => {
+    event.stopPropagation();
+    if (currentOverlay === "leader") showOverlay("none");
+    else showLeaderMenu();
+    renderer.requestRender();
+  };
+  menuButton.onMouseOver = () => {
+    renderer.setMousePointer("pointer");
+    menuButtonLabel.fg = colors.accent;
+    renderer.requestRender();
+  };
+  menuButton.onMouseOut = () => {
+    renderer.setMousePointer("default");
+    menuButtonLabel.fg = colors.muted;
+    renderer.requestRender();
+  };
+  activeStatusMgr = createStatusManager(
+    statusBar,
+    () => renderer.requestRender()
+  );
+  const statusMgr = activeStatusMgr;
+  renderer.on("destroy", () => statusMgr.dispose());
   setTimeout(() => {
     if (currentOverlay === "none") {
       setStatus(nextTip());
@@ -7264,6 +7564,158 @@ ${pack.description ?? ""}`;
       if (repo) openUrl(repo.url);
     }
   });
+  attachClickToSelect(renderer, resultsSelect, {
+    keepFocus: true,
+    onOpen: () => resultsSelect.selectCurrent()
+  });
+  function activateOverlaySelection() {
+    switch (currentOverlay) {
+      case "history": {
+        const sel = historySelect.getSelectedOption();
+        if (sel?.value) {
+          const entry = sel.value.entry;
+          showOverlay("none");
+          if (!entry) return;
+          if (entry.mode === "trending") {
+            if (entry.tab)
+              trendingTab = entry.tab;
+            loadTrending();
+          } else {
+            searchInput.value = entry.query;
+            showSearchMode();
+            doSearch(entry.query);
+          }
+        }
+        return;
+      }
+      case "bookmarks": {
+        const sel = bookmarksSelect.getSelectedOption();
+        if (sel?.value)
+          openUrl(sel.value.repo?.url ?? "");
+        return;
+      }
+      case "saved": {
+        const sel = savedSelect.getSelectedOption();
+        if (sel?.value) {
+          const s = sel.value;
+          showOverlay("none");
+          touchSavedSearch(s.name);
+          if (s.mode === "trending") {
+            if (s.tab) trendingTab = s.tab;
+            loadTrending();
+          } else {
+            searchInput.value = s.query;
+            showSearchMode();
+            currentSort = s.sort;
+            currentLimit = s.limit;
+            setToolbar();
+            doSearch(s.query);
+          }
+        }
+        return;
+      }
+      case "topics": {
+        const sel = topicsSelect.getSelectedOption();
+        if (sel?.value) {
+          const topic = sel.value;
+          showOverlay("none");
+          searchInput.value = `topic:${topic.name ?? ""}`;
+          showSearchMode();
+          doSearch(`topic:${topic.name}`);
+        }
+        return;
+      }
+      case "export": {
+        const sel = exportSelect.getSelectedOption();
+        if (sel?.value && currentRepos.length > 0) {
+          const format2 = sel.value;
+          const path = exportToFile(currentRepos, format2);
+          showOverlay("none");
+          setStatus(`\u2713 Exported to ${path}`);
+        } else {
+          setStatus("No results to export");
+          showOverlay("none");
+        }
+        renderer.requestRender();
+        return;
+      }
+      case "share": {
+        const sel = shareSelect.getSelectedOption();
+        if (sel?.value) {
+          const opt = resultsSelect.getSelectedOption();
+          const repo = opt?.value;
+          if (repo) {
+            const text = formatShare(repo, sel.value);
+            copyToClipboard(text).then((ok) => {
+              showOverlay("none");
+              setStatus(ok ? "\u2713 Copied!" : "Clipboard not available");
+            });
+          }
+        }
+        renderer.requestRender();
+        return;
+      }
+      case "help": {
+        showOverlay("none");
+        renderer.requestRender();
+        return;
+      }
+      default:
+        return;
+    }
+  }
+  function attachOverlayMouse(box, select) {
+    attachClickToSelect(renderer, select, {
+      onOpen: () => activateOverlaySelection(),
+      onClickMiss: () => {
+        showOverlay("none");
+        renderer.requestRender();
+      }
+    });
+    attachClickOutside(box, () => {
+      showOverlay("none");
+      renderer.requestRender();
+    });
+  }
+  attachOverlayMouse(historyBox, historySelect);
+  attachOverlayMouse(bookmarksBox, bookmarksSelect);
+  attachOverlayMouse(savedBox, savedSelect);
+  attachOverlayMouse(topicsBox, topicsSelect);
+  attachOverlayMouse(exportBox, exportSelect);
+  attachOverlayMouse(shareBox, shareSelect);
+  for (const panel of [helpBox, orgBox, readmeBox, compareBox, notifsBox]) {
+    attachClickOutside(panel, () => {
+      showOverlay("none");
+      renderer.requestRender();
+    });
+  }
+  for (const scroller of [helpScroll, orgScroll, readmeScroll, updateScroll]) {
+    scroller.onMouseScroll = (event) => {
+      event.stopPropagation();
+    };
+  }
+  attachClickToSelect(renderer, leaderSelect, {
+    onOpen: () => {
+      const entry = leaderSelect.getSelectedOption()?.value;
+      if (!entry) return;
+      if (entry.type === "category") {
+        pushMenuLevel(`  Menu > ${entry.name}`, entry.name, entry.children, 0);
+      } else {
+        resetMenu();
+        showOverlay("none");
+        entry.action();
+      }
+      renderer.requestRender();
+    },
+    onClickMiss: () => {
+      showOverlay("none");
+      renderer.requestRender();
+    }
+  });
+  attachClickOutside(leaderDim, () => {
+    showOverlay("none");
+    renderer.requestRender();
+  });
   renderer.keyInput.on("keypress", (key) => {
     if (tokenPromptBox.visible) {
       if (key.name === "escape") {
@@ -7357,21 +7809,7 @@ ${pack.description ?? ""}`;
           return;
         }
         if (key.name === "enter" || key.name === "return") {
-          const sel = historySelect.getSelectedOption();
-          if (sel?.value) {
-            const entry = sel.value.entry;
-            showOverlay("none");
-            if (!entry) return;
-            if (entry.mode === "trending") {
-              if (entry.tab)
-                trendingTab = entry.tab;
-              loadTrending();
-            } else {
-              searchInput.value = entry.query;
-              showSearchMode();
-              doSearch(entry.query);
-            }
-          }
+          activateOverlaySelection();
           return;
         }
         return;
@@ -7390,9 +7828,7 @@ ${pack.description ?? ""}`;
           return;
         }
         if (key.name === "enter" || key.name === "return") {
-          const sel = bookmarksSelect.getSelectedOption();
-          if (sel?.value)
-            openUrl(sel.value.repo?.url ?? "");
+          activateOverlaySelection();
           return;
         }
         return;
@@ -7409,54 +7845,21 @@ ${pack.description ?? ""}`;
           return;
         }
         if (key.name === "enter" || key.name === "return") {
-          const sel = savedSelect.getSelectedOption();
-          if (sel?.value) {
-            const s = sel.value;
-            showOverlay("none");
-            touchSavedSearch(s.name);
-            if (s.mode === "trending") {
-              if (s.tab) trendingTab = s.tab;
-              loadTrending();
-            } else {
-              searchInput.value = s.query;
-              showSearchMode();
-              currentSort = s.sort;
-              currentLimit = s.limit;
-              setToolbar();
-              doSearch(s.query);
-            }
-          }
+          activateOverlaySelection();
           return;
         }
         return;
       }
       if (currentOverlay === "topics") {
         if (key.name === "enter" || key.name === "return") {
-          const sel = topicsSelect.getSelectedOption();
-          if (sel?.value) {
-            const topic = sel.value;
-            showOverlay("none");
-            searchInput.value = `topic:${topic.name ?? ""}`;
-            showSearchMode();
-            doSearch(`topic:${topic.name}`);
-          }
+          activateOverlaySelection();
           return;
         }
         return;
       }
       if (currentOverlay === "export") {
         if (key.name === "enter" || key.name === "return") {
-          const sel = exportSelect.getSelectedOption();
-          if (sel?.value && currentRepos.length > 0) {
-            const format2 = sel.value;
-            const path = exportToFile(currentRepos, format2);
-            showOverlay("none");
-            setStatus(`\u2713 Exported to ${path}`);
-          } else {
-            setStatus("No results to export");
-            showOverlay("none");
-          }
-          renderer.requestRender();
+          activateOverlaySelection();
           return;
         }
         return;
@@ -7485,26 +7888,13 @@ ${pack.description ?? ""}`;
       }
       if (currentOverlay === "share") {
         if (key.name === "enter" || key.name === "return") {
-          const sel = shareSelect.getSelectedOption();
-          if (sel?.value) {
-            const opt = resultsSelect.getSelectedOption();
-            const repo = opt?.value;
-            if (repo) {
-              const text = formatShare(repo, sel.value);
-              copyToClipboard(text).then((ok) => {
-                showOverlay("none");
-                setStatus(ok ? "\u2713 Copied!" : "Clipboard not available");
-              });
-            }
-          }
-          renderer.requestRender();
+          activateOverlaySelection();
           return;
         }
         return;
       }
       if (currentOverlay === "help") {
-        showOverlay("none");
-        renderer.requestRender();
+        activateOverlaySelection();
         return;
       }
       if (currentOverlay === "update") {
@@ -7529,29 +7919,7 @@ ${pack.description ?? ""}`;
           return;
         }
         if (key.name === "enter" || key.name === "return") {
-          const action = ["now", "later", "never"][updateSelectedOption];
-          if (action === "now") {
-            showOverlay("none");
-            recordPreUpdateState(cachedVersion ?? "");
-            performUpdate().then((ok) => {
-              if (ok) {
-                setStatus("\u2713 Update complete \u2014 restart ghfind");
-              } else {
-                setStatus("\u2717 Update failed \u2014 check terminal output");
-              }
-            }).catch(() => {
-              setStatus("\u2717 Update failed \u2014 check terminal output");
-            });
-          } else if (action === "never") {
-            suppressUpdateNotices();
-            showOverlay("none");
-            setStatus("Update notices suppressed");
-          } else {
-            snoozeUpdateNotices(3);
-            showOverlay("none");
-            setStatus("Update reminder snoozed for 3 days");
-          }
-          renderer.requestRender();
+          runUpdateOption(updateSelectedOption);
           return;
         }
         return;
@@ -7574,8 +7942,14 @@ ${pack.description ?? ""}`;
       toggleGraph();
       return;
     }
-    if (key.name === "space" && !searchInput.focused) {
-      showLeaderMenu();
+    if (key.name === "escape") {
+      if (currentOverlay !== "none") {
+        showOverlay("none");
+        setToolbar();
+      } else {
+        showLeaderMenu();
+      }
+      renderer.requestRender();
       return;
     }
     if (!searchInput.focused && errorHint) {
@@ -7693,7 +8067,12 @@ ${pack.description ?? ""}`;
     }
   });
   const _currentVersion = getVersion();
-  showLanding(true);
+  if (startMode === "trending") {
+    showLanding(false);
+    loadTrending();
+  } else {
+    showLanding(true);
+  }
   checkForUpdateAndShow();
   checkPostUpgradePanel();
   renderer.start();
@@ -7710,10 +8089,17 @@ function formatToolbar(sort, limit, totalCount) {
   return ` sort: ${sortLabel}   limit: ${limit}   results: ${totalCount.toLocaleString()}`;
 }
 function cleanup() {
+  activeStatusMgr?.dispose();
+  activeStatusMgr = null;
   try {
     rotateHistory();
   } catch {
   }
+  try {
+    activeRenderer?.destroy();
+  } catch {
+  }
+  activeRenderer = null;
   process.exit(0);
 }
 if (import.meta.main && false) {
@@ -8385,7 +8771,7 @@ var TOOLS = [
         token: resolveToken(state, args.token),
         limit
       });
-      return { text: formatUserJson(profile), data: { ...profile } };
+      return { text: formatUserText(profile), data: { ...profile } };
     }
   },
   {
@@ -8732,6 +9118,7 @@ var SORT_VALUES = [
   "downloads",
   "name"
 ];
+var SINCE_VALUES = ["daily", "weekly", "monthly"];
 function parseArgs(args) {
   const flags = {
     query: "",
@@ -8744,6 +9131,7 @@ function parseArgs(args) {
     token: process.env.GITHUB_TOKEN,
     trending: false,
     since: "daily",
+    sinceExplicit: false,
     watch: false,
     releases: false,
     interval: 300,
@@ -8844,15 +9232,51 @@ function parseArgs(args) {
       case "--token":
         flags.token = args[++i];
         break;
-      case "--since":
-        flags.since = args[++i];
+      case "--interval": {
+        const parsed = parseInt(args[++i], 10);
+        if (Number.isNaN(parsed) || parsed < 1) {
+          console.error(
+            `Invalid interval: ${args[i] ?? "(missing)"} (must be a whole number of seconds, e.g. 300).`
+          );
+          process.exit(1);
+        }
+        flags.interval = parsed;
+        break;
+      }
+      case "--since": {
+        const since = args[++i];
+        if (!since || !SINCE_VALUES.includes(since)) {
+          console.error(
+            `Invalid since: ${since ?? "(missing)"} (use daily|weekly|monthly).`
+          );
+          process.exit(1);
+        }
+        flags.since = since;
+        flags.sinceExplicit = true;
         break;
-      case "--pipe":
-        flags.pipe = args[++i];
+      }
+      case "--pipe": {
+        const target = args[++i];
+        if (!target || !PIPE_TARGETS.includes(target)) {
+          console.error(
+            `Invalid pipe target: ${target ?? "(missing)"} (use open|clone).`
+          );
+          process.exit(1);
+        }
+        flags.pipe = target;
         break;
-      case "--format":
-        flags.format = args[++i];
+      }
+      case "--format": {
+        const fmt = args[++i];
+        if (!fmt || !FORMAT_VALUES.includes(fmt)) {
+          console.error(
+            `Invalid format: ${fmt ?? "(missing)"} (use ${FORMAT_VALUES.join("|")}).`
+          );
+          process.exit(1);
+        }
+        flags.format = fmt;
         break;
+      }
       case "--registry":
         flags.registry = args[++i] ?? "npm";
         break;
@@ -9141,7 +9565,13 @@ Options:
     await runNonInteractive(flags, outputFormat);
     return;
   }
-  await launchBrowser(flags.theme);
+  await launchBrowser(
+    flags.theme,
+    // `ghfind --trending` with no query/format promises the trending view
+    // (TRACKER.md), but the bare flag used to fall through to the landing
+    // menu. An explicit flag is explicit intent — skip the menu.
+    flags.trending ? "trending" : void 0
+  );
 }
 function buildSearchContext(flags) {
   const parsed = applyFlagFilters(parseQuery(flags.query), {});
@@ -9606,7 +10036,8 @@ async function runNonInteractive(flags, outputFormat) {
           limit: flags.limit,
           token: flags.token,
           intervalMs: flags.interval * 1e3,
-          trending: flags.trending
+          trending: flags.trending,
+          since: flags.sinceExplicit ? flags.since : void 0
         },
         (repos, delta) => {
           tick++;
@@ -9694,6 +10125,16 @@ Not found: ${missing.join(", ")}` : "";
     }
   };
   const key = flags.compare.length > 0 ? "compare" : flags.trending && !flags.watch ? "trending" : flags.watch ? "watch" : flags.pipe ? "pipe" : flags.format ? "format" : "search";
+  const needsQuery = key === "search" || key === "format" || key === "pipe" || key === "watch" && !flags.trending;
+  if (needsQuery && flags.query.trim() === "") {
+    console.error("\u26A0 No search query given.");
+    console.error(
+      '  Usage: ghfind "<query>" [--count|--format <fmt>|--pipe <tgt>|--watch]'
+    );
+    console.error('  Example: ghfind "language:Rust stars:>500" --count');
+    console.error("  Run `ghfind --help` for all options.");
+    process.exit(1);
+  }
   const ctx = buildSearchContext(flags);
   await handlers[key](ctx);
 }