@profullstack/readm3 0.1.0

package/dist/tree.js

@@ -0,0 +1,172 @@
+/**
+ * The file browser's model: a pruned tree of markdown files under a root.
+ *
+ * Directories with no markdown anywhere beneath them are dropped, so the pane
+ * shows a map of the documentation rather than a map of the repository.
+ */
+import { readdirSync, statSync } from "node:fs";
+import { basename, join, relative, sep } from "node:path";
+export const MARKDOWN = /\.(?:md|markdown|mdown|mkd|mdx)$/i;
+export const DEFAULT_IGNORE = [
+    "node_modules",
+    ".git",
+    ".svn",
+    ".hg",
+    "dist",
+    "build",
+    "out",
+    "target",
+    "vendor",
+    "coverage",
+    ".next",
+    ".nuxt",
+    ".turbo",
+    ".cache",
+    ".venv",
+    "venv",
+    "__pycache__",
+    ".pnpm-store",
+];
+/** README first, then the rest alphabetically; directories lead. */
+function order(a, b) {
+    if (a.dir !== b.dir)
+        return a.dir ? -1 : 1;
+    if (!a.dir) {
+        const ra = /^readme\b/i.test(a.name);
+        const rb = /^readme\b/i.test(b.name);
+        if (ra !== rb)
+            return ra ? -1 : 1;
+    }
+    return a.name.localeCompare(b.name, undefined, { numeric: true, sensitivity: "base" });
+}
+export function scan(root, options = {}) {
+    const ignore = new Set(options.ignore ?? DEFAULT_IGNORE);
+    const maxDepth = options.maxDepth ?? 12;
+    const budget = { left: options.maxEntries ?? 5000 };
+    const walk = (dir, depth) => {
+        if (depth > maxDepth || budget.left <= 0)
+            return [];
+        let names;
+        try {
+            names = readdirSync(dir);
+        }
+        catch {
+            return [];
+        }
+        const entries = [];
+        for (const name of names) {
+            if (budget.left <= 0)
+                break;
+            if (!options.all && name.startsWith("."))
+                continue;
+            if (ignore.has(name))
+                continue;
+            const path = join(dir, name);
+            let isDir;
+            try {
+                isDir = statSync(path).isDirectory();
+            }
+            catch {
+                continue;
+            }
+            if (isDir) {
+                const children = walk(path, depth + 1);
+                if (children.length === 0)
+                    continue;
+                budget.left--;
+                entries.push({ name, path, dir: true, children, expanded: depth < 1 });
+            }
+            else if (MARKDOWN.test(name)) {
+                budget.left--;
+                entries.push({ name, path, dir: false, children: [], expanded: false });
+            }
+        }
+        return entries.sort(order);
+    };
+    return walk(root, 0);
+}
+/**
+ * Depth-first order of what is currently visible. Matches HQTUI's own tree
+ * flattening, so a selected index means the same thing to both.
+ */
+export function flatten(entries, depth = 0, parent = -1, out = []) {
+    for (const entry of entries) {
+        const index = out.length;
+        out.push({ entry, depth, parent });
+        if (entry.dir && entry.expanded)
+            flatten(entry.children, depth + 1, index, out);
+    }
+    return out;
+}
+/** Every markdown file in the tree, in display order. */
+export function files(entries, out = []) {
+    for (const entry of entries) {
+        if (entry.dir)
+            files(entry.children, out);
+        else
+            out.push(entry);
+    }
+    return out;
+}
+/**
+ * A copy of the tree keeping only files whose path matches `query`, with every
+ * surviving directory expanded. Matching is a case-insensitive subsequence, so
+ * "gsg" finds "getting-started-guide.md".
+ */
+export function filterTree(entries, query, root) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return entries;
+    const keep = (list) => {
+        const result = [];
+        for (const entry of list) {
+            if (entry.dir) {
+                const children = keep(entry.children);
+                if (children.length > 0)
+                    result.push({ ...entry, children, expanded: true });
+            }
+            else if (matches(relative(root, entry.path), q)) {
+                result.push(entry);
+            }
+        }
+        return result;
+    };
+    return keep(entries);
+}
+/** Case-insensitive subsequence match, with a substring hit always winning. */
+export function matches(haystack, needle) {
+    const h = haystack.toLowerCase();
+    const n = needle.toLowerCase();
+    if (h.includes(n))
+        return true;
+    let i = 0;
+    for (const ch of n) {
+        const at = h.indexOf(ch, i);
+        if (at < 0)
+            return false;
+        i = at + 1;
+    }
+    return true;
+}
+/** Expand every directory on the way to `path`, so a file can be revealed. */
+export function reveal(entries, path) {
+    for (const entry of entries) {
+        if (entry.path === path)
+            return true;
+        if (entry.dir && path.startsWith(entry.path + sep) && reveal(entry.children, path)) {
+            entry.expanded = true;
+            return true;
+        }
+    }
+    return false;
+}
+/** Index of `path` in the flattened list, or -1. */
+export function indexOfPath(flat, path) {
+    return flat.findIndex((f) => f.entry.path === path);
+}
+/** A short label for the header: the path relative to the root. */
+export function label(root, path) {
+    const rel = relative(root, path);
+    return rel && !rel.startsWith("..") ? rel : basename(path);
+}
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

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

