@intlayer/engine 9.5.9 → 9.5.11

package/dist/esm/init/utils/packageManager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"packageManager.mjs","names":[],"sources":["../../../../src/init/utils/packageManager.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\n\n/** Package managers supported for dependency installation. */\nexport type PackageManager = 'bun' | 'pnpm' | 'yarn' | 'npm';\n\n/**\n * Configuration for the syncJSON plugin injected into intlayer.config\n * when a compat i18n library is detected.\n */\nexport type CompatSyncConfig = {\n  /**\n   * Which sync plugin ingests the catalogs:\n   * - `'json'` → `syncJSON` from `@intlayer/sync-json-plugin` (default).\n   * - `'po'`   → `syncPO` from `@intlayer/sync-po-plugin` (lingui's default\n   *   format).\n   */\n  plugin?: 'json' | 'po';\n  /**\n   * JSON format matching the compat library's conventions. Ignored when\n   * `plugin` is `'po'` (PO catalogs are always serialized as gettext).\n   */\n  format: 'icu' | 'i18next' | 'vue-i18n';\n  /**\n   * Source path template using ${locale} and ${key} placeholders.\n   * Rendered as a template literal in the generated config.\n   */\n  sourceTemplate: string;\n  /**\n   * Force `splitKeys: true` in the generated `syncJSON(...)` call so each\n   * top-level key of a single per-locale file becomes its own dictionary.\n   *\n   * Set for libraries whose single `messages/${locale}.json` file groups\n   * namespaces by its first-level keys (`next-intl` / `use-intl`, where\n   * `useTranslations('Hero')` resolves to the `Hero` dictionary). Left\n   * undefined for libraries whose top-level keys are plain message keys\n   * (e.g. `i18next`, `react-intl`); for those, syncJSON's auto-detection\n   * (split only when the source has no `${key}` segment) stays in control.\n   *\n   * Only meaningful for flat templates (no `${key}` segment); it is dropped\n   * automatically when the resolved template addresses one namespace per file.\n   */\n  splitKeys?: boolean;\n};\n\n/**\n * Configuration for injecting a compat vite plugin into vite.config.\n * The plugin replaces the generic `intlayer` plugin for libraries that\n * require alias injection (e.g. `vue-i18n` → `@intlayer/vue-i18n`).\n */\nexport type CompatVitePluginConfig = {\n  /** Exported function name from the plugin package, e.g. `'vueI18nVitePlugin'`. */\n  pluginFunctionName: string;\n  /** Import path for the plugin package, e.g. `'@intlayer/vue-i18n/plugin'`. */\n  pluginPackageSource: string;\n  /**\n   * Set when the compat plugin is a drop-in replacement for an i18n library's\n   * own Vite plugin (e.g. lingui ships `@lingui/vite-plugin`). When the original\n   * import is present, init rewrites only that import's module source to\n   * `pluginPackageSource` — keeping the binding and its call site — instead of\n   * injecting a second import and appending another plugin to the array.\n   */\n  replacesVitePlugin?: {\n    /** Imported binding to keep, e.g. `'lingui'`. */\n    importName: string;\n    /** Original package source to rewrite, e.g. `'@lingui/vite-plugin'`. */\n    fromPackageSource: string;\n  };\n};\n\n/** Result of analyzing project dependencies for intlayer package gaps. */\nexport type IntlayerPackageAnalysis = {\n  /** Intlayer packages that are referenced but not yet installed. */\n  packagesToInstall: string[];\n  /** Intlayer dev packages that are referenced but not yet installed. */\n  devPackagesToInstall: string[];\n  /** Compat packages in dependencies that got replaced and should be moved to devDependencies. */\n  packagesToMoveToDev: string[];\n  /**\n   * syncJSON plugin configuration to inject when a compat i18n library is\n   * detected. Undefined when no compat library is present or format is not\n   * yet implemented.\n   */\n  compatSyncConfig: CompatSyncConfig | undefined;\n  /**\n   * Vite config plugin to inject when a vite-based compat library is\n   * detected. Undefined for Next.js/Nuxt-only compat libs or when no compat\n   * library requires alias injection.\n   */\n  compatVitePluginConfig: CompatVitePluginConfig | undefined;\n};\n\n/** Lock files revealing the package manager, in detection priority order. */\nconst LOCK_FILE_PACKAGE_MANAGERS: ReadonlyArray<\n  readonly [lockFile: string, packageManager: PackageManager]\n> = [\n  ['bun.lock', 'bun'],\n  ['bun.lockb', 'bun'],\n  ['pnpm-lock.yaml', 'pnpm'],\n  ['yarn.lock', 'yarn'],\n  ['package-lock.json', 'npm'],\n];\n\n/** Package managers accepted in the `packageManager` field of `package.json`. */\nconst PACKAGE_MANAGERS: readonly PackageManager[] = [\n  'bun',\n  'pnpm',\n  'yarn',\n  'npm',\n];\n\n/**\n * Reads the package manager pinned by the `packageManager` field of the\n * `package.json` in `directory` (e.g. `\"pnpm@9.0.0\"`), if any.\n */\nconst readPackageManagerField = (directory: string): PackageManager | null => {\n  try {\n    const { packageManager } = JSON.parse(\n      readFileSync(join(directory, 'package.json'), 'utf8')\n    ) as { packageManager?: unknown };\n\n    if (typeof packageManager !== 'string') return null;\n\n    const name = packageManager.split('@')[0] as PackageManager;\n    return PACKAGE_MANAGERS.includes(name) ? name : null;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Detects the package manager in use by checking for lock files in the\n * project root, then the `packageManager` field of its `package.json`. Falls\n * back to npm when neither is found.\n */\nexport const detectPackageManager = (rootDir: string): PackageManager =>\n  LOCK_FILE_PACKAGE_MANAGERS.find(([lockFile]) =>\n    existsSync(join(rootDir, lockFile))\n  )?.[1] ??\n  readPackageManagerField(rootDir) ??\n  'npm';\n\n/**\n * Walks up from `startDir` to the nearest directory holding a lock file — the\n * workspace root an install must run from. Stops at the repository root\n * (`.git`) and returns `null` when no lock file is found.\n */\nexport const findLockFileDir = (startDir: string): string | null => {\n  let currentDir = resolve(startDir);\n\n  while (true) {\n    const hasLockFile = LOCK_FILE_PACKAGE_MANAGERS.some(([lockFile]) =>\n      existsSync(join(currentDir, lockFile))\n    );\n    if (hasLockFile) return currentDir;\n    if (existsSync(join(currentDir, '.git'))) return null;\n\n    const parentDir = dirname(currentDir);\n    if (parentDir === currentDir) return null;\n    currentDir = parentDir;\n  }\n};\n\n/**\n * Returns the install command for the given package manager and package list.\n */\nconst buildInstallCommand = (\n  packageManager: PackageManager,\n  packages: string[],\n  isDev: boolean = false\n): string => {\n  const packageList = packages.join(' ');\n  switch (packageManager) {\n    case 'bun':\n      return `bun add ${isDev ? '-d ' : ''}${packageList}`;\n    case 'pnpm':\n      return `pnpm add ${isDev ? '-D ' : ''}${packageList}`;\n    case 'yarn':\n      return `yarn add ${isDev ? '-D ' : ''}${packageList}`;\n    case 'npm':\n      return `npm install ${isDev ? '-D ' : ''}${packageList}`;\n  }\n};\n\n/**\n * Analyzes existing project dependencies to determine which intlayer packages\n * are missing and what syncJSON configuration to inject when compat i18n\n * libraries are present.\n */\n/** Extra signals (from a filesystem scan) that refine compat detection. */\nexport type DetectMissingPackagesOptions = {\n  /**\n   * Catalog format detected for a lingui project (`'po'` or `'json'`), or\n   * `null`/undefined when none was found. Decides which sync plugin + dev\n   * dependency the lingui compat setup uses.\n   */\n  linguiCatalogFormat?: 'po' | 'json' | null;\n  /**\n   * The project's runtime dependencies (from `package.json` `dependencies`).\n   * When provided, compat packages found here that are replaced by `@intlayer/*`\n   * are reported in `packagesToMoveToDev`.\n   */\n  dependencies?: Record<string, string>;\n  /**\n   * The project's development dependencies (from `package.json` `devDependencies`).\n   */\n  devDependencies?: Record<string, string>;\n};\n\n/** An existing i18n library Intlayer ships a compat adapter for. */\nexport type CompatI18nLibrary = {\n  /** Human-readable name, used to report the detection back to the user. */\n  label: string;\n  /**\n   * Dependency names that reveal the library — both the upstream packages and\n   * the Intlayer adapters, so a project that already ran `init` is still\n   * recognized.\n   */\n  packages: readonly string[];\n  /**\n   * Upstream third-party packages replaced by Intlayer compat adapters at runtime,\n   * mapped to their adapter package name.\n   */\n  replacements: Record<string, string>;\n};\n\n/**\n * Existing i18n libraries Intlayer can adapt, keyed by the dependencies that\n * reveal them. Mirrors the compat branches of\n * {@link detectMissingIntlayerPackages}: a library listed here is one that\n * detection will wire up on its own once its package is in `package.json`.\n */\nexport const COMPAT_I18N_LIBRARIES: readonly CompatI18nLibrary[] = [\n  {\n    label: 'i18next / react-i18next',\n    packages: [\n      'i18next',\n      'react-i18next',\n      '@intlayer/i18next',\n      '@intlayer/react-i18next',\n    ],\n    replacements: {\n      i18next: '@intlayer/i18next',\n      'react-i18next': '@intlayer/react-i18next',\n    },\n  },\n  {\n    label: 'next-intl / use-intl',\n    packages: [\n      'next-intl',\n      'use-intl',\n      '@intlayer/next-intl',\n      '@intlayer/use-intl',\n    ],\n    replacements: {\n      'next-intl': '@intlayer/next-intl',\n      'use-intl': '@intlayer/use-intl',\n    },\n  },\n  {\n    label: 'vue-i18n',\n    packages: ['vue-i18n', '@intlayer/vue-i18n'],\n    replacements: {\n      'vue-i18n': '@intlayer/vue-i18n',\n    },\n  },\n  {\n    label: '@nuxtjs/i18n',\n    packages: ['@nuxtjs/i18n', '@intlayer/nuxtjs-i18n'],\n    replacements: {\n      '@nuxtjs/i18n': '@intlayer/nuxtjs-i18n',\n    },\n  },\n  {\n    label: 'next-i18next',\n    packages: ['next-i18next', '@intlayer/next-i18next'],\n    replacements: {\n      'next-i18next': '@intlayer/next-i18next',\n    },\n  },\n  {\n    label: 'next-translate',\n    packages: ['next-translate', '@intlayer/next-translate'],\n    replacements: {\n      'next-translate': '@intlayer/next-translate',\n    },\n  },\n  {\n    label: 'react-intl',\n    packages: ['react-intl', '@intlayer/react-intl'],\n    replacements: {\n      'react-intl': '@intlayer/react-intl',\n    },\n  },\n  {\n    label: 'Lingui',\n    packages: ['@lingui/core', '@lingui/react', '@intlayer/lingui'],\n    replacements: {\n      '@lingui/core': '@intlayer/lingui',\n      '@lingui/react': '@intlayer/lingui',\n    },\n  },\n  {\n    label: 'svelte-i18n',\n    packages: ['svelte-i18n', '@intlayer/svelte-i18n'],\n    replacements: {\n      'svelte-i18n': '@intlayer/svelte-i18n',\n    },\n  },\n  {\n    label: '@ngneat/transloco',\n    packages: ['@ngneat/transloco', '@intlayer/transloco'],\n    replacements: {\n      '@ngneat/transloco': '@intlayer/transloco',\n    },\n  },\n  {\n    label: '@ngx-translate/core',\n    packages: ['@ngx-translate/core', '@intlayer/ngx-translate'],\n    replacements: {\n      '@ngx-translate/core': '@intlayer/ngx-translate',\n    },\n  },\n  {\n    label: 'node-polyglot',\n    packages: ['node-polyglot', '@intlayer/polyglot'],\n    replacements: {\n      'node-polyglot': '@intlayer/polyglot',\n    },\n  },\n  {\n    label: 'i18n-js',\n    packages: ['i18n-js', '@intlayer/i18n-js'],\n    replacements: {\n      'i18n-js': '@intlayer/i18n-js',\n    },\n  },\n];\n\n/**\n * Maps third-party i18n libraries to the Intlayer compat adapter that replaces\n * them at runtime, derived from {@link COMPAT_I18N_LIBRARIES}.\n */\nexport const COMPAT_PACKAGE_REPLACEMENTS: Record<string, string> =\n  Object.fromEntries(\n    COMPAT_I18N_LIBRARIES.flatMap((library) =>\n      Object.entries(library.replacements)\n    )\n  );\n\n/**\n * When a project uses a compat i18n package (such as `next-intl`) that gets\n * replaced by an `@intlayer/*` adapter (e.g. `@intlayer/next-intl`), moves the\n * original package from `dependencies` to `devDependencies` in `package.json`.\n *\n * Returns the list of package names that were moved.\n */\nexport const moveCompatPackagesToDevDependencies = (\n  packageJson: Record<string, any>\n): string[] => {\n  const movedPackages: string[] = [];\n  if (!packageJson.dependencies) return movedPackages;\n\n  for (const compatPackage of Object.keys(COMPAT_PACKAGE_REPLACEMENTS)) {\n    if (packageJson.dependencies[compatPackage]) {\n      const version = packageJson.dependencies[compatPackage];\n      delete packageJson.dependencies[compatPackage];\n\n      packageJson.devDependencies = packageJson.devDependencies ?? {};\n      if (!packageJson.devDependencies[compatPackage]) {\n        packageJson.devDependencies[compatPackage] = version;\n      }\n      movedPackages.push(compatPackage);\n    }\n  }\n\n  return movedPackages;\n};\n\n/**\n * Returns the labels of the compat i18n libraries present in `dependencies`.\n *\n * Lets the init flow report (and branch on) the libraries it found without\n * asking the user, since {@link detectMissingIntlayerPackages} already derives\n * the adapters, sync plugin and config from the very same dependency map.\n *\n * @param dependencies - Merged dependencies of the target project.\n */\nexport const detectCompatI18nLibraries = (\n  dependencies: Record<string, string>\n): string[] =>\n  COMPAT_I18N_LIBRARIES.filter((library) =>\n    library.packages.some((packageName) => Boolean(dependencies[packageName]))\n  ).map((library) => library.label);\n\n/**\n * True when the project already lints, and so has something to plug the\n * Intlayer lint rules into.\n *\n * `eslint-plugin-intlayer` loads in both ESLint and oxlint, so either linter is\n * enough. Shared with the init flow so that installing the plugin and wiring up\n * its configuration are gated on exactly the same condition — a project that\n * does not lint is left alone entirely.\n *\n * @param dependencies - Merged dependencies of the target project.\n */\nexport const hasLintTooling = (dependencies: Record<string, string>): boolean =>\n  Boolean(dependencies.eslint) || Boolean(dependencies.oxlint);\n\nexport const detectMissingIntlayerPackages = (\n  allDependencies: Record<string, string>,\n  options: DetectMissingPackagesOptions = {}\n): IntlayerPackageAnalysis => {\n  const packagesToInstall: string[] = [];\n  const devPackagesToInstall: string[] = [];\n  const packagesToMoveToDev: string[] = [];\n\n  let compatSyncConfig: CompatSyncConfig | undefined;\n  let compatVitePluginConfig: CompatVitePluginConfig | undefined;\n\n  const isInstalled = (packageName: string): boolean =>\n    Boolean(allDependencies[packageName]);\n\n  const addIfMissing = (packageName: string): void => {\n    if (!isInstalled(packageName)) {\n      packagesToInstall.push(packageName);\n    }\n  };\n\n  const addDevIfMissing = (packageName: string): void => {\n    if (!isInstalled(packageName)) {\n      devPackagesToInstall.push(packageName);\n    }\n  };\n\n  const markCompatReplacement = (\n    originalPackage: string,\n    adapterPackage: string\n  ): void => {\n    addIfMissing(adapterPackage);\n    addDevIfMissing(originalPackage);\n\n    const isExplicitDev = Boolean(options.devDependencies?.[originalPackage]);\n    const isExplicitProd = Boolean(options.dependencies?.[originalPackage]);\n    const isImplicitProd =\n      !options.dependencies &&\n      !options.devDependencies &&\n      Boolean(allDependencies[originalPackage]);\n\n    if ((isExplicitProd || isImplicitProd) && !isExplicitDev) {\n      if (!packagesToMoveToDev.includes(originalPackage)) {\n        packagesToMoveToDev.push(originalPackage);\n      }\n    }\n  };\n\n  // Core package — always required\n  addIfMissing('intlayer');\n\n  const isReactNativeProject =\n    isInstalled('react-native') || isInstalled('expo');\n\n  // Framework-specific runtime integrations\n  if (isInstalled('next')) {\n    addIfMissing('next-intlayer');\n  } else if (isReactNativeProject) {\n    addIfMissing('react-native-intlayer');\n  } else if (isInstalled('react')) {\n    addIfMissing('react-intlayer');\n  }\n\n  if (isInstalled('svelte')) {\n    addIfMissing('svelte-intlayer');\n  }\n\n  if (isInstalled('solid-js')) {\n    addIfMissing('solid-intlayer');\n  }\n\n  if (isInstalled('@angular/core')) {\n    addIfMissing('angular-intlayer');\n  }\n\n  if (isInstalled('vue')) {\n    addIfMissing('vue-intlayer');\n  }\n\n  if (isInstalled('vite')) {\n    addIfMissing('vite-intlayer');\n  }\n\n  // Lint rules — only when the project already lints.\n  if (hasLintTooling(allDependencies)) {\n    addDevIfMissing('eslint-plugin-intlayer');\n  }\n\n  // -------------------------------------------------------------------------\n  // Compat adapters for existing i18n libraries.\n  //\n  // Detection order matters: more specific libraries are checked first so that\n  // `compatSyncConfig ??=` and `compatVitePluginConfig ??=` capture the most\n  // relevant match.  Libraries that only affect the Next.js or Nuxt config do\n  // not set `compatVitePluginConfig` (handled separately in init/index.ts).\n  // Libraries whose JSON format is not yet supported leave `compatSyncConfig`\n  // undefined so no syncJSON plugin is injected.\n  // -------------------------------------------------------------------------\n\n  // next-intl — next.js only, ICU format. Default layout is a single file per\n  // locale (`messages/${locale}.json`) whose top-level keys are namespaces;\n  // syncJSON `splitKeys` auto-detection (no `${key}` segment) turns each\n  // top-level key into its own dictionary. The exact path is refined from\n  // `i18n/request.ts` in init/index.ts when present.\n  if (isInstalled('next-intl') || isInstalled('@intlayer/next-intl')) {\n    markCompatReplacement('next-intl', '@intlayer/next-intl');\n    compatSyncConfig ??= {\n      format: 'icu',\n      sourceTemplate: './messages/${locale}.json',\n      // next-intl groups namespaces by the first-level keys of one file.\n      splitKeys: true,\n    };\n    // next config handled via updateNextConfigForNextIntl in init/index.ts\n  }\n\n  // next-i18next — next.js only, i18next JSON format\n  if (isInstalled('next-i18next') || isInstalled('@intlayer/next-i18next')) {\n    markCompatReplacement('next-i18next', '@intlayer/next-i18next');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './src/locales/${locale}/${key}.json',\n    };\n    // next config handled via updateNextConfigForNextI18next in init/index.ts\n  }\n\n  // next-translate — next.js only, i18next-style flat-namespace JSON\n  if (\n    isInstalled('next-translate') ||\n    isInstalled('@intlayer/next-translate')\n  ) {\n    markCompatReplacement('next-translate', '@intlayer/next-translate');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './locales/${locale}/${key}.json',\n    };\n    // next config handled via updateNextConfigForNextTranslate in init/index.ts\n  }\n\n  // i18next — vite alias injection (`i18next` → `@intlayer/i18next`) so existing\n  // `import … from 'i18next'` is served by Intlayer without touching call sites.\n  if (isInstalled('i18next') || isInstalled('@intlayer/i18next')) {\n    markCompatReplacement('i18next', '@intlayer/i18next');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './src/locales/${locale}/${key}.json',\n    };\n    // When react-i18next is also present, its wrapper plugin aliases both\n    // `react-i18next` and `i18next`, so it must win — only inject the bare\n    // i18next plugin when no React wrapper is installed.\n    if (\n      !isInstalled('react-i18next') &&\n      !isInstalled('@intlayer/react-i18next')\n    ) {\n      compatVitePluginConfig ??= {\n        pluginFunctionName: 'i18nextVitePlugin',\n        pluginPackageSource: '@intlayer/i18next/plugin',\n      };\n    }\n  }\n\n  // react-i18next — vite alias injection (`react-i18next` → `@intlayer/react-i18next`\n  // and `i18next` → `@intlayer/i18next`) so components keep importing from\n  // `react-i18next` unchanged.\n  if (isInstalled('react-i18next') || isInstalled('@intlayer/react-i18next')) {\n    markCompatReplacement('react-i18next', '@intlayer/react-i18next');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './src/locales/${locale}/${key}.json',\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'reactI18nextVitePlugin',\n      pluginPackageSource: '@intlayer/react-i18next/plugin',\n    };\n  }\n\n  // vue-i18n — vite alias injection required\n  if (isInstalled('vue-i18n') || isInstalled('@intlayer/vue-i18n')) {\n    markCompatReplacement('vue-i18n', '@intlayer/vue-i18n');\n    compatSyncConfig ??= {\n      format: 'vue-i18n',\n      sourceTemplate: './locales/${locale}/${key}.json',\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'vueI18nVitePlugin',\n      pluginPackageSource: '@intlayer/vue-i18n/plugin',\n    };\n  }\n\n  // use-intl — framework-agnostic React core of next-intl; vite alias\n  // injection required, ICU format. Commonly a single `messages/${locale}.json`\n  // file whose top-level keys are namespaces, handled by syncJSON `splitKeys`\n  // auto-detection (no `${key}` segment in the source template).\n  if (isInstalled('use-intl') || isInstalled('@intlayer/use-intl')) {\n    markCompatReplacement('use-intl', '@intlayer/use-intl');\n    compatSyncConfig ??= {\n      format: 'icu',\n      sourceTemplate: './messages/${locale}.json',\n      // use-intl (the core of next-intl) uses the same single-file namespace model.\n      splitKeys: true,\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'useIntlVitePlugin',\n      pluginPackageSource: '@intlayer/use-intl/plugin',\n    };\n  }\n\n  // react-intl — vite alias injection required, ICU format\n  if (isInstalled('react-intl') || isInstalled('@intlayer/react-intl')) {\n    markCompatReplacement('react-intl', '@intlayer/react-intl');\n    compatSyncConfig ??= {\n      format: 'icu',\n      sourceTemplate: './src/i18n/${locale}.json',\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'reactIntlVitePlugin',\n      pluginPackageSource: '@intlayer/react-intl/plugin',\n    };\n  }\n\n  // @ngneat/transloco — vite alias injection required\n  // @todo syncJSON format not yet implemented for transloco\n  if (isInstalled('@ngneat/transloco') || isInstalled('@intlayer/transloco')) {\n    markCompatReplacement('@ngneat/transloco', '@intlayer/transloco');\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'translocoVitePlugin',\n      pluginPackageSource: '@intlayer/transloco/plugin',\n    };\n  }\n\n  // svelte-i18n — vite alias injection required, flat JSON (i18next-compatible)\n  if (isInstalled('svelte-i18n') || isInstalled('@intlayer/svelte-i18n')) {\n    markCompatReplacement('svelte-i18n', '@intlayer/svelte-i18n');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './src/locales/${locale}.json',\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'svelteI18nVitePlugin',\n      pluginPackageSource: '@intlayer/svelte-i18n/plugin',\n    };\n  }\n\n  // node-polyglot — vite alias injection required\n  // @todo syncJSON format not yet implemented for polyglot\n  if (isInstalled('node-polyglot') || isInstalled('@intlayer/polyglot')) {\n    markCompatReplacement('node-polyglot', '@intlayer/polyglot');\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'polyglotVitePlugin',\n      pluginPackageSource: '@intlayer/polyglot/plugin',\n    };\n  }\n\n  // @nuxtjs/i18n — nuxt module (no vite plugin), vue-i18n JSON format\n  if (isInstalled('@nuxtjs/i18n') || isInstalled('@intlayer/nuxtjs-i18n')) {\n    markCompatReplacement('@nuxtjs/i18n', '@intlayer/nuxtjs-i18n');\n    compatSyncConfig ??= {\n      format: 'vue-i18n',\n      sourceTemplate: './locales/${locale}/${key}.json',\n    };\n    // nuxt config handled via updateNuxtConfigForNuxtjsI18n in init/index.ts\n  }\n\n  // @ngx-translate/core — vite alias injection required, flat JSON (i18next)\n  if (\n    isInstalled('@ngx-translate/core') ||\n    isInstalled('@intlayer/ngx-translate')\n  ) {\n    markCompatReplacement('@ngx-translate/core', '@intlayer/ngx-translate');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './assets/i18n/${locale}.json',\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'ngxTranslateVitePlugin',\n      pluginPackageSource: '@intlayer/ngx-translate/plugin',\n    };\n  }\n\n  // @lingui/core — vite alias injection required.\n  // lingui keeps one catalog file per locale (default name `messages`), as\n  // `.po` (its default) or `.json`. The catalog filename is captured by the\n  // `${key}` segment so the produced dictionary key is `messages`, matching the\n  // fixed `messages` namespace the lingui compat runtime reads from.\n  if (\n    isInstalled('@lingui/core') ||\n    isInstalled('@lingui/react') ||\n    isInstalled('@intlayer/lingui')\n  ) {\n    markCompatReplacement('@lingui/core', '@intlayer/lingui');\n\n    if (isInstalled('@lingui/react')) {\n      markCompatReplacement('@lingui/react', '@intlayer/lingui');\n    }\n\n    const linguiUsesPo = options.linguiCatalogFormat === 'po';\n    compatSyncConfig ??= linguiUsesPo\n      ? {\n          plugin: 'po',\n          format: 'icu',\n          sourceTemplate: './src/locales/${locale}/${key}.po',\n        }\n      : {\n          plugin: 'json',\n          format: 'icu',\n          sourceTemplate: './src/locales/${locale}/${key}.json',\n        };\n\n    compatVitePluginConfig ??= {\n      // `@intlayer/lingui/plugin` exports `lingui` as a drop-in replacement for\n      // `@lingui/vite-plugin`, so a fresh project gets `lingui()` injected and a\n      // project already using `@lingui/vite-plugin` only has its import source\n      // rewritten (see `replacesVitePlugin`).\n      pluginFunctionName: 'lingui',\n      pluginPackageSource: '@intlayer/lingui/plugin',\n      replacesVitePlugin: {\n        importName: 'lingui',\n        fromPackageSource: '@lingui/vite-plugin',\n      },\n    };\n  }\n\n  // i18n-js — vite alias injection required\n  // @todo syncJSON format not yet implemented for i18n-js\n  if (isInstalled('i18n-js') || isInstalled('@intlayer/i18n-js')) {\n    markCompatReplacement('i18n-js', '@intlayer/i18n-js');\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'i18nJsVitePlugin',\n      pluginPackageSource: '@intlayer/i18n-js/plugin',\n    };\n  }\n\n  if (compatSyncConfig) {\n    addDevIfMissing(\n      compatSyncConfig.plugin === 'po'\n        ? '@intlayer/sync-po-plugin'\n        : '@intlayer/sync-json-plugin'\n    );\n  }\n\n  return {\n    packagesToInstall,\n    devPackagesToInstall,\n    packagesToMoveToDev,\n    compatSyncConfig,\n    compatVitePluginConfig,\n  };\n};\n\n/**\n * Runs the package install command synchronously.\n * Throws if the install process exits with a non-zero code.\n */\nexport const installPackages = (\n  rootDir: string,\n  packages: string[],\n  packageManager: PackageManager,\n  isDev: boolean = false\n): void => {\n  const command = buildInstallCommand(packageManager, packages, isDev);\n  execSync(command, { cwd: rootDir, stdio: 'inherit' });\n};\n\n/**\n * Determines whether a dependency name belongs to the Intlayer ecosystem.\n *\n * Matches the core `intlayer` package, every scoped `@intlayer/*` package\n * (including compat adapters such as `@intlayer/next-intl`) and the framework\n * runtime integrations that follow the `<framework>-intlayer` convention\n * (e.g. `next-intlayer`, `react-intlayer`, `express-intlayer`), as well as the\n * `intlayer-*` packages (e.g. `intlayer-editor`).\n */\nexport const isIntlayerPackageName = (packageName: string): boolean =>\n  packageName === 'intlayer' ||\n  packageName.startsWith('@intlayer/') ||\n  packageName.startsWith('intlayer-') ||\n  packageName.endsWith('-intlayer');\n\n/**\n * Reduces a semver range or full version to its `major.minor.patch` core,\n * stripping range prefixes (`^`, `~`), pre-release identifiers and build\n * metadata. Returns `null` when no `major.minor.patch` can be extracted.\n *\n * @example normalizeVersion('^9.0.0-canary.3') // '9.0.0'\n */\nexport const normalizeVersion = (version?: string): string | null => {\n  if (!version || typeof version !== 'string') return null;\n\n  const match = version.match(/(\\d+)\\.(\\d+)\\.(\\d+)/);\n\n  return match ? `${match[1]}.${match[2]}.${match[3]}` : null;\n};\n\n/**\n * Runs the package manager install command synchronously, so edited\n * `package.json` ranges are resolved and the lock file updated. Throws if the\n * install process exits with a non-zero code.\n */\nexport const runPackageInstall = (\n  rootDir: string,\n  packageManager: PackageManager\n): void => {\n  execSync(`${packageManager} install`, { cwd: rootDir, stdio: 'inherit' });\n};\n"],"mappings":"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"}
+{"version":3,"file":"packageManager.mjs","names":[],"sources":["../../../../src/init/utils/packageManager.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { isVersionAtLeast } from './version';\n\n/** Package managers supported for dependency installation. */\nexport type PackageManager = 'bun' | 'pnpm' | 'yarn' | 'npm';\n\n/**\n * Configuration for the syncJSON plugin injected into intlayer.config\n * when a compat i18n library is detected.\n */\nexport type CompatSyncConfig = {\n  /**\n   * Which sync plugin ingests the catalogs:\n   * - `'json'` → `syncJSON` from `@intlayer/sync-json-plugin` (default).\n   * - `'po'`   → `syncPO` from `@intlayer/sync-po-plugin` (lingui's default\n   *   format).\n   */\n  plugin?: 'json' | 'po';\n  /**\n   * JSON format matching the compat library's conventions. Ignored when\n   * `plugin` is `'po'` (PO catalogs are always serialized as gettext).\n   */\n  format: 'icu' | 'i18next' | 'vue-i18n';\n  /**\n   * Source path template using ${locale} and ${key} placeholders.\n   * Rendered as a template literal in the generated config.\n   */\n  sourceTemplate: string;\n  /**\n   * Force `splitKeys: true` in the generated `syncJSON(...)` call so each\n   * top-level key of a single per-locale file becomes its own dictionary.\n   *\n   * Set for libraries whose single `messages/${locale}.json` file groups\n   * namespaces by its first-level keys (`next-intl` / `use-intl`, where\n   * `useTranslations('Hero')` resolves to the `Hero` dictionary). Left\n   * undefined for libraries whose top-level keys are plain message keys\n   * (e.g. `i18next`, `react-intl`); for those, syncJSON's auto-detection\n   * (split only when the source has no `${key}` segment) stays in control.\n   *\n   * Only meaningful for flat templates (no `${key}` segment); it is dropped\n   * automatically when the resolved template addresses one namespace per file.\n   */\n  splitKeys?: boolean;\n};\n\n/**\n * Configuration for injecting a compat vite plugin into vite.config.\n * The plugin replaces the generic `intlayer` plugin for libraries that\n * require alias injection (e.g. `vue-i18n` → `@intlayer/vue-i18n`).\n */\nexport type CompatVitePluginConfig = {\n  /** Exported function name from the plugin package, e.g. `'vueI18nVitePlugin'`. */\n  pluginFunctionName: string;\n  /** Import path for the plugin package, e.g. `'@intlayer/vue-i18n/plugin'`. */\n  pluginPackageSource: string;\n  /**\n   * Set when the compat plugin is a drop-in replacement for an i18n library's\n   * own Vite plugin (e.g. lingui ships `@lingui/vite-plugin`). When the original\n   * import is present, init rewrites only that import's module source to\n   * `pluginPackageSource` — keeping the binding and its call site — instead of\n   * injecting a second import and appending another plugin to the array.\n   */\n  replacesVitePlugin?: {\n    /** Imported binding to keep, e.g. `'lingui'`. */\n    importName: string;\n    /** Original package source to rewrite, e.g. `'@lingui/vite-plugin'`. */\n    fromPackageSource: string;\n  };\n};\n\n/** Result of analyzing project dependencies for intlayer package gaps. */\nexport type IntlayerPackageAnalysis = {\n  /** Intlayer packages that are referenced but not yet installed. */\n  packagesToInstall: string[];\n  /** Intlayer dev packages that are referenced but not yet installed. */\n  devPackagesToInstall: string[];\n  /** Compat packages in dependencies that got replaced and should be moved to devDependencies. */\n  packagesToMoveToDev: string[];\n  /**\n   * syncJSON plugin configuration to inject when a compat i18n library is\n   * detected. Undefined when no compat library is present or format is not\n   * yet implemented.\n   */\n  compatSyncConfig: CompatSyncConfig | undefined;\n  /**\n   * Vite config plugin to inject when a vite-based compat library is\n   * detected. Undefined for Next.js/Nuxt-only compat libs or when no compat\n   * library requires alias injection.\n   */\n  compatVitePluginConfig: CompatVitePluginConfig | undefined;\n  /**\n   * Compat adapters the project would need but that are not published yet\n   * (see {@link PENDING_COMPAT_ADAPTERS}). The original library is kept as is;\n   * only its catalogs are synced.\n   */\n  pendingCompatAdapters: string[];\n};\n\n/**\n * Compat adapters that live in `compat-comming/` and are not published to npm\n * yet. Installing one fails the whole install command, so init keeps the\n * original library, skips the adapter and its bundler / framework wiring, and\n * only syncs the catalogs. Remove an entry once its package is released.\n */\nexport const PENDING_COMPAT_ADAPTERS: ReadonlySet<string> = new Set([\n  '@intlayer/nuxtjs-i18n',\n  '@intlayer/svelte-i18n',\n  '@intlayer/ngx-translate',\n]);\n\n/** Lock files revealing the package manager, in detection priority order. */\nconst LOCK_FILE_PACKAGE_MANAGERS: ReadonlyArray<\n  readonly [lockFile: string, packageManager: PackageManager]\n> = [\n  ['bun.lock', 'bun'],\n  ['bun.lockb', 'bun'],\n  ['pnpm-lock.yaml', 'pnpm'],\n  ['yarn.lock', 'yarn'],\n  ['package-lock.json', 'npm'],\n];\n\n/** Package managers accepted in the `packageManager` field of `package.json`. */\nconst PACKAGE_MANAGERS: readonly PackageManager[] = [\n  'bun',\n  'pnpm',\n  'yarn',\n  'npm',\n];\n\n/**\n * Reads the package manager pinned by the `packageManager` field of the\n * `package.json` in `directory` (e.g. `\"pnpm@9.0.0\"`), if any.\n */\nconst readPackageManagerField = (directory: string): PackageManager | null => {\n  try {\n    const { packageManager } = JSON.parse(\n      readFileSync(join(directory, 'package.json'), 'utf8')\n    ) as { packageManager?: unknown };\n\n    if (typeof packageManager !== 'string') return null;\n\n    const name = packageManager.split('@')[0] as PackageManager;\n    return PACKAGE_MANAGERS.includes(name) ? name : null;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Detects the package manager in use by checking for lock files in the\n * project root, then the `packageManager` field of its `package.json`. Falls\n * back to npm when neither is found.\n */\nexport const detectPackageManager = (rootDir: string): PackageManager =>\n  LOCK_FILE_PACKAGE_MANAGERS.find(([lockFile]) =>\n    existsSync(join(rootDir, lockFile))\n  )?.[1] ??\n  readPackageManagerField(rootDir) ??\n  'npm';\n\n/**\n * Walks up from `startDir` to the nearest directory holding a lock file — the\n * workspace root an install must run from. Stops at the repository root\n * (`.git`) and returns `null` when no lock file is found.\n */\nexport const findLockFileDir = (startDir: string): string | null => {\n  let currentDir = resolve(startDir);\n\n  while (true) {\n    const hasLockFile = LOCK_FILE_PACKAGE_MANAGERS.some(([lockFile]) =>\n      existsSync(join(currentDir, lockFile))\n    );\n    if (hasLockFile) return currentDir;\n    if (existsSync(join(currentDir, '.git'))) return null;\n\n    const parentDir = dirname(currentDir);\n    if (parentDir === currentDir) return null;\n    currentDir = parentDir;\n  }\n};\n\n/**\n * Returns the install command for the given package manager and package list.\n */\nconst buildInstallCommand = (\n  packageManager: PackageManager,\n  packages: string[],\n  isDev: boolean = false\n): string => {\n  const packageList = packages.join(' ');\n  switch (packageManager) {\n    case 'bun':\n      return `bun add ${isDev ? '-d ' : ''}${packageList}`;\n    case 'pnpm':\n      return `pnpm add ${isDev ? '-D ' : ''}${packageList}`;\n    case 'yarn':\n      return `yarn add ${isDev ? '-D ' : ''}${packageList}`;\n    case 'npm':\n      return `npm install ${isDev ? '-D ' : ''}${packageList}`;\n  }\n};\n\n/**\n * Analyzes existing project dependencies to determine which intlayer packages\n * are missing and what syncJSON configuration to inject when compat i18n\n * libraries are present.\n */\n/** Extra signals (from a filesystem scan) that refine compat detection. */\nexport type DetectMissingPackagesOptions = {\n  /**\n   * Catalog format detected for a lingui project (`'po'` or `'json'`), or\n   * `null`/undefined when none was found. Decides which sync plugin + dev\n   * dependency the lingui compat setup uses.\n   */\n  linguiCatalogFormat?: 'po' | 'json' | null;\n  /**\n   * The project's runtime dependencies (from `package.json` `dependencies`).\n   * When provided, compat packages found here that are replaced by `@intlayer/*`\n   * are reported in `packagesToMoveToDev`.\n   */\n  dependencies?: Record<string, string>;\n  /**\n   * The project's development dependencies (from `package.json` `devDependencies`).\n   */\n  devDependencies?: Record<string, string>;\n};\n\n/** An existing i18n library Intlayer ships a compat adapter for. */\nexport type CompatI18nLibrary = {\n  /** Human-readable name, used to report the detection back to the user. */\n  label: string;\n  /**\n   * Dependency names that reveal the library — both the upstream packages and\n   * the Intlayer adapters, so a project that already ran `init` is still\n   * recognized.\n   */\n  packages: readonly string[];\n  /**\n   * Upstream third-party packages replaced by Intlayer compat adapters at runtime,\n   * mapped to their adapter package name.\n   */\n  replacements: Record<string, string>;\n};\n\n/**\n * Existing i18n libraries Intlayer can adapt, keyed by the dependencies that\n * reveal them. Mirrors the compat branches of\n * {@link detectMissingIntlayerPackages}: a library listed here is one that\n * detection will wire up on its own once its package is in `package.json`.\n */\nexport const COMPAT_I18N_LIBRARIES: readonly CompatI18nLibrary[] = [\n  {\n    label: 'i18next / react-i18next',\n    packages: [\n      'i18next',\n      'react-i18next',\n      '@intlayer/i18next',\n      '@intlayer/react-i18next',\n    ],\n    replacements: {\n      i18next: '@intlayer/i18next',\n      'react-i18next': '@intlayer/react-i18next',\n    },\n  },\n  {\n    label: 'next-intl / use-intl',\n    packages: [\n      'next-intl',\n      'use-intl',\n      '@intlayer/next-intl',\n      '@intlayer/use-intl',\n    ],\n    replacements: {\n      'next-intl': '@intlayer/next-intl',\n      'use-intl': '@intlayer/use-intl',\n    },\n  },\n  {\n    label: 'vue-i18n',\n    packages: ['vue-i18n', '@intlayer/vue-i18n'],\n    replacements: {\n      'vue-i18n': '@intlayer/vue-i18n',\n    },\n  },\n  {\n    label: '@nuxtjs/i18n',\n    packages: ['@nuxtjs/i18n', '@intlayer/nuxtjs-i18n'],\n    replacements: {\n      '@nuxtjs/i18n': '@intlayer/nuxtjs-i18n',\n    },\n  },\n  {\n    label: 'next-i18next',\n    packages: ['next-i18next', '@intlayer/next-i18next'],\n    replacements: {\n      'next-i18next': '@intlayer/next-i18next',\n    },\n  },\n  {\n    label: 'next-translate',\n    packages: ['next-translate', '@intlayer/next-translate'],\n    replacements: {\n      'next-translate': '@intlayer/next-translate',\n    },\n  },\n  {\n    label: 'react-intl',\n    packages: ['react-intl', '@intlayer/react-intl'],\n    replacements: {\n      'react-intl': '@intlayer/react-intl',\n    },\n  },\n  {\n    label: 'Lingui',\n    packages: ['@lingui/core', '@lingui/react', '@intlayer/lingui'],\n    replacements: {\n      '@lingui/core': '@intlayer/lingui',\n      '@lingui/react': '@intlayer/lingui',\n    },\n  },\n  {\n    label: 'svelte-i18n',\n    packages: ['svelte-i18n', '@intlayer/svelte-i18n'],\n    replacements: {\n      'svelte-i18n': '@intlayer/svelte-i18n',\n    },\n  },\n  {\n    label: '@ngneat/transloco',\n    packages: ['@ngneat/transloco', '@intlayer/transloco'],\n    replacements: {\n      '@ngneat/transloco': '@intlayer/transloco',\n    },\n  },\n  {\n    label: '@ngx-translate/core',\n    packages: ['@ngx-translate/core', '@intlayer/ngx-translate'],\n    replacements: {\n      '@ngx-translate/core': '@intlayer/ngx-translate',\n    },\n  },\n  {\n    label: 'node-polyglot',\n    packages: ['node-polyglot', '@intlayer/polyglot'],\n    replacements: {\n      'node-polyglot': '@intlayer/polyglot',\n    },\n  },\n  {\n    label: 'i18n-js',\n    packages: ['i18n-js', '@intlayer/i18n-js'],\n    replacements: {\n      'i18n-js': '@intlayer/i18n-js',\n    },\n  },\n];\n\n/**\n * Maps third-party i18n libraries to the Intlayer compat adapter that replaces\n * them at runtime, derived from {@link COMPAT_I18N_LIBRARIES}.\n */\nexport const COMPAT_PACKAGE_REPLACEMENTS: Record<string, string> =\n  Object.fromEntries(\n    COMPAT_I18N_LIBRARIES.flatMap((library) =>\n      Object.entries(library.replacements)\n    )\n  );\n\n/**\n * When a project uses a compat i18n package (such as `next-intl`) that gets\n * replaced by an `@intlayer/*` adapter (e.g. `@intlayer/next-intl`), moves the\n * original package from `dependencies` to `devDependencies` in `package.json`.\n *\n * Returns the list of package names that were moved.\n */\nexport const moveCompatPackagesToDevDependencies = (\n  packageJson: Record<string, any>\n): string[] => {\n  const movedPackages: string[] = [];\n  if (!packageJson.dependencies) return movedPackages;\n\n  for (const compatPackage of Object.keys(COMPAT_PACKAGE_REPLACEMENTS)) {\n    if (packageJson.dependencies[compatPackage]) {\n      const version = packageJson.dependencies[compatPackage];\n      delete packageJson.dependencies[compatPackage];\n\n      packageJson.devDependencies = packageJson.devDependencies ?? {};\n      if (!packageJson.devDependencies[compatPackage]) {\n        packageJson.devDependencies[compatPackage] = version;\n      }\n      movedPackages.push(compatPackage);\n    }\n  }\n\n  return movedPackages;\n};\n\n/**\n * Returns the labels of the compat i18n libraries present in `dependencies`.\n *\n * Lets the init flow report (and branch on) the libraries it found without\n * asking the user, since {@link detectMissingIntlayerPackages} already derives\n * the adapters, sync plugin and config from the very same dependency map.\n *\n * @param dependencies - Merged dependencies of the target project.\n */\nexport const detectCompatI18nLibraries = (\n  dependencies: Record<string, string>\n): string[] =>\n  COMPAT_I18N_LIBRARIES.filter((library) =>\n    library.packages.some((packageName) => Boolean(dependencies[packageName]))\n  ).map((library) => library.label);\n\n/** Lowest ESLint major `eslint-plugin-intlayer` supports (flat config). */\nexport const MINIMUM_ESLINT_MAJOR = 9;\n\n/**\n * True when the project pins ESLint below {@link MINIMUM_ESLINT_MAJOR}.\n * Installing the plugin there fails on its `eslint` peer range (and takes the\n * whole install command down with it). Ranges without a version number\n * (`latest`, `*`, `catalog:`) are assumed current.\n *\n * @param dependencies - Merged dependencies of the target project.\n */\nexport const hasLegacyEslint = (\n  dependencies: Record<string, string>\n): boolean => {\n  const eslintVersion = dependencies.eslint;\n  if (!eslintVersion || !/\\d/.test(eslintVersion)) return false;\n  return !isVersionAtLeast(eslintVersion, MINIMUM_ESLINT_MAJOR);\n};\n\n/**\n * True when the project already lints with a linter the Intlayer rules can\n * plug into: oxlint, or ESLint 9+.\n *\n * Shared with the init flow so that installing the plugin and wiring up its\n * configuration are gated on exactly the same condition — a project that does\n * not lint, or lints with ESLint 8, is left alone.\n *\n * @param dependencies - Merged dependencies of the target project.\n */\nexport const hasLintTooling = (dependencies: Record<string, string>): boolean =>\n  !hasLegacyEslint(dependencies) &&\n  (Boolean(dependencies.eslint) || Boolean(dependencies.oxlint));\n\nexport const detectMissingIntlayerPackages = (\n  allDependencies: Record<string, string>,\n  options: DetectMissingPackagesOptions = {}\n): IntlayerPackageAnalysis => {\n  const packagesToInstall: string[] = [];\n  const devPackagesToInstall: string[] = [];\n  const packagesToMoveToDev: string[] = [];\n  const pendingCompatAdapters: string[] = [];\n\n  let compatSyncConfig: CompatSyncConfig | undefined;\n  let compatVitePluginConfig: CompatVitePluginConfig | undefined;\n\n  const isInstalled = (packageName: string): boolean =>\n    Boolean(allDependencies[packageName]);\n\n  const addIfMissing = (packageName: string): void => {\n    if (!isInstalled(packageName)) {\n      packagesToInstall.push(packageName);\n    }\n  };\n\n  const addDevIfMissing = (packageName: string): void => {\n    if (!isInstalled(packageName)) {\n      devPackagesToInstall.push(packageName);\n    }\n  };\n\n  /**\n   * Whether an adapter can be used: published, or already installed by the\n   * user (e.g. a local build).\n   */\n  const isAdapterAvailable = (adapterPackage: string): boolean =>\n    !PENDING_COMPAT_ADAPTERS.has(adapterPackage) || isInstalled(adapterPackage);\n\n  const markCompatReplacement = (\n    originalPackage: string,\n    adapterPackage: string\n  ): void => {\n    if (!isAdapterAvailable(adapterPackage)) {\n      if (!pendingCompatAdapters.includes(adapterPackage)) {\n        pendingCompatAdapters.push(adapterPackage);\n      }\n      return;\n    }\n\n    addIfMissing(adapterPackage);\n    addDevIfMissing(originalPackage);\n\n    const isExplicitDev = Boolean(options.devDependencies?.[originalPackage]);\n    const isExplicitProd = Boolean(options.dependencies?.[originalPackage]);\n    const isImplicitProd =\n      !options.dependencies &&\n      !options.devDependencies &&\n      Boolean(allDependencies[originalPackage]);\n\n    if ((isExplicitProd || isImplicitProd) && !isExplicitDev) {\n      if (!packagesToMoveToDev.includes(originalPackage)) {\n        packagesToMoveToDev.push(originalPackage);\n      }\n    }\n  };\n\n  // Core package — always required\n  addIfMissing('intlayer');\n\n  const isReactNativeProject =\n    isInstalled('react-native') || isInstalled('expo');\n\n  // Framework-specific runtime integrations\n  if (isInstalled('next')) {\n    addIfMissing('next-intlayer');\n  } else if (isReactNativeProject) {\n    addIfMissing('react-native-intlayer');\n  } else if (isInstalled('react')) {\n    addIfMissing('react-intlayer');\n  }\n\n  if (isInstalled('svelte')) {\n    addIfMissing('svelte-intlayer');\n  }\n\n  if (isInstalled('solid-js')) {\n    addIfMissing('solid-intlayer');\n  }\n\n  if (isInstalled('@angular/core')) {\n    addIfMissing('angular-intlayer');\n  }\n\n  if (isInstalled('vue')) {\n    addIfMissing('vue-intlayer');\n  }\n\n  if (isInstalled('vite')) {\n    addIfMissing('vite-intlayer');\n  }\n\n  // Meta-frameworks whose config init wires the Intlayer module /\n  // integration into. A `@nuxtjs/i18n` app keeps its own module instead.\n  if (isInstalled('nuxt') && !isInstalled('@nuxtjs/i18n')) {\n    addIfMissing('nuxt-intlayer');\n  }\n\n  if (isInstalled('astro')) {\n    addIfMissing('astro-intlayer');\n  }\n\n  // Server frameworks. NestJS runs on Express unless the Fastify platform is\n  // installed, so it gets the matching adapter.\n  const isNestJsProject = isInstalled('@nestjs/core');\n  const isNestJsOnFastify = isInstalled('@nestjs/platform-fastify');\n\n  if (isInstalled('express') || (isNestJsProject && !isNestJsOnFastify)) {\n    addIfMissing('express-intlayer');\n  }\n\n  if (isInstalled('fastify') || isNestJsOnFastify) {\n    addIfMissing('fastify-intlayer');\n  }\n\n  if (isInstalled('hono')) {\n    addIfMissing('hono-intlayer');\n  }\n\n  if (isInstalled('elysia')) {\n    addIfMissing('elysia-intlayer');\n  }\n\n  if (isInstalled('@adonisjs/core')) {\n    addIfMissing('adonis-intlayer');\n  }\n\n  // Lint rules — only when the project already lints.\n  if (hasLintTooling(allDependencies)) {\n    addDevIfMissing('eslint-plugin-intlayer');\n  }\n\n  // -------------------------------------------------------------------------\n  // Compat adapters for existing i18n libraries.\n  //\n  // Detection order matters: more specific libraries are checked first so that\n  // `compatSyncConfig ??=` and `compatVitePluginConfig ??=` capture the most\n  // relevant match.  Libraries that only affect the Next.js or Nuxt config do\n  // not set `compatVitePluginConfig` (handled separately in init/index.ts).\n  // Libraries whose JSON format is not yet supported leave `compatSyncConfig`\n  // undefined so no syncJSON plugin is injected.\n  // -------------------------------------------------------------------------\n\n  // next-intl — next.js only, ICU format. Default layout is a single file per\n  // locale (`messages/${locale}.json`) whose top-level keys are namespaces;\n  // syncJSON `splitKeys` auto-detection (no `${key}` segment) turns each\n  // top-level key into its own dictionary. The exact path is refined from\n  // `i18n/request.ts` in init/index.ts when present.\n  if (isInstalled('next-intl') || isInstalled('@intlayer/next-intl')) {\n    markCompatReplacement('next-intl', '@intlayer/next-intl');\n    compatSyncConfig ??= {\n      format: 'icu',\n      sourceTemplate: './messages/${locale}.json',\n      // next-intl groups namespaces by the first-level keys of one file.\n      splitKeys: true,\n    };\n    // next config handled via updateNextConfigForNextIntl in init/index.ts\n  }\n\n  // next-i18next — next.js only, i18next JSON format\n  if (isInstalled('next-i18next') || isInstalled('@intlayer/next-i18next')) {\n    markCompatReplacement('next-i18next', '@intlayer/next-i18next');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './src/locales/${locale}/${key}.json',\n    };\n    // next config handled via updateNextConfigForNextI18next in init/index.ts\n  }\n\n  // next-translate — next.js only, i18next-style flat-namespace JSON\n  if (\n    isInstalled('next-translate') ||\n    isInstalled('@intlayer/next-translate')\n  ) {\n    markCompatReplacement('next-translate', '@intlayer/next-translate');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './locales/${locale}/${key}.json',\n    };\n    // next config handled via updateNextConfigForNextTranslate in init/index.ts\n  }\n\n  // i18next — vite alias injection (`i18next` → `@intlayer/i18next`) so existing\n  // `import … from 'i18next'` is served by Intlayer without touching call sites.\n  if (isInstalled('i18next') || isInstalled('@intlayer/i18next')) {\n    markCompatReplacement('i18next', '@intlayer/i18next');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './src/locales/${locale}/${key}.json',\n    };\n    // When react-i18next is also present, its wrapper plugin aliases both\n    // `react-i18next` and `i18next`, so it must win — only inject the bare\n    // i18next plugin when no React wrapper is installed.\n    if (\n      !isInstalled('react-i18next') &&\n      !isInstalled('@intlayer/react-i18next')\n    ) {\n      compatVitePluginConfig ??= {\n        pluginFunctionName: 'i18nextVitePlugin',\n        pluginPackageSource: '@intlayer/i18next/plugin',\n      };\n    }\n  }\n\n  // react-i18next — vite alias injection (`react-i18next` → `@intlayer/react-i18next`\n  // and `i18next` → `@intlayer/i18next`) so components keep importing from\n  // `react-i18next` unchanged.\n  if (isInstalled('react-i18next') || isInstalled('@intlayer/react-i18next')) {\n    markCompatReplacement('react-i18next', '@intlayer/react-i18next');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './src/locales/${locale}/${key}.json',\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'reactI18nextVitePlugin',\n      pluginPackageSource: '@intlayer/react-i18next/plugin',\n    };\n  }\n\n  // vue-i18n — vite alias injection required\n  if (isInstalled('vue-i18n') || isInstalled('@intlayer/vue-i18n')) {\n    markCompatReplacement('vue-i18n', '@intlayer/vue-i18n');\n    compatSyncConfig ??= {\n      format: 'vue-i18n',\n      sourceTemplate: './locales/${locale}/${key}.json',\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'vueI18nVitePlugin',\n      pluginPackageSource: '@intlayer/vue-i18n/plugin',\n    };\n  }\n\n  // use-intl — framework-agnostic React core of next-intl; vite alias\n  // injection required, ICU format. Commonly a single `messages/${locale}.json`\n  // file whose top-level keys are namespaces, handled by syncJSON `splitKeys`\n  // auto-detection (no `${key}` segment in the source template).\n  if (isInstalled('use-intl') || isInstalled('@intlayer/use-intl')) {\n    markCompatReplacement('use-intl', '@intlayer/use-intl');\n    compatSyncConfig ??= {\n      format: 'icu',\n      sourceTemplate: './messages/${locale}.json',\n      // use-intl (the core of next-intl) uses the same single-file namespace model.\n      splitKeys: true,\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'useIntlVitePlugin',\n      pluginPackageSource: '@intlayer/use-intl/plugin',\n    };\n  }\n\n  // react-intl — vite alias injection required, ICU format\n  if (isInstalled('react-intl') || isInstalled('@intlayer/react-intl')) {\n    markCompatReplacement('react-intl', '@intlayer/react-intl');\n    compatSyncConfig ??= {\n      format: 'icu',\n      sourceTemplate: './src/i18n/${locale}.json',\n    };\n    compatVitePluginConfig ??= {\n      pluginFunctionName: 'reactIntlVitePlugin',\n      pluginPackageSource: '@intlayer/react-intl/plugin',\n    };\n  }\n\n  // @ngneat/transloco — vite alias injection required\n  // @todo syncJSON format not yet implemented for transloco\n  if (isInstalled('@ngneat/transloco') || isInstalled('@intlayer/transloco')) {\n    markCompatReplacement('@ngneat/transloco', '@intlayer/transloco');\n    if (isAdapterAvailable('@intlayer/transloco')) {\n      compatVitePluginConfig ??= {\n        pluginFunctionName: 'translocoVitePlugin',\n        pluginPackageSource: '@intlayer/transloco/plugin',\n      };\n    }\n  }\n\n  // svelte-i18n — vite alias injection required, flat JSON (i18next-compatible)\n  if (isInstalled('svelte-i18n') || isInstalled('@intlayer/svelte-i18n')) {\n    markCompatReplacement('svelte-i18n', '@intlayer/svelte-i18n');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './src/locales/${locale}.json',\n    };\n    if (isAdapterAvailable('@intlayer/svelte-i18n')) {\n      compatVitePluginConfig ??= {\n        pluginFunctionName: 'svelteI18nVitePlugin',\n        pluginPackageSource: '@intlayer/svelte-i18n/plugin',\n      };\n    }\n  }\n\n  // node-polyglot — vite alias injection required\n  // @todo syncJSON format not yet implemented for polyglot\n  if (isInstalled('node-polyglot') || isInstalled('@intlayer/polyglot')) {\n    markCompatReplacement('node-polyglot', '@intlayer/polyglot');\n    if (isAdapterAvailable('@intlayer/polyglot')) {\n      compatVitePluginConfig ??= {\n        pluginFunctionName: 'polyglotVitePlugin',\n        pluginPackageSource: '@intlayer/polyglot/plugin',\n      };\n    }\n  }\n\n  // @nuxtjs/i18n — nuxt module (no vite plugin), vue-i18n JSON format\n  if (isInstalled('@nuxtjs/i18n') || isInstalled('@intlayer/nuxtjs-i18n')) {\n    markCompatReplacement('@nuxtjs/i18n', '@intlayer/nuxtjs-i18n');\n    compatSyncConfig ??= {\n      format: 'vue-i18n',\n      sourceTemplate: './locales/${locale}/${key}.json',\n    };\n    // nuxt config handled via updateNuxtConfigForNuxtjsI18n in init/index.ts\n  }\n\n  // @ngx-translate/core — vite alias injection required, flat JSON (i18next)\n  if (\n    isInstalled('@ngx-translate/core') ||\n    isInstalled('@intlayer/ngx-translate')\n  ) {\n    markCompatReplacement('@ngx-translate/core', '@intlayer/ngx-translate');\n    compatSyncConfig ??= {\n      format: 'i18next',\n      sourceTemplate: './assets/i18n/${locale}.json',\n    };\n    if (isAdapterAvailable('@intlayer/ngx-translate')) {\n      compatVitePluginConfig ??= {\n        pluginFunctionName: 'ngxTranslateVitePlugin',\n        pluginPackageSource: '@intlayer/ngx-translate/plugin',\n      };\n    }\n  }\n\n  // @lingui/core — vite alias injection required.\n  // lingui keeps one catalog file per locale (default name `messages`), as\n  // `.po` (its default) or `.json`. The catalog filename is captured by the\n  // `${key}` segment so the produced dictionary key is `messages`, matching the\n  // fixed `messages` namespace the lingui compat runtime reads from.\n  if (\n    isInstalled('@lingui/core') ||\n    isInstalled('@lingui/react') ||\n    isInstalled('@intlayer/lingui')\n  ) {\n    markCompatReplacement('@lingui/core', '@intlayer/lingui');\n\n    if (isInstalled('@lingui/react')) {\n      markCompatReplacement('@lingui/react', '@intlayer/lingui');\n    }\n\n    const linguiUsesPo = options.linguiCatalogFormat === 'po';\n    compatSyncConfig ??= linguiUsesPo\n      ? {\n          plugin: 'po',\n          format: 'icu',\n          sourceTemplate: './src/locales/${locale}/${key}.po',\n        }\n      : {\n          plugin: 'json',\n          format: 'icu',\n          sourceTemplate: './src/locales/${locale}/${key}.json',\n        };\n\n    compatVitePluginConfig ??= {\n      // `@intlayer/lingui/plugin` exports `lingui` as a drop-in replacement for\n      // `@lingui/vite-plugin`, so a fresh project gets `lingui()` injected and a\n      // project already using `@lingui/vite-plugin` only has its import source\n      // rewritten (see `replacesVitePlugin`).\n      pluginFunctionName: 'lingui',\n      pluginPackageSource: '@intlayer/lingui/plugin',\n      replacesVitePlugin: {\n        importName: 'lingui',\n        fromPackageSource: '@lingui/vite-plugin',\n      },\n    };\n  }\n\n  // i18n-js — vite alias injection required\n  // @todo syncJSON format not yet implemented for i18n-js\n  if (isInstalled('i18n-js') || isInstalled('@intlayer/i18n-js')) {\n    markCompatReplacement('i18n-js', '@intlayer/i18n-js');\n    if (isAdapterAvailable('@intlayer/i18n-js')) {\n      compatVitePluginConfig ??= {\n        pluginFunctionName: 'i18nJsVitePlugin',\n        pluginPackageSource: '@intlayer/i18n-js/plugin',\n      };\n    }\n  }\n\n  if (compatSyncConfig) {\n    addDevIfMissing(\n      compatSyncConfig.plugin === 'po'\n        ? '@intlayer/sync-po-plugin'\n        : '@intlayer/sync-json-plugin'\n    );\n  }\n\n  return {\n    packagesToInstall,\n    devPackagesToInstall,\n    packagesToMoveToDev,\n    compatSyncConfig,\n    compatVitePluginConfig,\n    pendingCompatAdapters,\n  };\n};\n\n/**\n * Runs the package install command synchronously.\n * Throws if the install process exits with a non-zero code.\n */\nexport const installPackages = (\n  rootDir: string,\n  packages: string[],\n  packageManager: PackageManager,\n  isDev: boolean = false\n): void => {\n  const command = buildInstallCommand(packageManager, packages, isDev);\n  execSync(command, { cwd: rootDir, stdio: 'inherit' });\n};\n\n/**\n * Determines whether a dependency name belongs to the Intlayer ecosystem.\n *\n * Matches the core `intlayer` package, every scoped `@intlayer/*` package\n * (including compat adapters such as `@intlayer/next-intl`) and the framework\n * runtime integrations that follow the `<framework>-intlayer` convention\n * (e.g. `next-intlayer`, `react-intlayer`, `express-intlayer`), as well as the\n * `intlayer-*` packages (e.g. `intlayer-editor`).\n */\nexport const isIntlayerPackageName = (packageName: string): boolean =>\n  packageName === 'intlayer' ||\n  packageName.startsWith('@intlayer/') ||\n  packageName.startsWith('intlayer-') ||\n  packageName.endsWith('-intlayer');\n\n/**\n * Reduces a semver range or full version to its `major.minor.patch` core,\n * stripping range prefixes (`^`, `~`), pre-release identifiers and build\n * metadata. Returns `null` when no `major.minor.patch` can be extracted.\n *\n * @example normalizeVersion('^9.0.0-canary.3') // '9.0.0'\n */\nexport const normalizeVersion = (version?: string): string | null => {\n  if (!version || typeof version !== 'string') return null;\n\n  const match = version.match(/(\\d+)\\.(\\d+)\\.(\\d+)/);\n\n  return match ? `${match[1]}.${match[2]}.${match[3]}` : null;\n};\n\n/**\n * Runs the package manager install command synchronously, so edited\n * `package.json` ranges are resolved and the lock file updated. Throws if the\n * install process exits with a non-zero code.\n */\nexport const runPackageInstall = (\n  rootDir: string,\n  packageManager: PackageManager\n): void => {\n  execSync(`${packageManager} install`, { cwd: rootDir, stdio: 'inherit' });\n};\n"],"mappings":"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"}

