@commentray/render 0.0.1

package/dist/code-browser-client.js

@@ -0,0 +1,252 @@
+import { FuzzySearcher, PrefixSearcher, Query, SearcherFactory, SubstringSearcher, } from "@m31coding/fuzzy-search";
+import { findOrderedTokenSpans, lineAtIndex, offsetToLineIndex } from "./code-browser-search.js";
+function tokenizeQuery(q) {
+    return q.trim().split(/\s+/).filter(Boolean);
+}
+function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, n));
+}
+function decodeB64(b64) {
+    try {
+        return decodeURIComponent(escape(atob(b64)));
+    }
+    catch {
+        try {
+            return atob(b64);
+        }
+        catch {
+            return "";
+        }
+    }
+}
+function escapeHtmlText(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+function snippet(s, maxLen) {
+    const t = s.replace(/\s+/g, " ").trim();
+    if (t.length <= maxLen)
+        return t;
+    return `${t.slice(0, maxLen - 1)}…`;
+}
+function mergeHits(rows, max) {
+    const byKey = new Map();
+    for (const r of rows) {
+        const key = `${r.kind}:${r.line}`;
+        const prev = byKey.get(key);
+        if (!prev || r.score > prev.score) {
+            byKey.set(key, r);
+        }
+    }
+    return [...byKey.values()].sort((a, b) => b.score - a.score).slice(0, max);
+}
+function buildOrderedHits(raw, kind, tokens) {
+    const spans = findOrderedTokenSpans(raw, tokens);
+    const seen = new Set();
+    const out = [];
+    for (const sp of spans) {
+        const line = offsetToLineIndex(raw, sp.start);
+        if (seen.has(line))
+            continue;
+        seen.add(line);
+        out.push({
+            kind,
+            line,
+            text: lineAtIndex(raw, line),
+            score: 1000,
+            source: "ordered",
+        });
+    }
+    return out;
+}
+function buildFuzzyHits(searcher, query, topN) {
+    const qstr = query.trim();
+    if (!qstr)
+        return [];
+    const q = new Query(qstr, topN, [
+        new FuzzySearcher(0.22),
+        new SubstringSearcher(0),
+        new PrefixSearcher(0),
+    ]);
+    const res = searcher.getMatches(q);
+    const out = [];
+    for (const m of res.matches) {
+        const row = m.entity;
+        out.push({
+            kind: row.kind,
+            line: row.line,
+            text: row.text,
+            score: 100 + m.quality,
+            source: "fuzzy",
+        });
+    }
+    return out;
+}
+function wireSearchUi(ctx) {
+    const { rawCode, rawMd, mdLines, searcher, searchInput, searchClear, searchResults, docPane } = ctx;
+    function runSearch() {
+        const tokens = tokenizeQuery(searchInput.value);
+        if (tokens.length === 0) {
+            searchResults.hidden = true;
+            searchResults.innerHTML = "";
+            return;
+        }
+        const orderedCode = buildOrderedHits(rawCode, "code", tokens);
+        const orderedMd = buildOrderedHits(rawMd, "md", tokens);
+        const fuzzyHits = buildFuzzyHits(searcher, searchInput.value, 60);
+        const combined = mergeHits([...orderedCode, ...orderedMd, ...fuzzyHits], 80);
+        searchResults.hidden = false;
+        if (combined.length === 0) {
+            searchResults.innerHTML =
+                '<div class="hint">No matches. Try fewer tokens or looser spelling (fuzzy matches per line).</div>';
+            return;
+        }
+        const buf = [];
+        buf.push(`<div class="hint">Whole source: whitespace tokens in order (may span lines). Per-line fuzzy ranking for typos. ${combined.length} hit(s).</div>`);
+        for (const h of combined) {
+            const label = h.kind === "code" ? `Code L${h.line + 1}` : `Commentray L${h.line + 1}`;
+            const tag = h.source === "ordered" ? "ordered" : "fuzzy";
+            buf.push(`<button type="button" class="hit" data-kind="${h.kind}" data-line="${String(h.line)}">` +
+                `<span class="meta">${label} <span class="src-tag">(${tag})</span></span>` +
+                `<div class="snippet">${escapeHtmlText(snippet(h.text, 200))}</div></button>`);
+        }
+        searchResults.innerHTML = buf.join("");
+    }
+    searchResults.addEventListener("click", (ev) => {
+        let t = ev.target;
+        while (t && t !== searchResults && (!t.classList || !t.classList.contains("hit"))) {
+            t = t.parentElement;
+        }
+        if (!t || !t.classList || !t.classList.contains("hit"))
+            return;
+        const kind = t.getAttribute("data-kind");
+        const line = parseInt(t.getAttribute("data-line") || "0", 10);
+        if (kind === "code") {
+            const el = document.getElementById(`code-line-${String(line)}`);
+            if (el)
+                el.scrollIntoView({ block: "nearest", behavior: "smooth" });
+        }
+        else {
+            const total = mdLines.length;
+            if (total <= 0)
+                return;
+            const ratio = line / Math.max(1, total - 1);
+            const maxScroll = docPane.scrollHeight - docPane.clientHeight;
+            docPane.scrollTo({ top: ratio * Math.max(0, maxScroll), behavior: "smooth" });
+        }
+    });
+    let debounceTimer;
+    searchInput.addEventListener("input", () => {
+        clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(runSearch, 200);
+    });
+    searchClear.addEventListener("click", () => {
+        clearTimeout(debounceTimer);
+        searchInput.value = "";
+        searchResults.innerHTML = "";
+        searchResults.hidden = true;
+    });
+}
+function wireWrapToggle(storageWrap, codePane, wrapCb) {
+    const wrap = localStorage.getItem(storageWrap) === "1";
+    wrapCb.checked = wrap;
+    if (wrap)
+        codePane.classList.add("wrap");
+    wrapCb.addEventListener("change", () => {
+        if (wrapCb.checked) {
+            codePane.classList.add("wrap");
+            localStorage.setItem(storageWrap, "1");
+        }
+        else {
+            codePane.classList.remove("wrap");
+            localStorage.setItem(storageWrap, "0");
+        }
+    });
+}
+function wireSplitter(storageSplit, shell, codePane, gutter, initialPct) {
+    let dragging = false;
+    let lastPct = initialPct;
+    function onMove(ev) {
+        if (!dragging)
+            return;
+        const rect = shell.getBoundingClientRect();
+        const x = ev.clientX - rect.left;
+        const p = clamp((x / rect.width) * 100, 15, 85);
+        lastPct = p;
+        codePane.style.flex = `0 0 ${p}%`;
+    }
+    function stop() {
+        dragging = false;
+        window.removeEventListener("mousemove", onMove);
+        window.removeEventListener("mouseup", stop);
+        document.body.style.cursor = "";
+        document.body.style.userSelect = "";
+        localStorage.setItem(storageSplit, String(lastPct));
+    }
+    gutter.addEventListener("mousedown", (e) => {
+        e.preventDefault();
+        dragging = true;
+        document.body.style.cursor = "col-resize";
+        document.body.style.userSelect = "none";
+        window.addEventListener("mousemove", onMove);
+        window.addEventListener("mouseup", stop);
+    });
+}
+function main() {
+    const storageSplit = "commentray.codeCommentrayStatic.splitPct";
+    const storageWrap = "commentray.codeCommentrayStatic.wrap";
+    const shell = document.getElementById("shell");
+    const codePane = document.getElementById("code-pane");
+    const docPane = document.getElementById("doc-pane");
+    const gutter = document.getElementById("gutter");
+    const wrapCb = document.getElementById("wrap-lines");
+    const searchInput = document.getElementById("search-q");
+    const searchClear = document.getElementById("search-clear");
+    const searchResults = document.getElementById("search-results");
+    if (!shell ||
+        !codePane ||
+        !docPane ||
+        !gutter ||
+        !wrapCb ||
+        !searchInput ||
+        !searchClear ||
+        !searchResults) {
+        return;
+    }
+    const rawCode = decodeB64(codePane.getAttribute("data-raw-code-b64") || "");
+    const rawMd = decodeB64(codePane.getAttribute("data-raw-md-b64") || "");
+    const mdLines = rawMd.split("\n");
+    const codeLines = rawCode.split("\n");
+    const lineRows = [
+        ...codeLines.map((text, line) => ({ kind: "code", line, text })),
+        ...mdLines.map((text, line) => ({ kind: "md", line, text })),
+    ];
+    const searcher = SearcherFactory.createDefaultSearcher();
+    searcher.indexEntities(lineRows, (e) => `${e.kind}:${e.line}`, (e) => [e.text]);
+    wireSearchUi({
+        rawCode,
+        rawMd,
+        mdLines,
+        searcher,
+        searchInput,
+        searchClear,
+        searchResults,
+        docPane,
+    });
+    const pct0 = parseFloat(localStorage.getItem(storageSplit) || "50");
+    const pct = clamp(Number.isFinite(pct0) ? pct0 : 50, 15, 85);
+    codePane.style.flex = `0 0 ${pct}%`;
+    wireWrapToggle(storageWrap, codePane, wrapCb);
+    wireSplitter(storageSplit, shell, codePane, gutter, pct);
+}
+if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", main);
+}
+else {
+    main();
+}
+//# sourceMappingURL=code-browser-client.js.map

