@intlayer/cli 9.5.12 → 9.7.0

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

@@ -1 +1 @@
-{"version":3,"file":"translateDictionary.cjs","names":["colon","colorize","ANSIColors","colorizeNumber","getAppLogger","getAuthenticatedAPI","retryManager","getUnmergedDictionaries","getPerLocaleDictionary","colorizePath","basename","getFilterMissingTranslationsDictionary","excludeObjectFormat","formatLocale","chunkJSON","reconstructFromSingleChunk","extractTranslatableContent","verifyIdenticObjectFormat","reinsertTranslatedContent","mergeChunks","deepMergeContent","getMultilingualDictionary","insertContentInDictionary"],"sources":["../../../src/fill/translateDictionary.ts"],"sourcesContent":["import { basename } from 'node:path';\nimport type { AIConfig } from '@intlayer/ai';\nimport type { AIOptions } from '@intlayer/api';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colon,\n  colorize,\n  colorizeNumber,\n  colorizePath,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport { retryManager } from '@intlayer/config/utils';\nimport {\n  getFilterMissingTranslationsDictionary,\n  getMultilingualDictionary,\n  getPerLocaleDictionary,\n  insertContentInDictionary,\n} from '@intlayer/core/plugins';\nimport { getUnmergedDictionaries } from '@intlayer/dictionaries-entry/unmerged';\nimport {\n  chunkJSON,\n  excludeObjectFormat,\n  formatLocale,\n  type JsonChunk,\n  mergeChunks,\n  reconstructFromSingleChunk,\n  verifyIdenticObjectFormat,\n} from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { getAuthenticatedAPI } from '../utils/checkAccess';\nimport type { AIClient } from '../utils/setupAI';\nimport { deepMergeContent } from './deepMergeContent';\nimport {\n  extractTranslatableContent,\n  reinsertTranslatedContent,\n} from './extractTranslatableContent';\nimport type { TranslationTask } from './listTranslationsTasks';\n\ntype TranslateDictionaryResult = TranslationTask & {\n  dictionaryOutput: Dictionary | null;\n};\n\ntype TranslateDictionaryOptions = {\n  mode: 'complete' | 'review';\n  aiOptions?: AIOptions;\n  fillMetadata?: boolean;\n  onHandle?: ReturnType<\n    typeof import('@intlayer/engine/utils').getGlobalLimiter\n  >;\n  onSuccess?: () => void;\n  onError?: (error: unknown) => void;\n  getAbortError?: () => Error | null;\n  aiClient?: AIClient;\n  aiConfig?: AIConfig;\n};\n\nconst createChunkPreset = (chunkIndex: number, totalChunks: number) => {\n  if (totalChunks <= 1) return '';\n  return colon(\n    [\n      colorize('[', ANSIColors.GREY_DARK),\n      colorizeNumber(chunkIndex + 1),\n      colorize(`/${totalChunks}`, ANSIColors.GREY_DARK),\n      colorize(']', ANSIColors.GREY_DARK),\n    ].join(''),\n    { colSize: 5 }\n  );\n};\n\nconst hasMissingMetadata = (dictionary: Dictionary) =>\n  !dictionary.description || !dictionary.title || !dictionary.tags;\n\nconst serializeError = (error: unknown): string => {\n  if (error instanceof Error) {\n    return error.cause\n      ? `${error.message} (cause: ${String(error.cause)})`\n      : error.message;\n  }\n  if (typeof error === 'string') return error;\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n};\n\nconst CHUNK_SIZE = 4000;\nconst GROUP_MAX_RETRY = 2;\nconst MAX_RETRY = 3;\nconst RETRY_DELAY = 1000 * 10; // 10 seconds\n\nconst MAX_FOLLOWING_ERRORS = 10; // 10 errors in a row, hard exit the process\nlet followingErrors = 0;\n\nexport const translateDictionary = async (\n  task: TranslationTask,\n  configuration: IntlayerConfig,\n  options?: TranslateDictionaryOptions\n): Promise<TranslateDictionaryResult> => {\n  const appLogger = getAppLogger(configuration);\n  const intlayerAPI = await getAuthenticatedAPI(configuration);\n\n  const { mode, aiOptions, fillMetadata, aiClient, aiConfig } = {\n    mode: 'complete',\n    fillMetadata: true,\n    ...options,\n  } as const;\n\n  const notifySuccess = () => {\n    followingErrors = 0;\n    options?.onSuccess?.();\n  };\n\n  const result = await retryManager(\n    async () => {\n      const unmergedDictionariesRecord = getUnmergedDictionaries(configuration);\n\n      const baseUnmergedDictionary: Dictionary | undefined =\n        unmergedDictionariesRecord[task.dictionaryKey]?.find(\n          (dict) => dict.localId === task.dictionaryLocalId\n        );\n\n      if (!baseUnmergedDictionary) {\n        appLogger(\n          `${task.dictionaryPreset}Dictionary not found in unmergedDictionariesRecord. Skipping.`,\n          {\n            level: 'warn',\n          }\n        );\n        return { ...task, dictionaryOutput: null };\n      }\n\n      let metadata:\n        | Pick<Dictionary, 'description' | 'title' | 'tags'>\n        | undefined;\n\n      if (\n        fillMetadata &&\n        (hasMissingMetadata(baseUnmergedDictionary) || mode === 'review')\n      ) {\n        const defaultLocaleDictionary = getPerLocaleDictionary(\n          baseUnmergedDictionary,\n          configuration.internationalization.defaultLocale\n        );\n\n        appLogger(\n          `${task.dictionaryPreset} Filling missing metadata for ${colorizePath(basename(baseUnmergedDictionary.filePath!))}`,\n          {\n            level: 'info',\n          }\n        );\n\n        const runAudit = async () => {\n          if (aiClient && aiConfig) {\n            const result = await aiClient.auditDictionaryMetadata({\n              fileContent: JSON.stringify(defaultLocaleDictionary),\n              aiConfig,\n            });\n\n            return {\n              data: result,\n            };\n          }\n\n          return await intlayerAPI.ai.auditContentDeclarationMetadata({\n            fileContent: JSON.stringify(defaultLocaleDictionary),\n            aiOptions,\n          });\n        };\n\n        const metadataResult = options?.onHandle\n          ? await options.onHandle(runAudit)\n          : await runAudit();\n\n        metadata = metadataResult.data?.fileContent;\n      }\n\n      const translatedContentResults = await Promise.all(\n        task.targetLocales.map(async (targetLocale) => {\n          /**\n           * In complete mode, for large dictionaries, we want to filter all content that is already translated\n           *\n           * targetLocale: fr\n           *\n           * { test1: t({ ar: 'Hello', en: 'Hello', fr: 'Bonjour' } }) -> {}\n           * { test2: t({ ar: 'Hello', en: 'Hello' }) } -> { test2: t({ ar: 'Hello', en: 'Hello' }) }\n           *\n           */\n          // Reset to base dictionary for each locale to ensure we filter from the original\n          let dictionaryToProcess = structuredClone(baseUnmergedDictionary);\n\n          let targetLocaleDictionary: Dictionary;\n\n          if (typeof baseUnmergedDictionary.locale === 'string') {\n            // For per-locale files, the content is already in simple JSON format (not translation nodes)\n            // The base dictionary is already the source locale content\n\n            // Look up the target locale dictionary by its locale property.\n            // This handles both directory-based paths (/en/file.json → /es/file.json)\n            // AND filename-based paths (messages_ICU/en.json → messages_ICU/es.json).\n            // Plugins like syncJSON set `dict.locale` correctly, so matching by locale\n            // is the only reliable strategy — path string-replacement fails when the\n            // locale appears in the filename rather than a directory segment.\n            const targetUnmergedDictionary = unmergedDictionariesRecord[\n              task.dictionaryKey\n            ]?.find(\n              (dict) =>\n                dict.locale === targetLocale &&\n                dict.filePath !== baseUnmergedDictionary.filePath\n            );\n\n            // Derive the target file path for the fallback (when the file doesn't exist yet).\n            // Try directory-style first (/en/ → /es/), then filename-style (en.json → es.json).\n            const sourceFilePath = baseUnmergedDictionary.filePath ?? '';\n            const derivedTargetFilePath = sourceFilePath.includes(\n              `/${task.sourceLocale}/`\n            )\n              ? sourceFilePath.replace(\n                  new RegExp(`/${task.sourceLocale}/`, 'g'),\n                  `/${targetLocale}/`\n                )\n              : sourceFilePath.replace(\n                  new RegExp(`(^|/)${task.sourceLocale}(\\\\.[^/]+)$`),\n                  `$1${targetLocale}$2`\n                );\n\n            targetLocaleDictionary = targetUnmergedDictionary ?? {\n              key: baseUnmergedDictionary.key,\n              content: {},\n              filePath: derivedTargetFilePath || undefined,\n              locale: targetLocale,\n            };\n          } else {\n            // For multilingual dictionaries\n            if (mode === 'complete') {\n              // Remove all nodes that don't have any content to translate\n              dictionaryToProcess = getFilterMissingTranslationsDictionary(\n                dictionaryToProcess,\n                targetLocale\n              );\n            }\n\n            dictionaryToProcess = getPerLocaleDictionary(\n              dictionaryToProcess,\n              task.sourceLocale\n            );\n\n            targetLocaleDictionary = getPerLocaleDictionary(\n              baseUnmergedDictionary,\n              targetLocale\n            );\n          }\n\n          // Filter to only untranslated fields, preserving explicit null values as\n          // default-locale fallback markers. Applied after both paths converge so\n          // the same logic covers per-locale and multilingual dictionaries.\n          if (mode === 'complete') {\n            dictionaryToProcess = {\n              ...dictionaryToProcess,\n              content:\n                excludeObjectFormat(\n                  dictionaryToProcess.content,\n                  targetLocaleDictionary.content\n                ) ?? {},\n            };\n          }\n\n          const localePreset = colon(\n            [\n              colorize('[', ANSIColors.GREY_DARK),\n              formatLocale(targetLocale),\n              colorize(']', ANSIColors.GREY_DARK),\n            ].join(''),\n            { colSize: 18 }\n          );\n\n          appLogger(\n            `${task.dictionaryPreset}${localePreset} Preparing ${colorizePath(basename(targetLocaleDictionary.filePath!))}`,\n            {\n              level: 'info',\n            }\n          );\n\n          const chunkedJsonContent: JsonChunk[] = chunkJSON(\n            dictionaryToProcess.content as unknown as Record<string, any>,\n            CHUNK_SIZE\n          );\n\n          const nbOfChunks = chunkedJsonContent.length;\n\n          if (nbOfChunks > 1) {\n            appLogger(\n              `${task.dictionaryPreset}${localePreset} Split into ${colorizeNumber(nbOfChunks)} chunks for translation`,\n              {\n                level: 'info',\n              }\n            );\n          }\n\n          const chunkResult: JsonChunk[] = [];\n\n          // Process chunks in parallel (globally throttled) to allow concurrent translation\n          const chunkPromises = chunkedJsonContent.map(async (chunk) => {\n            const chunkPreset = createChunkPreset(chunk.index, chunk.total);\n\n            if (nbOfChunks > 1) {\n              appLogger(\n                `${task.dictionaryPreset}${localePreset}${chunkPreset} Translating chunk`,\n                {\n                  level: 'info',\n                }\n              );\n            }\n\n            const reconstructedChunk = reconstructFromSingleChunk(chunk);\n            const {\n              extractedContent: chunkExtractedContent,\n              translatableDictionary: chunkTranslatableDictionary,\n            } = extractTranslatableContent(reconstructedChunk);\n\n            const executeTranslation = async () => {\n              return await retryManager(\n                async () => {\n                  let translationResult: any;\n\n                  if (aiClient && aiConfig) {\n                    translationResult = await aiClient.translateJSON({\n                      entryFileContent:\n                        chunkTranslatableDictionary as unknown as JSON,\n                      presetOutputContent: chunkTranslatableDictionary,\n                      dictionaryDescription:\n                        dictionaryToProcess.description ??\n                        metadata?.description ??\n                        '',\n                      entryLocale: task.sourceLocale,\n                      outputLocale: targetLocale,\n                      mode,\n                      aiConfig,\n                    });\n                  } else {\n                    translationResult = await intlayerAPI.ai\n                      .translateJSON({\n                        entryFileContent:\n                          chunkTranslatableDictionary as unknown as JSON,\n                        presetOutputContent: chunkTranslatableDictionary,\n                        dictionaryDescription:\n                          dictionaryToProcess.description ??\n                          metadata?.description ??\n                          '',\n                        entryLocale: task.sourceLocale,\n                        outputLocale: targetLocale,\n                        mode,\n                        aiOptions,\n                      })\n                      .then((result) => result.data);\n                  }\n\n                  if (!translationResult?.fileContent) {\n                    throw new Error('No content result');\n                  }\n\n                  const { isIdentic, error } = verifyIdenticObjectFormat(\n                    translationResult.fileContent,\n                    chunkTranslatableDictionary\n                  );\n\n                  if (!isIdentic) {\n                    throw new Error(\n                      `Translation result does not match expected format: ${error}`\n                    );\n                  }\n\n                  notifySuccess();\n                  return reinsertTranslatedContent(\n                    reconstructedChunk,\n                    chunkExtractedContent,\n                    translationResult.fileContent as Record<number, string>\n                  );\n                },\n                {\n                  maxRetry: MAX_RETRY,\n                  delay: RETRY_DELAY,\n                  onError: ({ error, attempt, maxRetry }) => {\n                    const chunkPreset = createChunkPreset(\n                      chunk.index,\n                      chunk.total\n                    );\n                    appLogger(\n                      `${task.dictionaryPreset}${localePreset}${chunkPreset} ${colorize('Error filling:', ANSIColors.RED)} ${colorize(serializeError(error), ANSIColors.GREY_DARK)} - Attempt ${colorizeNumber(attempt + 1)} of ${colorizeNumber(maxRetry)}`,\n                      {\n                        level: 'error',\n                      }\n                    );\n\n                    followingErrors += 1;\n\n                    if (followingErrors >= MAX_FOLLOWING_ERRORS) {\n                      appLogger(`There is something wrong.`, {\n                        level: 'error',\n                      });\n                      process.exit(1); // 1 for error\n                    }\n                  },\n                }\n              )();\n            };\n\n            const wrapped = options?.onHandle\n              ? options.onHandle(executeTranslation) // queued in global limiter\n              : executeTranslation(); // no global limiter\n\n            return wrapped.then((result) => ({ chunk, result }));\n          });\n\n          // Wait for all chunks for this locale in parallel (still capped by global limiter)\n          const chunkResults = await Promise.all(chunkPromises);\n\n          // Maintain order\n          chunkResults\n            .sort((chunkA, chunkB) => chunkA.chunk.index - chunkB.chunk.index)\n            .forEach(({ result }) => {\n              chunkResult.push(result);\n            });\n\n          // Merge translated chunk contents back into a single content object\n          const reinsertedContent = mergeChunks(chunkResult);\n\n          const merged = {\n            ...dictionaryToProcess,\n            content: reinsertedContent,\n          };\n\n          // Merge newly translated content (including explicit null fallbacks) back\n          // into the existing target locale content. Applies to both per-locale and\n          // multilingual paths so the target always retains previously translated\n          // fields and receives null markers where the source has no translation.\n          const finalContent = deepMergeContent(\n            targetLocaleDictionary.content ?? {},\n            merged.content\n          );\n\n          return [targetLocale, finalContent] as const;\n        })\n      );\n\n      const translatedContent: Partial<Record<Locale, Dictionary['content']>> =\n        Object.fromEntries(translatedContentResults);\n\n      const baseDictionary = baseUnmergedDictionary.locale\n        ? {\n            ...baseUnmergedDictionary,\n            key: baseUnmergedDictionary.key!,\n            content: {},\n          }\n        : baseUnmergedDictionary;\n\n      let dictionaryOutput: Dictionary = {\n        ...getMultilingualDictionary(baseDictionary),\n        locale: undefined, // Ensure the dictionary is multilingual\n        ...metadata,\n      };\n\n      for (const targetLocale of task.targetLocales) {\n        if (translatedContent[targetLocale]) {\n          dictionaryOutput = insertContentInDictionary(\n            dictionaryOutput,\n            translatedContent[targetLocale],\n            targetLocale\n          );\n        }\n      }\n\n      appLogger(\n        `${task.dictionaryPreset} ${colorize('Translation completed successfully', ANSIColors.GREEN)} for ${colorizePath(basename(dictionaryOutput.filePath!))}`,\n        {\n          level: 'info',\n        }\n      );\n\n      // The dict-level `fill` value may have been lost during JSON serialisation\n      // (functions can't be serialised to JSON). Fall back to the config-level\n      // fill so that an explicit fill in intlayer.config.ts is honoured.\n      const effectiveFillForCheck =\n        baseUnmergedDictionary.fill ?? configuration.dictionary?.fill;\n\n      if (\n        baseUnmergedDictionary.locale &&\n        (effectiveFillForCheck === true ||\n          effectiveFillForCheck === undefined) &&\n        baseUnmergedDictionary.location === 'local'\n      ) {\n        const dictionaryFilePath = baseUnmergedDictionary\n          .filePath!.split('.')\n          .slice(0, -1);\n\n        const contentIndex = dictionaryFilePath[dictionaryFilePath.length - 1];\n\n        return JSON.parse(\n          JSON.stringify({\n            ...task,\n            dictionaryOutput: {\n              ...dictionaryOutput,\n              fill: undefined,\n              filled: true,\n            },\n          }).replaceAll(\n            new RegExp(`\\\\.${contentIndex}\\\\.[a-zA-Z0-9]+`, 'g'),\n            `.filled.${contentIndex}.json`\n          )\n        );\n      }\n\n      return {\n        ...task,\n        dictionaryOutput,\n      };\n    },\n    {\n      maxRetry: GROUP_MAX_RETRY,\n      delay: RETRY_DELAY,\n      onError: ({ error, attempt, maxRetry }) =>\n        appLogger(\n          `${task.dictionaryPreset} ${colorize('Error:', ANSIColors.RED)} ${colorize(serializeError(error), ANSIColors.GREY_DARK)} - Attempt ${colorizeNumber(attempt + 1)} of ${colorizeNumber(maxRetry)}`,\n          {\n            level: 'error',\n          }\n        ),\n      onMaxTryReached: ({ error }) =>\n        appLogger(\n          `${task.dictionaryPreset} ${colorize('Maximum number of retries reached:', ANSIColors.RED)} ${colorize(serializeError(error), ANSIColors.GREY_DARK)}`,\n          {\n            level: 'error',\n          }\n        ),\n    }\n  )();\n\n  return result as TranslateDictionaryResult;\n};\n"],"mappings":";;;;;;;;;;;;;;;AA0DA,MAAM,qBAAqB,YAAoB,gBAAwB;CACrE,IAAI,eAAe,GAAG,OAAO;CAC7B,WAAOA,+BACL;MACEC,kCAAS,KAAKC,wBAAW,SAAS;MAClCC,wCAAe,aAAa,CAAC;MAC7BF,kCAAS,IAAI,eAAeC,wBAAW,SAAS;MAChDD,kCAAS,KAAKC,wBAAW,SAAS;CACpC,CAAC,CAAC,KAAK,EAAE,GACT,EAAE,SAAS,EAAE,CACf;AACF;AAEA,MAAM,sBAAsB,eAC1B,CAAC,WAAW,eAAe,CAAC,WAAW,SAAS,CAAC,WAAW;AAE9D,MAAM,kBAAkB,UAA2B;CACjD,IAAI,iBAAiB,OACnB,OAAO,MAAM,QACT,GAAG,MAAM,QAAQ,WAAW,OAAO,MAAM,KAAK,EAAE,KAChD,MAAM;CAEZ,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI;EACF,OAAO,KAAK,UAAU,KAAK;CAC7B,QAAQ;EACN,OAAO,OAAO,KAAK;CACrB;AACF;AAEA,MAAM,aAAa;AACnB,MAAM,kBAAkB;AACxB,MAAM,YAAY;AAClB,MAAM,cAAc;AAEpB,MAAM,uBAAuB;AAC7B,IAAI,kBAAkB;AAEtB,MAAa,sBAAsB,OACjC,MACA,eACA,YACuC;CACvC,MAAM,gBAAYE,sCAAa,aAAa;CAC5C,MAAM,cAAc,MAAMC,8CAAoB,aAAa;CAE3D,MAAM,EAAE,MAAM,WAAW,cAAc,UAAU,aAAa;EAC5D,MAAM;EACN,cAAc;EACd,GAAG;CACL;CAEA,MAAM,sBAAsB;EAC1B,kBAAkB;EAClB,SAAS,YAAY;CACvB;CA0aA,OAAO,UAxacC,qCACnB,YAAY;EACV,MAAM,iCAA6BC,+DAAwB,aAAa;EAExE,MAAM,yBACJ,2BAA2B,KAAK,cAAc,EAAE,MAC7C,SAAS,KAAK,YAAY,KAAK,iBAClC;EAEF,IAAI,CAAC,wBAAwB;GAC3B,UACE,GAAG,KAAK,iBAAiB,gEACzB,EACE,OAAO,OACT,CACF;GACA,OAAO;IAAE,GAAG;IAAM,kBAAkB;GAAK;EAC3C;EAEA,IAAI;EAIJ,IACE,iBACC,mBAAmB,sBAAsB,KAAK,SAAS,WACxD;GACA,MAAM,8BAA0BC,+CAC9B,wBACA,cAAc,qBAAqB,aACrC;GAEA,UACE,GAAG,KAAK,iBAAiB,oCAAgCC,0CAAaC,oBAAS,uBAAuB,QAAS,CAAC,KAChH,EACE,OAAO,OACT,CACF;GAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,YAAY,UAMd,OAAO,EACL,MAAM,MANa,SAAS,wBAAwB;KACpD,aAAa,KAAK,UAAU,uBAAuB;KACnD;IACF,CAAC,EAID;IAGF,OAAO,MAAM,YAAY,GAAG,gCAAgC;KAC1D,aAAa,KAAK,UAAU,uBAAuB;KACnD;IACF,CAAC;GACH;GAMA,YAJuB,SAAS,WAC5B,MAAM,QAAQ,SAAS,QAAQ,IAC/B,MAAM,SAAS,EAEM,CAAC,MAAM;EAClC;EAEA,MAAM,2BAA2B,MAAM,QAAQ,IAC7C,KAAK,cAAc,IAAI,OAAO,iBAAiB;;;;;;;;;;GAW7C,IAAI,sBAAsB,gBAAgB,sBAAsB;GAEhE,IAAI;GAEJ,IAAI,OAAO,uBAAuB,WAAW,UAAU;IAUrD,MAAM,2BAA2B,2BAC/B,KAAK,cACN,EAAE,MACA,SACC,KAAK,WAAW,gBAChB,KAAK,aAAa,uBAAuB,QAC7C;IAIA,MAAM,iBAAiB,uBAAuB,YAAY;IAC1D,MAAM,wBAAwB,eAAe,SAC3C,IAAI,KAAK,aAAa,EACxB,IACI,eAAe,QACb,IAAI,OAAO,IAAI,KAAK,aAAa,IAAI,GAAG,GACxC,IAAI,aAAa,EACnB,IACA,eAAe,QACb,IAAI,OAAO,QAAQ,KAAK,aAAa,YAAY,GACjD,KAAK,aAAa,GACpB;IAEJ,yBAAyB,4BAA4B;KACnD,KAAK,uBAAuB;KAC5B,SAAS,CAAC;KACV,UAAU,yBAAyB;KACnC,QAAQ;IACV;GACF,OAAO;IAEL,IAAI,SAAS,YAEX,0BAAsBC,+DACpB,qBACA,YACF;IAGF,0BAAsBH,+CACpB,qBACA,KAAK,YACP;IAEA,6BAAyBA,+CACvB,wBACA,YACF;GACF;GAKA,IAAI,SAAS,YACX,sBAAsB;IACpB,GAAG;IACH,aACEI,4CACE,oBAAoB,SACpB,uBAAuB,OACzB,KAAK,CAAC;GACV;GAGF,MAAM,mBAAeZ,+BACnB;QACEC,kCAAS,KAAKC,wBAAW,SAAS;QAClCW,qCAAa,YAAY;QACzBZ,kCAAS,KAAKC,wBAAW,SAAS;GACpC,CAAC,CAAC,KAAK,EAAE,GACT,EAAE,SAAS,GAAG,CAChB;GAEA,UACE,GAAG,KAAK,mBAAmB,aAAa,iBAAaO,0CAAaC,oBAAS,uBAAuB,QAAS,CAAC,KAC5G,EACE,OAAO,OACT,CACF;GAEA,MAAM,yBAAkCI,kCACtC,oBAAoB,SACpB,UACF;GAEA,MAAM,aAAa,mBAAmB;GAEtC,IAAI,aAAa,GACf,UACE,GAAG,KAAK,mBAAmB,aAAa,kBAAcX,wCAAe,UAAU,EAAE,0BACjF,EACE,OAAO,OACT,CACF;GAGF,MAAM,cAA2B,CAAC;GAGlC,MAAM,gBAAgB,mBAAmB,IAAI,OAAO,UAAU;IAC5D,MAAM,cAAc,kBAAkB,MAAM,OAAO,MAAM,KAAK;IAE9D,IAAI,aAAa,GACf,UACE,GAAG,KAAK,mBAAmB,eAAe,YAAY,qBACtD,EACE,OAAO,OACT,CACF;IAGF,MAAM,yBAAqBY,mDAA2B,KAAK;IAC3D,MAAM,EACJ,kBAAkB,uBAClB,wBAAwB,gCACtBC,mEAA2B,kBAAkB;IAEjD,MAAM,qBAAqB,YAAY;KACrC,OAAO,UAAMV,qCACX,YAAY;MACV,IAAI;MAEJ,IAAI,YAAY,UACd,oBAAoB,MAAM,SAAS,cAAc;OAC/C,kBACE;OACF,qBAAqB;OACrB,uBACE,oBAAoB,eACpB,UAAU,eACV;OACF,aAAa,KAAK;OAClB,cAAc;OACd;OACA;MACF,CAAC;WAED,oBAAoB,MAAM,YAAY,GACnC,cAAc;OACb,kBACE;OACF,qBAAqB;OACrB,uBACE,oBAAoB,eACpB,UAAU,eACV;OACF,aAAa,KAAK;OAClB,cAAc;OACd;OACA;MACF,CAAC,CAAC,CACD,MAAM,WAAW,OAAO,IAAI;MAGjC,IAAI,CAAC,mBAAmB,aACtB,MAAM,IAAI,MAAM,mBAAmB;MAGrC,MAAM,EAAE,WAAW,cAAUW,kDAC3B,kBAAkB,aAClB,2BACF;MAEA,IAAI,CAAC,WACH,MAAM,IAAI,MACR,sDAAsD,OACxD;MAGF,cAAc;MACd,OAAOC,kEACL,oBACA,uBACA,kBAAkB,WACpB;KACF,GACA;MACE,UAAU;MACV,OAAO;MACP,UAAU,EAAE,OAAO,SAAS,eAAe;OACzC,MAAM,cAAc,kBAClB,MAAM,OACN,MAAM,KACR;OACA,UACE,GAAG,KAAK,mBAAmB,eAAe,YAAY,OAAGjB,kCAAS,kBAAkBC,wBAAW,GAAG,EAAE,OAAGD,kCAAS,eAAe,KAAK,GAAGC,wBAAW,SAAS,EAAE,iBAAaC,wCAAe,UAAU,CAAC,EAAE,UAAMA,wCAAe,QAAQ,KACnO,EACE,OAAO,QACT,CACF;OAEA,mBAAmB;OAEnB,IAAI,mBAAmB,sBAAsB;QAC3C,UAAU,6BAA6B,EACrC,OAAO,QACT,CAAC;QACD,QAAQ,KAAK,CAAC;OAChB;MACF;KACF,CACF,CAAC,CAAC;IACJ;IAMA,QAJgB,SAAS,WACrB,QAAQ,SAAS,kBAAkB,IACnC,mBAAmB,EAET,CAAC,MAAM,YAAY;KAAE;KAAO;IAAO,EAAE;GACrD,CAAC;GAMD,OAH2B,QAAQ,IAAI,aAAa,EAGxC,CACT,MAAM,QAAQ,WAAW,OAAO,MAAM,QAAQ,OAAO,MAAM,KAAK,CAAC,CACjE,SAAS,EAAE,aAAa;IACvB,YAAY,KAAK,MAAM;GACzB,CAAC;GAGH,MAAM,wBAAoBgB,oCAAY,WAAW;GAEjD,MAAM,SAAS;IACb,GAAG;IACH,SAAS;GACX;GAWA,OAAO,CAAC,cALaC,+CACnB,uBAAuB,WAAW,CAAC,GACnC,OAAO,OAGwB,CAAC;EACpC,CAAC,CACH;EAEA,MAAM,oBACJ,OAAO,YAAY,wBAAwB;EAE7C,MAAM,iBAAiB,uBAAuB,SAC1C;GACE,GAAG;GACH,KAAK,uBAAuB;GAC5B,SAAS,CAAC;EACZ,IACA;EAEJ,IAAI,mBAA+B;GACjC,OAAGC,kDAA0B,cAAc;GAC3C,QAAQ;GACR,GAAG;EACL;EAEA,KAAK,MAAM,gBAAgB,KAAK,eAC9B,IAAI,kBAAkB,eACpB,uBAAmBC,kDACjB,kBACA,kBAAkB,eAClB,YACF;EAIJ,UACE,GAAG,KAAK,iBAAiB,OAAGrB,kCAAS,sCAAsCC,wBAAW,KAAK,EAAE,WAAOO,0CAAaC,oBAAS,iBAAiB,QAAS,CAAC,KACrJ,EACE,OAAO,OACT,CACF;EAKA,MAAM,wBACJ,uBAAuB,QAAQ,cAAc,YAAY;EAE3D,IACE,uBAAuB,WACtB,0BAA0B,QACzB,0BAA0B,WAC5B,uBAAuB,aAAa,SACpC;GACA,MAAM,qBAAqB,uBACxB,SAAU,MAAM,GAAG,CAAC,CACpB,MAAM,GAAG,EAAE;GAEd,MAAM,eAAe,mBAAmB,mBAAmB,SAAS;GAEpE,OAAO,KAAK,MACV,KAAK,UAAU;IACb,GAAG;IACH,kBAAkB;KAChB,GAAG;KACH,MAAM;KACN,QAAQ;IACV;GACF,CAAC,CAAC,CAAC,WACD,IAAI,OAAO,MAAM,aAAa,kBAAkB,GAAG,GACnD,WAAW,aAAa,MAC1B,CACF;EACF;EAEA,OAAO;GACL,GAAG;GACH;EACF;CACF,GACA;EACE,UAAU;EACV,OAAO;EACP,UAAU,EAAE,OAAO,SAAS,eAC1B,UACE,GAAG,KAAK,iBAAiB,OAAGT,kCAAS,UAAUC,wBAAW,GAAG,EAAE,OAAGD,kCAAS,eAAe,KAAK,GAAGC,wBAAW,SAAS,EAAE,iBAAaC,wCAAe,UAAU,CAAC,EAAE,UAAMA,wCAAe,QAAQ,KAC9L,EACE,OAAO,QACT,CACF;EACF,kBAAkB,EAAE,YAClB,UACE,GAAG,KAAK,iBAAiB,OAAGF,kCAAS,sCAAsCC,wBAAW,GAAG,EAAE,OAAGD,kCAAS,eAAe,KAAK,GAAGC,wBAAW,SAAS,KAClJ,EACE,OAAO,QACT,CACF;CACJ,CACF,CAAC,CAAC;AAGJ"}
+{"version":3,"file":"translateDictionary.cjs","names":["colon","colorize","ANSIColors","colorizeNumber","getAppLogger","getAuthenticatedAPI","retryManager","getUnmergedDictionaries","getPerLocaleDictionary","colorizePath","basename","getFilterMissingTranslationsDictionary","excludeObjectFormat","formatLocale","chunkJSON","reconstructFromSingleChunk","extractTranslatableContent","verifyIdenticObjectFormat","reinsertTranslatedContent","mergeChunks","deepMergeContent","getMultilingualDictionary","insertContentInDictionary"],"sources":["../../../src/fill/translateDictionary.ts"],"sourcesContent":["import { basename } 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  colorizePath,\n  getAppLogger,\n} from '@intlayer/config/logger';\nimport { retryManager } from '@intlayer/config/utils';\nimport {\n  getFilterMissingTranslationsDictionary,\n  getMultilingualDictionary,\n  getPerLocaleDictionary,\n  insertContentInDictionary,\n} from '@intlayer/core/plugins';\nimport { getUnmergedDictionaries } from '@intlayer/dictionaries-entry/unmerged';\nimport {\n  chunkJSON,\n  excludeObjectFormat,\n  formatLocale,\n  type JsonChunk,\n  mergeChunks,\n  reconstructFromSingleChunk,\n  verifyIdenticObjectFormat,\n} from '@intlayer/engine/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { getAuthenticatedAPI } from '../utils/checkAccess';\nimport type { AIClient } from '../utils/setupAI';\nimport { deepMergeContent } from './deepMergeContent';\nimport {\n  extractTranslatableContent,\n  reinsertTranslatedContent,\n} from './extractTranslatableContent';\nimport type { TranslationTask } from './listTranslationsTasks';\n\ntype TranslateDictionaryResult = TranslationTask & {\n  dictionaryOutput: Dictionary | null;\n};\n\ntype TranslateDictionaryOptions = {\n  mode: 'complete' | 'review';\n  aiOptions?: AIOptions;\n  fillMetadata?: boolean;\n  onHandle?: ReturnType<\n    typeof import('@intlayer/engine/utils').getGlobalLimiter\n  >;\n  onSuccess?: () => void;\n  onError?: (error: unknown) => void;\n  getAbortError?: () => Error | null;\n  aiClient?: AIClient;\n  aiConfig?: AIConfig;\n};\n\nconst createChunkPreset = (chunkIndex: number, totalChunks: number) => {\n  if (totalChunks <= 1) return '';\n  return colon(\n    [\n      colorize('[', ANSIColors.GREY_DARK),\n      colorizeNumber(chunkIndex + 1),\n      colorize(`/${totalChunks}`, ANSIColors.GREY_DARK),\n      colorize(']', ANSIColors.GREY_DARK),\n    ].join(''),\n    { colSize: 5 }\n  );\n};\n\nconst hasMissingMetadata = (dictionary: Dictionary) =>\n  !dictionary.description || !dictionary.title || !dictionary.tags;\n\nconst serializeError = (error: unknown): string => {\n  if (error instanceof Error) {\n    return error.cause\n      ? `${error.message} (cause: ${String(error.cause)})`\n      : error.message;\n  }\n  if (typeof error === 'string') return error;\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n};\n\nconst CHUNK_SIZE = 4000;\nconst GROUP_MAX_RETRY = 2;\nconst MAX_RETRY = 3;\nconst RETRY_DELAY = 1000 * 10; // 10 seconds\n\nconst MAX_FOLLOWING_ERRORS = 10; // 10 errors in a row, hard exit the process\nlet followingErrors = 0;\n\nexport const translateDictionary = async (\n  task: TranslationTask,\n  configuration: IntlayerConfig,\n  options?: TranslateDictionaryOptions\n): Promise<TranslateDictionaryResult> => {\n  const appLogger = getAppLogger(configuration);\n  const intlayerAPI = await getAuthenticatedAPI(configuration);\n\n  const { mode, aiOptions, fillMetadata, aiClient, aiConfig } = {\n    mode: 'complete',\n    fillMetadata: true,\n    ...options,\n  } as const;\n\n  const notifySuccess = () => {\n    followingErrors = 0;\n    options?.onSuccess?.();\n  };\n\n  const result = await retryManager(\n    async () => {\n      const unmergedDictionariesRecord = getUnmergedDictionaries(configuration);\n\n      const baseUnmergedDictionary: Dictionary | undefined =\n        unmergedDictionariesRecord[task.dictionaryKey]?.find(\n          (dict) => dict.localId === task.dictionaryLocalId\n        );\n\n      if (!baseUnmergedDictionary) {\n        appLogger(\n          `${task.dictionaryPreset}Dictionary not found in unmergedDictionariesRecord. Skipping.`,\n          {\n            level: 'warn',\n          }\n        );\n        return { ...task, dictionaryOutput: null };\n      }\n\n      let metadata:\n        | Pick<Dictionary, 'description' | 'title' | 'tags'>\n        | undefined;\n\n      if (\n        fillMetadata &&\n        (hasMissingMetadata(baseUnmergedDictionary) || mode === 'review')\n      ) {\n        const defaultLocaleDictionary = getPerLocaleDictionary(\n          baseUnmergedDictionary,\n          configuration.internationalization.defaultLocale\n        );\n\n        appLogger(\n          `${task.dictionaryPreset} Filling missing metadata for ${colorizePath(basename(baseUnmergedDictionary.filePath!))}`,\n          {\n            level: 'info',\n          }\n        );\n\n        const runAudit = async () => {\n          if (aiClient && aiConfig) {\n            const result = await aiClient.auditDictionaryMetadata({\n              fileContent: JSON.stringify(defaultLocaleDictionary),\n              aiConfig,\n            });\n\n            return {\n              data: result,\n            };\n          }\n\n          return await intlayerAPI.ai.auditContentDeclarationMetadata({\n            fileContent: JSON.stringify(defaultLocaleDictionary),\n            aiOptions,\n          });\n        };\n\n        const metadataResult = options?.onHandle\n          ? await options.onHandle(runAudit)\n          : await runAudit();\n\n        metadata = metadataResult.data?.fileContent;\n      }\n\n      const translatedContentResults = await Promise.all(\n        task.targetLocales.map(async (targetLocale) => {\n          /**\n           * In complete mode, for large dictionaries, we want to filter all content that is already translated\n           *\n           * targetLocale: fr\n           *\n           * { test1: t({ ar: 'Hello', en: 'Hello', fr: 'Bonjour' } }) -> {}\n           * { test2: t({ ar: 'Hello', en: 'Hello' }) } -> { test2: t({ ar: 'Hello', en: 'Hello' }) }\n           *\n           */\n          // Reset to base dictionary for each locale to ensure we filter from the original\n          let dictionaryToProcess = structuredClone(baseUnmergedDictionary);\n\n          let targetLocaleDictionary: Dictionary;\n\n          if (typeof baseUnmergedDictionary.locale === 'string') {\n            // For per-locale files, the content is already in simple JSON format (not translation nodes)\n            // The base dictionary is already the source locale content\n\n            // Look up the target locale dictionary by its locale property.\n            // This handles both directory-based paths (/en/file.json → /es/file.json)\n            // AND filename-based paths (messages_ICU/en.json → messages_ICU/es.json).\n            // Plugins like syncJSON set `dict.locale` correctly, so matching by locale\n            // is the only reliable strategy — path string-replacement fails when the\n            // locale appears in the filename rather than a directory segment.\n            const targetUnmergedDictionary = unmergedDictionariesRecord[\n              task.dictionaryKey\n            ]?.find(\n              (dict) =>\n                dict.locale === targetLocale &&\n                dict.filePath !== baseUnmergedDictionary.filePath\n            );\n\n            // Derive the target file path for the fallback (when the file doesn't exist yet).\n            // Try directory-style first (/en/ → /es/), then filename-style (en.json → es.json).\n            const sourceFilePath = baseUnmergedDictionary.filePath ?? '';\n            const derivedTargetFilePath = sourceFilePath.includes(\n              `/${task.sourceLocale}/`\n            )\n              ? sourceFilePath.replace(\n                  new RegExp(`/${task.sourceLocale}/`, 'g'),\n                  `/${targetLocale}/`\n                )\n              : sourceFilePath.replace(\n                  new RegExp(`(^|/)${task.sourceLocale}(\\\\.[^/]+)$`),\n                  `$1${targetLocale}$2`\n                );\n\n            targetLocaleDictionary = targetUnmergedDictionary ?? {\n              key: baseUnmergedDictionary.key,\n              content: {},\n              filePath: derivedTargetFilePath || undefined,\n              locale: targetLocale,\n            };\n          } else {\n            // For multilingual dictionaries\n            if (mode === 'complete') {\n              // Remove all nodes that don't have any content to translate\n              dictionaryToProcess = getFilterMissingTranslationsDictionary(\n                dictionaryToProcess,\n                targetLocale\n              );\n            }\n\n            dictionaryToProcess = getPerLocaleDictionary(\n              dictionaryToProcess,\n              task.sourceLocale\n            );\n\n            targetLocaleDictionary = getPerLocaleDictionary(\n              baseUnmergedDictionary,\n              targetLocale\n            );\n          }\n\n          // Filter to only untranslated fields, preserving explicit null values as\n          // default-locale fallback markers. Applied after both paths converge so\n          // the same logic covers per-locale and multilingual dictionaries.\n          if (mode === 'complete') {\n            dictionaryToProcess = {\n              ...dictionaryToProcess,\n              content:\n                excludeObjectFormat(\n                  dictionaryToProcess.content,\n                  targetLocaleDictionary.content\n                ) ?? {},\n            };\n          }\n\n          const localePreset = colon(\n            [\n              colorize('[', ANSIColors.GREY_DARK),\n              formatLocale(targetLocale),\n              colorize(']', ANSIColors.GREY_DARK),\n            ].join(''),\n            { colSize: 18 }\n          );\n\n          appLogger(\n            `${task.dictionaryPreset}${localePreset} Preparing ${colorizePath(basename(targetLocaleDictionary.filePath!))}`,\n            {\n              level: 'info',\n            }\n          );\n\n          const chunkedJsonContent: JsonChunk[] = chunkJSON(\n            dictionaryToProcess.content as unknown as Record<string, any>,\n            CHUNK_SIZE\n          );\n\n          const nbOfChunks = chunkedJsonContent.length;\n\n          if (nbOfChunks > 1) {\n            appLogger(\n              `${task.dictionaryPreset}${localePreset} Split into ${colorizeNumber(nbOfChunks)} chunks for translation`,\n              {\n                level: 'info',\n              }\n            );\n          }\n\n          const chunkResult: JsonChunk[] = [];\n\n          // Process chunks in parallel (globally throttled) to allow concurrent translation\n          const chunkPromises = chunkedJsonContent.map(async (chunk) => {\n            const chunkPreset = createChunkPreset(chunk.index, chunk.total);\n\n            if (nbOfChunks > 1) {\n              appLogger(\n                `${task.dictionaryPreset}${localePreset}${chunkPreset} Translating chunk`,\n                {\n                  level: 'info',\n                }\n              );\n            }\n\n            const reconstructedChunk = reconstructFromSingleChunk(chunk);\n            const {\n              extractedContent: chunkExtractedContent,\n              translatableDictionary: chunkTranslatableDictionary,\n            } = extractTranslatableContent(reconstructedChunk);\n\n            const executeTranslation = async () => {\n              return await retryManager(\n                async () => {\n                  let translationResult: any;\n\n                  if (aiClient && aiConfig) {\n                    translationResult = await aiClient.translateJSON({\n                      entryFileContent:\n                        chunkTranslatableDictionary as unknown as JSON,\n                      presetOutputContent: chunkTranslatableDictionary,\n                      dictionaryDescription:\n                        dictionaryToProcess.description ??\n                        metadata?.description ??\n                        '',\n                      entryLocale: task.sourceLocale,\n                      outputLocale: targetLocale,\n                      mode,\n                      aiConfig,\n                    });\n                  } else {\n                    translationResult = await intlayerAPI.ai\n                      .translateJSON({\n                        entryFileContent: chunkTranslatableDictionary,\n                        presetOutputContent: chunkTranslatableDictionary,\n                        dictionaryDescription:\n                          dictionaryToProcess.description ??\n                          metadata?.description ??\n                          '',\n                        entryLocale: task.sourceLocale,\n                        outputLocale: targetLocale,\n                        mode,\n                        aiOptions,\n                      })\n                      .then((result) => result.data);\n                  }\n\n                  if (!translationResult?.fileContent) {\n                    throw new Error('No content result');\n                  }\n\n                  const { isIdentic, error } = verifyIdenticObjectFormat(\n                    translationResult.fileContent,\n                    chunkTranslatableDictionary\n                  );\n\n                  if (!isIdentic) {\n                    throw new Error(\n                      `Translation result does not match expected format: ${error}`\n                    );\n                  }\n\n                  notifySuccess();\n                  return reinsertTranslatedContent(\n                    reconstructedChunk,\n                    chunkExtractedContent,\n                    translationResult.fileContent as Record<number, string>\n                  );\n                },\n                {\n                  maxRetry: MAX_RETRY,\n                  delay: RETRY_DELAY,\n                  onError: ({ error, attempt, maxRetry }) => {\n                    const chunkPreset = createChunkPreset(\n                      chunk.index,\n                      chunk.total\n                    );\n                    appLogger(\n                      `${task.dictionaryPreset}${localePreset}${chunkPreset} ${colorize('Error filling:', ANSIColors.RED)} ${colorize(serializeError(error), ANSIColors.GREY_DARK)} - Attempt ${colorizeNumber(attempt + 1)} of ${colorizeNumber(maxRetry)}`,\n                      {\n                        level: 'error',\n                      }\n                    );\n\n                    followingErrors += 1;\n\n                    if (followingErrors >= MAX_FOLLOWING_ERRORS) {\n                      appLogger(`There is something wrong.`, {\n                        level: 'error',\n                      });\n                      process.exit(1); // 1 for error\n                    }\n                  },\n                }\n              )();\n            };\n\n            const wrapped = options?.onHandle\n              ? options.onHandle(executeTranslation) // queued in global limiter\n              : executeTranslation(); // no global limiter\n\n            return wrapped.then((result) => ({ chunk, result }));\n          });\n\n          // Wait for all chunks for this locale in parallel (still capped by global limiter)\n          const chunkResults = await Promise.all(chunkPromises);\n\n          // Maintain order\n          chunkResults\n            .sort((chunkA, chunkB) => chunkA.chunk.index - chunkB.chunk.index)\n            .forEach(({ result }) => {\n              chunkResult.push(result);\n            });\n\n          // Merge translated chunk contents back into a single content object\n          const reinsertedContent = mergeChunks(chunkResult);\n\n          const merged = {\n            ...dictionaryToProcess,\n            content: reinsertedContent,\n          };\n\n          // Merge newly translated content (including explicit null fallbacks) back\n          // into the existing target locale content. Applies to both per-locale and\n          // multilingual paths so the target always retains previously translated\n          // fields and receives null markers where the source has no translation.\n          const finalContent = deepMergeContent(\n            targetLocaleDictionary.content ?? {},\n            merged.content\n          );\n\n          return [targetLocale, finalContent] as const;\n        })\n      );\n\n      const translatedContent: Partial<Record<Locale, Dictionary['content']>> =\n        Object.fromEntries(translatedContentResults);\n\n      const baseDictionary = baseUnmergedDictionary.locale\n        ? {\n            ...baseUnmergedDictionary,\n            key: baseUnmergedDictionary.key!,\n            content: {},\n          }\n        : baseUnmergedDictionary;\n\n      let dictionaryOutput: Dictionary = {\n        ...getMultilingualDictionary(baseDictionary),\n        locale: undefined, // Ensure the dictionary is multilingual\n        ...metadata,\n      };\n\n      for (const targetLocale of task.targetLocales) {\n        if (translatedContent[targetLocale]) {\n          dictionaryOutput = insertContentInDictionary(\n            dictionaryOutput,\n            translatedContent[targetLocale],\n            targetLocale\n          );\n        }\n      }\n\n      appLogger(\n        `${task.dictionaryPreset} ${colorize('Translation completed successfully', ANSIColors.GREEN)} for ${colorizePath(basename(dictionaryOutput.filePath!))}`,\n        {\n          level: 'info',\n        }\n      );\n\n      // The dict-level `fill` value may have been lost during JSON serialisation\n      // (functions can't be serialised to JSON). Fall back to the config-level\n      // fill so that an explicit fill in intlayer.config.ts is honoured.\n      const effectiveFillForCheck =\n        baseUnmergedDictionary.fill ?? configuration.dictionary?.fill;\n\n      if (\n        baseUnmergedDictionary.locale &&\n        (effectiveFillForCheck === true ||\n          effectiveFillForCheck === undefined) &&\n        baseUnmergedDictionary.location === 'local'\n      ) {\n        const dictionaryFilePath = baseUnmergedDictionary\n          .filePath!.split('.')\n          .slice(0, -1);\n\n        const contentIndex = dictionaryFilePath[dictionaryFilePath.length - 1];\n\n        return JSON.parse(\n          JSON.stringify({\n            ...task,\n            dictionaryOutput: {\n              ...dictionaryOutput,\n              fill: undefined,\n              filled: true,\n            },\n          }).replaceAll(\n            new RegExp(`\\\\.${contentIndex}\\\\.[a-zA-Z0-9]+`, 'g'),\n            `.filled.${contentIndex}.json`\n          )\n        );\n      }\n\n      return {\n        ...task,\n        dictionaryOutput,\n      };\n    },\n    {\n      maxRetry: GROUP_MAX_RETRY,\n      delay: RETRY_DELAY,\n      onError: ({ error, attempt, maxRetry }) =>\n        appLogger(\n          `${task.dictionaryPreset} ${colorize('Error:', ANSIColors.RED)} ${colorize(serializeError(error), ANSIColors.GREY_DARK)} - Attempt ${colorizeNumber(attempt + 1)} of ${colorizeNumber(maxRetry)}`,\n          {\n            level: 'error',\n          }\n        ),\n      onMaxTryReached: ({ error }) =>\n        appLogger(\n          `${task.dictionaryPreset} ${colorize('Maximum number of retries reached:', ANSIColors.RED)} ${colorize(serializeError(error), ANSIColors.GREY_DARK)}`,\n          {\n            level: 'error',\n          }\n        ),\n    }\n  )();\n\n  return result as TranslateDictionaryResult;\n};\n"],"mappings":"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"}

