gt 2.20.3 → 2.20.4

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # gtx-cli
 
+## 2.20.4
+
+### Patch Changes
+
+- [#2262](https://github.com/generaltranslation/gt/pull/2262) [`c2c9048`](https://github.com/generaltranslation/gt/commit/c2c9048ffbe98b7aa77b0dee034e5e324bbb6395) Thanks [@fernando-aviles](https://github.com/fernando-aviles)! - fix(cli): with `experimentalAddHeaderAnchorIds: 'mintlify'`, write Mintlify's native `{#id}` on every translated heading, using the source heading's ID so anchors match across locales and the heading hover link points at the same target. Mintlify only reads `{#id}` on headings indented up to three spaces, and the MDX serializer indents JSX children two spaces per level, so headings nested in JSX are moved back to the margin. Default mode is unchanged.
+
 ## 2.20.3
 
 ### Patch Changes

package/dist/cli/commands/translate.js.map

@@ -1 +1 @@
-{"version":3,"file":"translate.js","names":[],"sources":["../../../src/cli/commands/translate.ts"],"sourcesContent":["import { EnqueueFilesResult } from 'generaltranslation/types';\nimport { TranslateFlags } from '../../types/index.js';\nimport { Settings } from '../../types/index.js';\nimport {\n  FileTranslationData,\n  runDownloadWorkflow,\n} from '../../workflows/download.js';\nimport { createFileMapping } from '../../formats/files/fileMapping.js';\nimport copyFile from '../../fs/copyFile.js';\nimport flattenJsonFiles from '../../utils/flattenJsonFiles.js';\nimport localizeStaticUrls from '../../utils/localizeStaticUrls.js';\nimport localizeRelativeAssets from '../../utils/localizeRelativeAssets.js';\nimport processAnchorIds from '../../utils/processAnchorIds.js';\nimport localizeStaticImports from '../../utils/localizeStaticImports.js';\nimport { postprocessMintlify } from '../../formats/files/postprocess/mintlify.js';\nimport { BranchData } from '../../types/branch.js';\nimport { getDownloadedMeta } from '../../state/recentDownloads.js';\nimport { persistPostProcessHashes } from '../../utils/persistPostprocessHashes.js';\nimport { runPublishWorkflow } from '../../workflows/publish.js';\nimport { SUPPORTED_FILE_EXTENSIONS } from '../../formats/files/supportedFiles.js';\nimport { hasNonIdentityFileFormatTransformForType } from '../../formats/files/transformFormat.js';\nimport { getRelative } from '../../fs/findFilepath.js';\nimport type { InlineLibrary } from '../../types/libraries.js';\n\n// Downloads translations that were completed\nexport async function handleTranslate(\n  options: TranslateFlags,\n  settings: Settings,\n  fileVersionData: FileTranslationData | undefined,\n  jobData: EnqueueFilesResult | undefined,\n  branchData: BranchData | undefined,\n  publishMap?: Map<string, boolean>,\n  inlineLibrary?: InlineLibrary\n) {\n  if (fileVersionData) {\n    const {\n      resolvedPaths,\n      placeholderPaths,\n      transformPaths,\n      transformFormats,\n    } = settings.files;\n\n    const fileMapping = createFileMapping(\n      resolvedPaths,\n      placeholderPaths,\n      transformPaths,\n      transformFormats,\n      settings.locales,\n      settings.defaultLocale\n    );\n    // Check for remaining translations\n    await runDownloadWorkflow({\n      fileVersionData: fileVersionData,\n      jobData: jobData,\n      branchData: branchData,\n      locales: settings.locales,\n      timeoutDuration: options.timeout,\n      resolveOutputPath: (sourcePath, locale) =>\n        fileMapping[locale]?.[sourcePath] ?? null,\n      options: settings,\n      inlineLibrary,\n      forceRetranslation: options.force,\n      forceDownload: options.forceDownload || options.force, // if force is true should also force download\n    });\n\n    // Publish/unpublish files after translations are downloaded\n    if (publishMap && branchData?.currentBranch.id) {\n      const files = Object.entries(fileVersionData).map(([fileId, data]) => ({\n        fileId,\n        versionId: data.versionId,\n        fileName: data.fileName,\n      }));\n      await runPublishWorkflow(\n        files,\n        publishMap,\n        branchData.currentBranch.id,\n        settings\n      );\n    }\n  }\n}\n\nexport async function postProcessTranslations(\n  settings: Settings,\n  includeFiles?: Set<string>\n) {\n  const postProcessIncludes = filterPostProcessIncludesForFormatTransforms(\n    settings,\n    includeFiles\n  );\n  if (includeFiles && postProcessIncludes?.size === 0) return;\n\n  await postprocessMintlify(settings, postProcessIncludes);\n\n  // Localize static urls (/docs -> /[locale]/docs) and preserve anchor IDs for non-default locales\n  // Default locale is processed earlier in the flow in base.ts\n  if (settings.options?.experimentalLocalizeStaticUrls) {\n    const nonDefaultLocales = settings.locales.filter(\n      (locale) => locale !== settings.defaultLocale\n    );\n    if (nonDefaultLocales.length > 0) {\n      await localizeStaticUrls(\n        settings,\n        nonDefaultLocales,\n        postProcessIncludes\n      );\n    }\n  }\n\n  // Rewrite relative asset URLs in translated md/mdx files\n  if (settings.options?.experimentalLocalizeRelativeAssets) {\n    const nonDefaultLocales = settings.locales.filter(\n      (locale) => locale !== settings.defaultLocale\n    );\n    if (nonDefaultLocales.length > 0) {\n      await localizeRelativeAssets(\n        settings,\n        nonDefaultLocales,\n        postProcessIncludes\n      );\n    }\n  }\n\n  // Localize static imports (import Snippet from /snippets/file.mdx -> import Snippet from /snippets/[locale]/file.mdx)\n  if (settings.options?.experimentalLocalizeStaticImports) {\n    await localizeStaticImports(settings, postProcessIncludes);\n  }\n\n  const shouldProcessAnchorIds =\n    settings.options?.experimentalLocalizeStaticUrls ||\n    settings.options?.experimentalAddHeaderAnchorIds;\n\n  // Add explicit anchor IDs to translated MDX/MD files to preserve navigation.\n  // Uses inline {#id} format by default, or div wrapping if experimentalAddHeaderAnchorIds is 'mintlify'.\n  //\n  // Runs last of the md/mdx passes: the others re-stringify the document, which\n  // re-indents headings nested in JSX and would otherwise move them out from\n  // under the anchors placed here.\n  if (shouldProcessAnchorIds) {\n    await processAnchorIds(settings, postProcessIncludes);\n  }\n\n  // Flatten json files into a single file\n  if (settings.options?.experimentalFlattenJsonFiles) {\n    await flattenJsonFiles(settings, postProcessIncludes);\n  }\n\n  // Copy files to the target locale\n  if (settings.options?.copyFiles) {\n    await copyFile(settings);\n  }\n\n  // Record postprocessed content hashes for newly downloaded files\n  persistPostProcessHashes(settings, postProcessIncludes, getDownloadedMeta());\n}\n\n/**\n * Exclude only outputs whose source file was translated into a different format.\n * @param settings - The settings for the project\n * @param includeFiles - The files to include in the post-processing\n * @returns The files to exclude in the post-processing\n */\nfunction filterPostProcessIncludesForFormatTransforms(\n  settings: Settings,\n  includeFiles?: Set<string>\n): Set<string> | undefined {\n  if (!includeFiles) return includeFiles;\n\n  const transformedSourcePaths = new Set<string>();\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    if (!hasNonIdentityFileFormatTransformForType(settings, fileType)) continue;\n\n    for (const sourcePath of settings.files.resolvedPaths[fileType] || []) {\n      transformedSourcePaths.add(getRelative(sourcePath));\n    }\n  }\n  if (transformedSourcePaths.size === 0) return includeFiles;\n\n  const { resolvedPaths, placeholderPaths, transformPaths, transformFormats } =\n    settings.files;\n  const fileMapping = createFileMapping(\n    resolvedPaths,\n    placeholderPaths,\n    transformPaths,\n    transformFormats,\n    settings.locales,\n    settings.defaultLocale\n  );\n\n  const transformedOutputPaths = new Set<string>();\n  for (const localeMapping of Object.values(fileMapping)) {\n    for (const [sourcePath, outputPath] of Object.entries(localeMapping)) {\n      if (transformedSourcePaths.has(sourcePath)) {\n        transformedOutputPaths.add(outputPath);\n      }\n    }\n  }\n\n  return new Set(\n    [...includeFiles].filter(\n      (filePath) => !transformedOutputPaths.has(filePath)\n    )\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAyBA,eAAsB,gBACpB,SACA,UACA,iBACA,SACA,YACA,YACA,eACA;AACA,KAAI,iBAAiB;EACnB,MAAM,EACJ,eACA,kBACA,gBACA,qBACE,SAAS;EAEb,MAAM,cAAc,kBAClB,eACA,kBACA,gBACA,kBACA,SAAS,SACT,SAAS,cACV;AAED,QAAM,oBAAoB;GACP;GACR;GACG;GACZ,SAAS,SAAS;GAClB,iBAAiB,QAAQ;GACzB,oBAAoB,YAAY,WAC9B,YAAY,UAAU,eAAe;GACvC,SAAS;GACT;GACA,oBAAoB,QAAQ;GAC5B,eAAe,QAAQ,iBAAiB,QAAQ;GACjD,CAAC;AAGF,MAAI,cAAc,YAAY,cAAc,GAM1C,OAAM,mBALQ,OAAO,QAAQ,gBAAgB,CAAC,KAAK,CAAC,QAAQ,WAAW;GACrE;GACA,WAAW,KAAK;GAChB,UAAU,KAAK;GAChB,EAEM,EACL,YACA,WAAW,cAAc,IACzB,SACD;;;AAKP,eAAsB,wBACpB,UACA,cACA;CACA,MAAM,sBAAsB,6CAC1B,UACA,aACD;AACD,KAAI,gBAAgB,qBAAqB,SAAS,EAAG;AAErD,OAAM,oBAAoB,UAAU,oBAAoB;AAIxD,KAAI,SAAS,SAAS,gCAAgC;EACpD,MAAM,oBAAoB,SAAS,QAAQ,QACxC,WAAW,WAAW,SAAS,cACjC;AACD,MAAI,kBAAkB,SAAS,EAC7B,OAAM,mBACJ,UACA,mBACA,oBACD;;AAKL,KAAI,SAAS,SAAS,oCAAoC;EACxD,MAAM,oBAAoB,SAAS,QAAQ,QACxC,WAAW,WAAW,SAAS,cACjC;AACD,MAAI,kBAAkB,SAAS,EAC7B,OAAM,uBACJ,UACA,mBACA,oBACD;;AAKL,KAAI,SAAS,SAAS,kCACpB,OAAM,sBAAsB,UAAU,oBAAoB;AAa5D,KATE,SAAS,SAAS,kCAClB,SAAS,SAAS,+BASlB,OAAM,iBAAiB,UAAU,oBAAoB;AAIvD,KAAI,SAAS,SAAS,6BACpB,OAAM,iBAAiB,UAAU,oBAAoB;AAIvD,KAAI,SAAS,SAAS,UACpB,OAAM,SAAS,SAAS;AAI1B,0BAAyB,UAAU,qBAAqB,mBAAmB,CAAC;;;;;;;;AAS9E,SAAS,6CACP,UACA,cACyB;AACzB,KAAI,CAAC,aAAc,QAAO;CAE1B,MAAM,yCAAyB,IAAI,KAAa;AAChD,MAAK,MAAM,YAAY,2BAA2B;AAChD,MAAI,CAAC,yCAAyC,UAAU,SAAS,CAAE;AAEnE,OAAK,MAAM,cAAc,SAAS,MAAM,cAAc,aAAa,EAAE,CACnE,wBAAuB,IAAI,YAAY,WAAW,CAAC;;AAGvD,KAAI,uBAAuB,SAAS,EAAG,QAAO;CAE9C,MAAM,EAAE,eAAe,kBAAkB,gBAAgB,qBACvD,SAAS;CACX,MAAM,cAAc,kBAClB,eACA,kBACA,gBACA,kBACA,SAAS,SACT,SAAS,cACV;CAED,MAAM,yCAAyB,IAAI,KAAa;AAChD,MAAK,MAAM,iBAAiB,OAAO,OAAO,YAAY,CACpD,MAAK,MAAM,CAAC,YAAY,eAAe,OAAO,QAAQ,cAAc,CAClE,KAAI,uBAAuB,IAAI,WAAW,CACxC,wBAAuB,IAAI,WAAW;AAK5C,QAAO,IAAI,IACT,CAAC,GAAG,aAAa,CAAC,QACf,aAAa,CAAC,uBAAuB,IAAI,SAAS,CACpD,CACF"}
+{"version":3,"file":"translate.js","names":[],"sources":["../../../src/cli/commands/translate.ts"],"sourcesContent":["import { EnqueueFilesResult } from 'generaltranslation/types';\nimport { TranslateFlags } from '../../types/index.js';\nimport { Settings } from '../../types/index.js';\nimport {\n  FileTranslationData,\n  runDownloadWorkflow,\n} from '../../workflows/download.js';\nimport { createFileMapping } from '../../formats/files/fileMapping.js';\nimport copyFile from '../../fs/copyFile.js';\nimport flattenJsonFiles from '../../utils/flattenJsonFiles.js';\nimport localizeStaticUrls from '../../utils/localizeStaticUrls.js';\nimport localizeRelativeAssets from '../../utils/localizeRelativeAssets.js';\nimport processAnchorIds from '../../utils/processAnchorIds.js';\nimport localizeStaticImports from '../../utils/localizeStaticImports.js';\nimport { postprocessMintlify } from '../../formats/files/postprocess/mintlify.js';\nimport { BranchData } from '../../types/branch.js';\nimport { getDownloadedMeta } from '../../state/recentDownloads.js';\nimport { persistPostProcessHashes } from '../../utils/persistPostprocessHashes.js';\nimport { runPublishWorkflow } from '../../workflows/publish.js';\nimport { SUPPORTED_FILE_EXTENSIONS } from '../../formats/files/supportedFiles.js';\nimport { hasNonIdentityFileFormatTransformForType } from '../../formats/files/transformFormat.js';\nimport { getRelative } from '../../fs/findFilepath.js';\nimport type { InlineLibrary } from '../../types/libraries.js';\n\n// Downloads translations that were completed\nexport async function handleTranslate(\n  options: TranslateFlags,\n  settings: Settings,\n  fileVersionData: FileTranslationData | undefined,\n  jobData: EnqueueFilesResult | undefined,\n  branchData: BranchData | undefined,\n  publishMap?: Map<string, boolean>,\n  inlineLibrary?: InlineLibrary\n) {\n  if (fileVersionData) {\n    const {\n      resolvedPaths,\n      placeholderPaths,\n      transformPaths,\n      transformFormats,\n    } = settings.files;\n\n    const fileMapping = createFileMapping(\n      resolvedPaths,\n      placeholderPaths,\n      transformPaths,\n      transformFormats,\n      settings.locales,\n      settings.defaultLocale\n    );\n    // Check for remaining translations\n    await runDownloadWorkflow({\n      fileVersionData: fileVersionData,\n      jobData: jobData,\n      branchData: branchData,\n      locales: settings.locales,\n      timeoutDuration: options.timeout,\n      resolveOutputPath: (sourcePath, locale) =>\n        fileMapping[locale]?.[sourcePath] ?? null,\n      options: settings,\n      inlineLibrary,\n      forceRetranslation: options.force,\n      forceDownload: options.forceDownload || options.force, // if force is true should also force download\n    });\n\n    // Publish/unpublish files after translations are downloaded\n    if (publishMap && branchData?.currentBranch.id) {\n      const files = Object.entries(fileVersionData).map(([fileId, data]) => ({\n        fileId,\n        versionId: data.versionId,\n        fileName: data.fileName,\n      }));\n      await runPublishWorkflow(\n        files,\n        publishMap,\n        branchData.currentBranch.id,\n        settings\n      );\n    }\n  }\n}\n\nexport async function postProcessTranslations(\n  settings: Settings,\n  includeFiles?: Set<string>\n) {\n  const postProcessIncludes = filterPostProcessIncludesForFormatTransforms(\n    settings,\n    includeFiles\n  );\n  if (includeFiles && postProcessIncludes?.size === 0) return;\n\n  await postprocessMintlify(settings, postProcessIncludes);\n\n  // Localize static urls (/docs -> /[locale]/docs) and preserve anchor IDs for non-default locales\n  // Default locale is processed earlier in the flow in base.ts\n  if (settings.options?.experimentalLocalizeStaticUrls) {\n    const nonDefaultLocales = settings.locales.filter(\n      (locale) => locale !== settings.defaultLocale\n    );\n    if (nonDefaultLocales.length > 0) {\n      await localizeStaticUrls(\n        settings,\n        nonDefaultLocales,\n        postProcessIncludes\n      );\n    }\n  }\n\n  // Rewrite relative asset URLs in translated md/mdx files\n  if (settings.options?.experimentalLocalizeRelativeAssets) {\n    const nonDefaultLocales = settings.locales.filter(\n      (locale) => locale !== settings.defaultLocale\n    );\n    if (nonDefaultLocales.length > 0) {\n      await localizeRelativeAssets(\n        settings,\n        nonDefaultLocales,\n        postProcessIncludes\n      );\n    }\n  }\n\n  // Localize static imports (import Snippet from /snippets/file.mdx -> import Snippet from /snippets/[locale]/file.mdx)\n  if (settings.options?.experimentalLocalizeStaticImports) {\n    await localizeStaticImports(settings, postProcessIncludes);\n  }\n\n  const shouldProcessAnchorIds =\n    settings.options?.experimentalLocalizeStaticUrls ||\n    settings.options?.experimentalAddHeaderAnchorIds;\n\n  // Add explicit anchor IDs to translated MDX/MD files to preserve navigation.\n  // Uses escaped inline \\{#id\\} by default, or Mintlify's native {#id} if\n  // experimentalAddHeaderAnchorIds is 'mintlify'.\n  //\n  // Runs last of the md/mdx passes: the others re-stringify the document, which\n  // re-indents headings nested in JSX and would otherwise move them out from\n  // under the anchors placed here.\n  if (shouldProcessAnchorIds) {\n    await processAnchorIds(settings, postProcessIncludes);\n  }\n\n  // Flatten json files into a single file\n  if (settings.options?.experimentalFlattenJsonFiles) {\n    await flattenJsonFiles(settings, postProcessIncludes);\n  }\n\n  // Copy files to the target locale\n  if (settings.options?.copyFiles) {\n    await copyFile(settings);\n  }\n\n  // Record postprocessed content hashes for newly downloaded files\n  persistPostProcessHashes(settings, postProcessIncludes, getDownloadedMeta());\n}\n\n/**\n * Exclude only outputs whose source file was translated into a different format.\n * @param settings - The settings for the project\n * @param includeFiles - The files to include in the post-processing\n * @returns The files to exclude in the post-processing\n */\nfunction filterPostProcessIncludesForFormatTransforms(\n  settings: Settings,\n  includeFiles?: Set<string>\n): Set<string> | undefined {\n  if (!includeFiles) return includeFiles;\n\n  const transformedSourcePaths = new Set<string>();\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    if (!hasNonIdentityFileFormatTransformForType(settings, fileType)) continue;\n\n    for (const sourcePath of settings.files.resolvedPaths[fileType] || []) {\n      transformedSourcePaths.add(getRelative(sourcePath));\n    }\n  }\n  if (transformedSourcePaths.size === 0) return includeFiles;\n\n  const { resolvedPaths, placeholderPaths, transformPaths, transformFormats } =\n    settings.files;\n  const fileMapping = createFileMapping(\n    resolvedPaths,\n    placeholderPaths,\n    transformPaths,\n    transformFormats,\n    settings.locales,\n    settings.defaultLocale\n  );\n\n  const transformedOutputPaths = new Set<string>();\n  for (const localeMapping of Object.values(fileMapping)) {\n    for (const [sourcePath, outputPath] of Object.entries(localeMapping)) {\n      if (transformedSourcePaths.has(sourcePath)) {\n        transformedOutputPaths.add(outputPath);\n      }\n    }\n  }\n\n  return new Set(\n    [...includeFiles].filter(\n      (filePath) => !transformedOutputPaths.has(filePath)\n    )\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAyBA,eAAsB,gBACpB,SACA,UACA,iBACA,SACA,YACA,YACA,eACA;AACA,KAAI,iBAAiB;EACnB,MAAM,EACJ,eACA,kBACA,gBACA,qBACE,SAAS;EAEb,MAAM,cAAc,kBAClB,eACA,kBACA,gBACA,kBACA,SAAS,SACT,SAAS,cACV;AAED,QAAM,oBAAoB;GACP;GACR;GACG;GACZ,SAAS,SAAS;GAClB,iBAAiB,QAAQ;GACzB,oBAAoB,YAAY,WAC9B,YAAY,UAAU,eAAe;GACvC,SAAS;GACT;GACA,oBAAoB,QAAQ;GAC5B,eAAe,QAAQ,iBAAiB,QAAQ;GACjD,CAAC;AAGF,MAAI,cAAc,YAAY,cAAc,GAM1C,OAAM,mBALQ,OAAO,QAAQ,gBAAgB,CAAC,KAAK,CAAC,QAAQ,WAAW;GACrE;GACA,WAAW,KAAK;GAChB,UAAU,KAAK;GAChB,EAEM,EACL,YACA,WAAW,cAAc,IACzB,SACD;;;AAKP,eAAsB,wBACpB,UACA,cACA;CACA,MAAM,sBAAsB,6CAC1B,UACA,aACD;AACD,KAAI,gBAAgB,qBAAqB,SAAS,EAAG;AAErD,OAAM,oBAAoB,UAAU,oBAAoB;AAIxD,KAAI,SAAS,SAAS,gCAAgC;EACpD,MAAM,oBAAoB,SAAS,QAAQ,QACxC,WAAW,WAAW,SAAS,cACjC;AACD,MAAI,kBAAkB,SAAS,EAC7B,OAAM,mBACJ,UACA,mBACA,oBACD;;AAKL,KAAI,SAAS,SAAS,oCAAoC;EACxD,MAAM,oBAAoB,SAAS,QAAQ,QACxC,WAAW,WAAW,SAAS,cACjC;AACD,MAAI,kBAAkB,SAAS,EAC7B,OAAM,uBACJ,UACA,mBACA,oBACD;;AAKL,KAAI,SAAS,SAAS,kCACpB,OAAM,sBAAsB,UAAU,oBAAoB;AAc5D,KAVE,SAAS,SAAS,kCAClB,SAAS,SAAS,+BAUlB,OAAM,iBAAiB,UAAU,oBAAoB;AAIvD,KAAI,SAAS,SAAS,6BACpB,OAAM,iBAAiB,UAAU,oBAAoB;AAIvD,KAAI,SAAS,SAAS,UACpB,OAAM,SAAS,SAAS;AAI1B,0BAAyB,UAAU,qBAAqB,mBAAmB,CAAC;;;;;;;;AAS9E,SAAS,6CACP,UACA,cACyB;AACzB,KAAI,CAAC,aAAc,QAAO;CAE1B,MAAM,yCAAyB,IAAI,KAAa;AAChD,MAAK,MAAM,YAAY,2BAA2B;AAChD,MAAI,CAAC,yCAAyC,UAAU,SAAS,CAAE;AAEnE,OAAK,MAAM,cAAc,SAAS,MAAM,cAAc,aAAa,EAAE,CACnE,wBAAuB,IAAI,YAAY,WAAW,CAAC;;AAGvD,KAAI,uBAAuB,SAAS,EAAG,QAAO;CAE9C,MAAM,EAAE,eAAe,kBAAkB,gBAAgB,qBACvD,SAAS;CACX,MAAM,cAAc,kBAClB,eACA,kBACA,gBACA,kBACA,SAAS,SACT,SAAS,cACV;CAED,MAAM,yCAAyB,IAAI,KAAa;AAChD,MAAK,MAAM,iBAAiB,OAAO,OAAO,YAAY,CACpD,MAAK,MAAM,CAAC,YAAY,eAAe,OAAO,QAAQ,cAAc,CAClE,KAAI,uBAAuB,IAAI,WAAW,CACxC,wBAAuB,IAAI,WAAW;AAK5C,QAAO,IAAI,IACT,CAAC,GAAG,aAAa,CAAC,QACf,aAAa,CAAC,uBAAuB,IAAI,SAAS,CACpD,CACF"}

package/dist/generated/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.20.3";
+export declare const PACKAGE_VERSION = "2.20.4";

package/dist/generated/version.js

@@ -1,5 +1,5 @@
 //#region src/generated/version.ts
-const PACKAGE_VERSION = "2.20.3";
+const PACKAGE_VERSION = "2.20.4";
 //#endregion
 export { PACKAGE_VERSION };
 

package/dist/generated/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","names":[],"sources":["../../src/generated/version.ts"],"sourcesContent":["// This file is auto-generated. Do not edit manually.\nexport const PACKAGE_VERSION = '2.20.3';\n"],"mappings":";AACA,MAAa,kBAAkB"}
+{"version":3,"file":"version.js","names":[],"sources":["../../src/generated/version.ts"],"sourcesContent":["// This file is auto-generated. Do not edit manually.\nexport const PACKAGE_VERSION = '2.20.4';\n"],"mappings":";AACA,MAAa,kBAAkB"}

package/dist/utils/addExplicitAnchorIds.d.ts

@@ -2,12 +2,6 @@ import type { AdditionalOptions } from '../types/index.js';
 type AnchorIdSettings = {
     options?: Pick<AdditionalOptions, 'experimentalAddHeaderAnchorIds'>;
 };
-/** A source range on a single line, as 1-based inclusive/exclusive columns. */
-interface ColumnRange {
-    line: number;
-    startColumn: number;
-    endColumn: number;
-}
 /**
  * Represents a heading with its position and metadata
  */
@@ -24,8 +18,6 @@ export interface HeadingInfo {
     startColumn: number;
     /** 1-based column just past the text, before any closing `##`; -1 if unknown. */
     textEndColumn: number;
-    /** `id` attribute of a wrapper element already anchoring this heading. */
-    wrapperId: ColumnRange | null;
     /** Whether the author wrote an explicit `{#id}`. */
     explicit: boolean;
 }

package/dist/utils/addExplicitAnchorIds.js

@@ -7,6 +7,12 @@ const ATX_HEADING = /^([ \t]*)(#{1,6}[ \t]+)(.*)$/;
 /** A trailing custom anchor ID, in either the plain or MDX-escaped form. */
 const TRAILING_ANCHOR = /\s*(?:\\\{#[^}]+\\\}|\{#[^}]+\})\s*$/;
 /**
+* Deepest indentation at which Mintlify still reads `## Heading {#id}`. It is
+* the CommonMark limit for a heading; MDX itself accepts deeper headings, so
+* past it the `{#id}` reaches the expression parser and fails to compile.
+*/
+const MAX_MINTLIFY_HEADING_INDENT = 3;
+/**
 * Generates a slug from heading text
 */
 function generateSlug(text) {
@@ -43,7 +49,6 @@ function extractHeadingsWithFallback(mdxContent) {
 			endLine: index + 1,
 			startColumn: indent.length + 1,
 			textEndColumn: line.length + 1,
-			wrapperId: null,
 			explicit: explicitId !== void 0
 		});
 	});
@@ -79,22 +84,6 @@ function assignUniqueSlugs(headings) {
 	}
 }
 /**
-* Finds the `id` of a wrapper element already anchoring this heading. Requiring
-* the heading to be its only child rules out containers like `<Tab>`.
-*/
-function findWrapperId(heading, parent) {
-	if (!parent || parent.type !== "mdxJsxFlowElement") return null;
-	const element = parent;
-	if (element.children.length !== 1 || element.children[0] !== heading) return null;
-	const position = element.attributes.find((attribute) => attribute.type === "mdxJsxAttribute" && attribute.name === "id")?.position;
-	if (!position || position.start.line !== position.end.line) return null;
-	return {
-		line: position.start.line,
-		startColumn: position.start.column,
-		endColumn: position.end.column
-	};
-}
-/**
 * Extracts heading information from content (read-only, no modifications).
 * Source and translation are matched by position, so both must parse the same
 * way — the fallback extractor misses headings nested in JSX.
@@ -108,7 +97,7 @@ function extractHeadingInfo(mdxContent) {
 	}
 	const headings = [];
 	let position = 0;
-	visit(ast, "heading", (heading, _index, parent) => {
+	visit(ast, "heading", (heading) => {
 		const { cleanedText, explicitId } = parseHeadingContent(extractHeadingText(heading));
 		if (!cleanedText && !explicitId) return;
 		const lastChild = heading.children[heading.children.length - 1];
@@ -121,7 +110,6 @@ function extractHeadingInfo(mdxContent) {
 			endLine: heading.position?.end.line ?? -1,
 			startColumn: heading.position?.start.column ?? 1,
 			textEndColumn: lastChild?.position?.end.column ?? heading.position?.end.column ?? -1,
-			wrapperId: findWrapperId(heading, parent),
 			explicit: explicitId !== void 0
 		});
 	});
@@ -133,7 +121,7 @@ function extractHeadingInfo(mdxContent) {
 */
 function addExplicitAnchorIds(translatedContent, sourceHeadingMap, settings, sourcePath, translatedPath, fileTypeHint) {
 	const addedIds = [];
-	const useDivWrapping = settings?.options?.experimentalAddHeaderAnchorIds === "mintlify";
+	const mintlifyMode = settings?.options?.experimentalAddHeaderAnchorIds === "mintlify";
 	const translatedHeadings = extractHeadingInfo(translatedContent);
 	if (sourceHeadingMap.length !== translatedHeadings.length) {
 		const sourceFile = sourcePath ? `Source file: ${sourcePath}` : "Source file";
@@ -155,17 +143,16 @@ function addExplicitAnchorIds(translatedContent, sourceHeadingMap, settings, sou
 		}
 	});
 	const translatedIsMdx = translatedPath ? translatedPath.toLowerCase().endsWith(".mdx") : true;
-	const shouldEscapeAnchors = fileTypeHint === "mdx" ? true : fileTypeHint === "md" ? false : translatedIsMdx;
+	const shouldEscapeAnchors = mintlifyMode ? false : fileTypeHint === "mdx" ? true : fileTypeHint === "md" ? false : translatedIsMdx;
 	if (idMappings.size === 0) {
-		const content = useDivWrapping ? translatedContent : normalizeInlineAnchors(translatedContent, shouldEscapeAnchors);
+		const content = normalizeInlineAnchors(translatedContent, shouldEscapeAnchors);
 		return {
 			content,
 			hasChanges: content !== translatedContent,
 			addedIds: []
 		};
 	}
-	let content = applyAnchorIds(translatedContent, translatedHeadings, idMappings, useDivWrapping, shouldEscapeAnchors);
-	if (!useDivWrapping) content = normalizeInlineAnchors(content, shouldEscapeAnchors);
+	const content = normalizeInlineAnchors(applyAnchorIds(translatedContent, translatedHeadings, idMappings, mintlifyMode, shouldEscapeAnchors), shouldEscapeAnchors);
 	return {
 		content,
 		hasChanges: content !== translatedContent,
@@ -176,7 +163,7 @@ function addExplicitAnchorIds(translatedContent, sourceHeadingMap, settings, sou
 * Writes anchor IDs onto the translated document, locating headings by parser
 * line position rather than by text. Edits run bottom-up to keep lines valid.
 */
-function applyAnchorIds(translatedContent, translatedHeadings, idMappings, useDivWrapping, escapeAnchors) {
+function applyAnchorIds(translatedContent, translatedHeadings, idMappings, mintlifyMode, escapeAnchors) {
 	const lines = translatedContent.split("\n");
 	const ordered = [...translatedHeadings].sort((a, b) => b.startLine - a.startLine);
 	for (const heading of ordered) {
@@ -184,26 +171,13 @@ function applyAnchorIds(translatedContent, translatedHeadings, idMappings, useDi
 		if (!mapping) continue;
 		if (heading.startLine < 1 || heading.endLine > lines.length) continue;
 		const index = heading.startLine - 1;
-		if (!useDivWrapping) {
-			if (heading.textEndColumn < 1) continue;
-			const anchor = escapeAnchors && !mapping.explicit ? `\\{#${mapping.id}\\}` : `{#${mapping.id}}`;
-			const { text, trailer } = splitHeadingLine(lines[index], heading);
-			lines[index] = `${text} ${anchor}${trailer}`;
-			continue;
-		}
-		if (heading.textEndColumn >= 1) {
-			const { text, trailer } = splitHeadingLine(lines[index], heading);
-			lines[index] = `${text}${trailer}`;
-		}
-		if (heading.wrapperId) {
-			const { line, startColumn, endColumn } = heading.wrapperId;
-			const wrapper = lines[line - 1];
-			lines[line - 1] = wrapper.slice(0, startColumn - 1) + `id="${mapping.id}"` + wrapper.slice(endColumn - 1);
-			continue;
-		}
-		const indent = lines[index].slice(0, Math.max(0, heading.startColumn - 1));
-		const body = lines.slice(index, heading.endLine).map((line) => `  ${line}`);
-		lines.splice(index, heading.endLine - heading.startLine + 1, `${indent}<div id="${mapping.id}">`, ...body, `${indent}</div>`);
+		if (heading.textEndColumn < 1) continue;
+		if (mintlifyMode && heading.endLine > heading.startLine) continue;
+		const anchor = escapeAnchors && !mapping.explicit ? `\\{#${mapping.id}\\}` : `{#${mapping.id}}`;
+		const { text, trailer } = splitHeadingLine(lines[index], heading);
+		const line = `${text} ${anchor}${trailer}`;
+		const indent = line.match(/^[ \t]*/)?.[0].length ?? 0;
+		lines[index] = mintlifyMode && indent > MAX_MINTLIFY_HEADING_INDENT ? line.trimStart() : line;
 	}
 	return lines.join("\n");
 }

package/dist/utils/addExplicitAnchorIds.js.map

@@ -1 +1 @@
-{"version":3,"file":"addExplicitAnchorIds.js","names":[],"sources":["../../src/utils/addExplicitAnchorIds.ts"],"sourcesContent":["import { visit } from 'unist-util-visit';\nimport type { Heading, Node } from 'mdast';\nimport type { MdxJsxFlowElement } from 'mdast-util-mdx-jsx';\nimport { logger } from '../console/logger.js';\nimport type { AdditionalOptions } from '../types/index.js';\nimport {\n  forEachLineOutsideCodeFences,\n  mapLinesOutsideCodeFences,\n  parseMdxTolerantly,\n} from './mdxAnchorSyntax.js';\n\ntype AnchorIdSettings = {\n  options?: Pick<AdditionalOptions, 'experimentalAddHeaderAnchorIds'>;\n};\n\n/** An ATX heading line, split into indentation, marker and text. */\nconst ATX_HEADING = /^([ \\t]*)(#{1,6}[ \\t]+)(.*)$/;\n\n/** A trailing custom anchor ID, in either the plain or MDX-escaped form. */\nconst TRAILING_ANCHOR = /\\s*(?:\\\\\\{#[^}]+\\\\\\}|\\{#[^}]+\\})\\s*$/;\n\n/**\n * Generates a slug from heading text\n */\nfunction generateSlug(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/[^\\w\\s-]/g, '') // Remove special chars except spaces and hyphens\n    .trim()\n    .replace(/\\s+/g, '-') // Replace spaces with hyphens\n    .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen\n    .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens\n}\n\n/**\n * Extracts text content from heading nodes\n */\nfunction extractHeadingText(heading: Heading): string {\n  let text = '';\n\n  visit(heading, ['text', 'inlineCode'], (node: Node) => {\n    if ('value' in node && typeof node.value === 'string') {\n      text += node.value;\n    }\n  });\n\n  return text;\n}\n\n/**\n * Line-by-line heading extractor used when MDX parsing fails outright.\n */\nfunction extractHeadingsWithFallback(mdxContent: string): HeadingInfo[] {\n  const headings: HeadingInfo[] = [];\n  let position = 0;\n\n  forEachLineOutsideCodeFences(mdxContent, (line, index) => {\n    const headingMatch = line.match(ATX_HEADING);\n    if (!headingMatch) return;\n\n    const [, indent, marker, rawText] = headingMatch;\n    const { cleanedText, explicitId } = parseHeadingContent(rawText);\n    if (!cleanedText && !explicitId) return;\n\n    headings.push({\n      text: cleanedText,\n      level: marker.trim().length,\n      slug: explicitId ?? generateSlug(cleanedText),\n      position: position++,\n      startLine: index + 1,\n      endLine: index + 1,\n      startColumn: indent.length + 1,\n      // Without a parser there is nothing finer to go on than end of line.\n      textEndColumn: line.length + 1,\n      wrapperId: null,\n      explicit: explicitId !== undefined,\n    });\n  });\n\n  assignUniqueSlugs(headings);\n  return headings;\n}\n\nfunction parseHeadingContent(text: string): {\n  cleanedText: string;\n  explicitId?: string;\n} {\n  // Support both {#id} and escaped \\{#id\\} forms\n  const anchorMatch = text.match(/(\\\\\\{#([^}]+)\\\\\\}|\\{#([^}]+)\\})\\s*$/);\n\n  if (!anchorMatch) {\n    return { cleanedText: text };\n  }\n\n  const explicitId = anchorMatch[2] || anchorMatch[3];\n  const cleanedText = text.replace(anchorMatch[0], '').trimEnd();\n\n  return { cleanedText, explicitId };\n}\n\n/**\n * Suffixes repeated slugs `-2`, `-3`, ... as Mintlify does. Author-written IDs\n * are never renumbered, only reserved.\n */\nfunction assignUniqueSlugs(headings: HeadingInfo[]): void {\n  // Reserve every explicit ID up front, including ones later in the document,\n  // so a generated slug never claims an ID an author asked for.\n  const used = new Set(\n    headings\n      .filter((heading) => heading.explicit)\n      .map((heading) => heading.slug)\n  );\n\n  for (const heading of headings) {\n    if (heading.explicit) continue;\n\n    // Headings with no slug-able characters would produce id=\"\".\n    const base = heading.slug || 'section';\n    let slug = base;\n    let suffix = 1;\n    while (used.has(slug)) {\n      suffix += 1;\n      slug = `${base}-${suffix}`;\n    }\n\n    heading.slug = slug;\n    used.add(slug);\n  }\n}\n\n/** A source range on a single line, as 1-based inclusive/exclusive columns. */\ninterface ColumnRange {\n  line: number;\n  startColumn: number;\n  endColumn: number;\n}\n\n/**\n * Represents a heading with its position and metadata\n */\nexport interface HeadingInfo {\n  text: string;\n  level: number;\n  slug: string;\n  position: number;\n  /** 1-based line the heading starts on. */\n  startLine: number;\n  /** 1-based line the heading ends on (differs from startLine for setext). */\n  endLine: number;\n  /** 1-based column of the heading marker; anything left of it is indentation. */\n  startColumn: number;\n  /** 1-based column just past the text, before any closing `##`; -1 if unknown. */\n  textEndColumn: number;\n  /** `id` attribute of a wrapper element already anchoring this heading. */\n  wrapperId: ColumnRange | null;\n  /** Whether the author wrote an explicit `{#id}`. */\n  explicit: boolean;\n}\n\n/**\n * Finds the `id` of a wrapper element already anchoring this heading. Requiring\n * the heading to be its only child rules out containers like `<Tab>`.\n */\nfunction findWrapperId(\n  heading: Heading,\n  parent: Node | undefined\n): ColumnRange | null {\n  if (!parent || parent.type !== 'mdxJsxFlowElement') return null;\n\n  const element = parent as MdxJsxFlowElement;\n  if (element.children.length !== 1 || element.children[0] !== heading) {\n    return null;\n  }\n\n  const id = element.attributes.find(\n    (attribute) =>\n      attribute.type === 'mdxJsxAttribute' && attribute.name === 'id'\n  );\n  const position = id?.position;\n  if (!position || position.start.line !== position.end.line) return null;\n\n  return {\n    line: position.start.line,\n    startColumn: position.start.column,\n    endColumn: position.end.column,\n  };\n}\n\n/**\n * Extracts heading information from content (read-only, no modifications).\n * Source and translation are matched by position, so both must parse the same\n * way — the fallback extractor misses headings nested in JSX.\n */\nexport function extractHeadingInfo(mdxContent: string): HeadingInfo[] {\n  let ast;\n  try {\n    ast = parseMdxTolerantly(mdxContent);\n  } catch {\n    // Fallback: line-by-line extraction skipping fenced code blocks\n    return extractHeadingsWithFallback(mdxContent);\n  }\n\n  const headings: HeadingInfo[] = [];\n  let position = 0;\n\n  visit(ast, 'heading', (heading: Heading, _index, parent) => {\n    const headingText = extractHeadingText(heading);\n    const { cleanedText, explicitId } = parseHeadingContent(headingText);\n    if (!cleanedText && !explicitId) return;\n\n    const lastChild = heading.children[heading.children.length - 1];\n\n    headings.push({\n      text: cleanedText,\n      level: heading.depth,\n      slug: explicitId ?? generateSlug(cleanedText),\n      position: position++,\n      startLine: heading.position?.start.line ?? -1,\n      endLine: heading.position?.end.line ?? -1,\n      startColumn: heading.position?.start.column ?? 1,\n      textEndColumn:\n        lastChild?.position?.end.column ?? heading.position?.end.column ?? -1,\n      wrapperId: findWrapperId(heading, parent),\n      explicit: explicitId !== undefined,\n    });\n  });\n\n  assignUniqueSlugs(headings);\n  return headings;\n}\n\n/**\n * Applies anchor IDs to translated content based on source heading mapping\n */\nexport function addExplicitAnchorIds(\n  translatedContent: string,\n  sourceHeadingMap: HeadingInfo[],\n  settings?: AnchorIdSettings,\n  sourcePath?: string,\n  translatedPath?: string,\n  fileTypeHint?: 'md' | 'mdx'\n): {\n  content: string;\n  hasChanges: boolean;\n  addedIds: Array<{ heading: string; id: string }>;\n} {\n  const addedIds: Array<{ heading: string; id: string }> = [];\n  const useDivWrapping =\n    settings?.options?.experimentalAddHeaderAnchorIds === 'mintlify';\n\n  // Extract headings from translated content\n  const translatedHeadings = extractHeadingInfo(translatedContent);\n\n  // Pre-processing validation: check if header counts match\n  if (sourceHeadingMap.length !== translatedHeadings.length) {\n    const sourceFile = sourcePath\n      ? `Source file: ${sourcePath}`\n      : 'Source file';\n    const translatedFile = translatedPath\n      ? `translated file: ${translatedPath}`\n      : 'translated file';\n\n    logger.warn(\n      `Header count mismatch detected! ${sourceFile} has ${sourceHeadingMap.length} headers but ${translatedFile} has ${translatedHeadings.length} headers. ` +\n        `This likely means your source file was edited after translation was requested, causing a mismatch between ` +\n        `the number of headers in your source file vs the translated file. Re-translate this file to resolve the issue.`\n    );\n  }\n\n  // Create ID mapping based on positional matching\n  const idMappings = new Map<number, { id: string; explicit: boolean }>();\n  sourceHeadingMap.forEach((sourceHeading, index) => {\n    const translatedHeading = translatedHeadings[index];\n    // Match by position and level for safety\n    if (translatedHeading && translatedHeading.level === sourceHeading.level) {\n      idMappings.set(index, {\n        id: sourceHeading.slug,\n        explicit: sourceHeading.explicit,\n      });\n      addedIds.push({\n        heading: translatedHeading.text,\n        id: sourceHeading.slug,\n      });\n    }\n  });\n\n  const translatedIsMdx = translatedPath\n    ? translatedPath.toLowerCase().endsWith('.mdx')\n    : true; // default to mdx-style escaping when unknown\n  const shouldEscapeAnchors =\n    fileTypeHint === 'mdx'\n      ? true\n      : fileTypeHint === 'md'\n        ? false\n        : translatedIsMdx;\n\n  if (idMappings.size === 0) {\n    // Normalize anchors the translation carried over.\n    const content = useDivWrapping\n      ? translatedContent\n      : normalizeInlineAnchors(translatedContent, shouldEscapeAnchors);\n    return {\n      content,\n      hasChanges: content !== translatedContent,\n      addedIds: [],\n    };\n  }\n\n  let content = applyAnchorIds(\n    translatedContent,\n    translatedHeadings,\n    idMappings,\n    useDivWrapping,\n    shouldEscapeAnchors\n  );\n\n  if (!useDivWrapping) {\n    content = normalizeInlineAnchors(content, shouldEscapeAnchors);\n  }\n\n  return {\n    content,\n    hasChanges: content !== translatedContent,\n    addedIds,\n  };\n}\n\n/**\n * Writes anchor IDs onto the translated document, locating headings by parser\n * line position rather than by text. Edits run bottom-up to keep lines valid.\n */\nfunction applyAnchorIds(\n  translatedContent: string,\n  translatedHeadings: HeadingInfo[],\n  idMappings: Map<number, { id: string; explicit: boolean }>,\n  useDivWrapping: boolean,\n  escapeAnchors: boolean\n): string {\n  const lines = translatedContent.split('\\n');\n\n  const ordered = [...translatedHeadings].sort(\n    (a, b) => b.startLine - a.startLine\n  );\n\n  for (const heading of ordered) {\n    const mapping = idMappings.get(heading.position);\n    if (!mapping) continue;\n    if (heading.startLine < 1 || heading.endLine > lines.length) continue;\n\n    const index = heading.startLine - 1;\n\n    if (!useDivWrapping) {\n      // Setext headings have no column to append to.\n      if (heading.textEndColumn < 1) continue;\n\n      const escape = escapeAnchors && !mapping.explicit;\n      const anchor = escape ? `\\\\{#${mapping.id}\\\\}` : `{#${mapping.id}}`;\n      const { text, trailer } = splitHeadingLine(lines[index], heading);\n\n      lines[index] = `${text} ${anchor}${trailer}`;\n      continue;\n    }\n\n    // In wrapper mode every heading gets a wrapper, including ones whose ID\n    // the author wrote inline. Mintlify's `{#id}` pre-pass does not recognize\n    // headings indented four or more spaces, which the MDX serializer produces\n    // for headings nested in JSX, so a re-attached inline ID fails to compile.\n    // A wrapper anchors the heading at any indentation. Drop any inline ID the\n    // translation carried over so the two forms never appear together.\n    if (heading.textEndColumn >= 1) {\n      const { text, trailer } = splitHeadingLine(lines[index], heading);\n      lines[index] = `${text}${trailer}`;\n    }\n\n    if (heading.wrapperId) {\n      // Already wrapped: fix the ID in place rather than nesting another.\n      const { line, startColumn, endColumn } = heading.wrapperId;\n      const wrapper = lines[line - 1];\n      lines[line - 1] =\n        wrapper.slice(0, startColumn - 1) +\n        `id=\"${mapping.id}\"` +\n        wrapper.slice(endColumn - 1);\n      continue;\n    }\n\n    const indent = lines[index].slice(0, Math.max(0, heading.startColumn - 1));\n    const body = lines.slice(index, heading.endLine).map((line) => `  ${line}`);\n\n    lines.splice(\n      index,\n      heading.endLine - heading.startLine + 1,\n      `${indent}<div id=\"${mapping.id}\">`,\n      ...body,\n      `${indent}</div>`\n    );\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Splits a heading line into its text, minus any trailing inline anchor, and\n * whatever follows the text (a closing `##` sequence, for instance).\n */\nfunction splitHeadingLine(\n  line: string,\n  heading: HeadingInfo\n): { text: string; trailer: string } {\n  return {\n    text: line.slice(0, heading.textEndColumn - 1).replace(TRAILING_ANCHOR, ''),\n    trailer: line.slice(heading.textEndColumn - 1),\n  };\n}\n\n/**\n * Normalizes every inline anchor: escaped for MDX, bare for Markdown.\n */\nfunction normalizeInlineAnchors(\n  content: string,\n  escapeAnchors: boolean\n): string {\n  return mapLinesOutsideCodeFences(content, (line) => {\n    const atx = line.match(ATX_HEADING);\n    if (!atx) return line;\n\n    const escaped = atx[3].match(/\\\\\\{#([A-Za-z0-9_-]+)\\\\\\}\\s*$/);\n    const bare = atx[3].match(/(?<!\\\\)\\{#([A-Za-z0-9_-]+)\\}\\s*$/);\n\n    if (escapeAnchors && bare) {\n      const text = atx[3].replace(TRAILING_ANCHOR, '');\n      return `${atx[1]}${atx[2]}${text} \\\\{#${bare[1]}\\\\}`;\n    }\n    if (!escapeAnchors && escaped) {\n      const text = atx[3].replace(TRAILING_ANCHOR, '');\n      return `${atx[1]}${atx[2]}${text} {#${escaped[1]}}`;\n    }\n    return line;\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"addExplicitAnchorIds.js","names":[],"sources":["../../src/utils/addExplicitAnchorIds.ts"],"sourcesContent":["import { visit } from 'unist-util-visit';\nimport type { Heading, Node } from 'mdast';\nimport { logger } from '../console/logger.js';\nimport type { AdditionalOptions } from '../types/index.js';\nimport {\n  forEachLineOutsideCodeFences,\n  mapLinesOutsideCodeFences,\n  parseMdxTolerantly,\n} from './mdxAnchorSyntax.js';\n\ntype AnchorIdSettings = {\n  options?: Pick<AdditionalOptions, 'experimentalAddHeaderAnchorIds'>;\n};\n\n/** An ATX heading line, split into indentation, marker and text. */\nconst ATX_HEADING = /^([ \\t]*)(#{1,6}[ \\t]+)(.*)$/;\n\n/** A trailing custom anchor ID, in either the plain or MDX-escaped form. */\nconst TRAILING_ANCHOR = /\\s*(?:\\\\\\{#[^}]+\\\\\\}|\\{#[^}]+\\})\\s*$/;\n\n/**\n * Deepest indentation at which Mintlify still reads `## Heading {#id}`. It is\n * the CommonMark limit for a heading; MDX itself accepts deeper headings, so\n * past it the `{#id}` reaches the expression parser and fails to compile.\n */\nconst MAX_MINTLIFY_HEADING_INDENT = 3;\n\n/**\n * Generates a slug from heading text\n */\nfunction generateSlug(text: string): string {\n  return text\n    .toLowerCase()\n    .replace(/[^\\w\\s-]/g, '') // Remove special chars except spaces and hyphens\n    .trim()\n    .replace(/\\s+/g, '-') // Replace spaces with hyphens\n    .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen\n    .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens\n}\n\n/**\n * Extracts text content from heading nodes\n */\nfunction extractHeadingText(heading: Heading): string {\n  let text = '';\n\n  visit(heading, ['text', 'inlineCode'], (node: Node) => {\n    if ('value' in node && typeof node.value === 'string') {\n      text += node.value;\n    }\n  });\n\n  return text;\n}\n\n/**\n * Line-by-line heading extractor used when MDX parsing fails outright.\n */\nfunction extractHeadingsWithFallback(mdxContent: string): HeadingInfo[] {\n  const headings: HeadingInfo[] = [];\n  let position = 0;\n\n  forEachLineOutsideCodeFences(mdxContent, (line, index) => {\n    const headingMatch = line.match(ATX_HEADING);\n    if (!headingMatch) return;\n\n    const [, indent, marker, rawText] = headingMatch;\n    const { cleanedText, explicitId } = parseHeadingContent(rawText);\n    if (!cleanedText && !explicitId) return;\n\n    headings.push({\n      text: cleanedText,\n      level: marker.trim().length,\n      slug: explicitId ?? generateSlug(cleanedText),\n      position: position++,\n      startLine: index + 1,\n      endLine: index + 1,\n      startColumn: indent.length + 1,\n      // Without a parser there is nothing finer to go on than end of line.\n      textEndColumn: line.length + 1,\n      explicit: explicitId !== undefined,\n    });\n  });\n\n  assignUniqueSlugs(headings);\n  return headings;\n}\n\nfunction parseHeadingContent(text: string): {\n  cleanedText: string;\n  explicitId?: string;\n} {\n  // Support both {#id} and escaped \\{#id\\} forms\n  const anchorMatch = text.match(/(\\\\\\{#([^}]+)\\\\\\}|\\{#([^}]+)\\})\\s*$/);\n\n  if (!anchorMatch) {\n    return { cleanedText: text };\n  }\n\n  const explicitId = anchorMatch[2] || anchorMatch[3];\n  const cleanedText = text.replace(anchorMatch[0], '').trimEnd();\n\n  return { cleanedText, explicitId };\n}\n\n/**\n * Suffixes repeated slugs `-2`, `-3`, ... as Mintlify does. Author-written IDs\n * are never renumbered, only reserved.\n */\nfunction assignUniqueSlugs(headings: HeadingInfo[]): void {\n  // Reserve every explicit ID up front, including ones later in the document,\n  // so a generated slug never claims an ID an author asked for.\n  const used = new Set(\n    headings\n      .filter((heading) => heading.explicit)\n      .map((heading) => heading.slug)\n  );\n\n  for (const heading of headings) {\n    if (heading.explicit) continue;\n\n    // Headings with no slug-able characters would produce id=\"\".\n    const base = heading.slug || 'section';\n    let slug = base;\n    let suffix = 1;\n    while (used.has(slug)) {\n      suffix += 1;\n      slug = `${base}-${suffix}`;\n    }\n\n    heading.slug = slug;\n    used.add(slug);\n  }\n}\n\n/**\n * Represents a heading with its position and metadata\n */\nexport interface HeadingInfo {\n  text: string;\n  level: number;\n  slug: string;\n  position: number;\n  /** 1-based line the heading starts on. */\n  startLine: number;\n  /** 1-based line the heading ends on (differs from startLine for setext). */\n  endLine: number;\n  /** 1-based column of the heading marker; anything left of it is indentation. */\n  startColumn: number;\n  /** 1-based column just past the text, before any closing `##`; -1 if unknown. */\n  textEndColumn: number;\n  /** Whether the author wrote an explicit `{#id}`. */\n  explicit: boolean;\n}\n\n/**\n * Extracts heading information from content (read-only, no modifications).\n * Source and translation are matched by position, so both must parse the same\n * way — the fallback extractor misses headings nested in JSX.\n */\nexport function extractHeadingInfo(mdxContent: string): HeadingInfo[] {\n  let ast;\n  try {\n    ast = parseMdxTolerantly(mdxContent);\n  } catch {\n    // Fallback: line-by-line extraction skipping fenced code blocks\n    return extractHeadingsWithFallback(mdxContent);\n  }\n\n  const headings: HeadingInfo[] = [];\n  let position = 0;\n\n  visit(ast, 'heading', (heading: Heading) => {\n    const headingText = extractHeadingText(heading);\n    const { cleanedText, explicitId } = parseHeadingContent(headingText);\n    if (!cleanedText && !explicitId) return;\n\n    const lastChild = heading.children[heading.children.length - 1];\n\n    headings.push({\n      text: cleanedText,\n      level: heading.depth,\n      slug: explicitId ?? generateSlug(cleanedText),\n      position: position++,\n      startLine: heading.position?.start.line ?? -1,\n      endLine: heading.position?.end.line ?? -1,\n      startColumn: heading.position?.start.column ?? 1,\n      textEndColumn:\n        lastChild?.position?.end.column ?? heading.position?.end.column ?? -1,\n      explicit: explicitId !== undefined,\n    });\n  });\n\n  assignUniqueSlugs(headings);\n  return headings;\n}\n\n/**\n * Applies anchor IDs to translated content based on source heading mapping\n */\nexport function addExplicitAnchorIds(\n  translatedContent: string,\n  sourceHeadingMap: HeadingInfo[],\n  settings?: AnchorIdSettings,\n  sourcePath?: string,\n  translatedPath?: string,\n  fileTypeHint?: 'md' | 'mdx'\n): {\n  content: string;\n  hasChanges: boolean;\n  addedIds: Array<{ heading: string; id: string }>;\n} {\n  const addedIds: Array<{ heading: string; id: string }> = [];\n  // Mintlify mode writes Mintlify's native `{#id}` on every heading.\n  const mintlifyMode =\n    settings?.options?.experimentalAddHeaderAnchorIds === 'mintlify';\n\n  // Extract headings from translated content\n  const translatedHeadings = extractHeadingInfo(translatedContent);\n\n  // Pre-processing validation: check if header counts match\n  if (sourceHeadingMap.length !== translatedHeadings.length) {\n    const sourceFile = sourcePath\n      ? `Source file: ${sourcePath}`\n      : 'Source file';\n    const translatedFile = translatedPath\n      ? `translated file: ${translatedPath}`\n      : 'translated file';\n\n    logger.warn(\n      `Header count mismatch detected! ${sourceFile} has ${sourceHeadingMap.length} headers but ${translatedFile} has ${translatedHeadings.length} headers. ` +\n        `This likely means your source file was edited after translation was requested, causing a mismatch between ` +\n        `the number of headers in your source file vs the translated file. Re-translate this file to resolve the issue.`\n    );\n  }\n\n  // Create ID mapping based on positional matching\n  const idMappings = new Map<number, { id: string; explicit: boolean }>();\n  sourceHeadingMap.forEach((sourceHeading, index) => {\n    const translatedHeading = translatedHeadings[index];\n    // Match by position and level for safety\n    if (translatedHeading && translatedHeading.level === sourceHeading.level) {\n      idMappings.set(index, {\n        id: sourceHeading.slug,\n        explicit: sourceHeading.explicit,\n      });\n      addedIds.push({\n        heading: translatedHeading.text,\n        id: sourceHeading.slug,\n      });\n    }\n  });\n\n  const translatedIsMdx = translatedPath\n    ? translatedPath.toLowerCase().endsWith('.mdx')\n    : true; // default to mdx-style escaping when unknown\n  const shouldEscapeAnchors = mintlifyMode\n    ? false\n    : fileTypeHint === 'mdx'\n      ? true\n      : fileTypeHint === 'md'\n        ? false\n        : translatedIsMdx;\n\n  if (idMappings.size === 0) {\n    // Normalize anchors the translation carried over.\n    const content = normalizeInlineAnchors(\n      translatedContent,\n      shouldEscapeAnchors\n    );\n    return {\n      content,\n      hasChanges: content !== translatedContent,\n      addedIds: [],\n    };\n  }\n\n  const content = normalizeInlineAnchors(\n    applyAnchorIds(\n      translatedContent,\n      translatedHeadings,\n      idMappings,\n      mintlifyMode,\n      shouldEscapeAnchors\n    ),\n    shouldEscapeAnchors\n  );\n\n  return {\n    content,\n    hasChanges: content !== translatedContent,\n    addedIds,\n  };\n}\n\n/**\n * Writes anchor IDs onto the translated document, locating headings by parser\n * line position rather than by text. Edits run bottom-up to keep lines valid.\n */\nfunction applyAnchorIds(\n  translatedContent: string,\n  translatedHeadings: HeadingInfo[],\n  idMappings: Map<number, { id: string; explicit: boolean }>,\n  mintlifyMode: boolean,\n  escapeAnchors: boolean\n): string {\n  const lines = translatedContent.split('\\n');\n\n  const ordered = [...translatedHeadings].sort(\n    (a, b) => b.startLine - a.startLine\n  );\n\n  for (const heading of ordered) {\n    const mapping = idMappings.get(heading.position);\n    if (!mapping) continue;\n    if (heading.startLine < 1 || heading.endLine > lines.length) continue;\n\n    const index = heading.startLine - 1;\n\n    if (heading.textEndColumn < 1) continue;\n\n    // Mintlify reads `{#id}` on ATX headings only, so a setext heading is left\n    // alone. Other modes keep the anchor on its text line as before.\n    if (mintlifyMode && heading.endLine > heading.startLine) continue;\n\n    const escape = escapeAnchors && !mapping.explicit;\n    const anchor = escape ? `\\\\{#${mapping.id}\\\\}` : `{#${mapping.id}}`;\n    const { text, trailer } = splitHeadingLine(lines[index], heading);\n    const line = `${text} ${anchor}${trailer}`;\n\n    // The MDX serializer indents JSX children two spaces per level, so a\n    // heading nested in JSX can sit deeper than Mintlify reads `{#id}`. Move it\n    // to the margin; mixed indentation inside a JSX element is valid MDX.\n    const indent = line.match(/^[ \\t]*/)?.[0].length ?? 0;\n    lines[index] =\n      mintlifyMode && indent > MAX_MINTLIFY_HEADING_INDENT\n        ? line.trimStart()\n        : line;\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Splits a heading line into its text, minus any trailing inline anchor, and\n * whatever follows the text (a closing `##` sequence, for instance).\n */\nfunction splitHeadingLine(\n  line: string,\n  heading: HeadingInfo\n): { text: string; trailer: string } {\n  return {\n    text: line.slice(0, heading.textEndColumn - 1).replace(TRAILING_ANCHOR, ''),\n    trailer: line.slice(heading.textEndColumn - 1),\n  };\n}\n\n/**\n * Normalizes every inline anchor: escaped for MDX, bare for Markdown.\n */\nfunction normalizeInlineAnchors(\n  content: string,\n  escapeAnchors: boolean\n): string {\n  return mapLinesOutsideCodeFences(content, (line) => {\n    const atx = line.match(ATX_HEADING);\n    if (!atx) return line;\n\n    const escaped = atx[3].match(/\\\\\\{#([A-Za-z0-9_-]+)\\\\\\}\\s*$/);\n    const bare = atx[3].match(/(?<!\\\\)\\{#([A-Za-z0-9_-]+)\\}\\s*$/);\n\n    if (escapeAnchors && bare) {\n      const text = atx[3].replace(TRAILING_ANCHOR, '');\n      return `${atx[1]}${atx[2]}${text} \\\\{#${bare[1]}\\\\}`;\n    }\n    if (!escapeAnchors && escaped) {\n      const text = atx[3].replace(TRAILING_ANCHOR, '');\n      return `${atx[1]}${atx[2]}${text} {#${escaped[1]}}`;\n    }\n    return line;\n  });\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gt",
-  "version": "2.20.3",
+  "version": "2.20.4",
   "main": "dist/index.js",
   "bin": "bin/main.js",
   "files": [
@@ -116,12 +116,12 @@
     "unist-util-visit": "^5.0.0",
     "yaml": "^2.8.0",
     "@generaltranslation/format": "0.1.8",
-    "@generaltranslation/python-extractor": "0.2.47",
-    "@generaltranslation/icu": "0.1.2",
-    "@generaltranslation/vue-extractor": "0.1.7",
     "@generaltranslation/supported-locales": "2.1.27",
     "generaltranslation": "9.2.0",
-    "gt-remark": "1.0.12"
+    "@generaltranslation/vue-extractor": "0.1.7",
+    "gt-remark": "1.0.12",
+    "@generaltranslation/python-extractor": "0.2.47",
+    "@generaltranslation/icu": "0.1.2"
   },
   "devDependencies": {
     "@types/babel__generator": "^7.27.0",