@intlayer/cli 8.7.12 → 8.7.14

package/README.md

@@ -190,7 +190,22 @@ Explore our comprehensive documentation to get started with Intlayer and learn h
   <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React using Compiler</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-react/compiler" rel=''>React-router-v7</a></li>
-  <li><a href="https://intlayer.org/doc/environment/vite-and-react/tanstack-start" rel=''>Tanstack start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/tanstack-start" rel=''>Tanstack start</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/environment/tanstack-start/solid" rel=''>Solid</a></li>
+    </ul>
+  </li>
+  <li><a href="https://intlayer.org/doc/environment/astro" rel=''>Astro</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/environment/astro/react" rel=''>React</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/vue" rel=''>Vue</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/svelte" rel=''>Svelte</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/solid" rel=''>Solid</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/vanilla" rel=''>Vanilla JS</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/lit" rel=''>Lit</a></li>
+    </ul>
+  </li>
+
   <li><a href="https://intlayer.org/doc/environment/react-native-and-expo" rel=''>React Native</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-svelte" rel=''>Vite + Svelte</a></li>
   <li><a href="https://intlayer.org/doc/environment/sveltekit" rel=''>SvelteKit</a></li>
@@ -212,6 +227,17 @@ Explore our comprehensive documentation to get started with Intlayer and learn h
 </ul>
 </details>
 
+<details>
+<summary style="font-size:16px; font-weight:bold;">📊 Benchmark</summary>
+<ul>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/nextjs.md" rel=''>Next.js</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/tanstack.md" rel=''>TanStack Start</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md" rel=''>Vue</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md" rel=''>Solid</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md" rel=''>Svelte</a></li>
+</ul>
+</details>
+
 <details>
 <summary style="font-size:16px; font-weight:bold;">📰 Blog</summary>
 <ul>

package/dist/cjs/fill/writeFill.cjs

@@ -36,13 +36,12 @@ const writeFill = async (contentDeclarationFile, outputLocales, parentLocales, c
 			continue;
 		}
 		const { fill, ...rest } = contentDeclarationFile;
-		const relativeFilePath = (0, node_path.relative)(configuration.system.baseDir, output.filePath);
 		await (0, _intlayer_chokidar_build.writeContentDeclaration)({
 			...rest,
 			filled: true,
 			locale: output.isPerLocale ? output.localeList[0] : void 0,
-			localId: `${contentDeclarationFile.key}::local::${relativeFilePath}`,
-			filePath: relativeFilePath
+			localId: `${contentDeclarationFile.key}::local::${output.filePath}`,
+			filePath: (0, node_path.join)(configuration.system.baseDir, output.filePath)
 		}, configuration, { localeList: output.isPerLocale ? output.localeList : outputLocales ?? configuration.internationalization.locales });
 		if (output.isPerLocale) appLogger(`Auto filled per-locale content declaration for '${(0, _intlayer_config_logger.colorizeKey)(fullDictionary.key)}' written to ${(0, _intlayer_chokidar_utils.formatPath)(output.filePath)} for locale ${(0, _intlayer_chokidar_utils.formatLocale)(output.localeList[0])}`, { level: "info" });
 		else appLogger(`Auto filled content declaration for '${(0, _intlayer_config_logger.colorizeKey)(fullDictionary.key)}' written to ${(0, _intlayer_chokidar_utils.formatPath)(output.filePath)}`, { level: "info" });

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

@@ -1 +1 @@
-{"version":3,"file":"writeFill.cjs","names":["getAvailableLocalesInDictionary","formatFillData"],"sources":["../../../src/fill/writeFill.ts"],"sourcesContent":["import { relative } from 'node:path';\nimport { writeContentDeclaration } from '@intlayer/chokidar/build';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary, Fill } from '@intlayer/types/dictionary';\nimport { type FillData, formatFillData } from './formatFillData';\nimport { getAvailableLocalesInDictionary } from './getAvailableLocalesInDictionary';\n\nexport const writeFill = async (\n  contentDeclarationFile: Dictionary,\n  outputLocales: Locale[],\n  parentLocales: Locale[],\n  configuration: IntlayerConfig\n) => {\n  const appLogger = getAppLogger(configuration);\n  const dictionaries = getDictionaries(configuration);\n\n  const fullDictionary = dictionaries[contentDeclarationFile.key];\n\n  const { filePath } = contentDeclarationFile;\n\n  if (!filePath) {\n    appLogger('No file path found for dictionary', {\n      level: 'error',\n    });\n    return;\n  }\n\n  const fillOptions: Fill | undefined =\n    contentDeclarationFile.fill ?? configuration.dictionary?.fill ?? true;\n\n  if ((fillOptions as boolean) === false) {\n    appLogger(\n      `Auto fill is disabled for '${colorizeKey(fullDictionary.key)}'`,\n      {\n        level: 'info',\n      }\n    );\n    return;\n  }\n\n  const requestedLocales: Locale[] = (\n    outputLocales ?? configuration.internationalization.locales\n  ).filter((locale) => !parentLocales?.includes(locale));\n\n  // Get locales that actually have translations in the content\n  const availableLocales = getAvailableLocalesInDictionary(\n    contentDeclarationFile\n  );\n\n  // Only write files for locales that have actual translations\n  const localeList = requestedLocales.filter((locale) =>\n    availableLocales.includes(locale)\n  );\n\n  if (localeList.length === 0) {\n    appLogger(\n      `No translations available for dictionary '${colorizeKey(fullDictionary.key)}'`,\n      {\n        level: 'info',\n      }\n    );\n    return;\n  }\n\n  const fillData: FillData[] = await formatFillData(\n    fillOptions as Fill,\n    localeList,\n    filePath,\n    fullDictionary.key,\n    configuration\n  );\n\n  for await (const output of fillData) {\n    if (!output.filePath) {\n      appLogger(\n        `No file path found for auto filled content declaration for '${colorizeKey(fullDictionary.key)}'`,\n        {\n          level: 'error',\n        }\n      );\n      continue;\n    }\n\n    const { fill, ...rest } = contentDeclarationFile;\n\n    const relativeFilePath = relative(\n      configuration.system.baseDir,\n      output.filePath\n    );\n\n    await writeContentDeclaration(\n      {\n        ...rest,\n        filled: true,\n        locale: output.isPerLocale ? output.localeList[0] : undefined,\n        localId: `${contentDeclarationFile.key}::local::${relativeFilePath}`,\n        filePath: relativeFilePath,\n      },\n      configuration,\n      {\n        // Per-locale files: write only the specific locale.\n        // Multilingual files (string/function fill, single output): include all\n        // output locales (including source) so the file is complete.\n        localeList: output.isPerLocale\n          ? output.localeList\n          : (outputLocales ?? configuration.internationalization.locales),\n      }\n    );\n\n    if (output.isPerLocale) {\n      appLogger(\n        `Auto filled per-locale content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)} for locale ${formatLocale(output.localeList[0])}`,\n        { level: 'info' }\n      );\n    } else {\n      appLogger(\n        `Auto filled content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)}`,\n        { level: 'info' }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,YAAY,OACvB,wBACA,eACA,eACA,kBACG;CACH,MAAM,sDAAyB,cAAc;CAG7C,MAAM,mEAF+B,cAEF,CAAC,uBAAuB;CAE3D,MAAM,EAAE,aAAa;AAErB,KAAI,CAAC,UAAU;AACb,YAAU,qCAAqC,EAC7C,OAAO,SACR,CAAC;AACF;;CAGF,MAAM,cACJ,uBAAuB,QAAQ,cAAc,YAAY,QAAQ;AAEnE,KAAK,gBAA4B,OAAO;AACtC,YACE,uEAA0C,eAAe,IAAI,CAAC,IAC9D,EACE,OAAO,QACR,CACF;AACD;;CAGF,MAAM,oBACJ,iBAAiB,cAAc,qBAAqB,SACpD,QAAQ,WAAW,CAAC,eAAe,SAAS,OAAO,CAAC;CAGtD,MAAM,mBAAmBA,6EACvB,uBACD;CAGD,MAAM,aAAa,iBAAiB,QAAQ,WAC1C,iBAAiB,SAAS,OAAO,CAClC;AAED,KAAI,WAAW,WAAW,GAAG;AAC3B,YACE,sFAAyD,eAAe,IAAI,CAAC,IAC7E,EACE,OAAO,QACR,CACF;AACD;;CAGF,MAAM,WAAuB,MAAMC,2CACjC,aACA,YACA,UACA,eAAe,KACf,cACD;AAED,YAAW,MAAM,UAAU,UAAU;AACnC,MAAI,CAAC,OAAO,UAAU;AACpB,aACE,wGAA2E,eAAe,IAAI,CAAC,IAC/F,EACE,OAAO,SACR,CACF;AACD;;EAGF,MAAM,EAAE,MAAM,GAAG,SAAS;EAE1B,MAAM,2CACJ,cAAc,OAAO,SACrB,OAAO,SACR;AAED,8DACE;GACE,GAAG;GACH,QAAQ;GACR,QAAQ,OAAO,cAAc,OAAO,WAAW,KAAK;GACpD,SAAS,GAAG,uBAAuB,IAAI,WAAW;GAClD,UAAU;GACX,EACD,eACA,EAIE,YAAY,OAAO,cACf,OAAO,aACN,iBAAiB,cAAc,qBAAqB,SAC1D,CACF;AAED,MAAI,OAAO,YACT,WACE,4FAA+D,eAAe,IAAI,CAAC,wDAA0B,OAAO,SAAS,CAAC,yDAA2B,OAAO,WAAW,GAAG,IAC9K,EAAE,OAAO,QAAQ,CAClB;MAED,WACE,iFAAoD,eAAe,IAAI,CAAC,wDAA0B,OAAO,SAAS,IAClH,EAAE,OAAO,QAAQ,CAClB"}
+{"version":3,"file":"writeFill.cjs","names":["getAvailableLocalesInDictionary","formatFillData"],"sources":["../../../src/fill/writeFill.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { writeContentDeclaration } from '@intlayer/chokidar/build';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary, Fill } from '@intlayer/types/dictionary';\nimport { type FillData, formatFillData } from './formatFillData';\nimport { getAvailableLocalesInDictionary } from './getAvailableLocalesInDictionary';\n\nexport const writeFill = async (\n  contentDeclarationFile: Dictionary,\n  outputLocales: Locale[],\n  parentLocales: Locale[],\n  configuration: IntlayerConfig\n) => {\n  const appLogger = getAppLogger(configuration);\n  const dictionaries = getDictionaries(configuration);\n\n  const fullDictionary = dictionaries[contentDeclarationFile.key];\n\n  const { filePath } = contentDeclarationFile;\n\n  if (!filePath) {\n    appLogger('No file path found for dictionary', {\n      level: 'error',\n    });\n    return;\n  }\n\n  const fillOptions: Fill | undefined =\n    contentDeclarationFile.fill ?? configuration.dictionary?.fill ?? true;\n\n  if ((fillOptions as boolean) === false) {\n    appLogger(\n      `Auto fill is disabled for '${colorizeKey(fullDictionary.key)}'`,\n      {\n        level: 'info',\n      }\n    );\n    return;\n  }\n\n  const requestedLocales: Locale[] = (\n    outputLocales ?? configuration.internationalization.locales\n  ).filter((locale) => !parentLocales?.includes(locale));\n\n  // Get locales that actually have translations in the content\n  const availableLocales = getAvailableLocalesInDictionary(\n    contentDeclarationFile\n  );\n\n  // Only write files for locales that have actual translations\n  const localeList = requestedLocales.filter((locale) =>\n    availableLocales.includes(locale)\n  );\n\n  if (localeList.length === 0) {\n    appLogger(\n      `No translations available for dictionary '${colorizeKey(fullDictionary.key)}'`,\n      {\n        level: 'info',\n      }\n    );\n    return;\n  }\n\n  const fillData: FillData[] = await formatFillData(\n    fillOptions as Fill,\n    localeList,\n    filePath,\n    fullDictionary.key,\n    configuration\n  );\n\n  for await (const output of fillData) {\n    if (!output.filePath) {\n      appLogger(\n        `No file path found for auto filled content declaration for '${colorizeKey(fullDictionary.key)}'`,\n        {\n          level: 'error',\n        }\n      );\n      continue;\n    }\n\n    const { fill, ...rest } = contentDeclarationFile;\n\n    await writeContentDeclaration(\n      {\n        ...rest,\n        filled: true,\n        locale: output.isPerLocale ? output.localeList[0] : undefined,\n        localId: `${contentDeclarationFile.key}::local::${output.filePath}`,\n        filePath: join(configuration.system.baseDir, output.filePath), // Use absolute path for vscode extension\n      },\n      configuration,\n      {\n        // Per-locale files: write only the specific locale.\n        // Multilingual files (string/function fill, single output): include all\n        // output locales (including source) so the file is complete.\n        localeList: output.isPerLocale\n          ? output.localeList\n          : (outputLocales ?? configuration.internationalization.locales),\n      }\n    );\n\n    if (output.isPerLocale) {\n      appLogger(\n        `Auto filled per-locale content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)} for locale ${formatLocale(output.localeList[0])}`,\n        { level: 'info' }\n      );\n    } else {\n      appLogger(\n        `Auto filled content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)}`,\n        { level: 'info' }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,YAAY,OACvB,wBACA,eACA,eACA,kBACG;CACH,MAAM,sDAAyB,cAAc;CAG7C,MAAM,mEAF+B,cAEF,CAAC,uBAAuB;CAE3D,MAAM,EAAE,aAAa;AAErB,KAAI,CAAC,UAAU;AACb,YAAU,qCAAqC,EAC7C,OAAO,SACR,CAAC;AACF;;CAGF,MAAM,cACJ,uBAAuB,QAAQ,cAAc,YAAY,QAAQ;AAEnE,KAAK,gBAA4B,OAAO;AACtC,YACE,uEAA0C,eAAe,IAAI,CAAC,IAC9D,EACE,OAAO,QACR,CACF;AACD;;CAGF,MAAM,oBACJ,iBAAiB,cAAc,qBAAqB,SACpD,QAAQ,WAAW,CAAC,eAAe,SAAS,OAAO,CAAC;CAGtD,MAAM,mBAAmBA,6EACvB,uBACD;CAGD,MAAM,aAAa,iBAAiB,QAAQ,WAC1C,iBAAiB,SAAS,OAAO,CAClC;AAED,KAAI,WAAW,WAAW,GAAG;AAC3B,YACE,sFAAyD,eAAe,IAAI,CAAC,IAC7E,EACE,OAAO,QACR,CACF;AACD;;CAGF,MAAM,WAAuB,MAAMC,2CACjC,aACA,YACA,UACA,eAAe,KACf,cACD;AAED,YAAW,MAAM,UAAU,UAAU;AACnC,MAAI,CAAC,OAAO,UAAU;AACpB,aACE,wGAA2E,eAAe,IAAI,CAAC,IAC/F,EACE,OAAO,SACR,CACF;AACD;;EAGF,MAAM,EAAE,MAAM,GAAG,SAAS;AAE1B,8DACE;GACE,GAAG;GACH,QAAQ;GACR,QAAQ,OAAO,cAAc,OAAO,WAAW,KAAK;GACpD,SAAS,GAAG,uBAAuB,IAAI,WAAW,OAAO;GACzD,8BAAe,cAAc,OAAO,SAAS,OAAO,SAAS;GAC9D,EACD,eACA,EAIE,YAAY,OAAO,cACf,OAAO,aACN,iBAAiB,cAAc,qBAAqB,SAC1D,CACF;AAED,MAAI,OAAO,YACT,WACE,4FAA+D,eAAe,IAAI,CAAC,wDAA0B,OAAO,SAAS,CAAC,yDAA2B,OAAO,WAAW,GAAG,IAC9K,EAAE,OAAO,QAAQ,CAClB;MAED,WACE,iFAAoD,eAAe,IAAI,CAAC,wDAA0B,OAAO,SAAS,IAClH,EAAE,OAAO,QAAQ,CAClB"}

package/dist/cjs/reviewDoc/reviewDocBlockAware.cjs

@@ -74,12 +74,11 @@ const reviewFileBlockAware = async (baseFilePath, outputFilePath, locale, baseLo
 				{
 					role: "system",
 					content: `The next user message will be the **BLOCK ${(0, _intlayer_config_logger.colorizeNumber)(segmentNumber)} of ${(0, _intlayer_config_logger.colorizeNumber)(segmentsToReview.length)}** that should be translated in ${(0, _intlayer_core_localization.getLocaleName)(locale, _intlayer_types_locales.ENGLISH)} (${locale}).`
-				},
-				{
-					role: "user",
-					content: englishBlock.content
 				}
-			], aiOptions, configuration, aiClient, aiConfig);
+			], [{
+				role: "user",
+				content: englishBlock.content
+			}], aiOptions, configuration, aiClient, aiConfig);
 			applicationLogger(`${prefix}${(0, _intlayer_config_logger.colorizeNumber)(result.tokenUsed)} tokens used - Block ${(0, _intlayer_config_logger.colorizeNumber)(segmentNumber)} of ${(0, _intlayer_config_logger.colorizeNumber)(segmentsToReview.length)}`);
 			let processedChunk = require_translateDoc_validation.sanitizeChunk(result?.fileContent, englishBlock.content);
 			processedChunk = require_utils_fixChunkStartEndChars.fixChunkStartEndChars(processedChunk, englishBlock.content);

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

