github-search-cli 9.7.1 → 9.8.0

package/dist/cli.js

@@ -1538,7 +1538,7 @@ var cached = null;
 function getVersion() {
   if (cached) return cached;
   if (true) {
-    cached = "9.7.1";
+    cached = "9.8.0";
     return cached;
   }
   try {
@@ -2382,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) => ({
@@ -2414,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(
@@ -2443,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)
@@ -2456,7 +2456,7 @@ async function checkReleases(opts = {}) {
       });
     }
   }
-  saveCache(cache);
+  saveCache(cache2);
   return results2;
 }
 async function checkAndNotify(opts = {}) {
@@ -2473,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()
   );
 }
@@ -2953,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
@@ -3059,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" },
@@ -3099,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"
@@ -3260,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++) {
-    const 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;
+      const o = (y * width + x) * 4;
+      out[o] = r;
+      out[o + 1] = g;
+      out[o + 2] = b;
+      out[o + 3] = a;
     }
-    if (inCodeBlock) {
-      codeLines.push(line);
-      continue;
-    }
-    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
@@ -3746,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";
 }
@@ -3878,13 +4440,13 @@ async function launchBrowser(theme_override) {
   let deepDiveActive = false;
   const compareList = [];
   const _quitArmed = false;
-  const header = new TextRenderable4(renderer, {
+  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,
@@ -3899,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,
@@ -3908,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,
@@ -3921,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",
@@ -3940,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
@@ -3949,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 ",
@@ -3985,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,
@@ -3993,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"
@@ -4002,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",
@@ -4010,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",
@@ -4060,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%",
@@ -4072,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,
@@ -4226,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
@@ -4248,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",
@@ -4260,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
         })
@@ -4268,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
         })
@@ -4278,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,
@@ -4313,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,
@@ -4348,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,
@@ -4368,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,
@@ -4403,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,
@@ -4440,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
@@ -4476,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,
@@ -4535,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,
@@ -4546,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%",
@@ -4578,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,
@@ -4589,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,
@@ -4599,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%",
@@ -4618,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,
@@ -4642,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,
@@ -4658,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,
@@ -4673,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,
@@ -4688,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
@@ -4705,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,
@@ -4713,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);
@@ -5061,15 +5632,12 @@ async function launchBrowser(theme_override) {
     if (!state.lastInstalledVersion) return;
     if (state.lastInstalledVersion === currentVersion) return;
     const notes = fetchReleaseNotes(currentVersion);
-    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.";
     updateSelectedOption = 0;
-    updateText.content = `  Updated ghfind ${state.lastInstalledVersion} \u2192 ${currentVersion}
-
-${notesBlock}`;
+    updateHeader.content = `  Updated ghfind ${state.lastInstalledVersion} \u2192 ${currentVersion}
+`;
+    updateNotes.setContent(
+      notes ?? "_No release notes found for this version._"
+    );
     renderUpdateOptions();
     showOverlay("update");
   }
@@ -5084,22 +5652,12 @@ ${notesBlock}`;
     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
+      updateHeader.content = `  A new version is available
 
   Current: ${currentVersion}
   Latest:   ${latest}
-
-  Run "npm install -g ghfind"`;
-      updateText.content = `  A new version is available
-
-  Current: ${currentVersion}
-  Latest:   ${latest}
-
-${notesBlock}`;
+`;
+      updateNotes.setContent(notes ?? "Run `npm install -g ghfind` to update.");
       renderUpdateOptions();
       showOverlay("update");
     } else {
@@ -5182,7 +5740,7 @@ ${notesBlock}`;
       renderer.requestRender();
     }
   }
-  const orgBox = new BoxRenderable4(renderer, {
+  const orgBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.surface,
@@ -5205,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,
@@ -5278,7 +5836,7 @@ ${notesBlock}`;
     }
     renderer.requestRender();
   }
-  const readmeBox = new BoxRenderable4(renderer, {
+  const readmeBox = new BoxRenderable5(renderer, {
     visible: false,
     flexGrow: 1,
     backgroundColor: colors.surface,
@@ -5301,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,
@@ -5324,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,
@@ -5835,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") {
@@ -5917,6 +6490,14 @@ ${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") {