@dogsbay/format-mkdocs 0.2.0-beta.0

package/dist/rules/footnotes.js

@@ -0,0 +1,161 @@
+/**
+ * Footnote definition: [^label]: content
+ * Continuation lines indented by 4 spaces.
+ */
+function footnoteDefBlock(state, startLine, endLine, silent) {
+    const start = state.bMarks[startLine] + state.tShift[startLine];
+    const max = state.eMarks[startLine];
+    // Must start with [^
+    if (start + 4 > max)
+        return false;
+    if (state.src.charCodeAt(start) !== 0x5B /* [ */)
+        return false;
+    if (state.src.charCodeAt(start + 1) !== 0x5E /* ^ */)
+        return false;
+    // Find closing ]:
+    let pos = start + 2;
+    while (pos < max) {
+        if (state.src.charCodeAt(pos) === 0x5D /* ] */)
+            break;
+        // No spaces/newlines in label
+        if (state.src.charCodeAt(pos) === 0x20)
+            return false;
+        pos++;
+    }
+    if (pos >= max)
+        return false;
+    if (pos + 1 >= max || state.src.charCodeAt(pos + 1) !== 0x3A /* : */)
+        return false;
+    const label = state.src.slice(start + 2, pos);
+    if (!label)
+        return false;
+    if (silent)
+        return true;
+    // Content starts after "]: "
+    const contentStart = pos + 2;
+    const firstLineContent = state.src.slice(contentStart, max).trim();
+    // Collect continuation lines (indented by 4+ spaces or empty)
+    const contentLines = [firstLineContent];
+    let nextLine = startLine + 1;
+    while (nextLine < endLine) {
+        const lineStart = state.bMarks[nextLine] + state.tShift[nextLine];
+        const lineMax = state.eMarks[nextLine];
+        const lineContent = state.src.slice(state.bMarks[nextLine], lineMax);
+        // Continuation: 4+ spaces indent or empty line within block
+        if (lineContent.trim() === "") {
+            contentLines.push("");
+            nextLine++;
+            continue;
+        }
+        // Check for 4-space indent
+        const indent = state.sCount[nextLine];
+        if (indent < 4)
+            break;
+        contentLines.push(state.src.slice(lineStart, lineMax));
+        nextLine++;
+    }
+    // Trim trailing empty lines
+    while (contentLines.length > 0 && contentLines[contentLines.length - 1] === "") {
+        contentLines.pop();
+    }
+    const content = contentLines.join("\n");
+    // Emit tokens
+    const openToken = state.push("footnote_def_open", "", 1);
+    openToken.meta = { label };
+    openToken.map = [startLine, nextLine];
+    // Parse content as inline markdown
+    const contentToken = state.push("inline", "", 0);
+    contentToken.content = content;
+    contentToken.map = [startLine, nextLine];
+    contentToken.children = [];
+    state.push("footnote_def_close", "", -1);
+    state.line = nextLine;
+    return true;
+}
+/**
+ * Inline footnote reference: [^label]
+ */
+function footnoteRefInline(state, silent) {
+    const start = state.pos;
+    const max = state.posMax;
+    // Must start with [^
+    if (start + 3 > max)
+        return false;
+    if (state.src.charCodeAt(start) !== 0x5B /* [ */)
+        return false;
+    if (state.src.charCodeAt(start + 1) !== 0x5E /* ^ */)
+        return false;
+    // Find closing ]
+    let pos = start + 2;
+    while (pos < max) {
+        if (state.src.charCodeAt(pos) === 0x5D /* ] */)
+            break;
+        if (state.src.charCodeAt(pos) === 0x20 /* space */)
+            return false;
+        if (state.src.charCodeAt(pos) === 0x0A /* newline */)
+            return false;
+        pos++;
+    }
+    if (pos >= max)
+        return false;
+    const label = state.src.slice(start + 2, pos);
+    if (!label)
+        return false;
+    if (silent)
+        return true;
+    const token = state.push("footnote_ref", "", 0);
+    token.meta = { label };
+    state.pos = pos + 1;
+    return true;
+}
+/**
+ * Core rule: collect footnote definitions from the token stream,
+ * store them in env.footnotes, and remove the definition tokens.
+ */
+function footnoteCollect(state) {
+    if (state.inlineMode)
+        return;
+    const footnotes = {};
+    const newTokens = [];
+    let i = 0;
+    while (i < state.tokens.length) {
+        const token = state.tokens[i];
+        if (token.type === "footnote_def_open") {
+            const label = token.meta.label;
+            // Next token should be inline with the content
+            i++;
+            if (i < state.tokens.length && state.tokens[i].type === "inline") {
+                footnotes[label] = state.tokens[i].content;
+            }
+            // Skip to footnote_def_close
+            while (i < state.tokens.length && state.tokens[i].type !== "footnote_def_close") {
+                i++;
+            }
+            i++; // skip the close token
+            continue;
+        }
+        newTokens.push(token);
+        i++;
+    }
+    state.tokens = newTokens;
+    // Store in env for access by the tree builder
+    if (Object.keys(footnotes).length > 0) {
+        state.env.footnotes = footnotes;
+    }
+}
+/**
+ * Register footnote block + inline rules with markdown-it.
+ */
+export function footnotesPlugin(md) {
+    md.block.ruler.before("reference", "footnote_def", footnoteDefBlock, {
+        alt: ["paragraph", "reference"],
+    });
+    md.inline.ruler.after("image", "footnote_ref", footnoteRefInline);
+    md.core.ruler.after("inline", "footnote_collect", footnoteCollect);
+    // Custom renderer: output a placeholder tag that ContentRenderer can handle
+    md.renderer.rules.footnote_ref = (tokens, idx) => {
+        const label = tokens[idx].meta?.label ?? "";
+        return `<fn-ref data-label="${label}"></fn-ref>`;
+    };
+}
+//# sourceMappingURL=footnotes.js.map