@@ -1 +1 @@
-{"version":3,"file":"reviewDocBlockAware.cjs","names":["readAsset","ANSIColors","buildAlignmentPlan","mergeReviewedSegments","chunkInference","ENGLISH","sanitizeChunk","fixChunkStartEndChars","validateTranslation"],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport type { AIConfig } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { retryManager } from '@intlayer/config/utils';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { sanitizeChunk, validateTranslation } from '../translateDoc/validation';\nimport {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n} from '../translation-alignment/pipeline';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { AIClient } from '../utils/setupAI';\n\n/**\n * Review a file using block-aware alignment.\n * This approach:\n * 1. Segments both English and French documents into semantic blocks\n * 2. Aligns blocks using structure (special chars, numbers) and context\n * 3. Detects which blocks changed, were added, or deleted\n * 4. Only sends changed/new blocks to AI for translation\n * 5. Handles reordering automatically\n */\nexport const reviewFileBlockAware = async (\n  baseFilePath: string,\n  outputFilePath: string,\n  locale: Locale,\n  baseLocale: Locale,\n  aiOptions?: AIOptions,\n  configOptions?: GetConfigurationOptions,\n  customInstructions?: string,\n  changedLines?: number[],\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n) => {\n  const configuration = getConfiguration(configOptions);\n  const applicationLogger = getAppLogger(configuration);\n\n  const englishText = await readFile(baseFilePath, 'utf-8');\n  const frenchText = await readFile(outputFilePath, 'utf-8').catch(() => '');\n\n  const basePrompt = readAsset('./prompts/REVIEW_PROMPT.md', 'utf-8')\n    .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n    .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n    .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n    .replace('{{customInstructions}}', customInstructions ?? '-');\n\n  const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n  const filePrefix = [\n    colon(filePrefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n  const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n  const prefix = [\n    colon(prefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n\n  // Build block-aware alignment and plan\n  const { englishBlocks, frenchBlocks, plan, segmentsToReview } =\n    buildAlignmentPlan({\n      englishText,\n      frenchText,\n      changedLines,\n    });\n\n  applicationLogger(\n    `${filePrefix}Block-aware alignment complete. Total blocks: EN=${colorizeNumber(englishBlocks.length)}, FR=${colorizeNumber(frenchBlocks.length)}`\n  );\n  applicationLogger(\n    `${filePrefix}Actions: reuse=${colorizeNumber(plan.actions.filter((a) => a.kind === 'reuse').length)}, review=${colorizeNumber(plan.actions.filter((a) => a.kind === 'review').length)}, new=${colorizeNumber(plan.actions.filter((a) => a.kind === 'insert_new').length)}, delete=${colorizeNumber(plan.actions.filter((a) => a.kind === 'delete').length)}`\n  );\n\n  if (segmentsToReview.length === 0) {\n    applicationLogger(\n      `${filePrefix}No segments need review, reusing existing translation`\n    );\n    mkdirSync(dirname(outputFilePath), { recursive: true });\n    writeFileSync(\n      outputFilePath,\n      mergeReviewedSegments(plan, frenchBlocks, new Map())\n    );\n    applicationLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no changes needed).`\n    );\n    return;\n  }\n\n  applicationLogger(\n    `${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)}`\n  );\n\n  // Review segments that need AI translation\n  const reviewedSegmentsMap = new Map<number, string>();\n\n  for (const segment of segmentsToReview) {\n    const segmentNumber = segmentsToReview.indexOf(segment) + 1;\n    const englishBlock = segment.englishBlock;\n\n    const getBaseChunkContextPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\\n` +\n      `///chunksStart///\\n` +\n      englishBlock.content +\n      `///chunksEnd///`;\n\n    const getFrenchChunkPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\\n` +\n      `///chunksStart///\\n` +\n      (segment.frenchBlockText ?? '') +\n      `///chunksEnd///`;\n\n    const reviewedChunkResult = await retryManager(async () => {\n      const result = await chunkInference(\n        [\n          { role: 'system', content: basePrompt },\n          { role: 'system', content: getBaseChunkContextPrompt() },\n          { role: 'system', content: getFrenchChunkPrompt() },\n          {\n            role: 'system',\n            content: `The next user message will be the **BLOCK ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`,\n          },\n          { role: 'user', content: englishBlock.content },\n        ],\n        aiOptions,\n        configuration,\n        aiClient,\n        aiConfig\n      );\n\n      applicationLogger(\n        `${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}`\n      );\n\n      // Sanitize artifacts (e.g. Markdown code block wrappers)\n      let processedChunk = sanitizeChunk(\n        result?.fileContent,\n        englishBlock.content\n      );\n\n      // Fix start/end characters\n      processedChunk = fixChunkStartEndChars(\n        processedChunk,\n        englishBlock.content\n      );\n\n      // Validate Translation (YAML, Code fences, Length ratio)\n      const isValid = validateTranslation(\n        englishBlock.content,\n        processedChunk,\n        applicationLogger\n      );\n\n      if (!isValid) {\n        throw new Error(\n          'Validation failed for chunk (structure or length mismatch). Retrying...'\n        );\n      }\n\n      return processedChunk;\n    })();\n\n    reviewedSegmentsMap.set(segment.actionIndex, reviewedChunkResult);\n  }\n\n  // Merge reviewed segments back into final document\n  const finalFrenchOutput = mergeReviewedSegments(\n    plan,\n    frenchBlocks,\n    reviewedSegmentsMap\n  );\n\n  mkdirSync(dirname(outputFilePath), { recursive: true });\n  writeFileSync(outputFilePath, finalFrenchOutput);\n\n  applicationLogger(\n    `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`\n  );\n};\n"],"mappings":"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"}
+{"version":3,"file":"reviewDocBlockAware.cjs","names":["readAsset","ANSIColors","buildAlignmentPlan","mergeReviewedSegments","chunkInference","ENGLISH","sanitizeChunk","fixChunkStartEndChars","validateTranslation"],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport type { AIConfig } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { retryManager } from '@intlayer/config/utils';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { sanitizeChunk, validateTranslation } from '../translateDoc/validation';\nimport {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n} from '../translation-alignment/pipeline';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { AIClient } from '../utils/setupAI';\n\n/**\n * Review a file using block-aware alignment.\n * This approach:\n * 1. Segments both English and French documents into semantic blocks\n * 2. Aligns blocks using structure (special chars, numbers) and context\n * 3. Detects which blocks changed, were added, or deleted\n * 4. Only sends changed/new blocks to AI for translation\n * 5. Handles reordering automatically\n */\nexport const reviewFileBlockAware = async (\n  baseFilePath: string,\n  outputFilePath: string,\n  locale: Locale,\n  baseLocale: Locale,\n  aiOptions?: AIOptions,\n  configOptions?: GetConfigurationOptions,\n  customInstructions?: string,\n  changedLines?: number[],\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n) => {\n  const configuration = getConfiguration(configOptions);\n  const applicationLogger = getAppLogger(configuration);\n\n  const englishText = await readFile(baseFilePath, 'utf-8');\n  const frenchText = await readFile(outputFilePath, 'utf-8').catch(() => '');\n\n  const basePrompt = readAsset('./prompts/REVIEW_PROMPT.md', 'utf-8')\n    .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n    .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n    .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n    .replace('{{customInstructions}}', customInstructions ?? '-');\n\n  const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n  const filePrefix = [\n    colon(filePrefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n  const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n  const prefix = [\n    colon(prefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n\n  // Build block-aware alignment and plan\n  const { englishBlocks, frenchBlocks, plan, segmentsToReview } =\n    buildAlignmentPlan({\n      englishText,\n      frenchText,\n      changedLines,\n    });\n\n  applicationLogger(\n    `${filePrefix}Block-aware alignment complete. Total blocks: EN=${colorizeNumber(englishBlocks.length)}, FR=${colorizeNumber(frenchBlocks.length)}`\n  );\n  applicationLogger(\n    `${filePrefix}Actions: reuse=${colorizeNumber(plan.actions.filter((a) => a.kind === 'reuse').length)}, review=${colorizeNumber(plan.actions.filter((a) => a.kind === 'review').length)}, new=${colorizeNumber(plan.actions.filter((a) => a.kind === 'insert_new').length)}, delete=${colorizeNumber(plan.actions.filter((a) => a.kind === 'delete').length)}`\n  );\n\n  if (segmentsToReview.length === 0) {\n    applicationLogger(\n      `${filePrefix}No segments need review, reusing existing translation`\n    );\n    mkdirSync(dirname(outputFilePath), { recursive: true });\n    writeFileSync(\n      outputFilePath,\n      mergeReviewedSegments(plan, frenchBlocks, new Map())\n    );\n    applicationLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no changes needed).`\n    );\n    return;\n  }\n\n  applicationLogger(\n    `${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)}`\n  );\n\n  // Review segments that need AI translation\n  const reviewedSegmentsMap = new Map<number, string>();\n\n  for (const segment of segmentsToReview) {\n    const segmentNumber = segmentsToReview.indexOf(segment) + 1;\n    const englishBlock = segment.englishBlock;\n\n    const getBaseChunkContextPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\\n` +\n      `///chunksStart///\\n` +\n      englishBlock.content +\n      `///chunksEnd///`;\n\n    const getFrenchChunkPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\\n` +\n      `///chunksStart///\\n` +\n      (segment.frenchBlockText ?? '') +\n      `///chunksEnd///`;\n\n    const reviewedChunkResult = await retryManager(async () => {\n      const result = await chunkInference(\n        [\n          { role: 'system', content: basePrompt },\n          { role: 'system', content: getBaseChunkContextPrompt() },\n          { role: 'system', content: getFrenchChunkPrompt() },\n          {\n            role: 'system',\n            content: `The next user message will be the **BLOCK ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`,\n          },\n        ],\n        [{ role: 'user', content: englishBlock.content }],\n        aiOptions,\n        configuration,\n        aiClient,\n        aiConfig\n      );\n\n      applicationLogger(\n        `${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}`\n      );\n\n      // Sanitize artifacts (e.g. Markdown code block wrappers)\n      let processedChunk = sanitizeChunk(\n        result?.fileContent,\n        englishBlock.content\n      );\n\n      // Fix start/end characters\n      processedChunk = fixChunkStartEndChars(\n        processedChunk,\n        englishBlock.content\n      );\n\n      // Validate Translation (YAML, Code fences, Length ratio)\n      const isValid = validateTranslation(\n        englishBlock.content,\n        processedChunk,\n        applicationLogger\n      );\n\n      if (!isValid) {\n        throw new Error(\n          'Validation failed for chunk (structure or length mismatch). Retrying...'\n        );\n      }\n\n      return processedChunk;\n    })();\n\n    reviewedSegmentsMap.set(segment.actionIndex, reviewedChunkResult);\n  }\n\n  // Merge reviewed segments back into final document\n  const finalFrenchOutput = mergeReviewedSegments(\n    plan,\n    frenchBlocks,\n    reviewedSegmentsMap\n  );\n\n  mkdirSync(dirname(outputFilePath), { recursive: true });\n  writeFileSync(outputFilePath, finalFrenchOutput);\n\n  applicationLogger(\n    `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`\n  );\n};\n"],"mappings":"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"}

package/dist/cjs/translateDoc/translateFile.cjs

@@ -5,7 +5,6 @@ const require_translateDoc_validation = require('./validation.cjs');
 const require_utils_chunkInference = require('../utils/chunkInference.cjs');
 const require_utils_fixChunkStartEndChars = require('../utils/fixChunkStartEndChars.cjs');
 const require_utils_calculateChunks = require('../utils/calculateChunks.cjs');
-let node_fs = require("node:fs");
 let node_path = require("node:path");
 let _intlayer_chokidar_utils = require("@intlayer/chokidar/utils");
 let _intlayer_config_colors = require("@intlayer/config/colors");
@@ -55,12 +54,11 @@ const translateFile = async ({ baseFilePath, outputFilePath, locale, baseLocale,
 					{
 						role: "system",
 						content: [`You are translating TARGET CHUNK (${i + 1}/${totalChunks}).`, `Translate ONLY the target chunk. Preserve frontmatter/code exactly.`].join("\n")
-					},
-					{
-						role: "user",
-						content: `>>> TARGET CHUNK START <<<\n${fileToTranslateCurrentChunk}\n>>> TARGET CHUNK END <<<`
 					}
-				], aiOptions, configuration, aiClient, aiConfig);
+				], [{
+					role: "user",
+					content: `>>> TARGET CHUNK START <<<\n${fileToTranslateCurrentChunk}\n>>> TARGET CHUNK END <<<`
+				}], aiOptions, configuration, aiClient, aiConfig);
 				let processedChunk = require_translateDoc_validation.sanitizeChunk(result?.fileContent, fileToTranslateCurrentChunk);
 				processedChunk = require_utils_fixChunkStartEndChars.fixChunkStartEndChars(processedChunk, fileToTranslateCurrentChunk);
 				if (!require_translateDoc_validation.validateTranslation(fileToTranslateCurrentChunk, processedChunk, chunkLogger)) throw new Error(`Validation failed for chunk ${i + 1}/${totalChunks}`);
@@ -77,8 +75,8 @@ const translateFile = async ({ baseFilePath, outputFilePath, locale, baseLocale,
 					let endIdx = 0;
 					while (endIdx < totalChunks && translatedParts[endIdx] && translatedParts[endIdx] !== "") endIdx++;
 					const currentContent = translatedParts.slice(0, endIdx).join("");
-					(0, node_fs.mkdirSync)((0, node_path.dirname)(outputFilePath), { recursive: true });
-					(0, node_fs.writeFileSync)(outputFilePath, currentContent);
+					await (0, node_fs_promises.mkdir)((0, node_path.dirname)(outputFilePath), { recursive: true });
+					await (0, node_fs_promises.writeFile)(outputFilePath, currentContent);
 				}
 			}
 			chunkLogger([`${(0, _intlayer_config_logger.colorizeNumber)(tokens)} tokens used `, `${_intlayer_config_colors.GREY_DARK}in ${(0, _intlayer_config_logger.colorizeNumber)(chunkDuration)}ms${_intlayer_config_colors.RESET}`].join(""));
@@ -86,8 +84,8 @@ const translateFile = async ({ baseFilePath, outputFilePath, locale, baseLocale,
 		await Promise.all(tasks);
 		const fullContent = translatedParts.join("");
 		if (flushStrategy === "end" || flushStrategy === "incremental") {
-			(0, node_fs.mkdirSync)((0, node_path.dirname)(outputFilePath), { recursive: true });
-			(0, node_fs.writeFileSync)(outputFilePath, fullContent);
+			await (0, node_fs_promises.mkdir)((0, node_path.dirname)(outputFilePath), { recursive: true });
+			await (0, node_fs_promises.writeFile)(outputFilePath, fullContent);
 		}
 		const totalDuration = ((node_perf_hooks.performance.now() - fileStartTime) / 1e3).toFixed(2);
 		const relativePath = (0, node_path.relative)(configuration.system.baseDir, outputFilePath);

package/dist/cjs/translateDoc/translateFile.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"translateFile.cjs","names":["performance","chunkText","ANSIColors","readAsset","chunkInference","sanitizeChunk","fixChunkStartEndChars","validateTranslation"],"sources":["../../../src/translateDoc/translateFile.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { dirname, relative } from 'node:path';\nimport { performance } from 'node:perf_hooks';\nimport { readAsset } from 'utils:asset';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport { retryManager } from '@intlayer/config/utils';\nimport { chunkText } from '../utils/calculateChunks';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { TranslateFileOptions } from './types';\nimport { sanitizeChunk, validateTranslation } from './validation';\n\nexport const translateFile = async ({\n  baseFilePath,\n  outputFilePath,\n  locale,\n  baseLocale,\n  configuration,\n  errorState,\n  aiOptions,\n  customInstructions,\n  aiClient,\n  aiConfig,\n  flushStrategy = 'incremental',\n  onChunkReceive,\n  limit, // The Global Limiter\n}: TranslateFileOptions): Promise<string | null> => {\n  if (errorState.shouldStop) return null;\n\n  const appLogger = getAppLogger(configuration, { config: { prefix: '' } });\n  const fileStartTime = performance.now();\n\n  try {\n    const fileContent = await readFile(baseFilePath, 'utf-8');\n    const chunks = chunkText(fileContent);\n    const totalChunks = chunks.length;\n\n    const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n    const filePrefix = `${colon(filePrefixText, { colSize: 40 })}${ANSIColors.RESET}`;\n    const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n    const prefix = `${colon(prefixText, { colSize: 40 })}${ANSIColors.RESET}`;\n\n    appLogger(\n      `${filePrefix}Split into ${colorizeNumber(totalChunks)} chunks. Queuing...`\n    );\n\n    const basePrompt = readAsset('./prompts/TRANSLATE_PROMPT.md', 'utf-8')\n      .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n      .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n      .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n      .replace('{{customInstructions}}', customInstructions ?? '-');\n\n    const translatedParts: string[] = new Array(totalChunks).fill('');\n\n    // Fallback if no limiter is provided (runs immediately)\n    const runTask = limit ?? ((fn) => fn());\n\n    // MAP CHUNKS TO GLOBAL TASKS\n    // This pushes ALL chunks for this file into the Global Queue immediately.\n    // They will execute whenever the global concurrency slots open up.\n    const tasks = chunks.map((chunk, i) =>\n      runTask(async () => {\n        if (errorState.shouldStop) return null;\n\n        const chunkLogger = getAppLogger(configuration, {\n          config: {\n            prefix: `${prefix}  ${ANSIColors.GREY_DARK}[${i + 1}/${totalChunks}] ${ANSIColors.RESET}`,\n          },\n        });\n\n        const chunkStartTime = performance.now();\n        const isFirstChunk = i === 0;\n        const fileToTranslateCurrentChunk = chunk.content;\n\n        // Context Preparation\n        const getPrevChunkPrompt = () =>\n          `>>> CONTEXT: PREVIOUS SOURCE CONTENT <<<\\n\\`\\`\\`\\n` +\n          (chunks[i - 1]?.content ?? '') +\n          `\\n\\`\\`\\`\\n>>> END PREVIOUS CONTEXT <<<`;\n\n        const getBaseChunkContextPrompt = () =>\n          `>>> CONTEXT: NEXT CONTENT <<<\\n\\`\\`\\`\\n` +\n          (chunks[i + 1]?.content ?? '') +\n          `\\n\\`\\`\\`\\n>>> END NEXT CONTEXT <<<`;\n\n        chunkLogger('Process started');\n\n        const chunkTranslation = retryManager(async () => {\n          const result = await chunkInference(\n            [\n              { role: 'system', content: basePrompt },\n              ...(chunks[i + 1]\n                ? [\n                    {\n                      role: 'system',\n                      content: getBaseChunkContextPrompt(),\n                    } as const,\n                  ]\n                : []),\n              ...(isFirstChunk\n                ? []\n                : [{ role: 'system', content: getPrevChunkPrompt() } as const]),\n              {\n                role: 'system',\n                content: [\n                  `You are translating TARGET CHUNK (${i + 1}/${totalChunks}).`,\n                  `Translate ONLY the target chunk. Preserve frontmatter/code exactly.`,\n                ].join('\\n'),\n              },\n              {\n                role: 'user',\n                content: `>>> TARGET CHUNK START <<<\\n${fileToTranslateCurrentChunk}\\n>>> TARGET CHUNK END <<<`,\n              },\n            ],\n            aiOptions,\n            configuration,\n            aiClient,\n            aiConfig\n          );\n\n          let processedChunk = sanitizeChunk(\n            result?.fileContent,\n            fileToTranslateCurrentChunk\n          );\n          processedChunk = fixChunkStartEndChars(\n            processedChunk,\n            fileToTranslateCurrentChunk\n          );\n\n          const isValid = validateTranslation(\n            fileToTranslateCurrentChunk,\n            processedChunk,\n            chunkLogger\n          );\n\n          if (!isValid) {\n            // Throwing an error here signals retryManager to try again\n            throw new Error(\n              `Validation failed for chunk ${i + 1}/${totalChunks}`\n            );\n          }\n\n          return { content: processedChunk, tokens: result.tokenUsed };\n        });\n\n        const { content: translatedChunk, tokens } = await chunkTranslation();\n        const chunkEndTime = performance.now();\n        const chunkDuration = (chunkEndTime - chunkStartTime).toFixed(0);\n\n        // Store Result\n        translatedParts[i] = translatedChunk;\n\n        if (onChunkReceive) {\n          onChunkReceive(translatedChunk, i, totalChunks);\n        }\n\n        // Incremental Flush Strategy\n        if (flushStrategy === 'incremental') {\n          const isContiguous = translatedParts\n            .slice(0, i + 1)\n            .every((p) => p && p !== '');\n\n          if (isContiguous) {\n            let endIdx = 0;\n            while (\n              endIdx < totalChunks &&\n              translatedParts[endIdx] &&\n              translatedParts[endIdx] !== ''\n            ) {\n              endIdx++;\n            }\n            const currentContent = translatedParts.slice(0, endIdx).join('');\n            // Write asynchronously/sync is fine here as node handles file locks reasonably well for single process\n            mkdirSync(dirname(outputFilePath), { recursive: true });\n            writeFileSync(outputFilePath, currentContent);\n          }\n        }\n\n        chunkLogger(\n          [\n            `${colorizeNumber(tokens)} tokens used `,\n            `${ANSIColors.GREY_DARK}in ${colorizeNumber(chunkDuration)}ms${ANSIColors.RESET}`,\n          ].join('')\n        );\n      })\n    );\n\n    // Wait for all chunks for this specific file/locale to finish\n    await Promise.all(tasks);\n\n    // Final Flush\n    const fullContent = translatedParts.join('');\n    if (flushStrategy === 'end' || flushStrategy === 'incremental') {\n      mkdirSync(dirname(outputFilePath), { recursive: true });\n      writeFileSync(outputFilePath, fullContent);\n    }\n\n    const fileEndTime = performance.now();\n    const totalDuration = ((fileEndTime - fileStartTime) / 1000).toFixed(2);\n    const relativePath = relative(configuration.system.baseDir, outputFilePath);\n\n    appLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(relativePath)} completed in ${colorizeNumber(totalDuration)}s.`\n    );\n\n    return fullContent;\n  } catch (error: any) {\n    errorState.count++;\n    const errorMessage = error?.message ?? JSON.stringify(error);\n    appLogger(`${colorize('✖', ANSIColors.RED)} Error: ${errorMessage}`);\n    if (errorState.count >= errorState.maxErrors) errorState.shouldStop = true;\n    return null;\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"translateFile.cjs","names":["performance","chunkText","ANSIColors","readAsset","chunkInference","sanitizeChunk","fixChunkStartEndChars","validateTranslation"],"sources":["../../../src/translateDoc/translateFile.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, relative } from 'node:path';\nimport { performance } from 'node:perf_hooks';\nimport { readAsset } from 'utils:asset';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport { retryManager } from '@intlayer/config/utils';\nimport { chunkText } from '../utils/calculateChunks';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { TranslateFileOptions } from './types';\nimport { sanitizeChunk, validateTranslation } from './validation';\n\nexport const translateFile = async ({\n  baseFilePath,\n  outputFilePath,\n  locale,\n  baseLocale,\n  configuration,\n  errorState,\n  aiOptions,\n  customInstructions,\n  aiClient,\n  aiConfig,\n  flushStrategy = 'incremental',\n  onChunkReceive,\n  limit, // The Global Limiter\n}: TranslateFileOptions): Promise<string | null> => {\n  if (errorState.shouldStop) return null;\n\n  const appLogger = getAppLogger(configuration, { config: { prefix: '' } });\n  const fileStartTime = performance.now();\n\n  try {\n    const fileContent = await readFile(baseFilePath, 'utf-8');\n    const chunks = chunkText(fileContent);\n    const totalChunks = chunks.length;\n\n    const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n    const filePrefix = `${colon(filePrefixText, { colSize: 40 })}${ANSIColors.RESET}`;\n    const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n    const prefix = `${colon(prefixText, { colSize: 40 })}${ANSIColors.RESET}`;\n\n    appLogger(\n      `${filePrefix}Split into ${colorizeNumber(totalChunks)} chunks. Queuing...`\n    );\n\n    const basePrompt = readAsset('./prompts/TRANSLATE_PROMPT.md', 'utf-8')\n      .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n      .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n      .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n      .replace('{{customInstructions}}', customInstructions ?? '-');\n\n    const translatedParts: string[] = new Array(totalChunks).fill('');\n\n    // Fallback if no limiter is provided (runs immediately)\n    const runTask = limit ?? ((fn) => fn());\n\n    // MAP CHUNKS TO GLOBAL TASKS\n    // This pushes ALL chunks for this file into the Global Queue immediately.\n    // They will execute whenever the global concurrency slots open up.\n    const tasks = chunks.map((chunk, i) =>\n      runTask(async () => {\n        if (errorState.shouldStop) return null;\n\n        const chunkLogger = getAppLogger(configuration, {\n          config: {\n            prefix: `${prefix}  ${ANSIColors.GREY_DARK}[${i + 1}/${totalChunks}] ${ANSIColors.RESET}`,\n          },\n        });\n\n        const chunkStartTime = performance.now();\n        const isFirstChunk = i === 0;\n        const fileToTranslateCurrentChunk = chunk.content;\n\n        // Context Preparation\n        const getPrevChunkPrompt = () =>\n          `>>> CONTEXT: PREVIOUS SOURCE CONTENT <<<\\n\\`\\`\\`\\n` +\n          (chunks[i - 1]?.content ?? '') +\n          `\\n\\`\\`\\`\\n>>> END PREVIOUS CONTEXT <<<`;\n\n        const getBaseChunkContextPrompt = () =>\n          `>>> CONTEXT: NEXT CONTENT <<<\\n\\`\\`\\`\\n` +\n          (chunks[i + 1]?.content ?? '') +\n          `\\n\\`\\`\\`\\n>>> END NEXT CONTEXT <<<`;\n\n        chunkLogger('Process started');\n\n        const chunkTranslation = retryManager(async () => {\n          const result = await chunkInference(\n            [\n              { role: 'system', content: basePrompt },\n              ...(chunks[i + 1]\n                ? [\n                    {\n                      role: 'system',\n                      content: getBaseChunkContextPrompt(),\n                    } as const,\n                  ]\n                : []),\n              ...(isFirstChunk\n                ? []\n                : [{ role: 'system', content: getPrevChunkPrompt() } as const]),\n              {\n                role: 'system',\n                content: [\n                  `You are translating TARGET CHUNK (${i + 1}/${totalChunks}).`,\n                  `Translate ONLY the target chunk. Preserve frontmatter/code exactly.`,\n                ].join('\\n'),\n              },\n            ],\n            [\n              {\n                role: 'user',\n                content: `>>> TARGET CHUNK START <<<\\n${fileToTranslateCurrentChunk}\\n>>> TARGET CHUNK END <<<`,\n              },\n            ],\n            aiOptions,\n            configuration,\n            aiClient,\n            aiConfig\n          );\n\n          let processedChunk = sanitizeChunk(\n            result?.fileContent,\n            fileToTranslateCurrentChunk\n          );\n          processedChunk = fixChunkStartEndChars(\n            processedChunk,\n            fileToTranslateCurrentChunk\n          );\n\n          const isValid = validateTranslation(\n            fileToTranslateCurrentChunk,\n            processedChunk,\n            chunkLogger\n          );\n\n          if (!isValid) {\n            // Throwing an error here signals retryManager to try again\n            throw new Error(\n              `Validation failed for chunk ${i + 1}/${totalChunks}`\n            );\n          }\n\n          return { content: processedChunk, tokens: result.tokenUsed };\n        });\n\n        const { content: translatedChunk, tokens } = await chunkTranslation();\n        const chunkEndTime = performance.now();\n        const chunkDuration = (chunkEndTime - chunkStartTime).toFixed(0);\n\n        // Store Result\n        translatedParts[i] = translatedChunk;\n\n        if (onChunkReceive) {\n          onChunkReceive(translatedChunk, i, totalChunks);\n        }\n\n        // Incremental Flush Strategy\n        if (flushStrategy === 'incremental') {\n          const isContiguous = translatedParts\n            .slice(0, i + 1)\n            .every((p) => p && p !== '');\n\n          if (isContiguous) {\n            let endIdx = 0;\n            while (\n              endIdx < totalChunks &&\n              translatedParts[endIdx] &&\n              translatedParts[endIdx] !== ''\n            ) {\n              endIdx++;\n            }\n            const currentContent = translatedParts.slice(0, endIdx).join('');\n            // Write asynchronously/sync is fine here as node handles file locks reasonably well for single process\n            await mkdir(dirname(outputFilePath), { recursive: true });\n            await writeFile(outputFilePath, currentContent);\n          }\n        }\n\n        chunkLogger(\n          [\n            `${colorizeNumber(tokens)} tokens used `,\n            `${ANSIColors.GREY_DARK}in ${colorizeNumber(chunkDuration)}ms${ANSIColors.RESET}`,\n          ].join('')\n        );\n      })\n    );\n\n    // Wait for all chunks for this specific file/locale to finish\n    await Promise.all(tasks);\n\n    // Final Flush\n    const fullContent = translatedParts.join('');\n    if (flushStrategy === 'end' || flushStrategy === 'incremental') {\n      await mkdir(dirname(outputFilePath), { recursive: true });\n      await writeFile(outputFilePath, fullContent);\n    }\n\n    const fileEndTime = performance.now();\n    const totalDuration = ((fileEndTime - fileStartTime) / 1000).toFixed(2);\n    const relativePath = relative(configuration.system.baseDir, outputFilePath);\n\n    appLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(relativePath)} completed in ${colorizeNumber(totalDuration)}s.`\n    );\n\n    return fullContent;\n  } catch (error: any) {\n    errorState.count++;\n    const errorMessage = error?.message ?? JSON.stringify(error);\n    appLogger(`${colorize('✖', ANSIColors.RED)} Error: ${errorMessage}`);\n    if (errorState.count >= errorState.maxErrors) errorState.shouldStop = true;\n    return null;\n  }\n};\n"],"mappings":"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"}

package/dist/cjs/utils/chunkInference.cjs

@@ -8,12 +8,13 @@ let _intlayer_config_utils = require("@intlayer/config/utils");
 * Translates a single chunk via the OpenAI API.
 * Includes retry logic if the call fails.
 */
-const chunkInference = async (messages, aiOptions, configuration, aiClient, aiConfig) => {
+const chunkInference = async (system, messages, aiOptions, configuration, aiClient, aiConfig) => {
 	let lastResult;
 	await (0, _intlayer_config_utils.retryManager)(async () => {
 		if (aiClient && aiConfig) {
 			const response = await aiClient.customQuery({
 				aiConfig,
+				system,
 				messages
 			});
 			if (!response) throw new Error("No response from AI API");

package/dist/cjs/utils/chunkInference.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunkInference.cjs","names":[],"sources":["../../../src/utils/chunkInference.ts"],"sourcesContent":["import type { AIConfig, AIOptions } from '@intlayer/ai';\nimport { getIntlayerAPIProxy, type Messages } from '@intlayer/api';\nimport { retryManager } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { AIClient } from './setupAI';\n\ntype ChunkInferenceResult = {\n  fileContent: string;\n  tokenUsed: number;\n};\n\n/**\n * Translates a single chunk via the OpenAI API.\n * Includes retry logic if the call fails.\n */\nexport const chunkInference = async (\n  messages: Messages,\n  aiOptions?: AIOptions,\n  configuration?: IntlayerConfig,\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n): Promise<ChunkInferenceResult> => {\n  let lastResult: ChunkInferenceResult;\n\n  await retryManager(async () => {\n    if (aiClient && aiConfig) {\n      const response = await aiClient.customQuery({\n        aiConfig,\n        messages,\n      });\n\n      if (!response) {\n        throw new Error('No response from AI API');\n      }\n\n      const { fileContent, tokenUsed } = response;\n\n      lastResult = {\n        fileContent: processContent(fileContent),\n        tokenUsed,\n      };\n\n      return;\n    }\n\n    const api = getIntlayerAPIProxy(undefined, configuration);\n\n    const response = await api.ai.customQuery({\n      aiOptions,\n      messages,\n    });\n\n    if (!response.data) {\n      throw new Error('No response from AI API');\n    }\n\n    const { fileContent, tokenUsed } = response.data;\n\n    lastResult = {\n      fileContent: processContent(fileContent),\n      tokenUsed,\n    };\n  })();\n\n  return lastResult!;\n};\n\nconst processContent = (content: string) => {\n  return content\n    .replaceAll('///chunksStart///', '')\n    .replaceAll('///chunkStart///', '')\n    .replaceAll('///chunksEnd///', '')\n    .replaceAll('///chunkEnd///', '')\n    .replaceAll('///chunksStart///', '')\n    .replaceAll('chunkStart///', '')\n    .replaceAll('chunksEnd///', '')\n    .replaceAll('chunkEnd///', '')\n    .replaceAll('///chunksStart', '')\n    .replaceAll('///chunkStart', '')\n    .replaceAll('///chunksEnd', '')\n    .replaceAll('///chunkEnd', '')\n    .replaceAll('chunksStart', '')\n    .replaceAll('chunkStart', '')\n    .replaceAll('chunksEnd', '')\n    .replaceAll('chunkEnd', '');\n};\n"],"mappings":";;;;;;;;;;AAeA,MAAa,iBAAiB,OAC5B,UACA,WACA,eACA,UACA,aACkC;CAClC,IAAI;AAEJ,gDAAmB,YAAY;AAC7B,MAAI,YAAY,UAAU;GACxB,MAAM,WAAW,MAAM,SAAS,YAAY;IAC1C;IACA;IACD,CAAC;AAEF,OAAI,CAAC,SACH,OAAM,IAAI,MAAM,0BAA0B;GAG5C,MAAM,EAAE,aAAa,cAAc;AAEnC,gBAAa;IACX,aAAa,eAAe,YAAY;IACxC;IACD;AAED;;EAKF,MAAM,WAAW,6CAFe,QAAW,cAEjB,CAAC,GAAG,YAAY;GACxC;GACA;GACD,CAAC;AAEF,MAAI,CAAC,SAAS,KACZ,OAAM,IAAI,MAAM,0BAA0B;EAG5C,MAAM,EAAE,aAAa,cAAc,SAAS;AAE5C,eAAa;GACX,aAAa,eAAe,YAAY;GACxC;GACD;GACD,EAAE;AAEJ,QAAO;;AAGT,MAAM,kBAAkB,YAAoB;AAC1C,QAAO,QACJ,WAAW,qBAAqB,GAAG,CACnC,WAAW,oBAAoB,GAAG,CAClC,WAAW,mBAAmB,GAAG,CACjC,WAAW,kBAAkB,GAAG,CAChC,WAAW,qBAAqB,GAAG,CACnC,WAAW,iBAAiB,GAAG,CAC/B,WAAW,gBAAgB,GAAG,CAC9B,WAAW,eAAe,GAAG,CAC7B,WAAW,kBAAkB,GAAG,CAChC,WAAW,iBAAiB,GAAG,CAC/B,WAAW,gBAAgB,GAAG,CAC9B,WAAW,eAAe,GAAG,CAC7B,WAAW,eAAe,GAAG,CAC7B,WAAW,cAAc,GAAG,CAC5B,WAAW,aAAa,GAAG,CAC3B,WAAW,YAAY,GAAG"}
+{"version":3,"file":"chunkInference.cjs","names":[],"sources":["../../../src/utils/chunkInference.ts"],"sourcesContent":["import type {\n  AIConfig,\n  AIOptions,\n  Messages,\n  SystemMessage,\n} from '@intlayer/ai';\nimport { getIntlayerAPIProxy } from '@intlayer/api';\nimport { retryManager } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { AIClient } from './setupAI';\n\ntype ChunkInferenceResult = {\n  fileContent: string;\n  tokenUsed: number;\n};\n\n/**\n * Translates a single chunk via the OpenAI API.\n * Includes retry logic if the call fails.\n */\nexport const chunkInference = async (\n  system: SystemMessage,\n  messages: Messages,\n  aiOptions?: AIOptions,\n  configuration?: IntlayerConfig,\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n): Promise<ChunkInferenceResult> => {\n  let lastResult: ChunkInferenceResult;\n\n  await retryManager(async () => {\n    if (aiClient && aiConfig) {\n      const response = await aiClient.customQuery({\n        aiConfig,\n        system,\n        messages,\n      });\n\n      if (!response) {\n        throw new Error('No response from AI API');\n      }\n\n      const { fileContent, tokenUsed } = response;\n\n      lastResult = {\n        fileContent: processContent(fileContent),\n        tokenUsed,\n      };\n\n      return;\n    }\n\n    const api = getIntlayerAPIProxy(undefined, configuration);\n\n    const response = await api.ai.customQuery({\n      aiOptions,\n      messages,\n    });\n\n    if (!response.data) {\n      throw new Error('No response from AI API');\n    }\n\n    const { fileContent, tokenUsed } = response.data;\n\n    lastResult = {\n      fileContent: processContent(fileContent),\n      tokenUsed,\n    };\n  })();\n\n  return lastResult!;\n};\n\nconst processContent = (content: string) => {\n  return content\n    .replaceAll('///chunksStart///', '')\n    .replaceAll('///chunkStart///', '')\n    .replaceAll('///chunksEnd///', '')\n    .replaceAll('///chunkEnd///', '')\n    .replaceAll('///chunksStart///', '')\n    .replaceAll('chunkStart///', '')\n    .replaceAll('chunksEnd///', '')\n    .replaceAll('chunkEnd///', '')\n    .replaceAll('///chunksStart', '')\n    .replaceAll('///chunkStart', '')\n    .replaceAll('///chunksEnd', '')\n    .replaceAll('///chunkEnd', '')\n    .replaceAll('chunksStart', '')\n    .replaceAll('chunkStart', '')\n    .replaceAll('chunksEnd', '')\n    .replaceAll('chunkEnd', '');\n};\n"],"mappings":";;;;;;;;;;AAoBA,MAAa,iBAAiB,OAC5B,QACA,UACA,WACA,eACA,UACA,aACkC;CAClC,IAAI;AAEJ,gDAAmB,YAAY;AAC7B,MAAI,YAAY,UAAU;GACxB,MAAM,WAAW,MAAM,SAAS,YAAY;IAC1C;IACA;IACA;IACD,CAAC;AAEF,OAAI,CAAC,SACH,OAAM,IAAI,MAAM,0BAA0B;GAG5C,MAAM,EAAE,aAAa,cAAc;AAEnC,gBAAa;IACX,aAAa,eAAe,YAAY;IACxC;IACD;AAED;;EAKF,MAAM,WAAW,6CAFe,QAAW,cAEjB,CAAC,GAAG,YAAY;GACxC;GACA;GACD,CAAC;AAEF,MAAI,CAAC,SAAS,KACZ,OAAM,IAAI,MAAM,0BAA0B;EAG5C,MAAM,EAAE,aAAa,cAAc,SAAS;AAE5C,eAAa;GACX,aAAa,eAAe,YAAY;GACxC;GACD;GACD,EAAE;AAEJ,QAAO;;AAGT,MAAM,kBAAkB,YAAoB;AAC1C,QAAO,QACJ,WAAW,qBAAqB,GAAG,CACnC,WAAW,oBAAoB,GAAG,CAClC,WAAW,mBAAmB,GAAG,CACjC,WAAW,kBAAkB,GAAG,CAChC,WAAW,qBAAqB,GAAG,CACnC,WAAW,iBAAiB,GAAG,CAC/B,WAAW,gBAAgB,GAAG,CAC9B,WAAW,eAAe,GAAG,CAC7B,WAAW,kBAAkB,GAAG,CAChC,WAAW,iBAAiB,GAAG,CAC/B,WAAW,gBAAgB,GAAG,CAC9B,WAAW,eAAe,GAAG,CAC7B,WAAW,eAAe,GAAG,CAC7B,WAAW,cAAc,GAAG,CAC5B,WAAW,aAAa,GAAG,CAC3B,WAAW,YAAY,GAAG"}

package/dist/cjs/utils/setupAI.cjs

@@ -44,6 +44,7 @@ const setupAI = async (configuration, aiOptions) => {
 		appLogger([(0, _intlayer_config_logger.colorize)("@intlayer/ai", _intlayer_config_colors.GREY_LIGHT), (0, _intlayer_config_logger.colorize)("found - Run process locally", _intlayer_config_colors.GREY_DARK)]);
 		const aiConfig = await aiClient.getAIConfig({
 			userOptions: aiOptions,
+			projectOptions: configuration.ai,
 			accessType: ["public"]
 		});
 		logAIConfig(aiOptions ?? {}, appLogger);

package/dist/cjs/utils/setupAI.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"setupAI.cjs","names":["ANSIColors","checkAIAccess"],"sources":["../../../src/utils/setupAI.ts"],"sourcesContent":["import type { AIConfig, AIOptions } from '@intlayer/ai';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger, type logger } from '@intlayer/config/logger';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { checkAIAccess } from './checkAccess';\n\nexport type AIClient = typeof import('@intlayer/ai');\n\ntype SetupAIResult = {\n  aiClient?: AIClient;\n  aiConfig?: AIConfig;\n  isCustomAI: boolean;\n  hasAIAccess: boolean;\n};\n\n// Disable warnings from the AI SDK\nglobalThis.AI_SDK_LOG_WARNINGS = false;\n\nconst logAIConfig = (aiOptions: AIOptions, appLogger: typeof logger) => {\n  appLogger([\n    colorize('Provider:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.provider ?? '(default)', ANSIColors.BLUE),\n    colorize('- Model:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.model ?? '(default)', ANSIColors.BLUE),\n    colorize('- API Key:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.apiKey ? '✓' : '(not set)', ANSIColors.BLUE),\n  ]);\n};\n\n/**\n * Checks if the @intlayer/ai package is available and configured when an API key is provided.\n * If API key is present but package is missing, logs a warning.\n * Also checks if the user has access to AI (either via local key or CMS auth).\n */\nexport const setupAI = async (\n  configuration: IntlayerConfig,\n  aiOptions?: AIOptions\n): Promise<SetupAIResult | undefined> => {\n  const appLogger = getAppLogger(configuration);\n\n  const isLocalAI =\n    aiOptions?.apiKey ||\n    aiOptions?.provider === 'ollama' ||\n    configuration.ai?.apiKey ||\n    configuration.ai?.provider === 'ollama';\n\n  if (isLocalAI) {\n    // Try to import the AI package for local AI usage\n    let aiClient: AIClient | undefined;\n\n    try {\n      aiClient = await import('@intlayer/ai');\n    } catch {\n      // Package not installed - log warning and fall back to backend\n      appLogger(\n        [\n          colorize('Using your API key, you can install the', ANSIColors.GREY),\n          colorize('@intlayer/ai', ANSIColors.GREY_LIGHT),\n          colorize(\n            'package to run the process locally, with no dependency on the Intlayer server',\n            ANSIColors.GREY\n          ),\n        ],\n        {\n          level: 'warn',\n        }\n      );\n\n      // Fall back to backend API check\n      const hasAIAccess = await checkAIAccess(configuration, aiOptions);\n      logAIConfig(aiOptions ?? {}, appLogger);\n      return {\n        isCustomAI: false,\n        hasAIAccess,\n      };\n    }\n\n    // Package found - now configure it (errors here should propagate, not fall back)\n    appLogger([\n      colorize('@intlayer/ai', ANSIColors.GREY_LIGHT),\n      colorize('found - Run process locally', ANSIColors.GREY_DARK),\n    ]);\n\n    const aiConfig = await aiClient.getAIConfig({\n      userOptions: aiOptions,\n      accessType: ['public'],\n    });\n\n    logAIConfig(aiOptions ?? {}, appLogger);\n\n    return {\n      aiClient,\n      aiConfig,\n      isCustomAI: true,\n      hasAIAccess: true, // Local AI always has access\n    };\n  }\n\n  // No local AI configured - use backend API\n  const hasAIAccess = await checkAIAccess(configuration, aiOptions);\n  logAIConfig(aiOptions ?? {}, appLogger);\n\n  return {\n    isCustomAI: false,\n    hasAIAccess,\n  };\n};\n"],"mappings":";;;;;;;;AAgBA,WAAW,sBAAsB;AAEjC,MAAM,eAAe,WAAsB,cAA6B;AACtE,WAAU;wCACC,aAAaA,wBAAW,UAAU;wCAClC,WAAW,YAAY,aAAaA,wBAAW,KAAK;wCACpD,YAAYA,wBAAW,UAAU;wCACjC,WAAW,SAAS,aAAaA,wBAAW,KAAK;wCACjD,cAAcA,wBAAW,UAAU;wCACnC,WAAW,SAAS,MAAM,aAAaA,wBAAW,KAAK;EACjE,CAAC;;;;;;;AAQJ,MAAa,UAAU,OACrB,eACA,cACuC;CACvC,MAAM,sDAAyB,cAAc;AAQ7C,KALE,WAAW,UACX,WAAW,aAAa,YACxB,cAAc,IAAI,UAClB,cAAc,IAAI,aAAa,UAElB;EAEb,IAAI;AAEJ,MAAI;AACF,cAAW,MAAM,OAAO;UAClB;AAEN,aACE;0CACW,2CAA2CA,wBAAW,KAAK;0CAC3D,gBAAgBA,wBAAW,WAAW;0CAE7C,iFACAA,wBAAW,KACZ;IACF,EACD,EACE,OAAO,QACR,CACF;GAGD,MAAM,cAAc,MAAMC,wCAAc,eAAe,UAAU;AACjE,eAAY,aAAa,EAAE,EAAE,UAAU;AACvC,UAAO;IACL,YAAY;IACZ;IACD;;AAIH,YAAU,uCACC,gBAAgBD,wBAAW,WAAW,wCACtC,+BAA+BA,wBAAW,UAAU,CAC9D,CAAC;EAEF,MAAM,WAAW,MAAM,SAAS,YAAY;GAC1C,aAAa;GACb,YAAY,CAAC,SAAS;GACvB,CAAC;AAEF,cAAY,aAAa,EAAE,EAAE,UAAU;AAEvC,SAAO;GACL;GACA;GACA,YAAY;GACZ,aAAa;GACd;;CAIH,MAAM,cAAc,MAAMC,wCAAc,eAAe,UAAU;AACjE,aAAY,aAAa,EAAE,EAAE,UAAU;AAEvC,QAAO;EACL,YAAY;EACZ;EACD"}
+{"version":3,"file":"setupAI.cjs","names":["ANSIColors","checkAIAccess"],"sources":["../../../src/utils/setupAI.ts"],"sourcesContent":["import type { AIConfig, AIOptions } from '@intlayer/ai';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger, type logger } from '@intlayer/config/logger';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { checkAIAccess } from './checkAccess';\n\nexport type AIClient = typeof import('@intlayer/ai');\n\ntype SetupAIResult = {\n  aiClient?: AIClient;\n  aiConfig?: AIConfig;\n  isCustomAI: boolean;\n  hasAIAccess: boolean;\n};\n\n// Disable warnings from the AI SDK\nglobalThis.AI_SDK_LOG_WARNINGS = false;\n\nconst logAIConfig = (aiOptions: AIOptions, appLogger: typeof logger) => {\n  appLogger([\n    colorize('Provider:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.provider ?? '(default)', ANSIColors.BLUE),\n    colorize('- Model:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.model ?? '(default)', ANSIColors.BLUE),\n    colorize('- API Key:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.apiKey ? '✓' : '(not set)', ANSIColors.BLUE),\n  ]);\n};\n\n/**\n * Checks if the @intlayer/ai package is available and configured when an API key is provided.\n * If API key is present but package is missing, logs a warning.\n * Also checks if the user has access to AI (either via local key or CMS auth).\n */\nexport const setupAI = async (\n  configuration: IntlayerConfig,\n  aiOptions?: AIOptions\n): Promise<SetupAIResult | undefined> => {\n  const appLogger = getAppLogger(configuration);\n\n  const isLocalAI =\n    aiOptions?.apiKey ||\n    aiOptions?.provider === 'ollama' ||\n    configuration.ai?.apiKey ||\n    configuration.ai?.provider === 'ollama';\n\n  if (isLocalAI) {\n    // Try to import the AI package for local AI usage\n    let aiClient: AIClient | undefined;\n\n    try {\n      aiClient = await import('@intlayer/ai');\n    } catch {\n      // Package not installed - log warning and fall back to backend\n      appLogger(\n        [\n          colorize('Using your API key, you can install the', ANSIColors.GREY),\n          colorize('@intlayer/ai', ANSIColors.GREY_LIGHT),\n          colorize(\n            'package to run the process locally, with no dependency on the Intlayer server',\n            ANSIColors.GREY\n          ),\n        ],\n        {\n          level: 'warn',\n        }\n      );\n\n      // Fall back to backend API check\n      const hasAIAccess = await checkAIAccess(configuration, aiOptions);\n      logAIConfig(aiOptions ?? {}, appLogger);\n      return {\n        isCustomAI: false,\n        hasAIAccess,\n      };\n    }\n\n    // Package found - now configure it (errors here should propagate, not fall back)\n    appLogger([\n      colorize('@intlayer/ai', ANSIColors.GREY_LIGHT),\n      colorize('found - Run process locally', ANSIColors.GREY_DARK),\n    ]);\n\n    const aiConfig = await aiClient.getAIConfig({\n      userOptions: aiOptions,\n      projectOptions: configuration.ai as AIOptions,\n      accessType: ['public'],\n    });\n\n    logAIConfig(aiOptions ?? {}, appLogger);\n\n    return {\n      aiClient,\n      aiConfig,\n      isCustomAI: true,\n      hasAIAccess: true, // Local AI always has access\n    };\n  }\n\n  // No local AI configured - use backend API\n  const hasAIAccess = await checkAIAccess(configuration, aiOptions);\n  logAIConfig(aiOptions ?? {}, appLogger);\n\n  return {\n    isCustomAI: false,\n    hasAIAccess,\n  };\n};\n"],"mappings":";;;;;;;;AAgBA,WAAW,sBAAsB;AAEjC,MAAM,eAAe,WAAsB,cAA6B;AACtE,WAAU;wCACC,aAAaA,wBAAW,UAAU;wCAClC,WAAW,YAAY,aAAaA,wBAAW,KAAK;wCACpD,YAAYA,wBAAW,UAAU;wCACjC,WAAW,SAAS,aAAaA,wBAAW,KAAK;wCACjD,cAAcA,wBAAW,UAAU;wCACnC,WAAW,SAAS,MAAM,aAAaA,wBAAW,KAAK;EACjE,CAAC;;;;;;;AAQJ,MAAa,UAAU,OACrB,eACA,cACuC;CACvC,MAAM,sDAAyB,cAAc;AAQ7C,KALE,WAAW,UACX,WAAW,aAAa,YACxB,cAAc,IAAI,UAClB,cAAc,IAAI,aAAa,UAElB;EAEb,IAAI;AAEJ,MAAI;AACF,cAAW,MAAM,OAAO;UAClB;AAEN,aACE;0CACW,2CAA2CA,wBAAW,KAAK;0CAC3D,gBAAgBA,wBAAW,WAAW;0CAE7C,iFACAA,wBAAW,KACZ;IACF,EACD,EACE,OAAO,QACR,CACF;GAGD,MAAM,cAAc,MAAMC,wCAAc,eAAe,UAAU;AACjE,eAAY,aAAa,EAAE,EAAE,UAAU;AACvC,UAAO;IACL,YAAY;IACZ;IACD;;AAIH,YAAU,uCACC,gBAAgBD,wBAAW,WAAW,wCACtC,+BAA+BA,wBAAW,UAAU,CAC9D,CAAC;EAEF,MAAM,WAAW,MAAM,SAAS,YAAY;GAC1C,aAAa;GACb,gBAAgB,cAAc;GAC9B,YAAY,CAAC,SAAS;GACvB,CAAC;AAEF,cAAY,aAAa,EAAE,EAAE,UAAU;AAEvC,SAAO;GACL;GACA;GACA,YAAY;GACZ,aAAa;GACd;;CAIH,MAAM,cAAc,MAAMC,wCAAc,eAAe,UAAU;AACjE,aAAY,aAAa,EAAE,EAAE,UAAU;AAEvC,QAAO;EACL,YAAY;EACZ;EACD"}

package/dist/esm/fill/writeFill.mjs

@@ -1,6 +1,6 @@
 import { formatFillData } from "./formatFillData.mjs";
 import { getAvailableLocalesInDictionary } from "./getAvailableLocalesInDictionary.mjs";
-import { relative } from "node:path";
+import { join } from "node:path";
 import { writeContentDeclaration } from "@intlayer/chokidar/build";
 import { formatLocale, formatPath } from "@intlayer/chokidar/utils";
 import { colorizeKey, getAppLogger } from "@intlayer/config/logger";
@@ -34,13 +34,12 @@ const writeFill = async (contentDeclarationFile, outputLocales, parentLocales, c
 			continue;
 		}
 		const { fill, ...rest } = contentDeclarationFile;
-		const relativeFilePath = relative(configuration.system.baseDir, output.filePath);
 		await writeContentDeclaration({
 			...rest,
 			filled: true,
 			locale: output.isPerLocale ? output.localeList[0] : void 0,
-			localId: `${contentDeclarationFile.key}::local::${relativeFilePath}`,
-			filePath: relativeFilePath
+			localId: `${contentDeclarationFile.key}::local::${output.filePath}`,
+			filePath: join(configuration.system.baseDir, output.filePath)
 		}, configuration, { localeList: output.isPerLocale ? output.localeList : outputLocales ?? configuration.internationalization.locales });
 		if (output.isPerLocale) appLogger(`Auto filled per-locale content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)} for locale ${formatLocale(output.localeList[0])}`, { level: "info" });
 		else appLogger(`Auto filled content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)}`, { level: "info" });

package/dist/esm/fill/writeFill.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeFill.mjs","names":[],"sources":["../../../src/fill/writeFill.ts"],"sourcesContent":["import { relative } from 'node:path';\nimport { writeContentDeclaration } from '@intlayer/chokidar/build';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary, Fill } from '@intlayer/types/dictionary';\nimport { type FillData, formatFillData } from './formatFillData';\nimport { getAvailableLocalesInDictionary } from './getAvailableLocalesInDictionary';\n\nexport const writeFill = async (\n  contentDeclarationFile: Dictionary,\n  outputLocales: Locale[],\n  parentLocales: Locale[],\n  configuration: IntlayerConfig\n) => {\n  const appLogger = getAppLogger(configuration);\n  const dictionaries = getDictionaries(configuration);\n\n  const fullDictionary = dictionaries[contentDeclarationFile.key];\n\n  const { filePath } = contentDeclarationFile;\n\n  if (!filePath) {\n    appLogger('No file path found for dictionary', {\n      level: 'error',\n    });\n    return;\n  }\n\n  const fillOptions: Fill | undefined =\n    contentDeclarationFile.fill ?? configuration.dictionary?.fill ?? true;\n\n  if ((fillOptions as boolean) === false) {\n    appLogger(\n      `Auto fill is disabled for '${colorizeKey(fullDictionary.key)}'`,\n      {\n        level: 'info',\n      }\n    );\n    return;\n  }\n\n  const requestedLocales: Locale[] = (\n    outputLocales ?? configuration.internationalization.locales\n  ).filter((locale) => !parentLocales?.includes(locale));\n\n  // Get locales that actually have translations in the content\n  const availableLocales = getAvailableLocalesInDictionary(\n    contentDeclarationFile\n  );\n\n  // Only write files for locales that have actual translations\n  const localeList = requestedLocales.filter((locale) =>\n    availableLocales.includes(locale)\n  );\n\n  if (localeList.length === 0) {\n    appLogger(\n      `No translations available for dictionary '${colorizeKey(fullDictionary.key)}'`,\n      {\n        level: 'info',\n      }\n    );\n    return;\n  }\n\n  const fillData: FillData[] = await formatFillData(\n    fillOptions as Fill,\n    localeList,\n    filePath,\n    fullDictionary.key,\n    configuration\n  );\n\n  for await (const output of fillData) {\n    if (!output.filePath) {\n      appLogger(\n        `No file path found for auto filled content declaration for '${colorizeKey(fullDictionary.key)}'`,\n        {\n          level: 'error',\n        }\n      );\n      continue;\n    }\n\n    const { fill, ...rest } = contentDeclarationFile;\n\n    const relativeFilePath = relative(\n      configuration.system.baseDir,\n      output.filePath\n    );\n\n    await writeContentDeclaration(\n      {\n        ...rest,\n        filled: true,\n        locale: output.isPerLocale ? output.localeList[0] : undefined,\n        localId: `${contentDeclarationFile.key}::local::${relativeFilePath}`,\n        filePath: relativeFilePath,\n      },\n      configuration,\n      {\n        // Per-locale files: write only the specific locale.\n        // Multilingual files (string/function fill, single output): include all\n        // output locales (including source) so the file is complete.\n        localeList: output.isPerLocale\n          ? output.localeList\n          : (outputLocales ?? configuration.internationalization.locales),\n      }\n    );\n\n    if (output.isPerLocale) {\n      appLogger(\n        `Auto filled per-locale content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)} for locale ${formatLocale(output.localeList[0])}`,\n        { level: 'info' }\n      );\n    } else {\n      appLogger(\n        `Auto filled content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)}`,\n        { level: 'info' }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;AAWA,MAAa,YAAY,OACvB,wBACA,eACA,eACA,kBACG;CACH,MAAM,YAAY,aAAa,cAAc;CAG7C,MAAM,iBAFe,gBAAgB,cAEF,CAAC,uBAAuB;CAE3D,MAAM,EAAE,aAAa;AAErB,KAAI,CAAC,UAAU;AACb,YAAU,qCAAqC,EAC7C,OAAO,SACR,CAAC;AACF;;CAGF,MAAM,cACJ,uBAAuB,QAAQ,cAAc,YAAY,QAAQ;AAEnE,KAAK,gBAA4B,OAAO;AACtC,YACE,8BAA8B,YAAY,eAAe,IAAI,CAAC,IAC9D,EACE,OAAO,QACR,CACF;AACD;;CAGF,MAAM,oBACJ,iBAAiB,cAAc,qBAAqB,SACpD,QAAQ,WAAW,CAAC,eAAe,SAAS,OAAO,CAAC;CAGtD,MAAM,mBAAmB,gCACvB,uBACD;CAGD,MAAM,aAAa,iBAAiB,QAAQ,WAC1C,iBAAiB,SAAS,OAAO,CAClC;AAED,KAAI,WAAW,WAAW,GAAG;AAC3B,YACE,6CAA6C,YAAY,eAAe,IAAI,CAAC,IAC7E,EACE,OAAO,QACR,CACF;AACD;;CAGF,MAAM,WAAuB,MAAM,eACjC,aACA,YACA,UACA,eAAe,KACf,cACD;AAED,YAAW,MAAM,UAAU,UAAU;AACnC,MAAI,CAAC,OAAO,UAAU;AACpB,aACE,+DAA+D,YAAY,eAAe,IAAI,CAAC,IAC/F,EACE,OAAO,SACR,CACF;AACD;;EAGF,MAAM,EAAE,MAAM,GAAG,SAAS;EAE1B,MAAM,mBAAmB,SACvB,cAAc,OAAO,SACrB,OAAO,SACR;AAED,QAAM,wBACJ;GACE,GAAG;GACH,QAAQ;GACR,QAAQ,OAAO,cAAc,OAAO,WAAW,KAAK;GACpD,SAAS,GAAG,uBAAuB,IAAI,WAAW;GAClD,UAAU;GACX,EACD,eACA,EAIE,YAAY,OAAO,cACf,OAAO,aACN,iBAAiB,cAAc,qBAAqB,SAC1D,CACF;AAED,MAAI,OAAO,YACT,WACE,mDAAmD,YAAY,eAAe,IAAI,CAAC,eAAe,WAAW,OAAO,SAAS,CAAC,cAAc,aAAa,OAAO,WAAW,GAAG,IAC9K,EAAE,OAAO,QAAQ,CAClB;MAED,WACE,wCAAwC,YAAY,eAAe,IAAI,CAAC,eAAe,WAAW,OAAO,SAAS,IAClH,EAAE,OAAO,QAAQ,CAClB"}
+{"version":3,"file":"writeFill.mjs","names":[],"sources":["../../../src/fill/writeFill.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { writeContentDeclaration } from '@intlayer/chokidar/build';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary, Fill } from '@intlayer/types/dictionary';\nimport { type FillData, formatFillData } from './formatFillData';\nimport { getAvailableLocalesInDictionary } from './getAvailableLocalesInDictionary';\n\nexport const writeFill = async (\n  contentDeclarationFile: Dictionary,\n  outputLocales: Locale[],\n  parentLocales: Locale[],\n  configuration: IntlayerConfig\n) => {\n  const appLogger = getAppLogger(configuration);\n  const dictionaries = getDictionaries(configuration);\n\n  const fullDictionary = dictionaries[contentDeclarationFile.key];\n\n  const { filePath } = contentDeclarationFile;\n\n  if (!filePath) {\n    appLogger('No file path found for dictionary', {\n      level: 'error',\n    });\n    return;\n  }\n\n  const fillOptions: Fill | undefined =\n    contentDeclarationFile.fill ?? configuration.dictionary?.fill ?? true;\n\n  if ((fillOptions as boolean) === false) {\n    appLogger(\n      `Auto fill is disabled for '${colorizeKey(fullDictionary.key)}'`,\n      {\n        level: 'info',\n      }\n    );\n    return;\n  }\n\n  const requestedLocales: Locale[] = (\n    outputLocales ?? configuration.internationalization.locales\n  ).filter((locale) => !parentLocales?.includes(locale));\n\n  // Get locales that actually have translations in the content\n  const availableLocales = getAvailableLocalesInDictionary(\n    contentDeclarationFile\n  );\n\n  // Only write files for locales that have actual translations\n  const localeList = requestedLocales.filter((locale) =>\n    availableLocales.includes(locale)\n  );\n\n  if (localeList.length === 0) {\n    appLogger(\n      `No translations available for dictionary '${colorizeKey(fullDictionary.key)}'`,\n      {\n        level: 'info',\n      }\n    );\n    return;\n  }\n\n  const fillData: FillData[] = await formatFillData(\n    fillOptions as Fill,\n    localeList,\n    filePath,\n    fullDictionary.key,\n    configuration\n  );\n\n  for await (const output of fillData) {\n    if (!output.filePath) {\n      appLogger(\n        `No file path found for auto filled content declaration for '${colorizeKey(fullDictionary.key)}'`,\n        {\n          level: 'error',\n        }\n      );\n      continue;\n    }\n\n    const { fill, ...rest } = contentDeclarationFile;\n\n    await writeContentDeclaration(\n      {\n        ...rest,\n        filled: true,\n        locale: output.isPerLocale ? output.localeList[0] : undefined,\n        localId: `${contentDeclarationFile.key}::local::${output.filePath}`,\n        filePath: join(configuration.system.baseDir, output.filePath), // Use absolute path for vscode extension\n      },\n      configuration,\n      {\n        // Per-locale files: write only the specific locale.\n        // Multilingual files (string/function fill, single output): include all\n        // output locales (including source) so the file is complete.\n        localeList: output.isPerLocale\n          ? output.localeList\n          : (outputLocales ?? configuration.internationalization.locales),\n      }\n    );\n\n    if (output.isPerLocale) {\n      appLogger(\n        `Auto filled per-locale content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)} for locale ${formatLocale(output.localeList[0])}`,\n        { level: 'info' }\n      );\n    } else {\n      appLogger(\n        `Auto filled content declaration for '${colorizeKey(fullDictionary.key)}' written to ${formatPath(output.filePath)}`,\n        { level: 'info' }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;AAWA,MAAa,YAAY,OACvB,wBACA,eACA,eACA,kBACG;CACH,MAAM,YAAY,aAAa,cAAc;CAG7C,MAAM,iBAFe,gBAAgB,cAEF,CAAC,uBAAuB;CAE3D,MAAM,EAAE,aAAa;AAErB,KAAI,CAAC,UAAU;AACb,YAAU,qCAAqC,EAC7C,OAAO,SACR,CAAC;AACF;;CAGF,MAAM,cACJ,uBAAuB,QAAQ,cAAc,YAAY,QAAQ;AAEnE,KAAK,gBAA4B,OAAO;AACtC,YACE,8BAA8B,YAAY,eAAe,IAAI,CAAC,IAC9D,EACE,OAAO,QACR,CACF;AACD;;CAGF,MAAM,oBACJ,iBAAiB,cAAc,qBAAqB,SACpD,QAAQ,WAAW,CAAC,eAAe,SAAS,OAAO,CAAC;CAGtD,MAAM,mBAAmB,gCACvB,uBACD;CAGD,MAAM,aAAa,iBAAiB,QAAQ,WAC1C,iBAAiB,SAAS,OAAO,CAClC;AAED,KAAI,WAAW,WAAW,GAAG;AAC3B,YACE,6CAA6C,YAAY,eAAe,IAAI,CAAC,IAC7E,EACE,OAAO,QACR,CACF;AACD;;CAGF,MAAM,WAAuB,MAAM,eACjC,aACA,YACA,UACA,eAAe,KACf,cACD;AAED,YAAW,MAAM,UAAU,UAAU;AACnC,MAAI,CAAC,OAAO,UAAU;AACpB,aACE,+DAA+D,YAAY,eAAe,IAAI,CAAC,IAC/F,EACE,OAAO,SACR,CACF;AACD;;EAGF,MAAM,EAAE,MAAM,GAAG,SAAS;AAE1B,QAAM,wBACJ;GACE,GAAG;GACH,QAAQ;GACR,QAAQ,OAAO,cAAc,OAAO,WAAW,KAAK;GACpD,SAAS,GAAG,uBAAuB,IAAI,WAAW,OAAO;GACzD,UAAU,KAAK,cAAc,OAAO,SAAS,OAAO,SAAS;GAC9D,EACD,eACA,EAIE,YAAY,OAAO,cACf,OAAO,aACN,iBAAiB,cAAc,qBAAqB,SAC1D,CACF;AAED,MAAI,OAAO,YACT,WACE,mDAAmD,YAAY,eAAe,IAAI,CAAC,eAAe,WAAW,OAAO,SAAS,CAAC,cAAc,aAAa,OAAO,WAAW,GAAG,IAC9K,EAAE,OAAO,QAAQ,CAClB;MAED,WACE,wCAAwC,YAAY,eAAe,IAAI,CAAC,eAAe,WAAW,OAAO,SAAS,IAClH,EAAE,OAAO,QAAQ,CAClB"}

package/dist/esm/reviewDoc/reviewDocBlockAware.mjs

@@ -71,12 +71,11 @@ const reviewFileBlockAware = async (baseFilePath, outputFilePath, locale, baseLo
 				{
 					role: "system",
 					content: `The next user message will be the **BLOCK ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`
-				},
-				{
-					role: "user",
-					content: englishBlock.content
 				}
-			], aiOptions, configuration, aiClient, aiConfig);
+			], [{
+				role: "user",
+				content: englishBlock.content
+			}], aiOptions, configuration, aiClient, aiConfig);
 			applicationLogger(`${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}`);
 			let processedChunk = sanitizeChunk(result?.fileContent, englishBlock.content);
 			processedChunk = fixChunkStartEndChars(processedChunk, englishBlock.content);

package/dist/esm/reviewDoc/reviewDocBlockAware.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reviewDocBlockAware.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport type { AIConfig } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { retryManager } from '@intlayer/config/utils';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { sanitizeChunk, validateTranslation } from '../translateDoc/validation';\nimport {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n} from '../translation-alignment/pipeline';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { AIClient } from '../utils/setupAI';\n\n/**\n * Review a file using block-aware alignment.\n * This approach:\n * 1. Segments both English and French documents into semantic blocks\n * 2. Aligns blocks using structure (special chars, numbers) and context\n * 3. Detects which blocks changed, were added, or deleted\n * 4. Only sends changed/new blocks to AI for translation\n * 5. Handles reordering automatically\n */\nexport const reviewFileBlockAware = async (\n  baseFilePath: string,\n  outputFilePath: string,\n  locale: Locale,\n  baseLocale: Locale,\n  aiOptions?: AIOptions,\n  configOptions?: GetConfigurationOptions,\n  customInstructions?: string,\n  changedLines?: number[],\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n) => {\n  const configuration = getConfiguration(configOptions);\n  const applicationLogger = getAppLogger(configuration);\n\n  const englishText = await readFile(baseFilePath, 'utf-8');\n  const frenchText = await readFile(outputFilePath, 'utf-8').catch(() => '');\n\n  const basePrompt = readAsset('./prompts/REVIEW_PROMPT.md', 'utf-8')\n    .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n    .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n    .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n    .replace('{{customInstructions}}', customInstructions ?? '-');\n\n  const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n  const filePrefix = [\n    colon(filePrefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n  const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n  const prefix = [\n    colon(prefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n\n  // Build block-aware alignment and plan\n  const { englishBlocks, frenchBlocks, plan, segmentsToReview } =\n    buildAlignmentPlan({\n      englishText,\n      frenchText,\n      changedLines,\n    });\n\n  applicationLogger(\n    `${filePrefix}Block-aware alignment complete. Total blocks: EN=${colorizeNumber(englishBlocks.length)}, FR=${colorizeNumber(frenchBlocks.length)}`\n  );\n  applicationLogger(\n    `${filePrefix}Actions: reuse=${colorizeNumber(plan.actions.filter((a) => a.kind === 'reuse').length)}, review=${colorizeNumber(plan.actions.filter((a) => a.kind === 'review').length)}, new=${colorizeNumber(plan.actions.filter((a) => a.kind === 'insert_new').length)}, delete=${colorizeNumber(plan.actions.filter((a) => a.kind === 'delete').length)}`\n  );\n\n  if (segmentsToReview.length === 0) {\n    applicationLogger(\n      `${filePrefix}No segments need review, reusing existing translation`\n    );\n    mkdirSync(dirname(outputFilePath), { recursive: true });\n    writeFileSync(\n      outputFilePath,\n      mergeReviewedSegments(plan, frenchBlocks, new Map())\n    );\n    applicationLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no changes needed).`\n    );\n    return;\n  }\n\n  applicationLogger(\n    `${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)}`\n  );\n\n  // Review segments that need AI translation\n  const reviewedSegmentsMap = new Map<number, string>();\n\n  for (const segment of segmentsToReview) {\n    const segmentNumber = segmentsToReview.indexOf(segment) + 1;\n    const englishBlock = segment.englishBlock;\n\n    const getBaseChunkContextPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\\n` +\n      `///chunksStart///\\n` +\n      englishBlock.content +\n      `///chunksEnd///`;\n\n    const getFrenchChunkPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\\n` +\n      `///chunksStart///\\n` +\n      (segment.frenchBlockText ?? '') +\n      `///chunksEnd///`;\n\n    const reviewedChunkResult = await retryManager(async () => {\n      const result = await chunkInference(\n        [\n          { role: 'system', content: basePrompt },\n          { role: 'system', content: getBaseChunkContextPrompt() },\n          { role: 'system', content: getFrenchChunkPrompt() },\n          {\n            role: 'system',\n            content: `The next user message will be the **BLOCK ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`,\n          },\n          { role: 'user', content: englishBlock.content },\n        ],\n        aiOptions,\n        configuration,\n        aiClient,\n        aiConfig\n      );\n\n      applicationLogger(\n        `${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}`\n      );\n\n      // Sanitize artifacts (e.g. Markdown code block wrappers)\n      let processedChunk = sanitizeChunk(\n        result?.fileContent,\n        englishBlock.content\n      );\n\n      // Fix start/end characters\n      processedChunk = fixChunkStartEndChars(\n        processedChunk,\n        englishBlock.content\n      );\n\n      // Validate Translation (YAML, Code fences, Length ratio)\n      const isValid = validateTranslation(\n        englishBlock.content,\n        processedChunk,\n        applicationLogger\n      );\n\n      if (!isValid) {\n        throw new Error(\n          'Validation failed for chunk (structure or length mismatch). Retrying...'\n        );\n      }\n\n      return processedChunk;\n    })();\n\n    reviewedSegmentsMap.set(segment.actionIndex, reviewedChunkResult);\n  }\n\n  // Merge reviewed segments back into final document\n  const finalFrenchOutput = mergeReviewedSegments(\n    plan,\n    frenchBlocks,\n    reviewedSegmentsMap\n  );\n\n  mkdirSync(dirname(outputFilePath), { recursive: true });\n  writeFileSync(outputFilePath, finalFrenchOutput);\n\n  applicationLogger(\n    `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`\n  );\n};\n"],"mappings":"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"}
+{"version":3,"file":"reviewDocBlockAware.mjs","names":[],"sources":["../../../src/reviewDoc/reviewDocBlockAware.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport type { AIConfig } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { retryManager } from '@intlayer/config/utils';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { sanitizeChunk, validateTranslation } from '../translateDoc/validation';\nimport {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n} from '../translation-alignment/pipeline';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { AIClient } from '../utils/setupAI';\n\n/**\n * Review a file using block-aware alignment.\n * This approach:\n * 1. Segments both English and French documents into semantic blocks\n * 2. Aligns blocks using structure (special chars, numbers) and context\n * 3. Detects which blocks changed, were added, or deleted\n * 4. Only sends changed/new blocks to AI for translation\n * 5. Handles reordering automatically\n */\nexport const reviewFileBlockAware = async (\n  baseFilePath: string,\n  outputFilePath: string,\n  locale: Locale,\n  baseLocale: Locale,\n  aiOptions?: AIOptions,\n  configOptions?: GetConfigurationOptions,\n  customInstructions?: string,\n  changedLines?: number[],\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n) => {\n  const configuration = getConfiguration(configOptions);\n  const applicationLogger = getAppLogger(configuration);\n\n  const englishText = await readFile(baseFilePath, 'utf-8');\n  const frenchText = await readFile(outputFilePath, 'utf-8').catch(() => '');\n\n  const basePrompt = readAsset('./prompts/REVIEW_PROMPT.md', 'utf-8')\n    .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n    .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n    .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n    .replace('{{customInstructions}}', customInstructions ?? '-');\n\n  const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n  const filePrefix = [\n    colon(filePrefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n  const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n  const prefix = [\n    colon(prefixText, { colSize: 40 }),\n    `→ ${ANSIColors.RESET}`,\n  ].join('');\n\n  // Build block-aware alignment and plan\n  const { englishBlocks, frenchBlocks, plan, segmentsToReview } =\n    buildAlignmentPlan({\n      englishText,\n      frenchText,\n      changedLines,\n    });\n\n  applicationLogger(\n    `${filePrefix}Block-aware alignment complete. Total blocks: EN=${colorizeNumber(englishBlocks.length)}, FR=${colorizeNumber(frenchBlocks.length)}`\n  );\n  applicationLogger(\n    `${filePrefix}Actions: reuse=${colorizeNumber(plan.actions.filter((a) => a.kind === 'reuse').length)}, review=${colorizeNumber(plan.actions.filter((a) => a.kind === 'review').length)}, new=${colorizeNumber(plan.actions.filter((a) => a.kind === 'insert_new').length)}, delete=${colorizeNumber(plan.actions.filter((a) => a.kind === 'delete').length)}`\n  );\n\n  if (segmentsToReview.length === 0) {\n    applicationLogger(\n      `${filePrefix}No segments need review, reusing existing translation`\n    );\n    mkdirSync(dirname(outputFilePath), { recursive: true });\n    writeFileSync(\n      outputFilePath,\n      mergeReviewedSegments(plan, frenchBlocks, new Map())\n    );\n    applicationLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no changes needed).`\n    );\n    return;\n  }\n\n  applicationLogger(\n    `${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)}`\n  );\n\n  // Review segments that need AI translation\n  const reviewedSegmentsMap = new Map<number, string>();\n\n  for (const segment of segmentsToReview) {\n    const segmentNumber = segmentsToReview.indexOf(segment) + 1;\n    const englishBlock = segment.englishBlock;\n\n    const getBaseChunkContextPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\\n` +\n      `///chunksStart///\\n` +\n      englishBlock.content +\n      `///chunksEnd///`;\n\n    const getFrenchChunkPrompt = () =>\n      `**BLOCK ${segmentNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\\n` +\n      `///chunksStart///\\n` +\n      (segment.frenchBlockText ?? '') +\n      `///chunksEnd///`;\n\n    const reviewedChunkResult = await retryManager(async () => {\n      const result = await chunkInference(\n        [\n          { role: 'system', content: basePrompt },\n          { role: 'system', content: getBaseChunkContextPrompt() },\n          { role: 'system', content: getFrenchChunkPrompt() },\n          {\n            role: 'system',\n            content: `The next user message will be the **BLOCK ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`,\n          },\n        ],\n        [{ role: 'user', content: englishBlock.content }],\n        aiOptions,\n        configuration,\n        aiClient,\n        aiConfig\n      );\n\n      applicationLogger(\n        `${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(segmentNumber)} of ${colorizeNumber(segmentsToReview.length)}`\n      );\n\n      // Sanitize artifacts (e.g. Markdown code block wrappers)\n      let processedChunk = sanitizeChunk(\n        result?.fileContent,\n        englishBlock.content\n      );\n\n      // Fix start/end characters\n      processedChunk = fixChunkStartEndChars(\n        processedChunk,\n        englishBlock.content\n      );\n\n      // Validate Translation (YAML, Code fences, Length ratio)\n      const isValid = validateTranslation(\n        englishBlock.content,\n        processedChunk,\n        applicationLogger\n      );\n\n      if (!isValid) {\n        throw new Error(\n          'Validation failed for chunk (structure or length mismatch). Retrying...'\n        );\n      }\n\n      return processedChunk;\n    })();\n\n    reviewedSegmentsMap.set(segment.actionIndex, reviewedChunkResult);\n  }\n\n  // Merge reviewed segments back into final document\n  const finalFrenchOutput = mergeReviewedSegments(\n    plan,\n    frenchBlocks,\n    reviewedSegmentsMap\n  );\n\n  mkdirSync(dirname(outputFilePath), { recursive: true });\n  writeFileSync(outputFilePath, finalFrenchOutput);\n\n  applicationLogger(\n    `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`\n  );\n};\n"],"mappings":"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"}

package/dist/esm/translateDoc/translateFile.mjs

@@ -3,13 +3,12 @@ import { sanitizeChunk, validateTranslation } from "./validation.mjs";
 import { chunkInference } from "../utils/chunkInference.mjs";
 import { fixChunkStartEndChars } from "../utils/fixChunkStartEndChars.mjs";
 import { chunkText } from "../utils/calculateChunks.mjs";
-import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, relative } from "node:path";
 import { formatLocale, formatPath } from "@intlayer/chokidar/utils";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colon, colorize, colorizeNumber, getAppLogger } from "@intlayer/config/logger";
 import { retryManager } from "@intlayer/config/utils";
-import { readFile } from "node:fs/promises";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { performance } from "node:perf_hooks";
 
 //#region src/translateDoc/translateFile.ts
@@ -52,12 +51,11 @@ const translateFile = async ({ baseFilePath, outputFilePath, locale, baseLocale,
 					{
 						role: "system",
 						content: [`You are translating TARGET CHUNK (${i + 1}/${totalChunks}).`, `Translate ONLY the target chunk. Preserve frontmatter/code exactly.`].join("\n")
-					},
-					{
-						role: "user",
-						content: `>>> TARGET CHUNK START <<<\n${fileToTranslateCurrentChunk}\n>>> TARGET CHUNK END <<<`
 					}
-				], aiOptions, configuration, aiClient, aiConfig);
+				], [{
+					role: "user",
+					content: `>>> TARGET CHUNK START <<<\n${fileToTranslateCurrentChunk}\n>>> TARGET CHUNK END <<<`
+				}], aiOptions, configuration, aiClient, aiConfig);
 				let processedChunk = sanitizeChunk(result?.fileContent, fileToTranslateCurrentChunk);
 				processedChunk = fixChunkStartEndChars(processedChunk, fileToTranslateCurrentChunk);
 				if (!validateTranslation(fileToTranslateCurrentChunk, processedChunk, chunkLogger)) throw new Error(`Validation failed for chunk ${i + 1}/${totalChunks}`);
@@ -74,8 +72,8 @@ const translateFile = async ({ baseFilePath, outputFilePath, locale, baseLocale,
 					let endIdx = 0;
 					while (endIdx < totalChunks && translatedParts[endIdx] && translatedParts[endIdx] !== "") endIdx++;
 					const currentContent = translatedParts.slice(0, endIdx).join("");
-					mkdirSync(dirname(outputFilePath), { recursive: true });
-					writeFileSync(outputFilePath, currentContent);
+					await mkdir(dirname(outputFilePath), { recursive: true });
+					await writeFile(outputFilePath, currentContent);
 				}
 			}
 			chunkLogger([`${colorizeNumber(tokens)} tokens used `, `${ANSIColors.GREY_DARK}in ${colorizeNumber(chunkDuration)}ms${ANSIColors.RESET}`].join(""));
@@ -83,8 +81,8 @@ const translateFile = async ({ baseFilePath, outputFilePath, locale, baseLocale,
 		await Promise.all(tasks);
 		const fullContent = translatedParts.join("");
 		if (flushStrategy === "end" || flushStrategy === "incremental") {
-			mkdirSync(dirname(outputFilePath), { recursive: true });
-			writeFileSync(outputFilePath, fullContent);
+			await mkdir(dirname(outputFilePath), { recursive: true });
+			await writeFile(outputFilePath, fullContent);
 		}
 		const totalDuration = ((performance.now() - fileStartTime) / 1e3).toFixed(2);
 		const relativePath = relative(configuration.system.baseDir, outputFilePath);

package/dist/esm/translateDoc/translateFile.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"translateFile.mjs","names":[],"sources":["../../../src/translateDoc/translateFile.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { dirname, relative } from 'node:path';\nimport { performance } from 'node:perf_hooks';\nimport { readAsset } from 'utils:asset';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport { retryManager } from '@intlayer/config/utils';\nimport { chunkText } from '../utils/calculateChunks';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { TranslateFileOptions } from './types';\nimport { sanitizeChunk, validateTranslation } from './validation';\n\nexport const translateFile = async ({\n  baseFilePath,\n  outputFilePath,\n  locale,\n  baseLocale,\n  configuration,\n  errorState,\n  aiOptions,\n  customInstructions,\n  aiClient,\n  aiConfig,\n  flushStrategy = 'incremental',\n  onChunkReceive,\n  limit, // The Global Limiter\n}: TranslateFileOptions): Promise<string | null> => {\n  if (errorState.shouldStop) return null;\n\n  const appLogger = getAppLogger(configuration, { config: { prefix: '' } });\n  const fileStartTime = performance.now();\n\n  try {\n    const fileContent = await readFile(baseFilePath, 'utf-8');\n    const chunks = chunkText(fileContent);\n    const totalChunks = chunks.length;\n\n    const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n    const filePrefix = `${colon(filePrefixText, { colSize: 40 })}${ANSIColors.RESET}`;\n    const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n    const prefix = `${colon(prefixText, { colSize: 40 })}${ANSIColors.RESET}`;\n\n    appLogger(\n      `${filePrefix}Split into ${colorizeNumber(totalChunks)} chunks. Queuing...`\n    );\n\n    const basePrompt = readAsset('./prompts/TRANSLATE_PROMPT.md', 'utf-8')\n      .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n      .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n      .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n      .replace('{{customInstructions}}', customInstructions ?? '-');\n\n    const translatedParts: string[] = new Array(totalChunks).fill('');\n\n    // Fallback if no limiter is provided (runs immediately)\n    const runTask = limit ?? ((fn) => fn());\n\n    // MAP CHUNKS TO GLOBAL TASKS\n    // This pushes ALL chunks for this file into the Global Queue immediately.\n    // They will execute whenever the global concurrency slots open up.\n    const tasks = chunks.map((chunk, i) =>\n      runTask(async () => {\n        if (errorState.shouldStop) return null;\n\n        const chunkLogger = getAppLogger(configuration, {\n          config: {\n            prefix: `${prefix}  ${ANSIColors.GREY_DARK}[${i + 1}/${totalChunks}] ${ANSIColors.RESET}`,\n          },\n        });\n\n        const chunkStartTime = performance.now();\n        const isFirstChunk = i === 0;\n        const fileToTranslateCurrentChunk = chunk.content;\n\n        // Context Preparation\n        const getPrevChunkPrompt = () =>\n          `>>> CONTEXT: PREVIOUS SOURCE CONTENT <<<\\n\\`\\`\\`\\n` +\n          (chunks[i - 1]?.content ?? '') +\n          `\\n\\`\\`\\`\\n>>> END PREVIOUS CONTEXT <<<`;\n\n        const getBaseChunkContextPrompt = () =>\n          `>>> CONTEXT: NEXT CONTENT <<<\\n\\`\\`\\`\\n` +\n          (chunks[i + 1]?.content ?? '') +\n          `\\n\\`\\`\\`\\n>>> END NEXT CONTEXT <<<`;\n\n        chunkLogger('Process started');\n\n        const chunkTranslation = retryManager(async () => {\n          const result = await chunkInference(\n            [\n              { role: 'system', content: basePrompt },\n              ...(chunks[i + 1]\n                ? [\n                    {\n                      role: 'system',\n                      content: getBaseChunkContextPrompt(),\n                    } as const,\n                  ]\n                : []),\n              ...(isFirstChunk\n                ? []\n                : [{ role: 'system', content: getPrevChunkPrompt() } as const]),\n              {\n                role: 'system',\n                content: [\n                  `You are translating TARGET CHUNK (${i + 1}/${totalChunks}).`,\n                  `Translate ONLY the target chunk. Preserve frontmatter/code exactly.`,\n                ].join('\\n'),\n              },\n              {\n                role: 'user',\n                content: `>>> TARGET CHUNK START <<<\\n${fileToTranslateCurrentChunk}\\n>>> TARGET CHUNK END <<<`,\n              },\n            ],\n            aiOptions,\n            configuration,\n            aiClient,\n            aiConfig\n          );\n\n          let processedChunk = sanitizeChunk(\n            result?.fileContent,\n            fileToTranslateCurrentChunk\n          );\n          processedChunk = fixChunkStartEndChars(\n            processedChunk,\n            fileToTranslateCurrentChunk\n          );\n\n          const isValid = validateTranslation(\n            fileToTranslateCurrentChunk,\n            processedChunk,\n            chunkLogger\n          );\n\n          if (!isValid) {\n            // Throwing an error here signals retryManager to try again\n            throw new Error(\n              `Validation failed for chunk ${i + 1}/${totalChunks}`\n            );\n          }\n\n          return { content: processedChunk, tokens: result.tokenUsed };\n        });\n\n        const { content: translatedChunk, tokens } = await chunkTranslation();\n        const chunkEndTime = performance.now();\n        const chunkDuration = (chunkEndTime - chunkStartTime).toFixed(0);\n\n        // Store Result\n        translatedParts[i] = translatedChunk;\n\n        if (onChunkReceive) {\n          onChunkReceive(translatedChunk, i, totalChunks);\n        }\n\n        // Incremental Flush Strategy\n        if (flushStrategy === 'incremental') {\n          const isContiguous = translatedParts\n            .slice(0, i + 1)\n            .every((p) => p && p !== '');\n\n          if (isContiguous) {\n            let endIdx = 0;\n            while (\n              endIdx < totalChunks &&\n              translatedParts[endIdx] &&\n              translatedParts[endIdx] !== ''\n            ) {\n              endIdx++;\n            }\n            const currentContent = translatedParts.slice(0, endIdx).join('');\n            // Write asynchronously/sync is fine here as node handles file locks reasonably well for single process\n            mkdirSync(dirname(outputFilePath), { recursive: true });\n            writeFileSync(outputFilePath, currentContent);\n          }\n        }\n\n        chunkLogger(\n          [\n            `${colorizeNumber(tokens)} tokens used `,\n            `${ANSIColors.GREY_DARK}in ${colorizeNumber(chunkDuration)}ms${ANSIColors.RESET}`,\n          ].join('')\n        );\n      })\n    );\n\n    // Wait for all chunks for this specific file/locale to finish\n    await Promise.all(tasks);\n\n    // Final Flush\n    const fullContent = translatedParts.join('');\n    if (flushStrategy === 'end' || flushStrategy === 'incremental') {\n      mkdirSync(dirname(outputFilePath), { recursive: true });\n      writeFileSync(outputFilePath, fullContent);\n    }\n\n    const fileEndTime = performance.now();\n    const totalDuration = ((fileEndTime - fileStartTime) / 1000).toFixed(2);\n    const relativePath = relative(configuration.system.baseDir, outputFilePath);\n\n    appLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(relativePath)} completed in ${colorizeNumber(totalDuration)}s.`\n    );\n\n    return fullContent;\n  } catch (error: any) {\n    errorState.count++;\n    const errorMessage = error?.message ?? JSON.stringify(error);\n    appLogger(`${colorize('✖', ANSIColors.RED)} Error: ${errorMessage}`);\n    if (errorState.count >= errorState.maxErrors) errorState.shouldStop = true;\n    return null;\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"translateFile.mjs","names":[],"sources":["../../../src/translateDoc/translateFile.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, relative } from 'node:path';\nimport { performance } from 'node:perf_hooks';\nimport { readAsset } from 'utils:asset';\nimport { formatLocale, formatPath } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport { retryManager } from '@intlayer/config/utils';\nimport { chunkText } from '../utils/calculateChunks';\nimport { chunkInference } from '../utils/chunkInference';\nimport { fixChunkStartEndChars } from '../utils/fixChunkStartEndChars';\nimport type { TranslateFileOptions } from './types';\nimport { sanitizeChunk, validateTranslation } from './validation';\n\nexport const translateFile = async ({\n  baseFilePath,\n  outputFilePath,\n  locale,\n  baseLocale,\n  configuration,\n  errorState,\n  aiOptions,\n  customInstructions,\n  aiClient,\n  aiConfig,\n  flushStrategy = 'incremental',\n  onChunkReceive,\n  limit, // The Global Limiter\n}: TranslateFileOptions): Promise<string | null> => {\n  if (errorState.shouldStop) return null;\n\n  const appLogger = getAppLogger(configuration, { config: { prefix: '' } });\n  const fileStartTime = performance.now();\n\n  try {\n    const fileContent = await readFile(baseFilePath, 'utf-8');\n    const chunks = chunkText(fileContent);\n    const totalChunks = chunks.length;\n\n    const filePrefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}] `;\n    const filePrefix = `${colon(filePrefixText, { colSize: 40 })}${ANSIColors.RESET}`;\n    const prefixText = `${ANSIColors.GREY_DARK}[${formatPath(baseFilePath)}${ANSIColors.GREY_DARK}][${formatLocale(locale)}${ANSIColors.GREY_DARK}] `;\n    const prefix = `${colon(prefixText, { colSize: 40 })}${ANSIColors.RESET}`;\n\n    appLogger(\n      `${filePrefix}Split into ${colorizeNumber(totalChunks)} chunks. Queuing...`\n    );\n\n    const basePrompt = readAsset('./prompts/TRANSLATE_PROMPT.md', 'utf-8')\n      .replaceAll('{{localeName}}', `${formatLocale(locale, false)}`)\n      .replaceAll('{{baseLocaleName}}', `${formatLocale(baseLocale, false)}`)\n      .replace('{{applicationContext}}', aiOptions?.applicationContext ?? '-')\n      .replace('{{customInstructions}}', customInstructions ?? '-');\n\n    const translatedParts: string[] = new Array(totalChunks).fill('');\n\n    // Fallback if no limiter is provided (runs immediately)\n    const runTask = limit ?? ((fn) => fn());\n\n    // MAP CHUNKS TO GLOBAL TASKS\n    // This pushes ALL chunks for this file into the Global Queue immediately.\n    // They will execute whenever the global concurrency slots open up.\n    const tasks = chunks.map((chunk, i) =>\n      runTask(async () => {\n        if (errorState.shouldStop) return null;\n\n        const chunkLogger = getAppLogger(configuration, {\n          config: {\n            prefix: `${prefix}  ${ANSIColors.GREY_DARK}[${i + 1}/${totalChunks}] ${ANSIColors.RESET}`,\n          },\n        });\n\n        const chunkStartTime = performance.now();\n        const isFirstChunk = i === 0;\n        const fileToTranslateCurrentChunk = chunk.content;\n\n        // Context Preparation\n        const getPrevChunkPrompt = () =>\n          `>>> CONTEXT: PREVIOUS SOURCE CONTENT <<<\\n\\`\\`\\`\\n` +\n          (chunks[i - 1]?.content ?? '') +\n          `\\n\\`\\`\\`\\n>>> END PREVIOUS CONTEXT <<<`;\n\n        const getBaseChunkContextPrompt = () =>\n          `>>> CONTEXT: NEXT CONTENT <<<\\n\\`\\`\\`\\n` +\n          (chunks[i + 1]?.content ?? '') +\n          `\\n\\`\\`\\`\\n>>> END NEXT CONTEXT <<<`;\n\n        chunkLogger('Process started');\n\n        const chunkTranslation = retryManager(async () => {\n          const result = await chunkInference(\n            [\n              { role: 'system', content: basePrompt },\n              ...(chunks[i + 1]\n                ? [\n                    {\n                      role: 'system',\n                      content: getBaseChunkContextPrompt(),\n                    } as const,\n                  ]\n                : []),\n              ...(isFirstChunk\n                ? []\n                : [{ role: 'system', content: getPrevChunkPrompt() } as const]),\n              {\n                role: 'system',\n                content: [\n                  `You are translating TARGET CHUNK (${i + 1}/${totalChunks}).`,\n                  `Translate ONLY the target chunk. Preserve frontmatter/code exactly.`,\n                ].join('\\n'),\n              },\n            ],\n            [\n              {\n                role: 'user',\n                content: `>>> TARGET CHUNK START <<<\\n${fileToTranslateCurrentChunk}\\n>>> TARGET CHUNK END <<<`,\n              },\n            ],\n            aiOptions,\n            configuration,\n            aiClient,\n            aiConfig\n          );\n\n          let processedChunk = sanitizeChunk(\n            result?.fileContent,\n            fileToTranslateCurrentChunk\n          );\n          processedChunk = fixChunkStartEndChars(\n            processedChunk,\n            fileToTranslateCurrentChunk\n          );\n\n          const isValid = validateTranslation(\n            fileToTranslateCurrentChunk,\n            processedChunk,\n            chunkLogger\n          );\n\n          if (!isValid) {\n            // Throwing an error here signals retryManager to try again\n            throw new Error(\n              `Validation failed for chunk ${i + 1}/${totalChunks}`\n            );\n          }\n\n          return { content: processedChunk, tokens: result.tokenUsed };\n        });\n\n        const { content: translatedChunk, tokens } = await chunkTranslation();\n        const chunkEndTime = performance.now();\n        const chunkDuration = (chunkEndTime - chunkStartTime).toFixed(0);\n\n        // Store Result\n        translatedParts[i] = translatedChunk;\n\n        if (onChunkReceive) {\n          onChunkReceive(translatedChunk, i, totalChunks);\n        }\n\n        // Incremental Flush Strategy\n        if (flushStrategy === 'incremental') {\n          const isContiguous = translatedParts\n            .slice(0, i + 1)\n            .every((p) => p && p !== '');\n\n          if (isContiguous) {\n            let endIdx = 0;\n            while (\n              endIdx < totalChunks &&\n              translatedParts[endIdx] &&\n              translatedParts[endIdx] !== ''\n            ) {\n              endIdx++;\n            }\n            const currentContent = translatedParts.slice(0, endIdx).join('');\n            // Write asynchronously/sync is fine here as node handles file locks reasonably well for single process\n            await mkdir(dirname(outputFilePath), { recursive: true });\n            await writeFile(outputFilePath, currentContent);\n          }\n        }\n\n        chunkLogger(\n          [\n            `${colorizeNumber(tokens)} tokens used `,\n            `${ANSIColors.GREY_DARK}in ${colorizeNumber(chunkDuration)}ms${ANSIColors.RESET}`,\n          ].join('')\n        );\n      })\n    );\n\n    // Wait for all chunks for this specific file/locale to finish\n    await Promise.all(tasks);\n\n    // Final Flush\n    const fullContent = translatedParts.join('');\n    if (flushStrategy === 'end' || flushStrategy === 'incremental') {\n      await mkdir(dirname(outputFilePath), { recursive: true });\n      await writeFile(outputFilePath, fullContent);\n    }\n\n    const fileEndTime = performance.now();\n    const totalDuration = ((fileEndTime - fileStartTime) / 1000).toFixed(2);\n    const relativePath = relative(configuration.system.baseDir, outputFilePath);\n\n    appLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(relativePath)} completed in ${colorizeNumber(totalDuration)}s.`\n    );\n\n    return fullContent;\n  } catch (error: any) {\n    errorState.count++;\n    const errorMessage = error?.message ?? JSON.stringify(error);\n    appLogger(`${colorize('✖', ANSIColors.RED)} Error: ${errorMessage}`);\n    if (errorState.count >= errorState.maxErrors) errorState.shouldStop = true;\n    return null;\n  }\n};\n"],"mappings":"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"}

package/dist/esm/utils/chunkInference.mjs

@@ -6,12 +6,13 @@ import { retryManager } from "@intlayer/config/utils";
 * Translates a single chunk via the OpenAI API.
 * Includes retry logic if the call fails.
 */
-const chunkInference = async (messages, aiOptions, configuration, aiClient, aiConfig) => {
+const chunkInference = async (system, messages, aiOptions, configuration, aiClient, aiConfig) => {
 	let lastResult;
 	await retryManager(async () => {
 		if (aiClient && aiConfig) {
 			const response = await aiClient.customQuery({
 				aiConfig,
+				system,
 				messages
 			});
 			if (!response) throw new Error("No response from AI API");

package/dist/esm/utils/chunkInference.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunkInference.mjs","names":[],"sources":["../../../src/utils/chunkInference.ts"],"sourcesContent":["import type { AIConfig, AIOptions } from '@intlayer/ai';\nimport { getIntlayerAPIProxy, type Messages } from '@intlayer/api';\nimport { retryManager } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { AIClient } from './setupAI';\n\ntype ChunkInferenceResult = {\n  fileContent: string;\n  tokenUsed: number;\n};\n\n/**\n * Translates a single chunk via the OpenAI API.\n * Includes retry logic if the call fails.\n */\nexport const chunkInference = async (\n  messages: Messages,\n  aiOptions?: AIOptions,\n  configuration?: IntlayerConfig,\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n): Promise<ChunkInferenceResult> => {\n  let lastResult: ChunkInferenceResult;\n\n  await retryManager(async () => {\n    if (aiClient && aiConfig) {\n      const response = await aiClient.customQuery({\n        aiConfig,\n        messages,\n      });\n\n      if (!response) {\n        throw new Error('No response from AI API');\n      }\n\n      const { fileContent, tokenUsed } = response;\n\n      lastResult = {\n        fileContent: processContent(fileContent),\n        tokenUsed,\n      };\n\n      return;\n    }\n\n    const api = getIntlayerAPIProxy(undefined, configuration);\n\n    const response = await api.ai.customQuery({\n      aiOptions,\n      messages,\n    });\n\n    if (!response.data) {\n      throw new Error('No response from AI API');\n    }\n\n    const { fileContent, tokenUsed } = response.data;\n\n    lastResult = {\n      fileContent: processContent(fileContent),\n      tokenUsed,\n    };\n  })();\n\n  return lastResult!;\n};\n\nconst processContent = (content: string) => {\n  return content\n    .replaceAll('///chunksStart///', '')\n    .replaceAll('///chunkStart///', '')\n    .replaceAll('///chunksEnd///', '')\n    .replaceAll('///chunkEnd///', '')\n    .replaceAll('///chunksStart///', '')\n    .replaceAll('chunkStart///', '')\n    .replaceAll('chunksEnd///', '')\n    .replaceAll('chunkEnd///', '')\n    .replaceAll('///chunksStart', '')\n    .replaceAll('///chunkStart', '')\n    .replaceAll('///chunksEnd', '')\n    .replaceAll('///chunkEnd', '')\n    .replaceAll('chunksStart', '')\n    .replaceAll('chunkStart', '')\n    .replaceAll('chunksEnd', '')\n    .replaceAll('chunkEnd', '');\n};\n"],"mappings":";;;;;;;;AAeA,MAAa,iBAAiB,OAC5B,UACA,WACA,eACA,UACA,aACkC;CAClC,IAAI;AAEJ,OAAM,aAAa,YAAY;AAC7B,MAAI,YAAY,UAAU;GACxB,MAAM,WAAW,MAAM,SAAS,YAAY;IAC1C;IACA;IACD,CAAC;AAEF,OAAI,CAAC,SACH,OAAM,IAAI,MAAM,0BAA0B;GAG5C,MAAM,EAAE,aAAa,cAAc;AAEnC,gBAAa;IACX,aAAa,eAAe,YAAY;IACxC;IACD;AAED;;EAKF,MAAM,WAAW,MAFL,oBAAoB,QAAW,cAEjB,CAAC,GAAG,YAAY;GACxC;GACA;GACD,CAAC;AAEF,MAAI,CAAC,SAAS,KACZ,OAAM,IAAI,MAAM,0BAA0B;EAG5C,MAAM,EAAE,aAAa,cAAc,SAAS;AAE5C,eAAa;GACX,aAAa,eAAe,YAAY;GACxC;GACD;GACD,EAAE;AAEJ,QAAO;;AAGT,MAAM,kBAAkB,YAAoB;AAC1C,QAAO,QACJ,WAAW,qBAAqB,GAAG,CACnC,WAAW,oBAAoB,GAAG,CAClC,WAAW,mBAAmB,GAAG,CACjC,WAAW,kBAAkB,GAAG,CAChC,WAAW,qBAAqB,GAAG,CACnC,WAAW,iBAAiB,GAAG,CAC/B,WAAW,gBAAgB,GAAG,CAC9B,WAAW,eAAe,GAAG,CAC7B,WAAW,kBAAkB,GAAG,CAChC,WAAW,iBAAiB,GAAG,CAC/B,WAAW,gBAAgB,GAAG,CAC9B,WAAW,eAAe,GAAG,CAC7B,WAAW,eAAe,GAAG,CAC7B,WAAW,cAAc,GAAG,CAC5B,WAAW,aAAa,GAAG,CAC3B,WAAW,YAAY,GAAG"}
+{"version":3,"file":"chunkInference.mjs","names":[],"sources":["../../../src/utils/chunkInference.ts"],"sourcesContent":["import type {\n  AIConfig,\n  AIOptions,\n  Messages,\n  SystemMessage,\n} from '@intlayer/ai';\nimport { getIntlayerAPIProxy } from '@intlayer/api';\nimport { retryManager } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { AIClient } from './setupAI';\n\ntype ChunkInferenceResult = {\n  fileContent: string;\n  tokenUsed: number;\n};\n\n/**\n * Translates a single chunk via the OpenAI API.\n * Includes retry logic if the call fails.\n */\nexport const chunkInference = async (\n  system: SystemMessage,\n  messages: Messages,\n  aiOptions?: AIOptions,\n  configuration?: IntlayerConfig,\n  aiClient?: AIClient,\n  aiConfig?: AIConfig\n): Promise<ChunkInferenceResult> => {\n  let lastResult: ChunkInferenceResult;\n\n  await retryManager(async () => {\n    if (aiClient && aiConfig) {\n      const response = await aiClient.customQuery({\n        aiConfig,\n        system,\n        messages,\n      });\n\n      if (!response) {\n        throw new Error('No response from AI API');\n      }\n\n      const { fileContent, tokenUsed } = response;\n\n      lastResult = {\n        fileContent: processContent(fileContent),\n        tokenUsed,\n      };\n\n      return;\n    }\n\n    const api = getIntlayerAPIProxy(undefined, configuration);\n\n    const response = await api.ai.customQuery({\n      aiOptions,\n      messages,\n    });\n\n    if (!response.data) {\n      throw new Error('No response from AI API');\n    }\n\n    const { fileContent, tokenUsed } = response.data;\n\n    lastResult = {\n      fileContent: processContent(fileContent),\n      tokenUsed,\n    };\n  })();\n\n  return lastResult!;\n};\n\nconst processContent = (content: string) => {\n  return content\n    .replaceAll('///chunksStart///', '')\n    .replaceAll('///chunkStart///', '')\n    .replaceAll('///chunksEnd///', '')\n    .replaceAll('///chunkEnd///', '')\n    .replaceAll('///chunksStart///', '')\n    .replaceAll('chunkStart///', '')\n    .replaceAll('chunksEnd///', '')\n    .replaceAll('chunkEnd///', '')\n    .replaceAll('///chunksStart', '')\n    .replaceAll('///chunkStart', '')\n    .replaceAll('///chunksEnd', '')\n    .replaceAll('///chunkEnd', '')\n    .replaceAll('chunksStart', '')\n    .replaceAll('chunkStart', '')\n    .replaceAll('chunksEnd', '')\n    .replaceAll('chunkEnd', '');\n};\n"],"mappings":";;;;;;;;AAoBA,MAAa,iBAAiB,OAC5B,QACA,UACA,WACA,eACA,UACA,aACkC;CAClC,IAAI;AAEJ,OAAM,aAAa,YAAY;AAC7B,MAAI,YAAY,UAAU;GACxB,MAAM,WAAW,MAAM,SAAS,YAAY;IAC1C;IACA;IACA;IACD,CAAC;AAEF,OAAI,CAAC,SACH,OAAM,IAAI,MAAM,0BAA0B;GAG5C,MAAM,EAAE,aAAa,cAAc;AAEnC,gBAAa;IACX,aAAa,eAAe,YAAY;IACxC;IACD;AAED;;EAKF,MAAM,WAAW,MAFL,oBAAoB,QAAW,cAEjB,CAAC,GAAG,YAAY;GACxC;GACA;GACD,CAAC;AAEF,MAAI,CAAC,SAAS,KACZ,OAAM,IAAI,MAAM,0BAA0B;EAG5C,MAAM,EAAE,aAAa,cAAc,SAAS;AAE5C,eAAa;GACX,aAAa,eAAe,YAAY;GACxC;GACD;GACD,EAAE;AAEJ,QAAO;;AAGT,MAAM,kBAAkB,YAAoB;AAC1C,QAAO,QACJ,WAAW,qBAAqB,GAAG,CACnC,WAAW,oBAAoB,GAAG,CAClC,WAAW,mBAAmB,GAAG,CACjC,WAAW,kBAAkB,GAAG,CAChC,WAAW,qBAAqB,GAAG,CACnC,WAAW,iBAAiB,GAAG,CAC/B,WAAW,gBAAgB,GAAG,CAC9B,WAAW,eAAe,GAAG,CAC7B,WAAW,kBAAkB,GAAG,CAChC,WAAW,iBAAiB,GAAG,CAC/B,WAAW,gBAAgB,GAAG,CAC9B,WAAW,eAAe,GAAG,CAC7B,WAAW,eAAe,GAAG,CAC7B,WAAW,cAAc,GAAG,CAC5B,WAAW,aAAa,GAAG,CAC3B,WAAW,YAAY,GAAG"}

package/dist/esm/utils/setupAI.mjs

@@ -41,6 +41,7 @@ const setupAI = async (configuration, aiOptions) => {
 		appLogger([colorize("@intlayer/ai", ANSIColors.GREY_LIGHT), colorize("found - Run process locally", ANSIColors.GREY_DARK)]);
 		const aiConfig = await aiClient.getAIConfig({
 			userOptions: aiOptions,
+			projectOptions: configuration.ai,
 			accessType: ["public"]
 		});
 		logAIConfig(aiOptions ?? {}, appLogger);

package/dist/esm/utils/setupAI.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"setupAI.mjs","names":[],"sources":["../../../src/utils/setupAI.ts"],"sourcesContent":["import type { AIConfig, AIOptions } from '@intlayer/ai';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger, type logger } from '@intlayer/config/logger';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { checkAIAccess } from './checkAccess';\n\nexport type AIClient = typeof import('@intlayer/ai');\n\ntype SetupAIResult = {\n  aiClient?: AIClient;\n  aiConfig?: AIConfig;\n  isCustomAI: boolean;\n  hasAIAccess: boolean;\n};\n\n// Disable warnings from the AI SDK\nglobalThis.AI_SDK_LOG_WARNINGS = false;\n\nconst logAIConfig = (aiOptions: AIOptions, appLogger: typeof logger) => {\n  appLogger([\n    colorize('Provider:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.provider ?? '(default)', ANSIColors.BLUE),\n    colorize('- Model:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.model ?? '(default)', ANSIColors.BLUE),\n    colorize('- API Key:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.apiKey ? '✓' : '(not set)', ANSIColors.BLUE),\n  ]);\n};\n\n/**\n * Checks if the @intlayer/ai package is available and configured when an API key is provided.\n * If API key is present but package is missing, logs a warning.\n * Also checks if the user has access to AI (either via local key or CMS auth).\n */\nexport const setupAI = async (\n  configuration: IntlayerConfig,\n  aiOptions?: AIOptions\n): Promise<SetupAIResult | undefined> => {\n  const appLogger = getAppLogger(configuration);\n\n  const isLocalAI =\n    aiOptions?.apiKey ||\n    aiOptions?.provider === 'ollama' ||\n    configuration.ai?.apiKey ||\n    configuration.ai?.provider === 'ollama';\n\n  if (isLocalAI) {\n    // Try to import the AI package for local AI usage\n    let aiClient: AIClient | undefined;\n\n    try {\n      aiClient = await import('@intlayer/ai');\n    } catch {\n      // Package not installed - log warning and fall back to backend\n      appLogger(\n        [\n          colorize('Using your API key, you can install the', ANSIColors.GREY),\n          colorize('@intlayer/ai', ANSIColors.GREY_LIGHT),\n          colorize(\n            'package to run the process locally, with no dependency on the Intlayer server',\n            ANSIColors.GREY\n          ),\n        ],\n        {\n          level: 'warn',\n        }\n      );\n\n      // Fall back to backend API check\n      const hasAIAccess = await checkAIAccess(configuration, aiOptions);\n      logAIConfig(aiOptions ?? {}, appLogger);\n      return {\n        isCustomAI: false,\n        hasAIAccess,\n      };\n    }\n\n    // Package found - now configure it (errors here should propagate, not fall back)\n    appLogger([\n      colorize('@intlayer/ai', ANSIColors.GREY_LIGHT),\n      colorize('found - Run process locally', ANSIColors.GREY_DARK),\n    ]);\n\n    const aiConfig = await aiClient.getAIConfig({\n      userOptions: aiOptions,\n      accessType: ['public'],\n    });\n\n    logAIConfig(aiOptions ?? {}, appLogger);\n\n    return {\n      aiClient,\n      aiConfig,\n      isCustomAI: true,\n      hasAIAccess: true, // Local AI always has access\n    };\n  }\n\n  // No local AI configured - use backend API\n  const hasAIAccess = await checkAIAccess(configuration, aiOptions);\n  logAIConfig(aiOptions ?? {}, appLogger);\n\n  return {\n    isCustomAI: false,\n    hasAIAccess,\n  };\n};\n"],"mappings":";;;;;AAgBA,WAAW,sBAAsB;AAEjC,MAAM,eAAe,WAAsB,cAA6B;AACtE,WAAU;EACR,SAAS,aAAa,WAAW,UAAU;EAC3C,SAAS,WAAW,YAAY,aAAa,WAAW,KAAK;EAC7D,SAAS,YAAY,WAAW,UAAU;EAC1C,SAAS,WAAW,SAAS,aAAa,WAAW,KAAK;EAC1D,SAAS,cAAc,WAAW,UAAU;EAC5C,SAAS,WAAW,SAAS,MAAM,aAAa,WAAW,KAAK;EACjE,CAAC;;;;;;;AAQJ,MAAa,UAAU,OACrB,eACA,cACuC;CACvC,MAAM,YAAY,aAAa,cAAc;AAQ7C,KALE,WAAW,UACX,WAAW,aAAa,YACxB,cAAc,IAAI,UAClB,cAAc,IAAI,aAAa,UAElB;EAEb,IAAI;AAEJ,MAAI;AACF,cAAW,MAAM,OAAO;UAClB;AAEN,aACE;IACE,SAAS,2CAA2C,WAAW,KAAK;IACpE,SAAS,gBAAgB,WAAW,WAAW;IAC/C,SACE,iFACA,WAAW,KACZ;IACF,EACD,EACE,OAAO,QACR,CACF;GAGD,MAAM,cAAc,MAAM,cAAc,eAAe,UAAU;AACjE,eAAY,aAAa,EAAE,EAAE,UAAU;AACvC,UAAO;IACL,YAAY;IACZ;IACD;;AAIH,YAAU,CACR,SAAS,gBAAgB,WAAW,WAAW,EAC/C,SAAS,+BAA+B,WAAW,UAAU,CAC9D,CAAC;EAEF,MAAM,WAAW,MAAM,SAAS,YAAY;GAC1C,aAAa;GACb,YAAY,CAAC,SAAS;GACvB,CAAC;AAEF,cAAY,aAAa,EAAE,EAAE,UAAU;AAEvC,SAAO;GACL;GACA;GACA,YAAY;GACZ,aAAa;GACd;;CAIH,MAAM,cAAc,MAAM,cAAc,eAAe,UAAU;AACjE,aAAY,aAAa,EAAE,EAAE,UAAU;AAEvC,QAAO;EACL,YAAY;EACZ;EACD"}
+{"version":3,"file":"setupAI.mjs","names":[],"sources":["../../../src/utils/setupAI.ts"],"sourcesContent":["import type { AIConfig, AIOptions } from '@intlayer/ai';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger, type logger } from '@intlayer/config/logger';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { checkAIAccess } from './checkAccess';\n\nexport type AIClient = typeof import('@intlayer/ai');\n\ntype SetupAIResult = {\n  aiClient?: AIClient;\n  aiConfig?: AIConfig;\n  isCustomAI: boolean;\n  hasAIAccess: boolean;\n};\n\n// Disable warnings from the AI SDK\nglobalThis.AI_SDK_LOG_WARNINGS = false;\n\nconst logAIConfig = (aiOptions: AIOptions, appLogger: typeof logger) => {\n  appLogger([\n    colorize('Provider:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.provider ?? '(default)', ANSIColors.BLUE),\n    colorize('- Model:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.model ?? '(default)', ANSIColors.BLUE),\n    colorize('- API Key:', ANSIColors.GREY_DARK),\n    colorize(aiOptions?.apiKey ? '✓' : '(not set)', ANSIColors.BLUE),\n  ]);\n};\n\n/**\n * Checks if the @intlayer/ai package is available and configured when an API key is provided.\n * If API key is present but package is missing, logs a warning.\n * Also checks if the user has access to AI (either via local key or CMS auth).\n */\nexport const setupAI = async (\n  configuration: IntlayerConfig,\n  aiOptions?: AIOptions\n): Promise<SetupAIResult | undefined> => {\n  const appLogger = getAppLogger(configuration);\n\n  const isLocalAI =\n    aiOptions?.apiKey ||\n    aiOptions?.provider === 'ollama' ||\n    configuration.ai?.apiKey ||\n    configuration.ai?.provider === 'ollama';\n\n  if (isLocalAI) {\n    // Try to import the AI package for local AI usage\n    let aiClient: AIClient | undefined;\n\n    try {\n      aiClient = await import('@intlayer/ai');\n    } catch {\n      // Package not installed - log warning and fall back to backend\n      appLogger(\n        [\n          colorize('Using your API key, you can install the', ANSIColors.GREY),\n          colorize('@intlayer/ai', ANSIColors.GREY_LIGHT),\n          colorize(\n            'package to run the process locally, with no dependency on the Intlayer server',\n            ANSIColors.GREY\n          ),\n        ],\n        {\n          level: 'warn',\n        }\n      );\n\n      // Fall back to backend API check\n      const hasAIAccess = await checkAIAccess(configuration, aiOptions);\n      logAIConfig(aiOptions ?? {}, appLogger);\n      return {\n        isCustomAI: false,\n        hasAIAccess,\n      };\n    }\n\n    // Package found - now configure it (errors here should propagate, not fall back)\n    appLogger([\n      colorize('@intlayer/ai', ANSIColors.GREY_LIGHT),\n      colorize('found - Run process locally', ANSIColors.GREY_DARK),\n    ]);\n\n    const aiConfig = await aiClient.getAIConfig({\n      userOptions: aiOptions,\n      projectOptions: configuration.ai as AIOptions,\n      accessType: ['public'],\n    });\n\n    logAIConfig(aiOptions ?? {}, appLogger);\n\n    return {\n      aiClient,\n      aiConfig,\n      isCustomAI: true,\n      hasAIAccess: true, // Local AI always has access\n    };\n  }\n\n  // No local AI configured - use backend API\n  const hasAIAccess = await checkAIAccess(configuration, aiOptions);\n  logAIConfig(aiOptions ?? {}, appLogger);\n\n  return {\n    isCustomAI: false,\n    hasAIAccess,\n  };\n};\n"],"mappings":";;;;;AAgBA,WAAW,sBAAsB;AAEjC,MAAM,eAAe,WAAsB,cAA6B;AACtE,WAAU;EACR,SAAS,aAAa,WAAW,UAAU;EAC3C,SAAS,WAAW,YAAY,aAAa,WAAW,KAAK;EAC7D,SAAS,YAAY,WAAW,UAAU;EAC1C,SAAS,WAAW,SAAS,aAAa,WAAW,KAAK;EAC1D,SAAS,cAAc,WAAW,UAAU;EAC5C,SAAS,WAAW,SAAS,MAAM,aAAa,WAAW,KAAK;EACjE,CAAC;;;;;;;AAQJ,MAAa,UAAU,OACrB,eACA,cACuC;CACvC,MAAM,YAAY,aAAa,cAAc;AAQ7C,KALE,WAAW,UACX,WAAW,aAAa,YACxB,cAAc,IAAI,UAClB,cAAc,IAAI,aAAa,UAElB;EAEb,IAAI;AAEJ,MAAI;AACF,cAAW,MAAM,OAAO;UAClB;AAEN,aACE;IACE,SAAS,2CAA2C,WAAW,KAAK;IACpE,SAAS,gBAAgB,WAAW,WAAW;IAC/C,SACE,iFACA,WAAW,KACZ;IACF,EACD,EACE,OAAO,QACR,CACF;GAGD,MAAM,cAAc,MAAM,cAAc,eAAe,UAAU;AACjE,eAAY,aAAa,EAAE,EAAE,UAAU;AACvC,UAAO;IACL,YAAY;IACZ;IACD;;AAIH,YAAU,CACR,SAAS,gBAAgB,WAAW,WAAW,EAC/C,SAAS,+BAA+B,WAAW,UAAU,CAC9D,CAAC;EAEF,MAAM,WAAW,MAAM,SAAS,YAAY;GAC1C,aAAa;GACb,gBAAgB,cAAc;GAC9B,YAAY,CAAC,SAAS;GACvB,CAAC;AAEF,cAAY,aAAa,EAAE,EAAE,UAAU;AAEvC,SAAO;GACL;GACA;GACA,YAAY;GACZ,aAAa;GACd;;CAIH,MAAM,cAAc,MAAM,cAAc,eAAe,UAAU;AACjE,aAAY,aAAa,EAAE,EAAE,UAAU;AAEvC,QAAO;EACL,YAAY;EACZ;EACD"}

package/dist/types/translateDoc/translateFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translateFile.d.ts","names":[],"sources":["../../../src/translateDoc/translateFile.ts"],"mappings":";;;cAoBa,aAAA;EAAuB,YAAA;EAAA,cAAA;EAAA,MAAA;EAAA,UAAA;EAAA,aAAA;EAAA,UAAA;EAAA,SAAA;EAAA,kBAAA;EAAA,QAAA;EAAA,QAAA;EAAA,aAAA;EAAA,cAAA;EAAA;AAAA,GAcjC,oBAAA,KAAuB,OAAA"}
+{"version":3,"file":"translateFile.d.ts","names":[],"sources":["../../../src/translateDoc/translateFile.ts"],"mappings":";;;cAmBa,aAAA;EAAuB,YAAA;EAAA,cAAA;EAAA,MAAA;EAAA,UAAA;EAAA,aAAA;EAAA,UAAA;EAAA,SAAA;EAAA,kBAAA;EAAA,QAAA;EAAA,QAAA;EAAA,aAAA;EAAA,cAAA;EAAA;AAAA,GAcjC,oBAAA,KAAuB,OAAA"}

package/dist/types/utils/chunkInference.d.ts

@@ -1,7 +1,6 @@
 import { AIClient } from "./setupAI.js";
 import { IntlayerConfig } from "@intlayer/types/config";
-import { Messages } from "@intlayer/api";
-import { AIConfig, AIOptions as AIOptions$1 } from "@intlayer/ai";
+import { AIConfig, AIOptions, Messages, SystemMessage } from "@intlayer/ai";
 
 //#region src/utils/chunkInference.d.ts
 type ChunkInferenceResult = {
@@ -12,7 +11,7 @@ type ChunkInferenceResult = {
  * Translates a single chunk via the OpenAI API.
  * Includes retry logic if the call fails.
  */
-declare const chunkInference: (messages: Messages, aiOptions?: AIOptions$1, configuration?: IntlayerConfig, aiClient?: AIClient, aiConfig?: AIConfig) => Promise<ChunkInferenceResult>;
+declare const chunkInference: (system: SystemMessage, messages: Messages, aiOptions?: AIOptions, configuration?: IntlayerConfig, aiClient?: AIClient, aiConfig?: AIConfig) => Promise<ChunkInferenceResult>;
 //#endregion
 export { chunkInference };
 //# sourceMappingURL=chunkInference.d.ts.map

package/dist/types/utils/chunkInference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunkInference.d.ts","names":[],"sources":["../../../src/utils/chunkInference.ts"],"mappings":";;;;;;KAMK,oBAAA;EACH,WAAA;EACA,SAAA;AAAA;;;;AAOF;cAAa,cAAA,GACX,QAAA,EAAU,QAAA,EACV,SAAA,GAAY,WAAA,EACZ,aAAA,GAAgB,cAAA,EAChB,QAAA,GAAW,QAAA,EACX,QAAA,GAAW,QAAA,KACV,OAAA,CAAQ,oBAAA"}
+{"version":3,"file":"chunkInference.d.ts","names":[],"sources":["../../../src/utils/chunkInference.ts"],"mappings":";;;;;KAWK,oBAAA;EACH,WAAA;EACA,SAAA;AAAA;;;;AAOF;cAAa,cAAA,GACX,MAAA,EAAQ,aAAA,EACR,QAAA,EAAU,QAAA,EACV,SAAA,GAAY,SAAA,EACZ,aAAA,GAAgB,cAAA,EAChB,QAAA,GAAW,QAAA,EACX,QAAA,GAAW,QAAA,KACV,OAAA,CAAQ,oBAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/cli",
-  "version": "8.7.12",
+  "version": "8.7.14",
   "private": false,
   "description": "Provides uniform command-line interface scripts for Intlayer, used in packages like intlayer-cli and intlayer.",
   "keywords": [
@@ -67,22 +67,22 @@
   },
   "dependencies": {
     "@clack/prompts": "0.11.0",
-    "@intlayer/api": "8.7.12",
-    "@intlayer/babel": "8.7.12",
-    "@intlayer/chokidar": "8.7.12",
-    "@intlayer/config": "8.7.12",
-    "@intlayer/core": "8.7.12",
-    "@intlayer/dictionaries-entry": "8.7.12",
-    "@intlayer/remote-dictionaries-entry": "8.7.12",
-    "@intlayer/types": "8.7.12",
-    "@intlayer/unmerged-dictionaries-entry": "8.7.12",
+    "@intlayer/api": "8.7.14",
+    "@intlayer/babel": "8.7.14",
+    "@intlayer/chokidar": "8.7.14",
+    "@intlayer/config": "8.7.14",
+    "@intlayer/core": "8.7.14",
+    "@intlayer/dictionaries-entry": "8.7.14",
+    "@intlayer/remote-dictionaries-entry": "8.7.14",
+    "@intlayer/types": "8.7.14",
+    "@intlayer/unmerged-dictionaries-entry": "8.7.14",
     "commander": "14.0.3",
     "enquirer": "^2.4.1",
     "eventsource": "4.1.0",
     "fast-glob": "3.3.3"
   },
   "devDependencies": {
-    "@intlayer/ai": "8.7.12",
+    "@intlayer/ai": "8.7.14",
     "@types/node": "25.6.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
@@ -93,7 +93,7 @@
     "vitest": "4.1.5"
   },
   "peerDependencies": {
-    "@intlayer/ai": "8.7.12"
+    "@intlayer/ai": "8.7.14"
   },
   "peerDependenciesMeta": {
     "@intlayer/ai": {