@dogsbay/format-mkdocs 0.2.0-beta.0

package/dist/rules/blocks.js

@@ -0,0 +1,172 @@
+import { resolveType, autoTitle } from "../utils/types.js";
+/**
+ * Opening line regex for PyMdownX blocks syntax.
+ *
+ * Group 1: Slash delimiter — `///`, `////`, etc.
+ * Group 2: Block type keyword — `note`, `details`, `tab`, etc.
+ * Group 3: Title (optional) — text after `|` separator
+ */
+const BLOCKS_OPEN_RE = /^(\/{3,})\s+([\w-]+)(?:\s*\|\s*(.+?))?\s*$/;
+function getLineText(state, line) {
+    const pos = state.bMarks[line] + state.tShift[line];
+    const max = state.eMarks[line];
+    return state.src.slice(pos, max);
+}
+/**
+ * Find the closing delimiter line that matches the given slash count.
+ * Returns the line number of the closing delimiter, or -1 if not found.
+ */
+function findClosingDelimiter(state, startLine, endLine, slashCount) {
+    const closeRe = new RegExp(`^\\/{${slashCount}}\\s*$`);
+    for (let line = startLine; line < endLine; line++) {
+        const text = getLineText(state, line);
+        if (closeRe.test(text))
+            return line;
+    }
+    return -1;
+}
+/**
+ * Parse a single block (admonition or details) and emit tokens.
+ * Returns the line after the closing delimiter, or -1 if no closing found.
+ */
+function parseSingleBlock(state, startLine, endLine, slashCount, blockType, titleRaw) {
+    const contentStart = startLine + 1;
+    const closeLine = findClosingDelimiter(state, contentStart, endLine, slashCount);
+    if (closeLine === -1)
+        return -1;
+    const isDetails = blockType === "details";
+    const tokenType = isDetails ? "details" : "admonition";
+    const variant = isDetails ? "note" : resolveType(blockType);
+    // Title resolution
+    let title;
+    if (titleRaw !== null) {
+        title = titleRaw.trim();
+    }
+    else if (isDetails) {
+        title = "Details";
+    }
+    else {
+        title = autoTitle(blockType);
+    }
+    // Emit opening token
+    const slashes = "/".repeat(slashCount);
+    const openToken = state.push(`${tokenType}_open`, "", 1);
+    openToken.info = variant;
+    openToken.meta = { title, inline: null, open: false };
+    openToken.markup = slashes;
+    openToken.map = [startLine, closeLine + 1];
+    openToken.block = true;
+    // Tokenize inner content (no dedent needed — content is at normal indent)
+    const contentEnd = closeLine;
+    if (contentEnd > contentStart) {
+        const oldParentType = state.parentType;
+        const oldLineMax = state.lineMax;
+        state.parentType = "admonition";
+        state.lineMax = contentEnd;
+        state.md.block.tokenize(state, contentStart, contentEnd);
+        state.parentType = oldParentType;
+        state.lineMax = oldLineMax;
+    }
+    // Emit closing token
+    const closeToken = state.push(`${tokenType}_close`, "", -1);
+    closeToken.markup = slashes;
+    closeToken.block = true;
+    return closeLine + 1;
+}
+/**
+ * Parse consecutive tab blocks and wrap in a tab set.
+ * Returns the line after the last tab's closing delimiter.
+ */
+function parseTabBlocks(state, startLine, endLine, slashCount, firstTitle) {
+    // Open tab set
+    const setOpen = state.push("tab_set_open", "", 1);
+    setOpen.map = [startLine, startLine]; // updated at end
+    setOpen.block = true;
+    const slashes = "/".repeat(slashCount);
+    let line = startLine;
+    let title = firstTitle;
+    while (line < endLine) {
+        const contentStart = line + 1;
+        const closeLine = findClosingDelimiter(state, contentStart, endLine, slashCount);
+        if (closeLine === -1) {
+            // No closing delimiter — roll back tab set and fail
+            // Remove the tab_set_open token we already pushed
+            state.tokens.pop();
+            return -1;
+        }
+        // Open tab panel
+        const panelOpen = state.push("tab_panel_open", "", 1);
+        panelOpen.info = title;
+        panelOpen.markup = slashes;
+        panelOpen.map = [line, closeLine + 1];
+        panelOpen.block = true;
+        // Tokenize inner content
+        const contentEnd = closeLine;
+        if (contentEnd > contentStart) {
+            const oldParentType = state.parentType;
+            const oldLineMax = state.lineMax;
+            state.parentType = "tab";
+            state.lineMax = contentEnd;
+            state.md.block.tokenize(state, contentStart, contentEnd);
+            state.parentType = oldParentType;
+            state.lineMax = oldLineMax;
+        }
+        // Close tab panel
+        const panelClose = state.push("tab_panel_close", "", -1);
+        panelClose.markup = slashes;
+        panelClose.block = true;
+        line = closeLine + 1;
+        // Skip blank lines between tab panels
+        while (line < endLine && state.isEmpty(line))
+            line++;
+        // Check if next line opens another tab with the same slash count
+        if (line < endLine) {
+            const nextLine = getLineText(state, line);
+            const match = BLOCKS_OPEN_RE.exec(nextLine);
+            if (match && match[1].length === slashCount && match[2] === "tab") {
+                title = match[3]?.trim() ?? "Tab";
+                continue;
+            }
+        }
+        // No more consecutive tabs
+        break;
+    }
+    // Close tab set
+    const setClose = state.push("tab_set_close", "", -1);
+    setClose.block = true;
+    // Update map
+    setOpen.map[1] = line;
+    return line;
+}
+function blocksRule(state, startLine, endLine, silent) {
+    const lineText = getLineText(state, startLine);
+    const match = BLOCKS_OPEN_RE.exec(lineText);
+    if (!match)
+        return false;
+    if (silent)
+        return true;
+    const slashCount = match[1].length;
+    const blockType = match[2];
+    const titleRaw = match[3] ?? null;
+    let nextLine;
+    if (blockType === "tab") {
+        const title = titleRaw?.trim() ?? "Tab";
+        nextLine = parseTabBlocks(state, startLine, endLine, slashCount, title);
+    }
+    else {
+        nextLine = parseSingleBlock(state, startLine, endLine, slashCount, blockType, titleRaw);
+    }
+    if (nextLine === -1)
+        return false;
+    state.line = nextLine;
+    return true;
+}
+/**
+ * Register the blocks syntax rule with markdown-it.
+ */
+export function blocksPlugin(md) {
+    md.block.ruler.before("fence", "blocks", blocksRule, {
+        alt: ["paragraph", "reference", "blockquote", "list"],
+    });
+}
+//# sourceMappingURL=blocks.js.map

