hmr-serve 0.1.0

package/dist/server/plugin.js

@@ -0,0 +1,143 @@
+import { resolve, sep } from 'node:path';
+import { RendererRegistry } from './renderers/registry.js';
+import { SearchIndex } from './index/searchIndex.js';
+import { createWatchHandler } from './index/watcher.js';
+import { buildTree, extOf, isFile, listSupportedFiles, readFileText, toRelPosix } from './fs.js';
+import { HMR_UPDATE_EVENT, } from '../shared/types.js';
+/** Base path for all server API routes. */
+export const API_BASE = '/__hmrserve';
+function sendJson(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.statusCode = status;
+    res.setHeader('Content-Type', 'application/json; charset=utf-8');
+    res.setHeader('Cache-Control', 'no-store');
+    res.end(payload);
+}
+/** Resolve a client-supplied relative path against the served root, rejecting
+ *  anything that escapes it (traversal / absolute paths). Returns null if unsafe. */
+function safeResolve(targetDir, rel) {
+    if (!rel)
+        return null;
+    const abs = resolve(targetDir, rel);
+    if (abs !== targetDir && !abs.startsWith(targetDir + sep))
+        return null;
+    return abs;
+}
+function queryParam(req, key) {
+    const url = new URL(req.url ?? '', 'http://localhost');
+    return url.searchParams.get(key);
+}
+/**
+ * The hmr-serve Vite plugin. Owns the search index + file watcher and exposes
+ * the tree/file/raw/search endpoints. Content live-updates are pushed over
+ * Vite's own HMR websocket (a custom event) rather than a hand-rolled channel.
+ */
+export function hmrServePlugin(options) {
+    const targetDir = options.targetDir;
+    const registry = options.registry ?? new RendererRegistry();
+    const index = new SearchIndex();
+    return {
+        name: 'hmr-serve',
+        async configureServer(server) {
+            // 1. Initial index scan.
+            const files = await listSupportedFiles(targetDir, registry);
+            await Promise.all(files.map(async (rel) => {
+                const raw = await readFileText(resolve(targetDir, rel));
+                index.add(rel, extOf(rel), raw);
+            }));
+            // 2. Reuse Vite's chokidar watcher (single source of truth) for the target.
+            server.watcher.add(targetDir);
+            const emit = (update) => {
+                server.ws.send({ type: 'custom', event: HMR_UPDATE_EVENT, data: update });
+            };
+            const handlers = createWatchHandler({
+                index,
+                extOf,
+                isSupported: (ext) => registry.supports(ext),
+                readFile: (rel) => readFileText(resolve(targetDir, rel)),
+                emit,
+            });
+            const within = (abs) => abs === targetDir || abs.startsWith(targetDir + sep) ? toRelPosix(targetDir, abs) : null;
+            server.watcher.on('add', (abs) => {
+                const rel = within(abs);
+                if (rel)
+                    handlers.onAdd(rel);
+            });
+            server.watcher.on('change', (abs) => {
+                const rel = within(abs);
+                if (rel)
+                    handlers.onChange(rel);
+            });
+            server.watcher.on('unlink', (abs) => {
+                const rel = within(abs);
+                if (rel)
+                    handlers.onUnlink(rel);
+            });
+            server.httpServer?.once('close', () => handlers.dispose());
+            // 3. API routes.
+            server.middlewares.use(`${API_BASE}/tree`, (_req, res, next) => {
+                buildTree(targetDir, registry)
+                    .then((nodes) => {
+                    const body = { root: targetDir, nodes };
+                    sendJson(res, 200, body);
+                })
+                    .catch(next);
+            });
+            server.middlewares.use(`${API_BASE}/file`, (req, res, next) => {
+                const abs = safeResolve(targetDir, queryParam(req, 'path'));
+                if (!abs)
+                    return sendJson(res, 400, { error: 'invalid path' });
+                const rel = toRelPosix(targetDir, abs);
+                const ext = extOf(rel);
+                if (!registry.supports(ext))
+                    return sendJson(res, 415, { error: 'unsupported type' });
+                isFile(abs)
+                    .then((ok) => {
+                    if (!ok)
+                        return sendJson(res, 404, { error: 'not found' });
+                    return readFileText(abs).then((raw) => {
+                        const result = registry.render({ path: rel, ext, raw });
+                        const body = {
+                            path: rel,
+                            kind: result.kind,
+                            title: result.title,
+                            ...(result.kind === 'iframe'
+                                ? { iframeSrc: `${API_BASE}/raw?path=${encodeURIComponent(rel)}` }
+                                : { html: result.html }),
+                            ...(result.language ? { language: result.language } : {}),
+                        };
+                        sendJson(res, 200, body);
+                    });
+                })
+                    .catch(next);
+            });
+            server.middlewares.use(`${API_BASE}/raw`, (req, res, next) => {
+                const abs = safeResolve(targetDir, queryParam(req, 'path'));
+                if (!abs)
+                    return sendJson(res, 400, { error: 'invalid path' });
+                if (extOf(abs) !== 'html' && extOf(abs) !== 'htm') {
+                    return sendJson(res, 415, { error: 'raw only serves html' });
+                }
+                isFile(abs)
+                    .then((ok) => {
+                    if (!ok)
+                        return sendJson(res, 404, { error: 'not found' });
+                    return readFileText(abs).then((raw) => {
+                        res.statusCode = 200;
+                        res.setHeader('Content-Type', 'text/html; charset=utf-8');
+                        res.setHeader('X-Content-Type-Options', 'nosniff');
+                        res.setHeader('Cache-Control', 'no-store');
+                        res.end(raw);
+                    });
+                })
+                    .catch(next);
+            });
+            server.middlewares.use(`${API_BASE}/search`, (req, res) => {
+                const query = queryParam(req, 'q') ?? '';
+                const body = { query, hits: index.search(query) };
+                sendJson(res, 200, body);
+            });
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/server/plugin.js.map

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

package/dist/server/renderers/html.d.ts

@@ -0,0 +1,6 @@
+import type { Renderer } from './types.js';
+/** Raw HTML is presented in a sandboxed iframe by the client, so the renderer
+ *  itself only supplies metadata — the bytes are streamed by the /raw endpoint.
+ *  Kept separate from the markdown path so untrusted markup never lands in the
+ *  app-shell DOM. */
+export declare const htmlRenderer: Renderer;

package/dist/server/renderers/html.js

@@ -0,0 +1,15 @@
+import { basename } from 'node:path';
+/** Raw HTML is presented in a sandboxed iframe by the client, so the renderer
+ *  itself only supplies metadata — the bytes are streamed by the /raw endpoint.
+ *  Kept separate from the markdown path so untrusted markup never lands in the
+ *  app-shell DOM. */
+export const htmlRenderer = {
+    extensions: ['html', 'htm'],
+    render({ path }) {
+        return {
+            kind: 'iframe',
+            title: basename(path),
+        };
+    },
+};
+//# sourceMappingURL=html.js.map

package/dist/server/renderers/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../../src/server/renderers/html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC;;;qBAGqB;AACrB,MAAM,CAAC,MAAM,YAAY,GAAa;IACpC,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;IAC3B,MAAM,CAAC,EAAE,IAAI,EAAe;QAC1B,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;SACtB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/server/renderers/markdown.d.ts

@@ -0,0 +1,2 @@
+import type { Renderer } from './types.js';
+export declare const markdownRenderer: Renderer;

package/dist/server/renderers/markdown.js

@@ -0,0 +1,21 @@
+import MarkdownIt from 'markdown-it';
+import { basename } from 'node:path';
+const md = new MarkdownIt({ html: true, linkify: true, typographer: true });
+/** First ATX/setext heading text, else the file name. */
+function deriveTitle(raw, path) {
+    const atx = raw.match(/^#{1,6}\s+(.+?)\s*#*\s*$/m);
+    if (atx?.[1])
+        return atx[1].trim();
+    return basename(path);
+}
+export const markdownRenderer = {
+    extensions: ['md', 'markdown'],
+    render({ raw, path }) {
+        return {
+            kind: 'html',
+            html: md.render(raw),
+            title: deriveTitle(raw, path),
+        };
+    },
+};
+//# sourceMappingURL=markdown.js.map

package/dist/server/renderers/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/server/renderers/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAE5E,yDAAyD;AACzD,SAAS,WAAW,CAAC,GAAW,EAAE,IAAY;IAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACnD,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;IAC9B,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAe;QAC/B,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;YACpB,KAAK,EAAE,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/server/renderers/registry.d.ts

@@ -0,0 +1,19 @@
+import type { Renderer, RenderInput, RenderResult } from './types.js';
+/**
+ * Extension-keyed renderer dispatch. New file types register a `Renderer` here
+ * (or via `register`) without any change to the middleware or client routing —
+ * that decoupling is the whole point of the registry.
+ */
+export declare class RendererRegistry {
+    private readonly byExt;
+    constructor(renderers?: Renderer[]);
+    register(renderer: Renderer): void;
+    /** True if some renderer claims `ext` (lower-case, no dot). */
+    supports(ext: string): boolean;
+    supportedExtensions(): string[];
+    /** Dispatch to the matching renderer. Throws if none claims the extension —
+     *  callers gate on `supports()` first (the tree never surfaces others). */
+    render(input: RenderInput): RenderResult;
+}
+export declare const DEFAULT_RENDERERS: Renderer[];
+export type { Renderer, RenderInput, RenderResult } from './types.js';

package/dist/server/renderers/registry.js

@@ -0,0 +1,38 @@
+import { markdownRenderer } from './markdown.js';
+import { htmlRenderer } from './html.js';
+import { sourceRenderer } from './source.js';
+/**
+ * Extension-keyed renderer dispatch. New file types register a `Renderer` here
+ * (or via `register`) without any change to the middleware or client routing —
+ * that decoupling is the whole point of the registry.
+ */
+export class RendererRegistry {
+    byExt = new Map();
+    constructor(renderers = DEFAULT_RENDERERS) {
+        for (const renderer of renderers)
+            this.register(renderer);
+    }
+    register(renderer) {
+        for (const ext of renderer.extensions) {
+            this.byExt.set(ext.toLowerCase(), renderer);
+        }
+    }
+    /** True if some renderer claims `ext` (lower-case, no dot). */
+    supports(ext) {
+        return this.byExt.has(ext.toLowerCase());
+    }
+    supportedExtensions() {
+        return [...this.byExt.keys()];
+    }
+    /** Dispatch to the matching renderer. Throws if none claims the extension —
+     *  callers gate on `supports()` first (the tree never surfaces others). */
+    render(input) {
+        const renderer = this.byExt.get(input.ext.toLowerCase());
+        if (!renderer) {
+            throw new Error(`No renderer registered for extension: ${input.ext}`);
+        }
+        return renderer.render(input);
+    }
+}
+export const DEFAULT_RENDERERS = [markdownRenderer, htmlRenderer, sourceRenderer];
+//# sourceMappingURL=registry.js.map

package/dist/server/renderers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/server/renderers/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACV,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAErD,YAAY,YAAwB,iBAAiB;QACnD,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,QAAQ,CAAC,QAAkB;QACzB,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,QAAQ,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,mBAAmB;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;+EAC2E;IAC3E,MAAM,CAAC,KAAkB;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAe,CAAC,gBAAgB,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC"}

package/dist/server/renderers/source.d.ts

@@ -0,0 +1,4 @@
+import type { Renderer } from './types.js';
+/** Read-only syntax-highlighted view for source files. Highlighting runs here
+ *  on the server so the client bundle stays free of a highlighter. */
+export declare const sourceRenderer: Renderer;

package/dist/server/renderers/source.js

@@ -0,0 +1,29 @@
+import hljs from 'highlight.js';
+import { basename } from 'node:path';
+/** Maps our supported source extensions to highlight.js language ids.
+ *  `txt` has no language and is rendered as escaped plain text. */
+const LANGUAGE_BY_EXT = {
+    css: 'css',
+    txt: undefined,
+};
+function escapeHtml(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/** Read-only syntax-highlighted view for source files. Highlighting runs here
+ *  on the server so the client bundle stays free of a highlighter. */
+export const sourceRenderer = {
+    extensions: Object.keys(LANGUAGE_BY_EXT),
+    render({ raw, ext, path }) {
+        const language = LANGUAGE_BY_EXT[ext];
+        const inner = language && hljs.getLanguage(language)
+            ? hljs.highlight(raw, { language }).value
+            : escapeHtml(raw);
+        return {
+            kind: 'code',
+            html: `<pre class="hljs"><code>${inner}</code></pre>`,
+            language,
+            title: basename(path),
+        };
+    },
+};
+//# sourceMappingURL=source.js.map

package/dist/server/renderers/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/server/renderers/source.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,cAAc,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC;mEACmE;AACnE,MAAM,eAAe,GAAuC;IAC1D,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAClF,CAAC;AAED;sEACsE;AACtE,MAAM,CAAC,MAAM,cAAc,GAAa;IACtC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;IACxC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAe;QACpC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,KAAK,GACT,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;YACpC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK;YACzC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,2BAA2B,KAAK,eAAe;YACrD,QAAQ;YACR,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;SACtB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/server/renderers/types.d.ts

@@ -0,0 +1,20 @@
+import type { RenderKind } from '../../shared/types.js';
+export interface RenderInput {
+    /** Path relative to the served root, POSIX-separated. */
+    path: string;
+    /** Lower-case extension without the dot. */
+    ext: string;
+    /** Raw file contents. */
+    raw: string;
+}
+export interface RenderResult {
+    kind: RenderKind;
+    html?: string;
+    language?: string;
+    title: string;
+}
+export interface Renderer {
+    /** Lower-case extensions (no dot) this renderer claims. */
+    readonly extensions: readonly string[];
+    render(input: RenderInput): RenderResult;
+}

package/dist/server/renderers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/renderers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server/renderers/types.ts"],"names":[],"mappings":""}

package/dist/shared/types.d.ts

@@ -0,0 +1,52 @@
+/** How the client should present a file's rendered content. */
+export type RenderKind = 'html' | 'iframe' | 'code';
+/** A node in the file tree. Directories carry `children`; files carry `ext`. */
+export interface FileNode {
+    /** Path relative to the served root, POSIX-separated (e.g. `docs/intro.md`). */
+    path: string;
+    /** Base name for display (e.g. `intro.md`). */
+    name: string;
+    type: 'file' | 'directory';
+    /** Lower-case extension without the dot (e.g. `md`). Files only. */
+    ext?: string;
+    /** Present on directories; sorted dirs-first then alphabetically. */
+    children?: FileNode[];
+}
+export interface TreeResponse {
+    root: string;
+    nodes: FileNode[];
+}
+/** Server-rendered content for a single file, returned by `/file`. */
+export interface RenderedFile {
+    path: string;
+    kind: RenderKind;
+    /** Rendered HTML for `html`/`code` kinds. Absent for `iframe`. */
+    html?: string;
+    /** URL the client should point a sandboxed iframe at, for `iframe` kind. */
+    iframeSrc?: string;
+    /** Highlight.js language for `code` kind, when detected. */
+    language?: string;
+    title: string;
+}
+export interface SearchHit {
+    path: string;
+    title: string;
+    /** A short excerpt around the first match, plain text. */
+    snippet: string;
+    score: number;
+}
+export interface SearchResponse {
+    query: string;
+    hits: SearchHit[];
+}
+/** Payload pushed over Vite's HMR channel when a watched file changes. */
+export interface HmrServeUpdate {
+    event: 'add' | 'change' | 'unlink';
+    path: string;
+}
+/** The custom HMR event name the client subscribes to via `import.meta.hot`. */
+export declare const HMR_UPDATE_EVENT = "hmr-serve:update";
+/** Extensions the tool renders at launch. Central so the tree filter, the
+ *  renderer registry, and the indexer agree on one source of truth. */
+export declare const SUPPORTED_EXTENSIONS: readonly ["md", "html", "css", "txt"];
+export type SupportedExtension = (typeof SUPPORTED_EXTENSIONS)[number];

package/dist/shared/types.js

@@ -0,0 +1,8 @@
+// Types shared across the Node server and the Vue client. Kept dependency-free
+// so both the `node` and `vite/client` type environments can import it.
+/** The custom HMR event name the client subscribes to via `import.meta.hot`. */
+export const HMR_UPDATE_EVENT = 'hmr-serve:update';
+/** Extensions the tool renders at launch. Central so the tree filter, the
+ *  renderer registry, and the indexer agree on one source of truth. */
+export const SUPPORTED_EXTENSIONS = ['md', 'html', 'css', 'txt'];
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wEAAwE;AAuDxE,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAEnD;uEACuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "hmr-serve",
+  "version": "0.1.0",
+  "description": "Point at any folder and review it live in the browser — VSCode-style file tree + content pane, powered by Vite's dev server and HMR client.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "vite",
+    "hmr",
+    "markdown",
+    "preview",
+    "cli",
+    "dev-server",
+    "documentation"
+  ],
+  "bin": {
+    "hmr-serve": "bin/hmr-serve.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "src/client",
+    "src/shared"
+  ],
+  "engines": {
+    "node": ">=20.11.0"
+  },
+  "packageManager": "pnpm@11.11.0",
+  "scripts": {
+    "dev": "tsx src/cli/index.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "pnpm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit && vue-tsc -p tsconfig.client.json --noEmit",
+    "lint": "eslint . && prettier --check .",
+    "format": "prettier --write .",
+    "test": "vitest run",
+    "test:unit": "vitest run tests/unit tests/component",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "test:e2e:install": "playwright install --with-deps chromium"
+  },
+  "dependencies": {
+    "@vitejs/plugin-vue": "^5.2.1",
+    "cac": "^6.7.14",
+    "highlight.js": "^11.10.0",
+    "markdown-it": "^14.1.0",
+    "minisearch": "^7.1.1",
+    "vite": "^7.0.0",
+    "vue": "^3.5.13"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^22.10.5",
+    "@typescript-eslint/eslint-plugin": "^8.19.1",
+    "@typescript-eslint/parser": "^8.19.1",
+    "@vue/test-utils": "^2.4.6",
+    "@playwright/test": "^1.49.1",
+    "eslint": "^9.17.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-vue": "^9.32.0",
+    "jsdom": "^25.0.1",
+    "prettier": "^3.4.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.19.1",
+    "vue-eslint-parser": "^9.4.3",
+    "vue-tsc": "^2.2.0",
+    "vitest": "^2.1.8"
+  }
+}

package/src/client/App.vue

@@ -0,0 +1,101 @@
+<template>
+  <div class="app">
+    <header class="topbar">
+      <span class="brand">hmr-serve</span>
+      <search-box v-model="query" />
+    </header>
+    <div class="body">
+      <aside class="sidebar">
+        <ul v-if="query.trim()" class="search-results" data-testid="search-results">
+          <li v-if="hits.length === 0" class="empty" data-testid="search-empty">No matches</li>
+          <li
+            v-for="hit in hits"
+            :key="hit.path"
+            class="search-hit"
+            data-testid="search-hit"
+            :data-path="hit.path"
+            :class="{ selected: hit.path === selectedPath }"
+            @click="select(hit.path)"
+          >
+            <span class="hit-title">{{ hit.title }}</span>
+            <span class="hit-snippet">{{ hit.snippet }}</span>
+          </li>
+        </ul>
+        <file-tree v-else :nodes="tree" :selected-path="selectedPath" @select="select" />
+      </aside>
+      <main class="main">
+        <content-pane :path="selectedPath" />
+      </main>
+    </div>
+  </div>
+</template>
+
+<script lang="ts">
+import { defineComponent } from 'vue';
+import type { FileNode, SearchHit } from '../shared/types';
+import { fetchTree, search } from './api';
+import { onFileUpdate } from './hmr';
+import FileTree from './components/FileTree.vue';
+import ContentPane from './components/ContentPane.vue';
+import SearchBox from './components/SearchBox.vue';
+
+interface AppData {
+  tree: FileNode[];
+  selectedPath: string | null;
+  query: string;
+  hits: SearchHit[];
+  searchTimer: ReturnType<typeof setTimeout> | null;
+  unsubscribe: (() => void) | null;
+}
+
+export default defineComponent({
+  name: 'App',
+  components: { FileTree, ContentPane, SearchBox },
+  data(): AppData {
+    return {
+      tree: [],
+      selectedPath: null,
+      query: '',
+      hits: [],
+      searchTimer: null,
+      unsubscribe: null,
+    };
+  },
+  watch: {
+    query(): void {
+      // Debounce so each keystroke doesn't hit the server.
+      if (this.searchTimer) clearTimeout(this.searchTimer);
+      this.searchTimer = setTimeout(() => void this.runSearch(), 120);
+    },
+  },
+  async mounted(): Promise<void> {
+    await this.loadTree();
+    // Structural changes (add/unlink) reshape the tree; a change may alter a
+    // file's searchable text. Refresh both so the nav and results stay live.
+    this.unsubscribe = onFileUpdate((update) => {
+      if (update.event !== 'change') void this.loadTree();
+      if (this.query.trim()) void this.runSearch();
+    });
+  },
+  beforeUnmount(): void {
+    this.unsubscribe?.();
+    if (this.searchTimer) clearTimeout(this.searchTimer);
+  },
+  methods: {
+    async loadTree(): Promise<void> {
+      this.tree = (await fetchTree()).nodes;
+    },
+    async runSearch(): Promise<void> {
+      const q = this.query.trim();
+      if (!q) {
+        this.hits = [];
+        return;
+      }
+      this.hits = (await search(q)).hits;
+    },
+    select(path: string): void {
+      this.selectedPath = path;
+    },
+  },
+});
+</script>

package/src/client/api.ts

@@ -0,0 +1,23 @@
+import type { RenderedFile, SearchResponse, TreeResponse } from '../shared/types.js';
+
+const API_BASE = '/__hmrserve';
+
+async function getJson<T>(url: string): Promise<T> {
+  const res = await fetch(url, { headers: { Accept: 'application/json' } });
+  if (!res.ok) {
+    throw new Error(`Request failed (${res.status}): ${url}`);
+  }
+  return (await res.json()) as T;
+}
+
+export function fetchTree(): Promise<TreeResponse> {
+  return getJson<TreeResponse>(`${API_BASE}/tree`);
+}
+
+export function fetchFile(path: string): Promise<RenderedFile> {
+  return getJson<RenderedFile>(`${API_BASE}/file?path=${encodeURIComponent(path)}`);
+}
+
+export function search(query: string): Promise<SearchResponse> {
+  return getJson<SearchResponse>(`${API_BASE}/search?q=${encodeURIComponent(query)}`);
+}