@intlayer/engine 9.5.7 → 9.5.9-canary.0

package/dist/cjs/init/utils/intlayerDependencies.cjs

@@ -0,0 +1,119 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_init_utils_packageManager = require('./packageManager.cjs');
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+let _intlayer_config_defaultValues = require("@intlayer/config/defaultValues");
+let fast_glob = require("fast-glob");
+fast_glob = require_runtime.__toESM(fast_glob);
+
+//#region src/init/utils/intlayerDependencies.ts
+/** Dependency fields of a `package.json` scanned for Intlayer packages. */
+const DEPENDENCY_FIELDS = ["dependencies", "devDependencies"];
+/**
+* Ranges that do not point to the registry (monorepo workspaces, local links,
+* aliases, catalogs, git…). They are managed by the user and never rewritten.
+*/
+const isRegistryRange = (range) => /^[\^~]?\d/.test(range.trim());
+/**
+* Lists every `package.json` of the project (root first), skipping
+* `node_modules` and build outputs.
+*/
+const findPackageJsonFiles = async (rootDir) => {
+	return (await (0, fast_glob.default)("**/package.json", {
+		cwd: rootDir,
+		ignore: [..._intlayer_config_defaultValues.EXCLUDED_PATHS, "**/.git/**"]
+	})).sort((first, second) => first === "package.json" ? -1 : second === "package.json" ? 1 : first.localeCompare(second));
+};
+/**
+* Lists the Intlayer packages (`intlayer`, `@intlayer/*`, `*-intlayer`,
+* `intlayer-*`) declared with a registry range in a parsed `package.json`.
+*/
+const getIntlayerDependencies = (packageJson) => DEPENDENCY_FIELDS.flatMap((dependencyField) => Object.entries(packageJson[dependencyField] ?? {}).filter(([packageName, range]) => require_init_utils_packageManager.isIntlayerPackageName(packageName) && isRegistryRange(range)).map(([packageName, currentRange]) => ({
+	packageName,
+	dependencyField,
+	currentRange
+})));
+/** Lists the Intlayer dependencies of every `package.json` of the project. */
+const listIntlayerDependencies = async (rootDir) => {
+	const packageJsonPaths = await findPackageJsonFiles(rootDir);
+	return (await Promise.all(packageJsonPaths.map(async (packageJsonPath) => {
+		try {
+			const packageJson = JSON.parse(await (0, node_fs_promises.readFile)((0, node_path.join)(rootDir, packageJsonPath), "utf8"));
+			return {
+				packageJsonPath,
+				dependencies: getIntlayerDependencies(packageJson)
+			};
+		} catch {
+			return {
+				packageJsonPath,
+				dependencies: []
+			};
+		}
+	}))).filter(({ dependencies }) => dependencies.length > 0);
+};
+/**
+* Fetches the version a dist-tag (`latest` by default) of a package points to
+* on the npm registry. Resolves to `null` when the registry cannot be reached,
+* the package is not published or the dist-tag does not exist.
+*/
+const fetchLatestPackageVersion = async (packageName, { distTag = "latest", registryUrl = "https://registry.npmjs.org" } = {}) => {
+	try {
+		const response = await fetch(`${registryUrl}/${packageName.replace("/", "%2F")}/${encodeURIComponent(distTag)}`, { signal: AbortSignal.timeout(1e4) });
+		if (!response.ok) return null;
+		const { version } = await response.json();
+		return typeof version === "string" ? version : null;
+	} catch {
+		return null;
+	}
+};
+/**
+* Keeps the range operator (`^`, `~` or none) of `currentRange` and points it
+* to `version`.
+*
+* @example toRange('^9.0.0', '9.5.7') // '^9.5.7'
+*/
+const toRange = (currentRange, version) => `${currentRange.trim().match(/^[\^~]/)?.[0] ?? ""}${version}`;
+/**
+* Computes the upgrades bringing every listed dependency to its latest version.
+* Dependencies already on the latest version, or whose latest version could not
+* be fetched, are left out.
+*/
+const getIntlayerDependencyUpgrades = (packageJsonDependencies, latestVersions) => packageJsonDependencies.flatMap(({ packageJsonPath, dependencies }) => dependencies.flatMap((dependency) => {
+	const latestVersion = latestVersions.get(dependency.packageName);
+	if (!latestVersion || require_init_utils_packageManager.normalizeVersion(dependency.currentRange) === require_init_utils_packageManager.normalizeVersion(latestVersion)) return [];
+	return [{
+		...dependency,
+		packageJsonPath,
+		nextRange: toRange(dependency.currentRange, latestVersion)
+	}];
+}));
+/**
+* Writes the upgraded ranges back to their `package.json`, keeping the file's
+* indentation and trailing newline.
+*/
+const writeIntlayerDependencyUpgrades = async (rootDir, upgrades) => {
+	const packageJsonPaths = [...new Set(upgrades.map(({ packageJsonPath }) => packageJsonPath))];
+	for (const packageJsonPath of packageJsonPaths) {
+		const absolutePath = (0, node_path.join)(rootDir, packageJsonPath);
+		const content = await (0, node_fs_promises.readFile)(absolutePath, "utf8");
+		const packageJson = JSON.parse(content);
+		for (const upgrade of upgrades) {
+			if (upgrade.packageJsonPath !== packageJsonPath) continue;
+			packageJson[upgrade.dependencyField][upgrade.packageName] = upgrade.nextRange;
+		}
+		const indentation = content.match(/^[ \t]+(?=")/m)?.[0] ?? 2;
+		const trailingNewline = content.endsWith("\n") ? "\n" : "";
+		await (0, node_fs_promises.writeFile)(absolutePath, `${JSON.stringify(packageJson, null, indentation)}${trailingNewline}`, "utf8");
+	}
+};
+
+//#endregion
+exports.fetchLatestPackageVersion = fetchLatestPackageVersion;
+exports.findPackageJsonFiles = findPackageJsonFiles;
+exports.getIntlayerDependencies = getIntlayerDependencies;
+exports.getIntlayerDependencyUpgrades = getIntlayerDependencyUpgrades;
+exports.listIntlayerDependencies = listIntlayerDependencies;
+exports.toRange = toRange;
+exports.writeIntlayerDependencyUpgrades = writeIntlayerDependencyUpgrades;
+//# sourceMappingURL=intlayerDependencies.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intlayerDependencies.cjs","names":["fg","EXCLUDED_PATHS","isIntlayerPackageName","readFile","join","normalizeVersion","writeFile"],"sources":["../../../../src/init/utils/intlayerDependencies.ts"],"sourcesContent":["import { readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { EXCLUDED_PATHS } from '@intlayer/config/defaultValues';\nimport fg from 'fast-glob';\nimport { isIntlayerPackageName, normalizeVersion } from './packageManager';\n\n/** Dependency fields of a `package.json` scanned for Intlayer packages. */\nconst DEPENDENCY_FIELDS = ['dependencies', 'devDependencies'] as const;\n\ntype DependencyField = (typeof DEPENDENCY_FIELDS)[number];\n\n/** An Intlayer dependency declared in one of the project's `package.json`. */\nexport type IntlayerDependency = {\n  /** Package name, e.g. `next-intlayer`. */\n  packageName: string;\n  /** Field the dependency is declared in. */\n  dependencyField: DependencyField;\n  /** Declared version range, e.g. `^9.5.0`. */\n  currentRange: string;\n};\n\n/** Intlayer dependencies of one `package.json`. */\nexport type PackageJsonIntlayerDependencies = {\n  /** Path of the `package.json`, relative to the project root. */\n  packageJsonPath: string;\n  dependencies: IntlayerDependency[];\n};\n\n/** A dependency range rewritten to the latest published version. */\nexport type IntlayerDependencyUpgrade = IntlayerDependency & {\n  packageJsonPath: string;\n  /** Range written back to the `package.json`, e.g. `^9.5.7`. */\n  nextRange: string;\n};\n\n/**\n * Ranges that do not point to the registry (monorepo workspaces, local links,\n * aliases, catalogs, git…). They are managed by the user and never rewritten.\n */\nconst isRegistryRange = (range: string): boolean =>\n  /^[\\^~]?\\d/.test(range.trim());\n\n/**\n * Lists every `package.json` of the project (root first), skipping\n * `node_modules` and build outputs.\n */\nexport const findPackageJsonFiles = async (\n  rootDir: string\n): Promise<string[]> => {\n  const packageJsonFiles = await fg('**/package.json', {\n    cwd: rootDir,\n    ignore: [...EXCLUDED_PATHS, '**/.git/**'],\n  });\n\n  return packageJsonFiles.sort((first, second) =>\n    first === 'package.json'\n      ? -1\n      : second === 'package.json'\n        ? 1\n        : first.localeCompare(second)\n  );\n};\n\n/**\n * Lists the Intlayer packages (`intlayer`, `@intlayer/*`, `*-intlayer`,\n * `intlayer-*`) declared with a registry range in a parsed `package.json`.\n */\nexport const getIntlayerDependencies = (\n  packageJson: Partial<Record<DependencyField, Record<string, string>>>\n): IntlayerDependency[] =>\n  DEPENDENCY_FIELDS.flatMap((dependencyField) =>\n    Object.entries(packageJson[dependencyField] ?? {})\n      .filter(\n        ([packageName, range]) =>\n          isIntlayerPackageName(packageName) && isRegistryRange(range)\n      )\n      .map(([packageName, currentRange]) => ({\n        packageName,\n        dependencyField,\n        currentRange,\n      }))\n  );\n\n/** Lists the Intlayer dependencies of every `package.json` of the project. */\nexport const listIntlayerDependencies = async (\n  rootDir: string\n): Promise<PackageJsonIntlayerDependencies[]> => {\n  const packageJsonPaths = await findPackageJsonFiles(rootDir);\n\n  const results = await Promise.all(\n    packageJsonPaths.map(async (packageJsonPath) => {\n      try {\n        const packageJson = JSON.parse(\n          await readFile(join(rootDir, packageJsonPath), 'utf8')\n        );\n        return {\n          packageJsonPath,\n          dependencies: getIntlayerDependencies(packageJson),\n        };\n      } catch {\n        return { packageJsonPath, dependencies: [] };\n      }\n    })\n  );\n\n  return results.filter(({ dependencies }) => dependencies.length > 0);\n};\n\n/**\n * Fetches the version a dist-tag (`latest` by default) of a package points to\n * on the npm registry. Resolves to `null` when the registry cannot be reached,\n * the package is not published or the dist-tag does not exist.\n */\nexport const fetchLatestPackageVersion = async (\n  packageName: string,\n  {\n    distTag = 'latest',\n    registryUrl = 'https://registry.npmjs.org',\n  }: { distTag?: string; registryUrl?: string } = {}\n): Promise<string | null> => {\n  try {\n    const response = await fetch(\n      `${registryUrl}/${packageName.replace('/', '%2F')}/${encodeURIComponent(distTag)}`,\n      { signal: AbortSignal.timeout(10_000) }\n    );\n    if (!response.ok) return null;\n\n    const { version } = (await response.json()) as { version?: unknown };\n    return typeof version === 'string' ? version : null;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Keeps the range operator (`^`, `~` or none) of `currentRange` and points it\n * to `version`.\n *\n * @example toRange('^9.0.0', '9.5.7') // '^9.5.7'\n */\nexport const toRange = (currentRange: string, version: string): string =>\n  `${currentRange.trim().match(/^[\\^~]/)?.[0] ?? ''}${version}`;\n\n/**\n * Computes the upgrades bringing every listed dependency to its latest version.\n * Dependencies already on the latest version, or whose latest version could not\n * be fetched, are left out.\n */\nexport const getIntlayerDependencyUpgrades = (\n  packageJsonDependencies: PackageJsonIntlayerDependencies[],\n  latestVersions: Map<string, string | null>\n): IntlayerDependencyUpgrade[] =>\n  packageJsonDependencies.flatMap(({ packageJsonPath, dependencies }) =>\n    dependencies.flatMap((dependency) => {\n      const latestVersion = latestVersions.get(dependency.packageName);\n\n      if (\n        !latestVersion ||\n        normalizeVersion(dependency.currentRange) ===\n          normalizeVersion(latestVersion)\n      ) {\n        return [];\n      }\n\n      return [\n        {\n          ...dependency,\n          packageJsonPath,\n          nextRange: toRange(dependency.currentRange, latestVersion),\n        },\n      ];\n    })\n  );\n\n/**\n * Writes the upgraded ranges back to their `package.json`, keeping the file's\n * indentation and trailing newline.\n */\nexport const writeIntlayerDependencyUpgrades = async (\n  rootDir: string,\n  upgrades: IntlayerDependencyUpgrade[]\n): Promise<void> => {\n  const packageJsonPaths = [\n    ...new Set(upgrades.map(({ packageJsonPath }) => packageJsonPath)),\n  ];\n\n  for (const packageJsonPath of packageJsonPaths) {\n    const absolutePath = join(rootDir, packageJsonPath);\n    const content = await readFile(absolutePath, 'utf8');\n    const packageJson = JSON.parse(content);\n\n    for (const upgrade of upgrades) {\n      if (upgrade.packageJsonPath !== packageJsonPath) continue;\n      packageJson[upgrade.dependencyField][upgrade.packageName] =\n        upgrade.nextRange;\n    }\n\n    const indentation = content.match(/^[ \\t]+(?=\")/m)?.[0] ?? 2;\n    const trailingNewline = content.endsWith('\\n') ? '\\n' : '';\n\n    await writeFile(\n      absolutePath,\n      `${JSON.stringify(packageJson, null, indentation)}${trailingNewline}`,\n      'utf8'\n    );\n  }\n};\n"],"mappings":";;;;;;;;;;;AAOA,MAAM,oBAAoB,CAAC,gBAAgB,iBAAiB;;;;;AAgC5D,MAAM,mBAAmB,UACvB,YAAY,KAAK,MAAM,KAAK,CAAC;;;;;AAM/B,MAAa,uBAAuB,OAClC,YACsB;CAMtB,QAAO,UALwBA,mBAAG,mBAAmB;EACnD,KAAK;EACL,QAAQ,CAAC,GAAGC,+CAAgB,YAAY;CAC1C,CAAC,EAEsB,CAAC,MAAM,OAAO,WACnC,UAAU,iBACN,KACA,WAAW,iBACT,IACA,MAAM,cAAc,MAAM,CAClC;AACF;;;;;AAMA,MAAa,2BACX,gBAEA,kBAAkB,SAAS,oBACzB,OAAO,QAAQ,YAAY,oBAAoB,CAAC,CAAC,CAAC,CAC/C,QACE,CAAC,aAAa,WACbC,wDAAsB,WAAW,KAAK,gBAAgB,KAAK,CAC/D,CAAC,CACA,KAAK,CAAC,aAAa,mBAAmB;CACrC;CACA;CACA;AACF,EAAE,CACN;;AAGF,MAAa,2BAA2B,OACtC,YAC+C;CAC/C,MAAM,mBAAmB,MAAM,qBAAqB,OAAO;CAkB3D,QAAO,MAhBe,QAAQ,IAC5B,iBAAiB,IAAI,OAAO,oBAAoB;EAC9C,IAAI;GACF,MAAM,cAAc,KAAK,MACvB,UAAMC,+BAASC,gBAAK,SAAS,eAAe,GAAG,MAAM,CACvD;GACA,OAAO;IACL;IACA,cAAc,wBAAwB,WAAW;GACnD;EACF,QAAQ;GACN,OAAO;IAAE;IAAiB,cAAc,CAAC;GAAE;EAC7C;CACF,CAAC,CACH,EAEc,CAAC,QAAQ,EAAE,mBAAmB,aAAa,SAAS,CAAC;AACrE;;;;;;AAOA,MAAa,4BAA4B,OACvC,aACA,EACE,UAAU,UACV,cAAc,iCACgC,CAAC,MACtB;CAC3B,IAAI;EACF,MAAM,WAAW,MAAM,MACrB,GAAG,YAAY,GAAG,YAAY,QAAQ,KAAK,KAAK,EAAE,GAAG,mBAAmB,OAAO,KAC/E,EAAE,QAAQ,YAAY,QAAQ,GAAM,EAAE,CACxC;EACA,IAAI,CAAC,SAAS,IAAI,OAAO;EAEzB,MAAM,EAAE,YAAa,MAAM,SAAS,KAAK;EACzC,OAAO,OAAO,YAAY,WAAW,UAAU;CACjD,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;AAQA,MAAa,WAAW,cAAsB,YAC5C,GAAG,aAAa,KAAK,CAAC,CAAC,MAAM,QAAQ,CAAC,GAAG,MAAM,KAAK;;;;;;AAOtD,MAAa,iCACX,yBACA,mBAEA,wBAAwB,SAAS,EAAE,iBAAiB,mBAClD,aAAa,SAAS,eAAe;CACnC,MAAM,gBAAgB,eAAe,IAAI,WAAW,WAAW;CAE/D,IACE,CAAC,iBACDC,mDAAiB,WAAW,YAAY,MACtCA,mDAAiB,aAAa,GAEhC,OAAO,CAAC;CAGV,OAAO,CACL;EACE,GAAG;EACH;EACA,WAAW,QAAQ,WAAW,cAAc,aAAa;CAC3D,CACF;AACF,CAAC,CACH;;;;;AAMF,MAAa,kCAAkC,OAC7C,SACA,aACkB;CAClB,MAAM,mBAAmB,CACvB,GAAG,IAAI,IAAI,SAAS,KAAK,EAAE,sBAAsB,eAAe,CAAC,CACnE;CAEA,KAAK,MAAM,mBAAmB,kBAAkB;EAC9C,MAAM,mBAAeD,gBAAK,SAAS,eAAe;EAClD,MAAM,UAAU,UAAMD,2BAAS,cAAc,MAAM;EACnD,MAAM,cAAc,KAAK,MAAM,OAAO;EAEtC,KAAK,MAAM,WAAW,UAAU;GAC9B,IAAI,QAAQ,oBAAoB,iBAAiB;GACjD,YAAY,QAAQ,gBAAgB,CAAC,QAAQ,eAC3C,QAAQ;EACZ;EAEA,MAAM,cAAc,QAAQ,MAAM,eAAe,CAAC,GAAG,MAAM;EAC3D,MAAM,kBAAkB,QAAQ,SAAS,IAAI,IAAI,OAAO;EAExD,UAAMG,4BACJ,cACA,GAAG,KAAK,UAAU,aAAa,MAAM,WAAW,IAAI,mBACpD,MACF;CACF;AACF"}

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

@@ -1,19 +1,58 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-let node_path = require("node:path");
-let _intlayer_config_utils = require("@intlayer/config/utils");
 let node_fs = require("node:fs");
+let node_path = require("node:path");
 let node_child_process = require("node:child_process");
 
 //#region src/init/utils/packageManager.ts
+/** Lock files revealing the package manager, in detection priority order. */
+const LOCK_FILE_PACKAGE_MANAGERS = [
+	["bun.lock", "bun"],
+	["bun.lockb", "bun"],
+	["pnpm-lock.yaml", "pnpm"],
+	["yarn.lock", "yarn"],
+	["package-lock.json", "npm"]
+];
+/** Package managers accepted in the `packageManager` field of `package.json`. */
+const PACKAGE_MANAGERS = [
+	"bun",
+	"pnpm",
+	"yarn",
+	"npm"
+];
+/**
+* Reads the package manager pinned by the `packageManager` field of the
+* `package.json` in `directory` (e.g. `"pnpm@9.0.0"`), if any.
+*/
+const readPackageManagerField = (directory) => {
+	try {
+		const { packageManager } = JSON.parse((0, node_fs.readFileSync)((0, node_path.join)(directory, "package.json"), "utf8"));
+		if (typeof packageManager !== "string") return null;
+		const name = packageManager.split("@")[0];
+		return PACKAGE_MANAGERS.includes(name) ? name : null;
+	} catch {
+		return null;
+	}
+};
 /**
 * Detects the package manager in use by checking for lock files in the
-* project root. Falls back to npm when no lock file is found.
+* project root, then the `packageManager` field of its `package.json`. Falls
+* back to npm when neither is found.
+*/
+const detectPackageManager = (rootDir) => LOCK_FILE_PACKAGE_MANAGERS.find(([lockFile]) => (0, node_fs.existsSync)((0, node_path.join)(rootDir, lockFile)))?.[1] ?? readPackageManagerField(rootDir) ?? "npm";
+/**
+* Walks up from `startDir` to the nearest directory holding a lock file — the
+* workspace root an install must run from. Stops at the repository root
+* (`.git`) and returns `null` when no lock file is found.
 */
-const detectPackageManager = (rootDir) => {
-	if ((0, node_fs.existsSync)((0, node_path.join)(rootDir, "bun.lock")) || (0, node_fs.existsSync)((0, node_path.join)(rootDir, "bun.lockb"))) return "bun";
-	if ((0, node_fs.existsSync)((0, node_path.join)(rootDir, "pnpm-lock.yaml"))) return "pnpm";
-	if ((0, node_fs.existsSync)((0, node_path.join)(rootDir, "yarn.lock"))) return "yarn";
-	return "npm";
+const findLockFileDir = (startDir) => {
+	let currentDir = (0, node_path.resolve)(startDir);
+	while (true) {
+		if (LOCK_FILE_PACKAGE_MANAGERS.some(([lockFile]) => (0, node_fs.existsSync)((0, node_path.join)(currentDir, lockFile)))) return currentDir;
+		if ((0, node_fs.existsSync)((0, node_path.join)(currentDir, ".git"))) return null;
+		const parentDir = (0, node_path.dirname)(currentDir);
+		if (parentDir === currentDir) return null;
+		currentDir = parentDir;
+	}
 };
 /**
 * Returns the install command for the given package manager and package list.
@@ -41,7 +80,11 @@ const COMPAT_I18N_LIBRARIES = [
 			"react-i18next",
 			"@intlayer/i18next",
 			"@intlayer/react-i18next"
-		]
+		],
+		replacements: {
+			i18next: "@intlayer/i18next",
+			"react-i18next": "@intlayer/react-i18next"
+		}
 	},
 	{
 		label: "next-intl / use-intl",
@@ -50,27 +93,36 @@ const COMPAT_I18N_LIBRARIES = [
 			"use-intl",
 			"@intlayer/next-intl",
 			"@intlayer/use-intl"
-		]
+		],
+		replacements: {
+			"next-intl": "@intlayer/next-intl",
+			"use-intl": "@intlayer/use-intl"
+		}
 	},
 	{
 		label: "vue-i18n",
-		packages: ["vue-i18n", "@intlayer/vue-i18n"]
+		packages: ["vue-i18n", "@intlayer/vue-i18n"],
+		replacements: { "vue-i18n": "@intlayer/vue-i18n" }
 	},
 	{
 		label: "@nuxtjs/i18n",
-		packages: ["@nuxtjs/i18n", "@intlayer/nuxtjs-i18n"]
+		packages: ["@nuxtjs/i18n", "@intlayer/nuxtjs-i18n"],
+		replacements: { "@nuxtjs/i18n": "@intlayer/nuxtjs-i18n" }
 	},
 	{
 		label: "next-i18next",
-		packages: ["next-i18next", "@intlayer/next-i18next"]
+		packages: ["next-i18next", "@intlayer/next-i18next"],
+		replacements: { "next-i18next": "@intlayer/next-i18next" }
 	},
 	{
 		label: "next-translate",
-		packages: ["next-translate", "@intlayer/next-translate"]
+		packages: ["next-translate", "@intlayer/next-translate"],
+		replacements: { "next-translate": "@intlayer/next-translate" }
 	},
 	{
 		label: "react-intl",
-		packages: ["react-intl", "@intlayer/react-intl"]
+		packages: ["react-intl", "@intlayer/react-intl"],
+		replacements: { "react-intl": "@intlayer/react-intl" }
 	},
 	{
 		label: "Lingui",
@@ -78,30 +130,63 @@ const COMPAT_I18N_LIBRARIES = [
 			"@lingui/core",
 			"@lingui/react",
 			"@intlayer/lingui"
-		]
+		],
+		replacements: {
+			"@lingui/core": "@intlayer/lingui",
+			"@lingui/react": "@intlayer/lingui"
+		}
 	},
 	{
 		label: "svelte-i18n",
-		packages: ["svelte-i18n", "@intlayer/svelte-i18n"]
+		packages: ["svelte-i18n", "@intlayer/svelte-i18n"],
+		replacements: { "svelte-i18n": "@intlayer/svelte-i18n" }
 	},
 	{
 		label: "@ngneat/transloco",
-		packages: ["@ngneat/transloco", "@intlayer/transloco"]
+		packages: ["@ngneat/transloco", "@intlayer/transloco"],
+		replacements: { "@ngneat/transloco": "@intlayer/transloco" }
 	},
 	{
 		label: "@ngx-translate/core",
-		packages: ["@ngx-translate/core", "@intlayer/ngx-translate"]
+		packages: ["@ngx-translate/core", "@intlayer/ngx-translate"],
+		replacements: { "@ngx-translate/core": "@intlayer/ngx-translate" }
 	},
 	{
 		label: "node-polyglot",
-		packages: ["node-polyglot", "@intlayer/polyglot"]
+		packages: ["node-polyglot", "@intlayer/polyglot"],
+		replacements: { "node-polyglot": "@intlayer/polyglot" }
 	},
 	{
 		label: "i18n-js",
-		packages: ["i18n-js", "@intlayer/i18n-js"]
+		packages: ["i18n-js", "@intlayer/i18n-js"],
+		replacements: { "i18n-js": "@intlayer/i18n-js" }
 	}
 ];
 /**
+* Maps third-party i18n libraries to the Intlayer compat adapter that replaces
+* them at runtime, derived from {@link COMPAT_I18N_LIBRARIES}.
+*/
+const COMPAT_PACKAGE_REPLACEMENTS = Object.fromEntries(COMPAT_I18N_LIBRARIES.flatMap((library) => Object.entries(library.replacements)));
+/**
+* When a project uses a compat i18n package (such as `next-intl`) that gets
+* replaced by an `@intlayer/*` adapter (e.g. `@intlayer/next-intl`), moves the
+* original package from `dependencies` to `devDependencies` in `package.json`.
+*
+* Returns the list of package names that were moved.
+*/
+const moveCompatPackagesToDevDependencies = (packageJson) => {
+	const movedPackages = [];
+	if (!packageJson.dependencies) return movedPackages;
+	for (const compatPackage of Object.keys(COMPAT_PACKAGE_REPLACEMENTS)) if (packageJson.dependencies[compatPackage]) {
+		const version = packageJson.dependencies[compatPackage];
+		delete packageJson.dependencies[compatPackage];
+		packageJson.devDependencies = packageJson.devDependencies ?? {};
+		if (!packageJson.devDependencies[compatPackage]) packageJson.devDependencies[compatPackage] = version;
+		movedPackages.push(compatPackage);
+	}
+	return movedPackages;
+};
+/**
 * Returns the labels of the compat i18n libraries present in `dependencies`.
 *
 * Lets the init flow report (and branch on) the libraries it found without
@@ -126,6 +211,7 @@ const hasLintTooling = (dependencies) => Boolean(dependencies.eslint) || Boolean
 const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 	const packagesToInstall = [];
 	const devPackagesToInstall = [];
+	const packagesToMoveToDev = [];
 	let compatSyncConfig;
 	let compatVitePluginConfig;
 	const isInstalled = (packageName) => Boolean(allDependencies[packageName]);
@@ -135,6 +221,16 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 	const addDevIfMissing = (packageName) => {
 		if (!isInstalled(packageName)) devPackagesToInstall.push(packageName);
 	};
+	const markCompatReplacement = (originalPackage, adapterPackage) => {
+		addIfMissing(adapterPackage);
+		addDevIfMissing(originalPackage);
+		const isExplicitDev = Boolean(options.devDependencies?.[originalPackage]);
+		const isExplicitProd = Boolean(options.dependencies?.[originalPackage]);
+		const isImplicitProd = !options.dependencies && !options.devDependencies && Boolean(allDependencies[originalPackage]);
+		if ((isExplicitProd || isImplicitProd) && !isExplicitDev) {
+			if (!packagesToMoveToDev.includes(originalPackage)) packagesToMoveToDev.push(originalPackage);
+		}
+	};
 	addIfMissing("intlayer");
 	const isReactNativeProject = isInstalled("react-native") || isInstalled("expo");
 	if (isInstalled("next")) addIfMissing("next-intlayer");
@@ -147,8 +243,7 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 	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");
+		markCompatReplacement("next-intl", "@intlayer/next-intl");
 		compatSyncConfig ??= {
 			format: "icu",
 			sourceTemplate: "./messages/${locale}.json",
@@ -156,24 +251,21 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 		};
 	}
 	if (isInstalled("next-i18next") || isInstalled("@intlayer/next-i18next")) {
-		addIfMissing("@intlayer/next-i18next");
-		addIfMissing("next-i18next");
+		markCompatReplacement("next-i18next", "@intlayer/next-i18next");
 		compatSyncConfig ??= {
 			format: "i18next",
 			sourceTemplate: "./src/locales/${locale}/${key}.json"
 		};
 	}
 	if (isInstalled("next-translate") || isInstalled("@intlayer/next-translate")) {
-		addIfMissing("@intlayer/next-translate");
-		addIfMissing("next-translate");
+		markCompatReplacement("next-translate", "@intlayer/next-translate");
 		compatSyncConfig ??= {
 			format: "i18next",
 			sourceTemplate: "./locales/${locale}/${key}.json"
 		};
 	}
 	if (isInstalled("i18next") || isInstalled("@intlayer/i18next")) {
-		addIfMissing("@intlayer/i18next");
-		addIfMissing("i18next");
+		markCompatReplacement("i18next", "@intlayer/i18next");
 		compatSyncConfig ??= {
 			format: "i18next",
 			sourceTemplate: "./src/locales/${locale}/${key}.json"
@@ -184,8 +276,7 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 		};
 	}
 	if (isInstalled("react-i18next") || isInstalled("@intlayer/react-i18next")) {
-		addIfMissing("@intlayer/react-i18next");
-		addIfMissing("react-i18next");
+		markCompatReplacement("react-i18next", "@intlayer/react-i18next");
 		compatSyncConfig ??= {
 			format: "i18next",
 			sourceTemplate: "./src/locales/${locale}/${key}.json"
@@ -196,8 +287,7 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 		};
 	}
 	if (isInstalled("vue-i18n") || isInstalled("@intlayer/vue-i18n")) {
-		addIfMissing("@intlayer/vue-i18n");
-		addIfMissing("vue-i18n");
+		markCompatReplacement("vue-i18n", "@intlayer/vue-i18n");
 		compatSyncConfig ??= {
 			format: "vue-i18n",
 			sourceTemplate: "./locales/${locale}/${key}.json"
@@ -208,8 +298,7 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 		};
 	}
 	if (isInstalled("use-intl") || isInstalled("@intlayer/use-intl")) {
-		addIfMissing("@intlayer/use-intl");
-		addIfMissing("use-intl");
+		markCompatReplacement("use-intl", "@intlayer/use-intl");
 		compatSyncConfig ??= {
 			format: "icu",
 			sourceTemplate: "./messages/${locale}.json",
@@ -221,8 +310,7 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 		};
 	}
 	if (isInstalled("react-intl") || isInstalled("@intlayer/react-intl")) {
-		addIfMissing("@intlayer/react-intl");
-		addIfMissing("react-intl");
+		markCompatReplacement("react-intl", "@intlayer/react-intl");
 		compatSyncConfig ??= {
 			format: "icu",
 			sourceTemplate: "./src/i18n/${locale}.json"
@@ -233,16 +321,14 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 		};
 	}
 	if (isInstalled("@ngneat/transloco") || isInstalled("@intlayer/transloco")) {
-		addIfMissing("@intlayer/transloco");
-		addIfMissing("@ngneat/transloco");
+		markCompatReplacement("@ngneat/transloco", "@intlayer/transloco");
 		compatVitePluginConfig ??= {
 			pluginFunctionName: "translocoVitePlugin",
 			pluginPackageSource: "@intlayer/transloco/plugin"
 		};
 	}
 	if (isInstalled("svelte-i18n") || isInstalled("@intlayer/svelte-i18n")) {
-		addIfMissing("@intlayer/svelte-i18n");
-		addIfMissing("svelte-i18n");
+		markCompatReplacement("svelte-i18n", "@intlayer/svelte-i18n");
 		compatSyncConfig ??= {
 			format: "i18next",
 			sourceTemplate: "./src/locales/${locale}.json"
@@ -253,24 +339,21 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 		};
 	}
 	if (isInstalled("node-polyglot") || isInstalled("@intlayer/polyglot")) {
-		addIfMissing("@intlayer/polyglot");
-		addIfMissing("node-polyglot");
+		markCompatReplacement("node-polyglot", "@intlayer/polyglot");
 		compatVitePluginConfig ??= {
 			pluginFunctionName: "polyglotVitePlugin",
 			pluginPackageSource: "@intlayer/polyglot/plugin"
 		};
 	}
 	if (isInstalled("@nuxtjs/i18n") || isInstalled("@intlayer/nuxtjs-i18n")) {
-		addIfMissing("@intlayer/nuxtjs-i18n");
-		addIfMissing("@nuxtjs/i18n");
+		markCompatReplacement("@nuxtjs/i18n", "@intlayer/nuxtjs-i18n");
 		compatSyncConfig ??= {
 			format: "vue-i18n",
 			sourceTemplate: "./locales/${locale}/${key}.json"
 		};
 	}
 	if (isInstalled("@ngx-translate/core") || isInstalled("@intlayer/ngx-translate")) {
-		addIfMissing("@intlayer/ngx-translate");
-		addIfMissing("@ngx-translate/core");
+		markCompatReplacement("@ngx-translate/core", "@intlayer/ngx-translate");
 		compatSyncConfig ??= {
 			format: "i18next",
 			sourceTemplate: "./assets/i18n/${locale}.json"
@@ -281,8 +364,8 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 		};
 	}
 	if (isInstalled("@lingui/core") || isInstalled("@lingui/react") || isInstalled("@intlayer/lingui")) {
-		addIfMissing("@intlayer/lingui");
-		addIfMissing("@lingui/core");
+		markCompatReplacement("@lingui/core", "@intlayer/lingui");
+		if (isInstalled("@lingui/react")) markCompatReplacement("@lingui/react", "@intlayer/lingui");
 		const linguiUsesPo = options.linguiCatalogFormat === "po";
 		compatSyncConfig ??= linguiUsesPo ? {
 			plugin: "po",
@@ -303,8 +386,7 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 		};
 	}
 	if (isInstalled("i18n-js") || isInstalled("@intlayer/i18n-js")) {
-		addIfMissing("@intlayer/i18n-js");
-		addIfMissing("i18n-js");
+		markCompatReplacement("i18n-js", "@intlayer/i18n-js");
 		compatVitePluginConfig ??= {
 			pluginFunctionName: "i18nJsVitePlugin",
 			pluginPackageSource: "@intlayer/i18n-js/plugin"
@@ -314,6 +396,7 @@ const detectMissingIntlayerPackages = (allDependencies, options = {}) => {
 	return {
 		packagesToInstall,
 		devPackagesToInstall,
+		packagesToMoveToDev,
 		compatSyncConfig,
 		compatVitePluginConfig
 	};
@@ -335,9 +418,10 @@ const installPackages = (rootDir, packages, packageManager, isDev = false) => {
 * Matches the core `intlayer` package, every scoped `@intlayer/*` package
 * (including compat adapters such as `@intlayer/next-intl`) and the framework
 * runtime integrations that follow the `<framework>-intlayer` convention
-* (e.g. `next-intlayer`, `react-intlayer`, `express-intlayer`).
+* (e.g. `next-intlayer`, `react-intlayer`, `express-intlayer`), as well as the
+* `intlayer-*` packages (e.g. `intlayer-editor`).
 */
-const isIntlayerPackageName = (packageName) => packageName === "intlayer" || packageName.startsWith("@intlayer/") || /-intlayer$/.test(packageName);
+const isIntlayerPackageName = (packageName) => packageName === "intlayer" || packageName.startsWith("@intlayer/") || packageName.startsWith("intlayer-") || packageName.endsWith("-intlayer");
 /**
 * Reduces a semver range or full version to its `major.minor.patch` core,
 * stripping range prefixes (`^`, `~`), pre-release identifiers and build
@@ -351,46 +435,12 @@ const normalizeVersion = (version) => {
 	return match ? `${match[1]}.${match[2]}.${match[3]}` : null;
 };
 /**
-* Reads the installed version of a package from its `package.json` inside the
-* project's `node_modules`. Returns `null` when the package is not installed or
-* its manifest cannot be read.
+* Runs the package manager install command synchronously, so edited
+* `package.json` ranges are resolved and the lock file updated. Throws if the
+* install process exits with a non-zero code.
 */
-const getInstalledPackageVersion = (rootDir, packageName) => {
-	try {
-		const manifestPath = (0, node_path.join)(rootDir, "node_modules", packageName, "package.json");
-		if (!(0, node_fs.existsSync)(manifestPath)) return null;
-		const { version } = JSON.parse((0, node_fs.readFileSync)(manifestPath, "utf-8"));
-		return typeof version === "string" ? version : null;
-	} catch {
-		return null;
-	}
-};
-/**
-* Returns the Intlayer packages from `dependencies` whose installed version is
-* behind `targetVersion` (compared on `major.minor.patch`). Packages that are
-* not installed yet are ignored — those are handled by
-* {@link detectMissingIntlayerPackages}.
-*/
-const detectOutdatedIntlayerPackages = (rootDir, dependencies, targetVersion) => {
-	const normalizedTarget = normalizeVersion(targetVersion);
-	if (!normalizedTarget) return [];
-	return Object.keys(dependencies).filter(isIntlayerPackageName).filter((packageName) => {
-		const installedVersion = getInstalledPackageVersion(rootDir, packageName);
-		const normalizedInstalled = normalizeVersion(installedVersion ?? void 0);
-		if (!normalizedInstalled) return false;
-		return (0, _intlayer_config_utils.compareVersions)(normalizedInstalled, "<", normalizedTarget);
-	});
-};
-/**
-* Upgrades the given packages to `targetVersion` synchronously, preserving the
-* dependency type via the `isDev` flag. Throws if the install process exits
-* with a non-zero code.
-*/
-const upgradePackages = (rootDir, packages, packageManager, targetVersion, isDev = false) => {
-	if (packages.length === 0) return;
-	const versionedPackages = packages.map((packageName) => `${packageName}@${targetVersion}`);
-	const command = buildInstallCommand(packageManager, versionedPackages, isDev);
-	(0, node_child_process.execSync)(command, {
+const runPackageInstall = (rootDir, packageManager) => {
+	(0, node_child_process.execSync)(`${packageManager} install`, {
 		cwd: rootDir,
 		stdio: "inherit"
 	});
@@ -398,14 +448,15 @@ const upgradePackages = (rootDir, packages, packageManager, targetVersion, isDev
 
 //#endregion
 exports.COMPAT_I18N_LIBRARIES = COMPAT_I18N_LIBRARIES;
+exports.COMPAT_PACKAGE_REPLACEMENTS = COMPAT_PACKAGE_REPLACEMENTS;
 exports.detectCompatI18nLibraries = detectCompatI18nLibraries;
 exports.detectMissingIntlayerPackages = detectMissingIntlayerPackages;
-exports.detectOutdatedIntlayerPackages = detectOutdatedIntlayerPackages;
 exports.detectPackageManager = detectPackageManager;
-exports.getInstalledPackageVersion = getInstalledPackageVersion;
+exports.findLockFileDir = findLockFileDir;
 exports.hasLintTooling = hasLintTooling;
 exports.installPackages = installPackages;
 exports.isIntlayerPackageName = isIntlayerPackageName;
+exports.moveCompatPackagesToDevDependencies = moveCompatPackagesToDevDependencies;
 exports.normalizeVersion = normalizeVersion;
-exports.upgradePackages = upgradePackages;
+exports.runPackageInstall = runPackageInstall;
 //# sourceMappingURL=packageManager.cjs.map