@thallylabs/migrate 0.2.47 → 0.2.48

package/dist/index.js

@@ -419,7 +419,7 @@ function analyzeUnit(index, source, reactGlobals) {
   const statement = sf.statements[0];
   const blockers = [];
   if (!statement || sf.statements.length !== 1) {
-    return { index, source, names: [], refs: [], assigned: [], hooks: false, clientOnly: false, componentLike: false, blockers: ["is not a single declaration"] };
+    return { index, source, names: [], refs: [], assigned: [], hooks: false, clientOnly: false, handlers: false, componentLike: false, blockers: ["is not a single declaration"] };
   }
   const { names, componentLike, defaultExport } = declaredNames(statement);
   if (defaultExport) blockers.push("is a default export");
@@ -447,6 +447,7 @@ function analyzeUnit(index, source, reactGlobals) {
     assigned,
     hooks: refs.some(({ name }) => reactGlobals.has(name)) || /\bReact\.(?:use[A-Z]\w*|createContext|forwardRef|memo)\b/.test(source),
     clientOnly: handlers || refs.some(({ name }) => BROWSER_IDENTIFIERS.has(name)),
+    handlers,
     componentLike,
     blockers: [...new Set(blockers)]
   };
@@ -462,9 +463,9 @@ function importLocals(statementText) {
     if (!ts.isImportDeclaration(statement) || !statement.importClause) continue;
     const clause = statement.importClause;
     if (clause.name) locals.push(clause.name.text);
-    const named = clause.namedBindings;
-    if (named && ts.isNamespaceImport(named)) locals.push(named.name.text);
-    if (named && ts.isNamedImports(named)) for (const element of named.elements) locals.push(element.name.text);
+    const named2 = clause.namedBindings;
+    if (named2 && ts.isNamespaceImport(named2)) locals.push(named2.name.text);
+    if (named2 && ts.isNamedImports(named2)) for (const element of named2.elements) locals.push(element.name.text);
   }
   return locals;
 }
@@ -497,6 +498,38 @@ function bodyReferences(tree) {
   visit(tree);
   return { mdastTags, refs };
 }
+function gateOnMount(source, helper) {
+  const sf = parse(source);
+  const [statement] = sf.statements;
+  if (sf.statements.length !== 1) return void 0;
+  if (ts.isVariableStatement(statement)) {
+    const [declaration, ...others] = statement.declarationList.declarations;
+    const value = declaration.initializer && unwrap(declaration.initializer);
+    if (others.length > 0 || !ts.isIdentifier(declaration.name) || !declaration.initializer || !value || !(ts.isArrowFunction(value) || ts.isFunctionExpression(value))) return void 0;
+    const start = declaration.initializer.getStart(sf);
+    return `${source.slice(0, start)}${helper}(${source.slice(start, declaration.initializer.end)})${source.slice(declaration.initializer.end)}`;
+  }
+  if (ts.isFunctionDeclaration(statement) && statement.name && statement.body && !statement.asteriskToken) {
+    const start = statement.getStart(sf);
+    const header = /^(export\s+)?function\b/.exec(source.slice(start));
+    if (!header) return void 0;
+    const keyword = start + (header[1]?.length ?? 0);
+    return `${source.slice(0, keyword)}const ${statement.name.text} = ${helper}(${source.slice(keyword, statement.end)});${source.slice(statement.end)}`;
+  }
+  return void 0;
+}
+function mountGateHelper(name) {
+  return [
+    "// Renders nothing on the server or on the first client render, so a component that reads a browser global never disagrees with the server HTML.",
+    `function ${name}(Component) {`,
+    "  return function AfterMount(props) {",
+    "    const [mounted, setMounted] = useState(false)",
+    "    useEffect(() => { setMounted(true) }, [])",
+    "    return mounted ? <Component {...props} /> : null",
+    "  }",
+    "}"
+  ].join("\n");
+}
 function planInlineExtraction(input) {
   const units = input.declarations.map((declaration, index) => analyzeUnit(index, declaration.source, input.reactGlobals));
   const owner = /* @__PURE__ */ new Map();
@@ -550,12 +583,17 @@ function planInlineExtraction(input) {
     }
     return void 0;
   };
