@dogsbay/format-mkdocs 0.2.0-beta.0

package/dist/importer.js

@@ -0,0 +1,376 @@
+/**
+ * MkDocs project importer.
+ *
+ * Reads a MkDocs project directory (containing mkdocs.yml) and produces
+ * ExportPage[] + NavItem[] — the universal format contract.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative, basename, dirname, resolve } from "node:path";
+import MarkdownIt from "markdown-it";
+import YAML from "yaml";
+import { parseMeta } from "@dogsbay/types";
+import { mkdocsPlugin, configureFromMkdocs } from "./index.js";
+import { parseMkdocsMarkdown } from "./loader.js";
+/**
+ * Read and parse mkdocs.yml.
+ */
+export function readMkdocsConfig(sourceDir) {
+    const ymlPath = join(sourceDir, "mkdocs.yml");
+    if (!existsSync(ymlPath)) {
+        throw new Error(`No mkdocs.yml found in ${sourceDir}`);
+    }
+    const raw = YAML.parse(readFileSync(ymlPath, "utf-8"));
+    return {
+        siteName: raw.site_name || "Documentation",
+        docsDir: raw.docs_dir || "docs",
+        repoUrl: raw.repo_url,
+        editUri: raw.edit_uri,
+        copyright: raw.copyright,
+        extensions: normalizeExtensions(raw.markdown_extensions),
+        raw,
+    };
+}
+/**
+ * Import a MkDocs project: parse all pages and extract navigation.
+ */
+export async function importMkdocsProject(sourceDir, opts = {}) {
+    const config = readMkdocsConfig(sourceDir);
+    const fullDocsDir = join(sourceDir, config.docsDir);
+    if (!existsSync(fullDocsDir)) {
+        throw new Error(`docs directory not found at ${fullDocsDir}`);
+    }
+    // Build markdown-it instance with detected extensions
+    const pluginOpts = configureFromMkdocs(config.extensions);
+    // Always enable core features
+    pluginOpts.footnotes = true;
+    // Detect file includes
+    // mdx_include resolves {!> path !} relative to the mkdocs.yml directory (sourceDir),
+    // not the docs content directory. E.g. FastAPI's {!> ../../docs_src/...!} resolves
+    // from docs/en/ (where mkdocs.yml is), reaching fastapi/docs_src/.
+    const docsSrcDir = findDocsSrc(sourceDir);
+    if (docsSrcDir || hasExtension(config.extensions, "mdx_include")) {
+        pluginOpts.fileInclude = {
+            root: sourceDir,
+            docsDir: sourceDir,
+        };
+    }
+    // Detect variant tabs (Python version variants like _an_py310)
+    if (hasExtension(config.extensions, "markdown_include_variants")) {
+        pluginOpts.variants = { docsDir: fullDocsDir };
+    }
+    // Detect macros/templates ({{ var }} nunjucks syntax)
+    const macrosData = extractMacrosData(config.raw, sourceDir);
+    if (macrosData && Object.keys(macrosData).length > 0) {
+        pluginOpts.templates = { dataFiles: macrosData };
+    }
+    const md = new MarkdownIt({ html: true, linkify: true, typographer: true });
+    const mdOpts = {
+        ...pluginOpts,
+        snippets: { root: join(sourceDir, "includes"), autoAppend: ["mkdocs.md"] },
+        linkRewrite: false,
+        math: true,
+    };
+    md.use(mkdocsPlugin, mdOpts);
+    // Parse options
+    const parseOpts = {
+        collapse: false,
+        youtubeEmbed: true,
+        diagrams: true,
+    };
+    // Detect mkdocstrings autodoc config
+    const mkdocstringsConfig = extractMkdocstringsConfig(config.raw, sourceDir);
+    if (mkdocstringsConfig) {
+        const autodocOpts = {
+            sourceRoot: mkdocstringsConfig.sourceRoot,
+        };
+        if (mkdocstringsConfig.handlerOptions) {
+            const globalOpts = {};
+            const ho = mkdocstringsConfig.handlerOptions;
+            const optionMap = {
+                show_source: "showSource",
+                show_bases: "showBases",
+                show_signature: "showSignature",
+                unwrap_annotated: "unwrapAnnotated",
+                group_by_category: "groupByCategory",
+                show_root_full_path: "showRootFullPath",
+                show_root_heading: "showRootHeading",
+                show_if_no_docstring: "showIfNoDocstring",
+                inherited_members: "inheritedMembers",
+                merge_init_into_class: "mergeInitIntoClass",
+                separate_signature: "separateSignature",
+                members_order: "membersOrder",
+                filters: "filters",
+                heading_level: "headingLevel",
+            };
+            for (const [snake, camel] of Object.entries(optionMap)) {
+                if (ho[snake] !== undefined)
+                    globalOpts[camel] = ho[snake];
+            }
+            if (Object.keys(globalOpts).length > 0)
+                autodocOpts.globalOptions = globalOpts;
+        }
+        parseOpts.autodoc = autodocOpts;
+    }
+    // Find and parse all markdown files
+    const mdFiles = findMarkdownFiles(fullDocsDir);
+    const pages = [];
+    // Taxonomy names declared in dogsbay.config.yml's `taxonomies:` block
+    // (threaded through cli's import-content.ts). parseMeta uses these to
+    // lift user-declared taxonomy keys into meta.taxonomies.
+    const taxonomyNames = Array.isArray(opts.taxonomyNames)
+        ? opts.taxonomyNames
+        : undefined;
+    for (const mdPath of mdFiles) {
+        const relPath = relative(fullDocsDir, mdPath);
+        const slug = relPath
+            .replace(/\.md$/, "")
+            .replace(/\/index$/, "")
+            .replace(/^index$/, "");
+        try {
+            const source = readFileSync(mdPath, "utf-8");
+            // Lift YAML frontmatter from the raw source before parsing.
+            // The MkDocs parser strips it during post-processing, so we
+            // can't recover it from the tree downstream. Material's
+            // `tags: [foo]` convention is flat — passes through to
+            // meta.tags unchanged.
+            const frontmatter = extractFrontmatter(source);
+            const { tree, headings } = await parseMkdocsMarkdown(source, md, {
+                ...parseOpts,
+                env: { filePath: relPath },
+            });
+            const title = headings.find((h) => h.depth === 1)?.text ||
+                labelFromPath(relPath);
+            const finalSlug = slug || "index";
+            const meta = parseMeta(frontmatter, {
+                slug: finalSlug,
+                taxonomyNames,
+            });
+            pages.push({
+                slug: finalSlug,
+                title,
+                tree,
+                headings,
+                frontmatter,
+                meta,
+            });
+        }
+        catch (err) {
+            console.warn(`Warning: failed to parse ${relPath}: ${err.message}`);
+        }
+    }
+    // Extract navigation. hrefPrefix defaults to "/docs" but the CLI
+    // threads `site.basePath` (normalized) through opts.hrefPrefix so a
+    // site configured for a different prefix gets nav hrefs matching
+    // where pages will actually be emitted.
+    const hrefPrefix = typeof opts.hrefPrefix === "string" ? opts.hrefPrefix : "/docs";
+    const nav = convertNav(config.raw.nav, hrefPrefix);
+    return { pages, nav, config };
+}
+// ── Helpers ─────────────────────────────────────────────
+/** Match a YAML frontmatter block at the start of an MD source. */
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?/;
+/**
+ * Lift YAML frontmatter from the raw markdown source. Returns
+ * `undefined` when the source has no frontmatter block or the YAML
+ * doesn't parse to a plain object. Tolerates malformed YAML quietly
+ * so a single bad page doesn't break the whole import.
+ */
+function extractFrontmatter(source) {
+    const match = FRONTMATTER_RE.exec(source);
+    if (!match)
+        return undefined;
+    const raw = match[1];
+    if (raw.trim().length === 0)
+        return undefined;
+    try {
+        const parsed = YAML.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function findMarkdownFiles(dir) {
+    const results = [];
+    function walk(d) {
+        for (const entry of readdirSync(d)) {
+            const full = join(d, entry);
+            if (statSync(full).isDirectory()) {
+                walk(full);
+            }
+            else if (entry.endsWith(".md")) {
+                results.push(full);
+            }
+        }
+    }
+    walk(dir);
+    return results;
+}
+function convertNav(nav, hrefPrefix) {
+    if (!nav || !Array.isArray(nav))
+        return [];
+    return nav.map((entry) => {
+        if (typeof entry === "string") {
+            return { label: labelFromPath(entry), href: pathToHref(entry, hrefPrefix) };
+        }
+        const [label, value] = Object.entries(entry)[0];
+        if (typeof value === "string") {
+            return { label, href: pathToHref(value, hrefPrefix) };
+        }
+        if (Array.isArray(value)) {
+            return { label, children: convertNav(value, hrefPrefix) };
+        }
+        return { label };
+    });
+}
+function pathToHref(path, hrefPrefix) {
+    const slug = path
+        .replace(/\.md$/, "")
+        .replace(/\/index$/, "")
+        .replace(/^index$/, "");
+    // hrefPrefix is the (possibly empty) basePath. Empty means root-served
+    // sites get hrefs like "/intro" instead of "/docs/intro".
+    if (!slug)
+        return hrefPrefix || "/";
+    return `${hrefPrefix}/${slug}`;
+}
+function labelFromPath(path) {
+    const name = basename(path, ".md");
+    return name.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/**
+ * Normalize markdown_extensions from mkdocs.yml.
+ * Can be an array or an object (keys = extension names, values = config or null).
+ */
+function normalizeExtensions(raw) {
+    if (!raw)
+        return [];
+    if (Array.isArray(raw))
+        return raw;
+    if (typeof raw === "object" && raw !== null) {
+        return Object.entries(raw).map(([name, config]) => config != null ? { [name]: config } : name);
+    }
+    return [];
+}
+function hasExtension(extensions, name) {
+    return extensions.some((e) => typeof e === "string" ? e === name : Object.keys(e)[0] === name);
+}
+/**
+ * Find docs_src/ directory (used for {* *} file includes).
+ */
+function findDocsSrc(sourceDir) {
+    const candidates = [
+        join(sourceDir, "docs_src"),
+        join(sourceDir, "..", "docs_src"),
+    ];
+    for (const dir of candidates) {
+        if (existsSync(dir))
+            return dir;
+    }
+    return null;
+}
+/**
+ * Extract mkdocstrings configuration from mkdocs.yml plugins section.
+ */
+function extractMkdocstringsConfig(config, sourceDir) {
+    const plugins = config.plugins;
+    if (!plugins)
+        return null;
+    let mkdocstringsConf = null;
+    if (Array.isArray(plugins)) {
+        for (const p of plugins) {
+            if (typeof p === "object" && p !== null && "mkdocstrings" in p) {
+                mkdocstringsConf = p.mkdocstrings;
+                break;
+            }
+        }
+    }
+    else if (typeof plugins === "object" && plugins !== null) {
+        if ("mkdocstrings" in plugins) {
+            mkdocstringsConf = plugins.mkdocstrings || {};
+        }
+    }
+    if (!mkdocstringsConf)
+        return null;
+    const handlers = mkdocstringsConf.handlers;
+    const pythonConf = handlers?.python;
+    const paths = pythonConf?.paths;
+    const handlerOptions = pythonConf?.options;
+    // Use configured paths first
+    if (paths && paths.length > 0) {
+        const resolved = resolve(sourceDir, paths[0]);
+        if (existsSync(resolved))
+            return { sourceRoot: resolved, handlerOptions };
+    }
+    // Search parent directories for Python packages
+    for (let dir = sourceDir, i = 0; i < 4; i++) {
+        try {
+            for (const entry of readdirSync(dir)) {
+                const full = join(dir, entry);
+                if (statSync(full).isDirectory() && existsSync(join(full, "__init__.py"))) {
+                    return { sourceRoot: dir, handlerOptions };
+                }
+            }
+        }
+        catch { /* continue */ }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Extract macros plugin data files (include_yaml) from mkdocs.yml.
+ * Returns a map of variable name → absolute YAML file path.
+ */
+function extractMacrosData(config, sourceDir) {
+    const plugins = config.plugins;
+    if (!plugins)
+        return null;
+    let macrosConfig = null;
+    if (Array.isArray(plugins)) {
+        for (const p of plugins) {
+            if (typeof p === "object" && p !== null && "macros" in p) {
+                macrosConfig = p.macros;
+                break;
+            }
+            if (p === "macros") {
+                macrosConfig = {};
+                break;
+            }
+        }
+    }
+    else if (typeof plugins === "object" && plugins !== null) {
+        if ("macros" in plugins) {
+            macrosConfig = plugins.macros || {};
+        }
+    }
+    if (!macrosConfig)
+        return null;
+    const includeYaml = macrosConfig.include_yaml;
+    if (!includeYaml || !Array.isArray(includeYaml))
+        return null;
+    const result = {};
+    for (const entry of includeYaml) {
+        if (typeof entry === "string") {
+            const name = entry.replace(/\.[^.]+$/, "").split("/").pop() || entry;
+            const full = resolve(sourceDir, entry);
+            if (existsSync(full))
+                result[name] = full;
+        }
+        else if (typeof entry === "object" && entry !== null) {
+            const [name, path] = Object.entries(entry)[0];
+            if (typeof path === "string") {
+                const full = resolve(sourceDir, path);
+                if (existsSync(full))
+                    result[name] = full;
+            }
+        }
+    }
+    return Object.keys(result).length > 0 ? result : null;
+}
+//# sourceMappingURL=importer.js.map

package/dist/importer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.js","sourceRoot":"","sources":["../src/importer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAwBlD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAA4B,CAAC;IAClF,OAAO;QACL,QAAQ,EAAG,GAAG,CAAC,SAAoB,IAAI,eAAe;QACtD,OAAO,EAAG,GAAG,CAAC,QAAmB,IAAI,MAAM;QAC3C,OAAO,EAAE,GAAG,CAAC,QAA8B;QAC3C,OAAO,EAAE,GAAG,CAAC,QAA8B;QAC3C,SAAS,EAAE,GAAG,CAAC,SAA+B;QAC9C,UAAU,EAAE,mBAAmB,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACxD,GAAG;KACJ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,OAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAEpD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,+BAA+B,WAAW,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,sDAAsD;IACtD,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1D,8BAA8B;IAC9B,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC;IAE5B,uBAAuB;IACvB,qFAAqF;IACrF,mFAAmF;IACnF,mEAAmE;IACnE,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,UAAU,IAAI,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,CAAC;QACjE,UAAU,CAAC,WAAW,GAAG;YACvB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,SAAS;SACnB,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,IAAI,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,2BAA2B,CAAC,EAAE,CAAC;QACjE,UAAU,CAAC,QAAQ,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACjD,CAAC;IAED,sDAAsD;IACtD,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,UAAU,CAAC,SAAS,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,MAAM,MAAM,GAA4B;QACtC,GAAG,UAAU;QACb,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE;QAC1E,WAAW,EAAE,KAAK;QAClB,IAAI,EAAE,IAAI;KACX,CAAC;IACF,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAE7B,gBAAgB;IAChB,MAAM,SAAS,GAA4B;QACzC,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;KACf,CAAC;IAEF,qCAAqC;IACrC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC5E,IAAI,kBAAkB,EAAE,CAAC;QACvB,MAAM,WAAW,GAA4B;YAC3C,UAAU,EAAE,kBAAkB,CAAC,UAAU;SAC1C,CAAC;QACF,IAAI,kBAAkB,CAAC,cAAc,EAAE,CAAC;YACtC,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,MAAM,EAAE,GAAG,kBAAkB,CAAC,cAAc,CAAC;YAC7C,MAAM,SAAS,GAA2B;gBACxC,WAAW,EAAE,YAAY;gBACzB,UAAU,EAAE,WAAW;gBACvB,cAAc,EAAE,eAAe;gBAC/B,gBAAgB,EAAE,iBAAiB;gBACnC,iBAAiB,EAAE,iBAAiB;gBACpC,mBAAmB,EAAE,kBAAkB;gBACvC,iBAAiB,EAAE,iBAAiB;gBACpC,oBAAoB,EAAE,mBAAmB;gBACzC,iBAAiB,EAAE,kBAAkB;gBACrC,qBAAqB,EAAE,oBAAoB;gBAC3C,kBAAkB,EAAE,mBAAmB;gBACvC,aAAa,EAAE,cAAc;gBAC7B,OAAO,EAAE,SAAS;gBAClB,aAAa,EAAE,cAAc;aAC9B,CAAC;YACF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvD,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,SAAS;oBAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,WAAW,CAAC,aAAa,GAAG,UAAU,CAAC;QACjF,CAAC;QACD,SAAS,CAAC,OAAO,GAAG,WAAW,CAAC;IAClC,CAAC;IAED,oCAAoC;IACpC,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,sEAAsE;IACtE,sEAAsE;IACtE,yDAAyD;IACzD,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;QACrD,CAAC,CAAE,IAAI,CAAC,aAAmC;QAC3C,CAAC,CAAC,SAAS,CAAC;IAEd,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO;aACjB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;aACpB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;aACvB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAE1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAE7C,4DAA4D;YAC5D,4DAA4D;YAC5D,wDAAwD;YACxD,uDAAuD;YACvD,uBAAuB;YACvB,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAE/C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE;gBAC/D,GAAG,SAAS;gBACZ,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;aAC3B,CAAC,CAAC;YAEH,MAAM,KAAK,GACT,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAoB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,IAAI;gBAC5D,aAAa,CAAC,OAAO,CAAC,CAAC;YAEzB,MAAM,SAAS,GAAG,IAAI,IAAI,OAAO,CAAC;YAClC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE;gBAClC,IAAI,EAAE,SAAS;gBACf,aAAa;aACd,CAAC,CAAC;YAEH,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,SAAS;gBACf,KAAK;gBACL,IAAI;gBACJ,QAAQ;gBACR,WAAW;gBACX,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,4BAA4B,OAAO,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,oEAAoE;IACpE,iEAAiE;IACjE,wCAAwC;IACxC,MAAM,UAAU,GACd,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IAClE,MAAM,GAAG,GAAG,UAAU,CACpB,MAAM,CAAC,GAAG,CAAC,GAAmC,EAC9C,UAAU,CACX,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED,2DAA2D;AAE3D,mEAAmE;AACnE,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAElD;;;;;GAKG;AACH,SAAS,kBAAkB,CACzB,MAAc;IAEd,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,MAAiC,CAAC;QAC3C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,SAAS,IAAI,CAAC,CAAS;QACrB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC5B,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,OAAO,CAAC;AACjB,CAAC;AAID,SAAS,UAAU,CACjB,GAAiC,EACjC,UAAkB;IAElB,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3C,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAW,EAAE;QAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;QAC9E,CAAC;QAED,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;QACxD,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;QAC5D,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,UAAkB;IAClD,MAAM,IAAI,GAAG,IAAI;SACd,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC1B,uEAAuE;IACvE,0DAA0D;IAC1D,IAAI,CAAC,IAAI;QAAE,OAAO,UAAU,IAAI,GAAG,CAAC;IACpC,OAAO,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,GAAY;IAEZ,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAChD,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,CACtD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CACnB,UAAgD,EAChD,IAAY;IAEZ,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3B,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAChE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,SAAiB;IACpC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;QAC3B,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC;KAClC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAChC,MAA+B,EAC/B,SAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,gBAAgB,GAAmC,IAAI,CAAC;IAE5D,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;gBAC/D,gBAAgB,GAAI,CAA6B,CAAC,YAAuC,CAAC;gBAC1F,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3D,IAAI,cAAc,IAAI,OAAO,EAAE,CAAC;YAC9B,gBAAgB,GAAI,OAAmC,CAAC,YAAuC,IAAI,EAAE,CAAC;QACxG,CAAC;IACH,CAAC;IAED,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAA+C,CAAC;IAClF,MAAM,UAAU,GAAG,QAAQ,EAAE,MAA6C,CAAC;IAC3E,MAAM,KAAK,GAAG,UAAU,EAAE,KAA6B,CAAC;IACxD,MAAM,cAAc,GAAG,UAAU,EAAE,OAA8C,CAAC;IAElF,6BAA6B;IAC7B,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC5E,CAAC;IAED,gDAAgD;IAChD,KAAK,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC9B,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;oBAC1E,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CACxB,MAA+B,EAC/B,SAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,YAAY,GAAmC,IAAI,CAAC;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;gBACzD,YAAY,GAAI,CAA6B,CAAC,MAAiC,CAAC;gBAChF,MAAM;YACR,CAAC;YACD,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACnB,YAAY,GAAG,EAAE,CAAC;gBAClB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3D,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;YACxB,YAAY,GAAI,OAAmC,CAAC,MAAiC,IAAI,EAAE,CAAC;QAC9F,CAAC;IACH,CAAC;IAED,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,WAAW,GAAG,YAAY,CAAC,YAAY,CAAC;IAC9C,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7D,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC;YACrE,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACvC,IAAI,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC5C,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACtC,IAAI,UAAU,CAAC,IAAI,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+import type MarkdownIt from "markdown-it";
+export type { TreeNode, InlineNode, InlineText, InlineLink, InlineImage, InlineCode, InlineFootnoteRef, InlineKbd, InlineHtml, InlineBreak, RagChunk, ExportPage, NavItem } from "@dogsbay/types";
+export { treeToJson, chunkByHeadings } from "@dogsbay/types";
+export { walkInlineTokens } from "./inline-walker.js";
+export { tokensToTree } from "./walker.js";
+export { parseToTree } from "./parse.js";
+export { parseShortcode } from "./rules/icon-shortcode.js";
+export { treeToMkdocs } from "./export/to-mkdocs.js";
+export { exportMkdocsProject } from "./export/to-mkdocs-project.js";
+export type { MkdocsProjectOptions, MkdocsProjectExport } from "./export/to-mkdocs-project.js";
+export interface MkdocsPluginOptions {
+    admonitions?: boolean;
+    tabs?: boolean;
+    keys?: boolean;
+    snippets?: {
+        root: string;
+        autoAppend?: string[];
+    } | false;
+    annotations?: boolean;
+    mdInHtml?: boolean;
+    defList?: boolean;
+    linkRewrite?: {
+        baseUrl?: string;
+    } | boolean;
+    footnotes?: boolean;
+    icons?: boolean;
+    math?: boolean;
+    blocks?: boolean;
+    fileInclude?: {
+        root: string;
+        docsDir?: string;
+    } | false;
+    variants?: {
+        docsDir: string;
+    } | false;
+    templates?: {
+        dataFiles?: Record<string, string>;
+        dataDir?: string;
+        data?: Record<string, unknown>;
+    } | false;
+    autodoc?: {
+        sourceRoot: string;
+        globalOptions?: Record<string, unknown>;
+    } | false;
+    /** Docusaurus-style ::: admonitions (opt-in, conflicts with mkdocstrings :::) */
+    docusaurusAdmonitions?: boolean;
+}
+/**
+ * Main plugin entry point. Registers markdown-it rules based on options.
+ */
+export declare function mkdocsPlugin(md: MarkdownIt, options?: MkdocsPluginOptions): void;
+/**
+ * Build plugin options from a mkdocs.yml `markdown_extensions` array.
+ * Each entry can be a string or an object with a single key.
+ */
+export declare function configureFromMkdocs(extensions: (string | Record<string, unknown>)[]): MkdocsPluginOptions;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAG1C,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAClM,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAmB/F,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,KAAK,CAAC;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IACzD,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IACvC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,KAAK,CAAC;IAC7G,OAAO,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,KAAK,CAAC;IAClF,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,UAAU,EACd,OAAO,GAAE,mBAAwB,GAChC,IAAI,CA2EN;AAmDD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,GAC/C,mBAAmB,CAerB"}

package/dist/index.js

@@ -0,0 +1,170 @@
+export { treeToJson, chunkByHeadings } from "@dogsbay/types";
+export { walkInlineTokens } from "./inline-walker.js";
+// MkDocs parser exports
+export { tokensToTree } from "./walker.js";
+export { parseToTree } from "./parse.js";
+export { parseShortcode } from "./rules/icon-shortcode.js";
+// MkDocs serializer (TreeNode[] → MkDocs markdown)
+export { treeToMkdocs } from "./export/to-mkdocs.js";
+export { exportMkdocsProject } from "./export/to-mkdocs-project.js";
+import { admonitionPlugin } from "./rules/admonition.js";
+import { blocksPlugin } from "./rules/blocks.js";
+import { contentTabsPlugin } from "./rules/content-tabs.js";
+import { keysPlugin } from "./rules/keys.js";
+import { snippetsPlugin } from "./rules/snippets.js";
+import { fileIncludePlugin } from "./rules/file-include.js";
+import { variantsPlugin } from "./rules/variants.js";
+import { templatesPlugin } from "./rules/templates.js";
+// autodoc is handled in the loader (async), not as a core rule
+import { docusaurusAdmonitionsPlugin } from "./rules/docusaurus-admonitions.js";
+import { annotationsPlugin } from "./rules/annotations.js";
+import { mdInHtmlPlugin } from "./rules/md-in-html.js";
+import { linkRewritePlugin } from "./rules/link-rewrite.js";
+import { mathPlugin } from "./rules/math.js";
+import { footnotesPlugin } from "./rules/footnotes.js";
+import { iconShortcodePlugin } from "./rules/icon-shortcode.js";
+import deflist from "markdown-it-deflist";
+/**
+ * Main plugin entry point. Registers markdown-it rules based on options.
+ */
+export function mkdocsPlugin(md, options = {}) {
+    const opts = {
+        admonitions: true,
+        tabs: true,
+        keys: true,
+        snippets: false,
+        annotations: true,
+        mdInHtml: true,
+        defList: true,
+        linkRewrite: false,
+        footnotes: false,
+        blocks: false,
+        ...options,
+    };
+    if (opts.admonitions) {
+        admonitionPlugin(md);
+    }
+    if (opts.blocks) {
+        blocksPlugin(md);
+    }
+    if (opts.docusaurusAdmonitions) {
+        docusaurusAdmonitionsPlugin(md);
+    }
+    if (opts.tabs) {
+        contentTabsPlugin(md);
+    }
+    if (opts.keys) {
+        keysPlugin(md);
+    }
+    if (opts.snippets) {
+        snippetsPlugin(md, opts.snippets);
+    }
+    if (opts.templates) {
+        templatesPlugin(md, opts.templates);
+    }
+    // autodoc is handled in the loader via options.autodoc (async)
+    if (opts.variants) {
+        variantsPlugin(md, opts.variants);
+    }
+    if (opts.fileInclude) {
+        fileIncludePlugin(md, opts.fileInclude);
+    }
+    if (opts.annotations) {
+        annotationsPlugin(md);
+    }
+    if (opts.defList) {
+        md.use(deflist);
+        // Preprocess: convert <!-- md:... type:X --> comments into deflist terms
+        // so markdown-it-deflist can parse the orphan `:` definitions that follow
+        md.core.ruler.before("normalize", "md_option_terms", (state) => {
+            state.src = state.src.replace(/<!--\s*md:\w+\s+(?:\w+:)?(\w+)\s*-->/g, "`$1`");
+        });
+    }
+    if (opts.mdInHtml) {
+        mdInHtmlPlugin(md);
+    }
+    if (opts.linkRewrite) {
+        const rewriteOpts = typeof opts.linkRewrite === "object" ? opts.linkRewrite : {};
+        linkRewritePlugin(md, rewriteOpts);
+    }
+    if (opts.footnotes) {
+        footnotesPlugin(md);
+    }
+    if (opts.icons !== false) {
+        // Icons enabled by default
+        iconShortcodePlugin(md);
+    }
+    if (opts.math) {
+        mathPlugin(md);
+    }
+}
+/**
+ * Extension name mapping from mkdocs.yml markdown_extensions to plugin options.
+ */
+const EXTENSION_MAP = {
+    admonition: (opts) => {
+        opts.admonitions = true;
+    },
+    "pymdownx.details": (opts) => {
+        opts.admonitions = true;
+    },
+    "pymdownx.tabbed": (opts) => {
+        opts.tabs = true;
+    },
+    "pymdownx.keys": (opts) => {
+        opts.keys = true;
+    },
+    "pymdownx.snippets": (opts) => {
+        opts.snippets = { root: "." };
+    },
+    "pymdownx.superfences": (opts) => {
+        opts.annotations = true;
+    },
+    "md_in_html": (opts) => {
+        opts.mdInHtml = true;
+    },
+    "def_list": (opts) => {
+        opts.defList = true;
+    },
+    "footnotes": (opts) => {
+        opts.footnotes = true;
+    },
+    "pymdownx.blocks.admonition": (opts) => {
+        opts.blocks = true;
+    },
+    "pymdownx.blocks.details": (opts) => {
+        opts.blocks = true;
+    },
+    "pymdownx.blocks.tab": (opts) => {
+        opts.blocks = true;
+    },
+    "mdx_include": (opts) => {
+        if (!opts.fileInclude)
+            opts.fileInclude = { root: "." };
+    },
+    "markdown_include_variants": (opts) => {
+        if (!opts.fileInclude)
+            opts.fileInclude = { root: "." };
+        if (!opts.variants)
+            opts.variants = { docsDir: "." };
+    },
+};
+/**
+ * Build plugin options from a mkdocs.yml `markdown_extensions` array.
+ * Each entry can be a string or an object with a single key.
+ */
+export function configureFromMkdocs(extensions) {
+    const opts = {
+        admonitions: false,
+        tabs: false,
+        keys: false,
+        snippets: false,
+        annotations: false,
+    };
+    for (const ext of extensions) {
+        const name = typeof ext === "string" ? ext : Object.keys(ext)[0];
+        EXTENSION_MAP[name]?.(opts);
+    }
+    return opts;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/inline-walker.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Inline token walker — converts markdown-it inline tokens into InlineNode[].
+ *
+ * Walks tokens left-to-right maintaining an annotation stack (bold/italic/
+ * strikethrough) and a container stack for links. Emits InlineNode spans
+ * as it encounters content tokens.
+ *
+ * Formatting is flat annotations on text spans (Notion model), not nested
+ * elements. `{ bold: true, italic: true }` instead of `<strong><em>`.
+ */
+import type Token from "markdown-it/lib/token.mjs";
+import type { InlineNode } from "@dogsbay/types";
+/**
+ * Convert markdown-it inline token children into structured InlineNode[].
+ */
+export declare function walkInlineTokens(tokens: Token[] | null): InlineNode[];
+//# sourceMappingURL=inline-walker.d.ts.map

package/dist/inline-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-walker.d.ts","sourceRoot":"","sources":["../src/inline-walker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AACnD,OAAO,KAAK,EACV,UAAU,EAWX,MAAM,gBAAgB,CAAC;AAQxB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,GAAG,UAAU,EAAE,CA2KrE"}