github-search-cli 9.7.0 → 9.8.0

package/dist/cli.js

@@ -62,14 +62,14 @@ function flattenHtml(html) {
 }
 function parseRepoLink(block) {
   const anchor = block.match(
-    /<a[^>]*?href="\/([A-Za-z0-9._-]+)\/([^\"?#]+)"[^>]*class="Link"/
+    /<a[^>]*?href="\/([A-Za-z0-9._-]+)\/([^"?#]+)"[^>]*class="Link"/
   );
   if (!anchor) return void 0;
   return { owner: anchor[1], name: anchor[2] };
 }
 function parseStars(block) {
   const starsMatch = block.match(
-    /href="\/[^\/\"]+\/[^\/\"]+\/stargazers"[^>]*>.*?<\/svg>\s*(\d[\d,]*)/
+    /href="\/[^/"]+\/[^/"]+\/stargazers"[^>]*>.*?<\/svg>\s*(\d[\d,]*)/
   );
   return starsMatch ? parseInt(starsMatch[1].replace(/,/g, ""), 10) : 0;
 }
@@ -91,9 +91,8 @@ function parseTrendingHtml(html) {
   const flat = flattenHtml(html);
   const repos = [];
   const articleRe = /<article class="Box-row">(.*?)<\/article>/gi;
-  let match;
   let rank = 0;
-  while ((match = articleRe.exec(flat)) !== null) {
+  for (const match of flat.matchAll(articleRe)) {
     rank++;
     const block = match[1];
     const link = parseRepoLink(block);
@@ -240,7 +239,7 @@ function suggestFor(input) {
     return QUALIFIER_SUGGESTIONS[trimmed];
   }
   const matches = KNOWN_QUALIFIERS.filter((k) => k.startsWith(trimmed));
-  return matches.map((k) => k + ":");
+  return matches.map((k) => `${k}:`);
 }
 function tokenize(input) {
   const tokens = [];
@@ -353,7 +352,6 @@ function githubSortParam(sort) {
       return { sort: "forks", order: "desc" };
     case "updated":
       return { sort: "updated", order: "desc" };
-    case "best-match":
     default:
       return {};
   }
@@ -378,7 +376,6 @@ function rankRepos(repos, strategy) {
     case "updated":
       copy.sort(byKey((r) => Date.parse(r.updatedAt)));
       break;
-    case "best-match":
     default:
       break;
   }
@@ -585,6 +582,7 @@ function trendingRepoToRepo(r) {
 }
 var TrendingAdapter = class {
   name = "trending";
+  // biome-ignore lint/correctness/noUnusedPrivateClassMembers: part of the adapter constructor contract — callers pass a shared logger (search.ts:757) even though this adapter currently logs nothing itself.
   logger;
   constructor(logger2 = noopLogger) {
     this.logger = logger2;
@@ -740,12 +738,17 @@ import {
 } from "@opentui/core";
 
 // src/open-url.ts
+import { spawn } from "child_process";
 function openUrl(url) {
   try {
     const p = process.platform;
-    if (p === "win32") Bun.spawn(["cmd", "/c", "start", "", url]);
-    else if (p === "darwin") Bun.spawn(["open", url]);
-    else Bun.spawn(["xdg-open", url]);
+    const cmd = p === "win32" ? "explorer" : p === "darwin" ? "open" : "xdg-open";
+    if (typeof Bun !== "undefined") {
+      Bun.spawn([cmd, url]);
+      return;
+    }
+    const child = spawn(cmd, [url], { detached: true, stdio: "ignore" });
+    child.unref();
   } catch {
   }
 }
@@ -935,7 +938,7 @@ function formatPackageLine(pack) {
   const nameStr = `${pack.name}@${pack.version}`.padEnd(28).slice(0, 28);
   const dlStr = `\u2193 ${fmtCount(pack.downloads)}`.padEnd(20).slice(0, 20);
   const scoreStr = `score ${pack.score.toFixed(2)}`.padEnd(12).slice(0, 12);
-  const desc = (pack.description ?? "").length > 60 ? (pack.description ?? "").slice(0, 57) + "..." : pack.description ?? "";
+  const desc = (pack.description ?? "").length > 60 ? `${(pack.description ?? "").slice(0, 57)}...` : pack.description ?? "";
   const line1 = t`${bold(fg(C.nameText)(nameStr))}${fg(C.cyan)(dlStr)}${fg(C.gold)(scoreStr)}`;
   const line2 = t`${dim(fg(C.descText)(`     ${desc}`))}`;
   const newline = { text: "\n", __isChunk: true };
@@ -1198,9 +1201,13 @@ var results = [];
 function add(status, label, detail) {
   results.push({ status, label, detail });
 }
-function run(cmd, args) {
+function run(cmd, args, opts = {}) {
   try {
-    const res = spawnSync(cmd, args, { encoding: "utf8", timeout: 15e3 });
+    const res = spawnSync(cmd, args, {
+      encoding: "utf8",
+      timeout: 15e3,
+      ...opts
+    });
     return {
       status: res.status,
       stdout: res.stdout ?? "",
@@ -1375,6 +1382,97 @@ function checkDirs() {
     }
   }
 }
+var PKG_NAME = "github-search-cli";
+var BIN_NAME = "ghfind";
+function runningVersion() {
+  try {
+    const pkg = JSON.parse(
+      readFileSync(join(PKG_DIR, "package.json"), "utf8")
+    );
+    return pkg.version ?? "";
+  } catch {
+    return "";
+  }
+}
+function installVersionAt(shimPath) {
+  const dir = dirname(shimPath);
+  for (const ancestor of [dir, dirname(dir)]) {
+    for (const sub of ["node_modules", join("lib", "node_modules")]) {
+      const pkgJson = join(ancestor, sub, PKG_NAME, "package.json");
+      if (existsSync(pkgJson)) {
+        try {
+          const pkg = JSON.parse(readFileSync(pkgJson, "utf8"));
+          return { version: pkg.version ?? "", dir: dirname(pkgJson) };
+        } catch {
+        }
+      }
+    }
+  }
+  const res = run(shimPath, ["--version"], {
+    shell: platform() === "win32",
+    timeout: 1e4
+  });
+  const m = /\d+\.\d+\.\d+/.exec(res.stdout);
+  return m ? { version: m[0], dir } : null;
+}
+function checkInstallShadowing() {
+  const isWin = platform() === "win32";
+  const res = isWin ? run("where", [BIN_NAME]) : run("which", ["-a", BIN_NAME]);
+  const shims = [
+    ...new Set(
+      res.stdout.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0)
+    )
+  ];
+  if (shims.length === 0) {
+    add("WARN", "Global installs", `${BIN_NAME} not found on PATH.`);
+    return;
+  }
+  const running = runningVersion();
+  const norm = (p) => isWin ? p.replace(/\\/g, "/").toLowerCase() : p;
+  const seenDirs = /* @__PURE__ */ new Set();
+  const stale = [];
+  let knownCount = 0;
+  let staleVersion = "";
+  let staleDir = "";
+  for (const shim of shims) {
+    const info = installVersionAt(shim);
+    const dirKey = norm(dirname(shim));
+    if (seenDirs.has(dirKey)) continue;
+    seenDirs.add(dirKey);
+    knownCount++;
+    const isRunningInstall = info !== null && norm(info.dir) === norm(PKG_DIR);
+    if (!isRunningInstall && info !== null && running && info.version !== running) {
+      stale.push(`${dirname(shim)} (v${info.version} \u2260 running v${running})`);
+      staleVersion = info.version;
+      staleDir = dirname(shim);
+    }
+  }
+  if (stale.length > 0 && knownCount > 1) {
+    add(
+      "WARN",
+      "Global installs",
+      `${knownCount} install(s) on PATH; stale copies shadowing updates \u2192 ${stale.join("; ")}. Remove with: npm uninstall -g ${PKG_NAME} --prefix <dir>`
+    );
+  } else if (stale.length > 0) {
+    add(
+      "PASS",
+      "Global installs",
+      `v${staleVersion} at ${staleDir} (running v${running || "?"} from source/build) \u2014 single install, nothing shadowed.`
+    );
+  } else if (knownCount > 1) {
+    add(
+      "PASS",
+      "Global installs",
+      `${knownCount} install(s) on PATH, all v${running || "?"}.`
+    );
+  } else {
+    add(
+      "PASS",
+      "Global installs",
+      `v${running || "?"} at ${dirname(shims[0])}.`
+    );
+  }
+}
 function printReport() {
   const noColor = process.env.NO_COLOR !== void 0 || !process.stdout.isTTY;
   const colors2 = (s, n) => {
@@ -1417,6 +1515,7 @@ async function runDoctor() {
   checkConfig();
   checkGithubToken();
   checkDirs();
+  checkInstallShadowing();
   printReport();
   const hasFail = results.some((r) => r.status === "FAIL");
   process.exitCode = hasFail ? 1 : 0;
@@ -1429,7 +1528,7 @@ import {
   version as nodeVersion,
   versions as nodeVersions
 } from "process";
-import { spawn } from "child_process";
+import { spawn as spawn2 } from "child_process";
 
 // src/version.ts
 import { readFileSync as readFileSync2 } from "fs";
@@ -1439,7 +1538,7 @@ var cached = null;
 function getVersion() {
   if (cached) return cached;
   if (true) {
-    cached = "9.7.0";
+    cached = "9.8.0";
     return cached;
   }
   try {
@@ -1515,14 +1614,15 @@ function tryOpenUrl(url) {
   try {
     const p = osPlatform;
     if (typeof Bun !== "undefined") {
-      if (p === "win32") Bun.spawn(["cmd", "/c", "start", "", url]);
-      else if (p === "darwin") Bun.spawn(["open", url]);
+      if (p === "win32") {
+        Bun.spawn(["explorer", url]);
+      } else if (p === "darwin") Bun.spawn(["open", url]);
       else Bun.spawn(["xdg-open", url]);
       return true;
     }
-    const cmd = p === "win32" ? "cmd" : p === "darwin" ? "open" : "xdg-open";
-    const args = p === "win32" ? ["/c", "start", "", url] : [url];
-    const child = spawn(cmd, args, { detached: true, stdio: "ignore" });
+    const cmd = p === "win32" ? "explorer" : p === "darwin" ? "open" : "xdg-open";
+    const args = [url];
+    const child = spawn2(cmd, args, { detached: true, stdio: "ignore" });
     child.unref();
     return true;
   } catch {
@@ -1543,11 +1643,11 @@ function reportError(err, context = {
   console.error("");
   const opened = tryOpenUrl(url);
   if (opened) {
-    console.error("  \u2192 Opened: " + url);
+    console.error(`  \u2192 Opened: ${url}`);
   } else {
     console.error("  Copy this URL to file a bug report:");
     console.error("");
-    console.error("    " + url);
+    console.error(`    ${url}`);
   }
   console.error("");
   return url;
@@ -2148,7 +2248,8 @@ function appendJSONL(filename, obj) {
   try {
     appendFileSync(
       join3(stateDir(), filename),
-      JSON.stringify(obj) + "\n",
+      `${JSON.stringify(obj)}
+`,
       "utf-8"
     );
   } catch {
@@ -2281,8 +2382,8 @@ var PER_REPO = 5;
 function loadCache() {
   return readJSON(RELEASES_FILE, {});
 }
-function saveCache(cache) {
-  writeJSON(RELEASES_FILE, cache);
+function saveCache(cache2) {
+  writeJSON(RELEASES_FILE, cache2);
 }
 function toTracked(raw) {
   return raw.filter((r) => r.draft !== true).map((r) => ({
@@ -2299,7 +2400,7 @@ async function fetchReleases(fullName, etag, token) {
     Accept: "application/vnd.github+json"
   };
   if (etag) headers["If-None-Match"] = etag;
-  if (token) headers["Authorization"] = `Bearer ${token}`;
+  if (token) headers.Authorization = `Bearer ${token}`;
   const res = await fetch(
     `https://api.github.com/repos/${fullName}/releases?per_page=${PER_REPO}`,
     { headers }
@@ -2313,13 +2414,13 @@ async function fetchReleases(fullName, etag, token) {
 }
 async function checkReleases(opts = {}) {
   const bookmarks = getBookmarks();
-  const cache = loadCache();
+  const cache2 = loadCache();
   const config = loadConfig();
   const token = opts.token ?? config.githubToken ?? process.env.GITHUB_TOKEN;
   const results2 = [];
   for (const bm of bookmarks) {
     try {
-      const prev = cache[bm.repo.fullName];
+      const prev = cache2[bm.repo.fullName];
       const lastSeen = getLastSeen(bm.repo.fullName);
       const isNew = (r) => !r.publishedAt || new Date(r.publishedAt).getTime() > lastSeen;
       const { status, etag, releases } = await fetchReleases(
@@ -2342,7 +2443,7 @@ async function checkReleases(opts = {}) {
         });
         continue;
       }
-      cache[bm.repo.fullName] = { checkedAt: Date.now(), etag, releases };
+      cache2[bm.repo.fullName] = { checkedAt: Date.now(), etag, releases };
       results2.push({
         fullName: bm.repo.fullName,
         newReleases: releases.filter(isNew)
@@ -2355,7 +2456,7 @@ async function checkReleases(opts = {}) {
       });
     }
   }
-  saveCache(cache);
+  saveCache(cache2);
   return results2;
 }
 async function checkAndNotify(opts = {}) {
@@ -2372,9 +2473,9 @@ async function checkAndNotify(opts = {}) {
   return results2;
 }
 function allCachedReleases() {
-  const cache = loadCache();
+  const cache2 = loadCache();
   const bookmarks = getBookmarks();
-  return Object.entries(cache).filter(([fullName]) => bookmarks.some((b) => b.repo.fullName === fullName)).flatMap(([fullName, s]) => s.releases.map((r) => ({ ...r, fullName }))).sort(
+  return Object.entries(cache2).filter(([fullName]) => bookmarks.some((b) => b.repo.fullName === fullName)).flatMap(([fullName, s]) => s.releases.map((r) => ({ ...r, fullName }))).sort(
     (a, b) => new Date(b.publishedAt).getTime() - new Date(a.publishedAt).getTime()
   );
 }
@@ -2536,7 +2637,7 @@ async function runInitWizard() {
   const themeStr = await ask(`  Theme [${themes.join("/")}] (tokyo-night): `);
   const config = {
     defaultSort: ["best-match", "stars", "updated", "forks"].includes(sortStr) ? sortStr : "best-match",
-    defaultLimit: Math.min(100, Math.max(10, parseInt(limitStr) || 50)),
+    defaultLimit: Math.min(100, Math.max(10, parseInt(limitStr, 10) || 50)),
     theme: themes.includes(themeStr) ? themeStr : themes[0],
     cacheTtlSeconds: 300,
     defaultTab: "search"
@@ -2585,18 +2686,18 @@ function buildComparisonTable(repos) {
   const header = ["".padEnd(14), ...names.map((n) => n.padEnd(colW))];
   const sep = ["".padEnd(14, "\u2500"), ...names.map(() => "".padEnd(colW, "\u2500"))];
   const lines = [
-    "\u250C" + sep.map((s) => "\u2500" + s + "\u2500").join("\u252C") + "\u2510",
-    "\u2502" + header.map((h) => ` ${h} `).join("\u2502") + "\u2502",
-    "\u251C" + sep.map((s) => "\u2500" + s + "\u2500").join("\u253C") + "\u2524"
+    `\u250C${sep.map((s) => `\u2500${s}\u2500`).join("\u252C")}\u2510`,
+    `\u2502${header.map((h) => ` ${h} `).join("\u2502")}\u2502`,
+    `\u251C${sep.map((s) => `\u2500${s}\u2500`).join("\u253C")}\u2524`
   ];
   for (const row of rows) {
     const cells = [
       row.label.padEnd(14),
       ...row.values.map((v) => v.padEnd(colW))
     ];
-    lines.push("\u2502" + cells.map((c) => ` ${c} `).join("\u2502") + "\u2502");
+    lines.push(`\u2502${cells.map((c) => ` ${c} `).join("\u2502")}\u2502`);
   }
-  lines.push("\u2514" + sep.map((s) => "\u2500" + s + "\u2500").join("\u2534") + "\u2518");
+  lines.push(`\u2514${sep.map((s) => `\u2500${s}\u2500`).join("\u2534")}\u2518`);
   return lines.join("\n");
 }
 function comparisonRepo(r) {
@@ -2852,8 +2953,8 @@ import { fileURLToPath as fileURLToPath4 } from "url";
 // src/tui.ts
 import {
   createCliRenderer as createCliRenderer3,
-  BoxRenderable as BoxRenderable4,
-  TextRenderable as TextRenderable4,
+  BoxRenderable as BoxRenderable5,
+  TextRenderable as TextRenderable5,
   InputRenderable,
   SelectRenderable,
   ScrollBoxRenderable as ScrollBoxRenderable3
@@ -2958,7 +3059,7 @@ function buildHelpSections() {
         { keys: "Limit", action: "Cycle limit: 10 \u2192 25 \u2192 50 \u2192 100" },
         { keys: "Refresh", action: "Re-run current search" },
         { keys: "Graph", action: "Toggle commit activity chart" },
-        { keys: "Readme", action: "Full README viewer" },
+        { keys: "Readme", action: "Full markdown README viewer" },
         { keys: "Deep-dive", action: "Languages + contributors + excerpt" },
         { keys: "Bookmark", action: "Save / unsave selected repo" },
         { keys: "Compare", action: "Add to / remove from comparison" },
@@ -2998,6 +3099,7 @@ function buildHelpSections() {
         { keys: "d", action: "Delete entry (history, saved)" },
         { keys: "\u2191 \u2193 / j k", action: "Navigate overlay list" },
         { keys: "\u2190 \u2192 / h l", action: "Navigate tabs / panels" },
+        { keys: "i", action: "Toggle inline images (README viewer)" },
         {
           keys: "PgUp/PgDn",
           action: "Scroll update notes; Home/End jump to ends"
@@ -3074,7 +3176,8 @@ function deleteHistoryEntry(index) {
   );
   writeRaw(
     HISTORY_FILE,
-    remaining.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n"
+    `${remaining.reverse().map((e) => JSON.stringify(e)).join("\n")}
+`
   );
 }
 function clearHistory() {
@@ -3086,7 +3189,8 @@ function rotateHistory() {
   const trimmed = entries.slice(0, MAX_ENTRIES);
   writeRaw(
     HISTORY_FILE,
-    trimmed.reverse().map((e) => JSON.stringify(e)).join("\n") + "\n"
+    `${trimmed.reverse().map((e) => JSON.stringify(e)).join("\n")}
+`
   );
 }
 
@@ -3157,170 +3261,731 @@ function restoreSession() {
   return readJSON(SESSION_FILE, null);
 }
 
-// src/markdown-render.ts
-function renderMarkdown(md, opts = {}) {
-  const width = opts.width ?? 80;
-  const lines = md.split("\n");
-  const out = [];
-  let inCodeBlock = false;
-  let codeLang = "";
-  let codeLines = [];
-  let inTable = false;
-  let tableRows = [];
-  function flushCode() {
-    if (codeLines.length === 0) return;
-    const maxLen = Math.max(...codeLines.map((l) => l.length), codeLang.length);
-    const barW = Math.min(maxLen + 4, width - 2);
-    out.push("\u250C" + "\u2500".repeat(barW) + "\u2510");
-    if (codeLang) out.push("\u2502 " + codeLang.padEnd(barW - 1) + "\u2502");
-    for (const cl of codeLines) {
-      out.push("\u2502 " + cl.padEnd(barW - 1) + "\u2502");
-    }
-    out.push("\u2514" + "\u2500".repeat(barW) + "\u2518");
-    out.push("");
-    codeLines = [];
-    codeLang = "";
-  }
-  function flushTable() {
-    if (tableRows.length === 0) return;
-    const dataRows = tableRows.filter(
-      (r) => !r.every((c) => /^[\s\-:|]+$/.test(c))
+// src/markdown-view.ts
+import {
+  BoxRenderable as BoxRenderable3,
+  MarkdownRenderable,
+  RGBA,
+  StyledText as StyledText3,
+  SyntaxStyle,
+  TextRenderable as TextRenderable3,
+  createTextAttributes
+} from "@opentui/core";
+
+// src/png.ts
+import { inflateSync } from "zlib";
+var PNG_SIGNATURE = [137, 80, 78, 71, 13, 10, 26, 10];
+function channelsForColorType(colorType) {
+  switch (colorType) {
+    case 0:
+      return 1;
+    // greyscale
+    case 2:
+      return 3;
+    // truecolour
+    case 3:
+      return 1;
+    // palette index
+    case 4:
+      return 2;
+    // greyscale + alpha
+    case 6:
+      return 4;
+    // truecolour + alpha
+    default:
+      throw new Error(`Unsupported PNG colour type ${colorType}`);
+  }
+}
+function paeth(a, b, c) {
+  const p = a + b - c;
+  const pa = Math.abs(p - a);
+  const pb = Math.abs(p - b);
+  const pc = Math.abs(p - c);
+  if (pa <= pb && pa <= pc) return a;
+  if (pb <= pc) return b;
+  return c;
+}
+function unfilter(raw, height, bytesPerRow, bytesPerPixel) {
+  const out = new Uint8Array(height * bytesPerRow);
+  let src = 0;
+  for (let y = 0; y < height; y++) {
+    const filter = raw[src++];
+    const rowStart = y * bytesPerRow;
+    const prevStart = rowStart - bytesPerRow;
+    for (let x = 0; x < bytesPerRow; x++) {
+      const value = raw[src + x];
+      const left = x >= bytesPerPixel ? out[rowStart + x - bytesPerPixel] : 0;
+      const up = y > 0 ? out[prevStart + x] : 0;
+      const upLeft = y > 0 && x >= bytesPerPixel ? out[prevStart + x - bytesPerPixel] : 0;
+      let result;
+      switch (filter) {
+        case 0:
+          result = value;
+          break;
+        case 1:
+          result = value + left;
+          break;
+        case 2:
+          result = value + up;
+          break;
+        case 3:
+          result = value + (left + up >> 1);
+          break;
+        case 4:
+          result = value + paeth(left, up, upLeft);
+          break;
+        default:
+          throw new Error(`Unsupported PNG filter type ${filter}`);
+      }
+      out[rowStart + x] = result & 255;
+    }
+    src += bytesPerRow;
+  }
+  return out;
+}
+function sampleAt(row, offsetInRow, index, bitDepth) {
+  if (bitDepth === 8) return row[offsetInRow + index];
+  if (bitDepth === 16) return row[offsetInRow + index * 2];
+  const bitOffset = index * bitDepth;
+  const byte = row[offsetInRow + (bitOffset >> 3)];
+  const shift = 8 - bitDepth - (bitOffset & 7);
+  return byte >> shift & (1 << bitDepth) - 1;
+}
+function decodePng(bytes) {
+  if (bytes.length < 8) throw new Error("PNG too short");
+  for (let i = 0; i < PNG_SIGNATURE.length; i++) {
+    if (bytes[i] !== PNG_SIGNATURE[i]) throw new Error("Not a PNG file");
+  }
+  let width = 0;
+  let height = 0;
+  let bitDepth = 8;
+  let colorType = 6;
+  let interlace = 0;
+  let palette = null;
+  let transparency = null;
+  const idat = [];
+  let offset = 8;
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  while (offset + 8 <= bytes.length) {
+    const length = view.getUint32(offset);
+    const type = String.fromCharCode(
+      bytes[offset + 4],
+      bytes[offset + 5],
+      bytes[offset + 6],
+      bytes[offset + 7]
     );
-    if (dataRows.length === 0) {
-      tableRows = [];
-      return;
-    }
-    const colCount = Math.max(...dataRows.map((r) => r.length));
-    const colW = [];
-    for (let ci = 0; ci < colCount; ci++) {
-      colW.push(Math.max(3, ...dataRows.map((r) => (r[ci] ?? "").length)));
+    const dataStart = offset + 8;
+    const dataEnd = dataStart + length;
+    if (dataEnd > bytes.length) throw new Error("Truncated PNG chunk");
+    switch (type) {
+      case "IHDR": {
+        width = view.getUint32(dataStart);
+        height = view.getUint32(dataStart + 4);
+        bitDepth = bytes[dataStart + 8];
+        colorType = bytes[dataStart + 9];
+        interlace = bytes[dataStart + 12];
+        break;
+      }
+      case "PLTE":
+        palette = bytes.subarray(dataStart, dataEnd);
+        break;
+      case "tRNS":
+        transparency = bytes.subarray(dataStart, dataEnd);
+        break;
+      case "IDAT":
+        idat.push(bytes.subarray(dataStart, dataEnd));
+        break;
+      default:
+        break;
     }
-    const totalW = colW.reduce((a, b) => a + b, 0) + colCount * 3 - 1;
-    if (totalW > width) {
-      for (const row of dataRows) {
-        out.push("  " + row.map((c) => c.trim()).join(" \u2502 "));
+    offset = dataEnd + 4;
+    if (type === "IEND") break;
+  }
+  if (width === 0 || height === 0) throw new Error("PNG has no IHDR");
+  if (interlace !== 0) throw new Error("Interlaced PNG is not supported");
+  const channels = channelsForColorType(colorType);
+  const bitsPerPixel = channels * bitDepth;
+  const bytesPerRow = Math.ceil(width * bitsPerPixel / 8);
+  const bytesPerPixel = Math.max(1, Math.ceil(bitsPerPixel / 8));
+  const compressed = idat.length === 1 ? idat[0] : concat(idat);
+  const raw = new Uint8Array(inflateSync(compressed));
+  if (raw.length < height * (bytesPerRow + 1)) {
+    throw new Error("Truncated PNG pixel data");
+  }
+  const rows = unfilter(raw, height, bytesPerRow, bytesPerPixel);
+  const out = new Uint8Array(width * height * 4);
+  const maxSample = (1 << Math.min(bitDepth, 8)) - 1;
+  const scale = bitDepth === 16 ? 1 / 257 : 255 / maxSample;
+  for (let y = 0; y < height; y++) {
+    const row = rows.subarray(y * bytesPerRow, (y + 1) * bytesPerRow);
+    for (let x = 0; x < width; x++) {
+      const to8 = (sample) => bitDepth === 8 || bitDepth === 16 ? sample : Math.round(sample * scale);
+      let r;
+      let g;
+      let b;
+      let a = 255;
+      switch (colorType) {
+        case 0: {
+          const grey = to8(sampleAt(row, 0, x, bitDepth));
+          r = g = b = grey;
+          break;
+        }
+        case 2:
+          r = to8(sampleAt(row, 0, x * 3, bitDepth));
+          g = to8(sampleAt(row, 0, x * 3 + 1, bitDepth));
+          b = to8(sampleAt(row, 0, x * 3 + 2, bitDepth));
+          break;
+        case 3: {
+          const index = sampleAt(row, 0, x, bitDepth);
+          const p = index * 3;
+          if (!palette || p + 2 >= palette.length)
+            throw new Error("PNG palette entry missing");
+          r = palette[p];
+          g = palette[p + 1];
+          b = palette[p + 2];
+          if (transparency && index < transparency.length)
+            a = transparency[index];
+          break;
+        }
+        case 4: {
+          const grey = to8(sampleAt(row, 0, x * 2, bitDepth));
+          r = g = b = grey;
+          a = to8(sampleAt(row, 0, x * 2 + 1, bitDepth));
+          break;
+        }
+        default: {
+          r = to8(sampleAt(row, 0, x * 4, bitDepth));
+          g = to8(sampleAt(row, 0, x * 4 + 1, bitDepth));
+          b = to8(sampleAt(row, 0, x * 4 + 2, bitDepth));
+          a = to8(sampleAt(row, 0, x * 4 + 3, bitDepth));
+          break;
+        }
       }
-    } else {
-      const sep = "\u250C" + colW.map((w) => "\u2500".repeat(w + 2)).join("\u252C") + "\u2510";
-      const mid = "\u251C" + colW.map((w) => "\u2500".repeat(w + 2)).join("\u253C") + "\u2524";
-      const end = "\u2514" + colW.map((w) => "\u2500".repeat(w + 2)).join("\u2534") + "\u2518";
-      out.push(sep);
-      dataRows.forEach((row, i) => {
-        const cells = colW.map((w, ci) => (row[ci] ?? "").trim().padEnd(w));
-        out.push("\u2502 " + cells.map((c) => ` ${c} `).join("\u2502") + "\u2502");
-        if (i === 0) out.push(mid);
-      });
-      out.push(end);
-    }
-    out.push("");
-    tableRows = [];
-  }
-  function renderInline(line) {
-    line = line.replace(/\*\*(.+?)\*\*/g, "$1");
-    line = line.replace(/\*([^*]+?)\*/g, "$1");
-    line = line.replace(/`([^`]+)`/g, "\u27E8$1\u27E9");
-    line = line.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$1 ($2)");
-    line = line.replace(/!\[([^\]]*)\]\([^)]+\)/g, "\u{1F5BC} $1");
-    return line;
-  }
-  function wrapLine(line, maxW) {
-    if (line.length <= maxW) return [line];
-    const parts = [];
-    let remaining = line;
-    while (remaining.length > maxW) {
-      let breakAt = maxW;
-      const spaceIdx = remaining.lastIndexOf(" ", maxW);
-      if (spaceIdx > maxW / 2) breakAt = spaceIdx;
-      parts.push(remaining.slice(0, breakAt));
-      remaining = remaining.slice(breakAt).replace(/^ /, "");
-    }
-    if (remaining) parts.push(remaining);
-    return parts;
-  }
-  for (let i = 0; i < lines.length; i++) {
-    let line = lines[i];
-    if (/^```/.test(line)) {
-      if (inCodeBlock) {
-        flushCode();
-        inCodeBlock = false;
-      } else {
-        inCodeBlock = true;
-        codeLang = line.slice(3).trim();
+      if (colorType === 0 && transparency && transparency.length >= 2) {
+        const key = transparency[0] << 8 | transparency[1];
+        const sample = sampleAt(row, 0, x, bitDepth);
+        if (sample === key) a = 0;
       }
-      continue;
-    }
-    if (inCodeBlock) {
-      codeLines.push(line);
-      continue;
+      const o = (y * width + x) * 4;
+      out[o] = r;
+      out[o + 1] = g;
+      out[o + 2] = b;
+      out[o + 3] = a;
     }
-    if (line.includes("|")) {
-      const cells = line.split("|").map((c) => c.trim()).filter((_, idx, arr) => idx > 0 && idx < arr.length - 1);
-      if (cells.length >= 2) {
-        inTable = true;
-        tableRows.push(cells);
+  }
+  return { width, height, data: out };
+}
+function concat(chunks) {
+  let total = 0;
+  for (const c of chunks) total += c.length;
+  const merged = new Uint8Array(total);
+  let offset = 0;
+  for (const c of chunks) {
+    merged.set(c, offset);
+    offset += c.length;
+  }
+  return merged;
+}
+
+// src/image-render.ts
+var DEFAULT_CELL_ASPECT = 0.5;
+var HALF_BLOCK = "\u2580";
+function fitImageToCells(imgWidth, imgHeight, opts) {
+  const cellAspect = opts.cellAspect ?? DEFAULT_CELL_ASPECT;
+  const minCols = Math.max(1, Math.min(opts.maxCols, 8));
+  if (imgWidth <= 0 || imgHeight <= 0) {
+    return { cols: minCols, rows: 1 };
+  }
+  const rowsPerCol = cellAspect * (imgHeight / imgWidth);
+  let cols = Math.max(minCols, Math.floor(opts.maxCols));
+  let rows = Math.max(1, Math.round(cols * rowsPerCol));
+  if (rows > opts.maxRows) {
+    rows = Math.max(1, opts.maxRows);
+    cols = Math.max(
+      minCols,
+      Math.min(cols, Math.floor(rows / Math.max(rowsPerCol, 1e-6)))
+    );
+  }
+  return { cols, rows };
+}
+function pixelAt(img, x, y, background) {
+  const o = (y * img.width + x) * 4;
+  const a = img.data[o + 3] / 255;
+  if (a >= 1) return [img.data[o], img.data[o + 1], img.data[o + 2]];
+  const mix = (channel, bg) => Math.round(channel * a + bg * (1 - a));
+  return [
+    mix(img.data[o], background[0]),
+    mix(img.data[o + 1], background[1]),
+    mix(img.data[o + 2], background[2])
+  ];
+}
+function toHalfBlocks(img, opts = {}) {
+  const background = opts.background ?? [0, 0, 0];
+  const cells = [];
+  for (let row = 0; row * 2 < img.height; row++) {
+    const cellsRow = [];
+    const topY = row * 2;
+    const bottomY = topY + 1;
+    for (let x = 0; x < img.width; x++) {
+      const top = pixelAt(img, x, topY, background);
+      const bottom = bottomY < img.height ? pixelAt(img, x, bottomY, background) : top;
+      cellsRow.push({ top, bottom });
+    }
+    cells.push(cellsRow);
+  }
+  return { cols: img.width, rows: cells.length, cells };
+}
+function toImageRuns(image) {
+  return image.cells.map((cells) => {
+    const runs = [];
+    for (const cell of cells) {
+      const last = runs[runs.length - 1];
+      if (last && last.top[0] === cell.top[0] && last.top[1] === cell.top[1] && last.top[2] === cell.top[2] && last.bottom[0] === cell.bottom[0] && last.bottom[1] === cell.bottom[1] && last.bottom[2] === cell.bottom[2]) {
+        last.text += HALF_BLOCK;
         continue;
       }
-    } else if (inTable) {
-      flushTable();
-      inTable = false;
+      runs.push({ text: HALF_BLOCK, top: cell.top, bottom: cell.bottom });
     }
-    if (/^(\s*[-*_]){3,}\s*$/.test(line)) {
-      out.push("\u2500".repeat(Math.min(width, 40)));
-      out.push("");
-      continue;
+    return runs;
+  });
+}
+var MAX_SOURCE_PIXELS = 2e7;
+async function rasterizeImage(bytes, opts) {
+  const ImageCtor = globalThis.Bun?.Image;
+  if (!ImageCtor) return null;
+  const source = new ImageCtor(bytes, { maxPixels: MAX_SOURCE_PIXELS });
+  try {
+    const meta = await source.metadata();
+    const { cols, rows } = fitImageToCells(meta.width, meta.height, opts);
+    const png = await source.resize(cols, rows * 2, { fit: "fill" }).png({ compressionLevel: 1 }).bytes();
+    return toHalfBlocks(decodePng(png), { background: opts.background });
+  } catch {
+    return null;
+  }
+}
+
+// src/image-loader.ts
+var MAX_IMAGE_BYTES = 6 * 1024 * 1024;
+var BADGE_HOST = /(^|\.)(shields\.io|badgen\.net|badge\.fury\.io|codecov\.io|coveralls\.io|travis-ci\.(org|com)|snyk\.io|sonarcloud\.io|david-dm\.(org|io))$/i;
+var RAW_HOSTS = /* @__PURE__ */ new Set([
+  "raw.githubusercontent.com",
+  "camo.githubusercontent.com",
+  "user-images.githubusercontent.com",
+  "private-user-images.githubusercontent.com",
+  "avatars.githubusercontent.com",
+  "objects.githubusercontent.com"
+]);
+var RASTER_EXT = /\.(png|jpe?g|webp|gif|bmp|avif|heic|tiff?)(?:[?#]|$)/i;
+var CACHE_LIMIT = 24;
+var cache = /* @__PURE__ */ new Map();
+function decodeDataUri(uri) {
+  const match = /^data:([^;,]+)?(;base64)?,(.*)$/is.exec(uri);
+  if (!match) return null;
+  const mime = (match[1] ?? "").toLowerCase();
+  if (mime.includes("svg")) return null;
+  const payload = match[3];
+  try {
+    if (match[2]) return new Uint8Array(Buffer.from(payload, "base64"));
+    return new Uint8Array(Buffer.from(decodeURIComponent(payload), "binary"));
+  } catch {
+    return null;
+  }
+}
+function toRawGitHubUrl(url) {
+  if (url.hostname.toLowerCase() !== "github.com") return url;
+  const match = /^\/([^/]+)\/([^/]+)\/(?:blob|raw)\/(.+)$/.exec(url.pathname);
+  if (!match) return url;
+  const [, owner, repo, rest] = match;
+  return new URL(
+    `https://raw.githubusercontent.com/${owner}/${repo}/${rest}${url.search}`
+  );
+}
+function resolveRootRelative(path, base) {
+  let parsed;
+  try {
+    parsed = new URL(base);
+  } catch {
+    return null;
+  }
+  if (parsed.hostname.toLowerCase() !== "raw.githubusercontent.com") {
+    return null;
+  }
+  const segments = parsed.pathname.split("/").filter(Boolean);
+  if (segments.length < 3) return null;
+  return new URL(`${parsed.origin}/${segments.slice(0, 3).join("/")}${path}`);
+}
+function resolveReadmeImageUrl(raw, base) {
+  const cleaned = raw.trim();
+  if (!cleaned) return null;
+  if (/^data:/i.test(cleaned)) {
+    return isRenderableImageUrl(cleaned) ? cleaned : null;
+  }
+  let url = null;
+  try {
+    url = cleaned.startsWith("/") ? resolveRootRelative(cleaned, base) : new URL(cleaned, base);
+  } catch {
+    return null;
+  }
+  if (!url) return null;
+  url = toRawGitHubUrl(url);
+  if (url.protocol !== "http:" && url.protocol !== "https:") return null;
+  url.hash = "";
+  const resolved = url.toString();
+  return isRenderableImageUrl(resolved) ? resolved : null;
+}
+function isRenderableImageUrl(url) {
+  if (/^data:/i.test(url)) return !/svg/i.test(url.slice(0, 64));
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return false;
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return false;
+  if (BADGE_HOST.test(parsed.hostname)) return false;
+  const path = parsed.pathname.toLowerCase();
+  if (path.endsWith(".svg") || path.endsWith(".svgz")) return false;
+  if (parsed.hostname.toLowerCase().endsWith("github.com")) {
+    if (/^\/user-attachments\//.test(path)) return true;
+    if (!RAW_HOSTS.has(parsed.hostname)) {
+      return /\.(png|jpe?g|webp|gif|bmp|avif|heic|tiff?)$/i.test(path);
     }
-    const headingMatch = line.match(/^(#{1,6})\s+(.+)/);
-    if (headingMatch) {
-      const level = headingMatch[1].length;
-      const text = renderInline(headingMatch[2]);
-      const prefix = "\u2588 ".repeat(level);
-      out.push("");
-      out.push(prefix + text);
-      out.push("");
-      continue;
+  }
+  if (/\.[a-z0-9]{1,5}$/.test(path) && !RASTER_EXT.test(path)) return false;
+  return true;
+}
+function isGitHubHost(hostname) {
+  return /(^|\.)githubusercontent\.com$|(^|\.)github\.com$/i.test(hostname);
+}
+async function fetchImageBytes(url, opts = {}) {
+  const cached2 = cache.get(url);
+  if (cached2) return cached2;
+  const pending = loadImageBytes(url, opts);
+  cache.set(url, pending);
+  while (cache.size > CACHE_LIMIT) {
+    const oldest = cache.keys().next().value;
+    if (oldest === void 0) break;
+    cache.delete(oldest);
+  }
+  return pending;
+}
+async function loadImageBytes(url, opts) {
+  if (/^data:/i.test(url)) return decodeDataUri(url);
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const timeoutMs = opts.timeoutMs ?? 1e4;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const headers = {
+      "User-Agent": "ghfind/1.0",
+      Accept: "image/*,*/*;q=0.5"
+    };
+    let host = "";
+    try {
+      host = new URL(url).hostname;
+    } catch {
+      return null;
     }
-    const bqMatch = line.match(/^>\s?(.*)/);
-    if (bqMatch) {
-      const inner = renderInline(bqMatch[1]);
-      for (const wl of wrapLine(inner, width - 4)) {
-        out.push("\u2502 " + wl);
-      }
+    if (opts.token && isGitHubHost(host)) {
+      headers.Authorization = `Bearer ${opts.token}`;
+    }
+    const res = await fetchImpl(url, { headers, signal: controller.signal });
+    if (!res.ok) return null;
+    const contentType = res.headers.get("content-type") ?? "";
+    if (contentType && !/^image\//i.test(contentType)) {
+      const githubHost = isGitHubHost(host);
+      if (!githubHost || !/octet-stream/i.test(contentType)) return null;
+    }
+    if (/svg/i.test(contentType)) return null;
+    const declared = Number(res.headers.get("content-length") ?? "0");
+    if (declared > MAX_IMAGE_BYTES) return null;
+    const buffer = new Uint8Array(await res.arrayBuffer());
+    if (buffer.byteLength === 0 || buffer.byteLength > MAX_IMAGE_BYTES) {
+      return null;
+    }
+    return buffer;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function readmeBaseUrl(owner, repo, branch, path = "README.md") {
+  return `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`;
+}
+
+// src/markdown-images.ts
+var IMG_TAG = /<img\b[^>]*?src\s*=\s*["']([^"']+)["'][^>]*>/gi;
+var ALT_ATTR = /\balt\s*=\s*["']([^"']*)["']/i;
+var HTML_TAG = /<\/?[a-z][^>]*>/gi;
+function imagesFromHtml(raw) {
+  if (!raw || !/<img\b/i.test(raw)) return [];
+  const withoutTags = raw.replace(IMG_TAG, "").replace(/<\/?(?:p|div|center|br|a|picture|source)\b[^>]*>/gi, "").trim();
+  if (withoutTags) return [];
+  const refs = [];
+  for (const match of raw.matchAll(IMG_TAG)) {
+    const tag = match[0];
+    const alt = ALT_ATTR.exec(tag)?.[1] ?? "";
+    refs.push({ href: match[1], alt });
+  }
+  return refs;
+}
+function inlinePlainText(tokens) {
+  if (!tokens) return "";
+  let out = "";
+  for (const token of tokens) {
+    if (token.type === "image") continue;
+    if (token.type === "html") {
+      out += (token.raw ?? "").replace(HTML_TAG, "");
       continue;
     }
-    const ulMatch = line.match(/^(\s*)[-*+]\s+(.*)/);
-    if (ulMatch) {
-      const indent = ulMatch[1].length;
-      const depth = Math.floor(indent / 2);
-      const prefix = "  ".repeat(depth) + "\u2022 ";
-      const inner = renderInline(ulMatch[2]);
-      for (const wl of wrapLine(inner, width - prefix.length)) {
-        out.push(prefix + wl);
-      }
+    if (token.type === "br") {
+      out += "\n";
       continue;
     }
-    const olMatch = line.match(/^(\s*)\d+\.\s+(.*)/);
-    if (olMatch) {
-      const indent = olMatch[1].length;
-      const depth = Math.floor(indent / 2);
-      const prefix = "  ".repeat(depth) + "\u25E6 ";
-      const inner = renderInline(olMatch[2]);
-      for (const wl of wrapLine(inner, width - prefix.length)) {
-        out.push(prefix + wl);
-      }
+    if (token.text && (!token.tokens || token.tokens.length === 0)) {
+      out += token.text;
       continue;
     }
-    if (line.trim() === "") {
-      out.push("");
+    if (token.tokens?.length) {
+      out += inlinePlainText(token.tokens);
       continue;
     }
-    const rendered = renderInline(line);
-    for (const wl of wrapLine(rendered, width)) {
-      out.push(wl);
+    if (token.raw) out += token.raw.replace(HTML_TAG, "");
+  }
+  return out;
+}
+function extractImageRefs(token) {
+  const images = [];
+  const collect = (inline2) => {
+    if (inline2.type === "image") {
+      if (inline2.href)
+        images.push({ href: inline2.href, alt: inline2.text ?? "" });
+      return true;
+    }
+    if (inline2.type === "html") {
+      const refs = imagesFromHtml(inline2.raw);
+      if (refs.length > 0) {
+        images.push(...refs);
+        return true;
+      }
+      return !(inline2.raw ?? "").replace(HTML_TAG, "").trim();
+    }
+    if (inline2.type === "text" || inline2.type === "escape") {
+      return !(inline2.text ?? "").trim();
     }
+    return false;
+  };
+  if (token.type === "image" && token.href) {
+    return [{ href: token.href, alt: token.text ?? "" }];
+  }
+  if (token.type === "html") {
+    const refs = imagesFromHtml(token.raw);
+    return refs.length > 0 ? refs : null;
   }
-  if (inCodeBlock) flushCode();
-  if (inTable) flushTable();
-  return out.join("\n");
+  const inline = token.tokens ?? [];
+  if (inline.length === 0) return null;
+  for (const child of inline) {
+    if (!collect(child)) return null;
+  }
+  return images.length > 0 ? images : null;
+}
+
+// src/markdown-view.ts
+var MAX_IMAGE_ROWS = 24;
+function createMarkdownStyle(colors2) {
+  const surface = colors2.surface ?? colors2.bg;
+  return SyntaxStyle.fromStyles({
+    default: { fg: colors2.text ?? "#ffffff" },
+    conceal: { fg: colors2.muted ?? "#888888" },
+    "markup.heading": { fg: colors2.accent ?? colors2.blue, bold: true },
+    "markup.strong": { fg: colors2.text ?? "#ffffff", bold: true },
+    "markup.italic": { fg: colors2.text ?? "#ffffff", italic: true },
+    "markup.strikethrough": { fg: colors2.muted ?? "#888888", dim: true },
+    "markup.raw": { fg: colors2.green ?? "#a6e3a1", bg: surface },
+    "markup.raw.block": { fg: colors2.green ?? "#a6e3a1" },
+    "markup.link": { fg: colors2.accent ?? colors2.blue },
+    "markup.link.label": {
+      fg: colors2.accent ?? colors2.blue,
+      underline: true
+    },
+    "markup.link.url": { fg: colors2.muted ?? "#888888", underline: true },
+    "markup.quote": { fg: colors2.muted ?? "#888888", italic: true },
+    "markup.list": { fg: colors2.blue ?? colors2.accent }
+  });
+}
+function hexToRgb(hex) {
+  const fallback = [0, 0, 0];
+  if (!hex) return fallback;
+  const match = /^#?([0-9a-f]{6})$/i.exec(hex.trim());
+  if (!match) return fallback;
+  const value = Number.parseInt(match[1], 16);
+  return [value >> 16 & 255, value >> 8 & 255, value & 255];
+}
+function rgba(color) {
+  return RGBA.fromValues(color[0], color[1], color[2], 255);
+}
+function imageStyledText(image) {
+  const chunks = [];
+  toImageRuns(image).forEach((runs, rowIndex) => {
+    if (rowIndex > 0) chunks.push({ __isChunk: true, text: "\n" });
+    for (const run2 of runs) {
+      chunks.push({
+        __isChunk: true,
+        text: run2.text,
+        fg: rgba(run2.top),
+        bg: rgba(run2.bottom)
+      });
+    }
+  });
+  return new StyledText3(chunks);
+}
+function createMarkdownView(opts) {
+  const { renderer, colors: colors2 } = opts;
+  const maxImageRows = opts.maxImageRows ?? MAX_IMAGE_ROWS;
+  const rasterCache = /* @__PURE__ */ new Map();
+  let imagesEnabled = opts.images ?? true;
+  let imageBase = opts.imageBase;
+  const text = () => colors2.text ?? "#ffffff";
+  const bg = () => opts.background ?? colors2.bg ?? "#000000";
+  const muted = () => colors2.muted ?? "#888888";
+  const renderable = new MarkdownRenderable(renderer, {
+    content: "",
+    syntaxStyle: createMarkdownStyle(colors2),
+    fg: text(),
+    bg: bg(),
+    conceal: true,
+    streaming: true,
+    internalBlockMode: "top-level",
+    // Borderless columns are the top-level default; boxed tables read better
+    // for the multi-column tables READMEs use.
+    tableOptions: { style: "grid" },
+    width: "100%"
+  });
+  const caption = (label, color = muted()) => new TextRenderable3(renderer, {
+    content: `  ${label}`,
+    fg: color,
+    bg: bg(),
+    wrapMode: "word",
+    flexShrink: 0,
+    width: "100%"
+  });
+  const rasterize = (url) => {
+    const maxCols = Math.max(8, Math.floor(opts.getImageWidth?.() ?? 100));
+    const key = `${maxCols}|${url}`;
+    const cached2 = rasterCache.get(key);
+    if (cached2) return cached2;
+    const pending = (async () => {
+      const loader = opts.loadImage;
+      if (!loader) return null;
+      const bytes = await loader(url);
+      if (!bytes) return null;
+      return rasterizeImage(bytes, {
+        maxCols,
+        maxRows: maxImageRows,
+        background: hexToRgb(bg())
+      });
+    })();
+    rasterCache.set(key, pending);
+    return pending;
+  };
+  const imageNode = (image) => {
+    const label = `\u{1F5BC}  ${image.alt.trim() || "image"}`;
+    const url = imageBase ? resolveReadmeImageUrl(image.href, imageBase) : null;
+    if (!imagesEnabled || !url || !opts.loadImage) return caption(label);
+    const container = new BoxRenderable3(renderer, {
+      flexDirection: "column",
+      flexShrink: 0,
+      width: "100%"
+    });
+    const placeholder = caption(`${label}  (loading\u2026)`);
+    container.add(placeholder);
+    void rasterize(url).then(
+      (cells) => {
+        console.error(
+          `[dbg] image resolved: cells=${cells ? `${cells.cols}x${cells.rows}` : "null"} destroyed=${container.isDestroyed} parent=${!!container.parent} enabled=${imagesEnabled}`
+        );
+        if (container.isDestroyed || !container.parent) return;
+        container.remove(placeholder);
+        placeholder.destroy();
+        container.add(caption(label));
+        if (cells) {
+          container.add(
+            new TextRenderable3(renderer, {
+              content: imageStyledText(cells),
+              bg: bg(),
+              wrapMode: "none",
+              selectable: false,
+              flexShrink: 0
+            })
+          );
+        }
+        renderable.requestRender();
+      },
+      (err) => {
+        console.error("[dbg] image promise rejected:", err);
+      }
+    );
+    return container;
+  };
+  const headingNode = (token) => {
+    const heading = inlinePlainText(token.tokens).trim();
+    if (!heading) return void 0;
+    const depth = token.depth ?? 1;
+    const color = depth <= 2 ? colors2.accent : colors2.teal ?? colors2.accent;
+    return new TextRenderable3(renderer, {
+      content: new StyledText3([
+        {
+          __isChunk: true,
+          text: heading,
+          fg: RGBA.fromHex(color ?? "#ffffff"),
+          attributes: createTextAttributes({
+            bold: true,
+            underline: depth === 1
+          })
+        }
+      ]),
+      bg: bg(),
+      wrapMode: "word",
+      flexShrink: 0,
+      width: "100%"
+    });
+  };
+  const buildRenderNode = () => (token, _context) => {
+    if (token.type === "heading") return headingNode(token);
+    const images = extractImageRefs(token);
+    if (images && images.length > 0) {
+      const box = new BoxRenderable3(renderer, {
+        flexDirection: "column",
+        flexShrink: 0,
+        width: "100%",
+        marginTop: 1
+      });
+      for (const image of images) box.add(imageNode(image));
+      return box;
+    }
+    return void 0;
+  };
+  renderable.renderNode = buildRenderNode();
+  return {
+    renderable,
+    get imagesEnabled() {
+      return imagesEnabled;
+    },
+    setContent(markdown, base) {
+      if (base !== void 0) imageBase = base;
+      renderable.syntaxStyle = createMarkdownStyle(colors2);
+      renderable.fg = text();
+      renderable.bg = bg();
+      renderable.content = markdown;
+    },
+    setImagesEnabled(enabled) {
+      if (imagesEnabled === enabled) return;
+      imagesEnabled = enabled;
+      renderable.renderNode = buildRenderNode();
+      renderable.requestRender();
+    }
+  };
 }
 
 // src/explore.ts
@@ -3392,7 +4057,7 @@ var StatusManager = class {
 };
 
 // src/share.ts
-import { spawn as spawn2 } from "child_process";
+import { spawn as spawn3 } from "child_process";
 function formatShare(repo, format2) {
   switch (format2) {
     case "markdown":
@@ -3410,7 +4075,7 @@ async function copyToClipboard(text) {
     const p = process.platform;
     const cmd = p === "win32" ? ["clip"] : p === "darwin" ? ["pbcopy"] : await findLinuxClipboard();
     if (!cmd) return false;
-    const proc = spawn2(cmd[0], cmd.slice(1), {
+    const proc = spawn3(cmd[0], cmd.slice(1), {
       stdio: ["pipe", "ignore", "ignore"]
     });
     proc.stdin.write(text);
@@ -3473,9 +4138,10 @@ function nextTip() {
 
 // src/update-check.ts
 import { readFileSync as readFileSync5 } from "fs";
-import { join as join5, dirname as dirname3 } from "path";
+import { join as join5, dirname as dirname3, posix } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var REGISTRY_URL = "https://registry.npmjs.org/github-search-cli/latest";
+var PKG_NAME2 = "github-search-cli";
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 var REQUEST_TIMEOUT_MS = 5e3;
 var __dirname2 = dirname3(fileURLToPath3(import.meta.url));
@@ -3560,30 +4226,55 @@ function suppressUpdateNotices() {
     suppressed: true
   });
 }
-async function performUpdate() {
-  const pkg = "github-search-cli";
-  const isBun = typeof process.versions !== "undefined" && "bun" in process.versions;
-  const cmd = isBun ? ["bun", "install", "-g", pkg] : ["npm", "install", "-g", pkg];
+function detectInstallLocation(pkgDir) {
+  const norm = pkgDir.split("\\").join("/");
+  const nodeModules = posix.dirname(norm);
+  if (posix.basename(nodeModules) !== "node_modules") return null;
+  const owner = posix.dirname(nodeModules);
+  if (/(^|\/)\.bun(\/|$)/.test(owner)) return { channel: "bun" };
+  const prefix = posix.basename(owner) === "lib" ? posix.dirname(owner) : owner;
+  return { channel: "npm", prefix };
+}
+function buildUpdateCommand(loc) {
+  if (loc.channel === "bun") return ["bun", "install", "-g", PKG_NAME2];
+  const args = ["npm", "install", "-g"];
+  if (loc.prefix) args.push("--prefix", loc.prefix);
+  args.push(PKG_NAME2);
+  return args;
+}
+function quoteWin32(arg) {
+  return /\s/.test(arg) ? `"${arg}"` : arg;
+}
+async function performUpdate(location = detectInstallLocation(PKG_DIR2)) {
+  if (!location) {
+    debugLog(
+      "Update skipped: the running install is not under a node_modules tree (compiled binary or dev checkout). Update it manually."
+    );
+    return false;
+  }
+  const argv = buildUpdateCommand(location);
   try {
-    if (isBun) {
-      const proc = Bun.spawn(cmd, {
-        stdout: "pipe",
-        stderr: "pipe"
-      });
-      await proc.exited;
-      if (proc.exitCode !== 0) {
-        const err = await proc.stderr.text();
-        debugLog(`Install failed (code ${proc.exitCode}): ${err}`);
-      }
-      return proc.exitCode === 0;
-    }
-    const { spawn: spawn3 } = await import("child_process");
-    return await new Promise((resolve) => {
-      const proc = spawn3(cmd[0], cmd.slice(1), { stdio: "ignore" });
-      proc.on("close", (code) => resolve(code === 0));
-      proc.on("error", () => resolve(false));
+    const { spawn: spawn4 } = await import("child_process");
+    const useShell = process.platform === "win32";
+    const proc = spawn4(
+      argv[0],
+      useShell ? argv.slice(1).map(quoteWin32) : argv.slice(1),
+      { stdio: ["ignore", "ignore", "pipe"], shell: useShell }
+    );
+    let stderr = "";
+    proc.stderr?.on("data", (chunk) => {
+      stderr += String(chunk);
     });
-  } catch {
+    const code = await new Promise((resolve) => {
+      proc.on("close", (c) => resolve(c));
+      proc.on("error", () => resolve(-1));
+    });
+    if (code !== 0) {
+      debugLog(`Install failed (code ${code}): ${stderr.trim()}`);
+    }
+    return code === 0;
+  } catch (e) {
+    debugLog(`Update failed: ${e instanceof Error ? e.message : String(e)}`);
     return false;
   }
 }
@@ -3603,7 +4294,7 @@ function fetchReleaseNotes(version) {
   try {
     const changelogPath = join5(PKG_DIR2, "CHANGELOG.md");
     const changelog = readFileSync5(changelogPath, "utf-8");
-    const header = "## [" + version + "]";
+    const header = `## [${version}]`;
     const start = changelog.indexOf(header);
     if (start === -1) return null;
     const bodyStart = start + header.length;
@@ -3617,7 +4308,7 @@ function fetchReleaseNotes(version) {
 }
 
 // src/landing.ts
-import { BoxRenderable as BoxRenderable3, TextRenderable as TextRenderable3 } from "@opentui/core";
+import { BoxRenderable as BoxRenderable4, TextRenderable as TextRenderable4 } from "@opentui/core";
 function landingKeysActive(mode, overlay) {
   return mode === "landing" && overlay === "none";
 }
@@ -3747,15 +4438,15 @@ async function launchBrowser(theme_override) {
   let currentPage = 1;
   let totalCount = 0;
   let deepDiveActive = false;
-  let compareList = [];
-  let quitArmed = false;
-  const header = new TextRenderable4(renderer, {
+  const compareList = [];
+  const _quitArmed = false;
+  const header = new TextRenderable5(renderer, {
     content: " ghfind \u2014 GitHub repo browser   [/]search  [Space]menu  [\u2192]open  [?]help  [q]uit",
     bg: colors.bg,
     fg: colors.muted,
     height: 1
   });
-  const trendingTabBox = new BoxRenderable4(renderer, {
+  const trendingTabBox = new BoxRenderable5(renderer, {
     flexDirection: "row",
     height: 1,
     backgroundColor: colors.surface,
@@ -3770,7 +4461,7 @@ async function launchBrowser(theme_override) {
     TAB_NAMES.forEach((name, i) => {
       const isActive = name === trendingTab;
       const label = ` ${name} `;
-      const tt = new TextRenderable4(renderer, {
+      const tt = new TextRenderable5(renderer, {
         content: label,
         fg: isActive ? colors.bg : colors.muted,
         bg: isActive ? colors.blue : colors.bg,
@@ -3779,7 +4470,7 @@ async function launchBrowser(theme_override) {
       trendingTabTexts.push(tt);
       trendingTabBox.add(tt);
       if (i < TAB_NAMES.length - 1) {
-        const sp = new TextRenderable4(renderer, {
+        const sp = new TextRenderable5(renderer, {
           content: "  ",
           fg: colors.muted,
           bg: colors.bg,
@@ -3792,7 +4483,7 @@ async function launchBrowser(theme_override) {
   }
   root.add(header);
   root.add(trendingTabBox);
-  const searchBox = new BoxRenderable4(renderer, {
+  const searchBox = new BoxRenderable5(renderer, {
     visible: true,
     width: "100%",
     flexDirection: "row",
@@ -3811,7 +4502,7 @@ async function launchBrowser(theme_override) {
   });
   searchBox.add(searchInput);
   root.add(searchBox);
-  const toolbarText = new TextRenderable4(renderer, {
+  const toolbarText = new TextRenderable5(renderer, {
     content: formatToolbar(currentSort, currentLimit, totalCount),
     visible: true,
     // hidden in trending mode
@@ -3820,14 +4511,14 @@ async function launchBrowser(theme_override) {
     paddingX: 1
   });
   root.add(toolbarText);
-  const body = new BoxRenderable4(renderer, {
+  const body = new BoxRenderable5(renderer, {
     flexDirection: "row",
     flexGrow: 1,
     gap: 1,
     paddingY: 1,
     paddingX: 1
   });
-  const resultsBox = new BoxRenderable4(renderer, {
+  const resultsBox = new BoxRenderable5(renderer, {
     border: true,
     borderColor: colors.border,
     title: " Results ",
@@ -3856,7 +4547,7 @@ async function launchBrowser(theme_override) {
     itemSpacing: 0
   });
   resultsBox.add(resultsSelect);
-  const detailBox = new BoxRenderable4(renderer, {
+  const detailBox = new BoxRenderable5(renderer, {
     width: "50%",
     flexDirection: "column",
     paddingX: 1,
@@ -3864,7 +4555,7 @@ async function launchBrowser(theme_override) {
     focusable: false,
     backgroundColor: colors.surface
   });
-  const detailText = new TextRenderable4(renderer, {
+  const detailText = new TextRenderable5(renderer, {
     content: "",
     fg: colors.text,
     wrapMode: "none"
@@ -3873,7 +4564,7 @@ async function launchBrowser(theme_override) {
   body.add(resultsBox);
   body.add(detailBox);
   root.add(body);
-  const landingBox = new BoxRenderable4(renderer, {
+  const landingBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     flexDirection: "column",
@@ -3881,7 +4572,7 @@ async function launchBrowser(theme_override) {
     justifyContent: "center"
   });
   root.add(landingBox);
-  const landingBanner = new TextRenderable4(renderer, {
+  const landingBanner = new TextRenderable5(renderer, {
     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",
@@ -3931,7 +4622,7 @@ async function launchBrowser(theme_override) {
   const landingCards = [];
   for (let i = 0; i < landingOptions.length; i++) {
     const opt = landingOptions[i];
-    const card = new BoxRenderable4(renderer, {
+    const card = new BoxRenderable5(renderer, {
       flexDirection: "column",
       height: 5,
       width: "60%",
@@ -3943,18 +4634,18 @@ async function launchBrowser(theme_override) {
     });
     landingCards.push(card);
     landingBox.add(card);
-    const spacerTop = new TextRenderable4(renderer, { content: "", height: 1 });
-    const titleLine = new TextRenderable4(renderer, {
+    const spacerTop = new TextRenderable5(renderer, { content: "", height: 1 });
+    const titleLine = new TextRenderable5(renderer, {
       content: opt.title,
       fg: i === 0 ? colors.accent : colors.text,
       height: 1
     });
-    const spacerBot = new TextRenderable4(renderer, { content: "", height: 1 });
+    const spacerBot = new TextRenderable5(renderer, { content: "", height: 1 });
     card.add(spacerTop);
     card.add(titleLine);
     card.add(spacerBot);
   }
-  const landingHint = new TextRenderable4(renderer, {
+  const landingHint = new TextRenderable5(renderer, {
     content: "   \u2191\u2193 Navigate  \u21E9 Select  [b]ookmarks  [?]help  [q]uit",
     fg: colors.muted,
     bg: colors.bg,
@@ -4097,7 +4788,7 @@ async function launchBrowser(theme_override) {
     renderer.requestRender();
   }
   const helpSections = buildHelpSections();
-  const helpBox = new BoxRenderable4(renderer, {
+  const helpBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.bg
@@ -4119,7 +4810,7 @@ async function launchBrowser(theme_override) {
     }
   });
   for (const section of helpSections) {
-    const sectionBox = new BoxRenderable4(renderer, {
+    const sectionBox = new BoxRenderable5(renderer, {
       title: section.title,
       titleColor: colors[section.titleColor] ?? section.titleColor,
       flexDirection: "column",
@@ -4131,7 +4822,7 @@ async function launchBrowser(theme_override) {
     for (const row of section.rows) {
       const keys = row.keys.padEnd(HELP_KEYS_COLUMN);
       sectionBox.add(
-        new TextRenderable4(renderer, {
+        new TextRenderable5(renderer, {
           content: `  ${keys} ${row.action}`,
           fg: colors.text
         })
@@ -4139,7 +4830,7 @@ async function launchBrowser(theme_override) {
     }
     if (section.note) {
       sectionBox.add(
-        new TextRenderable4(renderer, {
+        new TextRenderable5(renderer, {
           content: `  ${section.note}`,
           fg: colors.muted
         })
@@ -4149,7 +4840,7 @@ async function launchBrowser(theme_override) {
   }
   helpBox.add(helpScroll);
   root.add(helpBox);
-  const historyBox = new BoxRenderable4(renderer, {
+  const historyBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.bg,
@@ -4184,7 +4875,7 @@ async function launchBrowser(theme_override) {
     }
     historySelect.setSelectedIndex(0);
   }
-  const bookmarksBox = new BoxRenderable4(renderer, {
+  const bookmarksBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.bg,
@@ -4219,7 +4910,7 @@ async function launchBrowser(theme_override) {
     }
     bookmarksSelect.setSelectedIndex(0);
   }
-  const savedBox = new BoxRenderable4(renderer, {
+  const savedBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.bg,
@@ -4239,7 +4930,7 @@ async function launchBrowser(theme_override) {
   });
   savedBox.add(savedSelect);
   root.add(savedBox);
-  const topicsBox = new BoxRenderable4(renderer, {
+  const topicsBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.bg,
@@ -4274,7 +4965,7 @@ async function launchBrowser(theme_override) {
     }
     topicsSelect.setSelectedIndex(0);
   }
-  const exportBox = new BoxRenderable4(renderer, {
+  const exportBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.bg,
@@ -4311,28 +5002,28 @@ async function launchBrowser(theme_override) {
   });
   exportBox.add(exportSelect);
   root.add(exportBox);
-  const compareBox = new BoxRenderable4(renderer, {
+  const compareBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.bg,
     title: " Comparison ",
     titleColor: colors.yellow
   });
-  const compareText = new TextRenderable4(renderer, {
+  const compareText = new TextRenderable5(renderer, {
     content: "",
     fg: colors.text,
     bg: colors.bg
   });
   compareBox.add(compareText);
   root.add(compareBox);
-  const notifsBox = new BoxRenderable4(renderer, {
+  const notifsBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.bg,
     title: " Notifications ",
     titleColor: colors.yellow
   });
-  const notifsText = new TextRenderable4(renderer, {
+  const notifsText = new TextRenderable5(renderer, {
     content: "(no notifications)",
     fg: colors.text,
     bg: colors.bg
@@ -4347,7 +5038,7 @@ async function launchBrowser(theme_override) {
       notifsText.content = notifs2.map((n) => `  ${n.icon} ${n.message}`).join("\n");
     }
   }
-  const shareBox = new BoxRenderable4(renderer, {
+  const shareBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.bg,
@@ -4406,7 +5097,7 @@ async function launchBrowser(theme_override) {
     }
     savedSelect.setSelectedIndex(0);
   }
-  const leaderDim = new BoxRenderable4(renderer, {
+  const leaderDim = new BoxRenderable5(renderer, {
     visible: false,
     position: "absolute",
     top: 0,
@@ -4417,7 +5108,7 @@ async function launchBrowser(theme_override) {
     // 60% opacity black (hex alpha: 0x99 ≈ 153/255)
   });
   root.add(leaderDim);
-  const leaderBox = new BoxRenderable4(renderer, {
+  const leaderBox = new BoxRenderable5(renderer, {
     visible: false,
     position: "absolute",
     width: "80%",
@@ -4449,7 +5140,7 @@ async function launchBrowser(theme_override) {
     selectedDescriptionColor: colors.selectionText,
     itemSpacing: 0
   });
-  const leaderFooter = new TextRenderable4(renderer, {
+  const leaderFooter = new TextRenderable5(renderer, {
     content: " \u2191\u2193 select   Enter run   Esc/q close ",
     fg: colors.muted,
     bg: colors.surfaceDim,
@@ -4460,7 +5151,7 @@ async function launchBrowser(theme_override) {
   leaderBox.add(leaderFooter);
   root.add(leaderDim);
   root.add(leaderBox);
-  const updateDim = new BoxRenderable4(renderer, {
+  const updateDim = new BoxRenderable5(renderer, {
     visible: false,
     position: "absolute",
     top: 0,
@@ -4470,7 +5161,7 @@ async function launchBrowser(theme_override) {
     backgroundColor: "#00000088"
   });
   root.add(updateDim);
-  const updateBox = new BoxRenderable4(renderer, {
+  const updateBox = new BoxRenderable5(renderer, {
     visible: false,
     position: "absolute",
     width: "55%",
@@ -4489,11 +5180,19 @@ async function launchBrowser(theme_override) {
     paddingLeft: 2,
     paddingRight: 2
   });
-  const updateText = new TextRenderable4(renderer, {
+  const updateHeader = new TextRenderable5(renderer, {
     content: "",
     fg: colors.accent,
     bg: colors.surfaceDim
   });
+  const updateNotes = createMarkdownView({
+    renderer,
+    colors,
+    // Notes ship with the release and are mostly prose/lists; skip the
+    // image pipeline in this narrow panel.
+    images: false,
+    background: colors.surfaceDim
+  });
   const updateScroll = new ScrollBoxRenderable3(renderer, {
     flexGrow: 1,
     backgroundColor: colors.surfaceDim,
@@ -4513,14 +5212,14 @@ async function launchBrowser(theme_override) {
     }
   });
   let updateSelectedOption = 0;
-  const updateOptionsRow = new BoxRenderable4(renderer, {
+  const updateOptionsRow = new BoxRenderable5(renderer, {
     flexDirection: "row",
     gap: 1,
     backgroundColor: colors.surfaceDim,
     height: 3,
     width: "100%"
   });
-  const updateNowBox = new BoxRenderable4(renderer, {
+  const updateNowBox = new BoxRenderable5(renderer, {
     border: true,
     borderColor: updateSelectedOption === 0 ? colors.yellow : colors.border,
     backgroundColor: colors.surfaceDim,
@@ -4529,13 +5228,13 @@ async function launchBrowser(theme_override) {
     paddingLeft: 1,
     paddingRight: 1
   });
-  const updateNowText = new TextRenderable4(renderer, {
+  const updateNowText = new TextRenderable5(renderer, {
     content: "   Update Now  ",
     fg: updateSelectedOption === 0 ? colors.yellow : colors.text,
     bg: colors.surfaceDim
   });
   updateNowBox.add(updateNowText);
-  const laterBox = new BoxRenderable4(renderer, {
+  const laterBox = new BoxRenderable5(renderer, {
     border: true,
     borderColor: updateSelectedOption === 1 ? colors.yellow : colors.border,
     backgroundColor: colors.surfaceDim,
@@ -4544,13 +5243,13 @@ async function launchBrowser(theme_override) {
     paddingLeft: 1,
     paddingRight: 1
   });
-  const laterText = new TextRenderable4(renderer, {
+  const laterText = new TextRenderable5(renderer, {
     content: "  Later",
     fg: updateSelectedOption === 1 ? colors.yellow : colors.text,
     bg: colors.surfaceDim
   });
   laterBox.add(laterText);
-  const neverBox = new BoxRenderable4(renderer, {
+  const neverBox = new BoxRenderable5(renderer, {
     border: true,
     borderColor: updateSelectedOption === 2 ? colors.yellow : colors.border,
     backgroundColor: colors.surfaceDim,
@@ -4559,7 +5258,7 @@ async function launchBrowser(theme_override) {
     paddingLeft: 1,
     paddingRight: 1
   });
-  const neverText = new TextRenderable4(renderer, {
+  const neverText = new TextRenderable5(renderer, {
     content: "  Don't show again",
     fg: updateSelectedOption === 2 ? colors.yellow : colors.text,
     bg: colors.surfaceDim
@@ -4576,7 +5275,7 @@ async function launchBrowser(theme_override) {
   }
   updateOptionsRow.add(updateNowBox);
   updateOptionsRow.add(laterBox);
-  const updateFooter = new TextRenderable4(renderer, {
+  const updateFooter = new TextRenderable5(renderer, {
     content: "  \u2191\u2193/jk/PgUp/PgDn scroll  \u2190\u2192 select  Enter  Esc/q close",
     fg: colors.muted,
     bg: colors.surfaceDim,
@@ -4584,7 +5283,8 @@ async function launchBrowser(theme_override) {
     paddingX: 1
   });
   updateBox.add(updateScroll);
-  updateScroll.add(updateText);
+  updateScroll.add(updateHeader);
+  updateScroll.add(updateNotes.renderable);
   updateBox.add(updateOptionsRow);
   updateBox.add(updateFooter);
   root.add(updateDim);
@@ -4611,6 +5311,7 @@ async function launchBrowser(theme_override) {
     if (menuStack.length <= 1) return false;
     const prev = menuStack[menuStack.length - 2];
     const current = menuStack.pop();
+    if (!current) return false;
     leaderSelect.options = prev.entries.map((e) => ({
       name: e.type === "category" ? `  ${e.icon} ${e.name} \u2192` : `  ${e.name}`,
       description: e.description,
@@ -4927,19 +5628,16 @@ async function launchBrowser(theme_override) {
     if (!cachedVersion) {
       cachedVersion = getVersion();
     }
-    const currentVersion2 = cachedVersion;
+    const currentVersion = cachedVersion;
     if (!state.lastInstalledVersion) return;
-    if (state.lastInstalledVersion === currentVersion2) return;
-    const notes = fetchReleaseNotes(currentVersion2);
-    const notesWidth = Math.max(
-      30,
-      Math.floor((process.stdout.columns || 80) * 0.55) - 8
-    );
-    const notesBlock = notes ? renderMarkdown(notes, { width: notesWidth }) : "  No release notes found for this version.";
+    if (state.lastInstalledVersion === currentVersion) return;
+    const notes = fetchReleaseNotes(currentVersion);
     updateSelectedOption = 0;
-    updateText.content = `  Updated ghfind ${state.lastInstalledVersion} \u2192 ${currentVersion2}
-
-${notesBlock}`;
+    updateHeader.content = `  Updated ghfind ${state.lastInstalledVersion} \u2192 ${currentVersion}
+`;
+    updateNotes.setContent(
+      notes ?? "_No release notes found for this version._"
+    );
     renderUpdateOptions();
     showOverlay("update");
   }
@@ -4948,32 +5646,22 @@ ${notesBlock}`;
     if (cachedVersion === null) {
       cachedVersion = getVersion();
     }
-    const currentVersion2 = cachedVersion;
-    const latest = process.env.DEBUG_FORCE_UPDATE || await checkForUpdate(currentVersion2);
+    const currentVersion = cachedVersion;
+    const latest = process.env.DEBUG_FORCE_UPDATE || await checkForUpdate(currentVersion);
     markUpdateChecked(latest ?? void 0);
     if (latest) {
       updateSelectedOption = 0;
       const notes = fetchReleaseNotes(latest);
-      const notesWidth = Math.max(
-        30,
-        Math.floor((process.stdout.columns || 80) * 0.55) - 8
-      );
-      const notesBlock = notes ? renderMarkdown(notes, { width: notesWidth }) : `  A new version is available
-
-  Current: ${currentVersion2}
-  Latest:   ${latest}
+      updateHeader.content = `  A new version is available
 
-  Run "npm install -g ghfind"`;
-      updateText.content = `  A new version is available
-
-  Current: ${currentVersion2}
+  Current: ${currentVersion}
   Latest:   ${latest}
-
-${notesBlock}`;
+`;
+      updateNotes.setContent(notes ?? "Run `npm install -g ghfind` to update.");
       renderUpdateOptions();
       showOverlay("update");
     } else {
-      debugLog(`No update available (current: ${currentVersion2})`);
+      debugLog(`No update available (current: ${currentVersion})`);
     }
   }
   function openUrlIfSelected() {
@@ -5018,7 +5706,7 @@ ${notesBlock}`;
   }
   function saveCurrentSearch() {
     if (currentQueryInput) {
-      const name = currentQueryInput.length > 40 ? currentQueryInput.slice(0, 37) + "..." : currentQueryInput;
+      const name = currentQueryInput.length > 40 ? `${currentQueryInput.slice(0, 37)}...` : currentQueryInput;
       saveSearch(
         name,
         currentQueryInput,
@@ -5052,7 +5740,7 @@ ${notesBlock}`;
       renderer.requestRender();
     }
   }
-  const orgBox = new BoxRenderable4(renderer, {
+  const orgBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.surface,
@@ -5075,14 +5763,14 @@ ${notesBlock}`;
       }
     }
   });
-  const orgText = new TextRenderable4(renderer, {
+  const orgText = new TextRenderable5(renderer, {
     content: "",
     fg: colors.text,
     bg: colors.bg
   });
   orgScroll.add(orgText);
   orgBox.add(orgScroll);
-  const orgFooter = new TextRenderable4(renderer, {
+  const orgFooter = new TextRenderable5(renderer, {
     content: "  \u2191\u2193/jk scroll  Esc/q close",
     fg: colors.muted,
     bg: colors.bg,
@@ -5148,7 +5836,7 @@ ${notesBlock}`;
     }
     renderer.requestRender();
   }
-  const readmeBox = new BoxRenderable4(renderer, {
+  const readmeBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.surface,
@@ -5171,15 +5859,17 @@ ${notesBlock}`;
       }
     }
   });
-  const readmeText = new TextRenderable4(renderer, {
-    content: "",
-    fg: colors.text,
-    bg: colors.bg
+  const readmeView = createMarkdownView({
+    renderer,
+    colors,
+    loadImage: (url) => fetchImageBytes(url, { token: githubToken }),
+    getImageWidth: () => Math.max(24, (process.stdout.columns || 80) - 12)
   });
-  readmeScroll.add(readmeText);
+  readmeScroll.add(readmeView.renderable);
   readmeBox.add(readmeScroll);
-  const readmeFooter = new TextRenderable4(renderer, {
-    content: "  \u2191\u2193/jk scroll  Esc/q close",
+  const readmeFooterText = () => `  \u2191\u2193/jk scroll  PgUp/PgDn page  i images: ${readmeView.imagesEnabled ? "on" : "off"}  Esc/q close`;
+  const readmeFooter = new TextRenderable5(renderer, {
+    content: readmeFooterText(),
     fg: colors.muted,
     bg: colors.bg,
     height: 1,
@@ -5194,37 +5884,39 @@ ${notesBlock}`;
       setStatus("No repo selected");
       return;
     }
-    readmeText.content = `  Loading README for ${repo.fullName}...`;
+    readmeView.setContent(`Loading README for ${repo.fullName}\u2026`);
+    readmeFooter.content = readmeFooterText();
+    readmeScroll.scrollTop = 0;
     showOverlay("readme");
     try {
       const headers = { "User-Agent": "ghfind/1.0" };
       if (githubToken) headers.Authorization = `Bearer ${githubToken}`;
       let text = "";
-      for (const path of [
-        `${repo.owner}/${repo.name}/main/README.md`,
-        `${repo.owner}/${repo.name}/master/README.md`,
-        `${repo.owner}/${repo.name}/main/README.rst`
+      let sourceUrl = "";
+      for (const [branch, file] of [
+        ["main", "README.md"],
+        ["master", "README.md"],
+        ["main", "README.rst"]
       ]) {
-        const r = await fetch(`https://raw.githubusercontent.com/${path}`, {
-          headers
-        });
+        const url = readmeBaseUrl(repo.owner, repo.name, branch, file);
+        const r = await fetch(url, { headers });
         if (r.ok) {
           text = await r.text();
+          sourceUrl = url;
           break;
         }
       }
       if (!text) {
-        readmeText.content = `  (no README found for ${repo.fullName})`;
+        readmeView.setContent(`_(no README found for ${repo.fullName})_`);
       } else {
-        const termW = Math.max(40, (process.stdout.columns || 80) - 4);
-        readmeText.content = renderMarkdown(text, { width: termW });
+        readmeView.setContent(text, sourceUrl);
       }
     } catch {
-      readmeText.content = "  Failed to load README";
+      readmeView.setContent("_Failed to load README._");
     }
     renderer.requestRender();
   }
-  const statusBar = new TextRenderable4(renderer, {
+  const statusBar = new TextRenderable5(renderer, {
     content: " Ready. Press Enter to search.",
     fg: colors.muted,
     height: 1,
@@ -5235,13 +5927,11 @@ ${notesBlock}`;
     statusBar.content = ` ${text}`;
     renderer.requestRender();
   });
-  if (config.theme !== void 0 || true) {
-    setTimeout(() => {
-      if (currentOverlay === "none") {
-        setStatus(nextTip());
-      }
-    }, 2e3);
-  }
+  setTimeout(() => {
+    if (currentOverlay === "none") {
+      setStatus(nextTip());
+    }
+  }, 2e3);
   function setStatus(msg) {
     statusMgr.set("idle", msg);
   }
@@ -5361,7 +6051,7 @@ ${notesBlock}`;
       if (idx >= 0) {
         const val = labelVals[idx];
         label = val >= 1e3 ? `${(val / 1e3).toFixed(1).replace(/\.0$/, "")}k` : String(val);
-        label = label.padStart(5) + " ";
+        label = `${label.padStart(5)} `;
       }
       lines.push(`${label}\u2506${chars.join("")}`);
     }
@@ -5707,6 +6397,17 @@ ${notesBlock}`;
       doSearch(searchInput.value);
     }
   });
+  searchInput.on("input", () => {
+    const v = searchInput.value;
+    if (v.length > 0) {
+      const t3 = v.trim();
+      if (t3.startsWith("{") && t3.endsWith("}") || t3.startsWith("[") && t3.endsWith("]")) {
+        searchInput.value = "";
+        setStatus("Ignored JSON paste \u2014 search queries accept plain text");
+        renderer.requestRender();
+      }
+    }
+  });
   resultsSelect.on("selectionChanged", () => {
     const opt = resultsSelect.getSelectedOption();
     if (currentMode === "packages") {
@@ -5789,13 +6490,22 @@ ${pack.description ?? ""}`;
         return;
       }
       if (currentOverlay === "readme") {
+        if (key.name === "i") {
+          readmeView.setImagesEnabled(!readmeView.imagesEnabled);
+          readmeFooter.content = readmeFooterText();
+          setStatus(
+            readmeView.imagesEnabled ? "README images on" : "README images off"
+          );
+          renderer.requestRender();
+        }
         return;
       }
       if (currentOverlay === "history") {
         if (key.name === "d") {
           const sel = historySelect.getSelectedOption();
           if (sel?.value) {
-            deleteHistoryEntry(sel.value.index);
+            const idx = sel.value.index;
+            if (idx !== void 0) deleteHistoryEntry(idx);
             refreshHistory();
             setStatus("Deleted history entry");
           }
@@ -5814,6 +6524,7 @@ ${pack.description ?? ""}`;
           if (sel?.value) {
             const entry = sel.value.entry;
             showOverlay("none");
+            if (!entry) return;
             if (entry.mode === "trending") {
               if (entry.tab)
                 trendingTab = entry.tab;
@@ -5832,7 +6543,9 @@ ${pack.description ?? ""}`;
         if (key.name === "d") {
           const sel = bookmarksSelect.getSelectedOption();
           if (sel?.value) {
-            removeBookmark(sel.value.repo.fullName);
+            removeBookmark(
+              sel.value.repo?.fullName ?? ""
+            );
             refreshBookmarks();
             setStatus("Bookmark removed");
           }
@@ -5841,7 +6554,8 @@ ${pack.description ?? ""}`;
         }
         if (key.name === "enter" || key.name === "return") {
           const sel = bookmarksSelect.getSelectedOption();
-          if (sel?.value) openUrl(sel.value.repo.url);
+          if (sel?.value)
+            openUrl(sel.value.repo?.url ?? "");
           return;
         }
         return;
@@ -5850,7 +6564,7 @@ ${pack.description ?? ""}`;
         if (key.name === "d") {
           const sel = savedSelect.getSelectedOption();
           if (sel?.value) {
-            deleteSavedSearch(sel.value.name);
+            deleteSavedSearch(sel.value.name ?? "");
             refreshSavedSearches();
             setStatus("Saved search deleted");
           }
@@ -5885,7 +6599,7 @@ ${pack.description ?? ""}`;
           if (sel?.value) {
             const topic = sel.value;
             showOverlay("none");
-            searchInput.value = `topic:${topic.name}`;
+            searchInput.value = `topic:${topic.name ?? ""}`;
             showSearchMode();
             doSearch(`topic:${topic.name}`);
           }
@@ -6076,7 +6790,7 @@ ${pack.description ?? ""}`;
     }
     if (/^[1-5]$/.test(key.name)) {
       if (currentMode === "trending") {
-        const idx = parseInt(key.name) - 1;
+        const idx = parseInt(key.name, 10) - 1;
         if (idx >= 0 && idx < TAB_NAMES.length) {
           trendingTab = TAB_NAMES[idx];
           loadTrending();
@@ -6120,14 +6834,14 @@ ${pack.description ?? ""}`;
       return;
     }
   });
-  const currentVersion = getVersion();
-  if (!session || !session.mode) {
+  const _currentVersion = getVersion();
+  if (!session?.mode) {
     showLanding(true);
   }
   checkForUpdateAndShow();
   checkPostUpgradePanel();
   renderer.start();
-  if (session && session.mode) {
+  if (session?.mode) {
     if (currentMode === "trending") {
       loadTrending();
     } else {
@@ -6801,7 +7515,8 @@ async function processServerLine(line, state, config) {
   }
 }
 function writeStdout(line) {
-  process.stdout.write(line + "\n");
+  process.stdout.write(`${line}
+`);
 }
 async function runMcpServer(options = {}) {
   const state = {
@@ -6820,8 +7535,9 @@ async function runMcpServer(options = {}) {
   let buffer = "";
   process.stdin.on("data", (chunk) => {
     buffer += chunk;
-    let idx;
-    while ((idx = buffer.indexOf("\n")) >= 0) {
+    for (; ; ) {
+      const idx = buffer.indexOf("\n");
+      if (idx < 0) break;
       const line = buffer.slice(0, idx).trim();
       buffer = buffer.slice(idx + 1);
       if (!line) continue;
@@ -6879,7 +7595,7 @@ function parseArgs(args) {
     doctor: false,
     mcp: false
   };
-  let queryParts = [];
+  const queryParts = [];
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     switch (arg) {
@@ -6933,8 +7649,8 @@ function parseArgs(args) {
         flags.login = true;
         break;
       case "--limit": {
-        const parsed = parseInt(args[++i]);
-        if (isNaN(parsed) || parsed < 1 || parsed > 100) {
+        const parsed = parseInt(args[++i], 10);
+        if (Number.isNaN(parsed) || parsed < 1 || parsed > 100) {
           console.error(`Invalid limit: must be 1-100. Using default 50.`);
           flags.limit = 50;
         } else {
@@ -7174,7 +7890,12 @@ function printAgentSkill(name) {
 }
 async function runUserProfile(flags, outputFormat) {
   try {
-    const profile = await fetchUserProfile(flags.user, {
+    const user = flags.user ?? "";
+    if (!user) {
+      console.error("Usage: ghfind user <name> [--json] [--token <t>]");
+      process.exit(1);
+    }
+    const profile = await fetchUserProfile(user, {
       token: flags.token,
       limit: flags.limit
     });
@@ -7196,7 +7917,12 @@ async function runUserProfile(flags, outputFormat) {
 }
 async function runOrgProfile(flags, outputFormat) {
   try {
-    const profile = await fetchOrgProfile(flags.org, {
+    const org = flags.org ?? "";
+    if (!org) {
+      console.error("Usage: ghfind org <name> [--json] [--token <t>]");
+      process.exit(1);
+    }
+    const profile = await fetchOrgProfile(org, {
       token: flags.token,
       limit: flags.limit
     });
@@ -7327,7 +8053,7 @@ async function runReleases(flags, outputFormat) {
 }
 async function runNonInteractive(flags, outputFormat) {
   const handlers = {
-    trending: async (ctx2) => {
+    trending: async (_ctx) => {
       const since = flags.since === "weekly" ? "weekly" : flags.since === "monthly" ? "monthly" : "daily";
       const trendingSearch = createTrendingSearch();
       let language;
@@ -7398,7 +8124,7 @@ async function runNonInteractive(flags, outputFormat) {
         token: flags.token
       });
       const repos = rankRepos(response.repos, flags.sort);
-      await pipeExec(repos, flags.pipe);
+      if (flags.pipe) await pipeExec(repos, flags.pipe);
     },
     format: async (ctx2) => {
       const response = await ctx2.provider.search(ctx2.parsed, {