package/dist/rules/blocks.js.map

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

package/dist/rules/content-tabs.d.ts

@@ -0,0 +1,6 @@
+import type MarkdownIt from "markdown-it";
+/**
+ * Register the content tabs block rule with markdown-it.
+ */
+export declare function contentTabsPlugin(md: MarkdownIt): void;
+//# sourceMappingURL=content-tabs.d.ts.map

package/dist/rules/content-tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-tabs.d.ts","sourceRoot":"","sources":["../../src/rules/content-tabs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAqF1C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAItD"}

package/dist/rules/content-tabs.js

@@ -0,0 +1,67 @@
+import { findIndentedBlockEnd, dedentAndTokenize } from "../utils/indent.js";
+/**
+ * Matches a content tab line: === "Title"
+ */
+const TAB_RE = /^===\s+"([^"]+)"\s*$/;
+function getLineText(state, line) {
+    const pos = state.bMarks[line] + state.tShift[line];
+    const max = state.eMarks[line];
+    return state.src.slice(pos, max);
+}
+function contentTabsRule(state, startLine, endLine, silent) {
+    const firstLine = getLineText(state, startLine);
+    const firstMatch = TAB_RE.exec(firstLine);
+    if (!firstMatch)
+        return false;
+    if (silent)
+        return true;
+    // Open tab set
+    const setOpen = state.push("tab_set_open", "", 1);
+    setOpen.map = [startLine, startLine]; // updated at end
+    setOpen.block = true;
+    let line = startLine;
+    while (line < endLine) {
+        const lineText = getLineText(state, line);
+        const match = TAB_RE.exec(lineText);
+        if (!match)
+            break;
+        const title = match[1];
+        // Open tab panel
+        const panelOpen = state.push("tab_panel_open", "", 1);
+        panelOpen.info = title;
+        panelOpen.markup = "===";
+        panelOpen.block = true;
+        // Find indented content for this panel
+        const contentStart = line + 1;
+        const contentEnd = findIndentedBlockEnd(state, contentStart, endLine, 4);
+        panelOpen.map = [line, contentEnd];
+        // Recursively tokenize inner content
+        if (contentEnd > contentStart) {
+            dedentAndTokenize(state, contentStart, contentEnd, 4);
+        }
+        // Close tab panel
+        const panelClose = state.push("tab_panel_close", "", -1);
+        panelClose.markup = "===";
+        panelClose.block = true;
+        line = contentEnd;
+        // Skip blank lines between tab panels
+        while (line < endLine && state.isEmpty(line))
+            line++;
+    }
+    // Close tab set
+    const setClose = state.push("tab_set_close", "", -1);
+    setClose.block = true;
+    // Update map
+    setOpen.map[1] = line;
+    state.line = line;
+    return true;
+}
+/**
+ * Register the content tabs block rule with markdown-it.
+ */
+export function contentTabsPlugin(md) {
+    md.block.ruler.before("fence", "content_tabs", contentTabsRule, {
+        alt: ["paragraph", "reference", "blockquote", "list"],
+    });
+}
+//# sourceMappingURL=content-tabs.js.map

