hmr-serve 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Blair Googer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# hmr-serve
+
+<!-- Add once CI is green:
+[![CI](https://github.com/<owner>/hmr-serve/actions/workflows/ci.yml/badge.svg)](https://github.com/<owner>/hmr-serve/actions/workflows/ci.yml)
+-->
+
+Point `hmr-serve` at any folder and review it live in the browser: a VSCode-style
+file tree on the left, a content pane on the right, and **instant updates as files
+change on disk** — powered by Vite's real dev server and HMR client, not a
+hand-rolled watcher/websocket.
+
+Built for reviewing AI-agent output (markdown/HTML docs) as it iterates.
+
+```bash
+npx hmr-serve ./some-folder
+# → opens http://localhost:5183 with a live tree + content pane
+```
+
+## Quickstart
+
+```bash
+# from a clone
+pnpm install
+pnpm dev ./fixtures      # serve the sample folder
+```
+
+CLI:
+
+```
+hmr-serve [dir]        Folder to serve (default: current directory)
+  --port <port>        Port to listen on (default: 5183)
+  --open               Open the browser on start
+```
+
+Supported file types at launch: `.md` (rendered), `.html` (sandboxed iframe),
+`.css` / `.txt` (read-only syntax-highlighted source).
+
+## Architecture
+
+1. **No build step for your content.** Runs in Vite dev-server mode only. The app
+   shell (a tiny Vue UI) is Vite's root; your folder is mounted alongside it via
+   middleware + `server.fs.allow`. Your files _are_ the content — nothing is compiled.
+2. **Live search index.** Built at startup with [MiniSearch](https://github.com/lucaong/minisearch)
+   (no native deps) and kept current incrementally off file-watch events — no rebuild step.
+3. **Plain HTTP + WebSocket, cross-browser.** The browser only talks to the Node
+   server over HTTP and Vite's HMR socket. No File System Access API, no
+   Chromium-only APIs — works in Safari and Firefox.
+4. **Extensible renderer registry.** `.md` → `markdown-it`; `.html` → sandboxed
+   iframe; `.css`/`.txt` → server-side `highlight.js`. New types register in
+   `src/server/renderers/` without touching routing.
+5. **Vue 3, Options API only.** Deliberately no Composition API / `<script setup>`,
+   and no component library — the client stays minimal.
+6. **Lightweight CLI** via [`cac`](https://github.com/cacjs/cac): `<path>`, `--port`, `--open`.
+
+Live content updates ride Vite's HMR channel: the server pushes a custom
+`hmr-serve:update` event and the content pane re-fetches — so Vite's client
+handles transport and reconnection for us.
+
+```
+src/
+  cli/       arg parsing + entry
+  server/    Vite plugin, middleware, search index, watcher, renderers
+  client/    Vue app shell (tree + content pane)
+  shared/    types shared across server and client
+fixtures/    versioned sample files used by tests
+tests/       unit · component · e2e
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for local setup and test expectations.
+
+## License
+
+[MIT](./LICENSE)

package/bin/hmr-serve.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+// Published entry point. Invokes the compiled CLI directly rather than relying
+// on import-time self-execution detection, which is unreliable when launched
+// through npm's .bin symlink (argv[1] is the symlink, not this file).
+import { run } from '../dist/cli/index.js';
+
+run(process.argv.slice(2)).catch((error) => {
+  console.error(`\n  ${error instanceof Error ? error.message : String(error)}\n`);
+  process.exitCode = 1;
+});

package/dist/cli/index.d.ts

@@ -0,0 +1,11 @@
+export interface ParsedArgs {
+    targetDir: string;
+    port?: number;
+    open: boolean;
+}
+/** Pure arg parsing, split out so it can be unit-tested without a live server.
+ *  Throws `Error` with a user-facing message on invalid input. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** Validate the target is an existing directory. Throws on failure. */
+export declare function assertDirectory(targetDir: string): void;
+export declare function run(argv: string[]): Promise<void>;

package/dist/cli/index.js

@@ -0,0 +1,62 @@
+import { statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { cac } from 'cac';
+import { createServer } from '../server/createServer.js';
+/** Pure arg parsing, split out so it can be unit-tested without a live server.
+ *  Throws `Error` with a user-facing message on invalid input. */
+export function parseArgs(argv) {
+    const cli = cac('hmr-serve');
+    cli
+        .command('[dir]', 'Serve a folder with a live file tree + content pane')
+        .option('--port <port>', 'Port to listen on', { default: 5183 })
+        .option('--open', 'Open the browser on start', { default: false });
+    cli.help();
+    const parsed = cli.parse(['node', 'hmr-serve', ...argv], { run: false });
+    const dir = parsed.args[0] ?? '.';
+    const port = Number(parsed.options.port);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new Error(`Invalid --port: ${parsed.options.port}`);
+    }
+    return {
+        targetDir: resolve(process.cwd(), dir),
+        port,
+        open: Boolean(parsed.options.open),
+    };
+}
+/** Validate the target is an existing directory. Throws on failure. */
+export function assertDirectory(targetDir) {
+    let stat;
+    try {
+        stat = statSync(targetDir);
+    }
+    catch {
+        throw new Error(`Folder does not exist: ${targetDir}`);
+    }
+    if (!stat.isDirectory()) {
+        throw new Error(`Not a directory: ${targetDir}`);
+    }
+}
+export async function run(argv) {
+    const args = parseArgs(argv);
+    assertDirectory(args.targetDir);
+    const server = await createServer({
+        targetDir: args.targetDir,
+        port: args.port,
+        open: args.open,
+    });
+    await server.listen();
+    const info = server.resolvedUrls?.local[0] ?? `http://localhost:${args.port}/`;
+    console.log(`\n  hmr-serve → serving ${args.targetDir}\n  ${info}\n`);
+}
+// Self-execute only when this module is the directly-run script (e.g.
+// `tsx src/cli/index.ts` in dev/e2e, or `node dist/cli/index.js`). The published
+// `bin` shim imports and calls `run()` itself, so it does not match here — which
+// keeps the tool from starting twice.
+const invokedPath = process.argv[1] ? resolve(process.argv[1]) : '';
+if (import.meta.url === `file://${invokedPath}`) {
+    run(process.argv.slice(2)).catch((error) => {
+        console.error(`\n  ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/server/createServer.d.ts

@@ -0,0 +1,15 @@
+import { type ViteDevServer } from 'vite';
+export interface CreateServerOptions {
+    /** Folder to serve. Resolved to an absolute path if relative. */
+    targetDir: string;
+    port?: number;
+    /** Open the browser once listening. */
+    open?: boolean;
+    host?: string;
+}
+/**
+ * Build (but do not start) a Vite dev server whose root is our app shell, with
+ * the target folder mounted via {@link hmrServePlugin}. Call `.listen()` on the
+ * returned server to start it.
+ */
+export declare function createServer(options: CreateServerOptions): Promise<ViteDevServer>;

package/dist/server/createServer.js

@@ -0,0 +1,41 @@
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { createServer as createViteServer } from 'vite';
+import vue from '@vitejs/plugin-vue';
+import { hmrServePlugin } from './plugin.js';
+/** Absolute path to the shipped Vue app shell (`src/client`), resolved relative
+ *  to this module so it works both from `src` (tsx/dev) and `dist` (published). */
+function resolveClientRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    // src/server/createServer.ts → ../client ; dist/server/createServer.js → ../../src/client
+    const fromSrc = resolve(here, '../client');
+    const fromDist = resolve(here, '../../src/client');
+    return existsSync(fromSrc) ? fromSrc : fromDist;
+}
+/**
+ * Build (but do not start) a Vite dev server whose root is our app shell, with
+ * the target folder mounted via {@link hmrServePlugin}. Call `.listen()` on the
+ * returned server to start it.
+ */
+export async function createServer(options) {
+    const targetDir = resolve(process.cwd(), options.targetDir);
+    const clientRoot = resolveClientRoot();
+    // The package root (…/src/client → package) holds the shell, shared types and
+    // node_modules; the target folder lives anywhere. Both must be fs-allowed.
+    const packageRoot = resolve(clientRoot, '../..');
+    return createViteServer({
+        root: clientRoot,
+        configFile: false,
+        plugins: [vue(), hmrServePlugin({ targetDir })],
+        server: {
+            port: options.port ?? 5183,
+            host: options.host,
+            open: options.open ?? false,
+            fs: { allow: [packageRoot, targetDir] },
+        },
+        // The app shell is tiny and self-contained; no user config should leak in.
+        envFile: false,
+    });
+}
+//# sourceMappingURL=createServer.js.map

package/dist/server/createServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createServer.js","sourceRoot":"","sources":["../../src/server/createServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAsB,MAAM,MAAM,CAAC;AAC5E,OAAO,GAAG,MAAM,oBAAoB,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAW7C;mFACmF;AACnF,SAAS,iBAAiB;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,0FAA0F;IAC1F,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,8EAA8E;IAC9E,2EAA2E;IAC3E,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEjD,OAAO,gBAAgB,CAAC;QACtB,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/C,MAAM,EAAE;YACN,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;YAC3B,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE;SACxC;QACD,2EAA2E;QAC3E,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/server/fs.d.ts

@@ -0,0 +1,17 @@
+import type { FileNode } from '../shared/types.js';
+import type { RendererRegistry } from './renderers/registry.js';
+/** Lower-case extension without the dot; '' when there is none. */
+export declare function extOf(name: string): string;
+/** Absolute path → root-relative, POSIX-separated path used everywhere in the API. */
+export declare function toRelPosix(root: string, abs: string): string;
+export declare function readFileText(abs: string): Promise<string>;
+/**
+ * Recursively build the file tree, keeping only directories and files whose
+ * extension the registry supports. Directories that end up empty are pruned so
+ * the nav doesn't show dead branches. Entries are sorted dirs-first, then by name.
+ */
+export declare function buildTree(root: string, registry: RendererRegistry): Promise<FileNode[]>;
+/** Collect every supported file (root-relative paths) for the initial index scan. */
+export declare function listSupportedFiles(root: string, registry: RendererRegistry): Promise<string[]>;
+/** Whether `abs` resolves to a real file (used to guard endpoint reads). */
+export declare function isFile(abs: string): Promise<boolean>;

package/dist/server/fs.js

@@ -0,0 +1,102 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+/** Lower-case extension without the dot; '' when there is none. */
+export function extOf(name) {
+    const dot = name.lastIndexOf('.');
+    if (dot <= 0)
+        return '';
+    return name.slice(dot + 1).toLowerCase();
+}
+/** Absolute path → root-relative, POSIX-separated path used everywhere in the API. */
+export function toRelPosix(root, abs) {
+    return relative(root, abs).split(sep).join('/');
+}
+/** Directories skipped during the tree walk and initial index scan. */
+const IGNORED_DIRS = new Set(['.git', 'node_modules', '.vite', 'dist', '.DS_Store']);
+export async function readFileText(abs) {
+    return readFile(abs, 'utf8');
+}
+/**
+ * Recursively build the file tree, keeping only directories and files whose
+ * extension the registry supports. Directories that end up empty are pruned so
+ * the nav doesn't show dead branches. Entries are sorted dirs-first, then by name.
+ */
+export async function buildTree(root, registry) {
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return [];
+        }
+        const nodes = [];
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || IGNORED_DIRS.has(entry.name))
+                continue;
+            const abs = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const children = await walk(abs);
+                if (children.length > 0) {
+                    nodes.push({
+                        path: toRelPosix(root, abs),
+                        name: entry.name,
+                        type: 'directory',
+                        children,
+                    });
+                }
+            }
+            else if (entry.isFile()) {
+                const ext = extOf(entry.name);
+                if (registry.supports(ext)) {
+                    nodes.push({ path: toRelPosix(root, abs), name: entry.name, type: 'file', ext });
+                }
+            }
+        }
+        return sortNodes(nodes);
+    }
+    return walk(root);
+}
+function sortNodes(nodes) {
+    return nodes.sort((a, b) => {
+        if (a.type !== b.type)
+            return a.type === 'directory' ? -1 : 1;
+        return a.name.localeCompare(b.name);
+    });
+}
+/** Collect every supported file (root-relative paths) for the initial index scan. */
+export async function listSupportedFiles(root, registry) {
+    const out = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || IGNORED_DIRS.has(entry.name))
+                continue;
+            const abs = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(abs);
+            }
+            else if (entry.isFile() && registry.supports(extOf(entry.name))) {
+                out.push(toRelPosix(root, abs));
+            }
+        }
+    }
+    await walk(root);
+    return out;
+}
+/** Whether `abs` resolves to a real file (used to guard endpoint reads). */
+export async function isFile(abs) {
+    try {
+        return (await stat(abs)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/server/fs.js.map

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

package/dist/server/index/searchIndex.d.ts

@@ -0,0 +1,17 @@
+import type { SearchHit } from '../../shared/types.js';
+/**
+ * Thin MiniSearch wrapper the watcher drives incrementally: `add` on discovery,
+ * `update` on change (replace-in-place), `remove` on unlink. No rebuild step.
+ */
+export declare class SearchIndex {
+    private readonly engine;
+    /** Retains raw content per id so we can build snippets at query time. */
+    private readonly content;
+    constructor();
+    private toDoc;
+    add(path: string, ext: string, raw: string): void;
+    update(path: string, ext: string, raw: string): void;
+    remove(path: string): void;
+    get size(): number;
+    search(query: string, limit?: number): SearchHit[];
+}

package/dist/server/index/searchIndex.js

@@ -0,0 +1,98 @@
+import MiniSearch from 'minisearch';
+/** Strip HTML tags so markup files index on their visible text, not attributes. */
+function extractText(ext, raw) {
+    if (ext === 'html' || ext === 'htm') {
+        return raw
+            .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+            .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+            .replace(/<[^>]+>/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+    }
+    return raw;
+}
+/** First markdown/heading line or the path, used as the hit title. */
+function deriveTitle(path, raw) {
+    const heading = raw.match(/^#{1,6}\s+(.+?)\s*#*\s*$/m);
+    if (heading?.[1])
+        return heading[1].trim();
+    return path;
+}
+function makeSnippet(content, query) {
+    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+    const lower = content.toLowerCase();
+    let at = -1;
+    for (const term of terms) {
+        const found = lower.indexOf(term);
+        if (found !== -1 && (at === -1 || found < at))
+            at = found;
+    }
+    if (at === -1)
+        return content.slice(0, 120).trim();
+    const start = Math.max(0, at - 40);
+    const end = Math.min(content.length, at + 80);
+    return `${start > 0 ? '…' : ''}${content.slice(start, end).trim()}${end < content.length ? '…' : ''}`;
+}
+/**
+ * Thin MiniSearch wrapper the watcher drives incrementally: `add` on discovery,
+ * `update` on change (replace-in-place), `remove` on unlink. No rebuild step.
+ */
+export class SearchIndex {
+    engine;
+    /** Retains raw content per id so we can build snippets at query time. */
+    content = new Map();
+    constructor() {
+        this.engine = new MiniSearch({
+            fields: ['title', 'content'],
+            storeFields: ['title'],
+            searchOptions: { boost: { title: 2 }, prefix: true, fuzzy: 0.2 },
+        });
+    }
+    toDoc(path, ext, raw) {
+        return { id: path, title: deriveTitle(path, raw), content: extractText(ext, raw) };
+    }
+    add(path, ext, raw) {
+        if (this.content.has(path)) {
+            this.update(path, ext, raw);
+            return;
+        }
+        const doc = this.toDoc(path, ext, raw);
+        this.engine.add(doc);
+        this.content.set(path, doc.content);
+    }
+    update(path, ext, raw) {
+        if (!this.content.has(path)) {
+            this.add(path, ext, raw);
+            return;
+        }
+        const doc = this.toDoc(path, ext, raw);
+        // MiniSearch requires the *old* doc to discard; `replace` handles that when
+        // the id matches, but we guard with a manual remove for older versions.
+        this.engine.replace(doc);
+        this.content.set(path, doc.content);
+    }
+    remove(path) {
+        if (!this.content.has(path))
+            return;
+        this.engine.discard(path);
+        this.content.delete(path);
+    }
+    get size() {
+        return this.content.size;
+    }
+    search(query, limit = 20) {
+        const trimmed = query.trim();
+        if (!trimmed)
+            return [];
+        return this.engine
+            .search(trimmed)
+            .slice(0, limit)
+            .map((result) => ({
+            path: result.id,
+            title: result.title,
+            snippet: makeSnippet(this.content.get(result.id) ?? '', trimmed),
+            score: result.score,
+        }));
+    }
+}
+//# sourceMappingURL=searchIndex.js.map

package/dist/server/index/searchIndex.js.map

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

package/dist/server/index/watcher.d.ts

@@ -0,0 +1,31 @@
+import type { SearchIndex } from './searchIndex.js';
+import type { HmrServeUpdate } from '../../shared/types.js';
+export interface WatchHandlerOptions {
+    index: SearchIndex;
+    /** Lower-case extension without the dot, given a root-relative path. */
+    extOf: (path: string) => string;
+    /** True if some renderer supports the extension. */
+    isSupported: (ext: string) => boolean;
+    /** Read a file's text given its root-relative path. */
+    readFile: (path: string) => Promise<string>;
+    /** Push an HMR update to connected clients. */
+    emit: (update: HmrServeUpdate) => void;
+    /** Coalesce rapid successive changes to the same file. Default 40ms. */
+    debounceMs?: number;
+}
+export interface WatchHandlers {
+    onAdd(path: string): void;
+    onChange(path: string): void;
+    onUnlink(path: string): void;
+    /** Force-run any pending debounced work immediately (used by tests). */
+    flush(): Promise<void>;
+    /** Cancel pending timers (used on server close). */
+    dispose(): void;
+}
+/**
+ * Pure watch-event logic, decoupled from Vite/chokidar so it can be unit-tested
+ * with injected `readFile`/`emit`. `add`/`change` are debounced per path (an
+ * editor save often fires several writes); `unlink` is applied immediately so a
+ * deleted file can't linger in the index behind a pending change.
+ */
+export declare function createWatchHandler(options: WatchHandlerOptions): WatchHandlers;

package/dist/server/index/watcher.js

@@ -0,0 +1,75 @@
+/**
+ * Pure watch-event logic, decoupled from Vite/chokidar so it can be unit-tested
+ * with injected `readFile`/`emit`. `add`/`change` are debounced per path (an
+ * editor save often fires several writes); `unlink` is applied immediately so a
+ * deleted file can't linger in the index behind a pending change.
+ */
+export function createWatchHandler(options) {
+    const { index, extOf, isSupported, readFile, emit, debounceMs = 40 } = options;
+    const timers = new Map();
+    const pending = new Map();
+    async function apply(path) {
+        const kind = pending.get(path);
+        pending.delete(path);
+        timers.delete(path);
+        if (!kind)
+            return;
+        const ext = extOf(path);
+        if (!isSupported(ext))
+            return;
+        let raw;
+        try {
+            raw = await readFile(path);
+        }
+        catch {
+            // File vanished between event and read — treat as no-op; an unlink will follow.
+            return;
+        }
+        if (kind === 'add')
+            index.add(path, ext, raw);
+        else
+            index.update(path, ext, raw);
+        emit({ event: kind, path });
+    }
+    function schedule(path, kind) {
+        if (!isSupported(extOf(path)))
+            return;
+        // An 'add' already queued should win over a later 'change' for the same tick.
+        if (!(pending.get(path) === 'add' && kind === 'change'))
+            pending.set(path, kind);
+        const existing = timers.get(path);
+        if (existing)
+            clearTimeout(existing);
+        timers.set(path, setTimeout(() => void apply(path), debounceMs));
+    }
+    return {
+        onAdd(path) {
+            schedule(path, 'add');
+        },
+        onChange(path) {
+            schedule(path, 'change');
+        },
+        onUnlink(path) {
+            const timer = timers.get(path);
+            if (timer)
+                clearTimeout(timer);
+            timers.delete(path);
+            pending.delete(path);
+            if (!isSupported(extOf(path)))
+                return;
+            index.remove(path);
+            emit({ event: 'unlink', path });
+        },
+        async flush() {
+            const paths = [...pending.keys()];
+            await Promise.all(paths.map((p) => apply(p)));
+        },
+        dispose() {
+            for (const timer of timers.values())
+                clearTimeout(timer);
+            timers.clear();
+            pending.clear();
+        },
+    };
+}
+//# sourceMappingURL=watcher.js.map

package/dist/server/index/watcher.js.map

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

package/dist/server/plugin.d.ts

@@ -0,0 +1,15 @@
+import type { Plugin } from 'vite';
+import { RendererRegistry } from './renderers/registry.js';
+/** Base path for all server API routes. */
+export declare const API_BASE = "/__hmrserve";
+export interface HmrServePluginOptions {
+    /** Absolute path to the folder being served. */
+    targetDir: string;
+    registry?: RendererRegistry;
+}
+/**
+ * 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 declare function hmrServePlugin(options: HmrServePluginOptions): Plugin;