@thallylabs/migrate 0.2.43 → 0.2.45

package/dist/url-migration.d.ts

@@ -1,5 +1,5 @@
-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';
+import { h as MigrationCapture } from './url-run-D-E4dr2h.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-D-E4dr2h.js';
 
 interface UrlMigrationScope {
     scopePath: string;

package/dist/url-migration.js

@@ -56,6 +56,32 @@ function playgroundDisplay(value, where, warn) {
   return void 0;
 }
 
+// src/redirects.ts
+function trimTrailingSlashes(route) {
+  let end = route.length;
+  while (end > 0 && route[end - 1] === "/") end--;
+  return route.slice(0, end);
+}
+function exactRoute(route) {
+  return route.startsWith("/") && !/[?:*#()[\]{}]/.test(route) ? trimTrailingSlashes(route) || "/" : null;
+}
+function literalRoute(route) {
+  return exactRoute(route)?.toLowerCase() ?? null;
+}
+function resolveDotSegments(route) {
+  const segments = [];
+  for (const segment of route.split("/").slice(1)) {
+    const dots = segment.replace(/%2e/gi, ".");
+    if (dots === "..") segments.pop();
+    else if (dots !== ".") segments.push(segment);
+  }
+  return `/${segments.join("/")}`;
+}
+function destinationRoute(destination) {
+  const route = destination.startsWith("//") ? null : exactRoute(destination.split(/[?#]/, 1)[0]);
+  return route === null ? null : resolveDotSegments(route);
+}
+
 // src/navigation.ts
 function titleCase(value) {
   return value.split(/[-_]/).map((word) => ["api", "cli", "sdk", "ui"].includes(word.toLowerCase()) ? word.toUpperCase() : word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
@@ -1270,9 +1296,9 @@ function recoverFlightArticleCode($, root) {
   const projectionBudget = expansionBudget();
   recoverFlightTreeTabs($, root, projectionBudget);
   const renderedHeadings = root.find("h1,h2,h3,h4,h5,h6").toArray().filter((node) => $(node).attr("data-thally-static-disclosure-heading") === void 0);
-  const headingText = renderedHeadings.map((node) => labelText($(node).text()));
+  const headingText2 = renderedHeadings.map((node) => labelText($(node).text()));
   const existingCode = root.find("pre").toArray().map((node) => renderedCode($, node));
-  if (!headingText.length || !existingCode.length) return;
+  if (!headingText2.length || !existingCode.length) return;
   const prose = root.clone();
   prose.find("pre,button,script,style,nav,footer,aside").remove();
   const renderedProse = labelText(prose.text());
@@ -1285,7 +1311,7 @@ function recoverFlightArticleCode($, root) {
       const anchor = /\s+\[#([A-Za-z\d_.:-]+)\]$/.exec(text2);
       return anchor && $(renderedHeadings[index]).attr("id") === anchor[1] ? text2.slice(0, anchor.index) : text2;
     });
-    if (JSON.stringify(headings) !== JSON.stringify(headingText)) continue;
+    if (JSON.stringify(headings) !== JSON.stringify(headingText2)) continue;
     let proseCursor = 0;
     let hasMatchingProse = true;
     for (const paragraph of nodes.filter((node) => node.type === "paragraph" || node.type === "tableCell")) {
@@ -1902,6 +1928,7 @@ import { createHash as createHash2 } from "crypto";
 import { lookup } from "dns/promises";
 import { request } from "https";
 import { isIP } from "net";
+import { createGunzip } from "zlib";
 
 // src/spec-exclude.ts
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
@@ -1911,6 +1938,7 @@ var HOSTNAME_LABEL = "[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?";
 var HOSTNAME = new RegExp(`^${HOSTNAME_LABEL}(?:\\.${HOSTNAME_LABEL})*$`);
 
 // src/mdx.ts
+import { analyze } from "eslint-scope";
 import { posix } from "path";
 import { compileSync } from "@mdx-js/mdx";
 import { nameToEmoji } from "gemoji";
@@ -2398,6 +2426,14 @@ function parseFrontmatter(raw) {
   }
 }
 
+// src/source-styles.ts
+import postcss from "postcss";
+import selectorParser from "postcss-selector-parser";
+import ts2 from "typescript";
+var CONTENT_CONTAINER = ".thally-docs-prose";
+var SOURCE_PAGE_ATTRIBUTE = "data-thally-source-page";
+var SCOPE = `:where(${CONTENT_CONTAINER}, [${SOURCE_PAGE_ATTRIBUTE}])`;
+
 // src/fence-meta.ts
 import remarkParse2 from "remark-parse";
 import { unified as unified2 } from "unified";
@@ -2495,11 +2531,31 @@ function titleFromId(id) {
   return value.split(/[-_]/).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
 var descriptionParser = unified3().use(remarkParse3).use(remarkGfm2).use(remarkMdx2);
-function plainText(node) {
+function plainText(node, elements) {
+  if (elements && (node.type === "mdxJsxTextElement" || node.type === "mdxJsxFlowElement")) {
+    elements.found = true;
+    return "";
+  }
   if (node.type === "text" || node.type === "inlineCode") return node.value ?? "";
   if (node.type === "image") return node.alt ?? "";
   if (node.type === "break") return " ";
-  return (node.children ?? []).map(plainText).join("");
+  return (node.children ?? []).map((child) => plainText(child, elements)).join("");
+}
+function headingText(content, definitions, elements) {
+  const references = [...content.matchAll(/\[([^\]\n]+)\]/g)].map((match) => definitions?.get(match[1].trim().replace(/\s+/g, " ").toLowerCase()) ?? "").join("\n");
+  try {
+    return plainText(descriptionParser.parse(`# ${content}
+
+${references}`), elements).trim();
+  } catch {
+    return content;
+  }
+}
+function mdxTextWithoutInlineElements(content, definitions) {
+  if (!/<[A-Za-z]/.test(content)) return void 0;
+  const elements = { found: false };
+  const text2 = headingText(content, definitions, elements);
+  return elements.found && /[\p{L}\p{M}\p{N}]/u.test(text2) ? text2 : void 0;
 }
 function firstParagraph(content) {
   function findParagraph(node) {
@@ -2519,6 +2575,23 @@ function firstParagraph(content) {
     return "";
   }
 }
+var linkParser = unified3().use(remarkParse3);
+function withoutMarkdownLinks(text2) {
+  const links = [];
+  const collect = (node) => {
+    if (node.type === "link") {
+      const first = node.children?.[0]?.position?.start.offset;
+      const last = node.children?.at(-1)?.position?.end.offset;
+      const start = node.position?.start.offset;
+      const end = node.position?.end.offset;
+      if (start !== void 0 && end !== void 0) links.push({ start, end, textStart: first ?? start, textEnd: last ?? start });
+      return;
+    }
+    for (const child of node.children ?? []) collect(child);
+  };
+  collect(linkParser.parse(text2));
+  return links.reduceRight((result, link) => result.slice(0, link.start) + result.slice(link.textStart, link.textEnd) + result.slice(link.end), text2);
+}
 function docusaurusAdmonitionTag(kind) {
   if (kind === "danger") return "Error";
   if (kind === "info") return "Info";
@@ -2723,9 +2796,9 @@ ${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;
+var HEADING_ID_WORD = /[\p{L}\p{M}\p{N}_+&/@%=<>|\u2019\u201c\u201d\u2014\u2013\u2192\u2026]/u;
 function mintlifyHeadingSlug(text2) {
-  const chars = [...text2.replace(/[\u200b*]/g, "").normalize("NFC").trim().toLowerCase()];
+  const chars = [...text2.replace(/[\u200b*]/g, "").replace(/(?<=[\p{L}\p{M}\p{N}_])\(s\)(?![\p{L}\p{M}\p{N}_])/gu, "s").normalize("NFC").trim().toLowerCase()];
   const isWord = (char) => char !== void 0 && HEADING_ID_WORD.test(char);
   let id = "";
   let afterDash = false;
@@ -2737,11 +2810,11 @@ function mintlifyHeadingSlug(text2) {
     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)) {
+    } else if (/[\s-]/.test(char) || char === "." && (isWord(after) || 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 === '"') {
+    } else if (char === "{" || char === ":" || char === '"' || char === ",") {
       afterDash = false;
     }
   });
@@ -2751,17 +2824,77 @@ function thallyHeadingSlug(text2) {
   return text2.normalize("NFC").toLowerCase().replace(/[^\p{L}\p{M}\p{N}]+/gu, "-").replace(/(^-|-$)/g, "");
 }
 function typesetQuotes(text2) {
+  const opensClosed = text2.startsWith('"') && !text2.trimEnd().endsWith('"');
   return text2.split(/(`[^`]*`|<[^>]*>|\]\([^)]*\))/).map((part, index) => {
     if (index % 2) return part;
-    return part.replace(/(^|[\s([{\u2014\u2013])"/g, "$1\u201C").replace(/"/g, "\u201D").replace(/(^|[\s([{\u2014\u2013\u201c])'(?=\S)/g, "$1\u2018").replace(/'/g, "\u2019");
+    return part.replace(/(^|[\s([{\u2014\u2013])"/g, (match, before) => opensClosed && index === 0 && before === "" ? match : `${before}\u201C`).replace(/"/g, "\u201D").replace(/(^|[\s([{\u2014\u2013\u201c])'(?=\S)(?!&lt;|<)/g, "$1\u2018").replace(/'/g, "\u2019");
   }).join("");
 }
+function typesetEllipses(text2) {
+  return text2.split(/(`[^`]*`|<[^>]*>|\]\([^)]*\))/).map((part, index) => index % 2 ? part : part.replace(/\.{3}/g, "\u2026")).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");
+  const unlinked = !source.includes("`") ? source : source.replace(/(`[^`]*`)|!?\[((?:`[^`]*`|[^\]`])*)\]\([^)]*\)/g, (_match, code, text2 = "") => code ?? text2);
+  return unlinked.split(/(`[^`]*`)/).map((part, index) => index % 2 ? part.slice(1, -1) : part.replace(/\{\/\*[\s\S]*?\*\/\}/g, " ").replace(/!?\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/<\/?[A-Za-z][^>]*>/g, "").replace(/(?<!\\)(\*\*|__|~~|\*)/g, "").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/\\([\\`*_{}[\]()#+.!&<>|~-])/g, "$1")).join("");
+}
+function staticAttributeString(value) {
+  if (typeof value === "string") return value;
+  const expression = value?.value;
+  if (typeof expression !== "string") return void 0;
+  return expression.match(/^\s*(?:"([^"\\]*)"|'([^'\\]*)'|`((?:[^`\\$]|\$(?!\{))*)`)\s*$/)?.slice(1).find((part) => part !== void 0);
+}
+function pageIdClaims(body) {
+  let tree;
+  try {
+    tree = descriptionParser.parse(body);
+  } catch {
+    return { free: () => false };
+  }
+  const owners = /* @__PURE__ */ new Map();
+  const headingLines = /* @__PURE__ */ new Set();
+  let claims = 0;
+  const root = (id) => id.toLowerCase().replace(/-\d+$/, "");
+  const claim = (owner, ...ids) => {
+    for (const id of ids) {
+      const key = root(id);
+      const held = owners.get(key);
+      if (!key) continue;
+      if (!held) owners.set(key, { owner, shared: false });
+      else if (held.owner !== owner) held.shared = true;
+    }
+  };
+  const visit = (node) => {
+    const line = node.position?.start.line ?? 0;
+    if (node.type === "heading" && (node.depth ?? 0) >= 2) {
+      headingLines.add(line);
+      const text2 = typesetQuotes(plainText(node));
+      claim(`heading ${line}`, mintlifyHeadingSlug(text2), thallyHeadingSlug(text2), thallyHeadingSlug(plainText(node, { found: false })));
+      for (const child of node.children ?? []) {
+        const authored = child.type === "mdxTextExpression" ? child.value?.match(/^\s*\/\*\s*#(\S+?)\s*\*\/\s*$/)?.[1] : void 0;
+        if (authored) claim(`claim ${claims++}`, authored);
+      }
+    } else if (node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") {
+      for (const { type, name, value } of node.attributes ?? []) {
+        const text2 = type === "mdxJsxAttribute" ? staticAttributeString(value) : void 0;
+        if (text2 === void 0) continue;
+        if (name === "id") claim(`claim ${claims++}`, text2);
+        else if (name === "title") claim(`claim ${claims++}`, mintlifyHeadingSlug(text2), thallyHeadingSlug(text2));
+      }
+    }
+    for (const child of node.children ?? []) visit(child);
+  };
+  visit(tree);
+  return {
+    free: (id, line) => {
+      const held = owners.get(root(id));
+      return headingLines.has(line) && (!held || held.owner === `heading ${line}` && !held.shared);
+    }
+  };
 }
 function markMintlifyHeadings(body) {
   let fence;
-  return body.split("\n").map((line) => {
+  let claims;
+  return body.split("\n").map((line, index) => {
     const marker = line.match(/^ {0,3}(`{3,}|~{3,})/);
     if (marker) {
       if (!fence) fence = marker[1];
@@ -2775,8 +2908,13 @@ function markMintlifyHeadings(body) {
     const source = typesetQuotes(explicit ? explicit[1] : heading[2]);
     if (explicit) return `${heading[1]}${source}${explicit[2]}`;
     const text2 = plainHeadingText(source);
-    const id = mintlifyHeadingSlug(text2);
-    return `${heading[1]}${source}${id && id !== thallyHeadingSlug(text2) ? ` ${headingIdMarker(id)}` : ""}`;
+    const id = mintlifyHeadingSlug(plainHeadingText(typesetEllipses(source)));
+    let marked = id !== thallyHeadingSlug(text2);
+    if (id && !marked) {
+      const visible = mdxTextWithoutInlineElements(source);
+      if (visible !== void 0 && id !== thallyHeadingSlug(visible)) marked = (claims ??= pageIdClaims(body)).free(id, index + 1);
+    }
+    return `${heading[1]}${source}${id && marked ? ` ${headingIdMarker(id)}` : ""}`;
   }).join("\n");
 }
 var GLOBAL_DOCUSARUS_COMPONENTS = /* @__PURE__ */ new Set([
@@ -2792,6 +2930,7 @@ function removeGlobalDocusaurusImports(body) {
     (statement, component) => GLOBAL_DOCUSARUS_COMPONENTS.has(component) ? "" : statement
   ));
 }
+var PLAIN_TEXT = new RegExp("^\\p{L}(?:[\\p{L}\\p{N} ,.;'?%$=+-]*[\\p{L}\\p{N}.])?$", "u");
 function leadingPageHeading(body) {
   if (!/^ {0,3}(?:#(?:[ \t]|$)|=+[ \t\r]*$)/m.test(body)) return void 0;
   try {
@@ -2904,6 +3043,27 @@ function normalizeFernFileTrees(body) {
     }
   ));
 }
+function unwrapHtmlCommentInMdxComment(body) {
+  return replaceOutsideCode(body, (text2) => {
+    const opener = /\{\s*\/\*\s*<!--/g;
+    const closer = /\s*\*\/\s*\}/y;
+    let out = "";
+    let copied = 0;
+    let dash = -2;
+    let star = -2;
+    for (let found = opener.exec(text2); found; found = opener.exec(text2)) {
+      const inner = opener.lastIndex;
+      if (dash !== -1 && dash < inner) dash = text2.indexOf("-->", inner);
+      if (dash === -1) break;
+      if (star !== -1 && star < inner) star = text2.indexOf("*/", inner);
+      closer.lastIndex = dash + 3;
+      if (star !== -1 && star < dash || !closer.test(text2)) continue;
+      out += `${text2.slice(copied, found.index)}{/*${text2.slice(inner, dash)}*/}`;
+      copied = opener.lastIndex = closer.lastIndex;
+    }
+    return out + text2.slice(copied);
+  });
+}
 function normalizeFernCallouts(body) {
   return replaceOutsideCode(body, (whole) => {
     const openTags = [];
@@ -3468,6 +3628,7 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
     rewritten = rewritten.replace(/^\n{2,}/, "\n");
   }
   if (runMintlify) rewritten = normalizeMintlifyParameterAnchors(rewritten);
+  rewritten = unwrapHtmlCommentInMdxComment(rewritten);
   rewritten = replaceOutsideCode(rewritten, (segment) => {
     let result = convertHtmlStyleAttributes(segment).replace(/<!--([\s\S]*?)-->/g, (_match, content) => mdxComment(content)).replace(/<Danger(\s[^>]*)?>/g, "<Error$1>").replace(/<\/Danger>/g, "</Error>").replace(/<Warn(\s[^>]*)?>/g, "<Warning$1>").replace(/<\/Warn>/g, "</Warning>").replace(/<Tree\.Folder/g, "<Folder").replace(/<\/Tree\.Folder>/g, "</Folder>").replace(/<Tree\.File/g, "<File").replace(/<\/Tree\.File>/g, "</File>");
     if (runDocusaurus) {
@@ -3497,8 +3658,15 @@ function normalizeMdx(body, platform, unwrapMdxCodeBlocks = true) {
   }
   return normalizeFlowParagraphContainers(normalized);
 }
+var SITE_PATH_LINK = /^\/(?:[A-Za-z0-9._~-]+(?:\/[A-Za-z0-9._~-]+)*\/?)?(?:\?(?:[A-Za-z0-9._~=&-]|%[0-9A-Fa-f]{2})*)?(?:#[A-Za-z0-9._~-]+)?$/;
+var MAX_SITE_PATH_LINK_LENGTH = 2e3;
+function sitePathLink(url) {
+  if (url.length > MAX_SITE_PATH_LINK_LENGTH || url.includes("__ESC_") || !SITE_PATH_LINK.test(url)) return void 0;
+  return url.split(/[?#]/, 1)[0].split("/").some((segment) => segment === "." || segment === "..") ? void 0 : url;
+}
 function externalPageUrl(value) {
   const url = typeof value === "string" ? value.trim() : "";
+  if (url.startsWith("/")) return sitePathLink(url);
   if (!/^https?:\/\/[^\s]+$/i.test(url)) return void 0;
   try {
     new URL(url);
@@ -3546,7 +3714,9 @@ function parseMarkdownPage(input) {
   const body = removeUndefinedExpressions(injectReactHookImports(input.platform === "mintlify" ? normalizeMintlifyCodeFences(normalized, input.warn) : normalized), input.warn).trim();
   const keywords = Array.isArray(parsed.data.keywords) ? parsed.data.keywords.filter((value) => typeof value === "string") : [];
   const heading = leadingPageHeading(body);
-  const title = typeof parsed.data.title === "string" && parsed.data.title.trim() ? parsed.data.title.trim() : heading?.title ?? titleFromId(identity.navigationId);
+  const authoredTitle = typeof parsed.data.title === "string" && parsed.data.title.trim() ? parsed.data.title.trim() : heading?.title;
+  const title = authoredTitle ?? titleFromId(identity.navigationId);
+  const namesOperation = typeof parsed.data.openapi === "string" && Boolean(parsed.data.openapi.trim());
   const sidebarTitle = input.platform === "docusaurus" ? parsed.data.sidebar_label : parsed.data.sidebarTitle;
   const navTitle = typeof sidebarTitle === "string" && sidebarTitle.trim() ? sidebarTitle.trim() : typeof parsed.data.navTitle === "string" && parsed.data.navTitle.trim() ? parsed.data.navTitle.trim() : void 0;
   const icon = typeof parsed.data.icon === "string" && parsed.data.icon.trim() ? parsed.data.icon.trim() : void 0;
@@ -3559,18 +3729,25 @@ 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;
+  if (input.platform === "mintlify" && typeof parsed.data.url === "string" && parsed.data.url.trim().startsWith("/") && !externalPageUrl(parsed.data.url)) {
+    const shown = parsed.data.url.trim();
+    input.warn?.(`Page "${identity.id}": its "url" frontmatter ${JSON.stringify(shown.length > 80 ? `${shown.slice(0, 80)}...` : shown)} was not turned into a link, so the page was kept with its own content. Only a site path made of letters, digits and . _ ~ - segments, with an optional ?key=value query and #id fragment, can become a link.`);
+  }
   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 authoredDescription = typeof parsed.data.description === "string" && parsed.data.description.trim() ? parsed.data.description.trim() : void 0;
+  const description = authoredDescription ?? (namesOperation ? "" : firstParagraph(body));
   const page = {
     id: identity.id,
     navigationId: identity.navigationId,
     locale: identity.locale,
     title,
+    ...authoredTitle === void 0 && namesOperation ? { titleFromFileName: true } : {},
     navTitle,
     icon,
     iconType,
     description,
-    ...input.platform === "docusaurus" || input.platform === "fern" ? { descriptionPlacement: "body" } : {},
+    // A description taken from the body is the paragraph the body already shows, so it must not also appear under the title.
+    ...input.platform === "docusaurus" || input.platform === "fern" || authoredDescription === void 0 && description !== "" ? { descriptionPlacement: "body" } : {},
     badge,
     keywords,
     mode,
@@ -3585,6 +3762,12 @@ function parseMarkdownPage(input) {
     source: input.source,
     ...parsed.error ? { frontmatterError: parsed.error } : {}
   };
+  const writtenDescription = typeof parsed.data.description === "string" ? parsed.data.description.trim() : "";
+  const plainDescription2 = withoutMarkdownLinks(writtenDescription);
+  if (plainDescription2 !== writtenDescription) {
+    page.description = plainDescription2;
+    input.warn?.(`Page "${identity.id}": its description had links, which Thally shows as plain text; the link text was kept.`);
+  }
   resolvePageDisplayHeading(page, input.platform);
   return page;
 }
@@ -3738,32 +3921,6 @@ function projectCapturedTabs($, root) {
   }
 }
 
-// src/redirects.ts
-function trimTrailingSlashes(route) {
-  let end = route.length;
-  while (end > 0 && route[end - 1] === "/") end--;
-  return route.slice(0, end);
-}
-function exactRoute(route) {
-  return route.startsWith("/") && !/[?:*#()[\]{}]/.test(route) ? trimTrailingSlashes(route) || "/" : null;
-}
-function literalRoute(route) {
-  return exactRoute(route)?.toLowerCase() ?? null;
-}
-function resolveDotSegments(route) {
-  const segments = [];
-  for (const segment of route.split("/").slice(1)) {
-    const dots = segment.replace(/%2e/gi, ".");
-    if (dots === "..") segments.pop();
-    else if (dots !== ".") segments.push(segment);
-  }
-  return `/${segments.join("/")}`;
-}
-function destinationRoute(destination) {
-  const route = destination.startsWith("//") ? null : exactRoute(destination.split(/[?#]/, 1)[0]);
-  return route === null ? null : resolveDotSegments(route);
-}
-
 // src/url.ts
 var MAX_LOCAL_RESPONSE_BYTES = 8e6;
 var MAX_EMBEDDED_SCHEMA_BYTES = 2e6;
@@ -4822,6 +4979,8 @@ ${fence}
       navigationId: id,
       title,
       description: description || plainDescription(body) || `Documentation imported from ${document.finalUrl.hostname}.`,
+      // A description taken from the page text is already in the body; only one the site published is shown under the title.
+      ...description ? {} : { descriptionPlacement: "body" },
       keywords: [],
       body,
       source: document.finalUrl.toString()
@@ -6651,11 +6810,11 @@ function rewriteMarkdownDestinations(body, rewrite) {
 import { createHash as createHash6 } from "crypto";
 import { existsSync as existsSync2, lstatSync as lstatSync2, readFileSync as readFileSync2 } from "fs";
 import { basename, dirname as dirname2, extname as extname3, posix as posix2, relative as relative3, resolve as resolve3 } from "path";
-import postcss from "postcss";
-import selectorParser from "postcss-selector-parser";
+import postcss2 from "postcss";
+import selectorParser2 from "postcss-selector-parser";
 import remarkMdx5 from "remark-mdx";
 import remarkParse6 from "remark-parse";
-import ts2 from "typescript";
+import ts3 from "typescript";
 import { unified as unified6 } from "unified";
 var parser3 = unified6().use(remarkParse6).use(remarkMdx5);
 var DOCUSAURUS_THEME_SHIMS = {
@@ -6700,29 +6859,29 @@ function hash2(value) {
   return createHash6("sha256").update(value).digest("hex").slice(0, 12);
 }
 function sourceFile(source, filename) {
-  return ts2.createSourceFile(filename, source, ts2.ScriptTarget.Latest, true, scriptKindFor(filename));
+  return ts3.createSourceFile(filename, source, ts3.ScriptTarget.Latest, true, scriptKindFor(filename));
 }
 function mergeComponentRegistry(existing, incoming) {
   const fingerprint = hash2(incoming);
   const name = `MigratedRegistry${fingerprint}`;
   const registryPath = `./migrated-components-${fingerprint}`;
   const source = sourceFile(existing, "custom-components.tsx");
-  const alreadyImported = source.statements.some((statement) => ts2.isImportDeclaration(statement) && ts2.isStringLiteral(statement.moduleSpecifier) && statement.moduleSpecifier.text === registryPath);
+  const alreadyImported = source.statements.some((statement) => ts3.isImportDeclaration(statement) && ts3.isStringLiteral(statement.moduleSpecifier) && statement.moduleSpecifier.text === registryPath);
   let initializer;
   for (const statement of source.statements) {
-    if (!ts2.isVariableStatement(statement) || !statement.modifiers?.some((modifier) => modifier.kind === ts2.SyntaxKind.ExportKeyword)) continue;
+    if (!ts3.isVariableStatement(statement) || !statement.modifiers?.some((modifier) => modifier.kind === ts3.SyntaxKind.ExportKeyword)) continue;
     for (const declaration of statement.declarationList.declarations) {
-      if (ts2.isIdentifier(declaration.name) && declaration.name.text === "customComponents") initializer = declaration.initializer;
+      if (ts3.isIdentifier(declaration.name) && declaration.name.text === "customComponents") initializer = declaration.initializer;
     }
   }
-  while (initializer && (ts2.isAsExpression(initializer) || ts2.isSatisfiesExpression(initializer) || ts2.isParenthesizedExpression(initializer))) initializer = initializer.expression;
-  if (!initializer || !ts2.isObjectLiteralExpression(initializer)) {
+  while (initializer && (ts3.isAsExpression(initializer) || ts3.isSatisfiesExpression(initializer) || ts3.isParenthesizedExpression(initializer))) initializer = initializer.expression;
+  if (!initializer || !ts3.isObjectLiteralExpression(initializer)) {
     throw new Error("Cannot safely merge src/mdx/custom-components.tsx: export customComponents as an object literal before importing components. The existing registry was preserved.");
   }
   const content = alreadyImported ? existing : applyReplacements(existing, [
     {
-      start: source.statements.filter((statement) => ts2.isExpressionStatement(statement) && ts2.isStringLiteral(statement.expression)).at(-1)?.end ?? 0,
-      end: source.statements.filter((statement) => ts2.isExpressionStatement(statement) && ts2.isStringLiteral(statement.expression)).at(-1)?.end ?? 0,
+      start: source.statements.filter((statement) => ts3.isExpressionStatement(statement) && ts3.isStringLiteral(statement.expression)).at(-1)?.end ?? 0,
+      end: source.statements.filter((statement) => ts3.isExpressionStatement(statement) && ts3.isStringLiteral(statement.expression)).at(-1)?.end ?? 0,
       value: `
 import { customComponents as ${name} } from ${JSON.stringify(registryPath)}
 `