-  const roots = units.filter((unit) => unit.hooks && unit.names.some((name) => /^[A-Z]/.test(name))).map((unit) => unit.index);
+  const readsBrowserGlobal = (unit) => unit.componentLike && !unit.hooks && !unit.handlers && unit.refs.some(({ name, kind }) => BROWSER_IDENTIFIERS.has(name) && kind !== "tag" && kind !== "member" && !owner.has(name) && !importByLocal.has(name) && !helperByName.has(name)) && gateOnMount(unit.source, "gate") !== void 0;
+  const roots = units.filter((unit) => (unit.hooks || readsBrowserGlobal(unit)) && unit.names.some((name) => /^[A-Z]/.test(name))).map((unit) => unit.index);
   const blocked = [];
   const active = new Set(roots);
   const block = (rootIndex, reason) => {
     active.delete(rootIndex);
-    blocked.push({ name: units[rootIndex].names.find((name) => /^[A-Z]/.test(name)) ?? units[rootIndex].names[0], reason });
+    blocked.push({
+      name: units[rootIndex].names.find((name) => /^[A-Z]/.test(name)) ?? units[rootIndex].names[0],
+      reason,
+      browser: readsBrowserGlobal(units[rootIndex])
+    });
   };
   for (const rootIndex of roots) {
     for (const member of closureOf(rootIndex)) {
@@ -644,6 +682,7 @@ function planInlineExtraction(input) {
       continue;
     }
     const movedNames = [...moved].flatMap((index) => units[index].names);
+    const gated = [...moved].filter((index) => readsBrowserGlobal(units[index])).sort((a, b) => a - b);
     const registryNames = movedNames.filter((name) => body.mdastTags.has(name));
     const importNames = movedNames.filter((name) => pageRefs.some((ref) => ref.name === name));
     const moduleMembers = [...inModule].sort((a, b) => a - b);
@@ -666,6 +705,7 @@ function planInlineExtraction(input) {
       blocked,
       moved: [...moved].sort((a, b) => a - b),
       copied: [...kept].sort((a, b) => a - b),
+      gated,
       movedNames,
       moduleImports: usedImports,
       moduleHelpers: usedHelpers,
@@ -675,7 +715,7 @@ function planInlineExtraction(input) {
       pageReferences
     };
   }
-  return { blocked, moved: [], copied: [], movedNames: [], moduleImports: [], moduleHelpers: [], registryNames: [], pageImportNames: [], moduleNames: /* @__PURE__ */ new Set(), pageReferences: /* @__PURE__ */ new Set() };
+  return { blocked, moved: [], copied: [], gated: [], movedNames: [], moduleImports: [], moduleHelpers: [], registryNames: [], pageImportNames: [], moduleNames: /* @__PURE__ */ new Set(), pageReferences: /* @__PURE__ */ new Set() };
 }
 function unboundTags(moduleSource, boundNames) {
   const sf = parse(moduleSource);
@@ -801,6 +841,7 @@ import { existsSync, lstatSync, readFileSync } from "fs";
 import { basename, dirname, extname as extname2, posix as posix2, relative as relative2, resolve as resolve2 } from "path";
 import postcss2 from "postcss";
 import selectorParser2 from "postcss-selector-parser";
+import remarkGfm2 from "remark-gfm";
 import remarkMdx2 from "remark-mdx";
 import remarkParse3 from "remark-parse";
 import ts3 from "typescript";
@@ -822,6 +863,50 @@ function salvageFrontmatterLines(matter) {
   }
   return data;
 }
+var KEY_LINE = /^[A-Za-z_][\w-]*:(?:\s|$)/;
+var QUOTED_KEY_LINE = /^[A-Za-z_][\w-]*:[ \t]*(["'])/;
+function closingQuote(line, from, quote) {
+  for (let index = from; index < line.length; index++) {
+    if (quote === '"' && line[index] === "\\") index++;
+    else if (line[index] === quote) {
+      if (quote === "'" && line[index + 1] === "'") index++;
+      else return index;
+    }
+  }
+  return -1;
+}
+function foldQuotedLineBreaks(matter) {
+  const lines = matter.split(/\r?\n/);
+  const folded = [];
+  let changed = false;
+  for (let start = 0; start < lines.length; start++) {
+    const opening = QUOTED_KEY_LINE.exec(lines[start]);
+    if (!opening || closingQuote(lines[start], opening[0].length, opening[1]) !== -1) {
+      folded.push(lines[start]);
+      continue;
+    }
+    const quote = opening[1];
+    let value = lines[start].slice(opening[0].length).trimEnd();
+    let end = start + 1;
+    for (; end < lines.length; end++) {
+      const line = lines[end];
+      if (line.trim() === "" || KEY_LINE.test(line)) return void 0;
+      const close = closingQuote(line, 0, quote);
+      if (close === -1) {
+        value += ` ${line.trim()}`;
+        continue;
+      }
+      if (!/^\s*(?:#.*)?$/.test(line.slice(close + 1))) return void 0;
+      value += ` ${line.slice(0, close).trimStart()}`;
+      break;
+    }
+    if (end === lines.length) return void 0;
+    folded.push(`${lines[start].slice(0, opening[0].length - 1)}${quote}${value}${quote}`);
+    changed = true;
+    start = end;
+  }
+  return changed ? folded.join("\n") : void 0;
+}
 function parseFrontmatter(raw) {
   const source = raw.charCodeAt(0) === 65279 ? raw.slice(1) : raw;
   const opening = /^---([^\r\n]*)\r?\n/.exec(source);
@@ -843,6 +928,14 @@ function parseFrontmatter(raw) {
       data: parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {}
     };
   } catch (err) {
+    const foldedMatter = foldQuotedLineBreaks(matter);
+    if (foldedMatter !== void 0) {
+      try {
+        const parsed = parseYaml(foldedMatter);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return { content, data: parsed };
+      } catch {
+      }
+    }
     return {
       content,
       data: salvageFrontmatterLines(matter),
@@ -1402,13 +1495,13 @@ function projectAuthoredStyles(css, contents, modules, namespace) {
   });
   const definitionsNamed = /* @__PURE__ */ new Map();
   for (const rule of definitions) pushTo(definitionsNamed, rule.params.trim().toLowerCase(), rule);
-  const named = /* @__PURE__ */ new Set();
+  const named2 = /* @__PURE__ */ new Set();
   const unread = [];
   const nameWords = (decl) => {
     for (const [word] of decl.value.matchAll(/[^\s,()"']+/g)) {
       const name = word.toLowerCase();
-      if (!named.has(name)) {
-        named.add(name);
+      if (!named2.has(name)) {
+        named2.add(name);
         unread.push(name);
       }
     }
@@ -1424,7 +1517,7 @@ function projectAuthoredStyles(css, contents, modules, namespace) {
     const name = rule.name.toLowerCase();
     if (name === "font-face") return;
     if (definitions.has(rule)) {
-      if (named.has(rule.params.trim().toLowerCase())) return;
+      if (named2.has(rule.params.trim().toLowerCase())) return;
       omittedAtRules.push(describe(rule));
       rule.remove();
       return;
@@ -1549,6 +1642,7 @@ function normalizeMintlifyCodeFences(body, warn) {
 }
 
 // src/mdx.ts
+var MDX_COMPILE_OPTIONS = { outputFormat: "program", remarkPlugins: [remarkGfm] };
 function titleFromId(id) {
   const value = id.split("/").at(-1) ?? id;
   if (value === "introduction") return "Introduction";
@@ -1830,6 +1924,7 @@ function mintlifyHeadingSlug(text4) {
   let id = "";
   let afterDash = false;
   let endsWithDash = false;
+  let softDash = false;
   chars.forEach((char, index) => {
     const before = chars[index - 1];
     const after = chars[index + 1];
@@ -1837,7 +1932,9 @@ function mintlifyHeadingSlug(text4) {
     if (isWord(char)) {
       id += char;
       afterDash = false;
+      softDash = false;
     } else if (/[\s-]/.test(char) || char === "." && (isWord(after) || after === ",") || char === "(" && isWord(before) && (isWord(after) || after === "{") || char === ")" && after !== void 0 && !/\s/.test(after)) {
+      softDash = /[\s-]/.test(char) ? false : id !== "" && !afterDash || softDash;
       if (id && !afterDash) id += "-";
       afterDash = true;
       endsWithDash = true;
@@ -1845,24 +1942,28 @@ function mintlifyHeadingSlug(text4) {
       afterDash = false;
     }
   });
-  return endsWithDash ? id.replace(/-$/, "") : id;
+  return endsWithDash || softDash ? id.replace(/-$/, "") : id;
 }
 function thallyHeadingSlug(text4) {
   return text4.normalize("NFC").toLowerCase().replace(/[^\p{L}\p{M}\p{N}]+/gu, "-").replace(/(^-|-$)/g, "");
 }
+var LINK_DESTINATION = String.raw`\]\((?:[^()]|\([^()]*\))*\)`;
+var TYPESET_PROTECTED = new RegExp(`(\`[^\`]*\`|<[^>]*>|${LINK_DESTINATION})`);
 function typesetQuotes(text4) {
   const opensClosed = text4.startsWith('"') && !text4.trimEnd().endsWith('"');
-  return text4.split(/(`[^`]*`|<[^>]*>|\]\([^)]*\))/).map((part, index) => {
+  return text4.split(TYPESET_PROTECTED).map((part, index) => {
     if (index % 2) return part;
     return part.replace(/(^|[\s([{\u2014\u2013])"/g, (match, before) => opensClosed && index === 0 && before === "" ? match : `${before}\u201C`).replace(/"/g, "\u201D").replace(/(^|[\s([{\u2014\u2013\u201c])'(?=\S)(?!&lt;|<)/g, "$1\u2018").replace(/'/g, "\u2019");
   }).join("");
 }
 function typesetEllipses(text4) {
-  return text4.split(/(`[^`]*`|<[^>]*>|\]\([^)]*\))/).map((part, index) => index % 2 ? part : part.replace(/\.{3}/g, "\u2026")).join("");
+  return text4.split(TYPESET_PROTECTED).map((part, index) => index % 2 ? part : part.replace(/\.{3}/g, "\u2026")).join("");
 }
+var LINK_HOLDING_CODE = new RegExp(`(\`[^\`]*\`)|!?\\[((?:\`[^\`]*\`|[^\\]\`])*)${LINK_DESTINATION}`, "g");
+var PLAIN_LINK = new RegExp(`!?\\[([^\\]]*)${LINK_DESTINATION}`, "g");
 function plainHeadingText(source) {
-  const unlinked = !source.includes("`") ? source : source.replace(/(`[^`]*`)|!?\[((?:`[^`]*`|[^\]`])*)\]\([^)]*\)/g, (_match, code, text4 = "") => code ?? text4);
-  return unlinked.split(/(`[^`]*`)/).map((part, index) => index % 2 ? part.slice(1, -1) : part.replace(/\{\/\*[\s\S]*?\*\/\}/g, " ").replace(/!?\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/<\/?[A-Za-z][^>]*>/g, "").replace(/(?<!\\)(\*\*|__|~~|\*)/g, "").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/\\([\\`*_{}[\]()#+.!&<>|~-])/g, "$1")).join("");
+  const unlinked = !source.includes("`") ? source : source.replace(LINK_HOLDING_CODE, (_match, code, text4 = "") => code ?? text4);
+  return unlinked.split(/(`[^`]*`)/).map((part, index) => index % 2 ? part.slice(1, -1) : part.replace(/\{\/\*[\s\S]*?\*\/\}/g, " ").replace(PLAIN_LINK, "$1").replace(/<\/?[A-Za-z][^>]*>/g, "").replace(/(?<!\\)(\*\*|__|~~|\*)/g, "").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/\\([\\`*_{}[\]()#+.!&<>|~-])/g, "$1")).join("");
 }
 function staticAttributeString(value) {
   if (typeof value === "string") return value;
@@ -1992,8 +2093,8 @@ function foldStatic(node, literals) {
     }
     case "Identifier":
     case "MemberExpression": {
-      const bound = literals.get(`${node.start}:${node.end}`);
-      return bound === void 0 ? void 0 : { value: bound };
+      const span = `${node.start}:${node.end}`;
+      return literals.has(span) ? { value: literals.get(span) } : void 0;
     }
     case "JSXElement":
     case "JSXFragment":
@@ -2032,8 +2133,8 @@ function foldStatic(node, literals) {
   }
 }
 var PLAIN_TEXT = new RegExp("^\\p{L}(?:[\\p{L}\\p{N} ,.;'?%$=+-]*[\\p{L}\\p{N}.])?$", "u");
-function bindSnippetProps(body, properties) {
-  if (properties.size === 0 || !body.includes("props") && ![...properties.keys()].some((name) => body.includes(name))) return body;
+function bindSnippetProps(body, properties, unset = /* @__PURE__ */ new Set()) {
+  if (properties.size === 0 && unset.size === 0 || !body.includes("props") && ![...properties.keys(), ...unset].some((name) => body.includes(name))) return body;
   const isJsx = /<[A-Za-z][A-Za-z0-9]*/.test(body);
   let tree;
   try {
@@ -2075,6 +2176,14 @@ function bindSnippetProps(body, properties) {
         }
       }
       const bound = properties.get(name);
+      if (variables && bound === void 0 && unset.has(name)) {
+        if (parent?.type === "Property" && parent.shorthand) edits.push({ start: parent.start, end: parent.end, value: `${name}: undefined` });
+        else {
+          edits.push({ start, end, value: "undefined" });
+          literals.set(`${start}:${end}`, void 0);
+        }
+        continue;
+      }
       if (!variables || bound === void 0) continue;
       if (name !== "children") {
         if (parent?.type === "Property" && parent.shorthand) edits.push({ start: parent.start, end: parent.end, value: `${name}: ${JSON.stringify(bound)}` });
@@ -2123,8 +2232,8 @@ function bindSnippetProps(body, properties) {
     const { value } = folded;
     const place = (text4) => flow ? asBlock(text4, start, end) : { start, end, value: text4 };
     if (typeof value === "object" && value !== null) return inAttribute ? void 0 : place(keepJsx(value.jsx, bound, literals));
-    if (inAttribute) return { start, end, value: `{${JSON.stringify(value)}}` };
-    if (typeof value === "boolean" || value === null || value === "") return place("");
+    if (inAttribute) return { start, end, value: `{${value === void 0 ? "undefined" : JSON.stringify(value)}}` };
+    if (typeof value === "boolean" || value === null || value === void 0 || value === "") return place("");
     return place(typeof value === "string" && PLAIN_TEXT.test(value) ? value : `{${JSON.stringify(value)}}`);
   };
   const foldBound = (program, bound, literals, span, inAttribute, flow) => {
@@ -2143,9 +2252,10 @@ function bindSnippetProps(body, properties) {
       const lone = node.type !== "mdxjsEsm" && program.body.length === 1 && statement.type === "ExpressionStatement" && statement.expression.type === "Identifier" ? statement.expression : void 0;
       if (lone) {
         const bound = moduleNames.has(lone.name) ? void 0 : properties.get(lone.name);
-        if (bound === void 0) {
-        } else if (span || isJsx && lone.name !== "children") edits.push({ start: lone.start, end: lone.end, value: JSON.stringify(bound) });
-        else if (start !== void 0 && end !== void 0) edits.push(node.type === "mdxFlowExpression" ? asBlock(bound, start, end) : { start, end, value: bound });
+        const missing = bound === void 0 && !moduleNames.has(lone.name) && unset.has(lone.name);
+        if (bound === void 0 && !missing) {
+        } else if (span || isJsx && lone.name !== "children") edits.push({ start: lone.start, end: lone.end, value: missing ? "undefined" : JSON.stringify(bound) });
+        else if (start !== void 0 && end !== void 0) edits.push(node.type === "mdxFlowExpression" ? asBlock(bound ?? "", start, end) : { start, end, value: bound ?? "" });
       } else {
         const first = edits.length;
         const literals = /* @__PURE__ */ new Map();
@@ -2371,11 +2481,11 @@ function protectMathBlocks(raw) {
   const protectedBody = front + output.join("\n");
   if (!converted) return { body: protectedBody, converted };
   try {
-    compileSync(protectedBody, { outputFormat: "program" });
+    compileSync(protectedBody, MDX_COMPILE_OPTIONS);
     return { body: protectedBody, converted };
   } catch {
     try {
-      compileSync(raw, { outputFormat: "program" });
+      compileSync(raw, MDX_COMPILE_OPTIONS);
       return { body: raw, converted: false, guardTriggered: true };
     } catch {
       return { body: protectedBody, converted };
@@ -2533,7 +2643,7 @@ function maskCode(body) {
       }
       continue;
     }
-    if (fenceMatch) {
+    if (fenceMatch && !(fenceMatch[1][0] === "`" && line.slice(fenceMatch[0].length).includes("`"))) {
       codeFence = fenceMatch[1];
       fenceBuffer = [line];
       continue;
@@ -2582,6 +2692,10 @@ function indentSnippetLines(snippet, indent) {
     return indent + line;
   }).join("\n");
 }
+function maskedOutsideCode(body) {
+  const { masked, openFence } = maskCode(body);
+  return { text: masked, openFence: openFence !== null };
+}
 function replaceOutsideCode(body, transform) {
   const { masked, unmask } = maskCode(body);
   return unmask(transform(masked));
@@ -2640,6 +2754,63 @@ function rewriteFernRelativePageLinks(body, currentSourcePath, routesBySourcePat
     (_match, opening, quote, target2) => `${opening}${quote}${rewrite(target2)}${quote}`
   ));
 }
+function rewriteRelativeJsxHrefs(body, pagePath) {
+  const rewrite = (target2) => {
+    if (!/^\.\.?\//.test(target2) || target2.includes("\\") || /[\u0000-\u001f\u007f]/.test(target2)) return target2;
+    const suffixAt = target2.search(/[?#]/);
+    const pathname = suffixAt < 0 ? target2 : target2.slice(0, suffixAt);
+    if (/%2e|%2f|%5c/i.test(pathname)) return target2;
+    const segments = pagePath.split("/").slice(0, -1);
+    for (const part of pathname.split("/")) {
+      if (part === "..") {
+        segments.pop();
+      } else if (part !== "." && part !== "") {
+        segments.push(part);
+      }
+    }
+    return `/${segments.join("/")}${pathname.endsWith("/") && segments.length > 0 ? "/" : ""}${suffixAt < 0 ? "" : target2.slice(suffixAt)}`;
+  };
+  return replaceOutsideCodeAndComments(body, (text4) => text4.replace(
+    /((?<![\w-])href\s*=\s*)(["'])([^"'\n]+)\2/g,
+    (_match, opening, quote, target2) => `${opening}${quote}${rewrite(target2)}${quote}`
+  ).replace(
+    /((?<![\w-])href\s*=\s*\{\s*)(["'])([^"'\n]+)\2(?=\s*\})/g,
+    (_match, opening, quote, target2) => `${opening}${quote}${rewrite(target2)}${quote}`
+  ));
+}
+function templateLiteralRanges(body) {
+  let tree;
+  try {
+    tree = descriptionParser.parse(body);
+  } catch {
+    return null;
+  }
+  const ranges = [];
+  const scan = (value) => {
+    if (!value || typeof value !== "object") return;
+    const node = value;
+    if (node.type === "TemplateLiteral" && typeof node.start === "number" && typeof node.end === "number") ranges.push([node.start, node.end]);
+    for (const child of Object.values(node)) scan(child);
+  };
+  scan(tree);
+  return ranges.sort((left, right) => left[0] - right[0]);
+}
+function esmTemplateLiteralRanges(body) {
+  const text4 = body.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, (frontmatter) => frontmatter.replace(/[^\r\n]/g, " "));
+  const direct = templateLiteralRanges(text4);
+  if (direct) return direct;
+  const blanked = text4.replace(/<!--[\s\S]*?-->/g, (comment) => comment.replace(/[^\r\n]/g, " "));
+  const repaired = escapeUnparseableExpressions(escapeUnmatchedClosingTags(blanked).body);
+  const ranges = templateLiteralRanges(repaired.body);
+  if (!ranges) return [];
+  const inserted = [];
+  for (let at = 0, source = 0; at < repaired.body.length; at++) {
+    if (repaired.body[at] === blanked[source]) source++;
+    else inserted.push(at);
+  }
+  const original = (offset) => offset - inserted.filter((at) => at < offset).length;
+  return ranges.map(([start, end]) => [original(start), original(end)]);
+}
 function normalizeFernFileTrees(body) {
   return replaceOutsideCode(body, (whole) => whole.replace(
     /<FileTree\s*>\s*\n([\s\S]*?)\n\s*<\/FileTree>/g,
@@ -2934,6 +3105,28 @@ function normalizeDocusaurusTabs(body) {
   }
   return result.replace(/<ThallyTabs\b/g, "<Tabs").replace(/<\/ThallyTabs>/g, "</Tabs>");
 }
+function normalizeStrayTabItems(body) {
+  const tags = [...body.matchAll(/<TabItem\b([^<>]*)>|<\/TabItem>/g)].filter((tag) => !/\/$/.test(tag[1] ?? ""));
+  const openers = [];
+  const paired = /* @__PURE__ */ new Set();
+  tags.forEach((tag, index) => {
+    if (tag[0] !== "</TabItem>") openers.push(index);
+    else if (openers.length > 0) {
+      paired.add(openers.pop());
+      paired.add(index);
+    }
+  });
+  let result = "";
+  let cursor = 0;
+  tags.forEach((tag, index) => {
+    if (!paired.has(index)) return;
+    const attributes = tag[1] ?? "";
+    const title = attributes.match(/\blabel=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean) ?? attributes.match(/\bvalue=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean) ?? "Tab";
+    result += `${body.slice(cursor, tag.index)}${tag[0] === "</TabItem>" ? "</Tab>" : `<Tab title="${title.replace(/"/g, "&quot;")}">`}`;
+    cursor = tag.index + tag[0].length;
+  });
+  return result + body.slice(cursor);
+}
 var TAB_FENCE_OPEN = /^(`{3,}|~{3,})(\S*)\s+tab\b(.*)$/;
 function normalizeDocusaurusTabBlocks(body) {
   const lines = body.split("\n");
@@ -3157,6 +3350,37 @@ function pinStepsTitleSize(body) {
   }
   return result + body.slice(cursor);
 }
+function addMintlifyVideoAttributes(body) {
+  if (!body.includes("<video")) return body;
+  let result = "";
+  let cursor = 0;
+  for (const match of body.matchAll(/<video(?=[\s/>])/g)) {
+    if (match.index < cursor) continue;
+    const tag = readTagEnd(body, match.index + match[0].length);
+    if (tag === UNTERMINATED) break;
+    if (!tag) continue;
+    let attributes;
+    try {
+      attributes = descriptionParser.parse(`<video${tag.attributes}/>`).children?.[0]?.attributes ?? [];
+    } catch {
+      continue;
+    }
+    const named2 = (name) => attributes.find((attribute2) => attribute2.type === "mdxJsxAttribute" && attribute2.name?.toLowerCase() === name.toLowerCase());
+    const autoPlay = named2("autoPlay");
+    const start = autoPlay?.position?.start.offset;
+    const end = autoPlay?.position?.end.offset;
+    const off = typeof autoPlay?.value === "object" && autoPlay.value?.value?.trim() === "false";
+    const missing = ["muted", "loop", "playsInline"].filter((name) => !named2(name));
+    if (!autoPlay || off || missing.length === 0 || start === void 0 || end === void 0) continue;
+    const at = match.index + end;
+    const indent = body.slice(body.lastIndexOf("\n", match.index + start - 1) + 1, match.index + start);
+    const eol = /^[ \t]*(\r?\n)/.exec(body.slice(at))?.[1];
+    const insert = eol && /^[ \t]*$/.test(indent) ? missing.map((name) => `${eol}${indent}${name}`).join("") : missing.map((name) => ` ${name}`).join("");
+    result += body.slice(cursor, at) + insert;
+    cursor = at;
+  }
+  return result + body.slice(cursor);
+}
 function escapeUnmatchedClosingTags(body) {
   const masked = maskCodeRegions(body);
   const tagPattern = /(\\?)<(\/?)([A-Za-z][\w.:-]*)/g;
@@ -3174,21 +3398,69 @@ function escapeUnmatchedClosingTags(body) {
     } else if (open.get(name)) {
       open.set(name, open.get(name) - 1);
     } else {
-      edits.push(match.index);
+      edits.push({ start: match.index, end: tag.end });
     }
   }
-  if (edits.length === 0) return { body, lines: [] };
+  if (edits.length === 0) return { body, escaped: [] };
   let result = "";
   let cursor = 0;
-  const lines = [];
-  let line = 1;
-  for (const start of edits) {
+  for (const { start } of edits) {
     result += `${body.slice(cursor, start)}\\`;
-    for (let i = cursor; i < start; i++) if (body.charCodeAt(i) === 10) line++;
-    lines.push(line);
     cursor = start;
   }
-  return { body: result + body.slice(cursor), lines };
+  return { body: result + body.slice(cursor), escaped: edits.map(({ start, end }) => body.slice(start, end)) };
+}
+function isBackslashEscaped(text4, index) {
+  let slashes = 0;
+  while (index - 1 - slashes >= 0 && text4[index - 1 - slashes] === "\\") slashes++;
+  return slashes % 2 === 1;
+}
+var MAX_EXPRESSION_REPAIRS = 50;
+function escapeUnparseableExpressions(body) {
+  let current = body;
+  const escaped = [];
+  for (let repairs = 0; ; repairs++) {
+    let failure;
+    try {
+      compileSync(current, MDX_COMPILE_OPTIONS);
+      return { body: current, escaped };
+    } catch (error) {
+      failure = error;
+    }
+    const offset = failure?.place?.offset;
+    if (repairs === MAX_EXPRESSION_REPAIRS || failure?.source !== "micromark-extension-mdx-expression" || failure.ruleId !== "acorn" || typeof offset !== "number") return { body, escaped: [] };
+    const masked = maskCodeRegions(current);
+    let opener = -1;
+    for (let i = offset - 1, depth = 0; i >= 0 && opener < 0; i--) {
+      if (isBackslashEscaped(masked, i)) continue;
+      if (masked[i] === "}") depth++;
+      else if (masked[i] === "{") {
+        if (depth === 0) opener = i;
+        else depth--;
+      }
+    }
+    if (opener < 0) return { body, escaped: [] };
+    let braces = [];
+    let close = -1;
+    for (let i = opener, depth = 0; i < masked.length && close < 0; i++) {
+      if (isBackslashEscaped(masked, i)) continue;
+      if (masked[i] === "{") {
+        depth++;
+        braces.push(i);
+      } else if (masked[i] === "}" && --depth === 0) {
+        close = i;
+      }
+    }
+    if (close < 0) braces = [opener];
+    escaped.push(current.slice(opener, close < 0 ? opener + 1 : close + 1));
+    let cursor = 0;
+    let result = "";
+    for (const brace of braces) {
+      result += `${current.slice(cursor, brace)}\\`;
+      cursor = brace;
+    }
+    current = result + current.slice(cursor);
+  }
 }
 function isKnownComponentName(name, body) {
   if (isThallyBuiltinComponent(name)) return true;
@@ -3219,7 +3491,7 @@ function escapeOrphanCapitalizedTags(body) {
   }
   if (edits.length === 0) return body;
   try {
-    compileSync(body, { outputFormat: "program" });
+    compileSync(body, MDX_COMPILE_OPTIONS);
     return body;
   } catch {
   }
@@ -3345,20 +3617,18 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
     ));
     rewritten = rewritten.replace(/^\n{2,}/, "\n");
   }
+  if (runMintlify && rewritten.includes("<TabItem")) rewritten = replaceOutsideCode(rewritten, normalizeDocusaurusTabs);
   if (runMintlify) rewritten = normalizeMintlifyParameterAnchors(rewritten);
   rewritten = unwrapHtmlCommentInMdxComment(rewritten);
   rewritten = replaceOutsideCode(rewritten, (segment) => {
     let result = convertHtmlStyleAttributes(segment).replace(/<!--([\s\S]*?)-->/g, (_match, content) => mdxComment(content)).replace(/<Danger(\s[^>]*)?>/g, "<Error$1>").replace(/<\/Danger>/g, "</Error>").replace(/<Warn(\s[^>]*)?>/g, "<Warning$1>").replace(/<\/Warn>/g, "</Warning>").replace(/<Tree\.Folder/g, "<Folder").replace(/<\/Tree\.Folder>/g, "</Folder>").replace(/<Tree\.File/g, "<File").replace(/<\/Tree\.File>/g, "</File>");
     if (runDocusaurus) {
-      result = result.replace(/<TabItem\b([^<>]*)>/g, (_match, attributes) => {
-        const title = attributes.match(/\blabel=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean) ?? attributes.match(/\bvalue=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean) ?? "Tab";
-        return `<Tab title="${title.replace(/"/g, "&quot;")}">`;
-      }).replace(/<\/TabItem>/g, "</Tab>");
-      result = normalizeDocusaurusLinkTags(result).replace(/<(?:DocCardList|TOCInline)\b[^<>]*\/>/g, "");
+      result = normalizeDocusaurusLinkTags(normalizeStrayTabItems(result)).replace(/<(?:DocCardList|TOCInline)\b[^<>]*\/>/g, "");
     }
     if (runMintlify) {
-      result = normalizeMintlifyUpdateLabels(result).replace(/<FileTree(\s[^>]*)?>/g, "<Tree$1>").replace(/<\/FileTree>/g, "</Tree>").replace(/<GitHub\.Repo/g, "<GitHub").replace(/<\/GitHub\.Repo>/g, "</GitHub>").replace(/<Callout(\s[^<>]*)?>/g, (tag) => tag.replace(/(\s)type=(?:"[^"]*"|'[^']*'|\{[^{}]*\})/, '$1type="info"')).replace(/<Column(\s[^>]*)?>/g, "<div$1>").replace(/<\/Column>/g, "</div>");
+      result = normalizeMintlifyUpdateLabels(normalizeStrayTabItems(result)).replace(/<FileTree(\s[^>]*)?>/g, "<Tree$1>").replace(/<\/FileTree>/g, "</Tree>").replace(/<GitHub\.Repo/g, "<GitHub").replace(/<\/GitHub\.Repo>/g, "</GitHub>").replace(/<Callout(\s[^<>]*)?>/g, (tag) => tag.replace(/(\s)type=(?:"[^"]*"|'[^']*'|\{[^{}]*\})/, '$1type="info"')).replace(/<Column(\s[^>]*)?>/g, "<div$1>").replace(/<\/Column>/g, "</div>");
       result = pinStepsTitleSize(result);
+      result = addMintlifyVideoAttributes(result);
     }
     if (runFern) {
       result = result.replace(/<CodeBlocks(\s[^>]*)?>/g, "<CodeGroup$1>").replace(/<\/CodeBlocks>/g, "</CodeGroup>").replace(/<ParameterField\b/g, "<ParamField").replace(/<\/ParameterField>/g, "</ParamField>").replace(/<Cards(\s[^>]*)?>/g, "<CardGroup$1>").replace(/<\/Cards>/g, "</CardGroup>").replace(/<Success(\s[^>]*)?>/g, "<Tip$1>").replace(/<\/Success>/g, "</Tip>").replace(/<Launch(\s[^>]*)?>/g, "<Note$1>").replace(/<\/Launch>/g, "</Note>").replace(/<Files(\s[^>]*)?>\n?/g, "").replace(/<\/Files>/g, "");
@@ -3369,7 +3639,7 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
   const normalized = escapeOrphanCapitalizedTags(provideScopedGlobalReferences(rewritten));
   if (runDocusaurus && sourceBody !== body) {
     try {
-      compileSync(normalized, { outputFormat: "program" });
+      compileSync(normalized, MDX_COMPILE_OPTIONS);
     } catch {
       return normalizeMdx(body, platform, false);
     }
@@ -3431,14 +3701,20 @@ function parseMarkdownPage(input) {
   const normalized = normalizeMdx(parsed.content, input.platform);
   const body = removeUndefinedExpressions(injectReactHookImports(input.platform === "mintlify" ? normalizeMintlifyCodeFences(normalized, input.warn) : normalized), input.warn).trim();
   const keywords = Array.isArray(parsed.data.keywords) ? parsed.data.keywords.filter((value) => typeof value === "string") : [];
-  const heading = leadingPageHeading(body);
+  const namesOperation = typeof parsed.data.openapi === "string" && Boolean(parsed.data.openapi.trim());
+  const heading = input.platform === "mintlify" && !namesOperation ? void 0 : leadingPageHeading(body);
   const authoredTitle = typeof parsed.data.title === "string" && parsed.data.title.trim() ? parsed.data.title.trim() : heading?.title;
   const title = authoredTitle ?? titleFromId(identity.navigationId);
-  const namesOperation = typeof parsed.data.openapi === "string" && Boolean(parsed.data.openapi.trim());
   const sidebarTitle = input.platform === "docusaurus" ? parsed.data.sidebar_label : parsed.data.sidebarTitle;
   const navTitle = typeof sidebarTitle === "string" && sidebarTitle.trim() ? sidebarTitle.trim() : typeof parsed.data.navTitle === "string" && parsed.data.navTitle.trim() ? parsed.data.navTitle.trim() : void 0;
-  const icon = typeof parsed.data.icon === "string" && parsed.data.icon.trim() ? parsed.data.icon.trim() : void 0;
-  const iconType = icon && typeof parsed.data.iconType === "string" && ["regular", "solid", "outline", "brands"].includes(parsed.data.iconType) ? parsed.data.iconType : void 0;
+  const iconObject = parsed.data.icon && typeof parsed.data.icon === "object" && !Array.isArray(parsed.data.icon) ? parsed.data.icon : void 0;
+  const iconSource = iconObject ? iconObject.name : parsed.data.icon;
+  const icon = typeof iconSource === "string" && iconSource.trim() ? iconSource.trim() : void 0;
+  const iconStyle = (value) => typeof value === "string" && ["regular", "solid", "outline", "brands"].includes(value) ? value : void 0;
+  const iconType = icon ? iconStyle(iconObject?.style) ?? iconStyle(parsed.data.iconType) : void 0;
+  if (icon && typeof iconObject?.library === "string" && input.siteIconLibrary !== void 0 && iconObject.library !== input.siteIconLibrary) {
+    input.warn?.(`Page "${identity.id}": its icon names the "${iconObject.library}" icon library, but this site uses "${input.siteIconLibrary}", so the icon "${icon}" is looked up there and may show a different icon or none. Use an icon name from "${input.siteIconLibrary}", or set icons.library in docs.json to "${iconObject.library}".`);
+  }
   const meta = {};
   for (const [source, field] of PAGE_META_FIELDS) {
     const value = parsed.data[source];
@@ -3667,7 +3943,12 @@ function youtubeEmbedVideoId(node, specifier) {
   }
   return void 0;
 }
-var parser = unified3().use(remarkParse3).use(remarkMdx2);
+var COMPONENT_ANALYSIS_FAILED = "Custom component analysis could not parse this MDX";
+function pageHasComponentWork(body) {
+  const { text: text4, openFence } = maskedOutsideCode(splitFrontmatterBlock(body).body);
+  return openFence || /^[ \t]*(?:import|export)\b|\bon[A-Z]\w*\s*=|\brequire\s*\(/m.test(text4);
+}
+var parser = unified3().use(remarkParse3).use(remarkGfm2).use(remarkMdx2);
 var CODE_EXTENSIONS = /* @__PURE__ */ new Set([".js", ".jsx", ".ts", ".tsx", ".mjs"]);
 var DATA_EXTENSIONS = /* @__PURE__ */ new Set([".json", ".css", ".svg", ".png", ".jpg", ".jpeg", ".webp", ".gif", ".avif", ".woff", ".woff2"]);
 var RESCUABLE_ASSET_EXTENSIONS = /* @__PURE__ */ new Set([".svg", ".png", ".jpg", ".jpeg", ".webp", ".gif", ".avif", ".ico", ".docx", ".pdf"]);
@@ -4437,7 +4718,7 @@ ${client ? "'use client';\n" : ""}
     try {
       tree = parser.parse(content);
     } catch {
-      warn("Custom component analysis could not parse this MDX; its source was preserved for manual migration.", currentFile);
+      warn(`${COMPONENT_ANALYSIS_FAILED}; its source was preserved for manual migration.`, currentFile);
       return frontmatter + neutralizeUnresolvableImportsWithoutAst(content, currentFile, warn);
     }
     const aliases = /* @__PURE__ */ new Map();
@@ -4541,7 +4822,7 @@ ${client ? "'use client';\n" : ""}
         }
         if (!specifier.startsWith(".") && !specifier.startsWith("/")) {
           if (SHARED_IMPORTS.has(specifier)) {
-            const isUnusedReactHookImport = specifier === "react" && bindings.length > 0 && bindings.every((binding) => REACT_GLOBALS.has(binding.imported)) && !hasExpressionReference(new Set(bindings.map((binding) => binding.local)));
+            const isUnusedReactHookImport = specifier === "react" && bindings.length > 0 && !hasExpressionReference(new Set(bindings.map((binding) => binding.local)), { includeDirectTags: true });
             if (!isUnusedReactHookImport) moduleImports.push(statement.getText(ast));
             if (isUnusedReactHookImport) edits.push({ start: node.position.start.offset + statement.getStart(ast), end: node.position.start.offset + statement.end, value: "" });
             else sharedImportEdits.push({ start: node.position.start.offset + statement.getStart(ast), end: node.position.start.offset + statement.end, value: "" });
@@ -4688,14 +4969,22 @@ ${client ? "'use client';\n" : ""}
         unavailableImports: unsupportedImports,
         reactGlobals: REACT_GLOBALS
       });
-      for (const { name, reason } of plan.blocked) {
+      for (const { name, reason, browser } of plan.blocked) {
         refusedInlineComponents.add(name);
-        warn(`Inline component "${name}" calls a React hook but was left in the page: ${reason}. Move it and everything it uses into a client component manually.`, currentFile);
+        warn(`Inline component "${name}" ${browser ? "uses `window` or `document`, which only exist in the browser," : "calls a React hook"} but was left in the page: ${reason}. Move it and everything it uses into a client component manually.`, currentFile);
+      }
+      const moduleIndexes = [...plan.moved, ...plan.copied].sort((a, b) => a - b);
+      const gated = new Set(plan.gated);
+      let gate = "renderAfterMount";
+      if (gated.size > 0) {
+        const spelled = identifierNames(sourceFile([...plan.moduleImports, ...plan.moduleHelpers, ...moduleIndexes.map((index) => declarations2[index].source)].join("\n"), "inline.jsx"));
+        for (let suffix = 2; spelled.has(gate); suffix += 1) gate = `renderAfterMount${suffix}`;
       }
       const moduleSource = plan.moved.length === 0 ? "" : [
         ...plan.moduleImports,
         ...plan.moduleHelpers,
-        ...[...plan.moved, ...plan.copied].sort((a, b) => a - b).map((index) => declarations2[index].source)
+        ...moduleIndexes.map((index) => (gated.has(index) ? gateOnMount(declarations2[index].source, gate) : void 0) ?? declarations2[index].source),
+        ...gated.size > 0 ? [mountGateHelper(gate)] : []
       ].join("\n\n");
       if (plan.moved.length > 0 && (copied.size >= MAX_COMPONENT_FILES || Buffer.byteLength(moduleSource) > MAX_FILE_BYTES || copiedBytes + Buffer.byteLength(moduleSource) > MAX_COMPONENT_BYTES)) {
         warn(`Inline component "${plan.movedNames[0]}" exceeded the component migration budget; source was preserved.`, currentFile);
@@ -5221,6 +5510,18 @@ function pageRoutes(pages) {
 function pageEntryRoutes(page) {
   return [.../* @__PURE__ */ new Set([...pageRoutes([page]), ...page.id === "introduction" ? ["/"] : []])];
 }
+function pagesRedirectedFrom(redirects, pages) {
+  const sources = new Set(redirects.flatMap(({ source }) => exactRoute(source) ?? []));
+  return pages.filter((page) => page.id !== "introduction" && !(page.locale && page.id === `${page.locale}/introduction`) && pageRoutes([page]).some((route) => sources.has(route)));
+}
+function redirectsOverPagesWarning(routes) {
+  if (routes.length === 0) return null;
+  const one = routes.length === 1;
+  return {
+    code: "unsupported-config",
+    message: `Kept ${routes.length} redirect${one ? "" : "s"} from ${list([...routes])}: ${one ? "that URL is" : "those URLs are"} also ${one ? "a page" : "pages"} in this site. Mintlify follows a redirect and never shows the page, so the ${one ? "page was" : "pages were"} marked noindex and ${one ? "its file stays" : "their files stay"}. Delete ${one ? "the page" : "a page"} and its navigation entry if you do not need it.`
+  };
+}
 function servedRoutes(pages) {
   return new Set(pageRoutes(pages).map((route) => route.toLowerCase()));
 }
@@ -5427,15 +5728,6 @@ function addMintlifyDirectoryRedirects(config, pages) {
       return match ? route === match[1] || route.startsWith(`${match[1]}/`) : false;
     });
   }
-  for (const page of pages) {
-    if (!/\/(?:overview|introduction)$/.test(page.navigationId)) continue;
-    const parent = page.id.replace(/\/(?:overview|introduction)$/, "");
-    if (!parent || pageIds.has(parent.toLowerCase())) continue;
-    const source = `/${parent}`;
-    if (hasAuthoredRedirect(source)) continue;
-    redirects.push({ source, destination: `/${page.id}`, permanent: false });
-    redirectSources.add(source.toLowerCase());
-  }
   const navigationOrder = [];
   function collectPages(nodes) {
     for (const node of nodes) {
@@ -5463,6 +5755,15 @@ function addMintlifyDirectoryRedirects(config, pages) {
       }
     }
   }
+  for (const page of pages) {
+    if (!/\/(?:overview|introduction)$/.test(page.navigationId)) continue;
+    const parent = page.id.replace(/\/(?:overview|introduction)$/, "");
+    if (!parent || pageIds.has(parent.toLowerCase()) || !firstDescendantByDirectory.has(parent)) continue;
+    const source = `/${parent}`;
+    if (hasAuthoredRedirect(source)) continue;
+    redirects.push({ source, destination: `/${page.id}`, permanent: false });
+    redirectSources.add(source.toLowerCase());
+  }
   for (const [directory2, landing] of firstDescendantByDirectory) {
     if (pageIds.has(directory2.toLowerCase())) continue;
     const source = `/${directory2}`;
@@ -5472,6 +5773,9 @@ function addMintlifyDirectoryRedirects(config, pages) {
   }
   return redirects.length > 0 ? { ...config, redirects } : config;
 }
+function isMintlifyRootIndex(page, defaultLocale) {
+  return page.id === "introduction" && (!page.locale || page.locale === defaultLocale) && /(?:^|[/#])index\.mdx?$/i.test(page.source);
+}
 function addMintlifyHomepageRedirects(config, pages) {
   const defaultPages = new Set(pages.filter((page) => !page.locale || page.locale === config.i18n?.defaultLocale).map((page) => page.navigationId));
   function firstPage(nodes) {
@@ -5491,8 +5795,9 @@ function addMintlifyHomepageRedirects(config, pages) {
   const sources = new Set(redirects.map((redirect) => routeKey(redirect.source)));
   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)];
   const homeLinksElsewhere = pages.some((page) => page.id === "introduction" && page.externalUrl);
+  const rootIsIndexPage = pages.some((page) => isMintlifyRootIndex(page, config.i18n?.defaultLocale));
   for (const locale of roots) {
-    if (!locale && homeLinksElsewhere) continue;
+    if (!locale && (homeLinksElsewhere || rootIsIndexPage)) continue;
     const source = locale ? `/${locale}` : "/";
     if (sources.has(source.toLowerCase())) continue;
     const destination = `${locale ? `/${locale}` : ""}/${homepage}`;
@@ -6257,12 +6562,43 @@ function convertContainerToTabs(containerValue, context, fallbackTab, trace, dep
     ...container.hidden === true ? { hidden: true } : {}
   }] : [];
 }
+function named(text4) {
+  return text4.replace(/[\x00-\x1f\x7f]/g, "").slice(0, 60);
+}
 function projectedTheme(value) {
   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 projectedThemeWithWarning(value, warnings) {
+  const theme = projectedTheme(value);
+  if (theme && value !== theme && value !== "mint") {
+    warnings.push({ code: "unsupported-config", message: `theme ${JSON.stringify(named(String(value)))} has no exact Thally equivalent, so ${JSON.stringify(theme)} was used, which is the closest. Compare the look of the migrated site with the live one.`, source: "docs.json" });
+  }
+  return theme;
+}
+function projectedErrors(value, warnings) {
+  const errors = objectValue2(value);
+  if (!errors) return void 0;
+  const notCarried = [];
+  let redirect;
+  for (const [status, entry] of Object.entries(errors)) {
+    const settings = status === "404" ? objectValue2(entry) : null;
+    if (!settings) {
+      notCarried.push(named(`errors.${status}`));
+      continue;
+    }
+    for (const [key, setting] of Object.entries(settings)) {
+      if (key === "redirect" && typeof setting === "boolean") redirect = setting;
+      else notCarried.push(named(`errors.404.${key}`));
+    }
+  }
+  if (notCarried.length > 0) {
+    warnings.push({ code: "unsupported-config", message: `docs.json ${notCarried.slice(0, 10).join(", ")}${notCarried.length > 10 ? ", ..." : ""} ${notCarried.length === 1 ? "was" : "were"} not carried over: Thally carries only errors.404.redirect (true or false).`, source: "docs.json" });
+  }
+  return redirect === void 0 ? void 0 : { "404": { redirect } };
+}
 function projectedColors(value, warnings) {
   const colors = objectValue2(value);
   if (!colors) {
@@ -6410,6 +6746,8 @@ function projectedCompatibleConfig(config, warnings, shortcutSources) {
   }
   const projectedMetatags = metatagEntries.length > 0 ? Object.fromEntries(metatagEntries) : void 0;
   const projectedColorsValue = projectedColors(config.colors, warnings);
+  const theme = projectedThemeWithWarning(config.theme, warnings);
+  const errors = projectedErrors(config.errors, warnings);
   const iconLibrary = objectValue2(config.icons)?.library;
   const projectedIconLibrary = iconLibrary === void 0 ? "fontawesome" : ["lucide", "fontawesome", "tabler"].includes(String(iconLibrary)) ? String(iconLibrary) : void 0;
   const docsNavbar = projectedNavbar(config.navbar);
@@ -6444,7 +6782,8 @@ function projectedCompatibleConfig(config, warnings, shortcutSources) {
     smartQuotes: true,
     // `styling.eyebrows: "breadcrumbs"` shows the whole group path; "section" (the default) shows the nearest group.
     ...objectValue2(config.styling)?.eyebrows === "breadcrumbs" ? { eyebrow: "path" } : {},
-    ...projectedTheme(config.theme) ? { theme: projectedTheme(config.theme) } : {},
+    ...theme ? { theme } : {},
+    ...errors ? { errors } : {},
     ...projectedContextual.length > 0 ? { contextual: { options: projectedContextual } } : {},
     ...projectedColorsValue ? { colors: projectedColorsValue } : {},
     ...projectedIconLibrary ? { icons: { library: projectedIconLibrary } } : {},
@@ -8257,10 +8596,10 @@ function namedExportStringText(source, name) {
     `\\bexport\\s+(?:const|let|var)\\s+${name}\\b(?:\\s*:\\s*[^=;]+)?\\s*=\\s*`
   ).exec(source);
   if (!match) return void 0;
-  const quoted = source.slice(match.index + match[0].length).match(/^("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/);
-  if (!quoted) return void 0;
+  const quoted2 = source.slice(match.index + match[0].length).match(/^("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/);
+  if (!quoted2) return void 0;
   try {
-    const parsed = JSON5.parse(quoted[1]);
+    const parsed = JSON5.parse(quoted2[1]);
     return typeof parsed === "string" ? parsed : void 0;
   } catch {
     return void 0;
@@ -8411,13 +8750,13 @@ function staticObjectEntries(array) {
 function staticStringField(source, name, bindings) {
   const start = propertyStart(source, name);
   if (start < 0) return void 0;
-  const quoted = source.slice(start).match(/^("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/);
-  if (!quoted) {
+  const quoted2 = source.slice(start).match(/^("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/);
+  if (!quoted2) {
     const reference = source.slice(start).match(/^([A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*)/)?.[1];
     return reference ? bindings?.get(reference) : void 0;
   }
   try {
-    const parsed = JSON5.parse(quoted[1]);
+    const parsed = JSON5.parse(quoted2[1]);
     return typeof parsed === "string" ? parsed : void 0;
   } catch {
     return void 0;
@@ -9291,6 +9630,18 @@ var SAFE_PATH = /^\/[A-Za-z0-9._~\-/]*$/;
 var MAX_PLAUSIBLE_DOMAINS = 10;
 var SUPPORTED = ["ga4", "gtm", "posthog", "plausible"];
 var LEGACY_GA4_ALIAS = "googleAnalytics";
+var KNOWN_TRACKERS = [
+  ["PostHog", /posthog/i],
+  ["Intercom", /intercom/i],
+  ["Segment", /segment\.(?:com|io)/i],
+  ["Hotjar", /hotjar|_hjSettings/i],
+  ["Google Tag Manager/Analytics", /googletagmanager|google-analytics\.com|\bgtag\s*\(|\bdataLayer\b/i],
+  ["Mixpanel", /mixpanel/i],
+  ["Amplitude", /amplitude/i]
+];
+function trackersIn(source) {
+  return KNOWN_TRACKERS.filter(([, pattern]) => pattern.test(source)).map(([name]) => name);
+}
 function own(record, key) {
   return Object.prototype.hasOwnProperty.call(record, key) ? record[key] : void 0;
 }
@@ -10015,9 +10366,9 @@ function projectCapturedTabs($, root) {
 import { createHash as createHash4 } from "crypto";
 import remarkMdx3 from "remark-mdx";
 import remarkParse4 from "remark-parse";
-import remarkGfm2 from "remark-gfm";
+import remarkGfm3 from "remark-gfm";
 import { unified as unified4 } from "unified";
-var parser2 = unified4().use(remarkParse4).use(remarkGfm2).use(remarkMdx3);
+var parser2 = unified4().use(remarkParse4).use(remarkGfm3).use(remarkMdx3);
 var MAX_SOURCE_BYTES = 8e6;
 var sourceTrees = /* @__PURE__ */ new Map();
 var cachedSourceBytes = 0;
@@ -10053,20 +10404,20 @@ function readMigrationFlightDocument($) {
 }
 function literalJson(value) {
   if (Buffer.byteLength(value) > MAX_SOURCE_BYTES) return void 0;
-  let depth = 0, quoted = false, escaped = false;
+  let depth = 0, quoted2 = false, escaped = false;
   for (const character of value) {
-    if (quoted) {
+    if (quoted2) {
       if (escaped) escaped = false;
       else if (character === "\\") escaped = true;
-      else if (character === '"') quoted = false;
-    } else if (character === '"') quoted = true;
+      else if (character === '"') quoted2 = false;
+    } else if (character === '"') quoted2 = true;
     else if (character === "[" || character === "{") {
       if (++depth > 96) return void 0;
     } else if (character === "]" || character === "}") {
       if (--depth < 0) return void 0;
     }
   }
-  if (depth !== 0 || quoted) return void 0;
+  if (depth !== 0 || quoted2) return void 0;
   try {
     return JSON.parse(value);
   } catch {
@@ -13925,14 +14276,49 @@ function readMintignoreMatcher(mintlifyRoot) {
   if (!existsSync5(path) || !lstatSync6(path).isFile()) return null;
   return createIgnoreMatcher().add(readFileSync6(path, "utf8"));
 }
+var RUNTIME_DEFAULT_ICON_LIBRARY = "lucide";
+function quoted(items) {
+  const unique = [...new Set(items.map((item) => item.replace(/\s+/g, " ").trim()))];
+  const shown = unique.slice(0, 3).map((item) => `\`${item.length > 60 ? `${item.slice(0, 59)}\u2026` : item}\``);
+  return `${shown.join(", ")}${unique.length > 3 ? `, and ${unique.length - 3} more` : ""}`;
+}
 function invalidMdxReason(body) {
   try {
-    compileSync2(body, { outputFormat: "program" });
+    compileSync2(body, MDX_COMPILE_OPTIONS);
     return null;
   } catch (error) {
     return error instanceof Error ? error.message : String(error);
   }
 }
+function unresolvedComponentWarning(name, source) {
+  return {
+    code: "unsupported-config",
+    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
+  };
+}
+function repairUncompilableMdx(body) {
+  const closingTags = escapeUnmatchedClosingTags(body);
+  if (closingTags.escaped.length > 0 && invalidMdxReason(closingTags.body) === null) {
+    return { body: closingTags.body, closingTags: closingTags.escaped, braces: [] };
+  }
+  const braces = escapeUnparseableExpressions(closingTags.body);
+  return braces.escaped.length > 0 ? { body: braces.body, closingTags: closingTags.escaped, braces: braces.escaped } : null;
+}
+function repairWarnings(repair, source) {
+  return [
+    ...repair.closingTags.length > 0 ? [{
+      code: "unsupported-config",
+      message: `Escaped unmatched closing tag(s) ${quoted(repair.closingTags)} so the page compiles; they render as literal text.`,
+      source
+    }] : [],
+    ...repair.braces.length > 0 ? [{
+      code: "unsupported-config",
+      message: `Escaped the braces of ${quoted(repair.braces)} so the page compiles; they render as literal text.`,
+      source
+    }] : []
+  ];
+}
 var HEX_COLOR = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i;
 function mintlifyThemeColors(value) {
   if (!value || typeof value !== "object") return void 0;
@@ -14177,9 +14563,9 @@ function resolveMintlifyApiSpecs(mintlifyConfig, files, warnings, remoteSpecs, n
   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 named = namedFiles.get(specRef) ?? resolveSpecRef(specRef, specFiles, false);
-    namedFiles.set(specRef, named);
-    const key = named.kind === "match" ? named.spec.sourcePath : "";
+    const named2 = namedFiles.get(specRef) ?? resolveSpecRef(specRef, specFiles, false);
+    namedFiles.set(specRef, named2);
+    const key = named2.kind === "match" ? named2.spec.sourcePath : "";
     if (!key || known.has(key)) continue;
     known.add(key);
     references.push({ value: key, kind: "openapi", tabLabel: `OpenAPI: ${key}`, hidden: true, pageOnly: true });
@@ -14462,23 +14848,23 @@ function mintlifyEndpointUrls(directory2, operations) {
     const title = mintlifyOperationTitle(operation);
     const tag = operation.tag === void 0 ? "" : mintlifyUrlSlug(operation.tag);
     const slug2 = mintlifyUrlSlug(title);
-    const named = slug2 !== "" && (operation.tag === void 0 || tag !== "");
+    const named2 = slug2 !== "" && (operation.tag === void 0 || tag !== "");
     const folder = [directory2, tag].filter(Boolean).join("/");
-    slugs.set(operation, { tag, slug: slug2, folder, title, named });
-    if (named) spelled.add(`${folder}/${slug2}`);
+    slugs.set(operation, { tag, slug: slug2, folder, title, named: named2 });
+    if (named2) spelled.add(`${folder}/${slug2}`);
   }
   const endpoints = /* @__PURE__ */ new Map();
   const taken = /* @__PURE__ */ new Set();
   const next = /* @__PURE__ */ new Map();
-  for (const [operation, { tag, slug: slug2, folder, title, named }] of slugs) {
+  for (const [operation, { tag, slug: slug2, folder, title, named: named2 }] of slugs) {
     let leaf = slug2;
-    if (named) {
+    if (named2) {
       let number = next.get(`${folder}/${slug2}`) ?? 1;
       while (taken.has(`${folder}/${leaf}`) || leaf !== slug2 && spelled.has(`${folder}/${leaf}`)) leaf = `${slug2}-${number++}`;
       next.set(`${folder}/${slug2}`, number);
       taken.add(`${folder}/${leaf}`);
     }
-    endpoints.set(operation, { tag, leaf, url: [folder, leaf].filter(Boolean).join("/"), title, named });
+    endpoints.set(operation, { tag, leaf, url: [folder, leaf].filter(Boolean).join("/"), title, named: named2 });
   }
   return endpoints;
 }
@@ -15041,10 +15427,29 @@ function staticSnippetProperties(attributes) {
   }
   return properties;
 }
-function interpolateSnippet(snippet, attributes, children) {
+function passedAttributeNames(attributes) {
+  const tree = ts5.createSourceFile("snippet.tsx", `const snippet = <Snippet ${attributes.replace(/\/\s*$/, "")} />`, ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
+  const statement = tree.statements[0];
+  const element = statement && ts5.isVariableStatement(statement) ? statement.declarationList.declarations[0]?.initializer : void 0;
+  if (!element || !ts5.isJsxSelfClosingElement(element)) return void 0;
+  const names = /* @__PURE__ */ new Set();
+  for (const attribute2 of element.attributes.properties) {
+    if (!ts5.isJsxAttribute(attribute2)) return void 0;
+    names.add(attribute2.name.getText(tree));
+  }
+  return names;
+}
+function interpolateSnippet(snippet, attributes, children, parameters = []) {
   const properties = staticSnippetProperties(attributes);
   if (children !== void 0) properties.set("children", children.trim());
-  return bindSnippetProps(snippet, properties);
+  const unset = /* @__PURE__ */ new Set();
+  const passed = parameters.length > 0 ? passedAttributeNames(attributes) : void 0;
+  for (const { name, fallback } of passed ? parameters : []) {
+    if (name === "children" || passed.has(name)) continue;
+    if (fallback === void 0) unset.add(name);
+    else properties.set(name, fallback);
+  }
+  return bindSnippetProps(snippet, properties, unset);
 }
 function isolateFences(snippet, source, start, end) {
   const fence = /^\s*(?:`{3,}|~{3,})/;
@@ -15058,6 +15463,23 @@ function alignToTag(snippet, source, start) {
   const indent = /^[ \t]*(?:(?:[-*+]|\d{1,9}[.)])[ \t]+)?$/.test(before) ? before.replace(/\S/g, " ") : before.match(/^[ \t]*/)[0];
   return indentSnippetLines(snippet, indent);
 }
+function snippetParameters(source, componentName) {
+  const parsed = ts5.createSourceFile("snippet.tsx", source, ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
+  for (const statement of parsed.statements) {
+    if (!ts5.isVariableStatement(statement)) continue;
+    for (const declaration of statement.declarationList.declarations) {
+      if (!ts5.isIdentifier(declaration.name) || declaration.name.text !== componentName) continue;
+      const pattern = declaration.initializer && ts5.isArrowFunction(declaration.initializer) ? declaration.initializer.parameters[0]?.name : void 0;
+      if (!pattern || !ts5.isObjectBindingPattern(pattern)) return [];
+      return pattern.elements.flatMap((element) => {
+        if (element.dotDotDotToken || element.propertyName || !ts5.isIdentifier(element.name)) return [];
+        if (!element.initializer) return [{ name: element.name.text }];
+        return ts5.isStringLiteralLike(element.initializer) ? [{ name: element.name.text, fallback: element.initializer.text }] : [];
+      });
+    }
+  }
+  return [];
+}
 function snippetComponentBody(source, componentName) {
   const parsed = ts5.createSourceFile("snippet.tsx", source, ts5.ScriptTarget.Latest, true, ts5.ScriptKind.TSX);
   for (const statement of parsed.statements) {
@@ -15144,20 +15566,37 @@ function staticNamedSnippetValues(source) {
   return values;
 }
 function hoistMdxImports(source) {
-  const imports2 = /* @__PURE__ */ new Set();
-  const withoutImports = replaceOutsideCode(source, (body) => body.replace(
-    /^[ \t]*import\s+(?:\{[^}\n]+\}|[A-Za-z_$][\w$]*)\s+from\s+(['"])[^'"\n]+\1[ \t]*;?/gm,
-    (statement) => {
-      imports2.add(statement.trim().replace(/;?$/, ";"));
-      return "";
-    }
-  ));
+  const hoist = (text4) => {
+    const imports3 = /* @__PURE__ */ new Set();
+    const rest2 = replaceOutsideCode(text4, (body) => body.replace(
+      /^[ \t]*import\s+(?:\{[^}\n]+\}|[A-Za-z_$][\w$]*)\s+from\s+(['"])[^'"\n]+\1[ \t]*;?/gm,
+      (statement) => {
+        imports3.add(statement.trim().replace(/;?$/, ";"));
+        return "";
+      }
+    ));
+    return { imports: imports3, rest: rest2 };
+  };
+  let { imports: imports2, rest } = hoist(source);
   if (imports2.size === 0) return source;
-  const frontmatter = withoutImports.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
+  const literals = [];
+  let protectedSource = "";
+  let cursor = 0;
+  for (const [start, end] of source.includes("`") ? esmTemplateLiteralRanges(source) : []) {
+    if (start < cursor) continue;
+    literals.push(source.slice(start, end));
+    protectedSource += `${source.slice(cursor, start)}${literals.length - 1}`;
+    cursor = end;
+  }
+  if (literals.length > 0) {
+    ({ imports: imports2, rest } = hoist(protectedSource + source.slice(cursor)));
+    if (imports2.size === 0) return source;
+  }
+  const frontmatter = rest.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
   const prefix = frontmatter?.[0] ?? "";
   return `${prefix}${[...imports2].join("\n")}
 
-${withoutImports.slice(prefix.length).replace(/^(?:\r?\n)*/, "")}`;
+${rest.slice(prefix.length).replace(/^(?:\r?\n)*/, "")}`.replace(/\u0002(\d+)\u0002/g, (marker, index) => literals[Number(index)] ?? marker);
 }
 function fernSourceBasePath(config) {
   const instance = Array.isArray(config.instances) ? config.instances[0] : null;
@@ -15213,14 +15652,26 @@ function stripFernBasePathFromLinks(body, basePath) {
   const escaped = basePath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   return replaceOutsideCode(body, (text4) => text4.replace(new RegExp(`(\\]\\()${escaped}(?=\\/|[)#?])`, "g"), (match, prefix, offset, source) => prefix + (source[offset + match.length] === "/" ? "" : "/")).replace(new RegExp(`(\\b(?:href|to)=["'])${escaped}(?=\\/|["'#?])`, "g"), (match, prefix, offset, source) => prefix + (source[offset + match.length] === "/" ? "" : "/")));
 }
-function rewriteMintlifyMountedLinks(body, pageIds) {
-  const rewrite = (target2) => {
+function mintlifySourceSite(config) {
+  const canonical2 = config?.seo?.metatags?.canonical;
+  if (typeof canonical2 === "string") {
+    try {
+      const url = new URL(canonical2.trim());
+      if (url.protocol === "http:" || url.protocol === "https:") return { host: url.hostname, path: url.pathname.replace(/\/+$/, "") };
+    } catch {
+    }
+  }
+  const domain = config?.integrations?.plausible?.domain;
+  return typeof domain === "string" && /^(?:docs|developers?)(?:\.[a-z0-9-]+)+$/i.test(domain.trim()) ? { host: domain.trim().toLowerCase(), path: "" } : void 0;
+}
+function rewriteMintlifyMountedLinks(body, pageIds, sourceSite) {
+  const resolve5 = (target2) => {
     const suffixAt = target2.search(/[?#]/);
     const pathname = suffixAt < 0 ? target2 : target2.slice(0, suffixAt);
     const suffix = suffixAt < 0 ? "" : target2.slice(suffixAt);
-    if (!pathname.startsWith("/") || pathname.startsWith("//") || pathname.includes("\\")) return target2;
+    if (!pathname.startsWith("/") || pathname.startsWith("//") || pathname.includes("\\")) return void 0;
     const segments = pathname.slice(1).split("/");
-    if (segments.some((segment) => !segment || segment === "." || segment === "..")) return target2;
+    if (segments.some((segment) => !segment || segment === "." || segment === "..")) return void 0;
     const markdown = pathname.endsWith(".md");
     const sourceMdx = pathname.endsWith(".mdx");
     const routeSegments = markdown || sourceMdx ? [...segments.slice(0, -1), segments.at(-1).replace(/\.mdx?$/, "")] : segments;
@@ -15229,9 +15680,21 @@ function rewriteMintlifyMountedLinks(body, pageIds) {
       const candidate = routeSegments.slice(count).join("/");
       if (pageIds.has(candidate)) return `/${candidate}${markdown ? ".md" : ""}${suffix}`;
     }
-    return target2;
+    return void 0;
+  };
+  const rewrite = (target2) => {
+    if (target2.startsWith("/")) return resolve5(target2) ?? target2;
+    if (!sourceSite) return target2;
+    try {
+      const url = new URL(target2);
+      if (url.hostname !== sourceSite.host || url.port || url.username || url.password) return target2;
+      if (sourceSite.path && url.pathname !== sourceSite.path && !url.pathname.startsWith(`${sourceSite.path}/`)) return target2;
+      return resolve5(`${url.pathname}${url.search}${url.hash}`) ?? target2;
+    } catch {
+      return target2;
+    }
   };
-  return replaceOutsideCode(body, (text4) => text4.replace(/(\]\()(\/[^\s)]+)(\))/g, (_match, before, target2, after) => `${before}${rewrite(target2)}${after}`).replace(/(\b(?:href|to)=(['"]))(\/[^'"\n]+)\2/g, (_match, before, quote, target2) => `${before}${rewrite(target2)}${quote}`));
+  return replaceOutsideCode(body, (text4) => text4.replace(/(\]\()(\/[^\s)]{1,2048}|https?:\/\/[^\s)]{1,2048})(\))/g, (_match, before, target2, after) => `${before}${rewrite(target2)}${after}`).replace(/(\b(?:href|to)=(['"]))(\/[^'"\n]{1,2048}|https?:\/\/[^'"\n]{1,2048})\2/g, (_match, before, quote, target2) => `${before}${rewrite(target2)}${quote}`));
 }
 function preserveLinkedAnchors(pages) {
   const pageById = new Map(pages.map((page) => [page.id, page]));
@@ -15521,8 +15984,8 @@ function importUndeclaredSnippetComponents(raw, currentFile, repositoryRoot, sit
     try {
       const candidate = resolveSnippetPath(specifier, currentFile, repositoryRoot, siteRoot);
       if (candidate !== match || !lstatSync6(candidate).isFile() || gate?.(candidate)) continue;
-      const named = snippetExportedNames(readFileSync6(candidate, "utf8")).has(name);
-      statements.push(named ? `import { ${name} } from '${specifier}'` : `import ${name} from '${specifier}'`);
+      const named2 = snippetExportedNames(readFileSync6(candidate, "utf8")).has(name);
+      statements.push(named2 ? `import { ${name} } from '${specifier}'` : `import ${name} from '${specifier}'`);
       warnings.push({
         code: "unsupported-config",
         message: `<${name}> is used without an import; it was resolved to ${specifier.slice(1)} (the only snippet exporting that name). Mintlify renders unimported components as empty, so this page now shows content the live site does not.`,
@@ -15641,6 +16104,7 @@ function inlineMdxSnippets(raw, currentFile, repositoryRoot, warnings, depth = 0
   if (depth >= 8) return raw;
   raw = normalizeIndentedFences(raw);
   const snippets = /* @__PURE__ */ new Map();
+  const snippetProps = /* @__PURE__ */ new Map();
   const preservedDeclarations = /* @__PURE__ */ new Map();
   const source = relative6(repositoryRoot, currentFile).replace(/\\/g, "/");
   const blockInline = (candidate, shownPath, label = shownPath) => {
@@ -15749,7 +16213,10 @@ ${indent}`), segment, match.index, end);
         );
         const declaration = statefulSnippetDeclaration(nested, componentName);
         if (declaration) preservedDeclarations.set(componentName, declaration);
-        else snippets.set(componentName, snippetComponentBody(nested, componentName));
+        else {
+          snippets.set(componentName, snippetComponentBody(nested, componentName));
+          snippetProps.set(componentName, snippetParameters(nested, componentName));
+        }
         return "";
       } catch (error) {
         if (error instanceof Error && error.message.includes("escapes its root")) {
@@ -15834,6 +16301,7 @@ ${indent}`), segment, match.index, end);
             continue;
           }
           components.push([binding.local, body]);
+          if (/^[A-Z]/.test(binding.exported)) snippetProps.set(binding.local, snippetParameters(snippetSource, binding.exported));
         }
         for (const [name, body] of components) snippets.set(name, body);
         return exportBlock(declarations2, statement, sourcePath);
@@ -15875,14 +16343,17 @@ ${indent}`), segment, match.index, end);
     );
     const declaration = statefulSnippetDeclaration(nested, componentName);
     if (declaration) preservedDeclarations.set(componentName, declaration);
-    else snippets.set(componentName, snippetComponentBody(nested, componentName));
+    else {
+      snippets.set(componentName, snippetComponentBody(nested, componentName));
+      snippetProps.set(componentName, snippetParameters(nested, componentName));
+    }
   }
   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(alignToTag(closeOpenCodeFence(interpolateSnippet(snippet, attributes)), source2, offset), source2, offset, offset + tag.length);
+        return isolateFences(alignToTag(closeOpenCodeFence(interpolateSnippet(snippet, attributes, void 0, snippetProps.get(componentName))), source2, offset), source2, offset, offset + tag.length);
       }).replace(new RegExp(`<${componentName}((?:\\s[^>]*)?)>([\\s\\S]*?)<\\/${componentName}>`, "g"), (tag, attributes, children, offset, source2) => {
-        return isolateFences(alignToTag(closeOpenCodeFence(interpolateSnippet(snippet, attributes, children)), source2, offset), source2, offset, offset + tag.length);
+        return isolateFences(alignToTag(closeOpenCodeFence(interpolateSnippet(snippet, attributes, children, snippetProps.get(componentName))), source2, offset), source2, offset, offset + tag.length);
       });
     }
     const tagLabel = (filePath) => platform === "fern" ? `Included file ${filePath}` : `Snippet file="${filePath}"`;
@@ -16064,6 +16535,7 @@ function migrateRepository(options) {
   let mintlifyConfig = null;
   let mintlifyApiTabSlots = [];
   let mintlifyDirectories = [];
+  let mintlifyAuthoredRedirects = [];
   const mintlifyNavigationAccess = /* @__PURE__ */ new Map();
   let fernRawConfig = null;
   let fernBasePath = "";
@@ -16110,6 +16582,7 @@ function migrateRepository(options) {
         docsConfig = projected.docsConfig;
         mintlifyApiTabSlots = projected.apiTabSlots;
         mintlifyDirectories = projected.directories;
+        mintlifyAuthoredRedirects = projected.docsConfig.redirects ?? [];
         warnings.push(...projected.warnings);
         for (const repo of projected.gatedSourceRefs) gatedSourceRepos.add(repo.toLowerCase());
         for (const appearance of projected.referenceAccess) {
@@ -16419,6 +16892,7 @@ ${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
     return { locale, navigationId, id: isDefaultLocale ? navigationId : `${locale}/${navigationId}` };
   };
   const routeAliases = [];
+  const siteIconLibrary = docsConfig.icons?.library ?? RUNTIME_DEFAULT_ICON_LIBRARY;
   const pageFiles = [...files].sort((left, right) => {
     const leftOrder = referenceOrder.get(normalizedReferenceKey(left.relativePath)) ?? Number.MAX_SAFE_INTEGER;
     const rightOrder = referenceOrder.get(normalizedReferenceKey(right.relativePath)) ?? Number.MAX_SAFE_INTEGER;
@@ -16595,9 +17069,27 @@ ${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
       );
     }
     const pageWarningSource = relative6(componentRoot, file.absolutePath).replace(/\\/g, "/");
+    let componentAnalysisLeftWork = false;
     if (componentMigrator) {
       const warningsBeforeTransform = warnings.length;
+      const analysisFailed = () => warnings.slice(warningsBeforeTransform).some((warning) => warning.message.startsWith(COMPONENT_ANALYSIS_FAILED) && warning.source !== void 0 && resolvePath(componentRoot, warning.source) === file.absolutePath);
+      const beforeTransform = raw;
       raw = componentMigrator.transform(raw, file.absolutePath);
+      if (analysisFailed()) {
+        const { front, body } = splitFrontmatterBlock(protectMathBlocks(beforeTransform).body);
+        const repair = repairUncompilableMdx(normalizeHtmlComments(body));
+        if (repair) {
+          const failed = warnings.splice(warningsBeforeTransform);
+          const retried = componentMigrator.transform(front + repair.body, file.absolutePath);
+          if (analysisFailed()) {
+            warnings.splice(warningsBeforeTransform, warnings.length, ...failed);
+          } else {
+            raw = retried;
+            warnings.push(...repairWarnings(repair, file.relativePath));
+          }
+        }
+      }
+      componentAnalysisLeftWork = analysisFailed() && pageHasComponentWork(beforeTransform);
       if (warnings.slice(warningsBeforeTransform).some((warning) => warning.code === "skipped-file" && warning.source !== void 0 && resolvePath(componentRoot, warning.source) === file.absolutePath)) {
         skipped++;
         continue;
@@ -16624,6 +17116,7 @@ ${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
       navigationId,
       warn: (message) => warnings.push({ code: "unsupported-config", message, source: pageWarningSource }),
       ...locale ? { locale } : {},
+      siteIconLibrary,
       raw,
       platform,
       source: `${options.sourceUrl}#${relative6(repositoryDir, file.absolutePath).replace(/\\/g, "/")}`,
@@ -16698,25 +17191,28 @@ ${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
     if (platform === "mintlify" || platform === "docusaurus" || platform === "fern") {
       page.body = replaceLinkWithAnchor(page.body);
       page.body = replaceUnknownComponents(page.body, (name) => {
-        warnings.push({
-          code: "unsupported-config",
-          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
-        });
+        warnings.push(unresolvedComponentWarning(name, file.relativePath));
       });
     }
     if (platform === "docusaurus") resolvePageDisplayHeading(page, platform);
     let mdxError = invalidMdxReason(page.body);
     if (mdxError) {
-      const repaired = escapeUnmatchedClosingTags(page.body);
-      if (repaired.lines.length > 0 && invalidMdxReason(repaired.body) === null) {
-        page.body = repaired.body;
-        mdxError = null;
-        warnings.push({
-          code: "unsupported-config",
-          message: `Escaped unmatched closing tag(s) on line ${repaired.lines.join(", ")} so the page compiles; they render as literal text.`,
-          source: file.relativePath
+      const repair = repairUncompilableMdx(page.body);
+      if (repair && (repair.braces.length === 0 || !componentAnalysisLeftWork)) {
+        const settledWarnings = [];
+        let settled = escapeFernLiteralBraces(repair.body);
+        settled = normalizeFlowParagraphContainers(settled);
+        settled = removeUndefinedExpressions(settled, (message) => {
+          settledWarnings.push({ code: "unsupported-config", message, source: pageWarningSource });
         });
+        settled = replaceUnknownComponents(replaceLinkWithAnchor(settled), (name) => {
+          settledWarnings.push(unresolvedComponentWarning(name, file.relativePath));
+        });
+        if (invalidMdxReason(settled) === null) {
+          page.body = settled;
+          mdxError = null;
+          warnings.push(...repairWarnings(repair, file.relativePath), ...settledWarnings);
+        }
       }
     }
     if (mdxError) {
@@ -16758,7 +17254,7 @@ ${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
     if (declarationsReferenceBrowserGlobal(page.body)) {
       warnings.push({
         code: "unsupported-config",
-        message: "This page defines a component that uses `document`/`window`, which isn't available when pages are rendered on the server. Move that code into a client component or edit the page manually.",
+        message: "This page still defines code that uses `document`/`window`, which isn't available when pages are rendered on the server. Move that code into a client component or edit the page manually.",
         source: file.relativePath
       });
     }
@@ -16987,6 +17483,17 @@ ${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
         code: "unsupported-config",
         message: `${scripts.length} script(s) from the content directory (${scripts.map((entry) => entry.path).join(", ")}) now load on every page via docs.json customScripts, as they did on Mintlify. They may target Mintlify's page structure; review them.`
       });
+      for (const entry of scripts) {
+        const content = assets.find((asset) => asset.path === entry.path)?.content;
+        const trackers = content === void 0 ? [] : trackersIn(Buffer.from(content).toString("utf8"));
+        if (trackers.length > 0) {
+          warnings.push({
+            code: "unsupported-config",
+            message: `Script ${stripControlCharacters(entry.path)} loads or names ${trackers.join(", ")}, which tracks visitors. It was carried over and now runs on every page of the migrated site. Delete the file and its docs.json customScripts entry if you do not want that.`,
+            source: entry.path
+          });
+        }
+      }
     }
     for (const entry of copiedSite.filter((item) => item.kind === "style")) {
       warnings.push({
@@ -17450,7 +17957,8 @@ ${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
       ...pages.map((page) => page.id),
       ...(docsConfig.redirects ?? []).map((redirect) => redirect.source.replace(/^\//, ""))
     ]);
-    for (const page of pages) page.body = rewriteMintlifyMountedLinks(page.body, reachablePaths);
+    const sourceSite = mintlifySourceSite(mintlifyConfig);
+    for (const page of pages) page.body = rewriteMintlifyMountedLinks(page.body, reachablePaths, sourceSite);
   }
   if (platform === "docusaurus" && docusaurusProjectRoot && !options.docusaurusSkipPlugins) {
     const additionalRoots = [
@@ -17648,6 +18156,9 @@ ${body}`;
       if (source) page.body = rewriteFernRelativePageLinks(page.body, source, routes);
     }
   }
+  if (platform === "mintlify") {
+    for (const page of pages) page.body = rewriteRelativeJsxHrefs(page.body, page.id);
+  }
   appendMintlifyDirectories(pages, mintlifyDirectories, warnings);
   preserveLinkedAnchors(pages);
   if (platform === "fern" && fernRawConfig) {
@@ -17663,7 +18174,13 @@ ${body}`;
     }
   }
   if (docsConfig.redirects) {
-    docsConfig = dropConflictingRedirects(dropUnroutableRedirects(docsConfig, warnings), [...pages, ...sourceRefPages], warnings);
+    const allPages = [...pages, ...sourceRefPages];
+    const takenOver = platform === "mintlify" ? pagesRedirectedFrom(mintlifyAuthoredRedirects, allPages) : [];
+    docsConfig = dropConflictingRedirects(dropUnroutableRedirects(docsConfig, warnings), takenOver.length > 0 ? allPages.filter((page) => !takenOver.includes(page)) : allPages, warnings);
+    const standIns = pagesRedirectedFrom(docsConfig.redirects ?? [], takenOver);
+    for (const page of standIns) page.noindex = true;
+    const standInWarning = redirectsOverPagesWarning(standIns.map((page) => `/${page.id}`));
+    if (standInWarning) warnings.push(standInWarning);
   }
   const redirectSources = new Map((docsConfig.redirects ?? []).map((redirect) => [(redirect.source.replace(/\/+$/, "") || "/").toLowerCase(), redirect.destination]));
   const linkRedirects = [];
@@ -17781,13 +18298,13 @@ ${reasons.map((reason) => `- ${reason}`).join("\n")}` : "No importable Markdown
     });
   }
   if (!docsConfig.navigation?.display && docsConfig.tabs.filter((tab) => !tab.hidden).length > 6) {
-    docsConfig = { ...docsConfig, navigation: { display: "dropdown", ...docsConfig.navigation?.groupHeadings ? { groupHeadings: docsConfig.navigation.groupHeadings } : {} } };
+    docsConfig = { ...docsConfig, navigation: { ...docsConfig.navigation, display: "dropdown" } };
   }
   const themeColors = mintlifyConfig ? mintlifyThemeColors(mintlifyConfig.colors) : fernRawConfig ? fernThemeColors(fernRawConfig.colors) ?? (fernRawConfig["global-theme"] === "nvidia" ? { primary: "#76B900" } : void 0) : isTopLevelDocusaurus ? presentation?.colors ?? readDocusaurusThemeColor(docusaurusProjectRoot) : void 0;
   const assetPaths = new Set(assets.map((asset) => asset.path));
   const publicBrandPath = (value) => {
     if (typeof value !== "string" || /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(value)) return void 0;
-    const normalized = fernBrandAssetPaths.get(value) ?? normalizeAssetPath(value);
+    const normalized = fernBrandAssetPaths.get(value) ?? normalizeAssetPath(value.replace(/^(?:\.[/\\]+)+/, ""));
     return normalized && assetPaths.has(normalized) ? `/${normalized}` : void 0;
   };
   const brandVariants = (value) => {
@@ -18279,14 +18796,14 @@ function target(value, base) {
 function readJson(value) {
   if (Buffer.byteLength(value) > MAX_JSON_BYTES) return void 0;
   let depth = 0;
-  let quoted = false;
+  let quoted2 = false;
   let escaped = false;
   for (const char of value) {
-    if (quoted) {
+    if (quoted2) {
       if (escaped) escaped = false;
       else if (char === "\\") escaped = true;
-      else if (char === '"') quoted = false;
-    } else if (char === '"') quoted = true;
+      else if (char === '"') quoted2 = false;
+    } else if (char === '"') quoted2 = true;
     else if (char === "[" || char === "{") {
       if (++depth > 96) return void 0;
     } else if (char === "]" || char === "}") depth--;
@@ -20674,7 +21191,8 @@ async function hydrateRemoteApiSpecs(bundle, fetcher) {
   const withDirectories = bundle.platform === "mintlify" && newPages.length > 0 ? addMintlifyDirectoryRedirects(boundConfig, newPages) : boundConfig;
   const links = (withDirectories.redirects ?? []).filter(isLinkRedirect);
   const unchecked = links.length > 0 ? { ...withDirectories, redirects: withDirectories.redirects.filter((redirect) => !isLinkRedirect(redirect)) } : withDirectories;
-  const checked = dropConflictingRedirects(dropUnroutableRedirects(unchecked, warnings), pages, warnings);
+  const standIns = bundle.platform === "mintlify" ? pagesRedirectedFrom(unchecked.redirects ?? [], pages.filter((page) => page.noindex)) : [];
+  const checked = dropConflictingRedirects(dropUnroutableRedirects(unchecked, warnings), standIns.length > 0 ? pages.filter((page) => !standIns.includes(page)) : pages, warnings);
   const checkedWithLinks = links.length > 0 ? dropConflictingRedirects({ ...checked, redirects: [...checked.redirects ?? [], ...links] }, [], warnings) : checked;
   return {
     ...bundle,