@thallylabs/migrate 0.2.29 → 0.2.31

package/dist/index.js

@@ -278,9 +278,9 @@ function collectRefs(root) {
       return;
     }
     if (ts.isAwaitExpression(node) && !inAsync) awaitOutsideAsync = true;
-    const target = ts.isBinaryExpression(node) && node.operatorToken.kind >= ts.SyntaxKind.FirstAssignment && node.operatorToken.kind <= ts.SyntaxKind.LastAssignment ? node.left : (ts.isPrefixUnaryExpression(node) || ts.isPostfixUnaryExpression(node)) && (node.operator === ts.SyntaxKind.PlusPlusToken || node.operator === ts.SyntaxKind.MinusMinusToken) ? node.operand : void 0;
-    if (target) {
-      let base = target;
+    const target2 = ts.isBinaryExpression(node) && node.operatorToken.kind >= ts.SyntaxKind.FirstAssignment && node.operatorToken.kind <= ts.SyntaxKind.LastAssignment ? node.left : (ts.isPrefixUnaryExpression(node) || ts.isPostfixUnaryExpression(node)) && (node.operator === ts.SyntaxKind.PlusPlusToken || node.operator === ts.SyntaxKind.MinusMinusToken) ? node.operand : void 0;
+    if (target2) {
+      let base = target2;
       while (ts.isPropertyAccessExpression(base) || ts.isElementAccessExpression(base)) base = base.expression;
       if (ts.isIdentifier(base) && !bound(base.text, scopes)) assigned.push(base.text);
     }
@@ -484,8 +484,8 @@ function planInlineExtraction(input) {
   const dependencies = (unit) => {
     const found = /* @__PURE__ */ new Set();
     for (const { name } of unit.refs) {
-      const target = owner.get(name);
-      if (target !== void 0 && target !== unit.index) found.add(target);
+      const target2 = owner.get(name);
+      if (target2 !== void 0 && target2 !== unit.index) found.add(target2);
     }
     return found;
   };
@@ -540,8 +540,8 @@ function planInlineExtraction(input) {
         if (clientSide.has(index)) continue;
         const unit = units[index];
         const callsClient = unit.refs.some(({ name, kind }) => {
-          const target = owner.get(name);
-          return target !== void 0 && clientSide.has(target) && kind !== "tag" && kind !== "prop";
+          const target2 = owner.get(name);
+          return target2 !== void 0 && clientSide.has(target2) && kind !== "tag" && kind !== "prop";
         });
         if (callsClient) {
           clientSide.add(index);
@@ -702,9 +702,9 @@ function hasOnlySafeMemberAccess(root) {
     } else if (ts.isBindingElement(node)) {
       if (ts.isObjectBindingPattern(node.parent) && !safeKey(node.propertyName ?? (ts.isIdentifier(node.name) ? node.name : void 0), false)) safe = false;
     } else if (ts.isObjectLiteralExpression(node)) {
-      const target = isAssignmentTarget(node);
+      const target2 = isAssignmentTarget(node);
       for (const property of node.properties) {
-        if ((ts.isPropertyAssignment(property) || ts.isShorthandPropertyAssignment(property)) && !safeKey(property.name, !target)) safe = false;
+        if ((ts.isPropertyAssignment(property) || ts.isShorthandPropertyAssignment(property)) && !safeKey(property.name, !target2)) safe = false;
       }
     }
     ts.forEachChild(node, visit);
@@ -722,8 +722,8 @@ function pageScopeNames(esmSources) {
     for (const statement of parse(source).statements) {
       for (const local of importLocals(statement.getText())) names.add(local);
       if (ts.isImportDeclaration(statement)) continue;
-      const target = ts.isExportDeclaration(statement) || ts.isExportAssignment(statement) ? void 0 : statement;
-      if (target) for (const name of declaredNames(target).names) names.add(name);
+      const target2 = ts.isExportDeclaration(statement) || ts.isExportAssignment(statement) ? void 0 : statement;
+      if (target2) for (const name of declaredNames(target2).names) names.add(name);
     }
   }
   return names;
@@ -872,12 +872,12 @@ 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);
+  const target2 = resolve(baseDir, candidate);
+  const fromRoot = relative(resolve(confineRoot), target2);
   if (fromRoot === ".." || fromRoot.startsWith(`..${sep}`) || isAbsolute(fromRoot)) {
     throw new Error(`Migration path escapes its root: ${candidate}`);
   }
-  return target;
+  return target2;
 }
 function normalizeAssetPath(value) {
   const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "");
@@ -1315,14 +1315,14 @@ ${trimmed.slice(0, marker).trimEnd()}`;
 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 mintlifyHeadingSlug(text3) {
+  return text3.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 thallyHeadingSlug(text3) {
+  return text3.normalize("NFC").toLowerCase().replace(/[^\p{L}\p{M}\p{N}]+/gu, "-").replace(/(^-|-$)/g, "");
 }
-function typesetQuotes(text2) {
-  return text2.split(/(`[^`]*`|<[^>]*>|\]\([^)]*\))/).map((part, index) => {
+function typesetQuotes(text3) {
+  return text3.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("");
@@ -1345,9 +1345,9 @@ function markMintlifyHeadings(body) {
     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)}` : ""}`;
+    const text3 = plainHeadingText(source);
+    const id = mintlifyHeadingSlug(text3);
+    return `${heading[1]}${source}${id && id !== thallyHeadingSlug(text3) ? ` ${headingIdMarker(id)}` : ""}`;
   }).join("\n");
 }
 var GLOBAL_DOCUSARUS_COMPONENTS = /* @__PURE__ */ new Set([
@@ -1417,7 +1417,7 @@ function bindSnippetProps(body, properties) {
     for (const child of node.children ?? []) visit(child);
   };
   visit(tree);
-  return edits.sort((a, b) => b.start - a.start).reduce((text2, edit) => text2.slice(0, edit.start) + edit.value + text2.slice(edit.end), body);
+  return edits.sort((a, b) => b.start - a.start).reduce((text3, edit) => text3.slice(0, edit.start) + edit.value + text3.slice(edit.end), body);
 }
 function leadingPageHeading(body) {
   if (!/^ {0,3}(?:#(?:[ \t]|$)|=+[ \t\r]*$)/m.test(body)) return void 0;
@@ -1425,8 +1425,8 @@ function leadingPageHeading(body) {
     const root = descriptionParser.parse(body);
     const first = root.children?.find((node) => node.type !== "mdxjsEsm" && node.type !== "html" && !(node.type === "mdxFlowExpression" && node.data?.estree?.body.length === 0));
     if (first?.type !== "heading" || first.depth !== 1) return void 0;
-    const text2 = (node) => node.type === "mdxTextExpression" || node.type === "mdxFlowExpression" ? "" : node.value ?? (node.children ?? []).map(text2).join("");
-    const title = text2(first).replace(/\s+/g, " ").trim();
+    const text3 = (node) => node.type === "mdxTextExpression" || node.type === "mdxFlowExpression" ? "" : node.value ?? (node.children ?? []).map(text3).join("");
+    const title = text3(first).replace(/\s+/g, " ").trim();
     const start = first.position?.start.offset;
     const end = first.position?.end.offset;
     return title && start !== void 0 && end !== void 0 ? { title, start, end } : void 0;
@@ -1505,16 +1505,16 @@ function collectEsmBindingsByPattern(source, declared) {
 var FENCE_OPEN = /^(`{3,}|~{3,})/;
 function maskInlineSpansForMath(line) {
   const blocks = [];
-  const stash = (text2) => {
-    blocks.push(text2);
+  const stash = (text3) => {
+    blocks.push(text3);
     return `\0${blocks.length - 1}\0`;
   };
   const codeMasked = line.split(/(`[^`]*`)/).map((segment, index) => index % 2 === 1 ? stash(segment) : segment).join("");
   const tagMasked = codeMasked.replace(/<\/?[a-zA-Z][^<>]*>/g, stash);
-  const masked = [tagMasked, tagMasked].reduce((text2) => text2.replace(/(?<!\$)\{[^{}]*\}/g, stash), tagMasked);
+  const masked = [tagMasked, tagMasked].reduce((text3) => text3.replace(/(?<!\$)\{[^{}]*\}/g, stash), tagMasked);
   return {
     masked,
-    unmask: (text2) => text2.replace(/\u0000(\d+)\u0000/g, (_match, index) => blocks[Number(index)])
+    unmask: (text3) => text3.replace(/\u0000(\d+)\u0000/g, (_match, index) => blocks[Number(index)])
   };
 }
 var TEX_SIGNAL = /\\[a-zA-Z]|[\^_{]/;
@@ -1670,11 +1670,11 @@ function splitFrontmatterBlock(raw) {
   return { front: bom + source.slice(0, end), body: source.slice(end) };
 }
 var MIGRATED_COMPONENT_TAG = /^Migrated[0-9a-f]{12}$/;
-function isSelfClosingJsx(text2) {
-  return /\/>\s*$/.test(text2);
+function isSelfClosingJsx(text3) {
+  return /\/>\s*$/.test(text3);
 }
-function renameTagOccurrences(text2, name, newName) {
-  let result = text2;
+function renameTagOccurrences(text3, name, newName) {
+  let result = text3;
   const openIndex = result.indexOf(`<${name}`);
   if (openIndex >= 0) result = `${result.slice(0, openIndex + 1)}${newName}${result.slice(openIndex + 1 + name.length)}`;
   const closeIndex = result.lastIndexOf(`</${name}`);
@@ -1720,9 +1720,9 @@ function replaceUnknownComponents(raw, warn, options = {}) {
     if (start === void 0 || end === void 0) return "";
     const isJsx = node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement";
     const tagRoot = node.name ? node.name.split(".")[0] : void 0;
-    const text2 = body.slice(start, end);
+    const text3 = body.slice(start, end);
     if (isJsx && tagRoot === "Link" && !declared.has("Link")) {
-      if (isSelfClosingJsx(text2) || !node.children?.length) return renameTagOccurrences(text2, node.name, "a");
+      if (isSelfClosingJsx(text3) || !node.children?.length) return renameTagOccurrences(text3, node.name, "a");
       const openEnd = node.children[0].position?.start.offset ?? start;
       const closeStart = node.children.at(-1).position?.end.offset ?? end;
       return renameTagOccurrences(body.slice(start, openEnd), node.name, "a") + renderChildrenSpan(node.children, openEnd, closeStart, body, renderNode) + renameTagOccurrences(body.slice(closeStart, end), node.name, "a");
@@ -1732,7 +1732,7 @@ function replaceUnknownComponents(raw, warn, options = {}) {
         warned.add(node.name);
         warn(node.name);
       }
-      if (isSelfClosingJsx(text2)) return "";
+      if (isSelfClosingJsx(text3)) return "";
       if (!node.children?.length) return "<div></div>";
       const openEnd = node.children[0].position?.start.offset ?? start;
       const closeStart = node.children.at(-1).position?.end.offset ?? end;
@@ -1743,7 +1743,7 @@ ${children}
 
 </div>` : `<div>${children}</div>`;
     }
-    if (!node.children?.length) return text2;
+    if (!node.children?.length) return text3;
     return renderChildrenSpan(node.children, start, end, body, renderNode);
   };
   return front + renderNode(root);
@@ -1751,8 +1751,8 @@ ${children}
 function maskCode(body) {
   const source = body.replace(/\u0000/g, "");
   const blocks = [];
-  const stash = (text2) => {
-    blocks.push(text2);
+  const stash = (text3) => {
+    blocks.push(text3);
     return `\0${blocks.length - 1}\0`;
   };
   const lines = [];
@@ -1779,7 +1779,7 @@ function maskCode(body) {
   if (fenceBuffer.length) lines.push(stash(fenceBuffer.join("\n")));
   return {
     masked: lines.join("\n"),
-    unmask: (text2) => text2.replace(/\u0000(\d+)\u0000/g, (_match, index) => blocks[Number(index)]),
+    unmask: (text3) => text3.replace(/\u0000(\d+)\u0000/g, (_match, index) => blocks[Number(index)]),
     openFence: codeFence
   };
 }
@@ -1792,8 +1792,8 @@ function replaceOutsideCode(body, transform) {
   const { masked, unmask } = maskCode(body);
   return unmask(transform(masked));
 }
-function mdxComment(text2) {
-  return `{/*${text2.replace(/\*\//g, "* /")}*/}`;
+function mdxComment(text3) {
+  return `{/*${text3.replace(/\*\//g, "* /")}*/}`;
 }
 function replaceOutsideCodeAndComments(body, transform) {
   return replaceOutsideCode(body, (masked) => {
@@ -1824,26 +1824,26 @@ function replaceOutsideCodeAndComments(body, transform) {
   });
 }
 function rewriteFernRelativePageLinks(body, currentSourcePath, routesBySourcePath) {
-  const rewrite = (target) => {
-    if (!target || target.startsWith("/") || target.startsWith("#") || target.startsWith("?") || target.includes("\\") || /[\u0000-\u001f\u007f]/.test(target) || /^[A-Za-z][A-Za-z\d+.-]*:/.test(target)) return target;
-    const suffixAt = target.search(/[?#]/);
-    const pathname = suffixAt < 0 ? target : target.slice(0, suffixAt);
-    const suffix = suffixAt < 0 ? "" : target.slice(suffixAt);
-    if (!pathname || pathname.startsWith("//") || pathname.split("/").some((part) => /%2f|%5c/i.test(part))) return target;
+  const rewrite = (target2) => {
+    if (!target2 || target2.startsWith("/") || target2.startsWith("#") || target2.startsWith("?") || target2.includes("\\") || /[\u0000-\u001f\u007f]/.test(target2) || /^[A-Za-z][A-Za-z\d+.-]*:/.test(target2)) return target2;
+    const suffixAt = target2.search(/[?#]/);
+    const pathname = suffixAt < 0 ? target2 : target2.slice(0, suffixAt);
+    const suffix = suffixAt < 0 ? "" : target2.slice(suffixAt);
+    if (!pathname || pathname.startsWith("//") || pathname.split("/").some((part) => /%2f|%5c/i.test(part))) return target2;
     const source = posix.normalize(posix.join(posix.dirname(currentSourcePath.replace(/\\/g, "/")), pathname));
     const candidates = /\.mdx?$/i.test(source) ? [source] : [source, `${source}.mdx`, `${source}.md`, `${source}/index.mdx`, `${source}/index.md`];
     const route = candidates.map((candidate) => routesBySourcePath.get(candidate)).find(Boolean);
-    return route ? `/${route.replace(/^\/+/, "")}${suffix}` : target;
+    return route ? `/${route.replace(/^\/+/, "")}${suffix}` : target2;
   };
-  return replaceOutsideCode(body, (text2) => text2.replace(
+  return replaceOutsideCode(body, (text3) => text3.replace(
     /(\]\()(<[^>\n]+>|[^\s)]+)(?=\s|\))/g,
-    (_match, opening, target) => `${opening}${target.startsWith("<") && target.endsWith(">") ? `<${rewrite(target.slice(1, -1))}>` : rewrite(target)}`
+    (_match, opening, target2) => `${opening}${target2.startsWith("<") && target2.endsWith(">") ? `<${rewrite(target2.slice(1, -1))}>` : rewrite(target2)}`
   ).replace(
     /(\b(?:href|to)\s*=\s*)(["'])([^"'\n]+)\2/g,
-    (_match, opening, quote, target) => `${opening}${quote}${rewrite(target)}${quote}`
+    (_match, opening, quote, target2) => `${opening}${quote}${rewrite(target2)}${quote}`
   ).replace(
     /(\b(?:href|to)\s*=\s*\{\s*)(["'])([^"'\n]+)\2(?=\s*\})/g,
-    (_match, opening, quote, target) => `${opening}${quote}${rewrite(target)}${quote}`
+    (_match, opening, quote, target2) => `${opening}${quote}${rewrite(target2)}${quote}`
   ));
 }
 function normalizeFernFileTrees(body) {
@@ -2302,12 +2302,12 @@ function maskCodeRegions(body) {
   }).join("\n");
 }
 var UNTERMINATED = "unterminated";
-function readTagEnd(text2, from) {
-  if (from < text2.length && !/[\s/>]/.test(text2[from])) return null;
+function readTagEnd(text3, from) {
+  if (from < text3.length && !/[\s/>]/.test(text3[from])) return null;
   let depth = 0;
   let quote = "";
-  for (let i = from; i < text2.length; i++) {
-    const char = text2[i];
+  for (let i = from; i < text3.length; i++) {
+    const char = text3[i];
     if (quote) {
       if (char === "\\" && depth > 0) i++;
       else if (char === quote) quote = "";
@@ -2320,8 +2320,8 @@ function readTagEnd(text2, from) {
     } else if (depth === 0) {
       if (char === "<") return null;
       if (char === ">") {
-        const selfClosing = text2[i - 1] === "/" && i > from;
-        return { end: i + 1, selfClosing, attributes: text2.slice(from, selfClosing ? i - 1 : i) };
+        const selfClosing = text3[i - 1] === "/" && i > from;
+        return { end: i + 1, selfClosing, attributes: text3.slice(from, selfClosing ? i - 1 : i) };
       }
     }
   }
@@ -2467,7 +2467,7 @@ function removeUndefinedExpressions(body, warn) {
   visit(tree);
   if (edits.length === 0) return body;
   warn?.(`Expressions that use ${[...removed].map((name) => `"${name}"`).join(", ")} were removed so the page builds: ${removed.size === 1 ? "the name is" : "the names are"} not defined on this page. Define ${removed.size === 1 ? "the name" : "the names"} or escape the braces as \\{ \\} to show the text.`);
-  return edits.sort((a, b) => b.start - a.start).reduce((text2, edit) => text2.slice(0, edit.start) + text2.slice(edit.end), body);
+  return edits.sort((a, b) => b.start - a.start).reduce((text3, edit) => text3.slice(0, edit.start) + text3.slice(edit.end), body);
 }
 function normalizeFlowParagraphContainers(body) {
   if (!body.includes("<p")) return body;
@@ -2493,7 +2493,7 @@ function normalizeFlowParagraphContainers(body) {
     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);
+  return edits.sort((a, b) => b.offset - a.offset).reduce((text3, edit) => text3.slice(0, edit.offset) + edit.value + text3.slice(edit.offset + 1), body);
 }
 function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
   const runFern = platform === "fern";
@@ -2895,7 +2895,7 @@ const MintlifyComponents = {
 }
 function applyReplacements(source, replacements) {
   return replacements.sort((a, b) => b.start - a.start).reduce(
-    (text2, edit) => text2.slice(0, edit.start) + edit.value + text2.slice(edit.end),
+    (text3, edit) => text3.slice(0, edit.start) + edit.value + text3.slice(edit.end),
     source
   );
 }
@@ -3301,14 +3301,14 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
         }
         return;
       }
-      const text2 = content.toString("utf8");
-      const syntax = ts2.transpileModule(text2, {
+      const text3 = content.toString("utf8");
+      const syntax = ts2.transpileModule(text3, {
         fileName: path.replace(/\.d\.ts$/, ".ts"),
         reportDiagnostics: true,
         compilerOptions: { jsx: ts2.JsxEmit.Preserve, target: ts2.ScriptTarget.ESNext, module: ts2.ModuleKind.ESNext }
       });
       if (syntax.diagnostics?.some((diagnostic) => diagnostic.category === ts2.DiagnosticCategory.Error)) throw new Error("component source contains unsupported JavaScript or TypeScript syntax");
-      const ast = sourceFile(text2, path);
+      const ast = sourceFile(text3, path);
       if (ast.statements.some((statement) => ts2.isExpressionStatement(statement) && ts2.isStringLiteral(statement.expression) && statement.expression.text === "use server")) throw new Error("server-only component modules require manual migration");
       const edits = [];
       const dependencies = [];
@@ -3346,10 +3346,10 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
         if (!specifier.startsWith(".") && !specifier.startsWith("/")) {
           throw new Error(specifier.startsWith("@/") ? `path alias ${specifier} points to source-site code the migration does not copy` : `external package ${specifier} requires manual installation and review`);
         }
-        const target = resolveDependency(specifier, path);
-        visit(target);
-        dependencies.push(outputPath(target));
-        const nextPath = relative2(dirname(destination), outputPath(target)).replace(/\\/g, "/");
+        const target2 = resolveDependency(specifier, path);
+        visit(target2);
+        dependencies.push(outputPath(target2));
+        const nextPath = relative2(dirname(destination), outputPath(target2)).replace(/\\/g, "/");
         edits.push({ start: literal.getStart(ast), end: literal.end, value: JSON.stringify(portableSpecifier(nextPath.startsWith(".") ? nextPath : `./${nextPath}`)) });
       }
       function inspect(node) {
@@ -3364,7 +3364,7 @@ function createComponentMigrator(siteRoot, confinementRoot, warnings, sourceIden
         ts2.forEachChild(node, inspect);
       }
       inspect(ast);
-      const replaced = applyReplacements(text2, edits);
+      const replaced = applyReplacements(text3, edits);
       const shebangMatch = /^#!.*\r?\n/.exec(replaced);
       modules.set(destination, {
         local: needsClientBoundary(ast),
@@ -3915,10 +3915,10 @@ ${inlineSource}` });
       const start = node.position.start.offset;
       const end = node.position.end.offset;
       if (extracted.some((item) => start >= item.node.position.start.offset && end <= item.node.position.end.offset)) return;
-      const text2 = content.slice(start, end);
-      const opening = text2.indexOf(`<${node.name}`);
+      const text3 = content.slice(start, end);
+      const opening = text3.indexOf(`<${node.name}`);
       if (opening >= 0) edits.push({ start: start + opening + 1, end: start + opening + 1 + node.name.length, value: replacement });
-      const closing = text2.lastIndexOf(`</${node.name}`);
+      const closing = text3.lastIndexOf(`</${node.name}`);
       if (closing >= 0) edits.push({ start: start + closing + 2, end: start + closing + 2 + node.name.length, value: replacement });
     });
     walk(tree, (node) => {
@@ -4210,8 +4210,8 @@ function cssBrandVars(css) {
     if (prelude.startsWith("@")) continue;
     for (const selector of prelude.split(",")) {
       const name = selector.trim().toLowerCase();
-      const target = name === ":root" || name === "html" ? root : name === ".dark" || name === "html.dark" || name === ":root.dark" ? dark : void 0;
-      if (target) declarations(source.slice(open + 1, close - 1), target);
+      const target2 = name === ":root" || name === "html" ? root : name === ".dark" || name === "html.dark" || name === ":root.dark" ? dark : void 0;
+      if (target2) declarations(source.slice(open + 1, close - 1), target2);
     }
   }
   return { root, dark };
@@ -4379,9 +4379,9 @@ function jsonPointer(root, pointer) {
       const index = Number(token);
       return Number.isSafeInteger(index) && index >= 0 ? current[index] : void 0;
     }
-    const object = objectValue2(current);
-    if (!object) return void 0;
-    return object[token.replace(/~1/g, "/").replace(/~0/g, "~")];
+    const object2 = objectValue2(current);
+    if (!object2) return void 0;
+    return object2[token.replace(/~1/g, "/").replace(/~0/g, "~")];
   }, root);
 }
 function readMintlifyJson(path, repositoryRoot) {
@@ -4400,22 +4400,22 @@ function resolveJsonReferences(value, currentFile, repositoryRoot, stack) {
   if (Array.isArray(value)) {
     return value.map((entry) => resolveJsonReferences(entry, currentFile, repositoryRoot, stack));
   }
-  const object = objectValue2(value);
-  if (!object) return value;
-  if (typeof object.$ref === "string") {
-    const [filePart, pointer = ""] = object.$ref.split("#", 2);
+  const object2 = objectValue2(value);
+  if (!object2) return value;
+  if (typeof object2.$ref === "string") {
+    const [filePart, pointer = ""] = object2.$ref.split("#", 2);
     const referencedFile = filePart ? resolveWithin(dirname2(currentFile), filePart) : currentFile;
     const relativePath = relative3(repositoryRoot, referencedFile);
     resolveWithin(repositoryRoot, relativePath);
     const stackKey = `${referencedFile}#${pointer}`;
-    if (stack.has(stackKey)) throw new Error(`Circular Mintlify $ref: ${object.$ref}`);
+    if (stack.has(stackKey)) throw new Error(`Circular Mintlify $ref: ${object2.$ref}`);
     stack.add(stackKey);
     const referencedRoot = readMintlifyJson(referencedFile, repositoryRoot);
     const referenced = jsonPointer(referencedRoot, pointer ? `#${pointer}` : "");
     const resolved = resolveJsonReferences(referenced, referencedFile, repositoryRoot, stack);
     stack.delete(stackKey);
     const siblings = Object.fromEntries(
-      Object.entries(object).filter(([key]) => key !== "$ref").map(([key, entry]) => [
+      Object.entries(object2).filter(([key]) => key !== "$ref").map(([key, entry]) => [
         key,
         resolveJsonReferences(entry, currentFile, repositoryRoot, stack)
       ])
@@ -4423,7 +4423,7 @@ function resolveJsonReferences(value, currentFile, repositoryRoot, stack) {
     return objectValue2(resolved) ? { ...resolved, ...siblings } : resolved;
   }
   return Object.fromEntries(
-    Object.entries(object).map(([key, entry]) => [
+    Object.entries(object2).map(([key, entry]) => [
       key,
       resolveJsonReferences(entry, currentFile, repositoryRoot, stack)
     ])
@@ -4473,9 +4473,9 @@ function mintlifyNavigationApiReferences(config) {
       const entries = node[key];
       if (!Array.isArray(entries)) continue;
       for (const entry of entries) {
-        const object = objectValue2(entry);
-        if (!object) continue;
-        visit(object, labelFor(object, tabLabel ?? "Documentation"));
+        const object2 = objectValue2(entry);
+        if (!object2) continue;
+        visit(object2, labelFor(object2, tabLabel ?? "Documentation"));
       }
     }
     for (const key of nestedKeys) {
@@ -4483,15 +4483,15 @@ function mintlifyNavigationApiReferences(config) {
       if (!Array.isArray(entries)) continue;
       for (const entry of entries) {
         if (typeof entry === "string") continue;
-        const object = objectValue2(entry);
-        if (object) visit(object, tabLabel);
+        const object2 = objectValue2(entry);
+        if (object2) visit(object2, tabLabel);
       }
     }
     if (Array.isArray(node.menu)) {
       const tab = tabLabel ?? "Documentation";
       const items = node.menu.flatMap((entry) => {
-        const object = objectValue2(entry);
-        return object ? [object] : [];
+        const object2 = objectValue2(entry);
+        return object2 ? [object2] : [];
       });
       const apiItems = items.filter((item) => specSource(item.openapi) || specSource(item.asyncapi));
       const soleContent = apiItems.length === 1 && !hasNavigationChildren(node) && !items.some(hasNavigationChildren);
@@ -4546,11 +4546,11 @@ function collectGatedSourceRefs(node, gate, out, limits, depth = 0) {
     for (const item of node) collectGatedSourceRefs(item, gate, out, limits, depth + 1);
     return;
   }
-  const object = objectValue2(node);
-  if (!object) return;
-  const reason = gate ?? navigationGateReason(object);
-  if (reason && typeof object.sourceRef === "string") out.set(object, reason);
-  for (const value of Object.values(object)) collectGatedSourceRefs(value, reason, out, limits, depth + 1);
+  const object2 = objectValue2(node);
+  if (!object2) return;
+  const reason = gate ?? navigationGateReason(object2);
+  if (reason && typeof object2.sourceRef === "string") out.set(object2, reason);
+  for (const value of Object.values(object2)) collectGatedSourceRefs(value, reason, out, limits, depth + 1);
 }
 function collectReferenceAccess(node, access, pathPrefix, out, depth = 0) {
   if (depth > SWEEP_DEPTH_LIMIT) return;
@@ -4558,20 +4558,20 @@ function collectReferenceAccess(node, access, pathPrefix, out, depth = 0) {
     for (const item of node) collectReferenceAccess(item, access, pathPrefix, out, depth + 1);
     return;
   }
-  const object = objectValue2(node);
-  if (!object) return;
-  const nested = descendNavigationAccess(access, navigationAccess(object));
+  const object2 = objectValue2(node);
+  if (!object2) return;
+  const nested = descendNavigationAccess(access, navigationAccess(object2));
   if (hasNavigationRules(nested)) {
-    const refs = [object.page, object.root, object.href, ...Array.isArray(object.pages) ? object.pages : []];
+    const refs = [object2.page, object2.root, object2.href, ...Array.isArray(object2.pages) ? object2.pages : []];
     for (const ref of refs) {
       if (typeof ref === "string" && normalizePageRef(ref, pathPrefix)) out.push({ ref, access: nested });
     }
   }
-  for (const value of Object.values(object)) collectReferenceAccess(value, nested, pathPrefix, out, depth + 1);
+  for (const value of Object.values(object2)) collectReferenceAccess(value, nested, pathPrefix, out, depth + 1);
 }
-function withContainerAccess(object, context, walk2) {
+function withContainerAccess(object2, context, walk2) {
   const outer = context.access;
-  context.access = descendNavigationAccess(outer, navigationAccess(object));
+  context.access = descendNavigationAccess(outer, navigationAccess(object2));
   try {
     return walk2();
   } finally {
@@ -4624,9 +4624,9 @@ function convertPage(value, context) {
     }
     return registerReference(value, context);
   }
-  const object = objectValue2(value);
-  if (!object) return null;
-  return withContainerAccess(object, context, () => convertPageObject(object, context));
+  const object2 = objectValue2(value);
+  if (!object2) return null;
+  return withContainerAccess(object2, context, () => convertPageObject(object2, context));
 }
 function gatedSourceRef(repo, context) {
   if (!context.gatedSourceRefs.includes(repo)) context.gatedSourceRefs.push(repo);
@@ -4637,10 +4637,10 @@ function gatedSourceRef(repo, context) {
   );
   return null;
 }
-function convertPageObject(object, context) {
-  if (typeof object.page === "string") return registerReference(object.page, context);
-  const href = projectedHref(object.href);
-  if (href && !object.pages && !object.groups) {
+function convertPageObject(object2, context) {
+  if (typeof object2.page === "string") return registerReference(object2.page, context);
+  const href = projectedHref(object2.href);
+  if (href && !object2.pages && !object2.groups) {
     const page = registerReference(href, context);
     if (page) return page;
     warnOnce(
@@ -4650,25 +4650,25 @@ function convertPageObject(object, context) {
     );
     return null;
   }
-  if (typeof object.sourceRef === "string") {
-    if (isNavigationRestricted(context.access) || context.gatedNodes.has(object) || context.limits.tooDeep) return gatedSourceRef(object.sourceRef, context);
-    const imported = context.resolveSourceRef?.(object.sourceRef);
-    if (imported) return { group: object.sourceRef.split("/").pop() ?? object.sourceRef, pages: imported };
+  if (typeof object2.sourceRef === "string") {
+    if (isNavigationRestricted(context.access) || context.gatedNodes.has(object2) || context.limits.tooDeep) return gatedSourceRef(object2.sourceRef, context);
+    const imported = context.resolveSourceRef?.(object2.sourceRef);
+    if (imported) return { group: object2.sourceRef.split("/").pop() ?? object2.sourceRef, pages: imported };
     const where = context.groupLabel ? `the "${context.groupLabel}" navigation group` : "the navigation";
     warnOnce(
       context,
-      `source-ref:${context.groupLabel ?? ""}:${object.sourceRef}`,
-      `Navigation in ${where} mounts the docs of the repository ${object.sourceRef} (sourceRef). Those pages were not migrated; pass --source-ref ${object.sourceRef}=<path> to import them.`
+      `source-ref:${context.groupLabel ?? ""}:${object2.sourceRef}`,
+      `Navigation in ${where} mounts the docs of the repository ${object2.sourceRef} (sourceRef). Those pages were not migrated; pass --source-ref ${object2.sourceRef}=<path> to import them.`
     );
     return null;
   }
-  const pages = Array.isArray(object.pages) ? object.pages : [];
-  if ("group" in object || pages.length > 0) {
+  const pages = Array.isArray(object2.pages) ? object2.pages : [];
+  if ("group" in object2 || pages.length > 0) {
     const children = [];
     const outerGroupLabel = context.groupLabel;
-    context.groupLabel = labelFor(object, "Documentation");
-    if (typeof object.root === "string") {
-      const root = registerReference(object.root, context);
+    context.groupLabel = labelFor(object2, "Documentation");
+    if (typeof object2.root === "string") {
+      const root = registerReference(object2.root, context);
       if (root) children.push(root);
     }
     try {
@@ -4688,9 +4688,9 @@ function convertPageObject(object, context) {
     }
     if (children.length === 0) return null;
     return {
-      group: labelFor(object, "Documentation"),
-      ...iconName(object.icon) ? { icon: iconName(object.icon) } : {},
-      ...object.hidden === true ? { hidden: true } : {},
+      group: labelFor(object2, "Documentation"),
+      ...iconName(object2.icon) ? { icon: iconName(object2.icon) } : {},
+      ...object2.hidden === true ? { hidden: true } : {},
       pages: children
     };
   }
@@ -4780,37 +4780,37 @@ function convertContainerToTabs(containerValue, context, fallbackTab, trace, dep
       entries.sort((left, right) => Number(objectValue2(right)?.default === true) - Number(objectValue2(left)?.default === true));
     }
     const tabs = entries.flatMap((value, index) => {
-      const object = objectValue2(value);
-      if (!object) return [];
-      const tab = labelFor(object, `${fallbackTab} ${index + 1}`);
-      const href = projectedHref(object.href);
-      const hasNestedContainers = [...containerKeys, "menu"].some((containerKey) => Array.isArray(object[containerKey]));
-      if (href && !object.pages && !object.groups && !hasNestedContainers) {
+      const object2 = objectValue2(value);
+      if (!object2) return [];
+      const tab = labelFor(object2, `${fallbackTab} ${index + 1}`);
+      const href = projectedHref(object2.href);
+      const hasNestedContainers = [...containerKeys, "menu"].some((containerKey) => Array.isArray(object2[containerKey]));
+      if (href && !object2.pages && !object2.groups && !hasNestedContainers) {
         return [{
           tab,
           href,
-          ...containerPresentation(object),
-          ...object.hidden === true ? { hidden: true } : {}
+          ...containerPresentation(object2),
+          ...object2.hidden === true ? { hidden: true } : {}
         }];
       }
-      const nested = withContainerAccess(object, context, () => convertContainerToTabs(object, context, tab, trace, depth + 1));
+      const nested = withContainerAccess(object2, context, () => convertContainerToTabs(object2, context, tab, trace, depth + 1));
       if (nested.length > 0) {
         if (nested.length === 1) {
           return [{
             ...nested[0],
             tab,
-            ...containerPresentation(object),
+            ...containerPresentation(object2),
             ...href ? { href } : {},
-            ...object.hidden === true ? { hidden: true } : {}
+            ...object2.hidden === true ? { hidden: true } : {}
           }];
         }
-        const presentation = containerPresentation(object);
+        const presentation = containerPresentation(object2);
         return nested.map((item, childIndex) => ({
           ...presentation,
           ...item,
           tab: `${tab}: ${item.tab}`,
           ...childIndex === 0 && href && !item.href ? { href } : {},
-          ...object.hidden === true ? { hidden: true } : {}
+          ...object2.hidden === true ? { hidden: true } : {}
         }));
       }
       return [];
@@ -5497,9 +5497,9 @@ function announcementMarkdown(message) {
     links.set(marker, destination && label ? `[${escapeText(label)}](${destination})` : escapeText(label));
     document(element).replaceWith(marker);
   });
-  let text2 = escapeText(document("body").text());
-  for (const [marker, link] of links) text2 = text2.replaceAll(marker, link);
-  return text2.trim();
+  let text3 = escapeText(document("body").text());
+  for (const [marker, link] of links) text3 = text3.replaceAll(marker, link);
+  return text3.trim();
 }
 function objectValue3(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -5595,8 +5595,8 @@ function registerPageAt(rawPath, base, context, navTitle, hidden = false) {
   context.sourcePathToNavigationId.set(sourcePath, navigationId);
   return navigationId;
 }
-function registerFolder(object, parentSegments, context) {
-  const rawPath = String(object.folder).trim();
+function registerFolder(object2, parentSegments, context) {
+  const rawPath = String(object2.folder).trim();
   let folder;
   try {
     folder = withinRealRoot(resolveWithinRoot(
@@ -5612,8 +5612,8 @@ function registerFolder(object, parentSegments, context) {
     warnOnce2(context, `fern-missing-folder-${rawPath}`, `Fern folder "${rawPath}" does not exist and was skipped.`);
     return null;
   }
-  const label = typeof object.title === "string" && object.title.trim() ? object.title.trim() : titleCase2(basename2(folder));
-  const segment = typeof object.slug === "string" || object["skip-slug"] === true ? segmentFor(object, label, context) : fernBasicSlug(basename2(folder));
+  const label = typeof object2.title === "string" && object2.title.trim() ? object2.title.trim() : titleCase2(basename2(folder));
+  const segment = typeof object2.slug === "string" || object2["skip-slug"] === true ? segmentFor(object2, label, context) : fernBasicSlug(basename2(folder));
   const segments = segment ? [...parentSegments, segment] : parentSegments;
   const visit = (directory, routeSegments, depth) => {
     if (depth > 12 || context.descriptors.length >= 5e3) {
@@ -5646,17 +5646,17 @@ function registerFolder(object, parentSegments, context) {
   addBareRouteRedirect(segments, pages, context);
   return { group: label, pages };
 }
-function registerPage(object, parentSegments, context) {
-  if (typeof object.path !== "string" || !object.path.trim()) return null;
-  const label = typeof object.page === "string" && object.page.trim() ? object.page.trim() : "Untitled";
-  const segment = segmentFor(object, label, context);
+function registerPage(object2, parentSegments, context) {
+  if (typeof object2.path !== "string" || !object2.path.trim()) return null;
+  const label = typeof object2.page === "string" && object2.page.trim() ? object2.page.trim() : "Untitled";
+  const segment = segmentFor(object2, label, context);
   const base = [...parentSegments, segment].filter(Boolean).join("/");
-  return registerPageAt(object.path, base, context, label, object.hidden === true) || null;
+  return registerPageAt(object2.path, base, context, label, object2.hidden === true) || null;
 }
-function isRestrictedNode(object) {
-  const viewers = object.viewers;
+function isRestrictedNode(object2) {
+  const viewers = object2.viewers;
   if (Array.isArray(viewers) ? viewers.length > 0 : typeof viewers === "string" ? viewers.trim() !== "" : viewers !== void 0 && viewers !== null && viewers !== false) return true;
-  const authed = object.authed;
+  const authed = object2.authed;
   return authed !== void 0 && authed !== null && authed !== false && !(typeof authed === "string" && ["", "false"].includes(authed.trim().toLowerCase()));
 }
 function restrictionMark(context) {
@@ -5667,67 +5667,67 @@ function markRestricted(context, mark) {
   context.restrictedApiSections.push(...context.apiSections.splice(mark.apis));
 }
 function convertNode(node, parentSegments, context) {
-  const object = objectValue3(node);
-  if (!object) return null;
+  const object2 = objectValue3(node);
+  if (!object2) return null;
   const walk2 = context.navigationWalk;
-  const reason = walk2.active.has(object) ? "cyclic section" : walk2.active.size >= 64 ? "section depth exceeds 64" : walk2.visits >= 5e3 ? "node budget exceeds 5000" : void 0;
+  const reason = walk2.active.has(object2) ? "cyclic section" : walk2.active.size >= 64 ? "section depth exceeds 64" : walk2.visits >= 5e3 ? "node budget exceeds 5000" : void 0;
   if (reason) {
     walk2.incomplete = true;
     warnOnce2(context, `navigation-${reason}`, `Fern navigation was skipped: ${reason}.`);
     return null;
   }
   walk2.visits++;
-  walk2.active.add(object);
+  walk2.active.add(object2);
   try {
-    if (isRestrictedNode(object)) {
+    if (isRestrictedNode(object2)) {
       const before = restrictionMark(context);
-      convertNodeContents({ ...object, viewers: void 0, authed: void 0 }, parentSegments, context);
+      convertNodeContents({ ...object2, viewers: void 0, authed: void 0 }, parentSegments, context);
       markRestricted(context, before);
       return null;
     }
-    return convertNodeContents(object, parentSegments, context);
+    return convertNodeContents(object2, parentSegments, context);
   } finally {
-    walk2.active.delete(object);
+    walk2.active.delete(object2);
   }
 }
-function convertNodeContents(object, parentSegments, context) {
-  if (typeof object.page === "string") {
-    const page = registerPage(object, parentSegments, context);
-    return object.hidden === true || context.hiddenInherited ? null : page;
+function convertNodeContents(object2, parentSegments, context) {
+  if (typeof object2.page === "string") {
+    const page = registerPage(object2, parentSegments, context);
+    return object2.hidden === true || context.hiddenInherited ? null : page;
   }
-  if (typeof object.folder === "string") {
-    const folder = registerFolder(object, parentSegments, object.hidden === true ? { ...context, hiddenInherited: true } : context);
-    return object.hidden === true || context.hiddenInherited ? null : folder;
+  if (typeof object2.folder === "string") {
+    const folder = registerFolder(object2, parentSegments, object2.hidden === true ? { ...context, hiddenInherited: true } : context);
+    return object2.hidden === true || context.hiddenInherited ? null : folder;
   }
-  if (typeof object.section === "string") {
-    const label = object.section;
-    const segment = segmentFor(object, label, context);
+  if (typeof object2.section === "string") {
+    const label = object2.section;
+    const segment = segmentFor(object2, label, context);
     const segments = segment ? [...parentSegments, segment] : parentSegments;
-    const contents = Array.isArray(object.contents) ? object.contents : [];
+    const contents = Array.isArray(object2.contents) ? object2.contents : [];
     const pages = [];
-    const hasOwnPath = typeof object.path === "string" && object.path.trim().length > 0;
+    const hasOwnPath = typeof object2.path === "string" && object2.path.trim().length > 0;
     if (hasOwnPath) {
-      const registered = registerPageAt(object.path, segments.join("/"), context, label, object.hidden === true);
+      const registered = registerPageAt(object2.path, segments.join("/"), context, label, object2.hidden === true);
       if (registered) pages.push(registered);
     }
     for (const child of contents) {
-      const converted = convertNode(child, segments, object.hidden === true ? { ...context, hiddenInherited: true } : context);
+      const converted = convertNode(child, segments, object2.hidden === true ? { ...context, hiddenInherited: true } : context);
       if (converted) pages.push(converted);
     }
     if (pages.length === 0) return null;
     if (!hasOwnPath && segment) addBareRouteRedirect(segments, pages, context);
-    if (object.hidden === true || context.hiddenInherited) return null;
+    if (object2.hidden === true || context.hiddenInherited) return null;
     return {
       group: label,
-      ...["open-by-default", "closed-by-default", true, false].includes(object.collapsed) ? { defaultOpen: object.collapsed === "open-by-default" || object.collapsed === false } : {},
-      ...typeof object.icon === "string" ? { icon: object.icon } : {},
-      ...object.hidden === true ? { hidden: true } : {},
+      ...["open-by-default", "closed-by-default", true, false].includes(object2.collapsed) ? { defaultOpen: object2.collapsed === "open-by-default" || object2.collapsed === false } : {},
+      ...typeof object2.icon === "string" ? { icon: object2.icon } : {},
+      ...object2.hidden === true ? { hidden: true } : {},
       pages
     };
   }
-  if (typeof object.link === "string") {
-    const label = object.link.trim();
-    const rawHref = typeof object.href === "string" ? object.href.trim() : "";
+  if (typeof object2.link === "string") {
+    const label = object2.link.trim();
+    const rawHref = typeof object2.href === "string" ? object2.href.trim() : "";
     let href;
     if (/^https?:\/\//i.test(rawHref) && !/[\\\u0000-\u0020\u007f]/.test(rawHref)) {
       try {
@@ -5736,26 +5736,26 @@ function convertNodeContents(object, parentSegments, context) {
       } catch {
       }
     }
-    if (label && href && object.hidden !== true && !context.hiddenInherited) {
+    if (label && href && object2.hidden !== true && !context.hiddenInherited) {
       if (!context.externalLinks.some((link) => link.label === label && link.href === href)) {
         context.externalLinks.push({ label, href });
       }
-    } else if (!href && object.hidden !== true && !context.hiddenInherited) {
+    } else if (!href && object2.hidden !== true && !context.hiddenInherited) {
       warnOnce2(context, `fern-link-${rawHref}`, `Fern navigation link "${label}" has an unsafe or invalid external URL and was skipped.`);
     }
     return null;
   }
-  if (typeof object.api === "string") {
-    const ownSegment = segmentFor(object, object.api, context);
+  if (typeof object2.api === "string") {
+    const ownSegment = segmentFor(object2, object2.api, context);
     context.apiSections.push({
-      name: typeof object["api-name"] === "string" ? object["api-name"] : object.api,
-      nameExplicit: typeof object["api-name"] === "string",
+      name: typeof object2["api-name"] === "string" ? object2["api-name"] : object2.api,
+      nameExplicit: typeof object2["api-name"] === "string",
       routeSegments: ownSegment ? [...parentSegments, ownSegment] : parentSegments
     });
     return null;
   }
-  if (typeof object.changelog === "string") {
-    return registerFolder({ folder: object.changelog, title: "Changelog", "skip-slug": true }, parentSegments, context);
+  if (typeof object2.changelog === "string") {
+    return registerFolder({ folder: object2.changelog, title: "Changelog", "skip-slug": true }, parentSegments, context);
   }
   return null;
 }
@@ -6258,8 +6258,8 @@ function expandDocusaurusDocCardLists(pages, config, sourceRoutes) {
     const cards = group.pages.flatMap((item) => {
       if (typeof item === "string") {
         if (item === page.navigationId) return [];
-        const target = pageByRoute.get(item);
-        return [{ title: target?.title ?? item.split("/").at(-1) ?? item, route: item }];
+        const target2 = pageByRoute.get(item);
+        return [{ title: target2?.title ?? item.split("/").at(-1) ?? item, route: item }];
       }
       const slug2 = slugifySegment(item.group);
       const routes = [...item.pages].flatMap((child) => typeof child === "string" ? [child] : []);
@@ -6284,23 +6284,23 @@ function rewriteDocusaurusLinks(body, current, descriptors, options = {}) {
     if (sourceRoute) routes.set(sourceRoute, descriptor.navigationId);
   }
   const currentDirectory = posix3.dirname(sourceReferenceKey(current.sourcePath));
-  function copiedAssetTarget(target) {
-    if (!target.startsWith("/") || target.startsWith("//") || target.includes("\\")) return null;
-    const suffixIndex = target.search(/[?#]/);
-    const path = suffixIndex >= 0 ? target.slice(0, suffixIndex) : target;
-    const suffix = suffixIndex >= 0 ? target.slice(suffixIndex) : "";
+  function copiedAssetTarget(target2) {
+    if (!target2.startsWith("/") || target2.startsWith("//") || target2.includes("\\")) return null;
+    const suffixIndex = target2.search(/[?#]/);
+    const path = suffixIndex >= 0 ? target2.slice(0, suffixIndex) : target2;
+    const suffix = suffixIndex >= 0 ? target2.slice(suffixIndex) : "";
     if (path.startsWith("/docs/") && options.assetPaths?.has(path.slice("/docs/".length))) {
       return `/${path.slice("/docs/".length)}${suffix}`;
     }
-    return options.assetPaths?.has(path.slice(1)) ? target : null;
+    return options.assetPaths?.has(path.slice(1)) ? target2 : null;
   }
-  function rewriteTarget(target) {
-    if (!target || /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(target)) return target;
-    if (target.startsWith("#")) return target;
-    const suffixIndex = target.search(/[?#]/);
-    const path = suffixIndex >= 0 ? target.slice(0, suffixIndex) : target;
-    const suffix = suffixIndex >= 0 ? target.slice(suffixIndex) : "";
-    const copiedAsset = copiedAssetTarget(target);
+  function rewriteTarget(target2) {
+    if (!target2 || /^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(target2)) return target2;
+    if (target2.startsWith("#")) return target2;
+    const suffixIndex = target2.search(/[?#]/);
+    const path = suffixIndex >= 0 ? target2.slice(0, suffixIndex) : target2;
+    const suffix = suffixIndex >= 0 ? target2.slice(suffixIndex) : "";
+    const copiedAsset = copiedAssetTarget(target2);
     if (copiedAsset) return copiedAsset;
     const candidates = path.startsWith("/") ? [
       sourceReferenceKey(path),
@@ -6313,10 +6313,10 @@ function rewriteDocusaurusLinks(body, current, descriptors, options = {}) {
     const route = candidates.map((candidate) => routes.get(candidate)).find(Boolean);
     if (!route) {
       if (path.startsWith("/") && path !== "/" && options.sourceOrigin) {
-        options.onExternalLink?.(target);
-        return new URL(target, options.sourceOrigin).toString();
+        options.onExternalLink?.(target2);
+        return new URL(target2, options.sourceOrigin).toString();
       }
-      return target;
+      return target2;
     }
     return `${route === "introduction" ? "/" : `/${route}`}${suffix}`;
   }
@@ -6329,10 +6329,10 @@ function rewriteDocusaurusLinks(body, current, descriptors, options = {}) {
       return line;
     }
     if (codeFence) return line;
-    return line.replace(/(\]\()([^\s)]+)(?=[\s)]|$)/g, (_match, prefix, target) => `${prefix}${rewriteTarget(target)}`).replace(/(\bhref=")([^"]+)(")/g, (_match, prefix, target, suffix) => `${prefix}${rewriteTarget(target)}${suffix}`).replace(/(\bsrc=")([^"]+)(")/g, (_match, prefix, target, suffix) => `${prefix}${copiedAssetTarget(target) ?? target}${suffix}`).replace(/^(\s{0,3}\[[^\]]+\]:\s*)(<[^>]+>|\S+)/, (_match, prefix, destination) => {
+    return line.replace(/(\]\()([^\s)]+)(?=[\s)]|$)/g, (_match, prefix, target2) => `${prefix}${rewriteTarget(target2)}`).replace(/(\bhref=")([^"]+)(")/g, (_match, prefix, target2, suffix) => `${prefix}${rewriteTarget(target2)}${suffix}`).replace(/(\bsrc=")([^"]+)(")/g, (_match, prefix, target2, suffix) => `${prefix}${copiedAssetTarget(target2) ?? target2}${suffix}`).replace(/^(\s{0,3}\[[^\]]+\]:\s*)(<[^>]+>|\S+)/, (_match, prefix, destination) => {
       const bracketed = destination.startsWith("<") && destination.endsWith(">");
-      const target = bracketed ? destination.slice(1, -1) : destination;
-      const rewritten = rewriteTarget(target);
+      const target2 = bracketed ? destination.slice(1, -1) : destination;
+      const rewritten = rewriteTarget(target2);
       return `${prefix}${bracketed ? `<${rewritten}>` : rewritten}`;
     });
   }).join("\n");
@@ -6418,14 +6418,14 @@ function parseStaticSidebarModule(source) {
         literal
       );
       const parsed = JSON5.parse(substituted);
-      const object = objectValue4(parsed);
-      if (!object) continue;
+      const object2 = objectValue4(parsed);
+      if (!object2) continue;
       const bindingName = candidate[0].match(/\b(?:const|let|var)\s+([A-Za-z_$][\w$]*)/)?.[1];
       if (bindingName) {
-        bindings.set(bindingName, object);
+        bindings.set(bindingName, object2);
         continue;
       }
-      return object;
+      return object2;
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       const line = Number(message.match(/at (\d+):/)?.[1] ?? 0);
@@ -6514,8 +6514,8 @@ function configuredSidebarPath(repositoryRoot) {
     if (!existsSync4(path)) continue;
     const source = readBoundedText(path);
     for (const docs of source.matchAll(/\bdocs\s*:\s*/g)) {
-      const object = matchingObjectLiteral(source, (docs.index ?? 0) + docs[0].length);
-      const candidate2 = object && staticStringField(object, "sidebarPath")?.replace(/^\.\//, "");
+      const object2 = matchingObjectLiteral(source, (docs.index ?? 0) + docs[0].length);
+      const candidate2 = object2 && staticStringField(object2, "sidebarPath")?.replace(/^\.\//, "");
       if (candidate2) {
         const resolved2 = withinRealRoot(resolveWithin(repositoryRoot, candidate2), repositoryRoot);
         if (existsSync4(resolved2) && lstatSync4(resolved2).isFile()) return candidate2;
@@ -6626,12 +6626,12 @@ function readCategoryMetadata(contentRoot, directory) {
     try {
       const raw = readBoundedText(path);
       const parsed = filename.endsWith(".json") ? JSON5.parse(raw) : parseYaml3(raw);
-      const object = objectValue4(parsed);
-      if (!object) return {};
+      const object2 = objectValue4(parsed);
+      if (!object2) return {};
       return {
-        ...typeof object.label === "string" ? { label: object.label } : {},
-        ...typeof object.position === "number" ? { position: object.position } : {},
-        ..."link" in object ? { link: object.link } : {}
+        ...typeof object2.label === "string" ? { label: object2.label } : {},
+        ...typeof object2.position === "number" ? { position: object2.position } : {},
+        ..."link" in object2 ? { link: object2.link } : {}
       };
     } catch {
       return {};
@@ -6815,7 +6815,7 @@ function readDocusaurusSiteSettings(repositoryRoot) {
   const source = readBoundedText(configPath);
   const bindings = staticStringBindings(source);
   const presets = staticArrayField(source, "presets");
-  const classicDocs = presets && [...presets.matchAll(/["']?docs["']?\s*:\s*/g)].map((match) => matchingObjectLiteral(presets, (match.index ?? 0) + match[0].length)).find((object) => Boolean(object));
+  const classicDocs = presets && [...presets.matchAll(/["']?docs["']?\s*:\s*/g)].map((match) => matchingObjectLiteral(presets, (match.index ?? 0) + match[0].length)).find((object2) => Boolean(object2));
   const docsRouteBasePath = classicDocs && staticStringField(classicDocs, "routeBasePath") || "docs";
   const themeStart = propertyStart(source, "themeConfig");
   const theme = themeStart < 0 ? null : matchingObjectLiteral(source, themeStart);
@@ -6938,24 +6938,24 @@ function convertItems(value, context) {
     return page ? [page] : [];
   }
   if (Array.isArray(value)) return value.flatMap((entry) => convertItems(entry, context));
-  const object = objectValue4(value);
-  if (!object) return [];
-  if (object.type === "doc" || object.type === "ref") {
-    const page = typeof object.id === "string" ? registerDoc(object.id, context) : null;
+  const object2 = objectValue4(value);
+  if (!object2) return [];
+  if (object2.type === "doc" || object2.type === "ref") {
+    const page = typeof object2.id === "string" ? registerDoc(object2.id, context) : null;
     return page ? [page] : [];
   }
-  if (object.type === "autogenerated") {
-    return autogeneratedItems(typeof object.dirName === "string" ? object.dirName : ".", context);
+  if (object2.type === "autogenerated") {
+    return autogeneratedItems(typeof object2.dirName === "string" ? object2.dirName : ".", context);
   }
-  if (object.type === "category") {
-    const label = typeof object.label === "string" ? object.label : "Documentation";
-    const pages = convertItems(object.items, context);
-    const landing = generatedIndexPage(label, object.link, context);
+  if (object2.type === "category") {
+    const label = typeof object2.label === "string" ? object2.label : "Documentation";
+    const pages = convertItems(object2.items, context);
+    const landing = generatedIndexPage(label, object2.link, context);
     if (landing && !pages.includes(landing)) pages.unshift(landing);
     return pages.length > 0 ? [{ group: label, pages }] : [];
   }
-  if (object.type === "link" || object.type === "html") return [];
-  return Object.entries(object).flatMap(([label, items]) => {
+  if (object2.type === "link" || object2.type === "html") return [];
+  return Object.entries(object2).flatMap(([label, items]) => {
     const pages = convertItems(items, context);
     return pages.length > 0 ? [{ group: label, pages }] : [];
   });
@@ -7047,9 +7047,9 @@ function readDocusaurusPresentation(repositoryRoot) {
       if (rule.parent?.type !== "root") return;
       for (const selector of rule.selector.split(",")) {
         const key = selector.trim();
-        const target = key === ":root" || key === "html" || /^(?:html)?\[data-theme=['"]?light['"]?\]$/.test(key) ? modes.light : /^(?:html)?\[data-theme=['"]?dark['"]?\]$/.test(key) || key === ".dark" ? modes.dark : void 0;
-        if (target) rule.walkDecls((decl) => {
-          if (decl.prop.startsWith("--ifm-")) target.set(decl.prop, decl.value);
+        const target2 = key === ":root" || key === "html" || /^(?:html)?\[data-theme=['"]?light['"]?\]$/.test(key) ? modes.light : /^(?:html)?\[data-theme=['"]?dark['"]?\]$/.test(key) || key === ".dark" ? modes.dark : void 0;
+        if (target2) rule.walkDecls((decl) => {
+          if (decl.prop.startsWith("--ifm-")) target2.set(decl.prop, decl.value);
         });
         const banner = key === ".theme-announcement-bar" ? banners.light : /^(?:html)?\[data-theme=['"]?dark['"]?\] \.theme-announcement-bar$/.test(key) ? banners.dark : void 0;
         if (banner) rule.walkDecls((decl) => {
@@ -7072,9 +7072,9 @@ function readDocusaurusPresentation(repositoryRoot) {
     return raw ? cssColorToHex(raw) : void 0;
   };
   const mapped = { "--docs-bg": "--ifm-background-color", "--docs-ink": "--ifm-font-color-base", "--docs-ink-2": "--ifm-font-color-base", "--docs-accent": "--ifm-link-color" };
-  const declarations2 = (mode) => Object.entries(mapped).flatMap(([target, source]) => {
+  const declarations2 = (mode) => Object.entries(mapped).flatMap(([target2, source]) => {
     const hex = color(source, mode);
-    return hex ? [`${target}:${hex}`] : [];
+    return hex ? [`${target2}:${hex}`] : [];
   }).join(";");
   const heading = value("--ifm-heading-font-family", "light")?.trim();
   const headingFont = heading && /^[\w -]{1,80}$/.test(heading) ? heading : void 0;
@@ -7114,9 +7114,9 @@ function readDocusaurusPresentation(repositoryRoot) {
       const theme = literal ? JSON5.parse(literal) : null;
       const tokenNames = { keyword: "keyword", string: "string", comment: "comment", function: "function", property: "property", constant: "constant", punctuation: "punctuation", parameter: "parameter" };
       const colors = /* @__PURE__ */ new Map();
-      for (const [target, raw] of [["--shiki-color-text", theme?.plain?.color], ["--docs-code-bg", theme?.plain?.backgroundColor]]) {
+      for (const [target2, raw] of [["--shiki-color-text", theme?.plain?.color], ["--docs-code-bg", theme?.plain?.backgroundColor]]) {
         const hex = typeof raw === "string" ? cssColorToHex(raw) : void 0;
-        if (hex && target) colors.set(target, hex);
+        if (hex && target2) colors.set(target2, hex);
       }
       for (const style of theme?.styles ?? []) for (const type of Array.isArray(style.types) ? style.types : []) {
         const hex = typeof style.style?.color === "string" ? cssColorToHex(style.style.color) : void 0;
@@ -7209,10 +7209,10 @@ function withheldOperationKeys(spec, withheldRefs, keptRefs) {
 function markExcluded(content, operationKeys, keptKeys = []) {
   const untouched = { content, excluded: [] };
   if (operationKeys.length === 0) return untouched;
-  const text2 = content.toString("utf8");
+  const text3 = content.toString("utf8");
   let doc;
   try {
-    doc = parseYaml4(text2);
+    doc = parseYaml4(text3);
   } catch {
     return untouched;
   }
@@ -7231,14 +7231,14 @@ function markExcluded(content, operationKeys, keptKeys = []) {
     }
     const entry = doc.paths?.[name];
     if (!entry || typeof entry !== "object") continue;
-    const target = typeof entry.$ref === "string" ? keptKeys.some((k) => k.slice(k.indexOf(" ") + 1) === name) ? void 0 : entry : entry[method];
-    if (target && typeof target === "object") {
-      target["x-excluded"] = true;
+    const target2 = typeof entry.$ref === "string" ? keptKeys.some((k) => k.slice(k.indexOf(" ") + 1) === name) ? void 0 : entry : entry[method];
+    if (target2 && typeof target2 === "object") {
+      target2["x-excluded"] = true;
       excluded.push(`${method.toUpperCase()} ${name}`);
     }
   }
   if (excluded.length === 0) return untouched;
-  const out = text2.trimStart().startsWith("{") ? `${JSON.stringify(doc, null, 2)}
+  const out = text3.trimStart().startsWith("{") ? `${JSON.stringify(doc, null, 2)}
 ` : stringifyYaml(doc);
   return { content: Buffer.from(out), excluded };
 }
@@ -7580,7 +7580,12 @@ var LOCALE_CODES = /* @__PURE__ */ new Set([
 ]);
 var PORTABLE_URL_PROPS = "href|src|img|primaryHref|secondaryHref";
 var PORTABLE_URL_PROP_NAMES = new Set(PORTABLE_URL_PROPS.split("|"));
+var MINTLIFY_ARTICLE_LABELS = [
+  { baseUrl: "Select base URL", permalink: "Navigate to header" },
+  { baseUrl: "\u9009\u62E9\u57FA\u7840URL", permalink: "\u5BFC\u822A\u5230\u6807\u9898" }
+];
 var remoteMarkdownParser = unified3().use(remarkParse3).use(remarkMdx3);
+var embeddedOpenApiParser = unified3().use(remarkParse3);
 function validateMigrationUrl(value) {
   let url;
   try {
@@ -7875,6 +7880,43 @@ function escapeMarkdownText(value, escapeTableSeparator = false) {
   }
   return escaped;
 }
+function portableMarkdownTableCell(value) {
+  let output = "";
+  let hasOddBackslashes = false;
+  for (let index = 0; index < value.length; index += 1) {
+    const character = value[index];
+    if (character === "\\") {
+      output += character;
+      hasOddBackslashes = !hasOddBackslashes;
+      continue;
+    }
+    if (character === "|" && !hasOddBackslashes) output += "\\";
+    if (character === "\r" || character === "\n") {
+      output += " ";
+      if (character === "\r" && value[index + 1] === "\n") index += 1;
+    } else output += character;
+    hasOddBackslashes = false;
+  }
+  return output.trim();
+}
+function needsLiteralTableCode(value) {
+  let hasOddBackslashes = false;
+  for (const character of value) {
+    if (character === "\\") hasOddBackslashes = !hasOddBackslashes;
+    else {
+      if (character === "|" && hasOddBackslashes) return true;
+      hasOddBackslashes = false;
+    }
+  }
+  return false;
+}
+function literalMdxCodeText(value) {
+  let output = "";
+  for (const character of value) {
+    output += /[A-Za-z0-9 ]/.test(character) ? character : `&#${character.codePointAt(0)};`;
+  }
+  return output;
+}
 function markdownLinkDestination(value) {
   try {
     return encodeURI(value).replace(/\(/g, "%28").replace(/\)/g, "%29").replace(/&/g, "&amp;");
@@ -7962,6 +8004,11 @@ function sanitizeMarkdownUrls(value) {
       return;
     }
     if (node.type === "mdxJsxTextElement" || node.type === "mdxJsxFlowElement") {
+      const isLiteralCode = node.type === "mdxJsxTextElement" && node.name === "code" && !node.attributes?.length && (node.children ?? []).every((child) => child.type === "text");
+      if (!isLiteralCode && (!node.name || !PORTABLE_MDX_COMPONENTS.has(node.name))) {
+        hasUnsafeMdxSyntax = true;
+        return;
+      }
       for (const attribute of node.attributes ?? []) {
         if (attribute.type !== "mdxJsxAttribute" || !attribute.name || /^on[A-Z]/.test(attribute.name)) {
           hasUnsafeMdxSyntax = true;
@@ -8122,22 +8169,18 @@ function sanitizeRemoteMarkdown(body) {
     }
   }).replace(/\\[{}]/g, "");
   if (hasUnsafeExpression || /[{}]/.test(withoutStaticProps) || /\bon[A-Z][A-Za-z]*\s*=/g.test(withoutStaticProps) || hasUnsafePortableUrlProp(executable)) return null;
-  for (const match of withoutStaticProps.matchAll(/<\/?([A-Za-z][A-Za-z0-9.]*)(?:\s|>|\/)/g)) {
-    const component = match[1].split(".", 1)[0];
-    if (!PORTABLE_MDX_COMPONENTS.has(component)) return null;
-  }
   return urlSafeMarkdown;
 }
 function migratedHref(href, currentUrl, source, scopePath, importedIds, sourceHomePageId) {
   if (/^(?:javascript|data|vbscript):/i.test(href)) return "#";
   if (href.startsWith("#") || /^(?:mailto|tel):/i.test(href)) return href;
   try {
-    const target = new URL(href, currentUrl);
-    if (target.origin !== source.origin) return href;
-    if (scopePath === "/" && candidateIdentity(target) === candidateIdentity(source)) {
-      return `/${target.search}${target.hash}`;
+    const target2 = new URL(href, currentUrl);
+    if (target2.origin !== source.origin) return href;
+    if (scopePath === "/" && candidateIdentity(target2) === candidateIdentity(source)) {
+      return `/${target2.search}${target2.hash}`;
     }
-    let path = target.pathname;
+    let path = target2.pathname;
     if (scopePath !== "/" && (path === scopePath || path.startsWith(`${scopePath}/`))) {
       path = path.slice(scopePath.length);
     }
@@ -8150,9 +8193,9 @@ function migratedHref(href, currentUrl, source, scopePath, importedIds, sourceHo
     }
     if (importedDestinationId) {
       const destination = importedDestinationId === "introduction" ? "/" : `/${importedDestinationId}`;
-      return `${destination}${target.search}${target.hash}`;
+      return `${destination}${target2.search}${target2.hash}`;
     }
-    return target.toString();
+    return target2.toString();
   } catch {
     return href;
   }
@@ -8206,22 +8249,45 @@ function stripMintlifyDocumentationIndex(body) {
   return lines.slice(index).join("\n");
 }
 function extractEmbeddedOpenApi(content) {
-  const fencePattern = /^\s{0,3}(`{3,}|~{3,})(?:yaml|yml|json)\s+(\S+\.(?:yaml|yml|json))\s+(delete|get|head|options|patch|post|put|trace)\s+(\/\S+)\s*\r?\n([\s\S]*?)^\s{0,3}\1\s*$/im;
-  const match = fencePattern.exec(content);
-  if (!match) return { content };
+  if (Buffer.byteLength(content, "utf8") > MAX_LOCAL_RESPONSE_BYTES) return { content };
   try {
-    const parsed = parseYaml5(match[5], { maxAliasCount: 50 });
+    const root = embeddedOpenApiParser.parse(content);
+    const candidates = (root.children ?? []).flatMap((node2) => {
+      if (node2.type !== "code" || !/^(?:yaml|yml|json)$/i.test(node2.lang ?? "")) return [];
+      const metadata = node2.meta?.match(/^(?:(\S+\.(?:yaml|yml|json))\s+)?(delete|get|head|options|patch|post|put|trace)\s+(\/\S+)\s*$/i);
+      return metadata ? [{ node: node2, method: metadata[2].toUpperCase(), path: metadata[3] }] : [];
+    });
+    if (candidates.length !== 1) return { content };
+    const { node, method, path } = candidates[0];
+    const start = node.position?.start.offset;
+    const end = node.position?.end.offset;
+    if (start === void 0 || end === void 0) return { content };
+    const lines = content.slice(start, end).split(/\r?\n/);
+    const opening = lines[0].match(/^ {0,3}(`{3,}|~{3,})/);
+    const closing = lines.at(-1)?.match(/^ {0,3}(`{3,}|~{3,})[\t ]*$/);
+    if (!opening || !closing || opening[1][0] !== closing[1][0] || closing[1].length < opening[1].length) return { content };
+    const parsed = parseYaml5(node.value ?? "", { maxAliasCount: 50 });
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return { content };
     const document = parsed;
     if (typeof document.openapi !== "string" && typeof document.swagger !== "string") return { content };
-    const method = match[3].toUpperCase();
-    const path = match[4];
     const paths = document.paths;
     if (!paths || typeof paths !== "object" || Array.isArray(paths)) return { content };
+    if (!Object.prototype.hasOwnProperty.call(paths, path)) return { content };
     const pathItem = paths[path];
-    if (!pathItem || typeof pathItem !== "object" || Array.isArray(pathItem) || !(match[3].toLowerCase() in pathItem)) return { content };
-    const before = content.slice(0, match.index).replace(/(?:^|\n)##\s+OpenAPI\s*\n\s*$/i, "\n");
-    const after = content.slice(match.index + match[0].length);
+    if (!pathItem || typeof pathItem !== "object" || Array.isArray(pathItem) || !Object.prototype.hasOwnProperty.call(pathItem, method.toLowerCase())) return { content };
+    const operation = pathItem[method.toLowerCase()];
+    if (!operation || typeof operation !== "object" || Array.isArray(operation)) return { content };
+    let values = 0;
+    let textLength = 0;
+    const serialized = JSON.stringify(document, (_key, value) => {
+      values += 1;
+      if (typeof value === "string") textLength += value.length;
+      if (values > 1e5 || textLength > MAX_LOCAL_RESPONSE_BYTES || typeof value === "number" && !Number.isFinite(value)) throw new Error("OpenAPI document exceeds portable data limits.");
+      return value;
+    });
+    if (Buffer.byteLength(serialized, "utf8") > MAX_LOCAL_RESPONSE_BYTES) return { content };
+    const before = content.slice(0, start).replace(/(?:^|\n)##\s+OpenAPI\s*\n\s*$/i, "\n");
+    const after = content.slice(end);
     return {
       content: `${before}${after}`.trim(),
       openapi: `${method} ${path}`,
@@ -8272,15 +8338,15 @@ function markdownPage(document, id, platform, warn) {
     openApiFragment: embeddedOpenApi.fragment
   };
 }
-function mergeRecord(target, source) {
+function mergeRecord(target2, source) {
   if (!source || typeof source !== "object" || Array.isArray(source)) return;
   for (const [key, value] of Object.entries(source)) {
     if (["__proto__", "constructor", "prototype"].includes(key)) continue;
-    if (!Object.prototype.hasOwnProperty.call(target, key)) {
-      target[key] = value;
+    if (!Object.prototype.hasOwnProperty.call(target2, key)) {
+      target2[key] = value;
       continue;
     }
-    const current = target[key];
+    const current = target2[key];
     if (current && value && typeof current === "object" && typeof value === "object" && !Array.isArray(current) && !Array.isArray(value)) {
       mergeRecord(current, value);
     }
@@ -8326,14 +8392,74 @@ function mergeEmbeddedOpenApi(fragments) {
   if (tags.size > 0) combined.tags = [...tags.values()];
   return new TextEncoder().encode(stringifyYaml2(combined));
 }
+function migrationHtmlArticle(body) {
+  const $ = load2(body);
+  const root = ["main article", "article", "main", '[role="main"]', "body"].map((selector) => $(selector).first()).find((candidate) => candidate.length);
+  root.find([
+    "script",
+    "style",
+    "noscript",
+    "nav",
+    "footer",
+    "aside",
+    ".theme-doc-version-badge",
+    ".theme-doc-breadcrumbs",
+    ".theme-doc-toc-mobile",
+    ".table-of-contents",
+    ".chat-assistant-floating-input",
+    ".chat-assistant-sheet",
+    "#chat-assistant-sheet",
+    "#chat-assistant-textarea"
+  ].join(",")).remove();
+  const permalinkSelectors = MINTLIFY_ARTICLE_LABELS.map((labels) => `a[aria-label="${labels.permalink}"]`);
+  root.find([...permalinkSelectors, "h1 .hash-link", "h2 .hash-link", "h3 .hash-link", "h4 .hash-link", "h5 .hash-link", "h6 .hash-link"].join(",")).each((_index, link) => {
+    const parent = $(link).parent();
+    $(link).remove();
+    if (parent.is("div") && !parent.text().trim() && parent.children().length === 0) parent.remove();
+  });
+  root.find('svg.lucide-chevrons-up-down,summary[data-component-part="expandable-button"] svg[data-component-part="icon-svg"]').remove();
+  root.find('li.task-list-item > input[type="checkbox"][disabled]').each((_index, element) => {
+    const isChecked = $(element).attr("checked") !== void 0;
+    $(element).replaceWith($("<span></span>").attr("data-thally-static-task-checkbox", isChecked ? "checked" : "unchecked").text(isChecked ? "[x] " : "[ ] "));
+  });
+  root.find(MINTLIFY_ARTICLE_LABELS.map((labels) => `select[aria-label="${labels.baseUrl}"]`).join(",")).each((_index, element) => {
+    const select = $(element);
+    const options = select.children("option").toArray();
+    if (!options.length || options.length !== select.children().length) return;
+    const urls = [];
+    for (const option of options) {
+      if ($(option).children().length) return;
+      const label = $(option).text().trim();
+      if (!/^https:\/\//i.test(label) || /[\s\u0000-\u001f\u007f]/.test(label)) return;
+      try {
+        const url = new URL(label);
+        if (url.protocol !== "https:" || url.username || url.password) return;
+        urls.push({ label, href: url.href, isSelected: $(option).attr("selected") !== void 0 });
+      } catch {
+        return;
+      }
+    }
+    const projection = $("<div data-thally-static-base-urls></div>");
+    const sourceId = select.attr("id");
+    if (sourceId) projection.attr("id", sourceId);
+    projection.append($("<p></p>").text(select.attr("aria-label")));
+    const list = $("<ul></ul>");
+    for (const url of urls) {
+      const item = $("<li></li>").append($("<a></a>").attr("href", url.href).text(url.label));
+      if (url.isSelected) item.append(" (selected)");
+      list.append(item);
+    }
+    projection.append(list);
+    select.replaceWith(projection);
+  });
+  return { $, root };
+}
 function htmlPage(document, id, options = {}) {
-  const $ = load2(document.body);
-  const links = $('nav a[href], main a[href], article a[href], [role="main"] a[href]').map((_index, element) => $(element).attr("href") ?? "").get().filter(Boolean);
-  const scopedTitle = options.omitDocumentHeading ? $('main article, article, main, [role="main"]').first().find("h1").first().text().trim() : "";
+  const { $, root } = migrationHtmlArticle(document.body);
+  const links = root.find("a[href]").map((_index, element) => $(element).attr("href") ?? "").get().filter(Boolean);
+  const scopedTitle = options.omitDocumentHeading ? root.find("h1").first().text().trim() : "";
   const title = scopedTitle || $("main h1, article h1, h1").first().text().trim() || $('meta[property="og:title"]').attr("content")?.trim() || $("title").text().split("|")[0].trim();
   const description = $('meta[name="description"]').attr("content")?.trim() || $('meta[property="og:description"]').attr("content")?.trim();
-  const content = $('main article, article, main, [role="main"]').first();
-  const root = content.length ? content : $("body");
   let documentHeadingAnchor = "";
   const excludedElements = options.omitDocumentHeading ? "script,style,noscript,nav,footer,aside,form,button,svg,iframe,object,embed,link,meta" : "script,style,noscript,nav,header,footer,aside,form,button,svg,iframe,object,embed,link,meta";
   root.find(excludedElements).remove();
@@ -8347,6 +8473,9 @@ function htmlPage(document, id, options = {}) {
 `;
       heading.remove();
     }
+    root.find("h1").each((_index, element) => {
+      element.name = "h2";
+    });
   }
   root.find("a[href]").each((_index, element) => {
     const href = $(element).attr("href");
@@ -8376,8 +8505,20 @@ function htmlPage(document, id, options = {}) {
       $(element).removeAttr("src");
     }
   });
-  const turndown = new TurndownService({ codeBlockStyle: "fenced", emDelimiter: "_", headingStyle: "atx" });
+  const turndown = new TurndownService({ codeBlockStyle: "fenced", emDelimiter: "_", headingStyle: "atx", preformattedCode: true });
+  let isConvertingTableCell = false;
   turndown.remove(["script", "style", "noscript"]);
+  turndown.addRule("migration-literal-table-code", {
+    filter: (node) => isConvertingTableCell && node.nodeName === "CODE" && node.parentNode?.nodeName !== "PRE" && needsLiteralTableCode(node.textContent ?? ""),
+    // A strict, attribute-free text leaf preserves the payload that GFM's
+    // escaped-pipe code-span grammar cannot represent without changing it.
+    replacement: (_content, node) => `<code>${literalMdxCodeText(node.textContent ?? "")}</code>`
+  });
+  turndown.addRule("migration-static-task-checkbox", {
+    filter: (node) => node.nodeName === "SPAN" && ["checked", "unchecked"].includes(node.getAttribute("data-thally-static-task-checkbox") ?? ""),
+    // Emit literal task-list syntax rather than escaping its brackets as copy.
+    replacement: (_content, node) => node.getAttribute("data-thally-static-task-checkbox") === "checked" ? "[x] " : "[ ] "
+  });
   const anchor = (element) => {
     const value = element.getAttribute("id");
     return options.preserveAnchors && value ? `<a id="${value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/\{/g, "&#123;")}" />
@@ -8386,12 +8527,12 @@ function htmlPage(document, id, options = {}) {
   };
   if (options.preserveAnchors) turndown.addRule("migration-source-anchor", {
     filter: (node) => node.hasAttribute("id") && node.nodeName !== "PRE",
-    replacement: (content2, node) => {
+    replacement: (content, node) => {
       const element = node;
       const heading = element.nodeName.match(/^H([1-6])$/);
       return `
 
-${anchor(element)}${heading ? `${"#".repeat(Number(heading[1]))} ` : ""}${content2}
+${anchor(element)}${heading ? `${"#".repeat(Number(heading[1]))} ${content.trim()}` : content}
 
 `;
     }
@@ -8416,10 +8557,10 @@ ${anchor(element)}${heading ? `${"#".repeat(Number(heading[1]))} ` : ""}${conten
     });
     turndown.addRule("migration-responsive-picture", {
       filter: "picture",
-      replacement: (content2) => `
+      replacement: (content) => `
 
 <picture>
-${content2.trim()}
+${content.trim()}
 </picture>
 
 `
@@ -8481,10 +8622,15 @@ ${tabs.join("\n\n")}
     filter: "table",
     replacement: (_content, node) => {
       const fragment = load2(node.outerHTML);
-      const rows = fragment("tr").toArray().map((row) => fragment(row).children("th,td").toArray().map((cell) => escapeMarkdownText(
-        fragment(cell).text().replace(/\s+/g, " ").trim(),
-        true
-      ))).filter((row) => row.length > 0);
+      const rows = fragment("tr").toArray().map((row) => fragment(row).children("th,td").toArray().map((cell) => {
+        const wasConvertingTableCell = isConvertingTableCell;
+        isConvertingTableCell = true;
+        try {
+          return portableMarkdownTableCell(turndown.turndown(fragment(cell).html() ?? ""));
+        } finally {
+          isConvertingTableCell = wasConvertingTableCell;
+        }
+      })).filter((row) => row.length > 0);
       if (rows.length === 0) return "";
       const width = Math.max(...rows.map((row) => row.length));
       const normalized = rows.map((row) => [...row, ...Array(width - row.length).fill("")]);
@@ -8517,7 +8663,7 @@ ${fence}
     }
   });
   const escape = turndown.escape.bind(turndown);
-  turndown.escape = (text2) => escape(text2).replace(/[<{}]/g, (match) => `\\${match}`);
+  turndown.escape = (text3) => isConvertingTableCell ? escape(text3.replace(/[<>{}]/g, (character) => ({ "<": "&lt;", ">": "&gt;", "{": "&#123;", "}": "&#125;" })[character])) : escape(text3).replace(/[<{}]/g, (match) => `\\${match}`);
   const body = `${documentHeadingAnchor}${turndown.turndown(root.html() ?? "").trim()}`;
   if (!title || body.length < 40 && $("article").length === 0) return { page: null, links };
   return {
@@ -8602,9 +8748,9 @@ function deriveDocusaurusScope(source, document, submittedScopePath) {
     const href = $(element).attr("href");
     if (!href) return [];
     try {
-      const target = new URL(href, document.finalUrl);
-      if (target.origin !== source.origin || !isInScope(target, source, scopePath)) return [];
-      const relativePath = target.pathname.slice(scopePath.length).replace(/^\/+/, "");
+      const target2 = new URL(href, document.finalUrl);
+      if (target2.origin !== source.origin || !isInScope(target2, source, scopePath)) return [];
+      const relativePath = target2.pathname.slice(scopePath.length).replace(/^\/+/, "");
       const version = relativePath.split("/", 1)[0];
       if (!/^(?:legacy|next|v\d[\w.-]*)$/i.test(version)) return [];
       return [`${scopePath}/${version}`];
@@ -8645,11 +8791,11 @@ function docusaurusNavigationFromSnapshots(snapshots, pages, scopePath) {
     snapshot
   ])).values()];
   const mergedSnapshots = [];
-  function mergeItems(target, incoming) {
+  function mergeItems(target2, incoming) {
     for (const item of incoming) {
-      const existing = target.find((candidate) => candidate.label === item.label && (candidate.items || item.items)) ?? target.find((candidate) => candidate.label === item.label && candidate.href === item.href);
+      const existing = target2.find((candidate) => candidate.label === item.label && (candidate.items || item.items)) ?? target2.find((candidate) => candidate.label === item.label && candidate.href === item.href);
       if (!existing) {
-        target.push(structuredClone(item));
+        target2.push(structuredClone(item));
         continue;
       }
       if (!existing.href && item.href) existing.href = item.href;
@@ -8720,10 +8866,10 @@ function htmlTopLevelNavigation(document, source, scopePath) {
         const href = $(element).attr("href");
         if (!label || !href) return;
         try {
-          const target = new URL(href, document.finalUrl);
-          if (!isInScope(target, source, scopePath)) return;
+          const target2 = new URL(href, document.finalUrl);
+          if (!isInScope(target2, source, scopePath)) return;
           anchorCount += 1;
-          const targetId = canonicalLocalizedPageId(pageIdForUrl(target, scopePath) ?? "");
+          const targetId = canonicalLocalizedPageId(pageIdForUrl(target2, scopePath) ?? "");
           const pageId = targetId;
           const section = targetId.split("/", 1)[0] || "introduction";
           if (!pageId || seenSections.has(section)) return;
@@ -9137,8 +9283,8 @@ var SOURCE_REF_MAX_BYTES = 5e7;
 var SOURCE_REF_MAX_REPOSITORY_KB = 2e5;
 var DOCS_JSON_MAX_BYTES = 1e6;
 var MAX_FORWARDED_WARNINGS = 50;
-function stripControlCharacters(text2) {
-  return text2.replace(/\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07\x1b]*(?:\x07|\x1b\\)?|.)?/g, "").replace(/[\x00-\x08\x0b-\x1f\x7f]/g, "");
+function stripControlCharacters(text3) {
+  return text3.replace(/\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07\x1b]*(?:\x07|\x1b\\)?|.)?/g, "").replace(/[\x00-\x08\x0b-\x1f\x7f]/g, "");
 }
 var REPO_PATTERN = /^[A-Za-z0-9-]{1,39}\/[A-Za-z0-9._-]{1,100}$/;
 var MOUNT_PATTERN = /^[a-z0-9][a-z0-9._-]*(?:\/[a-z0-9][a-z0-9._-]*)*$/;
@@ -9240,8 +9386,8 @@ function sanitizeAndMeasure(root) {
   }
   return { removedLinks };
 }
-function mainSiteLinkTarget(target, mountPath, index, unresolved) {
-  const [, base, tail] = /^([^?#]*)([\s\S]*)$/.exec(target);
+function mainSiteLinkTarget(target2, mountPath, index, unresolved) {
+  const [, base, tail] = /^([^?#]*)([\s\S]*)$/.exec(target2);
   const key = base.replace(/^\/+|\/+$/g, "");
   if (!key) return void 0;
   const has = (set, id) => set.has(id) || set.has(`${id}/index`);
@@ -9254,14 +9400,14 @@ function mainSiteLinkTarget(target, mountPath, index, unresolved) {
     const rest = key.slice(slash + 1);
     if (has(index.main, rest) && !index.sections.has(first)) return found(rest);
   }
-  unresolved.push(target);
+  unresolved.push(target2);
   return void 0;
 }
 function prefixRootLinks(body, mountPath, resolve4, markdown = true) {
   const mounted = `/${mountPath}`;
-  const alreadyMounted = (target) => target === mounted || ["/", "?", "#"].some((next) => target.startsWith(mounted + next));
-  const fix = (target) => alreadyMounted(target) ? target : resolve4?.(target) ?? `${mounted}${target}`;
-  return replaceOutsideCodeAndComments(body, (text2) => text2.replace(markdown ? /(\]\(<?)(\/(?!\/)[^\s)>]*)/g : /(?!)/g, (_match, before, target) => `${before}${fix(target)}`).replace(/(\b(?:href|src|to|poster)=(['"]))(\/(?!\/)[^'"\n]*)\2/g, (_match, before, quote, target) => `${before}${fix(target)}${quote}`).replace(/(\b(?:href|src|to|poster)=\{\s*(['"]))(\/(?!\/)[^'"\n]*)\2(\s*\})/g, (_match, before, quote, target, after) => `${before}${fix(target)}${quote}${after}`).replace(markdown ? /^(\[[^\]\n]+\]:[ \t]*<?)(\/(?!\/)\S*)/gm : /(?!)/g, (_match, before, target) => `${before}${fix(target)}`));
+  const alreadyMounted = (target2) => target2 === mounted || ["/", "?", "#"].some((next) => target2.startsWith(mounted + next));
+  const fix = (target2) => alreadyMounted(target2) ? target2 : resolve4?.(target2) ?? `${mounted}${target2}`;
+  return replaceOutsideCodeAndComments(body, (text3) => text3.replace(markdown ? /(\]\(<?)(\/(?!\/)[^\s)>]*)/g : /(?!)/g, (_match, before, target2) => `${before}${fix(target2)}`).replace(/(\b(?:href|src|to|poster)=(['"]))(\/(?!\/)[^'"\n]*)\2/g, (_match, before, quote, target2) => `${before}${fix(target2)}${quote}`).replace(/(\b(?:href|src|to|poster)=\{\s*(['"]))(\/(?!\/)[^'"\n]*)\2(\s*\})/g, (_match, before, quote, target2, after) => `${before}${fix(target2)}${quote}${after}`).replace(markdown ? /^(\[[^\]\n]+\]:[ \t]*<?)(\/(?!\/)\S*)/gm : /(?!)/g, (_match, before, target2) => `${before}${fix(target2)}`));
 }
 function prefixNavigation(entries, mountPath) {
   return entries.map((entry) => typeof entry === "string" ? `${mountPath}/${entry}` : { ...entry, pages: prefixNavigation(entry.pages, mountPath) });
@@ -9320,8 +9466,8 @@ function importSourceRef(mapping, repositoryDir) {
   return { ...mapping, pages, assets, ...bundle.componentFiles?.length ? { componentFiles: bundle.componentFiles } : {}, navigation: prefixNavigation(flattenTabs(bundle.docsConfig), mapping.mountPath), warnings };
 }
 function sourceRefMountCollides(siteRoot, mountPath) {
-  const target = resolve3(siteRoot, mountPath);
-  return [target, `${target}.md`, `${target}.mdx`].some((candidate) => {
+  const target2 = resolve3(siteRoot, mountPath);
+  return [target2, `${target2}.md`, `${target2}.mdx`].some((candidate) => {
     try {
       lstatSync5(candidate);
       return true;
@@ -10050,14 +10196,14 @@ function scanFiles(root, confinementRoot = root, warnings, rank, budget = MAX_SO
         }
         const withinConfinement = real === confinementReal || real.startsWith(`${confinementReal}${sep3}`);
         if (!withinConfinement) continue;
-        let target;
+        let target2;
         try {
-          target = statSync(real);
+          target2 = statSync(real);
         } catch {
           continue;
         }
-        if (target.isDirectory()) visit(real, logicalPath);
-        else if (target.isFile()) files.push({ absolutePath: real, relativePath: relative6(root, logicalPath).replace(/\\/g, "/") });
+        if (target2.isDirectory()) visit(real, logicalPath);
+        else if (target2.isFile()) files.push({ absolutePath: real, relativePath: relative6(root, logicalPath).replace(/\\/g, "/") });
         continue;
       }
       if (entry.isDirectory()) visit(path, logicalPath);
@@ -10171,8 +10317,8 @@ var PATH_SEPARATORS = /[\s"'()<>[\]{}=,;:|\\`*!?#&]+/;
 function publicAssetKey(repoRelative) {
   return repoRelative.split("/", 1)[0].toLowerCase() === "public" ? repoRelative.slice("public/".length) : repoRelative;
 }
-function addPathReferences(text2, baseDir, exact, loose, docusaurus) {
-  for (const word of text2.split(PATH_SEPARATORS)) {
+function addPathReferences(text3, baseDir, exact, loose, docusaurus) {
+  for (const word of text3.split(PATH_SEPARATORS)) {
     let token = word.replace(/\.+$/, "");
     if (!/\.[a-z0-9]{2,5}$/i.test(token) || token.startsWith("//")) continue;
     if (token.includes("%")) {
@@ -10240,8 +10386,8 @@ function classifyApiSpec(path) {
   } catch {
     return "unknown";
   }
-  const text2 = buffer.toString("utf8", 0, bytesRead);
-  const topLevel = text2.match(/^(?:openapi|swagger|asyncapi)\s*:/m)?.[0] ?? text2.match(/^\s*\{\s*"(?:openapi|swagger|asyncapi)"\s*:/m)?.[0];
+  const text3 = buffer.toString("utf8", 0, bytesRead);
+  const topLevel = text3.match(/^(?:openapi|swagger|asyncapi)\s*:/m)?.[0] ?? text3.match(/^\s*\{\s*"(?:openapi|swagger|asyncapi)"\s*:/m)?.[0];
   if (!topLevel) return "unknown";
   return /asyncapi/i.test(topLevel) ? "asyncapi" : "openapi";
 }
@@ -10507,22 +10653,22 @@ function rewriteApiOperationLinks(body, linkMap, prefixLandings, unmatched) {
       return line;
     }
     if (codeFence) return line;
-    const rewriteTarget = (target) => {
-      const suffixIndex = target.search(/[?#]/);
-      const path = (suffixIndex >= 0 ? target.slice(0, suffixIndex) : target).replace(/^\/+/, "").toLowerCase();
-      const suffix = suffixIndex >= 0 ? target.slice(suffixIndex) : "";
+    const rewriteTarget = (target2) => {
+      const suffixIndex = target2.search(/[?#]/);
+      const path = (suffixIndex >= 0 ? target2.slice(0, suffixIndex) : target2).replace(/^\/+/, "").toLowerCase();
+      const suffix = suffixIndex >= 0 ? target2.slice(suffixIndex) : "";
       const mapped = linkMap.get(path);
       if (mapped) return `${mapped}${suffix}`;
       for (const [prefix, landing] of orderedPrefixes) {
         if (path === prefix) return `${landing}${suffix}`;
         if (path.startsWith(`${prefix}/`)) {
-          unmatched.add(target);
+          unmatched.add(target2);
           return `${landing}${suffix}`;
         }
       }
-      return target;
+      return target2;
     };
-    return line.replace(/(\]\()\/([^\s)]+)(?=[\s)]|$)/g, (_match, prefix, target) => `${prefix}${rewriteTarget(`/${target}`)}`).replace(/(\bhref=")\/([^"]+)(")/g, (_match, prefix, target, suffix) => `${prefix}${rewriteTarget(`/${target}`)}${suffix}`);
+    return line.replace(/(\]\()\/([^\s)]+)(?=[\s)]|$)/g, (_match, prefix, target2) => `${prefix}${rewriteTarget(`/${target2}`)}`).replace(/(\bhref=")\/([^"]+)(")/g, (_match, prefix, target2, suffix) => `${prefix}${rewriteTarget(`/${target2}`)}${suffix}`);
   }).join("\n");
 }
 var MAX_FERN_GENERATORS_BYTES = 2e6;
@@ -10683,10 +10829,10 @@ function withoutFencedCode3(raw) {
   }).join("\n");
 }
 function fernIfRolesReason(raw) {
-  const text2 = withoutFencedCode3(raw).replace(/(`{1,3})[^`\n]*\1/g, "");
+  const text3 = withoutFencedCode3(raw).replace(/(`{1,3})[^`\n]*\1/g, "");
   const marker = /<If(?![\w$.-])/g;
-  for (let match = marker.exec(text2); match; match = marker.exec(text2)) {
-    const tag = scanJsxOpeningTag(text2, match.index, "If");
+  for (let match = marker.exec(text3); match; match = marker.exec(text3)) {
+    const tag = scanJsxOpeningTag(text3, match.index, "If");
     marker.lastIndex = tag.next;
     if (tag.attributes.includes("...")) {
       return "it contains `<If>` spread props whose access rules cannot be resolved safely";
@@ -10899,70 +11045,70 @@ function fernSourceSiteUrl(config) {
   }
 }
 function externalizeMissingFernLinks(body, pageIds, sourceSiteUrl, externalized) {
-  const rewrite = (target) => {
-    const path = target.split(/[?#]/, 1)[0].replace(/^\//, "").replace(/\/$/, "");
-    if (!path || pageIds.has(path) || ASSET_EXTENSIONS.has(extname6(path).toLowerCase())) return target;
+  const rewrite = (target2) => {
+    const path = target2.split(/[?#]/, 1)[0].replace(/^\//, "").replace(/\/$/, "");
+    if (!path || pageIds.has(path) || ASSET_EXTENSIONS.has(extname6(path).toLowerCase())) return target2;
     try {
       const base = new URL(`${sourceSiteUrl}/`);
-      const sourceLinkUrl = new URL(target.slice(1), base);
-      if (sourceLinkUrl.origin !== base.origin) return target;
+      const sourceLinkUrl = new URL(target2.slice(1), base);
+      if (sourceLinkUrl.origin !== base.origin) return target2;
       const sourceLink = sourceLinkUrl.toString();
-      externalized.add(target);
+      externalized.add(target2);
       return sourceLink;
     } catch {
-      return target;
+      return target2;
     }
   };
-  return replaceOutsideCode(body, (text2) => text2.replace(/(\]\()\/(?!\/)([^\s)]+)(\))/g, (_match, before, target, after) => `${before}${rewrite(`/${target}`)}${after}`).replace(/(\b(?:href|to)=(['"]))\/(?!\/)([^'"\n]+)\2/g, (_match, before, quote, target) => `${before}${rewrite(`/${target}`)}${quote}`));
+  return replaceOutsideCode(body, (text3) => text3.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}`));
 }
 function stripFernBasePathFromLinks(body, basePath) {
   if (!basePath) return body;
   const escaped = basePath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  return replaceOutsideCode(body, (text2) => text2.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] === "/" ? "" : "/")));
+  return replaceOutsideCode(body, (text3) => text3.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 = (target) => {
-    const suffixAt = target.search(/[?#]/);
-    const pathname = suffixAt < 0 ? target : target.slice(0, suffixAt);
-    const suffix = suffixAt < 0 ? "" : target.slice(suffixAt);
-    if (!pathname.startsWith("/") || pathname.startsWith("//") || pathname.includes("\\")) return target;
+  const rewrite = (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;
     const segments = pathname.slice(1).split("/");
-    if (segments.some((segment) => !segment || segment === "." || segment === "..")) return target;
-    if (pageIds.has(segments.join("/"))) return target;
+    if (segments.some((segment) => !segment || segment === "." || segment === "..")) return target2;
+    if (pageIds.has(segments.join("/"))) return target2;
     for (let count = 1; count < segments.length && count <= 3; count++) {
       const candidate = segments.slice(count).join("/");
       if (pageIds.has(candidate)) return `/${candidate}${suffix}`;
     }
-    return target;
+    return target2;
   };
-  return replaceOutsideCode(body, (text2) => text2.replace(/(\]\()(\/[^\s)]+)(\))/g, (_match, before, target, after) => `${before}${rewrite(target)}${after}`).replace(/(\b(?:href|to)=(['"]))(\/[^'"\n]+)\2/g, (_match, before, quote, target) => `${before}${rewrite(target)}${quote}`));
+  return replaceOutsideCode(body, (text3) => text3.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}`));
 }
 function preserveLinkedAnchors(pages) {
   const pageById = new Map(pages.map((page) => [page.id, page]));
   const requested = /* @__PURE__ */ new Map();
   const crossPageRequests = /* @__PURE__ */ new Set();
-  const addTarget = (target, currentId) => {
-    const hash3 = target.indexOf("#");
+  const addTarget = (target2, currentId) => {
+    const hash3 = target2.indexOf("#");
     if (hash3 < 0) return;
     let fragment;
     try {
-      fragment = decodeURIComponent(target.slice(hash3 + 1));
+      fragment = decodeURIComponent(target2.slice(hash3 + 1));
     } catch {
       return;
     }
     if (!/^[\p{L}\p{N}_.:$-]{1,120}$/u.test(fragment)) return;
-    const path = target.slice(0, hash3).split("?")[0];
-    const id = target.startsWith("#") ? currentId : path.startsWith("/") && !path.startsWith("//") ? path.replace(/^\//, "").replace(/\/$/, "") || "introduction" : "";
+    const path = target2.slice(0, hash3).split("?")[0];
+    const id = target2.startsWith("#") ? currentId : path.startsWith("/") && !path.startsWith("//") ? path.replace(/^\//, "").replace(/\/$/, "") || "introduction" : "";
     if (!pageById.has(id)) return;
     if (!requested.has(id)) requested.set(id, /* @__PURE__ */ new Set());
     requested.get(id).add(fragment);
     if (id !== currentId) crossPageRequests.add(`${id}#${fragment}`);
   };
   for (const page of pages) {
-    replaceOutsideCode(page.body, (text2) => {
-      for (const match of text2.matchAll(/\]\(([^)\s]+)\)/g)) addTarget(match[1], page.id);
-      for (const match of text2.matchAll(/\b(?:href|to)=(['"])([^'"\n]+)\1/g)) addTarget(match[2], page.id);
-      return text2;
+    replaceOutsideCode(page.body, (text3) => {
+      for (const match of text3.matchAll(/\]\(([^)\s]+)\)/g)) addTarget(match[1], page.id);
+      for (const match of text3.matchAll(/\b(?:href|to)=(['"])([^'"\n]+)\1/g)) addTarget(match[2], page.id);
+      return text3;
     });
   }
   const comparable = (value) => value.replace(/&(?:lt|gt|amp|quot);/g, " ").toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "");
@@ -10970,12 +11116,12 @@ function preserveLinkedAnchors(pages) {
     const fragments = requested.get(page.id);
     if (!fragments?.size) continue;
     const definitions = /* @__PURE__ */ new Map();
-    replaceOutsideCodeAndComments(page.body, (text2) => {
-      for (const match of text2.matchAll(/^ {0,3}\[([^\]\n]+)\]:[^\n]*$/gm)) {
+    replaceOutsideCodeAndComments(page.body, (text3) => {
+      for (const match of text3.matchAll(/^ {0,3}\[([^\]\n]+)\]:[^\n]*$/gm)) {
         const label = match[1].trim().replace(/\s+/g, " ").toLowerCase();
         if (!definitions.has(label)) definitions.set(label, match[0]);
       }
-      return text2;
+      return text3;
     });
     const lines = page.body.split("\n");
     let fence;
@@ -10994,10 +11140,10 @@ function preserveLinkedAnchors(pages) {
       return match ? { index, text: mdxVisibleText(match[1].replace(/\s*\{\/\*\s*#\S+?\s*\*\/\}$/, ""), definitions) } : null;
     }).filter((entry) => entry !== null);
     const existing = /* @__PURE__ */ new Set();
-    replaceOutsideCode(page.body, (text2) => {
-      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;
+    replaceOutsideCode(page.body, (text3) => {
+      for (const match of text3.matchAll(/\bid=(?:"([^"]+)"|'([^']+)')/g)) existing.add(match[1] ?? match[2]);
+      for (const match of text3.matchAll(/\{\/\*\s*#(\S+?)\s*\*\/\}/g)) existing.add(match[1]);
+      return text3;
     });
     const candidateIndexes = /* @__PURE__ */ new Map();
     for (const heading of headings) {
@@ -11283,15 +11429,15 @@ function repositoryAssetHref(value, currentFile, siteRoot, onReferenced, onRootF
   }
 }
 function rewriteFernIdRenameLinks(body, renames) {
-  return replaceOutsideCode(body, (text2) => {
-    const rewriteTarget = (target) => {
-      const suffixIndex = target.search(/[?#]/);
-      const path = (suffixIndex >= 0 ? target.slice(0, suffixIndex) : target).replace(/^\/+/, "");
-      const suffix = suffixIndex >= 0 ? target.slice(suffixIndex) : "";
+  return replaceOutsideCode(body, (text3) => {
+    const rewriteTarget = (target2) => {
+      const suffixIndex = target2.search(/[?#]/);
+      const path = (suffixIndex >= 0 ? target2.slice(0, suffixIndex) : target2).replace(/^\/+/, "");
+      const suffix = suffixIndex >= 0 ? target2.slice(suffixIndex) : "";
       const renamed = renames.get(path);
-      return renamed ? `/${renamed}${suffix}` : target;
+      return renamed ? `/${renamed}${suffix}` : target2;
     };
-    return text2.replace(/(\]\()\/([^\s)]+)(?=[\s)]|$)/g, (_match, prefix, target) => `${prefix}${rewriteTarget(`/${target}`)}`).replace(/(\bhref=")\/([^"]+)(")/g, (_match, prefix, target, suffix) => `${prefix}${rewriteTarget(`/${target}`)}${suffix}`);
+    return text3.replace(/(\]\()\/([^\s)]+)(?=[\s)]|$)/g, (_match, prefix, target2) => `${prefix}${rewriteTarget(`/${target2}`)}`).replace(/(\bhref=")\/([^"]+)(")/g, (_match, prefix, target2, suffix) => `${prefix}${rewriteTarget(`/${target2}`)}${suffix}`);
   });
 }
 function rewriteRepositoryAssetLinks(body, currentFile, siteRoot, onReferenced, onRootFallback) {
@@ -12737,7 +12883,7 @@ ${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
       const descriptor = descriptorByNavigationId.get(page.navigationId);
       if (descriptor) page.body = rewriteDocusaurusLinks(page.body, descriptor, docusaurusDescriptors, {
         sourceOrigin,
-        onExternalLink: (target) => externalizedLinks.add(target),
+        onExternalLink: (target2) => externalizedLinks.add(target2),
         assetPaths: new Set(assets.map((asset) => asset.path))
       });
     }
@@ -12777,7 +12923,7 @@ ${warnings.map((warning) => `- ${warning.message}`).join("\n")}`);
   }
   if (platform === "fern" && fernSourceLinkAliases.size > 0) {
     const imported = new Set(pages.map((page) => page.id));
-    const aliases = new Map([...fernSourceLinkAliases].map(([source, target]) => [source, fernIdRenames.get(target) ?? target]).filter(([, target]) => imported.has(target)));
+    const aliases = new Map([...fernSourceLinkAliases].map(([source, target2]) => [source, fernIdRenames.get(target2) ?? target2]).filter(([, target2]) => imported.has(target2)));
     for (const page of pages) page.body = rewriteFernIdRenameLinks(page.body, aliases);
   }
   if (docsConfig.tabs.length === 0) docsConfig = buildNavigationFromPages(pages);
@@ -13104,7 +13250,7 @@ ${body}`;
     let count = 0;
     const unresolvedLinks = [];
     const linkIndex = rootLinkIndex();
-    const resolveLink = (target) => mainSiteLinkTarget(target, ref.mountPath, linkIndex, unresolvedLinks);
+    const resolveLink = (target2) => mainSiteLinkTarget(target2, ref.mountPath, linkIndex, unresolvedLinks);
     for (const sourcePage of ref.pages) {
       const page = { ...sourcePage, body: prefixRootLinks(sourcePage.body, ref.mountPath, resolveLink) };
       if (taken.has(page.id)) {
@@ -13124,7 +13270,7 @@ ${body}`;
     if (unresolved.length > 0) {
       warnings.push({
         code: "unsupported-config",
-        message: `[${ref.repo}] ${unresolved.length} root-absolute link target${unresolved.length === 1 ? "" : "s"} match no page in the sub-site or the main site and were kept under "${ref.mountPath}": ${unresolved.slice(0, 10).map((target) => stripControlCharacters(target)).join(", ")}${unresolved.length > 10 ? ", \u2026" : ""}.`
+        message: `[${ref.repo}] ${unresolved.length} root-absolute link target${unresolved.length === 1 ? "" : "s"} match no page in the sub-site or the main site and were kept under "${ref.mountPath}": ${unresolved.slice(0, 10).map((target2) => stripControlCharacters(target2)).join(", ")}${unresolved.length > 10 ? ", \u2026" : ""}.`
       });
     }
   }
@@ -13508,18 +13654,18 @@ function mergeMigrationConfig(existing, incoming) {
       names.add(tab.tab.toLowerCase());
       continue;
     }
-    const target = tabs.find((item) => item.tab.toLowerCase() === tab.tab.toLowerCase());
-    if (!target) continue;
+    const target2 = tabs.find((item) => item.tab.toLowerCase() === tab.tab.toLowerCase());
+    if (!target2) continue;
     const incomingRootNodes = [
       ...uniqueTab.pages ?? [],
       ...uniqueTab.groups ?? []
     ];
     if (uniqueTab.pages?.length) {
-      target.pages = [...target.pages ?? target.groups ?? [], ...incomingRootNodes];
-      delete target.groups;
+      target2.pages = [...target2.pages ?? target2.groups ?? [], ...incomingRootNodes];
+      delete target2.groups;
     } else if (uniqueTab.groups?.length) {
-      if (target.pages) target.pages = [...target.pages, ...uniqueTab.groups];
-      else target.groups = [...target.groups ?? [], ...uniqueTab.groups];
+      if (target2.pages) target2.pages = [...target2.pages, ...uniqueTab.groups];
+      else target2.groups = [...target2.groups ?? [], ...uniqueTab.groups];
     }
   }
   const changelog = existing.tabs.find((tab) => tab.tab.toLowerCase() === "changelog") ?? incoming.tabs.find((tab) => tab.tab.toLowerCase() === "changelog");
@@ -13566,7 +13712,7 @@ function renderMigrationFiles(bundle, options = {}) {
 
 // src/url-run.ts
 import { createHash as createHash3 } from "crypto";
-import { load as load3 } from "cheerio";
+import { load as load4 } from "cheerio";
 import remarkParse4 from "remark-parse";
 import remarkMdx4 from "remark-mdx";
 import { unified as unified4 } from "unified";
@@ -13803,20 +13949,20 @@ function utf8SvgText(content) {
   if (body[0] === 254 && body[1] === 255 || body[0] === 255 && body[1] === 254 || body[0] === 0 && body[1] === 0 || body.includes(0)) {
     return null;
   }
-  const text2 = body.toString("utf8");
-  if (text2.includes("\uFFFD")) return null;
-  const declaration = /^<\?xml\b[^>]*\?>/iu.exec(text2);
+  const text3 = body.toString("utf8");
+  if (text3.includes("\uFFFD")) return null;
+  const declaration = /^<\?xml\b[^>]*\?>/iu.exec(text3);
   if (declaration) {
     const encoding = /\bencoding\s*=\s*["']([^"']*)["']/iu.exec(declaration[0]);
     if (encoding && !/^utf-?8$/iu.test(encoding[1].trim())) return null;
-  } else if (/<\?xml\b/iu.test(text2)) {
+  } else if (/<\?xml\b/iu.test(text3)) {
     return null;
   }
-  return text2;
+  return text3;
 }
 function isPassiveSvg(content) {
-  const text2 = utf8SvgText(Buffer.from(content.buffer, content.byteOffset, content.byteLength));
-  if (text2 === null) return false;
+  const text3 = utf8SvgText(Buffer.from(content.buffer, content.byteOffset, content.byteLength));
+  if (text3 === null) return false;
   let isPassive = true;
   let depth = 0;
   let sawRoot = false;
@@ -13868,7 +14014,7 @@ function isPassiveSvg(content) {
     { xmlMode: true, decodeEntities: true, recognizeSelfClosing: true }
   );
   try {
-    parser3.write(text2);
+    parser3.write(text3);
     parser3.end();
   } catch {
     return false;
@@ -13943,8 +14089,276 @@ function cloneUrlMigrationCheckpoint(checkpoint) {
   return clone(checkpoint);
 }
 
+// src/url-navigation.ts
+import { load as load3 } from "cheerio";
+var MAX_CAPTURE_BYTES = 8e6;
+var MAX_JSON_BYTES = 2e6;
+var MAX_NODES = 1e4;
+var MAX_DEPTH = 32;
+var MAX_STRING_LENGTH = 8192;
+function object(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function text2(value) {
+  return typeof value === "string" && value.length <= MAX_STRING_LENGTH && value.trim() ? value.trim() : void 0;
+}
+function target(value, base) {
+  const reference = text2(value);
+  if (!reference) return void 0;
+  try {
+    const url = new URL(reference, base);
+    return ["https:", "http:"].includes(url.protocol) && !url.username && !url.password ? url.toString() : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function readJson(value) {
+  if (Buffer.byteLength(value) > MAX_JSON_BYTES) return void 0;
+  let depth = 0;
+  let quoted = false;
+  let escaped = false;
+  for (const char of value) {
+    if (quoted) {
+      if (escaped) escaped = false;
+      else if (char === "\\") escaped = true;
+      else if (char === '"') quoted = false;
+    } else if (char === '"') quoted = true;
+    else if (char === "[" || char === "{") {
+      if (++depth > 96) return void 0;
+    } else if (char === "]" || char === "}") depth--;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    return void 0;
+  }
+}
+function flightRecords(stream) {
+  const bytes = Buffer.from(stream);
+  const records = [];
+  let cursor = 0;
+  while (cursor < bytes.length) {
+    const colon = bytes.indexOf(58, cursor);
+    if (colon < 0 || colon - cursor > 16 || !/^[a-f\d]*$/i.test(bytes.toString("utf8", cursor, colon))) break;
+    cursor = colon + 1;
+    if (bytes[cursor] === 84) {
+      const comma = bytes.indexOf(44, cursor + 1);
+      const length = comma < 0 ? "" : bytes.toString("utf8", cursor + 1, comma);
+      if (!/^[a-f\d]{1,8}$/i.test(length)) break;
+      const end2 = comma + 1 + Number.parseInt(length, 16);
+      if (end2 > bytes.length) break;
+      cursor = end2;
+      continue;
+    }
+    const newline = bytes.indexOf(10, cursor);
+    const end = newline < 0 ? bytes.length : newline;
+    if (bytes[cursor] === 91 || bytes[cursor] === 123) records.push(readJson(bytes.toString("utf8", cursor, end)));
+    cursor = end + 1;
+  }
+  return records;
+}
+function mintlifyNavigation(body, base, locale) {
+  const $ = load3(body);
+  let stream = "";
+  const records = [];
+  $("script").each((_index, script) => {
+    const source = $(script).text();
+    const call = /^\s*self\.__next_f\.push\(\s*(\[[\s\S]*\])\s*\)\s*;?\s*$/.exec(source);
+    if (call) {
+      const value = readJson(call[1]);
+      if (Array.isArray(value) && value[0] === 1 && typeof value[1] === "string") stream += value[1];
+    } else if ($(script).attr("type") === "application/json") {
+      records.push(readJson(source));
+    }
+  });
+  records.push(...flightRecords(stream));
+  const candidates = [];
+  let visited = 0;
+  const visit = (value, depth = 0) => {
+    if (++visited > MAX_NODES * 5 || depth > 96) return;
+    if (Array.isArray(value)) {
+      for (const child of value) visit(child, depth + 1);
+    } else if (object(value)) {
+      for (const key of ["scopedNav", "docsNavWithMetadata", "anonymizedNav"]) {
+        if (object(value[key])) candidates.push({ value: value[key], rank: key === "scopedNav" ? 3 : 2 });
+      }
+      if (object(value.docsConfig) && object(value.docsConfig.navigation)) {
+        candidates.push({ value: value.docsConfig.navigation, rank: 1 });
+      }
+      for (const child of Object.values(value)) visit(child, depth + 1);
+    }
+  };
+  records.forEach((record) => visit(record));
+  const language = locale ?? text2($("html").attr("lang"));
+  for (const candidate of candidates.sort((a, b) => b.rank - a.rank)) {
+    let count = 0;
+    const walk2 = (value, depth = 0, activeLocale) => {
+      if (depth > MAX_DEPTH || ++count > MAX_NODES) throw new Error("Source navigation exceeds its safety bound.");
+      if (typeof value === "string") {
+        const url2 = target(value, new URL("/", base));
+        return url2 ? [{ kind: "page", label: value, url: url2 }] : [];
+      }
+      if (Array.isArray(value)) return value.flatMap((child) => walk2(child, depth + 1, activeLocale));
+      if (!object(value)) return [];
+      if (Array.isArray(value.languages)) {
+        const languages = value.languages.filter(object);
+        const current = new URL(base);
+        current.hash = "";
+        const routeScore = (item) => {
+          let visited2 = 0;
+          let matches = false;
+          let populated = 0;
+          const scan = (node, depth2 = 0) => {
+            if (++visited2 > MAX_NODES || depth2 > MAX_DEPTH) return;
+            if (Array.isArray(node)) {
+              for (const child of node) scan(child, depth2 + 1);
+              return;
+            }
+            if (!object(node)) return;
+            const href = target(node.href, base);
+            if (href) {
+              populated++;
+              const url2 = new URL(href);
+              url2.hash = "";
+              if (url2.toString() === current.toString()) matches = true;
+            }
+            for (const key of ["tabs", "groups", "pages", "dropdowns", "anchors", "versions"]) {
+              if (Array.isArray(node[key])) scan(node[key], depth2 + 1);
+            }
+          };
+          scan(item);
+          return matches ? populated : 0;
+        };
+        const matching = languages.map((item) => ({ item, score: routeScore(item) })).filter((candidate2) => candidate2.score > 0).sort((a, b) => b.score - a.score);
+        const selected = matching[0]?.item ?? languages.find((item) => text2(item.language)?.toLowerCase() === language?.toLowerCase()) ?? languages.find((item) => text2(item.language)?.toLowerCase() === "en") ?? languages[0];
+        return selected ? walk2({ ...selected, languages: void 0 }, depth + 1, text2(selected.language)) : [];
+      }
+      const label = text2(value.tab) ?? text2(value.group) ?? text2(value.title) ?? text2(value.label);
+      const kind = text2(value.tab) ? "tab" : text2(value.group) ? "group" : "page";
+      const children = ["tabs", "groups", "pages", "dropdowns", "anchors", "versions"].flatMap((key) => Array.isArray(value[key]) ? walk2(value[key], depth + 1, activeLocale) : []);
+      const url = target(value.href, base);
+      if (!label) return children;
+      if (!url && !children.length) return [];
+      return [{
+        kind,
+        label,
+        ...url ? { url } : {},
+        ...children.length ? { children } : {},
+        ...kind === "tab" && activeLocale ? { locale: activeLocale } : {}
+      }];
+    };
+    try {
+      const nodes = walk2(candidate.value);
+      if (nodes.length) return nodes;
+    } catch {
+    }
+  }
+  return [];
+}
+function resolveNavigation(nodes, base) {
+  let count = 0;
+  const walk2 = (items, depth = 0) => {
+    if (depth > MAX_DEPTH || !Array.isArray(items)) throw new Error("Invalid source navigation.");
+    return items.flatMap((node) => {
+      if (++count > MAX_NODES || !object(node)) throw new Error("Source navigation exceeds its safety bound.");
+      const label = text2(node.label);
+      if (!label) return [];
+      const url = target(node.url, base);
+      const children = node.children ? walk2(node.children, depth + 1) : [];
+      return [{
+        label,
+        ...url ? { url } : {},
+        ...children.length ? { children } : {},
+        ...["tab", "group", "page"].includes(node.kind ?? "") ? { kind: node.kind } : {},
+        ...text2(node.locale) ? { locale: text2(node.locale) } : {}
+      }];
+    });
+  };
+  return walk2(nodes);
+}
+function extractSourceNavigation(capture) {
+  if (capture.navigation) return resolveNavigation(capture.navigation, capture.finalUrl);
+  if (!/html/i.test(capture.contentType) || Buffer.byteLength(capture.body) > MAX_CAPTURE_BYTES) return [];
+  const mintlify = mintlifyNavigation(capture.body, capture.finalUrl, capture.locale);
+  if (mintlify.length) return mintlify;
+  const $ = load3(capture.body);
+  const candidates = ['.theme-doc-sidebar-menu,[aria-label*="sidebar" i]', "aside", '[role="navigation"],nav'];
+  const root = candidates.map((selector) => $(selector).filter((_index, node) => $(node).find("a[href]").length > 0 && $(node).closest("header").length === 0).first()).find((candidate) => candidate.length);
+  if (!root) return [];
+  let count = 0;
+  const walk2 = (element, excluded, depth = 0) => {
+    if (depth > MAX_DEPTH) throw new Error("Source navigation exceeds its safety bound.");
+    const result = [];
+    $(element).children().each((_index, node) => {
+      if (++count > MAX_NODES) throw new Error("Source navigation exceeds its safety bound.");
+      if (node === excluded) return;
+      const item = $(node);
+      if (item.is("a[href]")) {
+        const label = item.text().replace(/\s+/g, " ").trim();
+        const url = target(item.attr("href"), capture.finalUrl);
+        if (label && url) result.push({ label, url });
+      } else if (item.is("li,details") || item.attr("data-migration-group") !== void 0 || item.children("h2,h3,h4,h5,h6").length > 0) {
+        const directLink = item.children("a[href]").first();
+        const direct = directLink.length ? directLink : item.children("div").children("a[href]").first();
+        const label = direct.text().trim() || item.children("summary,button,span,h2,h3,h4,h5,h6").first().text().trim();
+        const children = walk2(node, direct[0], depth + 1);
+        const url = target(direct.attr("href"), capture.finalUrl);
+        if (label && (url || children.length)) result.push({ label, ...url ? { url } : {}, ...children.length ? { children } : {} });
+        else result.push(...children);
+      } else result.push(...walk2(node, excluded, depth + 1));
+    });
+    return result;
+  };
+  try {
+    return walk2(root);
+  } catch {
+    return [];
+  }
+}
+function placeholder(node) {
+  const children = node.children ?? [];
+  return node.kind === "tab" && children.length === 1 && children[0].kind === "page" && children[0].label === node.label && !children[0].children?.length;
+}
+function mergeSourceNavigation(existing, incoming) {
+  let count = 0;
+  const merge = (left, right, depth = 0) => {
+    if (depth > MAX_DEPTH || (count += left.length + right.length) > MAX_NODES * 4) throw new Error("Source navigation exceeds its safety bound.");
+    const result = left.map((node) => ({ ...node }));
+    const identity = (node) => JSON.stringify([
+      node.kind,
+      node.label,
+      node.locale,
+      node.kind === "tab" || node.kind === "group" ? void 0 : node.url
+    ]);
+    const positions = /* @__PURE__ */ new Map();
+    result.forEach((node, index) => {
+      const key = identity(node);
+      const siblings = positions.get(key) ?? [];
+      siblings.push(index);
+      positions.set(key, siblings);
+    });
+    const offsets = /* @__PURE__ */ new Map();
+    for (const next of right) {
+      const key = identity(next);
+      const offset = offsets.get(key) ?? 0;
+      const index = positions.get(key)?.[offset];
+      offsets.set(key, offset + 1);
+      if (index === void 0) {
+        result.push({ ...next });
+        continue;
+      }
+      const previous = result[index];
+      if (placeholder(previous) && !placeholder(next)) result[index] = { ...next };
+      else if (!placeholder(previous) && placeholder(next)) continue;
+      else result[index] = { ...previous, ...next, ...previous.children || next.children ? { children: merge(previous.children ?? [], next.children ?? [], depth + 1) } : {} };
+    }
+    return result;
+  };
+  return merge(existing, incoming);
+}
+
 // src/url-run.ts
-var CONVERTER_VERSION = "url-evidence-v2";
+var CONVERTER_VERSION = "url-evidence-v3";
 var parser2 = unified4().use(remarkParse4).use(remarkMdx4);
 var ACCEPT = "text/markdown,text/html,application/xhtml+xml;q=0.9";
 var MAX_RESPONSE_BYTES = 8e6;
@@ -13954,9 +14368,12 @@ var LOCALES = /* @__PURE__ */ new Set(["ar", "cs", "da", "de", "el", "en", "es",
 function hash2(value) {
   return createHash3("sha256").update(value).digest("hex");
 }
+function canonicalJson(value) {
+  const canonical2 = (value2) => Array.isArray(value2) ? value2.map(canonical2) : value2 !== null && typeof value2 === "object" ? Object.fromEntries(Object.entries(value2).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, field]) => [key, canonical2(field)])) : value2;
+  return JSON.stringify(canonical2(value));
+}
 function pageHash(page) {
-  const canonical2 = (value) => Array.isArray(value) ? value.map(canonical2) : value !== null && typeof value === "object" ? Object.fromEntries(Object.entries(value).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, field]) => [key, canonical2(field)])) : value;
-  return hash2(JSON.stringify(canonical2(page)));
+  return hash2(canonicalJson(page));
 }
 function inScope(url, source, scope) {
   return url.origin === source.origin && !url.username && !url.password && (scope === "/" || url.pathname === scope || url.pathname.startsWith(`${scope}/`));
@@ -13975,7 +14392,7 @@ function canonical(value, base) {
 }
 function classifyMigrationResponse(document) {
   if (document.status && document.status >= 400) return "unsupported";
-  if (/\/(?:llms(?:-full)?|robots)\.txt$|\/sitemap[^/]*\.xml$|\/search(?:\.html)?$/i.test(document.finalUrl.pathname) || /(?:xml|json)/i.test(document.contentType)) return "index";
+  if (/\/(?:llms(?:-full)?|robots)\.txt$|\/sitemap[^/]*\.xml$|\/search(?:\.html)?$/i.test(document.finalUrl.pathname) || /\.(?:json|ya?ml)$/i.test(document.finalUrl.pathname) || /(?:xml|json)/i.test(document.contentType)) return "index";
   if (/^(?:image|audio|video)\//i.test(document.contentType) || /\.(?:pdf|zip|png|jpe?g|webp|gif|svg|ico|mp4|webm)$/i.test(document.finalUrl.pathname)) return "asset";
   return /(?:html|markdown|text\/plain)/i.test(document.contentType) || /\.mdx?$/i.test(document.finalUrl.pathname) ? "page" : "unsupported";
 }
@@ -13997,14 +14414,14 @@ function alternativeBlocks(body, baseline) {
   return blocks(body).filter((block) => !originals.has(block)).join("\n\n");
 }
 function linksOf(document) {
+  if (/json|ya?ml/i.test(document.contentType) || /\.(?:json|ya?ml)$/i.test(document.finalUrl.pathname)) return [];
   if (/html/i.test(document.contentType)) {
-    const $ = load3(document.body);
-    const root = $('main article,article,main,[role="main"]').first();
+    const { $, root } = migrationHtmlArticle(document.body);
     root.find("nav,footer,aside").remove();
     return [...root.find("a[href]").toArray(), ...$('link[rel="sitemap"][href],link[rel="alternate"][href]').toArray()].map((node) => $(node).attr("href")).filter(Boolean);
   }
   if (/xml/i.test(document.contentType) || /<urlset|<sitemapindex/i.test(document.body)) {
-    const $ = load3(document.body, { xmlMode: true });
+    const $ = load4(document.body, { xmlMode: true });
     return $("loc").toArray().map((node) => $(node).text().trim());
   }
   return [
@@ -14013,8 +14430,7 @@ function linksOf(document) {
   ];
 }
 function htmlEvidence(document) {
-  const $ = load3(document.body);
-  const root = $('main article,article,main,[role="main"]').first();
+  const { $, root } = migrationHtmlArticle(document.body);
   const article = root.length ? root : $("body");
   article.find("nav,footer,aside,form,script,style").remove();
   return {
@@ -14041,55 +14457,35 @@ function evidenceOf(capture) {
 function markdownHeadingAnchors(body) {
   const seen = /* @__PURE__ */ new Map();
   return markdownNodes(body).filter((node) => node.type === "heading").map((node) => {
-    const text2 = (value) => value.value ?? (value.children ?? []).map(text2).join("");
-    const base = text2(node).toLowerCase().replace(/[^\p{L}\p{N}\s_-]/gu, "").replace(/\s/g, "-");
+    const text3 = (value) => value.value ?? (value.children ?? []).map(text3).join("");
+    const base = text3(node).toLowerCase().replace(/[^\p{L}\p{N}\s_-]/gu, "").replace(/\s/g, "-");
     const occurrence = seen.get(base) ?? 0;
     seen.set(base, occurrence + 1);
     return occurrence ? `${base}-${occurrence}` : base;
   });
 }
 function sourceNavigation(capture) {
-  if (capture.navigation) {
-    const resolve4 = (nodes, depth = 0) => {
-      if (depth > 32 || nodes.length > 1e4) throw new Error("Source navigation exceeds its depth or width safety bound.");
-      return nodes.map((node) => ({ label: node.label, ...node.url ? { url: new URL(node.url, capture.finalUrl).toString() } : {}, ...node.children ? { children: resolve4(node.children, depth + 1) } : {} }));
-    };
-    return resolve4(capture.navigation);
-  }
-  if (!/html/i.test(capture.contentType)) return [];
-  const $ = load3(capture.body);
-  const candidates = ['.theme-doc-sidebar-menu,[aria-label*="sidebar" i]', "aside", '[role="navigation"],nav'];
-  const root = candidates.map((selector) => $(selector).filter((_index, node) => $(node).find("a[href]").length > 0 && $(node).closest("header").length === 0).first()).find((candidate) => candidate.length) ?? $("aside").first();
-  if (!root.length) return [];
-  const walk2 = (element, excluded) => {
-    const result = [];
-    $(element).children().each((_index, node) => {
-      if (node === excluded) return;
-      const item = $(node);
-      if (item.is("a[href]")) {
-        result.push({ label: item.text().replace(/\s+/g, " ").trim(), url: new URL(item.attr("href"), capture.finalUrl).toString() });
-      } else if (item.is("li,details") || item.attr("data-migration-group") !== void 0 || item.children("h2,h3,h4,h5,h6").length > 0) {
-        const directLink = item.children("a[href]").first();
-        const direct = directLink.length ? directLink : item.children("div").children("a[href]").first();
-        const label = direct.text().trim() || item.children("summary,button,span,h2,h3,h4,h5,h6").first().text().trim();
-        const children = walk2(node, direct[0]);
-        if (label) result.push({ label, ...direct.length ? { url: new URL(direct.attr("href"), capture.finalUrl).toString() } : {}, ...children.length ? { children } : {} });
-        else result.push(...children);
-      } else result.push(...walk2(node, excluded));
-    });
-    return result;
-  };
-  try {
-    return walk2(root);
-  } catch {
-    return [];
-  }
+  return extractSourceNavigation(capture);
 }
 function idForUrl(url, scope) {
   const relative7 = scope === "/" ? url.pathname.slice(1) : url.pathname.slice(scope.length).replace(/^\//, "");
   const id = pageIdFromReference(relative7 || "introduction", true);
   return id && `${id}${url.search ? `--${hash2(url.search).slice(0, 12)}` : ""}`;
 }
+function articleIdentity(document) {
+  if (!/html/i.test(document.contentType)) return document.finalUrl;
+  const $ = load4(document.body);
+  const reference = $('link[rel="canonical"][href]').first().attr("href");
+  if (!reference) return document.finalUrl;
+  try {
+    const target2 = new URL(reference, document.finalUrl);
+    const source = document.finalUrl;
+    const directory = (path) => path.replace(/\/index\/?$/i, "").replace(/\/$/, "");
+    return target2.origin === source.origin && !target2.username && !target2.password && target2.search === source.search && directory(target2.pathname) === directory(source.pathname) ? target2 : source;
+  } catch {
+    return document.finalUrl;
+  }
+}
 function convert(document, id) {
   if (/html/i.test(document.contentType)) {
     const technical = htmlEvidence(document);
@@ -14107,9 +14503,20 @@ function convert(document, id) {
         const info = original.split("\n", 1)[0].replace(/^`+|^~+/, "");
         const code = technical.code[index];
         const fence = "`".repeat(Math.max(3, ...[...code.matchAll(/`+/g)].map((match) => match[0].length + 1)));
+        const lineStart = page.body.lastIndexOf("\n", start - 1) + 1;
+        const prefix = page.body.slice(lineStart, start);
+        let hasContainerPrefix = true;
+        for (const character of prefix) {
+          if (character !== " " && character !== "	" && character !== ">") {
+            hasContainerPrefix = false;
+            break;
+          }
+        }
+        const indent = hasContainerPrefix ? prefix : "";
+        const payload = code.split("\n").map((line) => `${indent}${line}`).join("\n");
         page.body = `${page.body.slice(0, start)}${fence}${info}
-${code}
-${fence}${page.body.slice(end)}`;
+${payload}
+${indent}${fence}${page.body.slice(end)}`;
       }
     }
     return page;
@@ -14121,16 +14528,14 @@ function assetReferences(capture) {
   if (!/html/i.test(capture.contentType)) {
     return markdownNodes(capture.body).filter((node) => node.type === "image").flatMap((node) => node.url ? [node.url] : []);
   }
-  const $ = load3(capture.body);
-  const root = $('main article,article,main,[role="main"]').first();
+  const { $, root } = migrationHtmlArticle(capture.body);
   return [
     ...root.find("img[src],video[poster],a[download][href]").toArray().map((node) => $(node).attr("src") ?? $(node).attr("poster") ?? $(node).attr("href")),
     ...root.find("[srcset]").toArray().flatMap((node) => migrationImageCandidates($(node).attr("srcset") ?? "", capture.finalUrl).map((candidate) => candidate.url))
   ].filter(Boolean);
 }
-function unresolvedStaticControls(body) {
-  const $ = load3(body);
-  const root = $('main article,article,main,[role="main"]').first();
+function unresolvedStaticControls(body, hasApiSchema = false) {
+  const { $, root } = migrationHtmlArticle(body);
   const tabs = root.find('[role="tab"]').toArray();
   for (const tab of tabs) {
     const controls = $(tab).attr("aria-controls");
@@ -14138,6 +14543,7 @@ function unresolvedStaticControls(body) {
     if (panels.length !== 1 || !panels.text().trim() && !panels.find("pre,img,table,svg").length || panels.find('[aria-busy="true"],[role="progressbar"]').length) return true;
   }
   return root.find("details:not([open])").toArray().some((node) => {
+    if (hasApiSchema && $(node).is(".expandable") && $(node).children('summary[data-component-part="expandable-button"]').length) return false;
     const clone = $(node).clone();
     clone.children("summary").remove();
     return !clone.text().trim() && !clone.find("pre,img,table,svg").length;
@@ -14175,13 +14581,47 @@ function acceptedAsset(asset) {
 }
 function validRecord(record) {
   if (record.outcome !== "imported") return true;
-  return Boolean(record.page && record.pageSha256 === pageHash(record.page) && record.evidence && pageIdFromReference(record.page.id, true) === record.page.id && pageIdFromReference(record.page.navigationId, true) === record.page.navigationId && sanitizeRemoteMarkdown(record.page.body.replace(/^<a id="[^"<]*" \/>$/gm, "")) !== null && /^[a-f0-9]{64}$/.test(record.evidence.sha256) && record.assets?.every((asset) => /^migration-assets\/[a-f0-9]{64}\.[a-z0-9]+$/.test(asset.path) && hash2(Buffer.from(asset.base64, "base64")) === asset.sha256));
+  return Boolean(record.page && record.pageSha256 === pageHash(record.page) && record.evidence && pageIdFromReference(record.page.id, true) === record.page.id && pageIdFromReference(record.page.navigationId, true) === record.page.navigationId && sanitizeRemoteMarkdown(record.page.body.replace(/^<a id="[^"<]*" \/>$/gm, "")) !== null && /^[a-f0-9]{64}$/.test(record.evidence.sha256) && (!record.apiSpecification || hasCompleteLocalApiSchema(record.apiSpecification.document) && record.apiSpecification.path === `openapi/migration-${record.apiSpecification.sha256}.json` && hash2(canonicalJson(record.apiSpecification.document)) === record.apiSpecification.sha256) && record.assets?.every((asset) => /^migration-assets\/[a-f0-9]{64}\.[a-z0-9]+$/.test(asset.path) && hash2(Buffer.from(asset.base64, "base64")) === asset.sha256));
+}
+function hasCompleteLocalApiSchema(document) {
+  let visited = 0;
+  const visit = (value, depth = 0) => {
+    if (++visited > 1e5 || depth > 96) return false;
+    if (typeof value === "number" && !Number.isFinite(value)) return false;
+    if (!value || typeof value !== "object") return true;
+    if (Array.isArray(value)) return value.every((child) => visit(child, depth + 1));
+    const object2 = value;
+    if (Object.prototype.hasOwnProperty.call(object2, "$ref")) {
+      if (typeof object2.$ref !== "string" || !object2.$ref.startsWith("#/")) return false;
+      let target2 = document;
+      try {
+        for (const encoded of object2.$ref.slice(2).split("/")) {
+          const key = decodeURIComponent(encoded).replace(/~1/g, "/").replace(/~0/g, "~");
+          if (!target2 || typeof target2 !== "object" || !Object.prototype.hasOwnProperty.call(target2, key)) return false;
+          target2 = target2[key];
+        }
+      } catch {
+        return false;
+      }
+    }
+    return Object.values(object2).every((child) => visit(child, depth + 1));
+  };
+  return visit(document);
+}
+function resolveMigrationRecord(records, record) {
+  const seen = /* @__PURE__ */ new Set();
+  while (record?.outcome === "alias") {
+    if (seen.has(record.url) || seen.size >= 32) return void 0;
+    seen.add(record.url);
+    record = records.get(record.aliasOf ?? "");
+  }
+  return record;
 }
 function navigationConfig(navigation, records) {
   const project2 = (nodes) => nodes.flatMap((node) => {
     const record = node.url ? records.get(canonical(node.url, node.url) ?? "") : void 0;
-    const target = record?.outcome === "alias" ? records.get(record.aliasOf ?? "") : record;
-    const page = target?.page;
+    const target2 = resolveMigrationRecord(records, record);
+    const page = target2?.page;
     const children = project2(node.children ?? []);
     if (children.length) {
       const contains = (entries) => entries.some((entry) => typeof entry === "string" ? entry === page?.navigationId : contains(entry.pages));
@@ -14189,6 +14629,23 @@ function navigationConfig(navigation, records) {
     }
     return page ? [page.navigationId] : [];
   });
+  const tabs = navigation.filter((node) => node.kind === "tab");
+  if (tabs.length) {
+    const projection = localeProjection({ records: [...records.values()] });
+    const locales = [...new Set(tabs.map((tab) => tab.locale ?? projection.defaultLocale))];
+    const localizedTabs = (locale) => tabs.filter((tab) => (tab.locale ?? projection.defaultLocale) === locale).flatMap((tab) => {
+      const pages2 = project2(tab.children ?? []);
+      return pages2.length || tab.url ? [{ tab: tab.label, ...pages2.length ? { pages: pages2 } : {}, ...tab.url ? { href: tab.url } : {} }] : [];
+    });
+    const primary = localizedTabs(projection.defaultLocale);
+    return { tabs: primary.length ? primary : localizedTabs(locales[0]), ...locales.length > 1 ? {
+      i18n: {
+        defaultLocale: projection.defaultLocale,
+        locales: locales.map((code) => ({ code, label: code === "en" ? "English" : code })),
+        navigation: Object.fromEntries(locales.map((locale) => [locale, localizedTabs(locale)]))
+      }
+    } : {} };
+  }
   const pages = project2(navigation);
   return pages.length ? { tabs: [{ tab: "Documentation", pages }] } : null;
 }
@@ -14210,7 +14667,7 @@ function observedLocale(document, id, scopePath) {
   }
   const urlLocale = [id.split("/", 1)[0], ...scopePath.split("/"), document.finalUrl.pathname.split("/").filter(Boolean)[0]].find((segment) => segment && LOCALES.has(segment.toLowerCase()));
   if (urlLocale) candidates.push({ source: "URL", value: canonicalLanguage(urlLocale) });
-  const declared = /html/i.test(document.contentType) ? load3(document.body)("html").attr("lang")?.trim() : void 0;
+  const declared = /html/i.test(document.contentType) ? load4(document.body)("html").attr("lang")?.trim() : void 0;
   if (declared) {
     const locale = canonicalLanguage(declared);
     if (locale) candidates.push({ source: "html lang", value: locale });
@@ -14245,6 +14702,7 @@ function localeProjection(checkpoint) {
 }
 function validateUrlMigration(checkpoint, cancelled = false) {
   const issues = [];
+  const warnings = [];
   const counts = { pending: 0, imported: 0, excluded: 0, failed: 0, alias: 0 };
   const records = new Map(checkpoint.records.map((record) => [record.url, record]));
   const source = new URL(checkpoint.sourceUrl);
@@ -14253,7 +14711,7 @@ function validateUrlMigration(checkpoint, cancelled = false) {
   const outputIds = /* @__PURE__ */ new Set();
   const resolve4 = (url) => {
     const record = records.get(canonical(url, checkpoint.sourceUrl) ?? "");
-    return record?.outcome === "alias" ? records.get(record.aliasOf ?? "") : record;
+    return resolveMigrationRecord(records, record);
   };
   for (const record of checkpoint.records) {
     counts[record.outcome]++;
@@ -14286,7 +14744,15 @@ function validateUrlMigration(checkpoint, cancelled = false) {
           anchor = decodeURIComponent(anchor);
         } catch {
         }
-        if (!destination.evidence?.anchors.includes(anchor)) issues.push({ code: "missing-anchor", source: record.url, message: `Missing source anchor: ${link}` });
+        if (!destination.evidence?.anchors.includes(anchor)) {
+          warnings.push({ code: "source-link-warning", source: record.url, message: `The original source link refers to an absent source anchor: ${link}` });
+        } else if (destination.page) {
+          const nodes = markdownNodes(destination.page.body);
+          const explicit = nodes.flatMap((node) => node.name === "a" ? (node.attributes ?? []).flatMap((attribute) => attribute.name === "id" && typeof attribute.value === "string" ? [attribute.value] : []) : []);
+          if (!explicit.includes(anchor) && !markdownHeadingAnchors(destination.page.body).includes(anchor)) {
+            issues.push({ code: "missing-anchor", source: record.url, message: `Conversion lost a source anchor: ${link}` });
+          }
+        }
       }
     }
   }
@@ -14301,7 +14767,7 @@ function validateUrlMigration(checkpoint, cancelled = false) {
   };
   visit(checkpoint.navigation);
   if (!counts.imported) issues.push({ code: "missing-page", source: checkpoint.sourceUrl, message: "No readable article pages were imported." });
-  return { status: cancelled ? "cancelled" : issues.length ? "partial" : "passed", issues, counts };
+  return { status: cancelled ? "cancelled" : issues.length ? "partial" : "passed", issues, counts, ...warnings.length ? { warnings } : {} };
 }
 async function runUrlMigration(options) {
   const source = validateMigrationUrl(options.sourceUrl);
@@ -14331,6 +14797,11 @@ async function runUrlMigration(options) {
       delete record.pageSha256;
       delete record.evidence;
       delete record.assets;
+      delete record.apiSpecification;
+      delete record.version;
+      delete record.issues;
+      delete record.reason;
+      delete record.aliasOf;
     }
     if (record.page && pageIdFromReference(record.page.id, true) !== record.page.id) throw new Error("Checkpoint contains an unsafe page path.");
     records.set(record.url, record);
@@ -14359,6 +14830,33 @@ async function runUrlMigration(options) {
   enqueue(sourceUrl, sourceUrl, "submitted");
   for (const path of ["llms.txt", "sitemap.xml", "robots.txt"]) enqueue(`${scopePath === "/" ? "" : scopePath}/${path}`, sourceUrl, "discovery-index");
   if (scopePath !== "/") for (const path of ["llms.txt", "sitemap.xml", "robots.txt"]) enqueue(`/${path}`, sourceUrl, "discovery-index");
+  const enqueueArticleLinks = (links, base, discoveredBy) => {
+    for (const link of links) {
+      try {
+        const url = new URL(link, base);
+        if (!/\.(?:png|jpe?g|gif|svg|webp|avif|pdf|zip|mp4|webm|css|js)$/i.test(url.pathname)) enqueue(link, base, discoveredBy);
+      } catch {
+      }
+    }
+  };
+  const enqueueNavigation = (nodes, base) => {
+    for (const node of nodes) {
+      if (node.url) enqueue(node.url, base, "source-navigation");
+      enqueueNavigation(node.children ?? [], base);
+    }
+  };
+  for (const record of [...records.values()]) {
+    if (!record.evidence) continue;
+    const final = canonical(record.evidence.finalUrl, sourceUrl);
+    if (!final) continue;
+    if (record.outcome === "imported") enqueueArticleLinks(record.evidence.links, final, record.url);
+    else if (record.outcome === "excluded") {
+      if (classifyMigrationResponse({ finalUrl: new URL(final), contentType: record.evidence.contentType, body: "" }) === "index") {
+        for (const link of record.evidence.links) enqueue(link, final, record.url);
+      }
+    }
+  }
+  enqueueNavigation(checkpoint.navigation, sourceUrl);
   const fetcher = options.fetcher ?? defaultMigrationFetcher;
   const capture = options.captureProvider?.capture.bind(options.captureProvider) ?? (async ({ url }) => fetcher(url, { accept: ACCEPT }));
   const assetFetcher = options.assetFetcher ?? (!options.fetcher && !options.captureProvider ? defaultAssetFetcher : void 0);
@@ -14394,13 +14892,24 @@ async function runUrlMigration(options) {
     navigationChanged = false;
   };
   const process2 = async (record) => {
-    if (options.signal?.aborted) return;
+    if (options.signal?.aborted || record.outcome !== "pending") return;
+    let claimedId;
+    let claimedFinal;
+    let markdownRepresentation;
     try {
       delete record.reason;
+      delete record.apiSpecification;
+      const represented = resolveMigrationRecord(records, record.representationOf ? records.get(record.representationOf) : void 0);
+      if (represented?.outcome === "imported") {
+        record.outcome = "alias";
+        record.aliasOf = represented.url;
+        return;
+      }
       const document = await capture({ url: new URL(record.url), signal: options.signal });
       if (options.signal?.aborted) return;
       if (Buffer.byteLength(document.body) > MAX_RESPONSE_BYTES) throw new Error("Captured response exceeds the 8 MB safety bound.");
-      const final = canonical(document.finalUrl.toString(), sourceUrl);
+      const identity = articleIdentity(document);
+      const final = canonical(identity.toString(), sourceUrl);
       const role = classifyMigrationResponse(document);
       if (!inScope(document.finalUrl, source, scopePath) && !(role === "index" && isDiscoveryIndex(document.finalUrl, source))) {
         record.outcome = "excluded";
@@ -14421,6 +14930,30 @@ async function runUrlMigration(options) {
         for (const link of links) enqueue(link, final, record.url);
         return;
       }
+      if (/html/i.test(document.contentType)) {
+        const $ = load4(document.body);
+        $('link[rel="alternate"][type="text/markdown"][href]').each((_index, node) => {
+          const alternate = canonical($(node).attr("href"), final);
+          if (!alternate) return;
+          const target2 = new URL(alternate), primary = new URL(final);
+          const directory = (path) => path.replace(/\.mdx?$/i, "").replace(/\/index\/?$/i, "").replace(/\/$/, "");
+          if (target2.origin !== primary.origin || target2.search !== primary.search || directory(target2.pathname) !== directory(primary.pathname) || !/\.mdx?$/i.test(target2.pathname)) return;
+          enqueue(alternate, final, "declared-markdown-representation");
+          const sibling = records.get(alternate);
+          sibling.representationOf = record.url;
+          markdownRepresentation ??= alternate;
+          changed.push(sibling);
+        });
+      }
+      const observedNavigation = sourceNavigation(document);
+      if (observedNavigation.length && !(checkpoint.navigation.some((node) => node.kind === "tab") && !observedNavigation.some((node) => node.kind === "tab"))) {
+        const merged = mergeSourceNavigation(checkpoint.navigation, observedNavigation);
+        if (JSON.stringify(merged) !== JSON.stringify(checkpoint.navigation)) {
+          checkpoint.navigation = merged;
+          navigationChanged = true;
+        }
+        enqueueNavigation(observedNavigation, final);
+      }
       if (imported >= maxPages) {
         record.outcome = "excluded";
         record.reason = "A discovery endpoint resolved to an article after the selected page limit.";
@@ -14433,14 +14966,20 @@ async function runUrlMigration(options) {
         return;
       }
       finalUrls.set(final, record.url);
-      const id = idForUrl(document.finalUrl, scopePath);
+      claimedFinal = final;
+      const id = idForUrl(identity, scopePath);
       if (!id) throw new Error("Source URL has no safe destination path.");
-      if (usedIds.has(id) && usedIds.get(id) !== record.url) {
+      const language = observedLocale(document, id, scopePath);
+      const locale = language.locale;
+      const navigationId = locale ? id.split("/").filter((segment) => segment.toLowerCase() !== locale.toLowerCase()).join("/") || "introduction" : id;
+      const identityId = locale ? `${locale}/${navigationId}` : id;
+      if (usedIds.has(identityId) && usedIds.get(identityId) !== record.url) {
         record.outcome = "failed";
-        record.reason = `Destination collision for ${id}.`;
+        record.reason = `Destination collision for ${identityId}.`;
         return;
       }
-      usedIds.set(id, record.url);
+      usedIds.set(identityId, record.url);
+      claimedId = identityId;
       const evidence = evidenceOf(document);
       const page = convert(document, id);
       if (!page) {
@@ -14448,6 +14987,23 @@ async function runUrlMigration(options) {
         record.reason = "Content could not be represented as safe inert MDX.";
         return;
       }
+      const hasSchemaChoice = /html/i.test(document.contentType) && migrationHtmlArticle(document.body).root.find('select[aria-label="Select schema type"],select[aria-label="\u9009\u62E9\u67B6\u6784\u7C7B\u578B"]').length > 0;
+      if (/html/i.test(document.contentType) && markdownRepresentation && (unresolvedStaticControls(document.body) || hasSchemaChoice)) {
+        const schemaCapture = await capture({ url: new URL(markdownRepresentation), signal: options.signal });
+        if (options.signal?.aborted) return;
+        if (schemaCapture.status && schemaCapture.status >= 400 || !/text\/(?:markdown|plain)/i.test(schemaCapture.contentType)) throw new Error("API schema representation is not a successful Markdown response.");
+        totalBytes += Buffer.byteLength(schemaCapture.body);
+        if (Buffer.byteLength(schemaCapture.body) > MAX_RESPONSE_BYTES || totalBytes > (options.maxTotalBytes ?? 5e8)) throw new Error("API schema capture exceeds its content byte budget.");
+        const expected = new URL(markdownRepresentation);
+        if (schemaCapture.finalUrl.origin !== expected.origin || schemaCapture.finalUrl.pathname !== expected.pathname || schemaCapture.finalUrl.search !== expected.search) throw new Error("API schema representation escaped its declared identity.");
+        const fragment = extractEmbeddedOpenApi(schemaCapture.body).fragment;
+        if (fragment && hasCompleteLocalApiSchema(fragment.document)) {
+          const sha256 = hash2(canonicalJson(fragment.document));
+          const path = `openapi/migration-${sha256}.json`;
+          record.apiSpecification = { path, sha256, document: fragment.document };
+          page.openapi = `${path} ${fragment.method} ${fragment.path}`;
+        }
+      }
       const states = document.states ?? [];
       if (states.length > 64) throw new Error("Capture contains too many alternative states.");
       for (const state of states) {
@@ -14476,14 +15032,16 @@ ${difference}`;
       record.assets = [];
       record.issues = [];
       if (/html/i.test(document.contentType)) {
-        const $ = load3(document.body);
-        const root = $('main article,article,main,[role="main"]').first();
+        const { $, root } = migrationHtmlArticle(document.body);
         root.find("nav,footer,aside,.theme-doc-breadcrumbs,.theme-doc-toc-mobile,.table-of-contents,.hash-link").remove();
         root.find('button svg,a.hash-link svg,[aria-hidden="true"] svg,svg[aria-hidden="true"],svg[data-lucide],svg[data-icon]').remove();
-        if (root.find("h1").length > 1) record.issues.push({ code: "unsupported-component", source: record.url, message: "The article contains multiple level-one headings; review their hierarchy." });
+        if (record.apiSpecification) {
+          root.find('select[aria-label="Select schema type"],select[aria-label="\u9009\u62E9\u67B6\u6784\u7C7B\u578B"]').remove();
+          root.find('.option-dropdown svg[data-component-part="icon-svg"]').remove();
+        }
         const unsupported = [...new Set(root.find("iframe,object,embed,canvas,svg,form,input,textarea,select,math,video,audio").toArray().map((node) => node.tagName))];
         if (unsupported.length) record.issues.push({ code: "unsupported-component", source: record.url, message: `Rendered content requires explicit review for: ${unsupported.join(", ")}.` });
-        if (!states.length && unresolvedStaticControls(document.body)) record.issues.push({ code: "unsupported-component", source: record.url, message: "An interactive alternative has no complete captured panel or disclosure content." });
+        if (!states.length && unresolvedStaticControls(document.body, Boolean(record.apiSpecification))) record.issues.push({ code: "unsupported-component", source: record.url, message: "An interactive alternative has no complete captured panel or disclosure content." });
       }
       const suppliedAssets = new Map((document.assets ?? []).map((asset) => [canonical(asset.url, final), asset]));
       const assetUrls = [...new Set([...assetReferences(document), ...states.flatMap((state) => assetReferences(state.response))].map((url) => canonical(url, final)).filter((url) => Boolean(url)))];
@@ -14523,42 +15081,18 @@ ${difference}`;
       if (sanitizeRemoteMarkdown(page.body.replace(/^<a id="[^"<]*" \/>$/gm, "")) === null) throw new Error("Converted content did not pass inert MDX validation.");
       record.evidence = evidence;
       record.page = page;
-      const language = observedLocale(document, page.id, scopePath);
       record.issues.push(...language.issues);
       const canonicalLocale = language.locale;
       if (canonicalLocale) {
         page.locale = canonicalLocale;
-        const segments = page.id.split("/");
-        const localeIndex = segments.findIndex((segment) => segment.toLowerCase() === canonicalLocale.toLowerCase());
-        page.navigationId = segments.filter((_segment, index) => index !== localeIndex).join("/") || "introduction";
+        page.navigationId = navigationId;
         page.id = `${canonicalLocale}/${page.navigationId}`;
-        if (usedIds.has(page.id) && usedIds.get(page.id) !== record.url) throw new Error(`Destination collision for locale page ${page.id}.`);
-        usedIds.delete(id);
-        usedIds.set(page.id, record.url);
       }
       record.version = document.version ?? [...page.id.split("/"), ...document.finalUrl.pathname.split("/")].find((segment) => /^v\d+(?:\.\d+)*$/i.test(segment));
       record.pageSha256 = pageHash(page);
       record.outcome = "imported";
       imported++;
-      const navigation = checkpoint.navigation.length ? [] : sourceNavigation(document);
-      if (!checkpoint.navigation.length && navigation.length) {
-        checkpoint.navigation = navigation;
-        navigationChanged = true;
-      }
-      for (const link of evidence.links) {
-        try {
-          const url = new URL(link, final);
-          if (!/\.(?:png|jpe?g|gif|svg|webp|avif|pdf|zip|mp4|webm|css|js)$/i.test(url.pathname)) enqueue(link, final, record.url);
-        } catch {
-        }
-      }
-      const visit = (nodes) => {
-        for (const node of nodes) {
-          if (node.url) enqueue(node.url, final, "source-navigation");
-          visit(node.children ?? []);
-        }
-      };
-      visit(navigation);
+      enqueueArticleLinks(evidence.links, final, record.url);
     } catch (error) {
       if (options.signal?.aborted) return;
       const wasImported = record.outcome === "imported";
@@ -14571,13 +15105,43 @@ ${difference}`;
       delete record.page;
       delete record.pageSha256;
       delete record.assets;
+      delete record.apiSpecification;
     } finally {
+      if (record.outcome !== "imported") {
+        if (claimedId && usedIds.get(claimedId) === record.url) usedIds.delete(claimedId);
+        if (claimedFinal && finalUrls.get(claimedFinal) === record.url) finalUrls.delete(claimedFinal);
+      }
       if (record.outcome !== "pending") {
         if (options.onRecord) await options.onRecord(record);
         changed.push(record);
       }
     }
   };
+  const settleRepresentations = () => {
+    for (const record of records.values()) {
+      if (!record.representationOf) continue;
+      const primary = resolveMigrationRecord(records, records.get(record.representationOf));
+      if (!primary) continue;
+      const winner = primary.outcome === "imported" ? primary : record.outcome === "imported" && primary.outcome === "failed" ? record : void 0;
+      if (!winner) continue;
+      const alternate = winner === primary ? record : primary;
+      if (alternate.outcome === "alias" && alternate.aliasOf === winner.url) continue;
+      if (alternate.outcome === "imported") {
+        imported--;
+        if (alternate.page && usedIds.get(alternate.page.id) === alternate.url) usedIds.delete(alternate.page.id);
+      }
+      alternate.outcome = "alias";
+      alternate.aliasOf = winner.url;
+      delete alternate.reason;
+      delete alternate.page;
+      delete alternate.pageSha256;
+      delete alternate.assets;
+      delete alternate.issues;
+      delete alternate.apiSpecification;
+      changed.push(alternate);
+    }
+  };
+  settleRepresentations();
   while (cursor < pending.length && !options.signal?.aborted && !budgetExhausted && cursor < (options.maxCaptures ?? Infinity)) {
     if (imported >= maxPages) {
       const index = pending.findIndex((record, position) => position >= cursor && isDiscoveryIndex(new URL(record.url), source));
@@ -14587,17 +15151,18 @@ ${difference}`;
     const batch = pending.slice(cursor, cursor + Math.min(concurrency, imported >= maxPages ? 1 : maxPages - imported, (options.maxCaptures ?? Infinity) - cursor));
     cursor += batch.length;
     await Promise.all(batch.map(process2));
+    settleRepresentations();
     if (changed.length >= batchSize) await flush();
   }
   await flush();
   const projection = localeProjection(checkpoint);
   const routeMap = /* @__PURE__ */ new Map();
   for (const record of checkpoint.records) {
-    const target = record.outcome === "alias" ? records.get(record.aliasOf ?? "") : record;
-    if (target?.page) {
-      const route = projection.route(target.page);
+    const target2 = resolveMigrationRecord(records, record);
+    if (target2?.page) {
+      const route = projection.route(target2.page);
       routeMap.set(record.url, route);
-      if (target.evidence) routeMap.set(canonical(target.evidence.finalUrl, sourceUrl), route);
+      if (target2.evidence) routeMap.set(canonical(target2.evidence.finalUrl, sourceUrl), route);
     }
   }
   const navigationLabels = /* @__PURE__ */ new Map();
@@ -14605,11 +15170,11 @@ ${difference}`;
   const labelPages = (nodes) => {
     for (const node of nodes) {
       const entry = node.url ? records.get(canonical(node.url, sourceUrl) ?? "") : void 0;
-      const target = entry?.outcome === "alias" ? records.get(entry.aliasOf ?? "") : entry;
-      if (target?.page && node.label && !node.children?.length) {
-        const previous = navigationLabels.get(target.url);
-        if (previous && previous !== node.label) navigationIssues.push({ code: "unsupported-component", source: target.url, message: `This page has multiple source navigation labels (${previous}, ${node.label}); review the shared sidebar title.` });
-        else navigationLabels.set(target.url, node.label);
+      const target2 = resolveMigrationRecord(records, entry);
+      if (target2?.page && node.label && !node.children?.length) {
+        const previous = navigationLabels.get(target2.url);
+        if (previous && previous !== node.label) navigationIssues.push({ code: "unsupported-component", source: target2.url, message: `This page has multiple source navigation labels (${previous}, ${node.label}); review the shared sidebar title.` });
+        else navigationLabels.set(target2.url, node.label);
       }
       labelPages(node.children ?? []);
     }
@@ -14635,6 +15200,10 @@ ${difference}`;
       assets.set(asset.path, { path: asset.path, content: Buffer.from(content.buffer, content.byteOffset, content.byteLength) });
     }
   }
+  for (const record of checkpoint.records) if (record.page && record.apiSpecification) {
+    const spec = record.apiSpecification;
+    assets.set(spec.path, { path: spec.path, projectRelative: true, content: Buffer.from(canonicalJson(spec.document)) });
+  }
   const bundle = {
     sourceUrl,
     sourceKind: "url",
@@ -14642,13 +15211,16 @@ ${difference}`;
     pages,
     assets: [...assets.values()],
     docsConfig: navigationConfig(checkpoint.navigation, records) ?? buildNavigationFromPages(pages),
-    warnings: validation.issues.map((issue) => ({ code: issue.code === "missing-page" ? "missing-page" : "unsupported-config", message: issue.message, source: issue.source })),
+    warnings: [...validation.issues, ...validation.warnings ?? []].map((issue) => ({ code: issue.code === "missing-page" ? "missing-page" : "unsupported-config", message: issue.message, source: issue.source })),
     urlMigrationValidation: validation,
     stats: { discovered: records.size, imported: pages.length, skipped: records.size - pages.length }
   };
   if (projection.locales.length) {
     const locales = [.../* @__PURE__ */ new Set([projection.defaultLocale, ...projection.locales])];
-    bundle.docsConfig.i18n = { defaultLocale: projection.defaultLocale, locales: locales.map((code) => ({ code, label: code === "en" ? "English" : code })) };
+    bundle.docsConfig.i18n = { ...bundle.docsConfig.i18n, defaultLocale: projection.defaultLocale, locales: locales.map((code) => ({ code, label: code === "en" ? "English" : code })) };
+  }
+  for (const spec of assets.values()) if (spec.projectRelative && spec.path.startsWith("openapi/")) {
+    bundle.docsConfig.tabs.push({ tab: `Migration API ${spec.path.slice(-69, -5)}`, hidden: true, api: { source: spec.path, navigation: false } });
   }
   const stopReason = options.signal?.aborted ? "cancelled" : budgetExhausted ? "byte-limit" : cursor < pending.length && cursor >= (options.maxCaptures ?? Infinity) ? "capture-limit" : imported >= maxPages && cursor < pending.length ? "page-limit" : cursor < pending.length ? "capture-limit" : "complete";
   return { bundle, checkpoint, validation, stopReason };
@@ -14793,8 +15365,8 @@ async function downloadSpec(value, fetcher) {
   throw new Error("Remote OpenAPI spec redirected too many times.");
 }
 function parseOpenApi(content, extension) {
-  const text2 = content.toString("utf8");
-  const parsed = extension === "yaml" || !text2.trimStart().startsWith("{") ? parseYaml7(text2) : JSON.parse(text2);
+  const text3 = content.toString("utf8");
+  const parsed = extension === "yaml" || !text3.trimStart().startsWith("{") ? parseYaml7(text3) : JSON.parse(text3);
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("OpenAPI spec is not an object.");
   const document = parsed;
   if (typeof document.openapi !== "string" || !/^3\./.test(document.openapi)) {