@intlayer/engine 9.3.1 → 9.3.3

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

@@ -1 +1 @@
-{"version":3,"file":"packageManager.cjs","names":["existsSync","join","readFileSync","compareVersions"],"sources":["../../../../src/init/utils/packageManager.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { compareVersions } from '@intlayer/config/utils';\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  /**\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/**\n * Detects the package manager in use by checking for lock files in the\n * project root. Falls back to npm when no lock file is found.\n */\nexport const detectPackageManager = (rootDir: string): PackageManager => {\n  if (\n    existsSync(join(rootDir, 'bun.lock')) ||\n    existsSync(join(rootDir, 'bun.lockb'))\n  ) {\n    return 'bun';\n  }\n  if (existsSync(join(rootDir, 'pnpm-lock.yaml'))) {\n    return 'pnpm';\n  }\n  if (existsSync(join(rootDir, 'yarn.lock'))) {\n    return 'yarn';\n  }\n  return 'npm';\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   * Extra package names injected by the interactive init prompt when the user\n   * selects a compat i18n library that is not yet in `package.json`.\n   * These are merged with the real dependency map before running detection so\n   * the correct sync plugin and compat adapter are scheduled for installation.\n   */\n  hintDependencies?: Record<string, string>;\n};\n\nexport const detectMissingIntlayerPackages = (\n  allDependencies: Record<string, string>,\n  options: DetectMissingPackagesOptions = {}\n): IntlayerPackageAnalysis => {\n  const packagesToInstall: string[] = [];\n  const devPackagesToInstall: string[] = [];\n  let compatSyncConfig: CompatSyncConfig | undefined;\n  let compatVitePluginConfig: CompatVitePluginConfig | undefined;\n\n  // Merge hint deps supplied by the interactive init prompt so that compat\n  // libraries the user declared (but hasn't installed yet) are treated the same\n  // as pre-existing deps when building the install and config lists.\n  const effectiveDependencies: Record<string, string> = {\n    ...allDependencies,\n    ...(options.hintDependencies ?? {}),\n  };\n\n  const isInstalled = (packageName: string): boolean =>\n    Boolean(effectiveDependencies[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  // Core package — always required\n  addIfMissing('intlayer');\n\n  // Framework-specific runtime integrations\n  if (isInstalled('next')) {\n    addIfMissing('next-intlayer');\n  } else if (isInstalled('react')) {\n    addIfMissing('react-intlayer');\n  }\n\n  // React Native / Expo — the Metro plugin lives in react-native-intlayer,\n  // installed as a dev dependency (it is only used by the bundler).\n  if (isInstalled('react-native') || isInstalled('expo')) {\n    addDevIfMissing('react-native-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  // -------------------------------------------------------------------------\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    addIfMissing('@intlayer/next-intl');\n    addIfMissing('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    addIfMissing('@intlayer/next-i18next');\n    addIfMissing('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    addIfMissing('@intlayer/next-translate');\n    addIfMissing('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    addIfMissing('@intlayer/i18next');\n    // Ensure the required peer dependency is installed\n    addIfMissing('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    addIfMissing('@intlayer/react-i18next');\n    // Ensure the required peer dependency is installed\n    addIfMissing('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    addIfMissing('@intlayer/vue-i18n');\n    addIfMissing('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    addIfMissing('@intlayer/use-intl');\n    addIfMissing('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    addIfMissing('@intlayer/react-intl');\n    addIfMissing('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    addIfMissing('@intlayer/transloco');\n    addIfMissing('@ngneat/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    addIfMissing('@intlayer/svelte-i18n');\n    addIfMissing('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    addIfMissing('@intlayer/polyglot');\n    addIfMissing('node-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    addIfMissing('@intlayer/nuxtjs-i18n');\n    addIfMissing('@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    addIfMissing('@intlayer/ngx-translate');\n    addIfMissing('@ngx-translate/core');\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    addIfMissing('@intlayer/lingui');\n    addIfMissing('@lingui/core');\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    addIfMissing('@intlayer/i18n-js');\n    addIfMissing('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    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`).\n */\nexport const isIntlayerPackageName = (packageName: string): boolean =>\n  packageName === 'intlayer' ||\n  packageName.startsWith('@intlayer/') ||\n  /-intlayer$/.test(packageName);\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  const match = version.match(/(\\d+)\\.(\\d+)\\.(\\d+)/);\n  return match ? `${match[1]}.${match[2]}.${match[3]}` : null;\n};\n\n/**\n * Reads the installed version of a package from its `package.json` inside the\n * project's `node_modules`. Returns `null` when the package is not installed or\n * its manifest cannot be read.\n */\nexport const getInstalledPackageVersion = (\n  rootDir: string,\n  packageName: string\n): string | null => {\n  try {\n    const manifestPath = join(\n      rootDir,\n      'node_modules',\n      packageName,\n      'package.json'\n    );\n    if (!existsSync(manifestPath)) return null;\n    const { version } = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n    return typeof version === 'string' ? version : null;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Returns the Intlayer packages from `dependencies` whose installed version is\n * behind `targetVersion` (compared on `major.minor.patch`). Packages that are\n * not installed yet are ignored — those are handled by\n * {@link detectMissingIntlayerPackages}.\n */\nexport const detectOutdatedIntlayerPackages = (\n  rootDir: string,\n  dependencies: Record<string, string>,\n  targetVersion: string\n): string[] => {\n  const normalizedTarget = normalizeVersion(targetVersion);\n  if (!normalizedTarget) return [];\n\n  return Object.keys(dependencies)\n    .filter(isIntlayerPackageName)\n    .filter((packageName) => {\n      const installedVersion = getInstalledPackageVersion(rootDir, packageName);\n      const normalizedInstalled = normalizeVersion(\n        installedVersion ?? undefined\n      );\n      if (!normalizedInstalled) return false;\n      return compareVersions(normalizedInstalled, '<', normalizedTarget);\n    });\n};\n\n/**\n * Upgrades the given packages to `targetVersion` synchronously, preserving the\n * dependency type via the `isDev` flag. Throws if the install process exits\n * with a non-zero code.\n */\nexport const upgradePackages = (\n  rootDir: string,\n  packages: string[],\n  packageManager: PackageManager,\n  targetVersion: string,\n  isDev: boolean = false\n): void => {\n  if (packages.length === 0) return;\n  const versionedPackages = packages.map(\n    (packageName) => `${packageName}@${targetVersion}`\n  );\n  const command = buildInstallCommand(packageManager, versionedPackages, isDev);\n  execSync(command, { cwd: rootDir, stdio: 'inherit' });\n};\n"],"mappings":";;;;;;;;;;;AAgGA,MAAa,wBAAwB,YAAoC;CACvE,QACEA,wBAAWC,gBAAK,SAAS,UAAU,CAAC,SACpCD,wBAAWC,gBAAK,SAAS,WAAW,CAAC,GAErC,OAAO;CAET,QAAID,wBAAWC,gBAAK,SAAS,gBAAgB,CAAC,GAC5C,OAAO;CAET,QAAID,wBAAWC,gBAAK,SAAS,WAAW,CAAC,GACvC,OAAO;CAET,OAAO;AACT;;;;AAKA,MAAM,uBACJ,gBACA,UACA,QAAiB,UACN;CACX,MAAM,cAAc,SAAS,KAAK,GAAG;CACrC,QAAQ,gBAAR;EACE,KAAK,OACH,OAAO,WAAW,QAAQ,QAAQ,KAAK;EACzC,KAAK,QACH,OAAO,YAAY,QAAQ,QAAQ,KAAK;EAC1C,KAAK,QACH,OAAO,YAAY,QAAQ,QAAQ,KAAK;EAC1C,KAAK,OACH,OAAO,eAAe,QAAQ,QAAQ,KAAK;CAC/C;AACF;AAwBA,MAAa,iCACX,iBACA,UAAwC,CAAC,MACb;CAC5B,MAAM,oBAA8B,CAAC;CACrC,MAAM,uBAAiC,CAAC;CACxC,IAAI;CACJ,IAAI;CAKJ,MAAM,wBAAgD;EACpD,GAAG;EACH,GAAI,QAAQ,oBAAoB,CAAC;CACnC;CAEA,MAAM,eAAe,gBACnB,QAAQ,sBAAsB,YAAY;CAE5C,MAAM,gBAAgB,gBAA8B;EAClD,IAAI,CAAC,YAAY,WAAW,GAC1B,kBAAkB,KAAK,WAAW;CAEtC;CAEA,MAAM,mBAAmB,gBAA8B;EACrD,IAAI,CAAC,YAAY,WAAW,GAC1B,qBAAqB,KAAK,WAAW;CAEzC;CAGA,aAAa,UAAU;CAGvB,IAAI,YAAY,MAAM,GACpB,aAAa,eAAe;MACvB,IAAI,YAAY,OAAO,GAC5B,aAAa,gBAAgB;CAK/B,IAAI,YAAY,cAAc,KAAK,YAAY,MAAM,GACnD,gBAAgB,uBAAuB;CAGzC,IAAI,YAAY,QAAQ,GACtB,aAAa,iBAAiB;CAGhC,IAAI,YAAY,UAAU,GACxB,aAAa,gBAAgB;CAG/B,IAAI,YAAY,eAAe,GAC7B,aAAa,kBAAkB;CAGjC,IAAI,YAAY,KAAK,GACnB,aAAa,cAAc;CAG7B,IAAI,YAAY,MAAM,GACpB,aAAa,eAAe;CAmB9B,IAAI,YAAY,WAAW,KAAK,YAAY,qBAAqB,GAAG;EAClE,aAAa,qBAAqB;EAClC,aAAa,WAAW;EACxB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;GAEhB,WAAW;EACb;CAEF;CAGA,IAAI,YAAY,cAAc,KAAK,YAAY,wBAAwB,GAAG;EACxE,aAAa,wBAAwB;EACrC,aAAa,cAAc;EAC3B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;CAEF;CAGA,IACE,YAAY,gBAAgB,KAC5B,YAAY,0BAA0B,GACtC;EACA,aAAa,0BAA0B;EACvC,aAAa,gBAAgB;EAC7B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;CAEF;CAIA,IAAI,YAAY,SAAS,KAAK,YAAY,mBAAmB,GAAG;EAC9D,aAAa,mBAAmB;EAEhC,aAAa,SAAS;EACtB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EAIA,IACE,CAAC,YAAY,eAAe,KAC5B,CAAC,YAAY,yBAAyB,GAEtC,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CAEJ;CAKA,IAAI,YAAY,eAAe,KAAK,YAAY,yBAAyB,GAAG;EAC1E,aAAa,yBAAyB;EAEtC,aAAa,eAAe;EAC5B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAGA,IAAI,YAAY,UAAU,KAAK,YAAY,oBAAoB,GAAG;EAChE,aAAa,oBAAoB;EACjC,aAAa,UAAU;EACvB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAMA,IAAI,YAAY,UAAU,KAAK,YAAY,oBAAoB,GAAG;EAChE,aAAa,oBAAoB;EACjC,aAAa,UAAU;EACvB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;GAEhB,WAAW;EACb;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAGA,IAAI,YAAY,YAAY,KAAK,YAAY,sBAAsB,GAAG;EACpE,aAAa,sBAAsB;EACnC,aAAa,YAAY;EACzB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAIA,IAAI,YAAY,mBAAmB,KAAK,YAAY,qBAAqB,GAAG;EAC1E,aAAa,qBAAqB;EAClC,aAAa,mBAAmB;EAChC,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAGA,IAAI,YAAY,aAAa,KAAK,YAAY,uBAAuB,GAAG;EACtE,aAAa,uBAAuB;EACpC,aAAa,aAAa;EAC1B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAIA,IAAI,YAAY,eAAe,KAAK,YAAY,oBAAoB,GAAG;EACrE,aAAa,oBAAoB;EACjC,aAAa,eAAe;EAC5B,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAGA,IAAI,YAAY,cAAc,KAAK,YAAY,uBAAuB,GAAG;EACvE,aAAa,uBAAuB;EACpC,aAAa,cAAc;EAC3B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;CAEF;CAGA,IACE,YAAY,qBAAqB,KACjC,YAAY,yBAAyB,GACrC;EACA,aAAa,yBAAyB;EACtC,aAAa,qBAAqB;EAClC,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAOA,IACE,YAAY,cAAc,KAC1B,YAAY,eAAe,KAC3B,YAAY,kBAAkB,GAC9B;EACA,aAAa,kBAAkB;EAC/B,aAAa,cAAc;EAE3B,MAAM,eAAe,QAAQ,wBAAwB;EACrD,qBAAqB,eACjB;GACE,QAAQ;GACR,QAAQ;GACR,gBAAgB;EAClB,IACA;GACE,QAAQ;GACR,QAAQ;GACR,gBAAgB;EAClB;EAEJ,2BAA2B;GAKzB,oBAAoB;GACpB,qBAAqB;GACrB,oBAAoB;IAClB,YAAY;IACZ,mBAAmB;GACrB;EACF;CACF;CAIA,IAAI,YAAY,SAAS,KAAK,YAAY,mBAAmB,GAAG;EAC9D,aAAa,mBAAmB;EAChC,aAAa,SAAS;EACtB,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAEA,IAAI,kBACF,gBACE,iBAAiB,WAAW,OACxB,6BACA,4BACN;CAGF,OAAO;EACL;EACA;EACA;EACA;CACF;AACF;;;;;AAMA,MAAa,mBACX,SACA,UACA,gBACA,QAAiB,UACR;CACT,MAAM,UAAU,oBAAoB,gBAAgB,UAAU,KAAK;CACnE,iCAAS,SAAS;EAAE,KAAK;EAAS,OAAO;CAAU,CAAC;AACtD;;;;;;;;;AAUA,MAAa,yBAAyB,gBACpC,gBAAgB,cAChB,YAAY,WAAW,YAAY,KACnC,aAAa,KAAK,WAAW;;;;;;;;AAS/B,MAAa,oBAAoB,YAAoC;CACnE,IAAI,CAAC,WAAW,OAAO,YAAY,UAAU,OAAO;CACpD,MAAM,QAAQ,QAAQ,MAAM,qBAAqB;CACjD,OAAO,QAAQ,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,GAAG,MAAM,OAAO;AACzD;;;;;;AAOA,MAAa,8BACX,SACA,gBACkB;CAClB,IAAI;EACF,MAAM,mBAAeA,gBACnB,SACA,gBACA,aACA,cACF;EACA,IAAI,KAACD,oBAAW,YAAY,GAAG,OAAO;EACtC,MAAM,EAAE,YAAY,KAAK,UAAME,sBAAa,cAAc,OAAO,CAAC;EAClE,OAAO,OAAO,YAAY,WAAW,UAAU;CACjD,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;AAQA,MAAa,kCACX,SACA,cACA,kBACa;CACb,MAAM,mBAAmB,iBAAiB,aAAa;CACvD,IAAI,CAAC,kBAAkB,OAAO,CAAC;CAE/B,OAAO,OAAO,KAAK,YAAY,CAAC,CAC7B,OAAO,qBAAqB,CAAC,CAC7B,QAAQ,gBAAgB;EACvB,MAAM,mBAAmB,2BAA2B,SAAS,WAAW;EACxE,MAAM,sBAAsB,iBAC1B,oBAAoB,MACtB;EACA,IAAI,CAAC,qBAAqB,OAAO;EACjC,WAAOC,wCAAgB,qBAAqB,KAAK,gBAAgB;CACnE,CAAC;AACL;;;;;;AAOA,MAAa,mBACX,SACA,UACA,gBACA,eACA,QAAiB,UACR;CACT,IAAI,SAAS,WAAW,GAAG;CAC3B,MAAM,oBAAoB,SAAS,KAChC,gBAAgB,GAAG,YAAY,GAAG,eACrC;CACA,MAAM,UAAU,oBAAoB,gBAAgB,mBAAmB,KAAK;CAC5E,iCAAS,SAAS;EAAE,KAAK;EAAS,OAAO;CAAU,CAAC;AACtD"}
+{"version":3,"file":"packageManager.cjs","names":["existsSync","join","readFileSync","compareVersions"],"sources":["../../../../src/init/utils/packageManager.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { compareVersions } from '@intlayer/config/utils';\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  /**\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/**\n * Detects the package manager in use by checking for lock files in the\n * project root. Falls back to npm when no lock file is found.\n */\nexport const detectPackageManager = (rootDir: string): PackageManager => {\n  if (\n    existsSync(join(rootDir, 'bun.lock')) ||\n    existsSync(join(rootDir, 'bun.lockb'))\n  ) {\n    return 'bun';\n  }\n  if (existsSync(join(rootDir, 'pnpm-lock.yaml'))) {\n    return 'pnpm';\n  }\n  if (existsSync(join(rootDir, 'yarn.lock'))) {\n    return 'yarn';\n  }\n  return 'npm';\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\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\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  },\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  },\n  {\n    label: 'vue-i18n',\n    packages: ['vue-i18n', '@intlayer/vue-i18n'],\n  },\n  {\n    label: '@nuxtjs/i18n',\n    packages: ['@nuxtjs/i18n', '@intlayer/nuxtjs-i18n'],\n  },\n  {\n    label: 'next-i18next',\n    packages: ['next-i18next', '@intlayer/next-i18next'],\n  },\n  {\n    label: 'next-translate',\n    packages: ['next-translate', '@intlayer/next-translate'],\n  },\n  {\n    label: 'react-intl',\n    packages: ['react-intl', '@intlayer/react-intl'],\n  },\n  {\n    label: 'Lingui',\n    packages: ['@lingui/core', '@lingui/react', '@intlayer/lingui'],\n  },\n  {\n    label: 'svelte-i18n',\n    packages: ['svelte-i18n', '@intlayer/svelte-i18n'],\n  },\n  {\n    label: '@ngneat/transloco',\n    packages: ['@ngneat/transloco', '@intlayer/transloco'],\n  },\n  {\n    label: '@ngx-translate/core',\n    packages: ['@ngx-translate/core', '@intlayer/ngx-translate'],\n  },\n  {\n    label: 'node-polyglot',\n    packages: ['node-polyglot', '@intlayer/polyglot'],\n  },\n  {\n    label: 'i18n-js',\n    packages: ['i18n-js', '@intlayer/i18n-js'],\n  },\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  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  // Core package — always required\n  addIfMissing('intlayer');\n\n  // Framework-specific runtime integrations\n  if (isInstalled('next')) {\n    addIfMissing('next-intlayer');\n  } else if (isInstalled('react')) {\n    addIfMissing('react-intlayer');\n  }\n\n  // React Native / Expo — the Metro plugin lives in react-native-intlayer,\n  // installed as a dev dependency (it is only used by the bundler).\n  if (isInstalled('react-native') || isInstalled('expo')) {\n    addDevIfMissing('react-native-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    addIfMissing('@intlayer/next-intl');\n    addIfMissing('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    addIfMissing('@intlayer/next-i18next');\n    addIfMissing('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    addIfMissing('@intlayer/next-translate');\n    addIfMissing('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    addIfMissing('@intlayer/i18next');\n    // Ensure the required peer dependency is installed\n    addIfMissing('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    addIfMissing('@intlayer/react-i18next');\n    // Ensure the required peer dependency is installed\n    addIfMissing('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    addIfMissing('@intlayer/vue-i18n');\n    addIfMissing('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    addIfMissing('@intlayer/use-intl');\n    addIfMissing('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    addIfMissing('@intlayer/react-intl');\n    addIfMissing('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    addIfMissing('@intlayer/transloco');\n    addIfMissing('@ngneat/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    addIfMissing('@intlayer/svelte-i18n');\n    addIfMissing('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    addIfMissing('@intlayer/polyglot');\n    addIfMissing('node-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    addIfMissing('@intlayer/nuxtjs-i18n');\n    addIfMissing('@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    addIfMissing('@intlayer/ngx-translate');\n    addIfMissing('@ngx-translate/core');\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    addIfMissing('@intlayer/lingui');\n    addIfMissing('@lingui/core');\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    addIfMissing('@intlayer/i18n-js');\n    addIfMissing('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    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`).\n */\nexport const isIntlayerPackageName = (packageName: string): boolean =>\n  packageName === 'intlayer' ||\n  packageName.startsWith('@intlayer/') ||\n  /-intlayer$/.test(packageName);\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  const match = version.match(/(\\d+)\\.(\\d+)\\.(\\d+)/);\n  return match ? `${match[1]}.${match[2]}.${match[3]}` : null;\n};\n\n/**\n * Reads the installed version of a package from its `package.json` inside the\n * project's `node_modules`. Returns `null` when the package is not installed or\n * its manifest cannot be read.\n */\nexport const getInstalledPackageVersion = (\n  rootDir: string,\n  packageName: string\n): string | null => {\n  try {\n    const manifestPath = join(\n      rootDir,\n      'node_modules',\n      packageName,\n      'package.json'\n    );\n    if (!existsSync(manifestPath)) return null;\n    const { version } = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n    return typeof version === 'string' ? version : null;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Returns the Intlayer packages from `dependencies` whose installed version is\n * behind `targetVersion` (compared on `major.minor.patch`). Packages that are\n * not installed yet are ignored — those are handled by\n * {@link detectMissingIntlayerPackages}.\n */\nexport const detectOutdatedIntlayerPackages = (\n  rootDir: string,\n  dependencies: Record<string, string>,\n  targetVersion: string\n): string[] => {\n  const normalizedTarget = normalizeVersion(targetVersion);\n  if (!normalizedTarget) return [];\n\n  return Object.keys(dependencies)\n    .filter(isIntlayerPackageName)\n    .filter((packageName) => {\n      const installedVersion = getInstalledPackageVersion(rootDir, packageName);\n      const normalizedInstalled = normalizeVersion(\n        installedVersion ?? undefined\n      );\n      if (!normalizedInstalled) return false;\n      return compareVersions(normalizedInstalled, '<', normalizedTarget);\n    });\n};\n\n/**\n * Upgrades the given packages to `targetVersion` synchronously, preserving the\n * dependency type via the `isDev` flag. Throws if the install process exits\n * with a non-zero code.\n */\nexport const upgradePackages = (\n  rootDir: string,\n  packages: string[],\n  packageManager: PackageManager,\n  targetVersion: string,\n  isDev: boolean = false\n): void => {\n  if (packages.length === 0) return;\n  const versionedPackages = packages.map(\n    (packageName) => `${packageName}@${targetVersion}`\n  );\n  const command = buildInstallCommand(packageManager, versionedPackages, isDev);\n  execSync(command, { cwd: rootDir, stdio: 'inherit' });\n};\n"],"mappings":";;;;;;;;;;;AAgGA,MAAa,wBAAwB,YAAoC;CACvE,QACEA,wBAAWC,gBAAK,SAAS,UAAU,CAAC,SACpCD,wBAAWC,gBAAK,SAAS,WAAW,CAAC,GAErC,OAAO;CAET,QAAID,wBAAWC,gBAAK,SAAS,gBAAgB,CAAC,GAC5C,OAAO;CAET,QAAID,wBAAWC,gBAAK,SAAS,WAAW,CAAC,GACvC,OAAO;CAET,OAAO;AACT;;;;AAKA,MAAM,uBACJ,gBACA,UACA,QAAiB,UACN;CACX,MAAM,cAAc,SAAS,KAAK,GAAG;CACrC,QAAQ,gBAAR;EACE,KAAK,OACH,OAAO,WAAW,QAAQ,QAAQ,KAAK;EACzC,KAAK,QACH,OAAO,YAAY,QAAQ,QAAQ,KAAK;EAC1C,KAAK,QACH,OAAO,YAAY,QAAQ,QAAQ,KAAK;EAC1C,KAAK,OACH,OAAO,eAAe,QAAQ,QAAQ,KAAK;CAC/C;AACF;;;;;;;AAmCA,MAAa,wBAAsD;CACjE;EACE,OAAO;EACP,UAAU;GACR;GACA;GACA;GACA;EACF;CACF;CACA;EACE,OAAO;EACP,UAAU;GACR;GACA;GACA;GACA;EACF;CACF;CACA;EACE,OAAO;EACP,UAAU,CAAC,YAAY,oBAAoB;CAC7C;CACA;EACE,OAAO;EACP,UAAU,CAAC,gBAAgB,uBAAuB;CACpD;CACA;EACE,OAAO;EACP,UAAU,CAAC,gBAAgB,wBAAwB;CACrD;CACA;EACE,OAAO;EACP,UAAU,CAAC,kBAAkB,0BAA0B;CACzD;CACA;EACE,OAAO;EACP,UAAU,CAAC,cAAc,sBAAsB;CACjD;CACA;EACE,OAAO;EACP,UAAU;GAAC;GAAgB;GAAiB;EAAkB;CAChE;CACA;EACE,OAAO;EACP,UAAU,CAAC,eAAe,uBAAuB;CACnD;CACA;EACE,OAAO;EACP,UAAU,CAAC,qBAAqB,qBAAqB;CACvD;CACA;EACE,OAAO;EACP,UAAU,CAAC,uBAAuB,yBAAyB;CAC7D;CACA;EACE,OAAO;EACP,UAAU,CAAC,iBAAiB,oBAAoB;CAClD;CACA;EACE,OAAO;EACP,UAAU,CAAC,WAAW,mBAAmB;CAC3C;AACF;;;;;;;;;;AAWA,MAAa,6BACX,iBAEA,sBAAsB,QAAQ,YAC5B,QAAQ,SAAS,MAAM,gBAAgB,QAAQ,aAAa,YAAY,CAAC,CAC3E,CAAC,CAAC,KAAK,YAAY,QAAQ,KAAK;;;;;;;;;;;;AAalC,MAAa,kBAAkB,iBAC7B,QAAQ,aAAa,MAAM,KAAK,QAAQ,aAAa,MAAM;AAE7D,MAAa,iCACX,iBACA,UAAwC,CAAC,MACb;CAC5B,MAAM,oBAA8B,CAAC;CACrC,MAAM,uBAAiC,CAAC;CACxC,IAAI;CACJ,IAAI;CAEJ,MAAM,eAAe,gBACnB,QAAQ,gBAAgB,YAAY;CAEtC,MAAM,gBAAgB,gBAA8B;EAClD,IAAI,CAAC,YAAY,WAAW,GAC1B,kBAAkB,KAAK,WAAW;CAEtC;CAEA,MAAM,mBAAmB,gBAA8B;EACrD,IAAI,CAAC,YAAY,WAAW,GAC1B,qBAAqB,KAAK,WAAW;CAEzC;CAGA,aAAa,UAAU;CAGvB,IAAI,YAAY,MAAM,GACpB,aAAa,eAAe;MACvB,IAAI,YAAY,OAAO,GAC5B,aAAa,gBAAgB;CAK/B,IAAI,YAAY,cAAc,KAAK,YAAY,MAAM,GACnD,gBAAgB,uBAAuB;CAGzC,IAAI,YAAY,QAAQ,GACtB,aAAa,iBAAiB;CAGhC,IAAI,YAAY,UAAU,GACxB,aAAa,gBAAgB;CAG/B,IAAI,YAAY,eAAe,GAC7B,aAAa,kBAAkB;CAGjC,IAAI,YAAY,KAAK,GACnB,aAAa,cAAc;CAG7B,IAAI,YAAY,MAAM,GACpB,aAAa,eAAe;CAI9B,IAAI,eAAe,eAAe,GAChC,gBAAgB,wBAAwB;CAmB1C,IAAI,YAAY,WAAW,KAAK,YAAY,qBAAqB,GAAG;EAClE,aAAa,qBAAqB;EAClC,aAAa,WAAW;EACxB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;GAEhB,WAAW;EACb;CAEF;CAGA,IAAI,YAAY,cAAc,KAAK,YAAY,wBAAwB,GAAG;EACxE,aAAa,wBAAwB;EACrC,aAAa,cAAc;EAC3B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;CAEF;CAGA,IACE,YAAY,gBAAgB,KAC5B,YAAY,0BAA0B,GACtC;EACA,aAAa,0BAA0B;EACvC,aAAa,gBAAgB;EAC7B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;CAEF;CAIA,IAAI,YAAY,SAAS,KAAK,YAAY,mBAAmB,GAAG;EAC9D,aAAa,mBAAmB;EAEhC,aAAa,SAAS;EACtB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EAIA,IACE,CAAC,YAAY,eAAe,KAC5B,CAAC,YAAY,yBAAyB,GAEtC,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CAEJ;CAKA,IAAI,YAAY,eAAe,KAAK,YAAY,yBAAyB,GAAG;EAC1E,aAAa,yBAAyB;EAEtC,aAAa,eAAe;EAC5B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAGA,IAAI,YAAY,UAAU,KAAK,YAAY,oBAAoB,GAAG;EAChE,aAAa,oBAAoB;EACjC,aAAa,UAAU;EACvB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAMA,IAAI,YAAY,UAAU,KAAK,YAAY,oBAAoB,GAAG;EAChE,aAAa,oBAAoB;EACjC,aAAa,UAAU;EACvB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;GAEhB,WAAW;EACb;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAGA,IAAI,YAAY,YAAY,KAAK,YAAY,sBAAsB,GAAG;EACpE,aAAa,sBAAsB;EACnC,aAAa,YAAY;EACzB,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAIA,IAAI,YAAY,mBAAmB,KAAK,YAAY,qBAAqB,GAAG;EAC1E,aAAa,qBAAqB;EAClC,aAAa,mBAAmB;EAChC,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAGA,IAAI,YAAY,aAAa,KAAK,YAAY,uBAAuB,GAAG;EACtE,aAAa,uBAAuB;EACpC,aAAa,aAAa;EAC1B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAIA,IAAI,YAAY,eAAe,KAAK,YAAY,oBAAoB,GAAG;EACrE,aAAa,oBAAoB;EACjC,aAAa,eAAe;EAC5B,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAGA,IAAI,YAAY,cAAc,KAAK,YAAY,uBAAuB,GAAG;EACvE,aAAa,uBAAuB;EACpC,aAAa,cAAc;EAC3B,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;CAEF;CAGA,IACE,YAAY,qBAAqB,KACjC,YAAY,yBAAyB,GACrC;EACA,aAAa,yBAAyB;EACtC,aAAa,qBAAqB;EAClC,qBAAqB;GACnB,QAAQ;GACR,gBAAgB;EAClB;EACA,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAOA,IACE,YAAY,cAAc,KAC1B,YAAY,eAAe,KAC3B,YAAY,kBAAkB,GAC9B;EACA,aAAa,kBAAkB;EAC/B,aAAa,cAAc;EAE3B,MAAM,eAAe,QAAQ,wBAAwB;EACrD,qBAAqB,eACjB;GACE,QAAQ;GACR,QAAQ;GACR,gBAAgB;EAClB,IACA;GACE,QAAQ;GACR,QAAQ;GACR,gBAAgB;EAClB;EAEJ,2BAA2B;GAKzB,oBAAoB;GACpB,qBAAqB;GACrB,oBAAoB;IAClB,YAAY;IACZ,mBAAmB;GACrB;EACF;CACF;CAIA,IAAI,YAAY,SAAS,KAAK,YAAY,mBAAmB,GAAG;EAC9D,aAAa,mBAAmB;EAChC,aAAa,SAAS;EACtB,2BAA2B;GACzB,oBAAoB;GACpB,qBAAqB;EACvB;CACF;CAEA,IAAI,kBACF,gBACE,iBAAiB,WAAW,OACxB,6BACA,4BACN;CAGF,OAAO;EACL;EACA;EACA;EACA;CACF;AACF;;;;;AAMA,MAAa,mBACX,SACA,UACA,gBACA,QAAiB,UACR;CACT,MAAM,UAAU,oBAAoB,gBAAgB,UAAU,KAAK;CACnE,iCAAS,SAAS;EAAE,KAAK;EAAS,OAAO;CAAU,CAAC;AACtD;;;;;;;;;AAUA,MAAa,yBAAyB,gBACpC,gBAAgB,cAChB,YAAY,WAAW,YAAY,KACnC,aAAa,KAAK,WAAW;;;;;;;;AAS/B,MAAa,oBAAoB,YAAoC;CACnE,IAAI,CAAC,WAAW,OAAO,YAAY,UAAU,OAAO;CACpD,MAAM,QAAQ,QAAQ,MAAM,qBAAqB;CACjD,OAAO,QAAQ,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,GAAG,MAAM,OAAO;AACzD;;;;;;AAOA,MAAa,8BACX,SACA,gBACkB;CAClB,IAAI;EACF,MAAM,mBAAeA,gBACnB,SACA,gBACA,aACA,cACF;EACA,IAAI,KAACD,oBAAW,YAAY,GAAG,OAAO;EACtC,MAAM,EAAE,YAAY,KAAK,UAAME,sBAAa,cAAc,OAAO,CAAC;EAClE,OAAO,OAAO,YAAY,WAAW,UAAU;CACjD,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;AAQA,MAAa,kCACX,SACA,cACA,kBACa;CACb,MAAM,mBAAmB,iBAAiB,aAAa;CACvD,IAAI,CAAC,kBAAkB,OAAO,CAAC;CAE/B,OAAO,OAAO,KAAK,YAAY,CAAC,CAC7B,OAAO,qBAAqB,CAAC,CAC7B,QAAQ,gBAAgB;EACvB,MAAM,mBAAmB,2BAA2B,SAAS,WAAW;EACxE,MAAM,sBAAsB,iBAC1B,oBAAoB,MACtB;EACA,IAAI,CAAC,qBAAqB,OAAO;EACjC,WAAOC,wCAAgB,qBAAqB,KAAK,gBAAgB;CACnE,CAAC;AACL;;;;;;AAOA,MAAa,mBACX,SACA,UACA,gBACA,eACA,QAAiB,UACR;CACT,IAAI,SAAS,WAAW,GAAG;CAC3B,MAAM,oBAAoB,SAAS,KAChC,gBAAgB,GAAG,YAAY,GAAG,eACrC;CACA,MAAM,UAAU,oBAAoB,gBAAgB,mBAAmB,KAAK;CAC5E,iCAAS,SAAS;EAAE,KAAK;EAAS,OAAO;CAAU,CAAC;AACtD"}

