@pruddiman/mdmirror 0.1.0

package/dist/render/mermaid.js

@@ -0,0 +1,66 @@
+/**
+ * Mermaid diagram rehype plugin.
+ * Detects fenced code blocks with lang="mermaid" and replaces them
+ * with <pre class="mermaid"> elements for client-side rendering.
+ */
+import { visit } from "unist-util-visit";
+/**
+ * Rehype plugin that transforms mermaid code blocks into renderable elements.
+ * Converts: <pre><code class="language-mermaid">...</code></pre>
+ * Into: <pre class="mermaid">...</pre>
+ */
+export const rehypeMermaid = () => {
+    return (tree) => {
+        visit(tree, "element", (node, _index, _parent) => {
+            // Look for <pre><code class="language-mermaid">...</code></pre>
+            if (node.tagName === "pre" &&
+                node.children.length === 1 &&
+                isElement(node.children[0]) &&
+                node.children[0].tagName === "code") {
+                const codeNode = node.children[0];
+                const className = getClassName(codeNode);
+                if (className && className.includes("language-mermaid")) {
+                    // Extract the raw text content from the code block
+                    const textContent = getTextContent(codeNode);
+                    // Replace the <pre><code> with <pre class="mermaid">
+                    node.properties = { className: ["mermaid"] };
+                    node.children = [
+                        {
+                            type: "text",
+                            value: textContent,
+                        },
+                    ];
+                }
+            }
+        });
+    };
+};
+function isElement(node) {
+    return (typeof node === "object" &&
+        node !== null &&
+        "type" in node &&
+        node.type === "element");
+}
+function getClassName(node) {
+    const classes = node.properties?.className;
+    if (Array.isArray(classes)) {
+        return classes.join(" ");
+    }
+    if (typeof classes === "string") {
+        return classes;
+    }
+    return null;
+}
+function getTextContent(node) {
+    let text = "";
+    for (const child of node.children) {
+        if (child.type === "text") {
+            text += child.value;
+        }
+        else if ("children" in child) {
+            text += getTextContent(child);
+        }
+    }
+    return text;
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/render/mermaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../src/render/mermaid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAIzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAqB,GAAG,EAAE;IAClD,OAAO,CAAC,IAAU,EAAE,EAAE;QACpB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,IAAa,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACxD,gEAAgE;YAChE,IACE,IAAI,CAAC,OAAO,KAAK,KAAK;gBACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAC1B,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC3B,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,EACnC,CAAC;gBACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAY,CAAC;gBAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;gBAEzC,IAAI,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBACxD,mDAAmD;oBACnD,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;oBAE7C,qDAAqD;oBACrD,IAAI,CAAC,UAAU,GAAG,EAAE,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC7C,IAAI,CAAC,QAAQ,GAAG;wBACd;4BACE,IAAI,EAAE,MAAM;4BACZ,KAAK,EAAE,WAAW;yBACX;qBACV,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,SAAS,SAAS,CAAC,IAAa;IAC9B,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,MAAM,IAAI,IAAI;QACb,IAAgB,CAAC,IAAI,KAAK,SAAS,CACrC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAa;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,IAAa;IACnC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,IAAI,IAAK,KAAc,CAAC,KAAK,CAAC;QAChC,CAAC;aAAM,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,cAAc,CAAC,KAAgB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/render/pipeline.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Markdown rendering pipeline.
+ * Configures unified processor with remark/rehype plugins.
+ * Includes Shiki syntax highlighting, Mermaid block transformation,
+ * and relative link rewriting.
+ */
+/** Fields extracted from YAML front matter */
+export interface FrontMatter {
+    title?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * Extract YAML front matter from markdown content.
+ * Returns parsed fields and the content with the front matter block stripped.
+ */
+export declare function extractFrontMatter(content: string): {
+    frontMatter: FrontMatter;
+    body: string;
+};
+/**
+ * Render markdown content to HTML.
+ */
+export declare function renderMarkdown(content: string): Promise<string>;
+/**
+ * Render a .txt file to HTML by wrapping in <pre> tags.
+ */
+export declare function renderText(content: string): string;
+/**
+ * Render content based on file type.
+ */
+export declare function renderContent(content: string, fileType: "md" | "txt"): Promise<string>;

package/dist/render/pipeline.js

@@ -0,0 +1,141 @@
+/**
+ * Markdown rendering pipeline.
+ * Configures unified processor with remark/rehype plugins.
+ * Includes Shiki syntax highlighting, Mermaid block transformation,
+ * and relative link rewriting.
+ */
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkGfm from "remark-gfm";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkExtractFrontmatter from "remark-extract-frontmatter";
+import remarkRehype from "remark-rehype";
+import rehypeStringify from "rehype-stringify";
+import rehypeRaw from "rehype-raw";
+import rehypeShiki from "@shikijs/rehype";
+import { parse as parseYaml } from "yaml";
+import { visit } from "unist-util-visit";
+import { rehypeMermaid } from "./mermaid.js";
+/** Front matter regex — matches the leading --- block */
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/;
+/**
+ * Extract YAML front matter from markdown content.
+ * Returns parsed fields and the content with the front matter block stripped.
+ */
+export function extractFrontMatter(content) {
+    const match = content.match(FRONTMATTER_RE);
+    if (!match)
+        return { frontMatter: {}, body: content };
+    let parsed = {};
+    try {
+        parsed = parseYaml(match[1]) ?? {};
+    }
+    catch {
+        // Malformed YAML — ignore, treat as no front matter
+    }
+    return {
+        frontMatter: parsed,
+        body: content.slice(match[0].length),
+    };
+}
+/**
+ * Custom rehype plugin to rewrite relative .md/.txt links to their slug paths.
+ * Converts href="./getting-started.md" to href="/getting-started"
+ * Converts href="../intro.md" to the resolved path.
+ */
+const rehypeRewriteLinks = () => {
+    return (tree) => {
+        visit(tree, "element", (node) => {
+            if (node.tagName === "a" && node.properties?.href) {
+                const href = String(node.properties.href);
+                // Only rewrite relative links to .md or .txt files
+                if (!href.startsWith("http://") &&
+                    !href.startsWith("https://") &&
+                    !href.startsWith("//") &&
+                    !href.startsWith("#") &&
+                    (href.endsWith(".md") || href.endsWith(".txt"))) {
+                    // Strip extension and convert to slug-like path
+                    const withoutExt = href.replace(/\.(md|txt)$/, "");
+                    // Normalize path separators and handle ./prefix
+                    let normalized = withoutExt.replace(/\\/g, "/").replace(/^\.\//, "");
+                    // Handle index/readme files
+                    if (normalized.endsWith("/index") ||
+                        normalized.endsWith("/readme") ||
+                        normalized.endsWith("/README")) {
+                        normalized = normalized.replace(/\/(index|readme|README)$/, "");
+                    }
+                    if (normalized === "index" ||
+                        normalized === "readme" ||
+                        normalized === "README") {
+                        normalized = "/";
+                    }
+                    // Ensure leading slash for absolute-style paths
+                    if (!normalized.startsWith("/") && !normalized.startsWith("..")) {
+                        normalized = "/" + normalized;
+                    }
+                    node.properties.href = normalized;
+                }
+            }
+        });
+    };
+};
+/**
+ * Create the markdown rendering processor.
+ * Returns a unified processor that converts markdown to HTML with
+ * Shiki syntax highlighting and Mermaid diagram support.
+ */
+async function createProcessor() {
+    return unified()
+        .use(remarkParse)
+        .use(remarkFrontmatter, ["yaml"])
+        .use(remarkExtractFrontmatter, { yaml: parseYaml })
+        .use(remarkGfm)
+        .use(remarkRehype, { allowDangerousHtml: true })
+        .use(rehypeRaw)
+        .use(rehypeMermaid)
+        .use(rehypeShiki, {
+        themes: {
+            light: "github-light",
+            dark: "github-dark",
+        },
+        defaultColor: false,
+    })
+        .use(rehypeRewriteLinks)
+        .use(rehypeStringify);
+}
+// Singleton processor instance
+let processorPromise = null;
+function getProcessor() {
+    if (!processorPromise) {
+        processorPromise = createProcessor();
+    }
+    return processorPromise;
+}
+/**
+ * Render markdown content to HTML.
+ */
+export async function renderMarkdown(content) {
+    const proc = await getProcessor();
+    const result = await proc.process(content);
+    return String(result);
+}
+/**
+ * Render a .txt file to HTML by wrapping in <pre> tags.
+ */
+export function renderText(content) {
+    const escaped = content
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+    return `<pre>${escaped}</pre>`;
+}
+/**
+ * Render content based on file type.
+ */
+export async function renderContent(content, fileType) {
+    if (fileType === "txt") {
+        return renderText(content);
+    }
+    return renderMarkdown(content);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/render/pipeline.js.map

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

package/dist/search/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Search index generation.
+ * Builds a MiniSearch-compatible JSON index from processed documents.
+ * In build mode, written to assets/search.json.
+ * In serve mode, served from memory at /assets/search.json.
+ */
+import type { Document } from "../types.js";
+export interface SearchDocument {
+    id: string;
+    title: string;
+    slug: string;
+    /** First 500 chars of plain-text content (headings stripped, no markdown) */
+    excerpt: string;
+}
+/**
+ * Build a search index from all documents.
+ * Returns an array of SearchDocument objects, ready to be serialised.
+ */
+export declare function buildSearchIndex(documents: Document[]): SearchDocument[];

package/dist/search/index.js

@@ -0,0 +1,43 @@
+/**
+ * Search index generation.
+ * Builds a MiniSearch-compatible JSON index from processed documents.
+ * In build mode, written to assets/search.json.
+ * In serve mode, served from memory at /assets/search.json.
+ */
+/** Strip markdown syntax for plain-text indexing */
+function toPlainText(content) {
+    return (content
+        // Remove front matter
+        .replace(/^---[\s\S]*?---\n?/, "")
+        // Remove headings markers
+        .replace(/^#{1,6}\s+/gm, "")
+        // Remove inline code
+        .replace(/`[^`]+`/g, "")
+        // Remove fenced code blocks
+        .replace(/```[\s\S]*?```/g, "")
+        // Remove links but keep text
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
+        // Remove images
+        .replace(/!\[[^\]]*\]\([^)]+\)/g, "")
+        // Remove bold/italic markers
+        .replace(/\*{1,3}|_{1,3}/g, "")
+        // Collapse whitespace
+        .replace(/\s+/g, " ")
+        .trim());
+}
+/**
+ * Build a search index from all documents.
+ * Returns an array of SearchDocument objects, ready to be serialised.
+ */
+export function buildSearchIndex(documents) {
+    return documents.map((doc) => {
+        const plain = toPlainText(doc.content);
+        return {
+            id: doc.slug || "__root__",
+            title: doc.title,
+            slug: doc.slug,
+            excerpt: plain.slice(0, 500),
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,oDAAoD;AACpD,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,CACL,OAAO;QACL,sBAAsB;SACrB,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAClC,0BAA0B;SACzB,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5B,qBAAqB;SACpB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QACxB,4BAA4B;SAC3B,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC/B,6BAA6B;SAC5B,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC;QACxC,gBAAgB;SACf,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC;QACrC,6BAA6B;SAC5B,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC/B,sBAAsB;SACrB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAqB;IACpD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,UAAU;YAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/reload.d.ts

@@ -0,0 +1,23 @@
+/**
+ * WebSocket live reload server.
+ * Attaches to an existing HTTP server via the upgrade event.
+ * Broadcasts reload messages to all connected clients.
+ */
+import type { Server as HttpServer } from "node:http";
+/**
+ * Client-side live reload script.
+ * Connects to the WebSocket server, listens for reload messages,
+ * and calls location.reload() with auto-reconnect.
+ */
+export declare const LIVE_RELOAD_CLIENT_SCRIPT: string;
+export interface ReloadServer {
+    /** Broadcast a reload signal to all connected clients */
+    reload: () => void;
+    /** Close the WebSocket server */
+    close: () => void;
+}
+/**
+ * Create a WebSocket reload server attached to an HTTP server.
+ * Uses the upgrade event to share the same port.
+ */
+export declare function createReloadServer(httpServer: HttpServer): ReloadServer;

package/dist/server/reload.js

@@ -0,0 +1,80 @@
+/**
+ * WebSocket live reload server.
+ * Attaches to an existing HTTP server via the upgrade event.
+ * Broadcasts reload messages to all connected clients.
+ */
+import { WebSocketServer } from "ws";
+/**
+ * Client-side live reload script.
+ * Connects to the WebSocket server, listens for reload messages,
+ * and calls location.reload() with auto-reconnect.
+ */
+export const LIVE_RELOAD_CLIENT_SCRIPT = `
+(function() {
+  var protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
+  var url = protocol + '//' + location.host + '/__mdmirror_reload';
+  var retryDelay = 1000;
+
+  function connect() {
+    var ws = new WebSocket(url);
+    ws.onopen = function() { retryDelay = 1000; };
+    ws.onmessage = function(event) {
+      if (event.data === 'reload') {
+        location.reload();
+      }
+    };
+    ws.onclose = function() {
+      setTimeout(function() {
+        retryDelay = Math.min(retryDelay * 1.5, 5000);
+        connect();
+      }, retryDelay);
+    };
+  }
+
+  connect();
+})();
+`.trim();
+/**
+ * Create a WebSocket reload server attached to an HTTP server.
+ * Uses the upgrade event to share the same port.
+ */
+export function createReloadServer(httpServer) {
+    const wss = new WebSocketServer({ noServer: true });
+    const clients = new Set();
+    wss.on("connection", (ws) => {
+        clients.add(ws);
+        ws.on("close", () => {
+            clients.delete(ws);
+        });
+        ws.on("error", () => {
+            clients.delete(ws);
+        });
+    });
+    // Handle upgrade requests for our specific path
+    httpServer.on("upgrade", (request, socket, head) => {
+        if (request.url === "/__mdmirror_reload") {
+            wss.handleUpgrade(request, socket, head, (ws) => {
+                wss.emit("connection", ws, request);
+            });
+        }
+        else {
+            socket.destroy();
+        }
+    });
+    return {
+        reload() {
+            for (const client of clients) {
+                if (client.readyState === client.OPEN) {
+                    client.send("reload");
+                }
+            }
+        },
+        close() {
+            for (const client of clients) {
+                client.close();
+            }
+            wss.close();
+        },
+    };
+}
+//# sourceMappingURL=reload.js.map

package/dist/server/reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.js","sourceRoot":"","sources":["../../src/server/reload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAkB,MAAM,IAAI,CAAC;AAGrD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBxC,CAAC,IAAI,EAAE,CAAC;AAST;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAsB;IACvD,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;IAErC,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACjD,IAAI,OAAO,CAAC,GAAG,KAAK,oBAAoB,EAAE,CAAC;YACzC,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;gBAC9C,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;YACJ,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;oBACtC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK;YACH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,CAAC;YACD,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/server.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HTTP dev server.
+ * Serves generated HTML pages at their slug paths.
+ * Serves static assets, bundled libraries, and source folder files.
+ */
+import { createServer } from "node:http";
+import type { ServerConfig } from "../types.js";
+export interface ServedSite {
+    /** Map of slug -> rendered HTML page */
+    pages: Map<string, string>;
+    /** Absolute path to source folder (for serving images/assets) */
+    sourcePath: string;
+}
+/**
+ * Create and start the HTTP dev server.
+ * Returns a promise that resolves with the server instance and a function
+ * to update the served pages. Rejects if the port is in use or binding fails.
+ */
+export declare function startServer(config: ServerConfig, site: ServedSite): Promise<{
+    server: ReturnType<typeof createServer>;
+    updatePages: (pages: Map<string, string>) => void;
+}>;

package/dist/server/server.js

@@ -0,0 +1,137 @@
+/**
+ * HTTP dev server.
+ * Serves generated HTML pages at their slug paths.
+ * Serves static assets, bundled libraries, and source folder files.
+ */
+import { createServer } from "node:http";
+import { readFile, stat } from "node:fs/promises";
+import { resolve, extname, join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+/** Resolve the package root from this module's location (works in both src/ and dist/) */
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PACKAGE_ROOT = resolve(__dirname, "..", "..");
+/** MIME type mapping for common file types */
+const MIME_TYPES = {
+    ".html": "text/html; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".mjs": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".ico": "image/x-icon",
+    ".webp": "image/webp",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".pdf": "application/pdf",
+};
+/**
+ * Map of virtual asset paths to their real file system locations.
+ * Used to serve bundled libraries like Mermaid from node_modules.
+ */
+const VIRTUAL_ASSETS = {
+    "/assets/mermaid.min.js": join(PACKAGE_ROOT, "node_modules/mermaid/dist/mermaid.min.js"),
+};
+/**
+ * Create and start the HTTP dev server.
+ * Returns a promise that resolves with the server instance and a function
+ * to update the served pages. Rejects if the port is in use or binding fails.
+ */
+export function startServer(config, site) {
+    let currentPages = site.pages;
+    const updatePages = (pages) => {
+        currentPages = pages;
+    };
+    const server = createServer(async (req, res) => {
+        const url = new URL(req.url || "/", `http://${req.headers.host || "localhost"}`);
+        let pathname = decodeURIComponent(url.pathname);
+        // Remove trailing slash (except for root)
+        if (pathname !== "/" && pathname.endsWith("/")) {
+            pathname = pathname.slice(0, -1);
+        }
+        // Check for virtual asset paths (e.g., /assets/mermaid.min.js)
+        if (VIRTUAL_ASSETS[pathname]) {
+            try {
+                const realPath = VIRTUAL_ASSETS[pathname];
+                const content = await readFile(realPath);
+                const ext = extname(pathname).toLowerCase();
+                const mimeType = MIME_TYPES[ext] || "application/octet-stream";
+                res.writeHead(200, {
+                    "Content-Type": mimeType,
+                    "Cache-Control": "public, max-age=3600",
+                });
+                res.end(content);
+                return;
+            }
+            catch {
+                // Fall through to 404
+            }
+        }
+        // Convert pathname to slug (strip leading /)
+        const slug = pathname === "/" ? "" : pathname.slice(1);
+        // Check if this is a page route
+        if (currentPages.has(slug)) {
+            const ext = extname(slug).toLowerCase();
+            const mimeType = MIME_TYPES[ext] || "text/html; charset=utf-8";
+            res.writeHead(200, { "Content-Type": mimeType });
+            res.end(currentPages.get(slug));
+            return;
+        }
+        // Try to serve a static file from the source folder
+        try {
+            const filePath = resolve(site.sourcePath, slug);
+            // Security: prevent directory traversal
+            if (!filePath.startsWith(site.sourcePath)) {
+                send404(res);
+                return;
+            }
+            const fileStat = await stat(filePath);
+            if (fileStat.isFile()) {
+                const ext = extname(filePath).toLowerCase();
+                const mimeType = MIME_TYPES[ext] || "application/octet-stream";
+                const content = await readFile(filePath);
+                res.writeHead(200, { "Content-Type": mimeType });
+                res.end(content);
+                return;
+            }
+        }
+        catch {
+            // File not found, fall through to 404
+        }
+        send404(res);
+    });
+    server.listen(config.port, config.host);
+    return new Promise((resolve, reject) => {
+        server.on("listening", () => {
+            resolve({ server, updatePages });
+        });
+        server.on("error", (err) => {
+            if (err.code === "EADDRINUSE") {
+                reject(new Error(`Port ${config.port} is already in use. Try --port ${config.port + 1}`));
+            }
+            else if (err.code === "EACCES") {
+                reject(new Error(`Permission denied binding to ${config.host}:${config.port}`));
+            }
+            else {
+                reject(new Error(`Server error: ${err.message}`));
+            }
+        });
+    });
+}
+function send404(res) {
+    res.writeHead(404, { "Content-Type": "text/html; charset=utf-8" });
+    res.end(`<!DOCTYPE html>
+<html>
+<head><title>404 - Not Found</title></head>
+<body>
+  <h1>404 - Page Not Found</h1>
+  <p>The requested page could not be found.</p>
+  <p><a href="/">Go to homepage</a></p>
+</body>
+</html>`);
+}
+//# sourceMappingURL=server.js.map

package/dist/server/server.js.map

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

package/dist/server/watcher.d.ts

@@ -0,0 +1,24 @@
+/**
+ * File system watcher module.
+ * Uses chokidar to watch the source folder for .md and .txt file changes.
+ * Emits debounced events for add, change, unlink.
+ */
+import { type FSWatcher } from "chokidar";
+export type WatchEventType = "add" | "change" | "unlink";
+export interface WatchEvent {
+    type: WatchEventType;
+    path: string;
+}
+export interface WatcherOptions {
+    /** Root folder to watch */
+    sourcePath: string;
+    /** Debounce delay in ms */
+    debounceMs?: number;
+    /** Callback when files change (called with batched events after debounce) */
+    onChange: (events: WatchEvent[]) => void;
+}
+/**
+ * Start watching a source folder for markdown/text file changes.
+ * Returns the watcher instance for cleanup.
+ */
+export declare function startWatcher(options: WatcherOptions): FSWatcher;