@thallylabs/migrate 0.2.40 → 0.2.42

package/dist/url-migration.d.ts

@@ -1,5 +1,5 @@
-import { h as MigrationCapture } from './url-run-DFnoqEi-.js';
-export { a as MigrationAsset, f as MigrationBundle, i as MigrationCaptureProvider, j as MigrationCaptureState, k as MigrationCapturedAsset, g as MigrationDocsConfig, l as MigrationEvidence, m as MigrationFetchRequest, n as MigrationFetchResponse, d as MigrationFetcher, o as MigrationJournalAsset, b as MigrationNavigationGroup, p as MigrationNavigationOccurrence, q as MigrationNavigationTab, M as MigrationPage, e as MigrationPlatform, c as MigrationWarning, R as RenderedMigrationFile, U as UrlMigrationCheckpoint, r as UrlMigrationCheckpointDelta, s as UrlMigrationIssue, t as UrlMigrationRecord, u as UrlMigrationRun, v as UrlMigrationRunOptions, w as UrlMigrationValidation, x as classifyMigrationResponse, z as renderMigrationFiles, A as runUrlMigration, B as validateUrlMigration } from './url-run-DFnoqEi-.js';
+import { h as MigrationCapture } from './url-run-CPzQfjRW.js';
+export { a as MigrationAsset, f as MigrationBundle, i as MigrationCaptureProvider, j as MigrationCaptureState, k as MigrationCapturedAsset, g as MigrationDocsConfig, l as MigrationEvidence, m as MigrationFetchRequest, n as MigrationFetchResponse, d as MigrationFetcher, o as MigrationJournalAsset, b as MigrationNavigationGroup, p as MigrationNavigationOccurrence, q as MigrationNavigationTab, M as MigrationPage, e as MigrationPlatform, c as MigrationWarning, R as RenderedMigrationFile, U as UrlMigrationCheckpoint, r as UrlMigrationCheckpointDelta, s as UrlMigrationIssue, t as UrlMigrationRecord, u as UrlMigrationRun, v as UrlMigrationRunOptions, w as UrlMigrationValidation, x as classifyMigrationResponse, z as renderMigrationFiles, A as runUrlMigration, B as validateUrlMigration } from './url-run-CPzQfjRW.js';
 
 interface UrlMigrationScope {
     scopePath: string;

package/dist/url-migration.js

@@ -1,6 +1,7 @@
 // src/url-run.ts
 import { createHash as createHash4 } from "crypto";
 import { load as load7 } from "cheerio";
+import { parse as parse2, postprocess, preprocess } from "micromark";
 import remarkParse4 from "remark-parse";
 import remarkMdx4 from "remark-mdx";
 import { unified as unified4 } from "unified";
@@ -1815,7 +1816,10 @@ var VIDEO_ATTRIBUTES = /* @__PURE__ */ new Set([
   "width",
   "height",
   "preload",
-  "aria-label"
+  "aria-label",
+  // Publisher asset provenance does not change playback and is never emitted.
+  // Keep this explicit: arbitrary data attributes may drive custom controls.
+  "data-path"
 ]);
 var YOUTUBE_ATTRIBUTES = /* @__PURE__ */ new Set([
   "src",
@@ -2618,8 +2622,29 @@ ${trimmed.slice(0, marker).trimEnd()}`;
 function headingIdMarker(id) {
   return `{/* #${id} */}`;
 }
+var HEADING_ID_WORD = /[\p{L}\p{M}\p{N}_+&/@\u2019\u201c\u201d\u2014\u2013\u2192]/u;
 function mintlifyHeadingSlug(text2) {
-  return text2.replace(/\u200b/g, "").normalize("NFC").trim().toLowerCase().replace(/[.\s]+/g, "-").replace(/-{2,}/g, "-").replace(/^-|-$/g, "").replace(/[^\p{L}\p{M}\p{N}_\-+&/\u2019\u201c\u201d\u2014\u2013\u2192]/gu, "");
+  const chars = [...text2.replace(/[\u200b*]/g, "").normalize("NFC").trim().toLowerCase()];
+  const isWord = (char) => char !== void 0 && HEADING_ID_WORD.test(char);
+  let id = "";
+  let afterDash = false;
+  let endsWithDash = false;
+  chars.forEach((char, index) => {
+    const before = chars[index - 1];
+    const after = chars[index + 1];
+    endsWithDash = false;
+    if (isWord(char)) {
+      id += char;
+      afterDash = false;
+    } else if (/[\s-]/.test(char) || char === "." && isWord(after) || char === "(" && isWord(before) && (isWord(after) || after === "{") || char === ")" && after !== void 0 && !/\s/.test(after)) {
+      if (id && !afterDash) id += "-";
+      afterDash = true;
+      endsWithDash = true;
+    } else if (char === "{" || char === ":" || char === '"') {
+      afterDash = false;
+    }
+  });
+  return endsWithDash ? id.replace(/-$/, "") : id;
 }
 function thallyHeadingSlug(text2) {
   return text2.normalize("NFC").toLowerCase().replace(/[^\p{L}\p{M}\p{N}]+/gu, "-").replace(/(^-|-$)/g, "");
@@ -2631,7 +2656,7 @@ function typesetQuotes(text2) {
   }).join("");
 }
 function plainHeadingText(source) {
-  return source.replace(/\{\/\*[\s\S]*?\*\/\}/g, " ").replace(/!?\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/<\/?[A-Za-z][^>]*>/g, "").replace(/`([^`]*)`/g, "$1").replace(/(\*\*|__|~~|\*)/g, "").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/\\([\\`*_{}[\]()#+.!&<>|~-])/g, "$1");
+  return source.replace(/\{\/\*[\s\S]*?\*\/\}/g, " ").replace(/!?\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/<\/?[A-Za-z][^>]*>/g, "").replace(/`([^`]*)`/g, "$1").replace(/(?<!\\)(\*\*|__|~~|\*)/g, "").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/\\([\\`*_{}[\]()#+.!&<>|~-])/g, "$1");
 }
 function markMintlifyHeadings(body) {
   let fence;
@@ -3343,7 +3368,7 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
   }
   if (runMintlify) rewritten = normalizeMintlifyParameterAnchors(rewritten);
   rewritten = replaceOutsideCode(rewritten, (segment) => {
-    let result = convertHtmlStyleAttributes(segment).replace(/<!--([\s\S]*?)-->/g, (_match, content) => mdxComment(content)).replace(/<Danger(\s[^>]*)?>/g, "<Error$1>").replace(/<\/Danger>/g, "</Error>").replace(/<Warn(\s[^>]*)?>/g, "<Warning$1>").replace(/<\/Warn>/g, "</Warning>").replace(/<Check(\s[^>]*)?>/g, "<Note$1>").replace(/<\/Check>/g, "</Note>").replace(/<Tree\.Folder/g, "<Folder").replace(/<\/Tree\.Folder>/g, "</Folder>").replace(/<Tree\.File/g, "<File").replace(/<\/Tree\.File>/g, "</File>");
+    let result = convertHtmlStyleAttributes(segment).replace(/<!--([\s\S]*?)-->/g, (_match, content) => mdxComment(content)).replace(/<Danger(\s[^>]*)?>/g, "<Error$1>").replace(/<\/Danger>/g, "</Error>").replace(/<Warn(\s[^>]*)?>/g, "<Warning$1>").replace(/<\/Warn>/g, "</Warning>").replace(/<Tree\.Folder/g, "<Folder").replace(/<\/Tree\.Folder>/g, "</Folder>").replace(/<Tree\.File/g, "<File").replace(/<\/Tree\.File>/g, "</File>");
     if (runDocusaurus) {
       result = result.replace(/<TabItem\b([^<>]*)>/g, (_match, attributes) => {
         const title = attributes.match(/\blabel=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean) ?? attributes.match(/\bvalue=(?:"([^"]*)"|'([^']*)')/)?.slice(1).find(Boolean) ?? "Tab";
@@ -3352,7 +3377,7 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
       result = normalizeDocusaurusLinkTags(result).replace(/<(?:DocCardList|TOCInline)\b[^<>]*\/>/g, "");
     }
     if (runMintlify) {
-      result = normalizeMintlifyUpdateLabels(result).replace(/<FileTree(\s[^>]*)?>/g, "<Tree$1>").replace(/<\/FileTree>/g, "</Tree>").replace(/<GitHub\.Repo/g, "<GitHub").replace(/<\/GitHub\.Repo>/g, "</GitHub>").replace(/<Column(\s[^>]*)?>/g, "<div$1>").replace(/<\/Column>/g, "</div>");
+      result = normalizeMintlifyUpdateLabels(result).replace(/<FileTree(\s[^>]*)?>/g, "<Tree$1>").replace(/<\/FileTree>/g, "</Tree>").replace(/<GitHub\.Repo/g, "<GitHub").replace(/<\/GitHub\.Repo>/g, "</GitHub>").replace(/<Callout(\s[^<>]*)?>/g, (tag) => tag.replace(/(\s)type=(?:"[^"]*"|'[^']*'|\{[^{}]*\})/, '$1type="info"')).replace(/<Column(\s[^>]*)?>/g, "<div$1>").replace(/<\/Column>/g, "</div>");
       result = pinStepsTitleSize(result);
     }
     if (runFern) {
@@ -3371,6 +3396,16 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
   }
   return normalizeFlowParagraphContainers(normalized);
 }
+function externalPageUrl(value) {
+  const url = typeof value === "string" ? value.trim() : "";
+  if (!/^https?:\/\/[^\s]+$/i.test(url)) return void 0;
+  try {
+    new URL(url);
+    return url;
+  } catch {
+    return void 0;
+  }
+}
 function parseMarkdownPage(input) {
   const parsed = parseFrontmatter(input.raw);
   const fallbackIdentity = {
@@ -3395,6 +3430,7 @@ function parseMarkdownPage(input) {
   const badge = typeof parsed.data.tag === "string" && parsed.data.tag.trim() ? parsed.data.tag.trim() : typeof parsed.data.badge === "string" && parsed.data.badge.trim() ? parsed.data.badge.trim() : void 0;
   const sourceMode = typeof parsed.data.mode === "string" ? parsed.data.mode : void 0;
   const mode = sourceMode === "frame" ? "wide" : ["default", "wide", "custom", "center", "home"].includes(sourceMode ?? "") ? sourceMode : void 0;
+  const externalUrl = input.platform === "mintlify" ? externalPageUrl(parsed.data.url) : void 0;
   const description = typeof parsed.data.description === "string" && parsed.data.description.trim() ? parsed.data.description.trim() : typeof parsed.data.openapi === "string" && parsed.data.openapi.trim() ? "" : firstParagraph(body);
   const page = {
     id: identity.id,
@@ -3410,7 +3446,9 @@ function parseMarkdownPage(input) {
     keywords,
     mode,
     hidden: parsed.data.hidden === true ? true : void 0,
-    noindex: parsed.data.noindex === true || parsed.data.noindex === "true" ? true : void 0,
+    // The path of a page that links elsewhere redirects, so it has no business in a sitemap.
+    noindex: parsed.data.noindex === true || parsed.data.noindex === "true" || externalUrl ? true : void 0,
+    ...externalUrl ? { externalUrl } : {},
     ...Object.keys(meta).length > 0 ? { meta } : {},
     openapi: typeof parsed.data.openapi === "string" ? parsed.data.openapi.trim() : void 0,
     ...apiFrontmatter(parsed.data, input.warn),
@@ -5182,9 +5220,9 @@ function apiOperationCodeControls(body, specification, operation) {
 }
 
 // src/url-run.ts
-var CONVERTER_VERSION = "url-evidence-v6";
+var CONVERTER_VERSION = "url-evidence-v7";
 var parser2 = unified4().use(remarkParse4).use(remarkMdx4);
-var ACCEPT = "text/markdown,text/html,application/xhtml+xml;q=0.9";
+var ACCEPT = "text/html,application/xhtml+xml";
 var MAX_RESPONSE_BYTES = 8e6;
 var MAX_ASSET_BYTES = 1e7;
 var MAX_RECORDS = 1e5;
@@ -5214,6 +5252,11 @@ function canonical(value, base) {
     return null;
   }
 }
+function sameRouteMarkdownRepresentation(alternate, primary) {
+  const target2 = new URL(alternate), source = new URL(primary);
+  const directory2 = (path) => path.replace(/\.mdx?$/i, "").replace(/\/index\/?$/i, "").replace(/\/$/, "");
+  return target2.origin === source.origin && target2.search === source.search && directory2(target2.pathname) === directory2(source.pathname) && /\.mdx?$/i.test(target2.pathname);
+}
 function classifyMigrationResponse(document) {
   if (document.status && document.status >= 400) return "unsupported";
   if (/\/(?:llms(?:-full)?|robots)\.txt$|\/sitemap[^/]*\.xml$|\/search(?:\.html)?$/i.test(document.finalUrl.pathname) || /\.(?:json|ya?ml)$/i.test(document.finalUrl.pathname) || /(?:xml|json)/i.test(document.contentType)) return "index";
@@ -5464,7 +5507,7 @@ function resolveMigrationRecord(records, record) {
   }
   return record;
 }
-function navigationConfig(checkpoint, records) {
+function navigationConfig(checkpoint, records, occurrencePages = /* @__PURE__ */ new Map()) {
   const navigation = checkpoint.navigation;
   const shortcuts = [];
   const collectShortcuts = (nodes) => {
@@ -5489,7 +5532,7 @@ function navigationConfig(checkpoint, records) {
   const project = (nodes) => nodes.flatMap((node) => {
     const record = node.url ? records.get(canonical(node.url, node.url) ?? "") : void 0;
     const target2 = resolveMigrationRecord(records, record);
-    const page = target2?.page;
+    const page = occurrencePages.get(node) ?? target2?.page;
     const children = project(node.children ?? []);
     if (children.length) {
       const contains = (entries) => entries.some((entry) => typeof entry === "string" ? entry === (page && projection.navigationId(page)) : contains(entry.pages));
@@ -5789,8 +5832,19 @@ async function runUrlMigration(options) {
     if (!record.evidence) continue;
     const final = canonical(record.evidence.finalUrl, sourceUrl);
     if (!final) continue;
-    if (record.outcome === "imported") enqueueArticleLinks(record.evidence.links, final, record.url);
-    else if (record.outcome === "excluded") {
+    if (record.outcome === "imported") {
+      enqueueArticleLinks(record.evidence.links, final, record.url);
+      for (const reference of record.evidence.markdownRepresentations ?? []) {
+        const alternate = canonical(reference, final);
+        if (!alternate || !sameRouteMarkdownRepresentation(alternate, final)) continue;
+        enqueue(alternate, final, "declared-markdown-representation");
+        const sibling = records.get(alternate);
+        if (sibling && sibling.representationOf !== record.url) {
+          sibling.representationOf = record.url;
+          changed.push(sibling);
+        }
+      }
+    } else if (record.outcome === "excluded") {
       if (classifyMigrationResponse({ finalUrl: new URL(final), contentType: record.evidence.contentType, body: "" }) === "index") {
         for (const link of record.evidence.links) enqueue(link, final, record.url);
       }
@@ -5873,6 +5927,7 @@ async function runUrlMigration(options) {
     let claimedId;
     let claimedFinal;
     let markdownRepresentation;
+    const markdownRepresentations = [];
     let exactKey;
     try {
       delete record.reason;
@@ -5965,13 +6020,13 @@ async function runUrlMigration(options) {
         $('link[rel="alternate"][type="text/markdown"][href]').each((_index, node) => {
           const alternate = canonical($(node).attr("href"), final);
           if (!alternate) return;
-          const target2 = new URL(alternate), primary = new URL(final);
-          const directory2 = (path) => path.replace(/\.mdx?$/i, "").replace(/\/index\/?$/i, "").replace(/\/$/, "");
-          if (target2.origin !== primary.origin || target2.search !== primary.search || directory2(target2.pathname) !== directory2(primary.pathname) || !/\.mdx?$/i.test(target2.pathname)) return;
+          if (!sameRouteMarkdownRepresentation(alternate, final)) return;
           enqueue(alternate, final, "declared-markdown-representation");
           const sibling = records.get(alternate);
+          if (!sibling) return;
           sibling.representationOf = record.url;
           markdownRepresentation ??= alternate;
+          markdownRepresentations.push(alternate);
           changed.push(sibling);
         });
       }
@@ -5984,7 +6039,8 @@ async function runUrlMigration(options) {
         }
         enqueueNavigation(observedNavigation, final);
       }
-      if (imported >= maxPages) {
+      const replacesRepresentation = imported >= maxPages && markdownRepresentations.some((url) => records.get(url)?.page);
+      if (imported >= maxPages && !replacesRepresentation) {
         record.outcome = "excluded";
         record.reason = "A discovery endpoint resolved to an article after the selected page limit.";
         return;
@@ -6003,14 +6059,17 @@ async function runUrlMigration(options) {
       const locale = language.locale;
       const navigationId = locale ? id.split("/").filter((segment) => segment.toLowerCase() !== locale.toLowerCase()).join("/") || "introduction" : id;
       const identityId = locale ? `${locale}/${navigationId}` : id;
-      if (usedIds.has(identityId) && usedIds.get(identityId) !== record.url) {
+      const owner = records.get(usedIds.get(identityId) ?? "");
+      const sharesDeclaredRepresentation = owner && (owner.representationOf === record.url || record.representationOf === owner.url);
+      if (owner && owner !== record && !sharesDeclaredRepresentation) {
         record.outcome = "failed";
         record.reason = `Destination collision for ${identityId}.`;
         return;
       }
-      usedIds.set(identityId, record.url);
+      if (!owner || owner === record || owner.representationOf === record.url) usedIds.set(identityId, record.url);
       claimedId = identityId;
       const evidence = evidenceOf(document);
+      if (markdownRepresentations.length) evidence.markdownRepresentations = markdownRepresentations;
       const page = convert(document, id);
       if (!page) {
         record.outcome = "failed";
@@ -6221,6 +6280,7 @@ ${difference}`;
       if (!primary || primary === record) continue;
       const winner = primary.outcome === "imported" ? primary : record.outcome === "imported" && primary.outcome === "failed" ? record : void 0;
       if (!winner) continue;
+      if (winner.page) usedIds.set(winner.page.id, winner.url);
       const alternate = winner === primary ? record : primary;
       if (alternate.outcome === "alias" && alternate.aliasOf === winner.url) continue;
       if (alternate.outcome === "imported") {
@@ -6242,7 +6302,17 @@ ${difference}`;
   settleArticleIdentities();
   while (cursor < pending.length && !options.signal?.aborted && !budgetExhausted && cursor < (options.maxCaptures ?? Infinity)) {
     if (imported >= maxPages) {
-      const index = pending.findIndex((record, position) => position >= cursor && isDiscoveryIndex(new URL(record.url), source));
+      const index = pending.findIndex((record, position) => {
+        if (position < cursor || record.outcome !== "pending") return false;
+        const url = new URL(record.url);
+        if (isDiscoveryIndex(url, source)) return true;
+        if (/\.mdx?$/i.test(url.pathname)) return false;
+        return [".md", ".mdx", "/index.md", "/index.mdx"].some((extension) => {
+          const alternate = new URL(url);
+          alternate.pathname = alternate.pathname.replace(/\/index$/i, "") + extension;
+          return records.get(alternate.href)?.outcome === "imported";
+        });
+      });
       if (index < 0) break;
       pending.splice(cursor, 0, pending.splice(index, 1)[0]);
     }
@@ -6266,19 +6336,60 @@ ${difference}`;
   }
   const navigationLabels = /* @__PURE__ */ new Map();
   const navigationIssues = [];
+  const navigationOccurrences = /* @__PURE__ */ new Map();
   const labelPages = (nodes) => {
     for (const node of nodes) {
       const entry = node.url ? records.get(canonical(node.url, sourceUrl) ?? "") : void 0;
       const target2 = resolveMigrationRecord(records, entry);
-      if (target2?.page && node.label && !node.children?.length && !entry?.aliasAnchor) {
-        const previous = navigationLabels.get(target2.url);
-        if (previous && previous !== node.label) navigationIssues.push({ code: "unsupported-component", source: target2.url, message: `This page has multiple source navigation labels (${previous}, ${node.label}); review the shared sidebar title.` });
-        else navigationLabels.set(target2.url, node.label);
+      if (entry && target2?.page && node.label && !node.children?.length && !entry.aliasAnchor) {
+        const occurrences = navigationOccurrences.get(target2) ?? [];
+        occurrences.push({ node, entry });
+        navigationOccurrences.set(target2, occurrences);
       }
       labelPages(node.children ?? []);
     }
   };
   labelPages(checkpoint.navigation);
+  const occurrencePages = /* @__PURE__ */ new Map();
+  const navigationAliases = /* @__PURE__ */ new Map();
+  const occupiedPageIds = new Set(checkpoint.records.flatMap((record) => record.page ? [projection.pageId(record.page)] : []));
+  const navigationRedirects = [];
+  for (const [target2, occurrences] of navigationOccurrences) {
+    const final = target2.evidence && canonical(target2.evidence.finalUrl, sourceUrl);
+    const primary = occurrences.find(({ entry }) => entry.url === final) ?? occurrences.find(({ entry }) => entry === target2) ?? occurrences[0];
+    navigationLabels.set(target2.url, primary.node.label);
+    for (const { node, entry } of occurrences) {
+      if (node.label === primary.node.label) continue;
+      const existing = navigationAliases.get(entry.url);
+      if (existing?.page.navTitle === node.label && existing.target === target2) {
+        occurrencePages.set(node, existing.page);
+        continue;
+      }
+      const sourceRoute = new URL(entry.url);
+      const id = inScope(sourceRoute, source, scopePath) ? idForUrl(sourceRoute, scopePath) : null;
+      const locale = projection.canonicalLocale(target2.page);
+      let navigationId = id && (locale ? id.split("/").filter((segment) => segment.toLowerCase() !== locale.toLowerCase()).join("/") || "introduction" : id);
+      const legacyPrefix = locale && `${locale.toLowerCase()}-`;
+      if (navigationId && legacyPrefix && projection.navigationId(target2.page) !== target2.page.navigationId && navigationId.toLowerCase().startsWith(legacyPrefix)) navigationId = navigationId.slice(legacyPrefix.length);
+      const page = navigationId ? {
+        ...target2.page,
+        id: locale ? `${locale}/${navigationId}` : navigationId,
+        navigationId,
+        ...locale ? { locale } : {},
+        navTitle: node.label,
+        source: entry.url,
+        noindex: true
+      } : void 0;
+      if (!page || existing || occupiedPageIds.has(projection.pageId(page))) {
+        navigationIssues.push({ code: "unsupported-component", source: target2.url, message: `This page has multiple source navigation labels (${primary.node.label}, ${node.label}); their source routes cannot retain distinct sidebar titles safely.` });
+        continue;
+      }
+      occupiedPageIds.add(projection.pageId(page));
+      navigationAliases.set(entry.url, { page, target: target2 });
+      occurrencePages.set(node, page);
+      navigationRedirects.push({ source: projection.route(page), destination: projection.route(target2.page), permanent: true });
+    }
+  }
   const pages = checkpoint.records.flatMap((record) => record.page ? [{ ...record.page, id: projection.pageId(record.page), navigationId: projection.navigationId(record.page), ...projection.canonicalLocale(record.page) ? { locale: projection.canonicalLocale(record.page) } : {}, ...navigationLabels.has(record.url) ? { navTitle: navigationLabels.get(record.url) } : {}, body: rewriteMarkdownDestinations(record.page.body, (value) => {
     let url;
     try {
@@ -6299,6 +6410,10 @@ ${difference}`;
     const hasBrokenSourceAnchor = Boolean(url.hash && destination?.outcome === "imported" && destination.evidence && !destination.evidence.anchors.includes(anchor));
     return `${route}${hasBrokenSourceAnchor ? "" : effectiveHash}`;
   }) }] : []);
+  const projectedPages = new Map(pages.map((page) => [page.id, page]));
+  for (const { page, target: target2 } of navigationAliases.values()) {
+    pages.push({ ...page, id: projection.pageId(page), body: projectedPages.get(projection.pageId(target2.page)).body });
+  }
   const validation = validateUrlMigration(checkpoint, Boolean(options.signal?.aborted));
   validation.issues.push(...navigationIssues);
   if (navigationIssues.length && validation.status === "passed") validation.status = "partial";
@@ -6319,12 +6434,12 @@ ${difference}`;
     platform: options.platform ?? "generic",
     pages,
     assets: [...assets.values()],
-    docsConfig: navigationConfig(checkpoint, records) ?? buildNavigationFromPages(pages),
+    docsConfig: navigationConfig(checkpoint, records, occurrencePages) ?? buildNavigationFromPages(pages),
     warnings: [...validation.issues, ...validation.warnings ?? []].map((issue) => ({ code: issue.code === "missing-page" ? "missing-page" : "unsupported-config", message: issue.message, source: issue.source })),
     urlMigrationValidation: validation,
     stats: { discovered: records.size, imported: pages.length, skipped: records.size - pages.length }
   };
-  if (projection.redirects.length) bundle.docsConfig.redirects = projection.redirects;
+  if (projection.redirects.length || navigationRedirects.length) bundle.docsConfig.redirects = [...projection.redirects, ...navigationRedirects];
   if (projection.locales.length) {
     const locales = [.../* @__PURE__ */ new Set([projection.defaultLocale, ...projection.locales])];
     bundle.docsConfig.i18n = { ...bundle.docsConfig.i18n, defaultLocale: projection.defaultLocale, locales: locales.map((code) => ({ code, label: code === "en" ? "English" : code })) };
@@ -6342,9 +6457,11 @@ function rewriteMarkdownDestinations(body, rewrite) {
     const original = body.slice(start, end);
     const replacement = rewrite(node.url);
     if (replacement === node.url) return null;
-    const index = original.lastIndexOf(node.url);
-    if (index < 0) return null;
-    return { start: start + index, end: start + index + node.url.length, replacement };
+    const destinations = postprocess(parse2().document().write(preprocess()(original, void 0, true))).filter(([event, token]) => event === "enter" && ["resourceDestinationString", "definitionDestinationString", "autolinkProtocol", "autolinkEmail"].includes(token.type));
+    const destination = destinations.at(-1)?.[1];
+    if (!destination) return null;
+    const escaped = replacement.replace(/[\\&()<>]/g, "\\$&").replace(/[\t\n\r ]/g, (character) => encodeURIComponent(character));
+    return { start: start + destination.start.offset, end: start + destination.end.offset, replacement: escaped };
   }).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", "poster", "href", "srcSet", "srcset", "img", "primaryHref", "secondaryHref"].includes(attribute.name) || !attribute.position) continue;
@@ -6477,7 +6594,7 @@ function renderPage(bundle, page) {
     page.icon ? `icon: ${yamlString(page.icon)}` : null,
     page.iconType ? `iconType: ${yamlString(page.iconType)}` : null,
     `description: ${yamlString(page.description)}`,
-    page.descriptionPlacement === "body" ? "descriptionPlacement: body" : null,
+    page.descriptionPlacement === "body" || page.descriptionPlacement === "operation" ? `descriptionPlacement: ${page.descriptionPlacement}` : null,
     page.badge ? `badge: ${yamlString(page.badge)}` : null,
     page.keywords.length > 0 ? `keywords: [${page.keywords.map(yamlString).join(", ")}]` : null,
     page.mode ? `mode: ${yamlString(page.mode)}` : null,