package/dist/rules/content-tabs.js.map

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

package/dist/rules/docusaurus-admonitions.d.ts

@@ -0,0 +1,7 @@
+import type MarkdownIt from "markdown-it";
+/**
+ * Register the Docusaurus admonition rule with markdown-it.
+ * Opt-in only — conflicts with mkdocstrings ::: directive.
+ */
+export declare function docusaurusAdmonitionsPlugin(md: MarkdownIt): void;
+//# sourceMappingURL=docusaurus-admonitions.d.ts.map

package/dist/rules/docusaurus-admonitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docusaurus-admonitions.d.ts","sourceRoot":"","sources":["../../src/rules/docusaurus-admonitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAgH1C;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAIhE"}

package/dist/rules/docusaurus-admonitions.js

@@ -0,0 +1,101 @@
+import { resolveType, autoTitle } from "../utils/types.js";
+/**
+ * Opening line regex for Docusaurus-style admonitions.
+ *
+ * Group 1: Colon delimiter — `:::`, `::::`, etc.
+ * Group 2: Block type keyword — `note`, `info`, `tip`, `caution`, `danger`, etc.
+ * Group 3: Title (optional) — text after the type keyword
+ */
+const DOCUSAURUS_OPEN_RE = /^(:{3,})\s*([\w-]+)(?:\s+(.+?))?\s*$/;
+function getLineText(state, line) {
+    const pos = state.bMarks[line] + state.tShift[line];
+    const max = state.eMarks[line];
+    return state.src.slice(pos, max);
+}
+/**
+ * Find the closing delimiter line that matches the given colon count.
+ */
+function findClosingDelimiter(state, startLine, endLine, colonCount) {
+    const closeRe = new RegExp(`^:{${colonCount}}\\s*$`);
+    for (let line = startLine; line < endLine; line++) {
+        const text = getLineText(state, line);
+        if (closeRe.test(text))
+            return line;
+    }
+    return -1;
+}
+function docusaurusAdmonitionRule(state, startLine, endLine, silent) {
+    const lineText = getLineText(state, startLine);
+    const match = DOCUSAURUS_OPEN_RE.exec(lineText);
+    if (!match)
+        return false;
+    // Don't match mkdocstrings-style `::: module.Class` (dotted identifiers)
+    const blockType = match[2];
+    if (blockType.includes("."))
+        return false;
+    if (silent)
+        return true;
+    const colonCount = match[1].length;
+    const titleRaw = match[3] ?? null;
+    const contentStart = startLine + 1;
+    const closeLine = findClosingDelimiter(state, contentStart, endLine, colonCount);
+    if (closeLine === -1)
+        return false;
+    // Map Docusaurus types to MkDocs types
+    const typeMap = {
+        caution: "warning",
+        danger: "danger",
+        info: "info",
+        note: "note",
+        tip: "tip",
+        warning: "warning",
+        example: "example",
+        important: "warning",
+    };
+    const isDetails = blockType === "details";
+    const tokenType = isDetails ? "details" : "admonition";
+    const variant = isDetails ? "note" : resolveType(typeMap[blockType] ?? blockType);
+    let title;
+    if (titleRaw !== null) {
+        title = titleRaw.trim();
+    }
+    else if (isDetails) {
+        title = "Details";
+    }
+    else {
+        title = autoTitle(typeMap[blockType] ?? blockType);
+    }
+    const colons = ":".repeat(colonCount);
+    const openToken = state.push(`${tokenType}_open`, "", 1);
+    openToken.info = variant;
+    openToken.meta = { title, inline: null, open: false };
+    openToken.markup = colons;
+    openToken.map = [startLine, closeLine + 1];
+    openToken.block = true;
+    // Tokenize inner content
+    const contentEnd = closeLine;
+    if (contentEnd > contentStart) {
+        const oldParentType = state.parentType;
+        const oldLineMax = state.lineMax;
+        state.parentType = "admonition";
+        state.lineMax = contentEnd;
+        state.md.block.tokenize(state, contentStart, contentEnd);
+        state.parentType = oldParentType;
+        state.lineMax = oldLineMax;
+    }
+    const closeToken = state.push(`${tokenType}_close`, "", -1);
+    closeToken.markup = colons;
+    closeToken.block = true;
+    state.line = closeLine + 1;
+    return true;
+}
+/**
+ * Register the Docusaurus admonition rule with markdown-it.
+ * Opt-in only — conflicts with mkdocstrings ::: directive.
+ */
+export function docusaurusAdmonitionsPlugin(md) {
+    md.block.ruler.before("fence", "docusaurus_admonition", docusaurusAdmonitionRule, {
+        alt: ["paragraph", "reference", "blockquote", "list"],
+    });
+}
+//# sourceMappingURL=docusaurus-admonitions.js.map

