@dogsbay/format-mkdocs 0.2.0-beta.0

package/dist/rules/variants.js

@@ -0,0 +1,148 @@
+import { readdirSync } from "node:fs";
+import { resolve, dirname, basename, extname, join } from "node:path";
+/**
+ * Regex to parse variant filenames.
+ * Group 1: base name (tutorial001)
+ * Group 2: annotated flag (an) or undefined
+ * Group 3: version (py310, py39)
+ */
+const VARIANT_RE = /^(.+?)(?:_(an))?_(py\d+)$/;
+/**
+ * Match {* path [annotations] *} lines
+ */
+const INCLUDE_LINE_RE = /^\{\*\s+(.+?)\s*\*\}$/;
+function parseVariantFilename(filePath) {
+    const name = basename(filePath, extname(filePath));
+    const match = VARIANT_RE.exec(name);
+    if (!match)
+        return null;
+    return {
+        relPath: filePath,
+        base: match[1],
+        annotated: match[2] === "an",
+        version: match[3],
+    };
+}
+function versionLabel(version) {
+    const num = version.replace("py", "");
+    if (num.length >= 3) {
+        return `${num[0]}.${num.slice(1)}+`;
+    }
+    return `${num}+`;
+}
+function tabLabel(variant, hasAnnotatedSibling) {
+    const ver = `Python ${versionLabel(variant.version)}`;
+    if (!variant.annotated && hasAnnotatedSibling)
+        return `${ver} non-Annotated`;
+    return ver;
+}
+function sortVariants(a, b) {
+    if (a.version !== b.version)
+        return b.version.localeCompare(a.version);
+    if (a.annotated !== b.annotated)
+        return a.annotated ? -1 : 1;
+    return 0;
+}
+function findSiblingVariants(referencedPath, docsDir) {
+    const absPath = resolve(docsDir, referencedPath);
+    const dir = dirname(absPath);
+    const ext = extname(absPath);
+    const info = parseVariantFilename(absPath);
+    if (!info)
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const relDir = dirname(referencedPath);
+    const siblings = [];
+    for (const entry of entries) {
+        if (extname(entry) !== ext)
+            continue;
+        const sibling = parseVariantFilename(join(dir, entry));
+        if (!sibling)
+            continue;
+        if (sibling.base !== info.base)
+            continue;
+        sibling.relPath = (relDir === "." ? entry : `${relDir}/${entry}`).replace(/\\/g, "/");
+        siblings.push(sibling);
+    }
+    return siblings.sort(sortVariants);
+}
+function createVariantsRule(options) {
+    return function variantsRule(state) {
+        if (state.inlineMode)
+            return;
+        const lines = state.src.split("\n");
+        let changed = false;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            const includeMatch = INCLUDE_LINE_RE.exec(line);
+            if (!includeMatch)
+                continue;
+            const inner = includeMatch[1];
+            // Extract path (first token before any annotations)
+            const firstSpace = inner.search(/\s+(?:ln\[|hl\[)/);
+            const refPath = firstSpace === -1 ? inner : inner.substring(0, firstSpace);
+            const annotations = firstSpace === -1 ? "" : inner.substring(firstSpace);
+            // Check if this is a variant file
+            const absRef = resolve(options.docsDir, refPath);
+            if (!parseVariantFilename(absRef))
+                continue;
+            // Skip if already inside a //// tab block
+            let insideTab = false;
+            for (let j = i - 1; j >= 0; j--) {
+                const prev = lines[j].trim();
+                if (/^\/\/\/\/\s*$/.test(prev))
+                    break;
+                if (/^\/\/\/\/\s+tab\s*\|/.test(prev)) {
+                    insideTab = true;
+                    break;
+                }
+            }
+            if (insideTab)
+                continue;
+            // Find siblings (even a single variant gets wrapped in a tab)
+            const variants = findSiblingVariants(refPath, options.docsDir);
+            if (variants.length === 0)
+                continue;
+            // Build tab blocks
+            const tabLines = [];
+            const hasAnnotated = variants.some((v) => v.annotated);
+            for (const variant of variants) {
+                tabLines.push(`//// tab | ${tabLabel(variant, hasAnnotated)}`);
+                tabLines.push("");
+                if (!variant.annotated && hasAnnotated) {
+                    tabLines.push("/// tip");
+                    tabLines.push("");
+                    tabLines.push("Prefer to use the `Annotated` version if possible.");
+                    tabLines.push("");
+                    tabLines.push("///");
+                    tabLines.push("");
+                }
+                tabLines.push(`{* ${variant.relPath}${annotations} *}`);
+                tabLines.push("");
+                tabLines.push("////");
+                tabLines.push("");
+            }
+            lines.splice(i, 1, ...tabLines);
+            i += tabLines.length - 1;
+            changed = true;
+        }
+        if (changed) {
+            state.src = lines.join("\n");
+        }
+    };
+}
+/**
+ * Register the variants preprocessor as a markdown-it core rule.
+ * Must run BEFORE file_include so that expanded tab blocks
+ * get their {* *} includes resolved.
+ */
+export function variantsPlugin(md, options) {
+    md.core.ruler.before("normalize", "variants", createVariantsRule(options));
+}
+//# sourceMappingURL=variants.js.map

package/dist/rules/variants.js.map

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

package/dist/tree.d.ts

@@ -0,0 +1,2 @@
+export type { TreeNode } from "@dogsbay/types";
+//# sourceMappingURL=tree.d.ts.map

package/dist/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tree.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":""}

package/dist/utils/indent.d.ts

@@ -0,0 +1,18 @@
+import type StateBlock from "markdown-it/lib/rules_block/state_block.mjs";
+/**
+ * Find the extent of an indented content block starting at `startLine`.
+ * Content must be indented by at least `minIndent` spaces.
+ * Blank lines within the block are included (don't terminate).
+ * Trailing blank lines are trimmed.
+ *
+ * Returns the line index one past the last content line.
+ */
+export declare function findIndentedBlockEnd(state: StateBlock, startLine: number, endLine: number, minIndent: number): number;
+/**
+ * Temporarily dedent lines by `indent` spaces and tokenize the inner content.
+ * Restores original line markers after tokenization.
+ * This enables recursive parsing — nested blocks at `indent` fewer spaces
+ * become top-level blocks in the inner parse pass.
+ */
+export declare function dedentAndTokenize(state: StateBlock, startLine: number, endLine: number, indent: number): void;
+//# sourceMappingURL=indent.d.ts.map

package/dist/utils/indent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indent.d.ts","sourceRoot":"","sources":["../../src/utils/indent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,6CAA6C,CAAC;AAE1E;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAkBR;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,IAAI,CA2BN"}

package/dist/utils/indent.js

@@ -0,0 +1,56 @@
+/**
+ * Find the extent of an indented content block starting at `startLine`.
+ * Content must be indented by at least `minIndent` spaces.
+ * Blank lines within the block are included (don't terminate).
+ * Trailing blank lines are trimmed.
+ *
+ * Returns the line index one past the last content line.
+ */
+export function findIndentedBlockEnd(state, startLine, endLine, minIndent) {
+    let contentEnd = startLine;
+    while (contentEnd < endLine) {
+        if (state.isEmpty(contentEnd)) {
+            contentEnd++;
+            continue;
+        }
+        if (state.sCount[contentEnd] < minIndent)
+            break;
+        contentEnd++;
+    }
+    // Trim trailing blank lines
+    while (contentEnd > startLine && state.isEmpty(contentEnd - 1)) {
+        contentEnd--;
+    }
+    return contentEnd;
+}
+/**
+ * Temporarily dedent lines by `indent` spaces and tokenize the inner content.
+ * Restores original line markers after tokenization.
+ * This enables recursive parsing — nested blocks at `indent` fewer spaces
+ * become top-level blocks in the inner parse pass.
+ */
+export function dedentAndTokenize(state, startLine, endLine, indent) {
+    const savedBMarks = [];
+    const savedTShift = [];
+    const savedSCount = [];
+    const savedBlkIndent = state.blkIndent;
+    for (let i = startLine; i < endLine; i++) {
+        savedBMarks.push(state.bMarks[i]);
+        savedTShift.push(state.tShift[i]);
+        savedSCount.push(state.sCount[i]);
+        if (!state.isEmpty(i)) {
+            state.bMarks[i] += indent;
+            state.tShift[i] = Math.max(0, state.tShift[i] - indent);
+            state.sCount[i] = Math.max(0, state.sCount[i] - indent);
+        }
+    }
+    state.blkIndent = 0;
+    state.md.block.tokenize(state, startLine, endLine);
+    for (let i = startLine; i < endLine; i++) {
+        state.bMarks[i] = savedBMarks[i - startLine];
+        state.tShift[i] = savedTShift[i - startLine];
+        state.sCount[i] = savedSCount[i - startLine];
+    }
+    state.blkIndent = savedBlkIndent;
+}
+//# sourceMappingURL=indent.js.map

package/dist/utils/indent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indent.js","sourceRoot":"","sources":["../../src/utils/indent.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAiB,EACjB,SAAiB,EACjB,OAAe,EACf,SAAiB;IAEjB,IAAI,UAAU,GAAG,SAAS,CAAC;IAE3B,OAAO,UAAU,GAAG,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,UAAU,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,SAAS;YAAE,MAAM;QAChD,UAAU,EAAE,CAAC;IACf,CAAC;IAED,4BAA4B;IAC5B,OAAO,UAAU,GAAG,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QAC/D,UAAU,EAAE,CAAC;IACf,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAiB,EACjB,SAAiB,EACjB,OAAe,EACf,MAAc;IAEd,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;YAC1B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;YACxD,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;IAEpB,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAEnD,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QAC7C,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QAC7C,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,CAAC,SAAS,GAAG,cAAc,CAAC;AACnC,CAAC"}

package/dist/utils/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MkDocs Material admonition type aliases.
+ * Aliases resolve to their canonical type.
+ */
+export declare const TYPE_ALIASES: Record<string, string>;
+/**
+ * The 12 canonical admonition types supported by MkDocs Material.
+ */
+export declare const VALID_TYPES: Set<string>;
+/**
+ * Resolve a type keyword to its canonical type.
+ * Unknown types fall back to "note".
+ */
+export declare function resolveType(raw: string): string;
+/**
+ * Auto-capitalize a type keyword for default title.
+ */
+export declare function autoTitle(type: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyB/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,aAatB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/utils/types.js

@@ -0,0 +1,63 @@
+/**
+ * MkDocs Material admonition type aliases.
+ * Aliases resolve to their canonical type.
+ */
+export const TYPE_ALIASES = {
+    // abstract aliases
+    summary: "abstract",
+    tldr: "abstract",
+    // info aliases
+    todo: "info",
+    // tip aliases
+    hint: "tip",
+    important: "tip",
+    // success aliases
+    check: "success",
+    done: "success",
+    // question aliases
+    help: "question",
+    faq: "question",
+    // warning aliases
+    caution: "warning",
+    attention: "warning",
+    // failure aliases
+    fail: "failure",
+    missing: "failure",
+    // danger aliases
+    error: "danger",
+    // quote aliases
+    cite: "quote",
+};
+/**
+ * The 12 canonical admonition types supported by MkDocs Material.
+ */
+export const VALID_TYPES = new Set([
+    "note",
+    "abstract",
+    "info",
+    "tip",
+    "success",
+    "question",
+    "warning",
+    "failure",
+    "danger",
+    "bug",
+    "example",
+    "quote",
+]);
+/**
+ * Resolve a type keyword to its canonical type.
+ * Unknown types fall back to "note".
+ */
+export function resolveType(raw) {
+    const lower = raw.toLowerCase();
+    const resolved = TYPE_ALIASES[lower] ?? lower;
+    return VALID_TYPES.has(resolved) ? resolved : "note";
+}
+/**
+ * Auto-capitalize a type keyword for default title.
+ */
+export function autoTitle(type) {
+    return type.charAt(0).toUpperCase() + type.slice(1);
+}
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,mBAAmB;IACnB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,UAAU;IAChB,eAAe;IACf,IAAI,EAAE,MAAM;IACZ,cAAc;IACd,IAAI,EAAE,KAAK;IACX,SAAS,EAAE,KAAK;IAChB,kBAAkB;IAClB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,mBAAmB;IACnB,IAAI,EAAE,UAAU;IAChB,GAAG,EAAE,UAAU;IACf,kBAAkB;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,kBAAkB;IAClB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,iBAAiB;IACjB,KAAK,EAAE,QAAQ;IACf,gBAAgB;IAChB,IAAI,EAAE,OAAO;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IACjC,MAAM;IACN,UAAU;IACV,MAAM;IACN,KAAK;IACL,SAAS;IACT,UAAU;IACV,SAAS;IACT,SAAS;IACT,QAAQ;IACR,KAAK;IACL,SAAS;IACT,OAAO;CACR,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IAC9C,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/walker.d.ts

@@ -0,0 +1,8 @@
+import type Token from "markdown-it/lib/token.mjs";
+import type { TreeNode } from "./tree.js";
+/**
+ * Convert a markdown-it token stream into a TreeNode[].
+ * Handles open/close token pairs by recursively collecting children.
+ */
+export declare function tokensToTree(tokens: Token[]): TreeNode[];
+//# sourceMappingURL=walker.d.ts.map

package/dist/walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker.d.ts","sourceRoot":"","sources":["../src/walker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,CAkCxD"}

package/dist/walker.js

@@ -0,0 +1,193 @@
+import { walkInlineTokens } from "./inline-walker.js";
+/**
+ * Convert a markdown-it token stream into a TreeNode[].
+ * Handles open/close token pairs by recursively collecting children.
+ */
+export function tokensToTree(tokens) {
+    let pos = 0;
+    function walk() {
+        const nodes = [];
+        while (pos < tokens.length) {
+            const token = tokens[pos];
+            // Close tokens: return to parent
+            if (token.nesting === -1) {
+                pos++;
+                return nodes;
+            }
+            // Open tokens: collect children until matching close
+            if (token.nesting === 1) {
+                pos++;
+                const node = openTokenToNode(token);
+                node.children = walk();
+                nodes.push(node);
+                continue;
+            }
+            // Self-closing / inline tokens (nesting === 0)
+            pos++;
+            const node = flatTokenToNode(token);
+            if (node)
+                nodes.push(node);
+        }
+        return nodes;
+    }
+    return walk();
+}
+function openTokenToNode(token) {
+    switch (token.type) {
+        case "admonition_open":
+            return {
+                type: "callout",
+                props: {
+                    variant: token.info,
+                    title: token.meta?.title ?? null,
+                    inline: token.meta?.inline ?? null,
+                },
+            };
+        case "details_open":
+            return {
+                type: "details",
+                props: {
+                    variant: token.info,
+                    title: token.meta?.title ?? null,
+                    open: token.meta?.open ?? false,
+                },
+            };
+        case "tab_set_open":
+            return { type: "tabs" };
+        case "tab_panel_open":
+            return {
+                type: "tab",
+                props: { title: token.info },
+            };
+        case "annotation_list_open":
+            return { type: "annotation-list" };
+        case "paragraph_open":
+            return { type: "paragraph" };
+        case "heading_open":
+            return {
+                type: "heading",
+                props: { level: parseInt(token.tag.slice(1), 10) },
+            };
+        case "ordered_list_open":
+            return { type: "ordered-list" };
+        case "bullet_list_open":
+            return { type: "unordered-list" };
+        case "list_item_open":
+            return { type: "list-item" };
+        case "blockquote_open":
+            return { type: "blockquote" };
+        case "dl_open":
+            return { type: "deflist" };
+        case "dt_open":
+            return { type: "dt" };
+        case "dd_open":
+            return { type: "dd" };
+        case "html_container_open":
+            return {
+                type: "html-container",
+                props: {
+                    tag: token.meta?.tag ?? "div",
+                    attrs: token.meta?.attrs ?? {},
+                },
+            };
+        case "footnote_def_open":
+            return {
+                type: "footnote-def",
+                props: { label: token.meta?.label ?? "" },
+            };
+        default:
+            return { type: token.type.replace(/_open$/, "") };
+    }
+}
+function flatTokenToNode(token) {
+    switch (token.type) {
+        case "inline": {
+            const node = { type: "prose", html: token.content };
+            // Structured inline children (Notion-style rich text model)
+            if (token.children && token.children.length > 0) {
+                node.inline = walkInlineTokens(token.children);
+            }
+            return node;
+        }
+        case "math_block":
+            return {
+                type: "math-block",
+                props: { latex: token.content || token.meta?.latex || "" },
+            };
+        case "fence": {
+            const fenceMarker = token.markup || "```";
+            const { lang, title, highlights, lineNumbers } = parseFenceInfo(token.info);
+            return {
+                type: "code",
+                props: {
+                    lang,
+                    title: title || undefined,
+                    code: token.content,
+                    highlights: highlights || undefined,
+                    lineNumbers: lineNumbers || undefined,
+                    hasAnnotations: token.meta?.hasAnnotations ?? false,
+                    fence: fenceMarker.length > 3 ? fenceMarker : undefined,
+                },
+            };
+        }
+        case "code_block":
+            return { type: "code", props: { code: token.content } };
+        case "hr":
+            return { type: "hr" };
+        case "html_block": {
+            // Convert standalone <img> tags to structured paragraph > prose > image nodes
+            // so they can be rendered as BlockImage with optimization support
+            const imgMatch = token.content.match(/^\s*<img\s[^>]*?\bsrc=["']([^"']+)["'][^>]*?(?:\balt=["']([^"']*)["'])?[^>]*?\/?>\s*$/i);
+            if (imgMatch) {
+                const src = imgMatch[1];
+                // Extract alt — may appear before or after src
+                const altMatch = token.content.match(/\balt=["']([^"']*)["']/i);
+                const alt = altMatch ? altMatch[1] : "";
+                return {
+                    type: "paragraph",
+                    children: [
+                        {
+                            type: "prose",
+                            inline: [{ type: "image", src, alt }],
+                        },
+                    ],
+                };
+            }
+            return { type: "html", html: token.content };
+        }
+        // Skip hidden/empty tokens
+        case "softbreak":
+        case "hardbreak":
+            return null;
+        default:
+            if (token.hidden)
+                return null;
+            return { type: token.type, html: token.content || undefined };
+    }
+}
+/**
+ * Parse fence info string to extract lang, title, hl_lines, and linenums.
+ * Handles: "yaml", "yaml title=\".rc\"", " yaml", "yaml hl_lines=\"2 3\"",
+ * "python linenums=\"1\""
+ */
+function parseFenceInfo(info) {
+    if (!info)
+        return { lang: null, title: null, highlights: null, lineNumbers: false };
+    const trimmed = info.trim();
+    if (!trimmed)
+        return { lang: null, title: null, highlights: null, lineNumbers: false };
+    // Extract title="..." if present
+    const titleMatch = trimmed.match(/\btitle="([^"]*)"/);
+    const title = titleMatch ? titleMatch[1] : null;
+    // Extract hl_lines="..." if present (e.g. hl_lines="2 3" or hl_lines="1-3 5")
+    const hlMatch = trimmed.match(/\bhl_lines="([^"]*)"/);
+    const highlights = hlMatch ? hlMatch[1] : null;
+    // Extract linenums if present (e.g. linenums="1")
+    const lineNumbers = /\blinenums=/.test(trimmed);
+    // Lang is the first word (before any space, brace, or title= attribute)
+    // Must be a word-like string, not empty or starting with special chars
+    const firstWord = trimmed.split(/[\s{]/)[0];
+    const lang = firstWord && !firstWord.includes("=") ? firstWord : null;
+    return { lang, title, highlights, lineNumbers };
+}
+//# sourceMappingURL=walker.js.map

package/dist/walker.js.map

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

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@dogsbay/format-mkdocs",
+  "version": "0.2.0-beta.0",
+  "description": "MkDocs format plugin for Dogsbay — import/export MkDocs projects via TreeNode[]",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./loader": {
+      "types": "./dist/loader.d.ts",
+      "import": "./dist/loader.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    },
+    "./export/to-astro": {
+      "types": "./dist/export/to-astro.d.ts",
+      "import": "./dist/export/to-astro.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "markdown-it": "^14.0.0"
+  },
+  "devDependencies": {
+    "@mermaid-js/mermaid-cli": "^11.12.0",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^25.5.0",
+    "@types/nunjucks": "^3.2.6",
+    "markdown-it": "^14.1.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "markdown-it": "^14.1.0",
+    "markdown-it-deflist": "^3.0.0",
+    "nunjucks": "^3.2.4",
+    "tree-sitter-python": "^0.25.0",
+    "web-tree-sitter": "^0.26.8",
+    "yaml": "^2.8.3",
+    "@dogsbay/types": "0.2.0-beta.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dogsbay/dogsbay.git",
+    "directory": "packages/format-mkdocs"
+  },
+  "homepage": "https://github.com/dogsbay/dogsbay/tree/main/packages/format-mkdocs",
+  "bugs": {
+    "url": "https://github.com/dogsbay/dogsbay/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "compare": "tsx scripts/build-comparison.ts",
+    "demo:build": "tsx scripts/build-trees.ts && cd demo && npx astro build",
+    "demo:preview": "cd demo && npx astro preview",
+    "demo:dev": "tsx scripts/build-trees.ts && cd demo && npx astro dev"
+  }
+}