@intlayer/engine 9.5.9-canary.0 → 9.5.10

package/dist/cjs/init/utils/packageManager.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"packageManager.cjs","names":["readFileSync","join","existsSync","resolve","dirname"],"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.cjs","names":["readFileSync","join","existsSync","resolve","dirname","isVersionAtLeast"],"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/cjs/init/utils/urlRoutingFramework.cjs

@@ -0,0 +1,41 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#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
+exports.hasUrlRoutingFramework = hasUrlRoutingFramework;
+//# sourceMappingURL=urlRoutingFramework.cjs.map

package/dist/cjs/init/utils/urlRoutingFramework.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlRoutingFramework.cjs","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/cjs/initConfig/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require__utils_asset = require('../_virtual/_utils_asset.cjs');
-let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_config_node = require("@intlayer/config/node");
+let node_fs_promises = require("node:fs/promises");
 
 //#region src/initConfig/index.ts
 const getTemplatePath = (format) => {
@@ -19,13 +19,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 } = (0, _intlayer_config_node.searchConfigurationFile)(baseDir);
 	if (configurationFilePath) {
 		const relativePath = (0, node_path.relative)(baseDir, configurationFilePath);
 		(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} ${(0, _intlayer_config_logger.colorizePath)(relativePath)} already exists`);
-		return;
+		return false;
 	}
 	const extension = format.split(".").pop();
 	const templatePath = getTemplatePath(extension);
@@ -43,6 +45,7 @@ const initConfig = async (format, baseDir, options) => {
 	if (applicationURL) configContent = configContent.replace("http://localhost:3000", applicationURL);
 	await (0, node_fs_promises.writeFile)((0, node_path.join)(baseDir, format), configContent, "utf8");
 	(0, _intlayer_config_logger.logger)(`${_intlayer_config_logger.v} Created ${(0, _intlayer_config_logger.colorizePath)(format)}`);
+	return true;
 };
 
 //#endregion

package/dist/cjs/initConfig/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["searchConfigurationFile","relative","v","colorizePath","readAsset","writeFile","join"],"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,8BAA0BA,+CAAwB,OAAO;CAGjE,IAAI,uBAAuB;EACzB,MAAM,mBAAeC,oBAAS,SAAS,qBAAqB;EAC5D,oCAAO,GAAGC,0BAAE,OAAGC,sCAAa,YAAY,EAAE,gBAAgB;EAC1D;CACF;CAGA,MAAM,YAAY,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI;CAExC,MAAM,eAAe,gBAAgB,SAAS;CAC9C,IAAI,gBAAgBC,+BAAU,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,UAAMC,gCAAUC,gBAAK,SAAS,MAAM,GAAG,eAAe,MAAM;CAC5D,oCAAO,GAAGJ,0BAAE,eAAWC,sCAAa,MAAM,GAAG;AAC/C"}
+{"version":3,"file":"index.cjs","names":["searchConfigurationFile","relative","v","colorizePath","readAsset","writeFile","join"],"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,8BAA0BA,+CAAwB,OAAO;CAGjE,IAAI,uBAAuB;EACzB,MAAM,mBAAeC,oBAAS,SAAS,qBAAqB;EAC5D,oCAAO,GAAGC,0BAAE,OAAGC,sCAAa,YAAY,EAAE,gBAAgB;EAC1D,OAAO;CACT;CAGA,MAAM,YAAY,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI;CAExC,MAAM,eAAe,gBAAgB,SAAS;CAC9C,IAAI,gBAAgBC,+BAAU,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,UAAMC,gCAAUC,gBAAK,SAAS,MAAM,GAAG,eAAe,MAAM;CAC5D,oCAAO,GAAGJ,0BAAE,eAAWC,sCAAa,MAAM,GAAG;CAC7C,OAAO;AACT"}

package/dist/cjs/installLSP.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
-let node_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
+let node_fs = require("node:fs");
 
 //#region src/installLSP.ts
 const VSCODE_DIR = ".vscode";

package/dist/cjs/installMCP/installMCP.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_installSkills_index = require('../installSkills/index.cjs');
-let node_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
+let node_fs = require("node:fs");
 let node_os = require("node:os");
 node_os = require_runtime.__toESM(node_os);
 

package/dist/cjs/installSkills/index.cjs

@@ -1,11 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require__utils_asset = require('../_virtual/_utils_asset.cjs');
-let node_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
 let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_core_markdown = require("@intlayer/core/markdown");
+let node_fs = require("node:fs");
 
 //#region src/installSkills/index.ts
 /**

package/dist/cjs/listDictionariesPath.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
-let node_fs_promises = require("node:fs/promises");
 let _intlayer_config_utils = require("@intlayer/config/utils");
 let fast_glob = require("fast-glob");
 fast_glob = require_runtime.__toESM(fast_glob);
+let node_fs_promises = require("node:fs/promises");
 
 //#region src/listDictionariesPath.ts
 /**

package/dist/cjs/listGitFiles.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
-let node_fs = require("node:fs");
 let node_path = require("node:path");
 let _intlayer_config_logger = require("@intlayer/config/logger");
+let node_fs = require("node:fs");
 let _intlayer_config_built = require("@intlayer/config/built");
 let simple_git = require("simple-git");
 simple_git = require_runtime.__toESM(simple_git);

package/dist/cjs/loadDictionaries/getIntlayerBundle.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
-let _intlayer_config_file = require("@intlayer/config/file");
 let _intlayer_config_utils = require("@intlayer/config/utils");
+let node_fs_promises = require("node:fs/promises");
+let _intlayer_config_file = require("@intlayer/config/file");
 let node_module = require("node:module");
 
 //#region src/loadDictionaries/getIntlayerBundle.ts

package/dist/cjs/loadDictionaries/index.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_loadDictionaries_loadContentDeclaration = require('./loadContentDeclaration.cjs');
-const require_loadDictionaries_loadLocalDictionaries = require('./loadLocalDictionaries.cjs');
 const require_loadDictionaries_loadRemoteDictionaries = require('./loadRemoteDictionaries.cjs');
 const require_loadDictionaries_loadDictionaries = require('./loadDictionaries.cjs');
+const require_loadDictionaries_loadLocalDictionaries = require('./loadLocalDictionaries.cjs');
 
 exports.ensureIntlayerBundle = require_loadDictionaries_loadContentDeclaration.ensureIntlayerBundle;
 exports.formatDistantDictionaries = require_loadDictionaries_loadRemoteDictionaries.formatDistantDictionaries;

package/dist/cjs/loadDictionaries/loadContentDeclaration.cjs

@@ -6,10 +6,10 @@ const require_loadDictionaries_getIntlayerBundle = require('./getIntlayerBundle.
 const require_loadDictionaries_loadMarkdownContentDeclaration = require('./loadMarkdownContentDeclaration.cjs');
 const require_loadDictionaries_loadYamlContentDeclaration = require('./loadYamlContentDeclaration.cjs');
 const require_loadDictionaries_logTypeScriptErrors = require('./logTypeScriptErrors.cjs');
-let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
-let _intlayer_config_file = require("@intlayer/config/file");
 let _intlayer_config_utils = require("@intlayer/config/utils");
+let node_fs_promises = require("node:fs/promises");
+let _intlayer_config_file = require("@intlayer/config/file");
 
 //#region src/loadDictionaries/loadContentDeclaration.ts
 const formatLocalDictionaries = (dictionariesRecord, configuration) => Object.entries(dictionariesRecord).map(([relativePath, dict]) => ({

package/dist/cjs/loadDictionaries/loadDictionaries.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_filterInvalidDictionaries = require('../filterInvalidDictionaries.cjs');
-const require_loadDictionaries_loadContentDeclaration = require('./loadContentDeclaration.cjs');
 const require_formatDictionary = require('../formatDictionary.cjs');
+const require_loadDictionaries_loadContentDeclaration = require('./loadContentDeclaration.cjs');
 const require_loadDictionaries_loadRemoteDictionaries = require('./loadRemoteDictionaries.cjs');
 const require_loadDictionaries_log = require('./log.cjs');
 let _intlayer_config_colors = require("@intlayer/config/colors");

package/dist/cjs/loadDictionaries/loadLocalDictionaries.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_loadDictionaries_loadContentDeclaration = require('./loadContentDeclaration.cjs');
-let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
 
 //#region src/loadDictionaries/loadLocalDictionaries.ts
 const loadLocalDictionaries = async (contentDeclarationsPaths, configuration) => {

package/dist/cjs/loadDictionaries/loadMarkdownContentDeclaration.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_utils_parseContentDeclarationFileName = require('../utils/parseContentDeclarationFileName.cjs');
-let node_fs_promises = require("node:fs/promises");
 let _intlayer_core_markdown = require("@intlayer/core/markdown");
 let _intlayer_types_nodeType = require("@intlayer/types/nodeType");
+let node_fs_promises = require("node:fs/promises");
 
 //#region src/loadDictionaries/loadMarkdownContentDeclaration.ts
 const loadMarkdownContentDeclaration = async (path, configuration) => {

package/dist/cjs/loadDictionaries/logTypeScriptErrors.cjs

@@ -3,60 +3,121 @@ let node_path = require("node:path");
 let _intlayer_config_logger = require("@intlayer/config/logger");
 
 //#region src/loadDictionaries/logTypeScriptErrors.ts
-const logTypeScriptErrors = async (filePaths, configuration) => {
-	const appLogger = (0, _intlayer_config_logger.getAppLogger)(configuration);
-	const filesToCheck = filePaths.filter((path) => {
-		const ext = (0, node_path.extname)(path);
-		return [
-			".ts",
-			".tsx",
-			".js",
-			".jsx",
-			".cjs",
-			".mjs",
-			".json"
-		].includes(ext);
-	});
-	if (filesToCheck.length === 0) return;
-	let ts;
-	try {
-		ts = (await import("typescript")).default || await import("typescript");
-	} catch {
-		return;
-	}
-	const configFileName = ts.findConfigFile(configuration.system?.baseDir ?? process.cwd(), ts.sys.fileExists, "tsconfig.json");
+const CHECKABLE_EXTENSIONS = [
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".cjs",
+	".mjs",
+	".json"
+];
+/**
+* Checks files with the classic compiler API (`typescript` <= 6), which is
+* exposed from the package root.
+*/
+const collectClassicTypeScriptErrors = (typescript, filePaths, baseDir) => {
+	const configFileName = typescript.findConfigFile(baseDir, typescript.sys.fileExists, "tsconfig.json");
 	let compilerOptions = {
 		noEmit: true,
 		allowJs: true,
 		resolveJsonModule: true
 	};
-	if (configFileName) {
-		const configFileText = ts.sys.readFile(configFileName);
-		if (configFileText) {
-			const configJson = ts.parseConfigFileTextToJson(configFileName, configFileText);
-			if (!configJson.error) {
-				const { incremental, tsBuildInfoFile, ...restOptions } = ts.parseJsonConfigFileContent(configJson.config, ts.sys, (0, node_path.dirname)(configFileName)).options;
-				compilerOptions = {
-					...compilerOptions,
-					...restOptions,
-					noEmit: true
-				};
-			}
+	const configFileText = configFileName ? typescript.sys.readFile(configFileName) : void 0;
+	if (configFileName && configFileText) {
+		const configJson = typescript.parseConfigFileTextToJson(configFileName, configFileText);
+		if (!configJson.error) {
+			const { incremental, tsBuildInfoFile, ...restOptions } = typescript.parseJsonConfigFileContent(configJson.config, typescript.sys, (0, node_path.dirname)(configFileName)).options;
+			compilerOptions = {
+				...compilerOptions,
+				...restOptions,
+				noEmit: true
+			};
 		}
 	}
-	const program = ts.createProgram(filesToCheck, compilerOptions);
-	filesToCheck.forEach((filePath) => {
+	const program = typescript.createProgram(filePaths, compilerOptions);
+	return filePaths.flatMap((filePath) => {
 		const sourceFile = program.getSourceFile(filePath);
-		if (!sourceFile) return;
-		ts.getPreEmitDiagnostics(program, sourceFile).forEach((diagnostic) => {
-			const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
-			if (diagnostic.file && diagnostic.start !== void 0) {
-				const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
-				appLogger(`TS Error in ${diagnostic.file.fileName} (${line + 1},${character + 1}): ${message}`, { level: "warn" });
-			}
+		if (!sourceFile) return [];
+		return typescript.getPreEmitDiagnostics(program, sourceFile).flatMap((diagnostic) => {
+			if (!diagnostic.file || diagnostic.start === void 0) return [];
+			const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
+			return {
+				fileName: diagnostic.file.fileName,
+				line,
+				character,
+				message: typescript.flattenDiagnosticMessageText(diagnostic.messageText, "\n")
+			};
 		});
 	});
 };
+/** Flattens a native diagnostic message chain, indenting nested messages. */
+const flattenNativeDiagnosticMessage = (diagnostic, depth = 0) => [`${"  ".repeat(depth)}${diagnostic.text}`, ...(diagnostic.messageChain ?? []).map((chainedDiagnostic) => flattenNativeDiagnosticMessage(chainedDiagnostic, depth + 1))].join("\n");
+/**
+* Checks files with the native API (`typescript` >= 7, Go port), whose root
+* export only exposes the version. It spawns the bundled `tsgo` binary, which
+* resolves the closest tsconfig of each file.
+*/
+const collectNativeTypeScriptErrors = (NativeAPI, filePaths, baseDir) => {
+	const api = new NativeAPI({ cwd: baseDir });
+	try {
+		const snapshot = api.updateSnapshot({ openFiles: filePaths });
+		try {
+			return filePaths.flatMap((filePath) => {
+				const program = snapshot.getDefaultProjectForFile(filePath)?.program;
+				const sourceFile = program?.getSourceFile(filePath);
+				if (!program || !sourceFile) return [];
+				return [...program.getSyntacticDiagnostics(filePath), ...program.getSemanticDiagnostics(filePath)].map((diagnostic) => {
+					const { line, character } = sourceFile.getLineAndCharacterOfPosition(diagnostic.pos);
+					return {
+						fileName: diagnostic.fileName ?? filePath,
+						line,
+						character,
+						message: flattenNativeDiagnosticMessage(diagnostic)
+					};
+				});
+			});
+		} finally {
+			snapshot.dispose();
+		}
+	} finally {
+		api.close();
+	}
+};
+/**
+* Resolves the installed TypeScript and returns its errors for the given
+* files, or `undefined` if TypeScript is not installed.
+*/
+const collectTypeScriptErrors = async (filePaths, baseDir) => {
+	let typescriptModule;
+	try {
+		typescriptModule = await import("typescript");
+	} catch {
+		return;
+	}
+	const classicTypeScript = typescriptModule.createProgram ? typescriptModule : typescriptModule.default;
+	if (classicTypeScript?.createProgram) return collectClassicTypeScriptErrors(classicTypeScript, filePaths, baseDir);
+	let nativeModule;
+	try {
+		nativeModule = await import("typescript/unstable/sync");
+	} catch {
+		return;
+	}
+	return collectNativeTypeScriptErrors(nativeModule.API, filePaths, baseDir);
+};
+/**
+* Type-checks content declaration files and logs errors as warnings.
+* Supports both the classic (`typescript` <= 6) and native (>= 7) compilers.
+*/
+const logTypeScriptErrors = async (filePaths, configuration) => {
+	const appLogger = (0, _intlayer_config_logger.getAppLogger)(configuration);
+	const baseDir = configuration.system?.baseDir ?? process.cwd();
+	const filesToCheck = filePaths.filter((filePath) => CHECKABLE_EXTENSIONS.includes((0, node_path.extname)(filePath))).map((filePath) => (0, node_path.resolve)(baseDir, filePath));
+	if (filesToCheck.length === 0) return;
+	(await collectTypeScriptErrors(filesToCheck, baseDir))?.forEach(({ fileName, line, character, message }) => {
+		appLogger(`TS Error in ${fileName} (${line + 1},${character + 1}): ${message}`, { level: "warn" });
+	});
+};
 
 //#endregion
 exports.logTypeScriptErrors = logTypeScriptErrors;