package/dist/viewer.d.ts

@@ -0,0 +1,13 @@
+export interface ViewerOptions {
+    /** Directory the browser is rooted at. */
+    root: string;
+    /** File to open on start. */
+    open?: string | undefined;
+    theme?: string | undefined;
+    /** Sidebar columns. Clamped to the terminal. */
+    sidebar?: number | undefined;
+    mouse?: boolean | undefined;
+    all?: boolean | undefined;
+}
+export declare function run(options: ViewerOptions): Promise<void>;
+//# sourceMappingURL=viewer.d.ts.map

package/dist/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../src/viewer.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B;AAuCD,wBAAsB,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkc/D"}

package/dist/viewer.js

@@ -0,0 +1,477 @@
+/**
+ * The reader: a file browser on the left, the rendered document on the right.
+ */
+import { readFileSync, statSync } from "node:fs";
+import { basename, dirname, relative, resolve } from "node:path";
+import { createApp, stringWidth } from "@profullstack/hqtui";
+import { renderMarkdown } from "./markdown.js";
+import { filterTree, flatten, indexOfPath, label as pathLabel, reveal, scan, } from "./tree.js";
+/** Files above this size are refused rather than rendered. */
+const MAX_BYTES = 4 * 1024 * 1024;
+const clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, n));
+/** Map a span's semantic role onto the active theme. */
+function colorOf(span, theme) {
+    switch (span.role) {
+        case "h1":
+            return theme.title;
+        case "h2":
+            return theme.primary;
+        case "h3":
+            return theme.secondary;
+        case "code":
+        case "lang":
+        case "bullet":
+            return theme.accent;
+        case "fence":
+            return theme.foreground;
+        case "gutter":
+        case "rule":
+            return theme.border;
+        case "link":
+        case "url":
+            return theme.info;
+        case "quote":
+            return theme.secondary;
+        case "meta":
+            return theme.muted;
+        case "th":
+            return theme.title;
+        default:
+            return theme.foreground;
+    }
+}
+export async function run(options) {
+    const root = resolve(options.root);
+    const app = await createApp({
+        theme: options.theme,
+        mouse: options.mouse !== false,
+        // `q` is handled below so it can be typed into the filter.
+        quitKeys: ["ctrl+c"],
+    });
+    let entries = scan(root, { all: options.all ?? false });
+    let filter = "";
+    let filtering = false;
+    let view = entries;
+    let flat = flatten(view);
+    let selected = 0;
+    let pane = "tree";
+    let help = false;
+    let message = "";
+    let openPath = null;
+    let source = null;
+    let doc = null;
+    let scroll = 0;
+    let sidebar = options.sidebar ?? 0;
+    // Last measured pane interiors; the panel header needs them a frame early.
+    let viewport = { w: 80, h: 20 };
+    let treeHeight = 20;
+    // The panel header quotes numbers only the draw can measure, so a change in
+    // geometry or document length schedules exactly one more frame.
+    let measured = { total: -1, h: -1 };
+    const rebuild = (keepPath) => {
+        view = filter ? filterTree(entries, filter, root) : entries;
+        flat = flatten(view);
+        const at = keepPath ? indexOfPath(flat, keepPath) : -1;
+        selected = at >= 0 ? at : clamp(selected, 0, Math.max(0, flat.length - 1));
+    };
+    const openFile = (path) => {
+        try {
+            const info = statSync(path);
+            if (info.size > MAX_BYTES) {
+                message = `${basename(path)} is ${(info.size / 1024 / 1024).toFixed(1)} MB — too large to render`;
+                return;
+            }
+            source = readFileSync(path, "utf8");
+            openPath = path;
+            doc = null;
+            scroll = 0;
+            message = "";
+        }
+        catch (error) {
+            message = `Cannot read ${basename(path)}: ${error instanceof Error ? error.message : String(error)}`;
+        }
+    };
+    const maxScroll = () => Math.max(0, (doc?.lines.length ?? 0) - viewport.h);
+    const moveSelection = (delta) => {
+        if (flat.length === 0)
+            return;
+        selected = clamp(selected + delta, 0, flat.length - 1);
+    };
+    const activate = () => {
+        const current = flat[selected];
+        if (!current)
+            return;
+        if (current.entry.dir) {
+            current.entry.expanded = !current.entry.expanded;
+            rebuild(current.entry.path);
+        }
+        else {
+            openFile(current.entry.path);
+            pane = "view";
+        }
+    };
+    // Open whatever was asked for, or fall back to the first file in the tree.
+    if (options.open) {
+        openFile(resolve(options.open));
+        if (openPath) {
+            reveal(entries, openPath);
+            rebuild(openPath);
+        }
+    }
+    app.on("key", (event) => {
+        const { key, name, char } = event;
+        if (help) {
+            help = false;
+            app.invalidate();
+            return;
+        }
+        if (filtering) {
+            if (key === "escape") {
+                filtering = false;
+                filter = "";
+                rebuild(openPath);
+            }
+            else if (name === "enter") {
+                filtering = false;
+                const current = flat[selected];
+                if (current && !current.entry.dir)
+                    activate();
+            }
+            else if (name === "backspace") {
+                filter = filter.slice(0, -1);
+                rebuild();
+            }
+            else if (name === "up") {
+                moveSelection(-1);
+            }
+            else if (name === "down") {
+                moveSelection(1);
+            }
+            else if (char && !event.ctrl && !event.alt) {
+                filter += char;
+                rebuild();
+            }
+            app.invalidate();
+            return;
+        }
+        switch (key) {
+            case "q":
+                app.stop();
+                return;
+            case "?":
+                help = true;
+                app.invalidate();
+                return;
+            case "tab":
+                pane = pane === "tree" ? "view" : "tree";
+                app.invalidate();
+                return;
+            case "r": {
+                const keep = openPath;
+                entries = scan(root, { all: options.all ?? false });
+                if (keep)
+                    reveal(entries, keep);
+                rebuild(keep);
+                if (keep)
+                    openFile(keep);
+                app.invalidate();
+                return;
+            }
+            case "/":
+                filtering = true;
+                pane = "tree";
+                app.invalidate();
+                return;
+            case "[":
+                sidebar = clamp(sidebar - 2, 16, Math.max(16, app.width - 24));
+                app.invalidate();
+                return;
+            case "]":
+                sidebar = clamp(sidebar + 2, 16, Math.max(16, app.width - 24));
+                app.invalidate();
+                return;
+            case "escape":
+                if (filter) {
+                    filter = "";
+                    rebuild(openPath);
+                }
+                else {
+                    pane = "tree";
+                }
+                app.invalidate();
+                return;
+            default:
+                break;
+        }
+        if (pane === "tree") {
+            switch (key) {
+                case "up":
+                case "k":
+                    moveSelection(-1);
+                    break;
+                case "down":
+                case "j":
+                    moveSelection(1);
+                    break;
+                case "pageup":
+                    moveSelection(-Math.max(1, treeHeight - 1));
+                    break;
+                case "pagedown":
+                    moveSelection(Math.max(1, treeHeight - 1));
+                    break;
+                case "home":
+                case "g":
+                    selected = 0;
+                    break;
+                case "end":
+                case "G":
+                case "shift+g":
+                    selected = Math.max(0, flat.length - 1);
+                    break;
+                case "right":
+                case "l":
+                case "enter":
+                case "space": {
+                    const current = flat[selected];
+                    if (current?.entry.dir && current.entry.expanded && key !== "space")
+                        moveSelection(1);
+                    else
+                        activate();
+                    break;
+                }
+                case "left":
+                case "h": {
+                    const current = flat[selected];
+                    if (current?.entry.dir && current.entry.expanded) {
+                        current.entry.expanded = false;
+                        rebuild(current.entry.path);
+                    }
+                    else if (current && current.parent >= 0) {
+                        selected = current.parent;
+                    }
+                    break;
+                }
+                default:
+                    break;
+            }
+            app.invalidate();
+            return;
+        }
+        const page = Math.max(1, viewport.h - 2);
+        switch (key) {
+            case "up":
+            case "k":
+                scroll = clamp(scroll - 1, 0, maxScroll());
+                break;
+            case "down":
+            case "j":
+                scroll = clamp(scroll + 1, 0, maxScroll());
+                break;
+            case "pageup":
+            case "b":
+                scroll = clamp(scroll - page, 0, maxScroll());
+                break;
+            case "pagedown":
+            case "space":
+                scroll = clamp(scroll + page, 0, maxScroll());
+                break;
+            case "home":
+            case "g":
+                scroll = 0;
+                break;
+            case "end":
+            case "G":
+            case "shift+g":
+                scroll = maxScroll();
+                break;
+            case "left":
+            case "h":
+                pane = "tree";
+                break;
+            default:
+                break;
+        }
+        app.invalidate();
+    });
+    app.render(({ ui, theme, width, height }) => {
+        if (sidebar === 0)
+            sidebar = clamp(Math.round(width * 0.28), 22, 42);
+        const side = clamp(sidebar, 16, Math.max(16, width - 24));
+        const openRel = openPath ? pathLabel(root, openPath) : "";
+        const total = doc?.lines.length ?? 0;
+        const percent = total <= viewport.h ? 100 : Math.round((Math.min(scroll + viewport.h, total) / total) * 100);
+        ui.column({}, (screen) => {
+            screen.row({ size: "fill" }, (panes) => {
+                // ------------------------------------------------------- browser
+                panes.panel({
+                    width: side,
+                    title: filtering || filter ? ` /${filter}` : ` ${basename(root) || root} `,
+                    titleColor: filter ? theme.warning : theme.title,
+                    subtitle: filtering ? "▏" : `${flat.length}`,
+                    borderColor: pane === "tree" ? theme.borderFocused : theme.border,
+                    padding: [0, 1],
+                }, (p) => {
+                    treeHeight = p.height;
+                    if (flat.length === 0) {
+                        p.text(filter ? "No match." : "No markdown here.", { fg: theme.muted });
+                        return;
+                    }
+                    p.list({
+                        items: flat.map(({ entry, depth }) => {
+                            const indent = "  ".repeat(depth);
+                            const glyph = entry.dir ? (entry.expanded ? "▾ " : "▸ ") : "  ";
+                            const color = entry.dir
+                                ? theme.primary
+                                : entry.path === openPath
+                                    ? theme.accent
+                                    : theme.foreground;
+                            return { label: `${indent}${glyph}${entry.name}`, color };
+                        }),
+                        selected,
+                        followSelection: true,
+                        scrollbar: true,
+                        onScroll: (delta) => {
+                            moveSelection(delta * 3);
+                            app.invalidate();
+                        },
+                        onSelectRow: (row) => {
+                            const offset = Math.max(0, Math.min(selected - Math.floor(p.height / 2), flat.length - p.height));
+                            const index = clamp((flat.length > p.height ? offset : 0) + row, 0, flat.length - 1);
+                            selected = index;
+                            pane = "tree";
+                            activate();
+                            app.invalidate();
+                        },
+                        onFocus: () => {
+                            pane = "tree";
+                            app.invalidate();
+                        },
+                    });
+                });
+                // -------------------------------------------------------- reader
+                panes.panel({
+                    title: openRel ? ` ${openRel} ` : " readm3 ",
+                    subtitle: openPath ? `${percent}%` : undefined,
+                    footer: openPath && total > 0 ? `${Math.min(scroll + viewport.h, total)}/${total}` : undefined,
+                    borderColor: pane === "view" ? theme.borderFocused : theme.border,
+                    padding: [0, 1],
+                }, (p) => {
+                    const w = p.width;
+                    const h = p.height;
+                    viewport = { w, h };
+                    p.ctx.hit({
+                        rect: p.surface.hitRect(),
+                        onScroll: (delta) => {
+                            scroll = clamp(scroll + delta * 3, 0, maxScroll());
+                            app.invalidate();
+                        },
+                        onClick: () => {
+                            pane = "view";
+                            app.invalidate();
+                        },
+                    });
+                    if (message) {
+                        p.text(message, { fg: theme.danger, wrap: true });
+                        return;
+                    }
+                    if (!openPath || source === null) {
+                        p.spacer("fill");
+                        p.text("readm3", { fg: theme.title, bold: true, align: "center" });
+                        p.text("Pick a file on the left. ? for keys.", { fg: theme.muted, align: "center" });
+                        p.spacer("fill");
+                        return;
+                    }
+                    if (!doc || doc.path !== openPath || doc.width !== w) {
+                        doc = { path: openPath, width: w, lines: renderMarkdown(source, w) };
+                    }
+                    scroll = clamp(scroll, 0, Math.max(0, doc.lines.length - h));
+                    if (measured.total !== doc.lines.length || measured.h !== h) {
+                        measured = { total: doc.lines.length, h };
+                        app.invalidate();
+                    }
+                    for (const line of doc.lines.slice(scroll, scroll + h)) {
+                        const spans = line.spans;
+                        const only = spans[0];
+                        if (spans.length <= 1) {
+                            p.text(only?.text ?? "", {
+                                height: 1,
+                                fg: only ? colorOf(only, theme) : theme.foreground,
+                                bold: only?.bold ?? false,
+                                italic: only?.italic ?? false,
+                                underline: only?.underline ?? false,
+                                dim: only?.dim ?? false,
+                            });
+                            continue;
+                        }
+                        p.row({ height: 1 }, (row) => {
+                            for (const span of spans) {
+                                row.text(span.text, {
+                                    width: stringWidth(span.text),
+                                    fg: colorOf(span, theme),
+                                    bold: span.bold ?? false,
+                                    italic: span.italic ?? false,
+                                    underline: span.underline ?? false,
+                                    dim: span.dim ?? false,
+                                });
+                            }
+                            row.spacer("fill");
+                        });
+                    }
+                });
+            });
+            screen.statusBar({
+                items: filtering
+                    ? [
+                        { key: "type", label: "filter" },
+                        { key: "↵", label: "open" },
+                        { key: "esc", label: "clear" },
+                    ]
+                    : pane === "tree"
+                        ? [
+                            { key: "↑↓", label: "move" },
+                            { key: "↵", label: "open" },
+                            { key: "←→", label: "fold" },
+                            { key: "/", label: "find" },
+                            { key: "tab", label: "reader" },
+                            { key: "?", label: "keys" },
+                            { key: "q", label: "quit" },
+                        ]
+                        : [
+                            { key: "↑↓", label: "scroll" },
+                            { key: "spc", label: "page" },
+                            { key: "g/G", label: "ends" },
+                            { key: "tab", label: "files" },
+                            { key: "?", label: "keys" },
+                            { key: "q", label: "quit" },
+                        ],
+                right: [
+                    { label: openPath ? (dirname(openRel) === "." ? basename(root) : dirname(openRel)) : basename(root) },
+                    { label: theme.name, color: theme.muted },
+                ],
+            });
+            if (help) {
+                screen.modal({ title: " readm3 — keys ", width: 52, height: 18 }, (m) => {
+                    m.keyValues([
+                        { label: "↑ ↓  j k", value: "move / scroll" },
+                        { label: "→ ← l h", value: "expand / collapse" },
+                        { label: "enter", value: "open file" },
+                        { label: "tab", value: "switch pane" },
+                        { label: "space / b", value: "page down / up" },
+                        { label: "g / G", value: "top / bottom" },
+                        { label: "/", value: "filter files" },
+                        { label: "esc", value: "clear filter" },
+                        { label: "r", value: "rescan and reload" },
+                        { label: "[ ]", value: "sidebar width" },
+                        { label: "?", value: "this help" },
+                        { label: "q / ctrl+c", value: "quit" },
+                    ], { labelColor: theme.accent, labelWidth: 14 });
+                    m.spacer(1);
+                    m.text("Any key closes.", { fg: theme.muted, align: "center" });
+                });
+            }
+        });
+        void height;
+    });
+    await app.start();
+}
+//# sourceMappingURL=viewer.js.map