@thallylabs/migrate 0.2.37 → 0.2.39

package/dist/index.js

@@ -4462,9 +4462,9 @@ function jsonPointer(root, pointer) {
       const index = Number(token);
       return Number.isSafeInteger(index) && index >= 0 ? current[index] : void 0;
     }
-    const object2 = objectValue2(current);
-    if (!object2) return void 0;
-    return object2[token.replace(/~1/g, "/").replace(/~0/g, "~")];
+    const object3 = objectValue2(current);
+    if (!object3) return void 0;
+    return object3[token.replace(/~1/g, "/").replace(/~0/g, "~")];
   }, root);
 }
 function readMintlifyJson(path, repositoryRoot) {
@@ -4483,22 +4483,22 @@ function resolveJsonReferences(value, currentFile, repositoryRoot, stack) {
   if (Array.isArray(value)) {
     return value.map((entry) => resolveJsonReferences(entry, currentFile, repositoryRoot, stack));
   }
-  const object2 = objectValue2(value);
-  if (!object2) return value;
-  if (typeof object2.$ref === "string") {
-    const [filePart, pointer = ""] = object2.$ref.split("#", 2);
+  const object3 = objectValue2(value);
+  if (!object3) return value;
+  if (typeof object3.$ref === "string") {
+    const [filePart, pointer = ""] = object3.$ref.split("#", 2);
     const referencedFile = filePart ? resolveWithin(dirname2(currentFile), filePart) : currentFile;
     const relativePath = relative3(repositoryRoot, referencedFile);
     resolveWithin(repositoryRoot, relativePath);
     const stackKey = `${referencedFile}#${pointer}`;
-    if (stack.has(stackKey)) throw new Error(`Circular Mintlify $ref: ${object2.$ref}`);
+    if (stack.has(stackKey)) throw new Error(`Circular Mintlify $ref: ${object3.$ref}`);
     stack.add(stackKey);
     const referencedRoot = readMintlifyJson(referencedFile, repositoryRoot);
     const referenced = jsonPointer(referencedRoot, pointer ? `#${pointer}` : "");
     const resolved = resolveJsonReferences(referenced, referencedFile, repositoryRoot, stack);
     stack.delete(stackKey);
     const siblings = Object.fromEntries(
-      Object.entries(object2).filter(([key]) => key !== "$ref").map(([key, entry]) => [
+      Object.entries(object3).filter(([key]) => key !== "$ref").map(([key, entry]) => [
         key,
         resolveJsonReferences(entry, currentFile, repositoryRoot, stack)
       ])
@@ -4506,7 +4506,7 @@ function resolveJsonReferences(value, currentFile, repositoryRoot, stack) {
     return objectValue2(resolved) ? { ...resolved, ...siblings } : resolved;
   }
   return Object.fromEntries(
-    Object.entries(object2).map(([key, entry]) => [
+    Object.entries(object3).map(([key, entry]) => [
       key,
       resolveJsonReferences(entry, currentFile, repositoryRoot, stack)
     ])
@@ -4529,10 +4529,10 @@ function listedOperations(container) {
       if (OPENAPI_OPERATION_REF.test(entry)) operations.push(entry.trim());
       return;
     }
-    const object2 = objectValue2(entry);
-    if (!object2 || depth > SWEEP_DEPTH_LIMIT || depth > 0 && (specSource(object2.openapi) || specSource(object2.asyncapi))) return;
+    const object3 = objectValue2(entry);
+    if (!object3 || depth > SWEEP_DEPTH_LIMIT || depth > 0 && (specSource(object3.openapi) || specSource(object3.asyncapi))) return;
     for (const key of ["groups", "pages"]) {
-      if (Array.isArray(object2[key])) object2[key].forEach((child) => visit(child, depth + 1));
+      if (Array.isArray(object3[key])) object3[key].forEach((child) => visit(child, depth + 1));
     }
   };
   visit(container, 0);
@@ -4545,8 +4545,8 @@ var operationKey = (entry) => entry.trim().replace(/^(\S+)\s+/, "$1 ");
 function operationGroups(container, maxLevel = API_GROUPS_MAX_DEPTH) {
   const entries = (node, level) => ["groups", "pages"].flatMap((key) => (Array.isArray(node[key]) ? node[key] : []).flatMap((entry) => {
     if (typeof entry === "string") return OPENAPI_OPERATION_REF.test(entry) ? [operationKey(entry)] : [];
-    const object2 = objectValue2(entry);
-    const group = object2 && !bindsSpec(object2) ? groupOf(object2, level + 1) : void 0;
+    const object3 = objectValue2(entry);
+    const group = object3 && !bindsSpec(object3) ? groupOf(object3, level + 1) : void 0;
     return group ? [group] : [];
   }));
   const groupOf = (node, level) => {
@@ -4641,9 +4641,9 @@ function mintlifyNavigationApiReferences(config) {
       const entries = node[key];
       if (!Array.isArray(entries)) continue;
       for (const entry of entries) {
-        const object2 = objectValue2(entry);
-        if (!object2) continue;
-        visit(object2, labelFor(object2, tabLabel ?? "Documentation"), gated, otherLanguage || key === "languages" && rawNode === navigation && object2 !== defaultLanguage, hidden);
+        const object3 = objectValue2(entry);
+        if (!object3) continue;
+        visit(object3, labelFor(object3, tabLabel ?? "Documentation"), gated, otherLanguage || key === "languages" && rawNode === navigation && object3 !== defaultLanguage, hidden);
       }
     }
     for (const key of nestedKeys) {
@@ -4651,15 +4651,15 @@ function mintlifyNavigationApiReferences(config) {
       if (!Array.isArray(entries)) continue;
       for (const entry of entries) {
         if (typeof entry === "string") continue;
-        const object2 = objectValue2(entry);
-        if (object2) visit(object2, tabLabel, gated, otherLanguage, hidden || object2.hidden === true);
+        const object3 = objectValue2(entry);
+        if (object3) visit(object3, tabLabel, gated, otherLanguage, hidden || object3.hidden === true);
       }
     }
     if (Array.isArray(node.menu)) {
       const tab = tabLabel ?? "Documentation";
       const items = node.menu.flatMap((entry) => {
-        const object2 = objectValue2(entry);
-        return object2 ? [object2] : [];
+        const object3 = objectValue2(entry);
+        return object3 ? [object3] : [];
       });
       const apiItems = items.filter((item) => specSource(item.openapi) || specSource(item.asyncapi));
       const soleContent = apiItems.length === 1 && !hasNavigationChildren(node) && !items.some(hasNavigationChildren);
@@ -4727,11 +4727,11 @@ function collectGatedSourceRefs(node, gate, out, limits, depth = 0) {
     for (const item of node) collectGatedSourceRefs(item, gate, out, limits, depth + 1);
     return;
   }
-  const object2 = objectValue2(node);
-  if (!object2) return;
-  const reason = gate ?? navigationGateReason(object2);
-  if (reason && typeof object2.sourceRef === "string") out.set(object2, reason);
-  for (const value of Object.values(object2)) collectGatedSourceRefs(value, reason, out, limits, depth + 1);
+  const object3 = objectValue2(node);
+  if (!object3) return;
+  const reason = gate ?? navigationGateReason(object3);
+  if (reason && typeof object3.sourceRef === "string") out.set(object3, reason);
+  for (const value of Object.values(object3)) collectGatedSourceRefs(value, reason, out, limits, depth + 1);
 }
 function collectReferenceAccess(node, access, pathPrefix, out, depth = 0) {
   if (depth > SWEEP_DEPTH_LIMIT) return;
@@ -4739,29 +4739,29 @@ function collectReferenceAccess(node, access, pathPrefix, out, depth = 0) {
     for (const item of node) collectReferenceAccess(item, access, pathPrefix, out, depth + 1);
     return;
   }
-  const object2 = objectValue2(node);
-  if (!object2) return;
-  const nested = descendNavigationAccess(access, navigationAccess(object2));
+  const object3 = objectValue2(node);
+  if (!object3) return;
+  const nested = descendNavigationAccess(access, navigationAccess(object3));
   if (hasNavigationRules(nested)) {
-    const refs = [object2.page, object2.root, object2.href, ...Array.isArray(object2.pages) ? object2.pages : []];
+    const refs = [object3.page, object3.root, object3.href, ...Array.isArray(object3.pages) ? object3.pages : []];
     for (const ref of refs) {
       if (typeof ref === "string" && normalizePageRef(ref, pathPrefix)) out.push({ ref, access: nested });
     }
   }
-  for (const value of Object.values(object2)) collectReferenceAccess(value, nested, pathPrefix, out, depth + 1);
+  for (const value of Object.values(object3)) collectReferenceAccess(value, nested, pathPrefix, out, depth + 1);
 }
-function withContainerAccess(object2, context, walk2, nested = false) {
+function withContainerAccess(object3, context, walk2, nested = false) {
   const outer = context.access;
-  context.access = descendNavigationAccess(outer, navigationAccess(object2));
+  context.access = descendNavigationAccess(outer, navigationAccess(object3));
   try {
-    return withOperationScope(object2, context, nested, walk2);
+    return withOperationScope(object3, context, nested, walk2);
   } finally {
     context.access = outer;
   }
 }
-function withOperationScope(object2, context, nested, walk2) {
+function withOperationScope(object3, context, nested, walk2) {
   const outer = context.operations;
-  context.operations = descendOperationScope(outer, object2, nested);
+  context.operations = descendOperationScope(outer, object3, nested);
   try {
     return walk2();
   } finally {
@@ -4835,9 +4835,9 @@ function convertPage(value, context) {
     }
     return registerReference(value, context);
   }
-  const object2 = objectValue2(value);
-  if (!object2) return null;
-  return withContainerAccess(object2, context, () => convertPageObject(object2, context));
+  const object3 = objectValue2(value);
+  if (!object3) return null;
+  return withContainerAccess(object3, context, () => convertPageObject(object3, context));
 }
 function gatedSourceRef(repo, context) {
   if (!context.gatedSourceRefs.includes(repo)) context.gatedSourceRefs.push(repo);
@@ -4848,10 +4848,10 @@ function gatedSourceRef(repo, context) {
   );
   return null;
 }
-function convertPageObject(object2, context) {
-  if (typeof object2.page === "string") return registerReference(object2.page, context);
-  const href = projectedHref(object2.href);
-  if (href && !object2.pages && !object2.groups) {
+function convertPageObject(object3, context) {
+  if (typeof object3.page === "string") return registerReference(object3.page, context);
+  const href = projectedHref(object3.href);
+  if (href && !object3.pages && !object3.groups) {
     const page = registerReference(href, context);
     if (page) return page;
     warnOnce(
@@ -4861,25 +4861,25 @@ function convertPageObject(object2, context) {
     );
     return null;
   }
-  if (typeof object2.sourceRef === "string") {
-    if (isNavigationRestricted(context.access) || context.gatedNodes.has(object2) || context.limits.tooDeep) return gatedSourceRef(object2.sourceRef, context);
-    const imported = context.resolveSourceRef?.(object2.sourceRef);
-    if (imported) return { group: object2.sourceRef.split("/").pop() ?? object2.sourceRef, pages: imported };
+  if (typeof object3.sourceRef === "string") {
+    if (isNavigationRestricted(context.access) || context.gatedNodes.has(object3) || context.limits.tooDeep) return gatedSourceRef(object3.sourceRef, context);
+    const imported = context.resolveSourceRef?.(object3.sourceRef);
+    if (imported) return { group: object3.sourceRef.split("/").pop() ?? object3.sourceRef, pages: imported };
     const where = context.groupLabel ? `the "${context.groupLabel}" navigation group` : "the navigation";
     warnOnce(
       context,
-      `source-ref:${context.groupLabel ?? ""}:${object2.sourceRef}`,
-      `Navigation in ${where} mounts the docs of the repository ${object2.sourceRef} (sourceRef). Those pages were not migrated; pass --source-ref ${object2.sourceRef}=<path> to import them.`
+      `source-ref:${context.groupLabel ?? ""}:${object3.sourceRef}`,
+      `Navigation in ${where} mounts the docs of the repository ${object3.sourceRef} (sourceRef). Those pages were not migrated; pass --source-ref ${object3.sourceRef}=<path> to import them.`
     );
     return null;
   }
-  const pages = Array.isArray(object2.pages) ? object2.pages : [];
-  if ("group" in object2 || pages.length > 0) {
+  const pages = Array.isArray(object3.pages) ? object3.pages : [];
+  if ("group" in object3 || pages.length > 0) {
     const children = [];
     const outerGroupLabel = context.groupLabel;
-    context.groupLabel = labelFor(object2, "Documentation");
-    if (typeof object2.root === "string") {
-      const root = registerReference(object2.root, context);
+    context.groupLabel = labelFor(object3, "Documentation");
+    if (typeof object3.root === "string") {
+      const root = registerReference(object3.root, context);
       if (root) children.push(root);
     }
     try {
@@ -4899,9 +4899,9 @@ function convertPageObject(object2, context) {
     }
     if (children.length === 0) return null;
     return {
-      group: labelFor(object2, "Documentation"),
-      ...iconName(object2.icon) ? { icon: iconName(object2.icon) } : {},
-      ...object2.hidden === true ? { hidden: true } : {},
+      group: labelFor(object3, "Documentation"),
+      ...iconName(object3.icon) ? { icon: iconName(object3.icon) } : {},
+      ...object3.hidden === true ? { hidden: true } : {},
       pages: children
     };
   }
@@ -4991,37 +4991,37 @@ function convertContainerToTabs(containerValue, context, fallbackTab, trace, dep
       entries.sort((left, right) => Number(objectValue2(right)?.default === true) - Number(objectValue2(left)?.default === true));
     }
     const tabs = entries.flatMap((value, index) => {
-      const object2 = objectValue2(value);
-      if (!object2) return [];
-      const tab = labelFor(object2, `${fallbackTab} ${index + 1}`);
-      const href = projectedHref(object2.href);
-      const hasNestedContainers = [...containerKeys, "menu"].some((containerKey) => Array.isArray(object2[containerKey]));
-      if (href && !object2.pages && !object2.groups && !hasNestedContainers) {
+      const object3 = objectValue2(value);
+      if (!object3) return [];
+      const tab = labelFor(object3, `${fallbackTab} ${index + 1}`);
+      const href = projectedHref(object3.href);
+      const hasNestedContainers = [...containerKeys, "menu"].some((containerKey) => Array.isArray(object3[containerKey]));
+      if (href && !object3.pages && !object3.groups && !hasNestedContainers) {
         return [{
           tab,
           href,
-          ...containerPresentation(object2),
-          ...object2.hidden === true ? { hidden: true } : {}
+          ...containerPresentation(object3),
+          ...object3.hidden === true ? { hidden: true } : {}
         }];
       }
-      const nested = withContainerAccess(object2, context, () => convertContainerToTabs(object2, context, tab, trace, depth + 1), true);
+      const nested = withContainerAccess(object3, context, () => convertContainerToTabs(object3, context, tab, trace, depth + 1), true);
       if (nested.length > 0) {
         if (nested.length === 1) {
           return [{
             ...nested[0],
             tab,
-            ...containerPresentation(object2),
+            ...containerPresentation(object3),
             ...href ? { href } : {},
-            ...object2.hidden === true ? { hidden: true } : {}
+            ...object3.hidden === true ? { hidden: true } : {}
           }];
         }
-        const presentation = containerPresentation(object2);
+        const presentation = containerPresentation(object3);
         return nested.map((item, childIndex) => ({
           ...presentation,
           ...item,
           tab: `${tab}: ${item.tab}`,
           ...childIndex === 0 && href && !item.href ? { href } : {},
-          ...object2.hidden === true ? { hidden: true } : {}
+          ...object3.hidden === true ? { hidden: true } : {}
         }));
       }
       return [];
@@ -5820,8 +5820,8 @@ function registerPageAt(rawPath, base, context, navTitle, hidden = false) {
   context.sourcePathToNavigationId.set(sourcePath, navigationId);
   return navigationId;
 }
-function registerFolder(object2, parentSegments, context) {
-  const rawPath = String(object2.folder).trim();
+function registerFolder(object3, parentSegments, context) {
+  const rawPath = String(object3.folder).trim();
   let folder;
   try {
     folder = withinRealRoot(resolveWithinRoot(
@@ -5837,8 +5837,8 @@ function registerFolder(object2, parentSegments, context) {
     warnOnce2(context, `fern-missing-folder-${rawPath}`, `Fern folder "${rawPath}" does not exist and was skipped.`);
     return null;
   }
-  const label = typeof object2.title === "string" && object2.title.trim() ? object2.title.trim() : titleCase2(basename2(folder));
-  const segment = typeof object2.slug === "string" || object2["skip-slug"] === true ? segmentFor(object2, label, context) : fernBasicSlug(basename2(folder));
+  const label = typeof object3.title === "string" && object3.title.trim() ? object3.title.trim() : titleCase2(basename2(folder));
+  const segment = typeof object3.slug === "string" || object3["skip-slug"] === true ? segmentFor(object3, label, context) : fernBasicSlug(basename2(folder));
   const segments = segment ? [...parentSegments, segment] : parentSegments;
   const visit = (directory, routeSegments, depth) => {
     if (depth > 12 || context.descriptors.length >= 5e3) {
@@ -5871,17 +5871,17 @@ function registerFolder(object2, parentSegments, context) {
   addBareRouteRedirect(segments, pages, context);
   return { group: label, pages };
 }
-function registerPage(object2, parentSegments, context) {
-  if (typeof object2.path !== "string" || !object2.path.trim()) return null;
-  const label = typeof object2.page === "string" && object2.page.trim() ? object2.page.trim() : "Untitled";
-  const segment = segmentFor(object2, label, context);
+function registerPage(object3, parentSegments, context) {
+  if (typeof object3.path !== "string" || !object3.path.trim()) return null;
+  const label = typeof object3.page === "string" && object3.page.trim() ? object3.page.trim() : "Untitled";
+  const segment = segmentFor(object3, label, context);
   const base = [...parentSegments, segment].filter(Boolean).join("/");
-  return registerPageAt(object2.path, base, context, label, object2.hidden === true) || null;
+  return registerPageAt(object3.path, base, context, label, object3.hidden === true) || null;
 }
-function isRestrictedNode(object2) {
-  const viewers = object2.viewers;
+function isRestrictedNode(object3) {
+  const viewers = object3.viewers;
   if (Array.isArray(viewers) ? viewers.length > 0 : typeof viewers === "string" ? viewers.trim() !== "" : viewers !== void 0 && viewers !== null && viewers !== false) return true;
-  const authed = object2.authed;
+  const authed = object3.authed;
   return authed !== void 0 && authed !== null && authed !== false && !(typeof authed === "string" && ["", "false"].includes(authed.trim().toLowerCase()));
 }
 function restrictionMark(context) {
@@ -5892,67 +5892,67 @@ function markRestricted(context, mark) {
   context.restrictedApiSections.push(...context.apiSections.splice(mark.apis));
 }
 function convertNode(node, parentSegments, context) {
-  const object2 = objectValue3(node);
-  if (!object2) return null;
+  const object3 = objectValue3(node);
+  if (!object3) return null;
   const walk2 = context.navigationWalk;
-  const reason = walk2.active.has(object2) ? "cyclic section" : walk2.active.size >= 64 ? "section depth exceeds 64" : walk2.visits >= 5e3 ? "node budget exceeds 5000" : void 0;
+  const reason = walk2.active.has(object3) ? "cyclic section" : walk2.active.size >= 64 ? "section depth exceeds 64" : walk2.visits >= 5e3 ? "node budget exceeds 5000" : void 0;
   if (reason) {
     walk2.incomplete = true;
     warnOnce2(context, `navigation-${reason}`, `Fern navigation was skipped: ${reason}.`);
     return null;
   }
   walk2.visits++;
-  walk2.active.add(object2);
+  walk2.active.add(object3);
   try {
-    if (isRestrictedNode(object2)) {
+    if (isRestrictedNode(object3)) {
       const before = restrictionMark(context);
-      convertNodeContents({ ...object2, viewers: void 0, authed: void 0 }, parentSegments, context);
+      convertNodeContents({ ...object3, viewers: void 0, authed: void 0 }, parentSegments, context);
       markRestricted(context, before);
       return null;
     }
-    return convertNodeContents(object2, parentSegments, context);
+    return convertNodeContents(object3, parentSegments, context);
   } finally {
-    walk2.active.delete(object2);
+    walk2.active.delete(object3);
   }
 }
-function convertNodeContents(object2, parentSegments, context) {
-  if (typeof object2.page === "string") {
-    const page = registerPage(object2, parentSegments, context);
-    return object2.hidden === true || context.hiddenInherited ? null : page;
+function convertNodeContents(object3, parentSegments, context) {
+  if (typeof object3.page === "string") {
+    const page = registerPage(object3, parentSegments, context);
+    return object3.hidden === true || context.hiddenInherited ? null : page;
   }
-  if (typeof object2.folder === "string") {
-    const folder = registerFolder(object2, parentSegments, object2.hidden === true ? { ...context, hiddenInherited: true } : context);
-    return object2.hidden === true || context.hiddenInherited ? null : folder;
+  if (typeof object3.folder === "string") {
+    const folder = registerFolder(object3, parentSegments, object3.hidden === true ? { ...context, hiddenInherited: true } : context);
+    return object3.hidden === true || context.hiddenInherited ? null : folder;
   }
-  if (typeof object2.section === "string") {
-    const label = object2.section;
-    const segment = segmentFor(object2, label, context);
+  if (typeof object3.section === "string") {
+    const label = object3.section;
+    const segment = segmentFor(object3, label, context);
     const segments = segment ? [...parentSegments, segment] : parentSegments;
-    const contents = Array.isArray(object2.contents) ? object2.contents : [];
+    const contents = Array.isArray(object3.contents) ? object3.contents : [];
     const pages = [];
-    const hasOwnPath = typeof object2.path === "string" && object2.path.trim().length > 0;
+    const hasOwnPath = typeof object3.path === "string" && object3.path.trim().length > 0;
     if (hasOwnPath) {
-      const registered = registerPageAt(object2.path, segments.join("/"), context, label, object2.hidden === true);
+      const registered = registerPageAt(object3.path, segments.join("/"), context, label, object3.hidden === true);
       if (registered) pages.push(registered);
     }
     for (const child of contents) {
-      const converted = convertNode(child, segments, object2.hidden === true ? { ...context, hiddenInherited: true } : context);
+      const converted = convertNode(child, segments, object3.hidden === true ? { ...context, hiddenInherited: true } : context);
       if (converted) pages.push(converted);
     }
     if (pages.length === 0) return null;
     if (!hasOwnPath && segment) addBareRouteRedirect(segments, pages, context);
-    if (object2.hidden === true || context.hiddenInherited) return null;
+    if (object3.hidden === true || context.hiddenInherited) return null;
     return {
       group: label,
-      ...["open-by-default", "closed-by-default", true, false].includes(object2.collapsed) ? { defaultOpen: object2.collapsed === "open-by-default" || object2.collapsed === false } : {},
-      ...typeof object2.icon === "string" ? { icon: object2.icon } : {},
-      ...object2.hidden === true ? { hidden: true } : {},
+      ...["open-by-default", "closed-by-default", true, false].includes(object3.collapsed) ? { defaultOpen: object3.collapsed === "open-by-default" || object3.collapsed === false } : {},
+      ...typeof object3.icon === "string" ? { icon: object3.icon } : {},
+      ...object3.hidden === true ? { hidden: true } : {},
       pages
     };
   }
-  if (typeof object2.link === "string") {
-    const label = object2.link.trim();
-    const rawHref = typeof object2.href === "string" ? object2.href.trim() : "";
+  if (typeof object3.link === "string") {
+    const label = object3.link.trim();
+    const rawHref = typeof object3.href === "string" ? object3.href.trim() : "";
     let href;
     if (/^https?:\/\//i.test(rawHref) && !/[\\\u0000-\u0020\u007f]/.test(rawHref)) {
       try {
@@ -5961,26 +5961,26 @@ function convertNodeContents(object2, parentSegments, context) {
       } catch {
       }
     }
-    if (label && href && object2.hidden !== true && !context.hiddenInherited) {
+    if (label && href && object3.hidden !== true && !context.hiddenInherited) {
       if (!context.externalLinks.some((link) => link.label === label && link.href === href)) {
         context.externalLinks.push({ label, href });
       }
-    } else if (!href && object2.hidden !== true && !context.hiddenInherited) {
+    } else if (!href && object3.hidden !== true && !context.hiddenInherited) {
       warnOnce2(context, `fern-link-${rawHref}`, `Fern navigation link "${label}" has an unsafe or invalid external URL and was skipped.`);
     }
     return null;
   }
-  if (typeof object2.api === "string") {
-    const ownSegment = segmentFor(object2, object2.api, context);
+  if (typeof object3.api === "string") {
+    const ownSegment = segmentFor(object3, object3.api, context);
     context.apiSections.push({
-      name: typeof object2["api-name"] === "string" ? object2["api-name"] : object2.api,
-      nameExplicit: typeof object2["api-name"] === "string",
+      name: typeof object3["api-name"] === "string" ? object3["api-name"] : object3.api,
+      nameExplicit: typeof object3["api-name"] === "string",
       routeSegments: ownSegment ? [...parentSegments, ownSegment] : parentSegments
     });
     return null;
   }
-  if (typeof object2.changelog === "string") {
-    return registerFolder({ folder: object2.changelog, title: "Changelog", "skip-slug": true }, parentSegments, context);
+  if (typeof object3.changelog === "string") {
+    return registerFolder({ folder: object3.changelog, title: "Changelog", "skip-slug": true }, parentSegments, context);
   }
   return null;
 }
@@ -6643,14 +6643,14 @@ function parseStaticSidebarModule(source) {
         literal
       );
       const parsed = JSON5.parse(substituted);
-      const object2 = objectValue4(parsed);
-      if (!object2) continue;
+      const object3 = objectValue4(parsed);
+      if (!object3) continue;
       const bindingName = candidate[0].match(/\b(?:const|let|var)\s+([A-Za-z_$][\w$]*)/)?.[1];
       if (bindingName) {
-        bindings.set(bindingName, object2);
+        bindings.set(bindingName, object3);
         continue;
       }
-      return object2;
+      return object3;
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       const line = Number(message.match(/at (\d+):/)?.[1] ?? 0);
@@ -6739,8 +6739,8 @@ function configuredSidebarPath(repositoryRoot) {
     if (!existsSync4(path)) continue;
     const source = readBoundedText(path);
     for (const docs of source.matchAll(/\bdocs\s*:\s*/g)) {
-      const object2 = matchingObjectLiteral(source, (docs.index ?? 0) + docs[0].length);
-      const candidate2 = object2 && staticStringField(object2, "sidebarPath")?.replace(/^\.\//, "");
+      const object3 = matchingObjectLiteral(source, (docs.index ?? 0) + docs[0].length);
+      const candidate2 = object3 && staticStringField(object3, "sidebarPath")?.replace(/^\.\//, "");
       if (candidate2) {
         const resolved2 = withinRealRoot(resolveWithin(repositoryRoot, candidate2), repositoryRoot);
         if (existsSync4(resolved2) && lstatSync4(resolved2).isFile()) return candidate2;
@@ -6851,12 +6851,12 @@ function readCategoryMetadata(contentRoot, directory) {
     try {
       const raw = readBoundedText(path);
       const parsed = filename.endsWith(".json") ? JSON5.parse(raw) : parseYaml3(raw);
-      const object2 = objectValue4(parsed);
-      if (!object2) return {};
+      const object3 = objectValue4(parsed);
+      if (!object3) return {};
       return {
-        ...typeof object2.label === "string" ? { label: object2.label } : {},
-        ...typeof object2.position === "number" ? { position: object2.position } : {},
-        ..."link" in object2 ? { link: object2.link } : {}
+        ...typeof object3.label === "string" ? { label: object3.label } : {},
+        ...typeof object3.position === "number" ? { position: object3.position } : {},
+        ..."link" in object3 ? { link: object3.link } : {}
       };
     } catch {
       return {};
@@ -7040,7 +7040,7 @@ function readDocusaurusSiteSettings(repositoryRoot) {
   const source = readBoundedText(configPath);
   const bindings = staticStringBindings(source);
   const presets = staticArrayField(source, "presets");
-  const classicDocs = presets && [...presets.matchAll(/["']?docs["']?\s*:\s*/g)].map((match) => matchingObjectLiteral(presets, (match.index ?? 0) + match[0].length)).find((object2) => Boolean(object2));
+  const classicDocs = presets && [...presets.matchAll(/["']?docs["']?\s*:\s*/g)].map((match) => matchingObjectLiteral(presets, (match.index ?? 0) + match[0].length)).find((object3) => Boolean(object3));
   const docsRouteBasePath = classicDocs && staticStringField(classicDocs, "routeBasePath") || "docs";
   const themeStart = propertyStart(source, "themeConfig");
   const theme = themeStart < 0 ? null : matchingObjectLiteral(source, themeStart);
@@ -7163,24 +7163,24 @@ function convertItems(value, context) {
     return page ? [page] : [];
   }
   if (Array.isArray(value)) return value.flatMap((entry) => convertItems(entry, context));
-  const object2 = objectValue4(value);
-  if (!object2) return [];
-  if (object2.type === "doc" || object2.type === "ref") {
-    const page = typeof object2.id === "string" ? registerDoc(object2.id, context) : null;
+  const object3 = objectValue4(value);
+  if (!object3) return [];
+  if (object3.type === "doc" || object3.type === "ref") {
+    const page = typeof object3.id === "string" ? registerDoc(object3.id, context) : null;
     return page ? [page] : [];
   }
-  if (object2.type === "autogenerated") {
-    return autogeneratedItems(typeof object2.dirName === "string" ? object2.dirName : ".", context);
+  if (object3.type === "autogenerated") {
+    return autogeneratedItems(typeof object3.dirName === "string" ? object3.dirName : ".", context);
   }
-  if (object2.type === "category") {
-    const label = typeof object2.label === "string" ? object2.label : "Documentation";
-    const pages = convertItems(object2.items, context);
-    const landing = generatedIndexPage(label, object2.link, context);
+  if (object3.type === "category") {
+    const label = typeof object3.label === "string" ? object3.label : "Documentation";
+    const pages = convertItems(object3.items, context);
+    const landing = generatedIndexPage(label, object3.link, context);
     if (landing && !pages.includes(landing)) pages.unshift(landing);
     return pages.length > 0 ? [{ group: label, pages }] : [];
   }
-  if (object2.type === "link" || object2.type === "html") return [];
-  return Object.entries(object2).flatMap(([label, items]) => {
+  if (object3.type === "link" || object3.type === "html") return [];
+  return Object.entries(object3).flatMap(([label, items]) => {
     const pages = convertItems(items, context);
     return pages.length > 0 ? [{ group: label, pages }] : [];
   });
@@ -7552,7 +7552,7 @@ import { lstatSync as lstatSync5, readdirSync as readdirSync3, readFileSync as r
 import { isAbsolute as isAbsolute2, join, relative as relative5, resolve as resolve3, sep as sep2 } from "path";
 
 // src/url.ts
-import { load as load2 } from "cheerio";
+import { load as load3 } from "cheerio";
 import remarkMdx3 from "remark-mdx";
 import remarkParse3 from "remark-parse";
 import TurndownService from "turndown";
@@ -7738,7 +7738,7 @@ function migrationImageUrl(value, base) {
   if (!["http:", "https:"].includes(url.protocol) || url.username || url.password) throw new Error("Responsive image URL is not a credential-free HTTP(S) URL.");
   return url.toString();
 }
-function migrationImageCandidates(value, base, resolve4 = true) {
+function migrationImageCandidates(value, base, resolve5 = true) {
   if (value.length > 64e3) throw new Error("Responsive image candidate list exceeds its safety bound.");
   const result = [];
   let index = 0;
@@ -7756,7 +7756,7 @@ function migrationImageCandidates(value, base, resolve4 = true) {
     if (descriptor && !/^(?:[1-9]\d*w|(?:\d+(?:\.\d+)?|\.\d+)x)$/.test(descriptor)) throw new Error("Responsive image has an unsupported descriptor.");
     if (descriptor.endsWith("x") && Number(descriptor.slice(0, -1)) <= 0) throw new Error("Responsive image density must be positive.");
     const resolved = migrationImageUrl(url, base);
-    result.push({ url: resolve4 ? resolved : url, descriptor });
+    result.push({ url: resolve5 ? resolved : url, descriptor });
     if (result.length > 128) throw new Error("Responsive image has too many candidates.");
     if (value[index] === ",") index++;
   }
@@ -7770,6 +7770,86 @@ function migrationImageAttribute(value) {
   return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/\{/g, "&#123;").replace(/\}/g, "&#125;").replace(/\r/g, "&#13;").replace(/\n/g, "&#10;");
 }
 
+// src/url-media.ts
+import { load as load2 } from "cheerio";
+var VIDEO_ATTRIBUTES = /* @__PURE__ */ new Set([
+  "src",
+  "title",
+  "poster",
+  "controls",
+  "muted",
+  "autoplay",
+  "loop",
+  "playsinline",
+  "class",
+  "id",
+  "width",
+  "height",
+  "preload",
+  "aria-label"
+]);
+var YOUTUBE_ATTRIBUTES = /* @__PURE__ */ new Set([
+  "src",
+  "title",
+  "width",
+  "height",
+  "allow",
+  "allowfullscreen",
+  "referrerpolicy",
+  "frameborder",
+  "loading",
+  "class",
+  "id",
+  "aria-label"
+]);
+var YOUTUBE_HOSTS = /* @__PURE__ */ new Set([
+  "youtube.com",
+  "www.youtube.com",
+  "youtube-nocookie.com",
+  "www.youtube-nocookie.com"
+]);
+function projectMigrationMedia(html, base) {
+  const $ = load2(html, void 0, false);
+  const nodes = $.root().contents().filter((_index, node2) => node2.type !== "text" || Boolean(node2.data.trim()));
+  if (nodes.length !== 1) return null;
+  const element = nodes.first();
+  const node = element[0];
+  if (node.type !== "tag" || !["video", "iframe"].includes(node.name)) return null;
+  if (element.children().length || element.text().trim()) return null;
+  const allowed = node.name === "video" ? VIDEO_ATTRIBUTES : YOUTUBE_ATTRIBUTES;
+  if (Object.keys(node.attribs).some((name) => !allowed.has(name))) return null;
+  const source = element.attr("src");
+  if (!source) return null;
+  try {
+    let src = migrationImageUrl(source, base);
+    let component = "Video";
+    const props = [];
+    if (node.name === "video") {
+      if (!/\.(?:mp4|webm|ogg|mov|m4v)(?:[?#]|$)/i.test(src)) component = "video";
+      const isMuted = element.attr("muted") !== void 0;
+      const hasAutoplay = element.attr("autoplay") !== void 0;
+      if (hasAutoplay && !isMuted) return null;
+      props.push("controls={true}");
+      for (const [attribute, prop] of [["muted", "muted"], ["loop", "loop"], ["playsinline", "playsInline"], ["autoplay", "autoPlay"]]) {
+        if (element.attr(attribute) !== void 0) props.push(`${prop}={true}`);
+      }
+      const poster = element.attr("poster");
+      if (poster) props.push(`poster="${migrationImageAttribute(migrationImageUrl(poster, base))}"`);
+    } else {
+      const url = new URL(src);
+      if (url.protocol !== "https:" || url.port || !YOUTUBE_HOSTS.has(url.hostname)) return null;
+      const id = url.pathname.match(/^\/embed\/([A-Za-z0-9_-]{11})$/)?.[1];
+      if (!id || url.hash || [...url.searchParams.keys()].some((name) => name !== "si")) return null;
+      src = `https://www.youtube-nocookie.com/embed/${id}`;
+    }
+    const title = element.attr("title") ?? element.attr("aria-label");
+    if (title !== void 0) props.push(`title="${migrationImageAttribute(title)}"`);
+    return `<${component} src="${migrationImageAttribute(src)}"${props.length ? ` ${props.join(" ")}` : ""} />`;
+  } catch {
+    return null;
+  }
+}
+
 // src/redirects.ts
 var LISTED = 10;
 function exactRoute(route) {
@@ -7987,7 +8067,8 @@ var PORTABLE_MDX_COMPONENTS = /* @__PURE__ */ new Set([
   "Warning",
   "YouTube",
   "picture",
-  "source"
+  "source",
+  "video"
 ]);
 var LOCALE_CODES = /* @__PURE__ */ new Set([
   "ar",
@@ -8023,7 +8104,7 @@ var LOCALE_CODES = /* @__PURE__ */ new Set([
   "zh-hans",
   "zh-hant"
 ]);
-var PORTABLE_URL_PROPS = "href|src|img|primaryHref|secondaryHref";
+var PORTABLE_URL_PROPS = "href|src|poster|img|primaryHref|secondaryHref";
 var PORTABLE_URL_PROP_NAMES = new Set(PORTABLE_URL_PROPS.split("|"));
 var MINTLIFY_ARTICLE_LABELS = [
   { baseUrl: "Select base URL", permalink: "Navigate to header" },
@@ -8099,7 +8180,7 @@ function machineIndexScopePath(source, documents) {
     if (!document) continue;
     const references = [...headerLinks(document)];
     if (/html/i.test(document.contentType)) {
-      const $ = load2(document.body);
+      const $ = load3(document.body);
       references.push(...$("link[href], a[href]").map((_index, element) => $(element).attr("href") ?? "").get().filter((href) => /\/(?:llms(?:-full)?\.txt|sitemap\.xml)(?:[?#]|$)/i.test(href)));
     }
     for (const reference of references) {
@@ -8210,7 +8291,7 @@ function jsonObjectAfterKey(value, key) {
   return null;
 }
 function embeddedMintlifyConfig(body) {
-  const $ = load2(body);
+  const $ = load3(body);
   const flightPayloads = [];
   $("script").each((_index, element) => {
     const script = $(element).text();
@@ -8308,7 +8389,7 @@ function isSafePortableUrl(value) {
   }
 }
 function decodeHtmlAttribute(value) {
-  const document = load2(`<i data-thally-value="${value.replace(/"/g, "&quot;")}"></i>`);
+  const document = load3(`<i data-thally-value="${value.replace(/"/g, "&quot;")}"></i>`);
   return document("i").attr("data-thally-value") ?? "";
 }
 function escapeMarkdownText(value, escapeTableSeparator = false) {
@@ -8394,7 +8475,7 @@ function replacePortableHtmlImages(value) {
     if (start < cursor) continue;
     const end = htmlOpeningTagEnd(value, start + match[0].length);
     if (end === null) continue;
-    const fragment = load2(value.slice(start, end));
+    const fragment = load3(value.slice(start, end));
     const image = fragment("img").first();
     const source = image.attr("src");
     const destination = source && isSafePortableUrl(source) ? markdownLinkDestination(source) : null;
@@ -8419,7 +8500,7 @@ function replacePortableHtmlAnchors(value) {
     const closing = closingMatch.exec(value);
     if (!closing) continue;
     const end = closing.index + closing[0].length;
-    const fragment = load2(value.slice(start, end));
+    const fragment = load3(value.slice(start, end));
     const anchor = fragment("a").first();
     const href = anchor.attr("href");
     const label = escapeMarkdownText(anchor.text().replace(/\s+/g, " ").trim());
@@ -8454,6 +8535,10 @@ function sanitizeMarkdownUrls(value) {
         hasUnsafeMdxSyntax = true;
         return;
       }
+      if (node.name === "video" && node.children?.length) {
+        hasUnsafeMdxSyntax = true;
+        return;
+      }
       for (const attribute of node.attributes ?? []) {
         if (attribute.type !== "mdxJsxAttribute" || !attribute.name || /^on[A-Z]/.test(attribute.name)) {
           hasUnsafeMdxSyntax = true;
@@ -8490,6 +8575,22 @@ function sanitizeMarkdownUrls(value) {
             return;
           }
         }
+        if (node.name === "video") {
+          const isBoolean = ["controls", "muted", "autoPlay", "loop", "playsInline"].includes(attribute.name);
+          const isText = ["src", "poster", "title"].includes(attribute.name);
+          if (isBoolean && typeof staticValue !== "boolean" || isText && typeof attribute.value !== "string" || !isBoolean && !isText) {
+            hasUnsafeMdxSyntax = true;
+            return;
+          }
+          if (attribute.name === "src" || attribute.name === "poster") {
+            try {
+              migrationImageUrl(decodeHtmlAttribute(attribute.value), new URL("https://migration.invalid"));
+            } catch {
+              hasUnsafeMdxSyntax = true;
+              return;
+            }
+          }
+        }
       }
     }
     for (const child of node.children ?? []) validateMdxSyntax(child);
@@ -8602,7 +8703,7 @@ function sanitizeRemoteMarkdown(body) {
   const urlSafeMarkdown = sanitizeMarkdownUrls(sanitized);
   if (urlSafeMarkdown === null) return null;
   const executable = withoutFencedCode2(urlSafeMarkdown).replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<(?:https?:\/\/|mailto:)[^>]+>/gi, "").replace(/(`+)[\s\S]*?\1/g, "");
-  if (/^\s*(?:import|export)\s/m.test(executable)) return null;
+  if (/^[\t ]*(?:import|export)[\t ]/m.test(executable)) return null;
   let hasUnsafeExpression = false;
   const withoutStaticProps = executable.replace(/=\{([^{}\n]*)\}/g, (original, value) => {
     try {
@@ -8699,7 +8800,7 @@ function extractEmbeddedOpenApi(content) {
     const root = embeddedOpenApiParser.parse(content);
     const candidates = (root.children ?? []).flatMap((node2) => {
       if (node2.type !== "code" || !/^(?:yaml|yml|json)$/i.test(node2.lang ?? "")) return [];
-      const metadata = node2.meta?.match(/^(?:(\S+\.(?:yaml|yml|json))\s+)?(delete|get|head|options|patch|post|put|trace)\s+(\/\S+)\s*$/i);
+      const metadata = node2.meta?.match(/^(?:((?:\S+\.(?:yaml|yml|json)|[A-Za-z][A-Za-z0-9_-]{0,127}))\s+)?(delete|get|head|options|patch|post|put|trace)\s+(\/\S+)\s*$/i);
       return metadata ? [{ node: node2, method: metadata[2].toUpperCase(), path: metadata[3] }] : [];
     });
     if (candidates.length !== 1) return { content };
@@ -8838,7 +8939,7 @@ function mergeEmbeddedOpenApi(fragments) {
   return new TextEncoder().encode(stringifyYaml2(combined));
 }
 function migrationHtmlArticle(body) {
-  const $ = load2(body);
+  const $ = load3(body);
   const root = ["main article", "article", "main", '[role="main"]', "body"].map((selector) => $(selector).first()).find((candidate) => candidate.length);
   root.find([
     "script",
@@ -8856,7 +8957,10 @@ function migrationHtmlArticle(body) {
     "#chat-assistant-sheet",
     "#chat-assistant-textarea"
   ].join(",")).remove();
-  const permalinkSelectors = MINTLIFY_ARTICLE_LABELS.map((labels) => `a[aria-label="${labels.permalink}"]`);
+  root.find('div[data-component-part="code-group-tab-content"]').each((_index, element) => {
+    if ($(element).parents("pre").length === 0 && $(element).find("pre").length === 0) element.name = "pre";
+  });
+  const permalinkSelectors = MINTLIFY_ARTICLE_LABELS.map((labels2) => `a[aria-label="${labels2.permalink}"]`);
   root.find([...permalinkSelectors, "h1 .hash-link", "h2 .hash-link", "h3 .hash-link", "h4 .hash-link", "h5 .hash-link", "h6 .hash-link"].join(",")).each((_index, link) => {
     const parent = $(link).parent();
     $(link).remove();
@@ -8867,7 +8971,7 @@ function migrationHtmlArticle(body) {
     const isChecked = $(element).attr("checked") !== void 0;
     $(element).replaceWith($("<span></span>").attr("data-thally-static-task-checkbox", isChecked ? "checked" : "unchecked").text(isChecked ? "[x] " : "[ ] "));
   });
-  root.find(MINTLIFY_ARTICLE_LABELS.map((labels) => `select[aria-label="${labels.baseUrl}"]`).join(",")).each((_index, element) => {
+  root.find(MINTLIFY_ARTICLE_LABELS.map((labels2) => `select[aria-label="${labels2.baseUrl}"]`).join(",")).each((_index, element) => {
     const select = $(element);
     const options = select.children("option").toArray();
     if (!options.length || options.length !== select.children().length) return;
@@ -8906,7 +9010,7 @@ function htmlPage(document, id, options = {}) {
   const title = scopedTitle || $("main h1, article h1, h1").first().text().trim() || $('meta[property="og:title"]').attr("content")?.trim() || $("title").text().split("|")[0].trim();
   const description = $('meta[name="description"]').attr("content")?.trim() || $('meta[property="og:description"]').attr("content")?.trim();
   let documentHeadingAnchor = "";
-  const excludedElements = options.omitDocumentHeading ? "script,style,noscript,nav,footer,aside,form,button,svg,iframe,object,embed,link,meta" : "script,style,noscript,nav,header,footer,aside,form,button,svg,iframe,object,embed,link,meta";
+  const excludedElements = options.omitDocumentHeading ? "script,style,noscript,nav,footer,aside,form,button,svg,object,embed,link,meta" : "script,style,noscript,nav,header,footer,aside,form,button,svg,object,embed,link,meta";
   root.find(excludedElements).remove();
   root.find(".theme-doc-version-badge,.theme-doc-breadcrumbs,.theme-doc-toc-mobile,.table-of-contents,.hash-link").remove();
   if (options.omitDocumentHeading) {
@@ -8964,6 +9068,18 @@ function htmlPage(document, id, options = {}) {
     // Emit literal task-list syntax rather than escaping its brackets as copy.
     replacement: (_content, node) => node.getAttribute("data-thally-static-task-checkbox") === "checked" ? "[x] " : "[ ] "
   });
+  turndown.addRule("migration-authored-paragraph", {
+    filter: (node) => node.nodeName === "SPAN" && node.getAttribute("data-as") === "p",
+    // Some publishers render authored paragraphs as spans. Their explicit
+    // semantic hint must retain a block boundary: otherwise following copy
+    // joins a picture's closing tag or an accordion's source anchor and can
+    // change the resulting MDX grammar. Ordinary spans remain inline.
+    replacement: (content) => `
+
+${content}
+
+`
+  });
   const anchor = (element) => {
     const value = element.getAttribute("id");
     return options.preserveAnchors && value ? `<a id="${value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/\{/g, "&#123;")}" />
@@ -8982,6 +9098,18 @@ ${anchor(element)}${heading ? `${"#".repeat(Number(heading[1]))} ${content.trim(
 `;
     }
   });
+  turndown.addRule("migration-static-media", {
+    filter: (node) => node.nodeName === "VIDEO" || node.nodeName === "IFRAME",
+    replacement: (_content, node) => {
+      const element = node;
+      const projected = projectMigrationMedia(element.outerHTML, document.finalUrl);
+      return projected ? `
+
+${anchor(element)}${projected}
+
+` : "";
+    }
+  });
   if (options.preserveResponsiveImages) {
     const image = (element) => {
       const tag = element.nodeName.toLowerCase();
@@ -9017,7 +9145,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 = load2(element.outerHTML);
+      const fragment = load3(element.outerHTML);
       const clone = fragment(".theme-admonition").first();
       const title2 = clone.find('[class*="admonitionHeading"],.admonition-heading').first();
       const titleText = title2.text().trim();
@@ -9038,15 +9166,15 @@ ${titleText ? `**${escapeMarkdownText(titleText)}**
     filter: (node) => node.nodeName === "DIV" && node.classList.contains("tabs-container"),
     replacement: (_content, node) => {
       const element = node;
-      const fragment = load2(element.outerHTML);
+      const fragment = load3(element.outerHTML);
       const container = fragment(".tabs-container").first();
-      const labels = container.children("ul.tabs").children("li").toArray().map((item) => fragment(item).text().trim() || "Tab");
+      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 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;
-        const title2 = migrationImageAttribute((tab ? fragment(tab).text().trim() : labels[index]) || `Tab ${index + 1}`);
+        const title2 = migrationImageAttribute((tab ? fragment(tab).text().trim() : labels2[index]) || `Tab ${index + 1}`);
         const panelAnchor = options.preserveAnchors && panelId ? `<a id="${migrationImageAttribute(panelId)}" />
 
 ` : "";
@@ -9066,7 +9194,7 @@ ${tabs.join("\n\n")}
   turndown.addRule("gfm-table", {
     filter: "table",
     replacement: (_content, node) => {
-      const fragment = load2(node.outerHTML);
+      const fragment = load3(node.outerHTML);
       const rows = fragment("tr").toArray().map((row) => fragment(row).children("th,td").toArray().map((cell) => {
         const wasConvertingTableCell = isConvertingTableCell;
         isConvertingTableCell = true;
@@ -9092,10 +9220,17 @@ ${normalized.slice(1).map((row) => `| ${row.join(" | ")} |`).join("\n")}
     filter: (node) => node.nodeName === "PRE",
     replacement: (_content, node) => {
       const element = node;
-      const fragment = load2(element.outerHTML);
+      const fragment = load3(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 = fragment("code").attr("class")?.match(/(?:language-|lang-)([A-Za-z0-9_+-]+)/)?.[1] ?? "";
+      const language = ["code", "pre"].flatMap((selector) => {
+        const block = fragment(selector).first();
+        return [
+          block.attr("language"),
+          block.attr("data-language"),
+          block.attr("class")?.match(/(?:^|\s)(?:language-|lang-)([A-Za-z0-9_+-]+)(?=\s|$)/)?.[1]
+        ];
+      }).find((value) => value !== void 0 && /^[A-Za-z0-9_+-]{1,64}$/.test(value)) ?? "";
       const longestFence = Math.max(0, ...[...code.matchAll(/`+/g)].map((match) => match[0].length));
       const fence = "`".repeat(Math.max(3, longestFence + 1));
       return `
@@ -9125,7 +9260,7 @@ ${fence}
   };
 }
 function htmlNavigationLinks(document) {
-  const $ = load2(document.body);
+  const $ = load3(document.body);
   return $('.nav-tabs a[href], nav a[href], aside a[href], [role="navigation"] a[href]').map((_index, element) => $(element).attr("href") ?? "").get().filter(Boolean);
 }
 function normalizedLinkLabel(value) {
@@ -9133,7 +9268,7 @@ function normalizedLinkLabel(value) {
 }
 function readDocusaurusSidebar(document) {
   if (!/html/i.test(document.contentType)) return null;
-  const $ = load2(document.body);
+  const $ = load3(document.body);
   const sidebar = $("ul.theme-doc-sidebar-menu").first();
   if (sidebar.length === 0) return null;
   function readList(list2) {
@@ -9169,7 +9304,7 @@ function docusaurusSidebarHrefs(snapshot) {
   return hrefs;
 }
 function deriveDocusaurusScope(source, document, submittedScopePath) {
-  const $ = load2(document.body);
+  const $ = load3(document.body);
   const sidebar = readDocusaurusSidebar(document);
   const internalPaths = docusaurusSidebarHrefs(sidebar).flatMap((href) => {
     try {
@@ -9299,7 +9434,7 @@ function docusaurusNavigationFromSnapshots(snapshots, pages, scopePath) {
   return { tabs };
 }
 function htmlTopLevelNavigation(document, source, scopePath) {
-  const $ = load2(document.body);
+  const $ = load3(document.body);
   const collectCandidates = (selector) => {
     const candidates2 = [];
     $(selector).each((_containerIndex, container) => {
@@ -9360,7 +9495,7 @@ function markdownLinks(body) {
   return [...body.matchAll(/\[[^\]]+\]\(([^)\s]+)(?:\s+['"][^'"]*['"])?\)/g)].map((match) => match[1]);
 }
 function sitemapLinks(body) {
-  const $ = load2(body, { xmlMode: true });
+  const $ = load3(body, { xmlMode: true });
   return $("url > loc, sitemap > loc").map((_index, element) => $(element).text().trim()).get().filter(Boolean);
 }
 function robotsSitemaps(body) {
@@ -9399,7 +9534,7 @@ async function migrateUrl(options) {
   const platform = options.platform ?? detectUrlPlatform(scopedHtmlProbe ?? initial);
   let docusaurusHtmlProbe = platform === "docusaurus" ? scopedHtmlProbe : null;
   if (docusaurusHtmlProbe && !readDocusaurusSidebar(docusaurusHtmlProbe)) {
-    const $ = load2(docusaurusHtmlProbe.body);
+    const $ = load3(docusaurusHtmlProbe.body);
     const docsHref = $("nav a[href]").toArray().map((element) => ({
       href: $(element).attr("href"),
       label: normalizedLinkLabel($(element).text())
@@ -9849,10 +9984,10 @@ function mainSiteLinkTarget(target2, mountPath, index, unresolved) {
   unresolved.push(target2);
   return void 0;
 }
-function prefixRootLinks(body, mountPath, resolve4, markdown = true) {
+function prefixRootLinks(body, mountPath, resolve5, markdown = true) {
   const mounted = `/${mountPath}`;
   const alreadyMounted = (target2) => target2 === mounted || ["/", "?", "#"].some((next) => target2.startsWith(mounted + next));
-  const fix = (target2) => alreadyMounted(target2) ? target2 : resolve4?.(target2) ?? `${mounted}${target2}`;
+  const fix = (target2) => alreadyMounted(target2) ? target2 : resolve5?.(target2) ?? `${mounted}${target2}`;
   return replaceOutsideCodeAndComments(body, (text3) => text3.replace(markdown ? /(\]\(<?)(\/(?!\/)[^\s)>]*)/g : /(?!)/g, (_match, before, target2) => `${before}${fix(target2)}`).replace(/(\b(?:href|src|to|poster)=(['"]))(\/(?!\/)[^'"\n]*)\2/g, (_match, before, quote, target2) => `${before}${fix(target2)}${quote}`).replace(/(\b(?:href|src|to|poster)=\{\s*(['"]))(\/(?!\/)[^'"\n]*)\2(\s*\})/g, (_match, before, quote, target2, after) => `${before}${fix(target2)}${quote}${after}`).replace(markdown ? /^(\[[^\]\n]+\]:[ \t]*<?)(\/(?!\/)\S*)/gm : /(?!)/g, (_match, before, target2) => `${before}${fix(target2)}`));
 }
 function prefixNavigation(entries, mountPath) {
@@ -10376,8 +10511,8 @@ var HARD_TIMEOUT_REASON = `still running after ${MAX_GIT_PROCESS_MS / 6e4} minut
 var GIT_EXIT_DRAIN_MS = 2e3;
 var RETRYABLE_CLONE_ERROR = /RPC failed|Recv failure|early EOF|curl \d+|Could not resolve host|Connection (?:reset|refused|timed out)|The remote end hung up|SSL[_ ]?(?:read|connect|write) error|timed out|network is unreachable/i;
 function delay(ms) {
-  return new Promise((resolve4) => {
-    setTimeout(resolve4, ms);
+  return new Promise((resolve5) => {
+    setTimeout(resolve5, ms);
   });
 }
 function gitIdleTimeoutMs() {
@@ -10389,7 +10524,7 @@ function gitErrorTail(stderr) {
   return stderr.split(/[\r\n]+/).map((line) => line.trim()).filter((line) => line && !/^(?:remote: )?[A-Za-z][A-Za-z ]*:\s+\d+%/.test(line)).slice(-5).join("\n");
 }
 function runGit(args, options) {
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     const child = spawn("git", args, {
       stdio: ["ignore", "ignore", "pipe"],
       ...options.cwd ? { cwd: options.cwd } : {},
@@ -10412,7 +10547,7 @@ function runGit(args, options) {
       settled = true;
       clearTimers();
       child.stderr.destroy();
-      if (code === 0) resolve4();
+      if (code === 0) resolve5();
       else if (timeoutReason) {
         const hint = timeoutReason === HARD_TIMEOUT_REASON ? "" : "; on a very slow link, raise THALLY_MIGRATE_CLONE_TIMEOUT_MS (milliseconds of allowed silence)";
         reject(new Error(`${options.label}: timed out (${timeoutReason}) and was killed. Check your network connection and try again${hint}.`));
@@ -14343,7 +14478,7 @@ function renderMigrationFiles(bundle, options = {}) {
 
 // src/url-run.ts
 import { createHash as createHash3 } from "crypto";
-import { load as load4 } from "cheerio";
+import { load as load6 } from "cheerio";
 import remarkParse4 from "remark-parse";
 import remarkMdx4 from "remark-mdx";
 import { unified as unified4 } from "unified";
@@ -14721,7 +14856,53 @@ function cloneUrlMigrationCheckpoint(checkpoint) {
 }
 
 // src/url-navigation.ts
-import { load as load3 } from "cheerio";
+import { load as load5 } from "cheerio";
+
+// src/url-scope.ts
+import { load as load4 } from "cheerio";
+function inferUrlMigrationScope(capture) {
+  const source = capture.finalUrl;
+  let end = source.pathname.length;
+  while (end > 0 && source.pathname.charCodeAt(end - 1) === 47) end--;
+  const parent = end < source.pathname.length ? source.pathname.slice(0, end) || "/" : source.pathname.slice(0, source.pathname.lastIndexOf("/")) || "/";
+  if (!/html/i.test(capture.contentType) || Buffer.byteLength(capture.body) > 8e6) return { scopePath: parent, evidence: "source-parent" };
+  const $ = load4(capture.body);
+  const ancestor = (path) => path === "/" || source.pathname === path || source.pathname.startsWith(`${path}/`);
+  const observed = (reference) => {
+    if (!reference || reference.length > 8192) return void 0;
+    try {
+      const url = new URL(reference, source);
+      if (url.origin !== source.origin || url.username || url.password || url.search || url.hash || /%2f|%5c/i.test(url.pathname)) return void 0;
+      return url;
+    } catch {
+      return void 0;
+    }
+  };
+  const indexes = [];
+  $("link[href],a[href]").slice(0, 1e4).each((_, node) => {
+    const url = observed($(node).attr("href"));
+    if (!url || !/\/(?:llms(?:-full)?\.txt|sitemap(?:[-_][^/]*)?\.xml)$/i.test(url.pathname)) return;
+    const path = url.pathname.slice(0, url.pathname.lastIndexOf("/")) || "/";
+    if (ancestor(path)) indexes.push(path);
+  });
+  if (indexes.length) return { scopePath: indexes.sort((a, b) => b.length - a.length)[0], evidence: "discovery-index" };
+  const paths = [];
+  $('nav a[href],aside a[href],[role="navigation"] a[href]').slice(0, 1e4).each((_, node) => {
+    if ($(node).closest("header,footer").length) return;
+    const url = observed($(node).attr("href"));
+    if (url && !/\.[a-z0-9]+$/i.test(url.pathname)) paths.push(url.pathname);
+  });
+  if (new Set(paths).size >= 2 && paths.some((path) => path === source.pathname)) {
+    const segments = paths.map((path) => path.split("/").filter(Boolean));
+    let count = 0;
+    while (segments.every((parts) => parts[count] !== void 0 && parts[count] === segments[0][count])) count++;
+    const common = "/" + segments[0].slice(0, count).join("/");
+    if (ancestor(common)) return { scopePath: common, evidence: "navigation" };
+  }
+  return { scopePath: parent, evidence: "source-parent" };
+}
+
+// src/url-navigation.ts
 var MAX_CAPTURE_BYTES = 8e6;
 var MAX_JSON_BYTES = 2e6;
 var MAX_NODES = 1e4;
@@ -14788,8 +14969,18 @@ function flightRecords(stream) {
   }
   return records;
 }
-function mintlifyNavigation(body, base, locale) {
-  const $ = load3(body);
+function mintlifyNavigation(body, base, locale, selectedScope) {
+  const $ = load5(body);
+  const scope = inferUrlMigrationScope({ body, contentType: "text/html", finalUrl: base });
+  const mount = scope.evidence === "source-parent" ? selectedScope ?? "/" : scope.scopePath;
+  const configTarget = (value) => {
+    const reference = text2(value);
+    if (!reference) return void 0;
+    if (/^(?:[a-z][a-z0-9+.-]*:|\/\/)/i.test(reference)) return target(reference, base);
+    const path = reference.replace(/^\/+/, "");
+    const prefix = mount.replace(/^\/|\/$/g, "");
+    return target(prefix && path !== prefix && !path.startsWith(`${prefix}/`) ? `${prefix}/${path}` : path, new URL("/", base));
+  };
   let stream = "";
   const records = [];
   $("script").each((_index, script) => {
@@ -14826,7 +15017,7 @@ function mintlifyNavigation(body, base, locale) {
     const walk2 = (value, depth = 0, activeLocale) => {
       if (depth > MAX_DEPTH || ++count > MAX_NODES) throw new Error("Source navigation exceeds its safety bound.");
       if (typeof value === "string") {
-        const url2 = target(value, new URL("/", base));
+        const url2 = configTarget(value);
         return url2 ? [{ kind: "page", label: value, url: url2 }] : [];
       }
       if (Array.isArray(value)) return value.flatMap((child) => walk2(child, depth + 1, activeLocale));
@@ -14846,7 +15037,7 @@ function mintlifyNavigation(body, base, locale) {
               return;
             }
             if (!object(node)) return;
-            const href = target(node.href, base);
+            const href = configTarget(node.href);
             if (href) {
               populated++;
               const url2 = new URL(href);
@@ -14864,10 +15055,10 @@ function mintlifyNavigation(body, base, locale) {
         const selected = matching[0]?.item ?? languages.find((item) => text2(item.language)?.toLowerCase() === language?.toLowerCase()) ?? languages.find((item) => text2(item.language)?.toLowerCase() === "en") ?? languages[0];
         return selected ? walk2({ ...selected, languages: void 0 }, depth + 1, text2(selected.language)) : [];
       }
-      const label = text2(value.tab) ?? text2(value.group) ?? text2(value.title) ?? text2(value.label);
-      const kind = text2(value.tab) ? "tab" : text2(value.group) ? "group" : "page";
+      const label = text2(value.tab) ?? text2(value.dropdown) ?? text2(value.group) ?? text2(value.sidebarTitle) ?? text2(value.title) ?? text2(value.label);
+      const kind = text2(value.tab) || text2(value.dropdown) ? "tab" : text2(value.group) ? "group" : "page";
       const children = ["tabs", "groups", "pages", "dropdowns", "anchors", "versions"].flatMap((key) => Array.isArray(value[key]) ? walk2(value[key], depth + 1, activeLocale) : []);
-      const url = target(value.href, base);
+      const url = configTarget(value.href);
       if (!label) return children;
       if (!url && !children.length) return [];
       return [{
@@ -14875,6 +15066,7 @@ function mintlifyNavigation(body, base, locale) {
         label,
         ...url ? { url } : {},
         ...children.length ? { children } : {},
+        ...text2(value.dropdown) ? { presentation: "dropdown" } : {},
         ...kind === "tab" && activeLocale ? { locale: activeLocale } : {}
       }];
     };
@@ -14901,18 +15093,19 @@ function resolveNavigation(nodes, base) {
         ...url ? { url } : {},
         ...children.length ? { children } : {},
         ...["tab", "group", "page"].includes(node.kind ?? "") ? { kind: node.kind } : {},
+        ...node.presentation === "dropdown" ? { presentation: "dropdown" } : {},
         ...text2(node.locale) ? { locale: text2(node.locale) } : {}
       }];
     });
   };
   return walk2(nodes);
 }
-function extractSourceNavigation(capture) {
+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 [];
-  const mintlify = mintlifyNavigation(capture.body, capture.finalUrl, capture.locale);
+  const mintlify = mintlifyNavigation(capture.body, capture.finalUrl, capture.locale, selectedScope);
   if (mintlify.length) return mintlify;
-  const $ = load3(capture.body);
+  const $ = load5(capture.body);
   const candidates = ['.theme-doc-sidebar-menu,[aria-label*="sidebar" i]', "aside", '[role="navigation"],nav'];
   const root = candidates.map((selector) => $(selector).filter((_index, node) => $(node).find("a[href]").length > 0 && $(node).closest("header").length === 0).first()).find((candidate) => candidate.length);
   if (!root) return [];
@@ -14988,8 +15181,127 @@ function mergeSourceNavigation(existing, incoming) {
   return merge(existing, incoming);
 }
 
+// src/url-api-schema-controls.ts
+var MAX_CAPTURE_BYTES2 = 8e6;
+var MAX_TAB_GROUPS = 256;
+var MAX_TABS = 1024;
+function object2(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function localReference2(document, reference) {
+  if (typeof reference !== "string" || !reference.startsWith("#/")) return void 0;
+  let target2 = document;
+  try {
+    for (const part of reference.slice(2).split("/")) {
+      const key = decodeURIComponent(part).replace(/~1/g, "/").replace(/~0/g, "~");
+      if (!target2 || typeof target2 !== "object" || !Object.hasOwn(target2, key)) return void 0;
+      target2 = target2[key];
+    }
+  } catch {
+    return void 0;
+  }
+  return target2;
+}
+function resolve4(document, value) {
+  const seen = /* @__PURE__ */ new Set();
+  for (let depth = 0; depth < 32; depth += 1) {
+    const schema = object2(value);
+    if (!schema || seen.has(schema)) return void 0;
+    seen.add(schema);
+    if (!Object.hasOwn(schema, "$ref")) return schema;
+    value = localReference2(document, schema.$ref);
+  }
+  return void 0;
+}
+function complete(document) {
+  let visited = 0;
+  const active = /* @__PURE__ */ new Set();
+  const visit = (value, depth) => {
+    if (++visited > 1e5 || depth > 96) return false;
+    if (typeof value === "number" && !Number.isFinite(value)) return false;
+    if (!value || typeof value !== "object") return true;
+    if (active.has(value)) return false;
+    active.add(value);
+    const schema = object2(value);
+    const valid = (!schema || !Object.hasOwn(schema, "$ref") || Boolean(object2(localReference2(document, schema.$ref)))) && Object.values(value).every((child) => visit(child, depth + 1));
+    active.delete(value);
+    return valid;
+  };
+  return visit(document, 0);
+}
+function labels(document, value) {
+  const schema = resolve4(document, value);
+  if (!Array.isArray(schema?.oneOf) || schema.oneOf.length < 2 || schema.oneOf.length > 64) return void 0;
+  const result = [];
+  for (const [index, branch] of schema.oneOf.entries()) {
+    const target2 = resolve4(document, branch);
+    if (!target2) return void 0;
+    const title = object2(branch)?.title ?? target2.title;
+    result.push(typeof title === "string" && title.trim() ? title.trim().replace(/\s+/g, " ") : `Option ${index + 1}`);
+  }
+  return new Set(result).size === result.length ? result : void 0;
+}
+function apiSchemaTabGroups(body, document, operation) {
+  if (Buffer.byteLength(body) > MAX_CAPTURE_BYTES2 || !complete(document)) return [];
+  const path = object2(document.paths)?.[operation.path];
+  const method = operation.method.toLowerCase();
+  if (!/^(?:get|post|put|patch|delete|head|options|trace)$/.test(method)) return [];
+  const selected = object2(object2(path)?.[method]);
+  if (!selected) return [];
+  const { $, root } = migrationHtmlArticle(body);
+  const groups = root.find('[role="tablist"],[data-component-part="tabs-list"]');
+  if (groups.length > MAX_TAB_GROUPS || root.find('[role="tab"]').length > MAX_TABS) return [];
+  const idCounts = /* @__PURE__ */ new Map();
+  root.find("[id]").each((_index, node) => {
+    const id = $(node).attr("id");
+    idCounts.set(id, (idCounts.get(id) ?? 0) + 1);
+  });
+  const proofs = [];
+  groups.each((index, node) => {
+    const group = $(node);
+    const container = group.parent(".tabs.tab-container");
+    const field = group.closest(".object-param-field");
+    const section = field.parent(".api-section");
+    if (!group.is('[role="tablist"][data-component-part="tabs-list"]') || !container.length || !section.length || !section.closest('[id^="api-playground-"][id$="-operation-page"]').length) return;
+    if (field.parents(".object-param-field").length) return;
+    const heading = section.children(".api-section-heading");
+    const title = heading.find(".api-section-heading-title").text().trim().toLowerCase();
+    const media = heading.find("*").toArray().filter((element) => $(element).children().length === 0).map((element) => $(element).text().trim()).filter((text3) => /^[a-z][a-z\d.+-]*\/[a-z\d.+-]+$/i.test(text3));
+    if (heading.length !== 1 || !media || media.length !== 1) return;
+    let schema;
+    let scope;
+    if (title === "body") {
+      const request2 = resolve4(document, selected.requestBody);
+      schema = object2(object2(request2?.content)?.[media[0]])?.schema;
+      scope = `request:${media[0]}`;
+    } else if (title === "response") {
+      const statuses = heading.find('button[aria-haspopup="menu"]').toArray().map((button) => $(button).text().trim()).filter((text3) => /^(?:[1-5]\d{2}|default)$/.test(text3));
+      if (statuses.length !== 1) return;
+      const response = resolve4(document, object2(selected.responses)?.[statuses[0]]);
+      schema = object2(object2(response?.content)?.[media[0]])?.schema;
+      scope = `response:${statuses[0]}:${media[0]}`;
+    } else return;
+    const expected = labels(document, schema);
+    const tabs = group.children('[role="tab"][data-component-part="tab"]');
+    if (!expected || tabs.length !== expected.length || group.children().length !== tabs.length) return;
+    const panels = container.children('[data-component-part="tabs-panels"]').children('[role="tabpanel"][data-component-part="tab-content"]');
+    if (panels.length !== tabs.length) return;
+    const ids = /* @__PURE__ */ new Set();
+    for (const [position, tab] of tabs.toArray().entries()) {
+      const control = $(tab).attr("aria-controls");
+      const panel = panels.eq(position);
+      if ($(tab).text().trim().replace(/\s+/g, " ") !== expected[position] || !control || ids.has(control) || panel.attr("id") !== control || !$(tab).attr("id") || panel.attr("aria-labelledby") !== $(tab).attr("id") || idCounts.get(control) !== 1 || panel.text().trim() || panel.children().length) return;
+      ids.add(control);
+    }
+    proofs.push({ index, scope });
+  });
+  const scopeCounts = /* @__PURE__ */ new Map();
+  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);
+}
+
 // src/url-run.ts
-var CONVERTER_VERSION = "url-evidence-v4";
+var CONVERTER_VERSION = "url-evidence-v5";
 var parser2 = unified4().use(remarkParse4).use(remarkMdx4);
 var ACCEPT = "text/markdown,text/html,application/xhtml+xml;q=0.9";
 var MAX_RESPONSE_BYTES = 8e6;
@@ -15052,7 +15364,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 $ = load4(document.body, { xmlMode: true });
+    const $ = load6(document.body, { xmlMode: true });
     return $("loc").toArray().map((node) => $(node).text().trim());
   }
   return [
@@ -15095,8 +15407,8 @@ function markdownHeadingAnchors(body) {
     return occurrence ? `${base}-${occurrence}` : base;
   });
 }
-function sourceNavigation(capture) {
-  return extractSourceNavigation(capture);
+function sourceNavigation(capture, selectedScope) {
+  return extractSourceNavigation(capture, selectedScope);
 }
 function idForUrl(url, scope) {
   const relative7 = scope === "/" ? url.pathname.slice(1) : url.pathname.slice(scope.length).replace(/^\//, "");
@@ -15105,7 +15417,7 @@ function idForUrl(url, scope) {
 }
 function articleIdentity(document) {
   if (!/html/i.test(document.contentType)) return document.finalUrl;
-  const $ = load4(document.body);
+  const $ = load6(document.body);
   const reference = $('link[rel="canonical"][href]').first().attr("href");
   if (!reference) return document.finalUrl;
   try {
@@ -15161,16 +15473,24 @@ function assetReferences(capture) {
   }
   const { $, root } = migrationHtmlArticle(capture.body);
   return [
-    ...root.find("img[src],video[poster],a[download][href]").toArray().map((node) => $(node).attr("src") ?? $(node).attr("poster") ?? $(node).attr("href")),
+    ...root.find("img[src],video[poster],a[download][href]").toArray().map((node) => $(node).is("video") ? $(node).attr("poster") : $(node).is("a") ? $(node).attr("href") : $(node).attr("src")),
     ...root.find("[srcset]").toArray().flatMap((node) => migrationImageCandidates($(node).attr("srcset") ?? "", capture.finalUrl).map((candidate) => candidate.url))
   ].filter(Boolean);
 }
-function unresolvedStaticControls(body, hasApiSchema = false) {
+function unresolvedStaticControls(body, hasApiSchema = false, coveredSchemaGroups = []) {
   const { $, root } = migrationHtmlArticle(body);
+  root.find('[role="tablist"],[data-component-part="tabs-list"]').each((index, node) => {
+    if (coveredSchemaGroups.includes(index)) $(node).remove();
+  });
   const tabs = root.find('[role="tab"]').toArray();
   for (const tab of tabs) {
     const controls = $(tab).attr("aria-controls");
-    const panels = controls ? root.find("[id]").filter((_index, node) => $(node).attr("id") === controls) : root.find('[role="tabpanel"]').eq(tabs.indexOf(tab));
+    const group = $(tab).closest('[role="tablist"]');
+    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 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 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;
   }
   return root.find("details:not([open])").toArray().some((node) => {
@@ -15221,12 +15541,12 @@ function hasCompleteLocalApiSchema(document) {
     if (typeof value === "number" && !Number.isFinite(value)) return false;
     if (!value || typeof value !== "object") return true;
     if (Array.isArray(value)) return value.every((child) => visit(child, depth + 1));
-    const object2 = value;
-    if (Object.prototype.hasOwnProperty.call(object2, "$ref")) {
-      if (typeof object2.$ref !== "string" || !object2.$ref.startsWith("#/")) return false;
+    const object3 = value;
+    if (Object.prototype.hasOwnProperty.call(object3, "$ref")) {
+      if (typeof object3.$ref !== "string" || !object3.$ref.startsWith("#/")) return false;
       let target2 = document;
       try {
-        for (const encoded of object2.$ref.slice(2).split("/")) {
+        for (const encoded of object3.$ref.slice(2).split("/")) {
           const key = decodeURIComponent(encoded).replace(/~1/g, "/").replace(/~0/g, "~");
           if (!target2 || typeof target2 !== "object" || !Object.prototype.hasOwnProperty.call(target2, key)) return false;
           target2 = target2[key];
@@ -15235,7 +15555,7 @@ function hasCompleteLocalApiSchema(document) {
         return false;
       }
     }
-    return Object.values(object2).every((child) => visit(child, depth + 1));
+    return Object.values(object3).every((child) => visit(child, depth + 1));
   };
   return visit(document);
 }
@@ -15250,6 +15570,25 @@ function resolveMigrationRecord(records, record) {
 }
 function navigationConfig(checkpoint, records) {
   const navigation = checkpoint.navigation;
+  const shortcuts = [];
+  const collectShortcuts = (nodes) => {
+    for (const node of nodes) {
+      if (node.url) {
+        const record = records.get(canonical(node.url, checkpoint.sourceUrl) ?? "");
+        const href = record?.redirectTo ?? node.url;
+        const identity = canonical(href, checkpoint.sourceUrl);
+        const target2 = identity ? new URL(href, checkpoint.sourceUrl).href : null;
+        if (target2 && !inScope(new URL(target2), new URL(checkpoint.sourceUrl), checkpoint.scopePath) && !shortcuts.some((link) => link.label === node.label && link.href === target2)) shortcuts.push({ label: node.label, href: target2 });
+      }
+      collectShortcuts(node.children ?? []);
+    }
+  };
+  collectShortcuts(navigation);
+  const hasDropdown = navigation.some((node) => node.presentation === "dropdown");
+  const externalNavigation = shortcuts.length || hasDropdown ? { navigation: {
+    ...shortcuts.length ? { shortcuts } : {},
+    ...hasDropdown ? { display: "dropdown" } : {}
+  } } : {};
   const projection = localeProjection(checkpoint);
   const project2 = (nodes) => nodes.flatMap((node) => {
     const record = node.url ? records.get(canonical(node.url, node.url) ?? "") : void 0;
@@ -15270,7 +15609,7 @@ function navigationConfig(checkpoint, records) {
       return pages2.length || tab.url ? [{ tab: tab.label, ...pages2.length ? { pages: pages2 } : {}, ...tab.url ? { href: tab.url } : {} }] : [];
     });
     const primary = localizedTabs(projection.defaultLocale);
-    return { tabs: primary.length ? primary : localizedTabs(locales[0]), ...locales.length > 1 ? {
+    return { ...externalNavigation, tabs: primary.length ? primary : localizedTabs(locales[0]), ...locales.length > 1 ? {
       i18n: {
         defaultLocale: projection.defaultLocale,
         locales: locales.map((code) => ({ code, label: code === "en" ? "English" : code })),
@@ -15279,7 +15618,7 @@ function navigationConfig(checkpoint, records) {
     } : {} };
   }
   const pages = project2(navigation);
-  return pages.length ? { tabs: [{ tab: "Documentation", pages }] } : null;
+  return pages.length || shortcuts.length ? { ...externalNavigation, tabs: [{ tab: "Documentation", pages }] } : null;
 }
 function canonicalLanguage(value) {
   if (!/^[a-z]{2,3}(?:-[a-z0-9]{2,8}){0,4}$/i.test(value)) return void 0;
@@ -15299,7 +15638,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) ? load4(document.body)("html").attr("lang")?.trim() : void 0;
+  const declared = /html/i.test(document.contentType) ? load6(document.body)("html").attr("lang")?.trim() : void 0;
   if (declared) {
     const locale = canonicalLanguage(declared);
     if (locale) candidates.push({ source: "html lang", value: locale });
@@ -15376,13 +15715,15 @@ function validateUrlMigration(checkpoint, cancelled = false) {
   const projection = localeProjection(checkpoint);
   const primaryIds = new Set(checkpoint.records.flatMap((record) => record.page && (!projection.canonicalLocale(record.page) || projection.canonicalLocale(record.page) === projection.defaultLocale) ? [projection.navigationId(record.page)] : []));
   const outputIds = /* @__PURE__ */ new Set();
-  const resolve4 = (url) => {
+  const resolve5 = (url) => {
     const record = records.get(canonical(url, checkpoint.sourceUrl) ?? "");
     return resolveMigrationRecord(records, record);
   };
   for (const record of checkpoint.records) {
     counts[record.outcome]++;
     issues.push(...record.issues ?? []);
+    warnings.push(...record.warnings ?? []);
+    if (record.outcome === "alias" && !resolveMigrationRecord(records, record)?.page) issues.push({ code: "missing-page", source: record.url, message: "An alias does not resolve to an imported source page." });
     if (record.outcome === "pending" || record.outcome === "failed") issues.push({ code: "missing-page", source: record.url, message: record.reason ?? `Inventory entry is ${record.outcome}.` });
     if (!record.page || !record.evidence) continue;
     const outputId = projection.pageId(record.page);
@@ -15401,8 +15742,9 @@ function validateUrlMigration(checkpoint, cancelled = false) {
         continue;
       }
       if (!inScope(link, source, checkpoint.scopePath)) continue;
+      if (isDiscoveryIndex(link, source)) 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());
+      const destination = resolve5(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") {
@@ -15429,7 +15771,9 @@ function validateUrlMigration(checkpoint, cancelled = false) {
       if (node.url) {
         const url = new URL(node.url, source);
         if (inScope(url, source, checkpoint.scopePath)) {
-          const page = resolve4(url.toString())?.page;
+          const destination = resolve5(url.toString());
+          if (destination?.outcome === "excluded" && destination.redirectTo) continue;
+          const page = destination?.page;
           if (!page) issues.push({ code: "navigation-missing", source: node.url, message: `Source navigation target ${node.label} was not imported.` });
           else if (locale && locale !== projection.defaultLocale && !outputIds.has(`${locale}/${projection.navigationId(page)}`)) {
             issues.push({ code: "navigation-missing", source: node.url, message: `The ${locale} sidebar target ${node.label} has no authored localized runtime page.` });
@@ -15446,16 +15790,32 @@ function validateUrlMigration(checkpoint, cancelled = false) {
 async function runUrlMigration(options) {
   const source = validateMigrationUrl(options.sourceUrl);
   const sourceUrl = canonical(source.toString(), source.toString());
-  const requestedScope = options.scopePath ?? (source.pathname.endsWith("/") ? source.pathname : source.pathname.slice(0, source.pathname.lastIndexOf("/")) || "/");
-  let scopeEnd = requestedScope.length;
-  while (scopeEnd > 0 && requestedScope.charCodeAt(scopeEnd - 1) === 47) scopeEnd--;
-  const scopePath = requestedScope.slice(0, scopeEnd) || "/";
-  if (!scopePath.startsWith("/") || scopePath.includes("?") || scopePath.includes("#") || !inScope(source, source, scopePath)) throw new Error("The selected documentation scope must contain the source URL.");
   const maxPages = options.maxPages ?? 1e3;
   if (!Number.isInteger(maxPages) || maxPages < 1 || maxPages > 1e4) throw new Error("maxPages must be between 1 and 10000.");
   const concurrency = Math.max(1, Math.min(32, Math.floor(options.concurrency ?? 5)));
   const batchSize = Math.max(1, Math.min(500, Math.floor(options.batchSize ?? 50)));
   if (!Number.isFinite(concurrency) || !Number.isFinite(batchSize) || options.maxCaptures !== void 0 && (!Number.isInteger(options.maxCaptures) || options.maxCaptures < 1) || options.maxTotalBytes !== void 0 && (!Number.isFinite(options.maxTotalBytes) || options.maxTotalBytes < 1)) throw new Error("Migration batch, concurrency and byte limits must be positive finite numbers.");
+  const fetcher = options.fetcher ?? defaultMigrationFetcher;
+  const acquire = options.captureProvider?.capture.bind(options.captureProvider) ?? (async ({ url }) => fetcher(url, { accept: ACCEPT }));
+  let initial;
+  let inferredScope;
+  if (options.scopePath === void 0 && !options.checkpoint && !options.signal?.aborted) {
+    initial = Promise.resolve().then(() => acquire({ url: source, signal: options.signal }));
+    try {
+      const document = await initial;
+      if (document.finalUrl.origin === source.origin) {
+        const inferred = inferUrlMigrationScope(document).scopePath;
+        if (inScope(source, source, inferred)) inferredScope = inferred;
+      }
+    } catch {
+    }
+  }
+  const capture = (request2) => initial && canonical(request2.url.href, sourceUrl) === sourceUrl ? initial : acquire(request2);
+  const requestedScope = options.scopePath ?? options.checkpoint?.scopePath ?? inferredScope ?? (source.pathname.endsWith("/") ? source.pathname : source.pathname.slice(0, source.pathname.lastIndexOf("/")) || "/");
+  let scopeEnd = requestedScope.length;
+  while (scopeEnd > 0 && requestedScope.charCodeAt(scopeEnd - 1) === 47) scopeEnd--;
+  const scopePath = requestedScope.slice(0, scopeEnd) || "/";
+  if (!scopePath.startsWith("/") || scopePath.includes("?") || scopePath.includes("#") || !inScope(source, source, scopePath)) throw new Error("The selected documentation scope must contain the source URL.");
   const captureVersion = options.captureVersion ?? "fetch-v1";
   if (options.checkpoint && options.checkpoint.records.length > MAX_RECORDS) throw new Error("Checkpoint inventory exceeds its bound.");
   const checkpoint = options.checkpoint ? cloneUrlMigrationCheckpoint(options.checkpoint) : { schemaVersion: 1, converterVersion: CONVERTER_VERSION, sourceUrl, scopePath, captureVersion, records: [], navigation: [] };
@@ -15474,6 +15834,8 @@ async function runUrlMigration(options) {
       delete record.apiSpecification;
       delete record.version;
       delete record.issues;
+      delete record.warnings;
+      delete record.redirectTo;
       delete record.reason;
       delete record.aliasOf;
     }
@@ -15486,6 +15848,7 @@ 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 existing = records.get(url);
     if (existing) {
       if (!existing.discoveredBy.includes(discoveredBy)) {
@@ -15495,10 +15858,15 @@ async function runUrlMigration(options) {
       return;
     }
     if (records.size >= MAX_RECORDS) throw new Error("Discovered URL inventory exceeded the 100000 URL safety bound.");
-    const record = { url, discoveredBy: [discoveredBy], outcome: "pending" };
+    const record = {
+      url,
+      discoveredBy: [discoveredBy],
+      outcome: isAttachment ? "excluded" : "pending",
+      ...isAttachment ? { reason: "Machine-readable attachment, not an authored article." } : {}
+    };
     records.set(url, record);
     checkpoint.records.push(record);
-    pending.push(record);
+    if (!isAttachment) pending.push(record);
     changed.push(record);
   };
   enqueue(sourceUrl, sourceUrl, "submitted");
@@ -15531,8 +15899,6 @@ async function runUrlMigration(options) {
     }
   }
   enqueueNavigation(checkpoint.navigation, sourceUrl);
-  const fetcher = options.fetcher ?? defaultMigrationFetcher;
-  const capture = options.captureProvider?.capture.bind(options.captureProvider) ?? (async ({ url }) => fetcher(url, { accept: ACCEPT }));
   const assetFetcher = options.assetFetcher ?? (!options.fetcher && !options.captureProvider ? defaultAssetFetcher : void 0);
   const usedIds = new Map([...records.values()].filter((record) => record.page).map((record) => [record.page.id, record.url]));
   const finalUrls = new Map([...records.values()].filter((record) => record.evidence && record.page).map((record) => [canonical(record.evidence.finalUrl, sourceUrl), record.url]));
@@ -15540,6 +15906,10 @@ async function runUrlMigration(options) {
   const assetPayloads = new Map(checkpoint.records.flatMap((record) => (record.assets ?? []).map((asset) => [asset.sha256, asset])));
   const assetBytes = /* @__PURE__ */ new Map();
   const retainAsset = (asset) => {
+    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.");
     const sha256 = hash2(asset.content);
     const content = assetBytes.get(sha256) ?? Buffer.from(asset.content);
@@ -15572,6 +15942,11 @@ async function runUrlMigration(options) {
     let markdownRepresentation;
     try {
       delete record.reason;
+      if (/\/llms-full\.txt$/i.test(new URL(record.url).pathname)) {
+        record.outcome = "excluded";
+        record.reason = "Aggregate documentation corpus; individual articles are inventoried separately.";
+        return;
+      }
       delete record.apiSpecification;
       const represented = resolveMigrationRecord(records, record.representationOf ? records.get(record.representationOf) : void 0);
       if (represented?.outcome === "imported") {
@@ -15581,6 +15956,16 @@ async function runUrlMigration(options) {
       }
       const document = await capture({ url: new URL(record.url), signal: options.signal });
       if (options.signal?.aborted) return;
+      if (document.status && document.status >= 300 && document.status < 400 && document.headers?.location) {
+        const destination = canonical(document.headers.location, document.finalUrl.href);
+        if (destination && new URL(destination).origin !== source.origin) {
+          record.outcome = "excluded";
+          record.redirectTo = new URL(document.headers.location, document.finalUrl).href;
+          record.reason = "The source entry is a redirect to an external public resource, retained as a link.";
+          return;
+        }
+        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);
       const final = canonical(identity.toString(), sourceUrl);
@@ -15588,6 +15973,7 @@ async function runUrlMigration(options) {
       if (!inScope(document.finalUrl, source, scopePath) && !(role === "index" && isDiscoveryIndex(document.finalUrl, source))) {
         record.outcome = "excluded";
         record.reason = "Redirected outside the selected origin/path.";
+        if (document.finalUrl.origin === source.origin && (!document.status || document.status >= 200 && document.status < 300)) record.redirectTo = document.finalUrl.href;
         return;
       }
       if (document.status && document.status >= 400) throw new Error(`Source page returned HTTP ${document.status}.`);
@@ -15605,7 +15991,7 @@ async function runUrlMigration(options) {
         return;
       }
       if (/html/i.test(document.contentType)) {
-        const $ = load4(document.body);
+        const $ = load6(document.body);
         $('link[rel="alternate"][type="text/markdown"][href]').each((_index, node) => {
           const alternate = canonical($(node).attr("href"), final);
           if (!alternate) return;
@@ -15619,7 +16005,7 @@ async function runUrlMigration(options) {
           changed.push(sibling);
         });
       }
-      const observedNavigation = sourceNavigation(document);
+      const observedNavigation = sourceNavigation(document, scopePath);
       if (observedNavigation.length && !(checkpoint.navigation.some((node) => node.kind === "tab") && !observedNavigation.some((node) => node.kind === "tab"))) {
         const merged = mergeSourceNavigation(checkpoint.navigation, observedNavigation);
         if (JSON.stringify(merged) !== JSON.stringify(checkpoint.navigation)) {
@@ -15661,6 +16047,7 @@ async function runUrlMigration(options) {
         record.reason = "Content could not be represented as safe inert MDX.";
         return;
       }
+      let coveredSchemaGroups = [];
       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 });
@@ -15676,6 +16063,7 @@ async function runUrlMigration(options) {
           const path = `openapi/migration-${sha256}.json`;
           record.apiSpecification = { path, sha256, document: fragment.document };
           page.openapi = `${path} ${fragment.method} ${fragment.path}`;
+          coveredSchemaGroups = apiSchemaTabGroups(document.body, fragment.document, fragment);
         }
       }
       const states = document.states ?? [];
@@ -15705,17 +16093,24 @@ ${difference}`;
       }
       record.assets = [];
       record.issues = [];
+      record.warnings = [];
       if (/html/i.test(document.contentType)) {
         const { $, root } = migrationHtmlArticle(document.body);
         root.find("nav,footer,aside,.theme-doc-breadcrumbs,.theme-doc-toc-mobile,.table-of-contents,.hash-link").remove();
         root.find('button svg,a.hash-link svg,[aria-hidden="true"] svg,svg[aria-hidden="true"],svg[data-lucide],svg[data-icon]').remove();
+        root.find("video,iframe").each((_index, node) => {
+          if (projectMigrationMedia($.html(node), document.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();
+          }
+        });
         if (record.apiSpecification) {
           root.find('select[aria-label="Select schema type"],select[aria-label="\u9009\u62E9\u67B6\u6784\u7C7B\u578B"]').remove();
           root.find('.option-dropdown svg[data-component-part="icon-svg"]').remove();
         }
         const unsupported = [...new Set(root.find("iframe,object,embed,canvas,svg,form,input,textarea,select,math,video,audio").toArray().map((node) => node.tagName))];
         if (unsupported.length) record.issues.push({ code: "unsupported-component", source: record.url, message: `Rendered content requires explicit review for: ${unsupported.join(", ")}.` });
-        if (!states.length && unresolvedStaticControls(document.body, Boolean(record.apiSpecification))) record.issues.push({ code: "unsupported-component", source: record.url, message: "An interactive alternative has no complete captured panel or disclosure content." });
+        if (!states.length && unresolvedStaticControls(document.body, Boolean(record.apiSpecification), coveredSchemaGroups)) record.issues.push({ code: "unsupported-component", source: record.url, message: "An interactive alternative has no complete captured panel or disclosure content." });
       }
       const suppliedAssets = new Map((document.assets ?? []).map((asset) => [canonical(asset.url, final), asset]));
       const assetUrls = [...new Set([...assetReferences(document), ...states.flatMap((state) => assetReferences(state.response))].map((url) => canonical(url, final)).filter((url) => Boolean(url)))];
@@ -15729,6 +16124,11 @@ ${difference}`;
           const supplied = suppliedAssets.get(url);
           const asset = supplied ? 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}` });
+            page.body = rewriteMarkdownDestinations(page.body, (destination) => canonical(destination, final) === url ? url : destination);
+            continue;
+          }
           const extension = acceptedAsset(asset);
           if (!extension) throw new Error("Asset MIME/signature is unsupported or unsafe to serve.");
           const sha256 = hash2(asset.content);
@@ -15770,7 +16170,7 @@ ${difference}`;
     } catch (error) {
       if (options.signal?.aborted) return;
       const wasImported = record.outcome === "imported";
-      record.outcome = record.discoveredBy.every((origin) => origin === "discovery-index") ? "excluded" : "failed";
+      record.outcome = isDiscoveryIndex(new URL(record.url), source) || record.discoveredBy.every((origin) => origin === "discovery-index") ? "excluded" : "failed";
       record.reason = error instanceof Error ? error.message : String(error);
       if (record.page) {
         if (wasImported) imported--;
@@ -15795,7 +16195,7 @@ ${difference}`;
     for (const record of records.values()) {
       if (!record.representationOf) continue;
       const primary = resolveMigrationRecord(records, records.get(record.representationOf));
-      if (!primary) continue;
+      if (!primary || primary === record) continue;
       const winner = primary.outcome === "imported" ? primary : record.outcome === "imported" && primary.outcome === "failed" ? record : void 0;
       if (!winner) continue;
       const alternate = winner === primary ? record : primary;
@@ -15921,7 +16321,7 @@ function rewriteMarkdownDestinations(body, rewrite) {
     return { start: start + index, end: start + index + node.url.length, replacement };
   }).filter((edit) => edit !== null).sort((a, b) => b.start - a.start);
   for (const node of markdownNodes(body)) for (const attribute of node.attributes ?? []) {
-    if (!attribute.name || !["src", "href", "srcSet", "srcset", "img", "primaryHref", "secondaryHref"].includes(attribute.name) || !attribute.position) continue;
+    if (!attribute.name || !["src", "poster", "href", "srcSet", "srcset", "img", "primaryHref", "secondaryHref"].includes(attribute.name) || !attribute.position) continue;
     let value = attribute.value;
     if (typeof value !== "string") {
       try {
@@ -15982,7 +16382,7 @@ async function getPinnedAddress(url) {
 }
 async function requestPinnedSpec(url) {
   const pinned = await getPinnedAddress(url);
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     const req = request(url, {
       headers: { Accept: "application/json, application/yaml, text/yaml, */*", "User-Agent": "Thally-Migrate/1.0 (+https://thally.io)" },
       signal: AbortSignal.timeout(3e4),
@@ -15996,7 +16396,7 @@ async function requestPinnedSpec(url) {
       const status = response.statusCode ?? 0;
       if (status >= 300 && status < 400) {
         response.resume();
-        resolve4({ status, location: response.headers.location, body: Buffer.alloc(0) });
+        resolve5({ status, location: response.headers.location, body: Buffer.alloc(0) });
         return;
       }
       if (status < 200 || status >= 300) {
@@ -16020,7 +16420,7 @@ async function requestPinnedSpec(url) {
         }
         chunks.push(chunk);
       });
-      response.on("end", () => resolve4({ status, body: Buffer.concat(chunks) }));
+      response.on("end", () => resolve5({ status, body: Buffer.concat(chunks) }));
       response.on("error", reject);
     });
     req.on("error", reject);