@intlayer/engine 9.3.0 → 9.3.2

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

@@ -1 +1 @@
-{"version":3,"file":"fileSystem.mjs","names":[],"sources":["../../../../src/init/utils/fileSystem.ts"],"sourcesContent":["import { access, mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, join, relative, resolve, sep } from 'node:path';\nimport { EXCLUDED_PATHS } from '@intlayer/config/defaultValues';\nimport { ALL_LOCALES } from '@intlayer/types/allLocales';\nimport fg from 'fast-glob';\n\n/**\n * Helper to check if a file exists\n */\nexport const exists = async (rootDir: string, filePath: string) => {\n  try {\n    await access(join(rootDir, filePath));\n    return true;\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Helper to read a file\n */\nexport const readFileFromRoot = async (rootDir: string, filePath: string) =>\n  await readFile(join(rootDir, filePath), 'utf8');\n\n/**\n * Helper to write a file\n */\nexport const writeFileToRoot = async (\n  rootDir: string,\n  filePath: string,\n  content: string\n) => await writeFile(join(rootDir, filePath), content, 'utf8');\n\n/**\n * Helper to ensure a directory exists\n */\nexport const ensureDirectory = async (rootDir: string, dirPath: string) => {\n  try {\n    await mkdir(join(rootDir, dirPath), { recursive: true });\n  } catch {\n    // Directory already exists or could not be created\n  }\n};\n\n/**\n * Pattern type for locale JSON file organisation.\n * - 'nested': files are at `{base}/{locale}/{key}.json`\n * - 'flat':   files are at `{base}/{locale}.json`\n */\nexport type JsonLocalePatternType = 'nested' | 'flat';\n\n/**\n * Detected locale JSON file pattern and the corresponding source template.\n * `template` uses `${locale}` and `${key}` as literal placeholders (not JS\n * expressions) so it can be embedded directly in a template-literal string.\n */\nexport type JsonLocalePattern = {\n  type: JsonLocalePatternType;\n  /**\n   * Source path template for syncJSON `source` option.\n   * Example nested: `./locales/${locale}/${key}.json`\n   * Example flat:   `./locales/${locale}.json`\n   */\n  template: string;\n  /**\n   * Detected locales in the directory.\n   */\n  locales: string[];\n};\n\n/**\n * Set of all known locale string values from the intlayer Locales registry\n * (e.g. `'en'`, `'fr'`, `'zh-TW'`).  Keyed by the exact locale string so\n * `.has()` lookups are O(1) and common short directory names (`src`, `lib`,\n * `app`, …) are not mistaken for locales.\n */\nconst ALL_LOCALE_VALUES = new Set<string>(Object.values(ALL_LOCALES));\n\n/**\n * Returns true when `segment` matches a known BCP-47 locale identifier, e.g.\n * `en`, `fr`, `zh-TW`, `pt-BR`, `en-US`.\n */\nconst isLocaleSegment = (segment: string): boolean =>\n  ALL_LOCALE_VALUES.has(segment);\n\n/** JSON filenames that are never locale translation files. */\nconst KNOWN_CONFIG_FILENAMES = new Set([\n  'package.json',\n  'tsconfig.json',\n  'jsconfig.json',\n  'biome.json',\n  'turbo.json',\n  'lerna.json',\n  'vercel.json',\n  'netlify.json',\n  'babel.config.json',\n  'jest.config.json',\n  'vitest.config.json',\n  '.eslintrc.json',\n  '.prettierrc.json',\n]);\n\n/**\n * Scans the project for JSON files and determines whether locale files are\n * organised as `{base}/{locale}/{key}.json` (nested) or `{base}/{locale}.json`\n * (flat).  Returns the most likely source template, or `null` when no locale\n * JSON files are found.\n *\n * The returned `template` contains `${locale}` and `${key}` as **literal**\n * placeholder strings so it can be embedded inside a JS template literal.\n */\nexport const detectJsonLocalePattern = async (\n  rootDir: string\n): Promise<JsonLocalePattern | null> => {\n  const files = await fg('**/*.json', {\n    cwd: rootDir,\n    ignore: EXCLUDED_PATHS,\n    absolute: false,\n    onlyFiles: true,\n  });\n\n  const nestedBasePaths: string[] = [];\n  const flatBasePaths: string[] = [];\n  const nestedLocales = new Set<string>();\n  const flatLocales = new Set<string>();\n\n  for (const file of files) {\n    const parts = file.split('/');\n    const filename = parts[parts.length - 1] ?? '';\n\n    if (KNOWN_CONFIG_FILENAMES.has(filename)) continue;\n\n    // Nested: …/{locale}/{key}.json — parent directory is a locale code\n    if (parts.length >= 3) {\n      const localeDir = parts[parts.length - 2] ?? '';\n      if (isLocaleSegment(localeDir)) {\n        nestedBasePaths.push(parts.slice(0, -2).join('/') || '.');\n        nestedLocales.add(localeDir);\n      }\n    }\n\n    // Flat: …/{locale}.json — filename (without extension) is a locale code\n    if (parts.length >= 2) {\n      const baseName = filename.slice(0, -5); // strip \".json\"\n      if (isLocaleSegment(baseName)) {\n        flatBasePaths.push(parts.slice(0, -1).join('/') || '.');\n        flatLocales.add(baseName);\n      }\n    }\n  }\n\n  if (nestedBasePaths.length === 0 && flatBasePaths.length === 0) {\n    return null;\n  }\n\n  /**\n   * Returns the path prefix that appears most frequently among the matches,\n   * formatted as a relative path suitable for a source template.\n   */\n  const mostFrequentPrefix = (paths: string[]): string => {\n    const counts = paths.reduce<Record<string, number>>((accumulator, path) => {\n      accumulator[path] = (accumulator[path] ?? 0) + 1;\n      return accumulator;\n    }, {});\n    const topEntry = Object.entries(counts).sort(([, a], [, b]) => b - a)[0];\n    const basePath = topEntry?.[0] ?? '.';\n    return basePath === '.' ? '.' : `./${basePath}`;\n  };\n\n  if (nestedBasePaths.length >= flatBasePaths.length) {\n    const prefix = mostFrequentPrefix(nestedBasePaths);\n    return {\n      type: 'nested',\n      // Literal ${locale} and ${key} — not evaluated here, used in template literals\n      template: `${prefix}/\\${locale}/\\${key}.json`,\n      locales: Array.from(nestedLocales),\n    };\n  }\n\n  const prefix = mostFrequentPrefix(flatBasePaths);\n  return {\n    type: 'flat',\n    template: `${prefix}/\\${locale}.json`,\n    locales: Array.from(flatLocales),\n  };\n};\n\n/**\n * Detected lingui catalog pattern. lingui stores one catalog file per locale\n * (default name `messages`), as `.po` (its default) or `.json`.\n */\nexport type LinguiCatalogPattern = {\n  /** Which sync plugin should ingest the catalogs. */\n  format: 'po' | 'json';\n  /**\n   * Source path template, with `${locale}` and `${key}` as literal\n   * placeholders. The catalog filename (`messages`) is captured by `${key}` so\n   * the produced intlayer dictionary key is `messages` — matching the fixed\n   * `messages` namespace the lingui compat runtime reads from.\n   * Example: `./src/locales/${locale}/${key}.po`.\n   */\n  template: string;\n  /** Detected locales. */\n  locales: string[];\n};\n\n/**\n * Scans the project for lingui catalog files (`{base}/{locale}/messages.po` or\n * `…/messages.json`, lingui's default layout) and derives the `syncPO` /\n * `syncJSON` `source` template.\n *\n * `.po` is preferred when present (lingui's default format). Returns `null`\n * when no lingui catalog is found, in which case the caller falls back to the\n * generic JSON detection.\n *\n * @param rootDir - Project root directory.\n */\nexport const detectLinguiCatalogPattern = async (\n  rootDir: string\n): Promise<LinguiCatalogPattern | null> => {\n  // lingui's default catalog name is `messages`; match that basename for both\n  // formats so the captured `${key}` is `messages`.\n  const files = await fg(['**/messages.po', '**/messages.json'], {\n    cwd: rootDir,\n    ignore: EXCLUDED_PATHS,\n    absolute: false,\n    onlyFiles: true,\n  });\n\n  const basePathsByFormat: Record<'po' | 'json', string[]> = {\n    po: [],\n    json: [],\n  };\n  const localesByFormat: Record<'po' | 'json', Set<string>> = {\n    po: new Set(),\n    json: new Set(),\n  };\n\n  for (const file of files) {\n    const parts = file.split('/');\n    // Nested layout: …/{locale}/messages.{po,json} — parent dir is the locale.\n    if (parts.length < 2) continue;\n\n    const localeDir = parts[parts.length - 2] ?? '';\n    if (!isLocaleSegment(localeDir)) continue;\n\n    const extension = (file.endsWith('.po') ? 'po' : 'json') as 'po' | 'json';\n    basePathsByFormat[extension].push(parts.slice(0, -2).join('/') || '.');\n    localesByFormat[extension].add(localeDir);\n  }\n\n  // Prefer `.po` (lingui's default) when catalogs of both formats coexist.\n  const format: 'po' | 'json' = basePathsByFormat.po.length > 0 ? 'po' : 'json';\n\n  const basePaths = basePathsByFormat[format];\n  if (basePaths.length === 0) return null;\n\n  const counts = basePaths.reduce<Record<string, number>>(\n    (accumulator, path) => {\n      accumulator[path] = (accumulator[path] ?? 0) + 1;\n      return accumulator;\n    },\n    {}\n  );\n  const topBasePath =\n    Object.entries(counts).sort(([, a], [, b]) => b - a)[0]?.[0] ?? '.';\n  const prefix = topBasePath === '.' ? '.' : `./${topBasePath}`;\n\n  return {\n    format,\n    template: `${prefix}/\\${locale}/\\${key}.${format}`,\n    locales: Array.from(localesByFormat[format]),\n  };\n};\n\n/**\n * The messages source template derived from a `next-intl` `i18n/request.ts`\n * file, ready to be used as a `syncJSON` `source` builder.\n */\nexport type NextIntlMessagesPattern = {\n  /** `'flat'` (one file per locale) or `'nested'` (per-namespace files). */\n  type: JsonLocalePatternType;\n  /**\n   * Source path template relative to the project root, with `${locale}` (and\n   * `${key}` when nested) as literal placeholders, e.g. `./messages/${locale}.json`.\n   */\n  template: string;\n};\n\n/** Common locations of the `next-intl` request config, relative to the root. */\nconst NEXT_INTL_REQUEST_FILES = [\n  'i18n/request.ts',\n  'i18n/request.tsx',\n  'i18n/request.js',\n  'i18n/request.mjs',\n  'src/i18n/request.ts',\n  'src/i18n/request.tsx',\n  'src/i18n/request.js',\n  'src/i18n/request.mjs',\n  'app/i18n/request.ts',\n  'src/app/i18n/request.ts',\n];\n\n/**\n * Derives the messages source template from a `next-intl` `i18n/request.ts`\n * file, which is the authoritative location of the messages path in a next-intl\n * project (e.g. `messages: (await import(\\`../messages/${locale}.json\\`)).default`).\n *\n * Reading it removes the ambiguity of globbing the file system and yields the\n * exact `source` template for `syncJSON`. When the resulting template has no\n * `${key}` segment (the common single-file-per-locale layout, where top-level\n * keys are namespaces), `syncJSON` `splitKeys` auto-detection turns each\n * top-level key into its own dictionary.\n *\n * Returns `null` when no request file is found, the messages import cannot be\n * parsed, or the path is not project-root-relative (e.g. uses a TS path alias).\n *\n * @param rootDir - Project root directory.\n */\nexport const detectNextIntlMessagesPattern = async (\n  rootDir: string\n): Promise<NextIntlMessagesPattern | null> => {\n  for (const requestFile of NEXT_INTL_REQUEST_FILES) {\n    if (!(await exists(rootDir, requestFile))) continue;\n\n    const content = await readFileFromRoot(rootDir, requestFile);\n\n    // Capture the template-literal path of the messages dynamic import, e.g.\n    // import(`../messages/${locale}.json`) → `../messages/${locale}.json`.\n    const importMatch = content.match(\n      /import\\(\\s*`([^`]*\\$\\{\\s*locale\\s*\\}[^`]*\\.json)`/\n    );\n\n    const importPath = importMatch?.[1];\n    if (!importPath) continue;\n\n    // Only relative imports can be resolved against the file system; path\n    // aliases (e.g. `@/messages/...`) are skipped in favour of glob detection.\n    if (!importPath.startsWith('.')) continue;\n\n    // Resolve the import (relative to the request file) back to a\n    // project-root-relative template. The `${locale}` / `${key}` placeholders\n    // are kept literal — path utilities treat them as ordinary segments.\n    const requestDir = dirname(resolve(rootDir, requestFile));\n    const absoluteTemplate = resolve(requestDir, importPath);\n    const relativeTemplate = relative(rootDir, absoluteTemplate)\n      .split(sep)\n      .join('/');\n\n    const template = relativeTemplate.startsWith('.')\n      ? relativeTemplate\n      : `./${relativeTemplate}`;\n\n    const type: JsonLocalePatternType =\n      template.includes('${key}') || template.includes('${namespace}')\n        ? 'nested'\n        : 'flat';\n\n    return { type, template };\n  }\n\n  return null;\n};\n"],"mappings":"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"}
+{"version":3,"file":"fileSystem.mjs","names":[],"sources":["../../../../src/init/utils/fileSystem.ts"],"sourcesContent":["import { access, mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, join, relative, resolve, sep } from 'node:path';\nimport { EXCLUDED_PATHS } from '@intlayer/config/defaultValues';\nimport { ALL_LOCALES } from '@intlayer/types/allLocales';\nimport fg from 'fast-glob';\n\n/**\n * Helper to check if a file exists\n */\nexport const exists = async (rootDir: string, filePath: string) => {\n  try {\n    await access(join(rootDir, filePath));\n    return true;\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Helper to read a file\n */\nexport const readFileFromRoot = async (rootDir: string, filePath: string) =>\n  await readFile(join(rootDir, filePath), 'utf8');\n\n/**\n * Helper to write a file\n */\nexport const writeFileToRoot = async (\n  rootDir: string,\n  filePath: string,\n  content: string\n) => await writeFile(join(rootDir, filePath), content, 'utf8');\n\n/**\n * Helper to ensure a directory exists\n */\nexport const ensureDirectory = async (rootDir: string, dirPath: string) => {\n  try {\n    await mkdir(join(rootDir, dirPath), { recursive: true });\n  } catch {\n    // Directory already exists or could not be created\n  }\n};\n\n/**\n * Pattern type for locale JSON file organisation.\n * - 'nested': files are at `{base}/{locale}/{key}.json`\n * - 'flat':   files are at `{base}/{locale}.json`\n */\nexport type JsonLocalePatternType = 'nested' | 'flat';\n\n/**\n * Detected locale JSON file pattern and the corresponding source template.\n * `template` uses `${locale}` and `${key}` as literal placeholders (not JS\n * expressions) so it can be embedded directly in a template-literal string.\n */\nexport type JsonLocalePattern = {\n  type: JsonLocalePatternType;\n  /**\n   * Source path template for syncJSON `source` option.\n   * Example nested: `./locales/${locale}/${key}.json`\n   * Example flat:   `./locales/${locale}.json`\n   */\n  template: string;\n  /**\n   * Detected locales in the directory.\n   */\n  locales: string[];\n};\n\n/**\n * Set of all known locale string values from the intlayer Locales registry\n * (e.g. `'en'`, `'fr'`, `'zh-TW'`).  Keyed by the exact locale string so\n * `.has()` lookups are O(1) and common short directory names (`src`, `lib`,\n * `app`, …) are not mistaken for locales.\n */\nconst ALL_LOCALE_VALUES = new Set<string>(Object.values(ALL_LOCALES));\n\n/**\n * Returns true when `segment` matches a known BCP-47 locale identifier, e.g.\n * `en`, `fr`, `zh-TW`, `pt-BR`, `en-US`.\n */\nconst isLocaleSegment = (segment: string): boolean =>\n  ALL_LOCALE_VALUES.has(segment);\n\n/** JSON filenames that are never locale translation files. */\nconst KNOWN_CONFIG_FILENAMES = new Set([\n  'package.json',\n  'tsconfig.json',\n  'jsconfig.json',\n  'biome.json',\n  'turbo.json',\n  'lerna.json',\n  'vercel.json',\n  'netlify.json',\n  'babel.config.json',\n  'jest.config.json',\n  'vitest.config.json',\n  '.eslintrc.json',\n  '.prettierrc.json',\n]);\n\n/**\n * Scans the project for JSON files and determines whether locale files are\n * organised as `{base}/{locale}/{key}.json` (nested) or `{base}/{locale}.json`\n * (flat).  Returns the most likely source template, or `null` when no locale\n * JSON files are found.\n *\n * The returned `template` contains `${locale}` and `${key}` as **literal**\n * placeholder strings so it can be embedded inside a JS template literal.\n */\nexport const detectJsonLocalePattern = async (\n  rootDir: string\n): Promise<JsonLocalePattern | null> => {\n  const files = await fg('**/*.json', {\n    cwd: rootDir,\n    ignore: EXCLUDED_PATHS,\n    absolute: false,\n    onlyFiles: true,\n  });\n\n  const nestedBasePaths: string[] = [];\n  const flatBasePaths: string[] = [];\n  const nestedLocales = new Set<string>();\n  const flatLocales = new Set<string>();\n\n  for (const file of files) {\n    const parts = file.split('/');\n    const filename = parts[parts.length - 1] ?? '';\n\n    if (KNOWN_CONFIG_FILENAMES.has(filename)) continue;\n\n    // Nested: …/{locale}/{key}.json — parent directory is a locale code\n    if (parts.length >= 3) {\n      const localeDir = parts[parts.length - 2] ?? '';\n      if (isLocaleSegment(localeDir)) {\n        nestedBasePaths.push(parts.slice(0, -2).join('/') || '.');\n        nestedLocales.add(localeDir);\n      }\n    }\n\n    // Flat: …/{locale}.json — filename (without extension) is a locale code\n    if (parts.length >= 2) {\n      const baseName = filename.slice(0, -5); // strip \".json\"\n      if (isLocaleSegment(baseName)) {\n        flatBasePaths.push(parts.slice(0, -1).join('/') || '.');\n        flatLocales.add(baseName);\n      }\n    }\n  }\n\n  if (nestedBasePaths.length === 0 && flatBasePaths.length === 0) {\n    return null;\n  }\n\n  /**\n   * Returns the path prefix that appears most frequently among the matches,\n   * formatted as a relative path suitable for a source template.\n   */\n  const mostFrequentPrefix = (paths: string[]): string => {\n    const counts = paths.reduce<Record<string, number>>((accumulator, path) => {\n      accumulator[path] = (accumulator[path] ?? 0) + 1;\n      return accumulator;\n    }, {});\n    const topEntry = Object.entries(counts).sort(([, a], [, b]) => b - a)[0];\n    const basePath = topEntry?.[0] ?? '.';\n    return basePath === '.' ? '.' : `./${basePath}`;\n  };\n\n  if (nestedBasePaths.length >= flatBasePaths.length) {\n    const prefix = mostFrequentPrefix(nestedBasePaths);\n    return {\n      type: 'nested',\n      // Literal ${locale} and ${key} — not evaluated here, used in template literals\n      template: `${prefix}/\\${locale}/\\${key}.json`,\n      locales: Array.from(nestedLocales),\n    };\n  }\n\n  const prefix = mostFrequentPrefix(flatBasePaths);\n  return {\n    type: 'flat',\n    template: `${prefix}/\\${locale}.json`,\n    locales: Array.from(flatLocales),\n  };\n};\n\n/**\n * Detected lingui catalog pattern. lingui stores one catalog file per locale\n * (default name `messages`), as `.po` (its default) or `.json`.\n */\nexport type LinguiCatalogPattern = {\n  /** Which sync plugin should ingest the catalogs. */\n  format: 'po' | 'json';\n  /**\n   * Source path template, with `${locale}` and `${key}` as literal\n   * placeholders. The catalog filename (`messages`) is captured by `${key}` so\n   * the produced intlayer dictionary key is `messages` — matching the fixed\n   * `messages` namespace the lingui compat runtime reads from.\n   * Example: `./src/locales/${locale}/${key}.po`.\n   */\n  template: string;\n  /** Detected locales. */\n  locales: string[];\n};\n\n/**\n * Scans the project for lingui catalog files (`{base}/{locale}/messages.po` or\n * `…/messages.json`, lingui's default layout) and derives the `syncPO` /\n * `syncJSON` `source` template.\n *\n * `.po` is preferred when present (lingui's default format). Returns `null`\n * when no lingui catalog is found, in which case the caller falls back to the\n * generic JSON detection.\n *\n * @param rootDir - Project root directory.\n */\nexport const detectLinguiCatalogPattern = async (\n  rootDir: string\n): Promise<LinguiCatalogPattern | null> => {\n  // lingui's default catalog name is `messages`; match that basename for both\n  // formats so the captured `${key}` is `messages`.\n  const files = await fg(['**/messages.po', '**/messages.json'], {\n    cwd: rootDir,\n    ignore: EXCLUDED_PATHS,\n    absolute: false,\n    onlyFiles: true,\n  });\n\n  const basePathsByFormat: Record<'po' | 'json', string[]> = {\n    po: [],\n    json: [],\n  };\n  const localesByFormat: Record<'po' | 'json', Set<string>> = {\n    po: new Set(),\n    json: new Set(),\n  };\n\n  for (const file of files) {\n    const parts = file.split('/');\n    // Nested layout: …/{locale}/messages.{po,json} — parent dir is the locale.\n    if (parts.length < 2) continue;\n\n    const localeDir = parts[parts.length - 2] ?? '';\n    if (!isLocaleSegment(localeDir)) continue;\n\n    const extension = (file.endsWith('.po') ? 'po' : 'json') as 'po' | 'json';\n    basePathsByFormat[extension].push(parts.slice(0, -2).join('/') || '.');\n    localesByFormat[extension].add(localeDir);\n  }\n\n  // Prefer `.po` (lingui's default) when catalogs of both formats coexist.\n  const format: 'po' | 'json' = basePathsByFormat.po.length > 0 ? 'po' : 'json';\n\n  const basePaths = basePathsByFormat[format];\n  if (basePaths.length === 0) return null;\n\n  const counts = basePaths.reduce<Record<string, number>>(\n    (accumulator, path) => {\n      accumulator[path] = (accumulator[path] ?? 0) + 1;\n      return accumulator;\n    },\n    {}\n  );\n  const topBasePath =\n    Object.entries(counts).sort(([, a], [, b]) => b - a)[0]?.[0] ?? '.';\n  const prefix = topBasePath === '.' ? '.' : `./${topBasePath}`;\n\n  return {\n    format,\n    template: `${prefix}/\\${locale}/\\${key}.${format}`,\n    locales: Array.from(localesByFormat[format]),\n  };\n};\n\n/**\n * The messages source template derived from a `next-intl` `i18n/request.ts`\n * file, ready to be used as a `syncJSON` `source` builder.\n */\nexport type NextIntlMessagesPattern = {\n  /** `'flat'` (one file per locale) or `'nested'` (per-namespace files). */\n  type: JsonLocalePatternType;\n  /**\n   * Source path template relative to the project root, with `${locale}` (and\n   * `${key}` when nested) as literal placeholders, e.g. `./messages/${locale}.json`.\n   */\n  template: string;\n};\n\n/** Common locations of the `next-intl` request config, relative to the root. */\nconst NEXT_INTL_REQUEST_FILES = [\n  'i18n/request.ts',\n  'i18n/request.tsx',\n  'i18n/request.js',\n  'i18n/request.mjs',\n  'src/i18n/request.ts',\n  'src/i18n/request.tsx',\n  'src/i18n/request.js',\n  'src/i18n/request.mjs',\n  'app/i18n/request.ts',\n  'src/app/i18n/request.ts',\n];\n\n/**\n * Derives the messages source template from a `next-intl` `i18n/request.ts`\n * file, which is the authoritative location of the messages path in a next-intl\n * project (e.g. `messages: (await import(\\`../messages/${locale}.json\\`)).default`).\n *\n * Reading it removes the ambiguity of globbing the file system and yields the\n * exact `source` template for `syncJSON`. When the resulting template has no\n * `${key}` segment (the common single-file-per-locale layout, where top-level\n * keys are namespaces), `syncJSON` `splitKeys` auto-detection turns each\n * top-level key into its own dictionary.\n *\n * Returns `null` when no request file is found, the messages import cannot be\n * parsed, or the path is not project-root-relative (e.g. uses a TS path alias).\n *\n * @param rootDir - Project root directory.\n */\nexport const detectNextIntlMessagesPattern = async (\n  rootDir: string\n): Promise<NextIntlMessagesPattern | null> => {\n  for (const requestFile of NEXT_INTL_REQUEST_FILES) {\n    if (!(await exists(rootDir, requestFile))) continue;\n\n    const content = await readFileFromRoot(rootDir, requestFile);\n\n    // Capture the template-literal path of the messages dynamic import, e.g.\n    // import(`../messages/${locale}.json`) → `../messages/${locale}.json`.\n    const importMatch = content.match(\n      /import\\(\\s*`([^`]*\\$\\{\\s*locale\\s*\\}[^`]*\\.json)`/\n    );\n\n    const importPath = importMatch?.[1];\n    if (!importPath) continue;\n\n    // Only relative imports can be resolved against the file system; path\n    // aliases (e.g. `@/messages/...`) are skipped in favour of glob detection.\n    if (!importPath.startsWith('.')) continue;\n\n    // Resolve the import (relative to the request file) back to a\n    // project-root-relative template. The `${locale}` / `${key}` placeholders\n    // are kept literal — path utilities treat them as ordinary segments.\n    const requestDir = dirname(resolve(rootDir, requestFile));\n    const absoluteTemplate = resolve(requestDir, importPath);\n    const relativeTemplate = relative(rootDir, absoluteTemplate)\n      .split(sep)\n      .join('/');\n\n    const template = relativeTemplate.startsWith('.')\n      ? relativeTemplate\n      : `./${relativeTemplate}`;\n\n    const type: JsonLocalePatternType =\n      template.includes('${key}') || template.includes('${namespace}')\n        ? 'nested'\n        : 'flat';\n\n    return { type, template };\n  }\n\n  return null;\n};\n"],"mappings":"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"}

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