package/dist/esm/build.mjs

@@ -7,7 +7,7 @@ import { getBuiltUnmergedDictionariesPath } from "./createDictionaryEntryPoint/g
 import { createDictionaryEntryPoint } from "./createDictionaryEntryPoint/createDictionaryEntryPoint.mjs";
 import { readDictionariesFromDisk } from "./utils/readDictionariesFromDisk.mjs";
 import { buildDictionary } from "./buildIntlayerDictionary/buildIntlayerDictionary.mjs";
-import { createModuleAugmentation, getTypeName } from "./createType/createModuleAugmentation.mjs";
+import { createModuleAugmentation, formatRewriteRules, getTypeName } from "./createType/createModuleAugmentation.mjs";
 import { createTypes, generateTypeScriptType } from "./createType/createType.mjs";
 import { processContentDeclaration } from "./buildIntlayerDictionary/processContentDeclaration.mjs";
 import { ensureIntlayerBundle, formatLocalDictionaries, loadContentDeclaration, loadContentDeclarations } from "./loadDictionaries/loadContentDeclaration.mjs";
@@ -23,4 +23,4 @@ import { transformJSFile } from "./writeContentDeclaration/transformJSFile.mjs";
 import { writeJSFile } from "./writeContentDeclaration/writeJSFile.mjs";
 import { writeContentDeclaration } from "./writeContentDeclaration/writeContentDeclaration.mjs";
 
