@dogsbay/format-mdx 0.2.0-beta.10 → 0.2.0-beta.102

package/dist/mintlify-openapi.js

@@ -0,0 +1,357 @@
+/**
+ * Mintlify OpenAPI page generation.
+ *
+ * A Mintlify API-reference page is often just frontmatter — no body:
+ *
+ *   ---
+ *   openapi: post /partners/ban
+ *   sidebarTitle: Ban partner
+ *   ---
+ *
+ * The page content (endpoint card, params, request/response) is generated by
+ * Mintlify from the OpenAPI spec declared in `docs.json` (`api.openapi`, a URL
+ * or a local file). Without resolving that directive, every such page imports
+ * blank. This module reads the spec once and hands back the `endpoint` TreeNode
+ * for a given `METHOD path`, reusing `@dogsbay/format-openapi` (which already
+ * maps operations to endpoint nodes the Astro serializer renders as full API
+ * pages).
+ */
+import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { join, resolve as resolvePath, dirname, basename, sep } from "node:path";
+import { parseOpenApiSpec } from "@dogsbay/format-openapi";
+const HTTP_METHODS = new Set([
+    "get",
+    "post",
+    "put",
+    "patch",
+    "delete",
+    "head",
+    "options",
+    "trace",
+]);
+/**
+ * The OpenAPI spec reference declared in a Mintlify config, or null. Reads
+ * `docs.json` / `mint.json` `api.openapi` (string, or first of an array) and the
+ * legacy top-level `openapi`. Only an `http(s)://` value is a URL; everything
+ * else — including a ROOT-relative path like `/api-reference/openapi.json`,
+ * which Mintlify resolves against the docs root, not the filesystem root — is
+ * resolved against `source`.
+ */
+export function mintlifyOpenApiSpecRef(source) {
+    const config = readConfig(source);
+    if (!config)
+        return null;
+    const ref = firstString(config.api?.openapi) ?? firstString(config.openapi) ?? null;
+    return ref ? resolveSpecRef(source, ref) : null;
+}
+/** Is `abs` inside `root` once symlinks are resolved? Separator-aware. */
+function withinRoot(abs, root) {
+    const real = (p) => {
+        try {
+            return realpathSync(p);
+        }
+        catch {
+            const parent = dirname(p);
+            return parent === p ? p : join(real(parent), basename(p));
+        }
+    };
+    const realRoot = real(resolvePath(root));
+    const realAbs = real(resolvePath(abs));
+    return realAbs === realRoot || realAbs.startsWith(realRoot + sep);
+}
+/**
+ * A spec ref → a URL, a source-relative filesystem path, or null when it is
+ * not allowed.
+ *
+ * Two refusals, both silent-by-default before:
+ *
+ *  - **Escaping the corpus.** `join(source, ref.replace(/^\//, ""))` strips a
+ *    leading slash but leaves `../` intact, so `openapi: "/../../secrets.json
+ *    GET /x"` read a file outside the docs root and put its contents into the
+ *    imported page. The check now compares realpaths and requires a separator,
+ *    matching the include resolver in `cli/src/commands/convert.ts`.
+ *  - **A page naming a URL.** Only a config-declared spec may be fetched. A
+ *    page-declared `https://…` made the converter issue a request from
+ *    wherever it runs — a CI runner or a hosted service sits inside a network
+ *    the repo's author cannot otherwise reach.
+ */
+function resolveSpecRef(source, ref, origin = "config") {
+    if (/^https?:\/\//.test(ref)) {
+        if (origin === "page") {
+            console.warn(`  warning: ignoring OpenAPI spec URL declared in page frontmatter ` +
+                `(${ref}) — only docs.json/mint.json may name a remote spec.`);
+            return null;
+        }
+        return ref;
+    }
+    const abs = join(source, ref.replace(/^\//, ""));
+    if (!withinRoot(abs, source)) {
+        console.warn(`  warning: ignoring OpenAPI spec path that escapes the docs root (${ref}).`);
+        return null;
+    }
+    return abs;
+}
+/**
+ * Fetch the raw spec document, unparsed.
+ *
+ * An OpenAPI spec is a CANONICAL SOURCE ARTIFACT, not prose: round-tripping it
+ * through the TreeNode IR is lossy by construction ($ref/component schemas
+ * inline, security schemes and callbacks vanish). Exporters that can consume a
+ * spec directly should pass THIS through rather than rebuild it from endpoint
+ * nodes. Returns null when the spec cannot be read.
+ */
+export async function readOpenApiSpecSource(specRef) {
+    try {
+        let text;
+        if (/^https?:\/\//.test(specRef)) {
+            const res = await fetch(specRef, { signal: AbortSignal.timeout(30_000) });
+            if (!res.ok)
+                return null;
+            text = await res.text();
+        }
+        else {
+            text = readFileSync(specRef, "utf-8");
+        }
+        const base = specRef.split(/[?#]/)[0].split("/").pop() || "openapi";
+        const filename = /\.(json|ya?ml)$/i.test(base)
+            ? base
+            : `${base}.${text.trimStart().startsWith("{") ? "json" : "yaml"}`;
+        return { text, filename };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a spec into an endpoint map. A fetch/parse error must degrade to blank
+ * pages (never crash the import), but is reported via `loadError` rather than
+ * silently swallowed.
+ */
+export async function buildMintlifyEndpointMap(specRef) {
+    const map = new Map();
+    try {
+        const { pages } = await parseOpenApiSpec(specRef);
+        for (const page of pages) {
+            const ep = page.tree.find((n) => n.type === "endpoint");
+            if (!ep)
+                continue;
+            const method = String(ep.props?.method ?? "").toLowerCase();
+            const path = String(ep.props?.path ?? "");
+            if (method && path)
+                map.set(`${method} ${path}`, [ep]);
+        }
+        return { map, loadError: null };
+    }
+    catch (err) {
+        return { map, loadError: err instanceof Error ? err.message : String(err) };
+    }
+}
+/**
+ * Normalise a page's `openapi` frontmatter value to a map key, or null when the
+ * page is not an OpenAPI page. Accepts `"post /partners/ban"` (method + path);
+ * a leading named-spec token (`"api POST /x"`) is tolerated by taking the last
+ * two whitespace-separated tokens.
+ */
+export function openApiPageKey(value) {
+    if (typeof value !== "string")
+        return null;
+    const parts = value.trim().split(/\s+/);
+    if (parts.length < 2)
+        return null;
+    const path = parts[parts.length - 1];
+    const method = parts[parts.length - 2].toLowerCase();
+    if (!HTTP_METHODS.has(method))
+        return null;
+    if (!path.startsWith("/"))
+        return null;
+    return `${method} ${path}`;
+}
+/**
+ * The spec a PAGE names in its own `openapi:` frontmatter, or null.
+ *
+ * Mintlify lets a page point at a specific spec inline:
+ *
+ *     openapi: "/openapi.json GET /project/update-status/{statusId}"
+ *
+ * `openApiPageKey` already tolerates that leading token (it takes the last two
+ * tokens); this reads the token itself, which nothing did. A site whose
+ * `docs.json` has no `api.openapi` key therefore resolved NO endpoints even
+ * though every page stated exactly which spec to use — measured on Mintlify's
+ * own documentation: 100 pages imported without their endpoint content and 20
+ * of them came out completely blank, next to an `openapi.json` sitting in the
+ * repo root.
+ *
+ * Resolved the same way as a config-declared ref: a leading `/` is the DOCS
+ * root, not the filesystem root.
+ */
+export function openApiPageSpecRef(source, value) {
+    if (typeof value !== "string")
+        return null;
+    const parts = value.trim().split(/\s+/);
+    // Three tokens minimum: <spec> <METHOD> <path>. Two is method+path with no
+    // spec, which is the config-declared case.
+    if (parts.length < 3)
+        return null;
+    const ref = parts[0];
+    // Only treat it as a spec when it looks like one — a URL, a path, or a
+    // json/yaml filename. Anything else is a NAMED spec (Mintlify also allows
+    // `openapi: "api POST /x"` referring to a named entry), which this does not
+    // resolve and which the existing key parser already tolerates.
+    const looksLikeSpec = /^https?:\/\//.test(ref) || ref.startsWith("/") || /\.(json|ya?ml)$/i.test(ref);
+    return looksLikeSpec ? resolveSpecRef(source, ref, "page") : null;
+}
+/**
+ * The vault/site slug for a nav-referenced OpenAPI operation (a `pages` string
+ * of the form `"POST /api/generate"` under a tab/group that declares an
+ * `openapi` spec). The NAV and the GENERATED PAGE both call this, so their
+ * href and slug always agree. Path-based (`/api/generate` → `api/generate`) for
+ * clean URLs; same-path-different-method operations would collide — rare, and
+ * documented (ollama and typical REST doc sets use unique paths per page).
+ */
+export function openApiRefSlug(path) {
+    return path.replace(/^\//, "").replace(/\/$/, "");
+}
+/**
+ * Every distinct OpenAPI spec a Mintlify config references — the top-level
+ * `api.openapi` AND any `openapi` declared on a nav container (tab/group).
+ *
+ * Both are real source artifacts. Capturing only the top-level one meant a site
+ * like ollama (whose spec is declared on an "API Reference" tab) fell back to
+ * lossy reconstruction despite having a perfectly good spec on disk.
+ */
+export function collectMintlifyOpenApiSpecRefs(source, 
+/** Spec refs named by individual pages' `openapi:` frontmatter. */
+pageSpecRefs = []) {
+    const config = readConfig(source);
+    const refs = new Set(pageSpecRefs);
+    if (!config)
+        return [...refs];
+    const top = firstString(config.api?.openapi) ?? firstString(config.openapi);
+    const topResolved = top ? resolveSpecRef(source, top) : null;
+    if (topResolved)
+        refs.add(topResolved);
+    if (config.navigation) {
+        const found = new Map();
+        walkForOpenApiRefs(config.navigation, undefined, source, found);
+        for (const ref of found.keys())
+            refs.add(ref);
+    }
+    return [...refs];
+}
+/**
+ * Generate an ExportPage for every OpenAPI operation referenced ONLY by the nav
+ * (a `METHOD /path` `pages` string under a container that declares `openapi`) —
+ * these pages exist in no `.mdx` file (unlike the frontmatter case), so without
+ * this the nav links are dead and the API section is empty. ollama's docs.json
+ * is exactly this shape (an "Endpoints" group of 12 such strings under a tab
+ * with `openapi: /openapi.yaml`).
+ */
+export async function collectMintlifyOpenApiNavPages(source) {
+    const config = readConfig(source);
+    if (!config?.navigation)
+        return { pages: [], loadError: null };
+    const globalSpec = firstString(config.api?.openapi) ?? firstString(config.openapi);
+    // refs: specRef → set of "method path" keys referenced under it.
+    const refs = new Map();
+    walkForOpenApiRefs(config.navigation, globalSpec, source, refs);
+    if (refs.size === 0)
+        return { pages: [], loadError: null };
+    const pages = [];
+    const seen = new Set();
+    let loadError = null;
+    for (const [specRef, keys] of refs) {
+        const { map, loadError: err } = await buildMintlifyEndpointMap(specRef);
+        if (err)
+            loadError = err;
+        for (const key of keys) {
+            const endpoint = map.get(key);
+            if (!endpoint)
+                continue;
+            const path = key.slice(key.indexOf(" ") + 1);
+            const slug = openApiRefSlug(path);
+            if (seen.has(slug))
+                continue;
+            seen.add(slug);
+            const ep = endpoint[0];
+            const title = ep.props?.summary ||
+                `${String(ep.props?.method ?? "").toUpperCase()} ${path}`;
+            pages.push({ slug, title, tree: endpoint, headings: [] });
+        }
+    }
+    return { pages, loadError };
+}
+/** Walk a navigation node, tracking the inherited `openapi` spec, collecting
+ *  `METHOD /path` page strings keyed by their governing (resolved) spec ref. */
+function walkForOpenApiRefs(node, inheritedSpec, source, out, inPages = false) {
+    if (Array.isArray(node)) {
+        for (const e of node)
+            walkForOpenApiRefs(e, inheritedSpec, source, out, inPages);
+        return;
+    }
+    if (!node || typeof node !== "object") {
+        // A bare `METHOD /path` string — ONLY meaningful inside a `pages` array.
+        // Scanning every string made prose like `"See POST /users"` in a tab
+        // description generate a phantom API page.
+        if (!inPages)
+            return;
+        const key = typeof node === "string" ? openApiPageKey(node) : null;
+        if (key && inheritedSpec) {
+            const resolved = resolveSpecRef(source, inheritedSpec);
+            if (resolved) {
+                if (!out.has(resolved))
+                    out.set(resolved, new Set());
+                out.get(resolved).add(key);
+            }
+        }
+        return;
+    }
+    const declared = firstString(node.openapi);
+    const spec = declared ?? inheritedSpec;
+    // A container that DECLARES a spec registers it even when its children are
+    // ordinary .mdx pages — otherwise a nav-declared spec was only captured when
+    // a `METHOD /path` string happened to sit under it.
+    if (declared) {
+        const resolved = resolveSpecRef(source, declared);
+        if (resolved && !out.has(resolved))
+            out.set(resolved, new Set());
+    }
+    for (const [key, v] of Object.entries(node)) {
+        if (v && typeof v === "object") {
+            walkForOpenApiRefs(v, spec, source, out, key === "pages" || inPages);
+        }
+        else if (typeof v === "string" && key === "pages") {
+            walkForOpenApiRefs(v, spec, source, out, true);
+        }
+    }
+}
+function readConfig(source) {
+    for (const name of ["docs.json", "mint.json"]) {
+        const p = join(source, name);
+        if (existsSync(p)) {
+            try {
+                return JSON.parse(readFileSync(p, "utf-8"));
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    return null;
+}
+function firstString(v) {
+    if (typeof v === "string" && v.length > 0)
+        return v;
+    if (Array.isArray(v)) {
+        for (const e of v) {
+            const s = firstString(typeof e === "object" && e ? e.openapi ?? e.source : e);
+            if (s)
+                return s;
+        }
+    }
+    if (v && typeof v === "object") {
+        // `api.openapi` may be `{ source: "..." }` in some configs.
+        return firstString(v.source ?? v.openapi);
+    }
+    return undefined;
+}
+//# sourceMappingURL=mintlify-openapi.js.map

package/dist/mintlify-openapi.js.map

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

package/dist/mintlify.d.ts

@@ -0,0 +1,3 @@
+import type { MdxAdapter } from "./adapter.js";
+export declare const mintlifyAdapter: MdxAdapter;
+//# sourceMappingURL=mintlify.d.ts.map

package/dist/mintlify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mintlify.d.ts","sourceRoot":"","sources":["../src/mintlify.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,cAAc,CAAC;AA8KjE,eAAO,MAAM,eAAe,EAAE,UAoB7B,CAAC"}

package/dist/mintlify.js

@@ -0,0 +1,196 @@
+/**
+ * `<Update label="2.1.218" description="July 22, 2026">` wraps every release
+ * in a Mintlify changelog, with the entries as ordinary markdown bullets
+ * inside.
+ *
+ * Unmapped it is PRESERVED as raw MDX, which means its inner markdown is
+ * never parsed — a 5,000-line changelog renders as one run-on paragraph of
+ * literal `*` characters (observed: 4,000+ bullets, zero list items). Mapping
+ * it with `children: "blocks"` is what makes the bullets parse.
+ *
+ * `details` rather than a callout: a changelog is hundreds of releases, and
+ * collapsing each one is the difference between a usable page and a wall.
+ * Both attributes ride into the title, because a version without its date
+ * loses the thing a reader scans for.
+ */
+const update = {
+    type: "details",
+    container: true,
+    children: "blocks",
+    propsFromAttrs: (attrs) => {
+        const label = attrs.label?.trim();
+        const description = attrs.description?.trim();
+        const title = [label, description].filter(Boolean).join(" — ");
+        // `<Update>` also carries `tags={[…]}` and `rss={{ title, description }}`.
+        // Reading only label/description dropped them with no ledger entry, and on
+        // the raw path they had survived byte-exact — 71 tags on one changelog page
+        // alone. Carried through as props so the information is not lost; an
+        // exporter that has nowhere to put them declares that in its capabilities.
+        const extra = {};
+        for (const key of ["tags", "rss"]) {
+            const value = attrs[key]?.trim();
+            if (value)
+                extra[key] = value;
+        }
+        return { variant: "note", ...(title ? { title } : {}), ...extra };
+    },
+};
+/**
+ * Self-closing marketing/experiment wrappers. Both carry NO documentation
+ * content — `<ContactSalesCard surface="bedrock" />` is a CTA, and
+ * `<Experiment flag="…" treatment={<ContactSalesCard …/>} />` is an A/B
+ * wrapper whose treatment is that same CTA.
+ *
+ * They were already being dropped by the built-in strip list; declaring them
+ * here makes the drop an ADAPTER DECISION recorded in the ledger, rather than
+ * a side effect of a component nobody had considered.
+ */
+/**
+ * `container: true` matches the BUILTIN strip entries for the same tags
+ * (`parse.ts` AgentInstructions/Experiment/ContactSalesCard). With
+ * `container: false` a paired `<Experiment>…</Experiment>` had its body kept
+ * and a stray `</Experiment>` html node leaked into the tree — invisible while
+ * the adapter was opt-in, and the default for every Mintlify site once adapter
+ * auto-selection landed.
+ */
+const stripped = { type: "", container: true, strip: true };
+/**
+ * `<ParamField body="url" type="string" required>` / `<ResponseField …>` — the
+ * parameter vocabulary of every hand-written Mintlify API page.
+ *
+ * Unmapped these were PRESERVED as `mdx-raw`, which is honest but not useful:
+ * an exporter that cannot render `<ParamField>` strips the tag and keeps only
+ * the description, so the reader is left with a page of unattributed sentences
+ * — the parameter NAME, TYPE, REQUIRED flag and DEFAULT all vanish. On the dub
+ * corpus that is 331 fields across the API reference.
+ *
+ * The mapping is evidence-backed, not guessed: the attribute set is fixed and
+ * documented, and the name arrives in whichever of `body`/`query`/`path`/
+ * `header` names the location — so the location is real information too, and
+ * rides into the term rather than being discarded.
+ *
+ * `deflist` because that IS the shape: a term (the parameter) and its
+ * definition (the prose). Every exporter already handles it, and the ones that
+ * lack a definition-list syntax degrade it visibly (bold term + indented body)
+ * rather than dropping it.
+ */
+const PARAM_LOCATIONS = ["body", "query", "path", "header"];
+/**
+ * `<Expandable title="properties">` wraps the NESTED fields of an object
+ * parameter. Unmapped it was preserved as raw MDX, so every exporter that
+ * cannot render it stripped the tag and orphaned the children — on dub that is
+ * 198 of 458 fields (43%), and 568 of 1753 (32%) on mintlify-docs, each losing
+ * its name and type exactly like the top-level fields did before ParamField
+ * was mapped.
+ *
+ * It has no content of its own beyond the title, so it UNWRAPS: its children
+ * are already `deflist`s and belong in the flow. The nesting is conveyed by the
+ * dotted field names Mintlify authors use (`user.name`), so flattening reads
+ * correctly rather than losing a distinction.
+ */
+const expandable = {
+    type: "",
+    container: true,
+    toNode: (_attrs, innerSource, ctx) => ctx.parseBlocks(innerSource),
+};
+const paramField = {
+    type: "deflist",
+    container: true,
+    toNode: (attrs, innerSource, ctx) => {
+        const location = PARAM_LOCATIONS.find((k) => attrs[k] !== undefined);
+        const name = (location ? attrs[location] : attrs.name) ?? "";
+        if (!name)
+            return "preserve";
+        const bits = [];
+        if (attrs.type)
+            bits.push(attrs.type);
+        if (location)
+            bits.push(location);
+        // A bare attribute arrives as the string "true".
+        if (attrs.required === "true" || attrs.required === "")
+            bits.push("required");
+        if (attrs.deprecated === "true" || attrs.deprecated === "")
+            bits.push("deprecated");
+        if (attrs.default)
+            bits.push(`default: ${attrs.default}`);
+        const body = ctx.parseBlocks(innerSource);
+        const dt = {
+            type: "dt",
+            inline: [
+                { type: "code", text: name },
+                ...(bits.length > 0 ? [{ type: "text", text: ` — ${bits.join(", ")}` }] : []),
+            ],
+        };
+        return {
+            type: "deflist",
+            children: [dt, ...(body.length > 0 ? [{ type: "dd", children: body }] : [])],
+        };
+    },
+};
+/**
+ * `<HeroCard filename title description href />` — a linked image card that
+ * Mintlify's own docs define IN THE PAGE:
+ *
+ *     export const HeroCard = ({ filename, title, description, href }) => {
+ *       return (<a href={href}><img src={…}/>…</a>)
+ *     }
+ *
+ * The definition is a multi-statement arrow, so the snippet substitution that
+ * handles `props => (<JSX/>)` cannot expand it, and every USAGE fell through to
+ * `mdx-raw` — 32 of them across the corpus, each rendering as a code block of
+ * its own JSX on the site's front page.
+ *
+ * Mapped rather than expanded: a Dogsbay `card` carries the title, description
+ * and href faithfully. What is lost is the hero IMAGE, whose src is built by
+ * template-interpolating `filename` into a GitHub raw URL — that is JavaScript,
+ * and reconstructing it would hard-code one site's asset convention into a
+ * general adapter. The card is the content; the image was decoration.
+ */
+/**
+ * IT DECLINES ANYTHING THAT IS NOT THAT SHAPE. `HeroCard` is not part of
+ * Mintlify's documented vocabulary the way `Update`/`ParamField`/`Expandable`
+ * are — it is a component one site defines in its own pages, and the name is
+ * generic enough that another site will define its own with different props
+ * (`image`, `cta`, `variant`). Coercing those into a card whose title and href
+ * are empty would be worse than leaving them raw, so an unrecognised shape
+ * returns "preserve" — byte-exact `mdx-raw` plus a ledger entry — and a site
+ * that wants its own mapping uses `--components`, which exists for exactly this.
+ */
+const heroCard = {
+    type: "card",
+    container: false,
+    toNode: (attrs) => {
+        const title = attrs.title?.trim();
+        const href = attrs.href?.trim();
+        // The documented shape carries at least a title and a destination.
+        if (!title || !href)
+            return "preserve";
+        const description = attrs.description?.trim();
+        return {
+            type: "card",
+            props: { title, href, ...(description ? { description } : {}) },
+        };
+    },
+};
+export const mintlifyAdapter = {
+    name: "mintlify",
+    components: {
+        HeroCard: heroCard,
+        Update: update,
+        ParamField: paramField,
+        Expandable: expandable,
+        ResponseField: paramField,
+        ContactSalesCard: stripped,
+        Experiment: stripped,
+    },
+    // NOT self-closing, despite an earlier note here saying so. The segmenter
+    // decides pairing from THIS list, not from a mapping's `container` flag, so
+    // declaring them self-closing meant `<Experiment name="x">…</Experiment>`
+    // was never paired: the body stayed in the page and the stray closing tag
+    // was emitted as raw HTML, while the ledger recorded it as "stripped".
+    // Flipping `container: true` on the mapping did not fix it, because nothing
+    // reads `container` at segmentation time. The builtin (no-adapter) path
+    // handled these correctly, so the declaration was a regression against it.
+    selfClosingTags: [],
+};
+//# sourceMappingURL=mintlify.js.map

package/dist/mintlify.js.map

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

package/dist/nav-extract.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Static sidebar extraction from a hardcoded Fumadocs page tree.
+ *
+ * Passing a hand-built `PageTree.Root` to `DocsLayout tree={…}` is a
+ * documented first-class Fumadocs pattern; sites that use it (better-auth's
+ * sidebar-content.tsx) keep the REAL sidebar in a TSX data literal and let
+ * meta.json go stale. Page trees must be serializable by design, so the
+ * literal is statically readable: this module captures the exported array
+ * and maps it to NavItem[] — no execution, ever (icons and other JSX
+ * values ride through the balanced scanner and are dropped).
+ *
+ * The mapping is shape-tolerant rather than better-auth-specific: an entry
+ * contributes a nav item when it has a string `title`/`name`/`label`;
+ * `href`/`url` become the link; the first array-valued key among
+ * `list`/`subpages`/`children`/`items`/`pages` becomes the children.
+ *
+ * Href prefix: sites hardcode their mount point (`/docs/introduction`).
+ * When every internal href shares the same first path segment it is
+ * stripped and replaced with the importer's own `hrefPrefix` (auto-detected
+ * — pass `stripPrefix` to override).
+ */
+import type { NavItem } from "@dogsbay/types";
+export interface NavExtractOptions {
+    /** Name of the exported array (default "contents"). */
+    exportName?: string;
+    /** Prefix for emitted hrefs (e.g. "/docs" of the TARGET site). */
+    hrefPrefix?: string;
+    /**
+     * Leading path segment to strip from the source's hardcoded hrefs
+     * (e.g. "/docs"). Auto-detected when omitted: stripped when every
+     * internal href shares the same first segment.
+     */
+    stripPrefix?: string;
+}
+/**
+ * Extract NavItem[] from TSX source containing an exported data-literal
+ * page tree. Returns null when the export is missing or doesn't scan —
+ * callers fall back to the meta.json walk (never guess).
+ */
+export declare function extractNavFromTsx(source: string, opts?: NavExtractOptions): NavItem[] | null;
+/** File-reading convenience for the CLI layer. */
+export declare function extractNavFromTsxFile(filePath: string, opts?: NavExtractOptions): NavItem[] | null;
+//# sourceMappingURL=nav-extract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nav-extract.d.ts","sourceRoot":"","sources":["../src/nav-extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAI9C,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmFD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,iBAAsB,GAC3B,OAAO,EAAE,GAAG,IAAI,CA6BlB;AAED,kDAAkD;AAClD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,EAAE,GAAG,IAAI,CAMlB"}