@thallylabs/migrate 0.2.21 → 0.2.23

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/repository.ts
 import { compileSync as compileSync2 } from "@mdx-js/mdx";
+import { createHash as createHash2 } from "crypto";
 import { spawn } from "child_process";
 import {
   closeSync,
@@ -16,12 +17,12 @@ import {
 import { createRequire } from "module";
 import { basename as basename3, dirname as dirname4, extname as extname6, isAbsolute as isAbsolute2, posix as posix3, relative as relative5, resolve as resolvePath, sep as sep2 } from "path";
 import { parse as parseYaml4 } from "yaml";
-import * as ts3 from "typescript";
+import * as ts4 from "typescript";
 
 // src/components.ts
 import { createHash } from "crypto";
 import { existsSync, lstatSync, readFileSync } from "fs";
-import { basename, dirname, extname, relative as relative2, resolve as resolve2 } from "path";
+import { basename, dirname, extname as extname2, relative as relative2, resolve as resolve2 } from "path";
 import postcss from "postcss";
 import selectorParser from "postcss-selector-parser";
 import remarkMdx2 from "remark-mdx";
@@ -156,6 +157,177 @@ function isThallyBuiltinComponent(name) {
   return THALLY_BUILTIN_COMPONENTS.has(name) || THALLY_BUILTIN_COMPONENTS.has(name.split(".")[0]);
 }
 
+// src/mintlify-extras.ts
+import { extname } from "path";
+
+// src/path.ts
+import { isAbsolute, relative, resolve, sep } from "path";
+var SAFE_SEGMENT = /[^a-z0-9._-]+/gi;
+function trimTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) end--;
+  return value.slice(0, end);
+}
+function trimEdgeSlashes(value) {
+  let start = 0;
+  let end = value.length;
+  while (start < end && value.charCodeAt(start) === 47) start++;
+  while (end > start && value.charCodeAt(end - 1) === 47) end--;
+  return value.slice(start, end);
+}
+function slugifySegment(value, preserveCase = false) {
+  let decoded = value;
+  try {
+    decoded = decodeURIComponent(value);
+  } catch {
+  }
+  const normalized = preserveCase ? decoded : decoded.toLowerCase();
+  return normalized.replace(/\.(?:html?|mdx?)$/i, "").replace(SAFE_SEGMENT, "-").replace(/(^-|-$)/g, "");
+}
+function pageIdFromReference(value, preserveCase = false) {
+  const withoutQuery = value.split(/[?#]/, 1)[0].replace(/\\/g, "/").replace(/^\/+/, "");
+  if (!withoutQuery || withoutQuery.includes("\0")) return null;
+  const rawSegments = withoutQuery.split("/").filter(Boolean);
+  if (rawSegments.some((segment) => segment === ".." || segment === ".")) return null;
+  const last = rawSegments.at(-1)?.replace(/\.(?:mdx?|rst|txt)$/i, "") ?? "";
+  const isRootLevelReadme = rawSegments.length === 1 && /^readme$/i.test(last);
+  const collapsesToParent = /^index$/i.test(last) || isRootLevelReadme;
+  const baseSegments = collapsesToParent ? rawSegments.slice(0, -1) : rawSegments;
+  if (!collapsesToParent) {
+    baseSegments[baseSegments.length - 1] = last;
+  }
+  const segments = baseSegments.map((segment) => slugifySegment(segment, preserveCase)).filter(Boolean);
+  return segments.join("/") || "introduction";
+}
+function mintlifyLocalizedReference(value, locale, defaultPageIds = /* @__PURE__ */ new Set()) {
+  const reference = value.replace(/^\/+/, "");
+  const localePrefix = `${locale.toLowerCase()}/`;
+  if (reference.toLowerCase().startsWith(localePrefix)) return reference.slice(localePrefix.length);
+  const sectionPrefix = `${locale.toLowerCase()}-`;
+  if (reference.toLowerCase().startsWith(sectionPrefix)) {
+    const candidate = reference.slice(sectionPrefix.length);
+    const candidateId = pageIdFromReference(candidate, true);
+    if (candidateId && defaultPageIds.has(candidateId)) return candidate;
+  }
+  const segments = reference.split("/");
+  const localeIndex = segments.findIndex((segment) => segment.toLowerCase() === locale.toLowerCase());
+  if (localeIndex > 0) {
+    return [...segments.slice(0, localeIndex), ...segments.slice(localeIndex + 1)].join("/");
+  }
+  return value;
+}
+function resolveWithin(root, candidate) {
+  return resolveWithinRoot(root, candidate, root);
+}
+function resolveWithinRoot(baseDir, candidate, confineRoot) {
+  if (isAbsolute(candidate) || candidate.includes("\0")) {
+    throw new Error(`Unsafe migration path: ${candidate}`);
+  }
+  const target = resolve(baseDir, candidate);
+  const fromRoot = relative(resolve(confineRoot), target);
+  if (fromRoot === ".." || fromRoot.startsWith(`..${sep}`) || isAbsolute(fromRoot)) {
+    throw new Error(`Migration path escapes its root: ${candidate}`);
+  }
+  return target;
+}
+function normalizeAssetPath(value) {
+  const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "");
+  if (!normalized || normalized.includes("\0")) return null;
+  const segments = normalized.split("/").filter(Boolean);
+  if (segments.some((segment) => segment === "." || segment === "..")) return null;
+  return segments.join("/");
+}
+
+// src/mintlify-extras.ts
+function objectValue(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+var PUBLIC_FALSE_STRINGS = /* @__PURE__ */ new Set(["false", "no", "off", "0"]);
+function isPublicFalse(value) {
+  return value === false || value === 0 || typeof value === "string" && PUBLIC_FALSE_STRINGS.has(value.trim().toLowerCase());
+}
+function isPublicTrue(value) {
+  return value === true || typeof value === "string" && value.trim().toLowerCase() === "true";
+}
+function frontmatterGateReason(data) {
+  const groups = data.groups;
+  const hasGroups = Array.isArray(groups) ? groups.length > 0 : typeof groups === "string" ? groups.trim() !== "" : groups !== void 0 && groups !== null && groups !== false;
+  if (hasGroups) return "frontmatter `groups` restricts it to authenticated groups";
+  if (isPublicFalse(data.public)) return "frontmatter `public: false`";
+  return void 0;
+}
+function navigationGateReason(node) {
+  const groups = node.groups;
+  const isContainer = (entry) => typeof entry === "object" && entry !== null && !Array.isArray(entry) && ["group", "pages", "tab", "groups", "page", "root", "menu", "href"].some((key) => key in entry);
+  const restricted = typeof groups === "string" ? groups.trim() !== "" : Array.isArray(groups) && groups.length > 0 && !groups.every(isContainer);
+  if (restricted) return "its navigation container sets `groups`";
+  if (isPublicFalse(node.public)) return "its navigation container sets `public: false`";
+  return void 0;
+}
+var CONFIG_BASENAME = /(?:^|[.-])(?:config|rc)\.[cm]?js$|^(?:tailwind|postcss|next|eslint|prettier|babel|webpack|vite|vitest|jest|rollup|gulpfile|gruntfile|stylelint|commitlint|lint-staged|svgo|metro)[.-]/i;
+var BUILD_OUTPUT_SEGMENTS = /* @__PURE__ */ new Set(["dist", "build", "coverage"]);
+var FONT_EXTENSIONS = /* @__PURE__ */ new Set([".woff", ".woff2", ".ttf", ".otf"]);
+function isMintlifyServedScriptOrStyle(relativePath) {
+  const extension = extname(relativePath).toLowerCase();
+  if (extension !== ".css" && extension !== ".js") return false;
+  const segments = relativePath.split("/");
+  if (segments.slice(0, -1).some((segment) => BUILD_OUTPUT_SEGMENTS.has(segment.toLowerCase()))) return false;
+  return extension === ".css" || !CONFIG_BASENAME.test(segments[segments.length - 1]);
+}
+function mintlifyFontSources(config) {
+  const fonts = objectValue(config?.fonts);
+  if (!fonts) return [];
+  const found = [];
+  for (const entry of [fonts, objectValue(fonts.heading), objectValue(fonts.body)]) {
+    if (!entry || typeof entry.source !== "string" || !entry.source.trim()) continue;
+    const source = entry.source.trim();
+    const family = typeof entry.family === "string" ? entry.family : "a font";
+    const remote = /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(source);
+    const path = remote || /^[a-z]:[\\/]/i.test(source) ? null : normalizeAssetPath(source);
+    found.push({ family, source, path: path && FONT_EXTENSIONS.has(extname(path).toLowerCase()) ? path : null, remote });
+  }
+  return found;
+}
+function mintlifyAppearance(config, warnings) {
+  const appearance = objectValue(config.appearance);
+  const legacy = objectValue(config.modeToggle);
+  const result = {};
+  const isMode = (value) => value === "system" || value === "light" || value === "dark";
+  const skip = (field, value) => {
+    warnings.push({
+      code: "unsupported-config",
+      message: `Ignored invalid ${field} value ${JSON.stringify(value)?.slice(0, 40)}; the appearance default was left unchanged.`
+    });
+  };
+  if (appearance?.default !== void 0) {
+    if (isMode(appearance.default)) result.default = appearance.default;
+    else skip("appearance.default", appearance.default);
+  } else if (legacy?.default !== void 0) {
+    if (isMode(legacy.default)) result.default = legacy.default;
+    else skip("modeToggle.default", legacy.default);
+  }
+  if (appearance?.strict !== void 0) {
+    if (typeof appearance.strict === "boolean") {
+      if (appearance.strict) result.showToggle = false;
+    } else skip("appearance.strict", appearance.strict);
+  } else if (legacy?.isHidden !== void 0) {
+    if (typeof legacy.isHidden === "boolean") {
+      if (legacy.isHidden) result.showToggle = false;
+    } else skip("modeToggle.isHidden", legacy.isHidden);
+  }
+  return result;
+}
+function playgroundDisplay(value, where, warn) {
+  const mode = typeof value === "string" ? value.trim().toLowerCase() : "";
+  if (mode === "interactive" || mode === "simple" || mode === "none") return mode;
+  if (mode === "auth") {
+    warn?.(`${where} "auth" shows the playground only to signed-in readers, which Thally cannot tell; migrated as "simple" (no playground).`);
+    return "simple";
+  }
+  warn?.(`${where} ${JSON.stringify(value)} is not one of interactive, simple, none, auth and was dropped.`);
+  return void 0;
+}
+
 // src/mdx.ts
 function titleFromId(id) {
   const value = id.split("/").at(-1) ?? id;
@@ -264,7 +436,7 @@ function unwrapDocusaurusMdxCodeBlocks(body) {
   return isMdxCodeBlock ? body : output.join("\n");
 }
 var HTML_ID = /^[^\s"'<>`{}&]+$/u;
-function normalizeExplicitHeadingIds(raw, warn) {
+function normalizeExplicitHeadingIds(raw, warn, options = {}) {
   const { front, body } = splitFrontmatterBlock(raw);
   return front + replaceOutsideCode(body, (segment) => segment.split("\n").map((line) => {
     if (!/^[ \t]{0,3}#{1,6}[ \t]+/.test(line)) return line;
@@ -275,13 +447,15 @@ function normalizeExplicitHeadingIds(raw, warn) {
         const id = trimmed.slice(marker + 3, -1);
         const heading = trimmed.slice(0, marker).trimEnd();
         if (/[{}]/.test(id)) return line;
-        if (HTML_ID.test(id)) return `<a id="${id}"></a>
+        const usable = options.headingMarkers ? id && !/\s/.test(id) && !id.includes("*/") : HTML_ID.test(id);
+        if (usable && options.headingMarkers) return `${heading} ${headingIdMarker(id)}`;
+        if (usable) return `<a id="${id}"></a>
 ${heading}`;
         warn?.(`Heading anchor {#${id}} is not a valid HTML id and was removed from "${heading.replace(/^\s*#+\s*/, "")}".`);
         return heading;
       }
     }
-    if (trimmed.endsWith("*/}")) {
+    if (!options.headingMarkers && !options.keepIdComments && trimmed.endsWith("*/}")) {
       const marker = trimmed.lastIndexOf(" {/*");
       if (marker >= 0) {
         const comment = trimmed.slice(marker + 4, -3).trim();
@@ -295,6 +469,44 @@ ${trimmed.slice(0, marker).trimEnd()}`;
     return line;
   }).join("\n"));
 }
+function headingIdMarker(id) {
+  return `{/* #${id} */}`;
+}
+function mintlifyHeadingSlug(text2) {
+  return text2.replace(/\u200b/g, "").normalize("NFC").trim().toLowerCase().replace(/[.\s]+/g, "-").replace(/-{2,}/g, "-").replace(/^-|-$/g, "").replace(/[^\p{L}\p{M}\p{N}_\-+&/\u2019\u201c\u201d\u2014\u2013\u2192]/gu, "");
+}
+function thallyHeadingSlug(text2) {
+  return text2.normalize("NFC").toLowerCase().replace(/[^\p{L}\p{M}\p{N}]+/gu, "-").replace(/(^-|-$)/g, "");
+}
+function typesetQuotes(text2) {
+  return text2.split(/(`[^`]*`|<[^>]*>|\]\([^)]*\))/).map((part, index) => {
+    if (index % 2) return part;
+    return part.replace(/(^|[\s([{\u2014\u2013])"/g, "$1\u201C").replace(/"/g, "\u201D").replace(/(^|[\s([{\u2014\u2013\u201c])'(?=\S)/g, "$1\u2018").replace(/'/g, "\u2019");
+  }).join("");
+}
+function plainHeadingText(source) {
+  return source.replace(/!?\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/<\/?[A-Za-z][^>]*>/g, "").replace(/`([^`]*)`/g, "$1").replace(/(\*\*|__|~~|\*)/g, "").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/\\([\\`*_{}[\]()#+.!&<>|~-])/g, "$1");
+}
+function markMintlifyHeadings(body) {
+  let fence;
+  return body.split("\n").map((line) => {
+    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 = void 0;
+      return line;
+    }
+    if (fence) return line;
+    const heading = line.match(/^( {0,3}#{2,6}[ \t]+)(.+?)(?:[ \t]+#+)?[ \t]*$/);
+    if (!heading) return line;
+    const explicit = heading[2].match(/^(.*?)([ \t]*\{\/\*[ \t]*#\S+[ \t]*\*\/\})$/);
+    const source = typesetQuotes(explicit ? explicit[1] : heading[2]);
+    if (explicit) return `${heading[1]}${source}${explicit[2]}`;
+    const text2 = plainHeadingText(source);
+    const id = mintlifyHeadingSlug(text2);
+    return `${heading[1]}${source}${id && id !== thallyHeadingSlug(text2) ? ` ${headingIdMarker(id)}` : ""}`;
+  }).join("\n");
+}
 var GLOBAL_DOCUSARUS_COMPONENTS = /* @__PURE__ */ new Set([
   "Tabs",
   "TabItem",
@@ -428,6 +640,9 @@ function bracketDelta(line) {
   return delta;
 }
 var ESM_OPEN = /^(?:import|export)\b/;
+function latexElement(source, block = false) {
+  return `<Latex${block ? " block" : ""}>{${JSON.stringify(source)}}</Latex>`;
+}
 function protectMathBlocks(raw) {
   const { front, body } = splitFrontmatterBlock(raw);
   const lines = body.split(/\r\n|\r|\n/);
@@ -442,7 +657,7 @@ function protectMathBlocks(raw) {
     const trimmed = line.trim();
     if (mathBlockDelimiter) {
       if (trimmed === mathBlockDelimiter) {
-        output.push("```math", ...mathLines, "```");
+        output.push(latexElement(mathLines.join("\n"), true));
         mathBlockDelimiter = null;
         mathLines = [];
         converted = true;
@@ -484,11 +699,11 @@ function protectMathBlocks(raw) {
         (whole, block, inline) => {
           if (block !== void 0) {
             converted = true;
-            return `\`$$${block}$$\``;
+            return latexElement(unmask(block));
           }
           if (inline !== void 0 && hasTexSignal(unmask(inline))) {
             converted = true;
-            return `\`$${inline}$\``;
+            return latexElement(unmask(inline));
           }
           return whole;
         }
@@ -1222,17 +1437,55 @@ function injectReactHookImports(body) {
 
 ${body}` : body;
 }
+function normalizeFlowParagraphContainers(body) {
+  if (!body.includes("<p")) return body;
+  let tree;
+  try {
+    tree = descriptionParser.parse(body);
+  } catch {
+    return body;
+  }
+  const edits = [];
+  function visit(node) {
+    if (node.type === "mdxJsxFlowElement" && node.name === "p" && node.children?.some((child) => child.type === "paragraph" || child.type === "list" || child.type === "mdxJsxFlowElement")) {
+      const start = node.position?.start.offset;
+      const end = node.position?.end.offset;
+      if (start !== void 0 && end !== void 0 && body.slice(start, start + 2) === "<p") {
+        const closing = body.slice(start, end).match(/<\/p\s*>\s*$/i);
+        if (closing?.index !== void 0) {
+          edits.push({ offset: start + 1, value: "div" });
+          edits.push({ offset: start + closing.index + 2, value: "div" });
+        }
+      }
+    }
+    for (const child of node.children ?? []) visit(child);
+  }
+  visit(tree);
+  return edits.sort((a, b) => b.offset - a.offset).reduce((text2, edit) => text2.slice(0, edit.offset) + edit.value + text2.slice(edit.offset + 1), body);
+}
 function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
   const runFern = platform === "fern";
   const runMintlify = platform === "mintlify";
   const runDocusaurus = platform === "docusaurus";
   const sourceBody = runDocusaurus && unwrapMdxCodeBlocks ? unwrapDocusaurusMdxCodeBlocks(body) : body;
-  let rewritten = normalizeDocusaurusAdmonitions(normalizeExplicitHeadingIds(runFern ? normalizeFernFileTrees(normalizeFernCallouts(normalizeNestedCodeFences(sourceBody))) : normalizeNestedCodeFences(sourceBody)));
+  let rewritten = normalizeDocusaurusAdmonitions(normalizeExplicitHeadingIds(
+    runFern ? normalizeFernFileTrees(normalizeFernCallouts(normalizeNestedCodeFences(sourceBody))) : normalizeNestedCodeFences(sourceBody),
+    void 0,
+    { headingMarkers: runMintlify }
+  ));
+  if (runMintlify) rewritten = markMintlifyHeadings(rewritten);
   if (runDocusaurus) {
     rewritten = replaceOutsideCode(rewritten, (segment) => segment.replace(
       /:([+\w-]+):/g,
       (shortcode, name) => nameToEmoji[name] ?? shortcode
     ));
+    rewritten = replaceOutsideCode(rewritten, (segment) => segment.replace(
+      /\b(href|src)=\{\s*require\(\s*(['"])@docusaurus\/useBaseUrl\2\s*\)\.default\(\s*(['"])([^'"]+)\3\s*\)\s*\}/g,
+      (original, attribute, _moduleQuote, _pathQuote, path) => {
+        if (!/^[\w./~%-]+$/.test(path) || path.split("/").includes("..")) return original;
+        return `${attribute}="/${path.replace(/^\.\//, "").replace(/^\/+/, "")}"`;
+      }
+    ));
     rewritten = normalizeDocusaurusTabBlocks(normalizeDocusaurusTabs(removeGlobalDocusaurusImports(rewritten)));
     rewritten = replaceOutsideCode(rewritten, (segment) => segment.replace(
       /\bimport\s+([A-Za-z_$][\w$]*)\s+from\s+(['"])(@site\/[^'"]+)\2\s*;?/g,
@@ -1269,7 +1522,7 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
       return normalizeMdx(body, platform, false);
     }
   }
-  return normalized;
+  return normalizeFlowParagraphContainers(normalized);
 }
 function parseMarkdownPage(input) {
   const parsed = parseFrontmatter(input.raw);
@@ -1287,16 +1540,25 @@ function parseMarkdownPage(input) {
     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 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 meta = {};
+  for (const [source, field] of PAGE_META_FIELDS) {
+    const value = parsed.data[source];
+    if (typeof value === "string" && value.trim()) meta[field] = value.trim();
+  }
   const badge = typeof parsed.data.tag === "string" && parsed.data.tag.trim() ? parsed.data.tag.trim() : typeof parsed.data.badge === "string" && parsed.data.badge.trim() ? parsed.data.badge.trim() : void 0;
   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() : firstParagraph(body);
+  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 {
     id: identity.id,
     navigationId: identity.navigationId,
     locale: identity.locale,
     title,
     navTitle,
+    icon,
+    iconType,
     description,
     ...input.platform === "docusaurus" || input.platform === "fern" ? { descriptionPlacement: "body" } : {},
     badge,
@@ -1304,6 +1566,7 @@ function parseMarkdownPage(input) {
     mode,
     hidden: parsed.data.hidden === true ? true : void 0,
     noindex: parsed.data.noindex === true || parsed.data.noindex === "true" ? true : void 0,
+    ...Object.keys(meta).length > 0 ? { meta } : {},
     openapi: typeof parsed.data.openapi === "string" ? parsed.data.openapi.trim() : void 0,
     ...apiFrontmatter(parsed.data, input.warn),
     body,
@@ -1311,9 +1574,21 @@ function parseMarkdownPage(input) {
     ...parsed.error ? { frontmatterError: parsed.error } : {}
   };
 }
+var PAGE_META_FIELDS = [
+  ["og:title", "ogTitle"],
+  ["og:description", "ogDescription"],
+  ["og:image", "ogImage"],
+  ["twitter:title", "twitterTitle"],
+  ["twitter:description", "twitterDescription"],
+  ["twitter:image", "twitterImage"]
+];
 var AUTH_METHODS = /* @__PURE__ */ new Set(["bearer", "basic", "key", "none"]);
 function apiFrontmatter(data, warn) {
   const result = {};
+  if (data.playground !== void 0 && data.playground !== null) {
+    const display = playgroundDisplay(data.playground, `The page's "playground" frontmatter`, warn);
+    if (display) result.playground = display;
+  }
   if (data.api !== void 0 && data.api !== null) {
     if (typeof data.api === "string" && data.api.trim()) result.api = data.api.trim();
     else warn?.(`The page's "api" frontmatter is not a "METHOD url-or-path" string and was dropped.`);
@@ -1326,84 +1601,6 @@ function apiFrontmatter(data, warn) {
   return result;
 }
 
-// src/path.ts
-import { isAbsolute, relative, resolve, sep } from "path";
-var SAFE_SEGMENT = /[^a-z0-9._-]+/gi;
-function trimTrailingSlashes(value) {
-  let end = value.length;
-  while (end > 0 && value.charCodeAt(end - 1) === 47) end--;
-  return value.slice(0, end);
-}
-function trimEdgeSlashes(value) {
-  let start = 0;
-  let end = value.length;
-  while (start < end && value.charCodeAt(start) === 47) start++;
-  while (end > start && value.charCodeAt(end - 1) === 47) end--;
-  return value.slice(start, end);
-}
-function slugifySegment(value, preserveCase = false) {
-  let decoded = value;
-  try {
-    decoded = decodeURIComponent(value);
-  } catch {
-  }
-  const normalized = preserveCase ? decoded : decoded.toLowerCase();
-  return normalized.replace(/\.(?:html?|mdx?)$/i, "").replace(SAFE_SEGMENT, "-").replace(/(^-|-$)/g, "");
-}
-function pageIdFromReference(value, preserveCase = false) {
-  const withoutQuery = value.split(/[?#]/, 1)[0].replace(/\\/g, "/").replace(/^\/+/, "");
-  if (!withoutQuery || withoutQuery.includes("\0")) return null;
-  const rawSegments = withoutQuery.split("/").filter(Boolean);
-  if (rawSegments.some((segment) => segment === ".." || segment === ".")) return null;
-  const last = rawSegments.at(-1)?.replace(/\.(?:mdx?|rst|txt)$/i, "") ?? "";
-  const isRootLevelReadme = rawSegments.length === 1 && /^readme$/i.test(last);
-  const collapsesToParent = /^index$/i.test(last) || isRootLevelReadme;
-  const baseSegments = collapsesToParent ? rawSegments.slice(0, -1) : rawSegments;
-  if (!collapsesToParent) {
-    baseSegments[baseSegments.length - 1] = last;
-  }
-  const segments = baseSegments.map((segment) => slugifySegment(segment, preserveCase)).filter(Boolean);
-  return segments.join("/") || "introduction";
-}
-function mintlifyLocalizedReference(value, locale, defaultPageIds = /* @__PURE__ */ new Set()) {
-  const reference = value.replace(/^\/+/, "");
-  const localePrefix = `${locale.toLowerCase()}/`;
-  if (reference.toLowerCase().startsWith(localePrefix)) return reference.slice(localePrefix.length);
-  const sectionPrefix = `${locale.toLowerCase()}-`;
-  if (reference.toLowerCase().startsWith(sectionPrefix)) {
-    const candidate = reference.slice(sectionPrefix.length);
-    const candidateId = pageIdFromReference(candidate, true);
-    if (candidateId && defaultPageIds.has(candidateId)) return candidate;
-  }
-  const segments = reference.split("/");
-  const localeIndex = segments.findIndex((segment) => segment.toLowerCase() === locale.toLowerCase());
-  if (localeIndex > 0) {
-    return [...segments.slice(0, localeIndex), ...segments.slice(localeIndex + 1)].join("/");
-  }
-  return value;
-}
-function resolveWithin(root, candidate) {
-  return resolveWithinRoot(root, candidate, root);
-}
-function resolveWithinRoot(baseDir, candidate, confineRoot) {
-  if (isAbsolute(candidate) || candidate.includes("\0")) {
-    throw new Error(`Unsafe migration path: ${candidate}`);
-  }
-  const target = resolve(baseDir, candidate);
-  const fromRoot = relative(resolve(confineRoot), target);
-  if (fromRoot === ".." || fromRoot.startsWith(`..${sep}`) || isAbsolute(fromRoot)) {
-    throw new Error(`Migration path escapes its root: ${candidate}`);
-  }
-  return target;
-}
-function normalizeAssetPath(value) {
-  const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "");
-  if (!normalized || normalized.includes("\0")) return null;
-  const segments = normalized.split("/").filter(Boolean);
-  if (segments.some((segment) => segment === "." || segment === "..")) return null;
-  return segments.join("/");
-}
-
 // src/inline-extraction.ts
 import ts from "typescript";
 var SERVER_ONLY_IDENTIFIERS = /* @__PURE__ */ new Set(["process", "require", "module", "exports", "__dirname", "__filename", "Buffer"]);
@@ -2205,26 +2402,33 @@ function hash(value) {
 function portableSpecifier(path) {
   return path.replace(/\.tsx?$/, "");
 }
-function wrapImpureCssModuleSelectors(css) {
+function sanitizeCssModuleSelectors(css) {
   const root = postcss.parse(css);
+  let omitted = 0;
   root.walkRules((rule) => {
-    rule.selector = selectorParser((selectors) => {
-      selectors.each((selector) => {
-        let hasClassOrId = false;
-        selector.walk((node) => {
-          if (node.type === "class" || node.type === "id") hasClassOrId = true;
-        });
-        if (hasClassOrId) return;
-        const nodes = selector.nodes.splice(0, selector.nodes.length);
-        const container = selectorParser.selector({ value: "" });
-        for (const node of nodes) container.append(node);
-        const globalPseudo = selectorParser.pseudo({ value: ":global" });
-        globalPseudo.append(container);
-        selector.append(globalPseudo);
+    if (rule.parent?.type === "atrule" && /keyframes$/i.test(rule.parent.name)) return;
+    if (/^:export$|^:import\(/.test(rule.selector.trim())) return;
+    const selectors = selectorParser().astSync(rule.selector);
+    selectors.each((selector) => {
+      let hasLocalClassOrId = false;
+      selector.walk((node) => {
+        if (node.type !== "class" && node.type !== "id") return;
+        let parent = node.parent;
+        while (parent) {
+          if (parent.type === "pseudo" && parent.value === ":global") return;
+          parent = parent.parent;
+        }
+        hasLocalClassOrId = true;
       });
-    }).processSync(rule.selector);
+      if (!hasLocalClassOrId) {
+        selector.remove();
+        omitted++;
+      }
+    });
+    if (selectors.nodes.length === 0) rule.remove();
+    else rule.selector = selectors.toString();
   });
-  return root.toString();
+  return { css: root.toString(), omitted };
 }
 function sourceFile(source, filename) {
   return ts2.createSourceFile(
@@ -2424,10 +2628,10 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
   }
   function expandCandidates(candidate) {
     const candidates = [candidate];
-    if (!extname(candidate)) {
+    if (!extname2(candidate)) {
       candidates.push(...[".tsx", ".jsx", ".ts", ".js", ".mjs", ".json"].map((extension) => candidate + extension));
       candidates.push(...["index.tsx", "index.jsx", "index.ts", "index.js"].map((name) => resolve2(candidate, name)));
-    } else if (extname(candidate) === ".js") {
+    } else if (extname2(candidate) === ".js") {
       candidates.push(candidate.slice(0, -3) + ".ts", candidate.slice(0, -3) + ".tsx");
     }
     return candidates;
@@ -2455,6 +2659,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
   }
   function copyGraph(entry) {
     const staged = /* @__PURE__ */ new Map();
+    const stagedWarnings = [];
     let stagedBytes = 0;
     function stageShim(filename, content) {
       const shimDestination = `${destinationRoot}/shims/${filename}`;
@@ -2467,7 +2672,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
       checkedFile(path);
       const size = lstatSync(path).size;
       if (size > MAX_FILE_BYTES || copiedBytes + stagedBytes + size > MAX_COMPONENT_BYTES || copied.size + staged.size >= MAX_COMPONENT_FILES) throw new Error("component migration budget exceeded");
-      const extension = extname(path).toLowerCase();
+      const extension = extname2(path).toLowerCase();
       if (!CODE_EXTENSIONS.has(extension) && !DATA_EXTENSIONS.has(extension)) throw new Error(`unsupported dependency file type ${extension}`);
       stagedBytes += size;
       const content = readFileSync(path);
@@ -2475,13 +2680,14 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
       if (!CODE_EXTENSIONS.has(extension)) {
         if (extension === ".css" && /@import\b|url\s*\(/i.test(content.toString("utf8"))) throw new Error("CSS resource dependencies require manual migration");
         if (extension === ".css" && path.toLowerCase().endsWith(".module.css")) {
-          let wrapped;
+          let sanitized;
           try {
-            wrapped = wrapImpureCssModuleSelectors(content.toString("utf8"));
+            sanitized = sanitizeCssModuleSelectors(content.toString("utf8"));
           } catch {
             throw new Error("CSS module could not be parsed to check for Turbopack-safe selectors");
           }
-          staged.set(destination, { path: destination, content: wrapped });
+          if (sanitized.omitted > 0) stagedWarnings.push({ path, omitted: sanitized.omitted });
+          staged.set(destination, { path: destination, content: sanitized.css });
         }
         return;
       }
@@ -2550,6 +2756,9 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
     }
     visit(entry);
     for (const [path, file] of staged) copied.set(path, file);
+    for (const { path, omitted } of stagedWarnings) {
+      warn(`Site-authored CSS module ${relative2(root, path).replace(/\\/g, "/")} has ${omitted} global-only selector branch(es) that cannot be copied into Thally CSS Modules; those styles were omitted.`, path);
+    }
     copiedBytes += stagedBytes;
     return outputPath(entry);
   }
@@ -2559,7 +2768,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
     if (size > MAX_FILE_BYTES || copiedBytes + size > MAX_COMPONENT_BYTES || copied.size >= MAX_COMPONENT_FILES) {
       throw new Error("component migration budget exceeded");
     }
-    const publicName = `migrated-${hash(relative2(confined, path))}${extname(path).toLowerCase()}`;
+    const publicName = `migrated-${hash(relative2(confined, path))}${extname2(path).toLowerCase()}`;
     const destination = `public/${publicName}`;
     if (!copied.has(destination)) {
       copied.set(destination, { path: destination, content: readFileSync(path) });
@@ -2594,7 +2803,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
   function transform(raw, currentFile) {
     const parsedFrontmatter = parseFrontmatter(raw).content;
     const frontmatter = raw.slice(0, raw.length - parsedFrontmatter.length);
-    const content = normalizeExplicitHeadingIds(normalizeIndentedFences(normalizeHtmlComments(parsedFrontmatter)));
+    const content = normalizeExplicitHeadingIds(normalizeIndentedFences(normalizeHtmlComments(parsedFrontmatter)), void 0, { keepIdComments: true });
     let tree;
     try {
       tree = parser.parse(content);
@@ -2712,7 +2921,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
           }
           continue;
         }
-        if (bindings.length && RESCUABLE_ASSET_EXTENSIONS.has(extname(specifier).toLowerCase()) && !bindings.some((binding) => usedAsJsxTagName(binding.local))) {
+        if (bindings.length && RESCUABLE_ASSET_EXTENSIONS.has(extname2(specifier).toLowerCase()) && !bindings.some((binding) => usedAsJsxTagName(binding.local))) {
           try {
             const href = copyPublicAsset(resolveDependency(specifier, currentFile));
             edits.push({
@@ -2743,7 +2952,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
         try {
           const sourcePath = resolveDependency(specifier, currentFile);
           const path = copyGraph(sourcePath);
-          const isSvgUsedAsTag = extname(path).toLowerCase() === ".svg" && bindings.some((binding) => usedAsJsxTagName(binding.local));
+          const isSvgUsedAsTag = extname2(path).toLowerCase() === ".svg" && bindings.some((binding) => usedAsJsxTagName(binding.local));
           for (const binding of bindings) {
             const registerPath = isSvgUsedAsTag ? wrapSvgAsComponent(path) : path;
             const registerImported = isSvgUsedAsTag ? "default" : binding.imported;
@@ -2782,7 +2991,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
           const importStart = node.position.start.offset + statement.getStart(ast);
           const importEnd = node.position.start.offset + statement.end;
           let rescuedAssetHref;
-          if (RESCUABLE_ASSET_EXTENSIONS.has(extname(specifier).toLowerCase())) {
+          if (RESCUABLE_ASSET_EXTENSIONS.has(extname2(specifier).toLowerCase())) {
             const usedAsJsxTag = bindings.some((binding) => hasExpressionReference(/* @__PURE__ */ new Set([binding.local]), { includeDirectTags: true }));
             if (!usedAsJsxTag) {
               try {
@@ -2803,7 +3012,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
             warn(`Asset import ${JSON.stringify(rawSpecifier)} could not be copied as a component; it was copied to ${rescuedAssetHref} and bound to that URL instead.`, currentFile);
           } else {
             edits.push({ start: importStart, end: importEnd, value: "" });
-            warn(`Component import ${JSON.stringify(rawSpecifier)} could not be copied and was removed: ${error instanceof Error ? error.message : "unsupported dependency"}. Its usage on this page was neutralized.`, currentFile);
+            warn(`Site-authored component import ${JSON.stringify(rawSpecifier)} could not be copied and was removed: ${error instanceof Error ? error.message : "unsupported dependency"}. Its usage on this page was neutralized; review this custom implementation manually.`, currentFile);
           }
         }
       }
@@ -3133,6 +3342,125 @@ import { customComponents as ${name} } from ${JSON.stringify(registryPath)}
   ];
 }
 
+// src/source-styles.ts
+import postcss2 from "postcss";
+import selectorParser2 from "postcss-selector-parser";
+import ts3 from "typescript";
+var PLATFORM_CLASSES = /* @__PURE__ */ new Set(["navbar-link"]);
+var PLATFORM_IDS = /* @__PURE__ */ new Set(["footer", "navbar", "sidebar"]);
+var PLATFORM_CLASS_PREFIX = /^(?:mintlify[-_]|fern[-_]|docusaurus[-_]|theme-doc-|theme-code-block|DocSearch|pagination-nav|menu__)/i;
+var SHARED_THEME_CLASSES = /* @__PURE__ */ new Set(["dark", "light"]);
+var UTILITY_CLASS = /^(?:[mp][trblxy]?|w|h|min-w|max-w|min-h|max-h|text|bg|border|rounded|flex|grid|gap|space-[xy]|items|justify|overflow|truncate|hidden|block|inline|relative|absolute|sticky|z|opacity)-/;
+function withoutFencedCode(content) {
+  let fence;
+  return content.split("\n").map((line) => {
+    const marker = line.match(/^ {0,3}(`{3,}|~{3,})/)?.[1];
+    if (fence) {
+      if (marker?.[0] === fence.marker && marker.length >= fence.length) fence = void 0;
+      return "";
+    }
+    if (marker) {
+      fence = { marker: marker[0], length: marker.length };
+      return "";
+    }
+    return line;
+  }).join("\n");
+}
+function navbarLinkButtons(css) {
+  const buttons = [];
+  postcss2.parse(css).walkRules((rule) => {
+    const match = /^(?:li)?\.navbar-link\s+a\[href(\*)?=["']([^"']+)["']\]$/.exec(rule.selector.trim());
+    if (!match) return;
+    let background;
+    let color;
+    rule.walkDecls((decl) => {
+      if (decl.prop === "background-color" || decl.prop === "background") background = decl.value;
+      else if (decl.prop === "color") color = decl.value;
+    });
+    if (background) buttons.push({ href: match[2], exact: !match[1], background, ...color ? { color } : {} });
+  });
+  return buttons;
+}
+function authoredStyleNames(contents) {
+  const classes = /* @__PURE__ */ new Set();
+  const ids = /* @__PURE__ */ new Set();
+  for (const original of contents) {
+    const content = withoutFencedCode(original);
+    for (const match of content.matchAll(/\b(?:className|class)\s*=\s*["']([^"']+)["']/g)) {
+      for (const name of match[1].split(/\s+/)) if (name) classes.add(name);
+    }
+    for (const match of content.matchAll(/\bid\s*=\s*["']([^"']+)["']/g)) ids.add(match[1]);
+    if (!content.includes("className={")) continue;
+    const source = ts3.createSourceFile("component.tsx", content, ts3.ScriptTarget.Latest, true, ts3.ScriptKind.TSX);
+    const visit = (node) => {
+      if (ts3.isJsxAttribute(node) && ts3.isIdentifier(node.name) && node.name.text === "className" && node.initializer) {
+        const collect = (value) => {
+          if (ts3.isStringLiteral(value) || ts3.isNoSubstitutionTemplateLiteral(value)) {
+            for (const name of value.text.split(/\s+/)) if (name) classes.add(name);
+          } else ts3.forEachChild(value, collect);
+        };
+        collect(node.initializer);
+      }
+      ts3.forEachChild(node, visit);
+    };
+    visit(source);
+  }
+  return { classes, ids };
+}
+function projectAuthoredStyles(css, contents) {
+  const names = authoredStyleNames(contents);
+  const root = postcss2.parse(css);
+  let omittedSelectors = 0;
+  let rewrittenSelectors = 0;
+  root.walkRules((rule) => {
+    if (rule.parent?.type === "atrule" && /keyframes$/i.test(rule.parent.name)) return;
+    const retained = [];
+    try {
+      selectorParser2((selectors) => {
+        selectors.each((selector) => {
+          let hasAuthoredAnchor = false;
+          let hasPlatformAnchor = false;
+          selector.walk((node) => {
+            let ancestor = node.parent;
+            let isNestedInPseudo = false;
+            while (ancestor && ancestor !== selector) {
+              if (ancestor.type === "pseudo") isNestedInPseudo = true;
+              ancestor = ancestor.parent;
+            }
+            if (node.type === "class") {
+              if (SHARED_THEME_CLASSES.has(node.value)) return;
+              if (PLATFORM_CLASSES.has(node.value) || PLATFORM_CLASS_PREFIX.test(node.value) || UTILITY_CLASS.test(node.value) || !names.classes.has(node.value)) hasPlatformAnchor = true;
+              else if (!isNestedInPseudo) hasAuthoredAnchor = true;
+            } else if (node.type === "id") {
+              if (PLATFORM_IDS.has(node.value) || !names.ids.has(node.value)) hasPlatformAnchor = true;
+              else if (!isNestedInPseudo) hasAuthoredAnchor = true;
+            } else if (node.type === "attribute" && node.attribute === "data-as") {
+              node.remove();
+              rewrittenSelectors += 1;
+            }
+          });
+          if (hasAuthoredAnchor && !hasPlatformAnchor) retained.push(selector.toString());
+          else omittedSelectors += 1;
+        });
+      }).processSync(rule.selector);
+    } catch {
+      omittedSelectors += 1;
+    }
+    if (retained.length) rule.selector = retained.join(", ");
+    else rule.remove();
+  });
+  const hasStyleRule = (nodes) => Boolean(nodes?.some((node) => node.type === "rule" || node.type === "atrule" && hasStyleRule(node.nodes)));
+  root.walkAtRules((rule) => {
+    if (rule.name === "font-face" || rule.name === "property") return;
+    if (!hasStyleRule(rule.nodes)) rule.remove();
+  });
+  if (omittedSelectors === 0 && rewrittenSelectors === 0) return { css, omittedSelectors };
+  root.walkComments((comment) => {
+    comment.remove();
+  });
+  return { css: root.toString(), omittedSelectors };
+}
+
 // src/docusaurus.ts
 import { existsSync as existsSync3, lstatSync as lstatSync3, readFileSync as readFileSync3 } from "fs";
 import { extname as extname4, posix as posix2 } from "path";
@@ -3142,89 +3470,6 @@ import { parse as parseYaml2 } from "yaml";
 // src/navigation.ts
 import { existsSync as existsSync2, lstatSync as lstatSync2, readFileSync as readFileSync2, realpathSync } from "fs";
 import { dirname as dirname2, extname as extname3, relative as relative3 } from "path";
-
-// src/mintlify-extras.ts
-import { extname as extname2 } from "path";
-function objectValue(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
-}
-var PUBLIC_FALSE_STRINGS = /* @__PURE__ */ new Set(["false", "no", "off", "0"]);
-function isPublicFalse(value) {
-  return value === false || value === 0 || typeof value === "string" && PUBLIC_FALSE_STRINGS.has(value.trim().toLowerCase());
-}
-function isPublicTrue(value) {
-  return value === true || typeof value === "string" && value.trim().toLowerCase() === "true";
-}
-function frontmatterGateReason(data) {
-  const groups = data.groups;
-  const hasGroups = Array.isArray(groups) ? groups.length > 0 : typeof groups === "string" ? groups.trim() !== "" : groups !== void 0 && groups !== null && groups !== false;
-  if (hasGroups) return "frontmatter `groups` restricts it to authenticated groups";
-  if (isPublicFalse(data.public)) return "frontmatter `public: false`";
-  return void 0;
-}
-function navigationGateReason(node) {
-  const groups = node.groups;
-  const isContainer = (entry) => typeof entry === "object" && entry !== null && !Array.isArray(entry) && ["group", "pages", "tab", "groups", "page", "root", "menu", "href"].some((key) => key in entry);
-  const restricted = typeof groups === "string" ? groups.trim() !== "" : Array.isArray(groups) && groups.length > 0 && !groups.every(isContainer);
-  if (restricted) return "its navigation container sets `groups`";
-  if (isPublicFalse(node.public)) return "its navigation container sets `public: false`";
-  return void 0;
-}
-var CONFIG_BASENAME = /(?:^|[.-])(?:config|rc)\.[cm]?js$|^(?:tailwind|postcss|next|eslint|prettier|babel|webpack|vite|vitest|jest|rollup|gulpfile|gruntfile|stylelint|commitlint|lint-staged|svgo|metro)[.-]/i;
-var BUILD_OUTPUT_SEGMENTS = /* @__PURE__ */ new Set(["dist", "build", "coverage"]);
-var FONT_EXTENSIONS = /* @__PURE__ */ new Set([".woff", ".woff2", ".ttf", ".otf"]);
-function isMintlifyServedScriptOrStyle(relativePath) {
-  const extension = extname2(relativePath).toLowerCase();
-  if (extension !== ".css" && extension !== ".js") return false;
-  const segments = relativePath.split("/");
-  if (segments.slice(0, -1).some((segment) => BUILD_OUTPUT_SEGMENTS.has(segment.toLowerCase()))) return false;
-  return extension === ".css" || !CONFIG_BASENAME.test(segments[segments.length - 1]);
-}
-function mintlifyFontSources(config) {
-  const fonts = objectValue(config?.fonts);
-  if (!fonts) return [];
-  const found = [];
-  for (const entry of [fonts, objectValue(fonts.heading), objectValue(fonts.body)]) {
-    if (!entry || typeof entry.source !== "string" || !entry.source.trim()) continue;
-    const source = entry.source.trim();
-    const family = typeof entry.family === "string" ? entry.family : "a font";
-    const remote = /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(source);
-    const path = remote || /^[a-z]:[\\/]/i.test(source) ? null : normalizeAssetPath(source);
-    found.push({ family, source, path: path && FONT_EXTENSIONS.has(extname2(path).toLowerCase()) ? path : null, remote });
-  }
-  return found;
-}
-function mintlifyAppearance(config, warnings) {
-  const appearance = objectValue(config.appearance);
-  const legacy = objectValue(config.modeToggle);
-  const result = {};
-  const isMode = (value) => value === "system" || value === "light" || value === "dark";
-  const skip = (field, value) => {
-    warnings.push({
-      code: "unsupported-config",
-      message: `Ignored invalid ${field} value ${JSON.stringify(value)?.slice(0, 40)}; the appearance default was left unchanged.`
-    });
-  };
-  if (appearance?.default !== void 0) {
-    if (isMode(appearance.default)) result.default = appearance.default;
-    else skip("appearance.default", appearance.default);
-  } else if (legacy?.default !== void 0) {
-    if (isMode(legacy.default)) result.default = legacy.default;
-    else skip("modeToggle.default", legacy.default);
-  }
-  if (appearance?.strict !== void 0) {
-    if (typeof appearance.strict === "boolean") {
-      if (appearance.strict) result.showToggle = false;
-    } else skip("appearance.strict", appearance.strict);
-  } else if (legacy?.isHidden !== void 0) {
-    if (typeof legacy.isHidden === "boolean") {
-      if (legacy.isHidden) result.showToggle = false;
-    } else skip("modeToggle.isHidden", legacy.isHidden);
-  }
-  return result;
-}
-
-// src/navigation.ts
 var MAX_MINTLIFY_CONFIG_BYTES = 2e7;
 function addMintlifyDirectoryRedirects(config, pages) {
   const pageIds = new Set(pages.map((page) => page.id));
@@ -3295,34 +3540,37 @@ function addMintlifyHomepageRedirects(config, pages) {
     }
   }
   const homepage = config.tabs.filter((tab) => !tab.hidden).map((tab) => firstPage([...tab.pages ?? [], ...tab.groups ?? []])).find(Boolean);
-  if (!homepage || homepage === "introduction") return config;
+  if (!homepage) return config;
   const redirects = [...config.redirects ?? []];
   const sources = new Set(redirects.map((redirect) => redirect.source.replace(/\/$/, "") || "/"));
-  const roots = ["", ...(config.i18n?.locales ?? []).filter((locale) => locale.code !== config.i18n?.defaultLocale).map((locale) => locale.code)];
+  const roots = ["", ...(config.i18n?.locales ?? []).filter((locale) => locale.code !== config.i18n?.defaultLocale).filter((locale) => homepage !== "introduction" || pages.some((page) => page.locale === locale.code && page.navigationId === homepage)).map((locale) => locale.code)];
   for (const locale of roots) {
     const source = locale ? `/${locale}` : "/";
     if (sources.has(source)) continue;
-    redirects.push({ source, destination: `${locale ? `/${locale}` : ""}/${homepage}`, permanent: false });
+    redirects.push({ source, destination: `${locale ? `/${locale}` : ""}/${homepage}`, permanent: true });
   }
   return { ...config, redirects };
 }
 var LANGUAGE_LABELS = {
-  ar: "Arabic",
-  de: "German",
+  ar: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629",
+  de: "Deutsch",
   en: "English",
-  es: "Spanish",
-  fr: "French",
-  hi: "Hindi",
-  it: "Italian",
-  ja: "Japanese",
-  ko: "Korean",
-  nl: "Dutch",
-  pl: "Polish",
-  pt: "Portuguese",
-  ru: "Russian",
-  tr: "Turkish",
-  uk: "Ukrainian",
-  zh: "Chinese"
+  es: "Espa\xF1ol",
+  fr: "Fran\xE7ais",
+  hi: "\u0939\u093F\u0928\u094D\u0926\u0940",
+  it: "Italiano",
+  ja: "\u65E5\u672C\u8A9E",
+  ko: "\uD55C\uAD6D\uC5B4",
+  nl: "Nederlands",
+  pl: "Polski",
+  pt: "Portugu\xEAs",
+  "pt-BR": "Portugu\xEAs (BR)",
+  ru: "\u0420\u0443\u0441\u0441\u043A\u0438\u0439",
+  tr: "T\xFCrk\xE7e",
+  uk: "\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430",
+  zh: "\u7B80\u4F53\u4E2D\u6587",
+  "zh-Hans": "\u7B80\u4F53\u4E2D\u6587",
+  "zh-Hant": "\u7E41\u9AD4\u4E2D\u6587"
 };
 function objectValue2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -3787,11 +4035,26 @@ function convertContainerToTabs(containerValue, context, fallbackTab, trace, dep
   }] : [];
 }
 function projectedTheme(value) {
-  if (value === "maple") return "maple";
-  if (["aspen", "luma", "sequoia"].includes(String(value))) return "sharp";
+  if (value === "maple" || value === "aspen") return "maple";
+  if (["luma", "sequoia"].includes(String(value))) return "sharp";
   if (["almond", "palm"].includes(String(value))) return "minimal";
   return typeof value === "string" ? "default" : void 0;
 }
+function projectedColors(value) {
+  const colors = objectValue2(value);
+  if (!colors) return void 0;
+  const hex = (entry) => {
+    const match = typeof entry === "string" ? /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(entry.trim()) : null;
+    if (!match) return void 0;
+    const digits = match[1].length === 3 ? [...match[1]].map((digit) => digit + digit).join("") : match[1];
+    return `#${digits.toLowerCase()}`;
+  };
+  const primary = hex(colors.primary);
+  const light = hex(colors.light) ?? primary;
+  const dark = hex(colors.dark) ?? primary;
+  if (!primary) return void 0;
+  return { light: { accent: primary, primary: dark ?? primary }, dark: { accent: light ?? primary, primary: light ?? primary } };
+}
 function projectedNavbar(value) {
   const navbar = objectValue2(value);
   if (!navbar) return void 0;
@@ -3807,7 +4070,8 @@ function projectedNavbar(value) {
   const primaryHref = projectedHref(primaryValue?.href);
   const primary = primaryValue && primaryHref ? {
     label: typeof primaryValue.label === "string" ? primaryValue.label : primaryValue.type === "github" ? "GitHub" : "Get started",
-    href: primaryHref
+    href: primaryHref,
+    ...primaryValue.type === "github" ? { type: "github" } : {}
   } : void 0;
   return links.length > 0 || primary ? { ...links.length > 0 ? { links } : {}, ...primary ? { primary } : {} } : void 0;
 }
@@ -3887,8 +4151,16 @@ function projectedCompatibleConfig(config, warnings) {
   const headingFont = projectedFont(objectValue2(config.fonts)?.heading);
   const feedback = objectValue2(config.feedback);
   const seo = objectValue2(config.seo);
+  const contextualOptions = Array.isArray(objectValue2(config.contextual)?.options) ? objectValue2(config.contextual).options : [];
+  const projectedContextual = contextualOptions.filter((option) => typeof option === "string" && ["copy", "view", "chatgpt", "claude", "perplexity"].includes(option));
+  const droppedContextual = contextualOptions.filter((option) => !projectedContextual.includes(option));
+  if (droppedContextual.length > 0) {
+    warnings.push({ code: "unsupported-config", message: `contextual.options entries not supported by the page menu were dropped: ${droppedContextual.map((option) => typeof option === "string" ? option : "custom entry").join(", ")}.`, source: "docs.json" });
+  }
+  const metatagEntries = Object.entries(objectValue2(seo?.metatags) ?? {}).filter((entry) => /^[\w:.-]+$/.test(entry[0]) && typeof entry[1] === "string" && entry[1].length <= 1e3);
+  const projectedMetatags = metatagEntries.length > 0 ? Object.fromEntries(metatagEntries) : void 0;
   const iconLibrary = objectValue2(config.icons)?.library;
-  const projectedIconLibrary = ["lucide", "fontawesome", "tabler"].includes(String(iconLibrary)) ? String(iconLibrary) : void 0;
+  const projectedIconLibrary = iconLibrary === void 0 ? "fontawesome" : ["lucide", "fontawesome", "tabler"].includes(String(iconLibrary)) ? String(iconLibrary) : void 0;
   const docsNavbar = projectedNavbar(config.navbar);
   const legacyRaw = legacyTopbarNavbar(config);
   const legacyNavbar = projectedNavbar(legacyRaw);
@@ -3916,6 +4188,8 @@ function projectedCompatibleConfig(config, warnings) {
   const projectedNavigation = navbarLinks.length > 0 || navbar?.primary ? { ...navbarLinks.length > 0 ? { links: navbarLinks } : {}, ...navbar?.primary ? { primary: navbar.primary } : {} } : void 0;
   return {
     ...projectedTheme(config.theme) ? { theme: projectedTheme(config.theme) } : {},
+    ...projectedContextual.length > 0 ? { contextual: { options: projectedContextual } } : {},
+    ...projectedColors(config.colors) ? { colors: projectedColors(config.colors) } : {},
     ...projectedIconLibrary ? { icons: { library: projectedIconLibrary } } : {},
     ...bannerContent ? {
       banner: {
@@ -3933,10 +4207,19 @@ function projectedCompatibleConfig(config, warnings) {
     ...projectedNavigation ? { navbar: projectedNavigation } : {},
     ...projectedFooter(config.footer) ? { footer: projectedFooter(config.footer) } : {},
     ...bodyFont || headingFont ? { fonts: { ...bodyFont ? { body: bodyFont } : {}, ...headingFont ? { heading: headingFont } : {} } } : {},
-    ...seo?.indexing === "all" ? { seo: { indexing: "all" } } : {},
+    // Mintlify titles pages "<title> - <site name>" unless `og:title` overrides them,
+    // and its sitemap lists navigation pages only.
+    seo: { ...seo?.indexing === "all" ? { indexing: "all" } : {}, titleSeparator: " - ", sitemap: "navigable", ...projectedMetatags ? { metatags: projectedMetatags } : {} },
     ...typeof feedback?.thumbsRating === "boolean" ? { feedback: { thumbsRating: feedback.thumbsRating } } : {}
   };
 }
+function projectedApi(config, warnings) {
+  const mdx = projectedApiMdx(config, warnings).api?.mdx;
+  const raw = objectValue2(objectValue2(config.api)?.playground)?.display;
+  const display = raw === void 0 ? void 0 : playgroundDisplay(raw, "api.playground.display", (message) => warnings.push({ code: "unsupported-config", message }));
+  if (!mdx && !display) return {};
+  return { api: { ...mdx ? { mdx } : {}, ...display ? { playground: { display } } : {} } };
+}
 function projectedApiMdx(config, warnings) {
   const mdx = objectValue2(objectValue2(config.api)?.mdx);
   if (!mdx) return {};
@@ -4131,6 +4414,47 @@ function projectMintlifyNavigation(config, options = {}) {
       message: "Mintlify navigation could not be projected; generated navigation will be used."
     });
   }
+  const versionOwner = languages.length > 0 ? languages.find((entry) => entry.default === true) ?? languages[0] : navigation;
+  const globalNavigation = objectValue2(versionOwner.global) ?? objectValue2(navigation.global);
+  const shortcuts = Array.isArray(globalNavigation?.anchors) ? globalNavigation.anchors.flatMap((value) => {
+    const anchor = objectValue2(value);
+    const label = typeof anchor?.anchor === "string" ? anchor.anchor.trim() : "";
+    const href = projectedHref(anchor?.href);
+    if (!label || !href) return [];
+    return [{ label, href, ...iconName(anchor?.icon) ? { icon: iconName(anchor?.icon) } : {} }];
+  }) : [];
+  const rawVersions = Array.isArray(versionOwner.versions) ? versionOwner.versions.map(objectValue2).filter((value) => value !== null).sort((left, right) => Number(right.default === true) - Number(left.default === true)) : [];
+  const versionNames = rawVersions.map((entry) => typeof entry.version === "string" ? entry.version.trim() : "").filter(Boolean);
+  const annotateVersions = (items) => items.map((item) => {
+    const version = versionNames.find((name) => item.tab.startsWith(`${name}: `));
+    return version ? { ...item, version, displayLabel: item.tab.slice(version.length + 2) } : item;
+  });
+  const firstPage = (item) => {
+    const visit = (entries) => {
+      for (const entry of entries) {
+        if (typeof entry === "string") return entry;
+        const nested = visit(entry.pages);
+        if (nested) return nested;
+      }
+      return void 0;
+    };
+    return visit([...item.pages ?? [], ...item.groups ?? []]);
+  };
+  const defaultVersion = rawVersions.find((entry) => entry.default === true) ?? rawVersions[0];
+  const versions = rawVersions.length > 1 ? rawVersions.flatMap((entry) => {
+    const label = typeof entry.version === "string" ? entry.version.trim() : "";
+    if (!label) return [];
+    const candidates = tabs.filter((item) => item.tab.startsWith(`${label}: `)).map(firstPage).filter((page) => Boolean(page));
+    const landing = candidates.find((page) => page.startsWith(`${label}/`)) ?? candidates[0];
+    if (!landing) return [];
+    const firstSegment = landing.split("/")[0];
+    const prefix = firstSegment === label ? label : "";
+    return [{ label, prefix, href: `/${landing}`, ...entry === defaultVersion ? { default: true } : {}, ...entry.hidden === true ? { hidden: true } : {} }];
+  }) : [];
+  if (versions.length > 1) {
+    tabs = annotateVersions(tabs);
+    for (const [locale, items] of Object.entries(localizedNavigation)) localizedNavigation[locale] = annotateVersions(items);
+  }
   const redirects = Array.isArray(config.redirects) ? config.redirects.flatMap((value) => {
     const redirect = objectValue2(value);
     if (!redirect || typeof redirect.source !== "string" || typeof redirect.destination !== "string") return [];
@@ -4155,9 +4479,13 @@ function projectMintlifyNavigation(config, options = {}) {
   return {
     docsConfig: {
       tabs,
-      ...projectionTrace.rootContainerKind === "dropdowns" ? { navigation: { display: "dropdown" } } : {},
+      ...projectionTrace.rootContainerKind === "dropdowns" || versions.length > 1 || shortcuts.length > 0 ? { navigation: {
+        ...projectionTrace.rootContainerKind === "dropdowns" ? { display: "dropdown" } : {},
+        ...versions.length > 1 ? { versions } : {},
+        ...shortcuts.length > 0 ? { shortcuts } : {}
+      } } : {},
       ...projectedCompatibleConfig(config, warnings),
-      ...projectedApiMdx(config, warnings),
+      ...projectedApi(config, warnings),
       ...i18n ? { i18n } : {},
       ...redirects.length > 0 ? { redirects } : {}
     },
@@ -4832,9 +5160,10 @@ function descriptorSort(left, right) {
   if (leftPosition !== rightPosition) return leftPosition - rightPosition;
   return left.sourcePath.localeCompare(right.sourcePath, void 0, { numeric: true });
 }
-function registerDoc(docId, context) {
+function registerDoc(docId, context, sourceDirectory) {
   const key = normalizeDocId(docId);
-  const descriptor = context.descriptorByDocId.get(key) ?? context.descriptors.find((page) => page.navigationId === docusaurusRouteId(key));
+  const scopedKey = sourceDirectory && !docId.startsWith("/") ? normalizeDocId(posix2.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",
@@ -4846,10 +5175,10 @@ function registerDoc(docId, context) {
   context.referencedNavigationIds.add(descriptor.navigationId);
   return descriptor.navigationId;
 }
-function generatedIndexPage(label, linkValue, context) {
+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);
+  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;
@@ -5092,7 +5421,7 @@ function autogeneratedItems(dirName, context) {
         };
       }
     }
-    const landing = generatedIndexPage(metadata.label ?? titleCase2(segment), metadata.link, context);
+    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,
@@ -5926,6 +6255,7 @@ var FRONTMATTER_HEAD_BYTES = 65536;
 var MAX_WITHHELD_SCAN_BYTES = MAX_PAGE_BYTES * 8;
 var MAX_DROPPED_GATED_WARNINGS = 20;
 var MAX_ASSET_BYTES = 25e6;
+var MAX_REFERENCED_ASSET_BYTES = 1e8;
 var MAX_TOTAL_ASSET_BYTES = 5e8;
 var GIT_LFS_POINTER_PREFIX = "version https://git-lfs.github.com/spec/v1";
 function listAssetPaths(paths) {
@@ -6804,12 +7134,22 @@ function mintlifyTopLevelApiReferences(config) {
   }
   return references;
 }
-function resolveMintlifyApiSpecs(mintlifyConfig, files, warnings, remoteSpecs) {
+function resolveMintlifyApiSpecs(mintlifyConfig, files, warnings, remoteSpecs, pages = []) {
   if (!mintlifyConfig) return [];
   const references = [
     ...mintlifyTopLevelApiReferences(mintlifyConfig),
     ...mintlifyNavigationApiReferences(mintlifyConfig)
   ];
+  const specKey = (value) => value.split(/[?#]/, 1)[0].replace(/\\/g, "/").replace(/^(?:\.\/)+/, "").replace(/^\/+/, "");
+  const known = new Set(references.map((reference) => specKey(reference.value)));
+  for (const page of pages) {
+    const specRef = page.openapi ? splitOpenApiRef(page.openapi)?.specRef : void 0;
+    if (!specRef || /^[a-z][a-z0-9+.-]*:/i.test(specRef)) continue;
+    const key = specKey(specRef);
+    if (known.has(key) || !files.some((file) => file.relativePath === key)) continue;
+    known.add(key);
+    references.push({ value: key, kind: "openapi", tabLabel: `OpenAPI: ${key}`, hidden: true, pageOnly: true });
+  }
   const seen = /* @__PURE__ */ new Set();
   const specs = [];
   for (const reference of references) {
@@ -6859,6 +7199,7 @@ function resolveMintlifyApiSpecs(mintlifyConfig, files, warnings, remoteSpecs) {
       parentTab: reference.parentTab,
       icon: reference.icon,
       hidden: reference.hidden,
+      ...reference.pageOnly ? { pageOnly: true } : {},
       sourcePath: match.relativePath,
       directory: reference.directory
     });
@@ -7186,18 +7527,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 = ts3.createSourceFile("snippet.tsx", source, ts3.ScriptTarget.Latest, true, ts3.ScriptKind.TSX);
+  const parsed = ts4.createSourceFile("snippet.tsx", source, ts4.ScriptTarget.Latest, true, ts4.ScriptKind.TSX);
   for (const statement of parsed.statements) {
-    if (!ts3.isVariableStatement(statement)) continue;
+    if (!ts4.isVariableStatement(statement)) continue;
     for (const declaration of statement.declarationList.declarations) {
-      if (!ts3.isIdentifier(declaration.name) || declaration.name.text !== componentName) continue;
+      if (!ts4.isIdentifier(declaration.name) || declaration.name.text !== componentName) continue;
       const initializer = declaration.initializer;
-      if (!initializer || !ts3.isArrowFunction(initializer)) continue;
-      const returned = ts3.isBlock(initializer.body) ? initializer.body.statements.find(ts3.isReturnStatement)?.expression : initializer.body;
+      if (!initializer || !ts4.isArrowFunction(initializer)) continue;
+      const returned = ts4.isBlock(initializer.body) ? initializer.body.statements.find(ts4.isReturnStatement)?.expression : initializer.body;
       if (!returned) continue;
       let expression = returned;
-      while (ts3.isParenthesizedExpression(expression)) expression = expression.expression;
-      if (ts3.isJsxElement(expression) || ts3.isJsxSelfClosingElement(expression) || ts3.isJsxFragment(expression)) {
+      while (ts4.isParenthesizedExpression(expression)) expression = expression.expression;
+      if (ts4.isJsxElement(expression) || ts4.isJsxSelfClosingElement(expression) || ts4.isJsxFragment(expression)) {
         return expression.getText(parsed);
       }
     }
@@ -7205,31 +7546,31 @@ function snippetComponentBody(source, componentName) {
   return source;
 }
 function statefulSnippetDeclaration(source, componentName) {
-  const parsed = ts3.createSourceFile("snippet.tsx", source, ts3.ScriptTarget.Latest, true, ts3.ScriptKind.TSX);
-  const isEsm = (statement2) => ts3.isImportDeclaration(statement2) || (ts3.isVariableStatement(statement2) || ts3.isFunctionDeclaration(statement2) || ts3.isClassDeclaration(statement2)) && !!ts3.getModifiers(statement2)?.some((modifier) => modifier.kind === ts3.SyntaxKind.ExportKeyword);
+  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);
   if (parsed.statements.length === 0 || !parsed.statements.every(isEsm)) return null;
-  const statement = parsed.statements.find((candidate) => ts3.isVariableStatement(candidate) && candidate.declarationList.declarations.length === 1 && ts3.isIdentifier(candidate.declarationList.declarations[0].name) && candidate.declarationList.declarations[0].name.text === componentName);
-  if (!statement || !ts3.isVariableStatement(statement)) 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 declaration = statement.declarationList.declarations[0];
-  if (!declaration.initializer || !ts3.isArrowFunction(declaration.initializer) || !ts3.isBlock(declaration.initializer.body)) return null;
+  if (!declaration.initializer || !ts4.isArrowFunction(declaration.initializer) || !ts4.isBlock(declaration.initializer.body)) return null;
   const body = declaration.initializer.body.statements;
-  if (body.length < 2 || !body.some(ts3.isReturnStatement)) return null;
+  if (body.length < 2 || !body.some(ts4.isReturnStatement)) return null;
   return source.trim();
 }
 function staticNamedSnippetValues(source) {
   const values = /* @__PURE__ */ new Map();
-  const parsed = ts3.createSourceFile("snippet.tsx", source, ts3.ScriptTarget.Latest, true, ts3.ScriptKind.TSX);
+  const parsed = ts4.createSourceFile("snippet.tsx", source, ts4.ScriptTarget.Latest, true, ts4.ScriptKind.TSX);
   for (const statement of parsed.statements) {
-    if (!ts3.isVariableStatement(statement) || !statement.modifiers?.some((modifier) => modifier.kind === ts3.SyntaxKind.ExportKeyword)) continue;
+    if (!ts4.isVariableStatement(statement) || !statement.modifiers?.some((modifier) => modifier.kind === ts4.SyntaxKind.ExportKeyword)) continue;
     for (const declaration of statement.declarationList.declarations) {
-      if (!ts3.isIdentifier(declaration.name) || !declaration.initializer) continue;
+      if (!ts4.isIdentifier(declaration.name) || !declaration.initializer) continue;
       const expression = declaration.initializer;
-      if (ts3.isStringLiteral(expression) || ts3.isNoSubstitutionTemplateLiteral(expression)) {
+      if (ts4.isStringLiteral(expression) || ts4.isNoSubstitutionTemplateLiteral(expression)) {
         values.set(declaration.name.text, JSON.stringify(expression.text));
-      } else if (ts3.isNumericLiteral(expression)) {
+      } else if (ts4.isNumericLiteral(expression)) {
         values.set(declaration.name.text, expression.text);
-      } else if (expression.kind === ts3.SyntaxKind.TrueKeyword || expression.kind === ts3.SyntaxKind.FalseKeyword) {
-        values.set(declaration.name.text, expression.kind === ts3.SyntaxKind.TrueKeyword ? "true" : "false");
+      } else if (expression.kind === ts4.SyntaxKind.TrueKeyword || expression.kind === ts4.SyntaxKind.FalseKeyword) {
+        values.set(declaration.name.text, expression.kind === ts4.SyntaxKind.TrueKeyword ? "true" : "false");
       }
     }
   }
@@ -7368,11 +7709,12 @@ 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] } : null;
+      return match ? { index, text: match[1].replace(/\s*\{\/\*\s*#\S+?\s*\*\/\}$/, "") } : null;
     }).filter((entry) => entry !== null);
     const existing = /* @__PURE__ */ new Set();
     replaceOutsideCode(page.body, (text2) => {
       for (const match of text2.matchAll(/\bid=(?:"([^"]+)"|'([^']+)')/g)) existing.add(match[1] ?? match[2]);
+      for (const match of text2.matchAll(/\{\/\*\s*#(\S+?)\s*\*\/\}/g)) existing.add(match[1]);
       return text2;
     });
     const candidateIndexes = /* @__PURE__ */ new Map();
@@ -7515,7 +7857,11 @@ function repositoryAssetHref(value, currentFile, siteRoot, onReferenced) {
   }
   if (!ASSET_EXTENSIONS.has(extname6(decodedPath).toLowerCase())) return null;
   try {
-    const candidate = decodedPath.startsWith("/") ? resolveWithin(siteRoot, decodedPath.replace(/^\/+/, "")) : resolveWithinRoot(dirname4(currentFile), decodedPath, siteRoot);
+    let candidate = decodedPath.startsWith("/") ? resolveWithin(siteRoot, decodedPath.replace(/^\/+/, "")) : resolveWithinRoot(dirname4(currentFile), decodedPath, siteRoot);
+    if (!decodedPath.startsWith("/") && !existsSync5(candidate)) {
+      const fromRoot = resolveWithin(siteRoot, decodedPath.replace(/^(?:\.\/)+/, ""));
+      if (existsSync5(fromRoot)) candidate = fromRoot;
+    }
     const realRoot = realpathSync2(siteRoot);
     const realCandidate = realpathSync2(candidate);
     const realRelative = relative5(realRoot, realCandidate);
@@ -7556,6 +7902,19 @@ function rewriteRepositoryAssetLinks(body, currentFile, siteRoot, onReferenced)
   });
 }
 var LOCAL_EXPORT_DECLARATION = /^\s*export\s+(?:const|let|var|function|class|async\s+function)\s+([A-Za-z_$][\w$]*)/;
+function replaceOutsideMdxComments(body, transform) {
+  const comment = /\{\/\*[\s\S]*?\*\/\}/g;
+  let cursor = 0;
+  let output = "";
+  for (const match of body.matchAll(comment)) {
+    output += transform(body.slice(cursor, match.index)) + match[0];
+    cursor = match.index + match[0].length;
+  }
+  return output + transform(body.slice(cursor));
+}
+function replaceOutsideCodeAndMdxComments(body, transform) {
+  return replaceOutsideCode(body, (segment) => replaceOutsideMdxComments(segment, transform));
+}
 function locallyDeclaredNames(raw) {
   const names = /* @__PURE__ */ new Set();
   let codeFence = null;
@@ -7601,7 +7960,7 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
     });
     return `{/* ${verdict.kind === "oversized" ? "Oversized" : "Unreadable"} content not inlined: ${shown} */}`;
   };
-  let withoutImports = replaceOutsideCode(raw, (source2) => source2.replace(
+  let withoutImports = replaceOutsideCodeAndMdxComments(raw, (source2) => source2.replace(
     SNIPPET_IMPORT_PATTERN,
     (_statement, namedComponent, defaultComponent, sourcePath) => {
       const componentName = namedComponent ?? defaultComponent;
@@ -7628,6 +7987,12 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
         else snippets.set(componentName, snippetComponentBody(nested, componentName));
         return "";
       } catch {
+        let hasLiveUsage = false;
+        replaceOutsideCodeAndMdxComments(raw, (segment) => {
+          if (new RegExp(`<${componentName}(?:\\s|/?>)`).test(segment)) hasLiveUsage = true;
+          return segment;
+        });
+        if (!hasLiveUsage) return "";
         warnings.push({
           code: "missing-page",
           message: `Imported snippet ${sourcePath} could not be resolved and was left as a comment.`,
@@ -7638,7 +8003,7 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
       }
     }
   ));
-  withoutImports = replaceOutsideCode(withoutImports, (source2) => source2.replace(
+  withoutImports = replaceOutsideCodeAndMdxComments(withoutImports, (source2) => source2.replace(
     SNIPPET_VALUE_IMPORT_PATTERN,
     (statement, names, sourcePath) => {
       const bindings = names.split(",").map((name) => name.trim()).filter(Boolean).map((name) => {
@@ -7682,7 +8047,12 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
   ));
   const localNames = locallyDeclaredNames(withoutImports);
   for (const [componentName, candidate] of globalAliases) {
-    if (snippets.has(componentName) || localNames.has(componentName) || gate?.(candidate)?.kind === "gated" || !new RegExp(`<${componentName}(?:\\s|/?>)`).test(withoutImports)) continue;
+    let hasLiveUsage = false;
+    replaceOutsideCodeAndMdxComments(withoutImports, (source2) => {
+      if (new RegExp(`<${componentName}(?:\\s|/?>)`).test(source2)) hasLiveUsage = true;
+      return source2;
+    });
+    if (snippets.has(componentName) || localNames.has(componentName) || gate?.(candidate)?.kind === "gated" || !hasLiveUsage) continue;
     const blocked = blockInline(candidate, relative5(repositoryRoot, candidate).replace(/\\/g, "/"));
     if (blocked) {
       snippets.set(componentName, blocked);
@@ -7705,9 +8075,9 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
   let result = replaceOutsideCodeAndComments(withoutImports, (segment) => {
     for (const [componentName, snippet] of snippets) {
       segment = segment.replace(new RegExp(`<${componentName}((?:\\s[^>]*)?)\\s*/>`, "g"), (tag, attributes, offset, source2) => {
-        return isolateFences(interpolateSnippet(snippet, attributes), source2, offset, offset + tag.length);
+        return isolateFences(closeOpenCodeFence(interpolateSnippet(snippet, attributes)), source2, offset, offset + tag.length);
       }).replace(new RegExp(`<${componentName}((?:\\s[^>]*)?)>([\\s\\S]*?)<\\/${componentName}>`, "g"), (tag, attributes, children, offset, source2) => {
-        return isolateFences(interpolateSnippet(snippet, attributes, children), source2, offset, offset + tag.length);
+        return isolateFences(closeOpenCodeFence(interpolateSnippet(snippet, attributes, children)), source2, offset, offset + tag.length);
       });
     }
     return segment.replace(SNIPPET_TAG_PATTERN, (tag, doubleQuoted, singleQuoted, offset, source2) => {
@@ -7726,7 +8096,7 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
         if (!candidate) throw new Error("file not found");
         const blocked = blockInline(candidate, filePath, `Snippet file="${filePath}"`);
         if (blocked) return blocked;
-        return isolateFences(inlineMdxSnippets(
+        return isolateFences(closeOpenCodeFence(inlineMdxSnippets(
           withoutFrontmatter(readFileSync5(candidate, "utf8")),
           candidate,
           repositoryRoot,
@@ -7735,7 +8105,7 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
           siteRoot,
           globalAliases,
           gate
-        ), source2, offset, offset + tag.length);
+        )), source2, offset, offset + tag.length);
       } catch {
         warnings.push({
           code: "missing-page",
@@ -7940,7 +8310,7 @@ function migrateRepository(options) {
   const sourceBudget = options.maxSourceFiles ?? MAX_SOURCE_FILES;
   const scannedFiles = scanFiles(contentRoot, repositoryDir, warnings, discoveryRank, sourceBudget);
   const mintignoreFilteredFiles = mintignoreMatcher ? scannedFiles.filter((file) => !mintignoreMatcher.ignores(file.relativePath)) : scannedFiles;
-  const discoveryBudgetApplied = discoveryRank !== void 0 && mintignoreFilteredFiles.length > sourceBudget;
+  const isUnreferencedSnippetModule = (file) => file.relativePath.split("/").some((segment) => SNIPPET_DIRECTORIES.has(segment.toLowerCase())) && isDocumentationExtension(file.relativePath) && !referenceOrder.has(normalizedReferenceKey(file.relativePath));
   const files = discoveryRank ? selectFilesWithinBudget(mintignoreFilteredFiles, discoveryRank, warnings, allVersionPrefixes, sourceBudget) : mintignoreFilteredFiles;
   if (platform === "fern" && fernProjectRoot) {
     const discovered2 = new Set(files.map((file) => file.relativePath));
@@ -8019,6 +8389,10 @@ function migrateRepository(options) {
     }
     for (const file of mintignoreFilteredFiles) {
       if (keptFiles.has(file) || !isDocFile(file)) continue;
+      if (isUnreferencedSnippetModule(file)) {
+        if (classifyPageGate(file).reason) withheldDocFiles.push(file);
+        continue;
+      }
       droppedPageCount++;
       if (!isGateCandidate(file)) {
         const snippetReason = classifyPageGate(file).reason;
@@ -8241,7 +8615,11 @@ function migrateRepository(options) {
     const publishedText = trackPublishedRefs ? raw : void 0;
     const pageAssetReferences = [];
     if (platform === "fern" || platform === "mintlify" || platform === "docusaurus") {
-      raw = normalizeExplicitHeadingIds(raw, (message) => warnings.push({ code: "invalid-page", message, source: file.relativePath }));
+      raw = normalizeExplicitHeadingIds(
+        raw,
+        (message) => warnings.push({ code: "invalid-page", message, source: file.relativePath }),
+        { headingMarkers: platform === "mintlify" }
+      );
     }
     if (componentMigrator) {
       const warningsBeforeTransform = warnings.length;
@@ -8253,13 +8631,7 @@ function migrateRepository(options) {
     }
     if (platform === "fern" || platform === "mintlify" || platform === "docusaurus") {
       const protectedMath = protectMathBlocks(raw);
-      if (protectedMath.converted) {
-        warnings.push({
-          code: "unsupported-config",
-          message: "Math (KaTeX '$$...$$') has no renderer in Thally yet; it was kept as a fenced code block instead of being dropped.",
-          source: relative5(repositoryDir, file.absolutePath).replace(/\\/g, "/")
-        });
-      } else if (protectedMath.guardTriggered) {
+      if (protectedMath.guardTriggered) {
         warnings.push({
           code: "unsupported-config",
           message: "A suspected math span looked like it needed converting, but doing so broke the page; the page was kept as originally authored instead.",
@@ -8351,7 +8723,7 @@ function migrateRepository(options) {
       page.body = replaceUnknownComponents(page.body, (name) => {
         warnings.push({
           code: "unsupported-config",
-          message: `Component <${name}> has no equivalent in Thally and wasn't found on this page; it was replaced with a plain <div> (or removed, if self-closing) so the page still builds. Add a matching component or edit the page.`,
+          message: `Unresolved MDX component <${name}> was replaced with a plain <div> (or removed, if self-closing) so the page still builds. It may be a site-authored or third-party implementation; review its source before adding a Thally equivalent.`,
           source: file.relativePath
         });
       });
@@ -8478,9 +8850,35 @@ function migrateRepository(options) {
     const source = /^src\/mdx\/migrated\/[^/]+\/source\/(.+)$/.exec(file.path)?.[1];
     return source ? [resolvePath(repositoryDir, source)] : [];
   }));
+  const rootStylesheetPath = platform === "mintlify" && mintlifyProjectRoot ? resolveWithin(mintlifyProjectRoot, "style.css") : void 0;
+  const hasRootStylesheet = Boolean(rootStylesheetPath && existsSync5(rootStylesheetPath) && lstatSync5(rootStylesheetPath).isFile() && !lstatSync5(rootStylesheetPath).isSymbolicLink());
+  let rootStyleProjection;
+  let rootNavbarButtons = [];
+  let rootStyleProblem;
+  if (hasRootStylesheet && rootStylesheetPath && lstatSync5(rootStylesheetPath).size <= MAX_ASSET_BYTES) {
+    const css = readFileSync5(rootStylesheetPath, "utf8");
+    if (/@import\b|url\s*\(\s*['"]?\s*(?:javascript:|file:)/i.test(css)) rootStyleProblem = "unsafe";
+    else {
+      try {
+        rootNavbarButtons = navbarLinkButtons(css);
+        rootStyleProjection = projectAuthoredStyles(css, [
+          ...pages.map((page) => page.body),
+          ...(componentMigrator?.files() ?? []).map((file) => typeof file.content === "string" ? file.content : ""),
+          // Site-wide scripts build markup of their own (a CTA card, say) that the stylesheet is meant for.
+          ...files.filter((file) => isMintlifyServedScriptOrStyle(file.relativePath) && extname6(file.relativePath).toLowerCase() === ".js" && lstatSync5(file.absolutePath).size <= MAX_PAGE_BYTES).map((file) => readFileSync5(file.absolutePath, "utf8"))
+        ]);
+      } catch {
+        rootStyleProblem = "parse";
+      }
+    }
+  }
+  if (trackPublishedRefs && rootStyleProjection?.css) {
+    addPathReferences(rootStyleProjection.css, "", publishedExact, publishedLoose);
+  }
   const siteAssetPaths = /* @__PURE__ */ new Map();
   const fontAssetByRelative = /* @__PURE__ */ new Map();
   for (const file of [...files, ...repositoryAssets, ...fernReferencedAssets]) {
+    if (rootStylesheetPath && file.absolutePath === rootStylesheetPath) continue;
     const firstSegment = file.relativePath.split("/", 1)[0].toLowerCase();
     const siteKind = platform !== "mintlify" ? void 0 : fontRelativePaths.has(file.relativePath) ? "font" : isMintlifyServedScriptOrStyle(file.relativePath) && !importedComponentSources.has(file.absolutePath) ? extname6(file.relativePath).toLowerCase() === ".css" ? "style" : "script" : void 0;
     if (!siteKind && !ASSET_EXTENSIONS.has(extname6(file.relativePath).toLowerCase())) continue;
@@ -8526,7 +8924,8 @@ function migrateRepository(options) {
   const lfsPointerAssets = [];
   const ambiguouslyNamedAssets = [];
   for (const { file, assetPath, size } of orderedAssetCandidates) {
-    if (size > MAX_ASSET_BYTES || totalAssetBytes + size > MAX_TOTAL_ASSET_BYTES) {
+    const individualLimit = referencedAssetPaths.has(assetPath) ? MAX_REFERENCED_ASSET_BYTES : MAX_ASSET_BYTES;
+    if (size > individualLimit || totalAssetBytes + size > MAX_TOTAL_ASSET_BYTES) {
       overBudgetAssets.push(file.relativePath);
       if (referencedAssetPaths.has(assetPath)) overBudgetReferenced++;
       continue;
@@ -8568,7 +8967,7 @@ function migrateRepository(options) {
     for (const entry of copiedSite.filter((item) => item.kind === "style")) {
       warnings.push({
         code: "unsupported-config",
-        message: `Migration gap: custom stylesheet ${entry.path} is NOT applied. It was copied to public/${entry.path} but no page loads it, Thally cannot load a stylesheet from docs.json, and Mintlify-specific selectors will not match Thally's markup. Port the styles you need by hand into src/app/globals.css.`,
+        message: `Migration gap: custom stylesheet ${entry.path} is NOT applied. It was copied to public/${entry.path} but was not declared in docs.json stylesheets; its selectors may target Mintlify's markup. Review and port its authored rules into a Thally stylesheet.`,
         source: entry.path
       });
     }
@@ -8586,7 +8985,7 @@ function migrateRepository(options) {
   if (overBudgetAssets.length > 0) {
     warnings.push({
       code: "limit-reached",
-      message: `${overBudgetAssets.length} asset file${overBudgetAssets.length === 1 ? " was" : "s were"} not copied because files over ${MAX_ASSET_BYTES / 1e6} MB, or beyond ${MAX_TOTAL_ASSET_BYTES / 1e6} MB in total, are skipped: ${listAssetPaths(overBudgetAssets)}. ` + (overBudgetReferenced > 0 ? `${overBudgetReferenced} of them ${overBudgetReferenced === 1 ? "is" : "are"} used by pages, so those images will be broken until you copy ${overBudgetAssets.length === 1 ? "it" : "them"}. ` : "") + `Copy ${overBudgetAssets.length === 1 ? "it" : "them"} into public/ manually.`
+      message: `${overBudgetAssets.length} asset file${overBudgetAssets.length === 1 ? " was" : "s were"} not copied because unreferenced files over ${MAX_ASSET_BYTES / 1e6} MB, referenced files over ${MAX_REFERENCED_ASSET_BYTES / 1e6} MB, or files beyond ${MAX_TOTAL_ASSET_BYTES / 1e6} MB in total, are skipped: ${listAssetPaths(overBudgetAssets)}. ` + (overBudgetReferenced > 0 ? `${overBudgetReferenced} of them ${overBudgetReferenced === 1 ? "is" : "are"} used by pages, so those images will be broken until you copy ${overBudgetAssets.length === 1 ? "it" : "them"}. ` : "") + `Copy ${overBudgetAssets.length === 1 ? "it" : "them"} into public/ manually.`
     });
   }
   if (lfsPointerAssets.length > 0) {
@@ -8595,7 +8994,43 @@ function migrateRepository(options) {
       message: `${lfsPointerAssets.length} asset file${lfsPointerAssets.length === 1 ? " is a Git LFS pointer" : "s are Git LFS pointers"}, not real content, and ${lfsPointerAssets.length === 1 ? "was" : "were"} not copied (Git LFS was skipped during clone because the host has no git-lfs binary): ${listAssetPaths(lfsPointerAssets)}. Install git-lfs and re-run the migration, or copy the real files into public/ manually.`
     });
   }
-  if (!discoveryBudgetApplied && files.length >= sourceBudget) {
+  if (hasRootStylesheet && rootStylesheetPath && mintlifyProjectRoot) {
+    const size = lstatSync5(rootStylesheetPath).size;
+    if (size > MAX_ASSET_BYTES || totalAssetBytes + size > MAX_TOTAL_ASSET_BYTES) {
+      warnings.push({ code: "limit-reached", message: "Mintlify root style.css exceeded the asset budget and was not imported.", source: "style.css" });
+    } else if (rootStyleProblem === "unsafe") {
+      warnings.push({ code: "unsupported-config", message: "Mintlify root style.css contains a CSS import or unsafe URL; review and import it manually.", source: "style.css" });
+    } else if (rootStyleProblem === "parse" || !rootStyleProjection) {
+      warnings.push({ code: "unsupported-config", message: "Mintlify root style.css could not be parsed and was not imported.", source: "style.css" });
+    } else {
+      if (rootNavbarButtons.length > 0 && docsConfig.navbar?.links) {
+        docsConfig = {
+          ...docsConfig,
+          navbar: {
+            ...docsConfig.navbar,
+            links: docsConfig.navbar.links.map((link) => {
+              const rule = rootNavbarButtons.find((entry) => entry.exact ? link.href === entry.href : link.href.includes(entry.href));
+              return rule ? { ...link, button: { background: rule.background, ...rule.color ? { color: rule.color } : {} } } : link;
+            })
+          }
+        };
+      }
+      if (rootStyleProjection.omittedSelectors > 0) warnings.push({
+        code: "unsupported-config",
+        source: "style.css",
+        message: `Skipped ${rootStyleProjection.omittedSelectors} stylesheet selector${rootStyleProjection.omittedSelectors === 1 ? "" : "s"} that target platform-owned or unreferenced markup. Recreate any intentional shell customization with Thally configuration.`
+      });
+      if (rootStyleProjection.css.trim()) {
+        const identity = createHash2("sha256").update(componentSourceIdentity(options.sourceUrl, repositoryDir, mintlifyProjectRoot)).digest("hex").slice(0, 12);
+        const assetPath = `migrated/${identity}/style.css`;
+        const content = Buffer.from(rootStyleProjection.css);
+        assets.push({ path: assetPath, content });
+        docsConfig = { ...docsConfig, stylesheets: [...docsConfig.stylesheets ?? [], `/${assetPath}`] };
+        totalAssetBytes += content.length;
+      }
+    }
+  }
+  if (!discoveryRank && files.length >= sourceBudget) {
     warnings.push({ code: "limit-reached", message: `Stopped scanning after ${sourceBudget} files, so the rest of the repository was not looked at. Run the migration on a smaller part of the repository with --docs-dir.` });
   }
   if (platform === "docusaurus") {
@@ -8730,7 +9165,9 @@ function migrateRepository(options) {
         source: path
       });
     };
-    const resolvedSpecs = resolveMintlifyApiSpecs(mintlifyConfig, files, warnings, remoteApiSpecs);
+    const allSpecs = resolveMintlifyApiSpecs(mintlifyConfig, files, warnings, remoteApiSpecs, pages);
+    const resolvedSpecs = allSpecs.filter((spec) => !spec.pageOnly);
+    const pageOnlySpecs = allSpecs.filter((spec) => spec.pageOnly);
     for (const spec of resolvedSpecs) {
       if (!assets.some((asset) => asset.path === specAssetPath(spec.filename))) {
         assets.push(specAsset(spec.filename, spec.content));
@@ -8763,6 +9200,14 @@ function migrateRepository(options) {
         }
       }
     }
+    for (const spec of pageOnlySpecs) {
+      if (!assets.some((asset) => asset.path === specAssetPath(spec.filename))) assets.push(specAsset(spec.filename, spec.content));
+      if (withheldSpecRefs.some((ref) => specRefMatches(ref, spec.sourcePath, spec.filename, true))) warnSharedSpec(spec.sourcePath);
+    }
+    if (pageOnlySpecs.length > 0) {
+      docsConfig = injectOpenApiSpecs(docsConfig, pageOnlySpecs, warnings);
+      pageSpecs = [...pageSpecs, ...pageOnlySpecs];
+    }
     rewriteMintlifyPageSpecRefs(pages, pageSpecs, new Set(remoteApiSpecs.map((spec) => spec.url)), warnings);
   }
   if (platform === "mintlify") {
@@ -9178,6 +9623,8 @@ function renderPage(bundle, page) {
     "---",
     `title: ${yamlString(page.title)}`,
     page.navTitle ? `navTitle: ${yamlString(page.navTitle)}` : null,
+    page.icon ? `icon: ${yamlString(page.icon)}` : null,
+    page.iconType ? `iconType: ${yamlString(page.iconType)}` : null,
     `description: ${yamlString(page.description)}`,
     page.descriptionPlacement === "body" ? "descriptionPlacement: body" : null,
     page.badge ? `badge: ${yamlString(page.badge)}` : null,
@@ -9185,9 +9632,11 @@ function renderPage(bundle, page) {
     page.mode ? `mode: ${yamlString(page.mode)}` : null,
     page.hidden ? "hidden: true" : null,
     page.noindex ? "noindex: true" : null,
+    ...Object.entries(page.meta ?? {}).map(([field, value]) => `${field}: ${yamlString(value)}`),
     page.openapi ? `openapi: ${yamlString(page.openapi)}` : null,
     page.api ? `api: ${yamlString(page.api)}` : null,
     page.authMethod ? `authMethod: ${yamlString(page.authMethod)}` : null,
+    page.playground ? `playground: ${yamlString(page.playground)}` : null,
     bundle.sourceKind === "url" ? `source: ${yamlString(page.source)}` : null,
     "---",
     "",
@@ -9268,6 +9717,7 @@ function mergeMigrationConfig(existing, incoming) {
     // Collection presentation belongs to the imported information
     // architecture; starter defaults must not coerce source dropdowns to tabs.
     navigation: incoming.navigation ?? existing.navigation,
+    ...existing.stylesheets?.length || incoming.stylesheets?.length ? { stylesheets: [.../* @__PURE__ */ new Set([...existing.stylesheets ?? [], ...incoming.stylesheets ?? []])] } : {},
     ...i18n ? { i18n } : {},
     // Existing providers win per provider; imported ones fill the gaps.
     // A malformed (string/array) existing value must not spread into index keys.
@@ -9614,7 +10064,7 @@ function embeddedMintlifyConfig(body) {
 function plainDescription(value) {
   return value.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/[`*_>#-]/g, "").replace(/\s+/g, " ").trim().slice(0, 240);
 }
-function withoutFencedCode(body) {
+function withoutFencedCode2(body) {
   let fenceCharacter = "";
   let fenceLength = 0;
   return body.split("\n").map((line) => {
@@ -9924,7 +10374,7 @@ function sanitizeRemoteMarkdown(body) {
   }).join("\n");
   const urlSafeMarkdown = sanitizeMarkdownUrls(sanitized);
   if (urlSafeMarkdown === null) return null;
-  const executable = withoutFencedCode(urlSafeMarkdown).replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<(?:https?:\/\/|mailto:)[^>]+>/gi, "").replace(/(`+)[\s\S]*?\1/g, "");
+  const executable = withoutFencedCode2(urlSafeMarkdown).replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<(?:https?:\/\/|mailto:)[^>]+>/gi, "").replace(/(`+)[\s\S]*?\1/g, "");
   if (/^\s*(?:import|export)\s/m.test(executable)) return null;
   let hasUnsafeExpression = false;
   const withoutStaticProps = executable.replace(/=\{([^{}\n]*)\}/g, (original, value) => {
@@ -10874,7 +11324,7 @@ async function migrateUrl(options) {
 }
 
 // src/remote-api.ts
-import { createHash as createHash2 } from "crypto";
+import { createHash as createHash3 } from "crypto";
 import { lookup } from "dns/promises";
 import { request } from "https";
 import { isIP } from "net";
@@ -11034,7 +11484,7 @@ async function hydrateRemoteApiSpecs(bundle, fetcher) {
       const extension = /\.ya?ml$/i.test(url.pathname) ? "yaml" : "json";
       const body = await downloadSpec(reference.url, fetcher);
       const operations = parseOpenApi(body, extension);
-      const filename = `openapi-${createHash2("sha256").update(reference.url).digest("hex").slice(0, 12)}.${extension}`;
+      const filename = `openapi-${createHash3("sha256").update(reference.url).digest("hex").slice(0, 12)}.${extension}`;
       assets.push({ path: `openapi/${filename}`, content: body, projectRelative: true });
       for (const page of pages) {
         const ref = page.openapi ? splitOpenApiRef(page.openapi) : null;