package/dist/rules/docusaurus-admonitions.js.map

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

package/dist/rules/file-include.d.ts

@@ -0,0 +1,28 @@
+import type MarkdownIt from "markdown-it";
+export interface FileIncludeOptions {
+    root: string;
+    docsDir?: string;
+}
+export declare function langFromExtension(filePath: string): string;
+/**
+ * Parse a line/highlight spec like "2,6:11,13:19" into sorted unique line numbers.
+ */
+export declare function parseLineSpec(spec: string): number[];
+/**
+ * Extract specific lines from content (1-based line numbers).
+ */
+export declare function extractLines(content: string, lineNums: number[]): string;
+/**
+ * Remap highlight line numbers from original file positions to positions
+ * within the extracted subset.
+ *
+ * If ln=[30,31,32,33,34,35,36,37,38] and hl=[31,32,33],
+ * then hl becomes positions [2,3,4] in the extracted subset.
+ */
+export declare function remapHighlights(hlNums: number[], lnNums: number[]): number[];
+/**
+ * Register the file include core rule with markdown-it.
+ * Runs after snippets but before normalize.
+ */
+export declare function fileIncludePlugin(md: MarkdownIt, options: FileIncludeOptions): void;
+//# sourceMappingURL=file-include.d.ts.map

package/dist/rules/file-include.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-include.d.ts","sourceRoot":"","sources":["../../src/rules/file-include.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAK1C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuDD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAMxE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,EAAE,CAIV;AA6GD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAEN"}

package/dist/rules/file-include.js