package/dist/rules/footnotes.js.map

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

package/dist/rules/icon-shortcode.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Inline rule: icon/emoji shortcode parser.
+ *
+ * Matches :shortcode: patterns and emits icon_shortcode tokens.
+ * Parses library, variant, name, and size from the shortcode.
+ *
+ * Patterns:
+ *   :material-check:          → { library: "material", name: "check" }
+ *   :fontawesome-brands-github: → { library: "fontawesome", variant: "brands", name: "github" }
+ *   :octicons-file-code-16:   → { library: "octicons", name: "file-code", size: "16" }
+ *   :simple-netlify:          → { library: "simple", name: "netlify" }
+ *   :smile:                   → { library: "emoji", name: "smile" }
+ */
+import type MarkdownIt from "markdown-it";
+interface ParsedShortcode {
+    library: string;
+    variant?: string;
+    name: string;
+    size?: string;
+}
+/**
+ * Parse a shortcode string into library/variant/name/size.
+ */
+export declare function parseShortcode(raw: string): ParsedShortcode;
+/**
+ * Register the icon shortcode inline rule with markdown-it.
+ */
+export declare function iconShortcodePlugin(md: MarkdownIt): void;
+export {};
+//# sourceMappingURL=icon-shortcode.d.ts.map

package/dist/rules/icon-shortcode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-shortcode.d.ts","sourceRoot":"","sources":["../../src/rules/icon-shortcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AA8B1C,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA2C3D;AA0GD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAExD"}

package/dist/rules/icon-shortcode.js