package/dist/cjs/getTargetDictionary.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-let node_path = require("node:path");
 let _intlayer_engine_cli = require("@intlayer/engine/cli");
+let node_path = require("node:path");
 let _intlayer_config_node = require("@intlayer/config/node");
 let _intlayer_dictionaries_entry_unmerged = require("@intlayer/dictionaries-entry/unmerged");
 

package/dist/cjs/index.cjs

@@ -1,4 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_auth_sessionToken = require('./auth/sessionToken.cjs');
+const require_auth_login = require('./auth/login.cjs');
 const require_initChromeExtension = require('./initChromeExtension.cjs');
 const require_initInfra = require('./initInfra.cjs');
 const require_initSkills = require('./initSkills.cjs');
@@ -10,9 +12,12 @@ const require_scan = require('./scan.cjs');
 const require_cli = require('./cli.cjs');
 const require_extract = require('./extract.cjs');
 const require_bundle = require('./bundle.cjs');
+const require_utils_checkConfigConsistency = require('./utils/checkConfigConsistency.cjs');
+const require_utils_checkAccess = require('./utils/checkAccess.cjs');
 const require_test_listMissingTranslations = require('./test/listMissingTranslations.cjs');
 const require_test_test = require('./test/test.cjs');
 const require_fill_fill = require('./fill/fill.cjs');