@@ -0,0 +1,198 @@
+import { readFileSync } from "node:fs";
+import { resolve, extname } from "node:path";
+/**
+ * Top-level file include: {* path [ln[...]] [hl[...]] *}
+ * Annotations can appear in either order.
+ */
+const FILE_INCLUDE_RE = /^\{\*\s+(\S+?)(?:\s+(?:ln\[([^\]]+)\]|hl\[([^\]]+)\]))(?:\s+(?:ln\[([^\]]+)\]|hl\[([^\]]+)\]))?\s*\*\}$|^\{\*\s+(\S+?)\s*\*\}$/;
+/**
+ * Simpler approach: match the whole line and extract parts.
+ */
+const INCLUDE_LINE_RE = /^\{\*\s+(.+?)\s*\*\}$/;
+const LN_RE = /ln\[([^\]]+)\]/;
+const HL_RE = /hl\[([^\]]+)\]/;
+/**
+ * Inline file include inside fences: {!> path !} or {!> path!}
+ */
+const INLINE_INCLUDE_RE = /\{!>\s*(\S+?)!?\}/;
+const LANG_MAP = {
+    ".py": "python",
+    ".js": "javascript",
+    ".ts": "typescript",
+    ".jsx": "jsx",
+    ".tsx": "tsx",
+    ".json": "json",
+    ".yaml": "yaml",
+    ".yml": "yaml",
+    ".toml": "toml",
+    ".html": "html",
+    ".css": "css",
+    ".sql": "sql",
+    ".sh": "bash",
+    ".bash": "bash",
+    ".zsh": "bash",
+    ".rs": "rust",
+    ".go": "go",
+    ".java": "java",
+    ".rb": "ruby",
+    ".php": "php",
+    ".c": "c",
+    ".cpp": "cpp",
+    ".h": "c",
+    ".hpp": "cpp",
+    ".md": "markdown",
+    ".xml": "xml",
+    ".graphql": "graphql",
+    ".ini": "ini",
+    ".env": "bash",
+    ".txt": "text",
+    ".dockerfile": "dockerfile",
+};
+export function langFromExtension(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return LANG_MAP[ext] || "text";
+}
+/**
+ * Parse a line/highlight spec like "2,6:11,13:19" into sorted unique line numbers.
+ */
+export function parseLineSpec(spec) {
+    const nums = [];
+    for (const part of spec.split(",")) {
+        const trimmed = part.trim();
+        if (trimmed.includes(":")) {
+            const [startStr, endStr] = trimmed.split(":");
+            const start = parseInt(startStr, 10);
+            const end = parseInt(endStr, 10);
+            if (!isNaN(start) && !isNaN(end)) {
+                for (let i = start; i <= end; i++)
+                    nums.push(i);
+            }
+        }
+        else {
+            const n = parseInt(trimmed, 10);
+            if (!isNaN(n))
+                nums.push(n);
+        }
+    }
+    return [...new Set(nums)].sort((a, b) => a - b);
+}
+/**
+ * Extract specific lines from content (1-based line numbers).
+ */
+export function extractLines(content, lineNums) {
+    const allLines = content.split("\n");
+    const extracted = lineNums
+        .filter((n) => n >= 1 && n <= allLines.length)
+        .map((n) => allLines[n - 1]);
+    return extracted.join("\n");
+}
+/**
+ * Remap highlight line numbers from original file positions to positions
+ * within the extracted subset.
+ *
+ * If ln=[30,31,32,33,34,35,36,37,38] and hl=[31,32,33],
+ * then hl becomes positions [2,3,4] in the extracted subset.
+ */
+export function remapHighlights(hlNums, lnNums) {
+    return hlNums
+        .map((h) => lnNums.indexOf(h) + 1)
+        .filter((pos) => pos > 0);
+}
+function createFileIncludeRule(options) {
+    return function fileIncludeRule(state) {
+        if (state.inlineMode)
+            return;
+        const lines = state.src.split("\n");
+        let changed = false;
+        const includes = [];
+        // Determine the base directory for resolving relative paths.
+        // {* *} paths resolve relative to the docsDir (mkdocs.yml docs_dir),
+        // or the root if docsDir is not set.
+        const baseDir = options.docsDir || options.root;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            // Top-level file include: {* path [annotations] *}
+            const includeMatch = INCLUDE_LINE_RE.exec(line);
+            if (includeMatch) {
+                const inner = includeMatch[1];
+                // Extract path (first token) and annotations
+                const lnMatch = LN_RE.exec(inner);
+                const hlMatch = HL_RE.exec(inner);
+                // Path is everything before the first annotation (or the whole thing)
+                let path = inner;
+                const firstAnnotation = Math.min(lnMatch ? inner.indexOf("ln[") : Infinity, hlMatch ? inner.indexOf("hl[") : Infinity);
+                if (firstAnnotation !== Infinity) {
+                    path = inner.substring(0, firstAnnotation).trim();
+                }
+                const absPath = resolve(baseDir, path);
+                let content;
+                try {
+                    content = readFileSync(absPath, "utf-8");
+                    includes.push(absPath);
+                }
+                catch {
+                    // Leave line as-is if file not found
+                    continue;
+                }
+                const lang = langFromExtension(path);
+                let lnNums = null;
+                let hlNums = null;
+                // Parse ln[] — line extraction
+                if (lnMatch) {
+                    lnNums = parseLineSpec(lnMatch[1]);
+                    content = extractLines(content, lnNums);
+                }
+                // Parse hl[] — highlights
+                if (hlMatch) {
+                    hlNums = parseLineSpec(hlMatch[1]);
+                    // Remap if ln was used
+                    if (lnNums) {
+                        hlNums = remapHighlights(hlNums, lnNums);
+                    }
+                }
+                // Build fence info string
+                let info = lang;
+                if (hlNums && hlNums.length > 0) {
+                    info += ` hl_lines="${hlNums.join(" ")}"`;
+                }
+                // Trim trailing newline from content
+                content = content.replace(/\n$/, "");
+                lines[i] = "```" + info + "\n" + content + "\n```";
+                changed = true;
+                continue;
+            }
+            // Inline file include inside fences: {!> path !}
+            if (INLINE_INCLUDE_RE.test(line)) {
+                const inlineMatch = INLINE_INCLUDE_RE.exec(line);
+                const path = inlineMatch[1];
+                const absPath = resolve(baseDir, path);
+                try {
+                    const content = readFileSync(absPath, "utf-8").replace(/\n$/, "");
+                    lines[i] = lines[i].replace(INLINE_INCLUDE_RE, content);
+                    includes.push(absPath);
+                    changed = true;
+                }
+                catch {
+                    // Leave as-is
+                }
+            }
+        }
+        if (changed) {
+            state.src = lines.join("\n");
+        }
+        if (includes.length > 0) {
+            if (!state.env.includes) {
+                state.env.includes = [];
+            }
+            state.env.includes.push(...includes);
+        }
+    };
+}
+/**
+ * Register the file include core rule with markdown-it.
+ * Runs after snippets but before normalize.
+ */
+export function fileIncludePlugin(md, options) {
+    md.core.ruler.before("normalize", "file_include", createFileIncludeRule(options));
+}
+//# sourceMappingURL=file-include.js.map