@@ -2,10 +2,10 @@ import { ensureNamedImport, firstInsertIndex, isModuleScopeBinding } from "./ast
 import { enableIntlayerEditorConfig, getMetroConfigTemplate, hasIntlayerVitePlugin, replaceViteConfigPluginImportSource, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n } from "./configManipulation.mjs";
 import { detectJsonLocalePattern, detectLinguiCatalogPattern, detectNextIntlMessagesPattern, ensureDirectory, exists, readFileFromRoot, writeFileToRoot } from "./fileSystem.mjs";
 import { isVersionAtLeast } from "./version.mjs";
-import { detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages } from "./packageManager.mjs";
+import { COMPAT_I18N_LIBRARIES, detectCompatI18nLibraries, detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, hasLintTooling, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages } from "./packageManager.mjs";
 import { GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, getGithubWorkflows, resolveGithubWorkflowsContext } from "./githubActions.mjs";
 import { parseJSONWithComments } from "./jsonParser.mjs";
 import { NEXT_INTLAYER_BABEL_CONFIG_CONTENT, setupNextCompilerBabelConfig } from "./nextCompilerBabel.mjs";
 import { findTsConfigFiles } from "./tsConfig.mjs";
 
-export { GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, detectJsonLocalePattern, detectLinguiCatalogPattern, detectMissingIntlayerPackages, detectNextIntlMessagesPattern, detectOutdatedIntlayerPackages, detectPackageManager, enableIntlayerEditorConfig, ensureDirectory, ensureNamedImport, exists, findTsConfigFiles, firstInsertIndex, getGithubWorkflows, getInstalledPackageVersion, getMetroConfigTemplate, hasIntlayerVitePlugin, installPackages, isIntlayerPackageName, isModuleScopeBinding, isVersionAtLeast, normalizeVersion, parseJSONWithComments, readFileFromRoot, replaceViteConfigPluginImportSource, resolveGithubWorkflowsContext, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode, setupNextCompilerBabelConfig, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n, upgradePackages, writeFileToRoot };
+export { COMPAT_I18N_LIBRARIES, GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, detectCompatI18nLibraries, detectJsonLocalePattern, detectLinguiCatalogPattern, detectMissingIntlayerPackages, detectNextIntlMessagesPattern, detectOutdatedIntlayerPackages, detectPackageManager, enableIntlayerEditorConfig, ensureDirectory, ensureNamedImport, exists, findTsConfigFiles, firstInsertIndex, getGithubWorkflows, getInstalledPackageVersion, getMetroConfigTemplate, hasIntlayerVitePlugin, hasLintTooling, installPackages, isIntlayerPackageName, isModuleScopeBinding, isVersionAtLeast, normalizeVersion, parseJSONWithComments, readFileFromRoot, replaceViteConfigPluginImportSource, resolveGithubWorkflowsContext, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode, setupNextCompilerBabelConfig, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n, upgradePackages, writeFileToRoot };

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

