@thallylabs/migrate 0.2.39 → 0.2.40

package/dist/url-migration.js

@@ -1,9 +1,9 @@
 // src/url-run.ts
-import { createHash } from "crypto";
-import { load as load5 } from "cheerio";
-import remarkParse3 from "remark-parse";
-import remarkMdx3 from "remark-mdx";
-import { unified as unified3 } from "unified";
+import { createHash as createHash4 } from "crypto";
+import { load as load7 } from "cheerio";
+import remarkParse4 from "remark-parse";
+import remarkMdx4 from "remark-mdx";
+import { unified as unified4 } from "unified";
 
 // src/navigation.ts
 import { existsSync, lstatSync, readFileSync, realpathSync as realpathSync2 } from "fs";
@@ -246,6 +246,10 @@ var ALLOWED_ATTRIBUTES = /* @__PURE__ */ new Set([
   "fill-rule",
   "stroke",
   "stroke-width",
+  // Some SVG exporters persist React spellings. These remain fixed static
+  // drawing attributes; accepting them never grants arbitrary JSX execution.
+  "fillrule",
+  "cliprule",
   "stroke-opacity",
   "stroke-linecap",
   "stroke-linejoin",
@@ -367,6 +371,8 @@ var ALLOWED_ATTRIBUTES = /* @__PURE__ */ new Set([
   "limitingconeangle",
   "aria-hidden",
   "aria-label",
+  "aria-labelledby",
+  "aria-describedby",
   "role",
   "focusable",
   // Validated below: only in-document fragment references.
@@ -411,7 +417,7 @@ function isPassiveSvg(content) {
   const fail = () => {
     isPassive = false;
   };
-  const parser3 = new Parser(
+  const parser4 = new Parser(
     {
       onopentag(name, attributes) {
         const element = name.toLowerCase();
@@ -420,7 +426,7 @@ function isPassiveSvg(content) {
           sawRoot = true;
         }
         depth += 1;
-        openStarts.push(parser3.startIndex);
+        openStarts.push(parser4.startIndex);
         if (element.includes(":") || !ALLOWED_ELEMENTS.has(element)) fail();
         for (const [rawName, value] of Object.entries(attributes)) {
           const attribute = rawName.toLowerCase();
@@ -439,7 +445,7 @@ function isPassiveSvg(content) {
       onclosetag(_name, isImplied) {
         depth -= 1;
         const start = openStarts.pop();
-        if (isImplied && start !== parser3.startIndex) fail();
+        if (isImplied && start !== parser4.startIndex) fail();
       },
       // DOCTYPE (and with it custom entities) or any other declaration other
       // than the XML prolog.
@@ -455,8 +461,8 @@ function isPassiveSvg(content) {
     { xmlMode: true, decodeEntities: true, recognizeSelfClosing: true }
   );
   try {
-    parser3.write(text2);
-    parser3.end();
+    parser4.write(text2);
+    parser4.end();
   } catch {
     return false;
   }
@@ -577,6 +583,770 @@ function inferUrlMigrationScope(capture) {
   return { scopePath: parent, evidence: "source-parent" };
 }
 
+// src/url-flight-content.ts
+import { createHash } from "crypto";
+import remarkMdx from "remark-mdx";
+import remarkParse from "remark-parse";
+import remarkGfm from "remark-gfm";
+import { unified } from "unified";
+var parser = unified().use(remarkParse).use(remarkGfm).use(remarkMdx);
+var MAX_SOURCE_BYTES = 8e6;
+var sourceTrees = /* @__PURE__ */ new Map();
+var cachedSourceBytes = 0;
+var MAX_CACHED_SOURCE_BYTES = 1e6;
+var UNRESOLVED_FLIGHT_VALUE = /* @__PURE__ */ Symbol("unresolved-flight-value");
+var expansionBudget = () => ({ visited: 0, bytes: 0, exceeded: false });
+function chargeExpansion(budget, value) {
+  if (budget.exceeded) return false;
+  budget.bytes += Buffer.byteLength(value);
+  if (budget.bytes > MAX_SOURCE_BYTES) budget.exceeded = true;
+  return !budget.exceeded;
+}
+function chargeProjectedText(budget, value) {
+  if (budget.exceeded) return false;
+  let bytes = Buffer.byteLength(value);
+  for (const character of value) bytes += character === "&" ? 4 : character === "<" || character === ">" ? 3 : character === '"' ? 5 : 0;
+  budget.bytes += bytes + 128;
+  if (budget.bytes > MAX_SOURCE_BYTES) budget.exceeded = true;
+  return !budget.exceeded;
+}
+var flightDocuments = /* @__PURE__ */ new WeakMap();
+function renderedRouteSlot(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value) || Object.keys(value).some((key) => key !== "children")) return void 0;
+  const child = value.children;
+  if (!Array.isArray(child) || child.length < 2) return void 0;
+  const segment = child[0], payload = child[1];
+  if (!(typeof segment === "string" || Array.isArray(segment) && segment.every((part) => typeof part === "string"))) return void 0;
+  return Array.isArray(payload) && payload[0] === "$" || typeof payload === "string" && /^\$L?[a-f\d]+$/i.test(payload) ? child : void 0;
+}
+function readMigrationFlightDocument($) {
+  flightTextRecords($);
+  return flightDocuments.get($);
+}
+function literalJson(value) {
+  if (Buffer.byteLength(value) > MAX_SOURCE_BYTES) return void 0;
+  let depth = 0, quoted = false, escaped = false;
+  for (const character of value) {
+    if (quoted) {
+      if (escaped) escaped = false;
+      else if (character === "\\") escaped = true;
+      else if (character === '"') quoted = false;
+    } else if (character === '"') quoted = true;
+    else if (character === "[" || character === "{") {
+      if (++depth > 96) return void 0;
+    } else if (character === "]" || character === "}") {
+      if (--depth < 0) return void 0;
+    }
+  }
+  if (depth !== 0 || quoted) return void 0;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return void 0;
+  }
+}
+function flightTextRecords($) {
+  const cached = flightDocuments.get($);
+  if (cached) return cached.sources;
+  const chunks = [];
+  let size = 0;
+  $("script").each((_index, node) => {
+    const match = /^\s*self\.__next_f\.push\(\s*(\[[\s\S]*\])\s*\)\s*;?\s*$/.exec($(node).text());
+    if (!match) return;
+    const envelope = literalJson(match[1]);
+    if (Array.isArray(envelope) && envelope.length === 2 && envelope[0] === 1 && typeof envelope[1] === "string") {
+      size += Buffer.byteLength(envelope[1]);
+      if (size <= MAX_SOURCE_BYTES) chunks.push(envelope[1]);
+    }
+  });
+  if (size > MAX_SOURCE_BYTES) return [];
+  const bytes = Buffer.from(chunks.join(""));
+  const texts = /* @__PURE__ */ new Map();
+  const modules = /* @__PURE__ */ new Map();
+  const records = /* @__PURE__ */ new Map();
+  let cursor = 0;
+  while (cursor < bytes.length && texts.size + modules.size + records.size <= 1e4) {
+    const colon = bytes.indexOf(58, cursor);
+    if (colon < 0 || colon - cursor > 16 || !/^[a-f\d]*$/i.test(bytes.toString("utf8", cursor, colon))) break;
+    const id = bytes.toString("utf8", cursor, colon);
+    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 end = comma + 1 + Number.parseInt(length, 16);
+      if (end > bytes.length) break;
+      const text2 = bytes.toString("utf8", comma + 1, end);
+      if (text2.includes("\uFFFD")) return [];
+      if (texts.has(id) || records.has(id) || modules.has(id)) return [];
+      texts.set(id, text2);
+      cursor = end;
+    } else {
+      const newline = bytes.indexOf(10, cursor);
+      const end = newline < 0 ? bytes.length : newline;
+      const line = bytes.toString("utf8", cursor, end);
+      if (id && (texts.has(id) || records.has(id) || modules.has(id))) return [];
+      if (line.startsWith("I[")) {
+        const moduleRecord = literalJson(line.slice(1));
+        if (id && Array.isArray(moduleRecord) && typeof moduleRecord[2] === "string") modules.set(id, moduleRecord[2]);
+      } else if (id && /^[\[{"\d-]|^(?:true|false|null)$/.test(line)) records.set(id, literalJson(line));
+      cursor = end + 1;
+    }
+  }
+  if (texts.size + modules.size + records.size > 1e4) return [];
+  const selected = /* @__PURE__ */ new Set();
+  let visited = 0;
+  let hasIncompleteSourceTree = false;
+  const active = /* @__PURE__ */ new Set();
+  const seenReferences = /* @__PURE__ */ new Set();
+  const visit = (value, inArticle, depth) => {
+    if (depth > 96 || ++visited > 1e5) {
+      hasIncompleteSourceTree = true;
+      return;
+    }
+    if (typeof value === "string") {
+      const reference = /^\$L?([a-f\d]+)$/i.exec(value)?.[1];
+      if (reference && active.has(reference)) hasIncompleteSourceTree = true;
+      const identity = `${reference}:${inArticle}`;
+      if (reference && records.has(reference) && !active.has(reference) && !seenReferences.has(identity)) {
+        seenReferences.add(identity);
+        active.add(reference);
+        visit(records.get(reference), inArticle, depth + 1);
+        active.delete(reference);
+      }
+      return;
+    }
+    if (Array.isArray(value)) {
+      const moduleId = value[0] === "$" && typeof value[1] === "string" ? /^\$L([a-f\d]+)$/i.exec(value[1])?.[1] : void 0;
+      const component = moduleId ? modules.get(moduleId) : void 0;
+      const isArticle = inArticle || component === "PageArticle";
+      const props = value[3];
+      if (isArticle && component === "CopyMarkdownButton" && props && typeof props === "object" && !Array.isArray(props)) {
+        const reference = /^\$([a-f\d]+)$/i.exec(String(props.content ?? ""))?.[1];
+        if (reference && texts.has(reference)) selected.add(texts.get(reference));
+      }
+      if (value[0] === "$" && props && typeof props === "object" && !Array.isArray(props)) {
+        visit(props.children, isArticle, depth + 1);
+        return;
+      }
+      for (const child of value) visit(child, isArticle, depth + 1);
+    } else if (depth === 0 && value && typeof value === "object" && Array.isArray(value.f)) {
+      visit(value.f, inArticle, depth + 1);
+    } else {
+      const slot = renderedRouteSlot(value);
+      if (slot) visit(slot, inArticle, depth + 1);
+    }
+  };
+  visit(records.get("0"), false, 0);
+  const sources = visited > 1e5 || hasIncompleteSourceTree ? [] : [...selected];
+  flightDocuments.set($, { texts, modules, records, sources });
+  return sources;
+}
+function descendants(root) {
+  const result = [];
+  let exceeded = false;
+  const visit = (node, depth) => {
+    if (depth > 96 || result.length >= 1e5) {
+      exceeded = true;
+      return;
+    }
+    result.push(node);
+    for (const child of node.children ?? []) visit(child, depth + 1);
+  };
+  visit(root, 0);
+  return exceeded ? [] : result;
+}
+function sourceText(node) {
+  if (["mdxjsEsm", "mdxFlowExpression", "mdxTextExpression"].includes(node.type)) return "";
+  return node.value ?? (node.children ?? []).map(sourceText).join("");
+}
+function sourceNodes(source) {
+  const key = createHash("sha256").update(source).digest("hex");
+  const cached = sourceTrees.get(key);
+  if (cached) {
+    sourceTrees.delete(key);
+    sourceTrees.set(key, cached);
+    return cached.nodes;
+  }
+  let nodes;
+  try {
+    nodes = descendants(parser.parse(source));
+  } catch {
+    nodes = [];
+  }
+  const bytes = Buffer.byteLength(source);
+  if (bytes <= MAX_CACHED_SOURCE_BYTES) {
+    while (sourceTrees.size >= 4 || cachedSourceBytes + bytes > MAX_CACHED_SOURCE_BYTES) {
+      const oldest = sourceTrees.keys().next().value;
+      if (oldest === void 0) break;
+      cachedSourceBytes -= sourceTrees.get(oldest).bytes;
+      sourceTrees.delete(oldest);
+    }
+    sourceTrees.set(key, { bytes, nodes });
+    cachedSourceBytes += bytes;
+  }
+  return nodes;
+}
+function codeText(value) {
+  return value.replace(/\n+$/, "");
+}
+function labelText(value) {
+  return value.trim().replace(/\s+/g, " ");
+}
+function renderedCode($, node) {
+  const copy = $(node).clone();
+  copy.find("code > span.line").each((_index, line) => {
+    if (!$(line).children().length && $(line).text() === " ") $(line).text("");
+  });
+  return codeText(copy.text());
+}
+function isOrderedSubsequence(values, source) {
+  let cursor = 0;
+  for (const value of values) {
+    while (cursor < source.length && source[cursor] !== value) cursor += 1;
+    if (cursor === source.length) return false;
+    cursor += 1;
+  }
+  return true;
+}
+function matchesSourceCode(rendered, source) {
+  const actual = codeText(rendered).split("\n"), declared = codeText(source).split("\n");
+  if (actual.length !== declared.length) return false;
+  return declared.every((line, index) => {
+    const directive = /\/\/\s*\[!code (?:\+\+|--|highlight|focus|error|warning)(?::\d+)?\]\s*$/.exec(line);
+    return directive ? line.slice(0, directive.index).replace(/[\t ]+$/, "") === actual[index].replace(/[\t ]+$/, "") : line === actual[index];
+  });
+}
+function matchesSourceCodeSequence(rendered, source) {
+  let cursor = 0;
+  for (const value of rendered) {
+    while (cursor < source.length && !matchesSourceCode(value, source[cursor].value ?? "")) cursor += 1;
+    if (cursor === source.length) return false;
+    cursor += 1;
+  }
+  return true;
+}
+function hasStaticProps(document, element, allowed) {
+  const common = /* @__PURE__ */ new Set(["children", "className", "style", "id", ...allowed]);
+  return Object.entries(element.props).every(([key, value]) => key === "ref" ? flightValue(document, value) === void 0 : common.has(key));
+}
+function flightValue(document, value) {
+  const seen = /* @__PURE__ */ new Set();
+  for (let depth = 0; depth < 32 && typeof value === "string"; depth += 1) {
+    if (value.startsWith("$$")) return value.slice(1);
+    const reference = /^\$L?([a-f\d]+)(?::(.+))?$/i.exec(value);
+    if (!reference) return value === "$undefined" ? void 0 : value.startsWith("$") ? UNRESOLVED_FLIGHT_VALUE : value;
+    if (seen.has(value)) return UNRESOLVED_FLIGHT_VALUE;
+    seen.add(value);
+    if (document.texts.has(reference[1])) return reference[2] ? UNRESOLVED_FLIGHT_VALUE : document.texts.get(reference[1]);
+    if (!document.records.has(reference[1]) || document.records.get(reference[1]) === void 0) return UNRESOLVED_FLIGHT_VALUE;
+    value = document.records.get(reference[1]);
+    if (reference[2]) for (const key of reference[2].split(":")) {
+      if (key === "props" && Array.isArray(value) && value[0] === "$" && typeof value[1] === "string" && value[3] && typeof value[3] === "object" && !Array.isArray(value[3])) {
+        value = value[3];
+        continue;
+      }
+      if (!value || typeof value !== "object" || !Object.hasOwn(value, key)) return UNRESOLVED_FLIGHT_VALUE;
+      value = value[key];
+    }
+  }
+  return typeof value === "string" && /^\$L?[a-f\d]+(?::|$)/i.test(value) ? UNRESOLVED_FLIGHT_VALUE : value;
+}
+function resolveMigrationFlightValue(document, input) {
+  const value = flightValue(document, input);
+  return value === UNRESOLVED_FLIGHT_VALUE ? { resolved: false, value: void 0 } : { resolved: true, value };
+}
+function flightElement(document, value) {
+  const node = flightValue(document, value);
+  if (!Array.isArray(node) || node[0] !== "$" || typeof node[1] !== "string" || !node[3] || typeof node[3] !== "object" || Array.isArray(node[3])) return void 0;
+  const moduleId = /^\$L?([a-f\d]+)$/i.exec(node[1])?.[1];
+  const symbol = moduleId ? document.records.get(moduleId) : void 0;
+  const kind = moduleId ? document.modules.get(moduleId) ?? (symbol === "$Sreact.fragment" ? "Fragment" : symbol === "$Sreact.suspense" ? "Suspense" : void 0) : node[1];
+  return kind ? { kind, props: node[3] } : void 0;
+}
+function visitFlightTree(document, root, visit, skipUnresolvedBranches = false) {
+  const budget = expansionBudget();
+  let hasUnresolvedValue = false;
+  const walk = (raw, depth) => {
+    if (budget.exceeded) return;
+    if (depth > 96 || ++budget.visited > 1e5) {
+      budget.exceeded = true;
+      return;
+    }
+    const value = flightValue(document, raw);
+    if (value === UNRESOLVED_FLIGHT_VALUE) {
+      hasUnresolvedValue = true;
+      return;
+    }
+    if (typeof value === "string" && !chargeExpansion(budget, value)) return;
+    const element = flightElement(document, value);
+    if (element) {
+      if (visit(element, value, budget) !== false) walk(element.props.children, depth + 1);
+    } else if (Array.isArray(value)) {
+      for (const child of value) walk(child, depth + 1);
+    } else if (depth === 0 && value && typeof value === "object" && Array.isArray(value.f)) {
+      walk(value.f, depth + 1);
+    } else {
+      const slot = renderedRouteSlot(value);
+      if (slot) walk(slot, depth + 1);
+    }
+  };
+  walk(root, 0);
+  return !budget.exceeded && (skipUnresolvedBranches || !hasUnresolvedValue);
+}
+function flightLiteralText(document, raw, depth = 0, code = false, budget = expansionBudget()) {
+  if (budget.exceeded || depth > 96 || ++budget.visited > 1e5) {
+    budget.exceeded = true;
+    return null;
+  }
+  const value = flightValue(document, raw);
+  if (value === null || value === void 0 || typeof value === "boolean") return "";
+  if (typeof value === "string" || typeof value === "number") return chargeExpansion(budget, String(value)) ? String(value) : null;
+  const element = flightElement(document, value);
+  if (element) {
+    if (["script", "style"].includes(element.kind) || element.props.dangerouslySetInnerHTML !== void 0) return null;
+    if (code && element.kind === "span" && element.props.className === "line" && element.props.children === " ") return "";
+    return flightLiteralText(document, element.props.children, depth + 1, code, budget);
+  }
+  if (!Array.isArray(value)) return null;
+  let text2 = "";
+  for (const child of value) {
+    const literal = flightLiteralText(document, child, depth + 1, code, budget);
+    if (literal === null) return null;
+    text2 += literal;
+  }
+  return text2;
+}
+function flightCode(document, element, budget = expansionBudget()) {
+  if (!["CodeBlock", "Pre", "pre"].includes(element.kind)) return null;
+  if (!hasStaticProps(document, element, ["language", "lang", "data-language", "tabIndex", "icon"])) return null;
+  const value = flightLiteralText(document, element.props.children, 0, true, budget);
+  if (value === null) return null;
+  const language = [element.props.language, element.props.lang, element.props["data-language"]].find((value2) => typeof value2 === "string" && /^[A-Za-z0-9_+-]{1,64}$/.test(value2));
+  return { value, ...typeof language === "string" ? { language } : {} };
+}
+function flightTabCode(document, raw, depth = 0, budget = expansionBudget()) {
+  if (budget.exceeded || depth > 96 || ++budget.visited > 1e5) {
+    budget.exceeded = true;
+    return null;
+  }
+  const value = flightValue(document, raw);
+  if (value === null || value === void 0 || typeof value === "boolean" || typeof value === "string" && !value.trim()) return [];
+  const element = flightElement(document, value);
+  if (element) {
+    const code = flightCode(document, element, budget);
+    if (code) return [code];
+    if (!["div", "figure"].includes(element.kind) || !hasStaticProps(document, element, []) || element.props.id !== void 0) return null;
+    return flightTabCode(document, element.props.children, depth + 1, budget);
+  }
+  if (!Array.isArray(value)) return null;
+  const result = [];
+  for (const child of value) {
+    const code = flightTabCode(document, child, depth + 1, budget);
+    if (code === null) return null;
+    result.push(...code);
+  }
+  return result;
+}
+function htmlLiteral(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function flightStaticHtml(document, source, prefix, budget = expansionBudget()) {
+  let visited = 0;
+  const reserve = (bytes) => {
+    budget.bytes += bytes;
+    if (budget.bytes > MAX_SOURCE_BYTES) budget.exceeded = true;
+  };
+  const literal = (value) => {
+    if (budget.exceeded) return "";
+    let bytes = Buffer.byteLength(value);
+    for (const character of value) bytes += character === "&" ? 4 : character === "<" || character === ">" ? 3 : character === '"' ? 5 : 0;
+    reserve(bytes);
+    return budget.exceeded ? "" : htmlLiteral(value);
+  };
+  let tabIndex = 0;
+  const render = (raw, depth) => {
+    if (budget.exceeded || depth > 96 || ++visited > 1e5) return null;
+    const value = flightValue(document, raw);
+    if (value === null || value === void 0 || typeof value === "boolean") return "";
+    if (typeof value === "string" || typeof value === "number") return literal(String(value));
+    const element = flightElement(document, value);
+    if (!element) {
+      if (!Array.isArray(value)) return null;
+      const children2 = value.map((child) => render(child, depth + 1));
+      return children2.some((child) => child === null) ? null : children2.join("");
+    }
+    reserve(128);
+    if (budget.exceeded) return null;
+    const code = flightCode(document, element, budget);
+    if (code) return `<pre${code.language ? ` data-language="${literal(code.language)}"` : ""}><code>${literal(code.value)}</code></pre>`;
+    if (element.kind === "svg") {
+      const svg = (raw2, depth2) => {
+        if (budget.exceeded || depth2 > 96 || ++visited > 1e5) return null;
+        const value2 = flightValue(document, raw2);
+        if (value2 === null || value2 === void 0 || typeof value2 === "boolean") return "";
+        if (typeof value2 === "string" || typeof value2 === "number") return literal(String(value2));
+        const node = flightElement(document, value2);
+        if (!node) {
+          if (!Array.isArray(value2)) return null;
+          const children3 = value2.map((child) => svg(child, depth2 + 1));
+          return children3.some((child) => child === null) ? null : children3.join("");
+        }
+        if (!/^[a-z][a-zA-Z\d]*$/.test(node.kind)) return null;
+        const attributes2 = [];
+        for (const [rawName, rawValue] of Object.entries(node.props)) {
+          if (rawName === "children") continue;
+          const value3 = flightValue(document, rawValue);
+          if (value3 === void 0) continue;
+          if (!["string", "number", "boolean"].includes(typeof value3)) return null;
+          const spellings = {
+            className: "class",
+            strokeWidth: "stroke-width",
+            strokeLinecap: "stroke-linecap",
+            strokeLinejoin: "stroke-linejoin",
+            strokeMiterlimit: "stroke-miterlimit",
+            strokeDasharray: "stroke-dasharray",
+            strokeDashoffset: "stroke-dashoffset",
+            fillRule: "fill-rule",
+            clipRule: "clip-rule",
+            fillOpacity: "fill-opacity",
+            strokeOpacity: "stroke-opacity",
+            clipPath: "clip-path",
+            fontSize: "font-size"
+          };
+          const name = spellings[rawName] ?? rawName;
+          if (!/^[a-zA-Z][a-zA-Z\d:._-]*$/.test(name)) return null;
+          reserve(name.length + 4);
+          if (budget.exceeded) return null;
+          attributes2.push(` ${name}="${literal(String(value3))}"`);
+        }
+        const children2 = svg(node.props.children, depth2 + 1);
+        return children2 === null ? null : `<${node.kind}${attributes2.join("")}>${children2}</${node.kind}>`;
+      };
+      const html = svg(value, depth + 1);
+      return html !== null && isPassiveSvg(Buffer.from(html)) ? html : null;
+    }
+    if (element.kind === "ThemedImage") {
+      if (Object.keys(element.props).some((key) => !["lightSrc", "darkSrc", "alt", "caption"].includes(key))) return null;
+      const light = flightValue(document, element.props.lightSrc), dark = flightValue(document, element.props.darkSrc);
+      const alt = flightValue(document, element.props.alt);
+      if (typeof light !== "string" || typeof dark !== "string" || typeof alt !== "string") return null;
+      const caption = render(element.props.caption, depth + 1);
+      if (caption === null) return null;
+      return `<figure><picture><source media="(prefers-color-scheme: dark)" srcset="${literal(dark)}"><img src="${literal(light)}" alt="${literal(alt)}"></picture>${caption ? `<figcaption>${caption}</figcaption>` : ""}</figure>`;
+    }
+    if (element.kind === "Tabs") {
+      if (!hasStaticProps(document, element, ["items", "defaultIndex", "groupId", "persist"])) return null;
+      const children2 = flightValue(document, element.props.children);
+      const tabs = flightElement(document, children2) ? [children2] : Array.isArray(children2) ? children2 : [];
+      const labels2 = flightValue(document, element.props.items);
+      const group = tabIndex++;
+      const choices = [];
+      for (const [index, rawTab] of tabs.entries()) {
+        const tab = flightElement(document, rawTab);
+        const label = tab?.props.value ?? tab?.props.title;
+        if (tab?.kind !== "Tab" || !hasStaticProps(document, tab, ["value", "title"]) || typeof label !== "string" || !label.trim()) return null;
+        const html = render(tab.props.children, depth + 1);
+        if (html === null) return null;
+        choices.push({ label, html, id: `${prefix}-${group}-${index}` });
+      }
+      if (!choices.length || labels2 !== void 0 && (!Array.isArray(labels2) || JSON.stringify(labels2) !== JSON.stringify(choices.map((choice) => choice.label)))) return null;
+      return `<div><div role="tablist">${choices.map((choice) => `<button role="tab" id="${choice.id}-tab" aria-controls="${choice.id}-panel">${literal(choice.label)}</button>`).join("")}</div>${choices.map((choice) => `<div role="tabpanel" id="${choice.id}-panel" aria-labelledby="${choice.id}-tab">${choice.html}</div>`).join("")}</div>`;
+    }
+    const children = render(element.props.children, depth + 1);
+    if (children === null) return null;
+    if (["Fragment", "Suspense", "Accordions"].includes(element.kind)) return hasStaticProps(document, element, ["type", "defaultValue", "collapsible"]) ? children : null;
+    if (element.kind === "Accordion") {
+      if (!hasStaticProps(document, element, ["title", "defaultOpen", "value"])) return null;
+      const title = flightLiteralText(document, element.props.title);
+      return title === null ? null : `<details open><summary>${literal(title)}</summary>${children}</details>`;
+    }
+    if (element.kind === "Callout") {
+      if (!hasStaticProps(document, element, ["title", "type", "icon"])) return null;
+      const title = element.props.title === void 0 ? "" : flightLiteralText(document, element.props.title);
+      return title === null ? null : `<blockquote>${title ? `<p><strong>${literal(title)}</strong></p>` : ""}${children}</blockquote>`;
+    }
+    const isStaticLink = element.kind === "default" && typeof element.props.href === "string" && Object.keys(element.props).every((key) => ["href", "children", "ref", "prefetch", "replace", "scroll", "className", "target", "rel"].includes(key)) && ["ref", "prefetch", "replace", "scroll"].every((key) => flightValue(document, element.props[key]) === void 0);
+    const tag = element.kind === "Heading" ? element.props.as ?? "h2" : element.kind === "Link" || isStaticLink ? "a" : element.kind;
+    if (typeof tag !== "string" || !/^(?:p|div|section|span|em|strong|a|ul|ol|li|blockquote|table|thead|tbody|tr|td|th|code|h[1-6]|br|hr|img|picture|source|figure|figcaption|sup|sub|details|summary)$/.test(tag) || element.props.dangerouslySetInnerHTML !== void 0) return null;
+    const semanticAttributes = tag === "a" ? ["href", "title", "target", "rel"] : tag === "img" ? ["src", "alt", "width", "height", "srcSet", "srcset", "sizes", "title", "loading", "decoding"] : tag === "source" ? ["srcSet", "srcset", "sizes", "media", "type", "width", "height"] : tag === "details" ? ["open"] : [];
+    if (!isStaticLink && !hasStaticProps(document, element, [...semanticAttributes, ...element.kind === "Heading" ? ["as"] : []])) return null;
+    const attributes = [];
+    for (const name of ["id", ...semanticAttributes]) {
+      if (element.props[name] === void 0) continue;
+      const attribute = flightValue(document, element.props[name]);
+      if (name === "open" && typeof attribute === "boolean") {
+        if (attribute) attributes.push(" open");
+        continue;
+      }
+      if (typeof attribute !== "string" && typeof attribute !== "number") return null;
+      reserve(name.length + 4);
+      if (budget.exceeded) return null;
+      attributes.push(` ${name === "srcSet" ? "srcset" : name}="${literal(String(attribute))}"`);
+    }
+    if (["br", "hr", "img", "source"].includes(tag)) return `<${tag}${attributes.join("")}>`;
+    return `<${tag}${attributes.join("")}>${children}</${tag}>`;
+  };
+  const result = render(source, 0);
+  return budget.exceeded ? null : result;
+}
+function recoverFlightDisclosures($, root, document, article, projectionBudget) {
+  const disclosures = [];
+  if (!visitFlightTree(document, article, (element) => {
+    if (element.kind === "Accordion") {
+      disclosures.push(element);
+      return false;
+    }
+  })) return;
+  const controls = root.find("button[aria-expanded][aria-controls]").toArray();
+  if (controls.length !== disclosures.length) return;
+  const projections = [];
+  for (const [index, control] of controls.entries()) {
+    const button = $(control), source = disclosures[index];
+    if (!hasStaticProps(document, source, ["title", "defaultOpen", "value"])) continue;
+    const title = flightLiteralText(document, source.props.title);
+    const id = button.attr("id"), target2 = button.attr("aria-controls");
+    const panel = root.find("[id]").filter((_index, node) => $(node).attr("id") === target2);
+    if (!id || !target2 || title === null || labelText(title) !== labelText(button.text()) || panel.length !== 1 || panel.attr("role") !== "region" || panel.attr("aria-labelledby") !== id || root.find("[id]").filter((_index, node) => $(node).attr("id") === id).length !== 1 || panel.is('[aria-busy="true"]') || panel.find('[aria-busy="true"],[role="progressbar"]').length) continue;
+    let html;
+    if (!panel.text().trim() && !panel.children().length) {
+      const prefix = `thally-flight-${createHash("sha256").update(target2).digest("hex").slice(0, 16)}`;
+      const rendered = flightStaticHtml(document, source.props.children, prefix, projectionBudget);
+      if (rendered === null || !rendered.trim()) continue;
+      html = rendered;
+    }
+    projections.push({ control, panel, html });
+  }
+  if (projectionBudget.exceeded) return;
+  for (const { control, panel, html } of projections) {
+    const button = $(control);
+    if (html !== void 0) panel.html(html);
+    control.name = "span";
+    button.removeAttr("aria-expanded aria-controls role type");
+    panel.removeAttr("hidden aria-hidden");
+    button.parent("h1,h2,h3,h4,h5,h6").attr("data-thally-static-disclosure-heading", "");
+  }
+}
+function recoverFlightTreeTabs($, root, projectionBudget) {
+  flightTextRecords($);
+  const document = flightDocuments.get($);
+  if (!document) return;
+  const articles = [];
+  if (!visitFlightTree(document, document.records.get("0"), (element, raw) => {
+    if (element.kind === "PageArticle" || element.kind === "article") {
+      articles.push(raw);
+      return false;
+    }
+  }, true)) return;
+  const title = labelText(root.find("h1").first().text());
+  const authored = root.children(".prose").length === 1 ? root.children(".prose") : root;
+  const renderedParagraphs = authored.find("p").toArray().filter((node) => !$(node).parents("pre,button,nav,aside,footer").length).map((node) => labelText($(node).text())).filter(Boolean);
+  const visibleCode = root.find("pre").toArray().map((node) => renderedCode($, node));
+  const candidates = articles.filter((article) => {
+    const headings = [], paragraphs = [], code = [], disclosureLabels = [];
+    const complete2 = visitFlightTree(document, article, (element, _raw, budget) => {
+      if (element.kind === "Accordion") {
+        const label = flightLiteralText(document, element.props.title, 0, false, budget);
+        if (label !== null) disclosureLabels.push(labelText(label));
+      }
+      if (element.kind === "p") paragraphs.push(labelText(flightLiteralText(document, element.props.children, 0, false, budget) ?? ""));
+      const block = flightCode(document, element, budget);
+      if (block) {
+        code.push(codeText(block.value));
+        return false;
+      }
+    });
+    const completeHeadings = visitFlightTree(document, article, (element, _raw, budget) => {
+      if (element.kind === "Accordion" || ["CodeBlock", "pre", "Pre"].includes(element.kind)) return false;
+      const heading = /^h[1-6]$/.test(element.kind) ? element.kind : element.kind === "Heading" ? element.props.as : void 0;
+      if (typeof heading === "string" && /^h[1-6]$/.test(heading)) headings.push(`${heading}:${labelText(flightLiteralText(document, element.props.children, 0, false, budget) ?? "")}`);
+    });
+    const renderedHeadings = root.find("h1,h2,h3,h4,h5,h6").toArray().filter((node) => {
+      const control = $(node).children("button[aria-expanded][aria-controls]").first();
+      if (!control.length || !disclosureLabels.includes(labelText(control.text()))) return true;
+      const copy = $(node).clone();
+      copy.find("button").remove();
+      const id = control.attr("id"), target2 = control.attr("aria-controls");
+      const panel = root.find("[id]").filter((_index, candidate) => $(candidate).attr("id") === target2);
+      return Boolean(copy.text().trim() || !id || panel.length !== 1 || panel.attr("aria-labelledby") !== id);
+    }).map((node) => `${node.name}:${labelText($(node).text())}`);
+    return complete2 && completeHeadings && title && headings[0] === `h1:${title}` && headings.length === renderedHeadings.length && headings.every((heading, index) => heading === renderedHeadings[index]) && isOrderedSubsequence(renderedParagraphs, paragraphs) && isOrderedSubsequence(visibleCode, code);
+  });
+  if (candidates.length !== 1) return;
+  recoverFlightDisclosures($, root, document, candidates[0], projectionBudget);
+  const sourceGroups = [];
+  if (!visitFlightTree(document, candidates[0], (element, _raw, budget) => {
+    if (element.kind !== "Tabs") return;
+    if (!hasStaticProps(document, element, ["items", "defaultIndex", "groupId", "persist"])) {
+      sourceGroups.push([]);
+      return false;
+    }
+    const children = flightValue(document, element.props.children);
+    const nodes = flightElement(document, children) ? [children] : Array.isArray(children) ? children : [];
+    const group = [];
+    for (const raw of nodes) {
+      const tab = flightElement(document, raw);
+      const label = tab?.props.value ?? tab?.props.title;
+      const code = tab?.kind === "Tab" && hasStaticProps(document, tab, ["value", "title"]) ? flightTabCode(document, tab.props.children, 0, budget) : null;
+      if (typeof label !== "string" || !label.trim() || !code?.length) {
+        sourceGroups.push([]);
+        return false;
+      }
+      group.push({ label: labelText(label), code });
+    }
+    const items = flightValue(document, element.props.items);
+    if (items !== void 0 && (!Array.isArray(items) || JSON.stringify(items) !== JSON.stringify(group.map((tab) => tab.label))) || items === void 0 && nodes.some((raw) => typeof flightElement(document, raw)?.props.title !== "string")) sourceGroups.push([]);
+    else sourceGroups.push(group);
+    return false;
+  })) return;
+  const groups = root.find('[role="tablist"]').toArray();
+  if (sourceGroups.length !== groups.length) return;
+  groups.forEach((group, index) => {
+    const tabs = $(group).find('[role="tab"]').toArray().filter((node) => $(node).closest('[role="tablist"]')[0] === group);
+    const source = sourceGroups[index];
+    if (!tabs.length || source.length !== tabs.length) return;
+    const panels = [];
+    for (const [position, tab] of tabs.entries()) {
+      const id = $(tab).attr("id"), target2 = $(tab).attr("aria-controls");
+      const panel = root.find("[id]").filter((_index, node) => $(node).attr("id") === target2);
+      if (!id || !target2 || panel.length !== 1 || panel.attr("role") !== "tabpanel" || panel.attr("aria-labelledby") !== id || !panel.parents().toArray().includes($(group).parent()[0]) || labelText($(tab).text()) !== source[position].label || panel.is('[aria-busy="true"]') || panel.find('[aria-busy="true"],[role="progressbar"]').length) return;
+      if (panel.text().trim() || panel.children().length) {
+        const copy = panel.clone();
+        copy.find("pre,button,style,script").remove();
+        const blocks = panel.find("pre").toArray().map((node) => renderedCode($, node));
+        if (copy.text().trim() || blocks.length !== source[position].code.length || !blocks.every((block, index2) => block === codeText(source[position].code[index2].value))) return;
+      }
+      panels.push(panel);
+    }
+    if (new Set(panels.map((panel) => panel[0])).size !== panels.length) return;
+    panels.forEach((panel, position) => {
+      if (panel.text().trim() || panel.children().length) return;
+      for (const block of source[position].code) {
+        if (!chargeProjectedText(projectionBudget, block.value)) return;
+      }
+      for (const block of source[position].code) {
+        const pre = $("<pre></pre>").append($("<code></code>").text(block.value));
+        if (block.language) pre.attr("data-language", block.language);
+        panel.append(pre);
+      }
+    });
+  });
+  const declarations = [];
+  if (!visitFlightTree(document, candidates[0], (element, _raw, budget) => {
+    const code = flightCode(document, element, budget);
+    if (code) {
+      declarations.push(code);
+      return false;
+    }
+  })) return;
+  root.find("pre").each((_index, node) => {
+    const payload = renderedCode($, node);
+    const matches = declarations.filter((code) => codeText(code.value) === payload);
+    const languages = new Set(matches.map((code) => code.language ?? ""));
+    const language = matches[0]?.language;
+    if (languages.size !== 1 || !language || $(node).attr("language") || $(node).attr("data-language") || $(node).find('code[language],code[data-language],code[class*="language-"],code[class*="lang-"]').length || /(?:^|\s)(?:language-|lang-)/.test($(node).attr("class") ?? "")) return;
+    $(node).attr("data-language", language);
+  });
+}
+function sourceTabs(nodes) {
+  return nodes.filter((node) => node.name === "Tabs").map((group) => {
+    const result = [];
+    for (const tab of group.children ?? []) {
+      if (tab.type === "text" && !tab.value?.trim()) continue;
+      if (tab.name !== "Tab") return [];
+      const label = tab.attributes?.find((attribute) => attribute.type === "mdxJsxAttribute" && attribute.name === "value")?.value;
+      if (typeof label !== "string" || !label.trim() || tab.attributes?.some((attribute) => attribute.type !== "mdxJsxAttribute" || !["value", "title"].includes(attribute.name ?? "") || typeof attribute.value !== "string")) return [];
+      const content = (tab.children ?? []).filter((child) => child.type !== "text" || child.value?.trim());
+      if (!content.length || content.some((child) => child.type !== "code")) return [];
+      result.push({ label: labelText(label), code: content });
+    }
+    return result;
+  });
+}
+function recoverFlightArticleCode($, root) {
+  root.find("[data-thally-static-disclosure-heading]").removeAttr("data-thally-static-disclosure-heading");
+  if (root.find('[role="tablist"]').length > 256 || root.find('[role="tab"]').length > 1024) return;
+  const projectionBudget = expansionBudget();
+  recoverFlightTreeTabs($, root, projectionBudget);
+  const renderedHeadings = root.find("h1,h2,h3,h4,h5,h6").toArray().filter((node) => $(node).attr("data-thally-static-disclosure-heading") === void 0);
+  const headingText = renderedHeadings.map((node) => labelText($(node).text()));
+  const existingCode = root.find("pre").toArray().map((node) => renderedCode($, node));
+  if (!headingText.length || !existingCode.length) return;
+  const prose = root.clone();
+  prose.find("pre,button,script,style,nav,footer,aside").remove();
+  const renderedProse = labelText(prose.text());
+  const candidates = [];
+  for (const source2 of flightTextRecords($)) {
+    if (!/^#\s+\S/m.test(source2) || !/^\s*`{3,}/m.test(source2)) continue;
+    const nodes = sourceNodes(source2);
+    const headings = nodes.filter((node) => node.type === "heading").map((node, index) => {
+      const text2 = labelText(sourceText(node));
+      const anchor = /\s+\[#([A-Za-z\d_.:-]+)\]$/.exec(text2);
+      return anchor && $(renderedHeadings[index]).attr("id") === anchor[1] ? text2.slice(0, anchor.index) : text2;
+    });
+    if (JSON.stringify(headings) !== JSON.stringify(headingText)) continue;
+    let proseCursor = 0;
+    let hasMatchingProse = true;
+    for (const paragraph of nodes.filter((node) => node.type === "paragraph" || node.type === "tableCell")) {
+      const text2 = labelText(sourceText(paragraph));
+      if (!text2) continue;
+      const position = renderedProse.indexOf(text2, proseCursor);
+      if (position < 0) {
+        hasMatchingProse = false;
+        break;
+      }
+      proseCursor = position + text2.length;
+    }
+    if (!hasMatchingProse) continue;
+    const sourceCode2 = nodes.filter((node) => node.type === "code");
+    if (matchesSourceCodeSequence(existingCode, sourceCode2)) candidates.push({ nodes, groups: sourceTabs(nodes) });
+  }
+  if (candidates.length !== 1) return;
+  const source = candidates[0];
+  const groups = root.find('[role="tablist"]').toArray();
+  if (groups.length === source.groups.length) groups.forEach((group, index) => {
+    const tabs = $(group).find('[role="tab"]').toArray().filter((tab) => $(tab).closest('[role="tablist"]')[0] === group);
+    const sourceGroup = source.groups[index];
+    if (!tabs.length || tabs.length !== sourceGroup.length) return;
+    const panels = [];
+    for (const [position, tab] of tabs.entries()) {
+      const control = $(tab).attr("aria-controls");
+      const tabId = $(tab).attr("id");
+      const panel = root.find("[id]").filter((_index, node) => $(node).attr("id") === control);
+      if (!control || panel.length !== 1 || !panel.is('[role="tabpanel"]') || !tabId || root.find("[id]").filter((_index, node) => $(node).attr("id") === tabId).length !== 1 || panel.attr("aria-labelledby") !== tabId || !panel.parents().toArray().includes($(group).parent()[0]) || labelText($(tab).text()) !== sourceGroup[position].label || panel.is('[aria-busy="true"]') || panel.find('[aria-busy="true"],[role="progressbar"]').length) return;
+      if (panel.text().trim() || panel.children().length) {
+        const code = panel.find("pre").toArray().map((node) => renderedCode($, node));
+        const clone = panel.clone();
+        clone.find("pre,button,script,style").remove();
+        const declared = sourceGroup[position].code;
+        if (clone.text().trim() || code.length !== declared.length || !code.every((value, index2) => matchesSourceCode(value, declared[index2].value ?? ""))) return;
+      }
+      panels.push(panel);
+    }
+    if (new Set(panels.map((panel) => panel[0])).size !== panels.length) return;
+    panels.forEach((panel, position) => {
+      if (panel.text().trim() || panel.children().length) return;
+      for (const code of sourceGroup[position].code) if (!chargeProjectedText(projectionBudget, code.value ?? "")) return;
+      for (const code of sourceGroup[position].code) {
+        const pre = $("<pre></pre>").append($("<code></code>").text(code.value ?? ""));
+        if (code.lang && /^[A-Za-z0-9_+-]{1,64}$/.test(code.lang)) pre.attr("data-language", code.lang);
+        panel.append(pre);
+      }
+    });
+  });
+  const sourceCode = source.nodes.filter((node) => node.type === "code");
+  let cursor = 0;
+  root.find("pre").each((_index, node) => {
+    const payload = renderedCode($, node);
+    while (cursor < sourceCode.length && !matchesSourceCode(payload, sourceCode[cursor].value ?? "")) cursor += 1;
+    const code = sourceCode[cursor++];
+    if (!code?.lang || !/^[A-Za-z0-9_+-]{1,64}$/.test(code.lang)) return;
+    const languages = new Set(sourceCode.filter((candidate) => matchesSourceCode(payload, candidate.value ?? "")).map((candidate) => candidate.lang ?? ""));
+    if (languages.size !== 1) return;
+    if (!$(node).attr("language") && !$(node).attr("data-language") && !$(node).find('code[language],code[data-language],code[class*="language-"],code[class*="lang-"]').length && !/(?:^|\s)(?:language-|lang-)/.test($(node).attr("class") ?? "")) $(node).attr("data-language", code.lang);
+  });
+}
+
 // src/url-navigation.ts
 var MAX_CAPTURE_BYTES = 8e6;
 var MAX_JSON_BYTES = 2e6;
@@ -775,6 +1545,75 @@ function resolveNavigation(nodes, base) {
   };
   return walk(nodes);
 }
+function sidebarCollectionMenus($, root, base, existing) {
+  const document = readMigrationFlightDocument($);
+  if (!document) return [];
+  const resolve4 = (input) => {
+    let value = input;
+    const seen = /* @__PURE__ */ new Set();
+    for (let depth = 0; depth < 32 && typeof value === "string"; depth++) {
+      if (value === "$undefined") return void 0;
+      if (value.startsWith("$$")) return value.slice(1);
+      const reference = /^\$L?([a-f\d]+)(?::(.+))?$/i.exec(value);
+      if (!reference) return value;
+      if (seen.has(value) || !document.records.has(reference[1])) return void 0;
+      seen.add(value);
+      value = document.records.get(reference[1]);
+      for (const key of reference[2]?.split(":") ?? []) {
+        if (key === "props" && Array.isArray(value) && value[0] === "$") {
+          value = value[3];
+          continue;
+        }
+        if (!value || typeof value !== "object" || !Object.hasOwn(value, key)) return void 0;
+        value = value[key];
+      }
+    }
+    return typeof value === "string" && /^\$L?[a-f\d]+(?::|$)/i.test(value) ? void 0 : value;
+  };
+  const known = /* @__PURE__ */ new Set();
+  const remember = (nodes) => {
+    for (const node of nodes) {
+      if (node.url) known.add(node.url);
+      remember(node.children ?? []);
+    }
+  };
+  remember(existing);
+  const result = [];
+  let visited = 0;
+  const active = /* @__PURE__ */ new Set();
+  const visit = (input, inSidebar, inHeader, inArticle, depth) => {
+    if (++visited > 1e5 || depth > 96 || active.has(input)) return;
+    const value = resolve4(input);
+    if (!value || typeof value !== "object") return;
+    active.add(input);
+    if (Array.isArray(value)) {
+      if (value[0] === "$" && object(value[3])) {
+        const componentId = typeof value[1] === "string" ? /^\$L([a-f\d]+)$/i.exec(value[1])?.[1] : void 0;
+        const component = componentId ? document.modules.get(componentId) : value[1];
+        const article = inArticle || ["PageArticle", "article", "pre", "code"].includes(String(component));
+        const sidebar = !article && (inSidebar || component === "Sidebar");
+        const header = sidebar && (inHeader || component === "SidebarHeader");
+        if (header && component === "RootToggle") {
+          const options = resolve4(value[3].options);
+          if (Array.isArray(options) && options.length >= 2 && options.length <= 100) {
+            const entries = options.map(resolve4).map((option) => object(option) ? { label: text(resolve4(option.title)), url: target(resolve4(option.url), base) } : {});
+            const hasVisibleChoice = entries.some((entry) => entry.label && root.find("button[aria-haspopup]").toArray().some((button) => [button, ...$(button).find("*").toArray()].some((node) => $(node).text().trim() === entry.label)));
+            if (hasVisibleChoice && entries.every((entry) => entry.label && entry.url)) for (const entry of entries) {
+              if (!known.has(entry.url)) {
+                known.add(entry.url);
+                result.push({ label: entry.label, url: entry.url });
+              }
+            }
+          }
+        }
+        visit(value[3].children, sidebar, header, article, depth + 1);
+      } else for (const child of value) visit(child, inSidebar, inHeader, inArticle, depth + 1);
+    } else for (const child of Object.values(value)) visit(child, inSidebar, inHeader, inArticle, depth + 1);
+    active.delete(input);
+  };
+  visit(document.records.get("0"), false, false, false, 0);
+  return visited > 1e5 ? [] : result;
+}
 function extractSourceNavigation(capture, selectedScope) {
   if (capture.navigation) return resolveNavigation(capture.navigation, capture.finalUrl);
   if (!/html/i.test(capture.contentType) || Buffer.byteLength(capture.body) > MAX_CAPTURE_BYTES) return [];
@@ -782,34 +1621,100 @@ function extractSourceNavigation(capture, selectedScope) {
   if (mintlify.length) return mintlify;
   const $ = load2(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);
+  const root = candidates.map((selector) => $(selector).filter((_index, node) => {
+    const item = $(node);
+    if (!item.find("a[href]").length || item.closest("header,article").length) return false;
+    const current = new URL(capture.finalUrl);
+    const internal = item.find("a[href]").toArray().flatMap((link) => {
+      const reference = target($(link).attr("href"), capture.finalUrl);
+      if (!reference) return [];
+      const url = new URL(reference);
+      return url.origin === current.origin ? [url] : [];
+    });
+    if (!internal.length) {
+      if (item.is('nav,[role="navigation"]')) return true;
+      const prose = item.clone();
+      prose.find("a,svg,img,script,style").remove();
+      return !prose.text().trim();
+    }
+    return internal.every((url) => !url.hash) || internal.some((url) => url.pathname !== current.pathname || !url.hash && url.search !== current.search);
+  }).first()).find((candidate) => candidate.length);
   if (!root) return [];
   let count = 0;
+  const labelOf = (item) => {
+    const visible = item.text().replace(/\s+/g, " ").trim();
+    if (visible) return visible;
+    if (item.is("a[href]")) {
+      const url = target(item.attr("href"), capture.finalUrl);
+      if (url && root.find("a[href]").toArray().some((node) => node !== item[0] && $(node).text().trim() && target($(node).attr("href"), capture.finalUrl) === url)) return "";
+    }
+    return text(item.attr("aria-label")) || text(item.attr("title")) || text(item.find("img[alt]").first().attr("alt")) || "";
+  };
   const walk = (element, excluded, depth = 0) => {
     if (depth > MAX_DEPTH) throw new Error("Source navigation exceeds its safety bound.");
     const result = [];
+    const siblings = $(element).children().toArray().filter((node) => node !== excluded);
+    if (siblings.length > MAX_NODES) throw new Error("Source navigation exceeds its safety bound.");
+    const marker = (node) => {
+      const item = $(node);
+      return item.is("p,span") && Boolean(item.text().trim()) && item.text().length <= 512 && item.find("*").toArray().every((child) => $(child).is("span,strong,em,b,i,small,code,br")) && !item.find("a,button,input,textarea,select,form,div,p,section,article").length && !item.closest('form,[role="search"],[aria-hidden="true"]').length;
+    };
+    const markerPositions = siblings.flatMap((node, index) => marker(node) ? [index] : []);
+    const markers = markerPositions.map((index) => siblings[index]);
+    const isLinkContainer = (node) => {
+      const item = $(node);
+      if (item.is("a[href]")) return true;
+      if (!item.is("div,li,ul,ol,details")) return false;
+      if (!item.find("a[href]").length || item.find('form,input,textarea,select,[role="search"]').length) return false;
+      const remainder = item.clone();
+      remainder.find("a[href],svg,img").remove();
+      return !remainder.text().trim() && !remainder.find("button,form,input,textarea,select,section,article").length;
+    };
+    const groupedMarkers = /* @__PURE__ */ new Set();
+    if (markers.length >= 2 && markers.every((node) => node.tagName === markers[0].tagName)) {
+      let isComplete = true;
+      for (let index = 0; index < markers.length; index++) {
+        const start = markerPositions[index] + 1;
+        const end = index + 1 < markers.length ? markerPositions[index + 1] : siblings.length;
+        const following = siblings.slice(start, end).filter((node) => $(node).text().trim() || $(node).find("a[href],button,input,textarea,select,form,img").length);
+        if (!following.length || !following.every(isLinkContainer)) {
+          isComplete = false;
+          break;
+        }
+      }
+      if (isComplete) markers.forEach((node) => groupedMarkers.add(node));
+    }
+    let currentGroup;
+    const append = (nodes) => {
+      if (currentGroup) currentGroup.children.push(...nodes);
+      else result.push(...nodes);
+    };
     $(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();
+      if (groupedMarkers.has(node)) {
+        currentGroup = { kind: "group", label: item.text().replace(/\s+/g, " ").trim(), children: [] };
+        result.push(currentGroup);
+      } else if (item.is("a[href]")) {
+        const label = labelOf(item);
         const url = target(item.attr("href"), capture.finalUrl);
-        if (label && url) result.push({ label, url });
+        if (label && url) append([{ 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 label = labelOf(direct) || labelOf(item.children("summary,button,span,h2,h3,h4,h5,h6").first());
         const children = walk(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(...walk(node, excluded, depth + 1));
+        if (label && (url || children.length)) append([{ label, ...url ? { url } : {}, ...children.length ? { children } : {} }]);
+        else append(children);
+      } else append(walk(node, excluded, depth + 1));
     });
     return result;
   };
   try {
-    return walk(root);
+    const nodes = walk(root);
+    return [...nodes, ...sidebarCollectionMenus($, root, capture.finalUrl, nodes)];
   } catch {
     return [];
   }
@@ -974,12 +1879,16 @@ function projectMigrationMedia(html, base) {
   }
 }
 
+// src/url-identity.ts
+import { createHash as createHash3 } from "crypto";
+import { load as load6 } from "cheerio";
+
 // src/url.ts
-import { load as load4 } from "cheerio";
-import remarkMdx2 from "remark-mdx";
-import remarkParse2 from "remark-parse";
+import { load as load5 } from "cheerio";
+import remarkMdx3 from "remark-mdx";
+import remarkParse3 from "remark-parse";
 import TurndownService from "turndown";
-import { unified as unified2 } from "unified";
+import { unified as unified3 } from "unified";
 import { parse as parseYaml2, stringify as stringifyYaml } from "yaml";
 
 // src/analytics.ts
@@ -990,10 +1899,10 @@ var HOSTNAME = new RegExp(`^${HOSTNAME_LABEL}(?:\\.${HOSTNAME_LABEL})*$`);
 import { posix } from "path";
 import { compileSync } from "@mdx-js/mdx";
 import { nameToEmoji } from "gemoji";
-import remarkGfm from "remark-gfm";
-import remarkMdx from "remark-mdx";
-import remarkParse from "remark-parse";
-import { unified } from "unified";
+import remarkGfm2 from "remark-gfm";
+import remarkMdx2 from "remark-mdx";
+import remarkParse2 from "remark-parse";
+import { unified as unified2 } from "unified";
 
 // src/builtin-components.ts
 var THALLY_BUILTIN_COMPONENTS = /* @__PURE__ */ new Set([
@@ -1480,7 +2389,7 @@ function titleFromId(id) {
   if (value === "introduction") return "Introduction";
   return value.split(/[-_]/).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
-var descriptionParser = unified().use(remarkParse).use(remarkGfm).use(remarkMdx);
+var descriptionParser = unified2().use(remarkParse2).use(remarkGfm2).use(remarkMdx2);
 function plainText(node) {
   if (node.type === "text" || node.type === "inlineCode") return node.value ?? "";
   if (node.type === "image") return node.alt ?? "";
@@ -2539,8 +3448,132 @@ function apiFrontmatter(data, warn) {
   return result;
 }
 
+// src/url-static-content.ts
+import { createHash as createHash2 } from "crypto";
+import { load as load4 } from "cheerio";
+function projectMigrationSvg(html) {
+  const $ = load4(html, { xmlMode: true }, false);
+  const svg = $.root().children();
+  if (svg.length !== 1 || !svg.is("svg")) return null;
+  if (svg.attr("xmlns") === void 0) svg.attr("xmlns", "http://www.w3.org/2000/svg");
+  const content = Buffer.from($.xml(svg));
+  if (!isPassiveSvg(content)) return null;
+  const sha256 = createHash2("sha256").update(content).digest("hex");
+  const labelled = (svg.attr("aria-labelledby") ?? "").split(/\s+/).filter(Boolean).map((id) => svg.find("[id]").filter((_index, node) => $(node).attr("id") === id).text().trim()).filter(Boolean);
+  const alternative = svg.attr("aria-label")?.trim() || labelled.join(" ") || svg.children("title").text().trim() || svg.children("desc").text().trim() || svg.find("text").text().trim();
+  return { asset: { path: `migration-assets/${sha256}.svg`, content }, alternative };
+}
+function projectProtectedEmails($, root) {
+  root.find("[data-cfemail]").each((_index, node) => {
+    const element = $(node);
+    const anchor = element.is("a") ? element : element.closest("a");
+    const href = anchor.attr("href") ?? "";
+    if (!anchor.length || !/^\/cdn-cgi\/l\/email-protection(?:#[a-f\d]+)?$/i.test(href)) return;
+    const encoded = element.attr("data-cfemail") ?? "";
+    if (!/^(?:[a-f\d]{2}){4,1024}$/i.test(encoded)) return;
+    const bytes = Buffer.from(encoded, "hex");
+    const payload = Uint8Array.from(bytes.subarray(1), (byte) => byte ^ bytes[0]);
+    let email;
+    try {
+      email = new TextDecoder("utf-8", { fatal: true }).decode(payload);
+    } catch {
+      return;
+    }
+    if (!/^[^@\s<>?#[\]\u0000-\u001f\u007f]+@[^@\s<>?#[\]\u0000-\u001f\u007f]+\.[^@\s<>?#[\]\u0000-\u001f\u007f]+$/u.test(email)) return;
+    anchor.attr("href", `mailto:${email}`);
+    if (/^\[email\s+protected\]$/i.test(element.text().trim())) element.text(email);
+    element.removeAttr("data-cfemail");
+  });
+}
+function hasCompleteCapturedPanel($, panel) {
+  const busy = '[aria-busy="true"],[role="progressbar"]';
+  if (panel.is(busy) || panel.find(busy).length) return false;
+  const copy = panel.clone();
+  copy.find('script,style,button,[role="tablist"]').remove();
+  return Boolean(copy.text().trim() || copy.find("img[src],svg").length);
+}
+function projectCapturedDisclosures($, root) {
+  const ids = /* @__PURE__ */ new Map();
+  root.find("[id]").each((_index, node) => {
+    const id = $(node).attr("id");
+    ids.set(id, ids.has(id) ? ids.get(id).add(node) : $(node));
+  });
+  root.find("button[aria-expanded][aria-controls],summary[aria-expanded][aria-controls]").each((_index, node) => {
+    const control = $(node);
+    if (control.is('[role="tab"],[aria-haspopup],[aria-busy="true"]')) return;
+    const id = control.attr("id"), target2 = control.attr("aria-controls");
+    const panel = target2 ? ids.get(target2) : void 0;
+    const nativeSummary = control.is("summary") && control.parent().is("details");
+    let owner = control.parent();
+    if (owner.is("h1,h2,h3,h4,h5,h6")) owner = owner.parent();
+    const labels2 = panel?.attr("aria-labelledby")?.trim().split(/\s+/);
+    const ownedLabels = labels2?.every((label) => ids.get(label)?.length === 1 && (label === id || nativeSummary && control.find("[id]").toArray().some((element) => $(element).attr("id") === label)));
+    if (!nativeSummary && !id || id && ids.get(id)?.length !== 1 || !panel || panel.length !== 1 || panel.attr("role") !== "region" && !(nativeSummary && panel.is('[data-component-part="expandable-content"]')) || labels2 && !ownedLabels || !panel.parents().toArray().some((parent) => parent === owner[0]) || nativeSummary && panel.parent()[0] !== owner[0] || !hasCompleteCapturedPanel($, panel)) return;
+    if (!nativeSummary) node.name = "span";
+    control.removeAttr("aria-expanded aria-controls role type");
+    panel.removeAttr("hidden aria-hidden");
+  });
+}
+function projectCapturedTabs($, root) {
+  root.find("[data-thally-static-tabs],[data-thally-static-tab]").removeAttr("data-thally-static-tabs data-thally-static-tab");
+  const ids = /* @__PURE__ */ new Map();
+  root.find("[id]").each((_index, node) => {
+    const id = $(node).attr("id");
+    ids.set(id, ids.has(id) ? ids.get(id).add(node) : $(node));
+  });
+  const claimed = /* @__PURE__ */ new Set();
+  const groups = root.find('[role="tablist"]').toArray();
+  if (groups.length > 256 || root.find('[role="tab"]').length > 1024) return;
+  for (const groupNode of groups.reverse()) {
+    const group = $(groupNode);
+    const tabs = group.find('[role="tab"]').toArray().filter((node) => $(node).closest('[role="tablist"]')[0] === groupNode);
+    if (!tabs.length || group.is('[aria-busy="true"]')) continue;
+    if (group.text().replace(/\s+/g, "") !== tabs.map((node) => $(node).text()).join("").replace(/\s+/g, "")) continue;
+    let container = group.parent();
+    const explicit = tabs.every((tab) => Boolean($(tab).attr("aria-controls")));
+    const panels = [];
+    if (explicit) {
+      for (const tab of tabs) {
+        const panel = ids.get($(tab).attr("aria-controls"));
+        const tabId = $(tab).attr("id");
+        if (!panel || panel.length !== 1 || !panel.is('[role="tabpanel"]') || panel.find('[role="tablist"]').toArray().includes(groupNode) || tabId && ids.get(tabId)?.length !== 1 || panel.attr("aria-labelledby") !== void 0 && panel.attr("aria-labelledby") !== tabId) break;
+        panels.push(panel);
+      }
+      for (let depth = 0; depth < 16 && container.length && panels.some((panel) => !panel.parents().toArray().some((parent) => parent === container[0])); depth += 1) container = container.parent();
+      if (!container.length || !container.find('[role="tablist"]').toArray().includes(groupNode)) continue;
+    } else {
+      if (tabs.some((tab) => $(tab).attr("aria-controls"))) continue;
+      container = group.closest(".code-group,.tabs-container,.tabs.tab-container");
+      if (!container.length) continue;
+      const owners = container.find('[role="tablist"]').toArray().filter((node) => $(node).closest(".code-group,.tabs-container,.tabs.tab-container")[0] === container[0]);
+      if (owners.length !== 1) continue;
+      panels.push(...container.find('[role="tabpanel"]').toArray().filter((node) => $(node).closest(".code-group,.tabs-container,.tabs.tab-container")[0] === container[0]).map((node) => $(node)));
+    }
+    if (panels.length !== tabs.length || new Set(panels.map((panel) => panel[0])).size !== panels.length || panels.some((panel) => claimed.has(panel[0]) || !hasCompleteCapturedPanel($, panel))) continue;
+    const unowned = container.find('[role="tabpanel"]').toArray().filter((node) => !panels.some((panel) => panel[0] === node || $(node).parents().toArray().some((parent) => parent === panel[0])));
+    if (unowned.length) continue;
+    const residual = container.clone();
+    residual.find('[role="tablist"],[role="tabpanel"]').remove();
+    const hasSurroundingContent = Boolean(residual.text().trim() || residual.find("a[href],pre,img,svg,table,video,audio,iframe,form,input,textarea,select,object,embed,canvas,math").length);
+    if (!hasSurroundingContent) container.attr("data-thally-static-tabs", "");
+    panels.forEach((panel, index) => {
+      claimed.add(panel[0]);
+      const label = $(tabs[index]).text().trim() || `Tab ${index + 1}`;
+      if (hasSurroundingContent) panel.prepend($("<p></p>").append($("<strong></strong>").text(label)));
+      else panel.attr("data-thally-static-tab", label);
+      panel.removeAttr("role hidden aria-hidden aria-labelledby");
+      const id = $(tabs[index]).attr("id");
+      if (id) panel.prepend($("<span></span>").attr("id", id));
+    });
+    const groupId = group.attr("id");
+    if (groupId) group.replaceWith($("<span></span>").attr("id", groupId));
+    else group.remove();
+  }
+}
+
 // src/url.ts
-var MAX_LOCAL_RESPONSE_BYTES = 2e6;
+var MAX_LOCAL_RESPONSE_BYTES = 8e6;
+var MAX_EMBEDDED_SCHEMA_BYTES = 2e6;
 var PORTABLE_MDX_COMPONENTS = /* @__PURE__ */ new Set([
   "Accordion",
   "AccordionGroup",
@@ -2617,8 +3650,8 @@ 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 = unified2().use(remarkParse2).use(remarkMdx2);
-var embeddedOpenApiParser = unified2().use(remarkParse2);
+var remoteMarkdownParser = unified3().use(remarkParse3).use(remarkMdx3);
+var embeddedOpenApiParser = unified3().use(remarkParse3);
 function validateMigrationUrl(value) {
   let url;
   try {
@@ -2635,7 +3668,7 @@ function validateMigrationUrl(value) {
 }
 async function readResponseBody(response) {
   const contentLength = Number(response.headers.get("content-length") ?? 0);
-  if (contentLength > MAX_LOCAL_RESPONSE_BYTES) throw new Error("A documentation response exceeded the 2 MB import limit.");
+  if (contentLength > MAX_LOCAL_RESPONSE_BYTES) throw new Error("A documentation response exceeded the 8 MB import limit.");
   if (!response.body) return "";
   const reader = response.body.getReader();
   const chunks = [];
@@ -2646,7 +3679,7 @@ async function readResponseBody(response) {
     size += value.byteLength;
     if (size > MAX_LOCAL_RESPONSE_BYTES) {
       await reader.cancel();
-      throw new Error("A documentation response exceeded the 2 MB import limit.");
+      throw new Error("A documentation response exceeded the 8 MB import limit.");
     }
     chunks.push(value);
   }
@@ -2751,7 +3784,7 @@ function isSafePortableUrl(value) {
   }
 }
 function decodeHtmlAttribute(value) {
-  const document = load4(`<i data-thally-value="${value.replace(/"/g, "&quot;")}"></i>`);
+  const document = load5(`<i data-thally-value="${value.replace(/"/g, "&quot;")}"></i>`);
   return document("i").attr("data-thally-value") ?? "";
 }
 function escapeMarkdownText(value, escapeTableSeparator = false) {
@@ -2837,7 +3870,7 @@ function replacePortableHtmlImages(value) {
     if (start < cursor) continue;
     const end = htmlOpeningTagEnd(value, start + match[0].length);
     if (end === null) continue;
-    const fragment = load4(value.slice(start, end));
+    const fragment = load5(value.slice(start, end));
     const image = fragment("img").first();
     const source = image.attr("src");
     const destination = source && isSafePortableUrl(source) ? markdownLinkDestination(source) : null;
@@ -2862,7 +3895,7 @@ function replacePortableHtmlAnchors(value) {
     const closing = closingMatch.exec(value);
     if (!closing) continue;
     const end = closing.index + closing[0].length;
-    const fragment = load4(value.slice(start, end));
+    const fragment = load5(value.slice(start, end));
     const anchor = fragment("a").first();
     const href = anchor.attr("href");
     const label = escapeMarkdownText(anchor.text().replace(/\s+/g, " ").trim());
@@ -3118,7 +4151,7 @@ function stripMintlifyDocumentationIndex(body) {
   return lines.slice(index).join("\n");
 }
 function extractEmbeddedOpenApi(content) {
-  if (Buffer.byteLength(content, "utf8") > MAX_LOCAL_RESPONSE_BYTES) return { content };
+  if (Buffer.byteLength(content, "utf8") > MAX_EMBEDDED_SCHEMA_BYTES) return { content };
   try {
     const root = embeddedOpenApiParser.parse(content);
     const candidates = (root.children ?? []).flatMap((node2) => {
@@ -3151,10 +4184,10 @@ function extractEmbeddedOpenApi(content) {
     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.");
+      if (values > 1e5 || textLength > MAX_EMBEDDED_SCHEMA_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 };
+    if (Buffer.byteLength(serialized, "utf8") > MAX_EMBEDDED_SCHEMA_BYTES) return { content };
     const before = content.slice(0, start).replace(/(?:^|\n)##\s+OpenAPI\s*\n\s*$/i, "\n");
     const after = content.slice(end);
     return {
@@ -3208,8 +4241,12 @@ function markdownPage(document, id, platform, warn) {
   };
 }
 function migrationHtmlArticle(body) {
-  const $ = load4(body);
+  const $ = load5(body);
   const root = ["main article", "article", "main", '[role="main"]', "body"].map((selector) => $(selector).first()).find((candidate) => candidate.length);
+  projectProtectedEmails($, root);
+  recoverFlightArticleCode($, root);
+  const assets = [];
+  const svgProjections = new Map(root.find("svg").toArray().map((element) => [element, projectMigrationSvg($.html(element))]));
   root.find([
     "script",
     "style",
@@ -3270,10 +4307,25 @@ function migrationHtmlArticle(body) {
     projection.append(list);
     select.replaceWith(projection);
   });
-  return { $, root };
+  projectCapturedDisclosures($, root);
+  root.find("svg").each((_index, element) => {
+    const svg = $(element);
+    if (svg.parents("svg,button,nav,footer,aside").length) return;
+    const projection = svgProjections.get(element);
+    if (!projection) return;
+    const image = $("<img>").attr("src", `/${projection.asset.path}`).attr("alt", projection.alternative);
+    for (const attribute of ["id", "width", "height"]) {
+      const value = svg.attr(attribute);
+      if (value !== void 0) image.attr(attribute, value);
+    }
+    assets.push(projection.asset);
+    svg.replaceWith(image);
+  });
+  projectCapturedTabs($, root);
+  return { $, root, assets };
 }
 function htmlPage(document, id, options = {}) {
-  const { $, root } = migrationHtmlArticle(document.body);
+  const { $, root, assets } = 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();
@@ -3312,6 +4364,7 @@ function htmlPage(document, id, options = {}) {
   root.find("img[src]").each((_index, element) => {
     const src = $(element).attr("src");
     if (!src) return;
+    if (assets.some((asset) => src === `/${asset.path}`)) return;
     try {
       const resolved = new URL(src, document.finalUrl);
       if (["http:", "https:"].includes(resolved.protocol)) {
@@ -3323,7 +4376,15 @@ function htmlPage(document, id, options = {}) {
       $(element).removeAttr("src");
     }
   });
-  const turndown = new TurndownService({ codeBlockStyle: "fenced", emDelimiter: "_", headingStyle: "atx", preformattedCode: true });
+  const turndown = new TurndownService({
+    codeBlockStyle: "fenced",
+    emDelimiter: "_",
+    headingStyle: "atx",
+    preformattedCode: true,
+    // Turndown chooses its blank rule before custom rules. Empty source anchor
+    // leaves still carry navigation identity, including captured tab controls.
+    blankReplacement: (_content, node) => options.preserveAnchors ? anchor(node) : ""
+  });
   let isConvertingTableCell = false;
   turndown.remove(["script", "style", "noscript"]);
   turndown.addRule("migration-literal-table-code", {
@@ -3364,6 +4425,22 @@ ${content}
 
 ${anchor(element)}${heading ? `${"#".repeat(Number(heading[1]))} ${content.trim()}` : content}
 
+`;
+    }
+  });
+  turndown.addRule("migration-flow-link", {
+    filter: (node) => node.nodeName === "A" && node.hasAttribute("href") && Boolean(node.querySelector("div,p,picture,figure,blockquote,pre,table,ul,ol,h1,h2,h3,h4,h5,h6")),
+    replacement: (content, node) => {
+      const element = node;
+      const href = migrationImageAttribute(element.getAttribute("href") ?? "");
+      return `
+
+${anchor(element)}<Card href="${href}">
+
+${content.trim()}
+
+</Card>
+
 `;
     }
   });
@@ -3414,7 +4491,7 @@ ${content.trim()}
       const element = node;
       const className = element.className;
       const tag = /admonition-(?:danger)/.test(className) ? "Error" : /admonition-(?:caution|warning)/.test(className) ? "Warning" : /admonition-info/.test(className) ? "Info" : "Note";
-      const fragment = load4(element.outerHTML);
+      const fragment = load5(element.outerHTML);
       const clone = fragment(".theme-admonition").first();
       const title2 = clone.find('[class*="admonitionHeading"],.admonition-heading').first();
       const titleText = title2.text().trim();
@@ -3435,11 +4512,15 @@ ${titleText ? `**${escapeMarkdownText(titleText)}**
     filter: (node) => node.nodeName === "DIV" && node.classList.contains("tabs-container"),
     replacement: (_content, node) => {
       const element = node;
-      const fragment = load4(element.outerHTML);
+      const fragment = load5(element.outerHTML);
       const container = fragment(".tabs-container").first();
       const labels2 = container.children("ul.tabs").children("li").toArray().map((item) => fragment(item).text().trim() || "Tab");
       const panels = container.find('[role="tabpanel"]').toArray().filter((panel) => fragment(panel).closest(".tabs-container")[0] === container[0]);
       if (panels.length === 0) return _content;
+      const residual = container.clone();
+      residual.children("ul.tabs").remove();
+      residual.find('[role="tabpanel"]').remove();
+      if (residual.text().trim() || residual.find("a[href],pre,img,svg,table,video,iframe,input,select,textarea").length) return _content;
       const tabs = panels.map((panel, index) => {
         const panelId = fragment(panel).attr("id");
         const tab = panelId ? container.find('[role="tab"]').toArray().find((item) => fragment(item).attr("aria-controls") === panelId) : void 0;
@@ -3457,13 +4538,40 @@ ${anchor(element)}<Tabs>
 ${tabs.join("\n\n")}
 </Tabs>
 
+`;
+    }
+  });
+  turndown.addRule("migration-complete-captured-tabs", {
+    filter: (node) => node.hasAttribute("data-thally-static-tabs"),
+    replacement: (_content, node) => {
+      const element = node;
+      const fragment = load5(element.outerHTML);
+      const container = fragment("[data-thally-static-tabs]").first();
+      const panels = container.find("[data-thally-static-tab]").toArray().filter((panel) => fragment(panel).closest("[data-thally-static-tabs]")[0] === container[0]);
+      const tabs = panels.map((panel) => {
+        const selection = fragment(panel);
+        const title2 = migrationImageAttribute(selection.attr("data-thally-static-tab"));
+        const id2 = selection.attr("id");
+        const panelAnchor = options.preserveAnchors && id2 ? `<a id="${migrationImageAttribute(id2)}" />
+
+` : "";
+        return `<Tab title="${title2}">
+${panelAnchor}${turndown.turndown(selection.html() ?? "").trim()}
+</Tab>`;
+      });
+      return `
+
+${anchor(element)}<Tabs>
+${tabs.join("\n\n")}
+</Tabs>
+
 `;
     }
   });
   turndown.addRule("gfm-table", {
     filter: "table",
     replacement: (_content, node) => {
-      const fragment = load4(node.outerHTML);
+      const fragment = load5(node.outerHTML);
       const rows = fragment("tr").toArray().map((row) => fragment(row).children("th,td").toArray().map((cell) => {
         const wasConvertingTableCell = isConvertingTableCell;
         isConvertingTableCell = true;
@@ -3489,7 +4597,7 @@ ${normalized.slice(1).map((row) => `| ${row.join(" | ")} |`).join("\n")}
     filter: (node) => node.nodeName === "PRE",
     replacement: (_content, node) => {
       const element = node;
-      const fragment = load4(element.outerHTML);
+      const fragment = load5(element.outerHTML);
       const tokenLines = fragment(".token-line").toArray();
       const code = (tokenLines.length > 0 ? tokenLines.map((line) => fragment(line).text()).join("\n") : fragment("pre").text()).replace(/\n$/, "");
       const language = ["code", "pre"].flatMap((selector) => {
@@ -3514,7 +4622,7 @@ ${fence}
   const escape = turndown.escape.bind(turndown);
   turndown.escape = (text2) => isConvertingTableCell ? escape(text2.replace(/[<>{}]/g, (character) => ({ "<": "&lt;", ">": "&gt;", "{": "&#123;", "}": "&#125;" })[character])) : escape(text2).replace(/[<{}]/g, (match) => `\\${match}`);
   const body = `${documentHeadingAnchor}${turndown.turndown(root.html() ?? "").trim()}`;
-  if (!title || body.length < 40 && $("article").length === 0) return { page: null, links };
+  if (!title || body.length < 40 && $("article").length === 0) return { page: null, links, assets };
   return {
     page: {
       id,
@@ -3525,10 +4633,74 @@ ${fence}
       body,
       source: document.finalUrl.toString()
     },
-    links
+    links,
+    assets
   };
 }
 
+// src/url-identity.ts
+var directory = (path) => path.replace(/\/index\/?$/i, "").replace(/\/$/, "") || "/";
+function migrationSectionQueryCandidate(source, anchors) {
+  const target2 = new URL(source);
+  const sections = [...source.searchParams].filter(([, value]) => anchors.includes(value));
+  const section = sections.length === 1 && source.searchParams.getAll(sections[0][0]).length === 1 ? sections[0] : void 0;
+  if (section) target2.searchParams.delete(section[0]);
+  target2.hash = "";
+  target2.pathname = target2.pathname.replace(/\/+$/, "") || "/";
+  return { canonicalUrl: target2.href, ...section ? { sectionAnchor: section[1] } : {} };
+}
+function isMigrationUtilityUrl(url) {
+  return /^\/cdn-cgi\/l\/email-protection\/?$/i.test(url.pathname);
+}
+function declaredMigrationArticleUrl(document) {
+  const target2 = declaredCanonical(document);
+  return target2 && target2.search === document.finalUrl.search ? target2 : document.finalUrl;
+}
+function declaredCanonical(document) {
+  if (!/html/i.test(document.contentType)) return void 0;
+  const reference = load6(document.body)('link[rel="canonical"][href]').first().attr("href");
+  if (!reference) return void 0;
+  try {
+    const target2 = new URL(reference, document.finalUrl);
+    if (target2.origin !== document.finalUrl.origin || target2.username || target2.password || directory(target2.pathname) !== directory(document.finalUrl.pathname)) return void 0;
+    target2.hash = "";
+    target2.pathname = target2.pathname.replace(/\/+$/, "") || "/";
+    return target2;
+  } catch {
+    return void 0;
+  }
+}
+function observedMigrationArticleIdentity(document) {
+  if (!/html/i.test(document.contentType)) return void 0;
+  const { $, root } = migrationHtmlArticle(document.body);
+  if (!root.length || !root.text().trim()) return void 0;
+  const anchors = root.find("[id]").toArray().map((node) => $(node).attr("id"));
+  root.find("nav,aside,footer,script,style").remove();
+  const metadata = load6(document.body);
+  const payload = JSON.stringify([
+    $.html(root),
+    metadata("title").text(),
+    metadata('meta[name="description"]').attr("content"),
+    metadata("html").attr("lang"),
+    document.locale,
+    document.version,
+    // Deferred content can exist only in inert hydration data. Never erase its
+    // differences merely because two collapsed DOM panels appear identical.
+    metadata("script").toArray().map((node) => [metadata(node).attr("src"), metadata(node).text()]),
+    (document.states ?? []).map((state) => [state.id, state.label, state.response.body])
+  ]);
+  const source = document.finalUrl;
+  const canonical2 = declaredCanonical(document) ?? new URL(source);
+  if (canonical2.href === source.href) {
+    canonical2.href = migrationSectionQueryCandidate(source, anchors).canonicalUrl;
+  }
+  canonical2.hash = "";
+  canonical2.pathname = canonical2.pathname.replace(/\/+$/, "") || "/";
+  const removed = [...source.searchParams].filter(([key, value]) => !canonical2.searchParams.getAll(key).includes(value));
+  const sectionAnchor = removed.length === 1 && anchors.includes(removed[0][1]) ? removed[0][1] : void 0;
+  return { canonicalUrl: canonical2.href, articleSha256: createHash3("sha256").update(payload).digest("hex"), ...sectionAnchor ? { sectionAnchor } : {} };
+}
+
 // src/url-api-schema-controls.ts
 var MAX_CAPTURE_BYTES2 = 8e6;
 var MAX_TAB_GROUPS = 256;
@@ -3647,17 +4819,378 @@ function apiSchemaTabGroups(body, document, operation) {
   for (const proof of proofs) scopeCounts.set(proof.scope, (scopeCounts.get(proof.scope) ?? 0) + 1);
   return proofs.filter((proof) => scopeCounts.get(proof.scope) === 1).map((proof) => proof.index);
 }
+function apiSchemaDisclosureGroups(body, document, operation) {
+  if (Buffer.byteLength(body) > MAX_CAPTURE_BYTES2 || !complete(document)) return [];
+  if (!/^(?:get|post|put|patch|delete|head|options|trace)$/i.test(operation.method)) return [];
+  const path = object2(object2(document.paths)?.[operation.path]);
+  const selected = object2(path?.[operation.method.toLowerCase()]);
+  if (!selected) return [];
+  const { $, root } = migrationHtmlArticle(body);
+  const operations = root.find('[id^="api-playground-"][id$="-operation-page"]').filter((_index, node) => {
+    const item = $(node);
+    const endpoint = item.find('[data-component-part="scroll-area-content"]').first().clone();
+    endpoint.find("[data-thally-static-base-urls]").remove();
+    return item.find(".method-pill").first().text().trim().toLowerCase() === operation.method.toLowerCase() && endpoint.text().trim() === operation.path;
+  });
+  if (operations.length !== 1) return [];
+  const ids = /* @__PURE__ */ new Map();
+  root.find("[id]").each((_index, node) => {
+    const id = $(node).attr("id");
+    ids.set(id, (ids.get(id) ?? 0) + 1);
+  });
+  if (ids.get(operations.attr("id")) !== 1) return [];
+  let visits = 0;
+  const property = (value, name, active = /* @__PURE__ */ new Set()) => {
+    if (++visits > 1e5 || active.has(value)) return [];
+    const schema = resolve2(document, value);
+    if (!schema) return [];
+    active.add(value);
+    const direct = object2(schema.properties)?.[name];
+    const result = direct ? [direct] : [
+      ...schema.items ? property(schema.items, name, active) : [],
+      ...["allOf", "oneOf", "anyOf"].flatMap((key) => Array.isArray(schema[key]) ? schema[key].flatMap((child) => property(child, name, active)) : [])
+    ];
+    active.delete(value);
+    return result;
+  };
+  const fieldSelector = ".object-param-field,.array-param-field";
+  const proofs = [];
+  if (root.find("details").length > MAX_TABS) return [];
+  root.find("details").each((index, node) => {
+    const details = $(node), control = details.children('summary[data-component-part="expandable-button"]');
+    const panel = details.children('[data-component-part="expandable-content"]');
+    const field = details.closest(fieldSelector), section = field.closest(".api-section");
+    if (!details.is('.expandable[data-component-part="expandable"]') || control.length !== 1 || panel.length !== 1 || details.children().length !== 2 || !field.length || section.closest('[id^="api-playground-"][id$="-operation-page"]')[0] !== operations[0]) return;
+    const target2 = control.attr("aria-controls"), controlId = control.attr("id");
+    if (target2 && (panel.attr("id") !== target2 || ids.get(target2) !== 1) || controlId && ids.get(controlId) !== 1) return;
+    const payload = panel.clone();
+    payload.find("script,style").remove();
+    if (payload.text().trim() || payload.children().length) return;
+    const ancestors = field.parents(fieldSelector).toArray().reverse().filter((owner) => $(owner).is(".array-param-field") || $(owner).find('[data-component-part="expandable-content"]').toArray().some((region) => $(region).closest(fieldSelector)[0] === owner && field.parents().toArray().includes(region)));
+    const chain = [...ancestors, field[0]];
+    const names = chain.map((owner) => $(owner).find('[data-component-part="field-name"]').filter((_index, name) => $(name).closest(fieldSelector)[0] === owner));
+    const hasNamedPath = names.every((name) => name.length === 1 && Boolean(name.text().trim()));
+    const heading = section.children(".api-section-heading");
+    if (heading.length !== 1) return;
+    const leaves = heading.find("*").toArray().filter((element) => $(element).children().length === 0).map((element) => $(element).text().trim());
+    const combined = leaves.flatMap((text2) => {
+      const match = text2.match(/^([1-5]\d{2}|default) - ([a-z][a-z\d.+-]*\/[a-z\d.+-]+)$/i);
+      return match ? [{ status: match[1], media: match[2] }] : [];
+    });
+    const media = heading.find("*").toArray().filter((element) => $(element).children().length === 0).map((element) => $(element).text().trim()).filter((text2) => /^[a-z][a-z\d.+-]*\/[a-z\d.+-]+$/i.test(text2));
+    const statuses = heading.find('button[aria-haspopup="menu"]').toArray().map((button) => $(button).text().trim()).filter((text2) => /^(?:[1-5]\d{2}|default)$/.test(text2));
+    if (combined.length === 1 && !media.length && !statuses.length) {
+      media.push(combined[0].media);
+      statuses.push(combined[0].status);
+    }
+    let schemas = [];
+    let offset = 0;
+    let prefix = "";
+    if (media.length === 1 && statuses.length === 1) {
+      const response = resolve2(document, object2(selected.responses)?.[statuses[0]]);
+      schemas = [object2(object2(response?.content)?.[media[0]])?.schema];
+      prefix = "response";
+    } else if (media.length === 1 && !statuses.length) {
+      const request = resolve2(document, selected.requestBody);
+      schemas = [object2(object2(request?.content)?.[media[0]])?.schema];
+      prefix = "body";
+    } else if (!media.length && !statuses.length) {
+      const head = $(chain[0]).find(".param-head[id]").filter((_index, element) => $(element).closest(fieldSelector)[0] === chain[0]).first().attr("id") ?? "";
+      const location = ["query", "path", "header", "cookie"].find((value) => head.startsWith(`${value}-`));
+      if (names[0]?.length !== 1 || !location && !head.startsWith("parameter-")) return;
+      const parameters = [...Array.isArray(path?.parameters) ? path.parameters : [], ...Array.isArray(selected.parameters) ? selected.parameters : []].map((value) => resolve2(document, value)).filter((parameter) => (!location || parameter?.in === location) && parameter?.name === names[0].text().trim());
+      if (parameters.length !== 1) return;
+      schemas = [parameters[0]?.schema];
+      offset = 1;
+      prefix = $(chain[0]).is(".array-param-field") ? "parameter" : `parameter-${names[0].text().trim()}`;
+    }
+    const expandable = (value) => {
+      const schema = resolve2(document, value);
+      return Boolean(schema && (object2(schema.properties) || object2(schema.items) || object2(schema.additionalProperties) || ["allOf", "oneOf", "anyOf"].some((key) => Array.isArray(schema[key]))));
+    };
+    const roots = schemas;
+    if (hasNamedPath) {
+      for (const name of names.slice(offset)) schemas = schemas.flatMap((schema) => property(schema, name.text().trim()));
+      if (schemas.some(expandable)) {
+        proofs.push(index);
+        return;
+      }
+    }
+    const marker = details.attr("data-testid");
+    if (!prefix || !marker?.endsWith("-children")) return;
+    const expected = marker.slice(0, -"-children".length);
+    const visibleNames = chain.flatMap((owner) => {
+      const labels2 = $(owner).find('[data-component-part="field-name"]').filter((_index, label) => $(label).closest(fieldSelector)[0] === owner);
+      return labels2.length === 1 ? [labels2.text().trim()] : [];
+    });
+    const matches = /* @__PURE__ */ new Set();
+    const walk = (value, key, pathNames, active = /* @__PURE__ */ new Set()) => {
+      if (++visits > 1e5 || key.length > 2048 || active.has(value)) return;
+      const schema = resolve2(document, value);
+      if (!schema) return;
+      if (key === expected && expandable(schema)) {
+        let cursor = 0;
+        const labelsAgree = visibleNames.every((name) => {
+          const found = pathNames.indexOf(name, cursor);
+          cursor = found + 1;
+          return found >= 0;
+        });
+        if (labelsAgree) matches.add(schema);
+      }
+      if (!expected.startsWith(`${key}-`)) return;
+      active.add(value);
+      for (const [name, child] of Object.entries(object2(schema.properties) ?? {})) {
+        const segments = /* @__PURE__ */ new Set([name, name.replace(/([a-z\d])([A-Z])/g, "$1-$2").toLowerCase()]);
+        for (const segment of segments) walk(child, `${key}-${segment}`, [...pathNames, name], active);
+      }
+      if (schema.items) walk(schema.items, `${key}-items`, pathNames, active);
+      if ((schema.nullable === true || Array.isArray(schema.type) && schema.type.includes("null")) && !schema.oneOf) walk({ ...schema, nullable: false, type: Array.isArray(schema.type) ? schema.type.filter((value2) => value2 !== "null") : schema.type }, `${key}-one-of-0`, pathNames, active);
+      if (Array.isArray(schema.allOf)) schema.allOf.forEach((child) => walk(child, key, pathNames, active));
+      for (const [keyword, segment] of [["allOf", "all-of"], ["oneOf", "one-of"], ["anyOf", "any-of"]]) {
+        const children = schema[keyword];
+        if (Array.isArray(children)) children.forEach((child, branch) => walk(child, `${key}-${segment}-${branch}`, pathNames, active));
+      }
+      active.delete(value);
+    };
+    roots.forEach((schema) => walk(schema, prefix, offset ? [names[0].text().trim()] : []));
+    if (matches.size === 1) proofs.push(index);
+  });
+  return visits > 1e5 ? [] : proofs;
+}
+function apiOperationCodeControls(body, specification, operation) {
+  if (Buffer.byteLength(body) > MAX_CAPTURE_BYTES2 || !complete(specification)) return [];
+  const selected = object2(object2(object2(specification.paths)?.[operation.path])?.[operation.method.toLowerCase()]);
+  if (!selected) return [];
+  const { $, root } = migrationHtmlArticle(body);
+  const flight = readMigrationFlightDocument($);
+  if (!flight) return [];
+  let visited = 0, textBytes = 0, exceeded = false;
+  const resolveValue = (input) => {
+    if (exceeded) return void 0;
+    const result = resolveMigrationFlightValue(flight, input);
+    if (!result.resolved) exceeded = true;
+    return result.value;
+  };
+  const textOf = (input, depth = 0, label = false) => {
+    if (exceeded || ++visited > 1e5 || depth > 96) {
+      exceeded = true;
+      return void 0;
+    }
+    const value = resolveValue(input);
+    if (value === void 0 || value === null || typeof value === "boolean") return "";
+    if (typeof value === "string" || typeof value === "number") {
+      const result = String(value);
+      textBytes += Buffer.byteLength(result);
+      if (textBytes > MAX_CAPTURE_BYTES2) {
+        exceeded = true;
+        return void 0;
+      }
+      return result;
+    }
+    if (!Array.isArray(value)) return void 0;
+    if (value[0] === "$") {
+      if (typeof value[1] !== "string" || !(label ? ["div", "p", "span", "code", "a", "br", "svg", "path", "polyline"] : ["span", "code", "a", "br"]).includes(value[1]) || !object2(value[3])) return void 0;
+      return value[1] === "br" ? "\n" : textOf(value[3].children, depth + 1, label);
+    }
+    const children = value.map((child) => textOf(child, depth + 1, label));
+    return children.some((child) => child === void 0) ? void 0 : children.join("");
+  };
+  const samplePairs = (value, transport = true) => {
+    if (exceeded) return void 0;
+    const samples = transport ? resolveValue(value) : value;
+    if (!Array.isArray(samples) || samples.length > 64) return void 0;
+    const pairs = [];
+    for (const input of samples) {
+      const sample = object2(transport ? resolveValue(input) : input);
+      const language = transport ? resolveValue(sample?.lang) : sample?.lang;
+      const source = transport ? resolveValue(sample?.source) : sample?.source;
+      const label = transport ? resolveValue(sample?.label) : sample?.label;
+      if (label !== void 0 && typeof label !== "string") return void 0;
+      if (typeof language !== "string" || !language.trim() || typeof source !== "string" || !source.trim()) return void 0;
+      textBytes += Buffer.byteLength(language) + Buffer.byteLength(source) + (typeof label === "string" ? Buffer.byteLength(label) : 0);
+      if (textBytes > MAX_CAPTURE_BYTES2) {
+        exceeded = true;
+        return void 0;
+      }
+      pairs.push(JSON.stringify([language, source, label ?? null]));
+    }
+    return pairs;
+  };
+  const declared = selected["x-codeSamples"] === void 0 ? [] : samplePairs(selected["x-codeSamples"], false);
+  if (!declared) return [];
+  const groups = [];
+  const providers = [];
+  let providerCount = 0, generatedControllers = 0, providerMetadataMatches = false;
+  const matchesOperation = (value) => {
+    const metadata = object2(resolveValue(value));
+    const declaration = resolveValue(metadata?.openapi);
+    if (typeof declaration !== "string") return false;
+    const tokens = declaration.trim().split(/\s+/);
+    return tokens.at(-2)?.toLowerCase() === operation.method.toLowerCase() && tokens.at(-1) === operation.path;
+  };
+  const active = /* @__PURE__ */ new Set();
+  const visit = (input, provider, group, depth, owners = []) => {
+    if (exceeded || ++visited > 1e5 || depth > 96) {
+      exceeded = true;
+      return;
+    }
+    const value = resolveValue(input);
+    if (!value || typeof value !== "object") return;
+    if (active.has(value)) {
+      exceeded = true;
+      return;
+    }
+    active.add(value);
+    if (Array.isArray(value)) {
+      if (value[0] === "$" && object2(value[3])) {
+        const props = value[3];
+        const moduleId = typeof value[1] === "string" ? /^\$L([a-f\d]+)$/i.exec(value[1])?.[1] : void 0;
+        const kind = moduleId ? flight.modules.get(moduleId) : value[1];
+        const ownId = moduleId ? void 0 : resolveValue(props.id);
+        const localOwners = typeof ownId === "string" ? [...owners, ownId] : owners;
+        let owned = provider;
+        if (kind === "OpenApiProvider") {
+          providerCount += 1;
+          const data = object2(resolveValue(props.openApiReferenceData));
+          const source = object2(resolveValue(data?.operation));
+          const samples = samplePairs(source?.codeSamples);
+          const authored = source?.["x-codeSamples"] === void 0 ? [] : samplePairs(source["x-codeSamples"]);
+          owned = Boolean(source && source.method === operation.method.toLowerCase() && source.path === operation.path && samples && authored && JSON.stringify(samples) === JSON.stringify(declared) && JSON.stringify(authored) === JSON.stringify(declared));
+          if (owned) {
+            providers.push(source);
+            providerMetadataMatches = matchesOperation(props.pageMetadata);
+          }
+        }
+        if (owned && kind === "MDXContentController" && matchesOperation(props.pageMetadata)) {
+          const child = resolveValue(props.children);
+          const childId = Array.isArray(child) && child[0] === "$" && typeof child[1] === "string" ? /^\$L([a-f\d]+)$/i.exec(child[1])?.[1] : void 0;
+          const childProps = Array.isArray(child) ? object2(child[3]) : void 0;
+          const source = object2(resolveValue(childProps?.mdxSource));
+          const scope = object2(resolveValue(source?.scope));
+          if (childId && flight.modules.get(childId) === "default" && typeof source?.compiledSource === "string" && (() => {
+            if (matchesOperation(scope?.pageMetadata)) return true;
+            const hint = object2(resolveValue(scope?.pageMetadata)), metadata = object2(resolveValue(props.pageMetadata));
+            const declaration = resolveValue(hint?.openapi);
+            if (typeof declaration !== "string" || typeof hint?.href !== "string" || !hint.href || hint.href !== metadata?.href) return false;
+            const tokens = declaration.trim().split(/\s+/);
+            const template = (path) => path.split("/").map((segment) => /^\{[^{}\/]+\}$/.test(segment) ? "{}" : segment).join("/");
+            return tokens.at(-2)?.toLowerCase() === operation.method.toLowerCase() && template(tokens.at(-1) ?? "") === template(operation.path);
+          })()) generatedControllers += 1;
+        }
+        let local = group;
+        if (owned && typeof props.className === "string" && props.className.split(/\s+/).includes("code-group")) {
+          local = { owners: localOwners, code: [], controls: [], toolbar: false, generated: false, invalid: false };
+          groups.push(local);
+        }
+        if (local && owned) {
+          if (props["data-component-part"] === "code-group-tab-bar") local.toolbar = true;
+          if (String(props["data-index"]) === "-1") local.generated = true;
+          if (props["aria-expanded"] !== void 0) {
+            const text2 = textOf(props.children, 0, true);
+            if (kind !== "button" || props["aria-haspopup"] !== "menu" || text2 === void 0) local.invalid = true;
+            else local.controls.push(JSON.stringify([text2, props["aria-label"] ?? "", String(props["aria-expanded"]), props["aria-haspopup"]]));
+          }
+          if (kind === "pre") {
+            const code = textOf(props.children);
+            if (code === void 0 || !code.trim()) local.invalid = true;
+            else local.code.push(code);
+          }
+          if (props["aria-busy"] === true || props["aria-busy"] === "true" || props.role === "progressbar") local.invalid = true;
+        }
+        visit(props.children, owned, local, depth + 1, localOwners);
+      } else for (const child of value) visit(child, provider, group, depth + 1, owners);
+    } else if (depth === 0 && Array.isArray(value.f)) {
+      visit(value.f, provider, group, depth + 1, owners);
+    } else if (Object.keys(value).every((key) => key === "children")) {
+      const children = value.children;
+      if (Array.isArray(children) && children.length >= 2) visit(children, provider, group, depth + 1, owners);
+    }
+    active.delete(value);
+  };
+  visit(flight.records.get("0"), false, void 0, 0);
+  if (exceeded || providerCount !== 1 || providers.length !== 1 || groups.length > MAX_TAB_GROUPS) return [];
+  const sources = declared.map((pair) => JSON.parse(pair)[1]);
+  const sourceCounts = /* @__PURE__ */ new Map();
+  for (const group of groups) if (group.toolbar && group.generated && !group.invalid && group.controls.length >= 1 && group.controls.length <= 2) {
+    const signature = JSON.stringify([group.owners, group.code, group.controls]);
+    sourceCounts.set(signature, (sourceCounts.get(signature) ?? 0) + 1);
+  }
+  const expanded = root.find("[aria-expanded]").toArray();
+  if (expanded.length > MAX_TABS) return [];
+  const controlIndices = new Map(expanded.map((node, index) => [node, index]));
+  const domGroups = /* @__PURE__ */ new Map();
+  $(expanded).each((_index, node) => {
+    const control = $(node);
+    const group = control.closest('.code-group,[data-testid="code-group-select"]');
+    const legacy = group.is('[data-testid="code-group-select"]');
+    if (!control.is('button[aria-haspopup="menu"]') || control.attr("aria-controls") || !legacy && !control.closest('[data-component-part="code-group-tab-bar"]').length || !group.length || group.find("[aria-expanded]").length < 1 || group.find("[aria-expanded]").length > 2) return;
+    if (domGroups.has(group[0])) return;
+    const menus = group.find("[aria-expanded]");
+    if (menus.toArray().some((menu) => !$(menu).is('button[aria-haspopup="menu"]') || !$(menu).attr("aria-label")?.trim() && !$(menu).text().trim() || $(menu).attr("aria-controls") || !legacy && $(menu).closest('[data-component-part="code-group-tab-bar"]')[0] !== group.children('[data-component-part="code-group-tab-bar"]')[0] || legacy && !$(menu).parents().toArray().includes(group.children().first()[0]))) return;
+    if (menus.length === 2) {
+      const samples = declared.map((pair) => JSON.parse(pair));
+      const labelledChoices = samples.filter((sample) => sample[2] && samples.filter((other) => other[0] === sample[0]).length >= 2);
+      if (!labelledChoices.length || !menus.toArray().some((menu) => labelledChoices.some((sample) => sample[2] === $(menu).text().trim()))) return;
+    }
+    const panels = group.find("[data-index]");
+    const code = group.find("pre").toArray().map((pre) => {
+      const lines = $(pre).find(".token-line");
+      return lines.length ? lines.toArray().map((line) => $(line).text()).join("\n") : $(pre).text();
+    });
+    if (group.find('[aria-busy="true"],[role="progressbar"]').length) return;
+    if (legacy) {
+      if (menus.length !== 2 || group.children().length !== 2 || group.children().first().find("pre").length || code.length !== 1 || !code[0].trim() || panels.length) return;
+      const selectedSamples = declared.map((pair) => JSON.parse(pair)).filter((sample) => sample[2] && menus.toArray().some((menu) => $(menu).text().trim() === sample[2]) && menus.toArray().some((menu) => $(menu).text().trim().toLowerCase() === sample[0]?.toLowerCase()) && (code[0] === sample[1] || code[0] === sample[1]?.replace(/\n$/, "")));
+      if (!selectedSamples.length) return;
+    } else if (!panels.length || panels.length > MAX_TABS || code.length !== panels.length || !panels.toArray().some((panel) => $(panel).attr("data-index") === "-1") || panels.toArray().some((panel) => $(panel).find("pre").length !== 1 || !$(panel).text().trim()) || !sources.every((source) => code.some((captured) => captured === source || captured === source.replace(/\n$/, "")))) return;
+    const controls = menus.toArray().map((menu) => JSON.stringify([$(menu).text(), $(menu).attr("aria-label") ?? "", $(menu).attr("aria-expanded"), $(menu).attr("aria-haspopup")]));
+    const owners = group.parents("[id]").toArray().reverse().map((owner) => $(owner).attr("id"));
+    if (group.attr("id")) owners.push(group.attr("id"));
+    domGroups.set(group[0], { signature: JSON.stringify([owners, code, controls]), indices: menus.toArray().map((menu) => controlIndices.get(menu)), code, legacy, title: group.children('[data-component-part="code-group-tab-bar"]').find("span[title]").first().attr("title"), label: legacy || group.children('[data-component-part="code-group-tab-bar"]').length === 1 && group.children('[data-component-part="code-group-tab-bar"]').find("span[title]").toArray().some((title) => Boolean($(title).attr("title")?.trim()) && $(title).text().trim() === $(title).attr("title")) });
+  });
+  const domCounts = /* @__PURE__ */ new Map();
+  for (const group of domGroups.values()) domCounts.set(group.signature, (domCounts.get(group.signature) ?? 0) + 1);
+  const proofs = [];
+  for (const group of domGroups.values()) if (sourceCounts.get(group.signature) === 1 && domCounts.get(group.signature) === 1) proofs.push(...group.indices);
+  if (groups.length === 0 && providerMetadataMatches && generatedControllers === 1 && domGroups.size === 2) {
+    const operations = root.find('[id^="api-playground-"][id$="-operation-page"]').filter((_index, node) => {
+      const endpoint = $(node).find('[data-component-part="scroll-area-content"]').first().clone();
+      endpoint.find("[data-thally-static-base-urls]").remove();
+      return $(node).find(".method-pill").first().text().trim().toLowerCase() === operation.method.toLowerCase() && endpoint.text().trim() === operation.path;
+    });
+    const main = $("main#content-container"), side = $('[id="content-side-layout"]');
+    const content = $('[id="content-area"]');
+    const slots = /* @__PURE__ */ new Map();
+    const titles = [resolveValue(providers[0].title), resolveValue(providers[0].summary), ...declared.flatMap((pair) => {
+      const values = JSON.parse(pair);
+      return [values[0], values[2]];
+    })].filter((value) => typeof value === "string").map((value) => value.toLowerCase());
+    let valid = operations.length === 1 && main.length === 1 && side.length === 1 && content.length === 1 && operations.closest("#content-area")[0] === content[0] && $("[id]").filter((_index, node) => $(node).attr("id") === operations.attr("id")).length === 1 && side.closest("main")[0] === main[0];
+    for (const [node, entry] of domGroups) {
+      const group = $(node);
+      const control = group.find("button[aria-expanded]").first();
+      const owner = group.closest('[id^="api-playground-"][id$="-operation-page"]');
+      const slot = owner[0] === operations[0] ? "inline" : group.closest("#content-side-layout")[0] === side[0] ? "sidebar" : void 0;
+      if (!slot || slots.has(slot) || !entry.label || !entry.legacy && (!entry.title || !titles.includes(entry.title.toLowerCase()) || !control.attr("aria-label")?.trim()) || group.closest("main")[0] !== main[0] || group.closest('.mdx-content,.api-section,.object-param-field,.array-param-field,[data-component-part="expandable-content"]').length) valid = false;
+      else slots.set(slot, entry);
+    }
+    if (valid && slots.size === 2 && JSON.stringify(slots.get("inline")?.code) === JSON.stringify(slots.get("sidebar")?.code)) {
+      proofs.push(...[...slots.values()].flatMap((slot) => slot.indices));
+    }
+  }
+  return proofs;
+}
 
 // src/url-run.ts
-var CONVERTER_VERSION = "url-evidence-v5";
-var parser = unified3().use(remarkParse3).use(remarkMdx3);
+var CONVERTER_VERSION = "url-evidence-v6";
+var parser2 = unified4().use(remarkParse4).use(remarkMdx4);
 var ACCEPT = "text/markdown,text/html,application/xhtml+xml;q=0.9";
 var MAX_RESPONSE_BYTES = 8e6;
 var MAX_ASSET_BYTES = 1e7;
 var MAX_RECORDS = 1e5;
 var LOCALES = /* @__PURE__ */ new Set(["ar", "cs", "da", "de", "el", "en", "es", "fi", "fr", "he", "hi", "hu", "id", "it", "ja", "ko", "ms", "nl", "no", "pl", "pt", "pt-br", "ro", "ru", "sk", "sv", "th", "tr", "uk", "vi", "zh", "zh-cn", "zh-hans", "zh-hant"]);
 function hash(value) {
-  return createHash("sha256").update(value).digest("hex");
+  return createHash4("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;
@@ -3693,14 +5226,14 @@ function markdownNodes(body) {
     nodes.push(node);
     for (const child of node.children ?? []) visit(child);
   };
-  visit(parser.parse(body));
+  visit(parser2.parse(body));
   return nodes;
 }
 function markdownCode(body) {
   return markdownNodes(body).filter((node) => node.type === "code").map((node) => node.value ?? "");
 }
 function alternativeBlocks(body, baseline) {
-  const blocks = (value) => (parser.parse(value).children ?? []).map((node) => value.slice(node.position.start.offset, node.position.end.offset));
+  const blocks = (value) => (parser2.parse(value).children ?? []).map((node) => value.slice(node.position.start.offset, node.position.end.offset));
   const originals = new Set(blocks(baseline));
   return blocks(body).filter((block) => !originals.has(block)).join("\n\n");
 }
@@ -3712,7 +5245,7 @@ function linksOf(document) {
     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 $ = load5(document.body, { xmlMode: true });
+    const $ = load7(document.body, { xmlMode: true });
     return $("loc").toArray().map((node) => $(node).text().trim());
   }
   return [
@@ -3742,7 +5275,8 @@ function evidenceOf(capture) {
     ...capture.artifactRef ? { artifactRef: capture.artifactRef } : {},
     states: (capture.states ?? []).map((state) => ({ id: state.id, label: state.label, sha256: hash(state.response.body) })),
     ...technical,
-    links: linksOf(capture)
+    links: linksOf(capture),
+    articleIdentity: observedMigrationArticleIdentity(capture)
   };
 }
 function markdownHeadingAnchors(body) {
@@ -3763,20 +5297,6 @@ function idForUrl(url, scope) {
   const id = pageIdFromReference(relative4 || "introduction", true);
   return id && `${id}${url.search ? `--${hash(url.search).slice(0, 12)}` : ""}`;
 }
-function articleIdentity(document) {
-  if (!/html/i.test(document.contentType)) return document.finalUrl;
-  const $ = load5(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);
@@ -3825,24 +5345,52 @@ function assetReferences(capture) {
     ...root.find("[srcset]").toArray().flatMap((node) => migrationImageCandidates($(node).attr("srcset") ?? "", capture.finalUrl).map((candidate) => candidate.url))
   ].filter(Boolean);
 }
-function unresolvedStaticControls(body, hasApiSchema = false, coveredSchemaGroups = []) {
+function unresolvedStaticControls(body, coveredSchemaGroups = [], coveredSchemaDisclosures = [], coveredCodeControls = []) {
   const { $, root } = migrationHtmlArticle(body);
+  root.find("[aria-expanded]").each((index, node) => {
+    if (coveredCodeControls.includes(index)) $(node).removeAttr("aria-expanded");
+  });
   root.find('[role="tablist"],[data-component-part="tabs-list"]').each((index, node) => {
     if (coveredSchemaGroups.includes(index)) $(node).remove();
   });
+  root.find("details").each((index, node) => {
+    if (coveredSchemaDisclosures.includes(index)) $(node).remove();
+  });
   const tabs = root.find('[role="tab"]').toArray();
+  const idCounts = /* @__PURE__ */ new Map();
+  root.find("[id]").each((_index, node) => {
+    const id = $(node).attr("id");
+    idCounts.set(id, (idCounts.get(id) ?? 0) + 1);
+  });
   for (const tab of tabs) {
+    const controlId = $(tab).attr("id");
+    if (controlId && idCounts.get(controlId) !== 1) return true;
     const controls = $(tab).attr("aria-controls");
-    const group = $(tab).closest('[role="tablist"]');
+    const group = $(tab).closest('[role="tablist"],ul.tabs');
     const container = group.closest(".code-group,.tabs-container,.tabs.tab-container");
-    const peers = group.find('[role="tab"]').toArray().filter((node) => $(node).closest('[role="tablist"]')[0] === group[0]);
+    const peers = group.find('[role="tab"]').toArray().filter((node) => $(node).closest('[role="tablist"],ul.tabs')[0] === group[0]);
     const localPanels = container.find('[role="tabpanel"]').toArray().filter((node) => $(node).closest(".code-group,.tabs-container,.tabs.tab-container")[0] === container[0]);
-    const owners = container.find('[role="tablist"]').toArray().filter((node) => $(node).closest(".code-group,.tabs-container,.tabs.tab-container")[0] === container[0]);
+    const owners = container.find('[role="tablist"],ul.tabs').toArray().filter((node) => $(node).closest(".code-group,.tabs-container,.tabs.tab-container")[0] === container[0]);
     const panels = controls ? root.find("[id]").filter((_index, node) => $(node).attr("id") === controls) : owners.length === 1 && peers.length === localPanels.length ? $(localPanels).eq(peers.indexOf(tab)) : $([]);
-    if (panels.length !== 1 || !panels.text().trim() && !panels.find("pre,img,table,svg").length || panels.find('[aria-busy="true"],[role="progressbar"]').length) return true;
-  }
+    if (panels.length !== 1 || !panels.text().trim() && !panels.find("pre,img,table,svg").length || panels.is('[aria-busy="true"],[role="progressbar"]') || panels.find('[aria-busy="true"],[role="progressbar"]').length) return true;
+    const labels2 = panels.attr("aria-labelledby")?.trim().split(/\s+/);
+    if (labels2 && (!controlId || !labels2.includes(controlId))) return true;
+    if (controls && !labels2 && (container.length ? panels.closest(".code-group,.tabs-container,.tabs.tab-container")[0] !== container[0] : panels.parent()[0] !== group.parent()[0])) return true;
+  }
+  const isCapturedImageZoom = (node, depth = 0) => {
+    if (depth > 8) return false;
+    const control = $(node), image = control.prev("span.zoom-image-trigger[data-ramka-trigger]");
+    return control.is('button[data-ramka-trigger][aria-haspopup="dialog"][aria-label]') && Boolean(control.attr("aria-label")?.trim()) && !control.attr("aria-controls") && !control.text().trim() && image.find("img[src]").length === 1 && !image.text().trim() && !image.find("form,iframe,object,embed,canvas").length && image.find("button").toArray().every((button) => isCapturedImageZoom(button, depth + 1));
+  };
+  if (root.find("[aria-expanded]").toArray().some((node) => {
+    const control = $(node);
+    if (control.attr("role") === "tab") return false;
+    const actions = control.parent('[id="page-context-menu"]');
+    if (control.is('button[aria-haspopup="menu"]') && !control.attr("aria-controls") && !control.text().trim() && actions.closest("header").length && actions.children("button#page-context-menu-button").length === 1) return false;
+    if (isCapturedImageZoom(node)) return false;
+    return true;
+  })) 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;
@@ -3880,7 +5428,7 @@ 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.apiSpecification || hasCompleteLocalApiSchema(record.apiSpecification.document) && record.apiSpecification.path === `openapi/migration-${record.apiSpecification.sha256}.json` && hash(canonicalJson(record.apiSpecification.document)) === record.apiSpecification.sha256) && record.assets?.every((asset) => /^migration-assets\/[a-f0-9]{64}\.[a-z0-9]+$/.test(asset.path) && hash(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` && hash(canonicalJson(record.apiSpecification.document)) === record.apiSpecification.sha256) && record.assets?.every((asset) => /^migration-assets\/[a-f0-9]{64}\.[a-z0-9]+$/.test(asset.path) && (!asset.derivedFromSha256 || /^[a-f0-9]{64}$/.test(asset.derivedFromSha256)) && hash(Buffer.from(asset.base64, "base64")) === asset.sha256));
 }
 function hasCompleteLocalApiSchema(document) {
   let visited = 0;
@@ -3986,7 +5534,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) ? load5(document.body)("html").attr("lang")?.trim() : void 0;
+  const declared = /html/i.test(document.contentType) ? load7(document.body)("html").attr("lang")?.trim() : void 0;
   if (declared) {
     const locale = canonicalLanguage(declared);
     if (locale) candidates.push({ source: "html lang", value: locale });
@@ -4090,14 +5638,14 @@ function validateUrlMigration(checkpoint, cancelled = false) {
         continue;
       }
       if (!inScope(link, source, checkpoint.scopePath)) continue;
-      if (isDiscoveryIndex(link, source)) continue;
+      if (isDiscoveryIndex(link, source) || isMigrationUtilityUrl(link)) continue;
       if (/\.(?:png|jpe?g|gif|svg|webp|avif|pdf|zip|mp4|webm|css|js|json|ya?ml)$/i.test(link.pathname)) continue;
       const destination = resolve4(link.toString());
       if (!destination || !["imported", "excluded"].includes(destination.outcome)) {
         issues.push({ code: "missing-page", source: record.url, message: `Unresolved internal destination: ${link}` });
-      } else if (link.hash && destination.outcome === "imported") {
-        let anchor = link.hash.slice(1);
-        try {
+      } else if ((link.hash || records.get(canonical(link.href, checkpoint.sourceUrl) ?? "")?.aliasAnchor) && destination.outcome === "imported") {
+        let anchor = link.hash.slice(1) || records.get(canonical(link.href, checkpoint.sourceUrl) ?? "").aliasAnchor;
+        if (link.hash) try {
           anchor = decodeURIComponent(anchor);
         } catch {
         }
@@ -4118,7 +5666,7 @@ function validateUrlMigration(checkpoint, cancelled = false) {
       const locale = node.locale ? canonicalLanguage(node.locale) : parentLocale;
       if (node.url) {
         const url = new URL(node.url, source);
-        if (inScope(url, source, checkpoint.scopePath)) {
+        if (inScope(url, source, checkpoint.scopePath) && !isMigrationUtilityUrl(url)) {
           const destination = resolve4(url.toString());
           if (destination?.outcome === "excluded" && destination.redirectTo) continue;
           const page = destination?.page;
@@ -4186,6 +5734,7 @@ async function runUrlMigration(options) {
       delete record.redirectTo;
       delete record.reason;
       delete record.aliasOf;
+      delete record.aliasAnchor;
     }
     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);
@@ -4196,7 +5745,8 @@ async function runUrlMigration(options) {
   const enqueue = (value, base, discoveredBy) => {
     const url = canonical(value, base);
     if (!url || !inScope(new URL(url), source, scopePath) && !isDiscoveryIndex(new URL(url), source)) return;
-    const isAttachment = discoveredBy !== "submitted" && /\.(?:json|ya?ml)$/i.test(new URL(url).pathname);
+    const isUtility = isMigrationUtilityUrl(new URL(url));
+    const isAttachment = isUtility || discoveredBy !== "submitted" && /\.(?:json|ya?ml)$/i.test(new URL(url).pathname);
     const existing = records.get(url);
     if (existing) {
       if (!existing.discoveredBy.includes(discoveredBy)) {
@@ -4210,7 +5760,7 @@ async function runUrlMigration(options) {
       url,
       discoveredBy: [discoveredBy],
       outcome: isAttachment ? "excluded" : "pending",
-      ...isAttachment ? { reason: "Machine-readable attachment, not an authored article." } : {}
+      ...isAttachment ? { reason: isUtility ? "Recognized provider utility endpoint, not an authored article." : "Machine-readable attachment, not an authored article." } : {}
     };
     records.set(url, record);
     checkpoint.records.push(record);
@@ -4253,12 +5803,27 @@ async function runUrlMigration(options) {
   let imported = usedIds.size;
   const assetPayloads = new Map(checkpoint.records.flatMap((record) => (record.assets ?? []).map((asset) => [asset.sha256, asset])));
   const assetBytes = /* @__PURE__ */ new Map();
-  const retainAsset = (asset) => {
+  const rasterizedSvgs = /* @__PURE__ */ new Map();
+  const retainAsset = async (original) => {
+    let asset = { ...original };
+    delete asset.derivedFromSha256;
     if (asset.unavailable) {
       if ([404, 410].includes(asset.unavailable.status) && asset.content.byteLength === 0) return asset;
       throw new Error("Invalid source asset availability evidence.");
     }
-    if (!acceptedAsset(asset)) throw new Error("Asset MIME/signature is unsupported or unsafe to serve.");
+    if (!acceptedAsset(asset)) {
+      if (asset.content.byteLength > MAX_ASSET_BYTES || asset.contentType.split(";", 1)[0].trim().toLowerCase() !== "image/svg+xml" || !options.rasterizeSvg) throw new Error("Asset MIME/signature is unsupported or unsafe to serve.");
+      const sourceSha256 = hash(asset.content);
+      let rendering = rasterizedSvgs.get(sourceSha256);
+      if (!rendering) {
+        rendering = options.rasterizeSvg({ ...asset, content: Buffer.from(asset.content) }, options.signal).then((rendered) => {
+          if (rendered.unavailable || rendered.contentType.split(";", 1)[0].trim().toLowerCase() !== "image/png" || acceptedAsset(rendered) !== "png") throw new Error("Trusted SVG renderer did not return a bounded PNG image.");
+          return { ...rendered, derivedFromSha256: sourceSha256 };
+        });
+        rasterizedSvgs.set(sourceSha256, rendering);
+      }
+      asset = { ...await rendering, url: original.url };
+    }
     const sha256 = hash(asset.content);
     const content = assetBytes.get(sha256) ?? Buffer.from(asset.content);
     assetBytes.set(sha256, content);
@@ -4274,6 +5839,26 @@ async function runUrlMigration(options) {
   }
   let totalBytes = checkpoint.records.reduce((sum, record) => sum + (record.evidence?.byteLength ?? 0), 0) + [...assetPayloads.values()].reduce((sum, asset) => sum + Buffer.byteLength(asset.base64, "base64"), 0);
   let budgetExhausted = false;
+  const exactCaptures = /* @__PURE__ */ new Map();
+  const exactCaptureKey = (document) => {
+    let body = document.body;
+    if (body.includes("data-cfemail")) {
+      const $ = load7(body);
+      projectProtectedEmails($, $.root());
+      body = $.html();
+    }
+    return hash(canonicalJson([
+      hash(body),
+      document.contentType,
+      document.status,
+      document.locale,
+      document.version,
+      document.headers?.["content-language"],
+      document.navigation,
+      (document.states ?? []).map((state) => [state.id, state.label, state.response.finalUrl.href, state.response.contentType, state.response.status, hash(state.response.body)]),
+      (document.assets ?? []).map((asset) => [asset.url, asset.contentType, asset.unavailable, hash(asset.content)])
+    ]));
+  };
   let cursor = 0;
   const flush = async () => {
     const distinct = [...new Map(changed.map((record) => [record.url, record])).values()];
@@ -4288,6 +5873,7 @@ async function runUrlMigration(options) {
     let claimedId;
     let claimedFinal;
     let markdownRepresentation;
+    let exactKey;
     try {
       delete record.reason;
       if (/\/llms-full\.txt$/i.test(new URL(record.url).pathname)) {
@@ -4315,7 +5901,43 @@ async function runUrlMigration(options) {
         throw new Error("Capture returned an unresolved redirect.");
       }
       if (Buffer.byteLength(document.body) > MAX_RESPONSE_BYTES) throw new Error("Captured response exceeds the 8 MB safety bound.");
-      const identity = articleIdentity(document);
+      if ((document.states?.length ?? 0) > 64 || (document.assets?.length ?? 0) > 256) throw new Error("Capture contains too many alternative states or assets.");
+      for (const state of document.states ?? []) if (Buffer.byteLength(state.response.body) > MAX_RESPONSE_BYTES) throw new Error("Alternative state exceeds the 8 MB safety bound.");
+      if (/html/i.test(document.contentType) && (!document.status || document.status < 300) && inScope(document.finalUrl, source, scopePath)) {
+        exactKey = exactCaptureKey(document);
+        const peer = resolveMigrationRecord(records, records.get(exactCaptures.get(exactKey) ?? ""));
+        const peerIdentity = peer?.evidence?.articleIdentity;
+        if (peer?.outcome === "imported" && peer.evidence && peerIdentity) {
+          const candidate = migrationSectionQueryCandidate(document.finalUrl, peer.evidence.anchors);
+          if (candidate.sectionAnchor && candidate.canonicalUrl === peerIdentity.canonicalUrl) {
+            const byteLength = Buffer.byteLength(document.body) + (document.states ?? []).reduce((sum, state) => sum + Buffer.byteLength(state.response.body), 0);
+            totalBytes += byteLength;
+            if (totalBytes > (options.maxTotalBytes ?? 5e8)) {
+              budgetExhausted = true;
+              throw new Error("Migration exceeded its content byte budget.");
+            }
+            record.outcome = "alias";
+            record.aliasOf = peer.url;
+            record.aliasAnchor = candidate.sectionAnchor;
+            if (peerIdentity.sectionAnchor && peer.aliasAnchor !== peerIdentity.sectionAnchor) {
+              peer.aliasAnchor = peerIdentity.sectionAnchor;
+              changed.push(peer);
+            }
+            record.evidence = {
+              ...peer.evidence,
+              sha256: hash(document.body),
+              byteLength,
+              finalUrl: document.finalUrl.href,
+              ...document.artifactRef ? { artifactRef: document.artifactRef } : {},
+              articleIdentity: { ...peerIdentity, sectionAnchor: candidate.sectionAnchor }
+            };
+            if (!document.artifactRef) delete record.evidence.artifactRef;
+            enqueueArticleLinks(record.evidence.links, document.finalUrl.href, record.url);
+            return;
+          }
+        }
+      }
+      const identity = declaredMigrationArticleUrl(document);
       const final = canonical(identity.toString(), sourceUrl);
       const role = classifyMigrationResponse(document);
       if (!inScope(document.finalUrl, source, scopePath) && !(role === "index" && isDiscoveryIndex(document.finalUrl, source))) {
@@ -4339,13 +5961,13 @@ async function runUrlMigration(options) {
         return;
       }
       if (/html/i.test(document.contentType)) {
-        const $ = load5(document.body);
+        const $ = load7(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;
+          const directory2 = (path) => path.replace(/\.mdx?$/i, "").replace(/\/index\/?$/i, "").replace(/\/$/, "");
+          if (target2.origin !== primary.origin || target2.search !== primary.search || directory2(target2.pathname) !== directory2(primary.pathname) || !/\.mdx?$/i.test(target2.pathname)) return;
           enqueue(alternate, final, "declared-markdown-representation");
           const sibling = records.get(alternate);
           sibling.representationOf = record.url;
@@ -4396,6 +6018,9 @@ async function runUrlMigration(options) {
         return;
       }
       let coveredSchemaGroups = [];
+      let coveredSchemaDisclosures = [];
+      let coveredCodeControls = [];
+      let schemaOperation;
       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 });
@@ -4411,7 +6036,10 @@ async function runUrlMigration(options) {
           const path = `openapi/migration-${sha256}.json`;
           record.apiSpecification = { path, sha256, document: fragment.document };
           page.openapi = `${path} ${fragment.method} ${fragment.path}`;
+          schemaOperation = fragment;
           coveredSchemaGroups = apiSchemaTabGroups(document.body, fragment.document, fragment);
+          coveredSchemaDisclosures = apiSchemaDisclosureGroups(document.body, fragment.document, fragment);
+          coveredCodeControls = apiOperationCodeControls(document.body, fragment.document, fragment);
         }
       }
       const states = document.states ?? [];
@@ -4442,12 +6070,13 @@ ${difference}`;
       record.assets = [];
       record.issues = [];
       record.warnings = [];
-      if (/html/i.test(document.contentType)) {
-        const { $, root } = migrationHtmlArticle(document.body);
+      for (const captured of [document, ...states.map((state) => state.response)]) {
+        if (!/html/i.test(captured.contentType)) continue;
+        const { $, root } = migrationHtmlArticle(captured.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();
         root.find("video,iframe").each((_index, node) => {
-          if (projectMigrationMedia($.html(node), document.finalUrl) !== null) {
+          if (projectMigrationMedia($.html(node), captured.finalUrl) !== null) {
             record.warnings.push({ code: "source-asset-warning", source: record.url, message: "Embedded video is preserved at its original public media URL; playback depends on the original host." });
             $(node).remove();
           }
@@ -4458,9 +6087,17 @@ ${difference}`;
         }
         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, Boolean(record.apiSpecification), coveredSchemaGroups)) record.issues.push({ code: "unsupported-component", source: record.url, message: "An interactive alternative has no complete captured panel or disclosure content." });
+        const groups = captured === document ? coveredSchemaGroups : record.apiSpecification && schemaOperation ? apiSchemaTabGroups(captured.body, record.apiSpecification.document, schemaOperation) : [];
+        const disclosures = captured === document ? coveredSchemaDisclosures : record.apiSpecification && schemaOperation ? apiSchemaDisclosureGroups(captured.body, record.apiSpecification.document, schemaOperation) : [];
+        const codeControls = captured === document ? coveredCodeControls : record.apiSpecification && schemaOperation ? apiOperationCodeControls(captured.body, record.apiSpecification.document, schemaOperation) : [];
+        if (unresolvedStaticControls(captured.body, groups, disclosures, codeControls)) 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 inlineAssets = [document, ...states.map((state) => state.response)].flatMap((captured) => /html/i.test(captured.contentType) ? migrationHtmlArticle(captured.body).assets.map((asset) => ({
+        url: new URL(`/${asset.path}`, captured.finalUrl).href,
+        contentType: "image/svg+xml",
+        content: typeof asset.content === "string" ? Buffer.from(asset.content) : asset.content
+      })) : []);
+      const suppliedAssets = new Map([...document.assets ?? [], ...inlineAssets].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)))];
       if (assetUrls.length > 256 || (document.assets?.length ?? 0) > 256) throw new Error("Capture exceeds the 256 assets per page safety bound.");
       for (const url of assetUrls) {
@@ -4470,7 +6107,7 @@ ${difference}`;
             assetRequest = assetRequests.load(url, () => assetFetcher(new URL(url), options.signal).then(retainAsset));
           }
           const supplied = suppliedAssets.get(url);
-          const asset = supplied ? retainAsset(supplied) : assetRequest ? await assetRequest : null;
+          const asset = supplied ? await retainAsset(supplied) : assetRequest ? await assetRequest : null;
           if (!asset) throw new Error("Capture host did not supply asset bytes or a binary fetch boundary.");
           if (asset.unavailable && [404, 410].includes(asset.unavailable.status) && asset.content.byteLength === 0) {
             record.warnings.push({ code: "asset-failed", source: record.url, message: `The original source asset is unavailable (HTTP ${asset.unavailable.status}); its original URL was retained: ${url}` });
@@ -4489,7 +6126,7 @@ ${difference}`;
             }
           }
           const path = `migration-assets/${sha256}.${extension}`;
-          const receipt = { url, path, sha256, contentType: asset.contentType, base64: existing?.base64 ?? Buffer.from(asset.content).toString("base64") };
+          const receipt = { url, path, sha256, contentType: asset.contentType, base64: existing?.base64 ?? Buffer.from(asset.content).toString("base64"), ...asset.derivedFromSha256 ? { derivedFromSha256: asset.derivedFromSha256 } : {} };
           record.assets.push(receipt);
           if (!existing) assetPayloads.set(sha256, receipt);
           if (!assetRequests.has(url)) assetRequests.remember(url, asset);
@@ -4514,6 +6151,7 @@ ${difference}`;
       record.pageSha256 = pageHash(page);
       record.outcome = "imported";
       imported++;
+      if (exactKey) exactCaptures.set(exactKey, record.url);
       enqueueArticleLinks(evidence.links, final, record.url);
     } catch (error) {
       if (options.signal?.aborted) return;
@@ -4539,6 +6177,43 @@ ${difference}`;
       }
     }
   };
+  const settleArticleIdentities = () => {
+    const groups = /* @__PURE__ */ new Map();
+    for (const record of records.values()) {
+      const identity = record.evidence?.articleIdentity;
+      if (record.outcome !== "imported" || !identity) continue;
+      const key = JSON.stringify([identity.canonicalUrl, identity.articleSha256]);
+      const group = groups.get(key) ?? [];
+      group.push(record);
+      groups.set(key, group);
+    }
+    for (const group of groups.values()) {
+      if (group.length < 2) continue;
+      const canonicalUrl = group[0].evidence.articleIdentity.canonicalUrl;
+      const winner = group.find((record) => record.url === canonicalUrl) ?? group[0];
+      const winnerAnchor = winner.evidence.articleIdentity.sectionAnchor;
+      if (winnerAnchor && winner.aliasAnchor !== winnerAnchor) {
+        winner.aliasAnchor = winnerAnchor;
+        changed.push(winner);
+      }
+      for (const alternate of group) {
+        if (alternate === winner) continue;
+        imported--;
+        if (alternate.page && usedIds.get(alternate.page.id) === alternate.url) usedIds.delete(alternate.page.id);
+        alternate.outcome = "alias";
+        alternate.aliasOf = winner.url;
+        alternate.aliasAnchor = alternate.evidence.articleIdentity.sectionAnchor;
+        delete alternate.page;
+        delete alternate.pageSha256;
+        delete alternate.assets;
+        delete alternate.apiSpecification;
+        delete alternate.issues;
+        delete alternate.warnings;
+        delete alternate.reason;
+        changed.push(alternate);
+      }
+    }
+  };
   const settleRepresentations = () => {
     for (const record of records.values()) {
       if (!record.representationOf) continue;
@@ -4564,6 +6239,7 @@ ${difference}`;
     }
   };
   settleRepresentations();
+  settleArticleIdentities();
   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));
@@ -4574,6 +6250,7 @@ ${difference}`;
     cursor += batch.length;
     await Promise.all(batch.map(process));
     settleRepresentations();
+    settleArticleIdentities();
     if (changed.length >= batchSize) await flush();
   }
   await flush();
@@ -4593,7 +6270,7 @@ ${difference}`;
     for (const node of nodes) {
       const entry = node.url ? records.get(canonical(node.url, sourceUrl) ?? "") : void 0;
       const target2 = resolveMigrationRecord(records, entry);
-      if (target2?.page && node.label && !node.children?.length) {
+      if (target2?.page && node.label && !node.children?.length && !entry?.aliasAnchor) {
         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);
@@ -4618,8 +6295,9 @@ ${difference}`;
       anchor = decodeURIComponent(anchor);
     } catch {
     }
+    const effectiveHash = url.hash || (records.get(identity)?.aliasAnchor ? `#${encodeURIComponent(records.get(identity).aliasAnchor)}` : "");
     const hasBrokenSourceAnchor = Boolean(url.hash && destination?.outcome === "imported" && destination.evidence && !destination.evidence.anchors.includes(anchor));
-    return `${route}${hasBrokenSourceAnchor ? "" : url.hash}`;
+    return `${route}${hasBrokenSourceAnchor ? "" : effectiveHash}`;
   }) }] : []);
   const validation = validateUrlMigration(checkpoint, Boolean(options.signal?.aborted));
   validation.issues.push(...navigationIssues);
@@ -4698,16 +6376,16 @@ function rewriteMarkdownDestinations(body, rewrite) {
 }
 
 // src/components.ts
-import { createHash as createHash2 } from "crypto";
+import { createHash as createHash5 } from "crypto";
 import { existsSync as existsSync2, lstatSync as lstatSync2, readFileSync as readFileSync2 } from "fs";
 import { basename, dirname as dirname2, extname as extname3, posix as posix2, relative as relative3, resolve as resolve3 } from "path";
 import postcss from "postcss";
 import selectorParser from "postcss-selector-parser";
-import remarkMdx4 from "remark-mdx";
-import remarkParse4 from "remark-parse";
+import remarkMdx5 from "remark-mdx";
+import remarkParse5 from "remark-parse";
 import ts2 from "typescript";
-import { unified as unified4 } from "unified";
-var parser2 = unified4().use(remarkParse4).use(remarkMdx4);
+import { unified as unified5 } from "unified";
+var parser3 = unified5().use(remarkParse5).use(remarkMdx5);
 var DOCUSAURUS_THEME_SHIMS = {
   "@theme/CodeBlock": {
     filename: "docusaurus-code-block.tsx",
@@ -4747,7 +6425,7 @@ function applyReplacements(source, replacements) {
   );
 }
 function hash2(value) {
-  return createHash2("sha256").update(value).digest("hex").slice(0, 12);
+  return createHash5("sha256").update(value).digest("hex").slice(0, 12);
 }
 function sourceFile(source, filename) {
   return ts2.createSourceFile(filename, source, ts2.ScriptTarget.Latest, true, scriptKindFor(filename));