@@ -0,0 +1,169 @@
+/** Known emoji shortcodes (single word, no hyphen) */
+const KNOWN_EMOJI = new Set([
+    "smile", "grinning", "laughing", "rofl", "joy", "wink", "blush", "thinking",
+    "thumbsup", "thumbsdown", "clap", "wave", "pray", "handshake",
+    "rocket", "star", "fire", "sparkles", "bulb", "wrench", "hammer", "gear",
+    "lock", "key", "link", "paperclip", "bookmark", "pushpin", "clipboard",
+    "warning", "question", "exclamation", "heart",
+    "sun", "moon", "cloud", "zap", "snowflake", "rainbow",
+    "computer", "iphone", "email", "globe",
+    "eyes", "memo", "books", "package", "tada", "trophy", "medal", "crown",
+    "image",
+]);
+/** Known icon library prefixes */
+const LIBRARY_PREFIXES = new Set([
+    "material",
+    "fontawesome",
+    "octicons",
+    "simple",
+]);
+/** FontAwesome sub-variants */
+const FA_VARIANTS = new Set(["brands", "solid", "regular"]);
+/** Octicons size suffix pattern */
+const OCTICONS_SIZE_RE = /-(\d+)$/;
+/**
+ * Parse a shortcode string into library/variant/name/size.
+ */
+export function parseShortcode(raw) {
+    // Try each known library prefix
+    for (const prefix of LIBRARY_PREFIXES) {
+        if (raw.startsWith(prefix + "-")) {
+            const rest = raw.slice(prefix.length + 1);
+            if (prefix === "fontawesome") {
+                // fontawesome-brands-github, fontawesome-solid-trash
+                const dashIdx = rest.indexOf("-");
+                if (dashIdx > 0) {
+                    const maybeVariant = rest.slice(0, dashIdx);
+                    if (FA_VARIANTS.has(maybeVariant)) {
+                        return {
+                            library: "fontawesome",
+                            variant: maybeVariant,
+                            name: rest.slice(dashIdx + 1),
+                        };
+                    }
+                }
+                // No variant match — treat rest as name
+                return { library: "fontawesome", name: rest };
+            }
+            if (prefix === "octicons") {
+                // octicons-file-code-16 — strip trailing size
+                const sizeMatch = OCTICONS_SIZE_RE.exec(rest);
+                if (sizeMatch) {
+                    return {
+                        library: "octicons",
+                        name: rest.slice(0, -sizeMatch[0].length),
+                        size: sizeMatch[1],
+                    };
+                }
+                return { library: "octicons", name: rest };
+            }
+            // material, simple — straightforward
+            return { library: prefix, name: rest };
+        }
+    }
+    // No known prefix — treat as emoji shortcode
+    return { library: "emoji", name: raw };
+}
+/**
+ * Parse optional attr_list { .class style="..." } after a shortcode.
+ * Returns parsed attributes and the number of characters consumed.
+ */
+function parseAttrList(src, pos) {
+    if (pos >= src.length || src.charCodeAt(pos) !== 0x7B /* { */)
+        return null;
+    const closeIdx = src.indexOf("}", pos);
+    if (closeIdx < 0)
+        return null;
+    const inner = src.slice(pos + 1, closeIdx).trim();
+    if (!inner)
+        return null;
+    const attrs = {};
+    // Parse .class tokens
+    const classMatches = inner.match(/\.[\w-]+/g);
+    if (classMatches) {
+        attrs.class = classMatches.map((c) => c.slice(1)).join(" ");
+    }
+    // Parse key="value" pairs
+    const kvMatches = inner.matchAll(/([\w-]+)="([^"]*)"/g);
+    for (const m of kvMatches) {
+        attrs[m[1]] = m[2];
+    }
+    // Parse #id (only from non-quoted parts to avoid matching hex colors)
+    const stripped = inner.replace(/"[^"]*"/g, "");
+    const idMatch = stripped.match(/#([\w-]+)/);
+    if (idMatch) {
+        attrs.id = idMatch[1];
+    }
+    return { attrs, consumed: closeIdx - pos + 1 };
+}
+/**
+ * markdown-it inline rule for icon shortcodes.
+ */
+function iconShortcodeRule(state, silent) {
+    const src = state.src;
+    const pos = state.pos;
+    // Must start with :
+    if (src.charCodeAt(pos) !== 0x3A /* : */)
+        return false;
+    // Find closing : — must come before any ] or newline (to avoid interfering with link parser)
+    let closeIdx = -1;
+    for (let j = pos + 1; j < src.length; j++) {
+        const ch = src.charCodeAt(j);
+        if (ch === 0x3A /* : */) {
+            closeIdx = j;
+            break;
+        }
+        if (ch === 0x5D /* ] */ || ch === 0x0A /* \n */)
+            break;
+    }
+    if (closeIdx < 0)
+        return false;
+    // Extract shortcode content
+    const content = src.slice(pos + 1, closeIdx);
+    // Must be a valid shortcode: lowercase letters, digits, hyphens, underscores
+    if (!content || !/^[a-z][a-z0-9_-]*$/.test(content))
+        return false;
+    if (content.length < 2)
+        return false;
+    // Must contain a hyphen (all icon library shortcodes do) OR be a known emoji
+    const hasHyphen = content.includes("-");
+    if (!hasHyphen && !KNOWN_EMOJI.has(content))
+        return false;
+    // Don't match inside words — previous char must be whitespace, start of line, or punctuation
+    if (pos > 0) {
+        const prevChar = src.charCodeAt(pos - 1);
+        // Allow after: space, tab, newline, (, [, {, start of string
+        if (prevChar > 0x20 && prevChar !== 0x28 && prevChar !== 0x5B && prevChar !== 0x7B)
+            return false;
+    }
+    // Check for optional attr_list after closing :
+    let nextPos = closeIdx + 1;
+    const attrResult = parseAttrList(src, nextPos);
+    if (attrResult) {
+        nextPos += attrResult.consumed;
+    }
+    if (silent) {
+        state.pos = nextPos;
+        return true;
+    }
+    const parsed = parseShortcode(content);
+    const attrs = attrResult?.attrs;
+    const token = state.push("icon_shortcode", "", 0);
+    token.meta = {
+        raw: content,
+        library: parsed.library,
+        variant: parsed.variant,
+        name: parsed.name,
+        size: parsed.size,
+        attrs,
+    };
+    state.pos = nextPos;
+    return true;
+}
+/**
+ * Register the icon shortcode inline rule with markdown-it.
+ */
+export function iconShortcodePlugin(md) {
+    md.inline.ruler.after("image", "icon_shortcode", iconShortcodeRule);
+}
+//# sourceMappingURL=icon-shortcode.js.map

