@intlayer/cli 8.6.1 → 8.6.3

package/dist/cjs/fill/extractTranslatableContent.cjs

@@ -0,0 +1,58 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/fill/extractTranslatableContent.ts
+const extractTranslatableContent = (content, currentPath = [], state = {
+	currentIndex: 1,
+	extractedContent: [],
+	translatableDictionary: {}
+}) => {
+	if (typeof content === "string") {
+		const regex = /[{]+.*?[}]+/g;
+		const replacement = {};
+		let varIndex = 1;
+		const modifiedContent = content.replace(regex, (matchStr) => {
+			const placeholder = `<${varIndex}>`;
+			replacement[placeholder] = matchStr;
+			varIndex++;
+			return placeholder;
+		});
+		const contentWithoutPlaceholders = modifiedContent.replace(/<\d+>/g, "");
+		if (/[\p{L}\p{N}]/u.test(contentWithoutPlaceholders)) {
+			state.extractedContent.push({
+				index: state.currentIndex,
+				path: currentPath,
+				value: modifiedContent,
+				replacement: Object.keys(replacement).length > 0 ? replacement : void 0
+			});
+			state.translatableDictionary[state.currentIndex] = modifiedContent;
+			state.currentIndex++;
+		}
+	} else if (Array.isArray(content)) content.forEach((item, index) => {
+		extractTranslatableContent(item, [...currentPath, index], state);
+	});
+	else if (typeof content === "object" && content !== null) {
+		for (const key in content) if (Object.hasOwn(content, key)) extractTranslatableContent(content[key], [...currentPath, key], state);
+	}
+	return {
+		extractedContent: state.extractedContent,
+		translatableDictionary: state.translatableDictionary
+	};
+};
+const reinsertTranslatedContent = (baseContent, extractedContentProps, translatedDictionary) => {
+	const result = structuredClone(baseContent);
+	for (const { index, path, replacement } of extractedContentProps) {
+		let translatedValue = translatedDictionary[index];
+		if (translatedValue !== void 0) {
+			if (replacement) for (const [placeholder, originalVar] of Object.entries(replacement)) translatedValue = translatedValue.replace(placeholder, originalVar);
+			let current = result;
+			for (let i = 0; i < path.length - 1; i++) current = current[path[i]];
+			current[path[path.length - 1]] = translatedValue;
+		}
+	}
+	return result;
+};
+
+//#endregion
+exports.extractTranslatableContent = extractTranslatableContent;
+exports.reinsertTranslatedContent = reinsertTranslatedContent;
+//# sourceMappingURL=extractTranslatableContent.cjs.map