package/dist/code-browser-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-client.js","sourceRoot":"","sources":["../src/code-browser-client.ts"],"names":[],"mappings":"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"}

package/dist/code-browser-search.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Whole-document search: tokens must appear in order as case-insensitive substrings,
+ * but may span multiple lines (any offsets in `text`).
+ */
+/**
+ * Returns every minimal span [start, end) where each non-empty token appears in order
+ * in `text` (case-insensitive). Spans may overlap; iteration advances by one code unit
+ * from the start of the previous match.
+ */
+export declare function findOrderedTokenSpans(text: string, tokens: string[]): Array<{
+    start: number;
+    end: number;
+}>;
+/** 0-based line index for the line containing `offset` (offset clamped to [0, length]). */
+export declare function offsetToLineIndex(text: string, offset: number): number;
+export declare function lineAtIndex(text: string, lineIndex: number): string;
+//# sourceMappingURL=code-browser-search.d.ts.map

package/dist/code-browser-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-search.d.ts","sourceRoot":"","sources":["../src/code-browser-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,GACf,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BvC;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOtE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAInE"}

package/dist/code-browser-search.js

@@ -0,0 +1,60 @@
+/**
+ * Whole-document search: tokens must appear in order as case-insensitive substrings,
+ * but may span multiple lines (any offsets in `text`).
+ */
+const MAX_ORDERED_SPANS = 400;
+/**
+ * Returns every minimal span [start, end) where each non-empty token appears in order
+ * in `text` (case-insensitive). Spans may overlap; iteration advances by one code unit
+ * from the start of the previous match.
+ */
+export function findOrderedTokenSpans(text, tokens) {
+    const parts = tokens.map((t) => t.trim()).filter(Boolean);
+    if (parts.length === 0)
+        return [];
+    const lower = text.toLowerCase();
+    const needle = parts.map((t) => t.toLowerCase());
+    const out = [];
+    let scan = 0;
+    let produced = 0;
+    while (scan < text.length && produced < MAX_ORDERED_SPANS) {
+        let pos = scan;
+        let first = -1;
+        let ok = true;
+        for (const tok of needle) {
+            if (tok.length === 0)
+                continue;
+            const idx = lower.indexOf(tok, pos);
+            if (idx < 0) {
+                ok = false;
+                break;
+            }
+            if (first < 0)
+                first = idx;
+            pos = idx + tok.length;
+        }
+        if (!ok || first < 0)
+            break;
+        out.push({ start: first, end: pos });
+        produced++;
+        scan = first + 1;
+    }
+    return out;
+}
+/** 0-based line index for the line containing `offset` (offset clamped to [0, length]). */
+export function offsetToLineIndex(text, offset) {
+    const o = Math.max(0, Math.min(offset, text.length));
+    let line = 0;
+    for (let i = 0; i < o; i++) {
+        if (text[i] === "\n")
+            line++;
+    }
+    return line;
+}
+export function lineAtIndex(text, lineIndex) {
+    const lines = text.split("\n");
+    if (lineIndex < 0 || lineIndex >= lines.length)
+        return "";
+    return lines[lineIndex] ?? "";
+}
+//# sourceMappingURL=code-browser-search.js.map