package/dist/esm/init/utils/urlRoutingFramework.mjs

@@ -0,0 +1,40 @@
+//#region src/init/utils/urlRoutingFramework.ts
+/**
+* Frontend packages whose apps are served over URLs, so a locale routing
+* strategy (`routing.mode`, the locale proxy) applies to them.
+*/
+const URL_ROUTING_FRAMEWORK_PACKAGES = [
+	"next",
+	"react",
+	"react-dom",
+	"react-router",
+	"react-router-dom",
+	"@tanstack/react-router",
+	"@tanstack/react-start",
+	"@tanstack/solid-router",
+	"@tanstack/solid-start",
+	"vue",
+	"nuxt",
+	"svelte",
+	"@sveltejs/kit",
+	"solid-js",
+	"preact",
+	"@angular/core",
+	"astro",
+	"lit",
+	"@remix-run/react",
+	"vite"
+];
+/**
+* Returns true when the project is a web frontend for which locale routing is
+* meaningful. React Native / Expo apps are excluded (no URL routing), as are
+* backend-only and plain Node projects.
+*/
+const hasUrlRoutingFramework = (dependencies) => {
+	if (dependencies["react-native"] || dependencies.expo) return false;
+	return URL_ROUTING_FRAMEWORK_PACKAGES.some((packageName) => packageName in dependencies);
+};
+
+//#endregion
+export { hasUrlRoutingFramework };
+//# sourceMappingURL=urlRoutingFramework.mjs.map