package/dist/cjs/fill/extractTranslatableContent.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractTranslatableContent.cjs","names":[],"sources":["../../../src/fill/extractTranslatableContent.ts"],"sourcesContent":["export type ExtractedContentProps = {\n  index: number;\n  path: (string | number)[];\n  value: string;\n  replacement?: Record<string, string>;\n};\n\nexport type ExtractedContentResult = {\n  extractedContent: ExtractedContentProps[];\n  translatableDictionary: Record<number, string>;\n};\n\nexport const extractTranslatableContent = (\n  content: any,\n  currentPath: (string | number)[] = [],\n  state = {\n    currentIndex: 1,\n    extractedContent: [] as ExtractedContentProps[],\n    translatableDictionary: {} as Record<number, string>,\n  }\n): ExtractedContentResult => {\n  if (typeof content === 'string') {\n    const regex = /[{]+.*?[}]+/g;\n    const replacement: Record<string, string> = {};\n    let varIndex = 1;\n\n    const modifiedContent = content.replace(regex, (matchStr) => {\n      const placeholder = `<${varIndex}>`;\n      replacement[placeholder] = matchStr;\n      varIndex++;\n      return placeholder;\n    });\n\n    // Only extract strings that contain at least one letter or number outside of placeholders.\n    // This avoids extracting strings that are only spaces, special characters, or just variables.\n    const contentWithoutPlaceholders = modifiedContent.replace(/<\\d+>/g, '');\n    if (/[\\p{L}\\p{N}]/u.test(contentWithoutPlaceholders)) {\n      state.extractedContent.push({\n        index: state.currentIndex,\n        path: currentPath,\n        value: modifiedContent,\n        replacement:\n          Object.keys(replacement).length > 0 ? replacement : undefined,\n      });\n      state.translatableDictionary[state.currentIndex] = modifiedContent;\n      state.currentIndex++;\n    }\n  } else if (Array.isArray(content)) {\n    content.forEach((item, index) => {\n      extractTranslatableContent(item, [...currentPath, index], state);\n    });\n  } else if (typeof content === 'object' && content !== null) {\n    for (const key in content) {\n      if (Object.hasOwn(content, key)) {\n        extractTranslatableContent(content[key], [...currentPath, key], state);\n      }\n    }\n  }\n\n  return {\n    extractedContent: state.extractedContent,\n    translatableDictionary: state.translatableDictionary,\n  };\n};\n\nexport const reinsertTranslatedContent = (\n  baseContent: any,\n  extractedContentProps: ExtractedContentProps[],\n  translatedDictionary: Record<number, string>\n): any => {\n  const result = structuredClone(baseContent);\n\n  for (const { index, path, replacement } of extractedContentProps) {\n    let translatedValue = translatedDictionary[index];\n\n    if (translatedValue !== undefined) {\n      if (replacement) {\n        for (const [placeholder, originalVar] of Object.entries(replacement)) {\n          translatedValue = translatedValue.replace(placeholder, originalVar);\n        }\n      }\n\n      let current = result;\n      for (let i = 0; i < path.length - 1; i++) {\n        current = current[path[i]];\n      }\n      current[path[path.length - 1]] = translatedValue;\n    }\n  }\n\n  return result;\n};\n"],"mappings":";;;AAYA,MAAa,8BACX,SACA,cAAmC,EAAE,EACrC,QAAQ;CACN,cAAc;CACd,kBAAkB,EAAE;CACpB,wBAAwB,EAAE;CAC3B,KAC0B;AAC3B,KAAI,OAAO,YAAY,UAAU;EAC/B,MAAM,QAAQ;EACd,MAAM,cAAsC,EAAE;EAC9C,IAAI,WAAW;EAEf,MAAM,kBAAkB,QAAQ,QAAQ,QAAQ,aAAa;GAC3D,MAAM,cAAc,IAAI,SAAS;AACjC,eAAY,eAAe;AAC3B;AACA,UAAO;IACP;EAIF,MAAM,6BAA6B,gBAAgB,QAAQ,UAAU,GAAG;AACxE,MAAI,gBAAgB,KAAK,2BAA2B,EAAE;AACpD,SAAM,iBAAiB,KAAK;IAC1B,OAAO,MAAM;IACb,MAAM;IACN,OAAO;IACP,aACE,OAAO,KAAK,YAAY,CAAC,SAAS,IAAI,cAAc;IACvD,CAAC;AACF,SAAM,uBAAuB,MAAM,gBAAgB;AACnD,SAAM;;YAEC,MAAM,QAAQ,QAAQ,CAC/B,SAAQ,SAAS,MAAM,UAAU;AAC/B,6BAA2B,MAAM,CAAC,GAAG,aAAa,MAAM,EAAE,MAAM;GAChE;UACO,OAAO,YAAY,YAAY,YAAY,MACpD;OAAK,MAAM,OAAO,QAChB,KAAI,OAAO,OAAO,SAAS,IAAI,CAC7B,4BAA2B,QAAQ,MAAM,CAAC,GAAG,aAAa,IAAI,EAAE,MAAM;;AAK5E,QAAO;EACL,kBAAkB,MAAM;EACxB,wBAAwB,MAAM;EAC/B;;AAGH,MAAa,6BACX,aACA,uBACA,yBACQ;CACR,MAAM,SAAS,gBAAgB,YAAY;AAE3C,MAAK,MAAM,EAAE,OAAO,MAAM,iBAAiB,uBAAuB;EAChE,IAAI,kBAAkB,qBAAqB;AAE3C,MAAI,oBAAoB,QAAW;AACjC,OAAI,YACF,MAAK,MAAM,CAAC,aAAa,gBAAgB,OAAO,QAAQ,YAAY,CAClE,mBAAkB,gBAAgB,QAAQ,aAAa,YAAY;GAIvE,IAAI,UAAU;AACd,QAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,IACnC,WAAU,QAAQ,KAAK;AAEzB,WAAQ,KAAK,KAAK,SAAS,MAAM;;;AAIrC,QAAO"}

package/dist/cjs/fill/fill.cjs

@@ -13,6 +13,7 @@ let _intlayer_config_colors = require("@intlayer/config/colors");
 _intlayer_config_colors = require_runtime.__toESM(_intlayer_config_colors);
 let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_config_node = require("@intlayer/config/node");
+let _intlayer_ai = require("@intlayer/ai");
 
 //#region src/fill/fill.ts
 const NB_CONCURRENT_TRANSLATIONS = 7;
@@ -32,10 +33,15 @@ const fill = async (options) => {
 	const aiResult = await require_utils_setupAI.setupAI(configuration, options?.aiOptions);
 	if (!aiResult?.hasAIAccess) return;
 	const { aiClient, aiConfig } = aiResult;
+	const { hasAIAccess, error } = await (0, _intlayer_ai.checkAISDKAccess)(aiConfig);
+	if (!hasAIAccess) {
+		appLogger(`${_intlayer_config_logger.x} ${error}`);
+		return;
+	}
 	const targetUnmergedDictionaries = await require_getTargetDictionary.getTargetUnmergedDictionaries(options);
-	const sourceDictionaries = await (0, _intlayer_chokidar_build.loadContentDeclarations)([...new Set(targetUnmergedDictionaries.map((unmergedDictionary) => unmergedDictionary.filePath).filter(Boolean))].map((sourcePath) => (0, node_path.join)(configuration.system.baseDir, sourcePath)), configuration);
+	const sourceDictionaries = await (0, _intlayer_chokidar_build.loadContentDeclarations)([...new Set(targetUnmergedDictionaries.filter((unmergedDictionary) => unmergedDictionary.location !== "remote").map((unmergedDictionary) => unmergedDictionary.filePath).filter(Boolean))].map((sourcePath) => (0, node_path.join)(configuration.system.baseDir, sourcePath)), configuration, void 0, { logError: false });
 	const originalFillByPath = /* @__PURE__ */ new Map();
-	for (const dict of sourceDictionaries) if (dict.filePath) originalFillByPath.set(dict.filePath, dict.fill);
+	for (const dictionary of sourceDictionaries) if (dictionary.filePath) originalFillByPath.set(dictionary.filePath, dictionary.fill);
 	const affectedDictionaryKeys = /* @__PURE__ */ new Set();
 	targetUnmergedDictionaries.forEach((dict) => {
 		affectedDictionaryKeys.add(dict.key);

package/dist/cjs/fill/fill.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fill.cjs","names":["ensureArray","setupAI","getTargetUnmergedDictionaries","ANSIColors","listTranslationsTasks","translateDictionary","writeFill"],"sources":["../../../src/fill/fill.ts"],"sourcesContent":["import { basename, join, relative } from 'node:path';\nimport type { AIOptions } from '@intlayer/api';\nimport {\n  loadContentDeclarations,\n  prepareIntlayer,\n  writeContentDeclaration,\n} from '@intlayer/chokidar/build';\nimport {\n  type ListGitFilesOptions,\n  logConfigDetails,\n} from '@intlayer/chokidar/cli';\nimport {\n  formatPath,\n  getGlobalLimiter,\n  getTaskLimiter,\n} from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colorize,\n  colorizeKey,\n  colorizePath,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { Fill } from '@intlayer/types/dictionary';\nimport {\n  ensureArray,\n  type GetTargetDictionaryOptions,\n  getTargetUnmergedDictionaries,\n} from '../getTargetDictionary';\nimport { setupAI } from '../utils/setupAI';\nimport {\n  listTranslationsTasks,\n  type TranslationTask,\n} from './listTranslationsTasks';\nimport { translateDictionary } from './translateDictionary';\nimport { writeFill } from './writeFill';\n\nconst NB_CONCURRENT_TRANSLATIONS = 7;\n\n// Arguments for the fill function\nexport type FillOptions = {\n  sourceLocale?: Locale;\n  outputLocales?: Locale | Locale[];\n  mode?: 'complete' | 'review';\n  gitOptions?: ListGitFilesOptions;\n  aiOptions?: AIOptions; // Added aiOptions to be passed to translateJSON\n  verbose?: boolean;\n  nbConcurrentTranslations?: number;\n  nbConcurrentTasks?: number; // NEW: number of tasks that may run at once\n  build?: boolean;\n  skipMetadata?: boolean;\n} & GetTargetDictionaryOptions;\n\n/**\n * Fill translations based on the provided options.\n */\nexport const fill = async (options?: FillOptions): Promise<void> => {\n  const configuration = getConfiguration(options?.configOptions);\n  logConfigDetails(options?.configOptions);\n\n  const appLogger = getAppLogger(configuration);\n\n  if (options?.build === true) {\n    await prepareIntlayer(configuration, { forceRun: true });\n  } else if (typeof options?.build === 'undefined') {\n    await prepareIntlayer(configuration);\n  }\n\n  const { defaultLocale, locales } = configuration.internationalization;\n  const mode = options?.mode ?? 'complete';\n  const baseLocale = options?.sourceLocale ?? defaultLocale;\n\n  const outputLocales = options?.outputLocales\n    ? ensureArray(options.outputLocales)\n    : locales;\n\n  const aiResult = await setupAI(configuration, options?.aiOptions);\n\n  if (!aiResult?.hasAIAccess) return;\n\n  const { aiClient, aiConfig } = aiResult;\n\n  const targetUnmergedDictionaries =\n    await getTargetUnmergedDictionaries(options);\n\n  // Load the original source content declaration files to recover function-type\n  // `fill` values that are lost when dictionaries are JSON-serialised into\n  // unmerged_dictionaries.cjs.  Dictionary-level fill takes priority over the\n  // config-level fill, but we can only know that by reading the source files.\n  const uniqueSourcePaths = [\n    ...new Set(\n      targetUnmergedDictionaries\n        .map((unmergedDictionary) => unmergedDictionary.filePath)\n        .filter(Boolean) as string[]\n    ),\n  ];\n  const sourceDictionaries = await loadContentDeclarations(\n    uniqueSourcePaths.map((sourcePath) =>\n      join(configuration.system.baseDir, sourcePath)\n    ),\n    configuration\n  );\n  // Map relative filePath → original fill value from the source file\n  const originalFillByPath = new Map<string, Fill | undefined>();\n\n  for (const dict of sourceDictionaries) {\n    if (dict.filePath) {\n      originalFillByPath.set(dict.filePath, dict.fill as Fill | undefined);\n    }\n  }\n\n  const affectedDictionaryKeys = new Set<string>();\n  targetUnmergedDictionaries.forEach((dict) => {\n    affectedDictionaryKeys.add(dict.key);\n  });\n\n  const keysToProcess = Array.from(affectedDictionaryKeys);\n\n  appLogger([\n    'Affected dictionary keys for processing:',\n    keysToProcess.length > 0\n      ? keysToProcess.map((key) => colorizeKey(key)).join(', ')\n      : colorize('No keys found', ANSIColors.YELLOW),\n  ]);\n\n  if (keysToProcess.length === 0) return;\n\n  /**\n   * List the translations tasks\n   *\n   * Create a list of per-locale dictionaries to translate\n   *\n   * In 'complete' mode, filter only the missing locales to translate\n   */\n  const translationTasks: TranslationTask[] = listTranslationsTasks(\n    targetUnmergedDictionaries.map((dictionary) => dictionary.localId!),\n    outputLocales,\n    mode,\n    baseLocale,\n    configuration\n  );\n\n  // AI calls in flight at once (translateJSON + metadata audit)\n  const nbConcurrentTranslations =\n    options?.nbConcurrentTranslations ?? NB_CONCURRENT_TRANSLATIONS;\n  const globalLimiter = getGlobalLimiter(nbConcurrentTranslations);\n\n  // NEW: number of *tasks* that may run at once (start/prepare/log/write)\n  const nbConcurrentTasks = Math.max(\n    1,\n    Math.min(\n      options?.nbConcurrentTasks ?? nbConcurrentTranslations,\n      translationTasks.length\n    )\n  );\n\n  const taskLimiter = getTaskLimiter(nbConcurrentTasks);\n\n  const runners = translationTasks.map((task) =>\n    taskLimiter(async () => {\n      const relativePath = relative(\n        configuration?.system?.baseDir ?? process.cwd(),\n        task?.dictionaryFilePath ?? ''\n      );\n\n      // log AFTER acquiring a task slot\n      appLogger(\n        `${task.dictionaryPreset} Processing ${colorizePath(basename(relativePath))}`,\n        { level: 'info' }\n      );\n\n      const translationTaskResult = await translateDictionary(\n        task,\n        configuration,\n        {\n          mode,\n          aiOptions: options?.aiOptions,\n          fillMetadata: !options?.skipMetadata,\n          onHandle: globalLimiter,\n          aiClient,\n          aiConfig,\n        }\n      );\n\n      if (!translationTaskResult?.dictionaryOutput) return;\n\n      const { dictionaryOutput, sourceLocale } = translationTaskResult;\n\n      // Determine if we should write to separate files\n      // - If dictionary has explicit fill setting (string, function, or object), use it\n      // - If dictionary is per-locale AND has no explicit fill=false, use global fill config\n      // - If dictionary is multilingual (no locale property), always write to same file\n      //\n      // NOTE: function-type fill values are lost during JSON serialisation of\n      // unmerged_dictionaries.cjs.  We recover them by checking the original\n      // source file that was loaded above (originalFillByPath).  Dictionary-level\n      // fill always takes priority over config-level fill.\n      const originalFill = originalFillByPath.get(\n        dictionaryOutput.filePath ?? ''\n      );\n\n      // originalFill is undefined when the source file had no fill property; use\n      // the (possibly JSON-preserved) dictionaryOutput.fill as a fallback so that\n      // string/boolean fill values set directly on the dict still work.\n      const dictFill: Fill | undefined =\n        originalFill !== undefined ? originalFill : dictionaryOutput.fill;\n\n      const hasDictionaryLevelFill =\n        typeof dictFill === 'string' ||\n        typeof dictFill === 'function' ||\n        (typeof dictFill === 'object' && dictFill !== null);\n\n      const isPerLocale = typeof dictionaryOutput.locale === 'string';\n\n      const effectiveFill = hasDictionaryLevelFill\n        ? dictFill\n        : isPerLocale\n          ? (configuration.dictionary?.fill ?? true)\n          : (configuration.dictionary?.fill ?? false); // Multilingual dictionaries use config-level fill if set\n\n      const isFillOtherFile =\n        typeof effectiveFill === 'string' ||\n        typeof effectiveFill === 'function' ||\n        (typeof effectiveFill === 'object' && effectiveFill !== null);\n\n      if (isFillOtherFile) {\n        await writeFill(\n          {\n            ...dictionaryOutput,\n            // Ensure fill is set on the dictionary for writeFill to use\n            fill: effectiveFill,\n          },\n          outputLocales,\n          [sourceLocale],\n          configuration\n        );\n      } else {\n        await writeContentDeclaration(dictionaryOutput, configuration);\n\n        if (dictionaryOutput.filePath) {\n          appLogger(\n            `${task.dictionaryPreset} Content declaration written to ${formatPath(basename(dictionaryOutput.filePath))}`,\n            { level: 'info' }\n          );\n        }\n      }\n    })\n  );\n\n  await Promise.all(runners);\n  await (globalLimiter as any).onIdle();\n};\n"],"mappings":"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"}
+{"version":3,"file":"fill.cjs","names":["ensureArray","setupAI","x","getTargetUnmergedDictionaries","ANSIColors","listTranslationsTasks","translateDictionary","writeFill"],"sources":["../../../src/fill/fill.ts"],"sourcesContent":["import { basename, join, relative } from 'node:path';\nimport { checkAISDKAccess } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport {\n  loadContentDeclarations,\n  prepareIntlayer,\n  writeContentDeclaration,\n} from '@intlayer/chokidar/build';\nimport {\n  type ListGitFilesOptions,\n  logConfigDetails,\n} from '@intlayer/chokidar/cli';\nimport {\n  formatPath,\n  getGlobalLimiter,\n  getTaskLimiter,\n} from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colorize,\n  colorizeKey,\n  colorizePath,\n  getAppLogger,\n  x,\n} from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { Fill } from '@intlayer/types/dictionary';\nimport {\n  ensureArray,\n  type GetTargetDictionaryOptions,\n  getTargetUnmergedDictionaries,\n} from '../getTargetDictionary';\nimport { setupAI } from '../utils/setupAI';\nimport {\n  listTranslationsTasks,\n  type TranslationTask,\n} from './listTranslationsTasks';\nimport { translateDictionary } from './translateDictionary';\nimport { writeFill } from './writeFill';\n\nconst NB_CONCURRENT_TRANSLATIONS = 7;\n\n// Arguments for the fill function\nexport type FillOptions = {\n  sourceLocale?: Locale;\n  outputLocales?: Locale | Locale[];\n  mode?: 'complete' | 'review';\n  gitOptions?: ListGitFilesOptions;\n  aiOptions?: AIOptions; // Added aiOptions to be passed to translateJSON\n  verbose?: boolean;\n  nbConcurrentTranslations?: number;\n  nbConcurrentTasks?: number; // NEW: number of tasks that may run at once\n  build?: boolean;\n  skipMetadata?: boolean;\n} & GetTargetDictionaryOptions;\n\n/**\n * Fill translations based on the provided options.\n */\nexport const fill = async (options?: FillOptions): Promise<void> => {\n  const configuration = getConfiguration(options?.configOptions);\n  logConfigDetails(options?.configOptions);\n\n  const appLogger = getAppLogger(configuration);\n\n  if (options?.build === true) {\n    await prepareIntlayer(configuration, { forceRun: true });\n  } else if (typeof options?.build === 'undefined') {\n    await prepareIntlayer(configuration);\n  }\n\n  const { defaultLocale, locales } = configuration.internationalization;\n  const mode = options?.mode ?? 'complete';\n  const baseLocale = options?.sourceLocale ?? defaultLocale;\n\n  const outputLocales = options?.outputLocales\n    ? ensureArray(options.outputLocales)\n    : locales;\n\n  const aiResult = await setupAI(configuration, options?.aiOptions);\n\n  if (!aiResult?.hasAIAccess) return;\n\n  const { aiClient, aiConfig } = aiResult;\n\n  const { hasAIAccess, error } = await checkAISDKAccess(aiConfig!);\n  if (!hasAIAccess) {\n    appLogger(`${x} ${error}`);\n    return;\n  }\n\n  const targetUnmergedDictionaries =\n    await getTargetUnmergedDictionaries(options);\n\n  // Load the original source content declaration files to recover function-type\n  // `fill` values that are lost when dictionaries are JSON-serialised into\n  // unmerged_dictionaries.cjs.  Dictionary-level fill takes priority over the\n  // config-level fill, but we can only know that by reading the source files.\n  const uniqueSourcePaths = [\n    ...new Set(\n      targetUnmergedDictionaries\n        .filter(\n          (unmergedDictionary) => unmergedDictionary.location !== 'remote'\n        )\n        .map((unmergedDictionary) => unmergedDictionary.filePath)\n        .filter(Boolean) as string[]\n    ),\n  ];\n  const sourceDictionaries = await loadContentDeclarations(\n    uniqueSourcePaths.map((sourcePath) =>\n      join(configuration.system.baseDir, sourcePath)\n    ),\n    configuration,\n    undefined,\n    {\n      logError: false,\n    }\n  );\n  // Map relative filePath → original fill value from the source file\n  const originalFillByPath = new Map<string, Fill | undefined>();\n\n  for (const dictionary of sourceDictionaries) {\n    if (dictionary.filePath) {\n      originalFillByPath.set(\n        dictionary.filePath,\n        dictionary.fill as Fill | undefined\n      );\n    }\n  }\n\n  const affectedDictionaryKeys = new Set<string>();\n\n  targetUnmergedDictionaries.forEach((dict) => {\n    affectedDictionaryKeys.add(dict.key);\n  });\n\n  const keysToProcess = Array.from(affectedDictionaryKeys);\n\n  appLogger([\n    'Affected dictionary keys for processing:',\n    keysToProcess.length > 0\n      ? keysToProcess.map((key) => colorizeKey(key)).join(', ')\n      : colorize('No keys found', ANSIColors.YELLOW),\n  ]);\n\n  if (keysToProcess.length === 0) return;\n\n  /**\n   * List the translations tasks\n   *\n   * Create a list of per-locale dictionaries to translate\n   *\n   * In 'complete' mode, filter only the missing locales to translate\n   */\n  const translationTasks: TranslationTask[] = listTranslationsTasks(\n    targetUnmergedDictionaries.map((dictionary) => dictionary.localId!),\n    outputLocales,\n    mode,\n    baseLocale,\n    configuration\n  );\n\n  // AI calls in flight at once (translateJSON + metadata audit)\n  const nbConcurrentTranslations =\n    options?.nbConcurrentTranslations ?? NB_CONCURRENT_TRANSLATIONS;\n  const globalLimiter = getGlobalLimiter(nbConcurrentTranslations);\n\n  // NEW: number of *tasks* that may run at once (start/prepare/log/write)\n  const nbConcurrentTasks = Math.max(\n    1,\n    Math.min(\n      options?.nbConcurrentTasks ?? nbConcurrentTranslations,\n      translationTasks.length\n    )\n  );\n\n  const taskLimiter = getTaskLimiter(nbConcurrentTasks);\n\n  const runners = translationTasks.map((task) =>\n    taskLimiter(async () => {\n      const relativePath = relative(\n        configuration?.system?.baseDir ?? process.cwd(),\n        task?.dictionaryFilePath ?? ''\n      );\n\n      // log AFTER acquiring a task slot\n      appLogger(\n        `${task.dictionaryPreset} Processing ${colorizePath(basename(relativePath))}`,\n        { level: 'info' }\n      );\n\n      const translationTaskResult = await translateDictionary(\n        task,\n        configuration,\n        {\n          mode,\n          aiOptions: options?.aiOptions,\n          fillMetadata: !options?.skipMetadata,\n          onHandle: globalLimiter,\n          aiClient,\n          aiConfig,\n        }\n      );\n\n      if (!translationTaskResult?.dictionaryOutput) return;\n\n      const { dictionaryOutput, sourceLocale } = translationTaskResult;\n\n      // Determine if we should write to separate files\n      // - If dictionary has explicit fill setting (string, function, or object), use it\n      // - If dictionary is per-locale AND has no explicit fill=false, use global fill config\n      // - If dictionary is multilingual (no locale property), always write to same file\n      //\n      // NOTE: function-type fill values are lost during JSON serialisation of\n      // unmerged_dictionaries.cjs.  We recover them by checking the original\n      // source file that was loaded above (originalFillByPath).  Dictionary-level\n      // fill always takes priority over config-level fill.\n      const originalFill = originalFillByPath.get(\n        dictionaryOutput.filePath ?? ''\n      );\n\n      // originalFill is undefined when the source file had no fill property; use\n      // the (possibly JSON-preserved) dictionaryOutput.fill as a fallback so that\n      // string/boolean fill values set directly on the dict still work.\n      const dictFill: Fill | undefined =\n        originalFill !== undefined ? originalFill : dictionaryOutput.fill;\n\n      const hasDictionaryLevelFill =\n        typeof dictFill === 'string' ||\n        typeof dictFill === 'function' ||\n        (typeof dictFill === 'object' && dictFill !== null);\n\n      const isPerLocale = typeof dictionaryOutput.locale === 'string';\n\n      const effectiveFill = hasDictionaryLevelFill\n        ? dictFill\n        : isPerLocale\n          ? (configuration.dictionary?.fill ?? true)\n          : (configuration.dictionary?.fill ?? false); // Multilingual dictionaries use config-level fill if set\n\n      const isFillOtherFile =\n        typeof effectiveFill === 'string' ||\n        typeof effectiveFill === 'function' ||\n        (typeof effectiveFill === 'object' && effectiveFill !== null);\n\n      if (isFillOtherFile) {\n        await writeFill(\n          {\n            ...dictionaryOutput,\n            // Ensure fill is set on the dictionary for writeFill to use\n            fill: effectiveFill,\n          },\n          outputLocales,\n          [sourceLocale],\n          configuration\n        );\n      } else {\n        await writeContentDeclaration(dictionaryOutput, configuration);\n\n        if (dictionaryOutput.filePath) {\n          appLogger(\n            `${task.dictionaryPreset} Content declaration written to ${formatPath(basename(dictionaryOutput.filePath))}`,\n            { level: 'info' }\n          );\n        }\n      }\n    })\n  );\n\n  await Promise.all(runners);\n  await (globalLimiter as any).onIdle();\n};\n"],"mappings":"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"}

package/dist/cjs/fill/translateDictionary.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_fill_deepMergeContent = require('./deepMergeContent.cjs');
-const require_fill_getFilterMissingContentPerLocale = require('./getFilterMissingContentPerLocale.cjs');
+const require_fill_extractTranslatableContent = require('./extractTranslatableContent.cjs');
 let node_path = require("node:path");
 let _intlayer_chokidar_utils = require("@intlayer/chokidar/utils");
 let _intlayer_config_colors = require("@intlayer/config/colors");
@@ -13,39 +13,26 @@ let _intlayer_api = require("@intlayer/api");
 let _intlayer_config_utils = require("@intlayer/config/utils");
 
 //#region src/fill/translateDictionary.ts
+const createChunkPreset = (chunkIndex, totalChunks) => {
+	if (totalChunks <= 1) return "";
+	return (0, _intlayer_config_logger.colon)([
+		(0, _intlayer_config_logger.colorize)("[", _intlayer_config_colors.GREY_DARK),
+		(0, _intlayer_config_logger.colorizeNumber)(chunkIndex + 1),
+		(0, _intlayer_config_logger.colorize)(`/${totalChunks}`, _intlayer_config_colors.GREY_DARK),
+		(0, _intlayer_config_logger.colorize)("]", _intlayer_config_colors.GREY_DARK)
+	].join(""), { colSize: 5 });
+};
 const hasMissingMetadata = (dictionary) => !dictionary.description || !dictionary.title || !dictionary.tags;
-/**
-* Recursively strips null values from an object, returning the cleaned content
-* and a separate object containing only the null-valued paths so they can be
-* re-injected after AI translation (nulls don't need translation).
-*/
-const stripNullValues = (obj) => {
-	if (typeof obj !== "object" || obj === null || Array.isArray(obj)) return {
-		content: obj,
-		nulls: void 0,
-		hasNulls: false
-	};
-	const content = {};
-	const nulls = {};
-	let hasNulls = false;
-	for (const [key, value] of Object.entries(obj)) if (value === null) {
-		nulls[key] = null;
-		hasNulls = true;
-	} else {
-		const child = stripNullValues(value);
-		content[key] = child.content;
-		if (child.hasNulls) {
-			nulls[key] = child.nulls;
-			hasNulls = true;
-		}
+const serializeError = (error) => {
+	if (error instanceof Error) return error.cause ? `${error.message} (cause: ${String(error.cause)})` : error.message;
+	if (typeof error === "string") return error;
+	try {
+		return JSON.stringify(error);
+	} catch {
+		return String(error);
 	}
-	return {
-		content,
-		nulls: hasNulls ? nulls : void 0,
-		hasNulls
-	};
 };
-const CHUNK_SIZE = 7e3;
+const CHUNK_SIZE = 1500;
 const GROUP_MAX_RETRY = 2;
 const MAX_RETRY = 3;
 const RETRY_DELAY = 1e3 * 10;
@@ -103,51 +90,42 @@ const translateDictionary = async (task, configuration, options) => {
 			let targetLocaleDictionary;
 			if (typeof baseUnmergedDictionary.locale === "string") {
 				const targetLocaleFilePath = baseUnmergedDictionary.filePath?.replace(new RegExp(`/${task.sourceLocale}/`, "g"), `/${targetLocale}/`);
-				const targetUnmergedDictionary = targetLocaleFilePath ? unmergedDictionariesRecord[task.dictionaryKey]?.find((dict) => dict.filePath === targetLocaleFilePath && dict.locale === targetLocale) : void 0;
-				targetLocaleDictionary = targetUnmergedDictionary ?? {
+				targetLocaleDictionary = (targetLocaleFilePath ? unmergedDictionariesRecord[task.dictionaryKey]?.find((dict) => dict.filePath === targetLocaleFilePath && dict.locale === targetLocale) : void 0) ?? {
 					key: baseUnmergedDictionary.key,
 					content: {},
 					filePath: targetLocaleFilePath,
 					locale: targetLocale
 				};
-				if (mode === "complete") dictionaryToProcess = require_fill_getFilterMissingContentPerLocale.getFilterMissingContentPerLocale(dictionaryToProcess, targetUnmergedDictionary);
 			} else {
 				if (mode === "complete") dictionaryToProcess = (0, _intlayer_core_plugins.getFilterMissingTranslationsDictionary)(dictionaryToProcess, targetLocale);
 				dictionaryToProcess = (0, _intlayer_core_plugins.getPerLocaleDictionary)(dictionaryToProcess, task.sourceLocale);
 				targetLocaleDictionary = (0, _intlayer_core_plugins.getPerLocaleDictionary)(baseUnmergedDictionary, targetLocale);
 			}
+			if (mode === "complete") dictionaryToProcess = {
+				...dictionaryToProcess,
+				content: (0, _intlayer_chokidar_utils.excludeObjectFormat)(dictionaryToProcess.content, targetLocaleDictionary.content) ?? {}
+			};
 			const localePreset = (0, _intlayer_config_logger.colon)([
 				(0, _intlayer_config_logger.colorize)("[", _intlayer_config_colors.GREY_DARK),
 				(0, _intlayer_chokidar_utils.formatLocale)(targetLocale),
 				(0, _intlayer_config_logger.colorize)("]", _intlayer_config_colors.GREY_DARK)
 			].join(""), { colSize: 18 });
-			const createChunkPreset = (chunkIndex, totalChunks) => {
-				if (totalChunks <= 1) return "";
-				return (0, _intlayer_config_logger.colon)([
-					(0, _intlayer_config_logger.colorize)("[", _intlayer_config_colors.GREY_DARK),
-					(0, _intlayer_config_logger.colorizeNumber)(chunkIndex + 1),
-					(0, _intlayer_config_logger.colorize)(`/${totalChunks}`, _intlayer_config_colors.GREY_DARK),
-					(0, _intlayer_config_logger.colorize)("]", _intlayer_config_colors.GREY_DARK)
-				].join(""), { colSize: 5 });
-			};
 			appLogger(`${task.dictionaryPreset}${localePreset} Preparing ${(0, _intlayer_config_logger.colorizePath)((0, node_path.basename)(targetLocaleDictionary.filePath))}`, { level: "info" });
-			const isContentStructured = typeof dictionaryToProcess.content === "object" && dictionaryToProcess.content !== null || Array.isArray(dictionaryToProcess.content);
-			const { content: contentToProcess, nulls: strippedNullValues } = stripNullValues(isContentStructured ? dictionaryToProcess.content : { __INTLAYER_ROOT_PRIMITIVE_CONTENT__: dictionaryToProcess.content });
-			const chunkedJsonContent = (0, _intlayer_chokidar_utils.chunkJSON)(contentToProcess, CHUNK_SIZE);
+			const chunkedJsonContent = (0, _intlayer_chokidar_utils.chunkJSON)(dictionaryToProcess.content, CHUNK_SIZE);
 			const nbOfChunks = chunkedJsonContent.length;
 			if (nbOfChunks > 1) appLogger(`${task.dictionaryPreset}${localePreset} Split into ${(0, _intlayer_config_logger.colorizeNumber)(nbOfChunks)} chunks for translation`, { level: "info" });
 			const chunkResult = [];
-			const chunkPromises = chunkedJsonContent.map((chunk) => {
+			const chunkPromises = chunkedJsonContent.map(async (chunk) => {
 				const chunkPreset = createChunkPreset(chunk.index, chunk.total);
 				if (nbOfChunks > 1) appLogger(`${task.dictionaryPreset}${localePreset}${chunkPreset} Translating chunk`, { level: "info" });
-				const chunkContent = (0, _intlayer_chokidar_utils.reconstructFromSingleChunk)(chunk);
-				const presetOutputContent = (0, _intlayer_chokidar_utils.reduceObjectFormat)(isContentStructured ? targetLocaleDictionary.content : { __INTLAYER_ROOT_PRIMITIVE_CONTENT__: targetLocaleDictionary.content }, chunkContent);
+				const reconstructedChunk = (0, _intlayer_chokidar_utils.reconstructFromSingleChunk)(chunk);
+				const { extractedContent: chunkExtractedContent, translatableDictionary: chunkTranslatableDictionary } = require_fill_extractTranslatableContent.extractTranslatableContent(reconstructedChunk);
 				const executeTranslation = async () => {
 					return await (0, _intlayer_config_utils.retryManager)(async () => {
 						let translationResult;
 						if (aiClient && aiConfig) translationResult = await aiClient.translateJSON({
-							entryFileContent: chunkContent,
-							presetOutputContent,
+							entryFileContent: chunkTranslatableDictionary,
+							presetOutputContent: chunkTranslatableDictionary,
 							dictionaryDescription: dictionaryToProcess.description ?? metadata?.description ?? "",
 							entryLocale: task.sourceLocale,
 							outputLocale: targetLocale,
@@ -155,8 +133,8 @@ const translateDictionary = async (task, configuration, options) => {
 							aiConfig
 						});
 						else translationResult = await intlayerAPI.ai.translateJSON({
-							entryFileContent: chunkContent,
-							presetOutputContent,
+							entryFileContent: chunkTranslatableDictionary,
+							presetOutputContent: chunkTranslatableDictionary,
 							dictionaryDescription: dictionaryToProcess.description ?? metadata?.description ?? "",
 							entryLocale: task.sourceLocale,
 							outputLocale: targetLocale,
@@ -164,16 +142,16 @@ const translateDictionary = async (task, configuration, options) => {
 							aiOptions
 						}).then((result) => result.data);
 						if (!translationResult?.fileContent) throw new Error("No content result");
-						const { isIdentic } = (0, _intlayer_chokidar_utils.verifyIdenticObjectFormat)(translationResult.fileContent, chunkContent);
-						if (!isIdentic) throw new Error("Translation result does not match expected format");
+						const { isIdentic, error } = (0, _intlayer_chokidar_utils.verifyIdenticObjectFormat)(translationResult.fileContent, chunkTranslatableDictionary);
+						if (!isIdentic) throw new Error(`Translation result does not match expected format: ${error}`);
 						notifySuccess();
-						return translationResult.fileContent;
+						return require_fill_extractTranslatableContent.reinsertTranslatedContent(reconstructedChunk, chunkExtractedContent, translationResult.fileContent);
 					}, {
 						maxRetry: MAX_RETRY,
 						delay: RETRY_DELAY,
 						onError: ({ error, attempt, maxRetry }) => {
 							const chunkPreset = createChunkPreset(chunk.index, chunk.total);
-							appLogger(`${task.dictionaryPreset}${localePreset}${chunkPreset} ${(0, _intlayer_config_logger.colorize)("Error filling:", _intlayer_config_colors.RED)} ${(0, _intlayer_config_logger.colorize)(typeof error === "string" ? error : JSON.stringify(error), _intlayer_config_colors.GREY_DARK)} - Attempt ${(0, _intlayer_config_logger.colorizeNumber)(attempt + 1)} of ${(0, _intlayer_config_logger.colorizeNumber)(maxRetry)}`, { level: "error" });
+							appLogger(`${task.dictionaryPreset}${localePreset}${chunkPreset} ${(0, _intlayer_config_logger.colorize)("Error filling:", _intlayer_config_colors.RED)} ${(0, _intlayer_config_logger.colorize)(serializeError(error), _intlayer_config_colors.GREY_DARK)} - Attempt ${(0, _intlayer_config_logger.colorizeNumber)(attempt + 1)} of ${(0, _intlayer_config_logger.colorizeNumber)(maxRetry)}`, { level: "error" });
 							followingErrors += 1;
 							if (followingErrors >= MAX_FOLLOWING_ERRORS) {
 								appLogger(`There is something wrong.`, { level: "error" });
@@ -190,15 +168,12 @@ const translateDictionary = async (task, configuration, options) => {
 			(await Promise.all(chunkPromises)).sort((chunkA, chunkB) => chunkA.chunk.index - chunkB.chunk.index).forEach(({ result }) => {
 				chunkResult.push(result);
 			});
-			let mergedContent = (0, _intlayer_chokidar_utils.mergeChunks)(chunkResult);
-			if (strippedNullValues) mergedContent = require_fill_deepMergeContent.deepMergeContent(mergedContent, strippedNullValues);
-			let finalContent = {
+			const reinsertedContent = (0, _intlayer_chokidar_utils.mergeChunks)(chunkResult);
+			const merged = {
 				...dictionaryToProcess,
-				content: mergedContent
-			}.content;
-			if (!isContentStructured) finalContent = finalContent?.__INTLAYER_ROOT_PRIMITIVE_CONTENT__;
-			if (typeof baseUnmergedDictionary.locale === "string") finalContent = require_fill_deepMergeContent.deepMergeContent(targetLocaleDictionary.content ?? {}, finalContent);
-			return [targetLocale, finalContent];
+				content: reinsertedContent
+			};
+			return [targetLocale, require_fill_deepMergeContent.deepMergeContent(targetLocaleDictionary.content ?? {}, merged.content)];
 		}));
 		const translatedContent = Object.fromEntries(translatedContentResults);
 		let dictionaryOutput = {
@@ -232,8 +207,8 @@ const translateDictionary = async (task, configuration, options) => {
 	}, {
 		maxRetry: GROUP_MAX_RETRY,
 		delay: RETRY_DELAY,
-		onError: ({ error, attempt, maxRetry }) => appLogger(`${task.dictionaryPreset} ${(0, _intlayer_config_logger.colorize)("Error:", _intlayer_config_colors.RED)} ${(0, _intlayer_config_logger.colorize)(typeof error === "string" ? error : JSON.stringify(error), _intlayer_config_colors.GREY_DARK)} - Attempt ${(0, _intlayer_config_logger.colorizeNumber)(attempt + 1)} of ${(0, _intlayer_config_logger.colorizeNumber)(maxRetry)}`, { level: "error" }),
-		onMaxTryReached: ({ error }) => appLogger(`${task.dictionaryPreset} ${(0, _intlayer_config_logger.colorize)("Maximum number of retries reached:", _intlayer_config_colors.RED)} ${(0, _intlayer_config_logger.colorize)(typeof error === "string" ? error : JSON.stringify(error), _intlayer_config_colors.GREY_DARK)}`, { level: "error" })
+		onError: ({ error, attempt, maxRetry }) => appLogger(`${task.dictionaryPreset} ${(0, _intlayer_config_logger.colorize)("Error:", _intlayer_config_colors.RED)} ${(0, _intlayer_config_logger.colorize)(serializeError(error), _intlayer_config_colors.GREY_DARK)} - Attempt ${(0, _intlayer_config_logger.colorizeNumber)(attempt + 1)} of ${(0, _intlayer_config_logger.colorizeNumber)(maxRetry)}`, { level: "error" }),
+		onMaxTryReached: ({ error }) => appLogger(`${task.dictionaryPreset} ${(0, _intlayer_config_logger.colorize)("Maximum number of retries reached:", _intlayer_config_colors.RED)} ${(0, _intlayer_config_logger.colorize)(serializeError(error), _intlayer_config_colors.GREY_DARK)}`, { level: "error" })
 	})();
 };
 

package/dist/cjs/fill/translateDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"translateDictionary.cjs","names":["getFilterMissingContentPerLocale","ANSIColors","deepMergeContent"],"sources":["../../../src/fill/translateDictionary.ts"],"sourcesContent":["import { basename } from 'node:path';\nimport type { AIConfig } from '@intlayer/ai';\nimport { type AIOptions, getIntlayerAPIProxy } from '@intlayer/api';\nimport {\n  chunkJSON,\n  formatLocale,\n  type JsonChunk,\n  mergeChunks,\n  reconstructFromSingleChunk,\n  reduceObjectFormat,\n  verifyIdenticObjectFormat,\n} from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  colorizePath,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport { retryManager } from '@intlayer/config/utils';\nimport {\n  getFilterMissingTranslationsDictionary,\n  getMultilingualDictionary,\n  getPerLocaleDictionary,\n  insertContentInDictionary,\n} from '@intlayer/core/plugins';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { getUnmergedDictionaries } from '@intlayer/unmerged-dictionaries-entry';\nimport type { AIClient } from '../utils/setupAI';\nimport { deepMergeContent } from './deepMergeContent';\nimport { getFilterMissingContentPerLocale } from './getFilterMissingContentPerLocale';\nimport type { TranslationTask } from './listTranslationsTasks';\n\ntype TranslateDictionaryResult = TranslationTask & {\n  dictionaryOutput: Dictionary | null;\n};\n\ntype TranslateDictionaryOptions = {\n  mode: 'complete' | 'review';\n  aiOptions?: AIOptions;\n  fillMetadata?: boolean;\n  onHandle?: ReturnType<\n    typeof import('@intlayer/chokidar/utils').getGlobalLimiter\n  >;\n  onSuccess?: () => void;\n  onError?: (error: unknown) => void;\n  getAbortError?: () => Error | null;\n  aiClient?: AIClient;\n  aiConfig?: AIConfig;\n};\n\nconst hasMissingMetadata = (dictionary: Dictionary) =>\n  !dictionary.description || !dictionary.title || !dictionary.tags;\n\n/**\n * Recursively strips null values from an object, returning the cleaned content\n * and a separate object containing only the null-valued paths so they can be\n * re-injected after AI translation (nulls don't need translation).\n */\nconst stripNullValues = (\n  obj: any\n): { content: any; nulls: any; hasNulls: boolean } => {\n  if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {\n    return { content: obj, nulls: undefined, hasNulls: false };\n  }\n\n  const content: any = {};\n  const nulls: any = {};\n  let hasNulls = false;\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (value === null) {\n      nulls[key] = null;\n      hasNulls = true;\n    } else {\n      const child = stripNullValues(value);\n      content[key] = child.content;\n      if (child.hasNulls) {\n        nulls[key] = child.nulls;\n        hasNulls = true;\n      }\n    }\n  }\n\n  return { content, nulls: hasNulls ? nulls : undefined, hasNulls };\n};\n\nconst CHUNK_SIZE = 7000; // GPT-5 Mini safe input size\nconst GROUP_MAX_RETRY = 2;\nconst MAX_RETRY = 3;\nconst RETRY_DELAY = 1000 * 10; // 10 seconds\n\nconst MAX_FOLLOWING_ERRORS = 10; // 10 errors in a row, hard exit the process\nlet followingErrors = 0;\n\nexport const translateDictionary = async (\n  task: TranslationTask,\n  configuration: IntlayerConfig,\n  options?: TranslateDictionaryOptions\n): Promise<TranslateDictionaryResult> => {\n  const appLogger = getAppLogger(configuration);\n  const intlayerAPI = getIntlayerAPIProxy(undefined, configuration);\n\n  const { mode, aiOptions, fillMetadata, aiClient, aiConfig } = {\n    mode: 'complete',\n    fillMetadata: true,\n    ...options,\n  } as const;\n\n  const notifySuccess = () => {\n    followingErrors = 0;\n    options?.onSuccess?.();\n  };\n\n  const result = await retryManager(\n    async () => {\n      const unmergedDictionariesRecord = getUnmergedDictionaries(configuration);\n\n      const baseUnmergedDictionary: Dictionary | undefined =\n        unmergedDictionariesRecord[task.dictionaryKey].find(\n          (dict) => dict.localId === task.dictionaryLocalId\n        );\n\n      if (!baseUnmergedDictionary) {\n        appLogger(\n          `${task.dictionaryPreset}Dictionary not found in unmergedDictionariesRecord. Skipping.`,\n          {\n            level: 'warn',\n          }\n        );\n        return { ...task, dictionaryOutput: null };\n      }\n\n      let metadata:\n        | Pick<Dictionary, 'description' | 'title' | 'tags'>\n        | undefined;\n\n      if (\n        fillMetadata &&\n        (hasMissingMetadata(baseUnmergedDictionary) || mode === 'review')\n      ) {\n        const defaultLocaleDictionary = getPerLocaleDictionary(\n          baseUnmergedDictionary,\n          configuration.internationalization.defaultLocale\n        );\n\n        appLogger(\n          `${task.dictionaryPreset} Filling missing metadata for ${colorizePath(basename(baseUnmergedDictionary.filePath!))}`,\n          {\n            level: 'info',\n          }\n        );\n\n        const runAudit = async () => {\n          if (aiClient && aiConfig) {\n            const result = await aiClient.auditDictionaryMetadata({\n              fileContent: JSON.stringify(defaultLocaleDictionary),\n              aiConfig,\n            });\n\n            return {\n              data: result,\n            };\n          }\n\n          return await intlayerAPI.ai.auditContentDeclarationMetadata({\n            fileContent: JSON.stringify(defaultLocaleDictionary),\n            aiOptions,\n          });\n        };\n\n        const metadataResult = options?.onHandle\n          ? await options.onHandle(runAudit)\n          : await runAudit();\n\n        metadata = metadataResult.data?.fileContent;\n      }\n\n      const translatedContentResults = await Promise.all(\n        task.targetLocales.map(async (targetLocale) => {\n          /**\n           * In complete mode, for large dictionaries, we want to filter all content that is already translated\n           *\n           * targetLocale: fr\n           *\n           * { test1: t({ ar: 'Hello', en: 'Hello', fr: 'Bonjour' } }) -> {}\n           * { test2: t({ ar: 'Hello', en: 'Hello' }) } -> { test2: t({ ar: 'Hello', en: 'Hello' }) }\n           *\n           */\n          // Reset to base dictionary for each locale to ensure we filter from the original\n          let dictionaryToProcess = structuredClone(baseUnmergedDictionary);\n\n          let targetLocaleDictionary: Dictionary;\n\n          if (typeof baseUnmergedDictionary.locale === 'string') {\n            // For per-locale files, the content is already in simple JSON format (not translation nodes)\n            // The base dictionary is already the source locale content\n\n            // Load the existing target locale dictionary\n            const targetLocaleFilePath =\n              baseUnmergedDictionary.filePath?.replace(\n                new RegExp(`/${task.sourceLocale}/`, 'g'),\n                `/${targetLocale}/`\n              );\n\n            // Find the target locale dictionary in unmerged dictionaries\n            const targetUnmergedDictionary = targetLocaleFilePath\n              ? unmergedDictionariesRecord[task.dictionaryKey]?.find(\n                  (dict) =>\n                    dict.filePath === targetLocaleFilePath &&\n                    dict.locale === targetLocale\n                )\n              : undefined;\n\n            targetLocaleDictionary = targetUnmergedDictionary ?? {\n              key: baseUnmergedDictionary.key,\n              content: {},\n              filePath: targetLocaleFilePath,\n              locale: targetLocale,\n            };\n\n            // In complete mode, filter out already translated content\n            if (mode === 'complete') {\n              dictionaryToProcess = getFilterMissingContentPerLocale(\n                dictionaryToProcess,\n                targetUnmergedDictionary\n              );\n            }\n          } else {\n            // For multilingual dictionaries\n            if (mode === 'complete') {\n              // Remove all nodes that don't have any content to translate\n              dictionaryToProcess = getFilterMissingTranslationsDictionary(\n                dictionaryToProcess,\n                targetLocale\n              );\n            }\n\n            dictionaryToProcess = getPerLocaleDictionary(\n              dictionaryToProcess,\n              task.sourceLocale\n            );\n\n            targetLocaleDictionary = getPerLocaleDictionary(\n              baseUnmergedDictionary,\n              targetLocale\n            );\n          }\n\n          const localePreset = colon(\n            [\n              colorize('[', ANSIColors.GREY_DARK),\n              formatLocale(targetLocale),\n              colorize(']', ANSIColors.GREY_DARK),\n            ].join(''),\n            { colSize: 18 }\n          );\n\n          const createChunkPreset = (\n            chunkIndex: number,\n            totalChunks: number\n          ) => {\n            if (totalChunks <= 1) return '';\n            return colon(\n              [\n                colorize('[', ANSIColors.GREY_DARK),\n                colorizeNumber(chunkIndex + 1),\n                colorize(`/${totalChunks}`, ANSIColors.GREY_DARK),\n                colorize(']', ANSIColors.GREY_DARK),\n              ].join(''),\n              { colSize: 5 }\n            );\n          };\n\n          appLogger(\n            `${task.dictionaryPreset}${localePreset} Preparing ${colorizePath(basename(targetLocaleDictionary.filePath!))}`,\n            {\n              level: 'info',\n            }\n          );\n\n          const isContentStructured =\n            (typeof dictionaryToProcess.content === 'object' &&\n              dictionaryToProcess.content !== null) ||\n            Array.isArray(dictionaryToProcess.content);\n\n          const rawContentToProcess = isContentStructured\n            ? dictionaryToProcess.content\n            : {\n                __INTLAYER_ROOT_PRIMITIVE_CONTENT__:\n                  dictionaryToProcess.content,\n              };\n\n          // Strip null values before sending to AI — nulls need no translation\n          // and confuse the model. They will be re-injected after merging.\n          const { content: contentToProcess, nulls: strippedNullValues } =\n            stripNullValues(rawContentToProcess);\n\n          const chunkedJsonContent: JsonChunk[] = chunkJSON(\n            contentToProcess as unknown as Record<string, any>,\n            CHUNK_SIZE\n          );\n\n          const nbOfChunks = chunkedJsonContent.length;\n\n          if (nbOfChunks > 1) {\n            appLogger(\n              `${task.dictionaryPreset}${localePreset} Split into ${colorizeNumber(nbOfChunks)} chunks for translation`,\n              {\n                level: 'info',\n              }\n            );\n          }\n\n          const chunkResult: JsonChunk[] = [];\n\n          // Process chunks in parallel (globally throttled) to allow concurrent translation\n          const chunkPromises = chunkedJsonContent.map((chunk) => {\n            const chunkPreset = createChunkPreset(chunk.index, chunk.total);\n\n            if (nbOfChunks > 1) {\n              appLogger(\n                `${task.dictionaryPreset}${localePreset}${chunkPreset} Translating chunk`,\n                {\n                  level: 'info',\n                }\n              );\n            }\n\n            // Reconstruct partial JSON content from this chunk's patches\n            const chunkContent = reconstructFromSingleChunk(chunk);\n            const presetOutputContent = reduceObjectFormat(\n              isContentStructured\n                ? targetLocaleDictionary.content\n                : {\n                    __INTLAYER_ROOT_PRIMITIVE_CONTENT__:\n                      targetLocaleDictionary.content,\n                  },\n              chunkContent\n            ) as unknown as JSON;\n\n            const executeTranslation = async () => {\n              return await retryManager(\n                async () => {\n                  let translationResult: any;\n\n                  if (aiClient && aiConfig) {\n                    translationResult = await aiClient.translateJSON({\n                      entryFileContent: chunkContent as unknown as JSON,\n                      presetOutputContent,\n                      dictionaryDescription:\n                        dictionaryToProcess.description ??\n                        metadata?.description ??\n                        '',\n                      entryLocale: task.sourceLocale,\n                      outputLocale: targetLocale,\n                      mode,\n                      aiConfig,\n                    });\n                  } else {\n                    translationResult = await intlayerAPI.ai\n                      .translateJSON({\n                        entryFileContent: chunkContent as unknown as JSON,\n                        presetOutputContent,\n                        dictionaryDescription:\n                          dictionaryToProcess.description ??\n                          metadata?.description ??\n                          '',\n                        entryLocale: task.sourceLocale,\n                        outputLocale: targetLocale,\n                        mode,\n                        aiOptions,\n                      })\n                      .then((result) => result.data);\n                  }\n\n                  if (!translationResult?.fileContent) {\n                    throw new Error('No content result');\n                  }\n\n                  const { isIdentic } = verifyIdenticObjectFormat(\n                    translationResult.fileContent,\n                    chunkContent\n                  );\n\n                  if (!isIdentic) {\n                    throw new Error(\n                      'Translation result does not match expected format'\n                    );\n                  }\n\n                  notifySuccess();\n                  return translationResult.fileContent;\n                },\n                {\n                  maxRetry: MAX_RETRY,\n                  delay: RETRY_DELAY,\n                  onError: ({ error, attempt, maxRetry }) => {\n                    const chunkPreset = createChunkPreset(\n                      chunk.index,\n                      chunk.total\n                    );\n                    appLogger(\n                      `${task.dictionaryPreset}${localePreset}${chunkPreset} ${colorize('Error filling:', ANSIColors.RED)} ${colorize(typeof error === 'string' ? error : JSON.stringify(error), ANSIColors.GREY_DARK)} - Attempt ${colorizeNumber(attempt + 1)} of ${colorizeNumber(maxRetry)}`,\n                      {\n                        level: 'error',\n                      }\n                    );\n\n                    followingErrors += 1;\n\n                    if (followingErrors >= MAX_FOLLOWING_ERRORS) {\n                      appLogger(`There is something wrong.`, {\n                        level: 'error',\n                      });\n                      process.exit(1); // 1 for error\n                    }\n                  },\n                }\n              )();\n            };\n\n            const wrapped = options?.onHandle\n              ? options.onHandle(executeTranslation) // queued in global limiter\n              : executeTranslation(); // no global limiter\n\n            return wrapped.then((result) => ({ chunk, result }));\n          });\n\n          // Wait for all chunks for this locale in parallel (still capped by global limiter)\n          const chunkResults = await Promise.all(chunkPromises);\n\n          // Maintain order\n          chunkResults\n            .sort((chunkA, chunkB) => chunkA.chunk.index - chunkB.chunk.index)\n            .forEach(({ result }) => {\n              chunkResult.push(result);\n            });\n\n          // Merge partial JSON objects produced from each chunk into a single object\n          let mergedContent = mergeChunks(chunkResult);\n\n          // Re-inject null values that were stripped before AI translation\n          if (strippedNullValues) {\n            mergedContent = deepMergeContent(mergedContent, strippedNullValues);\n          }\n\n          const merged = {\n            ...dictionaryToProcess,\n            content: mergedContent,\n          };\n\n          // For per-locale files, merge the newly translated content with existing target content\n          let finalContent = merged.content;\n\n          if (!isContentStructured) {\n            finalContent = (finalContent as any)\n              ?.__INTLAYER_ROOT_PRIMITIVE_CONTENT__;\n          }\n\n          if (typeof baseUnmergedDictionary.locale === 'string') {\n            // Deep merge: existing content + newly translated content\n            finalContent = deepMergeContent(\n              targetLocaleDictionary.content ?? {},\n              finalContent\n            );\n          }\n\n          return [targetLocale, finalContent] as const;\n        })\n      );\n\n      const translatedContent: Partial<Record<Locale, Dictionary['content']>> =\n        Object.fromEntries(translatedContentResults);\n\n      const baseDictionary = baseUnmergedDictionary.locale\n        ? {\n            ...baseUnmergedDictionary,\n            key: baseUnmergedDictionary.key!,\n            content: {},\n          }\n        : baseUnmergedDictionary;\n\n      let dictionaryOutput: Dictionary = {\n        ...getMultilingualDictionary(baseDictionary),\n        locale: undefined, // Ensure the dictionary is multilingual\n        ...metadata,\n      };\n\n      for (const targetLocale of task.targetLocales) {\n        if (translatedContent[targetLocale]) {\n          dictionaryOutput = insertContentInDictionary(\n            dictionaryOutput,\n            translatedContent[targetLocale],\n            targetLocale\n          );\n        }\n      }\n\n      appLogger(\n        `${task.dictionaryPreset} ${colorize('Translation completed successfully', ANSIColors.GREEN)} for ${colorizePath(basename(dictionaryOutput.filePath!))}`,\n        {\n          level: 'info',\n        }\n      );\n\n      // The dict-level `fill` value may have been lost during JSON serialisation\n      // (functions can't be serialised to JSON). Fall back to the config-level\n      // fill so that an explicit fill in intlayer.config.ts is honoured.\n      const effectiveFillForCheck =\n        baseUnmergedDictionary.fill ?? configuration.dictionary?.fill;\n\n      if (\n        baseUnmergedDictionary.locale &&\n        (effectiveFillForCheck === true ||\n          effectiveFillForCheck === undefined) &&\n        baseUnmergedDictionary.location === 'local'\n      ) {\n        const dictionaryFilePath = baseUnmergedDictionary\n          .filePath!.split('.')\n          .slice(0, -1);\n\n        const contentIndex = dictionaryFilePath[dictionaryFilePath.length - 1];\n\n        return JSON.parse(\n          JSON.stringify({\n            ...task,\n            dictionaryOutput: {\n              ...dictionaryOutput,\n              fill: undefined,\n              filled: true,\n            },\n          }).replaceAll(\n            new RegExp(`\\\\.${contentIndex}\\\\.[a-zA-Z0-9]+`, 'g'),\n            `.filled.${contentIndex}.json`\n          )\n        );\n      }\n\n      return {\n        ...task,\n        dictionaryOutput,\n      };\n    },\n    {\n      maxRetry: GROUP_MAX_RETRY,\n      delay: RETRY_DELAY,\n      onError: ({ error, attempt, maxRetry }) =>\n        appLogger(\n          `${task.dictionaryPreset} ${colorize('Error:', ANSIColors.RED)} ${colorize(typeof error === 'string' ? error : JSON.stringify(error), ANSIColors.GREY_DARK)} - Attempt ${colorizeNumber(attempt + 1)} of ${colorizeNumber(maxRetry)}`,\n          {\n            level: 'error',\n          }\n        ),\n      onMaxTryReached: ({ error }) =>\n        appLogger(\n          `${task.dictionaryPreset} ${colorize('Maximum number of retries reached:', ANSIColors.RED)} ${colorize(typeof error === 'string' ? error : JSON.stringify(error), ANSIColors.GREY_DARK)}`,\n          {\n            level: 'error',\n          }\n        ),\n    }\n  )();\n\n  return result as TranslateDictionaryResult;\n};\n"],"mappings":"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"}
+{"version":3,"file":"translateDictionary.cjs","names":["ANSIColors","extractTranslatableContent","reinsertTranslatedContent","deepMergeContent"],"sources":["../../../src/fill/translateDictionary.ts"],"sourcesContent":["import { basename } from 'node:path';\nimport type { AIConfig } from '@intlayer/ai';\nimport { type AIOptions, getIntlayerAPIProxy } from '@intlayer/api';\nimport {\n  chunkJSON,\n  excludeObjectFormat,\n  formatLocale,\n  type JsonChunk,\n  mergeChunks,\n  reconstructFromSingleChunk,\n  verifyIdenticObjectFormat,\n} from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  colorizePath,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport { retryManager } from '@intlayer/config/utils';\nimport {\n  getFilterMissingTranslationsDictionary,\n  getMultilingualDictionary,\n  getPerLocaleDictionary,\n  insertContentInDictionary,\n} from '@intlayer/core/plugins';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { getUnmergedDictionaries } from '@intlayer/unmerged-dictionaries-entry';\nimport type { AIClient } from '../utils/setupAI';\nimport { deepMergeContent } from './deepMergeContent';\nimport {\n  extractTranslatableContent,\n  reinsertTranslatedContent,\n} from './extractTranslatableContent';\nimport type { TranslationTask } from './listTranslationsTasks';\n\ntype TranslateDictionaryResult = TranslationTask & {\n  dictionaryOutput: Dictionary | null;\n};\n\ntype TranslateDictionaryOptions = {\n  mode: 'complete' | 'review';\n  aiOptions?: AIOptions;\n  fillMetadata?: boolean;\n  onHandle?: ReturnType<\n    typeof import('@intlayer/chokidar/utils').getGlobalLimiter\n  >;\n  onSuccess?: () => void;\n  onError?: (error: unknown) => void;\n  getAbortError?: () => Error | null;\n  aiClient?: AIClient;\n  aiConfig?: AIConfig;\n};\n\nconst createChunkPreset = (chunkIndex: number, totalChunks: number) => {\n  if (totalChunks <= 1) return '';\n  return colon(\n    [\n      colorize('[', ANSIColors.GREY_DARK),\n      colorizeNumber(chunkIndex + 1),\n      colorize(`/${totalChunks}`, ANSIColors.GREY_DARK),\n      colorize(']', ANSIColors.GREY_DARK),\n    ].join(''),\n    { colSize: 5 }\n  );\n};\n\nconst hasMissingMetadata = (dictionary: Dictionary) =>\n  !dictionary.description || !dictionary.title || !dictionary.tags;\n\nconst serializeError = (error: unknown): string => {\n  if (error instanceof Error) {\n    return error.cause\n      ? `${error.message} (cause: ${String(error.cause)})`\n      : error.message;\n  }\n  if (typeof error === 'string') return error;\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n};\n\nconst CHUNK_SIZE = 1500; // Smaller chunks for better accuracy and structural integrity\nconst GROUP_MAX_RETRY = 2;\nconst MAX_RETRY = 3;\nconst RETRY_DELAY = 1000 * 10; // 10 seconds\n\nconst MAX_FOLLOWING_ERRORS = 10; // 10 errors in a row, hard exit the process\nlet followingErrors = 0;\n\nexport const translateDictionary = async (\n  task: TranslationTask,\n  configuration: IntlayerConfig,\n  options?: TranslateDictionaryOptions\n): Promise<TranslateDictionaryResult> => {\n  const appLogger = getAppLogger(configuration);\n  const intlayerAPI = getIntlayerAPIProxy(undefined, configuration);\n\n  const { mode, aiOptions, fillMetadata, aiClient, aiConfig } = {\n    mode: 'complete',\n    fillMetadata: true,\n    ...options,\n  } as const;\n\n  const notifySuccess = () => {\n    followingErrors = 0;\n    options?.onSuccess?.();\n  };\n\n  const result = await retryManager(\n    async () => {\n      const unmergedDictionariesRecord = getUnmergedDictionaries(configuration);\n\n      const baseUnmergedDictionary: Dictionary | undefined =\n        unmergedDictionariesRecord[task.dictionaryKey].find(\n          (dict) => dict.localId === task.dictionaryLocalId\n        );\n\n      if (!baseUnmergedDictionary) {\n        appLogger(\n          `${task.dictionaryPreset}Dictionary not found in unmergedDictionariesRecord. Skipping.`,\n          {\n            level: 'warn',\n          }\n        );\n        return { ...task, dictionaryOutput: null };\n      }\n\n      let metadata:\n        | Pick<Dictionary, 'description' | 'title' | 'tags'>\n        | undefined;\n\n      if (\n        fillMetadata &&\n        (hasMissingMetadata(baseUnmergedDictionary) || mode === 'review')\n      ) {\n        const defaultLocaleDictionary = getPerLocaleDictionary(\n          baseUnmergedDictionary,\n          configuration.internationalization.defaultLocale\n        );\n\n        appLogger(\n          `${task.dictionaryPreset} Filling missing metadata for ${colorizePath(basename(baseUnmergedDictionary.filePath!))}`,\n          {\n            level: 'info',\n          }\n        );\n\n        const runAudit = async () => {\n          if (aiClient && aiConfig) {\n            const result = await aiClient.auditDictionaryMetadata({\n              fileContent: JSON.stringify(defaultLocaleDictionary),\n              aiConfig,\n            });\n\n            return {\n              data: result,\n            };\n          }\n\n          return await intlayerAPI.ai.auditContentDeclarationMetadata({\n            fileContent: JSON.stringify(defaultLocaleDictionary),\n            aiOptions,\n          });\n        };\n\n        const metadataResult = options?.onHandle\n          ? await options.onHandle(runAudit)\n          : await runAudit();\n\n        metadata = metadataResult.data?.fileContent;\n      }\n\n      const translatedContentResults = await Promise.all(\n        task.targetLocales.map(async (targetLocale) => {\n          /**\n           * In complete mode, for large dictionaries, we want to filter all content that is already translated\n           *\n           * targetLocale: fr\n           *\n           * { test1: t({ ar: 'Hello', en: 'Hello', fr: 'Bonjour' } }) -> {}\n           * { test2: t({ ar: 'Hello', en: 'Hello' }) } -> { test2: t({ ar: 'Hello', en: 'Hello' }) }\n           *\n           */\n          // Reset to base dictionary for each locale to ensure we filter from the original\n          let dictionaryToProcess = structuredClone(baseUnmergedDictionary);\n\n          let targetLocaleDictionary: Dictionary;\n\n          if (typeof baseUnmergedDictionary.locale === 'string') {\n            // For per-locale files, the content is already in simple JSON format (not translation nodes)\n            // The base dictionary is already the source locale content\n\n            // Load the existing target locale dictionary\n            const targetLocaleFilePath =\n              baseUnmergedDictionary.filePath?.replace(\n                new RegExp(`/${task.sourceLocale}/`, 'g'),\n                `/${targetLocale}/`\n              );\n\n            // Find the target locale dictionary in unmerged dictionaries\n            const targetUnmergedDictionary = targetLocaleFilePath\n              ? unmergedDictionariesRecord[task.dictionaryKey]?.find(\n                  (dict) =>\n                    dict.filePath === targetLocaleFilePath &&\n                    dict.locale === targetLocale\n                )\n              : undefined;\n\n            targetLocaleDictionary = targetUnmergedDictionary ?? {\n              key: baseUnmergedDictionary.key,\n              content: {},\n              filePath: targetLocaleFilePath,\n              locale: targetLocale,\n            };\n          } else {\n            // For multilingual dictionaries\n            if (mode === 'complete') {\n              // Remove all nodes that don't have any content to translate\n              dictionaryToProcess = getFilterMissingTranslationsDictionary(\n                dictionaryToProcess,\n                targetLocale\n              );\n            }\n\n            dictionaryToProcess = getPerLocaleDictionary(\n              dictionaryToProcess,\n              task.sourceLocale\n            );\n\n            targetLocaleDictionary = getPerLocaleDictionary(\n              baseUnmergedDictionary,\n              targetLocale\n            );\n          }\n\n          // Filter to only untranslated fields, preserving explicit null values as\n          // default-locale fallback markers. Applied after both paths converge so\n          // the same logic covers per-locale and multilingual dictionaries.\n          if (mode === 'complete') {\n            dictionaryToProcess = {\n              ...dictionaryToProcess,\n              content:\n                excludeObjectFormat(\n                  dictionaryToProcess.content,\n                  targetLocaleDictionary.content\n                ) ?? {},\n            };\n          }\n\n          const localePreset = colon(\n            [\n              colorize('[', ANSIColors.GREY_DARK),\n              formatLocale(targetLocale),\n              colorize(']', ANSIColors.GREY_DARK),\n            ].join(''),\n            { colSize: 18 }\n          );\n\n          appLogger(\n            `${task.dictionaryPreset}${localePreset} Preparing ${colorizePath(basename(targetLocaleDictionary.filePath!))}`,\n            {\n              level: 'info',\n            }\n          );\n\n          const chunkedJsonContent: JsonChunk[] = chunkJSON(\n            dictionaryToProcess.content as unknown as Record<string, any>,\n            CHUNK_SIZE\n          );\n\n          const nbOfChunks = chunkedJsonContent.length;\n\n          if (nbOfChunks > 1) {\n            appLogger(\n              `${task.dictionaryPreset}${localePreset} Split into ${colorizeNumber(nbOfChunks)} chunks for translation`,\n              {\n                level: 'info',\n              }\n            );\n          }\n\n          const chunkResult: JsonChunk[] = [];\n\n          // Process chunks in parallel (globally throttled) to allow concurrent translation\n          const chunkPromises = chunkedJsonContent.map(async (chunk) => {\n            const chunkPreset = createChunkPreset(chunk.index, chunk.total);\n\n            if (nbOfChunks > 1) {\n              appLogger(\n                `${task.dictionaryPreset}${localePreset}${chunkPreset} Translating chunk`,\n                {\n                  level: 'info',\n                }\n              );\n            }\n\n            const reconstructedChunk = reconstructFromSingleChunk(chunk);\n            const {\n              extractedContent: chunkExtractedContent,\n              translatableDictionary: chunkTranslatableDictionary,\n            } = extractTranslatableContent(reconstructedChunk);\n\n            const executeTranslation = async () => {\n              return await retryManager(\n                async () => {\n                  let translationResult: any;\n\n                  if (aiClient && aiConfig) {\n                    translationResult = await aiClient.translateJSON({\n                      entryFileContent:\n                        chunkTranslatableDictionary as unknown as JSON,\n                      presetOutputContent: chunkTranslatableDictionary,\n                      dictionaryDescription:\n                        dictionaryToProcess.description ??\n                        metadata?.description ??\n                        '',\n                      entryLocale: task.sourceLocale,\n                      outputLocale: targetLocale,\n                      mode,\n                      aiConfig,\n                    });\n                  } else {\n                    translationResult = await intlayerAPI.ai\n                      .translateJSON({\n                        entryFileContent:\n                          chunkTranslatableDictionary as unknown as JSON,\n                        presetOutputContent: chunkTranslatableDictionary,\n                        dictionaryDescription:\n                          dictionaryToProcess.description ??\n                          metadata?.description ??\n                          '',\n                        entryLocale: task.sourceLocale,\n                        outputLocale: targetLocale,\n                        mode,\n                        aiOptions,\n                      })\n                      .then((result) => result.data);\n                  }\n\n                  if (!translationResult?.fileContent) {\n                    throw new Error('No content result');\n                  }\n\n                  const { isIdentic, error } = verifyIdenticObjectFormat(\n                    translationResult.fileContent,\n                    chunkTranslatableDictionary\n                  );\n\n                  if (!isIdentic) {\n                    throw new Error(\n                      `Translation result does not match expected format: ${error}`\n                    );\n                  }\n\n                  notifySuccess();\n                  return reinsertTranslatedContent(\n                    reconstructedChunk,\n                    chunkExtractedContent,\n                    translationResult.fileContent as Record<number, string>\n                  );\n                },\n                {\n                  maxRetry: MAX_RETRY,\n                  delay: RETRY_DELAY,\n                  onError: ({ error, attempt, maxRetry }) => {\n                    const chunkPreset = createChunkPreset(\n                      chunk.index,\n                      chunk.total\n                    );\n                    appLogger(\n                      `${task.dictionaryPreset}${localePreset}${chunkPreset} ${colorize('Error filling:', ANSIColors.RED)} ${colorize(serializeError(error), ANSIColors.GREY_DARK)} - Attempt ${colorizeNumber(attempt + 1)} of ${colorizeNumber(maxRetry)}`,\n                      {\n                        level: 'error',\n                      }\n                    );\n\n                    followingErrors += 1;\n\n                    if (followingErrors >= MAX_FOLLOWING_ERRORS) {\n                      appLogger(`There is something wrong.`, {\n                        level: 'error',\n                      });\n                      process.exit(1); // 1 for error\n                    }\n                  },\n                }\n              )();\n            };\n\n            const wrapped = options?.onHandle\n              ? options.onHandle(executeTranslation) // queued in global limiter\n              : executeTranslation(); // no global limiter\n\n            return wrapped.then((result) => ({ chunk, result }));\n          });\n\n          // Wait for all chunks for this locale in parallel (still capped by global limiter)\n          const chunkResults = await Promise.all(chunkPromises);\n\n          // Maintain order\n          chunkResults\n            .sort((chunkA, chunkB) => chunkA.chunk.index - chunkB.chunk.index)\n            .forEach(({ result }) => {\n              chunkResult.push(result);\n            });\n\n          // Merge translated chunk contents back into a single content object\n          const reinsertedContent = mergeChunks(chunkResult);\n\n          const merged = {\n            ...dictionaryToProcess,\n            content: reinsertedContent,\n          };\n\n          // Merge newly translated content (including explicit null fallbacks) back\n          // into the existing target locale content. Applies to both per-locale and\n          // multilingual paths so the target always retains previously translated\n          // fields and receives null markers where the source has no translation.\n          const finalContent = deepMergeContent(\n            targetLocaleDictionary.content ?? {},\n            merged.content\n          );\n\n          return [targetLocale, finalContent] as const;\n        })\n      );\n\n      const translatedContent: Partial<Record<Locale, Dictionary['content']>> =\n        Object.fromEntries(translatedContentResults);\n\n      const baseDictionary = baseUnmergedDictionary.locale\n        ? {\n            ...baseUnmergedDictionary,\n            key: baseUnmergedDictionary.key!,\n            content: {},\n          }\n        : baseUnmergedDictionary;\n\n      let dictionaryOutput: Dictionary = {\n        ...getMultilingualDictionary(baseDictionary),\n        locale: undefined, // Ensure the dictionary is multilingual\n        ...metadata,\n      };\n\n      for (const targetLocale of task.targetLocales) {\n        if (translatedContent[targetLocale]) {\n          dictionaryOutput = insertContentInDictionary(\n            dictionaryOutput,\n            translatedContent[targetLocale],\n            targetLocale\n          );\n        }\n      }\n\n      appLogger(\n        `${task.dictionaryPreset} ${colorize('Translation completed successfully', ANSIColors.GREEN)} for ${colorizePath(basename(dictionaryOutput.filePath!))}`,\n        {\n          level: 'info',\n        }\n      );\n\n      // The dict-level `fill` value may have been lost during JSON serialisation\n      // (functions can't be serialised to JSON). Fall back to the config-level\n      // fill so that an explicit fill in intlayer.config.ts is honoured.\n      const effectiveFillForCheck =\n        baseUnmergedDictionary.fill ?? configuration.dictionary?.fill;\n\n      if (\n        baseUnmergedDictionary.locale &&\n        (effectiveFillForCheck === true ||\n          effectiveFillForCheck === undefined) &&\n        baseUnmergedDictionary.location === 'local'\n      ) {\n        const dictionaryFilePath = baseUnmergedDictionary\n          .filePath!.split('.')\n          .slice(0, -1);\n\n        const contentIndex = dictionaryFilePath[dictionaryFilePath.length - 1];\n\n        return JSON.parse(\n          JSON.stringify({\n            ...task,\n            dictionaryOutput: {\n              ...dictionaryOutput,\n              fill: undefined,\n              filled: true,\n            },\n          }).replaceAll(\n            new RegExp(`\\\\.${contentIndex}\\\\.[a-zA-Z0-9]+`, 'g'),\n            `.filled.${contentIndex}.json`\n          )\n        );\n      }\n\n      return {\n        ...task,\n        dictionaryOutput,\n      };\n    },\n    {\n      maxRetry: GROUP_MAX_RETRY,\n      delay: RETRY_DELAY,\n      onError: ({ error, attempt, maxRetry }) =>\n        appLogger(\n          `${task.dictionaryPreset} ${colorize('Error:', ANSIColors.RED)} ${colorize(serializeError(error), ANSIColors.GREY_DARK)} - Attempt ${colorizeNumber(attempt + 1)} of ${colorizeNumber(maxRetry)}`,\n          {\n            level: 'error',\n          }\n        ),\n      onMaxTryReached: ({ error }) =>\n        appLogger(\n          `${task.dictionaryPreset} ${colorize('Maximum number of retries reached:', ANSIColors.RED)} ${colorize(serializeError(error), ANSIColors.GREY_DARK)}`,\n          {\n            level: 'error',\n          }\n        ),\n    }\n  )();\n\n  return result as TranslateDictionaryResult;\n};\n"],"mappings":"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"}

package/dist/cjs/listContentDeclaration.cjs

@@ -1,22 +1,24 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 let node_path = require("node:path");
+let _intlayer_chokidar_cli = require("@intlayer/chokidar/cli");
 let _intlayer_chokidar_utils = require("@intlayer/chokidar/utils");
 let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_config_node = require("@intlayer/config/node");
 let _intlayer_unmerged_dictionaries_entry = require("@intlayer/unmerged-dictionaries-entry");
 
 //#region src/listContentDeclaration.ts
-const listContentDeclarationRows = (options) => {
+const listContentDeclarationRows = async (options) => {
 	const config = (0, _intlayer_config_node.getConfiguration)(options?.configOptions);
+	await (0, _intlayer_chokidar_cli.prepareIntlayer)(config);
 	const unmergedDictionariesRecord = (0, _intlayer_unmerged_dictionaries_entry.getUnmergedDictionaries)(config);
 	return Object.values(unmergedDictionariesRecord).flat().map((dictionary) => ({
 		key: dictionary.key ?? "",
 		path: options?.absolute ? dictionary.filePath ?? "Remote" : (0, node_path.relative)(config.system.baseDir, dictionary.filePath ?? "Remote")
 	}));
 };
-const listContentDeclaration = (options) => {
-	const rows = listContentDeclarationRows(options);
+const listContentDeclaration = async (options) => {
+	const rows = await listContentDeclarationRows(options);
 	if (options?.json) {
 		console.log(JSON.stringify(rows));
 		return;

package/dist/cjs/listContentDeclaration.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"listContentDeclaration.cjs","names":[],"sources":["../../src/listContentDeclaration.ts"],"sourcesContent":["import { relative } from 'node:path';\nimport { formatPath } from '@intlayer/chokidar/utils';\nimport {\n  colon,\n  colorizeKey,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { getUnmergedDictionaries } from '@intlayer/unmerged-dictionaries-entry';\n\ntype ListContentDeclarationOptions = {\n  configOptions?: GetConfigurationOptions;\n  json?: boolean;\n  absolute?: boolean;\n};\n\nexport const listContentDeclarationRows = (\n  options?: ListContentDeclarationOptions\n) => {\n  const config = getConfiguration(options?.configOptions);\n\n  const unmergedDictionariesRecord = getUnmergedDictionaries(config);\n\n  const rows = Object.values(unmergedDictionariesRecord)\n    .flat()\n    .map((dictionary) => ({\n      key: dictionary.key ?? '',\n      path: options?.absolute\n        ? (dictionary.filePath ?? 'Remote')\n        : relative(config.system.baseDir, dictionary.filePath ?? 'Remote'),\n    }));\n  return rows;\n};\n\nexport const listContentDeclaration = (\n  options?: ListContentDeclarationOptions\n) => {\n  const rows = listContentDeclarationRows(options);\n\n  if (options?.json) {\n    console.log(JSON.stringify(rows));\n    return;\n  }\n\n  const config = getConfiguration(options?.configOptions);\n  const appLogger = getAppLogger(config);\n\n  const lines = rows.map((row) =>\n    [\n      colon(` - ${colorizeKey(row.key)}`, {\n        colSize: rows.map((row) => row.key.length),\n        maxSize: 60,\n      }),\n      ' - ',\n      formatPath(row.path),\n    ].join('')\n  );\n\n  appLogger(`Content declaration files:`);\n\n  lines.forEach((line) => {\n    appLogger(line, {\n      level: 'info',\n    });\n  });\n\n  appLogger(`Total content declaration files: ${colorizeNumber(rows.length)}`);\n};\n"],"mappings":";;;;;;;;;AAoBA,MAAa,8BACX,YACG;CACH,MAAM,qDAA0B,SAAS,cAAc;CAEvD,MAAM,gGAAqD,OAAO;AAUlE,QARa,OAAO,OAAO,2BAA2B,CACnD,MAAM,CACN,KAAK,gBAAgB;EACpB,KAAK,WAAW,OAAO;EACvB,MAAM,SAAS,WACV,WAAW,YAAY,mCACf,OAAO,OAAO,SAAS,WAAW,YAAY,SAAS;EACrE,EAAE;;AAIP,MAAa,0BACX,YACG;CACH,MAAM,OAAO,2BAA2B,QAAQ;AAEhD,KAAI,SAAS,MAAM;AACjB,UAAQ,IAAI,KAAK,UAAU,KAAK,CAAC;AACjC;;CAIF,MAAM,kGAD0B,SAAS,cAAc,CACjB;CAEtC,MAAM,QAAQ,KAAK,KAAK,QACtB;qCACQ,+CAAkB,IAAI,IAAI,IAAI;GAClC,SAAS,KAAK,KAAK,QAAQ,IAAI,IAAI,OAAO;GAC1C,SAAS;GACV,CAAC;EACF;2CACW,IAAI,KAAK;EACrB,CAAC,KAAK,GAAG,CACX;AAED,WAAU,6BAA6B;AAEvC,OAAM,SAAS,SAAS;AACtB,YAAU,MAAM,EACd,OAAO,QACR,CAAC;GACF;AAEF,WAAU,gFAAmD,KAAK,OAAO,GAAG"}
+{"version":3,"file":"listContentDeclaration.cjs","names":[],"sources":["../../src/listContentDeclaration.ts"],"sourcesContent":["import { relative } from 'node:path';\nimport { prepareIntlayer } from '@intlayer/chokidar/cli';\nimport { formatPath } from '@intlayer/chokidar/utils';\nimport {\n  colon,\n  colorizeKey,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { getUnmergedDictionaries } from '@intlayer/unmerged-dictionaries-entry';\n\ntype ListContentDeclarationOptions = {\n  configOptions?: GetConfigurationOptions;\n  json?: boolean;\n  absolute?: boolean;\n};\n\nexport const listContentDeclarationRows = async (\n  options?: ListContentDeclarationOptions\n) => {\n  const config = getConfiguration(options?.configOptions);\n\n  await prepareIntlayer(config);\n\n  const unmergedDictionariesRecord = getUnmergedDictionaries(config);\n\n  const rows = Object.values(unmergedDictionariesRecord)\n    .flat()\n    .map((dictionary) => ({\n      key: dictionary.key ?? '',\n      path: options?.absolute\n        ? (dictionary.filePath ?? 'Remote')\n        : relative(config.system.baseDir, dictionary.filePath ?? 'Remote'),\n    }));\n  return rows;\n};\n\nexport const listContentDeclaration = async (\n  options?: ListContentDeclarationOptions\n) => {\n  const rows = await listContentDeclarationRows(options);\n\n  if (options?.json) {\n    console.log(JSON.stringify(rows));\n    return;\n  }\n\n  const config = getConfiguration(options?.configOptions);\n  const appLogger = getAppLogger(config);\n\n  const lines = rows.map((row) =>\n    [\n      colon(` - ${colorizeKey(row.key)}`, {\n        colSize: rows.map((row) => row.key.length),\n        maxSize: 60,\n      }),\n      ' - ',\n      formatPath(row.path),\n    ].join('')\n  );\n\n  appLogger(`Content declaration files:`);\n\n  lines.forEach((line) => {\n    appLogger(line, {\n      level: 'info',\n    });\n  });\n\n  appLogger(`Total content declaration files: ${colorizeNumber(rows.length)}`);\n};\n"],"mappings":";;;;;;;;;;AAqBA,MAAa,6BAA6B,OACxC,YACG;CACH,MAAM,qDAA0B,SAAS,cAAc;AAEvD,mDAAsB,OAAO;CAE7B,MAAM,gGAAqD,OAAO;AAUlE,QARa,OAAO,OAAO,2BAA2B,CACnD,MAAM,CACN,KAAK,gBAAgB;EACpB,KAAK,WAAW,OAAO;EACvB,MAAM,SAAS,WACV,WAAW,YAAY,mCACf,OAAO,OAAO,SAAS,WAAW,YAAY,SAAS;EACrE,EAAE;;AAIP,MAAa,yBAAyB,OACpC,YACG;CACH,MAAM,OAAO,MAAM,2BAA2B,QAAQ;AAEtD,KAAI,SAAS,MAAM;AACjB,UAAQ,IAAI,KAAK,UAAU,KAAK,CAAC;AACjC;;CAIF,MAAM,kGAD0B,SAAS,cAAc,CACjB;CAEtC,MAAM,QAAQ,KAAK,KAAK,QACtB;qCACQ,+CAAkB,IAAI,IAAI,IAAI;GAClC,SAAS,KAAK,KAAK,QAAQ,IAAI,IAAI,OAAO;GAC1C,SAAS;GACV,CAAC;EACF;2CACW,IAAI,KAAK;EACrB,CAAC,KAAK,GAAG,CACX;AAED,WAAU,6BAA6B;AAEvC,OAAM,SAAS,SAAS;AACtB,YAAU,MAAM,EACd,OAAO,QACR,CAAC;GACF;AAEF,WAAU,gFAAmD,KAAK,OAAO,GAAG"}

package/dist/cjs/reviewDoc/reviewDoc.cjs

@@ -12,6 +12,7 @@ let _intlayer_config_colors = require("@intlayer/config/colors");
 _intlayer_config_colors = require_runtime.__toESM(_intlayer_config_colors);
 let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_config_node = require("@intlayer/config/node");
+let _intlayer_ai = require("@intlayer/ai");
 let fast_glob = require("fast-glob");
 fast_glob = require_runtime.__toESM(fast_glob);
 
@@ -27,6 +28,11 @@ const reviewDoc = async ({ docPattern, locales, excludedGlobPattern, baseLocale,
 	const aiResult = await require_utils_setupAI.setupAI(configuration, aiOptions);
 	if (!aiResult?.hasAIAccess) return;
 	const { aiClient, aiConfig } = aiResult;
+	const { hasAIAccess, error } = await (0, _intlayer_ai.checkAISDKAccess)(aiConfig);
+	if (!hasAIAccess) {
+		appLogger(`${_intlayer_config_logger.x} ${error}`);
+		return;
+	}
 	if (nbSimultaneousFileProcessed && nbSimultaneousFileProcessed > 10) {
 		appLogger(`Warning: nbSimultaneousFileProcessed is set to ${nbSimultaneousFileProcessed}, which is greater than 10. Setting it to 10.`);
 		nbSimultaneousFileProcessed = 10;

package/dist/cjs/reviewDoc/reviewDoc.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"reviewDoc.cjs","names":["setupAI","getOutputFilePath","ANSIColors","checkFileModifiedRange","reviewFileBlockAware"],"sources":["../../../src/reviewDoc/reviewDoc.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { join, relative } from 'node:path';\nimport type { AIOptions } from '@intlayer/api';\nimport {\n  type ListGitFilesOptions,\n  listGitFiles,\n  listGitLines,\n  logConfigDetails,\n} from '@intlayer/chokidar/cli';\nimport {\n  formatLocale,\n  formatPath,\n  parallelize,\n} from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport fg from 'fast-glob';\nimport { checkFileModifiedRange } from '../utils/checkFileModifiedRange';\nimport { getOutputFilePath } from '../utils/getOutputFilePath';\nimport { setupAI } from '../utils/setupAI';\nimport { reviewFileBlockAware } from './reviewDocBlockAware';\n\ntype ReviewDocOptions = {\n  docPattern: string[];\n  locales: Locale[];\n  excludedGlobPattern: string[];\n  baseLocale: Locale;\n  aiOptions?: AIOptions;\n  nbSimultaneousFileProcessed?: number;\n  configOptions?: GetConfigurationOptions;\n  customInstructions?: string;\n  skipIfModifiedBefore?: number | string | Date;\n  skipIfModifiedAfter?: number | string | Date;\n  skipIfExists?: boolean;\n  gitOptions?: ListGitFilesOptions;\n};\n\n/**\n * Main audit function: scans all .md files in \"en/\" (unless you specified DOC_LIST),\n * then audits them to each locale in LOCALE_LIST.\n */\nexport const reviewDoc = async ({\n  docPattern,\n  locales,\n  excludedGlobPattern,\n  baseLocale,\n  aiOptions,\n  nbSimultaneousFileProcessed,\n  configOptions,\n  customInstructions,\n  skipIfModifiedBefore,\n  skipIfModifiedAfter,\n  skipIfExists,\n  gitOptions,\n}: ReviewDocOptions) => {\n  const configuration = getConfiguration(configOptions);\n  logConfigDetails(configOptions);\n\n  const appLogger = getAppLogger(configuration);\n\n  const aiResult = await setupAI(configuration, aiOptions);\n\n  if (!aiResult?.hasAIAccess) return;\n\n  const { aiClient, aiConfig } = aiResult;\n\n  if (nbSimultaneousFileProcessed && nbSimultaneousFileProcessed > 10) {\n    appLogger(\n      `Warning: nbSimultaneousFileProcessed is set to ${nbSimultaneousFileProcessed}, which is greater than 10. Setting it to 10.`\n    );\n    nbSimultaneousFileProcessed = 10; // Limit the number of simultaneous file processed to 10\n  }\n\n  let docList: string[] = await fg(docPattern, {\n    ignore: excludedGlobPattern,\n  });\n\n  if (gitOptions) {\n    const gitChangedFiles = await listGitFiles(gitOptions);\n\n    if (gitChangedFiles) {\n      // Convert dictionary file paths to be relative to git root for comparison\n\n      // Filter dictionaries based on git changed files\n      docList = docList.filter((path) =>\n        gitChangedFiles.some((gitFile) => join(process.cwd(), path) === gitFile)\n      );\n    }\n  }\n\n  // OAuth handled by API proxy internally\n\n  appLogger(`Base locale is ${formatLocale(baseLocale)}`);\n  appLogger(\n    `Reviewing ${colorizeNumber(locales.length)} locales: [ ${formatLocale(locales)} ]`\n  );\n\n  appLogger(`Reviewing ${colorizeNumber(docList.length)} files:`);\n  appLogger(docList.map((path) => ` - ${formatPath(path)}\\n`));\n\n  // Create all tasks to be processed\n  const allTasks = docList.flatMap((docPath) =>\n    locales.map((locale) => async () => {\n      appLogger(\n        `Reviewing file: ${formatPath(docPath)} to ${formatLocale(locale)}`\n      );\n\n      const absoluteBaseFilePath = join(configuration.system.baseDir, docPath);\n      const outputFilePath = getOutputFilePath(\n        absoluteBaseFilePath,\n        locale,\n        baseLocale\n      );\n\n      // Skip if file exists and skipIfExists option is enabled\n      if (skipIfExists && existsSync(outputFilePath)) {\n        const relativePath = relative(\n          configuration.system.baseDir,\n          outputFilePath\n        );\n        appLogger(\n          `${colorize('⊘', ANSIColors.YELLOW)} File ${formatPath(relativePath)} already exists, skipping.`\n        );\n        return;\n      }\n\n      // Check modification range only if the file exists\n      if (existsSync(outputFilePath)) {\n        const fileModificationData = checkFileModifiedRange(outputFilePath, {\n          skipIfModifiedBefore,\n          skipIfModifiedAfter,\n        });\n\n        if (fileModificationData.isSkipped) {\n          appLogger(fileModificationData.message);\n          return;\n        }\n      } else if (skipIfModifiedBefore || skipIfModifiedAfter) {\n        // Log if we intended to check modification time but couldn't because the file doesn't exist\n        appLogger(\n          `${colorize('!', ANSIColors.YELLOW)} File ${formatPath(outputFilePath)} does not exist, skipping modification date check.`\n        );\n      }\n\n      let changedLines: number[] | undefined;\n      // FIXED: Enable git optimization that was previously commented out\n      if (gitOptions) {\n        const gitChangedLines = await listGitLines(\n          absoluteBaseFilePath,\n          gitOptions\n        );\n\n        appLogger(`Git changed lines: ${gitChangedLines.join(', ')}`);\n        changedLines = gitChangedLines;\n      }\n\n      await reviewFileBlockAware(\n        absoluteBaseFilePath,\n        outputFilePath,\n        locale as Locale,\n        baseLocale,\n        aiOptions,\n        configOptions,\n        customInstructions,\n        changedLines,\n        aiClient,\n        aiConfig\n      );\n    })\n  );\n\n  await parallelize(\n    allTasks,\n    (task) => task(),\n    nbSimultaneousFileProcessed ?? 3\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAkDA,MAAa,YAAY,OAAO,EAC9B,YACA,SACA,qBACA,YACA,WACA,6BACA,eACA,oBACA,sBACA,qBACA,cACA,iBACsB;CACtB,MAAM,4DAAiC,cAAc;AACrD,8CAAiB,cAAc;CAE/B,MAAM,sDAAyB,cAAc;CAE7C,MAAM,WAAW,MAAMA,8BAAQ,eAAe,UAAU;AAExD,KAAI,CAAC,UAAU,YAAa;CAE5B,MAAM,EAAE,UAAU,aAAa;AAE/B,KAAI,+BAA+B,8BAA8B,IAAI;AACnE,YACE,kDAAkD,4BAA4B,+CAC/E;AACD,gCAA8B;;CAGhC,IAAI,UAAoB,6BAAS,YAAY,EAC3C,QAAQ,qBACT,CAAC;AAEF,KAAI,YAAY;EACd,MAAM,kBAAkB,+CAAmB,WAAW;AAEtD,MAAI,gBAIF,WAAU,QAAQ,QAAQ,SACxB,gBAAgB,MAAM,gCAAiB,QAAQ,KAAK,EAAE,KAAK,KAAK,QAAQ,CACzE;;AAML,WAAU,6DAA+B,WAAW,GAAG;AACvD,WACE,yDAA4B,QAAQ,OAAO,CAAC,yDAA2B,QAAQ,CAAC,IACjF;AAED,WAAU,yDAA4B,QAAQ,OAAO,CAAC,SAAS;AAC/D,WAAU,QAAQ,KAAK,SAAS,+CAAiB,KAAK,CAAC,IAAI,CAAC;AAyE5D,iDAtEiB,QAAQ,SAAS,YAChC,QAAQ,KAAK,WAAW,YAAY;AAClC,YACE,4DAA8B,QAAQ,CAAC,iDAAmB,OAAO,GAClE;EAED,MAAM,2CAA4B,cAAc,OAAO,SAAS,QAAQ;EACxE,MAAM,iBAAiBC,kDACrB,sBACA,QACA,WACD;AAGD,MAAI,wCAA2B,eAAe,EAAE;GAC9C,MAAM,uCACJ,cAAc,OAAO,SACrB,eACD;AACD,aACE,yCAAY,KAAKC,wBAAW,OAAO,CAAC,iDAAmB,aAAa,CAAC,4BACtE;AACD;;AAIF,8BAAe,eAAe,EAAE;GAC9B,MAAM,uBAAuBC,4DAAuB,gBAAgB;IAClE;IACA;IACD,CAAC;AAEF,OAAI,qBAAqB,WAAW;AAClC,cAAU,qBAAqB,QAAQ;AACvC;;aAEO,wBAAwB,oBAEjC,WACE,yCAAY,KAAKD,wBAAW,OAAO,CAAC,iDAAmB,eAAe,CAAC,oDACxE;EAGH,IAAI;AAEJ,MAAI,YAAY;GACd,MAAM,kBAAkB,+CACtB,sBACA,WACD;AAED,aAAU,sBAAsB,gBAAgB,KAAK,KAAK,GAAG;AAC7D,kBAAe;;AAGjB,QAAME,2DACJ,sBACA,gBACA,QACA,YACA,WACA,eACA,oBACA,cACA,UACA,SACD;GACD,CACH,GAIE,SAAS,MAAM,EAChB,+BAA+B,EAChC"}
+{"version":3,"file":"reviewDoc.cjs","names":["setupAI","x","getOutputFilePath","ANSIColors","checkFileModifiedRange","reviewFileBlockAware"],"sources":["../../../src/reviewDoc/reviewDoc.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { join, relative } from 'node:path';\nimport { checkAISDKAccess } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport {\n  type ListGitFilesOptions,\n  listGitFiles,\n  listGitLines,\n  logConfigDetails,\n} from '@intlayer/chokidar/cli';\nimport {\n  formatLocale,\n  formatPath,\n  parallelize,\n} from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n  x,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport fg from 'fast-glob';\nimport { checkFileModifiedRange } from '../utils/checkFileModifiedRange';\nimport { getOutputFilePath } from '../utils/getOutputFilePath';\nimport { setupAI } from '../utils/setupAI';\nimport { reviewFileBlockAware } from './reviewDocBlockAware';\n\ntype ReviewDocOptions = {\n  docPattern: string[];\n  locales: Locale[];\n  excludedGlobPattern: string[];\n  baseLocale: Locale;\n  aiOptions?: AIOptions;\n  nbSimultaneousFileProcessed?: number;\n  configOptions?: GetConfigurationOptions;\n  customInstructions?: string;\n  skipIfModifiedBefore?: number | string | Date;\n  skipIfModifiedAfter?: number | string | Date;\n  skipIfExists?: boolean;\n  gitOptions?: ListGitFilesOptions;\n};\n\n/**\n * Main audit function: scans all .md files in \"en/\" (unless you specified DOC_LIST),\n * then audits them to each locale in LOCALE_LIST.\n */\nexport const reviewDoc = async ({\n  docPattern,\n  locales,\n  excludedGlobPattern,\n  baseLocale,\n  aiOptions,\n  nbSimultaneousFileProcessed,\n  configOptions,\n  customInstructions,\n  skipIfModifiedBefore,\n  skipIfModifiedAfter,\n  skipIfExists,\n  gitOptions,\n}: ReviewDocOptions) => {\n  const configuration = getConfiguration(configOptions);\n  logConfigDetails(configOptions);\n\n  const appLogger = getAppLogger(configuration);\n\n  const aiResult = await setupAI(configuration, aiOptions);\n\n  if (!aiResult?.hasAIAccess) return;\n\n  const { aiClient, aiConfig } = aiResult;\n\n  const { hasAIAccess, error } = await checkAISDKAccess(aiConfig!);\n  if (!hasAIAccess) {\n    appLogger(`${x} ${error}`);\n    return;\n  }\n\n  if (nbSimultaneousFileProcessed && nbSimultaneousFileProcessed > 10) {\n    appLogger(\n      `Warning: nbSimultaneousFileProcessed is set to ${nbSimultaneousFileProcessed}, which is greater than 10. Setting it to 10.`\n    );\n    nbSimultaneousFileProcessed = 10; // Limit the number of simultaneous file processed to 10\n  }\n\n  let docList: string[] = await fg(docPattern, {\n    ignore: excludedGlobPattern,\n  });\n\n  if (gitOptions) {\n    const gitChangedFiles = await listGitFiles(gitOptions);\n\n    if (gitChangedFiles) {\n      // Convert dictionary file paths to be relative to git root for comparison\n\n      // Filter dictionaries based on git changed files\n      docList = docList.filter((path) =>\n        gitChangedFiles.some((gitFile) => join(process.cwd(), path) === gitFile)\n      );\n    }\n  }\n\n  // OAuth handled by API proxy internally\n\n  appLogger(`Base locale is ${formatLocale(baseLocale)}`);\n  appLogger(\n    `Reviewing ${colorizeNumber(locales.length)} locales: [ ${formatLocale(locales)} ]`\n  );\n\n  appLogger(`Reviewing ${colorizeNumber(docList.length)} files:`);\n  appLogger(docList.map((path) => ` - ${formatPath(path)}\\n`));\n\n  // Create all tasks to be processed\n  const allTasks = docList.flatMap((docPath) =>\n    locales.map((locale) => async () => {\n      appLogger(\n        `Reviewing file: ${formatPath(docPath)} to ${formatLocale(locale)}`\n      );\n\n      const absoluteBaseFilePath = join(configuration.system.baseDir, docPath);\n      const outputFilePath = getOutputFilePath(\n        absoluteBaseFilePath,\n        locale,\n        baseLocale\n      );\n\n      // Skip if file exists and skipIfExists option is enabled\n      if (skipIfExists && existsSync(outputFilePath)) {\n        const relativePath = relative(\n          configuration.system.baseDir,\n          outputFilePath\n        );\n        appLogger(\n          `${colorize('⊘', ANSIColors.YELLOW)} File ${formatPath(relativePath)} already exists, skipping.`\n        );\n        return;\n      }\n\n      // Check modification range only if the file exists\n      if (existsSync(outputFilePath)) {\n        const fileModificationData = checkFileModifiedRange(outputFilePath, {\n          skipIfModifiedBefore,\n          skipIfModifiedAfter,\n        });\n\n        if (fileModificationData.isSkipped) {\n          appLogger(fileModificationData.message);\n          return;\n        }\n      } else if (skipIfModifiedBefore || skipIfModifiedAfter) {\n        // Log if we intended to check modification time but couldn't because the file doesn't exist\n        appLogger(\n          `${colorize('!', ANSIColors.YELLOW)} File ${formatPath(outputFilePath)} does not exist, skipping modification date check.`\n        );\n      }\n\n      let changedLines: number[] | undefined;\n      // FIXED: Enable git optimization that was previously commented out\n      if (gitOptions) {\n        const gitChangedLines = await listGitLines(\n          absoluteBaseFilePath,\n          gitOptions\n        );\n\n        appLogger(`Git changed lines: ${gitChangedLines.join(', ')}`);\n        changedLines = gitChangedLines;\n      }\n\n      await reviewFileBlockAware(\n        absoluteBaseFilePath,\n        outputFilePath,\n        locale as Locale,\n        baseLocale,\n        aiOptions,\n        configOptions,\n        customInstructions,\n        changedLines,\n        aiClient,\n        aiConfig\n      );\n    })\n  );\n\n  await parallelize(\n    allTasks,\n    (task) => task(),\n    nbSimultaneousFileProcessed ?? 3\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoDA,MAAa,YAAY,OAAO,EAC9B,YACA,SACA,qBACA,YACA,WACA,6BACA,eACA,oBACA,sBACA,qBACA,cACA,iBACsB;CACtB,MAAM,4DAAiC,cAAc;AACrD,8CAAiB,cAAc;CAE/B,MAAM,sDAAyB,cAAc;CAE7C,MAAM,WAAW,MAAMA,8BAAQ,eAAe,UAAU;AAExD,KAAI,CAAC,UAAU,YAAa;CAE5B,MAAM,EAAE,UAAU,aAAa;CAE/B,MAAM,EAAE,aAAa,UAAU,yCAAuB,SAAU;AAChE,KAAI,CAAC,aAAa;AAChB,YAAU,GAAGC,0BAAE,GAAG,QAAQ;AAC1B;;AAGF,KAAI,+BAA+B,8BAA8B,IAAI;AACnE,YACE,kDAAkD,4BAA4B,+CAC/E;AACD,gCAA8B;;CAGhC,IAAI,UAAoB,6BAAS,YAAY,EAC3C,QAAQ,qBACT,CAAC;AAEF,KAAI,YAAY;EACd,MAAM,kBAAkB,+CAAmB,WAAW;AAEtD,MAAI,gBAIF,WAAU,QAAQ,QAAQ,SACxB,gBAAgB,MAAM,gCAAiB,QAAQ,KAAK,EAAE,KAAK,KAAK,QAAQ,CACzE;;AAML,WAAU,6DAA+B,WAAW,GAAG;AACvD,WACE,yDAA4B,QAAQ,OAAO,CAAC,yDAA2B,QAAQ,CAAC,IACjF;AAED,WAAU,yDAA4B,QAAQ,OAAO,CAAC,SAAS;AAC/D,WAAU,QAAQ,KAAK,SAAS,+CAAiB,KAAK,CAAC,IAAI,CAAC;AAyE5D,iDAtEiB,QAAQ,SAAS,YAChC,QAAQ,KAAK,WAAW,YAAY;AAClC,YACE,4DAA8B,QAAQ,CAAC,iDAAmB,OAAO,GAClE;EAED,MAAM,2CAA4B,cAAc,OAAO,SAAS,QAAQ;EACxE,MAAM,iBAAiBC,kDACrB,sBACA,QACA,WACD;AAGD,MAAI,wCAA2B,eAAe,EAAE;GAC9C,MAAM,uCACJ,cAAc,OAAO,SACrB,eACD;AACD,aACE,yCAAY,KAAKC,wBAAW,OAAO,CAAC,iDAAmB,aAAa,CAAC,4BACtE;AACD;;AAIF,8BAAe,eAAe,EAAE;GAC9B,MAAM,uBAAuBC,4DAAuB,gBAAgB;IAClE;IACA;IACD,CAAC;AAEF,OAAI,qBAAqB,WAAW;AAClC,cAAU,qBAAqB,QAAQ;AACvC;;aAEO,wBAAwB,oBAEjC,WACE,yCAAY,KAAKD,wBAAW,OAAO,CAAC,iDAAmB,eAAe,CAAC,oDACxE;EAGH,IAAI;AAEJ,MAAI,YAAY;GACd,MAAM,kBAAkB,+CACtB,sBACA,WACD;AAED,aAAU,sBAAsB,gBAAgB,KAAK,KAAK,GAAG;AAC7D,kBAAe;;AAGjB,QAAME,2DACJ,sBACA,gBACA,QACA,YACA,WACA,eACA,oBACA,cACA,UACA,SACD;GACD,CACH,GAIE,SAAS,MAAM,EAChB,+BAA+B,EAChC"}

package/dist/cjs/translateDoc/translateDoc.cjs

@@ -12,6 +12,7 @@ let _intlayer_config_colors = require("@intlayer/config/colors");
 _intlayer_config_colors = require_runtime.__toESM(_intlayer_config_colors);
 let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_config_node = require("@intlayer/config/node");
+let _intlayer_ai = require("@intlayer/ai");
 let fast_glob = require("fast-glob");
 fast_glob = require_runtime.__toESM(fast_glob);
 let node_perf_hooks = require("node:perf_hooks");
@@ -27,6 +28,11 @@ const translateDoc = async ({ docPattern, locales, excludedGlobPattern, baseLoca
 	const aiResult = await require_utils_setupAI.setupAI(configuration, aiOptions);
 	if (!aiResult?.hasAIAccess) return;
 	const { aiClient, aiConfig } = aiResult;
+	const { hasAIAccess, error } = await (0, _intlayer_ai.checkAISDKAccess)(aiConfig);
+	if (!hasAIAccess) {
+		appLogger(`${_intlayer_config_logger.x} ${error}`);
+		return;
+	}
 	if (gitOptions) {
 		const gitChangedFiles = await (0, _intlayer_chokidar_cli.listGitFiles)(gitOptions);
 		if (gitChangedFiles) docList = docList.filter((path) => gitChangedFiles.some((gitFile) => (0, node_path.join)(process.cwd(), path) === gitFile));