@dogsbay/format-mdx 0.2.0-beta.12 → 0.2.0-beta.121

package/dist/js-scan.js

@@ -0,0 +1,124 @@
+/**
+ * Shared quote/bracket-aware scanning helpers for statically reading JS/TSX
+ * data literals — no execution, ever.
+ *
+ * The one subtlety: apostrophes and quotes inside JSX TEXT content are not
+ * string delimiters (`<p>';--</p>` — better-auth's actual SQL-joke icon —
+ * breaks a naive tracker). A quote only OPENS a string in a value position:
+ * when the previous non-whitespace character is one that can precede a JS
+ * expression (`= ( [ { , : ? & | ! ;` or a `=>` arrow) or at the start of
+ * the scanned span. A bare `>` (JSX tag close) is NOT a value position —
+ * that is exactly where JSX text apostrophes live.
+ */
+const VALUE_POSITION_CHARS = new Set([
+    "=", "(", "[", "{", ",", ":", "?", "&", "|", "!", ";", "+", "-", "*", "%",
+]);
+/** Is src[i] a quote that starts a string (value position)? */
+export function isQuoteStart(src, i, spanStart) {
+    const ch = src[i];
+    if (ch !== '"' && ch !== "'" && ch !== "`")
+        return false;
+    for (let k = i - 1; k >= spanStart; k--) {
+        const prev = src[k];
+        if (prev === " " || prev === "\t" || prev === "\n" || prev === "\r")
+            continue;
+        if (prev === ">")
+            return src[k - 1] === "="; // `=>` arrow body, not JSX close
+        return VALUE_POSITION_CHARS.has(prev);
+    }
+    return true; // start of span
+}
+/**
+ * Scan a balanced literal starting at src[start] (which must be at or
+ * before the opening `{`/`[`/`(`). Returns the end index (exclusive, past
+ * the closing bracket) or -1 when the span never balances.
+ */
+export function scanBalancedLiteral(src, start) {
+    let depth = 0;
+    let started = false;
+    let quote = null;
+    for (let i = start; i < src.length; i++) {
+        const ch = src[i];
+        if (quote) {
+            if (ch === quote && src[i - 1] !== "\\")
+                quote = null;
+            continue;
+        }
+        if (isQuoteStart(src, i, start)) {
+            quote = ch;
+            continue;
+        }
+        if (ch === "{" || ch === "[" || ch === "(") {
+            depth++;
+            started = true;
+        }
+        else if (ch === "}" || ch === "]" || ch === ")") {
+            depth--;
+            if (started && depth === 0)
+                return i + 1;
+        }
+    }
+    return -1;
+}
+/**
+ * Capture the right-hand-side literal of a `const NAME = …` /
+ * `export const NAME = …` declaration (type annotations tolerated).
+ * Returns the raw literal text or null.
+ */
+export function captureConstLiteral(source, name) {
+    const re = new RegExp(`(?:^|\\n)\\s*(?:export\\s+)?const\\s+${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*(?::[^=]*?)?=\\s*`);
+    const m = re.exec(source);
+    if (!m)
+        return null;
+    const start = m.index + m[0].length;
+    const end = scanBalancedLiteral(source, start);
+    if (end === -1)
+        return null;
+    return source.slice(start, end).trim();
+}
+/** Unquote a raw JS value for display; non-literals pass through as source. */
+export function displayJsValue(raw) {
+    const t = raw.trim();
+    const m = t.match(/^(["'`])([\s\S]*)\1$/);
+    return m ? m[2] : t;
+}
+/**
+ * Split the top level of a balanced span into comma-separated pieces.
+ * `src` must already be the INNER text (without the outer brackets).
+ * Returns null when the span doesn't scan.
+ */
+export function splitTopLevel(src) {
+    const pieces = [];
+    let depth = 0;
+    let quote = null;
+    let start = 0;
+    for (let i = 0; i < src.length; i++) {
+        const ch = src[i];
+        if (quote) {
+            if (ch === quote && src[i - 1] !== "\\")
+                quote = null;
+            continue;
+        }
+        if (isQuoteStart(src, i, start)) {
+            quote = ch;
+            continue;
+        }
+        if (ch === "{" || ch === "[" || ch === "(")
+            depth++;
+        else if (ch === "}" || ch === "]" || ch === ")")
+            depth--;
+        else if (ch === "," && depth === 0) {
+            const piece = src.slice(start, i).trim();
+            if (piece)
+                pieces.push(piece);
+            start = i + 1;
+        }
+    }
+    if (quote || depth !== 0)
+        return null;
+    const last = src.slice(start).trim();
+    if (last)
+        pieces.push(last);
+    return pieces;
+}
+//# sourceMappingURL=js-scan.js.map

package/dist/js-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-scan.js","sourceRoot":"","sources":["../src/js-scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAC1E,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,CAAS,EAAE,SAAiB;IACpE,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAC9E,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,iCAAiC;QAC9E,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,gBAAgB;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,KAAa;IAC5D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI;gBAAE,KAAK,GAAG,IAAI,CAAC;YACtD,SAAS;QACX,CAAC;QACD,IAAI,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;YAAC,KAAK,GAAG,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAC1D,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,KAAK,EAAE,CAAC;YAAC,OAAO,GAAG,IAAI,CAAC;QAAC,CAAC;aACnE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAChD,KAAK,EAAE,CAAC;YACR,IAAI,OAAO,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,IAAY;IAC9D,MAAM,EAAE,GAAG,IAAI,MAAM,CACnB,wCAAwC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,uBAAuB,CAC3G,CAAC;IACF,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI;gBAAE,KAAK,GAAG,IAAI,CAAC;YACtD,SAAS;QACX,CAAC;QACD,IAAI,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;YAAC,KAAK,GAAG,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAC1D,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aAC/C,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACpD,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,IAAI;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/meta-nav.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Fumadocs `meta.json` → NavItem[] builder.
+ *
+ * Fumadocs organizes navigation with per-folder `meta.json` files:
+ *
+ *   { "title": "Guide", "root": true, "pages": ["introduction", "...",
+ *     "email-password/sign-in-and-sign-up", "[GitHub](https://…)"] }
+ *
+ * Supported `pages` entry forms:
+ *   - "name"                — file (name.mdx / name.md) or folder
+ *   - "nested/path"         — page inside a subfolder
+ *   - "..."                 — rest expansion (unlisted items, alphabetical)
+ *   - "z...a"               — rest expansion, reverse alphabetical
+ *   - "!name"               — exclude from rest expansion
+ *   - "[Label](https://…)"  — external link
+ *   - "---Label---"         — separator (skipped: NavItem has no separator)
+ *
+ * Folders with `root: true` are Fumadocs "root folders" (tab-like separate
+ * trees); they are rendered as ordinary top-level groups here.
+ */
+import type { NavItem } from "@dogsbay/types";
+export interface FumadocsNavOptions {
+    /** Prefix for hrefs (e.g. "/docs"). */
+    hrefPrefix?: string;
+}
+/** Detect a Fumadocs content directory: meta.json + .md/.mdx pages. */
+export declare function detectFumadocsDir(path: string): boolean;
+export declare function buildFumadocsNav(rootDir: string, opts?: FumadocsNavOptions): NavItem[];
+//# sourceMappingURL=meta-nav.d.ts.map

package/dist/meta-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-nav.d.ts","sourceRoot":"","sources":["../src/meta-nav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAS9C,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,kBAAuB,GAC5B,OAAO,EAAE,CAGX"}

package/dist/meta-nav.js

@@ -0,0 +1,194 @@
+/**
+ * Fumadocs `meta.json` → NavItem[] builder.
+ *
+ * Fumadocs organizes navigation with per-folder `meta.json` files:
+ *
+ *   { "title": "Guide", "root": true, "pages": ["introduction", "...",
+ *     "email-password/sign-in-and-sign-up", "[GitHub](https://…)"] }
+ *
+ * Supported `pages` entry forms:
+ *   - "name"                — file (name.mdx / name.md) or folder
+ *   - "nested/path"         — page inside a subfolder
+ *   - "..."                 — rest expansion (unlisted items, alphabetical)
+ *   - "z...a"               — rest expansion, reverse alphabetical
+ *   - "!name"               — exclude from rest expansion
+ *   - "[Label](https://…)"  — external link
+ *   - "---Label---"         — separator (skipped: NavItem has no separator)
+ *
+ * Folders with `root: true` are Fumadocs "root folders" (tab-like separate
+ * trees); they are rendered as ordinary top-level groups here.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+/** Detect a Fumadocs content directory: meta.json + .md/.mdx pages. */
+export function detectFumadocsDir(path) {
+    try {
+        if (!existsSync(join(path, "meta.json")))
+            return false;
+        return readdirSync(path).some((e) => e.endsWith(".mdx") || e.endsWith(".md"));
+    }
+    catch {
+        return false;
+    }
+}
+export function buildFumadocsNav(rootDir, opts = {}) {
+    const prefix = (opts.hrefPrefix ?? "").replace(/\/$/, "");
+    return walkDir(rootDir, rootDir, prefix);
+}
+function readMeta(dir) {
+    const metaPath = join(dir, "meta.json");
+    if (!existsSync(metaPath))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(metaPath, "utf-8"));
+        return parsed && typeof parsed === "object" ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function pageTitle(filePath, fallback) {
+    try {
+        const source = readFileSync(filePath, "utf-8");
+        const match = /^---\n([\s\S]*?)\n---/.exec(source);
+        if (match) {
+            const fm = YAML.parse(match[1]);
+            if (fm && typeof fm.title === "string")
+                return fm.title;
+        }
+    }
+    catch {
+        // fall through to the filename
+    }
+    return fallback;
+}
+function humanize(name) {
+    return name
+        .replace(/[-_]/g, " ")
+        .replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function resolvePageFile(dir, name) {
+    for (const ext of [".mdx", ".md"]) {
+        const p = join(dir, name + ext);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+function slugFor(root, dir, name) {
+    const rel = join(dir, name).slice(root.length).replace(/\\/g, "/").replace(/^\//, "");
+    return rel;
+}
+/** One nav item for a file entry, or null when the file doesn't exist. */
+function fileItem(root, dir, name, prefix) {
+    const filePath = resolvePageFile(dir, name);
+    if (!filePath)
+        return null;
+    const slug = slugFor(root, dir, name);
+    // Root index → "/"; a subfolder's index → the folder path itself.
+    const href = slug === "index" ? `${prefix}/` : `${prefix}/${slug.replace(/\/index$/, "")}`;
+    return { label: pageTitle(filePath, humanize(name)), href };
+}
+const EXTERNAL_LINK_RE = /^\[(.*)\]\((.*)\)$/;
+const SEPARATOR_RE = /^---.*---$/;
+function walkDir(root, dir, prefix) {
+    const meta = readMeta(dir);
+    // Inventory of this folder's files and subfolders.
+    const files = new Set();
+    const folders = new Set();
+    for (const entry of readdirSync(dir)) {
+        const full = join(dir, entry);
+        if (statSync(full).isDirectory()) {
+            folders.add(entry);
+        }
+        else if ((entry.endsWith(".mdx") || entry.endsWith(".md")) &&
+            entry !== "llms.txt") {
+            files.add(entry.replace(/\.(mdx|md)$/, ""));
+        }
+    }
+    const restItems = (excluded, reverse) => {
+        const names = [...new Set([...files, ...folders])]
+            .filter((n) => !excluded.has(n))
+            .sort();
+        if (reverse)
+            names.reverse();
+        return names.flatMap((n) => itemFor(n));
+    };
+    const itemFor = (name) => {
+        if (folders.has(name)) {
+            const childDir = join(dir, name);
+            const childMeta = readMeta(childDir);
+            const children = walkDir(root, childDir, prefix);
+            if (children.length === 0)
+                return [];
+            return [{ label: childMeta?.title ?? humanize(name), children }];
+        }
+        const item = fileItem(root, dir, name, prefix);
+        return item ? [item] : [];
+    };
+    if (!meta?.pages) {
+        // No meta.json ordering — alphabetical, index first.
+        const excluded = new Set();
+        const items = [];
+        if (files.has("index")) {
+            const idx = fileItem(root, dir, "index", prefix);
+            if (idx)
+                items.push(idx);
+            excluded.add("index");
+        }
+        items.push(...restItems(excluded, false));
+        return items;
+    }
+    const consumed = new Set();
+    const excluded = new Set();
+    // Pre-scan exclusions so "..." earlier in the list still honors them.
+    for (const entry of meta.pages) {
+        if (entry.startsWith("!"))
+            excluded.add(entry.slice(1));
+    }
+    const hasRest = meta.pages.some((e) => e === "..." || e === "z...a");
+    const items = [];
+    for (const entry of meta.pages) {
+        if (entry.startsWith("!"))
+            continue;
+        if (SEPARATOR_RE.test(entry))
+            continue;
+        const linkMatch = EXTERNAL_LINK_RE.exec(entry);
+        if (linkMatch) {
+            items.push({ label: linkMatch[1], href: linkMatch[2] });
+            continue;
+        }
+        if (entry === "..." || entry === "z...a") {
+            items.push(...restItems(new Set([...consumed, ...excluded]), entry === "z...a"));
+            // Everything is consumed after a rest expansion.
+            for (const n of [...files, ...folders])
+                consumed.add(n);
+            continue;
+        }
+        if (entry.includes("/")) {
+            // Page inside a subfolder (e.g. "email-password/sign-in-and-sign-up")
+            const parts = entry.split("/");
+            const name = parts.pop();
+            const subDir = join(dir, ...parts);
+            const item = fileItem(root, subDir, name, prefix);
+            if (item)
+                items.push(item);
+            continue;
+        }
+        consumed.add(entry);
+        items.push(...itemFor(entry));
+    }
+    // Implicit rest expansion: when the meta has no explicit "...",
+    // unlisted files and folders are appended alphabetically instead of
+    // being hidden. Strict Fumadocs hides them — but sites with heavily
+    // customized sidebars (a hand-written page tree overriding meta.json)
+    // often leave meta.json stale, and an IMPORT that silently drops most
+    // pages from the nav loses real structure. Never-drop applies to
+    // navigation too; `!name` exclusions are still honored.
+    if (!hasRest) {
+        items.push(...restItems(new Set([...consumed, ...excluded]), false));
+    }
+    return items;
+}
+//# sourceMappingURL=meta-nav.js.map

package/dist/meta-nav.js.map

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

package/dist/mintlify-nav.d.ts

@@ -0,0 +1,31 @@
+import type { NavItem } from "@dogsbay/types";
+export interface MintlifyNavOptions {
+    /** Prefixed onto every internal href (e.g. a base path). */
+    hrefPrefix?: string;
+}
+/**
+ * True when `dir` looks like a Mintlify docs source: a `docs.json`/`mint.json`
+ * that actually reads as a Mintlify config, plus md/mdx pages. The config sniff
+ * (a `navigation` key or a `mintlify` `$schema`) keeps an unrelated `docs.json`
+ * — e.g. TypeDoc's output — from being claimed by the mdx importer.
+ */
+export declare function detectMintlifyDir(dir: string): boolean;
+/**
+ * Build NavItem[] from a Mintlify config, or null when no config is present or
+ * it declares no navigation.
+ */
+export declare function buildMintlifyNav(source: string, opts?: MintlifyNavOptions): NavItem[] | null;
+/**
+ * Mintlify `redirects` as a source → destination map, `$ref` resolved.
+ *
+ * A docs site accumulates these as pages move, and its OWN pages then link to
+ * the old paths — Mintlify serves the redirect, so the link works and nobody
+ * notices it is stale. On import the redirect does not exist, so those links
+ * 404: measured on Mintlify's own docs, 16 internal links point at a redirect
+ * source, including `/installation` on the front page (→ `/cli/install`).
+ *
+ * `redirects` is itself commonly a `$ref` to a sibling file (121 entries in
+ * `redirects.json` here), so it is resolved the same way as navigation.
+ */
+export declare function mintlifyRedirects(source: string): Record<string, string>;
+//# sourceMappingURL=mintlify-nav.d.ts.map

package/dist/mintlify-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mintlify-nav.d.ts","sourceRoot":"","sources":["../src/mintlify-nav.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAStD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,kBAAuB,GAC5B,OAAO,EAAE,GAAG,IAAI,CAelB;AAyPD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBxE"}