package/dist/esm/init/utils/urlRoutingFramework.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlRoutingFramework.mjs","names":[],"sources":["../../../../src/init/utils/urlRoutingFramework.ts"],"sourcesContent":["/**\n * Frontend packages whose apps are served over URLs, so a locale routing\n * strategy (`routing.mode`, the locale proxy) applies to them.\n */\nconst URL_ROUTING_FRAMEWORK_PACKAGES = [\n  'next',\n  'react',\n  'react-dom',\n  'react-router',\n  'react-router-dom',\n  '@tanstack/react-router',\n  '@tanstack/react-start',\n  '@tanstack/solid-router',\n  '@tanstack/solid-start',\n  'vue',\n  'nuxt',\n  'svelte',\n  '@sveltejs/kit',\n  'solid-js',\n  'preact',\n  '@angular/core',\n  'astro',\n  'lit',\n  '@remix-run/react',\n  'vite',\n] as const;\n\n/**\n * Returns true when the project is a web frontend for which locale routing is\n * meaningful. React Native / Expo apps are excluded (no URL routing), as are\n * backend-only and plain Node projects.\n */\nexport const hasUrlRoutingFramework = (\n  dependencies: Record<string, string>\n): boolean => {\n  if (dependencies['react-native'] || dependencies.expo) return false;\n\n  return URL_ROUTING_FRAMEWORK_PACKAGES.some(\n    (packageName) => packageName in dependencies\n  );\n};\n"],"mappings":";;;;;AAIA,MAAM,iCAAiC;CACrC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;AAOA,MAAa,0BACX,iBACY;CACZ,IAAI,aAAa,mBAAmB,aAAa,MAAM,OAAO;CAE9D,OAAO,+BAA+B,MACnC,gBAAgB,eAAe,YAClC;AACF"}