-export { buildDictionary, cleanOutputDir, createDictionaryEntryPoint, createModuleAugmentation, createTypes, detectExportedComponentName, ensureIntlayerBundle, formatDictionaries, formatDictionariesOutput, formatDictionary, formatDictionaryOutput, formatDistantDictionaries, formatLocalDictionaries, generateDictionaryListContent, generateTypeScriptType, getBuiltDictionariesPath, getBuiltDynamicDictionariesPath, getBuiltFetchDictionariesPath, getBuiltRemoteDictionariesPath, getBuiltUnmergedDictionariesPath, getTypeName, isCachedConfigurationUpToDate, loadContentDeclaration, loadContentDeclarations, loadDictionaries, loadLocalDictionaries, loadRemoteDictionaries, prepareIntlayer, processContentDeclaration, readDictionariesFromDisk, transformJSFile, writeConfiguration, writeContentDeclaration, writeJSFile };
+export { buildDictionary, cleanOutputDir, createDictionaryEntryPoint, createModuleAugmentation, createTypes, detectExportedComponentName, ensureIntlayerBundle, formatDictionaries, formatDictionariesOutput, formatDictionary, formatDictionaryOutput, formatDistantDictionaries, formatLocalDictionaries, formatRewriteRules, generateDictionaryListContent, generateTypeScriptType, getBuiltDictionariesPath, getBuiltDynamicDictionariesPath, getBuiltFetchDictionariesPath, getBuiltRemoteDictionariesPath, getBuiltUnmergedDictionariesPath, getTypeName, isCachedConfigurationUpToDate, loadContentDeclaration, loadContentDeclarations, loadDictionaries, loadLocalDictionaries, loadRemoteDictionaries, prepareIntlayer, processContentDeclaration, readDictionariesFromDisk, transformJSFile, writeConfiguration, writeContentDeclaration, writeJSFile };

package/dist/esm/buildIntlayerDictionary/writeDynamicDictionary.mjs

@@ -5,12 +5,12 @@ import { mkdir } from "node:fs/promises";
 import { resolve } from "node:path";
 import { colorizePath } from "@intlayer/config/logger";
 import { assertPathWithin } from "@intlayer/config/utils";
-import { OUTPUT_FORMAT } from "@intlayer/config/defaultValues";
+import { DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, OUTPUT_FORMAT } from "@intlayer/config/defaultValues";
 import { COMPOSITE_ID_SEPARATOR, QUALIFIER_DYNAMIC_TYPES_KEY, reconstructQualifiedEntry } from "@intlayer/core/dictionaryManipulator";
 import { getPerLocaleDictionary } from "@intlayer/core/plugins";
 
 //#region src/buildIntlayerDictionary/writeDynamicDictionary.ts