@@ -26,16 +26,108 @@ const buildInstallCommand = (packageManager, packages, isDev = false) => {
 		case "npm": return `npm install ${isDev ? "-D " : ""}${packageList}`;
 	}
 };
+/**
+* Existing i18n libraries Intlayer can adapt, keyed by the dependencies that
+* reveal them. Mirrors the compat branches of
+* {@link detectMissingIntlayerPackages}: a library listed here is one that
+* detection will wire up on its own once its package is in `package.json`.
+*/
+const COMPAT_I18N_LIBRARIES = [
+	{
+		label: "i18next / react-i18next",
+		packages: [
+			"i18next",
+			"react-i18next",
+			"@intlayer/i18next",
+			"@intlayer/react-i18next"
+		]
+	},
+	{
+		label: "next-intl / use-intl",
+		packages: [
+			"next-intl",
+			"use-intl",
+			"@intlayer/next-intl",
+			"@intlayer/use-intl"
+		]
+	},
+	{
+		label: "vue-i18n",
+		packages: ["vue-i18n", "@intlayer/vue-i18n"]
+	},
+	{
+		label: "@nuxtjs/i18n",
+		packages: ["@nuxtjs/i18n", "@intlayer/nuxtjs-i18n"]
+	},
+	{
+		label: "next-i18next",
+		packages: ["next-i18next", "@intlayer/next-i18next"]
+	},
+	{
+		label: "next-translate",
+		packages: ["next-translate", "@intlayer/next-translate"]
+	},
+	{
+		label: "react-intl",
+		packages: ["react-intl", "@intlayer/react-intl"]
+	},
+	{
+		label: "Lingui",
+		packages: [
+			"@lingui/core",
+			"@lingui/react",
+			"@intlayer/lingui"
+		]
+	},
+	{
+		label: "svelte-i18n",
+		packages: ["svelte-i18n", "@intlayer/svelte-i18n"]
+	},
+	{
+		label: "@ngneat/transloco",
+		packages: ["@ngneat/transloco", "@intlayer/transloco"]
+	},
+	{
+		label: "@ngx-translate/core",
+		packages: ["@ngx-translate/core", "@intlayer/ngx-translate"]
+	},
+	{
+		label: "node-polyglot",
+		packages: ["node-polyglot", "@intlayer/polyglot"]
+	},
+	{
+		label: "i18n-js",
+		packages: ["i18n-js", "@intlayer/i18n-js"]
+	}
+];
+/**
+* Returns the labels of the compat i18n libraries present in `dependencies`.
+*
+* Lets the init flow report (and branch on) the libraries it found without
+* asking the user, since {@link detectMissingIntlayerPackages} already derives
+* the adapters, sync plugin and config from the very same dependency map.
+*
+* @param dependencies - Merged dependencies of the target project.
+*/
+const detectCompatI18nLibraries = (dependencies) => COMPAT_I18N_LIBRARIES.filter((library) => library.packages.some((packageName) => Boolean(dependencies[packageName]))).map((library) => library.label);
+/**
+* True when the project already lints, and so has something to plug the
+* Intlayer lint rules into.
+*
+* `eslint-plugin-intlayer` loads in both ESLint and oxlint, so either linter is
+* enough. Shared with the init flow so that installing the plugin and wiring up
+* its configuration are gated on exactly the same condition — a project that
+* does not lint is left alone entirely.
+*
+* @param dependencies - Merged dependencies of the target project.
+*/
+const hasLintTooling = (dependencies) => Boolean(dependencies.eslint) || Boolean(dependencies.oxlint);
 const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 	const packagesToInstall = [];
 	const devPackagesToInstall = [];
 	let compatSyncConfig;
 	let compatVitePluginConfig;