package/dist/rules/file-include.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-include.js","sourceRoot":"","sources":["../../src/rules/file-include.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAW,OAAO,EAAE,MAAM,WAAW,CAAC;AAOtD;;;GAGG;AACH,MAAM,eAAe,GACnB,gIAAgI,CAAC;AAEnI;;GAEG;AACH,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC;AAC/B,MAAM,KAAK,GAAG,gBAAgB,CAAC;AAE/B;;GAEG;AACH,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAE9C,MAAM,QAAQ,GAA2B;IACvC,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,KAAK;IACb,UAAU,EAAE,SAAS;IACrB,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,aAAa,EAAE,YAAY;CAC5B,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE;oBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,QAAkB;IAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,QAAQ;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAgB,EAChB,MAAgB;IAEhB,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;SACjC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,qBAAqB,CAAC,OAA2B;IACxD,OAAO,SAAS,eAAe,CAAC,KAAgB;QAC9C,IAAI,KAAK,CAAC,UAAU;YAAE,OAAO;QAE7B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,6DAA6D;QAC7D,qEAAqE;QACrE,qCAAqC;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;QAEhD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE7B,mDAAmD;YACnD,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;gBAE9B,6CAA6C;gBAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAElC,sEAAsE;gBACtE,IAAI,IAAI,GAAG,KAAK,CAAC;gBACjB,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EACzC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAC1C,CAAC;gBACF,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;oBACjC,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC;gBACpD,CAAC;gBAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACvC,IAAI,OAAe,CAAC;gBACpB,IAAI,CAAC;oBACH,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBACzC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,qCAAqC;oBACrC,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,MAAM,GAAoB,IAAI,CAAC;gBACnC,IAAI,MAAM,GAAoB,IAAI,CAAC;gBAEnC,+BAA+B;gBAC/B,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;oBACnC,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC1C,CAAC;gBAED,0BAA0B;gBAC1B,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;oBACnC,uBAAuB;oBACvB,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC3C,CAAC;gBACH,CAAC;gBAED,0BAA0B;gBAC1B,IAAI,IAAI,GAAG,IAAI,CAAC;gBAChB,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChC,IAAI,IAAI,cAAc,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAC5C,CAAC;gBAED,qCAAqC;gBACrC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAErC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;gBACnD,OAAO,GAAG,IAAI,CAAC;gBACf,SAAS;YACX,CAAC;YAED,iDAAiD;YACjD,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC;gBAClD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAClE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;oBACxD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACvB,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC;gBAAC,MAAM,CAAC;oBACP,cAAc;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACxB,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC;YAC1B,CAAC;YACA,KAAK,CAAC,GAAG,CAAC,QAAqB,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAc,EACd,OAA2B;IAE3B,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/dist/rules/footnotes.d.ts

@@ -0,0 +1,6 @@
+import type MarkdownIt from "markdown-it";
+/**
+ * Register footnote block + inline rules with markdown-it.
+ */
+export declare function footnotesPlugin(md: MarkdownIt): void;
+//# sourceMappingURL=footnotes.d.ts.map

package/dist/rules/footnotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footnotes.d.ts","sourceRoot":"","sources":["../../src/rules/footnotes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAuK1C;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAYpD"}