package/dist/rules/icon-shortcode.js.map

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

package/dist/rules/keys.d.ts

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

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

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

package/dist/rules/keys.js

@@ -0,0 +1,30 @@
+/**
+ * Matches ++key++ or ++key1+key2++ patterns.
+ * The content between ++ delimiters is split on + to get individual keys.
+ */
+const KEYS_RE = /^\+\+([^+]+(?:\+[^+]+)*)\+\+/;
+function keysRule(state, silent) {
+    if (state.src.charCodeAt(state.pos) !== 0x2b /* + */)
+        return false;
+    if (state.src.charCodeAt(state.pos + 1) !== 0x2b /* + */)
+        return false;
+    const tail = state.src.slice(state.pos);
+    const match = KEYS_RE.exec(tail);
+    if (!match)
+        return false;
+    if (!silent) {
+        const keys = match[1].split("+");
+        const html = keys.map((k) => `<kbd>${k.trim()}</kbd>`).join("+");
+        const token = state.push("html_inline", "", 0);
+        token.content = html;
+    }
+    state.pos += match[0].length;
+    return true;
+}
+/**
+ * Register the keyboard keys inline rule with markdown-it.
+ */
+export function keysPlugin(md) {
+    md.inline.ruler.before("escape", "keys", keysRule);
+}
+//# sourceMappingURL=keys.js.map

package/dist/rules/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/rules/keys.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,GAAG,8BAA8B,CAAC;AAE/C,SAAS,QAAQ,CAAC,KAAkB,EAAE,MAAe;IACnD,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACnE,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAEvE,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEjE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/C,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAc;IACvC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC"}

package/dist/rules/link-rewrite.d.ts

@@ -0,0 +1,7 @@
+import type MarkdownIt from "markdown-it";
+export interface LinkRewriteOptions {
+    /** Base prefix for docs routes (default: "/docs") */
+    baseUrl?: string;
+}
+export declare function linkRewritePlugin(md: MarkdownIt, options?: LinkRewriteOptions): void;
+//# sourceMappingURL=link-rewrite.d.ts.map

package/dist/rules/link-rewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-rewrite.d.ts","sourceRoot":"","sources":["../../src/rules/link-rewrite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAI1C,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsGD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,GAAG,IAAI,CAExF"}

package/dist/rules/link-rewrite.js

