@thallylabs/migrate 0.2.26 → 0.2.27

package/dist/index.js

@@ -9,15 +9,15 @@ import {
   openSync,
   readFileSync as readFileSync6,
   readSync,
-  readdirSync as readdirSync3,
-  realpathSync as realpathSync3,
+  readdirSync as readdirSync4,
+  realpathSync as realpathSync4,
   rmSync as rmSync2,
   statSync
 } from "fs";
 import { createRequire } from "module";
 import { basename as basename3, dirname as dirname4, extname as extname6, isAbsolute as isAbsolute3, posix as posix4, relative as relative6, resolve as resolvePath, sep as sep3 } from "path";
 import { parse as parseYaml6 } from "yaml";
-import * as ts4 from "typescript";
+import * as ts5 from "typescript";
 
 // src/inline-extraction.ts
 import ts from "typescript";
@@ -808,6 +808,7 @@ import { unified } from "unified";
 import { extname } from "path";
 
 // src/path.ts
+import { realpathSync } from "fs";
 import { isAbsolute, relative, resolve, sep } from "path";
 var SAFE_SEGMENT = /[^a-z0-9._-]+/gi;
 function trimTrailingSlashes(value) {
@@ -829,7 +830,8 @@ function slugifySegment(value, preserveCase = false) {
   } catch {
   }
   const normalized = preserveCase ? decoded : decoded.toLowerCase();
-  return normalized.replace(/\.(?:html?|mdx?)$/i, "").replace(SAFE_SEGMENT, "-").replace(/(^-|-$)/g, "");
+  const slug2 = normalized.replace(/\.(?:html?|mdx?)$/i, "").replace(SAFE_SEGMENT, "-").replace(/(^-|-$)/g, "");
+  return slug2 === "." || slug2 === ".." ? "" : slug2;
 }
 function pageIdFromReference(value, preserveCase = false) {
   const withoutQuery = value.split(/[?#]/, 1)[0].replace(/\\/g, "/").replace(/^\/+/, "");
@@ -884,6 +886,22 @@ function normalizeAssetPath(value) {
   if (segments.some((segment) => segment === "." || segment === "..")) return null;
   return segments.join("/");
 }
+function withinRealRoot(candidate, repositoryRoot) {
+  let real;
+  try {
+    real = realpathSync(candidate);
+  } catch {
+    return candidate;
+  }
+  const realRoot = realpathSync(repositoryRoot);
+  if (real !== realRoot && !real.startsWith(realRoot.endsWith(sep) ? realRoot : realRoot + sep)) {
+    throw new Error(`Migration path escapes its root: ${candidate}`);
+  }
+  return candidate;
+}
+function isPathEscapeError(error) {
+  return error instanceof Error && /escapes its root|Unsafe migration path/.test(error.message);
+}
 
 // src/mintlify-extras.ts
 function objectValue(value) {
@@ -1048,7 +1066,7 @@ function playgroundDisplay(value, where, warn) {
     warn?.(`${where} "auth" requires reader sign-in, which Thally does not support. Migrated as "simple" (no Try it). Set it to "interactive" to allow everyone.`);
     return "simple";
   }
-  warn?.(`${where} ${JSON.stringify(value)} is not one of interactive, simple, none, auth and was dropped.`);
+  warn?.(`${where} is not one of interactive, simple, none, auth and was dropped.`);
   return void 0;
 }
 
@@ -1059,13 +1077,23 @@ function titleFromId(id) {
   return value.split(/[-_]/).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
 var descriptionParser = unified().use(remarkParse).use(remarkGfm).use(remarkMdx);
-function firstParagraph(content) {
-  function plainText(node) {
-    if (node.type === "text" || node.type === "inlineCode") return node.value ?? "";
-    if (node.type === "image") return node.alt ?? "";
-    if (node.type === "break") return " ";
-    return (node.children ?? []).map(plainText).join("");
+function plainText(node) {
+  if (node.type === "text" || node.type === "inlineCode") return node.value ?? "";
+  if (node.type === "image") return node.alt ?? "";
+  if (node.type === "break") return " ";
+  return (node.children ?? []).map(plainText).join("");
+}
+function mdxVisibleText(content, definitions) {
+  const references = [...content.matchAll(/\[([^\]\n]+)\]/g)].map((match) => definitions?.get(match[1].trim().replace(/\s+/g, " ").toLowerCase()) ?? "").join("\n");
+  try {
+    return plainText(descriptionParser.parse(`# ${content}
+
+${references}`)).trim();
+  } catch {
+    return content;
   }
+}
+function firstParagraph(content) {
   function findParagraph(node) {
     if (node.type === "paragraph") {
       const value = plainText(node).replace(/\s+/g, " ").trim();
@@ -1089,6 +1117,97 @@ function docusaurusAdmonitionTag(kind) {
   if (kind === "caution" || kind === "warning") return "Warning";
   return "Note";
 }
+function scanJsxOpeningTag(source, start, name) {
+  const opener = `<${name}`;
+  let quote = null;
+  let depth = 0;
+  let braceQuote = null;
+  let lineComment = false;
+  let blockComment = false;
+  const attributesStart = start + opener.length;
+  for (let index = attributesStart; index < source.length; index++) {
+    const char = source[index];
+    if (char === "<" && !quote && !braceQuote && depth === 0 && !lineComment && !blockComment && source.startsWith(opener, index) && !/[\w$.-]/.test(source[index + opener.length] ?? "")) {
+      return { attributes: source.slice(attributesStart, index), end: null, next: index };
+    }
+    if (lineComment) {
+      if (char === "\n" || char === "\r") lineComment = false;
+    } else if (blockComment) {
+      if (char === "*" && source[index + 1] === "/") {
+        blockComment = false;
+        index++;
+      }
+    } else if (braceQuote) {
+      if (char === "\\") index++;
+      else if (char === braceQuote) braceQuote = null;
+    } else if (depth > 0) {
+      if (char === "/" && source[index + 1] === "/") {
+        lineComment = true;
+        index++;
+      } else if (char === "/" && source[index + 1] === "*") {
+        blockComment = true;
+        index++;
+      } else if (char === '"' || char === "'" || char === "`") braceQuote = char;
+      else if (char === "{") depth++;
+      else if (char === "}") depth--;
+    } else if (quote) {
+      if (char === quote) quote = null;
+    } else if (char === '"' || char === "'") quote = char;
+    else if (char === "{") depth++;
+    else if (char === ">") return { attributes: source.slice(attributesStart, index), end: index, next: index + 1 };
+  }
+  return { attributes: source.slice(attributesStart), end: null, next: source.length };
+}
+function normalizeDocusaurusAdmonitionTags(segment) {
+  const open = [];
+  const marker = /<\/Admonition>|<Admonition(?![\w$.-])/g;
+  let output = "";
+  let cursor = 0;
+  for (let match = marker.exec(segment); match; match = marker.exec(segment)) {
+    if (match[0] === "</Admonition>") {
+      output += `${segment.slice(cursor, match.index)}
+</${open.pop() ?? "Note"}>`;
+      cursor = marker.lastIndex;
+      continue;
+    }
+    const tag = scanJsxOpeningTag(segment, match.index, "Admonition");
+    marker.lastIndex = tag.next;
+    if (tag.end === null) continue;
+    const type = tag.attributes.match(/\btype=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean)?.toLowerCase() ?? "note";
+    const title = tag.attributes.match(/\btitle=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean)?.trim();
+    const callout = docusaurusAdmonitionTag(type);
+    open.push(callout);
+    output += `${segment.slice(cursor, match.index)}${title ? `<${callout}>
+**${title}**
+` : `<${callout}>
+`}`;
+    cursor = tag.end + 1;
+    marker.lastIndex = cursor;
+  }
+  return output + segment.slice(cursor);
+}
+function normalizeDocusaurusLinkTags(segment) {
+  const marker = /<Link(?![\w$.-])/g;
+  let output = "";
+  let cursor = 0;
+  for (let match = marker.exec(segment); match; match = marker.exec(segment)) {
+    const tag = scanJsxOpeningTag(segment, match.index, "Link");
+    marker.lastIndex = tag.next;
+    if (tag.end === null) continue;
+    output += `${segment.slice(cursor, match.index)}<a${tag.attributes.replace(/(^|\s)to=/, "$1href=")}>`;
+    cursor = tag.end + 1;
+    marker.lastIndex = cursor;
+  }
+  return (output + segment.slice(cursor)).replace(/<\/Link>/g, "</a>");
+}
+function normalizeDocusaurusThemedImages(segment) {
+  return segment.replace(/<ThemedImage\b([^<]*?)\/>/g, (original, attributes) => {
+    const light = attributes.match(/\blight\s*:\s*(?:useBaseUrl\(\s*)?(?:"([^"]+)"|'([^']+)')/)?.slice(1).find(Boolean);
+    if (!light) return original;
+    const alt = attributes.match(/\balt=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find((value) => value !== void 0);
+    return `<img src="${light.replace(/"/g, "&quot;")}"${alt === void 0 ? "" : ` alt="${alt.replace(/"/g, "&quot;")}"`} />`;
+  });
+}
 function normalizeDocusaurusAdmonitions(body) {
   const lines = body.split("\n");
   const openAdmonitions = [];
@@ -1260,10 +1379,51 @@ var SAFE_BUILTIN_ROOTS = /* @__PURE__ */ new Set([
   "BigInt",
   "Reflect"
 ]);
+function bindSnippetProps(body, properties) {
+  if (!body.includes("props") || properties.size === 0) return body;
+  let tree;
+  try {
+    tree = descriptionParser.parse(body);
+  } catch {
+    return body;
+  }
+  const edits = [];
+  const inspectExpression = (value) => {
+    if (!value || typeof value !== "object") return;
+    const node = value;
+    if (node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression" || node.type === "FunctionDeclaration") {
+      const names = /* @__PURE__ */ new Set();
+      node.params.forEach((param) => collectPatternNames(param, names));
+      if (names.has("props")) return;
+    }
+    if (node.type === "MemberExpression" && node.object.type === "Identifier" && node.object.name === "props") {
+      const key = !node.computed && node.property.type === "Identifier" ? node.property.name : node.computed && node.property.type === "Literal" && typeof node.property.value === "string" ? node.property.value : void 0;
+      const replacement = key === void 0 ? void 0 : properties.get(key);
+      if (replacement !== void 0 && body.slice(node.start, node.end).startsWith("props")) {
+        edits.push({ start: node.start, end: node.end, value: JSON.stringify(replacement) });
+        return;
+      }
+    }
+    for (const child of Object.values(value)) {
+      if (Array.isArray(child)) child.forEach(inspectExpression);
+      else if (child && typeof child === "object") inspectExpression(child);
+    }
+  };
+  const visit = (value) => {
+    if (!value || typeof value !== "object") return;
+    const node = value;
+    if (node.data?.estree) inspectExpression(node.data.estree);
+    for (const attribute of node.attributes ?? []) visit(attribute.value);
+    for (const child of node.children ?? []) visit(child);
+  };
+  visit(tree);
+  return edits.sort((a, b) => b.start - a.start).reduce((text2, edit) => text2.slice(0, edit.start) + edit.value + text2.slice(edit.end), body);
+}
 function leadingPageHeading(body) {
+  if (!/^ {0,3}(?:#(?:[ \t]|$)|=+[ \t\r]*$)/m.test(body)) return void 0;
   try {
     const root = descriptionParser.parse(body);
-    const first = root.children?.find((node) => node.type !== "mdxjsEsm" && node.type !== "html");
+    const first = root.children?.find((node) => node.type !== "mdxjsEsm" && node.type !== "html" && !(node.type === "mdxFlowExpression" && node.data?.estree?.body.length === 0));
     if (first?.type !== "heading" || first.depth !== 1) return void 0;
     const text2 = (node) => node.type === "mdxTextExpression" || node.type === "mdxFlowExpression" ? "" : node.value ?? (node.children ?? []).map(text2).join("");
     const title = text2(first).replace(/\s+/g, " ").trim();
@@ -1274,6 +1434,12 @@ function leadingPageHeading(body) {
     return void 0;
   }
 }
+function resolvePageDisplayHeading(page, platform) {
+  const heading = leadingPageHeading(page.body);
+  if (!heading || heading.title !== page.title && platform !== "docusaurus") return;
+  if (heading.title !== page.title) page.headingTitle = heading.title;
+  page.body = `${page.body.slice(0, heading.start)}${page.body.slice(heading.end)}`.trim();
+}
 function collectPatternNames(pattern, names) {
   switch (pattern.type) {
     case "Identifier":
@@ -2045,13 +2211,13 @@ function normalizeMintlifyUpdateLabels(body) {
     } catch {
       return match;
     }
-    const plainText = (node) => {
+    const plainText2 = (node) => {
       if (node.type === "text" || node.type === "inlineCode") return node.value ?? "";
       if (node.type === "mdxTextExpression" || node.type === "mdxFlowExpression" || node.type === "mdxjsEsm") return null;
-      const parts = (node.children ?? []).map(plainText);
+      const parts = (node.children ?? []).map(plainText2);
       return parts.some((part) => part === null) ? null : parts.join("");
     };
-    const label = plainText(root)?.replace(/\s+/g, " ").trim();
+    const label = plainText2(root)?.replace(/\s+/g, " ").trim();
     return label && !/[{}]/.test(label) ? `${prefix}{${JSON.stringify(label)}}` : match;
   });
 }
@@ -2334,11 +2500,12 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
   const runMintlify = platform === "mintlify";
   const runDocusaurus = platform === "docusaurus";
   const sourceBody = runDocusaurus && unwrapMdxCodeBlocks ? unwrapDocusaurusMdxCodeBlocks(body) : body;
-  let rewritten = normalizeDocusaurusAdmonitions(normalizeExplicitHeadingIds(
+  let rewritten = normalizeExplicitHeadingIds(
     runFern ? normalizeFernFileTrees(normalizeFernCallouts(normalizeNestedCodeFences(sourceBody))) : normalizeNestedCodeFences(sourceBody),
     void 0,
     { headingMarkers: runMintlify }
-  ));
+  );
+  if (runDocusaurus) rewritten = normalizeDocusaurusAdmonitions(rewritten);
   if (runMintlify) rewritten = markMintlifyHeadings(rewritten);
   if (runDocusaurus) {
     rewritten = replaceOutsideCode(rewritten, (segment) => segment.replace(
@@ -2352,6 +2519,7 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
         return `${attribute}="/${path.replace(/^\.\//, "").replace(/^\/+/, "")}"`;
       }
     ));
+    rewritten = replaceOutsideCode(rewritten, (segment) => normalizeDocusaurusThemedImages(normalizeDocusaurusAdmonitionTags(segment)));
     rewritten = normalizeDocusaurusTabBlocks(normalizeDocusaurusTabs(removeGlobalDocusaurusImports(rewritten)));
     rewritten = replaceOutsideCode(rewritten, (segment) => segment.replace(
       /\bimport\s+([A-Za-z_$][\w$]*)\s+from\s+(['"])(@site\/[^'"]+)\2\s*;?/g,
@@ -2366,10 +2534,11 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
   rewritten = replaceOutsideCode(rewritten, (segment) => {
     let result = convertHtmlStyleAttributes(segment).replace(/<!--([\s\S]*?)-->/g, (_match, content) => mdxComment(content)).replace(/<Danger(\s[^>]*)?>/g, "<Error$1>").replace(/<\/Danger>/g, "</Error>").replace(/<Warn(\s[^>]*)?>/g, "<Warning$1>").replace(/<\/Warn>/g, "</Warning>").replace(/<Check(\s[^>]*)?>/g, "<Note$1>").replace(/<\/Check>/g, "</Note>").replace(/<Tree\.Folder/g, "<Folder").replace(/<\/Tree\.Folder>/g, "</Folder>").replace(/<Tree\.File/g, "<File").replace(/<\/Tree\.File>/g, "</File>");
     if (runDocusaurus) {
-      result = result.replace(/<TabItem\b([^>]*)>/g, (_match, attributes) => {
+      result = result.replace(/<TabItem\b([^<>]*)>/g, (_match, attributes) => {
         const title = attributes.match(/\blabel=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean) ?? attributes.match(/\bvalue=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean) ?? "Tab";
         return `<Tab title="${title.replace(/"/g, "&quot;")}">`;
-      }).replace(/<\/TabItem>/g, "</Tab>").replace(/<Link\b([^>]*)\bto=(?:"([^"]*)"|'([^']*)')([^>]*)>/g, (_match, before, doubleQuoted, singleQuoted, after) => `<a${before}href="${doubleQuoted ?? singleQuoted}"${after}>`).replace(/<\/Link>/g, "</a>").replace(/<(?:DocCardList|TOCInline)\b[^>]*\/>/g, "");
+      }).replace(/<\/TabItem>/g, "</Tab>");
+      result = normalizeDocusaurusLinkTags(result).replace(/<(?:DocCardList|TOCInline)\b[^<>]*\/>/g, "");
     }
     if (runMintlify) {
       result = normalizeMintlifyUpdateLabels(result).replace(/<FileTree(\s[^>]*)?>/g, "<Tree$1>").replace(/<\/FileTree>/g, "</Tree>").replace(/<GitHub\.Repo/g, "<GitHub").replace(/<\/GitHub\.Repo>/g, "</GitHub>").replace(/<Column(\s[^>]*)?>/g, "<div$1>").replace(/<\/Column>/g, "</div>");
@@ -2399,16 +2568,14 @@ function parseMarkdownPage(input) {
     ...input.locale ? { locale: input.locale } : {}
   };
   const identity = input.resolveIdentity?.(parsed.data, fallbackIdentity) ?? fallbackIdentity;
-  let body = removeUndefinedExpressions(injectReactHookImports(normalizeMdx(parsed.content, input.platform)), input.warn).trim();
+  const body = removeUndefinedExpressions(injectReactHookImports(normalizeMdx(parsed.content, input.platform)), input.warn).trim();
   const keywords = Array.isArray(parsed.data.keywords) ? parsed.data.keywords.filter((value) => typeof value === "string") : [];
   const heading = leadingPageHeading(body);
   const title = typeof parsed.data.title === "string" && parsed.data.title.trim() ? parsed.data.title.trim() : heading?.title ?? titleFromId(identity.navigationId);
-  if (heading && heading.title === title) {
-    body = `${body.slice(0, heading.start)}${body.slice(heading.end)}`.trim();
-  }
-  const navTitle = typeof parsed.data.sidebarTitle === "string" && parsed.data.sidebarTitle.trim() ? parsed.data.sidebarTitle.trim() : typeof parsed.data.navTitle === "string" && parsed.data.navTitle.trim() ? parsed.data.navTitle.trim() : void 0;
+  const sidebarTitle = input.platform === "docusaurus" ? parsed.data.sidebar_label : parsed.data.sidebarTitle;
+  const navTitle = typeof sidebarTitle === "string" && sidebarTitle.trim() ? sidebarTitle.trim() : typeof parsed.data.navTitle === "string" && parsed.data.navTitle.trim() ? parsed.data.navTitle.trim() : void 0;
   const icon = typeof parsed.data.icon === "string" && parsed.data.icon.trim() ? parsed.data.icon.trim() : void 0;
-  const iconType = icon && ["regular", "solid", "outline", "brands"].includes(String(parsed.data.iconType)) ? parsed.data.iconType : void 0;
+  const iconType = icon && typeof parsed.data.iconType === "string" && ["regular", "solid", "outline", "brands"].includes(parsed.data.iconType) ? parsed.data.iconType : void 0;
   const meta = {};
   for (const [source, field] of PAGE_META_FIELDS) {
     const value = parsed.data[source];
@@ -2418,7 +2585,7 @@ function parseMarkdownPage(input) {
   const sourceMode = typeof parsed.data.mode === "string" ? parsed.data.mode : void 0;
   const mode = sourceMode === "frame" ? "wide" : ["default", "wide", "custom", "center", "home"].includes(sourceMode ?? "") ? sourceMode : void 0;
   const description = typeof parsed.data.description === "string" && parsed.data.description.trim() ? parsed.data.description.trim() : typeof parsed.data.openapi === "string" && parsed.data.openapi.trim() ? "" : firstParagraph(body);
-  return {
+  const page = {
     id: identity.id,
     navigationId: identity.navigationId,
     locale: identity.locale,
@@ -2440,6 +2607,8 @@ function parseMarkdownPage(input) {
     source: input.source,
     ...parsed.error ? { frontmatterError: parsed.error } : {}
   };
+  resolvePageDisplayHeading(page, input.platform);
+  return page;
 }
 var PAGE_META_FIELDS = [
   ["og:title", "ogTitle"],
@@ -2463,7 +2632,7 @@ function apiFrontmatter(data, warn) {
   if (data.authMethod !== void 0 && data.authMethod !== null) {
     const method = typeof data.authMethod === "string" ? data.authMethod.trim().toLowerCase() : "";
     if (AUTH_METHODS.has(method)) result.authMethod = method;
-    else warn?.(`The page's "authMethod" frontmatter ${JSON.stringify(data.authMethod)} is not one of bearer, basic, key, none and was dropped.`);
+    else warn?.(`The page's "authMethod" frontmatter is not one of bearer, basic, key, none and was dropped.`);
   }
   return result;
 }
@@ -2499,6 +2668,10 @@ function normalizeIndentedFences(content) {
       }
       const match = line.match(/^([ \t]{4,})(`{3,}|~{3,})/);
       if (match) {
+        if (listIndent !== void 0 && match[1].length > listIndent) {
+          ordinaryFence = match[2];
+          return line;
+        }
         active = { indent: match[1], marker: match[2] };
         return line.slice(match[1].length);
       }
@@ -3065,7 +3238,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
   function expandCandidates(candidate) {
     const candidates = [candidate];
     if (!extname2(candidate)) {
-      candidates.push(...[".tsx", ".jsx", ".ts", ".js", ".mjs", ".json"].map((extension) => candidate + extension));
+      candidates.push(...[".tsx", ".jsx", ".ts", ".js", ".mjs", ".json", ".d.ts"].map((extension) => candidate + extension));
       candidates.push(...["index.tsx", "index.jsx", "index.ts", "index.js"].map((name) => resolve2(candidate, name)));
     } else if (extname2(candidate) === ".js") {
       candidates.push(candidate.slice(0, -3) + ".ts", candidate.slice(0, -3) + ".tsx");
@@ -3130,7 +3303,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
       }
       const text2 = content.toString("utf8");
       const syntax = ts2.transpileModule(text2, {
-        fileName: path,
+        fileName: path.replace(/\.d\.ts$/, ".ts"),
         reportDiagnostics: true,
         compilerOptions: { jsx: ts2.JsxEmit.Preserve, target: ts2.ScriptTarget.ESNext, module: ts2.ModuleKind.ESNext }
       });
@@ -3976,13 +4149,92 @@ function projectAuthoredStyles(css, contents) {
 }
 
 // src/docusaurus.ts
-import { existsSync as existsSync3, lstatSync as lstatSync3, readFileSync as readFileSync3 } from "fs";
-import { extname as extname4, posix as posix3 } from "path";
-import JSON5 from "json5";
+import { existsSync as existsSync4, lstatSync as lstatSync4, readFileSync as readFileSync4, readdirSync as readdirSync2 } from "fs";
+import { extname as extname5, posix as posix3 } from "path";
+import postcss3 from "postcss";
+
+// src/css-colors.ts
+var channel = (value) => Number(value);
+function cssColorToHex(raw) {
+  const value = raw.trim().replace(/\s*!important$/i, "");
+  if (value.length > 64) return void 0;
+  const hex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(value)?.[1];
+  if (hex) return `#${(hex.length === 3 ? [...hex].map((digit) => digit + digit).join("") : hex).toLowerCase()}`;
+  const rgb = /^(?:rgba?\(\s*)?(\d{1,3})(?:\s*,\s*|\s+)(\d{1,3})(?:\s*,\s*|\s+)(\d{1,3})\s*(?:[,/]\s*[\d.]+%?\s*)?\)?$/i.exec(value);
+  if (!rgb) return void 0;
+  const channels = [rgb[1], rgb[2], rgb[3]].map(channel);
+  if (channels.some((entry) => entry > 255)) return void 0;
+  if (value.includes("(") !== value.includes(")")) return void 0;
+  return `#${channels.map((entry) => entry.toString(16).padStart(2, "0")).join("")}`;
+}
+function stripComments(css) {
+  let out = "";
+  let index = 0;
+  while (index < css.length) {
+    const open = css.indexOf("/*", index);
+    if (open < 0) break;
+    out += css.slice(index, open);
+    const close = css.indexOf("*/", open + 2);
+    if (close < 0) return out;
+    index = close + 2;
+  }
+  return out + css.slice(index);
+}
+function declarations(body, into) {
+  for (const declaration of body.split(";")) {
+    const colon = declaration.indexOf(":");
+    if (colon < 0) continue;
+    const name = declaration.slice(0, colon).trim().toLowerCase();
+    if (name !== "--primary" && name !== "--primary-light" && name !== "--primary-dark") continue;
+    const hex = cssColorToHex(declaration.slice(colon + 1));
+    if (hex) into[name.slice(2)] = hex;
+  }
+}
+function cssBrandVars(css) {
+  const source = stripComments(css);
+  const root = {};
+  const dark = {};
+  let index = 0;
+  while (index < source.length) {
+    const open = source.indexOf("{", index);
+    if (open < 0) break;
+    let prelude = (source.slice(index, open).split("}").pop() ?? "").trim();
+    while (prelude.startsWith("@") && prelude.includes(";")) prelude = prelude.slice(prelude.indexOf(";") + 1).trim();
+    let depth = 1;
+    let close = open + 1;
+    for (; close < source.length && depth > 0; close++) {
+      if (source[close] === "{") depth++;
+      else if (source[close] === "}") depth--;
+    }
+    index = close;
+    if (prelude.startsWith("@")) continue;
+    for (const selector of prelude.split(",")) {
+      const name = selector.trim().toLowerCase();
+      const target = name === ":root" || name === "html" ? root : name === ".dark" || name === "html.dark" || name === ":root.dark" ? dark : void 0;
+      if (target) declarations(source.slice(open + 1, close - 1), target);
+    }
+  }
+  return { root, dark };
+}
+function brandColorsFromVars({ root, dark }) {
+  const result = {};
+  const lightAccent = root.primary;
+  const lightButton = root["primary-dark"] ?? root.primary;
+  if (lightAccent || lightButton) result.light = { ...lightAccent ? { accent: lightAccent } : {}, ...lightButton ? { primary: lightButton } : {} };
+  const darkAccent = dark["primary-light"] ?? dark.primary;
+  const darkButton = dark["primary-dark"] ?? dark["primary-light"] ?? dark.primary;
+  if (darkAccent || darkButton) result.dark = { ...darkAccent ? { accent: darkAccent } : {}, ...darkButton ? { primary: darkButton } : {} };
+  return result.light || result.dark ? result : void 0;
+}
+
+// src/fern.ts
+import { existsSync as existsSync3, lstatSync as lstatSync3, readFileSync as readFileSync3, readdirSync } from "fs";
+import { basename as basename2, dirname as dirname3, extname as extname4, relative as relative4 } from "path";
+import { load } from "cheerio";
 import { parse as parseYaml2 } from "yaml";
 
 // src/navigation.ts
-import { existsSync as existsSync2, lstatSync as lstatSync2, readFileSync as readFileSync2, realpathSync } from "fs";
+import { existsSync as existsSync2, lstatSync as lstatSync2, readFileSync as readFileSync2, realpathSync as realpathSync2 } from "fs";
 import { dirname as dirname2, extname as extname3, relative as relative3 } from "path";
 var MAX_MINTLIFY_CONFIG_BYTES = 2e7;
 function addMintlifyDirectoryRedirects(config, pages) {
@@ -4136,8 +4388,8 @@ function readMintlifyJson(path, repositoryRoot) {
   if (!existsSync2(path) || !lstatSync2(path).isFile()) {
     throw new Error(`Mintlify config reference is not a regular file: ${relative3(repositoryRoot, path)}`);
   }
-  const realPath = realpathSync(path);
-  const realRoot = realpathSync(repositoryRoot);
+  const realPath = realpathSync2(path);
+  const realRoot = realpathSync2(repositoryRoot);
   resolveWithin(realRoot, relative3(realRoot, realPath));
   if (lstatSync2(realPath).size > MAX_MINTLIFY_CONFIG_BYTES) {
     throw new Error(`Mintlify config reference exceeded ${MAX_MINTLIFY_CONFIG_BYTES / 1e6} MB: ${relative3(repositoryRoot, path)}`);
@@ -5221,1433 +5473,1695 @@ function pruneMissingNavigationPages(config, availableIds) {
   return { ...config, tabs };
 }
 
-// src/docusaurus.ts
+// src/fern.ts
 var MAX_CONFIG_BYTES = 2e7;
-var CATEGORY_FILENAMES = ["_category_.json", "_category_.yml", "_category_.yaml"];
-var SIDEBAR_FILENAMES = [
-  "sidebars.json",
-  "sidebars.js",
-  "sidebars.cjs",
-  "sidebars.mjs",
-  "sidebars.ts"
-];
+function announcementMarkdown(message) {
+  const document = load(message);
+  document("script, style, iframe, object, embed, svg, math").remove();
+  const escapeText = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/([\\`*_\[\]{}()!])/g, "\\$1");
+  const links = /* @__PURE__ */ new Map();
+  document("a").each((index, element) => {
+    const marker = `THALLYANNOUNCEMENTLINK${index}TOKEN`;
+    const label = document(element).text().trim();
+    const rawHref = document(element).attr("href")?.trim() ?? "";
+    let href;
+    if (/^https?:\/\//i.test(rawHref)) {
+      try {
+        href = new URL(rawHref).toString();
+      } catch {
+      }
+    } else if (rawHref.startsWith("/") && !rawHref.startsWith("//") && !/[\\<>\s]/.test(rawHref)) {
+      href = rawHref;
+    }
+    const destination = href?.replace(/\(/g, "%28").replace(/\)/g, "%29");
+    links.set(marker, destination && label ? `[${escapeText(label)}](${destination})` : escapeText(label));
+    document(element).replaceWith(marker);
+  });
+  let text2 = escapeText(document("body").text());
+  for (const [marker, link] of links) text2 = text2.replaceAll(marker, link);
+  return text2.trim();
+}
 function objectValue3(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
-function stripNumberPrefix(value) {
-  return value.replace(/^\d+[-_]+/, "");
-}
-function normalizeDocId(value) {
-  return value.split(/[?#]/, 1)[0].replace(/\\/g, "/").replace(/^\/+/, "").replace(/\.(?:mdx?)$/i, "").split("/").filter(Boolean).map(stripNumberPrefix).join("/");
+function titleCase2(value) {
+  return value.split(/[-_]/).filter(Boolean).map((word) => ["api", "cli", "sdk", "ui"].includes(word.toLowerCase()) ? word.toUpperCase() : word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
-function docusaurusSlugifySegment(value) {
-  let decoded = value;
-  try {
-    decoded = decodeURIComponent(value);
-  } catch {
+function readBoundedYaml(path) {
+  if (lstatSync3(path).size > MAX_CONFIG_BYTES) {
+    throw new Error("The Fern config is larger than 20 MB and could not be imported.");
   }
-  return decoded.replace(/\.(?:html?|mdx?)$/i, "").replace(/[^A-Za-z0-9._-]+/g, "-").replace(/(^-|-$)/g, "");
+  return parseYaml2(readFileSync3(path, "utf8"));
 }
-function docusaurusRouteId(value) {
-  const segments = normalizeDocId(value).split("/").map(docusaurusSlugifySegment).filter(Boolean);
-  return segments.join("/") || "introduction";
+function readFernConfig(fernRoot) {
+  const sourcePath = "docs.yml";
+  const path = resolveWithin(fernRoot, sourcePath);
+  if (!existsSync3(path) || !lstatSync3(path).isFile()) return null;
+  const config = objectValue3(readBoundedYaml(path));
+  if (!config) throw new Error("fern/docs.yml must contain an object.");
+  return { config, sourcePath };
 }
-function defaultDocusaurusRouteId(value) {
-  const segments = normalizeDocId(value).split("/").filter(Boolean);
-  if (/^(?:index|readme)$/i.test(segments.at(-1) ?? "")) segments.pop();
-  const normalized = segments.map(docusaurusSlugifySegment).filter(Boolean);
-  return normalized.join("/") || "introduction";
+function warnOnce2(context, key, message) {
+  if (context.warningKeys.has(key)) return;
+  context.warningKeys.add(key);
+  context.warnings.push({ code: "unsupported-config", message });
 }
-function storageIdForRoute(routeId) {
-  return /(?:^|\/)(?:index|readme)$/i.test(routeId) ? `${routeId}/index` : routeId;
+function firstLeafId(nodes) {
+  for (const node of nodes) {
+    if (typeof node === "string") return node;
+    const nested = firstLeafId(node.pages);
+    if (nested) return nested;
+  }
+  return void 0;
 }
-function titleCase2(value) {
-  return stripNumberPrefix(value).replace(/sidebar$/i, "").split(/[-_]/).filter(Boolean).map((word) => ["api", "cli", "sdk", "ui"].includes(word.toLowerCase()) ? word.toUpperCase() : word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+function addBareRouteRedirect(segments, pages, context) {
+  if (segments.length === 0) return;
+  const destination = firstLeafId(pages);
+  const source = segments.join("/");
+  if (destination && destination !== source) {
+    context.bareRouteRedirects.push({ source: `/${source}`, destination: `/${destination}` });
+  }
 }
-function routeFromSlug(slug2, fallback, sourceDirectory) {
-  if (slug2 === "/") return "introduction";
-  if (slug2.startsWith("/")) return docusaurusRouteId(slug2);
-  const fallbackDirectory = sourceDirectory ?? (fallback === "introduction" ? "" : posix3.dirname(fallback));
-  const resolved = posix3.normalize(posix3.join(fallbackDirectory, slug2));
-  if (resolved === ".." || resolved.startsWith("../")) return null;
-  return docusaurusRouteId(resolved);
+var FERN_SEGMENT_ALIAS = /^[\w.-]+$/;
+function fernBasicSlug(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
 }
-function resolveDocusaurusPageIdentity(sourcePath, frontmatter, fallback) {
-  const sourceDocId = normalizeDocId(sourcePath);
-  const sourceDirectory = posix3.dirname(sourceDocId);
-  const configuredId = typeof frontmatter.id === "string" && frontmatter.id.trim() ? stripNumberPrefix(frontmatter.id.trim()) : null;
-  const docId = configuredId ? normalizeDocId(sourceDirectory === "." ? configuredId : posix3.join(sourceDirectory, configuredId)) : sourceDocId;
-  const defaultNavigationId = defaultDocusaurusRouteId(docId) ?? fallback.navigationId;
-  const configuredSlug = typeof frontmatter.slug === "string" ? frontmatter.slug.trim() : "";
-  const navigationId = configuredSlug ? routeFromSlug(
-    configuredSlug,
-    defaultNavigationId,
-    sourceDirectory === "." ? "" : sourceDirectory
-  ) ?? defaultNavigationId : defaultNavigationId;
-  const position = typeof frontmatter.sidebar_position === "number" && Number.isFinite(frontmatter.sidebar_position) ? frontmatter.sidebar_position : void 0;
-  return {
-    identity: { id: storageIdForRoute(navigationId), navigationId },
-    descriptor: {
-      sourcePath: sourcePath.replace(/\\/g, "/"),
-      docId,
-      navigationId,
-      ...position === void 0 ? {} : { sidebarPosition: position }
-    }
-  };
-}
-function sourceReferenceKey(value) {
-  return value.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\.(?:mdx?)$/i, "").replace(/\/$/, "");
+function fernLabelSlug(label) {
+  const decamelized = label.replace(/[()]/g, "").replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2");
+  return fernBasicSlug(decamelized);
 }
-function sourceHeadings(body) {
-  const headings = [];
-  const lines = body.split("\n");
-  let fence = null;
-  for (let index = 0; index < lines.length; index++) {
-    const line = lines[index];
-    const marker = line.match(/^ {0,3}(`{3,}|~{3,})/);
-    if (marker) {
-      if (!fence) fence = marker[1];
-      else if (marker[1][0] === fence[0] && marker[1].length >= fence.length && /^\s*$/.test(line.slice(marker[0].length))) fence = null;
-      continue;
-    }
-    if (fence) continue;
-    const heading = line.match(/^ {0,3}(#{2,6})\s+(.+?)\s*#*\s*$/);
-    if (!heading) continue;
-    const preceding = lines[index - 1]?.match(/^<a id="([\p{L}\p{N}_.:$-]{1,120})"><\/a>$/u);
-    const plainText = !/[<>{}\[\]`*_]/.test(heading[2]);
-    const generatedId = plainText ? heading[2].normalize("NFC").toLowerCase().replace(/[^\p{L}\p{M}\p{N}]+/gu, "-").replace(/(^-|-$)/g, "") : null;
-    headings.push({ index, level: heading[1].length, id: preceding?.[1] ?? generatedId });
+function segmentFor(value, label, context) {
+  if (value["skip-slug"] === true) return null;
+  if (typeof value.slug !== "string") return fernLabelSlug(label) || null;
+  const explicit = value.slug.trim();
+  if (!explicit) return null;
+  const slugified = fernBasicSlug(explicit);
+  if (context && explicit !== slugified && FERN_SEGMENT_ALIAS.test(explicit)) {
+    context.segmentAliases.set(slugified, explicit);
   }
-  return headings;
+  return slugified || null;
 }
-function addDocusaurusTranslatedHeadingAliases(pages) {
-  const byRoute = new Map(pages.map((page) => [page.navigationId, page]));
-  for (const page of pages) {
-    const locale = page.source.match(/(?:^|[/#])i18n\/([A-Za-z]{2,8}(?:-[A-Za-z0-9]{2,8})*)\/docusaurus-plugin-content-docs\//)?.[1];
-    if (!locale) continue;
-    const originalRoute = page.navigationId === locale ? "introduction" : page.navigationId.startsWith(`${locale}/`) ? page.navigationId.slice(locale.length + 1) : null;
-    if (!originalRoute) continue;
-    const original = byRoute.get(originalRoute);
-    if (!original) continue;
-    const originalHeadings = sourceHeadings(original.body);
-    const translatedHeadings = sourceHeadings(page.body);
-    if (!originalHeadings.length || originalHeadings.length !== translatedHeadings.length || originalHeadings.some((heading, index) => heading.level !== translatedHeadings[index].level)) continue;
-    const occupied = new Set(translatedHeadings.map((heading) => heading.id).filter((id) => !!id));
-    for (const match of page.body.matchAll(/<a\s+id="([^"]+)"/g)) occupied.add(match[1]);
-    const originalIdCounts = /* @__PURE__ */ new Map();
-    for (const heading of originalHeadings) {
-      if (heading.id) originalIdCounts.set(heading.id, (originalIdCounts.get(heading.id) ?? 0) + 1);
-    }
-    const aliases = /* @__PURE__ */ new Map();
-    for (let index = 0; index < originalHeadings.length; index++) {
-      const id = originalHeadings[index].id;
-      if (!id || occupied.has(id) || originalIdCounts.get(id) !== 1) continue;
-      aliases.set(translatedHeadings[index].index, id);
-      occupied.add(id);
+function uniqueNavigationId(base, context) {
+  if (!context.seenNavigationIds.has(base)) return base;
+  let index = 2;
+  while (context.seenNavigationIds.has(`${base}-${index}`)) index++;
+  return `${base}-${index}`;
+}
+function registerPageAt(rawPath, base, context, navTitle, hidden = false) {
+  let sourcePath;
+  try {
+    const absolute = withinRealRoot(resolveWithinRoot(
+      context.pathPrefix ? resolveWithinRoot(context.fernRoot, context.pathPrefix, context.repositoryRoot) : context.fernRoot,
+      rawPath.trim(),
+      context.repositoryRoot
+    ), context.repositoryRoot);
+    sourcePath = relative4(context.fernRoot, absolute).replace(/\\/g, "/");
+  } catch {
+    warnOnce2(context, `fern-unsafe-page-${rawPath}`, `Skipped the Fern page "${rawPath}" because it points outside the repository (symlink or ..).`);
+    return "";
+  }
+  const navigationId = uniqueNavigationId(base || "introduction", context);
+  context.seenNavigationIds.add(navigationId);
+  const isHidden = hidden || context.hiddenInherited === true;
+  context.descriptors.push({ sourcePath, navigationId, ...navTitle ? { navTitle } : {}, ...isHidden ? { hidden: true } : {} });
+  const kept = context.sourcePathToNavigationId.get(sourcePath);
+  if (kept) {
+    if (!isHidden) {
+      const owner = context.descriptors.find((descriptor) => descriptor.navigationId === kept);
+      if (owner) owner.hidden = false;
     }
-    if (aliases.size) page.body = page.body.split("\n").flatMap((line, index) => {
-      const alias = aliases.get(index);
-      return alias ? [`<a id="${alias}"></a>`, line] : [line];
-    }).join("\n");
+    return kept;
   }
+  context.sourcePathToNavigationId.set(sourcePath, navigationId);
+  return navigationId;
 }
-function expandDocusaurusDocCardLists(pages, config, sourceRoutes) {
-  const pageByRoute = new Map(pages.map((page) => [page.navigationId, page]));
-  const containsRoute = (items, route) => items.some((item) => typeof item === "string" ? item === route : containsRoute(item.pages, route));
-  const findGroup = (items, route) => {
-    for (const item of items) {
-      if (typeof item === "string" || !containsRoute(item.pages, route)) continue;
-      return findGroup(item.pages, route) ?? item;
+function registerFolder(object, parentSegments, context) {
+  const rawPath = String(object.folder).trim();
+  let folder;
+  try {
+    folder = withinRealRoot(resolveWithinRoot(
+      context.pathPrefix ? resolveWithinRoot(context.fernRoot, context.pathPrefix, context.repositoryRoot) : context.fernRoot,
+      rawPath,
+      context.repositoryRoot
+    ), context.repositoryRoot);
+  } catch {
+    warnOnce2(context, `fern-unsafe-folder-${rawPath}`, `Skipped the Fern folder "${rawPath}" because it points outside the repository (symlink or ..). None of its pages were imported.`);
+    return null;
+  }
+  if (!existsSync3(folder) || !lstatSync3(folder).isDirectory()) {
+    warnOnce2(context, `fern-missing-folder-${rawPath}`, `Fern folder "${rawPath}" does not exist and was skipped.`);
+    return null;
+  }
+  const label = typeof object.title === "string" && object.title.trim() ? object.title.trim() : titleCase2(basename2(folder));
+  const segment = typeof object.slug === "string" || object["skip-slug"] === true ? segmentFor(object, label, context) : fernBasicSlug(basename2(folder));
+  const segments = segment ? [...parentSegments, segment] : parentSegments;
+  const visit = (directory, routeSegments, depth) => {
+    if (depth > 12 || context.descriptors.length >= 5e3) {
+      context.navigationWalk.incomplete = true;
+      warnOnce2(context, "fern-folder-limit", "Fern folder navigation exceeded its depth or page budget; remaining access rules could not be classified.");
+      return [];
     }
-    return void 0;
-  };
-  const firstRoute = (items) => {
-    for (const item of items) {
-      if (typeof item === "string") return item;
-      const candidate = firstRoute(item.pages);
-      if (candidate) return candidate;
+    const pages2 = [];
+    const entries = readdirSync(directory, { withFileTypes: true }).filter((entry) => !entry.name.startsWith(".") && !entry.isSymbolicLink()).sort((left, right) => Number(left.name !== "index.mdx" && left.name !== "index.md") - Number(right.name !== "index.mdx" && right.name !== "index.md") || left.name.localeCompare(right.name));
+    for (const entry of entries) {
+      const path = resolveWithin(directory, entry.name);
+      if (entry.isDirectory()) {
+        const nested = visit(path, [...routeSegments, fernBasicSlug(entry.name)], depth + 1);
+        if (nested.length) pages2.push({ group: titleCase2(entry.name), pages: nested });
+      } else if (entry.isFile() && [".md", ".mdx"].includes(extname4(entry.name).toLowerCase())) {
+        const stem = basename2(entry.name, extname4(entry.name));
+        const pageSegment = stem.toLowerCase() === "index" ? null : fernBasicSlug(stem);
+        const route = [...routeSegments, ...pageSegment ? [pageSegment] : []].join("/");
+        const source = lstatSync3(path).size <= MAX_CONFIG_BYTES ? readFileSync3(path, "utf8") : "";
+        const frontmatter = source.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/)?.[1] ?? "";
+        const hidden = /^hidden:\s*true\s*$/m.test(frontmatter);
+        const registered = registerPageAt(relative4(context.fernRoot, path), route, { ...context, pathPrefix: "" }, void 0, hidden);
+        if (registered && !hidden && !context.hiddenInherited) pages2.push(registered);
+      }
     }
-    return void 0;
+    return pages2;
   };
-  for (const page of pages) {
-    if (!sourceRoutes.has(page.navigationId)) continue;
-    const group = config.tabs.map((tab) => findGroup([
-      ...tab.pages ?? [],
-      ...tab.groups ?? []
-    ], page.navigationId)).find(Boolean);
-    if (!group) {
-      page.body = page.body.replace(/<div data-thally-doc-card-list=""\s*\/>/g, "");
-      continue;
+  const pages = visit(folder, segments, 0);
+  if (!pages.length) return null;
+  addBareRouteRedirect(segments, pages, context);
+  return { group: label, pages };
+}
+function registerPage(object, parentSegments, context) {
+  if (typeof object.path !== "string" || !object.path.trim()) return null;
+  const label = typeof object.page === "string" && object.page.trim() ? object.page.trim() : "Untitled";
+  const segment = segmentFor(object, label, context);
+  const base = [...parentSegments, segment].filter(Boolean).join("/");
+  return registerPageAt(object.path, base, context, label, object.hidden === true) || null;
+}
+function isRestrictedNode(object) {
+  const viewers = object.viewers;
+  if (Array.isArray(viewers) ? viewers.length > 0 : typeof viewers === "string" ? viewers.trim() !== "" : viewers !== void 0 && viewers !== null && viewers !== false) return true;
+  const authed = object.authed;
+  return authed !== void 0 && authed !== null && authed !== false && !(typeof authed === "string" && ["", "false"].includes(authed.trim().toLowerCase()));
+}
+function restrictionMark(context) {
+  return { descriptors: context.descriptors.length, apis: context.apiSections.length };
+}
+function markRestricted(context, mark) {
+  for (const descriptor of context.descriptors.slice(mark.descriptors)) descriptor.restricted = true;
+  context.restrictedApiSections.push(...context.apiSections.splice(mark.apis));
+}
+function convertNode(node, parentSegments, context) {
+  const object = objectValue3(node);
+  if (!object) return null;
+  const walk2 = context.navigationWalk;
+  const reason = walk2.active.has(object) ? "cyclic section" : walk2.active.size >= 64 ? "section depth exceeds 64" : walk2.visits >= 5e3 ? "node budget exceeds 5000" : void 0;
+  if (reason) {
+    walk2.incomplete = true;
+    warnOnce2(context, `navigation-${reason}`, `Fern navigation was skipped: ${reason}.`);
+    return null;
+  }
+  walk2.visits++;
+  walk2.active.add(object);
+  try {
+    if (isRestrictedNode(object)) {
+      const before = restrictionMark(context);
+      convertNodeContents({ ...object, viewers: void 0, authed: void 0 }, parentSegments, context);
+      markRestricted(context, before);
+      return null;
     }
-    const cards = group.pages.flatMap((item) => {
-      if (typeof item === "string") {
-        if (item === page.navigationId) return [];
-        const target = pageByRoute.get(item);
-        return [{ title: target?.title ?? item.split("/").at(-1) ?? item, route: item }];
-      }
-      const slug2 = slugifySegment(item.group);
-      const routes = [...item.pages].flatMap((child) => typeof child === "string" ? [child] : []);
-      const route = routes.find((candidate) => candidate === slug2 || candidate.endsWith(`/${slug2}`)) ?? firstRoute(item.pages);
-      return route ? [{ title: item.group, route }] : [];
-    });
-    const markup = cards.length ? `<CardGroup>
-${cards.map(({ title, route }) => `  <Card title={${JSON.stringify(title)}} href={${JSON.stringify(`/${route === "introduction" ? "" : route}`)}} />`).join("\n")}
-</CardGroup>` : "";
-    page.body = page.body.replace(/<div data-thally-doc-card-list=""\s*\/>/g, markup);
-    if (markup && !page.body.includes(markup)) page.body = [page.body.trim(), markup].filter(Boolean).join("\n\n");
+    return convertNodeContents(object, parentSegments, context);
+  } finally {
+    walk2.active.delete(object);
   }
 }
-function rewriteDocusaurusLinks(body, current, descriptors, options = {}) {
-  const routes = /* @__PURE__ */ new Map();
-  for (const descriptor of descriptors) {
-    const sourceKey = sourceReferenceKey(descriptor.sourcePath);
-    routes.set(sourceKey, descriptor.navigationId);
-    routes.set(sourceReferenceKey(descriptor.docId), descriptor.navigationId);
-    routes.set(sourceReferenceKey(descriptor.navigationId), descriptor.navigationId);
-    const sourceRoute = pageIdFromReference(sourceKey);
-    if (sourceRoute) routes.set(sourceRoute, descriptor.navigationId);
+function convertNodeContents(object, parentSegments, context) {
+  if (typeof object.page === "string") {
+    const page = registerPage(object, parentSegments, context);
+    return object.hidden === true || context.hiddenInherited ? null : page;
   }
-  const currentDirectory = posix3.dirname(sourceReferenceKey(current.sourcePath));
-  function copiedAssetTarget(target) {
-    if (!target.startsWith("/") || target.startsWith("//") || target.includes("\\")) return null;
-    const suffixIndex = target.search(/[?#]/);
-    const path = suffixIndex >= 0 ? target.slice(0, suffixIndex) : target;
-    const suffix = suffixIndex >= 0 ? target.slice(suffixIndex) : "";
-    if (path.startsWith("/docs/") && options.assetPaths?.has(path.slice("/docs/".length))) {
-      return `/${path.slice("/docs/".length)}${suffix}`;
-    }
-    return options.assetPaths?.has(path.slice(1)) ? target : null;
+  if (typeof object.folder === "string") {
+    const folder = registerFolder(object, parentSegments, object.hidden === true ? { ...context, hiddenInherited: true } : context);
+    return object.hidden === true || context.hiddenInherited ? null : folder;
   }
-  function rewriteTarget(target) {
-    if (!target || /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(target)) return target;
-    if (target.startsWith("#")) return target;
-    const suffixIndex = target.search(/[?#]/);
-    const path = suffixIndex >= 0 ? target.slice(0, suffixIndex) : target;
-    const suffix = suffixIndex >= 0 ? target.slice(suffixIndex) : "";
-    const copiedAsset = copiedAssetTarget(target);
-    if (copiedAsset) return copiedAsset;
-    const candidates = path.startsWith("/") ? [
-      sourceReferenceKey(path),
-      sourceReferenceKey(path).replace(/^docs\//, ""),
-      sourceReferenceKey(path).replace(/^docs\/(?:next|current|latest)\//, "")
-    ] : [
-      sourceReferenceKey(posix3.normalize(posix3.join(currentDirectory, path))),
-      sourceReferenceKey(path)
-    ];
-    const route = candidates.map((candidate) => routes.get(candidate)).find(Boolean);
-    if (!route) {
-      if (path.startsWith("/") && path !== "/" && options.sourceOrigin) {
-        options.onExternalLink?.(target);
-        return new URL(target, options.sourceOrigin).toString();
-      }
-      return target;
+  if (typeof object.section === "string") {
+    const label = object.section;
+    const segment = segmentFor(object, label, context);
+    const segments = segment ? [...parentSegments, segment] : parentSegments;
+    const contents = Array.isArray(object.contents) ? object.contents : [];
+    const pages = [];
+    const hasOwnPath = typeof object.path === "string" && object.path.trim().length > 0;
+    if (hasOwnPath) {
+      const registered = registerPageAt(object.path, segments.join("/"), context, label, object.hidden === true);
+      if (registered) pages.push(registered);
     }
-    return `${route === "introduction" ? "/" : `/${route}`}${suffix}`;
-  }
-  let codeFence = null;
-  return body.split("\n").map((line) => {
-    const fence = line.match(/^\s{0,3}(`{3,}|~{3,})/);
-    if (fence) {
-      if (!codeFence) codeFence = fence[1];
-      else if (fence[1][0] === codeFence[0] && fence[1].length >= codeFence.length && /^\s*$/.test(line.slice(fence[0].length))) codeFence = null;
-      return line;
-    }
-    if (codeFence) return line;
-    return line.replace(/(\]\()([^\s)]+)(?=[\s)]|$)/g, (_match, prefix, target) => `${prefix}${rewriteTarget(target)}`).replace(/(\bhref=")([^"]+)(")/g, (_match, prefix, target, suffix) => `${prefix}${rewriteTarget(target)}${suffix}`).replace(/(\bsrc=")([^"]+)(")/g, (_match, prefix, target, suffix) => `${prefix}${copiedAssetTarget(target) ?? target}${suffix}`).replace(/^(\s{0,3}\[[^\]]+\]:\s*)(<[^>]+>|\S+)/, (_match, prefix, destination) => {
-      const bracketed = destination.startsWith("<") && destination.endsWith(">");
-      const target = bracketed ? destination.slice(1, -1) : destination;
-      const rewritten = rewriteTarget(target);
-      return `${prefix}${bracketed ? `<${rewritten}>` : rewritten}`;
-    });
-  }).join("\n");
-}
-function readDocusaurusSiteOrigin(repositoryRoot) {
-  const configPath = findDocusaurusConfigPath(repositoryRoot);
-  if (!configPath) return void 0;
-  const address = readBoundedText(configPath).match(/\burl['"]?\s*:\s*(['"])(https?:\/\/[^'"]+)\1/)?.[2];
-  if (!address) return void 0;
-  try {
-    return new URL(address).origin;
-  } catch {
-    return void 0;
-  }
-}
-function readBoundedText(path) {
-  if (lstatSync3(path).size > MAX_CONFIG_BYTES) {
-    throw new Error("The Docusaurus sidebar config is larger than 20 MB and could not be imported.");
-  }
-  return readFileSync3(path, "utf8");
-}
-function matchingObjectLiteral(source, start) {
-  let depth = 0;
-  let quote = null;
-  let isEscaped = false;
-  let lineComment = false;
-  let blockComment = false;
-  let objectStart = -1;
-  for (let index = start; index < source.length; index++) {
-    const char = source[index];
-    const next = source[index + 1];
-    if (lineComment) {
-      if (char === "\n") lineComment = false;
-      continue;
-    }
-    if (blockComment) {
-      if (char === "*" && next === "/") {
-        blockComment = false;
-        index++;
-      }
-      continue;
-    }
-    if (quote) {
-      if (isEscaped) isEscaped = false;
-      else if (char === "\\") isEscaped = true;
-      else if (char === quote) quote = null;
-      continue;
-    }
-    if (char === "/" && next === "/") {
-      lineComment = true;
-      index++;
-      continue;
-    }
-    if (char === "/" && next === "*") {
-      blockComment = true;
-      index++;
-      continue;
-    }
-    if (char === '"' || char === "'" || char === "`") {
-      quote = char;
-      continue;
-    }
-    if (char === "{") {
-      if (objectStart < 0) objectStart = index;
-      depth++;
-    } else if (char === "}" && objectStart >= 0) {
-      depth--;
-      if (depth === 0) return source.slice(objectStart, index + 1);
-    } else if (objectStart < 0 && !/\s/.test(char)) {
-      return null;
+    for (const child of contents) {
+      const converted = convertNode(child, segments, object.hidden === true ? { ...context, hiddenInherited: true } : context);
+      if (converted) pages.push(converted);
     }
+    if (pages.length === 0) return null;
+    if (!hasOwnPath && segment) addBareRouteRedirect(segments, pages, context);
+    if (object.hidden === true || context.hiddenInherited) return null;
+    return {
+      group: label,
+      ...["open-by-default", "closed-by-default", true, false].includes(object.collapsed) ? { defaultOpen: object.collapsed === "open-by-default" || object.collapsed === false } : {},
+      ...typeof object.icon === "string" ? { icon: object.icon } : {},
+      ...object.hidden === true ? { hidden: true } : {},
+      pages
+    };
   }
-  return null;
-}
-function parseStaticSidebarModule(source) {
-  const bindings = /* @__PURE__ */ new Map();
-  const normalizedSource = replaceExternalFbContent(source);
-  const parseFailures = [];
-  const assignmentPatterns = [
-    /\bmodule\.exports\s*=\s*/g,
-    /\bexport\s+default\s*/g,
-    /\b(?:const|let|var)\s+[A-Za-z_$][\w$]*(?:\s*:\s*[^=;]+)?\s*=\s*/g
-  ];
-  const candidates = assignmentPatterns.flatMap((pattern) => [...normalizedSource.matchAll(pattern)]).sort((left, right) => (left.index ?? 0) - (right.index ?? 0));
-  for (const candidate of candidates) {
-    const literal = matchingObjectLiteral(normalizedSource, (candidate.index ?? 0) + candidate[0].length);
-    if (!literal) continue;
-    try {
-      const substituted = [...bindings].reduce(
-        (value, [name, binding]) => value.replace(
-          new RegExp(`(:\\s*)${name}\\b`, "g"),
-          (_match, prefix) => `${prefix}${JSON.stringify(binding)}`
-        ),
-        literal
-      );
-      const parsed = JSON5.parse(substituted);
-      const object = objectValue3(parsed);
-      if (!object) continue;
-      const bindingName = candidate[0].match(/\b(?:const|let|var)\s+([A-Za-z_$][\w$]*)/)?.[1];
-      if (bindingName) {
-        bindings.set(bindingName, object);
-        continue;
+  if (typeof object.link === "string") {
+    const label = object.link.trim();
+    const rawHref = typeof object.href === "string" ? object.href.trim() : "";
+    let href;
+    if (/^https?:\/\//i.test(rawHref) && !/[\\\u0000-\u0020\u007f]/.test(rawHref)) {
+      try {
+        const url = new URL(rawHref);
+        if (["http:", "https:"].includes(url.protocol) && !url.username && !url.password) href = url.toString();
+      } catch {
       }
-      return object;
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      const line = Number(message.match(/at (\d+):/)?.[1] ?? 0);
-      const context = line > 0 ? literal.split("\n").slice(Math.max(0, line - 2), line + 1).join(" ") : "";
-      parseFailures.push(`${message}${context ? ` near ${context}` : ""}`);
-    }
-  }
-  const exportedBinding = normalizedSource.match(/\bexport\s+default\s+([A-Za-z_$][\w$]*)\b/)?.[1] ?? normalizedSource.match(/\bmodule\.exports\s*=\s*([A-Za-z_$][\w$]*)\b/)?.[1];
-  if (exportedBinding && bindings.has(exportedBinding)) return bindings.get(exportedBinding);
-  throw new Error(`Sidebar config is executable or outside the supported data-only syntax.${parseFailures[0] ? ` ${parseFailures[0]}` : ""}`);
-}
-function replaceExternalFbContent(source) {
-  const marker = "...fbContent(";
-  let result = source;
-  let searchFrom = 0;
-  while (true) {
-    const start = result.indexOf(marker, searchFrom);
-    if (start < 0) return result.replace(/,\s*,/g, ",");
-    const objectStart = result.indexOf("{", start + marker.length);
-    if (objectStart < 0) return result;
-    const objectLiteral = matchingObjectLiteral(result, objectStart);
-    if (!objectLiteral) {
-      searchFrom = start + marker.length;
-      continue;
     }
-    const objectEnd = objectStart + objectLiteral.length;
-    const close = result.indexOf(")", objectEnd);
-    if (close < 0) return result;
-    const externalMatch = /\bexternal\s*:\s*/g.exec(objectLiteral);
-    let replacement = "";
-    if (externalMatch) {
-      const arrayStart = objectLiteral.indexOf("[", externalMatch.index + externalMatch[0].length);
-      if (arrayStart >= 0) {
-        const array = matchingArrayLiteral(objectLiteral, arrayStart);
-        if (array) replacement = array.slice(1, -1);
+    if (label && href && object.hidden !== true && !context.hiddenInherited) {
+      if (!context.externalLinks.some((link) => link.label === label && link.href === href)) {
+        context.externalLinks.push({ label, href });
       }
+    } else if (!href && object.hidden !== true && !context.hiddenInherited) {
+      warnOnce2(context, `fern-link-${rawHref}`, `Fern navigation link "${label}" has an unsafe or invalid external URL and was skipped.`);
     }
-    let replaceEnd = close + 1;
-    if (!replacement) {
-      const trailingComma = result.slice(replaceEnd).match(/^\s*,/);
-      if (trailingComma) replaceEnd += trailingComma[0].length;
-    }
-    result = `${result.slice(0, start)}${replacement}${result.slice(replaceEnd)}`;
-    searchFrom = start + replacement.length;
+    return null;
   }
-}
-function matchingArrayLiteral(source, start) {
-  let depth = 0;
-  let quote = "";
-  let isEscaped = false;
-  for (let index = start; index < source.length; index++) {
-    const character = source[index];
-    if (quote) {
-      if (isEscaped) isEscaped = false;
-      else if (character === "\\") isEscaped = true;
-      else if (character === quote) quote = "";
-      continue;
-    }
-    if (character === '"' || character === "'" || character === "`") {
-      quote = character;
-      continue;
-    }
-    if (character === "[") depth++;
-    if (character === "]" && --depth === 0) return source.slice(start, index + 1);
+  if (typeof object.api === "string") {
+    const ownSegment = segmentFor(object, object.api, context);
+    context.apiSections.push({
+      name: typeof object["api-name"] === "string" ? object["api-name"] : object.api,
+      nameExplicit: typeof object["api-name"] === "string",
+      routeSegments: ownSegment ? [...parentSegments, ownSegment] : parentSegments
+    });
+    return null;
   }
-  return null;
-}
-function configuredSidebarPath(repositoryRoot) {
-  for (const filename of ["docusaurus.config.js", "docusaurus.config.ts", "docusaurus.config.mjs"]) {
-    const path = resolveWithin(repositoryRoot, filename);
-    if (!existsSync3(path)) continue;
-    const source = readBoundedText(path);
-    for (const docs of source.matchAll(/\bdocs\s*:\s*/g)) {
-      const object = matchingObjectLiteral(source, (docs.index ?? 0) + docs[0].length);
-      const candidate2 = object && staticStringField(object, "sidebarPath")?.replace(/^\.\//, "");
-      if (candidate2) {
-        const resolved2 = resolveWithin(repositoryRoot, candidate2);
-        if (existsSync3(resolved2) && lstatSync3(resolved2).isFile()) return candidate2;
-      }
-    }
-    const match = source.match(/\bsidebarPath\s*:\s*(?:require\.resolve\(\s*)?(['"])([^'"]+)\1/);
-    if (!match) continue;
-    const candidate = match[2].replace(/^\.\//, "");
-    const resolved = resolveWithin(repositoryRoot, candidate);
-    if (existsSync3(resolved) && lstatSync3(resolved).isFile()) return candidate;
+  if (typeof object.changelog === "string") {
+    return registerFolder({ folder: object.changelog, title: "Changelog", "skip-slug": true }, parentSegments, context);
   }
   return null;
 }
-function readDocusaurusSidebars(repositoryRoot, versionedSidebarPath) {
-  const configured = versionedSidebarPath ?? configuredSidebarPath(repositoryRoot);
-  const sourcePath = [configured, ...versionedSidebarPath ? [] : SIDEBAR_FILENAMES].filter((value) => Boolean(value)).find((candidate) => {
-    const path = resolveWithin(repositoryRoot, candidate);
-    return existsSync3(path) && lstatSync3(path).isFile();
+function convertNodes(nodes, parentSegments, context) {
+  return nodes.flatMap((node) => {
+    const converted = convertNode(node, parentSegments, context);
+    return converted ? [converted] : [];
   });
-  if (!sourcePath) return null;
-  const absolutePath = resolveWithin(repositoryRoot, sourcePath);
-  const source = readBoundedText(absolutePath);
-  const parsed = extname4(sourcePath).toLowerCase() === ".json" ? objectValue3(JSON5.parse(source)) : parseStaticSidebarModule(source);
-  if (!parsed) throw new Error("Docusaurus sidebar config must export an object.");
-  return { config: parsed, sourcePath };
 }
-function namedExportObjectLiteralText(source, name) {
-  const normalizedSource = replaceExternalFbContent(source);
-  const match = new RegExp(`\\bexport\\s+(?:const|let|var)\\s+${name}\\b(?:\\s*:\\s*[^=;]+)?\\s*=\\s*`).exec(normalizedSource);
-  if (!match) return null;
-  return matchingObjectLiteral(normalizedSource, match.index + match[0].length);
+function groupsFromConverted(converted) {
+  const loosePages = converted.filter((entry) => typeof entry === "string");
+  const groups = converted.filter((entry) => typeof entry !== "string");
+  return loosePages.length > 0 ? [{ group: "Overview", pages: loosePages }, ...groups] : groups;
 }
-function redirectEntriesFromObjectLiteralText(objectLiteral) {
-  const match = /\bredirects\s*:\s*/.exec(objectLiteral);
-  if (!match) return [];
-  const arrayStart = objectLiteral.indexOf("[", match.index + match[0].length);
-  if (arrayStart < 0) return [];
-  const arrayLiteral = matchingArrayLiteral(objectLiteral, arrayStart);
-  if (!arrayLiteral) return [];
-  let parsed;
-  try {
-    parsed = JSON5.parse(arrayLiteral);
-  } catch {
-    return [];
+function resolveVersionedNavigation(config, configDir, fernRoot, context) {
+  if (Array.isArray(config.navigation)) return config;
+  if (Array.isArray(config.products)) {
+    warnOnce2(context, "fern-products", "Nested Fern multi-product docs are not supported; only this docs.yml was imported.");
+    return config;
   }
-  if (!Array.isArray(parsed)) return [];
-  const entries = [];
-  for (const raw of parsed) {
-    const entry = objectValue3(raw);
-    if (!entry || typeof entry.to !== "string") continue;
-    const froms = Array.isArray(entry.from) ? entry.from : [entry.from];
-    for (const from of froms) {
-      if (typeof from !== "string") continue;
-      if (!isRedirectPathSafe(from, entry.to)) continue;
-      entries.push({ source: from, destination: entry.to });
-    }
+  if (!Array.isArray(config.versions)) return config;
+  const versions = config.versions.flatMap((entry) => {
+    const version = objectValue3(entry);
+    return version ? [version] : [];
+  });
+  const chosen = versions.find((version) => version.default === true) ?? versions[0];
+  if (chosen && isRestrictedNode(chosen)) context.versionRestricted = true;
+  const skipped = versions.filter((version) => version !== chosen).map((version) => typeof version.version === "string" ? version.version : void 0).filter((name) => Boolean(name));
+  if (skipped.length > 0) {
+    warnOnce2(
+      context,
+      "fern-versions",
+      `Only the default Fern version was imported; other versions were skipped: ${skipped.join(", ")}.`
+    );
   }
-  return entries;
-}
-function readDocusaurusRedirects(repositoryRoot, warnings) {
-  const configPath = findDocusaurusConfigPath(repositoryRoot);
-  if (!configPath) return [];
-  const configSource = readBoundedText(configPath);
-  const pluginMatch = /['"]@docusaurus\/plugin-client-redirects['"]\s*,\s*/.exec(configSource);
-  if (!pluginMatch) return [];
-  const afterPlugin = configSource.slice(pluginMatch.index + pluginMatch[0].length);
-  const warnAboutCreateRedirects = (source) => {
-    if (!/\bcreateRedirects\s*[:(]/.test(source)) return;
-    warnings.push({
-      code: "unsupported-config",
-      message: "The redirects plugin's createRedirects function computes redirects dynamically and cannot be evaluated during migration; add its redirects manually."
-    });
-  };
-  warnAboutCreateRedirects(configSource);
-  const inlineLiteral = matchingObjectLiteral(configSource, pluginMatch.index + pluginMatch[0].length);
-  if (inlineLiteral) return redirectEntriesFromObjectLiteralText(inlineLiteral);
-  const identifier = afterPlugin.match(/^([A-Za-z_$][\w$]*)/)?.[1];
-  if (!identifier) return [];
-  const importMatch = new RegExp(`import\\s*\\{[^}]*\\b${identifier}\\b[^}]*\\}\\s*from\\s*(['"])([^'"]+)\\1`).exec(configSource) ?? new RegExp(`import\\s+${identifier}\\s+from\\s*(['"])([^'"]+)\\1`).exec(configSource);
-  const modulePath = importMatch?.[2];
-  if (!modulePath || !modulePath.startsWith(".")) return [];
-  let resolvedPath;
+  if (!chosen || typeof chosen.path !== "string") return config;
   try {
-    resolvedPath = ["", ".ts", ".tsx", ".js", ".jsx", ".mjs"].map((extension) => resolveWithin(repositoryRoot, `${modulePath.replace(/^\.\//, "")}${extension}`)).find((candidate) => existsSync3(candidate) && lstatSync3(candidate).isFile());
-  } catch {
-    return [];
-  }
-  if (!resolvedPath) return [];
-  const moduleSource = readBoundedText(resolvedPath);
-  warnAboutCreateRedirects(moduleSource);
-  const literal = namedExportObjectLiteralText(moduleSource, identifier);
-  return literal ? redirectEntriesFromObjectLiteralText(literal) : [];
-}
-function readCategoryMetadata(contentRoot, directory) {
-  for (const filename of CATEGORY_FILENAMES) {
-    const path = resolveWithin(contentRoot, posix3.join(directory, filename));
-    if (!existsSync3(path) || !lstatSync3(path).isFile()) continue;
-    try {
-      const raw = readBoundedText(path);
-      const parsed = filename.endsWith(".json") ? JSON5.parse(raw) : parseYaml2(raw);
-      const object = objectValue3(parsed);
-      if (!object) return {};
-      return {
-        ...typeof object.label === "string" ? { label: object.label } : {},
-        ...typeof object.position === "number" ? { position: object.position } : {},
-        ..."link" in object ? { link: object.link } : {}
-      };
-    } catch {
-      return {};
+    const versionPath = resolveWithinRoot(configDir, chosen.path, context.repositoryRoot);
+    if (!existsSync3(versionPath) || !lstatSync3(versionPath).isFile()) {
+      warnOnce2(context, "fern-version-not-file", `Fern version file "${chosen.path}" is not a regular file and was skipped.`);
+      return config;
     }
+    withinRealRoot(versionPath, context.repositoryRoot);
+    const versionConfig = objectValue3(readBoundedYaml(versionPath));
+    if (!versionConfig) return config;
+    context.pathPrefix = relative4(fernRoot, dirname3(versionPath)).replace(/\\/g, "/");
+    return { ...config, navigation: versionConfig.navigation, tabs: versionConfig.tabs ?? config.tabs };
+  } catch (error) {
+    warnOnce2(
+      context,
+      "fern-version-read-failed",
+      isPathEscapeError(error) ? `Skipped the Fern version file "${chosen.path}" because it points outside the repository (symlink or ..).` : `Fern version file "${chosen.path}" could not be read (${error instanceof Error ? error.message : String(error)}) and was skipped.`
+    );
+    return config;
   }
-  return {};
-}
-function descriptorSort(left, right) {
-  const leftPosition = left.sidebarPosition ?? Number.MAX_SAFE_INTEGER;
-  const rightPosition = right.sidebarPosition ?? Number.MAX_SAFE_INTEGER;
-  if (leftPosition !== rightPosition) return leftPosition - rightPosition;
-  return left.sourcePath.localeCompare(right.sourcePath, void 0, { numeric: true });
 }
-function registerDoc(docId, context, sourceDirectory) {
-  const key = normalizeDocId(docId);
-  const scopedKey = sourceDirectory && !docId.startsWith("/") ? normalizeDocId(posix3.join(sourceDirectory, key)) : void 0;
-  const descriptor = (scopedKey ? context.descriptorByDocId.get(scopedKey) : void 0) ?? context.descriptorByDocId.get(key) ?? context.descriptors.find((page) => page.navigationId === docusaurusRouteId(key));
-  if (!descriptor) {
-    context.warnings.push({
-      code: "missing-page",
-      message: "A Docusaurus sidebar document did not resolve to an imported page.",
-      source: docId
-    });
-    return null;
+function buildTabsFromConfig(rawConfig, configDir, fernRoot, routePrefix, fallbackTabLabel, context) {
+  const before = restrictionMark(context);
+  let tabs;
+  let restricted;
+  try {
+    tabs = buildUnrestrictedTabs(rawConfig, configDir, fernRoot, routePrefix, fallbackTabLabel, context);
+    restricted = context.versionRestricted === true;
+  } finally {
+    context.versionRestricted = false;
   }
-  context.referencedNavigationIds.add(descriptor.navigationId);
-  return descriptor.navigationId;
+  if (!restricted) return tabs;
+  markRestricted(context, before);
+  return [];
 }
-function generatedIndexPage(label, linkValue, context, sourceDirectory) {
-  const link = objectValue3(linkValue);
-  if (!link) return null;
-  if (link.type === "doc" && typeof link.id === "string") return registerDoc(link.id, context, sourceDirectory);
-  if (link.type !== "generated-index") return null;
-  const fallback = `category/${slugifySegment(label)}`;
-  const unprefixedNavigationId = typeof link.slug === "string" ? routeFromSlug(link.slug, fallback) ?? fallback : fallback;
-  const navigationId = context.routePrefix && unprefixedNavigationId !== context.routePrefix && !unprefixedNavigationId.startsWith(`${context.routePrefix}/`) ? posix3.join(context.routePrefix, unprefixedNavigationId) : unprefixedNavigationId;
-  if (!context.generatedIds.has(navigationId) && !context.descriptors.some((page) => page.navigationId === navigationId)) {
-    const description = typeof link.description === "string" ? link.description : `Browse the ${label} documentation.`;
-    context.generatedPages.push({
-      id: storageIdForRoute(navigationId),
-      navigationId,
-      title: typeof link.title === "string" ? link.title : label,
-      description,
-      keywords: Array.isArray(link.keywords) ? link.keywords.filter((value) => typeof value === "string") : [],
-      body: description,
-      source: `${context.sourceUrl}#${context.sidebarSource}`
+function buildUnrestrictedTabs(rawConfig, configDir, fernRoot, routePrefix, fallbackTabLabel, context) {
+  const config = resolveVersionedNavigation(rawConfig, configDir, fernRoot, context);
+  const tabsMeta = objectValue3(config.tabs) ?? {};
+  const navigation = config.navigation;
+  const isTabbedNavigation = Array.isArray(navigation) && navigation.length > 0 && navigation.every((entry) => typeof objectValue3(entry)?.tab === "string");
+  if (isTabbedNavigation) {
+    return navigation.flatMap((entry) => {
+      const id = String(entry.tab);
+      const meta = objectValue3(tabsMeta[id]) ?? {};
+      const label = typeof meta["display-name"] === "string" ? meta["display-name"] : titleCase2(id);
+      const tabSegment = segmentFor(meta, label, context);
+      const segments = [...routePrefix, ...tabSegment ? [tabSegment] : []];
+      const layout = Array.isArray(entry.layout) ? entry.layout : [];
+      const sectionsBefore = context.apiSections.length;
+      const descriptorsBefore = restrictionMark(context);
+      const groups = groupsFromConverted(convertNodes(layout, segments, context));
+      if (isRestrictedNode(entry) || isRestrictedNode(meta)) {
+        markRestricted(context, descriptorsBefore);
+        return [];
+      }
+      for (let index = sectionsBefore; index < context.apiSections.length; index += 1) {
+        context.apiSections[index].tabLabel ??= label;
+      }
+      if (groups.length === 0 && typeof meta.href === "string" && /^https?:\/\//i.test(meta.href)) {
+        return [{ tab: label, href: meta.href }];
+      }
+      if (groups.length === 0 && typeof meta.changelog === "string") {
+        const changelog = registerFolder({ folder: meta.changelog, title: label, "skip-slug": true }, segments, context);
+        if (changelog) {
+          const indexRoute = segments.join("/");
+          const descriptors = new Map(context.descriptors.map((descriptor) => [descriptor.navigationId, descriptor]));
+          const visiblePages = changelog.pages.filter((page) => typeof page === "string").filter((page) => !descriptors.get(page)?.hidden);
+          const index = visiblePages.find((page) => {
+            const descriptor = descriptors.get(page);
+            if (!descriptor) return false;
+            const stem = basename2(descriptor.sourcePath, extname4(descriptor.sourcePath));
+            return page === indexRoute || stem === "overview" || stem === "index";
+          });
+          const entries = visiblePages.filter((page) => page !== index).sort((left, right) => {
+            const date = (page) => descriptors.get(page)?.sourcePath.match(/\d{4}-\d{2}-\d{2}/)?.[0] ?? "";
+            return date(right).localeCompare(date(left)) || left.localeCompare(right);
+          });
+          for (const entryId of entries) {
+            const descriptor = descriptors.get(entryId);
+            if (descriptor) descriptor.hidden = true;
+          }
+          changelog.pages = [index ?? indexRoute];
+          context.changelogIndexes.push({ route: indexRoute, entries });
+          const latest = index ?? firstLeafId(changelog.pages);
+          const bareRouteIndex = context.bareRouteRedirects.findIndex((redirect) => redirect.source === `/${indexRoute}`);
+          const indexDescriptor = index ? descriptors.get(index) : void 0;
+          const indexSource = indexDescriptor && lstatSync3(resolveWithinRoot(context.fernRoot, indexDescriptor.sourcePath, context.repositoryRoot)).size <= MAX_CONFIG_BYTES ? readFileSync3(resolveWithinRoot(context.fernRoot, indexDescriptor.sourcePath, context.repositoryRoot), "utf8") : "";
+          const indexFrontmatter = indexSource.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/)?.[1] ?? "";
+          const indexSlug = indexFrontmatter.match(/^slug:\s*["']?([^\s"']+)["']?\s*$/m)?.[1]?.replace(/^\/+|\/+$/g, "");
+          const hasBarePage = index === indexRoute || indexSlug === indexRoute;
+          if (bareRouteIndex >= 0 && hasBarePage) context.bareRouteRedirects.splice(bareRouteIndex, 1);
+          else if (latest && bareRouteIndex >= 0) context.bareRouteRedirects[bareRouteIndex].destination = `/${latest}`;
+          return [{ tab: label, groups: [changelog] }];
+        }
+      }
+      if (groups.length === 0) return [];
+      if (segments.length > 0) addBareRouteRedirect(segments, groups, context);
+      return [{
+        tab: label,
+        ...typeof meta.icon === "string" ? { icon: meta.icon } : {},
+        groups
+      }];
     });
-    context.generatedIds.add(navigationId);
   }
-  context.referencedNavigationIds.add(navigationId);
-  return navigationId;
-}
-var DOCUSAURUS_HEX_COLOR = /^#[0-9a-fA-F]{3,8}$/;
-function findDocusaurusConfigPath(repositoryRoot) {
-  return ["docusaurus.config.js", "docusaurus.config.ts", "docusaurus.config.mjs"].map((filename) => resolveWithin(repositoryRoot, filename)).find((candidate) => existsSync3(candidate) && lstatSync3(candidate).isFile()) ?? null;
-}
-function readDocusaurusThemeColor(repositoryRoot) {
-  const configPath = findDocusaurusConfigPath(repositoryRoot);
-  if (!configPath) return void 0;
-  const configSource = readBoundedText(configPath);
-  const cssRelativePath = configSource.match(/\bcustomCss\s*:\s*(?:\[\s*)?(?:require\.resolve\(\s*)?(['"])([^'"]+)\1/)?.[2];
-  if (!cssRelativePath) return void 0;
-  let cssPath;
-  try {
-    cssPath = resolveWithin(repositoryRoot, cssRelativePath.replace(/^\.\//, ""));
-  } catch {
-    return void 0;
+  if (Array.isArray(navigation)) {
+    const sectionsBefore = context.apiSections.length;
+    const groups = groupsFromConverted(convertNodes(navigation, routePrefix, context));
+    for (let index = sectionsBefore; index < context.apiSections.length; index += 1) {
+      context.apiSections[index].tabLabel ??= fallbackTabLabel;
+    }
+    if (groups.length > 0) {
+      if (routePrefix.length > 0) addBareRouteRedirect(routePrefix, groups, context);
+      return [{ tab: fallbackTabLabel, groups }];
+    }
   }
-  if (!existsSync3(cssPath) || !lstatSync3(cssPath).isFile()) return void 0;
-  const css = readBoundedText(cssPath);
-  const pick = (block) => {
-    const value = block?.match(/--ifm-color-primary\s*:\s*([^;]+);/)?.[1]?.trim();
-    return value && DOCUSAURUS_HEX_COLOR.test(value) ? value : void 0;
-  };
-  const lightMode = pick(css.match(/:root\s*\{([^}]*)\}/)?.[1]);
-  const darkMode = pick(css.match(/\[data-theme=(['"])dark\1\]\s*\{([^}]*)\}/)?.[2]);
-  const colors = {};
-  if (darkMode) colors.light = darkMode;
-  if (lightMode) colors.dark = lightMode;
-  return Object.keys(colors).length > 0 ? colors : void 0;
-}
-function propertyStart(source, name) {
-  const pattern = new RegExp(`(?:^|[,{\\n])\\s*["']?${name}["']?\\s*:\\s*`, "m");
-  const match = pattern.exec(source);
-  return match ? match.index + match[0].length : -1;
+  return [];
 }
-function staticStringBindings(source) {
-  const bindings = /* @__PURE__ */ new Map();
-  for (const match of source.matchAll(/\bconst\s+([A-Z][A-Z0-9_]*)\s*=\s*((?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'))/g)) {
+function projectFernProducts(rawProducts, fernRoot, context) {
+  return rawProducts.flatMap((entry) => {
+    const product = objectValue3(entry);
+    const rawPath = typeof product?.path === "string" ? product.path.trim() : "";
+    if (!product || !rawPath) return [];
+    const label = typeof product["display-name"] === "string" && product["display-name"].trim() ? product["display-name"].trim() : "Product";
+    let productPath;
     try {
-      const value = JSON5.parse(match[2]);
-      if (typeof value === "string") bindings.set(match[1], value);
+      productPath = withinRealRoot(resolveWithin(fernRoot, rawPath), context.repositoryRoot);
     } catch {
+      warnOnce2(context, `fern-product-unsafe-${rawPath}`, `Skipped the Fern product "${label}" because "${rawPath}" points outside the repository (symlink or ..).`);
+      return [];
     }
-  }
-  return bindings;
-}
-function staticArrayField(source, name) {
-  const start = propertyStart(source, name);
-  return start < 0 ? null : matchingArrayLiteral(source, start);
-}
-function staticObjectEntries(array) {
-  if (!array) return [];
-  const entries = [];
-  let afterDelimiter = 1;
-  let quote = "";
-  let lineComment = false;
-  let blockComment = false;
-  for (let index = 1; index < array.length - 1; index++) {
-    const char = array[index];
-    const next = array[index + 1];
-    if (lineComment) {
-      if (char === "\n") lineComment = false;
-      continue;
+    if (!existsSync3(productPath) || !lstatSync3(productPath).isFile()) {
+      warnOnce2(context, `fern-product-missing-${rawPath}`, `Fern product "${label}" path "${rawPath}" does not exist and was skipped.`);
+      return [];
     }
-    if (blockComment) {
-      if (char === "*" && next === "/") {
-        blockComment = false;
-        index++;
-      }
-      continue;
+    let productConfig;
+    try {
+      productConfig = objectValue3(readBoundedYaml(productPath));
+    } catch (error) {
+      warnOnce2(
+        context,
+        `fern-product-read-failed-${rawPath}`,
+        `Fern product "${label}" could not be read (${error instanceof Error ? error.message : String(error)}) and was skipped.`
+      );
+      return [];
     }
-    if (quote) {
-      if (char === "\\") {
-        index++;
-        continue;
-      }
-      if (char === quote) quote = "";
-      continue;
+    if (!productConfig) return [];
+    const productDir = dirname3(productPath);
+    const routeSegment = segmentFor(product, label, context);
+    const priorPrefix = context.pathPrefix;
+    context.pathPrefix = relative4(fernRoot, productDir).replace(/\\/g, "/");
+    const before = restrictionMark(context);
+    try {
+      const tabs = buildTabsFromConfig(
+        productConfig,
+        productDir,
+        fernRoot,
+        routeSegment ? [routeSegment] : [],
+        label,
+        context
+      );
+      if (!isRestrictedNode(product)) return tabs;
+      markRestricted(context, before);
+      return [];
+    } finally {
+      context.pathPrefix = priorPrefix;
     }
-    if (char === "/" && next === "/") {
-      lineComment = true;
-      index++;
-      continue;
-    }
-    if (char === "/" && next === "*") {
-      blockComment = true;
-      index++;
-      continue;
-    }
-    if (char === '"' || char === "'" || char === "`") {
-      quote = char;
-      continue;
-    }
-    if (char === ",") {
-      afterDelimiter = index + 1;
-      continue;
-    }
-    if (char !== "{") continue;
-    const literal = matchingObjectLiteral(array, index);
-    if (!literal) continue;
-    const lead = array.slice(afterDelimiter, index).replace(/\/\*[\s\S]*?\*\/|\/\/[^\n]*/g, "").trim();
-    if (!lead) entries.push(literal);
-    index += literal.length - 1;
-  }
-  return entries;
+  });
 }
-function staticStringField(source, name, bindings) {
-  const start = propertyStart(source, name);
-  if (start < 0) return void 0;
-  const quoted = source.slice(start).match(/^("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/);
-  if (!quoted) {
-    const binding = source.slice(start).match(/^([A-Z][A-Z0-9_]*)\b/)?.[1];
-    return binding ? bindings?.get(binding) : void 0;
+function projectFernNavigation(input) {
+  const context = {
+    navigationWalk: { active: /* @__PURE__ */ new Set(), visits: 0, incomplete: false },
+    fernRoot: input.fernRoot,
+    repositoryRoot: input.repositoryRoot ?? input.fernRoot,
+    descriptors: [],
+    seenNavigationIds: /* @__PURE__ */ new Set(),
+    apiSections: [],
+    restrictedApiSections: [],
+    changelogIndexes: [],
+    warnings: [],
+    warningKeys: /* @__PURE__ */ new Set(),
+    externalLinks: [],
+    bareRouteRedirects: [],
+    segmentAliases: /* @__PURE__ */ new Map(),
+    pathPrefix: "",
+    sourcePathToNavigationId: /* @__PURE__ */ new Map()
+  };
+  const config = input.config;
+  const hasProducts = Array.isArray(config.products) && config.products.length > 0 && !Array.isArray(config.navigation);
+  const tabs = hasProducts ? projectFernProducts(config.products, input.fernRoot, context) : buildTabsFromConfig(config, input.fernRoot, input.fernRoot, [], "Documentation", context);
+  if (tabs.length === 0) {
+    context.warnings.push({
+      code: "unsupported-config",
+      message: "Fern navigation could not be projected; generated navigation will be used."
+    });
   }
-  try {
-    const parsed = JSON5.parse(quoted[1]);
-    return typeof parsed === "string" ? parsed : void 0;
-  } catch {
-    return void 0;
+  const navbarLinks = Array.isArray(config["navbar-links"]) ? config["navbar-links"].flatMap((entry) => {
+    const link = objectValue3(entry);
+    const href = typeof link?.url === "string" ? link.url : typeof link?.href === "string" ? link.href : typeof link?.value === "string" ? link.value : void 0;
+    const label = typeof link?.text === "string" ? link.text : typeof link?.label === "string" ? link.label : link?.type === "github" ? "GitHub" : void 0;
+    return href && label ? [{ label, href, ...link?.type === "github" ? { type: "github" } : {} }] : [];
+  }) : [];
+  for (const link of context.externalLinks) {
+    if (!navbarLinks.some((existing) => existing.label === link.label && existing.href === link.href)) {
+      navbarLinks.push(link);
+    }
   }
-}
-function readDocusaurusSiteSettings(repositoryRoot) {
-  const empty2 = { docsRouteBasePath: "docs", defaultColorMode: "light", navbarLinks: [], footerLinks: [] };
-  const configPath = findDocusaurusConfigPath(repositoryRoot);
-  if (!configPath) return empty2;
-  const source = readBoundedText(configPath);
-  const bindings = staticStringBindings(source);
-  const presets = staticArrayField(source, "presets");
-  const classicDocs = presets && [...presets.matchAll(/["']?docs["']?\s*:\s*/g)].map((match) => matchingObjectLiteral(presets, (match.index ?? 0) + match[0].length)).find((object) => Boolean(object));
-  const docsRouteBasePath = classicDocs && staticStringField(classicDocs, "routeBasePath") || "docs";
-  const themeStart = propertyStart(source, "themeConfig");
-  const theme = themeStart < 0 ? null : matchingObjectLiteral(source, themeStart);
-  const colorModeStart = theme ? propertyStart(theme, "colorMode") : -1;
-  const colorMode = colorModeStart < 0 ? null : matchingObjectLiteral(theme, colorModeStart);
-  const configuredColorMode = colorMode ? staticStringField(colorMode, "defaultMode") : void 0;
-  const defaultColorMode = configuredColorMode === "dark" ? "dark" : "light";
-  const navbarStart = theme ? propertyStart(theme, "navbar") : -1;
-  const navbar = navbarStart < 0 ? null : matchingObjectLiteral(theme, navbarStart);
-  const logoStart = navbar ? propertyStart(navbar, "logo") : -1;
-  const logo = logoStart < 0 ? null : matchingObjectLiteral(navbar, logoStart);
-  const footerStart = theme ? propertyStart(theme, "footer") : -1;
-  const footer = footerStart < 0 ? null : matchingObjectLiteral(theme, footerStart);
-  const navbarLinks = navbar ? staticObjectEntries(staticArrayField(navbar, "items")).flatMap((item) => {
-    if (propertyStart(item, "items") >= 0 || propertyStart(item, "dropdownItemsAfter") >= 0) return [];
-    const docsPluginId = staticStringField(item, "docsPluginId", bindings);
-    const href = staticStringField(item, "to", bindings) ?? staticStringField(item, "href", bindings);
-    const docId = staticStringField(item, "docId", bindings);
-    const sidebarId = staticStringField(item, "sidebarId", bindings);
-    const label = staticStringField(item, "label", bindings) ?? staticStringField(item, "aria-label", bindings);
-    return label && (href || docId || sidebarId || docsPluginId) ? [{
-      label,
-      ...href ? { href } : {},
-      ...docId ? { docId } : {},
-      ...sidebarId ? { sidebarId } : {},
-      ...docsPluginId ? { docsPluginId } : {}
-    }] : [];
+  const announcement = objectValue3(config.announcement);
+  const announcementMessage = typeof announcement?.message === "string" ? announcement.message.trim() : "";
+  const bannerContent = announcementMarkdown(announcementMessage);
+  const redirects = Array.isArray(config.redirects) ? config.redirects.flatMap((value) => {
+    const redirect = objectValue3(value);
+    if (!redirect || typeof redirect.source !== "string" || typeof redirect.destination !== "string") return [];
+    const rawSource = redirect.source.trim();
+    const rawDestination = redirect.destination.trim();
+    if (!isRedirectPathSafe(rawSource, rawDestination)) return [];
+    const translated = translateRedirectWildcards(rawSource, rawDestination);
+    if (!translated) {
+      warnOnce2(
+        context,
+        `fern-redirect-wildcard-${rawSource}`,
+        `Redirect from ${rawSource} uses a wildcard Next.js cannot express and was dropped.`
+      );
+      return [];
+    }
+    return [{
+      source: translated.source,
+      destination: translated.destination,
+      ...typeof redirect.permanent === "boolean" ? { permanent: redirect.permanent } : {}
+    }];
   }) : [];
-  const footerLinks = footer ? staticObjectEntries(staticArrayField(footer, "links")).flatMap((column) => {
-    const heading = staticStringField(column, "title", bindings);
-    if (!heading) return [];
-    const items = staticObjectEntries(staticArrayField(column, "items")).flatMap((item) => {
-      const href = staticStringField(item, "to", bindings) ?? staticStringField(item, "href", bindings);
-      const label = staticStringField(item, "label", bindings);
-      return label && href ? [{ label, href }] : [];
+  const authoredSources = new Set(redirects.map((redirect) => redirect.source));
+  const knownIds = new Set(context.descriptors.map((descriptor) => descriptor.navigationId));
+  const keptNavigationId = (descriptor) => context.sourcePathToNavigationId.get(descriptor.sourcePath) ?? descriptor.navigationId;
+  const segmentAliasRedirects = context.segmentAliases.size > 0 ? context.descriptors.flatMap((descriptor) => {
+    const segments = descriptor.navigationId.split("/");
+    let changed = false;
+    const aliased = segments.map((segment) => {
+      const literal = context.segmentAliases.get(segment);
+      if (!literal) return segment;
+      changed = true;
+      return literal;
     });
-    return items.length > 0 ? [{ heading, items }] : [];
+    if (!changed) return [];
+    const source = `/${aliased.join("/")}`;
+    const destination = `/${keptNavigationId(descriptor)}`;
+    if (source === destination || knownIds.has(aliased.join("/"))) return [];
+    return [{ source, destination }];
   }) : [];
-  const copyright = footer && propertyStart(footer, "copyright") >= 0 ? staticStringField(footer, "copyright") ?? footer.slice(propertyStart(footer, "copyright")).match(/^`([^`]+)`/)?.[1]?.replace(/\$\{new Date\(\)\.getFullYear\(\)\}/g, "{year}") : void 0;
-  return {
-    name: staticStringField(source, "title"),
-    description: staticStringField(source, "tagline"),
-    ...navbar && staticStringField(navbar, "title") ? { navbarTitle: staticStringField(navbar, "title") } : {},
-    defaultColorMode,
-    docsRouteBasePath,
-    ...logo && staticStringField(logo, "src") ? {
-      logo: {
-        light: staticStringField(logo, "src"),
-        ...staticStringField(logo, "srcDark") ? { dark: staticStringField(logo, "srcDark") } : {},
-        showTitle: Boolean(navbar && staticStringField(navbar, "title"))
-      }
-    } : {},
-    ...staticStringField(source, "favicon") ? { favicon: staticStringField(source, "favicon") } : {},
-    navbarLinks,
-    footerLinks,
-    ...copyright ? { copyright } : {}
-  };
-}
-function autogeneratedItems(dirName, context) {
-  const normalizedDir = dirName === "." ? "" : normalizeDocId(dirName);
-  const inDirectory = context.descriptors.filter((descriptor) => {
-    const source = descriptor.sourcePath.replace(/\.(?:mdx?)$/i, "");
-    return !normalizedDir || source === normalizedDir || source.startsWith(`${normalizedDir}/`);
+  const duplicateNavRedirects = context.descriptors.flatMap((descriptor) => {
+    const kept = keptNavigationId(descriptor);
+    if (kept === descriptor.navigationId) return [];
+    return [{ source: `/${descriptor.navigationId}`, destination: `/${kept}` }];
   });
-  const directPages = [];
-  const childDirectories = /* @__PURE__ */ new Set();
-  for (const descriptor of inDirectory) {
-    const source = descriptor.sourcePath.replace(/\.(?:mdx?)$/i, "");
-    const relativePath = normalizedDir ? posix3.relative(normalizedDir, source) : source;
-    const segments = relativePath.split("/").filter(Boolean);
-    if (segments.length <= 1) directPages.push(descriptor);
-    else childDirectories.add(segments[0]);
-  }
-  const pages = directPages.map((descriptor) => ({
-    // An index document is the category landing page in Docusaurus. Thally
-    // renders it as a child link, so put it before the category's other docs.
-    position: descriptor.sidebarPosition ?? (/(?:^|\/)(?:index|readme)\.mdx?$/i.test(descriptor.sourcePath) ? -1 : Number.MAX_SAFE_INTEGER),
-    sortKey: descriptor.sourcePath,
-    item: descriptor.navigationId
-  }));
-  const groups = [...childDirectories].map((segment) => {
-    const directory = normalizedDir ? posix3.join(normalizedDir, segment) : segment;
-    const metadata = readCategoryMetadata(context.contentRoot, directory);
-    const pages2 = autogeneratedItems(directory, context);
-    if (pages2.length === 1 && typeof pages2[0] === "string" && !metadata.label && metadata.position === void 0 && !metadata.link) {
-      const onlyPage = context.descriptors.find((descriptor) => descriptor.navigationId === pages2[0]);
-      if (onlyPage && /(?:^|\/)(?:index|readme)\.mdx?$/i.test(onlyPage.sourcePath)) {
-        return {
-          position: onlyPage.sidebarPosition ?? Number.MAX_SAFE_INTEGER,
-          sortKey: segment,
-          item: pages2[0]
-        };
-      }
+  const allRedirects = [
+    ...redirects,
+    ...context.bareRouteRedirects.filter((redirect) => !authoredSources.has(redirect.source)),
+    ...segmentAliasRedirects.filter((redirect) => !authoredSources.has(redirect.source)),
+    ...duplicateNavRedirects.filter((redirect) => !authoredSources.has(redirect.source))
+  ];
+  const claimedTabLabels = /* @__PURE__ */ new Set();
+  const disambiguatedApiSections = context.apiSections.map((section) => {
+    if (!section.tabLabel || !claimedTabLabels.has(section.tabLabel)) {
+      if (section.tabLabel) claimedTabLabels.add(section.tabLabel);
+      return section;
     }
-    const landing = generatedIndexPage(metadata.label ?? titleCase2(segment), metadata.link, context, directory);
-    if (landing && !pages2.includes(landing)) pages2.unshift(landing);
-    return {
-      position: metadata.position ?? Number.MAX_SAFE_INTEGER,
-      sortKey: segment,
-      item: {
-        group: metadata.label ?? titleCase2(segment),
-        pages: pages2
+    const distinguishingSegment = section.routeSegments.at(-1);
+    let tabLabel = distinguishingSegment ? `${section.tabLabel}: ${titleCase2(distinguishingSegment)}` : section.tabLabel;
+    if (!tabLabel || tabLabel === `${section.tabLabel}: ${section.tabLabel}` || claimedTabLabels.has(tabLabel)) {
+      let ordinal = 2;
+      let candidate = `${section.tabLabel} (${ordinal})`;
+      while (claimedTabLabels.has(candidate)) {
+        ordinal += 1;
+        candidate = `${section.tabLabel} (${ordinal})`;
       }
-    };
-  });
-  return [...pages, ...groups].sort((left, right) => left.position - right.position || left.sortKey.localeCompare(right.sortKey, void 0, { numeric: true })).map(({ item }) => {
-    if (typeof item === "string") context.referencedNavigationIds.add(item);
-    return item;
+      tabLabel = candidate;
+    }
+    claimedTabLabels.add(tabLabel);
+    return { ...section, tabLabel };
   });
-}
-function convertItems(value, context) {
-  if (typeof value === "string") {
-    const page = registerDoc(value, context);
-    return page ? [page] : [];
-  }
-  if (Array.isArray(value)) return value.flatMap((entry) => convertItems(entry, context));
-  const object = objectValue3(value);
-  if (!object) return [];
-  if (object.type === "doc" || object.type === "ref") {
-    const page = typeof object.id === "string" ? registerDoc(object.id, context) : null;
-    return page ? [page] : [];
-  }
-  if (object.type === "autogenerated") {
-    return autogeneratedItems(typeof object.dirName === "string" ? object.dirName : ".", context);
-  }
-  if (object.type === "category") {
-    const label = typeof object.label === "string" ? object.label : "Documentation";
-    const pages = convertItems(object.items, context);
-    const landing = generatedIndexPage(label, object.link, context);
-    if (landing && !pages.includes(landing)) pages.unshift(landing);
-    return pages.length > 0 ? [{ group: label, pages }] : [];
-  }
-  if (object.type === "link" || object.type === "html") return [];
-  return Object.entries(object).flatMap(([label, items]) => {
-    const pages = convertItems(items, context);
-    return pages.length > 0 ? [{ group: label, pages }] : [];
-  });
-}
-function projectDocusaurusNavigation(input) {
-  const warnings = [];
-  const descriptorByDocId = new Map(input.descriptors.map((page) => [page.docId, page]));
-  const context = {
-    contentRoot: input.contentRoot,
-    descriptors: input.descriptors,
-    descriptorByDocId,
-    generatedPages: [],
-    generatedIds: /* @__PURE__ */ new Set(),
-    referencedNavigationIds: /* @__PURE__ */ new Set(),
-    sourceUrl: input.sourceUrl,
-    routePrefix: input.routePrefix ?? "",
-    sidebarSource: input.sidebars?.sourcePath ?? "autogenerated sidebar",
-    warnings
-  };
-  const sidebarEntries = input.sidebars ? Object.entries(input.sidebars.config) : [["docs", [
-    { type: "autogenerated", dirName: "." }
-  ]]];
-  const tabs = sidebarEntries.flatMap(([sidebarId, value]) => {
-    const converted = convertItems(value, context);
-    if (converted.length === 0) return [];
-    return [{
-      tab: sidebarEntries.length === 1 ? "Documentation" : titleCase2(sidebarId),
-      // Docusaurus categories are disclosures, including at the sidebar
-      // root. Keeping them as Thally root nodes preserves their collapsed
-      // state and the authored interleaving of documents and categories.
-      pages: converted
-    }];
-  });
-  const unreferenced = input.descriptors.filter((page) => !context.referencedNavigationIds.has(page.navigationId)).sort(descriptorSort).map((page) => page.navigationId);
-  if (unreferenced.length > 0) {
-    if (tabs.length === 0) tabs.push({ tab: "Documentation", pages: [] });
-    tabs[0].pages?.push({ group: "Additional", pages: unreferenced });
-  }
-  return {
-    docsConfig: { tabs },
-    generatedPages: context.generatedPages,
-    referencedNavigationIds: context.referencedNavigationIds,
-    warnings
-  };
+  return {
+    navigationIncomplete: context.navigationWalk.incomplete,
+    docsConfig: {
+      tabs,
+      ...bannerContent ? { banner: { content: bannerContent, dismissible: true } } : {},
+      ...navbarLinks.length > 0 ? { navbar: { links: navbarLinks } } : {},
+      ...allRedirects.length > 0 ? { redirects: allRedirects } : {}
+    },
+    descriptors: context.descriptors,
+    warnings: context.warnings,
+    apiSections: disambiguatedApiSections,
+    restrictedApiSections: context.restrictedApiSections,
+    changelogIndexes: context.changelogIndexes
+  };
 }
 
-// src/fern.ts
-import { existsSync as existsSync4, lstatSync as lstatSync4, readFileSync as readFileSync4, readdirSync } from "fs";
-import { basename as basename2, dirname as dirname3, extname as extname5, relative as relative4 } from "path";
-import { load } from "cheerio";
+// src/docusaurus.ts
+import JSON5 from "json5";
+import ts4 from "typescript";
 import { parse as parseYaml3 } from "yaml";
 var MAX_CONFIG_BYTES2 = 2e7;
-function announcementMarkdown(message) {
-  const document = load(message);
-  document("script, style, iframe, object, embed, svg, math").remove();
-  const escapeText = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/([\\`*_\[\]{}()!])/g, "\\$1");
-  const links = /* @__PURE__ */ new Map();
-  document("a").each((index, element) => {
-    const marker = `THALLYANNOUNCEMENTLINK${index}TOKEN`;
-    const label = document(element).text().trim();
-    const rawHref = document(element).attr("href")?.trim() ?? "";
-    let href;
-    if (/^https?:\/\//i.test(rawHref)) {
-      try {
-        href = new URL(rawHref).toString();
-      } catch {
-      }
-    } else if (rawHref.startsWith("/") && !rawHref.startsWith("//") && !/[\\<>\s]/.test(rawHref)) {
-      href = rawHref;
-    }
-    const destination = href?.replace(/\(/g, "%28").replace(/\)/g, "%29");
-    links.set(marker, destination && label ? `[${escapeText(label)}](${destination})` : escapeText(label));
-    document(element).replaceWith(marker);
-  });
-  let text2 = escapeText(document("body").text());
-  for (const [marker, link] of links) text2 = text2.replaceAll(marker, link);
-  return text2.trim();
+var CATEGORY_FILENAMES = ["_category_.json", "_category_.yml", "_category_.yaml"];
+var SIDEBAR_FILENAMES = [
+  "sidebars.json",
+  "sidebars.js",
+  "sidebars.cjs",
+  "sidebars.mjs",
+  "sidebars.ts"
+];
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function objectValue4(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
-function titleCase3(value) {
-  return value.split(/[-_]/).filter(Boolean).map((word) => ["api", "cli", "sdk", "ui"].includes(word.toLowerCase()) ? word.toUpperCase() : word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+function stripNumberPrefix(value) {
+  return value.replace(/^\d+[-_]+/, "");
 }
-function readBoundedYaml(path) {
-  if (lstatSync4(path).size > MAX_CONFIG_BYTES2) {
-    throw new Error("The Fern config is larger than 20 MB and could not be imported.");
+function normalizeDocId(value) {
+  return value.split(/[?#]/, 1)[0].replace(/\\/g, "/").replace(/^\/+/, "").replace(/\.(?:mdx?)$/i, "").split("/").filter(Boolean).map(stripNumberPrefix).join("/");
+}
+function docusaurusSlugifySegment(value) {
+  let decoded = value;
+  try {
+    decoded = decodeURIComponent(value);
+  } catch {
   }
-  return parseYaml3(readFileSync4(path, "utf8"));
+  const slug2 = decoded.replace(/\.(?:html?|mdx?)$/i, "").replace(/[^A-Za-z0-9._-]+/g, "-").replace(/(^-|-$)/g, "");
+  return slug2 === "." || slug2 === ".." ? "" : slug2;
 }
-function readFernConfig(fernRoot) {
-  const sourcePath = "docs.yml";
-  const path = resolveWithin(fernRoot, sourcePath);
-  if (!existsSync4(path) || !lstatSync4(path).isFile()) return null;
-  const config = objectValue4(readBoundedYaml(path));
-  if (!config) throw new Error("fern/docs.yml must contain an object.");
-  return { config, sourcePath };
+function docusaurusRouteId(value) {
+  const segments = normalizeDocId(value).split("/").map(docusaurusSlugifySegment).filter(Boolean);
+  return segments.join("/") || "introduction";
 }
-function warnOnce2(context, key, message) {
-  if (context.warningKeys.has(key)) return;
-  context.warningKeys.add(key);
-  context.warnings.push({ code: "unsupported-config", message });
+function defaultDocusaurusRouteId(value) {
+  const segments = normalizeDocId(value).split("/").filter(Boolean);
+  if (/^(?:index|readme)$/i.test(segments.at(-1) ?? "")) segments.pop();
+  const normalized = segments.map(docusaurusSlugifySegment).filter(Boolean);
+  return normalized.join("/") || "introduction";
 }
-function firstLeafId(nodes) {
-  for (const node of nodes) {
-    if (typeof node === "string") return node;
-    const nested = firstLeafId(node.pages);
-    if (nested) return nested;
-  }
-  return void 0;
+function storageIdForRoute(routeId) {
+  return /(?:^|\/)(?:index|readme)$/i.test(routeId) ? `${routeId}/index` : routeId;
 }
-function addBareRouteRedirect(segments, pages, context) {
-  if (segments.length === 0) return;
-  const destination = firstLeafId(pages);
-  const source = segments.join("/");
-  if (destination && destination !== source) {
-    context.bareRouteRedirects.push({ source: `/${source}`, destination: `/${destination}` });
-  }
+function titleCase3(value) {
+  return stripNumberPrefix(value).replace(/sidebar$/i, "").split(/[-_]/).filter(Boolean).map((word) => ["api", "cli", "sdk", "ui"].includes(word.toLowerCase()) ? word.toUpperCase() : word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
-var FERN_SEGMENT_ALIAS = /^[\w.-]+$/;
-function fernBasicSlug(value) {
-  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+function routeFromSlug(slug2, fallback, sourceDirectory) {
+  if (slug2 === "/") return "introduction";
+  if (slug2.startsWith("/")) return docusaurusRouteId(slug2);
+  const fallbackDirectory = sourceDirectory ?? (fallback === "introduction" ? "" : posix3.dirname(fallback));
+  const resolved = posix3.normalize(posix3.join(fallbackDirectory, slug2));
+  if (resolved === ".." || resolved.startsWith("../")) return null;
+  return docusaurusRouteId(resolved);
 }
-function fernLabelSlug(label) {
-  const decamelized = label.replace(/[()]/g, "").replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2");
-  return fernBasicSlug(decamelized);
+function resolveDocusaurusPageIdentity(sourcePath, frontmatter, fallback) {
+  const sourceDocId = normalizeDocId(sourcePath);
+  const sourceDirectory = posix3.dirname(sourceDocId);
+  const configuredId = typeof frontmatter.id === "string" && frontmatter.id.trim() ? stripNumberPrefix(frontmatter.id.trim()) : null;
+  const docId = configuredId ? normalizeDocId(sourceDirectory === "." ? configuredId : posix3.join(sourceDirectory, configuredId)) : sourceDocId;
+  const defaultNavigationId = defaultDocusaurusRouteId(docId) ?? fallback.navigationId;
+  const configuredSlug = typeof frontmatter.slug === "string" ? frontmatter.slug.trim() : "";
+  const navigationId = configuredSlug ? routeFromSlug(
+    configuredSlug,
+    defaultNavigationId,
+    sourceDirectory === "." ? "" : sourceDirectory
+  ) ?? defaultNavigationId : defaultNavigationId;
+  const position = typeof frontmatter.sidebar_position === "number" && Number.isFinite(frontmatter.sidebar_position) ? frontmatter.sidebar_position : void 0;
+  return {
+    identity: { id: storageIdForRoute(navigationId), navigationId },
+    descriptor: {
+      sourcePath: sourcePath.replace(/\\/g, "/"),
+      docId,
+      navigationId,
+      ...position === void 0 ? {} : { sidebarPosition: position },
+      ...isUnlisted(frontmatter.unlisted) ? { unlisted: true } : {}
+    }
+  };
 }
-function segmentFor(value, label, context) {
-  if (value["skip-slug"] === true) return null;
-  if (typeof value.slug !== "string") return fernLabelSlug(label) || null;
-  const explicit = value.slug.trim();
-  if (!explicit) return null;
-  const slugified = fernBasicSlug(explicit);
-  if (context && explicit !== slugified && FERN_SEGMENT_ALIAS.test(explicit)) {
-    context.segmentAliases.set(slugified, explicit);
-  }
-  return slugified || null;
+function isUnlisted(value) {
+  return value !== void 0 && value !== null && value !== false && !(typeof value === "string" && ["", "false"].includes(value.trim().toLowerCase()));
 }
-function uniqueNavigationId(base, context) {
-  if (!context.seenNavigationIds.has(base)) return base;
-  let index = 2;
-  while (context.seenNavigationIds.has(`${base}-${index}`)) index++;
-  return `${base}-${index}`;
+function sourceReferenceKey(value) {
+  return value.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\.(?:mdx?)$/i, "").replace(/\/$/, "");
 }
-function registerPageAt(rawPath, base, context, navTitle, hidden = false) {
-  let sourcePath;
-  try {
-    const absolute = resolveWithinRoot(
-      context.pathPrefix ? resolveWithinRoot(context.fernRoot, context.pathPrefix, context.repositoryRoot) : context.fernRoot,
-      rawPath.trim(),
-      context.repositoryRoot
-    );
-    sourcePath = relative4(context.fernRoot, absolute).replace(/\\/g, "/");
-  } catch {
-    warnOnce2(context, `fern-unsafe-page-${rawPath}`, `Fern page path "${rawPath}" escapes the repository and was skipped.`);
-    return "";
-  }
-  const navigationId = uniqueNavigationId(base || "introduction", context);
-  context.seenNavigationIds.add(navigationId);
-  const isHidden = hidden || context.hiddenInherited === true;
-  context.descriptors.push({ sourcePath, navigationId, ...navTitle ? { navTitle } : {}, ...isHidden ? { hidden: true } : {} });
-  const kept = context.sourcePathToNavigationId.get(sourcePath);
-  if (kept) {
-    if (!isHidden) {
-      const owner = context.descriptors.find((descriptor) => descriptor.navigationId === kept);
-      if (owner) owner.hidden = false;
+function sourceHeadings(body) {
+  const headings = [];
+  const lines = body.split("\n");
+  let fence = null;
+  for (let index = 0; index < lines.length; index++) {
+    const line = lines[index];
+    const marker = line.match(/^ {0,3}(`{3,}|~{3,})/);
+    if (marker) {
+      if (!fence) fence = marker[1];
+      else if (marker[1][0] === fence[0] && marker[1].length >= fence.length && /^\s*$/.test(line.slice(marker[0].length))) fence = null;
+      continue;
     }
-    return kept;
+    if (fence) continue;
+    const heading = line.match(/^ {0,3}(#{2,6})\s+(.+?)\s*#*\s*$/);
+    if (!heading) continue;
+    const preceding = lines[index - 1]?.match(/^<a id="([\p{L}\p{N}_.:$-]{1,120})"><\/a>$/u);
+    const plainText2 = !/[<>{}\[\]`*_]/.test(heading[2]);
+    const generatedId = plainText2 ? heading[2].normalize("NFC").toLowerCase().replace(/[^\p{L}\p{M}\p{N}]+/gu, "-").replace(/(^-|-$)/g, "") : null;
+    headings.push({ index, level: heading[1].length, id: preceding?.[1] ?? generatedId });
   }
-  context.sourcePathToNavigationId.set(sourcePath, navigationId);
-  return navigationId;
+  return headings;
 }
-function registerFolder(object, parentSegments, context) {
-  const rawPath = String(object.folder).trim();
-  let folder;
-  try {
-    folder = resolveWithinRoot(
-      context.pathPrefix ? resolveWithinRoot(context.fernRoot, context.pathPrefix, context.repositoryRoot) : context.fernRoot,
-      rawPath,
-      context.repositoryRoot
-    );
-  } catch {
-    warnOnce2(context, `fern-unsafe-folder-${rawPath}`, `Fern folder "${rawPath}" escapes the repository and was skipped.`);
-    return null;
-  }
-  if (!existsSync4(folder) || !lstatSync4(folder).isDirectory()) {
-    warnOnce2(context, `fern-missing-folder-${rawPath}`, `Fern folder "${rawPath}" does not exist and was skipped.`);
-    return null;
-  }
-  const label = typeof object.title === "string" && object.title.trim() ? object.title.trim() : titleCase3(basename2(folder));
-  const segment = typeof object.slug === "string" || object["skip-slug"] === true ? segmentFor(object, label, context) : fernBasicSlug(basename2(folder));
-  const segments = segment ? [...parentSegments, segment] : parentSegments;
-  const visit = (directory, routeSegments, depth) => {
-    if (depth > 12 || context.descriptors.length >= 5e3) return [];
-    const pages2 = [];
-    const entries = readdirSync(directory, { withFileTypes: true }).filter((entry) => !entry.name.startsWith(".") && !entry.isSymbolicLink()).sort((left, right) => Number(left.name !== "index.mdx" && left.name !== "index.md") - Number(right.name !== "index.mdx" && right.name !== "index.md") || left.name.localeCompare(right.name));
-    for (const entry of entries) {
-      const path = resolveWithin(directory, entry.name);
-      if (entry.isDirectory()) {
-        const nested = visit(path, [...routeSegments, fernBasicSlug(entry.name)], depth + 1);
-        if (nested.length) pages2.push({ group: titleCase3(entry.name), pages: nested });
-      } else if (entry.isFile() && [".md", ".mdx"].includes(extname5(entry.name).toLowerCase())) {
-        const stem = basename2(entry.name, extname5(entry.name));
-        const pageSegment = stem.toLowerCase() === "index" ? null : fernBasicSlug(stem);
-        const route = [...routeSegments, ...pageSegment ? [pageSegment] : []].join("/");
-        const source = lstatSync4(path).size <= MAX_CONFIG_BYTES2 ? readFileSync4(path, "utf8") : "";
-        const frontmatter = source.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/)?.[1] ?? "";
-        const hidden = /^hidden:\s*true\s*$/m.test(frontmatter);
-        const registered = registerPageAt(relative4(context.fernRoot, path), route, { ...context, pathPrefix: "" }, void 0, hidden);
-        if (registered && !hidden && !context.hiddenInherited) pages2.push(registered);
-      }
+function addDocusaurusTranslatedHeadingAliases(pages) {
+  const byRoute = new Map(pages.map((page) => [page.navigationId, page]));
+  for (const page of pages) {
+    const locale = page.source.match(/(?:^|[/#])i18n\/([A-Za-z]{2,8}(?:-[A-Za-z0-9]{2,8})*)\/docusaurus-plugin-content-docs\//)?.[1];
+    if (!locale) continue;
+    const originalRoute = page.navigationId === locale ? "introduction" : page.navigationId.startsWith(`${locale}/`) ? page.navigationId.slice(locale.length + 1) : null;
+    if (!originalRoute) continue;
+    const original = byRoute.get(originalRoute);
+    if (!original) continue;
+    const originalHeadings = sourceHeadings(original.body);
+    const translatedHeadings = sourceHeadings(page.body);
+    if (!originalHeadings.length || originalHeadings.length !== translatedHeadings.length || originalHeadings.some((heading, index) => heading.level !== translatedHeadings[index].level)) continue;
+    const occupied = new Set(translatedHeadings.map((heading) => heading.id).filter((id) => !!id));
+    for (const match of page.body.matchAll(/<a\s+id="([^"]+)"/g)) occupied.add(match[1]);
+    const originalIdCounts = /* @__PURE__ */ new Map();
+    for (const heading of originalHeadings) {
+      if (heading.id) originalIdCounts.set(heading.id, (originalIdCounts.get(heading.id) ?? 0) + 1);
     }
-    return pages2;
-  };
-  const pages = visit(folder, segments, 0);
-  if (!pages.length) return null;
-  addBareRouteRedirect(segments, pages, context);
-  return { group: label, pages };
-}
-function registerPage(object, parentSegments, context) {
-  if (typeof object.path !== "string" || !object.path.trim()) return null;
-  const label = typeof object.page === "string" && object.page.trim() ? object.page.trim() : "Untitled";
-  const segment = segmentFor(object, label, context);
-  const base = [...parentSegments, segment].filter(Boolean).join("/");
-  return registerPageAt(object.path, base, context, label, object.hidden === true) || null;
-}
-function convertNode(node, parentSegments, context) {
-  const object = objectValue4(node);
-  if (!object) return null;
-  if (typeof object.page === "string") {
-    const page = registerPage(object, parentSegments, context);
-    return object.hidden === true || context.hiddenInherited ? null : page;
-  }
-  if (typeof object.folder === "string") {
-    const folder = registerFolder(object, parentSegments, object.hidden === true ? { ...context, hiddenInherited: true } : context);
-    return object.hidden === true || context.hiddenInherited ? null : folder;
+    const aliases = /* @__PURE__ */ new Map();
+    for (let index = 0; index < originalHeadings.length; index++) {
+      const id = originalHeadings[index].id;
+      if (!id || occupied.has(id) || originalIdCounts.get(id) !== 1) continue;
+      aliases.set(translatedHeadings[index].index, id);
+      occupied.add(id);
+    }
+    if (aliases.size) page.body = page.body.split("\n").flatMap((line, index) => {
+      const alias = aliases.get(index);
+      return alias ? [`<a id="${alias}"></a>`, line] : [line];
+    }).join("\n");
   }
-  if (typeof object.section === "string") {
-    const label = object.section;
-    const segment = segmentFor(object, label, context);
-    const segments = segment ? [...parentSegments, segment] : parentSegments;
-    const contents = Array.isArray(object.contents) ? object.contents : [];
-    const pages = [];
-    const hasOwnPath = typeof object.path === "string" && object.path.trim().length > 0;
-    if (hasOwnPath) {
-      const registered = registerPageAt(object.path, segments.join("/"), context, label, object.hidden === true);
-      if (registered) pages.push(registered);
+}
+function expandDocusaurusDocCardLists(pages, config, sourceRoutes) {
+  const pageByRoute = new Map(pages.map((page) => [page.navigationId, page]));
+  const containsRoute = (items, route) => items.some((item) => typeof item === "string" ? item === route : containsRoute(item.pages, route));
+  const findGroup = (items, route) => {
+    for (const item of items) {
+      if (typeof item === "string" || !containsRoute(item.pages, route)) continue;
+      return findGroup(item.pages, route) ?? item;
     }
-    for (const child of contents) {
-      const converted = convertNode(child, segments, object.hidden === true ? { ...context, hiddenInherited: true } : context);
-      if (converted) pages.push(converted);
+    return void 0;
+  };
+  const firstRoute = (items) => {
+    for (const item of items) {
+      if (typeof item === "string") return item;
+      const candidate = firstRoute(item.pages);
+      if (candidate) return candidate;
     }
-    if (pages.length === 0) return null;
-    if (!hasOwnPath && segment) addBareRouteRedirect(segments, pages, context);
-    if (object.hidden === true || context.hiddenInherited) return null;
-    return {
-      group: label,
-      ...typeof object.icon === "string" ? { icon: object.icon } : {},
-      ...object.hidden === true ? { hidden: true } : {},
-      pages
-    };
-  }
-  if (typeof object.link === "string") {
-    const label = object.link.trim();
-    const rawHref = typeof object.href === "string" ? object.href.trim() : "";
-    let href;
-    if (/^https?:\/\//i.test(rawHref) && !/[\\\u0000-\u0020\u007f]/.test(rawHref)) {
-      try {
-        const url = new URL(rawHref);
-        if (["http:", "https:"].includes(url.protocol) && !url.username && !url.password) href = url.toString();
-      } catch {
+    return void 0;
+  };
+  for (const page of pages) {
+    if (!sourceRoutes.has(page.navigationId)) continue;
+    const group = config.tabs.map((tab) => findGroup([
+      ...tab.pages ?? [],
+      ...tab.groups ?? []
+    ], page.navigationId)).find(Boolean);
+    if (!group) {
+      page.body = page.body.replace(/<div data-thally-doc-card-list=""\s*\/>/g, "");
+      continue;
+    }
+    const cards = group.pages.flatMap((item) => {
+      if (typeof item === "string") {
+        if (item === page.navigationId) return [];
+        const target = pageByRoute.get(item);
+        return [{ title: target?.title ?? item.split("/").at(-1) ?? item, route: item }];
       }
+      const slug2 = slugifySegment(item.group);
+      const routes = [...item.pages].flatMap((child) => typeof child === "string" ? [child] : []);
+      const route = routes.find((candidate) => candidate === slug2 || candidate.endsWith(`/${slug2}`)) ?? firstRoute(item.pages);
+      return route ? [{ title: item.group, route }] : [];
+    });
+    const markup = cards.length ? `<CardGroup>
+${cards.map(({ title, route }) => `  <Card title={${JSON.stringify(title)}} href={${JSON.stringify(`/${route === "introduction" ? "" : route}`)}} />`).join("\n")}
+</CardGroup>` : "";
+    page.body = page.body.replace(/<div data-thally-doc-card-list=""\s*\/>/g, markup);
+    if (markup && !page.body.includes(markup)) page.body = [page.body.trim(), markup].filter(Boolean).join("\n\n");
+  }
+}
+function rewriteDocusaurusLinks(body, current, descriptors, options = {}) {
+  const routes = /* @__PURE__ */ new Map();
+  for (const descriptor of descriptors) {
+    const sourceKey = sourceReferenceKey(descriptor.sourcePath);
+    routes.set(sourceKey, descriptor.navigationId);
+    routes.set(sourceReferenceKey(descriptor.docId), descriptor.navigationId);
+    routes.set(sourceReferenceKey(descriptor.navigationId), descriptor.navigationId);
+    const sourceRoute = pageIdFromReference(sourceKey);
+    if (sourceRoute) routes.set(sourceRoute, descriptor.navigationId);
+  }
+  const currentDirectory = posix3.dirname(sourceReferenceKey(current.sourcePath));
+  function copiedAssetTarget(target) {
+    if (!target.startsWith("/") || target.startsWith("//") || target.includes("\\")) return null;
+    const suffixIndex = target.search(/[?#]/);
+    const path = suffixIndex >= 0 ? target.slice(0, suffixIndex) : target;
+    const suffix = suffixIndex >= 0 ? target.slice(suffixIndex) : "";
+    if (path.startsWith("/docs/") && options.assetPaths?.has(path.slice("/docs/".length))) {
+      return `/${path.slice("/docs/".length)}${suffix}`;
     }
-    if (label && href && object.hidden !== true && !context.hiddenInherited) {
-      if (!context.externalLinks.some((link) => link.label === label && link.href === href)) {
-        context.externalLinks.push({ label, href });
+    return options.assetPaths?.has(path.slice(1)) ? target : null;
+  }
+  function rewriteTarget(target) {
+    if (!target || /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(target)) return target;
+    if (target.startsWith("#")) return target;
+    const suffixIndex = target.search(/[?#]/);
+    const path = suffixIndex >= 0 ? target.slice(0, suffixIndex) : target;
+    const suffix = suffixIndex >= 0 ? target.slice(suffixIndex) : "";
+    const copiedAsset = copiedAssetTarget(target);
+    if (copiedAsset) return copiedAsset;
+    const candidates = path.startsWith("/") ? [
+      sourceReferenceKey(path),
+      sourceReferenceKey(path).replace(/^docs\//, ""),
+      sourceReferenceKey(path).replace(/^docs\/(?:next|current|latest)\//, "")
+    ] : [
+      sourceReferenceKey(posix3.normalize(posix3.join(currentDirectory, path))),
+      sourceReferenceKey(path)
+    ];
+    const route = candidates.map((candidate) => routes.get(candidate)).find(Boolean);
+    if (!route) {
+      if (path.startsWith("/") && path !== "/" && options.sourceOrigin) {
+        options.onExternalLink?.(target);
+        return new URL(target, options.sourceOrigin).toString();
       }
-    } else if (!href && object.hidden !== true && !context.hiddenInherited) {
-      warnOnce2(context, `fern-link-${rawHref}`, `Fern navigation link "${label}" has an unsafe or invalid external URL and was skipped.`);
+      return target;
     }
-    return null;
+    return `${route === "introduction" ? "/" : `/${route}`}${suffix}`;
   }
-  if (typeof object.api === "string") {
-    const ownSegment = segmentFor(object, object.api, context);
-    context.apiSections.push({
-      name: typeof object["api-name"] === "string" ? object["api-name"] : object.api,
-      nameExplicit: typeof object["api-name"] === "string",
-      routeSegments: ownSegment ? [...parentSegments, ownSegment] : parentSegments
+  let codeFence = null;
+  return body.split("\n").map((line) => {
+    const fence = line.match(/^\s{0,3}(`{3,}|~{3,})/);
+    if (fence) {
+      if (!codeFence) codeFence = fence[1];
+      else if (fence[1][0] === codeFence[0] && fence[1].length >= codeFence.length && /^\s*$/.test(line.slice(fence[0].length))) codeFence = null;
+      return line;
+    }
+    if (codeFence) return line;
+    return line.replace(/(\]\()([^\s)]+)(?=[\s)]|$)/g, (_match, prefix, target) => `${prefix}${rewriteTarget(target)}`).replace(/(\bhref=")([^"]+)(")/g, (_match, prefix, target, suffix) => `${prefix}${rewriteTarget(target)}${suffix}`).replace(/(\bsrc=")([^"]+)(")/g, (_match, prefix, target, suffix) => `${prefix}${copiedAssetTarget(target) ?? target}${suffix}`).replace(/^(\s{0,3}\[[^\]]+\]:\s*)(<[^>]+>|\S+)/, (_match, prefix, destination) => {
+      const bracketed = destination.startsWith("<") && destination.endsWith(">");
+      const target = bracketed ? destination.slice(1, -1) : destination;
+      const rewritten = rewriteTarget(target);
+      return `${prefix}${bracketed ? `<${rewritten}>` : rewritten}`;
     });
-    return null;
+  }).join("\n");
+}
+function readDocusaurusSiteOrigin(repositoryRoot) {
+  const configPath = findDocusaurusConfigPath(repositoryRoot);
+  if (!configPath) return void 0;
+  const address = readBoundedText(configPath).match(/\burl['"]?\s*:\s*(['"])(https?:\/\/[^'"]+)\1/)?.[2];
+  if (!address) return void 0;
+  try {
+    return new URL(address).origin;
+  } catch {
+    return void 0;
   }
-  if (typeof object.changelog === "string") {
-    return registerFolder({ folder: object.changelog, title: "Changelog", "skip-slug": true }, parentSegments, context);
+}
+function readBoundedText(path) {
+  if (lstatSync4(path).size > MAX_CONFIG_BYTES2) {
+    throw new Error("The Docusaurus sidebar config is larger than 20 MB and could not be imported.");
   }
-  return null;
+  return readFileSync4(path, "utf8");
 }
-function convertNodes(nodes, parentSegments, context) {
-  return nodes.flatMap((node) => {
-    const converted = convertNode(node, parentSegments, context);
-    return converted ? [converted] : [];
-  });
+function braceTable(source) {
+  const table = /* @__PURE__ */ new Map();
+  try {
+    const tree = ts4.createSourceFile("config.ts", source, ts4.ScriptTarget.Latest, false, ts4.ScriptKind.TS);
+    const pending = [tree];
+    while (pending.length > 0) {
+      const node = pending.pop();
+      if (ts4.isObjectLiteralExpression(node) || ts4.isBlock(node)) {
+        const start = node.getStart(tree);
+        const end = node.end - 1;
+        if (source[start] === "{" && source[end] === "}") table.set(start, end);
+      }
+      ts4.forEachChild(node, (child) => {
+        pending.push(child);
+      });
+    }
+  } catch {
+  }
+  return table;
 }
-function groupsFromConverted(converted) {
-  const loosePages = converted.filter((entry) => typeof entry === "string");
-  const groups = converted.filter((entry) => typeof entry !== "string");
-  return loosePages.length > 0 ? [{ group: "Overview", pages: loosePages }, ...groups] : groups;
+var lastBraceSource;
+var lastBraceTable = /* @__PURE__ */ new Map();
+function matchingObjectLiteral(source, start) {
+  let index = start;
+  while (index < source.length) {
+    if (/\s/.test(source[index])) index++;
+    else if (source.startsWith("//", index)) {
+      const end2 = source.indexOf("\n", index);
+      index = end2 < 0 ? source.length : end2 + 1;
+    } else if (source.startsWith("/*", index)) {
+      const end2 = source.indexOf("*/", index + 2);
+      index = end2 < 0 ? source.length : end2 + 2;
+    } else break;
+  }
+  if (source[index] !== "{") return null;
+  if (lastBraceSource !== source) {
+    lastBraceSource = source;
+    lastBraceTable = braceTable(source);
+  }
+  const end = lastBraceTable.get(index);
+  return end === void 0 ? null : source.slice(index, end + 1);
 }
-function resolveVersionedNavigation(config, configDir, fernRoot, context) {
-  if (Array.isArray(config.navigation)) return config;
-  if (Array.isArray(config.products)) {
-    warnOnce2(context, "fern-products", "Nested Fern multi-product docs are not supported; only this docs.yml was imported.");
-    return config;
-  }
-  if (!Array.isArray(config.versions)) return config;
-  const versions = config.versions.flatMap((entry) => {
-    const version = objectValue4(entry);
-    return version ? [version] : [];
-  });
-  const chosen = versions.find((version) => version.default === true) ?? versions[0];
-  const skipped = versions.filter((version) => version !== chosen).map((version) => typeof version.version === "string" ? version.version : void 0).filter((name) => Boolean(name));
-  if (skipped.length > 0) {
-    warnOnce2(
-      context,
-      "fern-versions",
-      `Only the default Fern version was imported; other versions were skipped: ${skipped.join(", ")}.`
-    );
-  }
-  if (!chosen || typeof chosen.path !== "string") return config;
-  try {
-    const versionPath = resolveWithinRoot(configDir, chosen.path, context.repositoryRoot);
-    if (!existsSync4(versionPath) || !lstatSync4(versionPath).isFile()) {
-      warnOnce2(context, "fern-version-not-file", `Fern version file "${chosen.path}" is not a regular file and was skipped.`);
-      return config;
+function parseStaticSidebarModule(source) {
+  const bindings = /* @__PURE__ */ new Map();
+  const normalizedSource = replaceExternalFbContent(source);
+  const parseFailures = [];
+  const assignmentPatterns = [
+    /\bmodule\.exports\s*=\s*/g,
+    /\bexport\s+default\s*/g,
+    /\b(?:const|let|var)\s+[A-Za-z_$][\w$]*(?:\s*:\s*(?:(?!\b(?:const|let|var)\b)[^=;])+)?\s*=\s*/g
+  ];
+  const candidates = assignmentPatterns.flatMap((pattern) => [...normalizedSource.matchAll(pattern)]).sort((left, right) => (left.index ?? 0) - (right.index ?? 0));
+  for (const candidate of candidates) {
+    const literal = matchingObjectLiteral(normalizedSource, (candidate.index ?? 0) + candidate[0].length);
+    if (!literal) continue;
+    try {
+      const substituted = [...bindings].reduce(
+        (value, [name, binding]) => value.replace(
+          new RegExp(`(:\\s*)${escapeRegExp(name)}(?![\\w$])`, "g"),
+          (_match, prefix) => `${prefix}${JSON.stringify(binding)}`
+        ),
+        literal
+      );
+      const parsed = JSON5.parse(substituted);
+      const object = objectValue4(parsed);
+      if (!object) continue;
+      const bindingName = candidate[0].match(/\b(?:const|let|var)\s+([A-Za-z_$][\w$]*)/)?.[1];
+      if (bindingName) {
+        bindings.set(bindingName, object);
+        continue;
+      }
+      return object;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      const line = Number(message.match(/at (\d+):/)?.[1] ?? 0);
+      const context = line > 0 ? literal.split("\n").slice(Math.max(0, line - 2), line + 1).join(" ") : "";
+      parseFailures.push(`${message}${context ? ` near ${context}` : ""}`);
     }
-    const versionConfig = objectValue4(readBoundedYaml(versionPath));
-    if (!versionConfig) return config;
-    context.pathPrefix = relative4(fernRoot, dirname3(versionPath)).replace(/\\/g, "/");
-    return { ...config, navigation: versionConfig.navigation, tabs: versionConfig.tabs ?? config.tabs };
-  } catch (error) {
-    warnOnce2(
-      context,
-      "fern-version-read-failed",
-      `Fern version file "${chosen.path}" could not be read (${error instanceof Error ? error.message : String(error)}) and was skipped.`
-    );
-    return config;
   }
+  const exportedBinding = normalizedSource.match(/\bexport\s+default\s+([A-Za-z_$][\w$]*)\b/)?.[1] ?? normalizedSource.match(/\bmodule\.exports\s*=\s*([A-Za-z_$][\w$]*)\b/)?.[1];
+  if (exportedBinding && bindings.has(exportedBinding)) return bindings.get(exportedBinding);
+  throw new Error(`Sidebar config is executable or outside the supported data-only syntax.${parseFailures[0] ? ` ${parseFailures[0]}` : ""}`);
 }
-function buildTabsFromConfig(rawConfig, configDir, fernRoot, routePrefix, fallbackTabLabel, context) {
-  const config = resolveVersionedNavigation(rawConfig, configDir, fernRoot, context);
-  const tabsMeta = objectValue4(config.tabs) ?? {};
-  const navigation = config.navigation;
-  const isTabbedNavigation = Array.isArray(navigation) && navigation.length > 0 && navigation.every((entry) => typeof objectValue4(entry)?.tab === "string");
-  if (isTabbedNavigation) {
-    return navigation.flatMap((entry) => {
-      const id = String(entry.tab);
-      const meta = objectValue4(tabsMeta[id]) ?? {};
-      const label = typeof meta["display-name"] === "string" ? meta["display-name"] : titleCase3(id);
-      const tabSegment = segmentFor(meta, label, context);
-      const segments = [...routePrefix, ...tabSegment ? [tabSegment] : []];
-      const layout = Array.isArray(entry.layout) ? entry.layout : [];
-      const sectionsBefore = context.apiSections.length;
-      const groups = groupsFromConverted(convertNodes(layout, segments, context));
-      for (let index = sectionsBefore; index < context.apiSections.length; index += 1) {
-        context.apiSections[index].tabLabel ??= label;
-      }
-      if (groups.length === 0 && typeof meta.href === "string" && /^https?:\/\//i.test(meta.href)) {
-        return [{ tab: label, href: meta.href }];
-      }
-      if (groups.length === 0 && typeof meta.changelog === "string") {
-        const changelog = registerFolder({ folder: meta.changelog, title: label, "skip-slug": true }, segments, context);
-        if (changelog) {
-          const indexRoute = segments.join("/");
-          const descriptors = new Map(context.descriptors.map((descriptor) => [descriptor.navigationId, descriptor]));
-          const visiblePages = changelog.pages.filter((page) => typeof page === "string").filter((page) => !descriptors.get(page)?.hidden);
-          const index = visiblePages.find((page) => {
-            const descriptor = descriptors.get(page);
-            if (!descriptor) return false;
-            const stem = basename2(descriptor.sourcePath, extname5(descriptor.sourcePath));
-            return page === indexRoute || stem === "overview" || stem === "index";
-          });
-          const entries = visiblePages.filter((page) => page !== index).sort((left, right) => {
-            const date = (page) => descriptors.get(page)?.sourcePath.match(/\d{4}-\d{2}-\d{2}/)?.[0] ?? "";
-            return date(right).localeCompare(date(left)) || left.localeCompare(right);
-          });
-          for (const entryId of entries) {
-            const descriptor = descriptors.get(entryId);
-            if (descriptor) descriptor.hidden = true;
-          }
-          changelog.pages = [index ?? indexRoute];
-          context.changelogIndexes.push({ route: indexRoute, entries });
-          const latest = index ?? firstLeafId(changelog.pages);
-          const bareRouteIndex = context.bareRouteRedirects.findIndex((redirect) => redirect.source === `/${indexRoute}`);
-          const indexDescriptor = index ? descriptors.get(index) : void 0;
-          const indexSource = indexDescriptor && lstatSync4(resolveWithinRoot(context.fernRoot, indexDescriptor.sourcePath, context.repositoryRoot)).size <= MAX_CONFIG_BYTES2 ? readFileSync4(resolveWithinRoot(context.fernRoot, indexDescriptor.sourcePath, context.repositoryRoot), "utf8") : "";
-          const indexFrontmatter = indexSource.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/)?.[1] ?? "";
-          const indexSlug = indexFrontmatter.match(/^slug:\s*["']?([^\s"']+)["']?\s*$/m)?.[1]?.replace(/^\/+|\/+$/g, "");
-          const hasBarePage = index === indexRoute || indexSlug === indexRoute;
-          if (bareRouteIndex >= 0 && hasBarePage) context.bareRouteRedirects.splice(bareRouteIndex, 1);
-          else if (latest && bareRouteIndex >= 0) context.bareRouteRedirects[bareRouteIndex].destination = `/${latest}`;
-          return [{ tab: label, groups: [changelog] }];
-        }
+function replaceExternalFbContent(source) {
+  const marker = "...fbContent(";
+  let output = "";
+  let cursor = 0;
+  let searchFrom = 0;
+  while (true) {
+    const start = source.indexOf(marker, searchFrom);
+    if (start < 0) return `${output}${source.slice(cursor)}`.replace(/,\s*,/g, ",");
+    const objectStart = source.indexOf("{", start + marker.length);
+    if (objectStart < 0) return `${output}${source.slice(cursor)}`;
+    const objectLiteral = matchingObjectLiteral(source, objectStart);
+    if (!objectLiteral) {
+      searchFrom = start + marker.length;
+      continue;
+    }
+    const close = source.indexOf(")", objectStart + objectLiteral.length);
+    if (close < 0) return `${output}${source.slice(cursor)}`;
+    const externalMatch = /\bexternal\s*:\s*/g.exec(objectLiteral);
+    let replacement = "";
+    if (externalMatch) {
+      const arrayStart = objectLiteral.indexOf("[", externalMatch.index + externalMatch[0].length);
+      if (arrayStart >= 0) {
+        const array = matchingArrayLiteral(objectLiteral, arrayStart);
+        if (array) replacement = array.slice(1, -1);
       }
-      if (groups.length === 0) return [];
-      if (segments.length > 0) addBareRouteRedirect(segments, groups, context);
-      return [{
-        tab: label,
-        ...typeof meta.icon === "string" ? { icon: meta.icon } : {},
-        groups
-      }];
-    });
-  }
-  if (Array.isArray(navigation)) {
-    const sectionsBefore = context.apiSections.length;
-    const groups = groupsFromConverted(convertNodes(navigation, routePrefix, context));
-    for (let index = sectionsBefore; index < context.apiSections.length; index += 1) {
-      context.apiSections[index].tabLabel ??= fallbackTabLabel;
     }
-    if (groups.length > 0) {
-      if (routePrefix.length > 0) addBareRouteRedirect(routePrefix, groups, context);
-      return [{ tab: fallbackTabLabel, groups }];
+    let replaceEnd = close + 1;
+    if (!replacement) {
+      const trailingComma = /\s*,/y;
+      trailingComma.lastIndex = replaceEnd;
+      const found = trailingComma.exec(source);
+      if (found) replaceEnd += found[0].length;
     }
+    output += `${source.slice(cursor, start)}${replacement}`;
+    cursor = replaceEnd;
+    searchFrom = replaceEnd;
   }
-  return [];
 }
-function projectFernProducts(rawProducts, fernRoot, context) {
-  return rawProducts.flatMap((entry) => {
-    const product = objectValue4(entry);
-    const rawPath = typeof product?.path === "string" ? product.path.trim() : "";
-    if (!product || !rawPath) return [];
-    const label = typeof product["display-name"] === "string" && product["display-name"].trim() ? product["display-name"].trim() : "Product";
-    let productPath;
-    try {
-      productPath = resolveWithin(fernRoot, rawPath);
-    } catch {
-      warnOnce2(context, `fern-product-unsafe-${rawPath}`, `Fern product "${label}" path "${rawPath}" is unsafe and was skipped.`);
-      return [];
+function matchingArrayLiteral(source, start) {
+  let depth = 0;
+  let quote = "";
+  let isEscaped = false;
+  for (let index = start; index < source.length; index++) {
+    const character = source[index];
+    if (quote) {
+      if (isEscaped) isEscaped = false;
+      else if (character === "\\") isEscaped = true;
+      else if (character === quote) quote = "";
+      continue;
     }
-    if (!existsSync4(productPath) || !lstatSync4(productPath).isFile()) {
-      warnOnce2(context, `fern-product-missing-${rawPath}`, `Fern product "${label}" path "${rawPath}" does not exist and was skipped.`);
-      return [];
+    if (source.startsWith("//", index)) {
+      const end = source.indexOf("\n", index + 2);
+      if (end < 0) return null;
+      index = end;
+      continue;
     }
-    let productConfig;
-    try {
-      productConfig = objectValue4(readBoundedYaml(productPath));
-    } catch (error) {
-      warnOnce2(
-        context,
-        `fern-product-read-failed-${rawPath}`,
-        `Fern product "${label}" could not be read (${error instanceof Error ? error.message : String(error)}) and was skipped.`
-      );
-      return [];
+    if (source.startsWith("/*", index)) {
+      const end = source.indexOf("*/", index + 2);
+      if (end < 0) return null;
+      index = end + 1;
+      continue;
     }
-    if (!productConfig) return [];
-    const productDir = dirname3(productPath);
-    const routeSegment = segmentFor(product, label, context);
-    const priorPrefix = context.pathPrefix;
-    context.pathPrefix = relative4(fernRoot, productDir).replace(/\\/g, "/");
-    try {
-      return buildTabsFromConfig(
-        productConfig,
-        productDir,
-        fernRoot,
-        routeSegment ? [routeSegment] : [],
-        label,
-        context
-      );
-    } finally {
-      context.pathPrefix = priorPrefix;
+    if (character === '"' || character === "'" || character === "`") {
+      quote = character;
+      continue;
     }
-  });
-}
-function projectFernNavigation(input) {
-  const context = {
-    fernRoot: input.fernRoot,
-    repositoryRoot: input.repositoryRoot ?? input.fernRoot,
-    descriptors: [],
-    seenNavigationIds: /* @__PURE__ */ new Set(),
-    apiSections: [],
-    changelogIndexes: [],
-    warnings: [],
-    warningKeys: /* @__PURE__ */ new Set(),
-    externalLinks: [],
-    bareRouteRedirects: [],
-    segmentAliases: /* @__PURE__ */ new Map(),
-    pathPrefix: "",
-    sourcePathToNavigationId: /* @__PURE__ */ new Map()
-  };
-  const config = input.config;
-  const hasProducts = Array.isArray(config.products) && config.products.length > 0 && !Array.isArray(config.navigation);
-  const tabs = hasProducts ? projectFernProducts(config.products, input.fernRoot, context) : buildTabsFromConfig(config, input.fernRoot, input.fernRoot, [], "Documentation", context);
-  if (tabs.length === 0) {
-    context.warnings.push({
-      code: "unsupported-config",
-      message: "Fern navigation could not be projected; generated navigation will be used."
-    });
+    if (character === "[") depth++;
+    if (character === "]" && --depth === 0) return source.slice(start, index + 1);
   }
-  const navbarLinks = Array.isArray(config["navbar-links"]) ? config["navbar-links"].flatMap((entry) => {
-    const link = objectValue4(entry);
-    const href = typeof link?.url === "string" ? link.url : typeof link?.href === "string" ? link.href : typeof link?.value === "string" ? link.value : void 0;
-    const label = typeof link?.text === "string" ? link.text : typeof link?.label === "string" ? link.label : link?.type === "github" ? "GitHub" : void 0;
-    return href && label ? [{ label, href, ...link?.type === "github" ? { type: "github" } : {} }] : [];
-  }) : [];
-  for (const link of context.externalLinks) {
-    if (!navbarLinks.some((existing) => existing.label === link.label && existing.href === link.href)) {
-      navbarLinks.push(link);
+  return null;
+}
+function configuredSidebarPath(repositoryRoot) {
+  for (const filename of ["docusaurus.config.js", "docusaurus.config.ts", "docusaurus.config.mjs"]) {
+    const path = resolveWithin(repositoryRoot, filename);
+    if (!existsSync4(path)) continue;
+    const source = readBoundedText(path);
+    for (const docs of source.matchAll(/\bdocs\s*:\s*/g)) {
+      const object = matchingObjectLiteral(source, (docs.index ?? 0) + docs[0].length);
+      const candidate2 = object && staticStringField(object, "sidebarPath")?.replace(/^\.\//, "");
+      if (candidate2) {
+        const resolved2 = withinRealRoot(resolveWithin(repositoryRoot, candidate2), repositoryRoot);
+        if (existsSync4(resolved2) && lstatSync4(resolved2).isFile()) return candidate2;
+      }
     }
+    const match = source.match(/\bsidebarPath\s*:\s*(?:require\.resolve\(\s*)?(['"])([^'"]+)\1/);
+    if (!match) continue;
+    const candidate = match[2].replace(/^\.\//, "");
+    const resolved = withinRealRoot(resolveWithin(repositoryRoot, candidate), repositoryRoot);
+    if (existsSync4(resolved) && lstatSync4(resolved).isFile()) return candidate;
   }
-  const announcement = objectValue4(config.announcement);
-  const announcementMessage = typeof announcement?.message === "string" ? announcement.message.trim() : "";
-  const bannerContent = announcementMarkdown(announcementMessage);
-  const redirects = Array.isArray(config.redirects) ? config.redirects.flatMap((value) => {
-    const redirect = objectValue4(value);
-    if (!redirect || typeof redirect.source !== "string" || typeof redirect.destination !== "string") return [];
-    const rawSource = redirect.source.trim();
-    const rawDestination = redirect.destination.trim();
-    if (!isRedirectPathSafe(rawSource, rawDestination)) return [];
-    const translated = translateRedirectWildcards(rawSource, rawDestination);
-    if (!translated) {
-      warnOnce2(
-        context,
-        `fern-redirect-wildcard-${rawSource}`,
-        `Redirect from ${rawSource} uses a wildcard Next.js cannot express and was dropped.`
-      );
-      return [];
+  return null;
+}
+function readDocusaurusSidebars(repositoryRoot, versionedSidebarPath) {
+  const configured = versionedSidebarPath ?? configuredSidebarPath(repositoryRoot);
+  const sourcePath = [configured, ...versionedSidebarPath ? [] : SIDEBAR_FILENAMES].filter((value) => Boolean(value)).find((candidate) => {
+    const path = withinRealRoot(resolveWithin(repositoryRoot, candidate), repositoryRoot);
+    return existsSync4(path) && lstatSync4(path).isFile();
+  });
+  if (!sourcePath) return null;
+  const absolutePath = withinRealRoot(resolveWithin(repositoryRoot, sourcePath), repositoryRoot);
+  const source = readBoundedText(absolutePath);
+  const parsed = extname5(sourcePath).toLowerCase() === ".json" ? objectValue4(JSON5.parse(source)) : parseStaticSidebarModule(source);
+  if (!parsed) throw new Error("Docusaurus sidebar config must export an object.");
+  return { config: parsed, sourcePath };
+}
+function namedExportObjectLiteralText(source, name) {
+  const normalizedSource = replaceExternalFbContent(source);
+  const match = new RegExp(`\\bexport\\s+(?:const|let|var)\\s+${escapeRegExp(name)}(?![\\w$])(?:\\s*:\\s*(?:(?!\\b(?:const|let|var)\\b)[^=;])+)?\\s*=\\s*`).exec(normalizedSource);
+  if (!match) return null;
+  return matchingObjectLiteral(normalizedSource, match.index + match[0].length);
+}
+function redirectEntriesFromObjectLiteralText(objectLiteral, warnings) {
+  const match = /\bredirects\s*:\s*/.exec(objectLiteral);
+  if (!match) return [];
+  const arrayStart = objectLiteral.indexOf("[", match.index + match[0].length);
+  if (arrayStart < 0) return [];
+  const arrayLiteral = matchingArrayLiteral(objectLiteral, arrayStart);
+  if (!arrayLiteral) return [];
+  let parsed;
+  try {
+    parsed = JSON5.parse(arrayLiteral);
+  } catch {
+    return [];
+  }
+  if (!Array.isArray(parsed)) return [];
+  const entries = [];
+  for (const raw of parsed) {
+    const entry = objectValue4(raw);
+    if (!entry || typeof entry.to !== "string") continue;
+    const froms = Array.isArray(entry.from) ? entry.from : [entry.from];
+    for (const from of froms) {
+      if (typeof from !== "string") continue;
+      if (!isRedirectPathSafe(from, entry.to)) continue;
+      const translated = translateRedirectWildcards(from, entry.to);
+      if (!translated) {
+        warnings.push({ code: "unsupported-config", message: `Redirect from ${from} uses a wildcard Next.js cannot express and was dropped.` });
+        continue;
+      }
+      entries.push(translated);
     }
-    return [{
-      source: translated.source,
-      destination: translated.destination,
-      ...typeof redirect.permanent === "boolean" ? { permanent: redirect.permanent } : {}
-    }];
+  }
+  return entries;
+}
+function readDocusaurusRedirects(repositoryRoot, warnings) {
+  const configPath = findDocusaurusConfigPath(repositoryRoot);
+  if (!configPath) return [];
+  const configSource = readBoundedText(configPath);
+  const pluginMatch = /['"]@docusaurus\/plugin-client-redirects['"]\s*,\s*/.exec(configSource);
+  if (!pluginMatch) return [];
+  const afterPlugin = configSource.slice(pluginMatch.index + pluginMatch[0].length);
+  const warnAboutCreateRedirects = (source) => {
+    if (!/\bcreateRedirects\s*[:(]/.test(source)) return;
+    warnings.push({
+      code: "unsupported-config",
+      message: "The redirects plugin's createRedirects function computes redirects dynamically and cannot be evaluated during migration; add its redirects manually."
+    });
+  };
+  warnAboutCreateRedirects(configSource);
+  const inlineLiteral = matchingObjectLiteral(configSource, pluginMatch.index + pluginMatch[0].length);
+  if (inlineLiteral) return redirectEntriesFromObjectLiteralText(inlineLiteral, warnings);
+  const identifier = afterPlugin.match(/^([A-Za-z_$][\w$]*)/)?.[1];
+  if (!identifier) return [];
+  const importMatch = new RegExp(`import\\s*\\{[^}]*(?<![\\w$])${escapeRegExp(identifier)}(?![\\w$])[^}]*\\}\\s*from\\s*(['"])([^'"]+)\\1`).exec(configSource) ?? new RegExp(`import\\s+${escapeRegExp(identifier)}\\s+from\\s*(['"])([^'"]+)\\1`).exec(configSource);
+  const modulePath = importMatch?.[2];
+  if (!modulePath || !modulePath.startsWith(".")) return [];
+  let resolvedPath;
+  try {
+    resolvedPath = ["", ".ts", ".tsx", ".js", ".jsx", ".mjs"].map((extension) => withinRealRoot(resolveWithin(repositoryRoot, `${modulePath.replace(/^\.\//, "")}${extension}`), repositoryRoot)).find((candidate) => existsSync4(candidate) && lstatSync4(candidate).isFile());
+  } catch {
+    return [];
+  }
+  if (!resolvedPath) return [];
+  const moduleSource = readBoundedText(resolvedPath);
+  warnAboutCreateRedirects(moduleSource);
+  const literal = namedExportObjectLiteralText(moduleSource, identifier);
+  return literal ? redirectEntriesFromObjectLiteralText(literal, warnings) : [];
+}
+function readCategoryMetadata(contentRoot, directory) {
+  for (const filename of CATEGORY_FILENAMES) {
+    const path = resolveWithin(contentRoot, posix3.join(directory, filename));
+    try {
+      withinRealRoot(path, contentRoot);
+    } catch {
+      continue;
+    }
+    if (!existsSync4(path) || !lstatSync4(path).isFile()) continue;
+    try {
+      const raw = readBoundedText(path);
+      const parsed = filename.endsWith(".json") ? JSON5.parse(raw) : parseYaml3(raw);
+      const object = objectValue4(parsed);
+      if (!object) return {};
+      return {
+        ...typeof object.label === "string" ? { label: object.label } : {},
+        ...typeof object.position === "number" ? { position: object.position } : {},
+        ..."link" in object ? { link: object.link } : {}
+      };
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+function descriptorSort(left, right) {
+  const leftPosition = left.sidebarPosition ?? Number.MAX_SAFE_INTEGER;
+  const rightPosition = right.sidebarPosition ?? Number.MAX_SAFE_INTEGER;
+  if (leftPosition !== rightPosition) return leftPosition - rightPosition;
+  return left.sourcePath.localeCompare(right.sourcePath, void 0, { numeric: true });
+}
+function registerDoc(docId, context, sourceDirectory) {
+  const key = normalizeDocId(docId);
+  const scopedKey = sourceDirectory && !docId.startsWith("/") ? normalizeDocId(posix3.join(sourceDirectory, key)) : void 0;
+  const descriptor = (scopedKey ? context.descriptorByDocId.get(scopedKey) : void 0) ?? context.descriptorByDocId.get(key) ?? context.descriptors.find((page) => page.navigationId === docusaurusRouteId(key));
+  if (!descriptor) {
+    context.warnings.push({
+      code: "missing-page",
+      message: "A Docusaurus sidebar document did not resolve to an imported page.",
+      source: docId
+    });
+    return null;
+  }
+  context.referencedNavigationIds.add(descriptor.navigationId);
+  return descriptor.navigationId;
+}
+function generatedIndexPage(label, linkValue, context, sourceDirectory) {
+  const link = objectValue4(linkValue);
+  if (!link) return null;
+  if (link.type === "doc" && typeof link.id === "string") return registerDoc(link.id, context, sourceDirectory);
+  if (link.type !== "generated-index") return null;
+  const fallback = `category/${slugifySegment(label)}`;
+  const unprefixedNavigationId = typeof link.slug === "string" ? routeFromSlug(link.slug, fallback) ?? fallback : fallback;
+  const navigationId = context.routePrefix && unprefixedNavigationId !== context.routePrefix && !unprefixedNavigationId.startsWith(`${context.routePrefix}/`) ? posix3.join(context.routePrefix, unprefixedNavigationId) : unprefixedNavigationId;
+  if (!context.generatedIds.has(navigationId) && !context.descriptors.some((page) => page.navigationId === navigationId)) {
+    const description = typeof link.description === "string" ? link.description : `Browse the ${label} documentation.`;
+    context.generatedPages.push({
+      id: storageIdForRoute(navigationId),
+      navigationId,
+      title: typeof link.title === "string" ? link.title : label,
+      description,
+      keywords: Array.isArray(link.keywords) ? link.keywords.filter((value) => typeof value === "string") : [],
+      body: description,
+      source: `${context.sourceUrl}#${context.sidebarSource}`
+    });
+    context.generatedIds.add(navigationId);
+  }
+  context.referencedNavigationIds.add(navigationId);
+  return navigationId;
+}
+var DOCUSAURUS_HEX_COLOR = /^#[0-9a-fA-F]{3,8}$/;
+function findDocusaurusConfigPath(repositoryRoot) {
+  return ["docusaurus.config.js", "docusaurus.config.ts", "docusaurus.config.mjs"].map((filename) => resolveWithin(repositoryRoot, filename)).find((candidate) => existsSync4(candidate) && lstatSync4(candidate).isFile()) ?? null;
+}
+function readDocusaurusThemeColor(repositoryRoot) {
+  const configPath = findDocusaurusConfigPath(repositoryRoot);
+  if (!configPath) return void 0;
+  const configSource = readBoundedText(configPath);
+  const cssRelativePath = configSource.match(/\bcustomCss\s*:\s*(?:\[\s*)?(?:require\.resolve\(\s*)?(['"])([^'"]+)\1/)?.[2];
+  if (!cssRelativePath) return void 0;
+  let cssPath;
+  try {
+    cssPath = withinRealRoot(resolveWithin(repositoryRoot, cssRelativePath.replace(/^\.\//, "")), repositoryRoot);
+  } catch {
+    return void 0;
+  }
+  if (!existsSync4(cssPath) || !lstatSync4(cssPath).isFile()) return void 0;
+  const css = readBoundedText(cssPath);
+  const pick = (block) => {
+    const value = block?.match(/--ifm-color-primary\s*:\s*([^;]+);/)?.[1]?.trim();
+    return value && DOCUSAURUS_HEX_COLOR.test(value) ? value : void 0;
+  };
+  const lightMode = pick(css.match(/:root\s*\{([^}]*)\}/)?.[1]);
+  const darkMode = pick(css.match(/\[data-theme=(['"])dark\1\]\s*\{([^}]*)\}/)?.[2]);
+  const colors = {};
+  if (darkMode) colors.light = darkMode;
+  if (lightMode) colors.dark = lightMode;
+  return Object.keys(colors).length > 0 ? colors : void 0;
+}
+function propertyStart(source, name) {
+  const pattern = new RegExp(`["']?${name}["']?\\s*:\\s*`, "g");
+  for (let match = pattern.exec(source); match; match = pattern.exec(source)) {
+    let before = match.index - 1;
+    while (before >= 0 && (source[before] === " " || source[before] === "	")) before--;
+    if (before < 0 || "\r\n,{".includes(source[before])) return match.index + match[0].length;
+  }
+  return -1;
+}
+function staticStringBindings(source) {
+  const bindings = /* @__PURE__ */ new Map();
+  for (const match of source.matchAll(/\bconst\s+([A-Z][A-Z0-9_]*)\s*=\s*((?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'))/g)) {
+    try {
+      const value = JSON5.parse(match[2]);
+      if (typeof value === "string") bindings.set(match[1], value);
+    } catch {
+    }
+  }
+  return bindings;
+}
+function staticArrayField(source, name) {
+  const start = propertyStart(source, name);
+  return start < 0 ? null : matchingArrayLiteral(source, start);
+}
+function staticObjectEntries(array) {
+  if (!array) return [];
+  const entries = [];
+  let afterDelimiter = 1;
+  let quote = "";
+  let lineComment = false;
+  let blockComment = false;
+  for (let index = 1; index < array.length - 1; index++) {
+    const char = array[index];
+    const next = array[index + 1];
+    if (lineComment) {
+      if (char === "\n") lineComment = false;
+      continue;
+    }
+    if (blockComment) {
+      if (char === "*" && next === "/") {
+        blockComment = false;
+        index++;
+      }
+      continue;
+    }
+    if (quote) {
+      if (char === "\\") {
+        index++;
+        continue;
+      }
+      if (char === quote) quote = "";
+      continue;
+    }
+    if (char === "/" && next === "/") {
+      lineComment = true;
+      index++;
+      continue;
+    }
+    if (char === "/" && next === "*") {
+      blockComment = true;
+      index++;
+      continue;
+    }
+    if (char === '"' || char === "'" || char === "`") {
+      quote = char;
+      continue;
+    }
+    if (char === ",") {
+      afterDelimiter = index + 1;
+      continue;
+    }
+    if (char !== "{") continue;
+    const literal = matchingObjectLiteral(array, index);
+    if (!literal) continue;
+    const lead = array.slice(afterDelimiter, index).replace(/\/\*[\s\S]*?\*\/|\/\/[^\n]*/g, "").trim();
+    if (!lead) entries.push(literal);
+    index += literal.length - 1;
+  }
+  return entries;
+}
+function staticStringField(source, name, bindings) {
+  const start = propertyStart(source, name);
+  if (start < 0) return void 0;
+  const quoted = source.slice(start).match(/^("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/);
+  if (!quoted) {
+    const binding = source.slice(start).match(/^([A-Z][A-Z0-9_]*)\b/)?.[1];
+    return binding ? bindings?.get(binding) : void 0;
+  }
+  try {
+    const parsed = JSON5.parse(quoted[1]);
+    return typeof parsed === "string" ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function readDocusaurusSiteSettings(repositoryRoot) {
+  const empty2 = { docsRouteBasePath: "docs", defaultColorMode: "light", navbarLinks: [], footerLinks: [] };
+  const configPath = findDocusaurusConfigPath(repositoryRoot);
+  if (!configPath) return empty2;
+  const source = readBoundedText(configPath);
+  const bindings = staticStringBindings(source);
+  const presets = staticArrayField(source, "presets");
+  const classicDocs = presets && [...presets.matchAll(/["']?docs["']?\s*:\s*/g)].map((match) => matchingObjectLiteral(presets, (match.index ?? 0) + match[0].length)).find((object) => Boolean(object));
+  const docsRouteBasePath = classicDocs && staticStringField(classicDocs, "routeBasePath") || "docs";
+  const themeStart = propertyStart(source, "themeConfig");
+  const theme = themeStart < 0 ? null : matchingObjectLiteral(source, themeStart);
+  const colorModeStart = theme ? propertyStart(theme, "colorMode") : -1;
+  const colorMode = colorModeStart < 0 ? null : matchingObjectLiteral(theme, colorModeStart);
+  const configuredColorMode = colorMode ? staticStringField(colorMode, "defaultMode") : void 0;
+  const defaultColorMode = configuredColorMode === "dark" ? "dark" : "light";
+  const navbarStart = theme ? propertyStart(theme, "navbar") : -1;
+  const navbar = navbarStart < 0 ? null : matchingObjectLiteral(theme, navbarStart);
+  const logoStart = navbar ? propertyStart(navbar, "logo") : -1;
+  const logo = logoStart < 0 ? null : matchingObjectLiteral(navbar, logoStart);
+  const footerStart = theme ? propertyStart(theme, "footer") : -1;
+  const footer = footerStart < 0 ? null : matchingObjectLiteral(theme, footerStart);
+  const navbarLinks = navbar ? staticObjectEntries(staticArrayField(navbar, "items")).flatMap((item) => {
+    if (propertyStart(item, "items") >= 0 || propertyStart(item, "dropdownItemsAfter") >= 0) return [];
+    const docsPluginId = staticStringField(item, "docsPluginId", bindings);
+    const href = staticStringField(item, "to", bindings) ?? staticStringField(item, "href", bindings);
+    const docId = staticStringField(item, "docId", bindings);
+    const sidebarId = staticStringField(item, "sidebarId", bindings);
+    const label = staticStringField(item, "label", bindings) ?? staticStringField(item, "aria-label", bindings);
+    return label && (href || docId || sidebarId || docsPluginId) ? [{
+      label,
+      ...href ? { href } : {},
+      ...docId ? { docId } : {},
+      ...sidebarId ? { sidebarId } : {},
+      ...docsPluginId ? { docsPluginId } : {}
+    }] : [];
   }) : [];
-  const authoredSources = new Set(redirects.map((redirect) => redirect.source));
-  const knownIds = new Set(context.descriptors.map((descriptor) => descriptor.navigationId));
-  const keptNavigationId = (descriptor) => context.sourcePathToNavigationId.get(descriptor.sourcePath) ?? descriptor.navigationId;
-  const segmentAliasRedirects = context.segmentAliases.size > 0 ? context.descriptors.flatMap((descriptor) => {
-    const segments = descriptor.navigationId.split("/");
-    let changed = false;
-    const aliased = segments.map((segment) => {
-      const literal = context.segmentAliases.get(segment);
-      if (!literal) return segment;
-      changed = true;
-      return literal;
+  const footerLinks = footer ? staticObjectEntries(staticArrayField(footer, "links")).flatMap((column) => {
+    const heading = staticStringField(column, "title", bindings);
+    if (!heading) return [];
+    const items = staticObjectEntries(staticArrayField(column, "items")).flatMap((item) => {
+      const href = staticStringField(item, "to", bindings) ?? staticStringField(item, "href", bindings);
+      const label = staticStringField(item, "label", bindings);
+      return label && href ? [{ label, href }] : [];
     });
-    if (!changed) return [];
-    const source = `/${aliased.join("/")}`;
-    const destination = `/${keptNavigationId(descriptor)}`;
-    if (source === destination || knownIds.has(aliased.join("/"))) return [];
-    return [{ source, destination }];
+    return items.length > 0 ? [{ heading, items }] : [];
   }) : [];
-  const duplicateNavRedirects = context.descriptors.flatMap((descriptor) => {
-    const kept = keptNavigationId(descriptor);
-    if (kept === descriptor.navigationId) return [];
-    return [{ source: `/${descriptor.navigationId}`, destination: `/${kept}` }];
+  const copyright = footer && propertyStart(footer, "copyright") >= 0 ? staticStringField(footer, "copyright") ?? footer.slice(propertyStart(footer, "copyright")).match(/^`([^`]+)`/)?.[1]?.replace(/\$\{new Date\(\)\.getFullYear\(\)\}/g, "{year}") : void 0;
+  const announcementStart = theme ? propertyStart(theme, "announcementBar") : -1;
+  const announcement = announcementStart < 0 ? null : matchingObjectLiteral(theme, announcementStart);
+  const announcementContent = announcement && staticStringField(announcement, "content") || announcement?.slice(propertyStart(announcement, "content")).match(/^`([^`]+)`/)?.[1];
+  const bannerContent = announcementContent ? announcementMarkdown(announcementContent) : "";
+  return {
+    ...bannerContent ? { banner: { content: bannerContent, dismissible: !/isCloseable\s*:\s*false/.test(announcement), ...staticStringField(announcement, "id") ? { id: staticStringField(announcement, "id") } : {} } } : {},
+    name: staticStringField(source, "title"),
+    description: staticStringField(source, "tagline"),
+    ...navbar && staticStringField(navbar, "title") ? { navbarTitle: staticStringField(navbar, "title") } : {},
+    defaultColorMode,
+    docsRouteBasePath,
+    ...logo && staticStringField(logo, "src") ? {
+      logo: {
+        light: staticStringField(logo, "src"),
+        ...staticStringField(logo, "srcDark") ? { dark: staticStringField(logo, "srcDark") } : {},
+        showTitle: Boolean(navbar && staticStringField(navbar, "title"))
+      }
+    } : {},
+    ...staticStringField(source, "favicon") ? { favicon: staticStringField(source, "favicon") } : {},
+    navbarLinks,
+    footerLinks,
+    ...copyright ? { copyright } : {}
+  };
+}
+function autogeneratedItems(dirName, context) {
+  const normalizedDir = dirName === "." ? "" : dirName.replace(/\\/g, "/").replace(/^\/+|\/+$/g, "");
+  const inDirectory = context.descriptors.filter((descriptor) => {
+    const source = descriptor.sourcePath.replace(/\.(?:mdx?)$/i, "");
+    return !normalizedDir || source === normalizedDir || source.startsWith(`${normalizedDir}/`);
+  });
+  const directPages = [];
+  const childDirectories = /* @__PURE__ */ new Set();
+  for (const descriptor of inDirectory) {
+    const source = descriptor.sourcePath.replace(/\.(?:mdx?)$/i, "");
+    const relativePath = normalizedDir ? posix3.relative(normalizedDir, source) : source;
+    const segments = relativePath.split("/").filter(Boolean);
+    if (segments.length <= 1) directPages.push(descriptor);
+    else childDirectories.add(segments[0]);
+  }
+  const pages = directPages.map((descriptor) => ({
+    // An index document is the category landing page in Docusaurus. Thally
+    // renders it as a child link, so put it before the category's other docs.
+    position: descriptor.sidebarPosition ?? (/(?:^|\/)(?:index|readme)\.mdx?$/i.test(descriptor.sourcePath) ? -1 : Number.MAX_SAFE_INTEGER),
+    // Siblings sort by file or directory name, like the category entries below.
+    sortKey: posix3.basename(descriptor.sourcePath),
+    item: descriptor.navigationId
+  }));
+  const groups = [...childDirectories].map((segment) => {
+    const directory = normalizedDir ? posix3.join(normalizedDir, segment) : segment;
+    const metadata = readCategoryMetadata(context.contentRoot, directory);
+    const pages2 = autogeneratedItems(directory, context);
+    if (pages2.length === 1 && typeof pages2[0] === "string" && !metadata.label && metadata.position === void 0 && !metadata.link) {
+      const onlyPage = context.descriptors.find((descriptor) => descriptor.navigationId === pages2[0]);
+      if (onlyPage && /(?:^|\/)(?:index|readme)\.mdx?$/i.test(onlyPage.sourcePath)) {
+        return {
+          position: onlyPage.sidebarPosition ?? Number.MAX_SAFE_INTEGER,
+          sortKey: segment,
+          item: pages2[0]
+        };
+      }
+    }
+    const landing = generatedIndexPage(metadata.label ?? titleCase3(segment), metadata.link, context, directory);
+    if (landing && !pages2.includes(landing)) pages2.unshift(landing);
+    return {
+      position: metadata.position ?? Number.MAX_SAFE_INTEGER,
+      sortKey: segment,
+      item: {
+        group: metadata.label ?? titleCase3(segment),
+        pages: pages2
+      }
+    };
+  });
+  return [...pages, ...groups].sort((left, right) => left.position - right.position || left.sortKey.localeCompare(right.sortKey, void 0, { numeric: true })).map(({ item }) => {
+    if (typeof item === "string") context.referencedNavigationIds.add(item);
+    return item;
+  });
+}
+function convertItems(value, context) {
+  if (typeof value === "string") {
+    const page = registerDoc(value, context);
+    return page ? [page] : [];
+  }
+  if (Array.isArray(value)) return value.flatMap((entry) => convertItems(entry, context));
+  const object = objectValue4(value);
+  if (!object) return [];
+  if (object.type === "doc" || object.type === "ref") {
+    const page = typeof object.id === "string" ? registerDoc(object.id, context) : null;
+    return page ? [page] : [];
+  }
+  if (object.type === "autogenerated") {
+    return autogeneratedItems(typeof object.dirName === "string" ? object.dirName : ".", context);
+  }
+  if (object.type === "category") {
+    const label = typeof object.label === "string" ? object.label : "Documentation";
+    const pages = convertItems(object.items, context);
+    const landing = generatedIndexPage(label, object.link, context);
+    if (landing && !pages.includes(landing)) pages.unshift(landing);
+    return pages.length > 0 ? [{ group: label, pages }] : [];
+  }
+  if (object.type === "link" || object.type === "html") return [];
+  return Object.entries(object).flatMap(([label, items]) => {
+    const pages = convertItems(items, context);
+    return pages.length > 0 ? [{ group: label, pages }] : [];
+  });
+}
+function projectDocusaurusNavigation(input) {
+  const warnings = [];
+  const descriptorByDocId = new Map(input.descriptors.map((page) => [page.docId, page]));
+  const context = {
+    contentRoot: input.contentRoot,
+    descriptors: input.descriptors,
+    descriptorByDocId,
+    generatedPages: [],
+    generatedIds: /* @__PURE__ */ new Set(),
+    referencedNavigationIds: /* @__PURE__ */ new Set(),
+    sourceUrl: input.sourceUrl,
+    routePrefix: input.routePrefix ?? "",
+    sidebarSource: input.sidebars?.sourcePath ?? "autogenerated sidebar",
+    warnings
+  };
+  const sidebarEntries = input.sidebars ? Object.entries(input.sidebars.config) : [["docs", [
+    { type: "autogenerated", dirName: "." }
+  ]]];
+  const tabs = sidebarEntries.flatMap(([sidebarId, value]) => {
+    const converted = convertItems(value, context);
+    if (converted.length === 0) return [];
+    return [{
+      tab: sidebarEntries.length === 1 ? "Documentation" : titleCase3(sidebarId),
+      // Docusaurus categories are disclosures, including at the sidebar
+      // root. Keeping them as Thally root nodes preserves their collapsed
+      // state and the authored interleaving of documents and categories.
+      pages: converted
+    }];
   });
-  const allRedirects = [
-    ...redirects,
-    ...context.bareRouteRedirects.filter((redirect) => !authoredSources.has(redirect.source)),
-    ...segmentAliasRedirects.filter((redirect) => !authoredSources.has(redirect.source)),
-    ...duplicateNavRedirects.filter((redirect) => !authoredSources.has(redirect.source))
-  ];
-  const claimedTabLabels = /* @__PURE__ */ new Set();
-  const disambiguatedApiSections = context.apiSections.map((section) => {
-    if (!section.tabLabel || !claimedTabLabels.has(section.tabLabel)) {
-      if (section.tabLabel) claimedTabLabels.add(section.tabLabel);
-      return section;
-    }
-    const distinguishingSegment = section.routeSegments.at(-1);
-    let tabLabel = distinguishingSegment ? `${section.tabLabel}: ${titleCase3(distinguishingSegment)}` : section.tabLabel;
-    if (!tabLabel || tabLabel === `${section.tabLabel}: ${section.tabLabel}` || claimedTabLabels.has(tabLabel)) {
-      let ordinal = 2;
-      let candidate = `${section.tabLabel} (${ordinal})`;
-      while (claimedTabLabels.has(candidate)) {
-        ordinal += 1;
-        candidate = `${section.tabLabel} (${ordinal})`;
-      }
-      tabLabel = candidate;
-    }
-    claimedTabLabels.add(tabLabel);
-    return { ...section, tabLabel };
+  const unlisted = new Set(input.descriptors.filter((page) => page.unlisted).map((page) => page.navigationId));
+  const withoutUnlisted = (items) => items.flatMap((item) => {
+    if (typeof item === "string") return unlisted.has(item) ? [] : [item];
+    const pages = withoutUnlisted(item.pages);
+    return pages.length > 0 ? [{ ...item, pages }] : [];
   });
+  if (unlisted.size > 0) {
+    for (const tab of tabs) tab.pages = withoutUnlisted(tab.pages);
+  }
+  const unreferenced = input.descriptors.filter((page) => !unlisted.has(page.navigationId) && !context.referencedNavigationIds.has(page.navigationId)).sort(descriptorSort).map((page) => page.navigationId);
+  if (unreferenced.length > 0) {
+    if (tabs.length === 0) tabs.push({ tab: "Documentation", pages: [] });
+    tabs[0].pages?.push({ group: "Additional", pages: unreferenced });
+  }
   return {
-    docsConfig: {
-      tabs,
-      ...bannerContent ? { banner: { content: bannerContent, dismissible: true } } : {},
-      ...navbarLinks.length > 0 ? { navbar: { links: navbarLinks } } : {},
-      ...allRedirects.length > 0 ? { redirects: allRedirects } : {}
-    },
-    descriptors: context.descriptors,
-    warnings: context.warnings,
-    apiSections: disambiguatedApiSections,
-    changelogIndexes: context.changelogIndexes
+    docsConfig: { tabs },
+    generatedPages: context.generatedPages,
+    referencedNavigationIds: context.referencedNavigationIds,
+    warnings
+  };
+}
+function readDocusaurusPresentation(repositoryRoot) {
+  const configPath = findDocusaurusConfigPath(repositoryRoot);
+  if (!configPath) return void 0;
+  const config = readBoundedText(configPath);
+  const relative7 = config.match(/\bcustomCss\s*:\s*(?:\[\s*)?(?:require\.resolve\(\s*)?(['"])([^'"]+)\1/)?.[2];
+  if (!relative7) return void 0;
+  let css;
+  try {
+    const path = withinRealRoot(resolveWithin(repositoryRoot, relative7), repositoryRoot);
+    if (!lstatSync4(path).isFile()) return void 0;
+    css = readBoundedText(path);
+    if (/\btheme\(/.test(css) || /\.s[ac]ss$/.test(relative7)) {
+      const candidateDirectory = resolveWithin(repositoryRoot, "build/assets/css");
+      if (existsSync4(candidateDirectory)) {
+        const directory = withinRealRoot(candidateDirectory, repositoryRoot);
+        const compiled = readdirSync2(directory).filter((name) => /^styles[.\w-]*\.css$/.test(name)).sort().slice(0, 8);
+        let totalBytes = 0;
+        css = compiled.map((name) => {
+          const path2 = withinRealRoot(resolveWithin(directory, name), repositoryRoot);
+          const stat = lstatSync4(path2);
+          if (!stat.isFile()) return "";
+          totalBytes += stat.size;
+          if (totalBytes > MAX_CONFIG_BYTES2) throw new Error("Compiled theme exceeds the config size limit.");
+          return readBoundedText(path2);
+        }).join("\n") || css;
+      }
+    }
+  } catch {
+    return void 0;
+  }
+  const modes = { light: /* @__PURE__ */ new Map(), dark: /* @__PURE__ */ new Map() };
+  const banners = { light: /* @__PURE__ */ new Map(), dark: /* @__PURE__ */ new Map() };
+  try {
+    postcss3.parse(css).walkRules((rule) => {
+      if (rule.parent?.type !== "root") return;
+      for (const selector of rule.selector.split(",")) {
+        const key = selector.trim();
+        const target = key === ":root" || key === "html" || /^(?:html)?\[data-theme=['"]?light['"]?\]$/.test(key) ? modes.light : /^(?:html)?\[data-theme=['"]?dark['"]?\]$/.test(key) || key === ".dark" ? modes.dark : void 0;
+        if (target) rule.walkDecls((decl) => {
+          if (decl.prop.startsWith("--ifm-")) target.set(decl.prop, decl.value);
+        });
+        const banner = key === ".theme-announcement-bar" ? banners.light : /^(?:html)?\[data-theme=['"]?dark['"]?\] \.theme-announcement-bar$/.test(key) ? banners.dark : void 0;
+        if (banner) rule.walkDecls((decl) => {
+          banner.set(decl.prop, decl.value);
+        });
+      }
+    });
+  } catch {
+    return void 0;
+  }
+  const value = (name, mode, active = /* @__PURE__ */ new Set()) => {
+    if (active.has(name) || active.size >= 16) return void 0;
+    active.add(name);
+    const raw = modes[mode].get(name) ?? modes.light.get(name);
+    const reference = raw && /^var\((--[\w-]+)\)$/.exec(raw.trim())?.[1];
+    return reference ? value(reference, mode, active) : raw;
+  };
+  const color = (name, mode) => {
+    const raw = value(name, mode);
+    return raw ? cssColorToHex(raw) : void 0;
+  };
+  const mapped = { "--docs-bg": "--ifm-background-color", "--docs-ink": "--ifm-font-color-base", "--docs-ink-2": "--ifm-font-color-base", "--docs-accent": "--ifm-link-color" };
+  const declarations2 = (mode) => Object.entries(mapped).flatMap(([target, source]) => {
+    const hex = color(source, mode);
+    return hex ? [`${target}:${hex}`] : [];
+  }).join(";");
+  const heading = value("--ifm-heading-font-family", "light")?.trim();
+  const headingFont = heading && /^[\w -]{1,80}$/.test(heading) ? heading : void 0;
+  const dimension = (name, fallback) => {
+    const raw = value(name, "light");
+    return raw && /^\d+(?:\.\d+)?(?:px|rem)$/.test(raw) ? raw : fallback;
   };
+  const bodyFont = value("--ifm-font-family-base", "light");
+  const safeBodyFont = bodyFont && /^[\w\s,'"._-]{1,250}$/.test(bodyFont) ? bodyFont : "ui-sans-serif,system-ui,sans-serif";
+  const bannerCss = (mode) => {
+    const styles = [];
+    for (const [property, raw] of banners[mode]) {
+      const reference = /^var\((--[\w-]+)\)$/.exec(raw)?.[1];
+      const resolved = reference ? value(reference, mode) : raw;
+      if (!resolved) continue;
+      const hex = ["background-color", "color"].includes(property) ? cssColorToHex(resolved) : void 0;
+      if (hex) styles.push(`${property}:${hex}`);
+      else if (property === "font-family" && /^[\w\s,'"._-]{1,250}$/.test(resolved) || ["font-size", "padding"].includes(property) && /^(?:\d*\.?\d+(?:px|rem)?\s*){1,4}$/.test(resolved) || property === "font-weight" && /^(?:[1-9]00|bold|normal)$/.test(resolved)) styles.push(`${property}:${resolved}`);
+    }
+    return styles.join(";");
+  };
+  let tokens = "";
+  const prismStart = propertyStart(config, "prism");
+  const prism = prismStart < 0 ? null : matchingObjectLiteral(config, prismStart);
+  const themeStart = prism ? propertyStart(prism, "theme") : -1;
+  const themeExpression = themeStart < 0 ? "" : prism.slice(themeStart);
+  const identifier = /^([\w$]+)/.exec(themeExpression)?.[1];
+  const binding = identifier && config.match(new RegExp(`(?:const|let|var)\\s+${identifier.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*=\\s*(require\\([^\\n]+)`))?.[1];
+  const themePath = (themeExpression || "").match(/^require\(\s*['"]([^'"]+)['"]/)?.[1] ?? binding?.match(/^require\(\s*['"]([^'"]+)['"]/)?.[1];
+  if (themePath) try {
+    const base = resolveWithin(repositoryRoot, themePath);
+    const path = [base, `${base}.js`, `${base}/index.js`, `${base}/index.cjs.js`].find((candidate) => existsSync4(candidate) && lstatSync4(candidate).isFile());
+    if (path) {
+      const source = readBoundedText(withinRealRoot(path, repositoryRoot));
+      const start = source.search(/(?:module\.exports|(?:const|let|var)\s+\w+)\s*=/);
+      const literal = start < 0 ? null : matchingObjectLiteral(source, source.indexOf("=", start) + 1);
+      const theme = literal ? JSON5.parse(literal) : null;
+      const tokenNames = { keyword: "keyword", string: "string", comment: "comment", function: "function", property: "property", constant: "constant", punctuation: "punctuation", parameter: "parameter" };
+      const colors = /* @__PURE__ */ new Map();
+      for (const [target, raw] of [["--shiki-color-text", theme?.plain?.color], ["--docs-code-bg", theme?.plain?.backgroundColor]]) {
+        const hex = typeof raw === "string" ? cssColorToHex(raw) : void 0;
+        if (hex && target) colors.set(target, hex);
+      }
+      for (const style of theme?.styles ?? []) for (const type of Array.isArray(style.types) ? style.types : []) {
+        const hex = typeof style.style?.color === "string" ? cssColorToHex(style.style.color) : void 0;
+        if (tokenNames[type] && hex) colors.set(`--shiki-token-${tokenNames[type]}`, hex);
+      }
+      tokens = [...colors].map(([name, hex]) => `${name}:${hex}`).join(";");
+    }
+  } catch {
+  }
+  const lightAccent = color("--ifm-color-primary", "light");
+  const darkAccent = color("--ifm-color-primary", "dark");
+  return { headingFont, colors: lightAccent || darkAccent ? { dark: lightAccent, light: darkAccent } : void 0, unresolved: /\btheme\(/.test(css), css: `
+:root{${declarations2("light")}}
+:root.dark{${declarations2("dark")}}
+body{font-family:${safeBodyFont}}
+.thally-docs-root,.thally-docs-sidebar{background:var(--docs-bg);color:var(--docs-ink)}
+.thally-docs-topbar{background:var(--docs-bg);backdrop-filter:none}
+.thally-docs-topbar-inner{height:${dimension("--ifm-navbar-height", "60px")};max-width:none;padding-inline:24px}
+.thally-docs-collection-row{display:none}
+.thally-docs-actions{flex:1}.thally-docs-navlinks{order:-1;margin-left:auto;margin-right:12px}
+.thally-docs-topbar-link svg{display:none}
+.thally-docs-search,.thally-docs-search>button:first-of-type{width:180px}
+.thally-docs-search>button:first-of-type{border:1px solid var(--docs-line);border-radius:24px;background:var(--docs-bg)}
+.thally-ink-banner{${bannerCss("light")}}
+.dark .thally-ink-banner{${bannerCss("dark")}}
+.thally-ink-banner-content{color:inherit;font-size:inherit;font-weight:inherit}
+.thally-ink-banner-content a{color:var(--docs-accent)}
+.thally-ink-banner-dot{display:none}
+.thally-docs-eyebrow{display:none}
+.thally-docs-header h1{font-size:${dimension("--ifm-h1-font-size", "2.5rem")};line-height:1.25;color:var(--docs-ink)}
+.thally-docs-prose{line-height:1.5;color:var(--docs-ink)}
+.thally-docs-prose p{margin-block:0 1rem}
+.thally-docs-prose a{color:var(--docs-accent)}
+.thally-docs-code{${tokens};background:var(--docs-code-bg)}
+@media(min-width:1024px){
+.thally-docs-shell{max-width:none;padding-inline:0}
+.thally-docs-sidebar,.thally-docs-sidebar>div{width:300px}
+.thally-docs-sidebar{border-right:1px solid var(--docs-line)}
+.thally-docs-main{padding-top:50px}
+.thally-docs-main>div{padding-inline:26px}
+.thally-docs-article nav[aria-label=Breadcrumb]{display:none}
+.thally-docs-sidebar nav{padding-inline:16px}
+.thally-docs-sidebar a[aria-current=page]{background:transparent!important;text-shadow:none}
+}
+` };
 }
 
 // src/openapi-ref.ts
@@ -6733,7 +7247,7 @@ function sharedSpecMessage(path, excluded = []) {
 }
 
 // src/source-refs.ts
-import { lstatSync as lstatSync5, readdirSync as readdirSync2, readFileSync as readFileSync5, realpathSync as realpathSync2, rmSync, unlinkSync } from "fs";
+import { lstatSync as lstatSync5, readdirSync as readdirSync3, readFileSync as readFileSync5, realpathSync as realpathSync3, rmSync, unlinkSync } from "fs";
 import { isAbsolute as isAbsolute2, join, relative as relative5, resolve as resolve3, sep as sep2 } from "path";
 
 // src/url.ts
@@ -8586,7 +9100,7 @@ function sanitizeAndMeasure(root) {
   const stack = [root];
   while (stack.length > 0) {
     const directory = stack.pop();
-    for (const entry of readdirSync2(directory, { withFileTypes: true })) {
+    for (const entry of readdirSync3(directory, { withFileTypes: true })) {
       const path = join(directory, entry.name);
       if (entry.isSymbolicLink()) {
         unlinkSync(path);
@@ -8648,8 +9162,8 @@ function empty(mapping, message) {
 function importSourceRef(mapping, repositoryDir) {
   const docsRoot = findSourceRefDocsRoot(repositoryDir);
   if (!docsRoot) return empty(mapping, "no Mintlify docs.json was found in docs/ or at the repository root.");
-  const realRoot = realpathSync2(docsRoot);
-  const fromClone = relative5(realpathSync2(repositoryDir), realRoot);
+  const realRoot = realpathSync3(docsRoot);
+  const fromClone = relative5(realpathSync3(repositoryDir), realRoot);
   if (fromClone === ".." || fromClone.startsWith(`..${sep2}`) || isAbsolute2(fromClone)) return empty(mapping, "its docs directory resolves outside the repository.");
   const measured = sanitizeAndMeasure(realRoot);
   if (measured.error) return empty(mapping, `${measured.error}, over the per-repository limit. Nothing was imported.`);
@@ -8695,80 +9209,6 @@ function sourceRefMountCollides(siteRoot, mountPath) {
   });
 }
 
-// src/css-colors.ts
-var channel = (value) => Number(value);
-function cssColorToHex(raw) {
-  const value = raw.trim().replace(/\s*!important$/i, "");
-  if (value.length > 64) return void 0;
-  const hex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(value)?.[1];
-  if (hex) return `#${(hex.length === 3 ? [...hex].map((digit) => digit + digit).join("") : hex).toLowerCase()}`;
-  const rgb = /^(?:rgba?\(\s*)?(\d{1,3})(?:\s*,\s*|\s+)(\d{1,3})(?:\s*,\s*|\s+)(\d{1,3})\s*(?:[,/]\s*[\d.]+%?\s*)?\)?$/i.exec(value);
-  if (!rgb) return void 0;
-  const channels = [rgb[1], rgb[2], rgb[3]].map(channel);
-  if (channels.some((entry) => entry > 255)) return void 0;
-  if (value.includes("(") !== value.includes(")")) return void 0;
-  return `#${channels.map((entry) => entry.toString(16).padStart(2, "0")).join("")}`;
-}
-function stripComments(css) {
-  let out = "";
-  let index = 0;
-  while (index < css.length) {
-    const open = css.indexOf("/*", index);
-    if (open < 0) break;
-    out += css.slice(index, open);
-    const close = css.indexOf("*/", open + 2);
-    if (close < 0) return out;
-    index = close + 2;
-  }
-  return out + css.slice(index);
-}
-function declarations(body, into) {
-  for (const declaration of body.split(";")) {
-    const colon = declaration.indexOf(":");
-    if (colon < 0) continue;
-    const name = declaration.slice(0, colon).trim().toLowerCase();
-    if (name !== "--primary" && name !== "--primary-light" && name !== "--primary-dark") continue;
-    const hex = cssColorToHex(declaration.slice(colon + 1));
-    if (hex) into[name.slice(2)] = hex;
-  }
-}
-function cssBrandVars(css) {
-  const source = stripComments(css);
-  const root = {};
-  const dark = {};
-  let index = 0;
-  while (index < source.length) {
-    const open = source.indexOf("{", index);
-    if (open < 0) break;
-    let prelude = (source.slice(index, open).split("}").pop() ?? "").trim();
-    while (prelude.startsWith("@") && prelude.includes(";")) prelude = prelude.slice(prelude.indexOf(";") + 1).trim();
-    let depth = 1;
-    let close = open + 1;
-    for (; close < source.length && depth > 0; close++) {
-      if (source[close] === "{") depth++;
-      else if (source[close] === "}") depth--;
-    }
-    index = close;
-    if (prelude.startsWith("@")) continue;
-    for (const selector of prelude.split(",")) {
-      const name = selector.trim().toLowerCase();
-      const target = name === ":root" || name === "html" ? root : name === ".dark" || name === "html.dark" || name === ":root.dark" ? dark : void 0;
-      if (target) declarations(source.slice(open + 1, close - 1), target);
-    }
-  }
-  return { root, dark };
-}
-function brandColorsFromVars({ root, dark }) {
-  const result = {};
-  const lightAccent = root.primary;
-  const lightButton = root["primary-dark"] ?? root.primary;
-  if (lightAccent || lightButton) result.light = { ...lightAccent ? { accent: lightAccent } : {}, ...lightButton ? { primary: lightButton } : {} };
-  const darkAccent = dark["primary-light"] ?? dark.primary;
-  const darkButton = dark["primary-dark"] ?? dark["primary-light"] ?? dark.primary;
-  if (darkAccent || darkButton) result.dark = { ...darkAccent ? { accent: darkAccent } : {}, ...darkButton ? { primary: darkButton } : {} };
-  return result.light || result.dark ? result : void 0;
-}
-
 // src/repository.ts
 var MAX_SOURCE_FILES = 5e3;
 var MAX_PAGE_BYTES = 2e6;
@@ -8833,8 +9273,16 @@ var REPOSITORY_ONLY_DOCUMENTS = /* @__PURE__ */ new Set([
 ]);
 var SNIPPET_DIRECTORIES = /* @__PURE__ */ new Set(["snippets", "_snippets", "partials", "_partials"]);
 var SNIPPET_IMPORT_PATTERN = /\bimport\s+(?:\{\s*(?:default\s+as\s+)?([A-Z][A-Za-z0-9_]*)\s*\}|([A-Z][A-Za-z0-9_]*))\s+from\s+['"]([^'"]+\.mdx?)['"]\s*;?/g;
+var DOCUSAURUS_GENERATED_EXPORTS = Object.assign(/* @__PURE__ */ Object.create(null), {
+  toc: "[]",
+  frontMatter: "{}",
+  metadata: "{}",
+  assets: "{}",
+  contentTitle: "undefined"
+});
 var SNIPPET_VALUE_IMPORT_PATTERN = /\bimport\s*\{([^{}]+)\}\s*from\s+['"]([^'"]+\.mdx?)['"]\s*;?/g;
 var SNIPPET_TAG_PATTERN = /<Snippet\s+file=(?:"([^"]+)"|'([^']+)')\s*(?:\/>|>[\s\S]*?<\/Snippet>)/g;
+var FERN_MARKDOWN_TAG_PATTERN = /<Markdown\s+src=(?:"([^"]+)"|'([^']+)')\s*(?:\/>|>[\s\S]*?<\/Markdown>)/g;
 var MINTIGNORE_FILENAME = ".mintignore";
 var createIgnoreMatcher = createRequire(import.meta.url)("ignore");
 function isIgnoredDirectory(name) {
@@ -8879,7 +9327,7 @@ function countMarkdownPages(directory, limit = 2e4) {
     const current = stack.pop();
     let entries;
     try {
-      entries = readdirSync3(current, { withFileTypes: true });
+      entries = readdirSync4(current, { withFileTypes: true });
     } catch {
       continue;
     }
@@ -8932,7 +9380,7 @@ function findMintlifyProjectRoot(repositoryDir, docsDir, warnings) {
     visited++;
     if (hasMintlifyConfig(current.directory)) candidates.push(current.directory);
     if (current.depth >= 4) continue;
-    for (const entry of readdirSync3(current.directory, { withFileTypes: true })) {
+    for (const entry of readdirSync4(current.directory, { withFileTypes: true })) {
       if (!entry.isDirectory() || entry.isSymbolicLink() || isIgnoredDirectory(entry.name)) continue;
       queue.push({ directory: resolveWithin(current.directory, entry.name), depth: current.depth + 1 });
     }
@@ -8964,7 +9412,7 @@ function findFernProjectRoot(repositoryDir, docsDir) {
     visited++;
     if (hasFernConfig(current.directory)) return current.directory;
     if (current.depth >= 4) continue;
-    for (const entry of readdirSync3(current.directory, { withFileTypes: true })) {
+    for (const entry of readdirSync4(current.directory, { withFileTypes: true })) {
       if (!entry.isDirectory() || entry.isSymbolicLink() || isIgnoredDirectory(entry.name)) continue;
       queue.push({ directory: resolveWithin(current.directory, entry.name), depth: current.depth + 1 });
     }
@@ -8990,7 +9438,7 @@ function findDocusaurusProjectRoot(repositoryDir, docsDir, warnings) {
     visited++;
     if (hasDocusaurusConfig(current.directory)) candidates.push(current.directory);
     if (current.depth >= 4) continue;
-    for (const entry of readdirSync3(current.directory, { withFileTypes: true })) {
+    for (const entry of readdirSync4(current.directory, { withFileTypes: true })) {
       if (!entry.isDirectory() || entry.isSymbolicLink() || isIgnoredDirectory(entry.name)) continue;
       queue.push({
         directory: resolveWithin(current.directory, entry.name),
@@ -9100,7 +9548,7 @@ function docusaurusArchiveRoots(projectRoot, repositoryDir, warnings) {
   const directoryNames = (directory) => {
     const path = resolveWithin(projectRoot, directory);
     if (!existsSync5(path) || !lstatSync6(path).isDirectory()) return [];
-    return readdirSync3(path, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.isSymbolicLink()).map((entry) => entry.name).sort();
+    return readdirSync4(path, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.isSymbolicLink()).map((entry) => entry.name).sort();
   };
   let versions = directoryNames("versioned_docs").filter((name) => /^version-[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name));
   const versionsPath = resolveWithin(projectRoot, "versions.json");
@@ -9415,7 +9863,7 @@ function detectRepositoryPlatform(repositoryDir, docsDir) {
 }
 function containsMarkdown(directory, depth = 0) {
   if (depth > 4) return false;
-  for (const entry of readdirSync3(directory, { withFileTypes: true })) {
+  for (const entry of readdirSync4(directory, { withFileTypes: true })) {
     if (isIgnoredDirectory(entry.name) || entry.isSymbolicLink()) continue;
     const path = resolveWithin(directory, entry.name);
     if (entry.isFile() && [".md", ".mdx"].includes(extname6(entry.name).toLowerCase())) return true;
@@ -9436,7 +9884,7 @@ function scanFiles(root, confinementRoot = root, warnings, rank, budget = MAX_SO
   const walkCap = rank ? budget * RANKED_WALK_FACTOR : budget;
   let confinementReal;
   try {
-    confinementReal = realpathSync3(confinementRoot);
+    confinementReal = realpathSync4(confinementRoot);
   } catch {
     confinementReal = confinementRoot;
   }
@@ -9445,7 +9893,7 @@ function scanFiles(root, confinementRoot = root, warnings, rank, budget = MAX_SO
     if (files.length >= walkCap) return;
     let directoryReal;
     try {
-      directoryReal = realpathSync3(directory);
+      directoryReal = realpathSync4(directory);
     } catch {
       return;
     }
@@ -9453,7 +9901,7 @@ function scanFiles(root, confinementRoot = root, warnings, rank, budget = MAX_SO
     visitedRealPaths.add(directoryReal);
     let entries;
     try {
-      entries = readdirSync3(directory, { withFileTypes: true });
+      entries = readdirSync4(directory, { withFileTypes: true });
     } catch {
       return;
     }
@@ -9474,7 +9922,7 @@ function scanFiles(root, confinementRoot = root, warnings, rank, budget = MAX_SO
       if (entry.isSymbolicLink()) {
         let real;
         try {
-          real = realpathSync3(path);
+          real = realpathSync4(path);
         } catch {
           continue;
         }
@@ -9601,7 +10049,7 @@ var PATH_SEPARATORS = /[\s"'()<>[\]{}=,;:|\\`*!?#&]+/;
 function publicAssetKey(repoRelative) {
   return repoRelative.split("/", 1)[0].toLowerCase() === "public" ? repoRelative.slice("public/".length) : repoRelative;
 }
-function addPathReferences(text2, baseDir, exact, loose) {
+function addPathReferences(text2, baseDir, exact, loose, docusaurus) {
   for (const word of text2.split(PATH_SEPARATORS)) {
     let token = word.replace(/\.+$/, "");
     if (!/\.[a-z0-9]{2,5}$/i.test(token) || token.startsWith("//")) continue;
@@ -9615,14 +10063,40 @@ function addPathReferences(text2, baseDir, exact, loose) {
       loose.add(token.toLowerCase());
       continue;
     }
+    if (docusaurus && !token.startsWith("/")) {
+      const fromSite = normalizeAssetPath(posix4.normalize(token.startsWith("@site/") ? token.slice("@site/".length) : posix4.join(docusaurus.siteBase, token)));
+      const docsFolder = docusaurus.docsPrefix ? `${docusaurus.docsPrefix}/` : "";
+      const siteKey = fromSite?.startsWith("static/") ? fromSite.slice("static/".length) : fromSite && docsFolder && fromSite.startsWith(docsFolder) ? fromSite.slice(docsFolder.length) : void 0;
+      if (siteKey) {
+        exact.add(siteKey);
+        loose.add(siteKey.toLowerCase());
+      }
+      if (token.startsWith("@site/")) continue;
+    }
     if (!token.startsWith("/") && baseDir === void 0) continue;
     const resolved = normalizeAssetPath(posix4.normalize(token.startsWith("/") ? token.slice(1) : posix4.join(baseDir ?? "", token)));
     if (!resolved) continue;
-    const key = publicAssetKey(resolved);
+    const key = docusaurus && resolved.startsWith("static/") ? resolved.slice("static/".length) : publicAssetKey(resolved);
     exact.add(key);
     loose.add(key.toLowerCase());
   }
 }
+function addFernConfigPathReferences(config, exact, loose) {
+  const pending = [{ value: config, depth: 0 }];
+  const seen = /* @__PURE__ */ new Set();
+  let visits = 0;
+  while (pending.length > 0 && visits < 5e3) {
+    const { value, depth } = pending.pop();
+    visits++;
+    if (typeof value === "string") {
+      addPathReferences(value, "", exact, loose);
+    } else if (value && typeof value === "object" && !seen.has(value) && depth < 64) {
+      seen.add(value);
+      if (!Array.isArray(value) && fernViewersReason(value)) continue;
+      for (const child of Object.values(value)) pending.push({ value: child, depth: depth + 1 });
+    }
+  }
+}
 function looselyNamed(assetPath, loose) {
   const lower = assetPath.toLowerCase();
   const name = lower.split("/").pop() ?? lower;
@@ -9650,6 +10124,18 @@ function classifyApiSpec(path) {
   return /asyncapi/i.test(topLevel) ? "asyncapi" : "openapi";
 }
 var SPEC_DIRECTORY = "openapi";
+var MAX_SPEC_BYTES = 5e7;
+function readSpecFile(absolutePath, relativePath, warnings) {
+  if (lstatSync6(absolutePath).size > MAX_SPEC_BYTES) {
+    warnings.push({
+      code: "skipped-file",
+      message: `The OpenAPI spec "${relativePath}" is larger than ${MAX_SPEC_BYTES / 1e6} MB and was not migrated; split it or reduce its size.`,
+      source: relativePath
+    });
+    return void 0;
+  }
+  return readFileSync6(absolutePath);
+}
 function specAssetPath(filename) {
   return `${SPEC_DIRECTORY}/${filename}`;
 }
@@ -9725,9 +10211,11 @@ function resolveMintlifyApiSpecs(mintlifyConfig, files, warnings, remoteSpecs, p
         message: `The OpenAPI spec "${reference.value}"${tabSuffix} was limited to pages under "${reference.directory}" in the source, but Thally's API reference always covers a whole tab, so it was migrated as the tab's full API reference. Links in page bodies and Mintlify endpoint URLs under "${reference.directory}/<tag>/<operation>" are redirected to the matching endpoints where one exists (a separate warning counts any endpoint redirects that were skipped); check any other links to "${reference.directory}/..." manually.`
       });
     }
+    const content = readSpecFile(match.absolutePath, match.relativePath, warnings);
+    if (!content) continue;
     specs.push({
       filename: basename3(match.relativePath),
-      content: readFileSync6(match.absolutePath),
+      content,
       tabLabel: reference.tabLabel,
       parentTab: reference.parentTab,
       icon: reference.icon,
@@ -9976,7 +10464,7 @@ function findFernConfiguredOpenApi(fernRoot, repositoryDir, apiName, apiNameExpl
     for (const specPath of fernGeneratorsOpenApiPaths(config)) {
       if (/^(?:https?:)?\/\//i.test(specPath)) continue;
       try {
-        const absolute = resolveWithinRoot(dir, specPath, repositoryDir);
+        const absolute = withinRealRoot(resolveWithinRoot(dir, specPath, repositoryDir), repositoryDir);
         if (!existsSync5(absolute) || !lstatSync6(absolute).isFile()) continue;
         const kind = classifyApiSpec(absolute);
         if (kind === "asyncapi") {
@@ -9988,7 +10476,7 @@ function findFernConfiguredOpenApi(fernRoot, repositoryDir, apiName, apiNameExpl
       } catch {
         warnings.push({
           code: "unsupported-config",
-          message: `The OpenAPI spec path "${specPath}" in ${relative6(repositoryDir, generatorsPath).replace(/\\/g, "/")} is outside the repository and was skipped.`
+          message: `Skipped the OpenAPI spec "${specPath}" listed in ${relative6(repositoryDir, generatorsPath).replace(/\\/g, "/")} because it points outside the repository (symlink or ..).`
         });
       }
     }
@@ -10027,7 +10515,7 @@ function ownRestrictionReason(access) {
 }
 function canonicalPath(path) {
   try {
-    return realpathSync3.native(path);
+    return realpathSync4.native(path);
   } catch {
     return path;
   }
@@ -10042,14 +10530,86 @@ function pageHeadAccess(raw) {
 function describeRestriction(access) {
   return access.groups?.length ? `restricted to groups ${access.groups.join(", ")}` : "`public: false`";
 }
+function pageHeadGateReason(raw, platform) {
+  const parsed = parseFrontmatter(raw);
+  const gateKeys = platform === "docusaurus" ? /^draft\s*:/m : /^(viewers|authed)\s*:/m;
+  const unreadable = parsed.error && gateKeys.test(raw.slice(0, raw.length - parsed.content.length)) ? "frontmatter could not be parsed and declares an access or draft setting" : void 0;
+  const openapi = typeof parsed.data.openapi === "string" ? parsed.data.openapi.trim() : void 0;
+  const reason = platform === "docusaurus" ? docusaurusDraftReason(parsed.data) : fernViewersReason(parsed.data);
+  return { reason: reason ?? unreadable, openapi };
+}
+var DOCUSAURUS_DRAFT_REASON = "frontmatter `draft` marks it as a draft Docusaurus does not publish";
+function docusaurusDraftReason(data) {
+  const draft = data.draft;
+  if (draft === void 0 || draft === false || typeof draft === "string" && draft.trim().toLowerCase() === "false") return void 0;
+  return DOCUSAURUS_DRAFT_REASON;
+}
+function withoutFencedCode3(raw) {
+  let fence = null;
+  return raw.split("\n").map((line) => {
+    if (fence) {
+      const closing = /^ {0,3}(`{3,}|~{3,})[ \t]*$/.exec(line);
+      if (closing && closing[1][0] === fence.char && closing[1].length >= fence.length) fence = null;
+      return "";
+    }
+    const opening = /^ {0,3}(`{3,}|~{3,})([^\r]*)$/.exec(line);
+    if (opening && !(opening[1][0] === "`" && opening[2].includes("`"))) {
+      fence = { char: opening[1][0], length: opening[1].length };
+      return "";
+    }
+    return line;
+  }).join("\n");
+}
+function fernIfRolesReason(raw) {
+  const text2 = withoutFencedCode3(raw).replace(/(`{1,3})[^`\n]*\1/g, "");
+  const marker = /<If(?![\w$.-])/g;
+  for (let match = marker.exec(text2); match; match = marker.exec(text2)) {
+    const tag = scanJsxOpeningTag(text2, match.index, "If");
+    marker.lastIndex = tag.next;
+    if (tag.attributes.includes("...")) {
+      return "it contains `<If>` spread props whose access rules cannot be resolved safely";
+    }
+    if (tag.attributes.includes("{") && /[/`]/.test(tag.attributes)) {
+      return "it contains `<If>` expression props whose access rules cannot be resolved safely";
+    }
+    if (/(?:^|[\s{}"'])(?:roles|viewers)\s*=/.test(tag.attributes)) {
+      return "it contains `<If roles>` content that Fern shows only to some roles";
+    }
+  }
+  return void 0;
+}
+function fernViewersReason(data) {
+  const viewers = data.viewers;
+  const hasViewers = Array.isArray(viewers) ? viewers.length > 0 : typeof viewers === "string" ? viewers.trim() !== "" : viewers !== void 0 && viewers !== null && viewers !== false;
+  if (hasViewers) return "frontmatter `viewers` restricts it to signed-in roles";
+  const authed = data.authed;
+  if (authed !== void 0 && authed !== null && authed !== false && !(typeof authed === "string" && ["", "false"].includes(authed.trim().toLowerCase()))) {
+    return "frontmatter `authed` requires sign-in";
+  }
+  return void 0;
+}
 function withoutFrontmatter(value) {
   return value.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, "").trim();
 }
 function staticSnippetProperties(attributes) {
   const properties = /* @__PURE__ */ new Map();
-  const matcher = /\b([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(?:"([^"]*)"|'([^']*)'|\{\s*"([^"]*)"\s*\}|\{\s*'([^']*)'\s*\})/g;
-  for (const match of attributes.matchAll(matcher)) {
-    properties.set(match[1], match[2] ?? match[3] ?? match[4] ?? match[5] ?? "");
+  let tree;
+  try {
+    tree = ts5.createSourceFile("snippet.tsx", `const snippet = <Snippet ${attributes.replace(/\/\s*$/, "")} />`, ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
+  } catch {
+    return properties;
+  }
+  const statement = tree.statements[0];
+  if (!statement || !ts5.isVariableStatement(statement)) return properties;
+  const element = statement.declarationList.declarations[0]?.initializer;
+  if (!element || !ts5.isJsxSelfClosingElement(element)) return properties;
+  for (const attribute of element.attributes.properties) {
+    if (!ts5.isJsxAttribute(attribute) || !ts5.isIdentifier(attribute.name)) continue;
+    const value = attribute.initializer;
+    if (value && ts5.isStringLiteral(value)) properties.set(attribute.name.text, value.text);
+    else if (value && ts5.isJsxExpression(value) && value.expression && ts5.isStringLiteralLike(value.expression)) {
+      properties.set(attribute.name.text, value.expression.text);
+    }
   }
   return properties;
 }
@@ -10057,6 +10617,7 @@ function interpolateSnippet(snippet, attributes, children) {
   const properties = staticSnippetProperties(attributes);
   if (children !== void 0) properties.set("children", children.trim());
   if (properties.size === 0) return snippet;
+  snippet = bindSnippetProps(snippet, properties);
   const isJsxSnippet = /<[A-Za-z][A-Za-z0-9]*/.test(snippet);
   let fence = "";
   return snippet.split("\n").map((line) => {
@@ -10083,18 +10644,18 @@ function isolateFences(snippet, source, start, end) {
   return `${fence.test(lines[0]) && /\S/.test(before) ? "\n" : ""}${snippet}${fence.test(lines[lines.length - 1]) && /\S/.test(after) ? "\n" : ""}`;
 }
 function snippetComponentBody(source, componentName) {
-  const parsed = ts4.createSourceFile("snippet.tsx", source, ts4.ScriptTarget.Latest, true, ts4.ScriptKind.TSX);
+  const parsed = ts5.createSourceFile("snippet.tsx", source, ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
   for (const statement of parsed.statements) {
-    if (!ts4.isVariableStatement(statement)) continue;
+    if (!ts5.isVariableStatement(statement)) continue;
     for (const declaration of statement.declarationList.declarations) {
-      if (!ts4.isIdentifier(declaration.name) || declaration.name.text !== componentName) continue;
+      if (!ts5.isIdentifier(declaration.name) || declaration.name.text !== componentName) continue;
       const initializer = declaration.initializer;
-      if (!initializer || !ts4.isArrowFunction(initializer)) continue;
-      const returned = ts4.isBlock(initializer.body) ? initializer.body.statements.find(ts4.isReturnStatement)?.expression : initializer.body;
+      if (!initializer || !ts5.isArrowFunction(initializer)) continue;
+      const returned = ts5.isBlock(initializer.body) ? initializer.body.statements.find(ts5.isReturnStatement)?.expression : initializer.body;
       if (!returned) continue;
       let expression = returned;
-      while (ts4.isParenthesizedExpression(expression)) expression = expression.expression;
-      if (ts4.isJsxElement(expression) || ts4.isJsxSelfClosingElement(expression) || ts4.isJsxFragment(expression)) {
+      while (ts5.isParenthesizedExpression(expression)) expression = expression.expression;
+      if (ts5.isJsxElement(expression) || ts5.isJsxSelfClosingElement(expression) || ts5.isJsxFragment(expression)) {
         return expression.getText(parsed);
       }
     }
@@ -10102,65 +10663,65 @@ function snippetComponentBody(source, componentName) {
   return source;
 }
 function statefulSnippetDeclaration(source, componentName) {
-  const parsed = ts4.createSourceFile("snippet.tsx", source, ts4.ScriptTarget.Latest, true, ts4.ScriptKind.TSX);
-  const isEsm = (statement2) => ts4.isImportDeclaration(statement2) || (ts4.isVariableStatement(statement2) || ts4.isFunctionDeclaration(statement2) || ts4.isClassDeclaration(statement2)) && !!ts4.getModifiers(statement2)?.some((modifier) => modifier.kind === ts4.SyntaxKind.ExportKeyword);
+  const parsed = ts5.createSourceFile("snippet.tsx", source, ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
+  const isEsm = (statement2) => ts5.isImportDeclaration(statement2) || (ts5.isVariableStatement(statement2) || ts5.isFunctionDeclaration(statement2) || ts5.isClassDeclaration(statement2)) && !!ts5.getModifiers(statement2)?.some((modifier) => modifier.kind === ts5.SyntaxKind.ExportKeyword);
   if (parsed.statements.length === 0 || !parsed.statements.every(isEsm)) return null;
-  const statement = parsed.statements.find((candidate) => ts4.isVariableStatement(candidate) && candidate.declarationList.declarations.length === 1 && ts4.isIdentifier(candidate.declarationList.declarations[0].name) && candidate.declarationList.declarations[0].name.text === componentName);
-  if (!statement || !ts4.isVariableStatement(statement)) return null;
+  const statement = parsed.statements.find((candidate) => ts5.isVariableStatement(candidate) && candidate.declarationList.declarations.length === 1 && ts5.isIdentifier(candidate.declarationList.declarations[0].name) && candidate.declarationList.declarations[0].name.text === componentName);
+  if (!statement || !ts5.isVariableStatement(statement)) return null;
   const declaration = statement.declarationList.declarations[0];
-  if (!declaration.initializer || !ts4.isArrowFunction(declaration.initializer) || !ts4.isBlock(declaration.initializer.body)) return null;
+  if (!declaration.initializer || !ts5.isArrowFunction(declaration.initializer) || !ts5.isBlock(declaration.initializer.body)) return null;
   const body = declaration.initializer.body.statements;
-  if (body.length < 2 || !body.some(ts4.isReturnStatement)) return null;
+  if (body.length < 2 || !body.some(ts5.isReturnStatement)) return null;
   return source.trim();
 }
 function isStaticLiteral(expression) {
-  if (ts4.isStringLiteral(expression) || ts4.isNoSubstitutionTemplateLiteral(expression) || ts4.isNumericLiteral(expression)) return true;
-  if (expression.kind === ts4.SyntaxKind.TrueKeyword || expression.kind === ts4.SyntaxKind.FalseKeyword || expression.kind === ts4.SyntaxKind.NullKeyword) return true;
-  if (ts4.isArrayLiteralExpression(expression)) return expression.elements.every(isStaticLiteral);
-  if (ts4.isObjectLiteralExpression(expression)) {
-    return expression.properties.every((property) => ts4.isPropertyAssignment(property) && (ts4.isIdentifier(property.name) || ts4.isStringLiteral(property.name)) && isStaticLiteral(property.initializer));
+  if (ts5.isStringLiteral(expression) || ts5.isNoSubstitutionTemplateLiteral(expression) || ts5.isNumericLiteral(expression)) return true;
+  if (expression.kind === ts5.SyntaxKind.TrueKeyword || expression.kind === ts5.SyntaxKind.FalseKeyword || expression.kind === ts5.SyntaxKind.NullKeyword) return true;
+  if (ts5.isArrayLiteralExpression(expression)) return expression.elements.every(isStaticLiteral);
+  if (ts5.isObjectLiteralExpression(expression)) {
+    return expression.properties.every((property) => ts5.isPropertyAssignment(property) && (ts5.isIdentifier(property.name) || ts5.isStringLiteral(property.name)) && isStaticLiteral(property.initializer));
   }
   return false;
 }
 function snippetExportedNames(source) {
   const names = /* @__PURE__ */ new Set();
   const addBinding = (name) => {
-    if (ts4.isIdentifier(name)) names.add(name.text);
-    else for (const element of name.elements) if (!ts4.isOmittedExpression(element)) addBinding(element.name);
+    if (ts5.isIdentifier(name)) names.add(name.text);
+    else for (const element of name.elements) if (!ts5.isOmittedExpression(element)) addBinding(element.name);
   };
-  const parsed = ts4.createSourceFile("snippet.tsx", source, ts4.ScriptTarget.Latest, true, ts4.ScriptKind.TSX);
+  const parsed = ts5.createSourceFile("snippet.tsx", source, ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
   for (const statement of parsed.statements) {
-    if (ts4.isExportDeclaration(statement)) {
-      if (statement.exportClause && ts4.isNamedExports(statement.exportClause)) {
+    if (ts5.isExportDeclaration(statement)) {
+      if (statement.exportClause && ts5.isNamedExports(statement.exportClause)) {
         for (const element of statement.exportClause.elements) names.add(element.name.text);
       }
       continue;
     }
-    const modifiers = ts4.getModifiers(statement);
-    if (!modifiers?.some((modifier) => modifier.kind === ts4.SyntaxKind.ExportKeyword)) continue;
-    if (modifiers.some((modifier) => modifier.kind === ts4.SyntaxKind.DefaultKeyword)) continue;
-    if (ts4.isVariableStatement(statement)) for (const declaration of statement.declarationList.declarations) addBinding(declaration.name);
-    else if ((ts4.isFunctionDeclaration(statement) || ts4.isClassDeclaration(statement)) && statement.name) names.add(statement.name.text);
+    const modifiers = ts5.getModifiers(statement);
+    if (!modifiers?.some((modifier) => modifier.kind === ts5.SyntaxKind.ExportKeyword)) continue;
+    if (modifiers.some((modifier) => modifier.kind === ts5.SyntaxKind.DefaultKeyword)) continue;
+    if (ts5.isVariableStatement(statement)) for (const declaration of statement.declarationList.declarations) addBinding(declaration.name);
+    else if ((ts5.isFunctionDeclaration(statement) || ts5.isClassDeclaration(statement)) && statement.name) names.add(statement.name.text);
   }
   return names;
 }
 function staticNamedSnippetValues(source) {
   const values = /* @__PURE__ */ new Map();
-  const parsed = ts4.createSourceFile("snippet.tsx", source, ts4.ScriptTarget.Latest, true, ts4.ScriptKind.TSX);
+  const parsed = ts5.createSourceFile("snippet.tsx", source, ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
   for (const statement of parsed.statements) {
-    if (!ts4.isVariableStatement(statement) || !statement.modifiers?.some((modifier) => modifier.kind === ts4.SyntaxKind.ExportKeyword)) continue;
+    if (!ts5.isVariableStatement(statement) || !statement.modifiers?.some((modifier) => modifier.kind === ts5.SyntaxKind.ExportKeyword)) continue;
     for (const declaration of statement.declarationList.declarations) {
-      if (!ts4.isIdentifier(declaration.name) || !declaration.initializer) continue;
+      if (!ts5.isIdentifier(declaration.name) || !declaration.initializer) continue;
       const expression = declaration.initializer;
-      if (ts4.isStringLiteral(expression) || ts4.isNoSubstitutionTemplateLiteral(expression)) {
+      if (ts5.isStringLiteral(expression) || ts5.isNoSubstitutionTemplateLiteral(expression)) {
         values.set(declaration.name.text, JSON.stringify(expression.text));
-      } else if (ts4.isNumericLiteral(expression)) {
+      } else if (ts5.isNumericLiteral(expression)) {
         values.set(declaration.name.text, expression.text);
-      } else if (expression.kind === ts4.SyntaxKind.TrueKeyword || expression.kind === ts4.SyntaxKind.FalseKeyword) {
-        values.set(declaration.name.text, expression.kind === ts4.SyntaxKind.TrueKeyword ? "true" : "false");
-      } else if (/^[a-z_$]/.test(declaration.name.text) && (ts4.isArrowFunction(expression) || ts4.isFunctionExpression(expression)) && isSelfContainedFunction(expression)) {
+      } else if (expression.kind === ts5.SyntaxKind.TrueKeyword || expression.kind === ts5.SyntaxKind.FalseKeyword) {
+        values.set(declaration.name.text, expression.kind === ts5.SyntaxKind.TrueKeyword ? "true" : "false");
+      } else if (/^[a-z_$]/.test(declaration.name.text) && (ts5.isArrowFunction(expression) || ts5.isFunctionExpression(expression)) && isSelfContainedFunction(expression)) {
         values.set(declaration.name.text, expression.getText(parsed));
-      } else if ((ts4.isObjectLiteralExpression(expression) || ts4.isArrayLiteralExpression(expression)) && isStaticLiteral(expression)) {
+      } else if ((ts5.isObjectLiteralExpression(expression) || ts5.isArrayLiteralExpression(expression)) && isStaticLiteral(expression)) {
         values.set(declaration.name.text, expression.getText(parsed));
       }
     }
@@ -10286,6 +10847,14 @@ function preserveLinkedAnchors(pages) {
   for (const page of pages) {
     const fragments = requested.get(page.id);
     if (!fragments?.size) continue;
+    const definitions = /* @__PURE__ */ new Map();
+    replaceOutsideCodeAndComments(page.body, (text2) => {
+      for (const match of text2.matchAll(/^ {0,3}\[([^\]\n]+)\]:[^\n]*$/gm)) {
+        const label = match[1].trim().replace(/\s+/g, " ").toLowerCase();
+        if (!definitions.has(label)) definitions.set(label, match[0]);
+      }
+      return text2;
+    });
     const lines = page.body.split("\n");
     let fence;
     const tableCells = [];
@@ -10300,7 +10869,7 @@ function preserveLinkedAnchors(pages) {
       const tableCell = line.match(/^ {0,3}\|\s*([^|]+?)\s*\|/);
       if (tableCell && !/^[:\s-]+$/.test(tableCell[1])) tableCells.push({ index, text: tableCell[1] });
       const match = line.match(/^ {0,3}#{1,6}\s+(.+?)\s*#*\s*$/);
-      return match ? { index, text: match[1].replace(/\s*\{\/\*\s*#\S+?\s*\*\/\}$/, "") } : null;
+      return match ? { index, text: mdxVisibleText(match[1].replace(/\s*\{\/\*\s*#\S+?\s*\*\/\}$/, ""), definitions) } : null;
     }).filter((entry) => entry !== null);
     const existing = /* @__PURE__ */ new Set();
     replaceOutsideCode(page.body, (text2) => {
@@ -10403,18 +10972,66 @@ function resolveSnippetPath(sourcePath, currentFile, repositoryRoot, siteRoot) {
   resolveWithin(repositoryRoot, relative6(repositoryRoot, candidate));
   return withinRealRoot(candidate, repositoryRoot);
 }
-function withinRealRoot(candidate, repositoryRoot) {
-  let real;
-  try {
-    real = realpathSync3(candidate);
-  } catch {
-    return candidate;
-  }
-  const realRoot = realpathSync3(repositoryRoot);
-  if (real !== realRoot && !real.startsWith(realRoot.endsWith(sep3) ? realRoot : realRoot + sep3)) {
-    throw new Error(`Migration path escapes its root: ${candidate}`);
+function docusaurusGlobalImports(siteRoot, repositoryRoot, warnings) {
+  const registrations = /* @__PURE__ */ new Map();
+  for (const filename of ["MDXComponents.js", "MDXComponents.jsx", "MDXComponents.ts", "MDXComponents.tsx", "MDXComponents/index.js", "MDXComponents/index.tsx"]) {
+    try {
+      const path = withinRealRoot(resolveWithin(siteRoot, `src/theme/${filename}`), repositoryRoot);
+      if (!existsSync5(path) || !lstatSync6(path).isFile()) continue;
+      if (lstatSync6(path).size > MAX_PAGE_BYTES) throw new Error("registry exceeds the 2 MB limit");
+      const tree = ts5.createSourceFile(path, readFileSync6(path, "utf8"), ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
+      const bindings = /* @__PURE__ */ new Map();
+      for (const statement of tree.statements) {
+        if (!ts5.isImportDeclaration(statement) || !ts5.isStringLiteral(statement.moduleSpecifier) || statement.importClause?.isTypeOnly) continue;
+        let source = statement.moduleSpecifier.text;
+        if (source.startsWith(".")) source = `@site/${posix4.normalize(posix4.join("src/theme", posix4.dirname(filename), source))}`;
+        if (!source.startsWith("@site/") && !source.startsWith("/")) continue;
+        const clause = statement.importClause;
+        if (clause?.name) bindings.set(clause.name.text, { source, imported: "default" });
+        if (clause?.namedBindings && ts5.isNamedImports(clause.namedBindings)) {
+          for (const binding of clause.namedBindings.elements) {
+            if (!binding.isTypeOnly) bindings.set(binding.name.text, { source, imported: binding.propertyName?.text ?? binding.name.text });
+          }
+        }
+      }
+      for (const statement of tree.statements) {
+        if (!ts5.isExportAssignment(statement) || statement.isExportEquals || !ts5.isObjectLiteralExpression(statement.expression)) continue;
+        for (const property of statement.expression.properties) {
+          if (!ts5.isShorthandPropertyAssignment(property) && !ts5.isPropertyAssignment(property)) continue;
+          const name = property.name.getText(tree).replace(/^['"]|['"]$/g, "");
+          const local = ts5.isShorthandPropertyAssignment(property) ? property.name : property.initializer;
+          if (!/^[A-Z][\w$]*$/.test(name) || !ts5.isIdentifier(local)) continue;
+          const binding = bindings.get(local.text);
+          if (!binding) continue;
+          if (isThallyBuiltinComponent(name)) {
+            warnings.push({ code: "unsupported-config", message: `Global ${name} override uses the native widget mapping; review the source override for custom styling.`, source: `src/theme/${filename}` });
+            continue;
+          }
+          registrations.set(name, binding.imported === "default" ? `import ${name} from ${JSON.stringify(binding.source)};` : `import { ${binding.imported} as ${name} } from ${JSON.stringify(binding.source)};`);
+        }
+      }
+      return registrations;
+    } catch (error) {
+      warnings.push({ code: "unsupported-config", message: `Docusaurus MDX registry was not imported: ${error instanceof Error ? error.message : "unreadable file"}.`, source: `src/theme/${filename}` });
+    }
   }
-  return candidate;
+  return registrations;
+}
+function injectDocusaurusGlobalImports(raw, imports2) {
+  if (imports2.size === 0) return raw;
+  const parsed = parseFrontmatter(raw);
+  const declared = pageScopeNames([parsed.content]);
+  const used = /* @__PURE__ */ new Set();
+  replaceOutsideCodeAndComments(parsed.content, (segment) => {
+    for (const match of segment.matchAll(/<([A-Z][\w$]*)(?=[\s/>])/g)) {
+      if (imports2.has(match[1]) && !declared.has(match[1])) used.add(match[1]);
+    }
+    return segment;
+  });
+  const prefix = raw.slice(0, raw.length - parsed.content.length);
+  return used.size === 0 ? raw : `${prefix}${[...used].map((name) => imports2.get(name)).join("\n")}
+
+${parsed.content}`;
 }
 function globalSnippetAliases(files, repositoryRoot, siteRoot) {
   const aliases = /* @__PURE__ */ new Map();
@@ -10464,8 +11081,8 @@ function snippetExportIndex(files) {
       continue;
     }
     if (extension !== ".mdx") {
-      const parsed = ts4.createSourceFile("snippet.tsx", source, ts4.ScriptTarget.Latest, true, ts4.ScriptKind.TSX);
-      const hasDefault = parsed.statements.some((statement) => ts4.isExportAssignment(statement) && !statement.isExportEquals || ts4.getModifiers(statement)?.some((modifier) => modifier.kind === ts4.SyntaxKind.DefaultKeyword));
+      const parsed = ts5.createSourceFile("snippet.tsx", source, ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
+      const hasDefault = parsed.statements.some((statement) => ts5.isExportAssignment(statement) && !statement.isExportEquals || ts5.getModifiers(statement)?.some((modifier) => modifier.kind === ts5.SyntaxKind.DefaultKeyword));
       if (hasDefault) add(basename3(file.relativePath).replace(/\.[^.]+$/, ""), file.absolutePath);
     }
   }
@@ -10524,8 +11141,8 @@ function repositoryAssetHref(value, currentFile, siteRoot, onReferenced, onRootF
         usedRootFallback = true;
       }
     }
-    const realRoot = realpathSync3(siteRoot);
-    const realCandidate = realpathSync3(candidate);
+    const realRoot = realpathSync4(siteRoot);
+    const realCandidate = realpathSync4(candidate);
     const realRelative = relative6(realRoot, realCandidate);
     if (realRelative === ".." || realRelative.startsWith(`..${sep3}`) || isAbsolute3(realRelative)) return null;
     const siteRelative = relative6(siteRoot, candidate).replace(/\\/g, "/");
@@ -10533,7 +11150,7 @@ function repositoryAssetHref(value, currentFile, siteRoot, onReferenced, onRootF
     if (!existsSync5(candidate) || !lstatSync6(candidate).isFile()) return null;
     const normalized = normalizeAssetPath(siteRelative);
     if (!normalized) return null;
-    const onDiskRelative = relative6(realRoot, realpathSync3.native(candidate)).replace(/\\/g, "/");
+    const onDiskRelative = relative6(realRoot, realpathSync4.native(candidate)).replace(/\\/g, "/");
     const onDisk = onDiskRelative.toLowerCase() === siteRelative.toLowerCase() ? normalizeAssetPath(onDiskRelative) : null;
     onReferenced?.(normalized, onDisk ?? void 0);
     if (usedRootFallback) onRootFallback?.(decodedPath, normalized);
@@ -10594,7 +11211,13 @@ function locallyDeclaredNames(raw) {
   }
   return names;
 }
-function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0, siteRoot = repositoryRoot, globalAliases = /* @__PURE__ */ new Map(), gate) {
+function exportBlock(declarations2, statement, sourcePath) {
+  const code = declarations2.join("\n");
+  return code && statement.slice(statement.lastIndexOf(sourcePath)).includes("\n") ? `${code}
+
+` : code;
+}
+function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0, siteRoot = repositoryRoot, globalAliases = /* @__PURE__ */ new Map(), gate, platform) {
   if (depth >= 8) return raw;
   raw = normalizeIndentedFences(raw);
   const snippets = /* @__PURE__ */ new Map();
@@ -10608,6 +11231,10 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
       warnings.push({ code: "gated-page", message: `${label} is access-restricted and was NOT inlined; it was left as a comment.`, source });
       return `{/* Access-restricted content withheld: ${shown} */}`;
     }
+    if (verdict.kind === "draft") {
+      warnings.push({ code: "gated-page", message: `${label} is a draft page that Docusaurus does not publish, so it was not inlined; it was left as a comment.`, source });
+      return `{/* Draft content not inlined: ${shown} */}`;
+    }
     if (verdict.kind === "snippet-gated") {
       warnings.push({
         code: "gated-page",
@@ -10623,6 +11250,59 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
     });
     return `{/* ${verdict.kind === "oversized" ? "Oversized" : "Unreadable"} content not inlined: ${shown} */}`;
   };
+  if (platform === "fern") raw = replaceOutsideCodeAndComments(raw, (segment) => {
+    const marker = /<Code(?![\w$.-])/g;
+    let output = "";
+    let cursor = 0;
+    for (let match = marker.exec(segment); match; match = marker.exec(segment)) {
+      const opening = scanJsxOpeningTag(segment, match.index, "Code");
+      marker.lastIndex = opening.next;
+      if (opening.end === null) continue;
+      if (segment[opening.end - 1] !== "/") continue;
+      const properties = staticSnippetProperties(opening.attributes);
+      const attribute = (name) => properties.get(name);
+      const filePath = attribute("src");
+      if (!filePath) continue;
+      const end = opening.end + 1;
+      let replacement;
+      try {
+        const candidate = resolveSnippetPath(filePath, currentFile, repositoryRoot, siteRoot);
+        if (!existsSync5(candidate) || !lstatSync6(candidate).isFile()) throw new Error("file not found");
+        if (lstatSync6(candidate).size > MAX_PAGE_BYTES) throw new Error("file exceeds the 2 MB inline limit");
+        const blocked = blockInline(candidate, filePath, `Code source ${filePath}`);
+        if (blocked) replacement = blocked;
+        else {
+          let code = readFileSync6(candidate, "utf8").replace(/\r\n/g, "\n");
+          const lines = attribute("lines");
+          if (lines !== void 0) {
+            const range = /^(\d+)(?:-(\d+))?$/.exec(lines);
+            const first = Number(range?.[1]);
+            const last = Number(range?.[2] ?? range?.[1]);
+            if (!Number.isSafeInteger(first) || !Number.isSafeInteger(last) || first < 1 || last < first) throw new Error("invalid line range");
+            code = code.split("\n").slice(first - 1, last).join("\n");
+          }
+          const language = attribute("language") ?? "text";
+          if (!/^[\w+-]+$/.test(language)) throw new Error("invalid language");
+          const title = attribute("title")?.replace(/[\r\n`]/g, " ");
+          let fenceLength = 3;
+          for (const run of code.matchAll(/`+/g)) fenceLength = Math.max(fenceLength, run[0].length + 1);
+          const fence = "`".repeat(fenceLength);
+          const before = segment.slice(segment.lastIndexOf("\n", match.index - 1) + 1, match.index);
+          const indent = /^[ \t]*$/.test(before) ? before : "";
+          replacement = isolateFences(`${fence}${language}${title ? ` ${title}` : ""}
+${code.replace(/\n$/, "")}
+${fence}`.split("\n").join(`
+${indent}`), segment, match.index, end);
+        }
+      } catch (error) {
+        warnings.push({ code: "skipped-file", message: `Code source ${filePath} was not inlined: ${error instanceof Error ? error.message : "unreadable file"}.`, source });
+        replacement = mdxComment(` Code source not inlined: ${filePath} `);
+      }
+      output += segment.slice(cursor, match.index) + replacement;
+      cursor = end;
+    }
+    return output + segment.slice(cursor);
+  });
   let withoutImports = replaceOutsideCodeAndMdxComments(raw, (source2) => source2.replace(
     SNIPPET_IMPORT_PATTERN,
     (_statement, namedComponent, defaultComponent, sourcePath) => {
@@ -10644,7 +11324,8 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
           depth + 1,
           siteRoot,
           globalAliases,
-          gate
+          gate,
+          platform
         );
         const declaration = statefulSnippetDeclaration(nested, componentName);
         if (declaration) preservedDeclarations.set(componentName, declaration);
@@ -10692,7 +11373,7 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
             if (/^[A-Z]/.test(binding.exported)) snippets.set(binding.local, blocked);
             else declarations3.push(`export const ${binding.local} = undefined;`);
           }
-          return declarations3.join("\n");
+          return exportBlock(declarations3, statement, sourcePath);
         }
         const snippetSource = readFileSync6(candidate, "utf8");
         const values = staticNamedSnippetValues(snippetSource);
@@ -10707,6 +11388,11 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
           }
           exportedNames ??= snippetExportedNames(snippetSource);
           const exported = exportedNames.has(binding.exported);
+          const generated = exported || platform !== "docusaurus" ? void 0 : DOCUSAURUS_GENERATED_EXPORTS[binding.exported];
+          if (generated) {
+            declarations2.push(`export const ${binding.local} = ${generated};`);
+            continue;
+          }
           if (!exported && !(/^[A-Z]/.test(binding.exported) && snippetComponentBody(snippetSource, binding.exported) !== snippetSource)) {
             warnings.push({
               code: "unsupported-config",
@@ -10730,7 +11416,7 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
           components.push([binding.local, body]);
         }
         for (const [name, body] of components) snippets.set(name, body);
-        return declarations2.join("\n");
+        return exportBlock(declarations2, statement, sourcePath);
       } catch (error) {
         if (error instanceof Error && error.message.includes("escapes its root")) {
           warnings.push({
@@ -10764,7 +11450,8 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
       depth + 1,
       siteRoot,
       globalAliases,
-      gate
+      gate,
+      platform
     );
     const declaration = statefulSnippetDeclaration(nested, componentName);
     if (declaration) preservedDeclarations.set(componentName, declaration);
@@ -10778,13 +11465,17 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
         return isolateFences(closeOpenCodeFence(interpolateSnippet(snippet, attributes, children)), source2, offset, offset + tag.length);
       });
     }
-    return segment.replace(SNIPPET_TAG_PATTERN, (tag, doubleQuoted, singleQuoted, offset, source2) => {
+    const tagLabel = (filePath) => platform === "fern" ? `Included file ${filePath}` : `Snippet file="${filePath}"`;
+    return segment.replace(platform === "fern" ? FERN_MARKDOWN_TAG_PATTERN : SNIPPET_TAG_PATTERN, (tag, doubleQuoted, singleQuoted, offset, source2) => {
       const filePath = doubleQuoted ?? singleQuoted;
       try {
-        const candidate = [
+        const candidate = (platform === "fern" ? [
+          // Fern's absolute include paths are rooted at fern/, never snippets/.
+          () => resolveSnippetPath(filePath, currentFile, repositoryRoot, siteRoot)
+        ] : [
           () => withinRealRoot(resolveWithin(siteRoot, `snippets/${filePath}`), repositoryRoot),
           () => resolveSnippetPath(filePath, currentFile, repositoryRoot, siteRoot)
-        ].map((resolveCandidate) => {
+        ]).map((resolveCandidate) => {
           try {
             return resolveCandidate();
           } catch {
@@ -10792,7 +11483,7 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
           }
         }).find((path) => path !== void 0 && existsSync5(path) && lstatSync6(path).isFile());
         if (!candidate) throw new Error("file not found");
-        const blocked = blockInline(candidate, filePath, `Snippet file="${filePath}"`);
+        const blocked = blockInline(candidate, filePath, tagLabel(filePath));
         if (blocked) return blocked;
         return isolateFences(closeOpenCodeFence(inlineMdxSnippets(
           withoutFrontmatter(readFileSync6(candidate, "utf8")),
@@ -10802,12 +11493,13 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
           depth + 1,
           siteRoot,
           globalAliases,
-          gate
+          gate,
+          platform
         )), source2, offset, offset + tag.length);
       } catch {
         warnings.push({
           code: "missing-page",
-          message: `Snippet file="${filePath}" could not be resolved and was left as a comment.`,
+          message: platform === "fern" ? `${tagLabel(filePath)} could not be found, so it was left out of the page.` : `${tagLabel(filePath)} could not be resolved and was left as a comment.`,
           source: relative6(repositoryRoot, currentFile).replace(/\\/g, "/")
         });
         return mdxComment(` Missing snippet: ${filePath} `);
@@ -10890,6 +11582,7 @@ function migrateRepository(options) {
   })();
   const componentRoot = mintlifyProjectRoot ?? docusaurusProjectRoot ?? fernProjectRoot ?? repositoryDir;
   const componentMigrator = platform === "mintlify" || platform === "docusaurus" || platform === "fern" ? createComponentMigrator(componentRoot, repositoryDir, warnings, componentSourceIdentity(options.sourceUrl, repositoryDir, componentRoot, options.componentNamespace)) : void 0;
+  const globalDocusaurusImports = platform === "docusaurus" ? docusaurusGlobalImports(componentRoot, repositoryDir, warnings) : /* @__PURE__ */ new Map();
   let docsConfig = { tabs: [] };
   let defaultVersionPrefixes = /* @__PURE__ */ new Set();
   let allVersionPrefixes = /* @__PURE__ */ new Set();
@@ -10903,12 +11596,15 @@ function migrateRepository(options) {
   let fernBasePath = "";
   let fernVersionPath = "";
   let fernApiSections = [];
+  let fernRestrictedApiSections = [];
+  let fernNavigationIncomplete = false;
   const fernExternalSourcePaths = /* @__PURE__ */ new Set();
   let fernChangelogIndexes = [];
   const fernReferencedPaths = /* @__PURE__ */ new Set();
   const fernSourceLinkAliases = /* @__PURE__ */ new Map();
   const fernNavTitles = /* @__PURE__ */ new Map();
   const fernHiddenIds = /* @__PURE__ */ new Set();
+  const fernRestrictedPaths = /* @__PURE__ */ new Set();
   const activeSourceRefs = [];
   const usedSourceRefs = /* @__PURE__ */ new Set();
   const gatedSourceRepos = /* @__PURE__ */ new Set();
@@ -10971,6 +11667,8 @@ function migrateRepository(options) {
         docsConfig = projected.docsConfig;
         warnings.push(...projected.warnings);
         fernApiSections = projected.apiSections;
+        fernRestrictedApiSections = projected.restrictedApiSections;
+        fernNavigationIncomplete = projected.navigationIncomplete;
         fernChangelogIndexes = projected.changelogIndexes;
         for (const [index, descriptor] of projected.descriptors.entries()) {
           fernReferencedPaths.add(descriptor.sourcePath);
@@ -10978,6 +11676,7 @@ function migrateRepository(options) {
             fernNavTitles.set(descriptor.navigationId, descriptor.navTitle);
           }
           if (descriptor.hidden) fernHiddenIds.add(descriptor.navigationId);
+          if (descriptor.restricted) fernRestrictedPaths.add(canonicalPath(resolvePath(fernProjectRoot, descriptor.sourcePath)));
           const sourceTail = descriptor.sourcePath.match(/(?:^|\/)pages\/(.+)\.mdx?$/i)?.[1]?.replace(/\/index$/i, "");
           if (sourceTail) {
             const routeSegments = descriptor.navigationId.split("/");
@@ -11002,13 +11701,17 @@ function migrateRepository(options) {
       });
     }
   }
+  if (fernNavigationIncomplete) {
+    throw new Error(`Fern navigation could not be fully classified, so no pages, assets or API specs were migrated. Fix cyclic references or reduce the navigation's nesting or node count before retrying.
+${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
+  }
   if (platform === "docusaurus") {
     try {
       docusaurusSidebars = options.docusaurusSkipSidebar || !docusaurusProjectRoot ? null : readDocusaurusSidebars(docusaurusProjectRoot, options.docusaurusSidebarPath);
     } catch (error) {
       warnings.push({
         code: "unsupported-config",
-        message: `Docusaurus sidebar could not be read safely: ${error instanceof Error ? error.message : String(error)} Generated navigation will be used.`
+        message: isPathEscapeError(error) ? "Skipped the sidebar file because it points outside the repository (symlink or ..). Navigation was generated from the docs folder instead." : `Docusaurus sidebar could not be read safely: ${error instanceof Error ? error.message : String(error)} Generated navigation will be used.`
       });
     }
   }
@@ -11040,7 +11743,7 @@ function migrateRepository(options) {
     for (const sourcePath of fernExternalSourcePaths) {
       if (discovered2.has(sourcePath)) continue;
       try {
-        const absolutePath = resolveWithinRoot(fernProjectRoot, sourcePath, repositoryDir);
+        const absolutePath = withinRealRoot(resolveWithinRoot(fernProjectRoot, sourcePath, repositoryDir), repositoryDir);
         if (existsSync5(absolutePath) && lstatSync6(absolutePath).isFile()) {
           files.push({ absolutePath, relativePath: sourcePath });
           discovered2.add(sourcePath);
@@ -11088,10 +11791,11 @@ function migrateRepository(options) {
       const size = lstatSync6(file.absolutePath).size;
       const raw = readFrontmatterHead(file.absolutePath) ?? (size > MAX_PAGE_BYTES ? void 0 : readFileSync6(file.absolutePath, "utf8"));
       if (raw === void 0) throw new Error("frontmatter is not terminated within the bounded read");
-      head = pageHeadAccess(raw);
+      head = platform === "mintlify" ? pageHeadAccess(raw) : pageHeadGateReason(raw, platform);
     } catch {
-      head = { access: { problem: "frontmatter could not be read" } };
+      head = platform === "mintlify" ? { access: { problem: "frontmatter could not be read" } } : { reason: "frontmatter could not be read" };
     }
+    if (!("access" in head)) return head.reason ? { reason: head.reason, quarantineReason: head.reason, openapi: head.openapi } : { openapi: head.openapi };
     const verdict = resolvePageAccess(head.access, navigationAccessFor(file.relativePath));
     if (verdict.problem) return { reason: verdict.problem, quarantineReason: verdict.problem, openapi: head.openapi };
     const access = verdict.access ?? {};
@@ -11144,9 +11848,38 @@ function migrateRepository(options) {
       withheldDocFiles.push(file);
     }
   }
-  const pagesNotClassified = droppedPageCount > 0 || platform === "mintlify" && scanTruncated;
+  const fernBodyReason = (file) => {
+    if (platform !== "fern") return void 0;
+    try {
+      return lstatSync6(file.absolutePath).size > MAX_PAGE_BYTES ? void 0 : fernIfRolesReason(readFileSync6(file.absolutePath, "utf8"));
+    } catch {
+      return "it could not be read to check for role-restricted content";
+    }
+  };
+  const gateReasonCache = /* @__PURE__ */ new Map();
+  const nonMintlifyGateReason = (file) => {
+    if (!isDocFile(file)) return void 0;
+    const key = canonicalPath(file.absolutePath);
+    let reason = gateReasonCache.get(key);
+    if (reason === void 0) {
+      reason = platform === "docusaurus" && file.relativePath.split("/").some((segment) => segment.startsWith("_")) ? null : (fernRestrictedPaths.has(key) ? "docs.yml `viewers` restricts it to signed-in roles" : classifyPageGate(file).reason ?? fernBodyReason(file)) ?? null;
+      gateReasonCache.set(key, reason);
+    }
+    return reason ?? void 0;
+  };
+  if (platform === "docusaurus" || platform === "fern") {
+    for (const file of /* @__PURE__ */ new Set([...scannedFiles, ...files])) {
+      const reason = nonMintlifyGateReason(file);
+      if (!reason) continue;
+      gateByPath.set(file.absolutePath, { reason, quarantineReason: reason });
+      withheldPaths.add(file.absolutePath);
+    }
+  }
+  const pagesNotClassified = droppedPageCount > 0 || scanTruncated || files.some((file) => isDocFile(file) && lstatSync6(file.absolutePath).size > MAX_PAGE_BYTES);
   const hasWithheldContent = withheldPaths.size > 0 || withheldDocFiles.length > 0;
-  const trackPublishedRefs = platform === "mintlify" && (hasWithheldContent || pagesNotClassified);
+  const trackPublishedRefs = hasWithheldContent || pagesNotClassified;
+  const docusaurusDocsPrefix = platform === "docusaurus" ? relative6(docusaurusProjectRoot ?? repositoryDir, contentRoot).replace(/\\/g, "/") : "";
+  const docusaurusPaths = (siteBase) => platform === "docusaurus" ? { siteBase: posix4.normalize(siteBase).replace(/^\.$/, ""), docsPrefix: docusaurusDocsPrefix } : void 0;
   const withheldCanonical = new Set([...withheldPaths].map(canonicalPath));
   const verdictCache = /* @__PURE__ */ new Map();
   const classifyInlineCandidate = (candidate, key) => {
@@ -11177,7 +11910,11 @@ function migrateRepository(options) {
       verdictCache.set(key, verdict);
     }
     return verdict ?? void 0;
-  } : void 0;
+  } : (candidate) => {
+    const reason = nonMintlifyGateReason({ absolutePath: candidate, relativePath: relative6(contentRoot, candidate).replace(/\\/g, "/") });
+    if (reason) return { kind: reason === DOCUSAURUS_DRAFT_REASON ? "draft" : "gated", reason };
+    return lstatSync6(candidate).size > MAX_PAGE_BYTES ? { kind: "oversized", reason: "over 2 MB" } : void 0;
+  };
   const fernIdRenames = /* @__PURE__ */ new Map();
   let skipped = 0;
   let discovered = files.length;
@@ -11239,7 +11976,7 @@ function migrateRepository(options) {
       continue;
     }
     const sourceSegments = file.relativePath.split("/");
-    if (sourceSegments.some((segment) => SNIPPET_DIRECTORIES.has(segment.toLowerCase())) || platform === "docusaurus" && basename3(file.relativePath).startsWith("_")) {
+    if (sourceSegments.some((segment) => SNIPPET_DIRECTORIES.has(segment.toLowerCase())) || platform === "docusaurus" && sourceSegments.some((segment) => segment.startsWith("_"))) {
       skipped++;
       continue;
     }
@@ -11280,7 +12017,7 @@ function migrateRepository(options) {
     }
     const key = normalizedReferenceKey(file.relativePath);
     let pageGate;
-    if (platform === "mintlify") {
+    {
       pageGate = gateByPath.get(file.absolutePath);
       if (pageGate?.access?.isPublic === true) sawPublicTrue = true;
       const gateReason = pageGate?.quarantineReason;
@@ -11310,7 +12047,7 @@ function migrateRepository(options) {
         }
         warnings.push({
           code: "gated-page",
-          message: `Access-restricted on the source site, but its access rules could not be migrated safely (${gateReason}), so it was NOT published. Fix the rules in the original, saved at ${QUARANTINE_DIRECTORY}/${file.relativePath}, and move it into src/content/; until then links from other pages to it will break.`,
+          message: gateReason === DOCUSAURUS_DRAFT_REASON ? `This is a draft page that Docusaurus does not publish, so it was NOT published. The original is saved at ${QUARANTINE_DIRECTORY}/${file.relativePath}; links from other pages to it will break.` : platform === "mintlify" ? `Access-restricted on the source site, but its access rules could not be migrated safely (${gateReason}), so it was NOT published. Fix the rules in the original, saved at ${QUARANTINE_DIRECTORY}/${file.relativePath}, and move it into src/content/; until then links from other pages to it will break.` : `Access-restricted on the source site (${gateReason}), so it was NOT published. The original is saved at ${QUARANTINE_DIRECTORY}/${file.relativePath}; links from other pages to it will break.`,
           source: file.relativePath
         });
         continue;
@@ -11348,14 +12085,15 @@ function migrateRepository(options) {
     const isDefaultLocale = !locale || locale === localeConfig?.defaultLocale;
     const id = isDefaultLocale ? navigationId : `${locale}/${navigationId}`;
     let raw = inlineMdxSnippets(
-      mintlifyProjectRoot ? importUndeclaredSnippetComponents(readFileSync6(file.absolutePath, "utf8"), file.absolutePath, repositoryDir, mintlifyProjectRoot, snippetExports, snippetAliases, inlineGate, warnings) : readFileSync6(file.absolutePath, "utf8"),
+      mintlifyProjectRoot ? importUndeclaredSnippetComponents(readFileSync6(file.absolutePath, "utf8"), file.absolutePath, repositoryDir, mintlifyProjectRoot, snippetExports, snippetAliases, inlineGate, warnings) : injectDocusaurusGlobalImports(readFileSync6(file.absolutePath, "utf8"), globalDocusaurusImports),
       file.absolutePath,
       repositoryDir,
       warnings,
       0,
       mintlifyProjectRoot ?? docusaurusProjectRoot ?? fernProjectRoot ?? repositoryDir,
       snippetAliases,
-      inlineGate
+      inlineGate,
+      platform
     );
     const publishedText = trackPublishedRefs && !isRestrictedPage ? raw : void 0;
     const pageAssetReferences = [];
@@ -11476,6 +12214,7 @@ function migrateRepository(options) {
         });
       });
     }
+    if (platform === "docusaurus") resolvePageDisplayHeading(page, platform);
     let mdxError = invalidMdxReason(page.body);
     if (mdxError) {
       const repaired = escapeUnmatchedClosingTags(page.body);
@@ -11543,7 +12282,7 @@ function migrateRepository(options) {
     pages.push(page);
     if (isRestrictedPage) restrictedPages.add(page);
     for (const assetPath of pageAssetReferences) addAssetReference(assetPath, file.relativePath);
-    if (publishedText !== void 0) addPathReferences(publishedText, posix4.dirname(file.relativePath).replace(/^\.$/, ""), publishedExact, publishedLoose);
+    if (publishedText !== void 0) addPathReferences(publishedText, posix4.dirname(file.relativePath).replace(/^\.$/, ""), publishedExact, publishedLoose, docusaurusPaths(posix4.join(docusaurusDocsPrefix, posix4.dirname(file.relativePath))));
     if (hasDocusaurusDocCardList) {
       docusaurusDocCardRoutes.add(page.navigationId);
     }
@@ -11561,6 +12300,7 @@ function migrateRepository(options) {
       }
     }
     if (docusaurusDescriptor) {
+      if (docusaurusDescriptor.unlisted) page.hidden = true;
       docusaurusDescriptors.push({ ...docusaurusDescriptor, title: page.title });
     }
   }
@@ -11579,8 +12319,8 @@ function migrateRepository(options) {
       try {
         const absolutePath = source ? resolveWithinRoot(fernProjectRoot, source.replace(/^\/+/, ""), repositoryDir) : resolveWithin(repositoryDir, candidate);
         if (!existsSync5(absolutePath) || !lstatSync6(absolutePath).isFile()) return;
-        const realRoot = realpathSync3(repositoryDir);
-        const realPath = realpathSync3(absolutePath);
+        const realRoot = realpathSync4(repositoryDir);
+        const realPath = realpathSync4(absolutePath);
         const confined = relative6(realRoot, realPath);
         if (confined === ".." || confined.startsWith(`..${sep3}`) || isAbsolute3(confined)) return;
         const withinFern = relative6(fernProjectRoot, absolutePath);
@@ -11617,6 +12357,7 @@ function migrateRepository(options) {
     }));
   }) : [];
   const assetCandidates = [];
+  const seenAssetSources = /* @__PURE__ */ new Map();
   const mintlifyFonts = platform === "mintlify" ? mintlifyFontSources(mintlifyConfig) : [];
   const fontRelativePaths = new Set(mintlifyFonts.flatMap((font) => font.path ? [font.path] : []));
   const importedComponentSources = new Set((componentMigrator?.files() ?? []).flatMap((file) => {
@@ -11663,6 +12404,11 @@ function migrateRepository(options) {
     const isDocusaurusStatic = platform === "docusaurus" && firstSegment === "static";
     const assetPath = normalizeAssetPath(firstSegment === "public" ? file.relativePath.slice("public/".length) : isDocusaurusStatic ? file.relativePath.slice("static/".length) : file.relativePath);
     if (!assetPath) continue;
+    const sourceKey = canonicalPath(file.absolutePath);
+    const destinations = seenAssetSources.get(sourceKey) ?? /* @__PURE__ */ new Set();
+    if (destinations.has(assetPath)) continue;
+    destinations.add(assetPath);
+    seenAssetSources.set(sourceKey, destinations);
     if (siteKind) {
       siteAssetPaths.set(assetPath, siteKind);
       if (siteKind === "font") fontAssetByRelative.set(file.relativePath, assetPath);
@@ -11682,8 +12428,9 @@ function migrateRepository(options) {
   const destinationCounts = /* @__PURE__ */ new Map();
   for (const { assetPath } of assetCandidates) destinationCounts.set(assetPath, (destinationCounts.get(assetPath) ?? 0) + 1);
   if (trackPublishedRefs) {
-    const publishedConfig = JSON.stringify(mintlifyConfig ?? {}, (_key, value) => value && typeof value === "object" && !Array.isArray(value) && navigationGateReason(value) ? void 0 : value);
-    addPathReferences(publishedConfig, "", publishedExact, publishedLoose);
+    const publishedConfig = platform === "mintlify" ? JSON.stringify(mintlifyConfig ?? {}, (_key, value) => value && typeof value === "object" && !Array.isArray(value) && navigationGateReason(value) ? void 0 : value) : JSON.stringify([docsConfig, docusaurusProjectRoot ? readDocusaurusSiteSettings(docusaurusProjectRoot) : null]);
+    addPathReferences(publishedConfig, "", publishedExact, publishedLoose, docusaurusPaths(""));
+    if (fernRawConfig) addFernConfigPathReferences(fernRawConfig, publishedExact, publishedLoose);
   }
   for (const file of componentMigrator?.files() ?? []) {
     if (!trackPublishedRefs || typeof file.content !== "string") continue;
@@ -11692,7 +12439,7 @@ function migrateRepository(options) {
   }
   const failClosedAssets = trackPublishedRefs;
   const isPublicReachable = (assetPath) => referencedAssetPaths.has(assetPath) || publishedExact.has(assetPath);
-  const isQuarantinedAsset = (assetPath) => (withheldAssetPaths.has(assetPath) || failClosedAssets && !siteAssetPaths.has(assetPath)) && platform === "mintlify" && !(isPublicReachable(assetPath) && !(failClosedAssets && (destinationCounts.get(assetPath) ?? 0) > 1));
+  const isQuarantinedAsset = (assetPath) => (withheldAssetPaths.has(assetPath) || failClosedAssets && !siteAssetPaths.has(assetPath)) && !(isPublicReachable(assetPath) && !(failClosedAssets && (destinationCounts.get(assetPath) ?? 0) > 1));
   let withheldAssetCount = 0;
   let unreferencedAssetCount = 0;
   let totalAssetBytes = 0;
@@ -11913,7 +12660,7 @@ function migrateRepository(options) {
   }
   if (docsConfig.tabs.length === 0) docsConfig = buildNavigationFromPages(pages);
   if (platform === "fern" && fernProjectRoot) {
-    const sections = fernApiSections.length > 0 ? fernApiSections : [{ nameExplicit: false }];
+    const sections = fernApiSections.length > 0 ? fernApiSections : fernRestrictedApiSections.length > 0 ? [] : [{ nameExplicit: false }];
     const resolvedSpecs = [];
     const specFilenameSources = /* @__PURE__ */ new Map();
     for (const section of sections) {
@@ -11927,7 +12674,8 @@ function migrateRepository(options) {
           filename = `${prefix}${filename}`;
         }
         specFilenameSources.set(filename, spec.absolutePath);
-        const specContent = readFileSync6(spec.absolutePath);
+        const specContent = readSpecFile(spec.absolutePath, spec.relativePath, warnings);
+        if (!specContent) continue;
         if (!assets.some((asset) => asset.path === specAssetPath(filename))) {
           assets.push(specAsset(filename, specContent));
         }
@@ -11959,6 +12707,19 @@ function migrateRepository(options) {
         message: checked.length ? `No OpenAPI/AsyncAPI spec could be found for the "${section.name}" API. Checked: ${checked.join(", ")}. Point generators.yml at a spec file that exists.` : `No OpenAPI/AsyncAPI spec could be found for the "${section.name}" API, because its api-name is not a valid folder name. Add the spec manually.`
       });
     }
+    const publicSpecFiles = new Set(specFilenameSources.values());
+    for (const section of fernRestrictedApiSections) {
+      const spec = findFernConfiguredOpenApi(fernProjectRoot, repositoryDir, section.name, section.nameExplicit, warnings).spec ?? (!section.nameExplicit ? findOpenApi(files) : null);
+      if (!spec || publicSpecFiles.has(spec.absolutePath)) continue;
+      const content = readSpecFile(spec.absolutePath, spec.relativePath, warnings);
+      if (!content) continue;
+      quarantinedFiles.push({ path: `${QUARANTINE_DIRECTORY}/assets/${specAssetPath(basename3(spec.relativePath))}`, content });
+      warnings.push({
+        code: "gated-page",
+        message: `The "${section.name ?? "API"}" API reference is limited to signed-in roles in Fern, so it was NOT published. Its spec was saved at ${QUARANTINE_DIRECTORY}/assets/${specAssetPath(basename3(spec.relativePath))}.`,
+        source: spec.relativePath
+      });
+    }
     if (resolvedSpecs.length > 0) {
       docsConfig = injectOpenApiSpecs(docsConfig, resolvedSpecs, warnings);
       const { operationLinks, prefixLandings } = apiOperationLinkMap(
@@ -12030,14 +12791,15 @@ function migrateRepository(options) {
       if (endpointRedirects.length > 0) docsConfig = { ...docsConfig, redirects: [...docsConfig.redirects ?? [], ...endpointRedirects] };
     } else {
       const fallback = findOpenApi(files);
-      if (fallback) {
+      const fallbackContent = fallback ? readSpecFile(fallback.absolutePath, fallback.relativePath, warnings) : void 0;
+      if (fallback && fallbackContent) {
         const filename = basename3(fallback.relativePath);
         const matches = (ref) => specRefMatches(ref, fallback.relativePath, filename, true);
         if (withheldSpecRefs.some(matches) && !publishedSpecRefs.some(matches)) {
-          quarantinedFiles.push({ path: `${QUARANTINE_DIRECTORY}/assets/${specAssetPath(filename)}`, content: readFileSync6(fallback.absolutePath) });
+          quarantinedFiles.push({ path: `${QUARANTINE_DIRECTORY}/assets/${specAssetPath(filename)}`, content: fallbackContent });
           withheldAssetCount++;
         } else {
-          const pruned = excludeWithheldOperations({ sourcePath: fallback.relativePath, filename, content: readFileSync6(fallback.absolutePath) }, withheldSpecRefs, keptSpecRefs);
+          const pruned = excludeWithheldOperations({ sourcePath: fallback.relativePath, filename, content: fallbackContent }, withheldSpecRefs, keptSpecRefs);
           if (!assets.some((asset) => asset.path === specAssetPath(filename))) {
             assets.push(specAsset(filename, pruned.content));
           }
@@ -12312,7 +13074,14 @@ ${reasons.map((reason) => `- ${reason}`).join("\n")}` : "No importable Markdown
   }
   const isTopLevelDocusaurus = platform === "docusaurus" && docusaurusProjectRoot && !options.docusaurusSkipRedirects;
   const docusaurusSettings = isTopLevelDocusaurus ? readDocusaurusSiteSettings(docusaurusProjectRoot) : void 0;
+  const presentation = docusaurusSettings ? readDocusaurusPresentation(docusaurusProjectRoot) : void 0;
   if (docusaurusSettings) {
+    if (presentation) {
+      assets.push({ path: "_thally/source-theme.css", content: Buffer.from(presentation.css) });
+      docsConfig = { ...docsConfig, stylesheets: [...docsConfig.stylesheets ?? [], "/_thally/source-theme.css"], ...presentation.headingFont ? { fonts: { ...docsConfig.fonts, heading: { family: presentation.headingFont, weight: ["400", "500", "600", "700"] } } } : {} };
+      if (presentation.unresolved) warnings.push({ code: "unsupported-config", message: "Docusaurus Sass/Tailwind theme values could not be resolved statically; provide compiled build/assets/css/styles.*.css to retain those colors." });
+    }
+    if (docusaurusSettings.banner) docsConfig = { ...docsConfig, banner: docusaurusSettings.banner };
     const importedRoutes = new Set(pages.map((page) => page.navigationId));
     const sourceOrigin = readDocusaurusSiteOrigin(docusaurusProjectRoot);
     const externalized = /* @__PURE__ */ new Set();
@@ -12383,7 +13152,7 @@ ${reasons.map((reason) => `- ${reason}`).join("\n")}` : "No importable Markdown
   if (!docsConfig.navigation?.display && docsConfig.tabs.filter((tab) => !tab.hidden).length > 6) {
     docsConfig = { ...docsConfig, navigation: { display: "dropdown" } };
   }
-  const themeColors = mintlifyConfig ? mintlifyThemeColors(mintlifyConfig.colors) : fernRawConfig ? fernThemeColors(fernRawConfig.colors) : isTopLevelDocusaurus ? readDocusaurusThemeColor(docusaurusProjectRoot) : void 0;
+  const themeColors = mintlifyConfig ? mintlifyThemeColors(mintlifyConfig.colors) : fernRawConfig ? fernThemeColors(fernRawConfig.colors) ?? (fernRawConfig["global-theme"] === "nvidia" ? { primary: "#76B900" } : void 0) : isTopLevelDocusaurus ? presentation?.colors ?? readDocusaurusThemeColor(docusaurusProjectRoot) : void 0;
   const assetPaths = new Set(assets.map((asset) => asset.path));
   const publicBrandPath = (value) => {
     if (typeof value !== "string" || /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(value)) return void 0;
@@ -12490,7 +13259,12 @@ ${reasons.map((reason) => `- ${reason}`).join("\n")}` : "No importable Markdown
       message: (sawPublicTrue ? "Some pages set `public: true`, which means the source site used Mintlify authentication and every page WITHOUT it was private. " : "") + "Access control set in the Mintlify dashboard is not visible in the repository. Check the source site's dashboard access settings before publishing: until docs.json `auth` is configured, Thally publishes every imported page that has no `groups` or `public: false` to everyone. Confirm nothing here was meant to stay private before deploying."
     });
   }
-  if (fernRawConfig?.logo && !logoLight && !logo.light) warnings.push({
+  if (typeof fernRawConfig?.["global-theme"] === "string") warnings.push({
+    code: "unsupported-config",
+    message: `Fern global theme ${JSON.stringify(fernRawConfig["global-theme"])} could not be fetched during local migration; local overrides and Thally default styling tokens were applied.`,
+    source: "global-theme"
+  });
+  if (fernRawConfig?.logo && !fernRawConfig["global-theme"] && !logoLight && !logo.light) warnings.push({
     code: "unsupported-config",
     message: "Fern supplied a logo through its global theme without a local asset; add a logo path to docs.json after import."
   });
@@ -12541,6 +13315,7 @@ function renderPage(bundle, page) {
   return [
     "---",
     `title: ${yamlString(page.title)}`,
+    page.headingTitle ? `headingTitle: ${yamlString(page.headingTitle)}` : null,
     page.navTitle ? `navTitle: ${yamlString(page.navTitle)}` : null,
     page.icon ? `icon: ${yamlString(page.icon)}` : null,
     page.iconType ? `iconType: ${yamlString(page.iconType)}` : null,
@@ -12673,7 +13448,7 @@ import { lookup } from "dns/promises";
 import { request } from "https";
 import { isIP } from "net";
 import { parse as parseYaml7 } from "yaml";
-var MAX_SPEC_BYTES = 25e6;
+var MAX_SPEC_BYTES2 = 25e6;
 var MAX_REDIRECTS = 3;
 function isPublicAddress(address, family) {
   if (family === 4) {
@@ -12724,7 +13499,7 @@ async function requestPinnedSpec(url) {
         return;
       }
       const statedBytes = Number(response.headers["content-length"] ?? 0);
-      if (statedBytes > MAX_SPEC_BYTES) {
+      if (statedBytes > MAX_SPEC_BYTES2) {
         response.destroy();
         reject(new Error("Remote OpenAPI spec exceeds the 25 MB import limit."));
         return;
@@ -12733,7 +13508,7 @@ async function requestPinnedSpec(url) {
       let bytes = 0;
       response.on("data", (chunk) => {
         bytes += chunk.length;
-        if (bytes > MAX_SPEC_BYTES) {
+        if (bytes > MAX_SPEC_BYTES2) {
           response.destroy(new Error("Remote OpenAPI spec exceeds the 25 MB import limit."));
           return;
         }
@@ -12752,7 +13527,7 @@ async function downloadSpec(value, fetcher) {
     const response = await fetcher(url, { accept: "application/json, application/yaml, text/yaml" });
     validatedSpecUrl(response.finalUrl.toString());
     const body = Buffer.from(response.body);
-    if (body.length > MAX_SPEC_BYTES) throw new Error("Remote OpenAPI spec exceeds the 25 MB import limit.");
+    if (body.length > MAX_SPEC_BYTES2) throw new Error("Remote OpenAPI spec exceeds the 25 MB import limit.");
     return body;
   }
   for (let hop = 0; hop <= MAX_REDIRECTS; hop++) {