-	const effectiveDependencies = {
-		...allDependencies,
-		...options.hintDependencies ?? {}
-	};
-	const isInstalled = (packageName) => Boolean(effectiveDependencies[packageName]);
+	const isInstalled = (packageName) => Boolean(allDependencies[packageName]);
 	const addIfMissing = (packageName) => {
 		if (!isInstalled(packageName)) packagesToInstall.push(packageName);
 	};
@@ -51,6 +143,7 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 	if (isInstalled("@angular/core")) addIfMissing("angular-intlayer");
 	if (isInstalled("vue")) addIfMissing("vue-intlayer");
 	if (isInstalled("vite")) addIfMissing("vite-intlayer");
+	if (hasLintTooling(allDependencies)) addDevIfMissing("eslint-plugin-intlayer");
 	if (isInstalled("next-intl") || isInstalled("@intlayer/next-intl")) {
 		addIfMissing("@intlayer/next-intl");
 		addIfMissing("next-intl");
@@ -228,7 +321,8 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 * Throws if the install process exits with a non-zero code.
 */
 const installPackages = (rootDir, packages, packageManager, isDev = false) => {
-	execSync(buildInstallCommand(packageManager, packages, isDev), {
+	const command = buildInstallCommand(packageManager, packages, isDev);
+	execSync(command, {
 		cwd: rootDir,
 		stdio: "inherit"
 	});
@@ -293,12 +387,13 @@ const detectOutdatedIntlayerPackages = (rootDir, dependencies, targetVersion) =>
 const upgradePackages = (rootDir, packages, packageManager, targetVersion, isDev = false) => {
 	if (packages.length === 0) return;
 	const versionedPackages = packages.map((packageName) => `${packageName}@${targetVersion}`);
-	execSync(buildInstallCommand(packageManager, versionedPackages, isDev), {
+	const command = buildInstallCommand(packageManager, versionedPackages, isDev);
+	execSync(command, {
 		cwd: rootDir,
 		stdio: "inherit"
 	});
 };
 
 //#endregion
-export { detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages };
+export { COMPAT_I18N_LIBRARIES, detectCompatI18nLibraries, detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, hasLintTooling, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages };
 //# sourceMappingURL=packageManager.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"packageManager.mjs","names":[],"sources":["../../../../src/init/utils/packageManager.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { 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":"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"}
+{"version":3,"file":"packageManager.mjs","names":[],"sources":["../../../../src/init/utils/packageManager.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { 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,IACE,WAAW,KAAK,SAAS,UAAU,CAAC,KACpC,WAAW,KAAK,SAAS,WAAW,CAAC,GAErC,OAAO;CAET,IAAI,WAAW,KAAK,SAAS,gBAAgB,CAAC,GAC5C,OAAO;CAET,IAAI,WAAW,KAAK,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,SAAS,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,eAAe,KACnB,SACA,gBACA,aACA,cACF;EACA,IAAI,CAAC,WAAW,YAAY,GAAG,OAAO;EACtC,MAAM,EAAE,YAAY,KAAK,MAAM,aAAa,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,OAAO,gBAAgB,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,SAAS,SAAS;EAAE,KAAK;EAAS,OAAO;CAAU,CAAC;AACtD"}

package/dist/esm/initConfig/index.mjs

@@ -22,18 +22,22 @@ const getTemplatePath = (format) => {
 const initConfig = async (format, baseDir, options) => {
 	const { configurationFilePath } = searchConfigurationFile(baseDir);
 	if (configurationFilePath) {
-		logger(`${v} ${colorizePath(relative(baseDir, configurationFilePath))} already exists`);
+		const relativePath = relative(baseDir, configurationFilePath);
+		logger(`${v} ${colorizePath(relativePath)} already exists`);
 		return;
 	}
 	const extension = format.split(".").pop();
-	let configContent = readAsset(getTemplatePath(extension));
+	const templatePath = getTemplatePath(extension);
+	let configContent = readAsset(templatePath);
 	const { locales, applicationURL } = options ?? {};
-	if (locales && locales.length > 0) if (extension === "json") {
-		const localesString = JSON.stringify(locales);
-		configContent = configContent.replace("[\"en\"]", localesString);
-	} else {
-		const localesString = `[${locales.map((locale) => `'${locale}'`).join(", ")}]`;
-		configContent = configContent.replace("[Locales.ENGLISH]", localesString);
+	if (locales && locales.length > 0) {
+		if (extension === "json") {
+			const localesString = JSON.stringify(locales);
+			configContent = configContent.replace("[\"en\"]", localesString);
+		} else {
+			const localesString = `[${locales.map((locale) => `'${locale}'`).join(", ")}]`;
+			configContent = configContent.replace("[Locales.ENGLISH]", localesString);
+		}
 	}
 	if (applicationURL) configContent = configContent.replace("http://localhost:3000", applicationURL);
 	await writeFile(join(baseDir, format), configContent, "utf8");

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

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

package/dist/esm/listDictionariesPath.mjs

@@ -13,12 +13,13 @@ const listDictionaries = async (configuration) => {
 	const filePromises = fileExtensions.flatMap((ext) => contentDir.map((dir) => `${normalizePath(dir)}/**/*${ext}`.replace("//", "/"))).map(async (pattern) => {
 		const magicIndex = pattern.search(/[*?{}(]/);
 		const basePattern = magicIndex > -1 ? pattern.slice(0, magicIndex) : pattern;
+		const applicableIgnore = excludedPath.filter((excludePattern) => {
+			const cleanName = excludePattern.replace(/\*\*/g, "").replace(/\//g, "");
+			if (cleanName && basePattern.includes(`/${cleanName}/`)) return false;
+			return true;
+		});
 		return fg(pattern, {
-			ignore: excludedPath.filter((excludePattern) => {
-				const cleanName = excludePattern.replace(/\*\*/g, "").replace(/\//g, "");
-				if (cleanName && basePattern.includes(`/${cleanName}/`)) return false;
-				return true;
-			}),
+			ignore: applicableIgnore,
 			absolute: true,
 			dot: true
 		});

package/dist/esm/listDictionariesPath.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"listDictionariesPath.mjs","names":[],"sources":["../../src/listDictionariesPath.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { normalizePath } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport fg from 'fast-glob';\n\n/**\n * List all dictionaries absolute paths in the project\n * @param configuration - The configuration object\n * @returns An array of dictionary paths\n */\nexport const listDictionaries = async (\n  configuration: IntlayerConfig\n): Promise<string[]> => {\n  const { fileExtensions, contentDir, excludedPath } = configuration.content;\n\n  const watchedFilesPatternWithPath = fileExtensions.flatMap((ext) =>\n    contentDir.map((dir) =>\n      `${normalizePath(dir)}/**/*${ext}`.replace('//', '/')\n    )\n  );\n\n  const filePromises = watchedFilesPatternWithPath.map(async (pattern) => {\n    // Identify the static part of the path (before any wildcards like *)\n    //    e.g. \"/Users/.../design-system/dist/esm/**/*.content.ts\" -> \"/Users/.../design-system/dist/esm/\"\n    const magicIndex = pattern.search(/[*?{}(]/);\n    const basePattern =\n      magicIndex > -1 ? pattern.slice(0, magicIndex) : pattern;\n\n    // Filter the global ignored list for this specific pattern\n    const applicableIgnore = excludedPath.filter((excludePattern) => {\n      // Heuristic: Extract the key directory name from the glob\n      // e.g. \"**/dist/**\" -> \"dist\", \"**/node_modules/**\" -> \"node_modules\"\n      const cleanName = excludePattern.replace(/\\*\\*/g, '').replace(/\\//g, '');\n\n      // If the explicit base path contains the excluded directory (e.g. \".../dist/...\"),\n      // we assume you explicitly want it, so we REMOVE it from the ignore list.\n      // We check for `/${cleanName}/` to ensure we match whole folder names.\n      if (cleanName && basePattern.includes(`/${cleanName}/`)) {\n        return false; // Drop this exclude rule\n      }\n\n      return true; // Keep this exclude rule\n    });\n\n    // Run fast-glob with the customized ignore list\n    return fg(pattern, {\n      ignore: applicableIgnore,\n      absolute: true,\n      dot: true,\n    });\n  });\n\n  const filesArrays = await Promise.all(filePromises);\n\n  // Flatten and deduplicate\n  const uniqueFiles = Array.from(new Set(filesArrays.flat()));\n\n  return uniqueFiles;\n};\n\nexport const listDictionariesWithStats = async (\n  configuration: IntlayerConfig\n) => {\n  const files = await listDictionaries(configuration);\n\n  return Promise.all(\n    files.map(async (file) => ({ path: file, stats: await stat(file) }))\n  );\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,mBAAmB,OAC9B,kBACsB;CACtB,MAAM,EAAE,gBAAgB,YAAY,iBAAiB,cAAc;CAQnE,MAAM,eAN8B,eAAe,SAAS,QAC1D,WAAW,KAAK,QACd,GAAG,cAAc,GAAG,EAAE,OAAO,MAAM,QAAQ,MAAM,GAAG,CACtD,CAG6C,CAAC,CAAC,IAAI,OAAO,YAAY;EAGtE,MAAM,aAAa,QAAQ,OAAO,SAAS;EAC3C,MAAM,cACJ,aAAa,KAAK,QAAQ,MAAM,GAAG,UAAU,IAAI;EAmBnD,OAAO,GAAG,SAAS;GACjB,QAjBuB,aAAa,QAAQ,mBAAmB;IAG/D,MAAM,YAAY,eAAe,QAAQ,SAAS,EAAE,CAAC,CAAC,QAAQ,OAAO,EAAE;IAKvE,IAAI,aAAa,YAAY,SAAS,IAAI,UAAU,EAAE,GACpD,OAAO;IAGT,OAAO;GACT,CAIyB;GACvB,UAAU;GACV,KAAK;EACP,CAAC;CACH,CAAC;CAED,MAAM,cAAc,MAAM,QAAQ,IAAI,YAAY;CAKlD,OAFoB,MAAM,KAAK,IAAI,IAAI,YAAY,KAAK,CAAC,CAExC;AACnB;AAEA,MAAa,4BAA4B,OACvC,kBACG;CACH,MAAM,QAAQ,MAAM,iBAAiB,aAAa;CAElD,OAAO,QAAQ,IACb,MAAM,IAAI,OAAO,UAAU;EAAE,MAAM;EAAM,OAAO,MAAM,KAAK,IAAI;CAAE,EAAE,CACrE;AACF"}
+{"version":3,"file":"listDictionariesPath.mjs","names":[],"sources":["../../src/listDictionariesPath.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { normalizePath } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport fg from 'fast-glob';\n\n/**\n * List all dictionaries absolute paths in the project\n * @param configuration - The configuration object\n * @returns An array of dictionary paths\n */\nexport const listDictionaries = async (\n  configuration: IntlayerConfig\n): Promise<string[]> => {\n  const { fileExtensions, contentDir, excludedPath } = configuration.content;\n\n  const watchedFilesPatternWithPath = fileExtensions.flatMap((ext) =>\n    contentDir.map((dir) =>\n      `${normalizePath(dir)}/**/*${ext}`.replace('//', '/')\n    )\n  );\n\n  const filePromises = watchedFilesPatternWithPath.map(async (pattern) => {\n    // Identify the static part of the path (before any wildcards like *)\n    //    e.g. \"/Users/.../design-system/dist/esm/**/*.content.ts\" -> \"/Users/.../design-system/dist/esm/\"\n    const magicIndex = pattern.search(/[*?{}(]/);\n    const basePattern =\n      magicIndex > -1 ? pattern.slice(0, magicIndex) : pattern;\n\n    // Filter the global ignored list for this specific pattern\n    const applicableIgnore = excludedPath.filter((excludePattern) => {\n      // Heuristic: Extract the key directory name from the glob\n      // e.g. \"**/dist/**\" -> \"dist\", \"**/node_modules/**\" -> \"node_modules\"\n      const cleanName = excludePattern.replace(/\\*\\*/g, '').replace(/\\//g, '');\n\n      // If the explicit base path contains the excluded directory (e.g. \".../dist/...\"),\n      // we assume you explicitly want it, so we REMOVE it from the ignore list.\n      // We check for `/${cleanName}/` to ensure we match whole folder names.\n      if (cleanName && basePattern.includes(`/${cleanName}/`)) {\n        return false; // Drop this exclude rule\n      }\n\n      return true; // Keep this exclude rule\n    });\n\n    // Run fast-glob with the customized ignore list\n    return fg(pattern, {\n      ignore: applicableIgnore,\n      absolute: true,\n      dot: true,\n    });\n  });\n\n  const filesArrays = await Promise.all(filePromises);\n\n  // Flatten and deduplicate\n  const uniqueFiles = Array.from(new Set(filesArrays.flat()));\n\n  return uniqueFiles;\n};\n\nexport const listDictionariesWithStats = async (\n  configuration: IntlayerConfig\n) => {\n  const files = await listDictionaries(configuration);\n\n  return Promise.all(\n    files.map(async (file) => ({ path: file, stats: await stat(file) }))\n  );\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,mBAAmB,OAC9B,kBACsB;CACtB,MAAM,EAAE,gBAAgB,YAAY,iBAAiB,cAAc;CAQnE,MAAM,eAN8B,eAAe,SAAS,QAC1D,WAAW,KAAK,QACd,GAAG,cAAc,GAAG,EAAE,OAAO,MAAM,QAAQ,MAAM,GAAG,CACtD,CAG6C,CAAC,CAAC,IAAI,OAAO,YAAY;EAGtE,MAAM,aAAa,QAAQ,OAAO,SAAS;EAC3C,MAAM,cACJ,aAAa,KAAK,QAAQ,MAAM,GAAG,UAAU,IAAI;EAGnD,MAAM,mBAAmB,aAAa,QAAQ,mBAAmB;GAG/D,MAAM,YAAY,eAAe,QAAQ,SAAS,EAAE,CAAC,CAAC,QAAQ,OAAO,EAAE;GAKvE,IAAI,aAAa,YAAY,SAAS,IAAI,UAAU,EAAE,GACpD,OAAO;GAGT,OAAO;EACT,CAAC;EAGD,OAAO,GAAG,SAAS;GACjB,QAAQ;GACR,UAAU;GACV,KAAK;EACP,CAAC;CACH,CAAC;CAED,MAAM,cAAc,MAAM,QAAQ,IAAI,YAAY;CAKlD,OAFoB,MAAM,KAAK,IAAI,IAAI,YAAY,KAAK,CAAC,CAExC;AACnB;AAEA,MAAa,4BAA4B,OACvC,kBACG;CACH,MAAM,QAAQ,MAAM,iBAAiB,aAAa;CAElD,OAAO,QAAQ,IACb,MAAM,IAAI,OAAO,UAAU;EAAE,MAAM;EAAM,OAAO,MAAM,KAAK,IAAI;CAAE,EAAE,CACrE;AACF"}

package/dist/esm/listProjects.mjs

@@ -27,7 +27,8 @@ const listProjects = async (options) => {
 		const gitRootDir = await getGitRootDir(searchDir);
 		if (gitRootDir) searchDir = gitRootDir;
 	}
-	const configFiles = await fg(configurationFilesCandidates.map((fileName) => `**/${fileName}`), {
+	const configPatterns = configurationFilesCandidates.map((fileName) => `**/${fileName}`);
+	const configFiles = await fg(configPatterns, {
 		cwd: searchDir,
 		absolute: true,
 		ignore: ["**/node_modules/**", "**/.git/**"],

package/dist/esm/listProjects.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"listProjects.mjs","names":[],"sources":["../../src/listProjects.ts"],"sourcesContent":["import { dirname } from 'node:path';\nimport { configurationFilesCandidates } from '@intlayer/config/node';\nimport fg from 'fast-glob';\nimport simpleGit from 'simple-git';\n\nexport type ListProjectsOptions = {\n  /**\n   * Base directory to search from\n   * @default process.cwd()\n   */\n  baseDir?: string;\n  /**\n   * If true, search from the git root directory instead of baseDir\n   * @default false\n   */\n  gitRoot?: boolean;\n};\n\n/**\n * Returns the git repository root directory, or `null` when the given\n * directory is not inside a git repository.\n */\nexport const getGitRootDir = async (cwd?: string): Promise<string | null> => {\n  try {\n    const git = cwd ? simpleGit(cwd) : simpleGit();\n    const rootDir = await git.revparse(['--show-toplevel']);\n    return rootDir.trim();\n  } catch (_error) {\n    return null;\n  }\n};\n\n/**\n * List all Intlayer projects by searching for configuration files\n *\n * @param options - Options for listing projects\n * @returns Array of absolute paths to project directories containing Intlayer config\n */\nexport const listProjects = async (\n  options?: ListProjectsOptions\n): Promise<{ searchDir: string; projectsPath: string[] }> => {\n  let searchDir = options?.baseDir ?? process.cwd();\n\n  // If gitRoot option is enabled, try to get the git root directory\n  if (options?.gitRoot) {\n    const gitRootDir = await getGitRootDir(searchDir);\n    if (gitRootDir) {\n      searchDir = gitRootDir;\n    }\n  }\n\n  // Build glob patterns for all config file candidates\n  const configPatterns = configurationFilesCandidates.map(\n    (fileName) => `**/${fileName}`\n  );\n\n  // Search for all config files\n  const configFiles = await fg(configPatterns, {\n    cwd: searchDir,\n    absolute: true,\n    ignore: ['**/node_modules/**', '**/.git/**'],\n    dot: true, // Include dot files like .intlayerrc\n  });\n\n  // Extract unique directory paths from config files\n  const projectDirs = [...new Set(configFiles.map((file) => dirname(file)))];\n\n  // Sort alphabetically for consistent output\n  return { searchDir, projectsPath: projectDirs.sort() };\n};\n"],"mappings":";;;;;;;;;;AAsBA,MAAa,gBAAgB,OAAO,QAAyC;CAC3E,IAAI;EAGF,QAAO,OAFK,MAAM,UAAU,GAAG,IAAI,UAAU,EACpB,CAAC,SAAS,CAAC,iBAAiB,CAAC,EACxC,CAAC,KAAK;CACtB,SAAS,QAAQ;EACf,OAAO;CACT;AACF;;;;;;;AAQA,MAAa,eAAe,OAC1B,YAC2D;CAC3D,IAAI,YAAY,SAAS,WAAW,QAAQ,IAAI;CAGhD,IAAI,SAAS,SAAS;EACpB,MAAM,aAAa,MAAM,cAAc,SAAS;EAChD,IAAI,YACF,YAAY;CAEhB;CAQA,MAAM,cAAc,MAAM,GALH,6BAA6B,KACjD,aAAa,MAAM,UAIoB,GAAG;EAC3C,KAAK;EACL,UAAU;EACV,QAAQ,CAAC,sBAAsB,YAAY;EAC3C,KAAK;CACP,CAAC;CAGD,MAAM,cAAc,CAAC,GAAG,IAAI,IAAI,YAAY,KAAK,SAAS,QAAQ,IAAI,CAAC,CAAC,CAAC;CAGzE,OAAO;EAAE;EAAW,cAAc,YAAY,KAAK;CAAE;AACvD"}
+{"version":3,"file":"listProjects.mjs","names":[],"sources":["../../src/listProjects.ts"],"sourcesContent":["import { dirname } from 'node:path';\nimport { configurationFilesCandidates } from '@intlayer/config/node';\nimport fg from 'fast-glob';\nimport simpleGit from 'simple-git';\n\nexport type ListProjectsOptions = {\n  /**\n   * Base directory to search from\n   * @default process.cwd()\n   */\n  baseDir?: string;\n  /**\n   * If true, search from the git root directory instead of baseDir\n   * @default false\n   */\n  gitRoot?: boolean;\n};\n\n/**\n * Returns the git repository root directory, or `null` when the given\n * directory is not inside a git repository.\n */\nexport const getGitRootDir = async (cwd?: string): Promise<string | null> => {\n  try {\n    const git = cwd ? simpleGit(cwd) : simpleGit();\n    const rootDir = await git.revparse(['--show-toplevel']);\n    return rootDir.trim();\n  } catch (_error) {\n    return null;\n  }\n};\n\n/**\n * List all Intlayer projects by searching for configuration files\n *\n * @param options - Options for listing projects\n * @returns Array of absolute paths to project directories containing Intlayer config\n */\nexport const listProjects = async (\n  options?: ListProjectsOptions\n): Promise<{ searchDir: string; projectsPath: string[] }> => {\n  let searchDir = options?.baseDir ?? process.cwd();\n\n  // If gitRoot option is enabled, try to get the git root directory\n  if (options?.gitRoot) {\n    const gitRootDir = await getGitRootDir(searchDir);\n    if (gitRootDir) {\n      searchDir = gitRootDir;\n    }\n  }\n\n  // Build glob patterns for all config file candidates\n  const configPatterns = configurationFilesCandidates.map(\n    (fileName) => `**/${fileName}`\n  );\n\n  // Search for all config files\n  const configFiles = await fg(configPatterns, {\n    cwd: searchDir,\n    absolute: true,\n    ignore: ['**/node_modules/**', '**/.git/**'],\n    dot: true, // Include dot files like .intlayerrc\n  });\n\n  // Extract unique directory paths from config files\n  const projectDirs = [...new Set(configFiles.map((file) => dirname(file)))];\n\n  // Sort alphabetically for consistent output\n  return { searchDir, projectsPath: projectDirs.sort() };\n};\n"],"mappings":";;;;;;;;;;AAsBA,MAAa,gBAAgB,OAAO,QAAyC;CAC3E,IAAI;EAGF,QAAO,OAFK,MAAM,UAAU,GAAG,IAAI,UAAU,EACpB,CAAC,SAAS,CAAC,iBAAiB,CAAC,EACxC,CAAC,KAAK;CACtB,SAAS,QAAQ;EACf,OAAO;CACT;AACF;;;;;;;AAQA,MAAa,eAAe,OAC1B,YAC2D;CAC3D,IAAI,YAAY,SAAS,WAAW,QAAQ,IAAI;CAGhD,IAAI,SAAS,SAAS;EACpB,MAAM,aAAa,MAAM,cAAc,SAAS;EAChD,IAAI,YACF,YAAY;CAEhB;CAGA,MAAM,iBAAiB,6BAA6B,KACjD,aAAa,MAAM,UACtB;CAGA,MAAM,cAAc,MAAM,GAAG,gBAAgB;EAC3C,KAAK;EACL,UAAU;EACV,QAAQ,CAAC,sBAAsB,YAAY;EAC3C,KAAK;CACP,CAAC;CAGD,MAAM,cAAc,CAAC,GAAG,IAAI,IAAI,YAAY,KAAK,SAAS,QAAQ,IAAI,CAAC,CAAC,CAAC;CAGzE,OAAO;EAAE;EAAW,cAAc,YAAY,KAAK;CAAE;AACvD"}

package/dist/esm/loadDictionaries/getIntlayerBundle.mjs

@@ -39,7 +39,8 @@ const getIntlayerBundle = async (configuration) => {
 	const rootRequire = getProjectRequire(configuration.system.baseDir);
 	const aliases = { "@intlayer/config/built": join(configuration.system.configDir, `configuration.cjs`) };
 	const filePath = rootRequire.resolve("intlayer");
-	return await bundleFile(await readFile(filePath, "utf-8"), filePath, {
+	const code = await readFile(filePath, "utf-8");
+	return await bundleFile(code, filePath, {
 		bundle: true,
 		platform: "node",
 		external: [

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

@@ -1 +1 @@
-{"version":3,"file":"getIntlayerBundle.mjs","names":[],"sources":["../../../src/loadDictionaries/getIntlayerBundle.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { builtinModules, createRequire } from 'node:module';\nimport { join } from 'node:path';\nimport { bundleFile, type ESBuildPlugin } from '@intlayer/config/file';\nimport { getProjectRequire } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Rewrites bare specifiers to absolute paths on the user's disk and externalizes them\n * to preserve directory context (__dirname/import.meta.url).\n */\nconst localResolvePlugin = (\n  aliases: Record<string, string>,\n  rootRequire: NodeJS.Require\n): ESBuildPlugin => {\n  return {\n    name: 'local-resolve',\n    setup(build) {\n      build.onResolve({ filter: /.*/ }, (args) => {\n        // Direct alias match\n        if (aliases[args.path]) {\n          return {\n            path: aliases[args.path],\n            external: true, // Prevents inlining and context loss\n          };\n        }\n\n        // Dynamic resolution, importer first then user workspace.\n        //\n        // The importer takes priority so the bundle always keeps the\n        // `@intlayer/*` copy the importing file itself depends on. Resolving\n        // only from the project root lets Node walk past the project when the\n        // package is not installed there, and pick up an unrelated\n        // `node_modules` in a parent directory — which silently mixes two\n        // different Intlayer installations into the same bundle.\n        if (args.path === 'defu' || args.path.startsWith('@intlayer/')) {\n          const importerRequire = args.importer\n            ? createRequire(args.importer)\n            : undefined;\n\n          for (const resolver of [importerRequire, rootRequire]) {\n            if (!resolver) continue;\n\n            try {\n              return {\n                path: resolver.resolve(args.path),\n                external: true, // Injects `require('/absolute/path')`\n              };\n            } catch {\n              // Try the next resolver, then let esbuild resolve it itself.\n            }\n          }\n        }\n\n        return null;\n      });\n    },\n  };\n};\n\nexport const getIntlayerBundle = async (configuration: IntlayerConfig) => {\n  const rootRequire = getProjectRequire(configuration.system.baseDir);\n\n  const configurationPath = join(\n    configuration.system.configDir,\n    `configuration.cjs`\n  );\n\n  const aliases = {\n    '@intlayer/config/built': configurationPath,\n  };\n\n  const filePath = rootRequire.resolve('intlayer');\n  const code = await readFile(filePath, 'utf-8');\n\n  const output = await bundleFile(code, filePath, {\n    bundle: true,\n    platform: 'node',\n    external: [\n      ...builtinModules,\n      ...builtinModules.map((mod) => `node:${mod}`),\n      'vscode',\n      'esbuild',\n    ],\n    minify: true,\n    plugins: [localResolvePlugin(aliases, rootRequire)],\n  });\n\n  return output ?? '';\n};\n"],"mappings":";;;;;;;;;;;AAWA,MAAM,sBACJ,SACA,gBACkB;CAClB,OAAO;EACL,MAAM;EACN,MAAM,OAAO;GACX,MAAM,UAAU,EAAE,QAAQ,KAAK,IAAI,SAAS;IAE1C,IAAI,QAAQ,KAAK,OACf,OAAO;KACL,MAAM,QAAQ,KAAK;KACnB,UAAU;IACZ;IAWF,IAAI,KAAK,SAAS,UAAU,KAAK,KAAK,WAAW,YAAY,GAAG;KAC9D,MAAM,kBAAkB,KAAK,WACzB,cAAc,KAAK,QAAQ,IAC3B;KAEJ,KAAK,MAAM,YAAY,CAAC,iBAAiB,WAAW,GAAG;MACrD,IAAI,CAAC,UAAU;MAEf,IAAI;OACF,OAAO;QACL,MAAM,SAAS,QAAQ,KAAK,IAAI;QAChC,UAAU;OACZ;MACF,QAAQ,CAER;KACF;IACF;IAEA,OAAO;GACT,CAAC;EACH;CACF;AACF;AAEA,MAAa,oBAAoB,OAAO,kBAAkC;CACxE,MAAM,cAAc,kBAAkB,cAAc,OAAO,OAAO;CAOlE,MAAM,UAAU,EACd,0BANwB,KACxB,cAAc,OAAO,WACrB,mBAI0C,EAC5C;CAEA,MAAM,WAAW,YAAY,QAAQ,UAAU;CAgB/C,OAAO,MAbc,WAAW,MAFb,SAAS,UAAU,OAAO,GAEP,UAAU;EAC9C,QAAQ;EACR,UAAU;EACV,UAAU;GACR,GAAG;GACH,GAAG,eAAe,KAAK,QAAQ,QAAQ,KAAK;GAC5C;GACA;EACF;EACA,QAAQ;EACR,SAAS,CAAC,mBAAmB,SAAS,WAAW,CAAC;CACpD,CAAC,KAEgB;AACnB"}
+{"version":3,"file":"getIntlayerBundle.mjs","names":[],"sources":["../../../src/loadDictionaries/getIntlayerBundle.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { builtinModules, createRequire } from 'node:module';\nimport { join } from 'node:path';\nimport { bundleFile, type ESBuildPlugin } from '@intlayer/config/file';\nimport { getProjectRequire } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Rewrites bare specifiers to absolute paths on the user's disk and externalizes them\n * to preserve directory context (__dirname/import.meta.url).\n */\nconst localResolvePlugin = (\n  aliases: Record<string, string>,\n  rootRequire: NodeJS.Require\n): ESBuildPlugin => {\n  return {\n    name: 'local-resolve',\n    setup(build) {\n      build.onResolve({ filter: /.*/ }, (args) => {\n        // Direct alias match\n        if (aliases[args.path]) {\n          return {\n            path: aliases[args.path],\n            external: true, // Prevents inlining and context loss\n          };\n        }\n\n        // Dynamic resolution, importer first then user workspace.\n        //\n        // The importer takes priority so the bundle always keeps the\n        // `@intlayer/*` copy the importing file itself depends on. Resolving\n        // only from the project root lets Node walk past the project when the\n        // package is not installed there, and pick up an unrelated\n        // `node_modules` in a parent directory — which silently mixes two\n        // different Intlayer installations into the same bundle.\n        if (args.path === 'defu' || args.path.startsWith('@intlayer/')) {\n          const importerRequire = args.importer\n            ? createRequire(args.importer)\n            : undefined;\n\n          for (const resolver of [importerRequire, rootRequire]) {\n            if (!resolver) continue;\n\n            try {\n              return {\n                path: resolver.resolve(args.path),\n                external: true, // Injects `require('/absolute/path')`\n              };\n            } catch {\n              // Try the next resolver, then let esbuild resolve it itself.\n            }\n          }\n        }\n\n        return null;\n      });\n    },\n  };\n};\n\nexport const getIntlayerBundle = async (configuration: IntlayerConfig) => {\n  const rootRequire = getProjectRequire(configuration.system.baseDir);\n\n  const configurationPath = join(\n    configuration.system.configDir,\n    `configuration.cjs`\n  );\n\n  const aliases = {\n    '@intlayer/config/built': configurationPath,\n  };\n\n  const filePath = rootRequire.resolve('intlayer');\n  const code = await readFile(filePath, 'utf-8');\n\n  const output = await bundleFile(code, filePath, {\n    bundle: true,\n    platform: 'node',\n    external: [\n      ...builtinModules,\n      ...builtinModules.map((mod) => `node:${mod}`),\n      'vscode',\n      'esbuild',\n    ],\n    minify: true,\n    plugins: [localResolvePlugin(aliases, rootRequire)],\n  });\n\n  return output ?? '';\n};\n"],"mappings":";;;;;;;;;;;AAWA,MAAM,sBACJ,SACA,gBACkB;CAClB,OAAO;EACL,MAAM;EACN,MAAM,OAAO;GACX,MAAM,UAAU,EAAE,QAAQ,KAAK,IAAI,SAAS;IAE1C,IAAI,QAAQ,KAAK,OACf,OAAO;KACL,MAAM,QAAQ,KAAK;KACnB,UAAU;IACZ;IAWF,IAAI,KAAK,SAAS,UAAU,KAAK,KAAK,WAAW,YAAY,GAAG;KAC9D,MAAM,kBAAkB,KAAK,WACzB,cAAc,KAAK,QAAQ,IAC3B;KAEJ,KAAK,MAAM,YAAY,CAAC,iBAAiB,WAAW,GAAG;MACrD,IAAI,CAAC,UAAU;MAEf,IAAI;OACF,OAAO;QACL,MAAM,SAAS,QAAQ,KAAK,IAAI;QAChC,UAAU;OACZ;MACF,QAAQ,CAER;KACF;IACF;IAEA,OAAO;GACT,CAAC;EACH;CACF;AACF;AAEA,MAAa,oBAAoB,OAAO,kBAAkC;CACxE,MAAM,cAAc,kBAAkB,cAAc,OAAO,OAAO;CAOlE,MAAM,UAAU,EACd,0BANwB,KACxB,cAAc,OAAO,WACrB,mBAI0C,EAC5C;CAEA,MAAM,WAAW,YAAY,QAAQ,UAAU;CAC/C,MAAM,OAAO,MAAM,SAAS,UAAU,OAAO;CAe7C,OAAO,MAbc,WAAW,MAAM,UAAU;EAC9C,QAAQ;EACR,UAAU;EACV,UAAU;GACR,GAAG;GACH,GAAG,eAAe,KAAK,QAAQ,QAAQ,KAAK;GAC5C;GACA;EACF;EACA,QAAQ;EACR,SAAS,CAAC,mBAAmB,SAAS,WAAW,CAAC;CACpD,CAAC,KAEgB;AACnB"}

package/dist/esm/loadDictionaries/loadContentDeclaration.mjs

@@ -19,10 +19,11 @@ const formatLocalDictionaries = (dictionariesRecord, configuration) => Object.en
 }));
 const ensureIntlayerBundle = async (configuration) => {
 	const { system } = configuration;
-	const { set, isValid } = cacheDisk(configuration, ["intlayer-bundle"], { ttlMs: 1e3 * 60 * 60 * 24 * 5 });
+	const { set, isValid } = cacheDisk(configuration, ["intlayer-bundle"], { ttlMs: 432e6 });
 	const filePath = join(system.cacheDir, "intlayer-bundle.cjs");
 	if (!await isValid()) {
-		await writeFile(filePath, await getIntlayerBundle(configuration));
+		const intlayerBundle = await getIntlayerBundle(configuration);
+		await writeFile(filePath, intlayerBundle);
 		await set("ok");
 	}
 	return filePath;
@@ -31,7 +32,8 @@ let cachedExternalDeps = null;
 const getExternalDeps = async (baseDir) => {
 	if (cachedExternalDeps) return cachedExternalDeps;
 	try {
-		const packageJSON = await readFile(getPackageJsonPath(baseDir).packageJsonPath, "utf-8");
+		const packageJsonPath = getPackageJsonPath(baseDir);
+		const packageJSON = await readFile(packageJsonPath.packageJsonPath, "utf-8");
 		const parsedPackages = JSON.parse(packageJSON);
 		const allDependencies = Object.keys({
 			...parsedPackages.dependencies,
@@ -102,7 +104,7 @@ const loadContentDeclarations = async (contentDeclarationFilePath, configuration
 			status: "found"
 		}));
 		onStatusUpdate?.(listFoundDictionaries);
-		return filterInvalidDictionaries(await parallelize(contentDeclarations, async (contentDeclaration) => {
+		const processedDictionaries = await parallelize(contentDeclarations, async (contentDeclaration) => {
 			if (!contentDeclaration) return;
 			onStatusUpdate?.([{
 				dictionaryKey: contentDeclaration.key,
@@ -117,7 +119,8 @@ const loadContentDeclarations = async (contentDeclarationFilePath, configuration
 				status: "built"
 			}]);
 			return processedContentDeclaration;
-		}), configuration, { checkSchema: false });
+		});
+		return filterInvalidDictionaries(processedDictionaries, configuration, { checkSchema: false });
 	} catch {
 		console.error("Error loading content declarations");
 	}