package/dist/code-browser-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser-search.js","sourceRoot":"","sources":["../src/code-browser-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,MAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACjD,MAAM,GAAG,GAA0C,EAAE,CAAC;IACtD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,OAAO,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QAC1D,IAAI,GAAG,GAAG,IAAI,CAAC;QACf,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;QACf,IAAI,EAAE,GAAG,IAAI,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACpC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;gBACZ,EAAE,GAAG,KAAK,CAAC;gBACX,MAAM;YACR,CAAC;YACD,IAAI,KAAK,GAAG,CAAC;gBAAE,KAAK,GAAG,GAAG,CAAC;YAC3B,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,EAAE,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM;QAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QACrC,QAAQ,EAAE,CAAC;QACX,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAc;IAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,SAAiB;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAC1D,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/code-browser.d.ts

@@ -0,0 +1,18 @@
+export type CodeBrowserPageOptions = {
+    title?: string;
+    /** Repo-relative (or otherwise meaningful) path to display prominently in the toolbar. */
+    filePath?: string;
+    code: string;
+    language: string;
+    commentrayMarkdown: string;
+    includeMermaidRuntime?: boolean;
+    /** Highlight.js stylesheet base name (e.g. github, github-dark). */
+    hljsTheme?: string;
+};
+/**
+ * Static HTML shell for a minimal “code browser”: code + rendered commentray,
+ * draggable vertical splitter, togglable line wrap for the code pane, and
+ * token-in-line quick search (all non-whitespace tokens must appear on the same line).
+ */
+export declare function renderCodeBrowserHtml(opts: CodeBrowserPageOptions): Promise<string>;
+//# sourceMappingURL=code-browser.d.ts.map

