@pruddiman/mdmirror 0.1.0

package/dist/cli/serve.js.map

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

package/dist/core/discovery.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Recursive file discovery module.
+ * Accepts a folder path, recursively finds all .md and .txt files,
+ * and returns partially-populated Document objects.
+ */
+import type { Document } from "../types.js";
+/**
+ * Discover all supported files in a directory recursively.
+ * Returns Document objects with sourcePath, absolutePath, fileType, and isIndex populated.
+ * Other fields (slug, title, content, renderedHtml, sortKey) are left as empty strings.
+ */
+export declare function discoverFiles(rootPath: string): Promise<Document[]>;

package/dist/core/discovery.js

@@ -0,0 +1,91 @@
+/**
+ * Recursive file discovery module.
+ * Accepts a folder path, recursively finds all .md and .txt files,
+ * and returns partially-populated Document objects.
+ */
+import { readdir, stat } from "node:fs/promises";
+import { resolve, relative, extname, basename } from "node:path";
+const SUPPORTED_EXTENSIONS = new Set([".md", ".txt"]);
+const INDEX_FILENAMES = new Set(["index.md", "readme.md", "overview.md"]);
+/**
+ * Discover all supported files in a directory recursively.
+ * Returns Document objects with sourcePath, absolutePath, fileType, and isIndex populated.
+ * Other fields (slug, title, content, renderedHtml, sortKey) are left as empty strings.
+ */
+export async function discoverFiles(rootPath) {
+    const absoluteRoot = resolve(rootPath);
+    // Validate path exists
+    let rootStat;
+    try {
+        rootStat = await stat(absoluteRoot);
+    }
+    catch {
+        throw new Error(`Path does not exist: ${absoluteRoot}`);
+    }
+    // Handle single file input
+    if (rootStat.isFile()) {
+        const ext = extname(absoluteRoot).toLowerCase();
+        if (!SUPPORTED_EXTENSIONS.has(ext)) {
+            throw new Error(`File is not a supported type (.md, .txt): ${absoluteRoot}`);
+        }
+        const fileName = basename(absoluteRoot);
+        return [
+            {
+                sourcePath: fileName,
+                absolutePath: absoluteRoot,
+                slug: "",
+                title: "",
+                description: "",
+                content: "",
+                renderedHtml: "",
+                fileType: ext.slice(1),
+                isIndex: INDEX_FILENAMES.has(fileName.toLowerCase()),
+                sortKey: "",
+            },
+        ];
+    }
+    if (!rootStat.isDirectory()) {
+        throw new Error(`Path is not a file or directory: ${absoluteRoot}`);
+    }
+    const documents = [];
+    await walkDirectory(absoluteRoot, absoluteRoot, documents);
+    if (documents.length === 0) {
+        throw new Error(`No .md or .txt files found in ${absoluteRoot}`);
+    }
+    return documents;
+}
+/**
+ * Recursively walk a directory and collect Document objects.
+ */
+async function walkDirectory(currentPath, rootPath, documents) {
+    const entries = await readdir(currentPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = resolve(currentPath, entry.name);
+        if (entry.isDirectory()) {
+            // Skip hidden directories
+            if (entry.name.startsWith("."))
+                continue;
+            await walkDirectory(fullPath, rootPath, documents);
+        }
+        else if (entry.isFile()) {
+            const ext = extname(entry.name).toLowerCase();
+            if (!SUPPORTED_EXTENSIONS.has(ext))
+                continue;
+            const sourcePath = relative(rootPath, fullPath);
+            const fileName = basename(entry.name).toLowerCase();
+            documents.push({
+                sourcePath,
+                absolutePath: fullPath,
+                slug: "",
+                title: "",
+                description: "",
+                content: "",
+                renderedHtml: "",
+                fileType: ext.slice(1),
+                isIndex: INDEX_FILENAMES.has(fileName),
+                sortKey: "",
+            });
+        }
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/core/discovery.js.map

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

package/dist/core/navigation.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Navigation tree builder.
+ * Takes Document[] and builds a NavigationTree with NavigationNode hierarchy
+ * mirroring folder structure.
+ */
+import type { Document, NavigationTree } from "../types.js";
+/**
+ * Build a NavigationTree from a list of documents.
+ * Creates a hierarchy of sections (folders) and pages (files),
+ * sorted by numeric prefix then alphabetically.
+ */
+export declare function buildNavigationTree(documents: Document[]): NavigationTree;

package/dist/core/navigation.js

@@ -0,0 +1,155 @@
+/**
+ * Navigation tree builder.
+ * Takes Document[] and builds a NavigationTree with NavigationNode hierarchy
+ * mirroring folder structure.
+ */
+import { dirname, basename } from "node:path";
+import { generateSortKey } from "./slug.js";
+import { humanizeFilename } from "./title.js";
+/**
+ * Build a NavigationTree from a list of documents.
+ * Creates a hierarchy of sections (folders) and pages (files),
+ * sorted by numeric prefix then alphabetically.
+ */
+export function buildNavigationTree(documents) {
+    // Create root node
+    const root = {
+        label: "",
+        slug: "",
+        sortKey: "",
+        children: new Map(),
+        pages: [],
+        indexDocument: null,
+    };
+    // Place each document into the tree
+    for (const doc of documents) {
+        const dir = dirname(doc.sourcePath);
+        const segments = dir === "." ? [] : dir.split(/[/\\]/);
+        // Navigate to the correct folder node, creating intermediate nodes as needed
+        let current = root;
+        let currentSlug = "";
+        for (const segment of segments) {
+            currentSlug = currentSlug ? `${currentSlug}/${segment}` : segment;
+            if (!current.children.has(segment)) {
+                current.children.set(segment, {
+                    label: humanizeFilename(segment + ".md"), // reuse humanize logic
+                    slug: currentSlug,
+                    sortKey: generateSortKey(segment),
+                    children: new Map(),
+                    pages: [],
+                    indexDocument: null,
+                });
+            }
+            current = current.children.get(segment);
+        }
+        // Place the document
+        if (doc.isIndex) {
+            current.indexDocument = doc;
+        }
+        else {
+            current.pages.push(doc);
+        }
+    }
+    // Resolve index documents using priority chain:
+    // index.md > readme.md > overview.md > first file alphabetically
+    const INDEX_PRIORITY = ["index.md", "readme.md", "overview.md"];
+    function resolveIndexDocuments(node) {
+        // Recurse into children first
+        for (const child of node.children.values()) {
+            resolveIndexDocuments(child);
+        }
+        // Collect all candidate pages (existing index doc + regular pages)
+        const allPages = [...node.pages];
+        if (node.indexDocument) {
+            allPages.unshift(node.indexDocument);
+            node.indexDocument = null;
+        }
+        if (allPages.length === 0)
+            return;
+        // Try priority filenames first
+        let chosen = null;
+        for (const target of INDEX_PRIORITY) {
+            chosen =
+                allPages.find((d) => basename(d.sourcePath).toLowerCase() === target) ?? null;
+            if (chosen)
+                break;
+        }
+        // Fallback: first page alphabetically by filename
+        if (!chosen) {
+            allPages.sort((a, b) => basename(a.sourcePath)
+                .toLowerCase()
+                .localeCompare(basename(b.sourcePath).toLowerCase()));
+            chosen = allPages[0];
+        }
+        // Set as index, remove from pages list
+        node.indexDocument = chosen;
+        node.pages = allPages.filter((d) => d !== chosen);
+    }
+    resolveIndexDocuments(root);
+    // Convert tree to NavigationNode[]
+    const flatPages = [];
+    function convertNode(node, depth) {
+        const result = [];
+        // Add section nodes for child folders
+        for (const [_name, child] of node.children) {
+            const sectionSlug = child.indexDocument ? child.indexDocument.slug : child.slug;
+            const childNavNodes = convertNode(child, depth + 1);
+            const section = {
+                label: child.label,
+                slug: sectionSlug,
+                type: "section",
+                children: childNavNodes,
+                sortKey: child.sortKey,
+                isActive: false,
+                indexDocument: child.indexDocument,
+                depth,
+            };
+            if (child.indexDocument) {
+                flatPages.push(child.indexDocument);
+            }
+            result.push(section);
+        }
+        // Add page nodes for files in this folder
+        for (const doc of node.pages) {
+            flatPages.push(doc);
+            result.push({
+                label: doc.title,
+                slug: doc.slug,
+                type: "page",
+                children: [],
+                sortKey: doc.sortKey,
+                isActive: false,
+                indexDocument: null,
+                depth,
+            });
+        }
+        // Sort: numeric prefixes first (numerically), then alphabetical
+        result.sort((a, b) => {
+            const aIsNumeric = a.sortKey.match(/^\d+$/);
+            const bIsNumeric = b.sortKey.match(/^\d+$/);
+            // Numeric-prefixed items come before non-prefixed
+            if (aIsNumeric && !bIsNumeric)
+                return -1;
+            if (!aIsNumeric && bIsNumeric)
+                return 1;
+            // Both numeric: compare numerically
+            if (aIsNumeric && bIsNumeric) {
+                return a.sortKey.localeCompare(b.sortKey);
+            }
+            // Both non-numeric: compare alphabetically
+            return a.sortKey.localeCompare(b.sortKey);
+        });
+        return result;
+    }
+    // Handle root-level index document
+    if (root.indexDocument) {
+        flatPages.unshift(root.indexDocument);
+    }
+    const rootNodes = convertNode(root, 0);
+    return {
+        root: rootNodes,
+        flatPages,
+        totalPages: flatPages.length,
+    };
+}
+//# sourceMappingURL=navigation.js.map

package/dist/core/navigation.js.map

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

package/dist/core/slug.d.ts

@@ -0,0 +1,47 @@
+/**
+ * URL slug generation module.
+ * Converts file/folder paths to clean URL slugs.
+ * Handles spaces, special characters, numeric prefixes, and slug collisions.
+ */
+/**
+ * Strip the numeric prefix from a filename/folder name.
+ * "01-intro" -> "intro", "setup" -> "setup"
+ */
+export declare function stripNumericPrefix(name: string): string;
+/**
+ * Extract the numeric prefix value for sorting.
+ * "01-intro" -> 1, "setup" -> Infinity (sorts after numeric-prefixed items)
+ */
+export declare function extractNumericPrefix(name: string): number;
+/**
+ * Generate a sort key from a filename.
+ * Returns the numeric prefix (zero-padded) or the name for alphabetical sorting.
+ */
+export declare function generateSortKey(name: string): string;
+/**
+ * Generate a clean URL slug from a document's source path.
+ *
+ * Rules:
+ * - Strip file extension
+ * - Strip numeric prefixes from each path segment
+ * - index.md / README.md map to the folder slug (e.g., guides/index.md -> guides)
+ * - Root index.md maps to empty string (root page)
+ */
+export declare function generateSlug(sourcePath: string): string;
+/**
+ * Detect slug collisions in a set of documents and warn about them.
+ * Returns a map of slug -> source paths for any collisions.
+ */
+export declare function detectSlugCollisions(slugMap: Map<string, string[]>): Map<string, string[]>;
+/**
+ * Disambiguate slug collisions by appending numeric suffixes.
+ * When two or more documents produce the same slug, all but the first
+ * get a "-2", "-3", etc. suffix appended.
+ *
+ * Takes an array of objects with { slug, sourcePath } and mutates
+ * the slug property in-place.
+ */
+export declare function disambiguateSlugs(items: Array<{
+    slug: string;
+    sourcePath: string;
+}>): void;

package/dist/core/slug.js

@@ -0,0 +1,132 @@
+/**
+ * URL slug generation module.
+ * Converts file/folder paths to clean URL slugs.
+ * Handles spaces, special characters, numeric prefixes, and slug collisions.
+ */
+import { dirname, basename, extname } from "node:path";
+/** Regex to detect numeric prefixes like "01-", "02-", "10-" */
+const NUMERIC_PREFIX_RE = /^(\d+)-(.+)$/;
+/**
+ * Strip the numeric prefix from a filename/folder name.
+ * "01-intro" -> "intro", "setup" -> "setup"
+ */
+export function stripNumericPrefix(name) {
+    const match = name.match(NUMERIC_PREFIX_RE);
+    return match ? match[2] : name;
+}
+/**
+ * Extract the numeric prefix value for sorting.
+ * "01-intro" -> 1, "setup" -> Infinity (sorts after numeric-prefixed items)
+ */
+export function extractNumericPrefix(name) {
+    const match = name.match(NUMERIC_PREFIX_RE);
+    return match ? parseInt(match[1], 10) : Infinity;
+}
+/**
+ * Generate a sort key from a filename.
+ * Returns the numeric prefix (zero-padded) or the name for alphabetical sorting.
+ */
+export function generateSortKey(name) {
+    const match = name.match(NUMERIC_PREFIX_RE);
+    if (match) {
+        // Zero-pad to 10 digits for consistent numeric sorting
+        return match[1].padStart(10, "0");
+    }
+    // For non-numeric names, use the lowercase name for alphabetical sorting
+    return name.toLowerCase();
+}
+/**
+ * Convert a name (filename or folder) into a URL-safe slug segment.
+ * Handles Unicode by normalizing to NFKD and stripping combining diacritics,
+ * then falls back to percent-encoding for characters that survive that step.
+ */
+function slugifySegment(name) {
+    // Strip numeric prefix
+    const stripped = stripNumericPrefix(name);
+    const transliterated = stripped
+        // NFKD decomposes accented chars into base letter + combining mark
+        .normalize("NFKD")
+        // Remove combining diacritical marks (accents, tildes, etc.)
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        // Replace spaces and underscores with hyphens
+        .replace(/[\s_]+/g, "-")
+        // Remove any remaining non-ASCII characters (CJK, emoji, etc.)
+        // by replacing them with a hyphen so they don't silently vanish
+        // eslint-disable-next-line no-control-regex
+        .replace(/[^\x00-\x7f]/g, "-")
+        // Remove any remaining non-URL-safe ASCII characters (keep letters, numbers, hyphens)
+        .replace(/[^a-z0-9-]/g, "")
+        // Collapse multiple hyphens
+        .replace(/-+/g, "-")
+        // Trim leading/trailing hyphens
+        .replace(/^-|-$/g, "");
+    return transliterated;
+}
+/**
+ * Generate a clean URL slug from a document's source path.
+ *
+ * Rules:
+ * - Strip file extension
+ * - Strip numeric prefixes from each path segment
+ * - index.md / README.md map to the folder slug (e.g., guides/index.md -> guides)
+ * - Root index.md maps to empty string (root page)
+ */
+export function generateSlug(sourcePath) {
+    const ext = extname(sourcePath);
+    const withoutExt = sourcePath.slice(0, -ext.length);
+    // Split into path segments
+    const dir = dirname(withoutExt);
+    const file = basename(withoutExt);
+    // Check if this is an index/readme file
+    const isIndex = ["index", "readme"].includes(file.toLowerCase());
+    // Process directory segments
+    const dirSegments = dir === "." ? [] : dir.split(/[/\\]/).map(slugifySegment).filter(Boolean);
+    if (isIndex) {
+        // index.md / README.md -> folder slug or root
+        return dirSegments.join("/");
+    }
+    // Regular file -> add slugified filename
+    const fileSlug = slugifySegment(file);
+    return [...dirSegments, fileSlug].filter(Boolean).join("/");
+}
+/**
+ * Detect slug collisions in a set of documents and warn about them.
+ * Returns a map of slug -> source paths for any collisions.
+ */
+export function detectSlugCollisions(slugMap) {
+    const collisions = new Map();
+    for (const [slug, paths] of slugMap) {
+        if (paths.length > 1) {
+            collisions.set(slug, paths);
+        }
+    }
+    return collisions;
+}
+/**
+ * Disambiguate slug collisions by appending numeric suffixes.
+ * When two or more documents produce the same slug, all but the first
+ * get a "-2", "-3", etc. suffix appended.
+ *
+ * Takes an array of objects with { slug, sourcePath } and mutates
+ * the slug property in-place.
+ */
+export function disambiguateSlugs(items) {
+    const slugMap = new Map();
+    for (const item of items) {
+        const existing = slugMap.get(item.slug) || [];
+        existing.push(item);
+        slugMap.set(item.slug, existing);
+    }
+    for (const [slug, owners] of slugMap) {
+        if (owners.length <= 1)
+            continue;
+        // Sort by sourcePath for deterministic disambiguation
+        owners.sort((a, b) => a.sourcePath.localeCompare(b.sourcePath));
+        // First one keeps the original slug, subsequent ones get suffixes
+        for (let i = 1; i < owners.length; i++) {
+            owners[i].slug = `${slug}-${i + 1}`;
+        }
+    }
+}
+//# sourceMappingURL=slug.js.map

package/dist/core/slug.js.map

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

package/dist/core/title.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Title extraction module.
+ * Parses markdown content to extract the first heading as the page title.
+ * Falls back to a humanized filename if no heading is found.
+ */
+/**
+ * Extract the title from markdown content.
+ * Returns the text of the first heading found, or null if none exists.
+ */
+export declare function extractTitleFromContent(content: string): string | null;
+/**
+ * Convert a filename into a human-readable title.
+ * "getting-started.md" -> "Getting Started"
+ * "01-intro.md" -> "Intro"
+ * "my_cool_doc.txt" -> "My Cool Doc"
+ */
+export declare function humanizeFilename(filename: string): string;
+/**
+ * Get the title for a document.
+ * Tries to extract from content first, falls back to humanized filename.
+ */
+export declare function getTitle(content: string, sourcePath: string): string;

package/dist/core/title.js

@@ -0,0 +1,43 @@
+/**
+ * Title extraction module.
+ * Parses markdown content to extract the first heading as the page title.
+ * Falls back to a humanized filename if no heading is found.
+ */
+import { basename, extname } from "node:path";
+import { stripNumericPrefix } from "./slug.js";
+/** Regex to match a markdown heading (# Title) */
+const HEADING_RE = /^#{1,6}\s+(.+)$/m;
+/**
+ * Extract the title from markdown content.
+ * Returns the text of the first heading found, or null if none exists.
+ */
+export function extractTitleFromContent(content) {
+    const match = content.match(HEADING_RE);
+    return match ? match[1].trim() : null;
+}
+/**
+ * Convert a filename into a human-readable title.
+ * "getting-started.md" -> "Getting Started"
+ * "01-intro.md" -> "Intro"
+ * "my_cool_doc.txt" -> "My Cool Doc"
+ */
+export function humanizeFilename(filename) {
+    // Remove extension
+    const withoutExt = basename(filename, extname(filename));
+    // Strip numeric prefix
+    const stripped = stripNumericPrefix(withoutExt);
+    return (stripped
+        // Replace hyphens and underscores with spaces
+        .replace(/[-_]+/g, " ")
+        // Capitalize first letter of each word
+        .replace(/\b\w/g, (c) => c.toUpperCase())
+        .trim());
+}
+/**
+ * Get the title for a document.
+ * Tries to extract from content first, falls back to humanized filename.
+ */
+export function getTitle(content, sourcePath) {
+    return extractTitleFromContent(content) || humanizeFilename(sourcePath);
+}
+//# sourceMappingURL=title.js.map

package/dist/core/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../../src/core/title.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,kDAAkD;AAClD,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,mBAAmB;IACnB,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEzD,uBAAuB;IACvB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAEhD,OAAO,CACL,QAAQ;QACN,8CAA8C;SAC7C,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;QACvB,uCAAuC;SACtC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACxC,IAAI,EAAE,CACV,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,UAAkB;IAC1D,OAAO,uBAAuB,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC;AAC1E,CAAC"}

package/dist/render/highlight.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shiki syntax highlighting configuration.
+ * Exports the @shikijs/rehype plugin configuration for the rendering pipeline.
+ * Ensures mermaid blocks are excluded from syntax highlighting.
+ */
+/**
+ * Get the configured Shiki rehype plugin.
+ * Uses github-light theme with lazy language loading.
+ * Mermaid blocks are excluded since they're handled by the mermaid plugin.
+ */
+export declare function getShikiPlugin(): readonly [import("unified").Plugin<[import("@shikijs/rehype").RehypeShikiOptions], import("hast").Root>, {
+    readonly themes: {
+        readonly light: "github-light";
+        readonly dark: "github-dark";
+    };
+    readonly defaultColor: false;
+    readonly transformers: readonly [{
+        readonly name: "mdmirror:skip-mermaid";
+        readonly preprocess: (code: string, options: {
+            lang?: string;
+        }) => string;
+    }];
+}];

package/dist/render/highlight.js

@@ -0,0 +1,36 @@
+/**
+ * Shiki syntax highlighting configuration.
+ * Exports the @shikijs/rehype plugin configuration for the rendering pipeline.
+ * Ensures mermaid blocks are excluded from syntax highlighting.
+ */
+import rehypeShiki from "@shikijs/rehype";
+/**
+ * Get the configured Shiki rehype plugin.
+ * Uses github-light theme with lazy language loading.
+ * Mermaid blocks are excluded since they're handled by the mermaid plugin.
+ */
+export function getShikiPlugin() {
+    return [
+        rehypeShiki,
+        {
+            themes: {
+                light: "github-light",
+                dark: "github-dark",
+            },
+            defaultColor: false,
+            // Don't highlight mermaid blocks — they're handled separately
+            transformers: [
+                {
+                    name: "mdmirror:skip-mermaid",
+                    preprocess(code, options) {
+                        if (options.lang === "mermaid") {
+                            return false;
+                        }
+                        return code;
+                    },
+                },
+            ],
+        },
+    ];
+}
+//# sourceMappingURL=highlight.js.map

package/dist/render/highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.js","sourceRoot":"","sources":["../../src/render/highlight.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,WAAW;QACX;YACE,MAAM,EAAE;gBACN,KAAK,EAAE,cAAc;gBACrB,IAAI,EAAE,aAAa;aACpB;YACD,YAAY,EAAE,KAAK;YACnB,8DAA8D;YAC9D,YAAY,EAAE;gBACZ;oBACE,IAAI,EAAE,uBAAuB;oBAC7B,UAAU,CAAC,IAAY,EAAE,OAA0B;wBACjD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;4BAC/B,OAAO,KAA0B,CAAC;wBACpC,CAAC;wBACD,OAAO,IAAI,CAAC;oBACd,CAAC;iBACF;aACF;SACF;KACO,CAAC;AACb,CAAC"}

package/dist/render/mermaid.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Mermaid diagram rehype plugin.
+ * Detects fenced code blocks with lang="mermaid" and replaces them
+ * with <pre class="mermaid"> elements for client-side rendering.
+ */
+import type { Root } from "hast";
+import type { Plugin } from "unified";
+/**
+ * Rehype plugin that transforms mermaid code blocks into renderable elements.
+ * Converts: <pre><code class="language-mermaid">...</code></pre>
+ * Into: <pre class="mermaid">...</pre>
+ */
+export declare const rehypeMermaid: Plugin<[], Root>;