-const DICTIONARIES_SUBDIR = "json";
+const DICTIONARIES_SUBDIR = DYNAMIC_DICTIONARIES_JSON_SUBDIR;
 /**
 * Escapes a value interpolated into a single-quoted literal of a generated
 * loader module, so keys or segments containing `'` or `\` cannot break the
@@ -47,7 +47,7 @@ const generateDictionaryEntryPoint = (key, locales, format = "esm", nestedKeys =
 		if (sortedNestedKeys.length === 0) return `  '${safeLocale}': () => ${ownLoader}`;
 		return `  '${safeLocale}': () => Promise.all([\n      ${ownLoader},\n      ${sortedNestedKeys.map((nestedKey) => buildPerLocaleLoader(escapeJsLiteral(nestedKey), safeLocale, format)).join(",\n      ")}\n    ]).then(([_dictionary, ..._nested]) => ({\n      ..._dictionary,\n      nestedDictionaries: { ${sortedNestedKeys.map((nestedKey, index) => `'${escapeJsLiteral(nestedKey)}': _nested[${index}]`).join(", ")} }\n    }))`;
 	}).join(",\n");
-	if (format === "esm") return `const content = {\n${localeEntries}\n};\n\nexport default content;\n`;
+	if (format === "esm") return `const ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER} = {\n${localeEntries}\n};\n\nexport default ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER};\n`;
 	return `module.exports = {\n${localeEntries}\n};\n`;
 };
 const buildLoaderExpression = (key, chunkSegments, locale, format) => {
@@ -95,7 +95,7 @@ const generateQualifiedDictionaryEntryPoint = (key, qualifierTypes, entries, loc
 		return `  '${escapeJsLiteral(locale)}': ${serializeLoaderTree(tree, 1)}`;
 	}).join(",\n");
 	const marker = `  '${QUALIFIER_DYNAMIC_TYPES_KEY}': ${JSON.stringify(qualifierTypes)}`;
-	if (format === "esm") return `const content = {\n${marker},\n${localeEntries}\n};\n\nexport default content;\n`;
+	if (format === "esm") return `const ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER} = {\n${marker},\n${localeEntries}\n};\n\nexport default ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER};\n`;
 	return `module.exports = {\n${marker},\n${localeEntries}\n};\n`;
 };
 /**

package/dist/esm/buildIntlayerDictionary/writeDynamicDictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeDynamicDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { OUTPUT_FORMAT } from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { assertPathWithin } from '@intlayer/config/utils';\nimport {\n  COMPOSITE_ID_SEPARATOR,\n  QUALIFIER_DYNAMIC_TYPES_KEY,\n  reconstructQualifiedEntry,\n} from '@intlayer/core/dictionaryManipulator';\nimport { getPerLocaleDictionary } from '@intlayer/core/plugins';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryQualifierType,\n  QualifiedDictionaryGroup,\n} from '@intlayer/types/dictionary';\nimport { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { PlainMergedDictionaryOutput } from './writeMergedDictionary';\n\nexport type DictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type LocalizedDictionaryResult = Partial<\n  Record<Locale, DictionaryResult>\n>;\n\nexport type LocalizedDictionaryOutput = Record<\n  string,\n  LocalizedDictionaryResult\n>;\n\nconst DICTIONARIES_SUBDIR = 'json'; // Necessary to add a static first dir for Turbopack\n\n/**\n * Escapes a value interpolated into a single-quoted literal of a generated\n * loader module, so keys or segments containing `'` or `\\` cannot break the\n * emitted JavaScript.\n */\nconst escapeJsLiteral = (value: string): string =>\n  value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n\n/** Loader expression for one `(key, locale)` per-locale chunk. */\nconst buildPerLocaleLoader = (\n  key: string,\n  locale: string,\n  format: 'cjs' | 'esm'\n): string => {\n  const path = `./${DICTIONARIES_SUBDIR}/${key}/${locale}.json`;\n\n  return format === 'esm'\n    ? `import('${path}').then(m => m.default)`\n    : `Promise.resolve(require('${path}'))`;\n};\n\n/**\n * Generates the content of a dictionary entry point file.\n *\n * When the dictionary references other dictionaries through `nest()`, the\n * loader for a locale resolves the referenced dictionaries alongside it and\n * attaches them as `nestedDictionaries`. The nest targets then travel in the\n * same lazy chunk as their consumer, and `getNesting` resolves them from that\n * local reference instead of the global registry — which the build\n * optimization strips.\n *\n * @param key - The dictionary key.\n * @param locales - Locales to emit a loader for.\n * @param format - Output module format.\n * @param nestedKeys - Keys referenced through `nest()`, transitively.\n */\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  format: 'cjs' | 'esm' = 'esm',\n  nestedKeys: string[] = []\n): string => {\n  const sortedLocales = [...locales].sort((a, b) =>\n    String(a).localeCompare(String(b))\n  );\n  const sortedNestedKeys = [...nestedKeys].sort((a, b) => a.localeCompare(b));\n\n  const safeKey = escapeJsLiteral(key);\n\n  const localeEntries = sortedLocales\n    .map((locale) => {\n      const safeLocale = escapeJsLiteral(locale);\n      const ownLoader = buildPerLocaleLoader(safeKey, safeLocale, format);\n\n      if (sortedNestedKeys.length === 0) {\n        return `  '${safeLocale}': () => ${ownLoader}`;\n      }\n\n      const nestedLoaders = sortedNestedKeys\n        .map((nestedKey) =>\n          buildPerLocaleLoader(escapeJsLiteral(nestedKey), safeLocale, format)\n        )\n        .join(',\\n      ');\n\n      const attachedEntries = sortedNestedKeys\n        .map(\n          (nestedKey, index) =>\n            `'${escapeJsLiteral(nestedKey)}': _nested[${index}]`\n        )\n        .join(', ');\n\n      return (\n        `  '${safeLocale}': () => Promise.all([\\n` +\n        `      ${ownLoader},\\n` +\n        `      ${nestedLoaders}\\n` +\n        `    ]).then(([_dictionary, ..._nested]) => ({\\n` +\n        `      ..._dictionary,\\n` +\n        `      nestedDictionaries: { ${attachedEntries} }\\n` +\n        `    }))`\n      );\n    })\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `const content = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return `module.exports = {\\n${localeEntries}\\n};\\n`;\n};\n\n/**\n * A nested loader tree: one level per declared dimension, leaves are loader\n * expression strings.\n */\ntype LoaderTree = { [segment: string]: LoaderTree | string };\n\n/**\n * One entry of a qualified loader map.\n *\n * `treeSegments` is where the entry lives in the loader tree (its composite id\n * segments); `chunkSegments` is the chunk path it loads. They differ when the\n * entry aliases another entry with identical content (e.g. array-variant\n * fan-out): the alias keeps its own tree position but points at the canonical\n * entry's chunk, so equal content is emitted — and downloaded — only once.\n */\nexport type QualifiedEntrySegments = {\n  treeSegments: string[];\n  chunkSegments: string[];\n};\n\nconst buildLoaderExpression = (\n  key: string,\n  chunkSegments: string[],\n  locale: string,\n  format: 'cjs' | 'esm'\n): string => {\n  const path = escapeJsLiteral(\n    `./${DICTIONARIES_SUBDIR}/${key}/${chunkSegments.join('/')}/${locale}.json`\n  );\n\n  return format === 'esm'\n    ? `() => import('${path}').then(m => m.default)`\n    : `() => Promise.resolve(require('${path}'))`;\n};\n\nconst buildLoaderTree = (\n  key: string,\n  entries: QualifiedEntrySegments[],\n  locale: string,\n  format: 'cjs' | 'esm'\n): LoaderTree => {\n  const root: LoaderTree = {};\n\n  for (const { treeSegments, chunkSegments } of entries) {\n    let node = root;\n\n    treeSegments.forEach((segment, index) => {\n      if (index === treeSegments.length - 1) {\n        node[segment] = buildLoaderExpression(\n          key,\n          chunkSegments,\n          locale,\n          format\n        );\n        return;\n      }\n\n      node[segment] = (node[segment] as LoaderTree | undefined) ?? {};\n      node = node[segment] as LoaderTree;\n    });\n  }\n\n  return root;\n};\n\nconst serializeLoaderTree = (tree: LoaderTree, indentLevel: number): string => {\n  const pad = '  '.repeat(indentLevel);\n  const innerPad = '  '.repeat(indentLevel + 1);\n\n  const lines = Object.keys(tree)\n    .sort((a, b) => a.localeCompare(b))\n    .map((segment) => {\n      const value = tree[segment]!;\n      const serialized =\n        typeof value === 'string'\n          ? value\n          : serializeLoaderTree(value, indentLevel + 1);\n\n      return `${innerPad}'${escapeJsLiteral(segment)}': ${serialized}`;\n    });\n\n  return `{\\n${lines.join(',\\n')}\\n${pad}}`;\n};\n\n/**\n * Generates the entry point of a qualified dictionary (collection / variant,\n * possibly combined). Under each locale the loader map nests one\n * level per declared dimension (canonical order) and carries a marker listing\n * those dimensions so the runtime can walk the tree.\n *\n * One static `import()` is emitted per leaf `(locale, …segments)` chunk, which\n * keeps the output compatible with bundlers that reject template-literal\n * dynamic imports (Turbopack). Entries whose content is identical share one\n * chunk: their leaves point at the canonical entry's import path.\n */\nexport const generateQualifiedDictionaryEntryPoint = (\n  key: string,\n  qualifierTypes: DictionaryQualifierType[],\n  entries: QualifiedEntrySegments[],\n  locales: string[],\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const sortedLocales = [...locales].sort((a, b) =>\n    String(a).localeCompare(String(b))\n  );\n\n  const localeEntries = sortedLocales\n    .map((locale) => {\n      const tree = buildLoaderTree(key, entries, locale, format);\n      return `  '${escapeJsLiteral(locale)}': ${serializeLoaderTree(tree, 1)}`;\n    })\n    .join(',\\n');\n\n  const marker = `  '${QUALIFIER_DYNAMIC_TYPES_KEY}': ${JSON.stringify(qualifierTypes)}`;\n\n  if (format === 'esm') {\n    return (\n      `const content = {\\n${marker},\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return `module.exports = {\\n${marker},\\n${localeEntries}\\n};\\n`;\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dynamic_dictionary/dictionaries/en_home.json\n * // .intlayer/dynamic_dictionary/dictionaries/fr_home.json\n * ```\n */\nexport const writeDynamicDictionary = async (\n  mergedDictionaries: PlainMergedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT,\n  nestedDictionaryGraph: Map<string, Set<string>> = new Map()\n): Promise<LocalizedDictionaryOutput> => {\n  const { locales, defaultLocale } = configuration.internationalization;\n  const { dynamicDictionariesDir } = configuration.system;\n\n  const dictDir = resolve(dynamicDictionariesDir, DICTIONARIES_SUBDIR);\n  await mkdir(dictDir, { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Merge dictionaries with the same key and write to dictionariesDir\n  await parallelize(\n    Object.entries(mergedDictionaries).sort(([a], [b]) =>\n      String(a).localeCompare(String(b))\n    ),\n    async ([key, dictionaryEntry]) => {\n      if (key === 'undefined') return;\n\n      const localizedDictionariesPathsRecord: LocalizedDictionaryResult = {};\n\n      const keyDir = resolve(dictDir, key);\n      assertPathWithin(keyDir, dictDir);\n      await mkdir(keyDir, { recursive: true });\n\n      await parallelize(locales, async (locale) => {\n        const localizedDictionary = getPerLocaleDictionary(\n          dictionaryEntry.dictionary,\n          locale,\n          defaultLocale\n        );\n\n        // Directory structure: json/key/locale.json\n        const resultFilePath = resolve(keyDir, `${locale}.json`);\n\n        await writeJsonIfChanged(resultFilePath, localizedDictionary).catch(\n          (err) => {\n            console.error(\n              `Error creating localized ${key}/${locale}.json:`,\n              err\n            );\n          }\n        );\n\n        localizedDictionariesPathsRecord[locale] = {\n          dictionaryPath: resultFilePath,\n          dictionary: localizedDictionary,\n        };\n      });\n\n      resultDictionariesPaths[key] = localizedDictionariesPathsRecord;\n\n      await parallelize(formats, async (format) => {\n        const extension = format === 'cjs' ? 'cjs' : 'mjs';\n        const content = generateDictionaryEntryPoint(key, locales, format, [\n          ...(nestedDictionaryGraph.get(key) ?? []),\n        ]);\n\n        const dynEntryPath = resolve(\n          dynamicDictionariesDir,\n          `${key}.${extension}`\n        );\n        assertPathWithin(dynEntryPath, dynamicDictionariesDir);\n\n        await writeFileIfChanged(dynEntryPath, content).catch((err) => {\n          console.error(\n            `Error creating dynamic ${colorizePath(dynEntryPath)}:`,\n            err\n          );\n        });\n      });\n    }\n  );\n\n  return resultDictionariesPaths;\n};\n\nexport type QualifiedMergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionary: QualifiedDictionaryGroup;\n};\n\nexport type QualifiedMergedDictionaryOutput = Record<\n  string,\n  QualifiedMergedDictionaryResult\n>;\n\n/**\n * Writes the dynamic chunks and entry points of qualified dictionaries\n * (collections, variants — possibly combined) in\n * `importMode: 'dynamic'`.\n *\n * Each entry is reduced to one per-locale chunk written to a path nested by\n * dimension — `json/{key}/{seg1}/{seg2}/{locale}.json` — and a single\n * `{key}.{ext}` entry point exposes the matching nested loader tree, so the\n * entry point is discovered and aggregated exactly like a plain dynamic one.\n */\nexport const writeDynamicQualifiedDictionaries = async (\n  qualifiedDictionaries: QualifiedMergedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<void> => {\n  const { locales, defaultLocale } = configuration.internationalization;\n  const { dynamicDictionariesDir } = configuration.system;\n\n  const dictDir = resolve(dynamicDictionariesDir, DICTIONARIES_SUBDIR);\n  await mkdir(dictDir, { recursive: true });\n\n  await parallelize(\n    Object.entries(qualifiedDictionaries).sort(([a], [b]) =>\n      String(a).localeCompare(String(b))\n    ),\n    async ([key, { dictionary: group }]) => {\n      if (key === 'undefined') return;\n\n      const entryIds = Object.keys(group.content);\n\n      const keyDir = resolve(dictDir, key);\n      assertPathWithin(keyDir, dictDir);\n\n      // Entries with identical content (e.g. array-variant fan-out) share one\n      // chunk: only the first entry per content identity writes files; the\n      // others become aliases whose loaders point at the canonical chunk path.\n      const canonicalSegmentsByContent = new Map<string, string[]>();\n      const entries: QualifiedEntrySegments[] = [];\n      const canonicalEntryIds: string[] = [];\n\n      for (const entryId of entryIds) {\n        const treeSegments = entryId.split(COMPOSITE_ID_SEPARATOR);\n        const contentIdentity = JSON.stringify(group.content[entryId]);\n        const canonicalSegments =\n          canonicalSegmentsByContent.get(contentIdentity);\n\n        if (canonicalSegments) {\n          entries.push({ treeSegments, chunkSegments: canonicalSegments });\n          continue;\n        }\n\n        canonicalSegmentsByContent.set(contentIdentity, treeSegments);\n        entries.push({ treeSegments, chunkSegments: treeSegments });\n        canonicalEntryIds.push(entryId);\n      }\n\n      await parallelize(canonicalEntryIds, async (entryId) => {\n        // Rebuild a resolvable dictionary from the content node + composite id\n        // so per-locale extraction sees the same `{ key, content }` shape.\n        const entry = reconstructQualifiedEntry(group, entryId);\n\n        const segments = entryId.split(COMPOSITE_ID_SEPARATOR);\n\n        const entryDir = resolve(keyDir, ...segments);\n        assertPathWithin(entryDir, keyDir);\n        await mkdir(entryDir, { recursive: true });\n\n        await parallelize(locales, async (locale) => {\n          const localizedDictionary = getPerLocaleDictionary(\n            entry,\n            locale,\n            defaultLocale\n          );\n\n          // Directory structure: json/key/<…segments>/locale.json\n          const resultFilePath = resolve(entryDir, `${locale}.json`);\n\n          await writeJsonIfChanged(resultFilePath, localizedDictionary).catch(\n            (err) => {\n              console.error(\n                `Error creating localized ${key}/${segments.join('/')}/${locale}.json:`,\n                err\n              );\n            }\n          );\n        });\n      });\n\n      await parallelize(formats, async (format) => {\n        const extension = format === 'cjs' ? 'cjs' : 'mjs';\n        const content = generateQualifiedDictionaryEntryPoint(\n          key,\n          group.qualifierTypes,\n          entries,\n          locales,\n          format\n        );\n\n        const dynEntryPath = resolve(\n          dynamicDictionariesDir,\n          `${key}.${extension}`\n        );\n        assertPathWithin(dynEntryPath, dynamicDictionariesDir);\n\n        await writeFileIfChanged(dynEntryPath, content).catch((err) => {\n          console.error(\n            `Error creating dynamic ${colorizePath(dynEntryPath)}:`,\n            err\n          );\n        });\n      });\n    }\n  );\n};\n"],"mappings":"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"}
+{"version":3,"file":"writeDynamicDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport {\n  DYNAMIC_DICTIONARIES_JSON_SUBDIR,\n  DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER,\n  OUTPUT_FORMAT,\n} from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { assertPathWithin } from '@intlayer/config/utils';\nimport {\n  COMPOSITE_ID_SEPARATOR,\n  QUALIFIER_DYNAMIC_TYPES_KEY,\n  reconstructQualifiedEntry,\n} from '@intlayer/core/dictionaryManipulator';\nimport { getPerLocaleDictionary } from '@intlayer/core/plugins';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryQualifierType,\n  QualifiedDictionaryGroup,\n} from '@intlayer/types/dictionary';\nimport { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { PlainMergedDictionaryOutput } from './writeMergedDictionary';\n\nexport type DictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type LocalizedDictionaryResult = Partial<\n  Record<Locale, DictionaryResult>\n>;\n\nexport type LocalizedDictionaryOutput = Record<\n  string,\n  LocalizedDictionaryResult\n>;\n\nconst DICTIONARIES_SUBDIR = DYNAMIC_DICTIONARIES_JSON_SUBDIR;\n\n/**\n * Escapes a value interpolated into a single-quoted literal of a generated\n * loader module, so keys or segments containing `'` or `\\` cannot break the\n * emitted JavaScript.\n */\nconst escapeJsLiteral = (value: string): string =>\n  value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n\n/** Loader expression for one `(key, locale)` per-locale chunk. */\nconst buildPerLocaleLoader = (\n  key: string,\n  locale: string,\n  format: 'cjs' | 'esm'\n): string => {\n  const path = `./${DICTIONARIES_SUBDIR}/${key}/${locale}.json`;\n\n  return format === 'esm'\n    ? `import('${path}').then(m => m.default)`\n    : `Promise.resolve(require('${path}'))`;\n};\n\n/**\n * Generates the content of a dictionary entry point file.\n *\n * When the dictionary references other dictionaries through `nest()`, the\n * loader for a locale resolves the referenced dictionaries alongside it and\n * attaches them as `nestedDictionaries`. The nest targets then travel in the\n * same lazy chunk as their consumer, and `getNesting` resolves them from that\n * local reference instead of the global registry — which the build\n * optimization strips.\n *\n * @param key - The dictionary key.\n * @param locales - Locales to emit a loader for.\n * @param format - Output module format.\n * @param nestedKeys - Keys referenced through `nest()`, transitively.\n */\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  format: 'cjs' | 'esm' = 'esm',\n  nestedKeys: string[] = []\n): string => {\n  const sortedLocales = [...locales].sort((a, b) =>\n    String(a).localeCompare(String(b))\n  );\n  const sortedNestedKeys = [...nestedKeys].sort((a, b) => a.localeCompare(b));\n\n  const safeKey = escapeJsLiteral(key);\n\n  const localeEntries = sortedLocales\n    .map((locale) => {\n      const safeLocale = escapeJsLiteral(locale);\n      const ownLoader = buildPerLocaleLoader(safeKey, safeLocale, format);\n\n      if (sortedNestedKeys.length === 0) {\n        return `  '${safeLocale}': () => ${ownLoader}`;\n      }\n\n      const nestedLoaders = sortedNestedKeys\n        .map((nestedKey) =>\n          buildPerLocaleLoader(escapeJsLiteral(nestedKey), safeLocale, format)\n        )\n        .join(',\\n      ');\n\n      const attachedEntries = sortedNestedKeys\n        .map(\n          (nestedKey, index) =>\n            `'${escapeJsLiteral(nestedKey)}': _nested[${index}]`\n        )\n        .join(', ');\n\n      return (\n        `  '${safeLocale}': () => Promise.all([\\n` +\n        `      ${ownLoader},\\n` +\n        `      ${nestedLoaders}\\n` +\n        `    ]).then(([_dictionary, ..._nested]) => ({\\n` +\n        `      ..._dictionary,\\n` +\n        `      nestedDictionaries: { ${attachedEntries} }\\n` +\n        `    }))`\n      );\n    })\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `const ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER} = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER};\\n`\n    );\n  }\n  return `module.exports = {\\n${localeEntries}\\n};\\n`;\n};\n\n/**\n * A nested loader tree: one level per declared dimension, leaves are loader\n * expression strings.\n */\ntype LoaderTree = { [segment: string]: LoaderTree | string };\n\n/**\n * One entry of a qualified loader map.\n *\n * `treeSegments` is where the entry lives in the loader tree (its composite id\n * segments); `chunkSegments` is the chunk path it loads. They differ when the\n * entry aliases another entry with identical content (e.g. array-variant\n * fan-out): the alias keeps its own tree position but points at the canonical\n * entry's chunk, so equal content is emitted — and downloaded — only once.\n */\nexport type QualifiedEntrySegments = {\n  treeSegments: string[];\n  chunkSegments: string[];\n};\n\nconst buildLoaderExpression = (\n  key: string,\n  chunkSegments: string[],\n  locale: string,\n  format: 'cjs' | 'esm'\n): string => {\n  const path = escapeJsLiteral(\n    `./${DICTIONARIES_SUBDIR}/${key}/${chunkSegments.join('/')}/${locale}.json`\n  );\n\n  return format === 'esm'\n    ? `() => import('${path}').then(m => m.default)`\n    : `() => Promise.resolve(require('${path}'))`;\n};\n\nconst buildLoaderTree = (\n  key: string,\n  entries: QualifiedEntrySegments[],\n  locale: string,\n  format: 'cjs' | 'esm'\n): LoaderTree => {\n  const root: LoaderTree = {};\n\n  for (const { treeSegments, chunkSegments } of entries) {\n    let node = root;\n\n    treeSegments.forEach((segment, index) => {\n      if (index === treeSegments.length - 1) {\n        node[segment] = buildLoaderExpression(\n          key,\n          chunkSegments,\n          locale,\n          format\n        );\n        return;\n      }\n\n      node[segment] = (node[segment] as LoaderTree | undefined) ?? {};\n      node = node[segment] as LoaderTree;\n    });\n  }\n\n  return root;\n};\n\nconst serializeLoaderTree = (tree: LoaderTree, indentLevel: number): string => {\n  const pad = '  '.repeat(indentLevel);\n  const innerPad = '  '.repeat(indentLevel + 1);\n\n  const lines = Object.keys(tree)\n    .sort((a, b) => a.localeCompare(b))\n    .map((segment) => {\n      const value = tree[segment]!;\n      const serialized =\n        typeof value === 'string'\n          ? value\n          : serializeLoaderTree(value, indentLevel + 1);\n\n      return `${innerPad}'${escapeJsLiteral(segment)}': ${serialized}`;\n    });\n\n  return `{\\n${lines.join(',\\n')}\\n${pad}}`;\n};\n\n/**\n * Generates the entry point of a qualified dictionary (collection / variant,\n * possibly combined). Under each locale the loader map nests one\n * level per declared dimension (canonical order) and carries a marker listing\n * those dimensions so the runtime can walk the tree.\n *\n * One static `import()` is emitted per leaf `(locale, …segments)` chunk, which\n * keeps the output compatible with bundlers that reject template-literal\n * dynamic imports (Turbopack). Entries whose content is identical share one\n * chunk: their leaves point at the canonical entry's import path.\n */\nexport const generateQualifiedDictionaryEntryPoint = (\n  key: string,\n  qualifierTypes: DictionaryQualifierType[],\n  entries: QualifiedEntrySegments[],\n  locales: string[],\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const sortedLocales = [...locales].sort((a, b) =>\n    String(a).localeCompare(String(b))\n  );\n\n  const localeEntries = sortedLocales\n    .map((locale) => {\n      const tree = buildLoaderTree(key, entries, locale, format);\n      return `  '${escapeJsLiteral(locale)}': ${serializeLoaderTree(tree, 1)}`;\n    })\n    .join(',\\n');\n\n  const marker = `  '${QUALIFIER_DYNAMIC_TYPES_KEY}': ${JSON.stringify(qualifierTypes)}`;\n\n  if (format === 'esm') {\n    return (\n      `const ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER} = {\\n${marker},\\n${localeEntries}\\n};\\n\\n` +\n      `export default ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER};\\n`\n    );\n  }\n  return `module.exports = {\\n${marker},\\n${localeEntries}\\n};\\n`;\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dynamic_dictionary/dictionaries/en_home.json\n * // .intlayer/dynamic_dictionary/dictionaries/fr_home.json\n * ```\n */\nexport const writeDynamicDictionary = async (\n  mergedDictionaries: PlainMergedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT,\n  nestedDictionaryGraph: Map<string, Set<string>> = new Map()\n): Promise<LocalizedDictionaryOutput> => {\n  const { locales, defaultLocale } = configuration.internationalization;\n  const { dynamicDictionariesDir } = configuration.system;\n\n  const dictDir = resolve(dynamicDictionariesDir, DICTIONARIES_SUBDIR);\n  await mkdir(dictDir, { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Merge dictionaries with the same key and write to dictionariesDir\n  await parallelize(\n    Object.entries(mergedDictionaries).sort(([a], [b]) =>\n      String(a).localeCompare(String(b))\n    ),\n    async ([key, dictionaryEntry]) => {\n      if (key === 'undefined') return;\n\n      const localizedDictionariesPathsRecord: LocalizedDictionaryResult = {};\n\n      const keyDir = resolve(dictDir, key);\n      assertPathWithin(keyDir, dictDir);\n      await mkdir(keyDir, { recursive: true });\n\n      await parallelize(locales, async (locale) => {\n        const localizedDictionary = getPerLocaleDictionary(\n          dictionaryEntry.dictionary,\n          locale,\n          defaultLocale\n        );\n\n        // Directory structure: json/key/locale.json\n        const resultFilePath = resolve(keyDir, `${locale}.json`);\n\n        await writeJsonIfChanged(resultFilePath, localizedDictionary).catch(\n          (err) => {\n            console.error(\n              `Error creating localized ${key}/${locale}.json:`,\n              err\n            );\n          }\n        );\n\n        localizedDictionariesPathsRecord[locale] = {\n          dictionaryPath: resultFilePath,\n          dictionary: localizedDictionary,\n        };\n      });\n\n      resultDictionariesPaths[key] = localizedDictionariesPathsRecord;\n\n      await parallelize(formats, async (format) => {\n        const extension = format === 'cjs' ? 'cjs' : 'mjs';\n        const content = generateDictionaryEntryPoint(key, locales, format, [\n          ...(nestedDictionaryGraph.get(key) ?? []),\n        ]);\n\n        const dynEntryPath = resolve(\n          dynamicDictionariesDir,\n          `${key}.${extension}`\n        );\n        assertPathWithin(dynEntryPath, dynamicDictionariesDir);\n\n        await writeFileIfChanged(dynEntryPath, content).catch((err) => {\n          console.error(\n            `Error creating dynamic ${colorizePath(dynEntryPath)}:`,\n            err\n          );\n        });\n      });\n    }\n  );\n\n  return resultDictionariesPaths;\n};\n\nexport type QualifiedMergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionary: QualifiedDictionaryGroup;\n};\n\nexport type QualifiedMergedDictionaryOutput = Record<\n  string,\n  QualifiedMergedDictionaryResult\n>;\n\n/**\n * Writes the dynamic chunks and entry points of qualified dictionaries\n * (collections, variants — possibly combined) in\n * `importMode: 'dynamic'`.\n *\n * Each entry is reduced to one per-locale chunk written to a path nested by\n * dimension — `json/{key}/{seg1}/{seg2}/{locale}.json` — and a single\n * `{key}.{ext}` entry point exposes the matching nested loader tree, so the\n * entry point is discovered and aggregated exactly like a plain dynamic one.\n */\nexport const writeDynamicQualifiedDictionaries = async (\n  qualifiedDictionaries: QualifiedMergedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<void> => {\n  const { locales, defaultLocale } = configuration.internationalization;\n  const { dynamicDictionariesDir } = configuration.system;\n\n  const dictDir = resolve(dynamicDictionariesDir, DICTIONARIES_SUBDIR);\n  await mkdir(dictDir, { recursive: true });\n\n  await parallelize(\n    Object.entries(qualifiedDictionaries).sort(([a], [b]) =>\n      String(a).localeCompare(String(b))\n    ),\n    async ([key, { dictionary: group }]) => {\n      if (key === 'undefined') return;\n\n      const entryIds = Object.keys(group.content);\n\n      const keyDir = resolve(dictDir, key);\n      assertPathWithin(keyDir, dictDir);\n\n      // Entries with identical content (e.g. array-variant fan-out) share one\n      // chunk: only the first entry per content identity writes files; the\n      // others become aliases whose loaders point at the canonical chunk path.\n      const canonicalSegmentsByContent = new Map<string, string[]>();\n      const entries: QualifiedEntrySegments[] = [];\n      const canonicalEntryIds: string[] = [];\n\n      for (const entryId of entryIds) {\n        const treeSegments = entryId.split(COMPOSITE_ID_SEPARATOR);\n        const contentIdentity = JSON.stringify(group.content[entryId]);\n        const canonicalSegments =\n          canonicalSegmentsByContent.get(contentIdentity);\n\n        if (canonicalSegments) {\n          entries.push({ treeSegments, chunkSegments: canonicalSegments });\n          continue;\n        }\n\n        canonicalSegmentsByContent.set(contentIdentity, treeSegments);\n        entries.push({ treeSegments, chunkSegments: treeSegments });\n        canonicalEntryIds.push(entryId);\n      }\n\n      await parallelize(canonicalEntryIds, async (entryId) => {\n        // Rebuild a resolvable dictionary from the content node + composite id\n        // so per-locale extraction sees the same `{ key, content }` shape.\n        const entry = reconstructQualifiedEntry(group, entryId);\n\n        const segments = entryId.split(COMPOSITE_ID_SEPARATOR);\n\n        const entryDir = resolve(keyDir, ...segments);\n        assertPathWithin(entryDir, keyDir);\n        await mkdir(entryDir, { recursive: true });\n\n        await parallelize(locales, async (locale) => {\n          const localizedDictionary = getPerLocaleDictionary(\n            entry,\n            locale,\n            defaultLocale\n          );\n\n          // Directory structure: json/key/<…segments>/locale.json\n          const resultFilePath = resolve(entryDir, `${locale}.json`);\n\n          await writeJsonIfChanged(resultFilePath, localizedDictionary).catch(\n            (err) => {\n              console.error(\n                `Error creating localized ${key}/${segments.join('/')}/${locale}.json:`,\n                err\n              );\n            }\n          );\n        });\n      });\n\n      await parallelize(formats, async (format) => {\n        const extension = format === 'cjs' ? 'cjs' : 'mjs';\n        const content = generateQualifiedDictionaryEntryPoint(\n          key,\n          group.qualifierTypes,\n          entries,\n          locales,\n          format\n        );\n\n        const dynEntryPath = resolve(\n          dynamicDictionariesDir,\n          `${key}.${extension}`\n        );\n        assertPathWithin(dynEntryPath, dynamicDictionariesDir);\n\n        await writeFileIfChanged(dynEntryPath, content).catch((err) => {\n          console.error(\n            `Error creating dynamic ${colorizePath(dynEntryPath)}:`,\n            err\n          );\n        });\n      });\n    }\n  );\n};\n"],"mappings":"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"}

package/dist/esm/cli.mjs

@@ -9,7 +9,7 @@ import { getContentDeclarationFileTemplate } from "./getContentDeclarationFileTe
 import { writeJSFile } from "./writeContentDeclaration/writeJSFile.mjs";
 import { writeContentDeclaration } from "./writeContentDeclaration/writeContentDeclaration.mjs";
 import { enableEditorInConfig, setupCmsCredentials, writeCmsCredentialsToEnv } from "./init/cms.mjs";
-import { detectPackageManager, installPackages } from "./init/utils/packageManager.mjs";
+import { COMPAT_I18N_LIBRARIES, detectCompatI18nLibraries, detectPackageManager, installPackages } from "./init/utils/packageManager.mjs";
 import { NEXT_INTLAYER_BABEL_CONFIG_CONTENT } from "./init/utils/nextCompilerBabel.mjs";
 import { getDefaultApplicationURL, initIntlayer } from "./init/index.mjs";
 import { PLATFORMS, PLATFORMS_METADATA, SKILLS, SKILLS_METADATA, getInitialSkills, installSkills } from "./installSkills/index.mjs";
@@ -17,4 +17,4 @@ import { installMCP } from "./installMCP/installMCP.mjs";
 import { listGitFiles, listGitLines } from "./listGitFiles.mjs";
 import { logConfigDetails } from "./logConfigDetails.mjs";
 
-export { NEXT_INTLAYER_BABEL_CONFIG_CONTENT, PLATFORMS, PLATFORMS_METADATA, SKILLS, SKILLS_METADATA, detectExportedComponentName, detectFormatCommand, detectPackageManager, enableEditorInConfig, getContentDeclarationFileTemplate, getDefaultApplicationURL, getGitRootDir, getInitialSkills, initIntlayer, installLSP, installMCP, installPackages, installSkills, listDictionaries, listDictionariesWithStats, listGitFiles, listGitLines, listProjects, logConfigDetails, prepareIntlayer, setupCmsCredentials, transformJSFile, writeCmsCredentialsToEnv, writeContentDeclaration, writeJSFile };
+export { COMPAT_I18N_LIBRARIES, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, PLATFORMS, PLATFORMS_METADATA, SKILLS, SKILLS_METADATA, detectCompatI18nLibraries, detectExportedComponentName, detectFormatCommand, detectPackageManager, enableEditorInConfig, getContentDeclarationFileTemplate, getDefaultApplicationURL, getGitRootDir, getInitialSkills, initIntlayer, installLSP, installMCP, installPackages, installSkills, listDictionaries, listDictionariesWithStats, listGitFiles, listGitLines, listProjects, logConfigDetails, prepareIntlayer, setupCmsCredentials, transformJSFile, writeCmsCredentialsToEnv, writeContentDeclaration, writeJSFile };

package/dist/esm/createType/createModuleAugmentation.mjs

@@ -4,11 +4,28 @@ import { mkdir } from "node:fs/promises";
 import { basename, extname, join, relative } from "node:path";
 import fg from "fast-glob";
 import { kebabCaseToCamelCase, normalizePath } from "@intlayer/config/utils";
+import { getRewriteRules } from "@intlayer/core/localization";
 
 //#region src/createType/createModuleAugmentation.ts
 const getTypeName = (key) => `${kebabCaseToCamelCase(key)}Content`;
 /** Returns lines like: [Locales.FRENCH]: 1; */
 const formatLocales = (locales) => locales.map((locale) => `    "${locale}": 1;`).join("\n");
+/**
+* Serializes the `url` rewrite rules as a type literal, so `getLocalizedPath`
+* and `getLocalizedUrl` can resolve a canonical path to its localized literal at
+* the type level. Returns an empty string when the project declares no rewrite —
+* the consuming types then localize every path to itself.
+*
+* Rules are emitted in their normalized form (`:param`, no locale prefix), which
+* is exactly what the runtime matches against.
+*/
+const formatRewriteRules = (rewrite) => {
+	const rewriteRules = getRewriteRules(rewrite, "url");
+	if (!rewriteRules?.rules?.length) return "";
+	return `; rewrite: { ${rewriteRules.rules.map(({ canonical, localized }) => {
+		return `'${canonical}': { ${Object.entries(localized).filter(([, pattern]) => typeof pattern === "string").map(([locale, pattern]) => `'${locale}': '${pattern}'`).join("; ")} }`;
+	}).join("; ")} }`;
+};
 const zodToTsString = (schema) => {
 	if (!schema) return "any";
 	const def = schema._def ?? schema.def ?? schema;
@@ -95,7 +112,8 @@ const generateTypeIndexContent = (typeFiles, configuration, zodToTsFns) => {
 	fileContent += `  interface __StrictModeRegistry { mode: '${strictKey}' }\n\n`;
 	fileContent += `  interface __EditorRegistry { enabled : ${enabled} }\n\n`;
 	const routingMode = routing?.mode ?? "prefix-no-default";
-	fileContent += `  interface __RoutingRegistry { mode: '${routingMode}'; defaultLocale: '${defaultLocale}' }\n`;
+	const formattedRewriteRules = formatRewriteRules(routing?.rewrite);
+	fileContent += `  interface __RoutingRegistry { mode: '${routingMode}'; defaultLocale: '${defaultLocale}'${formattedRewriteRules} }\n`;
 	fileContent += `}\n`;
 	return fileContent;
 };
@@ -119,5 +137,5 @@ const createModuleAugmentation = async (configuration) => {
 };
 
 //#endregion
-export { createModuleAugmentation, getTypeName };
+export { createModuleAugmentation, formatRewriteRules, getTypeName };
 //# sourceMappingURL=createModuleAugmentation.mjs.map

package/dist/esm/createType/createModuleAugmentation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createModuleAugmentation.mjs","names":[],"sources":["../../../src/createType/createModuleAugmentation.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { basename, extname, join, relative } from 'node:path';\nimport { kebabCaseToCamelCase, normalizePath } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport fg from 'fast-glob';\nimport { getPathHash } from '../utils';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\n\nexport const getTypeName = (key: string): string =>\n  `${kebabCaseToCamelCase(key)}Content`;\n\n/** Returns lines like: [Locales.FRENCH]: 1; */\nconst formatLocales = (locales: Locale[]) =>\n  locales.map((locale) => `    \"${locale}\": 1;`).join('\\n');\n\nconst zodToTsString = (schema: any): string => {\n  if (!schema) return 'any';\n\n  // Support both real Zod objects (_def) and serialized versions (def or nested)\n  const def = schema._def ?? schema.def ?? schema;\n\n  // Handle serialized type names (sometimes 'type' instead of 'typeName')\n  const typeName = def.typeName ?? def.type;\n\n  switch (typeName) {\n    case 'ZodString':\n    case 'string':\n      return 'string';\n    case 'ZodNumber':\n    case 'number':\n      return 'number';\n    case 'ZodBoolean':\n    case 'boolean':\n      return 'boolean';\n    case 'ZodNull':\n    case 'null':\n      return 'null';\n    case 'ZodUndefined':\n    case 'undefined':\n      return 'undefined';\n    case 'ZodArray':\n    case 'array':\n      return `${zodToTsString(def.type ?? def.element)}[]`;\n    case 'ZodObject':\n    case 'object': {\n      const shape = typeof def.shape === 'function' ? def.shape() : def.shape;\n      if (!shape) return 'Record<string, any>';\n\n      const entries = Object.entries(shape)\n        .map(([k, v]) => `      \"${k}\": ${zodToTsString(v)};`)\n        .join('\\n');\n      return `{\\n${entries}\\n    }`;\n    }\n    case 'ZodOptional':\n    case 'optional':\n      return `${zodToTsString(def.innerType ?? def.wrapped)} | undefined`;\n    case 'ZodNullable':\n    case 'nullable':\n      return `${zodToTsString(def.innerType ?? def.wrapped)} | null`;\n    case 'ZodUnion':\n    case 'union': {\n      const options = def.options ?? [];\n      return options.map(zodToTsString).join(' | ');\n    }\n    case 'ZodIntersection':\n    case 'intersection':\n      return `${zodToTsString(def.left)} & ${zodToTsString(def.right)}`;\n    case 'ZodEnum':\n    case 'enum': {\n      const values = def.values ?? [];\n      return values.map((v: string) => `\"${v}\"`).join(' | ');\n    }\n    case 'ZodLiteral':\n    case 'literal': {\n      const value = def.value;\n      return typeof value === 'string' ? `\"${value}\"` : String(value);\n    }\n    default:\n      return 'any';\n  }\n};\n\ntype ZodToTsFns = {\n  zodToTs: (schema: any, opts?: any) => { node: any };\n  printNode: (node: any) => string;\n  createAuxiliaryTypeStore: () => any;\n};\n\n/** Generate the content of the module augmentation file */\nconst generateTypeIndexContent = (\n  typeFiles: string[],\n  configuration: IntlayerConfig,\n  zodToTsFns: ZodToTsFns | null\n): string => {\n  const { internationalization, system, editor, routing } = configuration;\n  const { moduleAugmentationDir } = system;\n  const { enabled } = editor;\n  const { locales, requiredLocales, strictMode, defaultLocale } =\n    internationalization;\n\n  let fileContent = 'import \"intlayer\";\\n';\n\n  // Build dictionary refs\n  const dictionariesRef = typeFiles.map((dictionaryPath) => ({\n    relativePath: `./${normalizePath(relative(moduleAugmentationDir, dictionaryPath))}`,\n    id: basename(dictionaryPath, extname(dictionaryPath)),\n    hash: `_${getPathHash(dictionaryPath)}`,\n  }));\n\n  // Import all dictionaries\n  for (const dictionary of dictionariesRef) {\n    fileContent += `import ${dictionary.hash} from '${dictionary.relativePath}';\\n`;\n  }\n  fileContent += '\\n';\n\n  // Dictionary map entries (id: typeof <hash>)\n  const formattedDictionaryMap: string = dictionariesRef\n    .map((dictionary) => `    \"${dictionary.id}\": typeof ${dictionary.hash};`)\n    .join('\\n');\n\n  // Ensure required ⊆ declared; if empty, default required = declared\n  const declared = locales;\n  const requiredSanitized = requiredLocales?.length\n    ? requiredLocales.filter((requiredLocales) =>\n        declared.includes(requiredLocales)\n      )\n    : declared;\n\n  const formattedDeclaredLocales = formatLocales(declared);\n  const formattedRequiredLocales = formatLocales(requiredSanitized);\n\n  // Build schema registry\n  const schemas = configuration.schemas ?? {};\n  const formattedSchemas = Object.entries(schemas)\n    .map(([key, schema]) => {\n      let typeStr = 'any';\n\n      if (schema) {\n        try {\n          if (zodToTsFns) {\n            const { node } = zodToTsFns.zodToTs(schema, {\n              auxiliaryTypeStore: zodToTsFns.createAuxiliaryTypeStore(),\n            });\n            // 133 is the kind for AnyKeyword in TypeScript\n            if ((node as any).kind !== 133) {\n              typeStr = zodToTsFns.printNode(node);\n            } else {\n              typeStr = zodToTsString(schema);\n            }\n          } else {\n            typeStr = zodToTsString(schema);\n          }\n        } catch (_e) {\n          // Fallback to custom string generator\n          typeStr = zodToTsString(schema);\n        }\n      }\n      return `    \"${key}\": ${typeStr};`;\n    })\n    .join('\\n');\n\n  // Choose strict mode registry key\n  const strictKey =\n    strictMode === 'strict'\n      ? 'strict'\n      : strictMode === 'inclusive'\n        ? 'inclusive'\n        : 'loose';\n\n  /**\n   * Module augmentation that ONLY adds keys to registries.\n   * No types/aliases redefined here—avoids merge conflicts.\n   */\n  fileContent += `declare module 'intlayer' {\\n`;\n  // Dictionaries registry\n  fileContent += `  interface __DictionaryRegistry {\\n${formattedDictionaryMap}\\n  }\\n\\n`;\n  // Locales registries\n  fileContent += `  interface __DeclaredLocalesRegistry {\\n${formattedDeclaredLocales}\\n  }\\n\\n`;\n  fileContent += `  interface __RequiredLocalesRegistry {\\n${formattedRequiredLocales}\\n  }\\n\\n`;\n  // Schema registry\n  fileContent += `  interface __SchemaRegistry {\\n${formattedSchemas}\\n  }\\n\\n`;\n  // Resolved strict mode (narrow the literal at build time)\n  fileContent += `  interface __StrictModeRegistry { mode: '${strictKey}' }\\n\\n`;\n  // Editor registry\n  fileContent += `  interface __EditorRegistry { enabled : ${enabled} }\\n\\n`;\n  // Routing registry (mode + defaultLocale narrowed to literals)\n  const routingMode = routing?.mode ?? 'prefix-no-default';\n  fileContent += `  interface __RoutingRegistry { mode: '${routingMode}'; defaultLocale: '${defaultLocale}' }\\n`;\n  fileContent += `}\\n`;\n\n  return fileContent;\n};\n\n/** Generate the index file merging all the types */\nexport const createModuleAugmentation = async (\n  configuration: IntlayerConfig\n) => {\n  const { moduleAugmentationDir, typesDir } = configuration.system;\n\n  await mkdir(moduleAugmentationDir, { recursive: true });\n\n  const dictionariesTypesDefinitions: string[] = await fg(\n    normalizePath(`${typesDir}/*.ts`),\n    { ignore: ['**/*.d.ts'] }\n  );\n\n  let zodToTsFns: ZodToTsFns | null = null;\n\n  const hasSchemas = Object.keys(configuration.schemas ?? {}).length > 0;\n\n  // zod-to-ts drags in the whole `typescript` package (~300ms import), so\n  // only load it when there are schemas to convert.\n  if (hasSchemas) {\n    try {\n      const mod = await import('zod-to-ts');\n      zodToTsFns = {\n        zodToTs: mod.zodToTs,\n        printNode: mod.printNode,\n        createAuxiliaryTypeStore: mod.createAuxiliaryTypeStore,\n      };\n    } catch {\n      // typescript peer dep not installed (plain JS project), use fallback\n    }\n  }\n\n  const tsContent = generateTypeIndexContent(\n    dictionariesTypesDefinitions,\n    configuration,\n    zodToTsFns\n  );\n\n  const tsFilePath = join(moduleAugmentationDir, 'intlayer.d.ts');\n  await writeFileIfChanged(tsFilePath, tsContent);\n};\n"],"mappings":"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"}
+{"version":3,"file":"createModuleAugmentation.mjs","names":[],"sources":["../../../src/createType/createModuleAugmentation.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { basename, extname, join, relative } from 'node:path';\nimport { kebabCaseToCamelCase, normalizePath } from '@intlayer/config/utils';\nimport { getRewriteRules } from '@intlayer/core/localization';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig, RoutingConfig } from '@intlayer/types/config';\nimport fg from 'fast-glob';\nimport { getPathHash } from '../utils';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\n\nexport const getTypeName = (key: string): string =>\n  `${kebabCaseToCamelCase(key)}Content`;\n\n/** Returns lines like: [Locales.FRENCH]: 1; */\nconst formatLocales = (locales: Locale[]) =>\n  locales.map((locale) => `    \"${locale}\": 1;`).join('\\n');\n\n/**\n * Serializes the `url` rewrite rules as a type literal, so `getLocalizedPath`\n * and `getLocalizedUrl` can resolve a canonical path to its localized literal at\n * the type level. Returns an empty string when the project declares no rewrite —\n * the consuming types then localize every path to itself.\n *\n * Rules are emitted in their normalized form (`:param`, no locale prefix), which\n * is exactly what the runtime matches against.\n */\nexport const formatRewriteRules = (\n  rewrite: RoutingConfig['rewrite']\n): string => {\n  const rewriteRules = getRewriteRules(rewrite, 'url');\n\n  if (!rewriteRules?.rules?.length) return '';\n\n  const formattedRules = rewriteRules.rules\n    .map(({ canonical, localized }) => {\n      const formattedLocalized = Object.entries(localized)\n        .filter(([, pattern]) => typeof pattern === 'string')\n        .map(([locale, pattern]) => `'${locale}': '${pattern}'`)\n        .join('; ');\n\n      return `'${canonical}': { ${formattedLocalized} }`;\n    })\n    .join('; ');\n\n  return `; rewrite: { ${formattedRules} }`;\n};\n\nconst zodToTsString = (schema: any): string => {\n  if (!schema) return 'any';\n\n  // Support both real Zod objects (_def) and serialized versions (def or nested)\n  const def = schema._def ?? schema.def ?? schema;\n\n  // Handle serialized type names (sometimes 'type' instead of 'typeName')\n  const typeName = def.typeName ?? def.type;\n\n  switch (typeName) {\n    case 'ZodString':\n    case 'string':\n      return 'string';\n    case 'ZodNumber':\n    case 'number':\n      return 'number';\n    case 'ZodBoolean':\n    case 'boolean':\n      return 'boolean';\n    case 'ZodNull':\n    case 'null':\n      return 'null';\n    case 'ZodUndefined':\n    case 'undefined':\n      return 'undefined';\n    case 'ZodArray':\n    case 'array':\n      return `${zodToTsString(def.type ?? def.element)}[]`;\n    case 'ZodObject':\n    case 'object': {\n      const shape = typeof def.shape === 'function' ? def.shape() : def.shape;\n      if (!shape) return 'Record<string, any>';\n\n      const entries = Object.entries(shape)\n        .map(([k, v]) => `      \"${k}\": ${zodToTsString(v)};`)\n        .join('\\n');\n      return `{\\n${entries}\\n    }`;\n    }\n    case 'ZodOptional':\n    case 'optional':\n      return `${zodToTsString(def.innerType ?? def.wrapped)} | undefined`;\n    case 'ZodNullable':\n    case 'nullable':\n      return `${zodToTsString(def.innerType ?? def.wrapped)} | null`;\n    case 'ZodUnion':\n    case 'union': {\n      const options = def.options ?? [];\n      return options.map(zodToTsString).join(' | ');\n    }\n    case 'ZodIntersection':\n    case 'intersection':\n      return `${zodToTsString(def.left)} & ${zodToTsString(def.right)}`;\n    case 'ZodEnum':\n    case 'enum': {\n      const values = def.values ?? [];\n      return values.map((v: string) => `\"${v}\"`).join(' | ');\n    }\n    case 'ZodLiteral':\n    case 'literal': {\n      const value = def.value;\n      return typeof value === 'string' ? `\"${value}\"` : String(value);\n    }\n    default:\n      return 'any';\n  }\n};\n\ntype ZodToTsFns = {\n  zodToTs: (schema: any, opts?: any) => { node: any };\n  printNode: (node: any) => string;\n  createAuxiliaryTypeStore: () => any;\n};\n\n/** Generate the content of the module augmentation file */\nconst generateTypeIndexContent = (\n  typeFiles: string[],\n  configuration: IntlayerConfig,\n  zodToTsFns: ZodToTsFns | null\n): string => {\n  const { internationalization, system, editor, routing } = configuration;\n  const { moduleAugmentationDir } = system;\n  const { enabled } = editor;\n  const { locales, requiredLocales, strictMode, defaultLocale } =\n    internationalization;\n\n  let fileContent = 'import \"intlayer\";\\n';\n\n  // Build dictionary refs\n  const dictionariesRef = typeFiles.map((dictionaryPath) => ({\n    relativePath: `./${normalizePath(relative(moduleAugmentationDir, dictionaryPath))}`,\n    id: basename(dictionaryPath, extname(dictionaryPath)),\n    hash: `_${getPathHash(dictionaryPath)}`,\n  }));\n\n  // Import all dictionaries\n  for (const dictionary of dictionariesRef) {\n    fileContent += `import ${dictionary.hash} from '${dictionary.relativePath}';\\n`;\n  }\n  fileContent += '\\n';\n\n  // Dictionary map entries (id: typeof <hash>)\n  const formattedDictionaryMap: string = dictionariesRef\n    .map((dictionary) => `    \"${dictionary.id}\": typeof ${dictionary.hash};`)\n    .join('\\n');\n\n  // Ensure required ⊆ declared; if empty, default required = declared\n  const declared = locales;\n  const requiredSanitized = requiredLocales?.length\n    ? requiredLocales.filter((requiredLocales) =>\n        declared.includes(requiredLocales)\n      )\n    : declared;\n\n  const formattedDeclaredLocales = formatLocales(declared);\n  const formattedRequiredLocales = formatLocales(requiredSanitized);\n\n  // Build schema registry\n  const schemas = configuration.schemas ?? {};\n  const formattedSchemas = Object.entries(schemas)\n    .map(([key, schema]) => {\n      let typeStr = 'any';\n\n      if (schema) {\n        try {\n          if (zodToTsFns) {\n            const { node } = zodToTsFns.zodToTs(schema, {\n              auxiliaryTypeStore: zodToTsFns.createAuxiliaryTypeStore(),\n            });\n            // 133 is the kind for AnyKeyword in TypeScript\n            if ((node as any).kind !== 133) {\n              typeStr = zodToTsFns.printNode(node);\n            } else {\n              typeStr = zodToTsString(schema);\n            }\n          } else {\n            typeStr = zodToTsString(schema);\n          }\n        } catch (_e) {\n          // Fallback to custom string generator\n          typeStr = zodToTsString(schema);\n        }\n      }\n      return `    \"${key}\": ${typeStr};`;\n    })\n    .join('\\n');\n\n  // Choose strict mode registry key\n  const strictKey =\n    strictMode === 'strict'\n      ? 'strict'\n      : strictMode === 'inclusive'\n        ? 'inclusive'\n        : 'loose';\n\n  /**\n   * Module augmentation that ONLY adds keys to registries.\n   * No types/aliases redefined here—avoids merge conflicts.\n   */\n  fileContent += `declare module 'intlayer' {\\n`;\n  // Dictionaries registry\n  fileContent += `  interface __DictionaryRegistry {\\n${formattedDictionaryMap}\\n  }\\n\\n`;\n  // Locales registries\n  fileContent += `  interface __DeclaredLocalesRegistry {\\n${formattedDeclaredLocales}\\n  }\\n\\n`;\n  fileContent += `  interface __RequiredLocalesRegistry {\\n${formattedRequiredLocales}\\n  }\\n\\n`;\n  // Schema registry\n  fileContent += `  interface __SchemaRegistry {\\n${formattedSchemas}\\n  }\\n\\n`;\n  // Resolved strict mode (narrow the literal at build time)\n  fileContent += `  interface __StrictModeRegistry { mode: '${strictKey}' }\\n\\n`;\n  // Editor registry\n  fileContent += `  interface __EditorRegistry { enabled : ${enabled} }\\n\\n`;\n  // Routing registry (mode + defaultLocale narrowed to literals)\n  const routingMode = routing?.mode ?? 'prefix-no-default';\n  const formattedRewriteRules = formatRewriteRules(routing?.rewrite);\n  fileContent += `  interface __RoutingRegistry { mode: '${routingMode}'; defaultLocale: '${defaultLocale}'${formattedRewriteRules} }\\n`;\n  fileContent += `}\\n`;\n\n  return fileContent;\n};\n\n/** Generate the index file merging all the types */\nexport const createModuleAugmentation = async (\n  configuration: IntlayerConfig\n) => {\n  const { moduleAugmentationDir, typesDir } = configuration.system;\n\n  await mkdir(moduleAugmentationDir, { recursive: true });\n\n  const dictionariesTypesDefinitions: string[] = await fg(\n    normalizePath(`${typesDir}/*.ts`),\n    { ignore: ['**/*.d.ts'] }\n  );\n\n  let zodToTsFns: ZodToTsFns | null = null;\n\n  const hasSchemas = Object.keys(configuration.schemas ?? {}).length > 0;\n\n  // zod-to-ts drags in the whole `typescript` package (~300ms import), so\n  // only load it when there are schemas to convert.\n  if (hasSchemas) {\n    try {\n      const mod = await import('zod-to-ts');\n      zodToTsFns = {\n        zodToTs: mod.zodToTs,\n        printNode: mod.printNode,\n        createAuxiliaryTypeStore: mod.createAuxiliaryTypeStore,\n      };\n    } catch {\n      // typescript peer dep not installed (plain JS project), use fallback\n    }\n  }\n\n  const tsContent = generateTypeIndexContent(\n    dictionariesTypesDefinitions,\n    configuration,\n    zodToTsFns\n  );\n\n  const tsFilePath = join(moduleAugmentationDir, 'intlayer.d.ts');\n  await writeFileIfChanged(tsFilePath, tsContent);\n};\n"],"mappings":"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"}

package/dist/esm/createType/index.mjs

@@ -1,4 +1,4 @@
-import { createModuleAugmentation, getTypeName } from "./createModuleAugmentation.mjs";
+import { createModuleAugmentation, formatRewriteRules, getTypeName } from "./createModuleAugmentation.mjs";
 import { createTypes, generateTypeScriptType } from "./createType.mjs";
 
-export { createModuleAugmentation, createTypes, generateTypeScriptType, getTypeName };
+export { createModuleAugmentation, createTypes, formatRewriteRules, generateTypeScriptType, getTypeName };

package/dist/esm/init/index.mjs

@@ -4,7 +4,7 @@ import { setCompilerOutputInConfig, setRoutingModeInConfig } from "./cms.mjs";
 import { initConfig } from "../initConfig/index.mjs";
 import { isVersionAtLeast } from "./utils/version.mjs";
 import { setupFramework } from "./frameworkSetup/index.mjs";
-import { detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, installPackages, upgradePackages } from "./utils/packageManager.mjs";
+import { detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, hasLintTooling, installPackages, upgradePackages } from "./utils/packageManager.mjs";
 import { getGithubWorkflows, resolveGithubWorkflowsContext } from "./utils/githubActions.mjs";
 import { parseJSONWithComments } from "./utils/jsonParser.mjs";
 import { setupNextCompilerBabelConfig } from "./utils/nextCompilerBabel.mjs";
@@ -43,6 +43,7 @@ const DocumentationRouter = {
 	Fastify: "https://intlayer.org/doc/environment/fastify.md",
 	Default: "https://intlayer.org/doc/get-started",
 	LSP: "https://intlayer.org/doc/lsp.md",
+	ESLint: "https://intlayer.org/doc/eslint.md",
 	NextIntl: "https://intlayer.org/blog/intlayer-with-next-intl.md",
 	ReactI18Next: "https://intlayer.org/blog/intlayer-with-react-i18next.md",
 	ReactIntl: "https://intlayer.org/blog/intlayer-with-react-intl.md",
@@ -50,6 +51,26 @@ const DocumentationRouter = {
 	VueI18n: "https://intlayer.org/blog/intlayer-with-vue-i18n.md"
 };
 /**
+* The Intlayer lint setup, as `intlayer init` writes it into `.oxlintrc.json`.
+*
+* Declared locally on purpose: `@intlayer/engine` is installed by every Intlayer
+* user, so it must not depend on a lint plugin to write a handful of strings
+* into a JSON file. oxlint resolves a plugin's *rules* but not its shipped
+* *configs*, so the preset cannot be referenced by name there either.
+*
+* Mirrors the `recommended` preset of `eslint-plugin-intlayer`; keep in sync
+* when a rule is enabled by default there.
+*/
+const LINT_PLUGIN_PACKAGE_NAME = "eslint-plugin-intlayer";
+/** Intlayer's generated output — never source, never worth linting. */
+const GENERATED_OUTPUT_GLOBS = ["**/.intlayer/**"];
+/** Rules of the `recommended` preset, prefixed by the plugin namespace. */
+const getRecommendedRules = () => ({
+	"intlayer/no-raw-text": "warn",
+	"intlayer/static-dictionary-key": "error",
+	"intlayer/no-dynamic-field-access": "error"
+});
+/**
 * Helper: Detects the environment and returns the doc URL
 */
 const getDocumentationUrl = (packageJson) => {
@@ -140,18 +161,13 @@ const initIntlayer = async (rootDir, options) => {
 		...packageJson.dependencies ?? {},
 		...packageJson.devDependencies ?? {}
 	};
-	const effectiveAllDeps = {
-		...allDeps,
-		...options?.hintDependencies ?? {}
-	};
 	const packageManager = detectPackageManager(rootDir);
-	const linguiPresent = Boolean(effectiveAllDeps["@lingui/core"] || effectiveAllDeps["@lingui/react"] || effectiveAllDeps["@intlayer/lingui"]);
+	const linguiPresent = Boolean(allDeps["@lingui/core"] || allDeps["@lingui/react"] || allDeps["@intlayer/lingui"]);
 	const linguiCatalog = linguiPresent ? await detectLinguiCatalogPattern(rootDir) : null;
-	const hintLinguiJson = Boolean(options?.hintDependencies?.["__lingui_json__"]);
-	const linguiCatalogFormat = linguiCatalog?.format ?? (linguiPresent ? hintLinguiJson ? "json" : "po" : null);
-	const { packagesToInstall, devPackagesToInstall, compatSyncConfig, compatVitePluginConfig } = detectMissingIntlayerPackages(effectiveAllDeps, { linguiCatalogFormat });
+	const linguiCatalogFormat = linguiCatalog?.format ?? (linguiPresent ? "po" : null);
+	const { packagesToInstall, devPackagesToInstall, compatSyncConfig, compatVitePluginConfig } = detectMissingIntlayerPackages(allDeps, { linguiCatalogFormat });
 	const wantsJsonNamespaces = options?.contentStrategy === "json-namespaces" && !compatSyncConfig;
-	if (wantsJsonNamespaces && !effectiveAllDeps["@intlayer/sync-json-plugin"] && !devPackagesToInstall.includes("@intlayer/sync-json-plugin")) devPackagesToInstall.push("@intlayer/sync-json-plugin");
+	if (wantsJsonNamespaces && !allDeps["@intlayer/sync-json-plugin"] && !devPackagesToInstall.includes("@intlayer/sync-json-plugin")) devPackagesToInstall.push("@intlayer/sync-json-plugin");
 	if (!options?.noInstallPackages) {
 		const withVersion = (packages) => options?.upgradeToVersion ? packages.map((pkg) => `${pkg}@${options.upgradeToVersion}`) : packages;
 		if (packagesToInstall.length > 0) {
@@ -255,6 +271,41 @@ const initIntlayer = async (rootDir, options) => {
 	} catch {
 		logger(`${x} Could not update ${colorizePath(settingsJsonPath)}. You may need to add the LSP settings manually.`, { level: "warn" });
 	}
+	if (!options?.noEslint && hasLintTooling(allDeps)) {
+		const oxlintConfigPath = ".oxlintrc.json";
+		if (await exists(rootDir, oxlintConfigPath)) try {
+			const content = await readFileFromRoot(rootDir, oxlintConfigPath);
+			const oxlintConfig = parseJSONWithComments(content);
+			oxlintConfig.jsPlugins ??= [];
+			oxlintConfig.rules ??= {};
+			oxlintConfig.ignorePatterns ??= [];
+			let oxlintUpdated = false;
+			for (const glob of GENERATED_OUTPUT_GLOBS) if (!oxlintConfig.ignorePatterns.includes(glob)) {
+				oxlintConfig.ignorePatterns.push(glob);
+				oxlintUpdated = true;
+			}
+			if (!oxlintConfig.jsPlugins.includes(LINT_PLUGIN_PACKAGE_NAME)) {
+				oxlintConfig.jsPlugins.push(LINT_PLUGIN_PACKAGE_NAME);
+				oxlintUpdated = true;
+			}
+			for (const [ruleName, severity] of Object.entries(getRecommendedRules())) if (!oxlintConfig.rules[ruleName]) {
+				oxlintConfig.rules[ruleName] = severity;
+				oxlintUpdated = true;
+			}
+			if (oxlintUpdated) {
+				await writeFileToRoot(rootDir, oxlintConfigPath, JSON.stringify(oxlintConfig, null, 2));
+				logger(`${v} Added the Intlayer lint rules to ${colorizePath(oxlintConfigPath)}`);
+			} else logger(`${v} ${colorizePath(oxlintConfigPath)} already includes the Intlayer lint rules`);
+		} catch {
+			logger(`${x} Could not update ${colorizePath(oxlintConfigPath)}. You may need to add ${colorize(LINT_PLUGIN_PACKAGE_NAME, ANSIColors.MAGENTA)} manually.`, { level: "warn" });
+		}
+		else logger([
+			colorize("Intlayer lint rules →", ANSIColors.MAGENTA),
+			colorize(`Add ${LINT_PLUGIN_PACKAGE_NAME} to your ESLint flat config to catch hardcoded text and dynamic calls the compiler cannot optimize:`, ANSIColors.GREY_LIGHT),
+			colorize(`  import intlayer from '${LINT_PLUGIN_PACKAGE_NAME}';\n  export default [...intlayer.configs.recommended];`, ANSIColors.GREY_LIGHT),
+			colorizePath(DocumentationRouter.ESLint)
+		]);
+	}
 	const tsConfigFiles = await findTsConfigFiles(rootDir);
 	let hasTsConfig = false;
 	for (const fileName of tsConfigFiles) if (await exists(rootDir, fileName)) {