package/dist/code-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser.d.ts","sourceRoot":"","sources":["../src/code-browser.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAgPF;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCzF"}

package/dist/code-browser.js

@@ -0,0 +1,241 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { escapeHtml } from "./html-utils.js";
+import { renderFencedCode, renderMarkdownToHtml } from "./markdown-pipeline.js";
+function extractPreCodeInner(html) {
+    const m = /<pre(?:\s[^>]*)?>\s*<code(?:\s[^>]*)?>([\s\S]*?)<\/code>\s*<\/pre>/i.exec(html.trim());
+    return m ? m[1] : escapeHtml(html);
+}
+/** One highlighted row per source line so in-page search can scroll to a line. */
+async function renderCodeLineBlocks(code, language) {
+    const lines = code.split("\n");
+    const langAttr = escapeHtml(language);
+    const parts = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] === "" ? " " : lines[i];
+        const fence = "```" + language + "\n" + line + "\n```\n";
+        const block = await renderFencedCode(fence);
+        const inner = extractPreCodeInner(block);
+        const num = i + 1;
+        parts.push(`<div class="code-line" id="code-line-${i}" data-line="${i}">` +
+            `<span class="ln" aria-hidden="true">${num}</span>` +
+            `<pre><code class="hljs language-${langAttr}">${inner}</code></pre>` +
+            `</div>`);
+    }
+    return parts.join("\n");
+}
+/** Split a repo-relative path into its directory prefix (with trailing slash) and basename. */
+function splitFilePath(p) {
+    const normalized = p.replaceAll("\\", "/").replace(/^\/+/, "");
+    const idx = normalized.lastIndexOf("/");
+    if (idx < 0)
+        return { dir: "", base: normalized };
+    return { dir: normalized.slice(0, idx + 1), base: normalized.slice(idx + 1) };
+}
+function renderFilePathLabel(filePath, fallbackTitle) {
+    const shown = (filePath ?? "").trim();
+    if (!shown) {
+        return `<strong class="file-path file-path--title">${escapeHtml(fallbackTitle)}</strong>`;
+    }
+    const { dir, base } = splitFilePath(shown);
+    const dirHtml = dir
+        ? `<span class="file-path__dir">${escapeHtml(dir)}</span>`
+        : `<span class="file-path__dir file-path__dir--root" title="Repository root">/ </span>`;
+    return (`<strong class="file-path" title="${escapeHtml(shown)}">` +
+        dirHtml +
+        `<span class="file-path__base">${escapeHtml(base)}</span>` +
+        `</strong>`);
+}
+/** IIFE produced by `npm run build -w @commentray/render` (esbuild of `code-browser-client.ts`). */
+function loadCodeBrowserClientBundle() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const inDist = join(here, "code-browser-client.bundle.js");
+    const fromSrc = join(here, "..", "dist", "code-browser-client.bundle.js");
+    for (const p of [inDist, fromSrc]) {
+        if (existsSync(p)) {
+            return readFileSync(p, "utf8");
+        }
+    }
+    throw new Error("Missing code-browser-client.bundle.js. Run `npm run build -w @commentray/render` to bundle the browser client.");
+}
+const CODE_BROWSER_STYLES = `
+      :root { color-scheme: light dark; }
+      * { box-sizing: border-box; }
+      body { margin: 0; font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif; }
+      .toolbar {
+        display: flex; flex-wrap: wrap; align-items: center; gap: 10px 14px; padding: 8px 12px;
+        border-bottom: 1px solid color-mix(in oklab, CanvasText 18%, Canvas);
+        font-size: 13px; flex: 0 0 auto;
+      }
+      .toolbar label { display: inline-flex; align-items: center; gap: 6px; cursor: pointer; user-select: none; }
+      .toolbar .file-path {
+        font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, monospace;
+        font-size: 13px; font-weight: 500;
+        display: inline-flex; align-items: baseline; gap: 0; margin-right: 4px;
+        max-width: 60vw; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+      }
+      .toolbar .file-path__dir {
+        color: color-mix(in oklab, CanvasText 55%, Canvas);
+      }
+      .toolbar .file-path__dir--root { letter-spacing: 0; }
+      .toolbar .file-path__base {
+        color: CanvasText; font-weight: 600;
+      }
+      .toolbar .file-path--title { font-weight: 600; }
+      .toolbar .search-field {
+        display: inline-flex; align-items: center; gap: 6px; flex: 1 1 220px; min-width: 160px;
+      }
+      .toolbar .search-field input[type="search"] {
+        flex: 1; min-width: 0; padding: 4px 8px; font: inherit; border-radius: 6px;
+        border: 1px solid color-mix(in oklab, CanvasText 25%, Canvas); background: Canvas;
+        color: CanvasText;
+      }
+      .toolbar button {
+        font: inherit; padding: 4px 10px; border-radius: 6px; cursor: pointer;
+        border: 1px solid color-mix(in oklab, CanvasText 25%, Canvas); background: color-mix(in oklab, CanvasText 6%, Canvas);
+        color: CanvasText;
+      }
+      .search-results {
+        flex: 0 0 auto; max-height: 160px; overflow: auto; padding: 6px 12px 8px;
+        border-bottom: 1px solid color-mix(in oklab, CanvasText 12%, Canvas);
+        font-size: 12px;
+      }
+      .search-results[hidden] { display: none !important; }
+      .search-results .hint { opacity: 0.75; margin-bottom: 6px; }
+      .search-results button.hit {
+        display: block; width: 100%; text-align: left; margin: 2px 0; padding: 6px 8px;
+        border-radius: 6px; border: 1px solid color-mix(in oklab, CanvasText 14%, Canvas);
+        background: color-mix(in oklab, CanvasText 5%, Canvas); color: CanvasText; cursor: pointer;
+        font: inherit;
+      }
+      .search-results button.hit:hover { background: color-mix(in oklab, CanvasText 10%, Canvas); }
+      .search-results button.hit .meta { opacity: 0.8; font-size: 11px; }
+      .search-results button.hit .src-tag { opacity: 0.75; font-weight: 500; font-size: 10px; }
+      .search-results button.hit .snippet { font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, monospace; font-size: 11px; white-space: pre-wrap; word-break: break-word; margin-top: 2px; }
+      .shell { display: flex; flex-direction: row; flex: 1; min-height: 0; }
+      .pane--code {
+        flex: 0 0 50%;
+        min-width: 120px; overflow: auto; padding: 12px 16px;
+        border-right: 1px solid color-mix(in oklab, CanvasText 15%, Canvas);
+      }
+      .pane--code .code-line {
+        display: grid; grid-template-columns: auto 1fr; column-gap: 12px; align-items: start;
+      }
+      .pane--code .code-line pre { margin: 0; min-width: 0; }
+      .pane--code .code-line .ln {
+        font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, monospace;
+        font-variant-numeric: tabular-nums;
+        text-align: right; user-select: none; -webkit-user-select: none;
+        color: color-mix(in oklab, CanvasText 45%, Canvas);
+        padding-right: 8px;
+        border-right: 1px solid color-mix(in oklab, CanvasText 12%, Canvas);
+        min-width: 3ch;
+      }
+      .pane--code .code-line:target .ln,
+      .pane--code .code-line:hover .ln {
+        color: color-mix(in oklab, CanvasText 75%, Canvas);
+      }
+      .pane--code.wrap .code-line pre, .pane--code.wrap .code-line pre code {
+        white-space: pre-wrap; word-break: break-word;
+      }
+      .pane--code:not(.wrap) .code-line pre, .pane--code:not(.wrap) .code-line pre code {
+        white-space: pre;
+      }
+      .gutter {
+        flex: 0 0 8px; cursor: col-resize; background: color-mix(in oklab, CanvasText 12%, Canvas);
+        position: relative;
+      }
+      .gutter:hover { background: color-mix(in oklab, CanvasText 22%, Canvas); }
+      .gutter::after {
+        content: ""; position: absolute; top: 0; bottom: 0; left: -4px; right: -4px;
+      }
+      .pane--doc {
+        flex: 1 1 auto; min-width: 120px; overflow: auto; padding: 12px 16px;
+      }
+      .pane--doc { font-size: 15px; line-height: 1.45; }
+      .pane--doc img { max-width: 100%; height: auto; }
+      .pane h2.pane-title { margin: 0 0 10px; font-size: 12px; letter-spacing: 0.06em; text-transform: uppercase; opacity: 0.75; }
+      .app { display: flex; flex-direction: column; height: 100vh; }
+`;
+function buildCodeBrowserPageHtml(p) {
+    const { title, filePathHtml, codeHtml, commentrayHtml, rawCodeB64, rawMdB64, hljs, hljsDark, mermaidScript, } = p;
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${escapeHtml(title)}</title>
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.11.1/build/styles/${escapeHtml(hljs)}.min.css" media="(prefers-color-scheme: light)" />
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.11.1/build/styles/${escapeHtml(hljsDark)}.min.css" media="(prefers-color-scheme: dark)" />
+    <style>
+${CODE_BROWSER_STYLES}
+    </style>
+  </head>
+  <body>
+    <div class="app">
+      <header class="toolbar" aria-label="View options">
+        ${filePathHtml}
+        <span class="search-field">
+          <label for="search-q">Search</label>
+          <input type="search" id="search-q" placeholder="Whole source (ordered tokens + fuzzy lines)…" autocomplete="off" spellcheck="false" />
+          <button type="button" id="search-clear" title="Clear search">Clear</button>
+        </span>
+        <label><input type="checkbox" id="wrap-lines" /> Wrap code lines</label>
+      </header>
+      <div class="search-results" id="search-results" hidden aria-live="polite"></div>
+      <div class="shell" id="shell">
+        <section class="pane--code" id="code-pane" aria-label="Source code" data-raw-code-b64="${escapeHtml(rawCodeB64)}" data-raw-md-b64="${escapeHtml(rawMdB64)}">
+          <h2 class="pane-title">Code</h2>
+          ${codeHtml}
+        </section>
+        <div class="gutter" id="gutter" role="separator" aria-orientation="vertical" aria-label="Resize panes"></div>
+        <section class="pane--doc commentray" id="doc-pane" aria-label="Commentray">
+          <h2 class="pane-title">Commentray</h2>
+          ${commentrayHtml}
+        </section>
+      </div>
+    </div>
+    <script>
+${loadCodeBrowserClientBundle()}
+    </script>
+    ${mermaidScript}
+  </body>
+</html>`;
+}
+/**
+ * Static HTML shell for a minimal “code browser”: code + rendered commentray,
+ * draggable vertical splitter, togglable line wrap for the code pane, and
+ * token-in-line quick search (all non-whitespace tokens must appear on the same line).
+ */
+export async function renderCodeBrowserHtml(opts) {
+    const [codeHtml, commentrayHtml] = await Promise.all([
+        renderCodeLineBlocks(opts.code, opts.language),
+        renderMarkdownToHtml(opts.commentrayMarkdown),
+    ]);
+    const rawCodeB64 = Buffer.from(opts.code, "utf8").toString("base64");
+    const rawMdB64 = Buffer.from(opts.commentrayMarkdown, "utf8").toString("base64");
+    const title = opts.title ?? opts.filePath ?? "Commentray";
+    const filePathHtml = renderFilePathLabel(opts.filePath, title);
+    const hljs = opts.hljsTheme ?? "github";
+    const hljsDark = opts.hljsTheme?.includes("dark") ? opts.hljsTheme : "github-dark";
+    const mermaidScript = opts.includeMermaidRuntime
+        ? `<script type="module">
+import mermaid from "https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs";
+mermaid.initialize({ startOnLoad: true, securityLevel: "strict" });
+mermaid.run({ querySelector: ".mermaid" });
+</script>`
+        : "";
+    return buildCodeBrowserPageHtml({
+        title,
+        filePathHtml,
+        codeHtml,
+        commentrayHtml,
+        rawCodeB64,
+        rawMdB64,
+        hljs,
+        hljsDark,
+        mermaidScript,
+    });
+}
+//# sourceMappingURL=code-browser.js.map

package/dist/code-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-browser.js","sourceRoot":"","sources":["../src/code-browser.ts"],"names":[],"mappings":"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"}

package/dist/html-utils.d.ts

@@ -0,0 +1,3 @@
+/** Escape text for safe inclusion in HTML attributes or text nodes. */
+export declare function escapeHtml(text: string): string;
+//# sourceMappingURL=html-utils.d.ts.map

package/dist/html-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-utils.d.ts","sourceRoot":"","sources":["../src/html-utils.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/C"}

package/dist/html-utils.js

@@ -0,0 +1,10 @@
+/** Escape text for safe inclusion in HTML attributes or text nodes. */
+export function escapeHtml(text) {
+    return text
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+//# sourceMappingURL=html-utils.js.map

package/dist/html-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-utils.js","sourceRoot":"","sources":["../src/html-utils.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI;SACR,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC"}