@intlayer/cli 9.7.1 → 9.7.3

package/dist/esm/push/push.mjs

@@ -2,16 +2,16 @@ import { loadPrompts } from "../loadPrompts.mjs";
 import { PushLogger } from "../pushLog.mjs";
 import { checkCMSAuth, getAuthenticatedAPI } from "../utils/checkAccess.mjs";
 import { selectCmsEnvironment } from "../utils/selectCmsEnvironment.mjs";
+import { join } from "node:path";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colorize, colorizeKey, getAppLogger } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
+import { getUnmergedDictionaries } from "@intlayer/dictionaries-entry/unmerged";
+import { prepareIntlayer, writeContentDeclaration } from "@intlayer/engine/build";
 import { listGitFiles, logConfigDetails } from "@intlayer/engine/cli";
-import { join } from "node:path";
-import * as fsPromises from "node:fs/promises";
 import { formatPath } from "@intlayer/engine/utils";
+import * as fsPromises from "node:fs/promises";
 import { parallelize } from "@intlayer/config/utils";
-import { getUnmergedDictionaries } from "@intlayer/dictionaries-entry/unmerged";
-import { prepareIntlayer as prepareIntlayer$1, writeContentDeclaration } from "@intlayer/engine/build";
 
 // src/push/push.ts
 const statusIconsAndColors = {
@@ -46,8 +46,8 @@ const push = async (options) => {
 	const config = getConfiguration(options?.configOptions);
 	logConfigDetails(options?.configOptions);
 	const appLogger = getAppLogger(config);
-	if (options?.build === true) await prepareIntlayer$1(config, { forceRun: true });
-	else if (typeof options?.build === "undefined") await prepareIntlayer$1(config);
+	if (options?.build === true) await prepareIntlayer(config, { forceRun: true });
+	else if (typeof options?.build === "undefined") await prepareIntlayer(config);
 	try {
 		if (!await checkCMSAuth(config)) return;
 		const intlayerAPI = await getAuthenticatedAPI(config);

package/dist/esm/push/push.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"push.mjs","names":["prepareIntlayer"],"sources":["../../../src/push/push.ts"],"sourcesContent":["import * as fsPromises from 'node:fs/promises';\nimport { join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { parallelize } from '@intlayer/config/utils';\nimport { getUnmergedDictionaries } from '@intlayer/dictionaries-entry/unmerged';\nimport {\n  prepareIntlayer,\n  writeContentDeclaration,\n} from '@intlayer/engine/build';\nimport {\n  type ListGitFilesOptions,\n  listGitFiles,\n  logConfigDetails,\n} from '@intlayer/engine/cli';\nimport { formatPath } from '@intlayer/engine/utils';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { loadPrompts } from '../loadPrompts';\nimport { PushLogger, type PushStatus } from '../pushLog';\nimport { checkCMSAuth, getAuthenticatedAPI } from '../utils/checkAccess';\nimport { selectCmsEnvironment } from '../utils/selectCmsEnvironment';\n\ntype PushOptions = {\n  deleteLocaleDictionary?: boolean;\n  keepLocaleDictionary?: boolean;\n  dictionaries?: string[];\n  gitOptions?: ListGitFilesOptions;\n  configOptions?: GetConfigurationOptions;\n  build?: boolean;\n};\n\ntype DictionariesStatus = {\n  dictionary: Dictionary;\n  status:\n    | 'pending'\n    | 'pushing'\n    | 'modified'\n    | 'pushed'\n    | 'up-to-date'\n    | 'unknown'\n    | 'error';\n  error?: Error;\n  errorMessage?: string;\n};\n\n// Print per-dictionary summary similar to loadDictionaries\nconst statusIconsAndColors = {\n  pushed: { icon: '✔', color: ANSIColors.GREEN },\n  modified: { icon: '✔', color: ANSIColors.GREEN },\n  'up-to-date': { icon: '=', color: ANSIColors.GREY },\n  error: { icon: '✖', color: ANSIColors.RED },\n  default: { icon: '⏲', color: ANSIColors.BLUE },\n};\n\nconst getIconAndColor = (status: DictionariesStatus['status']) => {\n  return (\n    statusIconsAndColors[status as keyof typeof statusIconsAndColors] ??\n    statusIconsAndColors.default\n  );\n};\n\n/**\n * Get all local dictionaries and push them simultaneously.\n */\nexport const push = async (options?: PushOptions): Promise<void> => {\n  const config = getConfiguration(options?.configOptions);\n  logConfigDetails(options?.configOptions);\n\n  const appLogger = getAppLogger(config);\n\n  if (options?.build === true) {\n    await prepareIntlayer(config, { forceRun: true });\n  } else if (typeof options?.build === 'undefined') {\n    await prepareIntlayer(config);\n  }\n\n  try {\n    const hasCMSAuth = await checkCMSAuth(config);\n\n    if (!hasCMSAuth) return;\n\n    const intlayerAPI = await getAuthenticatedAPI(config);\n\n    await selectCmsEnvironment(\n      options?.configOptions?.env,\n      intlayerAPI,\n      config\n    );\n\n    const unmergedDictionariesRecord = getUnmergedDictionaries(config);\n    const allDictionaries = Object.values(unmergedDictionariesRecord).flat();\n\n    const customLocations = Array.from(\n      new Set(\n        allDictionaries\n          .map((dictionary) => dictionary.location)\n          .filter(\n            (location) =>\n              location && !['remote', 'local', 'hybrid'].includes(location)\n          )\n      )\n    ) as string[];\n\n    // Include all custom locations automatically — no interactive prompt needed.\n    const selectedCustomLocations: string[] = customLocations;\n\n    let dictionaries: Dictionary[] = allDictionaries.filter((dictionary) => {\n      const location =\n        dictionary.location ?? config.dictionary?.location ?? 'local';\n\n      return (\n        location === 'remote' ||\n        location === 'hybrid' ||\n        selectedCustomLocations.includes(location)\n      );\n    });\n\n    // Check if the dictionaries list is empty after filtering by location\n    if (dictionaries.length === 0) {\n      appLogger(\n        `No dictionaries found to push. Only dictionaries with location ${colorize('remote', ANSIColors.BLUE, ANSIColors.RESET)}, ${colorize('hybrid', ANSIColors.BLUE, ANSIColors.RESET)} or selected custom locations are pushed.`,\n        { level: 'warn' }\n      );\n      appLogger(\n        `You can set the location in your dictionary file (e.g. ${colorize(\"{ key: 'my-key', location: 'hybrid', ... }\", ANSIColors.BLUE, ANSIColors.RESET)} or globally in your intlayer.config.ts file (e.g. ${colorize(\"{ dictionary: { location: 'hybrid' } }\", ANSIColors.BLUE, ANSIColors.RESET)}).`,\n        { level: 'info' }\n      );\n      return;\n    }\n\n    const existingDictionariesKeys: string[] = Object.keys(\n      unmergedDictionariesRecord\n    );\n\n    if (options?.dictionaries) {\n      // Check if the provided dictionaries exist\n      const noneExistingDictionariesOption = options.dictionaries.filter(\n        (dictionaryId) => !existingDictionariesKeys.includes(dictionaryId)\n      );\n\n      if (noneExistingDictionariesOption.length > 0) {\n        appLogger(\n          `The following dictionaries do not exist: ${noneExistingDictionariesOption.join(\n            ', '\n          )} and have been ignored.`,\n          {\n            level: 'error',\n          }\n        );\n      }\n\n      // Filter the dictionaries from the provided list of IDs\n      dictionaries = dictionaries.filter((dictionary) =>\n        options.dictionaries?.includes(dictionary.key)\n      );\n    }\n\n    if (options?.gitOptions) {\n      const gitFiles = await listGitFiles(options.gitOptions);\n\n      dictionaries = dictionaries.filter((dictionary) =>\n        gitFiles.includes(\n          join(config.system.baseDir, dictionary.filePath ?? '')\n        )\n      );\n    }\n\n    // Check if the dictionaries list is empty\n    if (dictionaries.length === 0) {\n      appLogger('No local dictionaries found', {\n        level: 'error',\n      });\n      return;\n    }\n\n    appLogger('Pushing dictionaries:');\n\n    // Prepare dictionaries statuses\n    const dictionariesStatuses: DictionariesStatus[] = dictionaries.map(\n      (dictionary) => ({\n        dictionary,\n        status: 'pending',\n      })\n    );\n\n    // Initialize aggregated logger similar to loadDictionaries\n    const logger = new PushLogger();\n    logger.update(\n      dictionariesStatuses.map<PushStatus>((s) => ({\n        dictionaryKey: s.dictionary.key,\n        status: 'pending',\n      }))\n    );\n\n    const successfullyPushedDictionaries: Dictionary[] = [];\n\n    const processDictionary = async (\n      statusObj: DictionariesStatus\n    ): Promise<void> => {\n      statusObj.status = 'pushing';\n      logger.update([\n        { dictionaryKey: statusObj.dictionary.key, status: 'pushing' },\n      ]);\n\n      try {\n        const pushResult = await intlayerAPI.dictionary.pushDictionaries([\n          statusObj.dictionary,\n        ]);\n\n        const updatedDictionaries = pushResult.data?.updatedDictionaries ?? [];\n        const newDictionaries = pushResult.data?.newDictionaries ?? [];\n        const upToDateDictionaries =\n          pushResult.data?.upToDateDictionaries ?? [];\n\n        const allDictionaries = [\n          ...updatedDictionaries,\n          ...newDictionaries,\n          ...upToDateDictionaries,\n        ];\n\n        for (const remoteDictionaryData of allDictionaries) {\n          const localDictionary = unmergedDictionariesRecord[\n            remoteDictionaryData.key\n          ]?.find(\n            (dictionary) => dictionary.localId === remoteDictionaryData.localId\n          );\n\n          if (!localDictionary) continue;\n\n          await writeContentDeclaration(\n            { ...localDictionary, id: remoteDictionaryData.id },\n            config\n          );\n        }\n\n        if (\n          updatedDictionaries.some(\n            (dictionary) => dictionary.key === statusObj.dictionary.key\n          )\n        ) {\n          statusObj.status = 'modified';\n          successfullyPushedDictionaries.push(statusObj.dictionary);\n          logger.update([\n            { dictionaryKey: statusObj.dictionary.key, status: 'modified' },\n          ]);\n        } else if (\n          newDictionaries.some(\n            (dictionary) => dictionary.key === statusObj.dictionary.key\n          )\n        ) {\n          statusObj.status = 'pushed';\n          successfullyPushedDictionaries.push(statusObj.dictionary);\n          logger.update([\n            { dictionaryKey: statusObj.dictionary.key, status: 'pushed' },\n          ]);\n        } else if (\n          upToDateDictionaries.some(\n            (dictionary) => dictionary.key === statusObj.dictionary.key\n          )\n        ) {\n          statusObj.status = 'up-to-date';\n          logger.update([\n            { dictionaryKey: statusObj.dictionary.key, status: 'up-to-date' },\n          ]);\n        } else {\n          statusObj.status = 'unknown';\n        }\n      } catch (error) {\n        statusObj.status = 'error';\n        statusObj.error = error as Error;\n        statusObj.errorMessage = `Error pushing dictionary ${statusObj.dictionary.key}: ${error}`;\n        logger.update([\n          { dictionaryKey: statusObj.dictionary.key, status: 'error' },\n        ]);\n      }\n    };\n\n    // Process dictionaries in parallel with a concurrency limit (reuse parallelize)\n    await parallelize(dictionariesStatuses, processDictionary, 5);\n\n    // Stop the logger and render final state\n    logger.finish();\n\n    for (const dictionaryStatus of dictionariesStatuses) {\n      const { icon, color } = getIconAndColor(dictionaryStatus.status);\n      appLogger(\n        ` - ${colorizeKey(dictionaryStatus.dictionary.key)} ${ANSIColors.GREY}[${color}${icon} ${dictionaryStatus.status}${ANSIColors.GREY}]${ANSIColors.RESET}`\n      );\n    }\n\n    // Output any error messages\n    for (const statusObj of dictionariesStatuses) {\n      if (statusObj.errorMessage) {\n        appLogger(statusObj.errorMessage, {\n          level: 'error',\n        });\n      }\n    }\n\n    // Handle delete or keep options\n    const deleteOption = options?.deleteLocaleDictionary;\n    const keepOption = options?.keepLocaleDictionary;\n\n    if (deleteOption && keepOption) {\n      throw new Error(\n        'Cannot specify both --deleteLocaleDictionary and --keepLocaleDictionary options.'\n      );\n    }\n\n    if (deleteOption) {\n      // Delete only the successfully pushed dictionaries\n      await deleteLocalDictionaries(successfullyPushedDictionaries, options);\n    } else if (keepOption) {\n      // Do nothing, keep the local dictionaries\n    } else {\n      // Ask the user\n      const remoteDictionaries = successfullyPushedDictionaries.filter(\n        (dictionary) => dictionary.location === 'remote'\n      );\n      const remoteDictionariesKeys = remoteDictionaries.map(\n        (dictionary) => dictionary.key\n      );\n\n      if (remoteDictionaries.length > 0) {\n        const { confirm, isCancel } = await loadPrompts();\n\n        const shouldDelete = await confirm({\n          message: `Do you want to delete the local dictionaries that were successfully pushed? ${colorize('(Dictionaries:', ANSIColors.GREY, ANSIColors.RESET)} ${colorizeKey(remoteDictionariesKeys)}${colorize(')', ANSIColors.GREY, ANSIColors.RESET)}`,\n          initialValue: false,\n        });\n\n        if (isCancel(shouldDelete)) {\n          return;\n        }\n\n        if (shouldDelete) {\n          await deleteLocalDictionaries(remoteDictionaries, options);\n        }\n      }\n    }\n  } catch (error) {\n    appLogger(error, {\n      level: 'error',\n    });\n  }\n};\n\nconst deleteLocalDictionaries = async (\n  dictionariesToDelete: Dictionary[],\n  options?: PushOptions\n): Promise<void> => {\n  const config = getConfiguration(options?.configOptions);\n  const appLogger = getAppLogger(config);\n\n  // Use a Set to collect all unique file paths\n  const filePathsSet: Set<string> = new Set();\n\n  for (const dictionary of dictionariesToDelete) {\n    const { filePath } = dictionary;\n\n    if (!filePath) {\n      appLogger(\n        `Dictionary ${colorizeKey(dictionary.key)} does not have a file path`,\n        {\n          level: 'error',\n        }\n      );\n      continue;\n    }\n\n    filePathsSet.add(filePath);\n  }\n\n  for (const filePath of filePathsSet) {\n    try {\n      const stats = await fsPromises.lstat(filePath);\n\n      if (stats.isFile()) {\n        await fsPromises.unlink(filePath);\n        appLogger(`Deleted file ${formatPath(filePath)}`, {});\n      } else if (stats.isDirectory()) {\n        appLogger(`Path is a directory ${formatPath(filePath)}, skipping.`, {});\n      } else {\n        appLogger(\n          `Unknown file type for ${formatPath(filePath)}, skipping.`,\n          {}\n        );\n      }\n    } catch (err) {\n      appLogger(`Error deleting ${formatPath(filePath)}: ${err}`, {\n        level: 'error',\n      });\n    }\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"push.mjs","names":[],"sources":["../../../src/push/push.ts"],"sourcesContent":["import * as fsPromises from 'node:fs/promises';\nimport { join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport { parallelize } from '@intlayer/config/utils';\nimport { getUnmergedDictionaries } from '@intlayer/dictionaries-entry/unmerged';\nimport {\n  prepareIntlayer,\n  writeContentDeclaration,\n} from '@intlayer/engine/build';\nimport {\n  type ListGitFilesOptions,\n  listGitFiles,\n  logConfigDetails,\n} from '@intlayer/engine/cli';\nimport { formatPath } from '@intlayer/engine/utils';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { loadPrompts } from '../loadPrompts';\nimport { PushLogger, type PushStatus } from '../pushLog';\nimport { checkCMSAuth, getAuthenticatedAPI } from '../utils/checkAccess';\nimport { selectCmsEnvironment } from '../utils/selectCmsEnvironment';\n\ntype PushOptions = {\n  deleteLocaleDictionary?: boolean;\n  keepLocaleDictionary?: boolean;\n  dictionaries?: string[];\n  gitOptions?: ListGitFilesOptions;\n  configOptions?: GetConfigurationOptions;\n  build?: boolean;\n};\n\ntype DictionariesStatus = {\n  dictionary: Dictionary;\n  status:\n    | 'pending'\n    | 'pushing'\n    | 'modified'\n    | 'pushed'\n    | 'up-to-date'\n    | 'unknown'\n    | 'error';\n  error?: Error;\n  errorMessage?: string;\n};\n\n// Print per-dictionary summary similar to loadDictionaries\nconst statusIconsAndColors = {\n  pushed: { icon: '✔', color: ANSIColors.GREEN },\n  modified: { icon: '✔', color: ANSIColors.GREEN },\n  'up-to-date': { icon: '=', color: ANSIColors.GREY },\n  error: { icon: '✖', color: ANSIColors.RED },\n  default: { icon: '⏲', color: ANSIColors.BLUE },\n};\n\nconst getIconAndColor = (status: DictionariesStatus['status']) => {\n  return (\n    statusIconsAndColors[status as keyof typeof statusIconsAndColors] ??\n    statusIconsAndColors.default\n  );\n};\n\n/**\n * Get all local dictionaries and push them simultaneously.\n */\nexport const push = async (options?: PushOptions): Promise<void> => {\n  const config = getConfiguration(options?.configOptions);\n  logConfigDetails(options?.configOptions);\n\n  const appLogger = getAppLogger(config);\n\n  if (options?.build === true) {\n    await prepareIntlayer(config, { forceRun: true });\n  } else if (typeof options?.build === 'undefined') {\n    await prepareIntlayer(config);\n  }\n\n  try {\n    const hasCMSAuth = await checkCMSAuth(config);\n\n    if (!hasCMSAuth) return;\n\n    const intlayerAPI = await getAuthenticatedAPI(config);\n\n    await selectCmsEnvironment(\n      options?.configOptions?.env,\n      intlayerAPI,\n      config\n    );\n\n    const unmergedDictionariesRecord = getUnmergedDictionaries(config);\n    const allDictionaries = Object.values(unmergedDictionariesRecord).flat();\n\n    const customLocations = Array.from(\n      new Set(\n        allDictionaries\n          .map((dictionary) => dictionary.location)\n          .filter(\n            (location) =>\n              location && !['remote', 'local', 'hybrid'].includes(location)\n          )\n      )\n    ) as string[];\n\n    // Include all custom locations automatically — no interactive prompt needed.\n    const selectedCustomLocations: string[] = customLocations;\n\n    let dictionaries: Dictionary[] = allDictionaries.filter((dictionary) => {\n      const location =\n        dictionary.location ?? config.dictionary?.location ?? 'local';\n\n      return (\n        location === 'remote' ||\n        location === 'hybrid' ||\n        selectedCustomLocations.includes(location)\n      );\n    });\n\n    // Check if the dictionaries list is empty after filtering by location\n    if (dictionaries.length === 0) {\n      appLogger(\n        `No dictionaries found to push. Only dictionaries with location ${colorize('remote', ANSIColors.BLUE, ANSIColors.RESET)}, ${colorize('hybrid', ANSIColors.BLUE, ANSIColors.RESET)} or selected custom locations are pushed.`,\n        { level: 'warn' }\n      );\n      appLogger(\n        `You can set the location in your dictionary file (e.g. ${colorize(\"{ key: 'my-key', location: 'hybrid', ... }\", ANSIColors.BLUE, ANSIColors.RESET)} or globally in your intlayer.config.ts file (e.g. ${colorize(\"{ dictionary: { location: 'hybrid' } }\", ANSIColors.BLUE, ANSIColors.RESET)}).`,\n        { level: 'info' }\n      );\n      return;\n    }\n\n    const existingDictionariesKeys: string[] = Object.keys(\n      unmergedDictionariesRecord\n    );\n\n    if (options?.dictionaries) {\n      // Check if the provided dictionaries exist\n      const noneExistingDictionariesOption = options.dictionaries.filter(\n        (dictionaryId) => !existingDictionariesKeys.includes(dictionaryId)\n      );\n\n      if (noneExistingDictionariesOption.length > 0) {\n        appLogger(\n          `The following dictionaries do not exist: ${noneExistingDictionariesOption.join(\n            ', '\n          )} and have been ignored.`,\n          {\n            level: 'error',\n          }\n        );\n      }\n\n      // Filter the dictionaries from the provided list of IDs\n      dictionaries = dictionaries.filter((dictionary) =>\n        options.dictionaries?.includes(dictionary.key)\n      );\n    }\n\n    if (options?.gitOptions) {\n      const gitFiles = await listGitFiles(options.gitOptions);\n\n      dictionaries = dictionaries.filter((dictionary) =>\n        gitFiles.includes(\n          join(config.system.baseDir, dictionary.filePath ?? '')\n        )\n      );\n    }\n\n    // Check if the dictionaries list is empty\n    if (dictionaries.length === 0) {\n      appLogger('No local dictionaries found', {\n        level: 'error',\n      });\n      return;\n    }\n\n    appLogger('Pushing dictionaries:');\n\n    // Prepare dictionaries statuses\n    const dictionariesStatuses: DictionariesStatus[] = dictionaries.map(\n      (dictionary) => ({\n        dictionary,\n        status: 'pending',\n      })\n    );\n\n    // Initialize aggregated logger similar to loadDictionaries\n    const logger = new PushLogger();\n    logger.update(\n      dictionariesStatuses.map<PushStatus>((s) => ({\n        dictionaryKey: s.dictionary.key,\n        status: 'pending',\n      }))\n    );\n\n    const successfullyPushedDictionaries: Dictionary[] = [];\n\n    const processDictionary = async (\n      statusObj: DictionariesStatus\n    ): Promise<void> => {\n      statusObj.status = 'pushing';\n      logger.update([\n        { dictionaryKey: statusObj.dictionary.key, status: 'pushing' },\n      ]);\n\n      try {\n        const pushResult = await intlayerAPI.dictionary.pushDictionaries([\n          statusObj.dictionary,\n        ]);\n\n        const updatedDictionaries = pushResult.data?.updatedDictionaries ?? [];\n        const newDictionaries = pushResult.data?.newDictionaries ?? [];\n        const upToDateDictionaries =\n          pushResult.data?.upToDateDictionaries ?? [];\n\n        const allDictionaries = [\n          ...updatedDictionaries,\n          ...newDictionaries,\n          ...upToDateDictionaries,\n        ];\n\n        for (const remoteDictionaryData of allDictionaries) {\n          const localDictionary = unmergedDictionariesRecord[\n            remoteDictionaryData.key\n          ]?.find(\n            (dictionary) => dictionary.localId === remoteDictionaryData.localId\n          );\n\n          if (!localDictionary) continue;\n\n          await writeContentDeclaration(\n            { ...localDictionary, id: remoteDictionaryData.id },\n            config\n          );\n        }\n\n        if (\n          updatedDictionaries.some(\n            (dictionary) => dictionary.key === statusObj.dictionary.key\n          )\n        ) {\n          statusObj.status = 'modified';\n          successfullyPushedDictionaries.push(statusObj.dictionary);\n          logger.update([\n            { dictionaryKey: statusObj.dictionary.key, status: 'modified' },\n          ]);\n        } else if (\n          newDictionaries.some(\n            (dictionary) => dictionary.key === statusObj.dictionary.key\n          )\n        ) {\n          statusObj.status = 'pushed';\n          successfullyPushedDictionaries.push(statusObj.dictionary);\n          logger.update([\n            { dictionaryKey: statusObj.dictionary.key, status: 'pushed' },\n          ]);\n        } else if (\n          upToDateDictionaries.some(\n            (dictionary) => dictionary.key === statusObj.dictionary.key\n          )\n        ) {\n          statusObj.status = 'up-to-date';\n          logger.update([\n            { dictionaryKey: statusObj.dictionary.key, status: 'up-to-date' },\n          ]);\n        } else {\n          statusObj.status = 'unknown';\n        }\n      } catch (error) {\n        statusObj.status = 'error';\n        statusObj.error = error as Error;\n        statusObj.errorMessage = `Error pushing dictionary ${statusObj.dictionary.key}: ${error}`;\n        logger.update([\n          { dictionaryKey: statusObj.dictionary.key, status: 'error' },\n        ]);\n      }\n    };\n\n    // Process dictionaries in parallel with a concurrency limit (reuse parallelize)\n    await parallelize(dictionariesStatuses, processDictionary, 5);\n\n    // Stop the logger and render final state\n    logger.finish();\n\n    for (const dictionaryStatus of dictionariesStatuses) {\n      const { icon, color } = getIconAndColor(dictionaryStatus.status);\n      appLogger(\n        ` - ${colorizeKey(dictionaryStatus.dictionary.key)} ${ANSIColors.GREY}[${color}${icon} ${dictionaryStatus.status}${ANSIColors.GREY}]${ANSIColors.RESET}`\n      );\n    }\n\n    // Output any error messages\n    for (const statusObj of dictionariesStatuses) {\n      if (statusObj.errorMessage) {\n        appLogger(statusObj.errorMessage, {\n          level: 'error',\n        });\n      }\n    }\n\n    // Handle delete or keep options\n    const deleteOption = options?.deleteLocaleDictionary;\n    const keepOption = options?.keepLocaleDictionary;\n\n    if (deleteOption && keepOption) {\n      throw new Error(\n        'Cannot specify both --deleteLocaleDictionary and --keepLocaleDictionary options.'\n      );\n    }\n\n    if (deleteOption) {\n      // Delete only the successfully pushed dictionaries\n      await deleteLocalDictionaries(successfullyPushedDictionaries, options);\n    } else if (keepOption) {\n      // Do nothing, keep the local dictionaries\n    } else {\n      // Ask the user\n      const remoteDictionaries = successfullyPushedDictionaries.filter(\n        (dictionary) => dictionary.location === 'remote'\n      );\n      const remoteDictionariesKeys = remoteDictionaries.map(\n        (dictionary) => dictionary.key\n      );\n\n      if (remoteDictionaries.length > 0) {\n        const { confirm, isCancel } = await loadPrompts();\n\n        const shouldDelete = await confirm({\n          message: `Do you want to delete the local dictionaries that were successfully pushed? ${colorize('(Dictionaries:', ANSIColors.GREY, ANSIColors.RESET)} ${colorizeKey(remoteDictionariesKeys)}${colorize(')', ANSIColors.GREY, ANSIColors.RESET)}`,\n          initialValue: false,\n        });\n\n        if (isCancel(shouldDelete)) {\n          return;\n        }\n\n        if (shouldDelete) {\n          await deleteLocalDictionaries(remoteDictionaries, options);\n        }\n      }\n    }\n  } catch (error) {\n    appLogger(error, {\n      level: 'error',\n    });\n  }\n};\n\nconst deleteLocalDictionaries = async (\n  dictionariesToDelete: Dictionary[],\n  options?: PushOptions\n): Promise<void> => {\n  const config = getConfiguration(options?.configOptions);\n  const appLogger = getAppLogger(config);\n\n  // Use a Set to collect all unique file paths\n  const filePathsSet: Set<string> = new Set();\n\n  for (const dictionary of dictionariesToDelete) {\n    const { filePath } = dictionary;\n\n    if (!filePath) {\n      appLogger(\n        `Dictionary ${colorizeKey(dictionary.key)} does not have a file path`,\n        {\n          level: 'error',\n        }\n      );\n      continue;\n    }\n\n    filePathsSet.add(filePath);\n  }\n\n  for (const filePath of filePathsSet) {\n    try {\n      const stats = await fsPromises.lstat(filePath);\n\n      if (stats.isFile()) {\n        await fsPromises.unlink(filePath);\n        appLogger(`Deleted file ${formatPath(filePath)}`, {});\n      } else if (stats.isDirectory()) {\n        appLogger(`Path is a directory ${formatPath(filePath)}, skipping.`, {});\n      } else {\n        appLogger(\n          `Unknown file type for ${formatPath(filePath)}, skipping.`,\n          {}\n        );\n      }\n    } catch (err) {\n      appLogger(`Error deleting ${formatPath(filePath)}: ${err}`, {\n        level: 'error',\n      });\n    }\n  }\n};\n"],"mappings":"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"}

package/dist/esm/reviewDoc/reviewDoc.mjs

@@ -6,14 +6,14 @@ import { reviewFileBlockAware } from "./reviewDocBlockAware.mjs";
 import { buildFileReviewReport, logReviewFileBlocks } from "./reviewDocLog.mjs";
 import { createReviewProgressLogger } from "./reviewDocProgress.mjs";
 import { formatReviewSynthesis } from "./reviewDocSynthesis.mjs";
+import { existsSync } from "node:fs";
+import { join, relative } from "node:path";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colorize, colorizeNumber, getAppLogger, x } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
 import { listGitFiles, listGitLines, logConfigDetails } from "@intlayer/engine/cli";
-import { join, relative } from "node:path";
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
 import { formatLocale, formatPath } from "@intlayer/engine/utils";
+import { readFile } from "node:fs/promises";
 import { parallelize } from "@intlayer/config/utils";
 import { buildReviewReport } from "@intlayer/engine/docReview";
 import fg from "fast-glob";

package/dist/esm/reviewDoc/reviewDocBlockAware.mjs

@@ -2,13 +2,13 @@ import { readAsset } from "../_virtual/_utils_asset.mjs";
 import { sanitizeChunk, validateTranslation } from "../translateDoc/validation.mjs";
 import { chunkInference } from "../utils/chunkInference.mjs";
 import { fixChunkStartEndChars } from "../utils/fixChunkStartEndChars.mjs";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colon, colorize, colorizeNumber, getAppLogger } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
-import { dirname } from "node:path";
-import { mkdirSync, writeFileSync } from "node:fs";
-import { readFile } from "node:fs/promises";
 import { formatLocale, formatPath } from "@intlayer/engine/utils";
+import { readFile } from "node:fs/promises";
 import { retryManager } from "@intlayer/config/utils";
 import { buildAlignmentPlan, mergeReviewedSegments } from "@intlayer/engine/docReview";
 import { getLocaleName } from "@intlayer/core/localization";
@@ -83,8 +83,8 @@ const reviewFileBlockAware = async (baseFilePath, outputFilePath, locale, baseLo
 	})).reverse();
 	for (const { segment, displayNumber } of segmentsBottomUp) {
 		const baseBlock = segment.baseBlock;
-		const getBaseChunkContextPrompt = () => `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\n///chunksStart///\n` + baseBlock.content + `///chunksEnd///`;
-		const getTargetChunkPrompt = () => `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\n///chunksStart///\n` + (segment.targetBlockText ?? "") + `///chunksEnd///`;
+		const getBaseChunkContextPrompt = () => `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\n///chunksStart///\n${baseBlock.content}///chunksEnd///`;
+		const getTargetChunkPrompt = () => `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\n///chunksStart///\n${segment.targetBlockText ?? ""}///chunksEnd///`;
 		const reviewedChunkResult = await retryManager(async () => {
 			const result = await chunkInference([
 				{

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, AIOptions } from '@intlayer/ai';\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 {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n  type PlannedAction,\n  type ReviewReportSummary,\n} from '@intlayer/engine/docReview';\nimport { formatLocale, formatPath } from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { sanitizeChunk, validateTranslation } from '../translateDoc/validation';\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 *\n * 1. Segments both base and target 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. Applies deletions immediately without AI.\n * 5. Sends changed/new blocks to AI in bottom-up order (last block first), so\n *    line numbers of earlier blocks are not shifted by edits below them.\n * 6. Rewrites the file after each block so progress is persisted incrementally.\n *\n * @returns The per-action block counts of the alignment plan, so the caller can\n * synthesize what was reused and what had to be edited.\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): Promise<ReviewReportSummary> => {\n  const configuration = getConfiguration(configOptions);\n  const applicationLogger = getAppLogger({\n    log: { ...configuration.log, prefix: '' },\n  });\n\n  const baseText = await readFile(baseFilePath, 'utf-8');\n  const targetText = 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 { baseBlocks, targetBlocks, plan, segmentsToReview } =\n    buildAlignmentPlan({\n      baseText,\n      targetText,\n      changedLines,\n    });\n\n  const countActions = (kind: PlannedAction['kind']): number =>\n    plan.actions.filter((action: PlannedAction) => action.kind === kind).length;\n\n  const reviewSummary: ReviewReportSummary = {\n    reuse: countActions('reuse'),\n    review: countActions('review'),\n    insertNew: countActions('insert_new'),\n    delete: countActions('delete'),\n  };\n\n  const deleteCount = reviewSummary.delete;\n\n  applicationLogger(\n    `${filePrefix}Block-aware alignment complete. Total blocks: base=${colorizeNumber(baseBlocks.length)}, target=${colorizeNumber(targetBlocks.length)}`\n  );\n  applicationLogger(\n    `${filePrefix}Actions: reuse=${colorizeNumber(reviewSummary.reuse)}, review=${colorizeNumber(reviewSummary.review)}, new=${colorizeNumber(reviewSummary.insertNew)}, delete=${colorizeNumber(deleteCount)}`\n  );\n\n  // Map shared across the entire run: each entry overrides the default behavior\n  // of mergeReviewedSegments for that action index.\n  const reviewedSegmentsMap = new Map<number, string>();\n\n  // --- Step 1: apply deletions immediately (no AI needed) ---\n  for (const [actionIndex, action] of plan.actions.entries()) {\n    if (action.kind === 'delete') {\n      reviewedSegmentsMap.set(actionIndex, '');\n    }\n  }\n\n  const writeCurrentState = (): void => {\n    const output = mergeReviewedSegments(\n      plan,\n      targetBlocks,\n      reviewedSegmentsMap\n    );\n    mkdirSync(dirname(outputFilePath), { recursive: true });\n    writeFileSync(outputFilePath, output);\n  };\n\n  if (deleteCount > 0) {\n    writeCurrentState();\n    applicationLogger(\n      `${filePrefix}${colorizeNumber(deleteCount)} block(s) deleted without AI.`\n    );\n  }\n\n  if (segmentsToReview.length === 0) {\n    if (deleteCount === 0) {\n      applicationLogger(\n        `${filePrefix}No segments need review, reusing existing translation`\n      );\n      writeCurrentState();\n    }\n    applicationLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no changes needed).`\n    );\n    return reviewSummary;\n  }\n\n  applicationLogger(\n    `${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)} (processing bottom-up)`\n  );\n\n  // --- Step 2: process AI segments in bottom-up order ---\n  // Reversing ensures edits near the end of the file don't shift line numbers\n  // that matter for blocks higher up, and each intermediate file write is valid.\n  const segmentsBottomUp = segmentsToReview\n    .map((segment, originalIndex) => ({\n      segment,\n      displayNumber: originalIndex + 1,\n    }))\n    .reverse();\n\n  for (const { segment, displayNumber } of segmentsBottomUp) {\n    const baseBlock = segment.baseBlock;\n\n    const getBaseChunkContextPrompt = () =>\n      `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\\n` +\n      `///chunksStart///\\n` +\n      baseBlock.content +\n      `///chunksEnd///`;\n\n    const getTargetChunkPrompt = () =>\n      `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\\n` +\n      `///chunksStart///\\n` +\n      (segment.targetBlockText ?? '') +\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: getTargetChunkPrompt() },\n          {\n            role: 'system',\n            content: `The next user message will be the **BLOCK ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`,\n          },\n        ],\n        [{ role: 'user', content: baseBlock.content }],\n        aiOptions,\n        configuration,\n        aiClient,\n        aiConfig\n      );\n\n      applicationLogger(\n        `${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}`\n      );\n\n      let processedChunk = sanitizeChunk(\n        result?.fileContent,\n        baseBlock.content\n      );\n      processedChunk = fixChunkStartEndChars(processedChunk, baseBlock.content);\n\n      const isValid = validateTranslation(\n        baseBlock.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    // Rewrite the file after every block so progress is never lost.\n    writeCurrentState();\n  }\n\n  applicationLogger(\n    `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`\n  );\n\n  return reviewSummary;\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 type { AIConfig, AIOptions } from '@intlayer/ai';\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 {\n  buildAlignmentPlan,\n  mergeReviewedSegments,\n  type PlannedAction,\n  type ReviewReportSummary,\n} from '@intlayer/engine/docReview';\nimport { formatLocale, formatPath } from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { readAsset } from 'utils:asset';\nimport { sanitizeChunk, validateTranslation } from '../translateDoc/validation';\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 *\n * 1. Segments both base and target 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. Applies deletions immediately without AI.\n * 5. Sends changed/new blocks to AI in bottom-up order (last block first), so\n *    line numbers of earlier blocks are not shifted by edits below them.\n * 6. Rewrites the file after each block so progress is persisted incrementally.\n *\n * @returns The per-action block counts of the alignment plan, so the caller can\n * synthesize what was reused and what had to be edited.\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): Promise<ReviewReportSummary> => {\n  const configuration = getConfiguration(configOptions);\n  const applicationLogger = getAppLogger({\n    log: { ...configuration.log, prefix: '' },\n  });\n\n  const baseText = await readFile(baseFilePath, 'utf-8');\n  const targetText = 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 { baseBlocks, targetBlocks, plan, segmentsToReview } =\n    buildAlignmentPlan({\n      baseText,\n      targetText,\n      changedLines,\n    });\n\n  const countActions = (kind: PlannedAction['kind']): number =>\n    plan.actions.filter((action: PlannedAction) => action.kind === kind).length;\n\n  const reviewSummary: ReviewReportSummary = {\n    reuse: countActions('reuse'),\n    review: countActions('review'),\n    insertNew: countActions('insert_new'),\n    delete: countActions('delete'),\n  };\n\n  const deleteCount = reviewSummary.delete;\n\n  applicationLogger(\n    `${filePrefix}Block-aware alignment complete. Total blocks: base=${colorizeNumber(baseBlocks.length)}, target=${colorizeNumber(targetBlocks.length)}`\n  );\n  applicationLogger(\n    `${filePrefix}Actions: reuse=${colorizeNumber(reviewSummary.reuse)}, review=${colorizeNumber(reviewSummary.review)}, new=${colorizeNumber(reviewSummary.insertNew)}, delete=${colorizeNumber(deleteCount)}`\n  );\n\n  // Map shared across the entire run: each entry overrides the default behavior\n  // of mergeReviewedSegments for that action index.\n  const reviewedSegmentsMap = new Map<number, string>();\n\n  // --- Step 1: apply deletions immediately (no AI needed) ---\n  for (const [actionIndex, action] of plan.actions.entries()) {\n    if (action.kind === 'delete') {\n      reviewedSegmentsMap.set(actionIndex, '');\n    }\n  }\n\n  const writeCurrentState = (): void => {\n    const output = mergeReviewedSegments(\n      plan,\n      targetBlocks,\n      reviewedSegmentsMap\n    );\n    mkdirSync(dirname(outputFilePath), { recursive: true });\n    writeFileSync(outputFilePath, output);\n  };\n\n  if (deleteCount > 0) {\n    writeCurrentState();\n    applicationLogger(\n      `${filePrefix}${colorizeNumber(deleteCount)} block(s) deleted without AI.`\n    );\n  }\n\n  if (segmentsToReview.length === 0) {\n    if (deleteCount === 0) {\n      applicationLogger(\n        `${filePrefix}No segments need review, reusing existing translation`\n      );\n      writeCurrentState();\n    }\n    applicationLogger(\n      `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} updated successfully (no changes needed).`\n    );\n    return reviewSummary;\n  }\n\n  applicationLogger(\n    `${filePrefix}Segments to review: ${colorizeNumber(segmentsToReview.length)} (processing bottom-up)`\n  );\n\n  // --- Step 2: process AI segments in bottom-up order ---\n  // Reversing ensures edits near the end of the file don't shift line numbers\n  // that matter for blocks higher up, and each intermediate file write is valid.\n  const segmentsBottomUp = segmentsToReview\n    .map((segment, originalIndex) => ({\n      segment,\n      displayNumber: originalIndex + 1,\n    }))\n    .reverse();\n\n  for (const { segment, displayNumber } of segmentsBottomUp) {\n    const baseBlock = segment.baseBlock;\n\n    const getBaseChunkContextPrompt = () =>\n      `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the base block in ${formatLocale(baseLocale, false)} as reference.\\n` +\n      `///chunksStart///\\n${ \n      baseBlock.content \n      }///chunksEnd///`;\n\n    const getTargetChunkPrompt = () =>\n      `**BLOCK ${displayNumber} of ${segmentsToReview.length}** is the current block to review in ${formatLocale(locale, false)}.\\n` +\n      `///chunksStart///\\n${ \n      segment.targetBlockText ?? '' \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: getTargetChunkPrompt() },\n          {\n            role: 'system',\n            content: `The next user message will be the **BLOCK ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}** that should be translated in ${getLocaleName(locale, ENGLISH)} (${locale}).`,\n          },\n        ],\n        [{ role: 'user', content: baseBlock.content }],\n        aiOptions,\n        configuration,\n        aiClient,\n        aiConfig\n      );\n\n      applicationLogger(\n        `${prefix}${colorizeNumber(result.tokenUsed)} tokens used - Block ${colorizeNumber(displayNumber)} of ${colorizeNumber(segmentsToReview.length)}`\n      );\n\n      let processedChunk = sanitizeChunk(\n        result?.fileContent,\n        baseBlock.content\n      );\n      processedChunk = fixChunkStartEndChars(processedChunk, baseBlock.content);\n\n      const isValid = validateTranslation(\n        baseBlock.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    // Rewrite the file after every block so progress is never lost.\n    writeCurrentState();\n  }\n\n  applicationLogger(\n    `${colorize('✔', ANSIColors.GREEN)} File ${formatPath(outputFilePath)} created/updated successfully.`\n  );\n\n  return reviewSummary;\n};\n"],"mappings":"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"}

package/dist/esm/reviewDoc/reviewDocLog.mjs

@@ -1,8 +1,8 @@
+import { existsSync } from "node:fs";
 import { getAppLogger } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
 import { formatLocale, formatPath } from "@intlayer/engine/utils";
+import { readFile } from "node:fs/promises";
 import { buildReviewReport, formatReviewReport } from "@intlayer/engine/docReview";
 
 // src/reviewDoc/reviewDocLog.ts

package/dist/esm/test/listMissingTranslations.mjs

@@ -1,6 +1,6 @@
 import { getConfiguration } from "@intlayer/config/node";
-import { logConfigDetails } from "@intlayer/engine/cli";
 import { getUnmergedDictionaries } from "@intlayer/dictionaries-entry/unmerged";
+import { logConfigDetails } from "@intlayer/engine/cli";
 import { getMissingLocalesContentFromDictionary } from "@intlayer/core/plugins";
 import { getDictionaries } from "@intlayer/dictionaries-entry";
 

package/dist/esm/test/test.mjs

@@ -2,8 +2,8 @@ import { listMissingTranslations } from "./listMissingTranslations.mjs";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colon, colorize, colorizeKey, colorizeNumber, getAppLogger } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
-import { formatLocale, formatPath } from "@intlayer/engine/utils";
 import { prepareIntlayer } from "@intlayer/engine/build";
+import { formatLocale, formatPath } from "@intlayer/engine/utils";
 
 // src/test/test.ts
 const testMissingTranslations = async (options) => {

package/dist/esm/translateDoc/translateDoc.mjs

@@ -2,12 +2,12 @@ import { checkFileModifiedRange } from "../utils/checkFileModifiedRange.mjs";
 import { getOutputFilePath } from "../utils/getOutputFilePath.mjs";
 import { setupAI } from "../utils/setupAI.mjs";
 import { translateFile } from "./translateFile.mjs";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colorize, colorizeNumber, getAppLogger, x } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
 import { listGitFiles, logConfigDetails } from "@intlayer/engine/cli";
-import { dirname, join } from "node:path";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { pLimit, parallelize } from "@intlayer/config/utils";
 import fg from "fast-glob";
 import { performance } from "node:perf_hooks";

package/dist/esm/translateDoc/translateFile.mjs

@@ -3,11 +3,11 @@ import { chunkText } from "../utils/calculateChunks.mjs";
 import { chunkInference } from "../utils/chunkInference.mjs";
 import { fixChunkStartEndChars } from "../utils/fixChunkStartEndChars.mjs";
 import { sanitizeChunk, validateTranslation } from "./validation.mjs";
+import { dirname, relative } from "node:path";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colon, colorize, colorizeNumber, getAppLogger } from "@intlayer/config/logger";
-import { dirname, relative } from "node:path";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { formatLocale, formatPath } from "@intlayer/engine/utils";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { retryManager } from "@intlayer/config/utils";
 import { performance } from "node:perf_hooks";
 
@@ -34,8 +34,8 @@ const translateFile = async ({ baseFilePath, outputFilePath, locale, baseLocale,
 			const chunkStartTime = performance.now();
 			const isFirstChunk = i === 0;
 			const fileToTranslateCurrentChunk = chunk.content;
-			const getPrevChunkPrompt = () => `>>> CONTEXT: PREVIOUS SOURCE CONTENT <<<\n\`\`\`\n` + (chunks[i - 1]?.content ?? "") + `\n\`\`\`\n>>> END PREVIOUS CONTEXT <<<`;
-			const getBaseChunkContextPrompt = () => `>>> CONTEXT: NEXT CONTENT <<<\n\`\`\`\n` + (chunks[i + 1]?.content ?? "") + `\n\`\`\`\n>>> END NEXT CONTEXT <<<`;
+			const getPrevChunkPrompt = () => `>>> CONTEXT: PREVIOUS SOURCE CONTENT <<<\n\`\`\`\n${chunks[i - 1]?.content ?? ""}\n\`\`\`\n>>> END PREVIOUS CONTEXT <<<`;
+			const getBaseChunkContextPrompt = () => `>>> CONTEXT: NEXT CONTENT <<<\n\`\`\`\n${chunks[i + 1]?.content ?? ""}\n\`\`\`\n>>> END NEXT CONTEXT <<<`;
 			chunkLogger("Process started");
 			const { content: translatedChunk, tokens } = await retryManager(async () => {
 				const result = await chunkInference([

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

@@ -1 +1 @@
-{"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 * 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 { formatLocale, formatPath } from '@intlayer/engine/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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"}
+{"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 * 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 { formatLocale, formatPath } from '@intlayer/engine/utils';\nimport { readAsset } from 'utils:asset';\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/upgrade.mjs

@@ -1,6 +1,6 @@
 import { findProjectRoot } from "./init.mjs";
-import { upgradeIntlayerPackages } from "@intlayer/engine/cli";
 import { resolve } from "node:path";
+import { upgradeIntlayerPackages } from "@intlayer/engine/cli";
 
 // src/upgrade.ts
 /**

package/dist/esm/utils/checkAccess.mjs

@@ -3,8 +3,8 @@ import { readCliSessionToken } from "../auth/sessionToken.mjs";
 import { checkConfigConsistency } from "./checkConfigConsistency.mjs";
 import * as ANSIColors from "@intlayer/config/colors";
 import { colorize, getAppLogger } from "@intlayer/config/logger";
-import { extractErrorMessage } from "@intlayer/config/utils";
 import { getIntlayerAPIProxy } from "@intlayer/api";
+import { extractErrorMessage } from "@intlayer/config/utils";
 
 // src/utils/checkAccess.ts
 const getAuthenticatedAPI = async (configuration) => {

package/dist/esm/utils/detectGitRepository.mjs

@@ -1,5 +1,5 @@
-import { searchConfigurationFile } from "@intlayer/config/node";
 import { relative, sep } from "node:path";
+import { searchConfigurationFile } from "@intlayer/config/node";
 import { spawnSync } from "node:child_process";
 
 // src/utils/detectGitRepository.ts

package/dist/esm/utils/getParentPackageJSON.mjs

@@ -1,5 +1,5 @@
-import { dirname, resolve } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
 
 // src/utils/getParentPackageJSON.ts
 const getParentPackageJSON = (startDir) => {

package/dist/types/IntlayerEventListener.d.ts

@@ -1,5 +1,5 @@
-import { DictionaryAPI } from "@intlayer/api";
 import { IntlayerConfig } from "@intlayer/types/config";
+import { DictionaryAPI } from "@intlayer/api";
 export type IntlayerMessageEvent = MessageEvent;
 /**
  * IntlayerEventListener class to listen for dictionary changes via SSE (Server-Sent Events).

package/dist/types/bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle.d.ts","names":[],"sources":["../../src/bundle.ts"],"mappings":";qBA8Ca,SAAM,SAAmB,0BAAwB"}
+{"version":3,"file":"bundle.d.ts","names":[],"sources":["../../src/bundle.ts"],"mappings":";qBA6Ca,SAAM,SAAmB,0BAAwB"}

package/dist/types/fill/fill.d.ts

@@ -1,6 +1,6 @@
 import { GetTargetDictionaryOptions } from "../getTargetDictionary.js";
-import { AIOptions } from "@intlayer/ai";
 import { ListGitFilesOptions } from "@intlayer/engine/cli";
+import { AIOptions } from "@intlayer/ai";
 import { Locale } from "@intlayer/types/allLocales";
 export type FillOptions = {
   sourceLocale?: Locale;

package/dist/types/fill/formatAutoFilledFilePath.d.ts

@@ -1,5 +1,5 @@
-import { IntlayerConfig } from "@intlayer/types/config";
 import { FilePathPattern } from "@intlayer/types/filePathPattern";
+import { IntlayerConfig } from "@intlayer/types/config";
 import { Locale } from "@intlayer/types/allLocales";
 export declare const formatAutoFilledFilePath: (autoFillField: FilePathPattern, dictionaryKey: string, dictionaryFilePath: string, baseDir: string, configuration: IntlayerConfig, locale?: Locale) => Promise<string>;
 //# sourceMappingURL=formatAutoFilledFilePath.d.ts.map

package/dist/types/index.d.ts

@@ -7,14 +7,14 @@ import { getRemoteEditorRunners, startEditor } from "./editor.js";
 import { extract } from "./extract.js";
 import { FillOptions, FillResult, fill } from "./fill/fill.js";
 import { IntlayerEventListener, IntlayerMessageEvent } from "./IntlayerEventListener.js";
-import { CONTENT_LAYOUT_CHOICES, DEFAULT_INIT_STEPS, ESLINT_CONFIG_FILES, INIT_STEP_COMMANDS, INIT_STEP_GROUPS, InitStep, InitStepOption, LOCALE_ROUTING_CHOICES, LocaleRoutingChoice, OPT_IN_INIT_STEPS, findProjectRoot, getContentInitOptions, getInitOptionsForSteps, getInitialInitSteps, getProjectDependencies, getRoutingInitOptions, init, initCms, initRepository, initSteps, isEslintInstalled, parseContentLayoutChoice, parseLocaleRoutingChoice, resolveProjectRoot } from "./init.js";
+import { CONTENT_LAYOUT_CHOICES, DEFAULT_INIT_STEPS, ESLINT_CONFIG_FILES, INIT_STEP_COMMANDS, INIT_STEP_GROUPS, InitStep, InitStepOption, LOCALE_ROUTING_CHOICES, LocaleRoutingChoice, OPT_IN_INIT_STEPS, findProjectRoot, getContentInitOptions, getInitOptionsForSteps, getInitialInitSteps, getProjectDependencies, getRoutingInitOptions, init, initCms, initRepository, initSteps, isEslintInstalled, isPrettierInstalled, parseContentLayoutChoice, parseLocaleRoutingChoice, resolveProjectRoot } from "./init.js";
 import { BROWSER_EXTENSION_OPTIONS, CHROME_EXTENSION_URL, EXTENSION_BROWSERS, EXTENSION_URL_BY_BROWSER, ExtensionBrowser, InitChromeExtensionOptions, MOZILLA_EXTENSION_URL, initChromeExtension, parseExtensionBrowsers } from "./initChromeExtension.js";
 import { INFRA_MODES, INSTALL_SCRIPT_URL, INSTALL_SCRIPT_URL_WINDOWS, InfraMode, InitInfraOptions, initInfra, parseInfraMode } from "./initInfra.js";
 import { InitSkillsOptions, PLATFORM_OPTIONS, initSkills, parsePlatform, parseSkills, promptPlatform, resolvePlatformWithoutPrompt } from "./initSkills.js";
 import { listContentDeclaration, listContentDeclarationRows } from "./listContentDeclaration.js";
 import { ListProjectsCommandOptions, listProjectsCommand } from "./listProjects.js";
 import { liveSync } from "./liveSync.js";
-import { pull } from "./pull.js";
+import { PulledDictionary, pull } from "./pull.js";
 import { push } from "./push/push.js";
 import { pushConfig } from "./pushConfig.js";
 import { ReviewDocMode, reviewDoc } from "./reviewDoc/reviewDoc.js";
@@ -30,4 +30,4 @@ export type * from "@intlayer/engine/cli";
 export type * from "@intlayer/engine/build";
 export type * from "@intlayer/engine/utils";
 export type * from "@intlayer/engine/watcher";
-export { BROWSER_EXTENSION_OPTIONS, CHROME_EXTENSION_URL, CONTENT_LAYOUT_CHOICES, ConfigurationOptions, DEFAULT_INIT_STEPS, ESLINT_CONFIG_FILES, EXTENSION_BROWSERS, EXTENSION_URL_BY_BROWSER, ExtensionBrowser, FillOptions, FillResult, INFRA_MODES, INIT_STEP_COMMANDS, INIT_STEP_GROUPS, INSTALL_SCRIPT_URL, INSTALL_SCRIPT_URL_WINDOWS, InfraMode, InitChromeExtensionOptions, InitInfraOptions, InitSkillsOptions, InitStep, InitStepOption, IntlayerEventListener, IntlayerMessageEvent, LOCALE_ROUTING_CHOICES, ListProjectsCommandOptions, LocaleRoutingChoice, MOZILLA_EXTENSION_URL, OPT_IN_INIT_STEPS, PLATFORM_OPTIONS, ReviewDocMode, ScanCommandOptions, build, bundle, checkCMSAuth, checkConfigConsistency, clearCliSessionToken, dirname, extract, fill, findProjectRoot, getAuthenticatedAPI, getContentInitOptions, getInitOptionsForSteps, getInitialInitSteps, getProjectDependencies, getRemoteEditorRunners, getRoutingInitOptions, init, initChromeExtension, initCms, initInfra, initRepository, initSkills, initSteps, isEslintInstalled, listContentDeclaration, listContentDeclarationRows, listMissingTranslations, listMissingTranslationsWithConfig, listProjectsCommand, liveSync, login, parseContentLayoutChoice, parseExtensionBrowsers, parseInfraMode, parseLocaleRoutingChoice, parsePlatform, parseSkills, promptPlatform, pull, push, pushConfig, readCliSessionToken, resolvePlatformWithoutPrompt, resolveProjectRoot, reviewDoc, scan, searchDoc, setAPI, startEditor, testMissingTranslations, translateDoc };
+export { BROWSER_EXTENSION_OPTIONS, CHROME_EXTENSION_URL, CONTENT_LAYOUT_CHOICES, ConfigurationOptions, DEFAULT_INIT_STEPS, ESLINT_CONFIG_FILES, EXTENSION_BROWSERS, EXTENSION_URL_BY_BROWSER, ExtensionBrowser, FillOptions, FillResult, INFRA_MODES, INIT_STEP_COMMANDS, INIT_STEP_GROUPS, INSTALL_SCRIPT_URL, INSTALL_SCRIPT_URL_WINDOWS, InfraMode, InitChromeExtensionOptions, InitInfraOptions, InitSkillsOptions, InitStep, InitStepOption, IntlayerEventListener, IntlayerMessageEvent, LOCALE_ROUTING_CHOICES, ListProjectsCommandOptions, LocaleRoutingChoice, MOZILLA_EXTENSION_URL, OPT_IN_INIT_STEPS, PLATFORM_OPTIONS, PulledDictionary, ReviewDocMode, ScanCommandOptions, build, bundle, checkCMSAuth, checkConfigConsistency, clearCliSessionToken, dirname, extract, fill, findProjectRoot, getAuthenticatedAPI, getContentInitOptions, getInitOptionsForSteps, getInitialInitSteps, getProjectDependencies, getRemoteEditorRunners, getRoutingInitOptions, init, initChromeExtension, initCms, initInfra, initRepository, initSkills, initSteps, isEslintInstalled, isPrettierInstalled, listContentDeclaration, listContentDeclarationRows, listMissingTranslations, listMissingTranslationsWithConfig, listProjectsCommand, liveSync, login, parseContentLayoutChoice, parseExtensionBrowsers, parseInfraMode, parseLocaleRoutingChoice, parsePlatform, parseSkills, promptPlatform, pull, push, pushConfig, readCliSessionToken, resolvePlatformWithoutPrompt, resolveProjectRoot, reviewDoc, scan, searchDoc, setAPI, startEditor, testMissingTranslations, translateDoc };

package/dist/types/init.d.ts

@@ -3,7 +3,7 @@ export declare const findProjectRoot: (startDir: string) => string;
 /** Resolves the project root from `--project-root`, else the working directory. */
 export declare const resolveProjectRoot: (projectRoot?: string) => string;
 /** Individually selectable setup steps exposed by the interactive init flow. */
-export type InitStep = 'packages' | 'githubActions' | 'projectSetup' | 'vscodeExtension' | 'lsp' | 'eslint' | 'skills' | 'mcp' | 'infra' | 'cms' | 'repository' | 'chromeExtension';
+export type InitStep = 'packages' | 'githubActions' | 'projectSetup' | 'vscodeExtension' | 'lsp' | 'eslint' | 'prettier' | 'skills' | 'mcp' | 'infra' | 'cms' | 'repository' | 'chromeExtension';
 /** A checkbox entry of the interactive init flow. */
 export type InitStepOption = {
   value: InitStep;
@@ -82,6 +82,10 @@ export declare const ESLINT_CONFIG_FILES: string[];
  * configured in the project.
  */
 export declare const isEslintInstalled: (dependencies: Record<string, string>, root?: string) => boolean;
+/**
+ * Checks whether Prettier is installed or configured in the project.
+ */
+export declare const isPrettierInstalled: (dependencies: Record<string, string>, root?: string) => boolean;
 /**
  * Computes the initial setup steps selected by default in the interactive prompt.
  * Steps like infrastructure and browser extension require opt-in, while

package/dist/types/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","names":[],"sources":["../../src/init.ts"],"mappings":";qBA4Ba,kBAAe;;qBAgBf,qBAAkB;;YAInB;;YAeA;EACV,OAAO;EACP;EACA;;;;;;;qBAQW,mBAAmB;;;;;;;qBAQnB,oBAAoB;;;;;qBAMpB,oBAAoB,OAAO;;;;;;qBAqB3B,yBAAsB,OAC1B,YAAU,cACH,gBACb;;;;;;qBAwBU,YAAS,iCACW,OACxB,YAAU,UACP,gBACT;;;;;qBAWU,UAAO,yBAAiC;;;;;qBAiBxC,iBAAc,yBAAiC;;qBAyB/C,kBAAkB,eAAe;;;;;YA2ElC,sBAAsB;;qBAoCrB,wBAAsB;;qBAKtB,2BAAwB,kBAAoB;;qBAI5C,wBAAqB,QACxB,wBACP,KAAK;;qBAoDK,wBAAsB;;qBAKtB,2BAAwB,kBAAoB;;KAIpD,qBAAqB,KACxB;;;;;;qBAaW,wBAAqB,sBACZ,sBACA,gCAEnB;;qBAwCU;;;;;qBAoBA,oBAAiB,cACd,wBAAsB;;;;;;qBAkBzB,sBAAmB,cAChB,wBAAsB,kBAEnC;;qBAcU,yBAAsB,iBAEhC;;;;;;qBA0MU,OAAI,sBACK,UACV,aAAW,0BACA"}
+{"version":3,"file":"init.d.ts","names":[],"sources":["../../src/init.ts"],"mappings":";qBA8Ba,kBAAe;;qBAgBf,qBAAkB;;YAInB;;YAgBA;EACV,OAAO;EACP;EACA;;;;;;;qBAQW,mBAAmB;;;;;;;qBAQnB,oBAAoB;;;;;qBAMpB,oBAAoB,OAAO;;;;;;qBAsB3B,yBAAsB,OAC1B,YAAU,cACH,gBACb;;;;;;qBAyBU,YAAS,iCACW,OACxB,YAAU,UACP,gBACT;;;;;qBAWU,UAAO,yBAAiC;;;;;qBAiBxC,iBAAc,yBAAiC;;qBAyB/C,kBAAkB,eAAe;;;;;YAgFlC,sBAAsB;;qBAoCrB,wBAAsB;;qBAKtB,2BAAwB,kBAAoB;;qBAI5C,wBAAqB,QACxB,wBACP,KAAK;;qBAoDK,wBAAsB;;qBAKtB,2BAAwB,kBAAoB;;KAIpD,qBAAqB,KACxB;;;;;;qBAaW,wBAAqB,sBACZ,sBACA,gCAEnB;;qBAwCU;;;;;qBAoBA,oBAAiB,cACd,wBAAsB;;;;qBAgBzB,sBAAmB,cAChB,wBAAsB;;;;;;qBAiBzB,sBAAmB,cAChB,wBAAsB,kBAEnC;;qBAgBU,yBAAsB,iBAEhC;;;;;;qBA0MU,OAAI,sBACK,UACV,aAAW,0BACA"}

package/dist/types/pull.d.ts

@@ -1,13 +1,26 @@
 import { GetConfigurationOptions } from "@intlayer/config/node";
+import { DictionaryStatus } from "@intlayer/engine/build";
 type PullOptions = {
   dictionaries?: string[];
   newDictionariesPath?: string;
   configOptions?: GetConfigurationOptions;
 };
+type DictionariesStatus = {
+  dictionaryKey: string;
+  status: DictionaryStatus | 'pending' | 'fetching' | 'error';
+  error?: Error;
+  errorMessage?: string;
+  /** Content declaration file written for the dictionary */
+  filePath?: string;
+};
+/** Outcome of one dictionary of a pull. */
+export type PulledDictionary = Pick<DictionariesStatus, 'dictionaryKey' | 'status' | 'filePath'>;
 /**
  * Fetch distant dictionaries and write them locally,
  * with progress indicators and concurrency control.
+ *
+ * @returns The outcome of each pulled dictionary (empty when nothing ran).
  */
-export declare const pull: (options?: PullOptions) => Promise<void>;
+export declare const pull: (options?: PullOptions) => Promise<PulledDictionary[]>;
 export {};
 //# sourceMappingURL=pull.d.ts.map

package/dist/types/pull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pull.d.ts","names":[],"sources":["../../src/pull.ts"],"mappings":";KAoBK;EACH;EACA;EACA,gBAAgB;;;;;;qBAcL,OAAI,UAAoB,gBAAc"}
+{"version":3,"file":"pull.d.ts","names":[],"sources":["../../src/pull.ts"],"mappings":";;KAoBK;EACH;EACA;EACA,gBAAgB;;KAGb;EACH;EACA,QAAQ;EACR,QAAQ;EACR;;EAEA;;;YAIU,mBAAmB,KAC7B;;;;;;;qBAUW,OAAI,UACL,gBACT,QAAQ"}

package/dist/types/reviewDoc/reviewDoc.d.ts

@@ -1,7 +1,7 @@
 import { ReviewFileResult } from "./reviewDocSynthesis.js";
 import { GetConfigurationOptions } from "@intlayer/config/node";
-import { AIOptions } from "@intlayer/ai";
 import { ListGitFilesOptions } from "@intlayer/engine/cli";
+import { AIOptions } from "@intlayer/ai";
 import { Locale } from "@intlayer/types/allLocales";
 /**
  * How the review should be run.

package/dist/types/test/listMissingTranslations.d.ts

@@ -1,5 +1,5 @@
-import { IntlayerConfig } from "@intlayer/types/config";
 import { GetConfigurationOptions } from "@intlayer/config/node";
+import { IntlayerConfig } from "@intlayer/types/config";
 import { Locale } from "@intlayer/types/allLocales";
 export declare const listMissingTranslationsWithConfig: (configuration: IntlayerConfig) => {
   missingTranslations: {

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

@@ -1,8 +1,8 @@
 import { AIClient } from "../utils/setupAI.js";
-import { IntlayerConfig } from "@intlayer/types/config";
 import { GetConfigurationOptions } from "@intlayer/config/node";
-import { AIConfig, AIOptions } from "@intlayer/ai";
 import { ListGitFilesOptions } from "@intlayer/engine/cli";
+import { IntlayerConfig } from "@intlayer/types/config";
+import { AIConfig, AIOptions } from "@intlayer/ai";
 import { Locale } from "@intlayer/types/allLocales";
 export type ErrorState = {
   count: number;

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

@@ -1,6 +1,6 @@
-import { IntlayerAPIProxy } from "@intlayer/api";
 import { IntlayerConfig } from "@intlayer/types/config";
 import { AIOptions } from "@intlayer/ai";
+import { IntlayerAPIProxy } from "@intlayer/api";
 export declare const getAuthenticatedAPI: (configuration?: IntlayerConfig) => Promise<IntlayerAPIProxy>;
 export declare const checkCMSAuth: (configuration: IntlayerConfig, shouldCheckConfigConsistency?: boolean, shouldAutoLogin?: boolean) => Promise<boolean>;
 export declare const checkAIAccess: (configuration: IntlayerConfig, aiOptions?: AIOptions, shouldCheckConfigConsistency?: boolean) => Promise<boolean>;

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

@@ -1,5 +1,5 @@
-import { IntlayerAPIProxy } from "@intlayer/api";
 import { IntlayerConfig } from "@intlayer/types/config";
+import { IntlayerAPIProxy } from "@intlayer/api";
 /**
  * Selects the CMS project environment that matches `environmentName`.
  *