+const require_IntlayerEventListener = require('./IntlayerEventListener.cjs');
 const require_listContentDeclaration = require('./listContentDeclaration.cjs');
 const require_liveSync = require('./liveSync.cjs');
 const require_pull = require('./pull.cjs');
@@ -24,29 +29,44 @@ const require_translateDoc_translateDoc = require('./translateDoc/translateDoc.c
 
 exports.BROWSER_EXTENSION_OPTIONS = require_initChromeExtension.BROWSER_EXTENSION_OPTIONS;
 exports.CHROME_EXTENSION_URL = require_initChromeExtension.CHROME_EXTENSION_URL;
+exports.CONTENT_LAYOUT_CHOICES = require_init.CONTENT_LAYOUT_CHOICES;
+exports.DEFAULT_INIT_STEPS = require_init.DEFAULT_INIT_STEPS;
 exports.ESLINT_CONFIG_FILES = require_init.ESLINT_CONFIG_FILES;
+exports.EXTENSION_BROWSERS = require_initChromeExtension.EXTENSION_BROWSERS;
+exports.EXTENSION_URL_BY_BROWSER = require_initChromeExtension.EXTENSION_URL_BY_BROWSER;
 exports.INFRA_MODES = require_initInfra.INFRA_MODES;
+exports.INIT_STEP_COMMANDS = require_init.INIT_STEP_COMMANDS;
 exports.INIT_STEP_GROUPS = require_init.INIT_STEP_GROUPS;
 exports.INSTALL_SCRIPT_URL = require_initInfra.INSTALL_SCRIPT_URL;
 exports.INSTALL_SCRIPT_URL_WINDOWS = require_initInfra.INSTALL_SCRIPT_URL_WINDOWS;
+exports.IntlayerEventListener = require_IntlayerEventListener.IntlayerEventListener;
 exports.LOCALE_ROUTING_CHOICES = require_init.LOCALE_ROUTING_CHOICES;
 exports.MOZILLA_EXTENSION_URL = require_initChromeExtension.MOZILLA_EXTENSION_URL;
 exports.OPT_IN_INIT_STEPS = require_init.OPT_IN_INIT_STEPS;
 exports.PLATFORM_OPTIONS = require_initSkills.PLATFORM_OPTIONS;
 exports.build = require_build.build;
 exports.bundle = require_bundle.bundle;
+exports.checkCMSAuth = require_utils_checkAccess.checkCMSAuth;
+exports.checkConfigConsistency = require_utils_checkConfigConsistency.checkConfigConsistency;
+exports.clearCliSessionToken = require_auth_sessionToken.clearCliSessionToken;
 exports.dirname = require_cli.dirname;
 exports.extract = require_extract.extract;
 exports.fill = require_fill_fill.fill;
 exports.findProjectRoot = require_init.findProjectRoot;
-exports.getDetectedPlatform = require_initSkills.getDetectedPlatform;
+exports.getAuthenticatedAPI = require_utils_checkAccess.getAuthenticatedAPI;
+exports.getContentInitOptions = require_init.getContentInitOptions;
+exports.getInitOptionsForSteps = require_init.getInitOptionsForSteps;
 exports.getInitialInitSteps = require_init.getInitialInitSteps;
 exports.getProjectDependencies = require_init.getProjectDependencies;
+exports.getRemoteEditorRunners = require_editor.getRemoteEditorRunners;
 exports.getRoutingInitOptions = require_init.getRoutingInitOptions;
 exports.init = require_init.init;
 exports.initChromeExtension = require_initChromeExtension.initChromeExtension;
+exports.initCms = require_init.initCms;
 exports.initInfra = require_initInfra.initInfra;
+exports.initRepository = require_init.initRepository;
 exports.initSkills = require_initSkills.initSkills;
+exports.initSteps = require_init.initSteps;
 exports.isEslintInstalled = require_init.isEslintInstalled;
 exports.listContentDeclaration = require_listContentDeclaration.listContentDeclaration;
 exports.listContentDeclarationRows = require_listContentDeclaration.listContentDeclarationRows;
@@ -54,12 +74,20 @@ exports.listMissingTranslations = require_test_listMissingTranslations.listMissi
 exports.listMissingTranslationsWithConfig = require_test_listMissingTranslations.listMissingTranslationsWithConfig;
 exports.listProjectsCommand = require_listProjects.listProjectsCommand;
 exports.liveSync = require_liveSync.liveSync;
+exports.login = require_auth_login.login;
+exports.parseContentLayoutChoice = require_init.parseContentLayoutChoice;
+exports.parseExtensionBrowsers = require_initChromeExtension.parseExtensionBrowsers;
 exports.parseInfraMode = require_initInfra.parseInfraMode;
 exports.parseLocaleRoutingChoice = require_init.parseLocaleRoutingChoice;
+exports.parsePlatform = require_initSkills.parsePlatform;
+exports.parseSkills = require_initSkills.parseSkills;
 exports.promptPlatform = require_initSkills.promptPlatform;
 exports.pull = require_pull.pull;
 exports.push = require_push_push.push;
 exports.pushConfig = require_pushConfig.pushConfig;
+exports.readCliSessionToken = require_auth_sessionToken.readCliSessionToken;
+exports.resolvePlatformWithoutPrompt = require_initSkills.resolvePlatformWithoutPrompt;
+exports.resolveProjectRoot = require_init.resolveProjectRoot;
 exports.reviewDoc = require_reviewDoc_reviewDoc.reviewDoc;
 exports.scan = require_scan.scan;
 exports.searchDoc = require_searchDoc.searchDoc;

package/dist/cjs/init.cjs

@@ -1,13 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_auth_login = require('./auth/login.cjs');
+const require_auth_setupRepository = require('./auth/setupRepository.cjs');
 const require_loadPrompts = require('./loadPrompts.cjs');
+const require_utils_isInteractiveTerminal = require('./utils/isInteractiveTerminal.cjs');
+const require_utils_parseChoice = require('./utils/parseChoice.cjs');
 const require_initChromeExtension = require('./initChromeExtension.cjs');
 const require_initInfra = require('./initInfra.cjs');
 const require_initSkills = require('./initSkills.cjs');
+const require_utils_detectGitRepository = require('./utils/detectGitRepository.cjs');
 const require_initMCP = require('./initMCP.cjs');
-let node_path = require("node:path");
 let _intlayer_engine_cli = require("@intlayer/engine/cli");
 let node_fs = require("node:fs");
+let node_path = require("node:path");
 
 //#region src/init.ts
 const findProjectRoot = (startDir) => {
@@ -18,12 +22,94 @@ const findProjectRoot = (startDir) => {
 	}
 	return startDir;
 };
+/** Resolves the project root from `--project-root`, else the working directory. */
+const resolveProjectRoot = (projectRoot) => findProjectRoot(projectRoot ? (0, node_path.resolve)(projectRoot) : process.cwd());
 /**
 * Steps shown but not pre-selected. The infrastructure installer touches the
 * machine (downloads an app, pulls Docker images) and browser extensions open external URLs
 * rather than modifying the project, so they must be an explicit choice.
 */
 const OPT_IN_INIT_STEPS = ["infra", "chromeExtension"];
+/**
+* Steps run by `intlayer init` without `--interactive`: install the packages
+* and set up the framework. Every other step has its own command
+* ({@link INIT_STEP_COMMANDS}), so nothing outside the app code is touched
+* unless asked for.
+*/
+const DEFAULT_INIT_STEPS = ["packages", "projectSetup"];
+/**
+* Command running each interactive step on its own, without prompts when every
+* value is passed as a flag. Printed when `--interactive` has no terminal.
+*/
+const INIT_STEP_COMMANDS = {
+	packages: "intlayer init packages",
+	projectSetup: "intlayer init project [--routing <routing>] [--content <layout>] [--content-format <format>] [--message-format <format>]",
+	githubActions: "intlayer init github-actions",
+	vscodeExtension: "intlayer init vscode-extension",
+	eslint: "intlayer init eslint",
+	chromeExtension: "intlayer init extension [--browser <chrome|firefox>]",
+	skills: "intlayer init skills [--platform <platform>] [--skills <skills...>]",
+	mcp: "intlayer init mcp [--platform <platform>] [--transport <stdio|sse>]",
+	lsp: "intlayer init lsp",
+	cms: "intlayer init cms",
+	repository: "intlayer init repository",
+	infra: "intlayer init infra --mode <desktop|docker|compose>"
+};
+/**
+* Maps setup steps to the {@link initIntlayer} options: every step handled by
+* `initIntlayer` that is not listed is skipped. Explicit `--no-*` flags in
+* `baseOptions` still win over a listed step.
+*/
+const getInitOptionsForSteps = (steps, baseOptions) => ({
+	...baseOptions,
+	noInstallPackages: baseOptions?.noInstallPackages || !steps.includes("packages"),
+	noGitignore: baseOptions?.noGitignore || !steps.includes("projectSetup"),
+	noGithubActions: baseOptions?.noGithubActions || !steps.includes("githubActions"),
+	noFrameworkSetup: baseOptions?.noFrameworkSetup || !steps.includes("projectSetup"),
+	noVscodeExtension: baseOptions?.noVscodeExtension || !steps.includes("vscodeExtension"),
+	noLsp: baseOptions?.noLsp || !steps.includes("lsp"),
+	noEslint: baseOptions?.noEslint || !steps.includes("eslint"),
+	skipFinalMessage: baseOptions?.skipFinalMessage || !steps.includes("projectSetup")
+});
+/**
+* Runs the given {@link initIntlayer} steps only (packages, project setup, CI,
+* VS Code extension, LSP, lint rules). Backs `intlayer init` and its
+* single-step subcommands.
+*/
+const initSteps = async (projectRoot, steps, options) => {
+	await (0, _intlayer_engine_cli.initIntlayer)(resolveProjectRoot(projectRoot), getInitOptionsForSteps(steps, options));
+};
+/**
+* Logs in to the Intlayer CMS through the browser, then stores the access-key
+* credentials in `.env` and enables the editor in the config file.
+*/
+const initCms = async (projectRoot) => {
+	const root = resolveProjectRoot(projectRoot);
+	(await require_loadPrompts.loadPrompts()).log.info("Opening your browser to log in to the Intlayer CMS...");
+	await require_auth_login.login({
+		exitAfter: false,
+		onCredentials: (credentials) => (0, _intlayer_engine_cli.setupCmsCredentials)(root, credentials)
+	});
+};
+/**
+* Connects the git repository of the project to its CMS project (and sets
+* its build settings) in the browser, pre-filled with the `origin` remote.
+*/
+const initRepository = async (projectRoot) => {
+	const root = resolveProjectRoot(projectRoot);
+	const p = await require_loadPrompts.loadPrompts();
+	const detectedRepository = require_utils_detectGitRepository.detectGitRepository(root);
+	p.log.info(detectedRepository ? `Detected repository: ${detectedRepository.provider} ${detectedRepository.owner}/${detectedRepository.repository}` : "No supported git remote detected: pick the repository in the browser.");
+	p.log.info("Opening your browser to connect the repository...");
+	await require_auth_setupRepository.setupRepository({ detectedRepository });
+};
+/** Explains why `--interactive` cannot run, and what to run instead. */
+const getNoTerminalMessage = () => [
+	"`intlayer init --interactive` needs a terminal to answer its prompts (none is attached, e.g. when run by an AI agent or in CI).",
+	"Run the steps directly instead:",
+	"  intlayer init    (installs the packages and sets up the framework)",
+	...Object.values(INIT_STEP_COMMANDS).map((command) => `  ${command}`)
+].join("\n");
 /** Grouped checkbox entries of the interactive init flow, in display order. */
 const INIT_STEP_GROUPS = {
 	Codebase: [
@@ -77,15 +163,23 @@ const INIT_STEP_GROUPS = {
 			hint: "go-to-definition from keys to .content files"
 		}
 	],
-	CMS: [{
-		value: "cms",
-		label: "CMS",
-		hint: "log in through your browser, then store the credentials in your .env"
-	}, {
-		value: "infra",
-		label: "Infrastructure (desktop app / self-hosting)",
-		hint: "install the desktop app, or self-host with Docker (all-in-one or Compose)"
-	}]
+	CMS: [
+		{
+			value: "cms",
+			label: "CMS",
+			hint: "log in through your browser, then store the credentials in your .env"
+		},
+		{
+			value: "repository",
+			label: "Git repository",
+			hint: "connect the git repository to the CMS project and set its build settings (GitHub, GitLab, Bitbucket, Codeberg, Gitee)"
+		},
+		{
+			value: "infra",
+			label: "Infrastructure (desktop app / self-hosting)",
+			hint: "install the desktop app, or self-host with Docker (all-in-one or Compose)"
+		}
+	]
 };
 /** Locale routing strategies offered by the interactive init flow. */
 const ROUTING_OPTIONS = [
@@ -118,11 +212,7 @@ const ROUTING_OPTIONS = [
 /** Locale routing choices accepted by `--routing`. */
 const LOCALE_ROUTING_CHOICES = ROUTING_OPTIONS.map((option) => option.value);
 /** Validates a `--routing` value, throwing on an unknown choice. */
-const parseLocaleRoutingChoice = (value) => {
-	const choice = LOCALE_ROUTING_CHOICES.find((routing) => routing === value);
-	if (!choice) throw new Error(`Invalid --routing value "${value}". Expected one of: ${LOCALE_ROUTING_CHOICES.join(", ")}.`);
-	return choice;
-};
+const parseLocaleRoutingChoice = (value) => require_utils_parseChoice.parseChoice(value, LOCALE_ROUTING_CHOICES, "--routing");
 /** Maps a routing choice to the init options it sets. */
 const getRoutingInitOptions = (choice) => choice === "none" ? {
 	routingMode: "no-prefix",
@@ -131,6 +221,83 @@ const getRoutingInitOptions = (choice) => choice === "none" ? {
 	routingMode: choice,
 	enableProxy: true
 };
+/** Content declaration layouts offered by the interactive init flow. */
+const CONTENT_LAYOUT_OPTIONS = [
+	{
+		value: "multilingual",
+		label: "Multilingual content declaration",
+		hint: "/**/{fileName}.content.{ts,json} — every locale in one file"
+	},
+	{
+		value: "per-locale",
+		label: "Per-locale content declaration",
+		hint: "/**/{fileName}.{locale}.content.{ts,json}"
+	},
+	{
+		value: "centralized",
+		label: "Centralized",
+		hint: "/locales/{locale}.{json,po}"
+	},
+	{
+		value: "namespaces",
+		label: "Namespaces",
+		hint: "/locales/{locale}/{namespace}.{json,po}"
+	}
+];
+/** Labels of the content formats offered by the interactive init flow. */
+const CONTENT_FORMAT_LABELS = {
+	ts: "TypeScript (.ts)",
+	json: "JSON (.json)",
+	po: "Gettext (.po)"
+};
+/** Labels of the JSON catalog message formats, in display order. */
+const CATALOG_MESSAGE_FORMAT_OPTIONS = {
+	icu: {
+		label: "ICU",
+		hint: "{count, plural, one {# item} other {# items}}"
+	},
+	i18next: {
+		label: "i18next",
+		hint: "{{count}} item, key_one / key_other"
+	},
+	"vue-i18n": {
+		label: "vue-i18n",
+		hint: "{count} item | {count} items"
+	},
+	intlayer: {
+		label: "Intlayer",
+		hint: "Intlayer dictionary content"
+	}
+};
+/** Content layouts accepted by `--content`. */
+const CONTENT_LAYOUT_CHOICES = CONTENT_LAYOUT_OPTIONS.map((option) => option.value);
+/** Validates a `--content` value, throwing on an unknown layout. */
+const parseContentLayoutChoice = (value) => require_utils_parseChoice.parseChoice(value, CONTENT_LAYOUT_CHOICES, "--content");
+/** Whether a layout + format pair produces a JSON catalog (sync plugin). */
+const isJsonCatalog = (layout, format) => (layout === "centralized" || layout === "namespaces") && format === "json";
+/**
+* Validates `--content` / `--content-format` / `--message-format` and maps
+* them to the init options. The format must be one the layout accepts, and the
+* message format only applies to JSON catalogs.
+*/
+const getContentInitOptions = (layoutValue, formatValue, messageFormatValue) => {
+	if (!layoutValue) {
+		if (formatValue || messageFormatValue) throw new Error("--content-format and --message-format require --content.");
+		return {};
+	}
+	const contentLayout = parseContentLayoutChoice(layoutValue);
+	const contentFormat = formatValue ? require_utils_parseChoice.parseChoice(formatValue, _intlayer_engine_cli.CONTENT_FORMATS_BY_LAYOUT[contentLayout], "--content-format") : void 0;
+	if (!messageFormatValue) return {
+		contentLayout,
+		contentFormat
+	};
+	if (!isJsonCatalog(contentLayout, contentFormat ?? "json")) throw new Error("--message-format only applies to JSON catalogs (--content centralized | namespaces with json).");
+	return {
+		contentLayout,
+		contentFormat,
+		contentMessageFormat: require_utils_parseChoice.parseChoice(messageFormatValue, _intlayer_engine_cli.CATALOG_MESSAGE_FORMATS, "--message-format")
+	};
+};
 /** Known ESLint and oxlint configuration file names. */
 const ESLINT_CONFIG_FILES = [
 	"eslint.config.js",
@@ -222,52 +389,110 @@ const runInteractiveInit = async (root, baseOptions) => {
 		}
 		routingOptions = getRoutingInitOptions(selectedRouting);
 	}
+	let contentOptions = {};
+	if (steps.includes("projectSetup") && baseOptions?.contentLayout === void 0 && !hasCompatLib) {
+		const contentLayout = await p.select({
+			message: "How do you want to declare your content?",
+			options: CONTENT_LAYOUT_OPTIONS,
+			initialValue: "multilingual"
+		});
+		if (p.isCancel(contentLayout)) {
+			p.cancel("Operation cancelled.");
+			return;
+		}
+		const acceptedFormats = _intlayer_engine_cli.CONTENT_FORMATS_BY_LAYOUT[contentLayout];
+		const hasTypeScript = (0, node_fs.existsSync)((0, node_path.join)(root, "tsconfig.json"));
+		const contentFormat = await p.select({
+			message: "Which format for your content?",
+			options: acceptedFormats.map((format) => ({
+				value: format,
+				label: CONTENT_FORMAT_LABELS[format]
+			})),
+			initialValue: acceptedFormats.includes("ts") && !hasTypeScript ? "json" : acceptedFormats[0]
+		});
+		if (p.isCancel(contentFormat)) {
+			p.cancel("Operation cancelled.");
+			return;
+		}
+		contentOptions = {
+			contentLayout,
+			contentFormat
+		};
+		if (isJsonCatalog(contentLayout, contentFormat)) {
+			const contentMessageFormat = await p.select({
+				message: "Which message format do your JSON catalogs use?",
+				options: _intlayer_engine_cli.CATALOG_MESSAGE_FORMATS.map((messageFormat) => ({
+					value: messageFormat,
+					...CATALOG_MESSAGE_FORMAT_OPTIONS[messageFormat]
+				})),
+				initialValue: _intlayer_engine_cli.CATALOG_MESSAGE_FORMATS[0]
+			});
+			if (p.isCancel(contentMessageFormat)) {
+				p.cancel("Operation cancelled.");
+				return;
+			}
+			contentOptions = {
+				...contentOptions,
+				contentMessageFormat
+			};
+		}
+	}
 	const options = {
-		...baseOptions,
-		...routingOptions,
-		noInstallPackages: !steps.includes("packages"),
-		noGitignore: baseOptions?.noGitignore || !steps.includes("projectSetup"),
-		noGithubActions: baseOptions?.noGithubActions || !steps.includes("githubActions"),
-		noFrameworkSetup: baseOptions?.noFrameworkSetup || !steps.includes("projectSetup"),
-		noVscodeExtension: !steps.includes("vscodeExtension"),
-		noLsp: !steps.includes("lsp"),
-		noEslint: !steps.includes("eslint"),
+		...getInitOptionsForSteps(steps, {
+			...baseOptions,
+			...routingOptions,
+			...contentOptions
+		}),
 		skipFinalMessage: true
 	};
 	const { guideUrl } = await (0, _intlayer_engine_cli.initIntlayer)(root, options);
 	const skillsPlatform = steps.includes("skills") ? await require_initSkills.initSkills(root) : void 0;
-	if (steps.includes("mcp")) await require_initMCP.initMCP(root, skillsPlatform);
+	if (steps.includes("mcp")) await require_initMCP.initMCP(root, { platform: skillsPlatform });
 	if (steps.includes("infra")) await require_initInfra.initInfra();
 	if (steps.includes("chromeExtension")) await require_initChromeExtension.initChromeExtension();
-	if (steps.includes("cms")) {
-		p.log.info("Opening your browser to log in to the Intlayer CMS...");
-		await require_auth_login.login({
-			exitAfter: false,
-			onCredentials: (credentials) => (0, _intlayer_engine_cli.setupCmsCredentials)(root, credentials)
-		});
-	}
+	if (steps.includes("cms")) await initCms(root);
+	if (steps.includes("repository")) await initRepository(root);
 	p.outro("Intlayer initialization complete");
 	if (guideUrl) (0, _intlayer_engine_cli.logInitSuccessMessage)(guideUrl);
 };
+/**
+* `intlayer init`: installs the packages and sets up the framework, or, with
+* `interactive`, lets the user pick every setup step. `--interactive` needs a
+* terminal; without one it fails and lists the single-step commands instead.
+*/
 const init = async (projectRoot, options, interactive) => {
-	const root = projectRoot ? findProjectRoot((0, node_path.resolve)(projectRoot)) : findProjectRoot(process.cwd());
-	if (interactive) {
-		await runInteractiveInit(root, options);
+	if (!interactive) {
+		await initSteps(projectRoot, DEFAULT_INIT_STEPS, options);
+		return;
+	}
+	if (!require_utils_isInteractiveTerminal.isInteractiveTerminal()) {
+		(await require_loadPrompts.loadPrompts()).log.error(getNoTerminalMessage());
+		process.exitCode = 1;
 		return;
 	}
-	await (0, _intlayer_engine_cli.initIntlayer)(root, options);
+	await runInteractiveInit(resolveProjectRoot(projectRoot), options);
 };
 
 //#endregion
+exports.CONTENT_LAYOUT_CHOICES = CONTENT_LAYOUT_CHOICES;
+exports.DEFAULT_INIT_STEPS = DEFAULT_INIT_STEPS;
 exports.ESLINT_CONFIG_FILES = ESLINT_CONFIG_FILES;
+exports.INIT_STEP_COMMANDS = INIT_STEP_COMMANDS;
 exports.INIT_STEP_GROUPS = INIT_STEP_GROUPS;
 exports.LOCALE_ROUTING_CHOICES = LOCALE_ROUTING_CHOICES;
 exports.OPT_IN_INIT_STEPS = OPT_IN_INIT_STEPS;
 exports.findProjectRoot = findProjectRoot;
+exports.getContentInitOptions = getContentInitOptions;
+exports.getInitOptionsForSteps = getInitOptionsForSteps;
 exports.getInitialInitSteps = getInitialInitSteps;
 exports.getProjectDependencies = getProjectDependencies;
 exports.getRoutingInitOptions = getRoutingInitOptions;
 exports.init = init;
+exports.initCms = initCms;
+exports.initRepository = initRepository;
+exports.initSteps = initSteps;
 exports.isEslintInstalled = isEslintInstalled;
+exports.parseContentLayoutChoice = parseContentLayoutChoice;
 exports.parseLocaleRoutingChoice = parseLocaleRoutingChoice;
+exports.resolveProjectRoot = resolveProjectRoot;
 //# sourceMappingURL=init.cjs.map