package/dist/esm/initConfig/index.mjs

@@ -18,13 +18,15 @@ const getTemplatePath = (format) => {
 /**
 * Initialize the Intlayer configuration file. No-ops when a configuration file
 * already exists at `baseDir`.
+*
+* @returns `true` when the file was created, `false` when one already existed.
 */
 const initConfig = async (format, baseDir, options) => {
 	const { configurationFilePath } = searchConfigurationFile(baseDir);
 	if (configurationFilePath) {
 		const relativePath = relative(baseDir, configurationFilePath);
 		logger(`${v} ${colorizePath(relativePath)} already exists`);
-		return;
+		return false;
 	}
 	const extension = format.split(".").pop();
 	const templatePath = getTemplatePath(extension);
@@ -42,6 +44,7 @@ const initConfig = async (format, baseDir, options) => {
 	if (applicationURL) configContent = configContent.replace("http://localhost:3000", applicationURL);
 	await writeFile(join(baseDir, format), configContent, "utf8");
 	logger(`${v} Created ${colorizePath(format)}`);
+	return true;
 };
 
 //#endregion

package/dist/esm/initConfig/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/initConfig/index.ts"],"sourcesContent":["import { writeFile } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport { colorizePath, logger, v } from '@intlayer/config/logger';\nimport {\n  type configurationFilesCandidates,\n  searchConfigurationFile,\n} from '@intlayer/config/node';\n\ntype ConfigFormat = 'ts' | 'cjs' | 'mjs' | 'js' | 'json';\n\nconst getTemplatePath = (format: ConfigFormat) => {\n  switch (format) {\n    case 'ts':\n      return './templates/ts.txt';\n    case 'cjs':\n      return './templates/cjs.txt';\n    case 'mjs':\n      return './templates/mjs.txt';\n    case 'js':\n      return './templates/mjs.txt';\n    case 'json':\n      return './templates/json.txt';\n    default:\n      return './templates/ts.txt';\n  }\n};\n\n/** Values injected into the configuration file template. */\nexport type InitConfigOptions = {\n  /** Locales detected in the project, inserted into `internationalization.locales`. */\n  locales?: string[];\n  /**\n   * Dev-server URL of the detected framework, inserted as\n   * `editor.applicationURL` (the template defaults to `http://localhost:3000`).\n   */\n  applicationURL?: string;\n};\n\n/**\n * Initialize the Intlayer configuration file. No-ops when a configuration file\n * already exists at `baseDir`.\n */\nexport const initConfig = async (\n  format: (typeof configurationFilesCandidates)[number],\n  baseDir: string,\n  options?: InitConfigOptions\n) => {\n  //   Search for configuration file\n  const { configurationFilePath } = searchConfigurationFile(baseDir);\n\n  //   return if the configuration file is found\n  if (configurationFilePath) {\n    const relativePath = relative(baseDir, configurationFilePath);\n    logger(`${v} ${colorizePath(relativePath)} already exists`);\n    return;\n  }\n\n  // Extract the format from the filename (e.g. 'intlayer.config.ts' -> 'ts')\n  const extension = format.split('.').pop() as ConfigFormat;\n\n  const templatePath = getTemplatePath(extension);\n  let configContent = readAsset(templatePath);\n\n  const { locales, applicationURL } = options ?? {};\n\n  if (locales && locales.length > 0) {\n    if (extension === 'json') {\n      const localesString = JSON.stringify(locales);\n      configContent = configContent.replace('[\"en\"]', localesString);\n    } else {\n      const localesString = `[${locales.map((locale) => `'${locale}'`).join(', ')}]`;\n      configContent = configContent.replace('[Locales.ENGLISH]', localesString);\n    }\n  }\n\n  if (applicationURL) {\n    configContent = configContent.replace(\n      'http://localhost:3000',\n      applicationURL\n    );\n  }\n\n  await writeFile(join(baseDir, format), configContent, 'utf8');\n  logger(`${v} Created ${colorizePath(format)}`);\n};\n"],"mappings":";;;;;;;AAWA,MAAM,mBAAmB,WAAyB;CAChD,QAAQ,QAAR;EACE,KAAK,MACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,MACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;;AAiBA,MAAa,aAAa,OACxB,QACA,SACA,YACG;CAEH,MAAM,EAAE,0BAA0B,wBAAwB,OAAO;CAGjE,IAAI,uBAAuB;EACzB,MAAM,eAAe,SAAS,SAAS,qBAAqB;EAC5D,OAAO,GAAG,EAAE,GAAG,aAAa,YAAY,EAAE,gBAAgB;EAC1D;CACF;CAGA,MAAM,YAAY,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI;CAExC,MAAM,eAAe,gBAAgB,SAAS;CAC9C,IAAI,gBAAgB,UAAU,YAAY;CAE1C,MAAM,EAAE,SAAS,mBAAmB,WAAW,CAAC;CAEhD,IAAI,WAAW,QAAQ,SAAS,GAAG;EACjC,IAAI,cAAc,QAAQ;GACxB,MAAM,gBAAgB,KAAK,UAAU,OAAO;GAC5C,gBAAgB,cAAc,QAAQ,YAAU,aAAa;EAC/D,OAAO;GACL,MAAM,gBAAgB,IAAI,QAAQ,KAAK,WAAW,IAAI,OAAO,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;GAC5E,gBAAgB,cAAc,QAAQ,qBAAqB,aAAa;EAC1E;CACF;CAEA,IAAI,gBACF,gBAAgB,cAAc,QAC5B,yBACA,cACF;CAGF,MAAM,UAAU,KAAK,SAAS,MAAM,GAAG,eAAe,MAAM;CAC5D,OAAO,GAAG,EAAE,WAAW,aAAa,MAAM,GAAG;AAC/C"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/initConfig/index.ts"],"sourcesContent":["import { writeFile } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport { colorizePath, logger, v } from '@intlayer/config/logger';\nimport {\n  type configurationFilesCandidates,\n  searchConfigurationFile,\n} from '@intlayer/config/node';\n\ntype ConfigFormat = 'ts' | 'cjs' | 'mjs' | 'js' | 'json';\n\nconst getTemplatePath = (format: ConfigFormat) => {\n  switch (format) {\n    case 'ts':\n      return './templates/ts.txt';\n    case 'cjs':\n      return './templates/cjs.txt';\n    case 'mjs':\n      return './templates/mjs.txt';\n    case 'js':\n      return './templates/mjs.txt';\n    case 'json':\n      return './templates/json.txt';\n    default:\n      return './templates/ts.txt';\n  }\n};\n\n/** Values injected into the configuration file template. */\nexport type InitConfigOptions = {\n  /** Locales detected in the project, inserted into `internationalization.locales`. */\n  locales?: string[];\n  /**\n   * Dev-server URL of the detected framework, inserted as\n   * `editor.applicationURL` (the template defaults to `http://localhost:3000`).\n   */\n  applicationURL?: string;\n};\n\n/**\n * Initialize the Intlayer configuration file. No-ops when a configuration file\n * already exists at `baseDir`.\n *\n * @returns `true` when the file was created, `false` when one already existed.\n */\nexport const initConfig = async (\n  format: (typeof configurationFilesCandidates)[number],\n  baseDir: string,\n  options?: InitConfigOptions\n): Promise<boolean> => {\n  //   Search for configuration file\n  const { configurationFilePath } = searchConfigurationFile(baseDir);\n\n  //   return if the configuration file is found\n  if (configurationFilePath) {\n    const relativePath = relative(baseDir, configurationFilePath);\n    logger(`${v} ${colorizePath(relativePath)} already exists`);\n    return false;\n  }\n\n  // Extract the format from the filename (e.g. 'intlayer.config.ts' -> 'ts')\n  const extension = format.split('.').pop() as ConfigFormat;\n\n  const templatePath = getTemplatePath(extension);\n  let configContent = readAsset(templatePath);\n\n  const { locales, applicationURL } = options ?? {};\n\n  if (locales && locales.length > 0) {\n    if (extension === 'json') {\n      const localesString = JSON.stringify(locales);\n      configContent = configContent.replace('[\"en\"]', localesString);\n    } else {\n      const localesString = `[${locales.map((locale) => `'${locale}'`).join(', ')}]`;\n      configContent = configContent.replace('[Locales.ENGLISH]', localesString);\n    }\n  }\n\n  if (applicationURL) {\n    configContent = configContent.replace(\n      'http://localhost:3000',\n      applicationURL\n    );\n  }\n\n  await writeFile(join(baseDir, format), configContent, 'utf8');\n  logger(`${v} Created ${colorizePath(format)}`);\n  return true;\n};\n"],"mappings":";;;;;;;AAWA,MAAM,mBAAmB,WAAyB;CAChD,QAAQ,QAAR;EACE,KAAK,MACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,MACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;;;;AAmBA,MAAa,aAAa,OACxB,QACA,SACA,YACqB;CAErB,MAAM,EAAE,0BAA0B,wBAAwB,OAAO;CAGjE,IAAI,uBAAuB;EACzB,MAAM,eAAe,SAAS,SAAS,qBAAqB;EAC5D,OAAO,GAAG,EAAE,GAAG,aAAa,YAAY,EAAE,gBAAgB;EAC1D,OAAO;CACT;CAGA,MAAM,YAAY,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI;CAExC,MAAM,eAAe,gBAAgB,SAAS;CAC9C,IAAI,gBAAgB,UAAU,YAAY;CAE1C,MAAM,EAAE,SAAS,mBAAmB,WAAW,CAAC;CAEhD,IAAI,WAAW,QAAQ,SAAS,GAAG;EACjC,IAAI,cAAc,QAAQ;GACxB,MAAM,gBAAgB,KAAK,UAAU,OAAO;GAC5C,gBAAgB,cAAc,QAAQ,YAAU,aAAa;EAC/D,OAAO;GACL,MAAM,gBAAgB,IAAI,QAAQ,KAAK,WAAW,IAAI,OAAO,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;GAC5E,gBAAgB,cAAc,QAAQ,qBAAqB,aAAa;EAC1E;CACF;CAEA,IAAI,gBACF,gBAAgB,cAAc,QAC5B,yBACA,cACF;CAGF,MAAM,UAAU,KAAK,SAAS,MAAM,GAAG,eAAe,MAAM;CAC5D,OAAO,GAAG,EAAE,WAAW,aAAa,MAAM,GAAG;CAC7C,OAAO;AACT"}

package/dist/esm/installMCP/installMCP.mjs

@@ -14,7 +14,7 @@ const installMCP = async (projectRoot, platform, transport) => {
 	let configKey = "mcpServers";
 	if (platform === "Claude") configPath = CLAUDE_DESKTOP_CONFIG_PATH;
 	else {
-		const relativeDir = path.dirname(PLATFORMS_METADATA[platform].dir);
+		const relativeDir = path.dirname(PLATFORMS_METADATA[platform]?.dir ?? ".");
 		configPath = path.join(projectRoot, relativeDir, MCP_CONFIG_FILENAME);
 		if (platform === "VSCode") configKey = "servers";
 	}

package/dist/esm/installMCP/installMCP.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"installMCP.mjs","names":["fs"],"sources":["../../../src/installMCP/installMCP.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { PLATFORMS_METADATA, type Platform } from '../installSkills';\n\nexport type MCPTransport = 'stdio' | 'sse';\n\nconst MCP_CONFIG_FILENAME = 'mcp.json';\n\nconst CLAUDE_DESKTOP_CONFIG_PATH =\n  process.platform === 'win32'\n    ? path.join(\n        process.env.APPDATA || '',\n        'Claude',\n        'claude_desktop_config.json'\n      )\n    : path.join(\n        os.homedir(),\n        'Library',\n        'Application Support',\n        'Claude',\n        'claude_desktop_config.json'\n      );\n\n/**\n * Installs the Intlayer MCP server configuration for a specific platform.\n */\nexport const installMCP = async (\n  projectRoot: string,\n  platform: Platform,\n  transport: MCPTransport\n): Promise<string> => {\n  let configPath: string;\n  let configKey = 'mcpServers';\n\n  if (platform === 'Claude') {\n    configPath = CLAUDE_DESKTOP_CONFIG_PATH;\n  } else {\n    const relativeDir = path.dirname(PLATFORMS_METADATA[platform].dir); // e.g. .cursor or .vscode\n    configPath = path.join(projectRoot, relativeDir, MCP_CONFIG_FILENAME);\n\n    if (platform === 'VSCode') {\n      configKey = 'servers';\n    }\n  }\n\n  // Ensure the configuration directory exists\n  await fs.mkdir(path.dirname(configPath), { recursive: true });\n\n  let config: any = {};\n  try {\n    const content = await fs.readFile(configPath, 'utf-8');\n    config = JSON.parse(content);\n  } catch {\n    // File doesn't exist or is invalid JSON, start fresh\n  }\n\n  if (!config[configKey]) {\n    config[configKey] = {};\n  }\n\n  if (transport === 'stdio') {\n    const mcpConfig: any = {\n      command: 'npx',\n      args: ['-y', '@intlayer/mcp'],\n    };\n\n    if (platform === 'VSCode') {\n      mcpConfig.type = 'stdio';\n    }\n\n    config[configKey].intlayer = mcpConfig;\n  } else {\n    const mcpConfig: any = {\n      url: 'https://mcp.intlayer.org',\n    };\n\n    if (platform === 'VSCode') {\n      mcpConfig.type = 'sse';\n    } else {\n      mcpConfig.transport = 'sse';\n    }\n\n    config[configKey].intlayer = mcpConfig;\n  }\n\n  await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');\n\n  return `MCP server configuration updated in ${configPath}`;\n};\n"],"mappings":";;;;;;AAOA,MAAM,sBAAsB;AAE5B,MAAM,6BACJ,QAAQ,aAAa,UACjB,KAAK,KACH,QAAQ,IAAI,WAAW,IACvB,UACA,4BACF,IACA,KAAK,KACH,GAAG,QAAQ,GACX,WACA,uBACA,UACA,4BACF;;;;AAKN,MAAa,aAAa,OACxB,aACA,UACA,cACoB;CACpB,IAAI;CACJ,IAAI,YAAY;CAEhB,IAAI,aAAa,UACf,aAAa;MACR;EACL,MAAM,cAAc,KAAK,QAAQ,mBAAmB,SAAS,CAAC,GAAG;EACjE,aAAa,KAAK,KAAK,aAAa,aAAa,mBAAmB;EAEpE,IAAI,aAAa,UACf,YAAY;CAEhB;CAGA,MAAMA,SAAG,MAAM,KAAK,QAAQ,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;CAE5D,IAAI,SAAc,CAAC;CACnB,IAAI;EACF,MAAM,UAAU,MAAMA,SAAG,SAAS,YAAY,OAAO;EACrD,SAAS,KAAK,MAAM,OAAO;CAC7B,QAAQ,CAER;CAEA,IAAI,CAAC,OAAO,YACV,OAAO,aAAa,CAAC;CAGvB,IAAI,cAAc,SAAS;EACzB,MAAM,YAAiB;GACrB,SAAS;GACT,MAAM,CAAC,MAAM,eAAe;EAC9B;EAEA,IAAI,aAAa,UACf,UAAU,OAAO;EAGnB,OAAO,UAAU,CAAC,WAAW;CAC/B,OAAO;EACL,MAAM,YAAiB,EACrB,KAAK,2BACP;EAEA,IAAI,aAAa,UACf,UAAU,OAAO;OAEjB,UAAU,YAAY;EAGxB,OAAO,UAAU,CAAC,WAAW;CAC/B;CAEA,MAAMA,SAAG,UAAU,YAAY,KAAK,UAAU,QAAQ,MAAM,CAAC,GAAG,OAAO;CAEvE,OAAO,uCAAuC;AAChD"}
+{"version":3,"file":"installMCP.mjs","names":["fs"],"sources":["../../../src/installMCP/installMCP.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { PLATFORMS_METADATA, type Platform } from '../installSkills';\n\nexport type MCPTransport = 'stdio' | 'sse';\n\nconst MCP_CONFIG_FILENAME = 'mcp.json';\n\nconst CLAUDE_DESKTOP_CONFIG_PATH =\n  process.platform === 'win32'\n    ? path.join(\n        process.env.APPDATA || '',\n        'Claude',\n        'claude_desktop_config.json'\n      )\n    : path.join(\n        os.homedir(),\n        'Library',\n        'Application Support',\n        'Claude',\n        'claude_desktop_config.json'\n      );\n\n/**\n * Installs the Intlayer MCP server configuration for a specific platform.\n */\nexport const installMCP = async (\n  projectRoot: string,\n  platform: Platform,\n  transport: MCPTransport\n): Promise<string> => {\n  let configPath: string;\n  let configKey = 'mcpServers';\n\n  if (platform === 'Claude') {\n    configPath = CLAUDE_DESKTOP_CONFIG_PATH;\n  } else {\n    const relativeDir = path.dirname(PLATFORMS_METADATA[platform]?.dir ?? '.'); // e.g. .cursor or .vscode\n    configPath = path.join(projectRoot, relativeDir, MCP_CONFIG_FILENAME);\n\n    if (platform === 'VSCode') {\n      configKey = 'servers';\n    }\n  }\n\n  // Ensure the configuration directory exists\n  await fs.mkdir(path.dirname(configPath), { recursive: true });\n\n  let config: any = {};\n  try {\n    const content = await fs.readFile(configPath, 'utf-8');\n    config = JSON.parse(content);\n  } catch {\n    // File doesn't exist or is invalid JSON, start fresh\n  }\n\n  if (!config[configKey]) {\n    config[configKey] = {};\n  }\n\n  if (transport === 'stdio') {\n    const mcpConfig: any = {\n      command: 'npx',\n      args: ['-y', '@intlayer/mcp'],\n    };\n\n    if (platform === 'VSCode') {\n      mcpConfig.type = 'stdio';\n    }\n\n    config[configKey].intlayer = mcpConfig;\n  } else {\n    const mcpConfig: any = {\n      url: 'https://mcp.intlayer.org',\n    };\n\n    if (platform === 'VSCode') {\n      mcpConfig.type = 'sse';\n    } else {\n      mcpConfig.transport = 'sse';\n    }\n\n    config[configKey].intlayer = mcpConfig;\n  }\n\n  await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');\n\n  return `MCP server configuration updated in ${configPath}`;\n};\n"],"mappings":";;;;;;AAOA,MAAM,sBAAsB;AAE5B,MAAM,6BACJ,QAAQ,aAAa,UACjB,KAAK,KACH,QAAQ,IAAI,WAAW,IACvB,UACA,4BACF,IACA,KAAK,KACH,GAAG,QAAQ,GACX,WACA,uBACA,UACA,4BACF;;;;AAKN,MAAa,aAAa,OACxB,aACA,UACA,cACoB;CACpB,IAAI;CACJ,IAAI,YAAY;CAEhB,IAAI,aAAa,UACf,aAAa;MACR;EACL,MAAM,cAAc,KAAK,QAAQ,mBAAmB,SAAS,EAAE,OAAO,GAAG;EACzE,aAAa,KAAK,KAAK,aAAa,aAAa,mBAAmB;EAEpE,IAAI,aAAa,UACf,YAAY;CAEhB;CAGA,MAAMA,SAAG,MAAM,KAAK,QAAQ,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;CAE5D,IAAI,SAAc,CAAC;CACnB,IAAI;EACF,MAAM,UAAU,MAAMA,SAAG,SAAS,YAAY,OAAO;EACrD,SAAS,KAAK,MAAM,OAAO;CAC7B,QAAQ,CAER;CAEA,IAAI,CAAC,OAAO,YACV,OAAO,aAAa,CAAC;CAGvB,IAAI,cAAc,SAAS;EACzB,MAAM,YAAiB;GACrB,SAAS;GACT,MAAM,CAAC,MAAM,eAAe;EAC9B;EAEA,IAAI,aAAa,UACf,UAAU,OAAO;EAGnB,OAAO,UAAU,CAAC,WAAW;CAC/B,OAAO;EACL,MAAM,YAAiB,EACrB,KAAK,2BACP;EAEA,IAAI,aAAa,UACf,UAAU,OAAO;OAEjB,UAAU,YAAY;EAGxB,OAAO,UAAU,CAAC,WAAW;CAC/B;CAEA,MAAMA,SAAG,UAAU,YAAY,KAAK,UAAU,QAAQ,MAAM,CAAC,GAAG,OAAO;CAEvE,OAAO,uCAAuC;AAChD"}

package/dist/esm/loadDictionaries/loadLocalDictionaries.mjs

@@ -12,8 +12,10 @@ const loadLocalDictionaries = async (contentDeclarationsPaths, configuration) =>
 	for await (const contentDeclarationPath of contentDeclarationsPaths) {
 		const dictionary = await loadContentDeclarations([contentDeclarationPath], configuration);
 		const relativeFilePath = relative(baseDir, contentDeclarationPath);
+		const firstDict = dictionary[0];
+		if (!firstDict) continue;
 		const dictionaryWithPath = {
-			...dictionary[0],
+			...firstDict,
 			filePath: relativeFilePath
 		};
 		result.push(dictionaryWithPath);

package/dist/esm/loadDictionaries/loadLocalDictionaries.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadLocalDictionaries.mjs","names":[],"sources":["../../../src/loadDictionaries/loadLocalDictionaries.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { loadContentDeclarations } from './loadContentDeclaration';\n\nexport const loadLocalDictionaries = async (\n  contentDeclarationsPaths: string[] | string,\n  configuration: IntlayerConfig\n): Promise<Dictionary[]> => {\n  const { system } = configuration;\n  const { dictionariesDir, baseDir } = system;\n\n  if (typeof contentDeclarationsPaths === 'string') {\n    contentDeclarationsPaths = [contentDeclarationsPaths];\n  }\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(dictionariesDir), { recursive: true });\n\n  const result: Dictionary[] = [];\n\n  for await (const contentDeclarationPath of contentDeclarationsPaths) {\n    const dictionary = await loadContentDeclarations(\n      [contentDeclarationPath],\n      configuration\n    );\n\n    const relativeFilePath = relative(baseDir, contentDeclarationPath);\n\n    const dictionaryWithPath: Dictionary = {\n      ...dictionary[0],\n      filePath: relativeFilePath,\n    };\n\n    result.push(dictionaryWithPath);\n  }\n\n  return result;\n};\n"],"mappings":";;;;;AAMA,MAAa,wBAAwB,OACnC,0BACA,kBAC0B;CAC1B,MAAM,EAAE,WAAW;CACnB,MAAM,EAAE,iBAAiB,YAAY;CAErC,IAAI,OAAO,6BAA6B,UACtC,2BAA2B,CAAC,wBAAwB;CAItD,MAAM,MAAM,QAAQ,eAAe,GAAG,EAAE,WAAW,KAAK,CAAC;CAEzD,MAAM,SAAuB,CAAC;CAE9B,WAAW,MAAM,0BAA0B,0BAA0B;EACnE,MAAM,aAAa,MAAM,wBACvB,CAAC,sBAAsB,GACvB,aACF;EAEA,MAAM,mBAAmB,SAAS,SAAS,sBAAsB;EAEjE,MAAM,qBAAiC;GACrC,GAAG,WAAW;GACd,UAAU;EACZ;EAEA,OAAO,KAAK,kBAAkB;CAChC;CAEA,OAAO;AACT"}
+{"version":3,"file":"loadLocalDictionaries.mjs","names":[],"sources":["../../../src/loadDictionaries/loadLocalDictionaries.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { loadContentDeclarations } from './loadContentDeclaration';\n\nexport const loadLocalDictionaries = async (\n  contentDeclarationsPaths: string[] | string,\n  configuration: IntlayerConfig\n): Promise<Dictionary[]> => {\n  const { system } = configuration;\n  const { dictionariesDir, baseDir } = system;\n\n  if (typeof contentDeclarationsPaths === 'string') {\n    contentDeclarationsPaths = [contentDeclarationsPaths];\n  }\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(dictionariesDir), { recursive: true });\n\n  const result: Dictionary[] = [];\n\n  for await (const contentDeclarationPath of contentDeclarationsPaths) {\n    const dictionary = await loadContentDeclarations(\n      [contentDeclarationPath],\n      configuration\n    );\n\n    const relativeFilePath = relative(baseDir, contentDeclarationPath);\n\n    const firstDict = dictionary[0];\n    if (!firstDict) continue;\n\n    const dictionaryWithPath: Dictionary = {\n      ...firstDict,\n      filePath: relativeFilePath,\n    };\n\n    result.push(dictionaryWithPath);\n  }\n\n  return result;\n};\n"],"mappings":";;;;;AAMA,MAAa,wBAAwB,OACnC,0BACA,kBAC0B;CAC1B,MAAM,EAAE,WAAW;CACnB,MAAM,EAAE,iBAAiB,YAAY;CAErC,IAAI,OAAO,6BAA6B,UACtC,2BAA2B,CAAC,wBAAwB;CAItD,MAAM,MAAM,QAAQ,eAAe,GAAG,EAAE,WAAW,KAAK,CAAC;CAEzD,MAAM,SAAuB,CAAC;CAE9B,WAAW,MAAM,0BAA0B,0BAA0B;EACnE,MAAM,aAAa,MAAM,wBACvB,CAAC,sBAAsB,GACvB,aACF;EAEA,MAAM,mBAAmB,SAAS,SAAS,sBAAsB;EAEjE,MAAM,YAAY,WAAW;EAC7B,IAAI,CAAC,WAAW;EAEhB,MAAM,qBAAiC;GACrC,GAAG;GACH,UAAU;EACZ;EAEA,OAAO,KAAK,kBAAkB;CAChC;CAEA,OAAO;AACT"}

package/dist/esm/loadDictionaries/loadRemoteDictionaries.mjs

@@ -29,7 +29,7 @@ const loadRemoteDictionaries = async (configuration = getConfiguration(), onStat
 			return data.updatedAt > localUpdatedAt;
 		});
 		const cachedDictionaries = Object.values(remoteDictionariesRecord).flat().filter((dictionary) => {
-			const remoteUpdatedAt = distantDictionaryUpdateTimeStamp[dictionary.id].updatedAt;
+			const remoteUpdatedAt = dictionary.id ? distantDictionaryUpdateTimeStamp[dictionary.id]?.updatedAt : void 0;
 			const localUpdatedAtRaw = dictionary.updatedAt;
 			const localUpdatedAt = typeof localUpdatedAtRaw === "number" ? localUpdatedAtRaw : localUpdatedAtRaw ? new Date(localUpdatedAtRaw).getTime() : void 0;
 			return typeof localUpdatedAt === "number" && typeof remoteUpdatedAt === "number" && localUpdatedAt >= remoteUpdatedAt;

package/dist/esm/loadDictionaries/loadRemoteDictionaries.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadRemoteDictionaries.mjs","names":[],"sources":["../../../src/loadDictionaries/loadRemoteDictionaries.ts"],"sourcesContent":["import { createIntlayerCMS } from '@intlayer/api';\nimport { dictionaryEndpoint } from '@intlayer/api/dictionary';\n// @ts-ignore @intlayer/backend is not build yet\nimport type { DictionaryAPI } from '@intlayer/backend';\nimport { getConfiguration } from '@intlayer/config/node';\nimport { getRemoteDictionaries } from '@intlayer/dictionaries-entry/remote';\nimport type {\n  Dictionary,\n  DictionaryId,\n  DictionaryKey,\n} from '@intlayer/types/dictionary';\nimport { fetchDistantDictionaries } from '../fetchDistantDictionaries';\nimport { sortAlphabetically } from '../utils/sortAlphabetically';\nimport type { DictionariesStatus } from './loadDictionaries';\n\nexport const formatDistantDictionaries = (\n  dictionaries: (DictionaryAPI | Dictionary)[]\n): Dictionary[] =>\n  dictionaries.map((dict) => ({\n    ...dict,\n    localId: `${dict.key}::remote::${dict.id}`,\n    location: 'remote' as const,\n  }));\n\nexport const loadRemoteDictionaries = async (\n  configuration = getConfiguration(),\n  onStatusUpdate?: (status: DictionariesStatus[]) => void,\n  options?: {\n    onStartRemoteCheck?: () => void;\n    onStopRemoteCheck?: () => void;\n    onError?: (error: Error) => void;\n  }\n): Promise<Dictionary[]> => {\n  const { editor } = configuration;\n  const remoteDictionariesRecord = getRemoteDictionaries(configuration);\n\n  const hasRemoteDictionaries = Boolean(editor.clientId && editor.clientSecret);\n\n  if (!hasRemoteDictionaries) return [];\n\n  try {\n    options?.onStartRemoteCheck?.();\n\n    const dictionary = dictionaryEndpoint(createIntlayerCMS(configuration));\n\n    // Get the list of dictionary keys\n    const getDictionariesKeysResult =\n      await dictionary.getDictionariesUpdateTimestamp();\n\n    const distantDictionaryUpdateTimeStamp: Record<\n      DictionaryId,\n      { key: DictionaryKey; updatedAt: number }\n    > | null = getDictionariesKeysResult.data;\n\n    if (!distantDictionaryUpdateTimeStamp) {\n      throw new Error('No distant dictionaries found');\n    }\n\n    const dictionariesIdToFetch = Object.entries(\n      distantDictionaryUpdateTimeStamp\n    ).filter(([dictionaryId, data]) => {\n      // If remote doesn't provide updatedAt, fetch to be safe\n      if (!data.updatedAt) return true;\n\n      // If no local cache exists, fetch\n      const local: Dictionary | undefined = remoteDictionariesRecord[\n        data.key\n      ]?.find((dictionary) => dictionary.id === dictionaryId);\n      if (!local) return true;\n\n      const localUpdatedAtRaw = (local as any)?.updatedAt as\n        | number\n        | string\n        | undefined;\n\n      const localUpdatedAt =\n        typeof localUpdatedAtRaw === 'number'\n          ? localUpdatedAtRaw\n          : localUpdatedAtRaw\n            ? new Date(localUpdatedAtRaw).getTime()\n            : undefined;\n\n      // If local timestamp missing or older than remote, fetch\n      if (typeof localUpdatedAt !== 'number') return true;\n\n      return data.updatedAt > localUpdatedAt;\n    });\n\n    const flatRemoteDictionariesRecord: DictionaryAPI[] = Object.values(\n      remoteDictionariesRecord\n    ).flat();\n\n    const cachedDictionaries: Dictionary[] =\n      flatRemoteDictionariesRecord.filter((dictionary) => {\n        const remoteUpdatedAt =\n          distantDictionaryUpdateTimeStamp[dictionary.id!].updatedAt;\n\n        const localUpdatedAtRaw = dictionary.updatedAt;\n\n        const localUpdatedAt =\n          typeof localUpdatedAtRaw === 'number'\n            ? localUpdatedAtRaw\n            : localUpdatedAtRaw\n              ? new Date(localUpdatedAtRaw).getTime()\n              : undefined;\n\n        // Consider as cached/imported when local exists and is up-to-date or newer\n        return (\n          typeof localUpdatedAt === 'number' &&\n          typeof remoteUpdatedAt === 'number' &&\n          localUpdatedAt >= remoteUpdatedAt\n        );\n      });\n\n    // Report cached as already imported\n    if (cachedDictionaries.length > 0) {\n      onStatusUpdate?.(\n        cachedDictionaries.map((dictionary) => ({\n          dictionaryKey: dictionary.key,\n          type: 'remote',\n          status: 'imported',\n        }))\n      );\n    }\n\n    // Several qualified dictionaries can share a key, so keys are deduplicated:\n    // one request per key already returns all of its siblings.\n    const orderedDistantDictionaryKeys = [\n      ...new Set(dictionariesIdToFetch.map(([, data]) => data.key)),\n    ].sort(sortAlphabetically);\n\n    // Report pending for keys to be fetched so totals are visible immediately\n    if (orderedDistantDictionaryKeys.length > 0) {\n      onStatusUpdate?.(\n        orderedDistantDictionaryKeys.map((key) => ({\n          dictionaryKey: key,\n          type: 'remote',\n          status: 'pending',\n        }))\n      );\n    }\n\n    const distantDictionariesData = await fetchDistantDictionaries(\n      {\n        dictionaryKeys: orderedDistantDictionaryKeys,\n      },\n      onStatusUpdate\n    );\n\n    const distantDictionaries: Dictionary[] = formatDistantDictionaries(\n      distantDictionariesData\n    );\n\n    // Fetching by key also returns the up-to-date siblings of a stale\n    // dictionary, so drop the cached copies the remote just sent back.\n    const fetchedDictionaryIds = new Set(\n      distantDictionaries.map((dictionary) => dictionary.id)\n    );\n\n    const notRefetchedCachedDictionaries = cachedDictionaries.filter(\n      (dictionary) => !fetchedDictionaryIds.has(dictionary.id)\n    );\n\n    return [...notRefetchedCachedDictionaries, ...distantDictionaries];\n  } catch (error) {\n    options?.onError?.(error as Error);\n    return [];\n  } finally {\n    options?.onStopRemoteCheck?.();\n  }\n};\n"],"mappings":";;;;;;;;AAeA,MAAa,6BACX,iBAEA,aAAa,KAAK,UAAU;CAC1B,GAAG;CACH,SAAS,GAAG,KAAK,IAAI,YAAY,KAAK;CACtC,UAAU;AACZ,EAAE;AAEJ,MAAa,yBAAyB,OACpC,gBAAgB,iBAAiB,GACjC,gBACA,YAK0B;CAC1B,MAAM,EAAE,WAAW;CACnB,MAAM,2BAA2B,sBAAsB,aAAa;CAIpE,IAAI,CAF0B,QAAQ,OAAO,YAAY,OAAO,YAEvC,GAAG,OAAO,CAAC;CAEpC,IAAI;EACF,SAAS,qBAAqB;EAQ9B,MAAM,oCAGK,MATQ,mBAAmB,kBAAkB,aAAa,CAIpD,CAAC,CAAC,+BAA+B,EAKd,CAAC;EAErC,IAAI,CAAC,kCACH,MAAM,IAAI,MAAM,+BAA+B;EAGjD,MAAM,wBAAwB,OAAO,QACnC,gCACF,CAAC,CAAC,QAAQ,CAAC,cAAc,UAAU;GAEjC,IAAI,CAAC,KAAK,WAAW,OAAO;GAG5B,MAAM,QAAgC,yBACpC,KAAK,IACN,EAAE,MAAM,eAAe,WAAW,OAAO,YAAY;GACtD,IAAI,CAAC,OAAO,OAAO;GAEnB,MAAM,oBAAqB,OAAe;GAK1C,MAAM,iBACJ,OAAO,sBAAsB,WACzB,oBACA,oBACE,IAAI,KAAK,iBAAiB,CAAC,CAAC,QAAQ,IACpC;GAGR,IAAI,OAAO,mBAAmB,UAAU,OAAO;GAE/C,OAAO,KAAK,YAAY;EAC1B,CAAC;EAMD,MAAM,qBAJgD,OAAO,OAC3D,wBACF,CAAC,CAAC,KAG2B,CAAC,CAAC,QAAQ,eAAe;GAClD,MAAM,kBACJ,iCAAiC,WAAW,GAAI,CAAC;GAEnD,MAAM,oBAAoB,WAAW;GAErC,MAAM,iBACJ,OAAO,sBAAsB,WACzB,oBACA,oBACE,IAAI,KAAK,iBAAiB,CAAC,CAAC,QAAQ,IACpC;GAGR,OACE,OAAO,mBAAmB,YAC1B,OAAO,oBAAoB,YAC3B,kBAAkB;EAEtB,CAAC;EAGH,IAAI,mBAAmB,SAAS,GAC9B,iBACE,mBAAmB,KAAK,gBAAgB;GACtC,eAAe,WAAW;GAC1B,MAAM;GACN,QAAQ;EACV,EAAE,CACJ;EAKF,MAAM,+BAA+B,CACnC,GAAG,IAAI,IAAI,sBAAsB,KAAK,GAAG,UAAU,KAAK,GAAG,CAAC,CAC9D,CAAC,CAAC,KAAK,kBAAkB;EAGzB,IAAI,6BAA6B,SAAS,GACxC,iBACE,6BAA6B,KAAK,SAAS;GACzC,eAAe;GACf,MAAM;GACN,QAAQ;EACV,EAAE,CACJ;EAGF,MAAM,0BAA0B,MAAM,yBACpC,EACE,gBAAgB,6BAClB,GACA,cACF;EAEA,MAAM,sBAAoC,0BACxC,uBACF;EAIA,MAAM,uBAAuB,IAAI,IAC/B,oBAAoB,KAAK,eAAe,WAAW,EAAE,CACvD;EAMA,OAAO,CAAC,GAJ+B,mBAAmB,QACvD,eAAe,CAAC,qBAAqB,IAAI,WAAW,EAAE,CAGjB,GAAG,GAAG,mBAAmB;CACnE,SAAS,OAAO;EACd,SAAS,UAAU,KAAc;EACjC,OAAO,CAAC;CACV,UAAU;EACR,SAAS,oBAAoB;CAC/B;AACF"}
+{"version":3,"file":"loadRemoteDictionaries.mjs","names":[],"sources":["../../../src/loadDictionaries/loadRemoteDictionaries.ts"],"sourcesContent":["import { createIntlayerCMS } from '@intlayer/api';\nimport { dictionaryEndpoint } from '@intlayer/api/dictionary';\n// @ts-ignore @intlayer/backend is not build yet\nimport type { DictionaryAPI } from '@intlayer/backend';\nimport { getConfiguration } from '@intlayer/config/node';\nimport { getRemoteDictionaries } from '@intlayer/dictionaries-entry/remote';\nimport type {\n  Dictionary,\n  DictionaryId,\n  DictionaryKey,\n} from '@intlayer/types/dictionary';\nimport { fetchDistantDictionaries } from '../fetchDistantDictionaries';\nimport { sortAlphabetically } from '../utils/sortAlphabetically';\nimport type { DictionariesStatus } from './loadDictionaries';\n\nexport const formatDistantDictionaries = (\n  dictionaries: (DictionaryAPI | Dictionary)[]\n): Dictionary[] =>\n  dictionaries.map((dict) => ({\n    ...dict,\n    localId: `${dict.key}::remote::${dict.id}`,\n    location: 'remote' as const,\n  }));\n\nexport const loadRemoteDictionaries = async (\n  configuration = getConfiguration(),\n  onStatusUpdate?: (status: DictionariesStatus[]) => void,\n  options?: {\n    onStartRemoteCheck?: () => void;\n    onStopRemoteCheck?: () => void;\n    onError?: (error: Error) => void;\n  }\n): Promise<Dictionary[]> => {\n  const { editor } = configuration;\n  const remoteDictionariesRecord = getRemoteDictionaries(configuration);\n\n  const hasRemoteDictionaries = Boolean(editor.clientId && editor.clientSecret);\n\n  if (!hasRemoteDictionaries) return [];\n\n  try {\n    options?.onStartRemoteCheck?.();\n\n    const dictionary = dictionaryEndpoint(createIntlayerCMS(configuration));\n\n    // Get the list of dictionary keys\n    const getDictionariesKeysResult =\n      await dictionary.getDictionariesUpdateTimestamp();\n\n    const distantDictionaryUpdateTimeStamp: Record<\n      DictionaryId,\n      { key: DictionaryKey; updatedAt: number }\n    > | null = getDictionariesKeysResult.data;\n\n    if (!distantDictionaryUpdateTimeStamp) {\n      throw new Error('No distant dictionaries found');\n    }\n\n    const dictionariesIdToFetch = Object.entries(\n      distantDictionaryUpdateTimeStamp\n    ).filter(([dictionaryId, data]) => {\n      // If remote doesn't provide updatedAt, fetch to be safe\n      if (!data.updatedAt) return true;\n\n      // If no local cache exists, fetch\n      const local: Dictionary | undefined = remoteDictionariesRecord[\n        data.key\n      ]?.find((dictionary) => dictionary.id === dictionaryId);\n      if (!local) return true;\n\n      const localUpdatedAtRaw = (local as any)?.updatedAt as\n        | number\n        | string\n        | undefined;\n\n      const localUpdatedAt =\n        typeof localUpdatedAtRaw === 'number'\n          ? localUpdatedAtRaw\n          : localUpdatedAtRaw\n            ? new Date(localUpdatedAtRaw).getTime()\n            : undefined;\n\n      // If local timestamp missing or older than remote, fetch\n      if (typeof localUpdatedAt !== 'number') return true;\n\n      return data.updatedAt > localUpdatedAt;\n    });\n\n    const flatRemoteDictionariesRecord: DictionaryAPI[] = Object.values(\n      remoteDictionariesRecord\n    ).flat();\n\n    const cachedDictionaries: Dictionary[] =\n      flatRemoteDictionariesRecord.filter((dictionary) => {\n        const remoteUpdatedAt = dictionary.id\n          ? distantDictionaryUpdateTimeStamp[dictionary.id]?.updatedAt\n          : undefined;\n\n        const localUpdatedAtRaw = dictionary.updatedAt;\n\n        const localUpdatedAt =\n          typeof localUpdatedAtRaw === 'number'\n            ? localUpdatedAtRaw\n            : localUpdatedAtRaw\n              ? new Date(localUpdatedAtRaw).getTime()\n              : undefined;\n\n        // Consider as cached/imported when local exists and is up-to-date or newer\n        return (\n          typeof localUpdatedAt === 'number' &&\n          typeof remoteUpdatedAt === 'number' &&\n          localUpdatedAt >= remoteUpdatedAt\n        );\n      });\n\n    // Report cached as already imported\n    if (cachedDictionaries.length > 0) {\n      onStatusUpdate?.(\n        cachedDictionaries.map((dictionary) => ({\n          dictionaryKey: dictionary.key,\n          type: 'remote',\n          status: 'imported',\n        }))\n      );\n    }\n\n    // Several qualified dictionaries can share a key, so keys are deduplicated:\n    // one request per key already returns all of its siblings.\n    const orderedDistantDictionaryKeys = [\n      ...new Set(dictionariesIdToFetch.map(([, data]) => data.key)),\n    ].sort(sortAlphabetically);\n\n    // Report pending for keys to be fetched so totals are visible immediately\n    if (orderedDistantDictionaryKeys.length > 0) {\n      onStatusUpdate?.(\n        orderedDistantDictionaryKeys.map((key) => ({\n          dictionaryKey: key,\n          type: 'remote',\n          status: 'pending',\n        }))\n      );\n    }\n\n    const distantDictionariesData = await fetchDistantDictionaries(\n      {\n        dictionaryKeys: orderedDistantDictionaryKeys,\n      },\n      onStatusUpdate\n    );\n\n    const distantDictionaries: Dictionary[] = formatDistantDictionaries(\n      distantDictionariesData\n    );\n\n    // Fetching by key also returns the up-to-date siblings of a stale\n    // dictionary, so drop the cached copies the remote just sent back.\n    const fetchedDictionaryIds = new Set(\n      distantDictionaries.map((dictionary) => dictionary.id)\n    );\n\n    const notRefetchedCachedDictionaries = cachedDictionaries.filter(\n      (dictionary) => !fetchedDictionaryIds.has(dictionary.id)\n    );\n\n    return [...notRefetchedCachedDictionaries, ...distantDictionaries];\n  } catch (error) {\n    options?.onError?.(error as Error);\n    return [];\n  } finally {\n    options?.onStopRemoteCheck?.();\n  }\n};\n"],"mappings":";;;;;;;;AAeA,MAAa,6BACX,iBAEA,aAAa,KAAK,UAAU;CAC1B,GAAG;CACH,SAAS,GAAG,KAAK,IAAI,YAAY,KAAK;CACtC,UAAU;AACZ,EAAE;AAEJ,MAAa,yBAAyB,OACpC,gBAAgB,iBAAiB,GACjC,gBACA,YAK0B;CAC1B,MAAM,EAAE,WAAW;CACnB,MAAM,2BAA2B,sBAAsB,aAAa;CAIpE,IAAI,CAF0B,QAAQ,OAAO,YAAY,OAAO,YAEvC,GAAG,OAAO,CAAC;CAEpC,IAAI;EACF,SAAS,qBAAqB;EAQ9B,MAAM,oCAGK,MATQ,mBAAmB,kBAAkB,aAAa,CAIpD,CAAC,CAAC,+BAA+B,EAKd,CAAC;EAErC,IAAI,CAAC,kCACH,MAAM,IAAI,MAAM,+BAA+B;EAGjD,MAAM,wBAAwB,OAAO,QACnC,gCACF,CAAC,CAAC,QAAQ,CAAC,cAAc,UAAU;GAEjC,IAAI,CAAC,KAAK,WAAW,OAAO;GAG5B,MAAM,QAAgC,yBACpC,KAAK,IACN,EAAE,MAAM,eAAe,WAAW,OAAO,YAAY;GACtD,IAAI,CAAC,OAAO,OAAO;GAEnB,MAAM,oBAAqB,OAAe;GAK1C,MAAM,iBACJ,OAAO,sBAAsB,WACzB,oBACA,oBACE,IAAI,KAAK,iBAAiB,CAAC,CAAC,QAAQ,IACpC;GAGR,IAAI,OAAO,mBAAmB,UAAU,OAAO;GAE/C,OAAO,KAAK,YAAY;EAC1B,CAAC;EAMD,MAAM,qBAJgD,OAAO,OAC3D,wBACF,CAAC,CAAC,KAG2B,CAAC,CAAC,QAAQ,eAAe;GAClD,MAAM,kBAAkB,WAAW,KAC/B,iCAAiC,WAAW,GAAG,EAAE,YACjD;GAEJ,MAAM,oBAAoB,WAAW;GAErC,MAAM,iBACJ,OAAO,sBAAsB,WACzB,oBACA,oBACE,IAAI,KAAK,iBAAiB,CAAC,CAAC,QAAQ,IACpC;GAGR,OACE,OAAO,mBAAmB,YAC1B,OAAO,oBAAoB,YAC3B,kBAAkB;EAEtB,CAAC;EAGH,IAAI,mBAAmB,SAAS,GAC9B,iBACE,mBAAmB,KAAK,gBAAgB;GACtC,eAAe,WAAW;GAC1B,MAAM;GACN,QAAQ;EACV,EAAE,CACJ;EAKF,MAAM,+BAA+B,CACnC,GAAG,IAAI,IAAI,sBAAsB,KAAK,GAAG,UAAU,KAAK,GAAG,CAAC,CAC9D,CAAC,CAAC,KAAK,kBAAkB;EAGzB,IAAI,6BAA6B,SAAS,GACxC,iBACE,6BAA6B,KAAK,SAAS;GACzC,eAAe;GACf,MAAM;GACN,QAAQ;EACV,EAAE,CACJ;EAGF,MAAM,0BAA0B,MAAM,yBACpC,EACE,gBAAgB,6BAClB,GACA,cACF;EAEA,MAAM,sBAAoC,0BACxC,uBACF;EAIA,MAAM,uBAAuB,IAAI,IAC/B,oBAAoB,KAAK,eAAe,WAAW,EAAE,CACvD;EAMA,OAAO,CAAC,GAJ+B,mBAAmB,QACvD,eAAe,CAAC,qBAAqB,IAAI,WAAW,EAAE,CAGjB,GAAG,GAAG,mBAAmB;CACnE,SAAS,OAAO;EACd,SAAS,UAAU,KAAc;EACjC,OAAO,CAAC;CACV,UAAU;EACR,SAAS,oBAAoB;CAC/B;AACF"}

package/dist/esm/loadDictionaries/log.mjs

@@ -106,7 +106,7 @@ var DictionariesLogger = class {
 	}
 	render() {
 		const { localTotal, localDone, remoteTotal, remoteDone, pluginTotal, pluginDone } = this.computeProgress();
-		const frame = this.spinnerFrames[this.spinnerIndex];
+		const frame = this.spinnerFrames[this.spinnerIndex] ?? "";
 		const clock = colorize(frame, ANSIColors.BLUE);
 		const lines = [];
 		const isLocalDone = localDone === localTotal;

package/dist/esm/loadDictionaries/log.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"log.mjs","names":[],"sources":["../../../src/loadDictionaries/log.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colorize,\n  getPrefix,\n  spinnerFrames,\n  v,\n  x,\n} from '@intlayer/config/logger';\nimport { extractErrorMessage } from '@intlayer/config/utils';\nimport type { DictionariesStatus } from './loadDictionaries';\n\nexport class DictionariesLogger {\n  private statuses: DictionariesStatus[] = [];\n  private spinnerTimer: NodeJS.Timeout | null = null;\n  private spinnerIndex = 0;\n  private renderedLines = 0;\n  private readonly spinnerFrames = spinnerFrames;\n  private isFinished = false;\n  private readonly prefix: string;\n  private lastRenderedState: string = '';\n  private remoteCheckInProgress = false;\n  private expectRemote = false;\n  private remoteError: string | undefined;\n  private pluginTotal = 0;\n  private pluginDone = 0;\n  private pluginNames: string[] = [];\n  private pluginError: string | undefined;\n\n  constructor() {\n    this.prefix = getPrefix(log?.prefix) ?? '';\n  }\n\n  setExpectRemote(expect: boolean) {\n    this.expectRemote = expect;\n  }\n\n  startRemoteCheck() {\n    if (this.isFinished) return;\n    this.remoteCheckInProgress = true;\n    this.startSpinner();\n    this.render();\n  }\n\n  stopRemoteCheck() {\n    this.remoteCheckInProgress = false;\n  }\n\n  update(newStatuses: DictionariesStatus[]) {\n    if (this.isFinished) return;\n    for (const status of newStatuses) {\n      const index = this.statuses.findIndex(\n        (s) =>\n          s.dictionaryKey === status.dictionaryKey && s.type === status.type\n      );\n      if (index >= 0) {\n        this.statuses[index] = status;\n      } else {\n        this.statuses.push(status);\n      }\n    }\n\n    // If we expect remote fetch later, avoid rendering a local-only line first\n    const { remoteTotal } = this.computeProgress();\n    if (this.expectRemote && !this.remoteCheckInProgress && remoteTotal === 0) {\n      // Do not start spinner or render yet; wait until remote check starts\n      return;\n    }\n\n    this.startSpinner();\n    this.render();\n  }\n\n  finish() {\n    this.isFinished = true;\n    this.stopSpinner();\n    // Render final state and keep it visible\n    this.render();\n  }\n\n  private startSpinner() {\n    if (this.spinnerTimer || this.isFinished) return;\n    this.spinnerTimer = setInterval(() => {\n      this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;\n      this.render();\n    }, 100);\n  }\n\n  private stopSpinner() {\n    if (!this.spinnerTimer) return;\n    clearInterval(this.spinnerTimer);\n    this.spinnerTimer = null;\n  }\n\n  public setRemoteError = (error?: Error) => {\n    this.remoteError = extractErrorMessage(error);\n    // Avoid rendering a transient remote-only line while the remote check flag is still true\n    // Ensure local + remote are rendered together after a failure\n    this.stopRemoteCheck();\n    this.render();\n  };\n\n  /**\n   * Register the names of the plugins providing dictionaries.\n   * They are displayed next to the plugin progress counters, e.g.\n   * `Plugin content: 6/6 (sync-json, load-po)`.\n   *\n   * @param names - Names of the plugins exposing a `loadDictionaries` hook\n   */\n  setPluginNames(names: string[]) {\n    if (this.isFinished) return;\n    // Guard against plugins declared without a name at runtime\n    this.pluginNames = names.filter((name) => Boolean(name));\n    this.render();\n  }\n\n  setPluginTotal(total: number) {\n    if (this.isFinished) return;\n    this.pluginTotal = total;\n    if (total > 0) {\n      this.startSpinner();\n    }\n    this.render();\n  }\n\n  setPluginDone(done: number) {\n    if (this.isFinished) return;\n    this.pluginDone = done;\n    this.render();\n  }\n\n  /**\n   * Flag the plugin line as errored.\n   *\n   * @param error - Error thrown while loading the plugin dictionaries\n   * @param pluginName - Name of the plugin that threw, prefixed to the message\n   */\n  setPluginError(error?: Error, pluginName?: string) {\n    if (this.isFinished) return;\n    const errorMessage = extractErrorMessage(error);\n    this.pluginError = pluginName\n      ? `${pluginName}: ${errorMessage}`\n      : errorMessage;\n    this.render();\n  }\n\n  private render() {\n    const {\n      localTotal,\n      localDone,\n      remoteTotal,\n      remoteDone,\n      pluginTotal,\n      pluginDone,\n    } = this.computeProgress();\n\n    const frame = this.spinnerFrames[this.spinnerIndex];\n    const clock = colorize(frame, ANSIColors.BLUE);\n    const lines: string[] = [];\n\n    const isLocalDone = localDone === localTotal;\n    const isRemoteDone = remoteDone === remoteTotal;\n    const isPluginDone = pluginDone === pluginTotal;\n\n    const suppressLocalWhileCheckingRemote =\n      this.expectRemote && this.remoteCheckInProgress && remoteTotal === 0;\n\n    if (!suppressLocalWhileCheckingRemote) {\n      if (isLocalDone) {\n        lines.push(\n          `${this.prefix} ${v} Local content: ${colorize(`${localDone}`, ANSIColors.GREEN)}${colorize(`/${localTotal}`, ANSIColors.GREY)}`\n        );\n      } else {\n        lines.push(\n          `${this.prefix} ${clock} Local content: ${colorize(`${localDone}`, ANSIColors.BLUE)}${colorize(`/${localTotal}`, ANSIColors.GREY)}`\n        );\n      }\n    }\n\n    // Single remote line: show error, check, or progress counts\n    if (remoteTotal > 0 || this.remoteCheckInProgress || this.remoteError) {\n      if (this.remoteError) {\n        lines.push(\n          `${this.prefix} ${x} Remote content: ${colorize(\n            this.remoteError,\n            ANSIColors.RED\n          )}`\n        );\n      } else if (remoteTotal === 0) {\n        lines.push(\n          `${this.prefix} ${clock} Remote content: ${colorize('Check server', ANSIColors.BLUE)}`\n        );\n      } else if (isRemoteDone) {\n        lines.push(\n          `${this.prefix} ${v} Remote content: ${colorize(`${remoteDone}`, ANSIColors.GREEN)}${colorize(`/${remoteTotal}`, ANSIColors.GREY)}`\n        );\n      } else {\n        lines.push(\n          `${this.prefix} ${clock} Remote content: ${colorize(`${remoteDone}`, ANSIColors.BLUE)}${colorize(`/${remoteTotal}`, ANSIColors.GREY)}`\n        );\n      }\n    }\n\n    // Plugin line: show error or progress counts, suffixed by the plugin names\n    if (pluginTotal > 0 || this.pluginError) {\n      const pluginNamesSuffix =\n        this.pluginNames.length > 0\n          ? colorize(` (${this.pluginNames.join(', ')})`, ANSIColors.GREY)\n          : '';\n\n      if (this.pluginError) {\n        lines.push(\n          `${this.prefix} ${x} Plugin content: ${colorize(\n            this.pluginError,\n            ANSIColors.RED\n          )}`\n        );\n      } else if (isPluginDone) {\n        lines.push(\n          `${this.prefix} ${v} Plugin content: ${colorize(`${pluginDone}`, ANSIColors.GREEN)}${colorize(`/${pluginTotal}`, ANSIColors.GREY)}${pluginNamesSuffix}`\n        );\n      } else {\n        lines.push(\n          `${this.prefix} ${clock} Plugin content: ${colorize(`${pluginDone}`, ANSIColors.BLUE)}${colorize(`/${pluginTotal}`, ANSIColors.GREY)}${pluginNamesSuffix}`\n        );\n      }\n    }\n\n    // Check if the state has changed to avoid duplicate rendering\n    const currentState = lines.join('\\n');\n    if (currentState === this.lastRenderedState) {\n      return;\n    }\n    this.lastRenderedState = currentState;\n\n    if (this.renderedLines > 0) {\n      process.stdout.write(`\\x1b[${this.renderedLines}F`);\n    }\n\n    const totalLinesToClear = Math.max(this.renderedLines, lines.length);\n    for (let i = 0; i < totalLinesToClear; i++) {\n      process.stdout.write('\\x1b[2K');\n      const line = lines[i];\n      if (line !== undefined) {\n        process.stdout.write(line);\n      }\n      process.stdout.write('\\n');\n    }\n\n    this.renderedLines = lines.length;\n  }\n\n  private computeProgress() {\n    const localKeys = new Set(\n      this.statuses\n        .filter((s) => s.type === 'local')\n        .map((s) => s.dictionaryKey)\n    );\n\n    const localDoneKeys = new Set(\n      this.statuses\n        .filter(\n          (s) =>\n            s.type === 'local' && (s.status === 'built' || s.status === 'error')\n        )\n        .map((s) => s.dictionaryKey)\n    );\n\n    const remoteKeys = new Set(\n      this.statuses\n        .filter((s) => s.type === 'remote')\n        .map((s) => s.dictionaryKey)\n    );\n\n    const remoteDoneKeys = new Set(\n      this.statuses\n        .filter(\n          (s) =>\n            s.type === 'remote' &&\n            (s.status === 'fetched' ||\n              s.status === 'imported' ||\n              s.status === 'error')\n        )\n        .map((s) => s.dictionaryKey)\n    );\n\n    return {\n      localTotal: localKeys.size,\n      localDone: localDoneKeys.size,\n      remoteTotal: remoteKeys.size,\n      remoteDone: remoteDoneKeys.size,\n      pluginTotal: this.pluginTotal,\n      pluginDone: this.pluginDone,\n    } as const;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"log.mjs","names":[],"sources":["../../../src/loadDictionaries/log.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport {\n  colorize,\n  getPrefix,\n  spinnerFrames,\n  v,\n  x,\n} from '@intlayer/config/logger';\nimport { extractErrorMessage } from '@intlayer/config/utils';\nimport type { DictionariesStatus } from './loadDictionaries';\n\nexport class DictionariesLogger {\n  private statuses: DictionariesStatus[] = [];\n  private spinnerTimer: NodeJS.Timeout | null = null;\n  private spinnerIndex = 0;\n  private renderedLines = 0;\n  private readonly spinnerFrames = spinnerFrames;\n  private isFinished = false;\n  private readonly prefix: string;\n  private lastRenderedState: string = '';\n  private remoteCheckInProgress = false;\n  private expectRemote = false;\n  private remoteError: string | undefined;\n  private pluginTotal = 0;\n  private pluginDone = 0;\n  private pluginNames: string[] = [];\n  private pluginError: string | undefined;\n\n  constructor() {\n    this.prefix = getPrefix(log?.prefix) ?? '';\n  }\n\n  setExpectRemote(expect: boolean) {\n    this.expectRemote = expect;\n  }\n\n  startRemoteCheck() {\n    if (this.isFinished) return;\n    this.remoteCheckInProgress = true;\n    this.startSpinner();\n    this.render();\n  }\n\n  stopRemoteCheck() {\n    this.remoteCheckInProgress = false;\n  }\n\n  update(newStatuses: DictionariesStatus[]) {\n    if (this.isFinished) return;\n    for (const status of newStatuses) {\n      const index = this.statuses.findIndex(\n        (s) =>\n          s.dictionaryKey === status.dictionaryKey && s.type === status.type\n      );\n      if (index >= 0) {\n        this.statuses[index] = status;\n      } else {\n        this.statuses.push(status);\n      }\n    }\n\n    // If we expect remote fetch later, avoid rendering a local-only line first\n    const { remoteTotal } = this.computeProgress();\n    if (this.expectRemote && !this.remoteCheckInProgress && remoteTotal === 0) {\n      // Do not start spinner or render yet; wait until remote check starts\n      return;\n    }\n\n    this.startSpinner();\n    this.render();\n  }\n\n  finish() {\n    this.isFinished = true;\n    this.stopSpinner();\n    // Render final state and keep it visible\n    this.render();\n  }\n\n  private startSpinner() {\n    if (this.spinnerTimer || this.isFinished) return;\n    this.spinnerTimer = setInterval(() => {\n      this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;\n      this.render();\n    }, 100);\n  }\n\n  private stopSpinner() {\n    if (!this.spinnerTimer) return;\n    clearInterval(this.spinnerTimer);\n    this.spinnerTimer = null;\n  }\n\n  public setRemoteError = (error?: Error) => {\n    this.remoteError = extractErrorMessage(error);\n    // Avoid rendering a transient remote-only line while the remote check flag is still true\n    // Ensure local + remote are rendered together after a failure\n    this.stopRemoteCheck();\n    this.render();\n  };\n\n  /**\n   * Register the names of the plugins providing dictionaries.\n   * They are displayed next to the plugin progress counters, e.g.\n   * `Plugin content: 6/6 (sync-json, load-po)`.\n   *\n   * @param names - Names of the plugins exposing a `loadDictionaries` hook\n   */\n  setPluginNames(names: string[]) {\n    if (this.isFinished) return;\n    // Guard against plugins declared without a name at runtime\n    this.pluginNames = names.filter((name) => Boolean(name));\n    this.render();\n  }\n\n  setPluginTotal(total: number) {\n    if (this.isFinished) return;\n    this.pluginTotal = total;\n    if (total > 0) {\n      this.startSpinner();\n    }\n    this.render();\n  }\n\n  setPluginDone(done: number) {\n    if (this.isFinished) return;\n    this.pluginDone = done;\n    this.render();\n  }\n\n  /**\n   * Flag the plugin line as errored.\n   *\n   * @param error - Error thrown while loading the plugin dictionaries\n   * @param pluginName - Name of the plugin that threw, prefixed to the message\n   */\n  setPluginError(error?: Error, pluginName?: string) {\n    if (this.isFinished) return;\n    const errorMessage = extractErrorMessage(error);\n    this.pluginError = pluginName\n      ? `${pluginName}: ${errorMessage}`\n      : errorMessage;\n    this.render();\n  }\n\n  private render() {\n    const {\n      localTotal,\n      localDone,\n      remoteTotal,\n      remoteDone,\n      pluginTotal,\n      pluginDone,\n    } = this.computeProgress();\n\n    const frame = this.spinnerFrames[this.spinnerIndex] ?? '';\n    const clock = colorize(frame, ANSIColors.BLUE);\n    const lines: string[] = [];\n\n    const isLocalDone = localDone === localTotal;\n    const isRemoteDone = remoteDone === remoteTotal;\n    const isPluginDone = pluginDone === pluginTotal;\n\n    const suppressLocalWhileCheckingRemote =\n      this.expectRemote && this.remoteCheckInProgress && remoteTotal === 0;\n\n    if (!suppressLocalWhileCheckingRemote) {\n      if (isLocalDone) {\n        lines.push(\n          `${this.prefix} ${v} Local content: ${colorize(`${localDone}`, ANSIColors.GREEN)}${colorize(`/${localTotal}`, ANSIColors.GREY)}`\n        );\n      } else {\n        lines.push(\n          `${this.prefix} ${clock} Local content: ${colorize(`${localDone}`, ANSIColors.BLUE)}${colorize(`/${localTotal}`, ANSIColors.GREY)}`\n        );\n      }\n    }\n\n    // Single remote line: show error, check, or progress counts\n    if (remoteTotal > 0 || this.remoteCheckInProgress || this.remoteError) {\n      if (this.remoteError) {\n        lines.push(\n          `${this.prefix} ${x} Remote content: ${colorize(\n            this.remoteError,\n            ANSIColors.RED\n          )}`\n        );\n      } else if (remoteTotal === 0) {\n        lines.push(\n          `${this.prefix} ${clock} Remote content: ${colorize('Check server', ANSIColors.BLUE)}`\n        );\n      } else if (isRemoteDone) {\n        lines.push(\n          `${this.prefix} ${v} Remote content: ${colorize(`${remoteDone}`, ANSIColors.GREEN)}${colorize(`/${remoteTotal}`, ANSIColors.GREY)}`\n        );\n      } else {\n        lines.push(\n          `${this.prefix} ${clock} Remote content: ${colorize(`${remoteDone}`, ANSIColors.BLUE)}${colorize(`/${remoteTotal}`, ANSIColors.GREY)}`\n        );\n      }\n    }\n\n    // Plugin line: show error or progress counts, suffixed by the plugin names\n    if (pluginTotal > 0 || this.pluginError) {\n      const pluginNamesSuffix =\n        this.pluginNames.length > 0\n          ? colorize(` (${this.pluginNames.join(', ')})`, ANSIColors.GREY)\n          : '';\n\n      if (this.pluginError) {\n        lines.push(\n          `${this.prefix} ${x} Plugin content: ${colorize(\n            this.pluginError,\n            ANSIColors.RED\n          )}`\n        );\n      } else if (isPluginDone) {\n        lines.push(\n          `${this.prefix} ${v} Plugin content: ${colorize(`${pluginDone}`, ANSIColors.GREEN)}${colorize(`/${pluginTotal}`, ANSIColors.GREY)}${pluginNamesSuffix}`\n        );\n      } else {\n        lines.push(\n          `${this.prefix} ${clock} Plugin content: ${colorize(`${pluginDone}`, ANSIColors.BLUE)}${colorize(`/${pluginTotal}`, ANSIColors.GREY)}${pluginNamesSuffix}`\n        );\n      }\n    }\n\n    // Check if the state has changed to avoid duplicate rendering\n    const currentState = lines.join('\\n');\n    if (currentState === this.lastRenderedState) {\n      return;\n    }\n    this.lastRenderedState = currentState;\n\n    if (this.renderedLines > 0) {\n      process.stdout.write(`\\x1b[${this.renderedLines}F`);\n    }\n\n    const totalLinesToClear = Math.max(this.renderedLines, lines.length);\n    for (let i = 0; i < totalLinesToClear; i++) {\n      process.stdout.write('\\x1b[2K');\n      const line = lines[i];\n      if (line !== undefined) {\n        process.stdout.write(line);\n      }\n      process.stdout.write('\\n');\n    }\n\n    this.renderedLines = lines.length;\n  }\n\n  private computeProgress() {\n    const localKeys = new Set(\n      this.statuses\n        .filter((s) => s.type === 'local')\n        .map((s) => s.dictionaryKey)\n    );\n\n    const localDoneKeys = new Set(\n      this.statuses\n        .filter(\n          (s) =>\n            s.type === 'local' && (s.status === 'built' || s.status === 'error')\n        )\n        .map((s) => s.dictionaryKey)\n    );\n\n    const remoteKeys = new Set(\n      this.statuses\n        .filter((s) => s.type === 'remote')\n        .map((s) => s.dictionaryKey)\n    );\n\n    const remoteDoneKeys = new Set(\n      this.statuses\n        .filter(\n          (s) =>\n            s.type === 'remote' &&\n            (s.status === 'fetched' ||\n              s.status === 'imported' ||\n              s.status === 'error')\n        )\n        .map((s) => s.dictionaryKey)\n    );\n\n    return {\n      localTotal: localKeys.size,\n      localDone: localDoneKeys.size,\n      remoteTotal: remoteKeys.size,\n      remoteDone: remoteDoneKeys.size,\n      pluginTotal: this.pluginTotal,\n      pluginDone: this.pluginDone,\n    } as const;\n  }\n}\n"],"mappings":"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"}