gt 2.14.35 → 2.14.36

package/dist/utils/localizeStaticUrls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localizeStaticUrls.js","names":["fs"],"sources":["../../src/utils/localizeStaticUrls.ts"],"sourcesContent":["import * as fs from 'fs';\nimport type { StaticLocalizationSettings } from '../types/index.js';\nimport { createFileMapping } from '../formats/files/fileMapping.js';\nimport micromatch from 'micromatch';\nimport { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkMdx from 'remark-mdx';\nimport remarkFrontmatter from 'remark-frontmatter';\nimport remarkStringify from 'remark-stringify';\nimport { visit } from 'unist-util-visit';\nimport type { Root, Link, Literal } from 'mdast';\nimport type { MdxJsxFlowElement, MdxJsxTextElement } from 'mdast-util-mdx-jsx';\nimport { escapeHtmlInTextNodes, normalizeCJKCharacters } from 'gt-remark';\n\nconst { isMatch } = micromatch;\n\nexport type StaticUrlSettings = StaticLocalizationSettings;\n\n/**\n * Localizes static urls in content files.\n * Currently only supported for md and mdx files. (/docs/ -> /[locale]/docs/)\n * @param settings - The settings object containing the project configuration.\n * @returns void\n *\n * @TODO This is an experimental feature, and only works in very specific cases. This needs to be improved before\n * it can be enabled by default.\n *\n * Before this becomes a non-experimental feature, we need to:\n * - Support more file types\n * - Support more complex paths\n */\nexport default async function localizeStaticUrls(\n  settings: StaticUrlSettings,\n  targetLocales?: string[],\n  includeFiles?: Set<string>\n) {\n  if (\n    !settings.files ||\n    (Object.keys(settings.files.placeholderPaths).length === 1 &&\n      settings.files.placeholderPaths.gt)\n  ) {\n    return;\n  }\n  const { resolvedPaths: sourceFiles } = settings.files;\n\n  // Use filtered locales if provided, otherwise use all locales\n  const locales = targetLocales || settings.locales;\n\n  const fileMapping = createFileMapping(\n    sourceFiles,\n    settings.files.placeholderPaths,\n    settings.files.transformPaths ?? {},\n    settings.files.transformFormats ?? {},\n    settings.locales, // Always use all locales for mapping, filter later\n    settings.defaultLocale\n  );\n\n  // Process all file types at once with a single call\n  const processPromises = [];\n\n  // First, process default locale files (from source files)\n  // This is needed because they might not be in the fileMapping if they're not being translated\n  // Only process default locale if it's in the target locales filter\n  if (\n    !fileMapping[settings.defaultLocale] &&\n    locales.includes(settings.defaultLocale) &&\n    !includeFiles // when filtering, skip default-locale pass\n  ) {\n    const defaultLocaleFiles: string[] = [];\n\n    // Collect all .md and .mdx files from sourceFiles\n    if (sourceFiles.md) {\n      defaultLocaleFiles.push(...sourceFiles.md);\n    }\n    if (sourceFiles.mdx) {\n      defaultLocaleFiles.push(...sourceFiles.mdx);\n    }\n\n    if (defaultLocaleFiles.length > 0) {\n      const defaultPromise = Promise.all(\n        defaultLocaleFiles.map(async (filePath: string) => {\n          // Check if file exists before processing\n          if (!fs.existsSync(filePath)) {\n            return;\n          }\n          // Get file content\n          const fileContent = await fs.promises.readFile(filePath, 'utf8');\n          // Localize the file using default locale\n          const result = localizeStaticUrlsForFile(\n            fileContent,\n            settings.defaultLocale,\n            settings.defaultLocale, // Process as default locale\n            settings.options?.experimentalHideDefaultLocale || false,\n            settings.options?.docsUrlPattern,\n            settings.options?.excludeStaticUrls,\n            settings.options?.baseDomain\n          );\n          // Only write the file if there were changes\n          if (result.hasChanges) {\n            await fs.promises.writeFile(filePath, result.content);\n          }\n        })\n      );\n      processPromises.push(defaultPromise);\n    }\n  }\n\n  // Then process all other locales from fileMapping\n  const mappingPromises = Object.entries(fileMapping)\n    .filter(([locale]) => locales.includes(locale)) // Filter by target locales\n    .map(async ([locale, filesMap]) => {\n      // Get all files that are md or mdx\n      const targetFiles = Object.values(filesMap).filter(\n        (p) =>\n          (p.endsWith('.md') || p.endsWith('.mdx')) &&\n          (!includeFiles || includeFiles.has(p))\n      );\n\n      // Replace the placeholder path with the target path\n      await Promise.all(\n        targetFiles.map(async (filePath) => {\n          // Check if file exists before processing\n          if (!fs.existsSync(filePath)) {\n            return;\n          }\n          // Get file content\n          const fileContent = await fs.promises.readFile(filePath, 'utf8');\n          // Localize the file (handles both URLs and hrefs in single AST pass)\n          const result = localizeStaticUrlsForFile(\n            fileContent,\n            settings.defaultLocale,\n            locale,\n            settings.options?.experimentalHideDefaultLocale || false,\n            settings.options?.docsUrlPattern,\n            settings.options?.excludeStaticUrls,\n            settings.options?.baseDomain\n          );\n          // Only write the file if there were changes\n          if (result.hasChanges) {\n            await fs.promises.writeFile(filePath, result.content);\n          }\n        })\n      );\n    });\n  processPromises.push(...mappingPromises);\n\n  await Promise.all(processPromises);\n}\n\ninterface UrlTransformResult {\n  content: string;\n  hasChanges: boolean;\n  transformedUrls: Array<{\n    originalPath: string;\n    newPath: string;\n    type: 'markdown' | 'href';\n  }>;\n}\n\n/**\n * Determines if a URL should be processed based on pattern matching\n */\nfunction shouldProcessUrl(\n  originalUrl: string,\n  patternHead: string,\n  targetLocale: string,\n  defaultLocale: string,\n  baseDomain?: string\n): boolean {\n  // Check fragment-only URLs like \"#id-name\"\n  if (/^\\s*#/.test(originalUrl)) {\n    return false;\n  }\n\n  const patternWithoutSlash = patternHead.replace(/\\/$/, '');\n\n  // Handle absolute URLs with baseDomain\n  let urlToCheck = originalUrl;\n  if (baseDomain && originalUrl.startsWith(baseDomain)) {\n    urlToCheck = originalUrl.substring(baseDomain.length);\n  }\n\n  if (targetLocale === defaultLocale) {\n    // For default locale processing, check if URL contains the pattern\n    return urlToCheck.includes(patternWithoutSlash);\n  } else {\n    // For non-default locales, check if URL starts with pattern\n    return urlToCheck.startsWith(patternWithoutSlash);\n  }\n}\n\n/**\n * Determines if a URL should be processed based on the base domain\n */\nfunction shouldProcessAbsoluteUrl(\n  originalUrl: string,\n  baseDomain: string\n): boolean {\n  return originalUrl.startsWith(baseDomain);\n}\n\n/**\n * Checks if a URL should be excluded based on exclusion patterns\n */\nfunction isUrlExcluded(\n  originalUrl: string,\n  exclude: string[],\n  defaultLocale: string\n): boolean {\n  const excludePatterns = exclude.map((p) =>\n    p.replace(/\\[locale\\]/g, defaultLocale)\n  );\n  return excludePatterns.some((pattern) => isMatch(originalUrl, pattern));\n}\n\n/**\n * Main URL transformation function that delegates to specific scenarios\n */\nexport function transformUrlPath(\n  originalUrl: string,\n  patternHead: string,\n  targetLocale: string,\n  defaultLocale: string,\n  hideDefaultLocale: boolean\n): string | null {\n  const originalPathArray = originalUrl\n    .split('/')\n    .filter((path) => path !== '');\n  const patternHeadArray = patternHead.split('/').filter((path) => path !== '');\n\n  // check if the pattern head matches the original path\n  if (!checkIfPathMatchesPattern(originalPathArray, patternHeadArray)) {\n    return null;\n  }\n\n  if (patternHeadArray.length > originalPathArray.length) {\n    return null; // Pattern is longer than the URL path\n  }\n\n  let result = null;\n  if (targetLocale === defaultLocale) {\n    if (hideDefaultLocale) {\n      // check if default locale is already present\n      if (originalPathArray?.[patternHeadArray.length] !== defaultLocale) {\n        return null;\n      }\n\n      // remove default locale\n      const newPathArray = [\n        ...originalPathArray.slice(0, patternHeadArray.length),\n        ...originalPathArray.slice(patternHeadArray.length + 1),\n      ];\n\n      result = newPathArray.join('/');\n    } else {\n      // check if default locale is already present\n      if (originalPathArray?.[patternHeadArray.length] === defaultLocale) {\n        return null;\n      }\n\n      // insert default locale\n      const newPathArray = [\n        ...originalPathArray.slice(0, patternHeadArray.length),\n        defaultLocale,\n        ...originalPathArray.slice(patternHeadArray.length),\n      ];\n\n      result = newPathArray.join('/');\n    }\n  } else if (hideDefaultLocale) {\n    // Avoid duplicating target locale if already present\n    if (originalPathArray?.[patternHeadArray.length] === targetLocale) {\n      return null;\n    }\n    const newPathArray = [\n      ...originalPathArray.slice(0, patternHeadArray.length),\n      targetLocale,\n      ...originalPathArray.slice(patternHeadArray.length),\n    ];\n\n    result = newPathArray.join('/');\n  } else {\n    // check default locale\n    if (originalPathArray?.[patternHeadArray.length] !== defaultLocale) {\n      return null;\n    }\n\n    // replace default locale with target locale\n    const newPathArray = [...originalPathArray];\n    newPathArray[patternHeadArray.length] = targetLocale;\n\n    result = newPathArray.join('/');\n  }\n\n  // check for leading and trailing slashes\n  if (originalUrl.startsWith('/')) {\n    result = '/' + result;\n  }\n  if (originalUrl.endsWith('/')) {\n    result = result + '/';\n  }\n\n  return result;\n}\n\n/**\n * AST-based transformation for MDX files using remark-mdx\n */\nfunction transformMdxUrls(\n  mdxContent: string,\n  defaultLocale: string,\n  targetLocale: string,\n  hideDefaultLocale: boolean,\n  pattern: string = '/[locale]',\n  exclude: string[] = [],\n  baseDomain?: string\n): UrlTransformResult {\n  const transformedUrls: Array<{\n    originalPath: string;\n    newPath: string;\n    type: 'markdown' | 'href';\n  }> = [];\n\n  if (!pattern.startsWith('/')) {\n    pattern = '/' + pattern;\n  }\n\n  const patternHead = pattern.split('[locale]')[0];\n\n  // Quick check: if the file doesn't contain the pattern, skip expensive AST parsing\n  // For default locale processing, we also need to check if content might need adjustment\n  if (targetLocale === defaultLocale) {\n    // For default locale files, we always need to check as we're looking for either:\n    // - paths without locale (when hideDefaultLocale=false)\n    // - paths with default locale (when hideDefaultLocale=true)\n    const patternWithoutSlash = patternHead.replace(/\\/$/, '');\n    if (!mdxContent.includes(patternWithoutSlash)) {\n      return {\n        content: mdxContent,\n        hasChanges: false,\n        transformedUrls: [],\n      };\n    }\n  } else {\n    // For non-default locales, use the original logic\n    if (!mdxContent.includes(patternHead.replace(/\\/$/, ''))) {\n      return {\n        content: mdxContent,\n        hasChanges: false,\n        transformedUrls: [],\n      };\n    }\n  }\n\n  // Parse the MDX content into an AST\n  let processedAst: Root;\n  try {\n    const parseProcessor = unified()\n      .use(remarkParse)\n      .use(remarkFrontmatter, ['yaml', 'toml'])\n      .use(remarkMdx);\n\n    const ast = parseProcessor.parse(mdxContent);\n    processedAst = parseProcessor.runSync(ast) as Root;\n  } catch {\n    return {\n      content: mdxContent,\n      hasChanges: false,\n      transformedUrls,\n    };\n  }\n\n  // Helper function to transform URL based on pattern\n  const transformUrl = (\n    originalUrl: string,\n    linkType: 'markdown' | 'href'\n  ): string | null => {\n    // For Markdown links [text](path), only process absolute-root paths starting with '/'\n    // Relative markdown links should remain relative to the current page and not be localized.\n    if (linkType === 'markdown') {\n      const isFragment = /^\\s*#/.test(originalUrl);\n      const isAbsoluteRoot = originalUrl.startsWith('/');\n      const looksAbsoluteWithDomain = baseDomain\n        ? shouldProcessAbsoluteUrl(originalUrl, baseDomain)\n        : false;\n      if (!isAbsoluteRoot && !looksAbsoluteWithDomain && !isFragment) {\n        return null;\n      }\n    }\n    // Check if URL should be processed\n    if (\n      !shouldProcessUrl(\n        originalUrl,\n        patternHead,\n        targetLocale,\n        defaultLocale,\n        baseDomain\n      )\n    ) {\n      return null;\n    }\n\n    // Skip absolute URLs (http://, https://, //, etc.)\n    if (baseDomain && shouldProcessAbsoluteUrl(originalUrl, baseDomain)) {\n      // Get everything after the base domain\n      const afterDomain = originalUrl.substring(baseDomain.length);\n\n      const transformedPath = transformUrlPath(\n        afterDomain,\n        patternHead,\n        targetLocale,\n        defaultLocale,\n        hideDefaultLocale\n      );\n      if (!transformedPath) {\n        return null;\n      }\n      transformedUrls.push({\n        originalPath: originalUrl,\n        newPath: transformedPath,\n        type: linkType,\n      });\n      return transformedPath ? baseDomain + transformedPath : null;\n    }\n\n    // Exclude colon-prefixed URLs (http://, https://, //, etc.)\n    if (originalUrl.split('?')[0].includes(':')) {\n      return null;\n    }\n\n    // Transform the URL based on locale and configuration\n    const newUrl = transformUrlPath(\n      originalUrl,\n      patternHead,\n      targetLocale,\n      defaultLocale,\n      hideDefaultLocale\n    );\n\n    if (!newUrl) {\n      return null;\n    }\n\n    // Check exclusions\n    if (isUrlExcluded(originalUrl, exclude, defaultLocale)) {\n      return null;\n    }\n\n    transformedUrls.push({\n      originalPath: originalUrl,\n      newPath: newUrl,\n      type: linkType,\n    });\n    return newUrl;\n  };\n\n  // Visit markdown link nodes: [text](url)\n  visit(processedAst, 'link', (node: Link) => {\n    if (node.url) {\n      const newUrl = transformUrl(node.url, 'markdown');\n      if (newUrl) {\n        node.url = newUrl;\n      }\n    }\n  });\n\n  // Visit JSX/HTML elements for href attributes: <a href=\"url\"> or <Card href=\"url\">\n  visit(processedAst, ['mdxJsxFlowElement', 'mdxJsxTextElement'], (node) => {\n    const jsxNode = node as MdxJsxFlowElement | MdxJsxTextElement;\n    if (jsxNode.attributes) {\n      for (const attr of jsxNode.attributes) {\n        if (\n          attr.type === 'mdxJsxAttribute' &&\n          attr.name === 'href' &&\n          attr.value\n        ) {\n          // Handle MdxJsxAttribute with string or MdxJsxAttributeValueExpression\n          const hrefValue =\n            typeof attr.value === 'string' ? attr.value : attr.value.value;\n          if (typeof hrefValue === 'string') {\n            const newUrl = transformUrl(hrefValue, 'href');\n            if (newUrl) {\n              if (typeof attr.value === 'string') {\n                attr.value = newUrl;\n              } else {\n                attr.value.value = newUrl;\n              }\n            }\n          }\n        }\n      }\n    }\n  });\n\n  // Visit raw JSX nodes for href attributes in JSX strings\n  visit(processedAst, 'jsx', (node: Literal) => {\n    if (node.value && typeof node.value === 'string') {\n      const jsxContent = node.value;\n\n      // Use regex to find href attributes in the JSX string\n      const hrefRegex = /href\\s*=\\s*[\"']([^\"']+)[\"']/g;\n      let match;\n      const replacements: Array<{\n        start: number;\n        end: number;\n        oldHrefAttr: string;\n        newHrefAttr: string;\n      }> = [];\n\n      // Reset regex lastIndex to avoid issues with global flag\n      hrefRegex.lastIndex = 0;\n\n      while ((match = hrefRegex.exec(jsxContent)) !== null) {\n        const originalHref = match[1];\n        const newUrl = transformUrl(originalHref, 'href');\n\n        if (newUrl) {\n          // Store replacement info\n          const oldHrefAttr = match[0]; // The full match like 'href=\"/quickstart\"'\n          const quote = oldHrefAttr.includes('\"') ? '\"' : \"'\";\n          const newHrefAttr = `href=${quote}${newUrl}${quote}`;\n\n          replacements.push({\n            start: match.index!,\n            end: match.index! + oldHrefAttr.length,\n            oldHrefAttr,\n            newHrefAttr,\n          });\n        }\n      }\n\n      // Apply replacements in reverse order (from end to start) to avoid position shifts\n      if (replacements.length > 0) {\n        let newJsxContent = jsxContent;\n        replacements\n          .sort((a, b) => b.start - a.start)\n          .forEach(({ start, end, newHrefAttr }) => {\n            newJsxContent =\n              newJsxContent.slice(0, start) +\n              newHrefAttr +\n              newJsxContent.slice(end);\n          });\n\n        node.value = newJsxContent;\n      }\n    }\n  });\n\n  // Convert the modified AST back to MDX string\n  let content: string;\n  try {\n    const stringifyProcessor = unified()\n      .use(remarkFrontmatter, ['yaml', 'toml'])\n      .use(remarkMdx)\n      .use(normalizeCJKCharacters)\n      .use(escapeHtmlInTextNodes)\n      .use(remarkStringify, {\n        handlers: {\n          // Handler to prevent escaping (avoids '&lt;' -> '\\&lt;')\n          text(node: Literal) {\n            return node.value;\n          },\n        },\n      });\n\n    const outTree = stringifyProcessor.runSync(processedAst) as Root;\n    content = stringifyProcessor.stringify(outTree);\n  } catch (error) {\n    console.warn(\n      `Failed to stringify MDX content: ${error instanceof Error ? error.message : String(error)}`\n    );\n    console.warn(\n      'Returning original content unchanged due to stringify error.'\n    );\n    return {\n      content: mdxContent,\n      hasChanges: false,\n      transformedUrls: [],\n    };\n  }\n\n  // Handle newline formatting to match original input\n  if (content.endsWith('\\n') && !mdxContent.endsWith('\\n')) {\n    content = content.slice(0, -1);\n  }\n\n  // Preserve leading newlines from original content\n  if (mdxContent.startsWith('\\n') && !content.startsWith('\\n')) {\n    content = '\\n' + content;\n  }\n\n  return {\n    content,\n    hasChanges: transformedUrls.length > 0,\n    transformedUrls,\n  };\n}\n\n// AST-based transformation for MDX files using remark\nfunction localizeStaticUrlsForFile(\n  file: string,\n  defaultLocale: string,\n  targetLocale: string,\n  hideDefaultLocale: boolean,\n  pattern: string = '/[locale]', // eg /docs/[locale] or /[locale]\n  exclude: string[] = [],\n  baseDomain?: string\n): UrlTransformResult {\n  // Use AST-based transformation for MDX files\n  return transformMdxUrls(\n    file,\n    defaultLocale,\n    targetLocale,\n    hideDefaultLocale,\n    pattern,\n    exclude,\n    baseDomain || ''\n  );\n}\n\nfunction checkIfPathMatchesPattern(\n  originalUrlArray: string[],\n  patternHeadArray: string[]\n): boolean {\n  // check if the pattern head matches the original path\n  for (let i = 0; i < patternHeadArray.length; i++) {\n    if (patternHeadArray[i] !== originalUrlArray?.[i]) {\n      return false;\n    }\n  }\n\n  return true;\n}\n"],"mappings":"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"}

package/dist/utils/mintlifyTitleFallback.js

@@ -1,80 +1,72 @@
-import path from 'path';
-import YAML from 'yaml';
+import path from "path";
+import YAML from "yaml";
+//#region src/utils/mintlifyTitleFallback.ts
 const FRONTMATTER_REGEX = /^---\s*\r?\n([\s\S]*?)\r?\n(---|\.\.\.)\s*(?:\r?\n|$)/;
 function toTitleCase(value) {
-    return value
-        .split(' ')
-        .map((word) => {
-        if (!word)
-            return '';
-        return word[0].toUpperCase() + word.slice(1);
-    })
-        .join(' ');
+	return value.split(" ").map((word) => {
+		if (!word) return "";
+		return word[0].toUpperCase() + word.slice(1);
+	}).join(" ");
 }
 function deriveTitleFromFilename(fileName, defaultLocale) {
-    const base = path.basename(fileName, path.extname(fileName));
-    if (base.toLowerCase() === 'index') {
-        const parentDir = path.dirname(fileName);
-        if (parentDir === '.' || parentDir === path.sep) {
-            return 'Index';
-        }
-        const parent = path.basename(parentDir);
-        if (parent && defaultLocale && parent === defaultLocale) {
-            return 'Index';
-        }
-        if (parent) {
-            return toTitleCase(parent.replace(/[-_]+/g, ' ').trim());
-        }
-        return 'Index';
-    }
-    const normalized = base.replace(/[-_]+/g, ' ').replace(/\s+/g, ' ').trim();
-    if (!normalized) {
-        return base;
-    }
-    return toTitleCase(normalized);
+	const base = path.basename(fileName, path.extname(fileName));
+	if (base.toLowerCase() === "index") {
+		const parentDir = path.dirname(fileName);
+		if (parentDir === "." || parentDir === path.sep) return "Index";
+		const parent = path.basename(parentDir);
+		if (parent && defaultLocale && parent === defaultLocale) return "Index";
+		if (parent) return toTitleCase(parent.replace(/[-_]+/g, " ").trim());
+		return "Index";
+	}
+	const normalized = base.replace(/[-_]+/g, " ").replace(/\s+/g, " ").trim();
+	if (!normalized) return base;
+	return toTitleCase(normalized);
 }
 function hasMeaningfulTitle(value) {
-    if (value === null || value === undefined) {
-        return false;
-    }
-    if (typeof value === 'string') {
-        return value.trim().length > 0;
-    }
-    return true;
+	if (value === null || value === void 0) return false;
+	if (typeof value === "string") return value.trim().length > 0;
+	return true;
 }
-export function applyMintlifyTitleFallback(content, fileName, defaultLocale) {
-    const inferredTitle = deriveTitleFromFilename(fileName, defaultLocale);
-    if (!inferredTitle) {
-        return { content, addedTitle: false };
-    }
-    const hasBom = content.startsWith('\uFEFF');
-    const contentBody = hasBom ? content.slice(1) : content;
-    const newline = contentBody.includes('\r\n') ? '\r\n' : '\n';
-    const frontmatterMatch = contentBody.match(FRONTMATTER_REGEX);
-    if (frontmatterMatch) {
-        const frontmatterContent = frontmatterMatch[1];
-        let parsed;
-        try {
-            parsed = YAML.parse(frontmatterContent);
-        }
-        catch {
-            return { content, addedTitle: false };
-        }
-        if (parsed && hasMeaningfulTitle(parsed.title)) {
-            return { content, addedTitle: false };
-        }
-        const titleLine = YAML.stringify({ title: inferredTitle }).trimEnd();
-        const headerEndIndex = contentBody.indexOf(newline) + newline.length;
-        const updated = contentBody.slice(0, headerEndIndex) +
-            titleLine +
-            newline +
-            contentBody.slice(headerEndIndex);
-        return { content: (hasBom ? '\uFEFF' : '') + updated, addedTitle: true };
-    }
-    const titleLine = YAML.stringify({ title: inferredTitle }).trimEnd();
-    const frontmatterBlock = `---${newline}${titleLine}${newline}---${newline}${newline}`;
-    return {
-        content: (hasBom ? '\uFEFF' : '') + frontmatterBlock + contentBody,
-        addedTitle: true,
-    };
+function applyMintlifyTitleFallback(content, fileName, defaultLocale) {
+	const inferredTitle = deriveTitleFromFilename(fileName, defaultLocale);
+	if (!inferredTitle) return {
+		content,
+		addedTitle: false
+	};
+	const hasBom = content.startsWith("");
+	const contentBody = hasBom ? content.slice(1) : content;
+	const newline = contentBody.includes("\r\n") ? "\r\n" : "\n";
+	const frontmatterMatch = contentBody.match(FRONTMATTER_REGEX);
+	if (frontmatterMatch) {
+		const frontmatterContent = frontmatterMatch[1];
+		let parsed;
+		try {
+			parsed = YAML.parse(frontmatterContent);
+		} catch {
+			return {
+				content,
+				addedTitle: false
+			};
+		}
+		if (parsed && hasMeaningfulTitle(parsed.title)) return {
+			content,
+			addedTitle: false
+		};
+		const titleLine = YAML.stringify({ title: inferredTitle }).trimEnd();
+		const headerEndIndex = contentBody.indexOf(newline) + newline.length;
+		const updated = contentBody.slice(0, headerEndIndex) + titleLine + newline + contentBody.slice(headerEndIndex);
+		return {
+			content: (hasBom ? "" : "") + updated,
+			addedTitle: true
+		};
+	}
+	const frontmatterBlock = `---${newline}${YAML.stringify({ title: inferredTitle }).trimEnd()}${newline}---${newline}${newline}`;
+	return {
+		content: (hasBom ? "" : "") + frontmatterBlock + contentBody,
+		addedTitle: true
+	};
 }
+//#endregion
+export { applyMintlifyTitleFallback };
+
+//# sourceMappingURL=mintlifyTitleFallback.js.map

package/dist/utils/mintlifyTitleFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mintlifyTitleFallback.js","names":[],"sources":["../../src/utils/mintlifyTitleFallback.ts"],"sourcesContent":["import path from 'path';\nimport YAML from 'yaml';\n\ntype TitleFallbackResult = {\n  content: string;\n  addedTitle: boolean;\n};\n\nconst FRONTMATTER_REGEX =\n  /^---\\s*\\r?\\n([\\s\\S]*?)\\r?\\n(---|\\.\\.\\.)\\s*(?:\\r?\\n|$)/;\n\nfunction toTitleCase(value: string): string {\n  return value\n    .split(' ')\n    .map((word) => {\n      if (!word) return '';\n      return word[0].toUpperCase() + word.slice(1);\n    })\n    .join(' ');\n}\n\nfunction deriveTitleFromFilename(\n  fileName: string,\n  defaultLocale?: string\n): string {\n  const base = path.basename(fileName, path.extname(fileName));\n  if (base.toLowerCase() === 'index') {\n    const parentDir = path.dirname(fileName);\n    if (parentDir === '.' || parentDir === path.sep) {\n      return 'Index';\n    }\n    const parent = path.basename(parentDir);\n    if (parent && defaultLocale && parent === defaultLocale) {\n      return 'Index';\n    }\n    if (parent) {\n      return toTitleCase(parent.replace(/[-_]+/g, ' ').trim());\n    }\n    return 'Index';\n  }\n  const normalized = base.replace(/[-_]+/g, ' ').replace(/\\s+/g, ' ').trim();\n  if (!normalized) {\n    return base;\n  }\n  return toTitleCase(normalized);\n}\n\nfunction hasMeaningfulTitle(value: unknown): boolean {\n  if (value === null || value === undefined) {\n    return false;\n  }\n  if (typeof value === 'string') {\n    return value.trim().length > 0;\n  }\n  return true;\n}\n\nexport function applyMintlifyTitleFallback(\n  content: string,\n  fileName: string,\n  defaultLocale?: string\n): TitleFallbackResult {\n  const inferredTitle = deriveTitleFromFilename(fileName, defaultLocale);\n  if (!inferredTitle) {\n    return { content, addedTitle: false };\n  }\n\n  const hasBom = content.startsWith('\\uFEFF');\n  const contentBody = hasBom ? content.slice(1) : content;\n  const newline = contentBody.includes('\\r\\n') ? '\\r\\n' : '\\n';\n\n  const frontmatterMatch = contentBody.match(FRONTMATTER_REGEX);\n  if (frontmatterMatch) {\n    const frontmatterContent = frontmatterMatch[1];\n    let parsed: Record<string, unknown> | undefined;\n    try {\n      parsed = YAML.parse(frontmatterContent);\n    } catch {\n      return { content, addedTitle: false };\n    }\n\n    if (parsed && hasMeaningfulTitle(parsed.title)) {\n      return { content, addedTitle: false };\n    }\n\n    const titleLine = YAML.stringify({ title: inferredTitle }).trimEnd();\n    const headerEndIndex = contentBody.indexOf(newline) + newline.length;\n    const updated =\n      contentBody.slice(0, headerEndIndex) +\n      titleLine +\n      newline +\n      contentBody.slice(headerEndIndex);\n\n    return { content: (hasBom ? '\\uFEFF' : '') + updated, addedTitle: true };\n  }\n\n  const titleLine = YAML.stringify({ title: inferredTitle }).trimEnd();\n  const frontmatterBlock = `---${newline}${titleLine}${newline}---${newline}${newline}`;\n  return {\n    content: (hasBom ? '\\uFEFF' : '') + frontmatterBlock + contentBody,\n    addedTitle: true,\n  };\n}\n"],"mappings":";;;AAQA,MAAM,oBACJ;AAEF,SAAS,YAAY,OAAuB;AAC1C,QAAO,MACJ,MAAM,IAAI,CACV,KAAK,SAAS;AACb,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,KAAK,GAAG,aAAa,GAAG,KAAK,MAAM,EAAE;GAC5C,CACD,KAAK,IAAI;;AAGd,SAAS,wBACP,UACA,eACQ;CACR,MAAM,OAAO,KAAK,SAAS,UAAU,KAAK,QAAQ,SAAS,CAAC;AAC5D,KAAI,KAAK,aAAa,KAAK,SAAS;EAClC,MAAM,YAAY,KAAK,QAAQ,SAAS;AACxC,MAAI,cAAc,OAAO,cAAc,KAAK,IAC1C,QAAO;EAET,MAAM,SAAS,KAAK,SAAS,UAAU;AACvC,MAAI,UAAU,iBAAiB,WAAW,cACxC,QAAO;AAET,MAAI,OACF,QAAO,YAAY,OAAO,QAAQ,UAAU,IAAI,CAAC,MAAM,CAAC;AAE1D,SAAO;;CAET,MAAM,aAAa,KAAK,QAAQ,UAAU,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,MAAM;AAC1E,KAAI,CAAC,WACH,QAAO;AAET,QAAO,YAAY,WAAW;;AAGhC,SAAS,mBAAmB,OAAyB;AACnD,KAAI,UAAU,QAAQ,UAAU,KAAA,EAC9B,QAAO;AAET,KAAI,OAAO,UAAU,SACnB,QAAO,MAAM,MAAM,CAAC,SAAS;AAE/B,QAAO;;AAGT,SAAgB,2BACd,SACA,UACA,eACqB;CACrB,MAAM,gBAAgB,wBAAwB,UAAU,cAAc;AACtE,KAAI,CAAC,cACH,QAAO;EAAE;EAAS,YAAY;EAAO;CAGvC,MAAM,SAAS,QAAQ,WAAW,IAAS;CAC3C,MAAM,cAAc,SAAS,QAAQ,MAAM,EAAE,GAAG;CAChD,MAAM,UAAU,YAAY,SAAS,OAAO,GAAG,SAAS;CAExD,MAAM,mBAAmB,YAAY,MAAM,kBAAkB;AAC7D,KAAI,kBAAkB;EACpB,MAAM,qBAAqB,iBAAiB;EAC5C,IAAI;AACJ,MAAI;AACF,YAAS,KAAK,MAAM,mBAAmB;UACjC;AACN,UAAO;IAAE;IAAS,YAAY;IAAO;;AAGvC,MAAI,UAAU,mBAAmB,OAAO,MAAM,CAC5C,QAAO;GAAE;GAAS,YAAY;GAAO;EAGvC,MAAM,YAAY,KAAK,UAAU,EAAE,OAAO,eAAe,CAAC,CAAC,SAAS;EACpE,MAAM,iBAAiB,YAAY,QAAQ,QAAQ,GAAG,QAAQ;EAC9D,MAAM,UACJ,YAAY,MAAM,GAAG,eAAe,GACpC,YACA,UACA,YAAY,MAAM,eAAe;AAEnC,SAAO;GAAE,UAAU,SAAS,MAAW,MAAM;GAAS,YAAY;GAAM;;CAI1E,MAAM,mBAAmB,MAAM,UADb,KAAK,UAAU,EAAE,OAAO,eAAe,CAAC,CAAC,SACT,GAAG,QAAQ,KAAK,UAAU;AAC5E,QAAO;EACL,UAAU,SAAS,MAAW,MAAM,mBAAmB;EACvD,YAAY;EACb"}