@@ -0,0 +1,93 @@
+import { posix } from "node:path";
+/**
+ * Rewrite .md links to /docs/ routes.
+ *
+ * Converts relative markdown links like `../setup/foo.md#anchor`
+ * to absolute routes like `/docs/setup/foo#anchor`.
+ *
+ * The current file's path must be set in `env.filePath`
+ * (relative to docs root, e.g. "reference/admonitions.md").
+ */
+function createLinkRewriteRule(options) {
+    const baseUrl = options.baseUrl ?? "/docs";
+    return function linkRewriteRule(state) {
+        const filePath = state.env?.filePath;
+        if (!filePath)
+            return;
+        // Directory of the current file relative to docs root
+        const fileDir = posix.dirname(filePath.replace(/\\/g, "/"));
+        for (const token of state.tokens) {
+            if (token.children) {
+                rewriteTokens(token.children, fileDir, baseUrl);
+            }
+            // Also check inline tokens at the block level
+            if (token.type === "inline" && token.children) {
+                rewriteTokens(token.children, fileDir, baseUrl);
+            }
+        }
+    };
+}
+function rewriteTokens(tokens, fileDir, baseUrl) {
+    for (const token of tokens) {
+        if (token.type === "link_open") {
+            const hrefIdx = token.attrIndex("href");
+            if (hrefIdx >= 0) {
+                const href = token.attrs[hrefIdx][1];
+                const rewritten = rewriteHref(href, fileDir, baseUrl);
+                if (rewritten !== href) {
+                    token.attrs[hrefIdx][1] = rewritten;
+                }
+            }
+        }
+        if (token.type === "image") {
+            const srcIdx = token.attrIndex("src");
+            if (srcIdx >= 0) {
+                const src = token.attrs[srcIdx][1];
+                const rewritten = rewriteAssetPath(src, fileDir);
+                if (rewritten !== src) {
+                    token.attrs[srcIdx][1] = rewritten;
+                }
+            }
+        }
+        if (token.children) {
+            rewriteTokens(token.children, fileDir, baseUrl);
+        }
+    }
+}
+function rewriteHref(href, fileDir, baseUrl) {
+    // Skip external URLs, anchors-only, mailto, etc.
+    if (href.startsWith("http://") || href.startsWith("https://") ||
+        href.startsWith("#") || href.startsWith("mailto:") ||
+        href.startsWith("tel:") || href.startsWith("javascript:")) {
+        return href;
+    }
+    // Only rewrite .md links
+    if (!href.includes(".md"))
+        return href;
+    // Split anchor
+    const [path, anchor] = href.split("#", 2);
+    // Resolve relative path
+    const resolved = posix.normalize(posix.join(fileDir, path));
+    // Convert to route: strip .md, strip /index suffix
+    let route = resolved
+        .replace(/\.md$/, "")
+        .replace(/\/index$/, "");
+    // Clean up leading dots or slashes
+    route = route.replace(/^\.?\/?/, "");
+    const fullRoute = route ? `${baseUrl}/${route}` : baseUrl;
+    return anchor ? `${fullRoute}#${anchor}` : fullRoute;
+}
+function rewriteAssetPath(src, fileDir) {
+    // Skip external URLs and absolute paths
+    if (src.startsWith("http://") || src.startsWith("https://") ||
+        src.startsWith("/") || src.startsWith("data:")) {
+        return src;
+    }
+    // Resolve relative path to absolute from docs root
+    const resolved = posix.normalize(posix.join(fileDir, src));
+    return `/${resolved.replace(/^\.?\/?/, "")}`;
+}
+export function linkRewritePlugin(md, options = {}) {
+    md.core.ruler.push("link_rewrite", createLinkRewriteRule(options));
+}
+//# sourceMappingURL=link-rewrite.js.map

package/dist/rules/link-rewrite.js.map

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

package/dist/rules/math.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Math rules for markdown-it.
+ *
+ * Inline: $...$ (single dollar, not escaped)
+ * Block: $$...$$ on separate lines
+ *
+ * Emits math_inline and math_block tokens with meta.latex.
+ */
+import type MarkdownIt from "markdown-it";
+/**
+ * Register math rules with markdown-it.
+ */
+export declare function mathPlugin(md: MarkdownIt): void;
+//# sourceMappingURL=math.d.ts.map

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

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