react-scripts-intlayer 9.1.2 → 9.2.0

package/dist/cjs/cli/react-scripts-intlayer.cjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+const require_findDuplicateWebpackPaths = require('../findDuplicateWebpackPaths.cjs');
 let _intlayer_config_node = require("@intlayer/config/node");
 let _intlayer_config_utils = require("@intlayer/config/utils");
 let node_child_process = require("node:child_process");
@@ -15,6 +16,22 @@ const args = process.argv.slice(2);
 const scriptIndex = args.findIndex((index) => index === "build" || index === "start" || index === "test");
 const script = scriptIndex === -1 ? args[0] : args[scriptIndex];
 /**
+* Surface a duplicated webpack install up-front, instead of leaving the user
+* with the unactionable `TypeError: The 'compilation' argument must be an
+* instance of Compilation` stack trace webpack throws much later.
+*/
+const warnOnDuplicateWebpack = () => {
+	const duplicateWebpackPaths = require_findDuplicateWebpackPaths.findDuplicateWebpackPaths();
+	if (duplicateWebpackPaths.length === 0) return;
+	(0, _intlayer_config_logger.logger)([
+		"Multiple copies of webpack were found in this project:",
+		...duplicateWebpackPaths.map((webpackPath) => `  - ${webpackPath}`),
+		"",
+		"react-scripts and its plugins must share a single webpack instance, otherwise the build fails with \"The 'compilation' argument must be an instance of Compilation\".",
+		"Deduplicate the install — for example by removing node_modules and the lockfile and reinstalling, or by pinning a single webpack version through your package manager (npm `overrides`, yarn `resolutions`, pnpm/bun `overrides`)."
+	].join("\n"), { level: "warn" });
+};
+/**
 * Build the Intlayer dictionaries (i.e. populate the `.intlayer` folder that
 * backs the `@intlayer/dictionaries-entry` alias) before craco/webpack starts.
 *
@@ -39,6 +56,7 @@ const runScript = async () => {
 		(0, _intlayer_config_logger.logger)("Perhaps you need to update craco?");
 		return;
 	}
+	warnOnDuplicateWebpack();
 	await prepareDictionaries(script);
 	const nodeArgs = scriptIndex > 0 ? args.slice(0, scriptIndex) : [];
 	const scriptPath = (0, _intlayer_config_utils.getProjectRequire)().resolve(`@craco/craco/dist/scripts/${script}`);

package/dist/cjs/cli/react-scripts-intlayer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"react-scripts-intlayer.cjs","names":[],"sources":["../../../src/cli/react-scripts-intlayer.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * To make the setup easier, we are using craco to override the webpack configuration.\n * This script is used to run the craco scripts with the custom configuration.\n *\n * The script is based on the original craco script from create-react-app.\n */\n\nimport { spawnSync } from 'node:child_process';\nimport { logger } from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport { getProjectRequire } from '@intlayer/config/utils';\n\nconst args = process.argv.slice(2);\nconst scriptIndex = args.findIndex(\n  (index) => index === 'build' || index === 'start' || index === 'test'\n);\nconst script = scriptIndex === -1 ? args[0] : args[scriptIndex];\n\n/**\n * Build the Intlayer dictionaries (i.e. populate the `.intlayer` folder that\n * backs the `@intlayer/dictionaries-entry` alias) before craco/webpack starts.\n *\n * Unlike the webpack `IntlayerPlugin` — whose `beforeCompile` hook fires only\n * after webpack has already begun resolving modules — this runs ahead of the\n * compiler so the dictionaries entry exists the moment resolution starts.\n * Mirrors the async `withIntlayer` flow used by the Next.js integration.\n */\nconst prepareDictionaries = async (\n  currentScript: string | undefined\n): Promise<void> => {\n  // `start` runs the dev server, `build` a production bundle, `test` the suite.\n  const isBuild = currentScript === 'build';\n  const isDev = currentScript === 'start';\n\n  const { prepareIntlayer } = await import('@intlayer/engine/build');\n  const intlayerConfig = getConfiguration();\n\n  // `prepareIntlayer` uses `runOnce`, so a redundant call from the webpack\n  // plugin later in the pipeline is a cheap no-op.\n  await prepareIntlayer(intlayerConfig, {\n    clean: isBuild,\n    env: isBuild ? 'prod' : 'dev',\n    cacheTimeoutMs: isDev\n      ? 1000 * 60 * 60 // 1 hour for dev (default cache timeout)\n      : 1000 * 30, // 30 seconds for build/test (ensure dictionaries are fresh)\n  });\n};\n\nconst runScript = async (): Promise<void> => {\n  if (script !== 'build' && script !== 'start' && script !== 'test') {\n    logger(`Unknown script \"${script}\".`);\n    logger('Perhaps you need to update craco?');\n    return;\n  }\n\n  await prepareDictionaries(script);\n\n  const nodeArgs = scriptIndex > 0 ? args.slice(0, scriptIndex) : [];\n  const scriptPath = getProjectRequire().resolve(\n    `@craco/craco/dist/scripts/${script}`\n  );\n\n  const scriptArgs = args.slice(scriptIndex + 1);\n  const processArgs = nodeArgs\n    .concat(scriptPath)\n    .concat([\n      ...scriptArgs,\n      '--config',\n      './node_modules/react-scripts-intlayer/dist/cjs/craco.config.cjs',\n    ]);\n\n  const child = spawnSync('node', processArgs, {\n    stdio: 'inherit',\n  });\n\n  if (child.signal) {\n    if (child.signal === 'SIGKILL') {\n      logger(`\n                The build failed because the process exited too early.\n                This probably means the system ran out of memory or someone called\n                \\`kill -9\\` on the process.\n            `);\n    } else if (child.signal === 'SIGTERM') {\n      logger(`\n                The build failed because the process exited too early.\n                Someone might have called  \\`kill\\` or \\`killall\\`, or the system could\n                be shutting down.\n            `);\n    }\n\n    process.exit(1);\n  }\n\n  process.exit(child.status ?? undefined);\n};\n\nrunScript();\n"],"mappings":";;;;;;;;;;;;;AAcA,MAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,MAAM,cAAc,KAAK,WACtB,UAAU,UAAU,WAAW,UAAU,WAAW,UAAU,MACjE;AACA,MAAM,SAAS,gBAAgB,KAAK,KAAK,KAAK,KAAK;;;;;;;;;;AAWnD,MAAM,sBAAsB,OAC1B,kBACkB;CAElB,MAAM,UAAU,kBAAkB;CAClC,MAAM,QAAQ,kBAAkB;CAEhC,MAAM,EAAE,oBAAoB,MAAM,OAAO;CAKzC,MAAM,4DAA6B,GAAG;EACpC,OAAO;EACP,KAAK,UAAU,SAAS;EACxB,gBAAgB,QACZ,MAAO,KAAK,KACZ,MAAO;CACb,CAAC;AACH;AAEA,MAAM,YAAY,YAA2B;CAC3C,IAAI,WAAW,WAAW,WAAW,WAAW,WAAW,QAAQ;EACjE,oCAAO,mBAAmB,OAAO,GAAG;EACpC,oCAAO,mCAAmC;EAC1C;CACF;CAEA,MAAM,oBAAoB,MAAM;CAEhC,MAAM,WAAW,cAAc,IAAI,KAAK,MAAM,GAAG,WAAW,IAAI,CAAC;CACjE,MAAM,2DAA+B,CAAC,CAAC,QACrC,6BAA6B,QAC/B;CAEA,MAAM,aAAa,KAAK,MAAM,cAAc,CAAC;CAS7C,MAAM,0CAAkB,QARJ,SACjB,OAAO,UAAU,CAAC,CAClB,OAAO;EACN,GAAG;EACH;EACA;CACF,CAEwC,GAAG,EAC3C,OAAO,UACT,CAAC;CAED,IAAI,MAAM,QAAQ;EAChB,IAAI,MAAM,WAAW,WACnB,oCAAO;;;;aAIA;OACF,IAAI,MAAM,WAAW,WAC1B,oCAAO;;;;aAIA;EAGT,QAAQ,KAAK,CAAC;CAChB;CAEA,QAAQ,KAAK,MAAM,UAAU,MAAS;AACxC;AAEA,UAAU"}
+{"version":3,"file":"react-scripts-intlayer.cjs","names":["findDuplicateWebpackPaths"],"sources":["../../../src/cli/react-scripts-intlayer.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * To make the setup easier, we are using craco to override the webpack configuration.\n * This script is used to run the craco scripts with the custom configuration.\n *\n * The script is based on the original craco script from create-react-app.\n */\n\nimport { spawnSync } from 'node:child_process';\nimport { logger } from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport { getProjectRequire } from '@intlayer/config/utils';\nimport { findDuplicateWebpackPaths } from '../findDuplicateWebpackPaths';\n\nconst args = process.argv.slice(2);\nconst scriptIndex = args.findIndex(\n  (index) => index === 'build' || index === 'start' || index === 'test'\n);\nconst script = scriptIndex === -1 ? args[0] : args[scriptIndex];\n\n/**\n * Surface a duplicated webpack install up-front, instead of leaving the user\n * with the unactionable `TypeError: The 'compilation' argument must be an\n * instance of Compilation` stack trace webpack throws much later.\n */\nconst warnOnDuplicateWebpack = (): void => {\n  const duplicateWebpackPaths = findDuplicateWebpackPaths();\n\n  if (duplicateWebpackPaths.length === 0) return;\n\n  logger(\n    [\n      'Multiple copies of webpack were found in this project:',\n      ...duplicateWebpackPaths.map((webpackPath) => `  - ${webpackPath}`),\n      '',\n      'react-scripts and its plugins must share a single webpack instance, otherwise the build fails with \"The \\'compilation\\' argument must be an instance of Compilation\".',\n      'Deduplicate the install — for example by removing node_modules and the lockfile and reinstalling, or by pinning a single webpack version through your package manager (npm `overrides`, yarn `resolutions`, pnpm/bun `overrides`).',\n    ].join('\\n'),\n    { level: 'warn' }\n  );\n};\n\n/**\n * Build the Intlayer dictionaries (i.e. populate the `.intlayer` folder that\n * backs the `@intlayer/dictionaries-entry` alias) before craco/webpack starts.\n *\n * Unlike the webpack `IntlayerPlugin` — whose `beforeCompile` hook fires only\n * after webpack has already begun resolving modules — this runs ahead of the\n * compiler so the dictionaries entry exists the moment resolution starts.\n * Mirrors the async `withIntlayer` flow used by the Next.js integration.\n */\nconst prepareDictionaries = async (\n  currentScript: string | undefined\n): Promise<void> => {\n  // `start` runs the dev server, `build` a production bundle, `test` the suite.\n  const isBuild = currentScript === 'build';\n  const isDev = currentScript === 'start';\n\n  const { prepareIntlayer } = await import('@intlayer/engine/build');\n  const intlayerConfig = getConfiguration();\n\n  // `prepareIntlayer` uses `runOnce`, so a redundant call from the webpack\n  // plugin later in the pipeline is a cheap no-op.\n  await prepareIntlayer(intlayerConfig, {\n    clean: isBuild,\n    env: isBuild ? 'prod' : 'dev',\n    cacheTimeoutMs: isDev\n      ? 1000 * 60 * 60 // 1 hour for dev (default cache timeout)\n      : 1000 * 30, // 30 seconds for build/test (ensure dictionaries are fresh)\n  });\n};\n\nconst runScript = async (): Promise<void> => {\n  if (script !== 'build' && script !== 'start' && script !== 'test') {\n    logger(`Unknown script \"${script}\".`);\n    logger('Perhaps you need to update craco?');\n    return;\n  }\n\n  warnOnDuplicateWebpack();\n\n  await prepareDictionaries(script);\n\n  const nodeArgs = scriptIndex > 0 ? args.slice(0, scriptIndex) : [];\n  const scriptPath = getProjectRequire().resolve(\n    `@craco/craco/dist/scripts/${script}`\n  );\n\n  const scriptArgs = args.slice(scriptIndex + 1);\n  const processArgs = nodeArgs\n    .concat(scriptPath)\n    .concat([\n      ...scriptArgs,\n      '--config',\n      './node_modules/react-scripts-intlayer/dist/cjs/craco.config.cjs',\n    ]);\n\n  const child = spawnSync('node', processArgs, {\n    stdio: 'inherit',\n  });\n\n  if (child.signal) {\n    if (child.signal === 'SIGKILL') {\n      logger(`\n                The build failed because the process exited too early.\n                This probably means the system ran out of memory or someone called\n                \\`kill -9\\` on the process.\n            `);\n    } else if (child.signal === 'SIGTERM') {\n      logger(`\n                The build failed because the process exited too early.\n                Someone might have called  \\`kill\\` or \\`killall\\`, or the system could\n                be shutting down.\n            `);\n    }\n\n    process.exit(1);\n  }\n\n  process.exit(child.status ?? undefined);\n};\n\nrunScript();\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,MAAM,cAAc,KAAK,WACtB,UAAU,UAAU,WAAW,UAAU,WAAW,UAAU,MACjE;AACA,MAAM,SAAS,gBAAgB,KAAK,KAAK,KAAK,KAAK;;;;;;AAOnD,MAAM,+BAAqC;CACzC,MAAM,wBAAwBA,4DAA0B;CAExD,IAAI,sBAAsB,WAAW,GAAG;CAExC,oCACE;EACE;EACA,GAAG,sBAAsB,KAAK,gBAAgB,OAAO,aAAa;EAClE;EACA;EACA;CACF,CAAC,CAAC,KAAK,IAAI,GACX,EAAE,OAAO,OAAO,CAClB;AACF;;;;;;;;;;AAWA,MAAM,sBAAsB,OAC1B,kBACkB;CAElB,MAAM,UAAU,kBAAkB;CAClC,MAAM,QAAQ,kBAAkB;CAEhC,MAAM,EAAE,oBAAoB,MAAM,OAAO;CAKzC,MAAM,4DAA6B,GAAG;EACpC,OAAO;EACP,KAAK,UAAU,SAAS;EACxB,gBAAgB,QACZ,MAAO,KAAK,KACZ,MAAO;CACb,CAAC;AACH;AAEA,MAAM,YAAY,YAA2B;CAC3C,IAAI,WAAW,WAAW,WAAW,WAAW,WAAW,QAAQ;EACjE,oCAAO,mBAAmB,OAAO,GAAG;EACpC,oCAAO,mCAAmC;EAC1C;CACF;CAEA,uBAAuB;CAEvB,MAAM,oBAAoB,MAAM;CAEhC,MAAM,WAAW,cAAc,IAAI,KAAK,MAAM,GAAG,WAAW,IAAI,CAAC;CACjE,MAAM,2DAA+B,CAAC,CAAC,QACrC,6BAA6B,QAC/B;CAEA,MAAM,aAAa,KAAK,MAAM,cAAc,CAAC;CAS7C,MAAM,0CAAkB,QARJ,SACjB,OAAO,UAAU,CAAC,CAClB,OAAO;EACN,GAAG;EACH;EACA;CACF,CAEwC,GAAG,EAC3C,OAAO,UACT,CAAC;CAED,IAAI,MAAM,QAAQ;EAChB,IAAI,MAAM,WAAW,WACnB,oCAAO;;;;aAIA;OACF,IAAI,MAAM,WAAW,WAC1B,oCAAO;;;;aAIA;EAGT,QAAQ,KAAK,CAAC;CAChB;CAEA,QAAQ,KAAK,MAAM,UAAU,MAAS;AACxC;AAEA,UAAU"}

package/dist/cjs/findDuplicateWebpackPaths.cjs

@@ -0,0 +1,56 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _intlayer_config_utils = require("@intlayer/config/utils");
+let node_module = require("node:module");
+
+//#region src/findDuplicateWebpackPaths.ts
+/**
+* Packages whose webpack resolution must agree for a CRA build to succeed.
+*
+* `react-scripts` owns the compiler, while `webpack-manifest-plugin` is a
+* plugin that taps it. Both are resolved independently by Node, so a hoisting
+* split between them is exactly the situation that breaks the build.
+*/
+const WEBPACK_CONSUMER_PACKAGES = ["react-scripts", "webpack-manifest-plugin"];
+/**
+* Resolve `webpack` from a package's own resolution root, mirroring what Node
+* does at runtime when that package calls `require('webpack')`.
+*
+* @param packageName - Name of the package to resolve `webpack` on behalf of.
+* @returns Absolute path to the webpack entry point, or `undefined` when it
+*   cannot be resolved.
+*/
+const resolveWebpackFrom = (packageName) => {
+	try {
+		return (0, node_module.createRequire)((0, _intlayer_config_utils.getProjectRequire)().resolve(`${packageName}/package.json`)).resolve("webpack");
+	} catch {
+		return;
+	}
+};
+/**
+* Detect whether the project tree contains more than one copy of webpack.
+*
+* `react-scripts` resolves webpack relative to itself, while hoisted plugins
+* such as `webpack-manifest-plugin` resolve it from the project root. When the
+* two resolutions land on different copies, the plugin's `Compilation` class is
+* not the one the compiler instantiated and webpack throws the opaque
+* `TypeError: The 'compilation' argument must be an instance of Compilation`.
+*
+* Neither `resolve.alias` nor any other webpack setting can fix this — the
+* duplication happens in Node's own `require` resolution, before webpack ever
+* runs — so the only remedy is deduplicating the install.
+*
+* @param resolver - Resolves the webpack entry a given package would load.
+*   Injectable for testing; defaults to real Node resolution.
+* @returns The distinct webpack entry points found, in discovery order. A
+*   result of fewer than two entries means the install is consistent.
+*/
+const findDuplicateWebpackPaths = (resolver = resolveWebpackFrom) => {
+	const webpackPaths = WEBPACK_CONSUMER_PACKAGES.map(resolver).filter((webpackPath) => Boolean(webpackPath));
+	const uniqueWebpackPaths = [...new Set(webpackPaths)];
+	return uniqueWebpackPaths.length < 2 ? [] : uniqueWebpackPaths;
+};
+
+//#endregion
+exports.findDuplicateWebpackPaths = findDuplicateWebpackPaths;
+exports.resolveWebpackFrom = resolveWebpackFrom;
+//# sourceMappingURL=findDuplicateWebpackPaths.cjs.map

package/dist/cjs/findDuplicateWebpackPaths.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"findDuplicateWebpackPaths.cjs","names":[],"sources":["../../src/findDuplicateWebpackPaths.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport { getProjectRequire } from '@intlayer/config/utils';\n\n/**\n * Packages whose webpack resolution must agree for a CRA build to succeed.\n *\n * `react-scripts` owns the compiler, while `webpack-manifest-plugin` is a\n * plugin that taps it. Both are resolved independently by Node, so a hoisting\n * split between them is exactly the situation that breaks the build.\n */\nconst WEBPACK_CONSUMER_PACKAGES = ['react-scripts', 'webpack-manifest-plugin'];\n\n/**\n * Resolves a function that maps a package name to the `webpack` entry point\n * that package would load, or `undefined` when the package (or its webpack) is\n * not installed.\n */\nexport type WebpackResolver = (packageName: string) => string | undefined;\n\n/**\n * Resolve `webpack` from a package's own resolution root, mirroring what Node\n * does at runtime when that package calls `require('webpack')`.\n *\n * @param packageName - Name of the package to resolve `webpack` on behalf of.\n * @returns Absolute path to the webpack entry point, or `undefined` when it\n *   cannot be resolved.\n */\nexport const resolveWebpackFrom: WebpackResolver = (packageName) => {\n  try {\n    const packageJsonPath = getProjectRequire().resolve(\n      `${packageName}/package.json`\n    );\n\n    return createRequire(packageJsonPath).resolve('webpack');\n  } catch {\n    // The package (or its webpack) is absent — nothing to compare.\n    return undefined;\n  }\n};\n\n/**\n * Detect whether the project tree contains more than one copy of webpack.\n *\n * `react-scripts` resolves webpack relative to itself, while hoisted plugins\n * such as `webpack-manifest-plugin` resolve it from the project root. When the\n * two resolutions land on different copies, the plugin's `Compilation` class is\n * not the one the compiler instantiated and webpack throws the opaque\n * `TypeError: The 'compilation' argument must be an instance of Compilation`.\n *\n * Neither `resolve.alias` nor any other webpack setting can fix this — the\n * duplication happens in Node's own `require` resolution, before webpack ever\n * runs — so the only remedy is deduplicating the install.\n *\n * @param resolver - Resolves the webpack entry a given package would load.\n *   Injectable for testing; defaults to real Node resolution.\n * @returns The distinct webpack entry points found, in discovery order. A\n *   result of fewer than two entries means the install is consistent.\n */\nexport const findDuplicateWebpackPaths = (\n  resolver: WebpackResolver = resolveWebpackFrom\n): string[] => {\n  const webpackPaths = WEBPACK_CONSUMER_PACKAGES.map(resolver).filter(\n    (webpackPath): webpackPath is string => Boolean(webpackPath)\n  );\n\n  const uniqueWebpackPaths = [...new Set(webpackPaths)];\n\n  return uniqueWebpackPaths.length < 2 ? [] : uniqueWebpackPaths;\n};\n"],"mappings":";;;;;;;;;;;;AAUA,MAAM,4BAA4B,CAAC,iBAAiB,yBAAyB;;;;;;;;;AAiB7E,MAAa,sBAAuC,gBAAgB;CAClE,IAAI;EAKF,oFAJ0C,CAAC,CAAC,QAC1C,GAAG,YAAY,cAGkB,CAAC,CAAC,CAAC,QAAQ,SAAS;CACzD,QAAQ;EAEN;CACF;AACF;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,6BACX,WAA4B,uBACf;CACb,MAAM,eAAe,0BAA0B,IAAI,QAAQ,CAAC,CAAC,QAC1D,gBAAuC,QAAQ,WAAW,CAC7D;CAEA,MAAM,qBAAqB,CAAC,GAAG,IAAI,IAAI,YAAY,CAAC;CAEpD,OAAO,mBAAmB,SAAS,IAAI,CAAC,IAAI;AAC9C"}

package/dist/cjs/intlayerCracoPlugin.cjs

@@ -13,7 +13,6 @@ const alias = (0, _intlayer_config_utils.getAlias)({
 });
 /**
 * Override the final CRA Webpack config.
-* We explicitely type the return as WebpackConfig to solve TS2742.
 */
 const overrideWebpackConfig = ({ webpackConfig }) => {
 	if (typeof webpackConfig.externals === "object") webpackConfig.externals = {

package/dist/cjs/intlayerCracoPlugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"intlayerCracoPlugin.cjs","names":["IntlayerPlugin"],"sources":["../../src/intlayerCracoPlugin.ts"],"sourcesContent":["import { join } from 'node:path';\nimport type {\n  CracoConfig,\n  CracoConfigOverride,\n  CracoPlugin,\n  WebpackConfigOverride,\n} from '@craco/types';\nimport { getConfiguration } from '@intlayer/config/node';\nimport { getAlias } from '@intlayer/config/utils';\nimport { IntlayerPlugin } from '@intlayer/webpack';\nimport { defu } from 'defu';\nimport type { Configuration as WebpackConfig } from 'webpack';\n\n// Get Intlayer configuration\nconst intlayerConfig = getConfiguration();\n\nconst alias = getAlias({\n  configuration: intlayerConfig,\n  formatter: (value: string) => join(process.cwd(), value),\n});\n\n/**\n * Override the final CRA Webpack config.\n * We explicitely type the return as WebpackConfig to solve TS2742.\n */\nexport const overrideWebpackConfig = ({\n  webpackConfig,\n}: WebpackConfigOverride): WebpackConfig => {\n  // 1) Remove `module`, `fs`, `path`, `vm` from externals.\n  if (typeof webpackConfig.externals === 'object') {\n    webpackConfig.externals = {\n      ...webpackConfig.externals,\n      esbuild: 'esbuild',\n    };\n  }\n\n  // 2) Properly push node-loader rule\n  webpackConfig.module?.rules?.push({\n    test: /\\.node$/,\n    use: 'node-loader',\n  });\n\n  // We cast here to satisfy the internal function return type if there are minor discrepancies\n  return webpackConfig as WebpackConfig;\n};\n\n/**\n * Override the CRACO config itself to set up aliases, fallbacks, and plugins.\n */\nexport const overrideCracoConfig = ({\n  cracoConfig,\n}: CracoConfigOverride): CracoConfig =>\n  defu(\n    {\n      webpack: {\n        plugins: {\n          // defu overwrites arrays by default, so we manually preserve existing plugins\n          add: [\n            ...(cracoConfig.webpack?.plugins?.add ?? []),\n            new IntlayerPlugin(intlayerConfig),\n          ],\n        },\n        // Automatically merges deeply with existing aliases\n        alias,\n      },\n    },\n    cracoConfig\n  ) as CracoConfig;\n\n/**\n * A CRACO plugin that adds the Intlayer configuration to the webpack configuration\n * and sets the environment variables.\n */\nexport const intlayerCracoPlugin: CracoPlugin = {\n  overrideCracoConfig,\n  // We cast to `any` here to bypass the strict version mismatch between\n  // the 'webpack' package installed in your node_modules and the one expected by '@craco/types'\n  overrideWebpackConfig: overrideWebpackConfig as any,\n};\n"],"mappings":";;;;;;;;AAcA,MAAM,6DAAkC;AAExC,MAAM,6CAAiB;CACrB,eAAe;CACf,YAAY,8BAAuB,QAAQ,IAAI,GAAG,KAAK;AACzD,CAAC;;;;;AAMD,MAAa,yBAAyB,EACpC,oBAC0C;CAE1C,IAAI,OAAO,cAAc,cAAc,UACrC,cAAc,YAAY;EACxB,GAAG,cAAc;EACjB,SAAS;CACX;CAIF,cAAc,QAAQ,OAAO,KAAK;EAChC,MAAM;EACN,KAAK;CACP,CAAC;CAGD,OAAO;AACT;;;;AAKA,MAAa,uBAAuB,EAClC,iCAGE,EACE,SAAS;CACP,SAAS,EAEP,KAAK,CACH,GAAI,YAAY,SAAS,SAAS,OAAO,CAAC,GAC1C,IAAIA,iCAAe,cAAc,CACnC,EACF;CAEA;AACF,EACF,GACA,WACF;;;;;AAMF,MAAa,sBAAmC;CAC9C;CAGuB;AACzB"}
+{"version":3,"file":"intlayerCracoPlugin.cjs","names":["IntlayerPlugin"],"sources":["../../src/intlayerCracoPlugin.ts"],"sourcesContent":["import { join } from 'node:path';\nimport type {\n  CracoConfig,\n  CracoConfigOverride,\n  CracoPlugin,\n  WebpackConfigOverride,\n} from '@craco/types';\nimport { getConfiguration } from '@intlayer/config/node';\nimport { getAlias } from '@intlayer/config/utils';\nimport { IntlayerPlugin } from '@intlayer/webpack';\nimport { defu } from 'defu';\n\n/**\n * The webpack `Configuration` type exactly as CRACO hands it to us.\n *\n * Deliberately derived from `@craco/types` rather than imported from `webpack`:\n * the webpack copy CRACO resolves and the one this package resolves are two\n * distinct type identities whenever their versions differ, which makes any\n * conversion between them a compile error. Reusing CRACO's own type keeps a\n * single identity, and — being an indexed access on an imported type — it stays\n * nameable in the emitted declarations, avoiding TS2742.\n */\ntype CracoWebpackConfig = WebpackConfigOverride['webpackConfig'];\n\n// Get Intlayer configuration\nconst intlayerConfig = getConfiguration();\n\nconst alias = getAlias({\n  configuration: intlayerConfig,\n  formatter: (value: string) => join(process.cwd(), value),\n});\n\n/**\n * Override the final CRA Webpack config.\n */\nexport const overrideWebpackConfig = ({\n  webpackConfig,\n}: WebpackConfigOverride): CracoWebpackConfig => {\n  // 1) Remove `module`, `fs`, `path`, `vm` from externals.\n  if (typeof webpackConfig.externals === 'object') {\n    webpackConfig.externals = {\n      ...webpackConfig.externals,\n      esbuild: 'esbuild',\n    };\n  }\n\n  // 2) Properly push node-loader rule\n  webpackConfig.module?.rules?.push({\n    test: /\\.node$/,\n    use: 'node-loader',\n  });\n\n  return webpackConfig;\n};\n\n/**\n * Override the CRACO config itself to set up aliases, fallbacks, and plugins.\n */\nexport const overrideCracoConfig = ({\n  cracoConfig,\n}: CracoConfigOverride): CracoConfig =>\n  defu(\n    {\n      webpack: {\n        plugins: {\n          // defu overwrites arrays by default, so we manually preserve existing plugins\n          add: [\n            ...(cracoConfig.webpack?.plugins?.add ?? []),\n            new IntlayerPlugin(intlayerConfig),\n          ],\n        },\n        // Automatically merges deeply with existing aliases\n        alias,\n      },\n    },\n    cracoConfig\n  ) as CracoConfig;\n\n/**\n * A CRACO plugin that adds the Intlayer configuration to the webpack configuration\n * and sets the environment variables.\n */\nexport const intlayerCracoPlugin: CracoPlugin = {\n  overrideCracoConfig,\n  overrideWebpackConfig,\n};\n"],"mappings":";;;;;;;;AAyBA,MAAM,6DAAkC;AAExC,MAAM,6CAAiB;CACrB,eAAe;CACf,YAAY,8BAAuB,QAAQ,IAAI,GAAG,KAAK;AACzD,CAAC;;;;AAKD,MAAa,yBAAyB,EACpC,oBAC+C;CAE/C,IAAI,OAAO,cAAc,cAAc,UACrC,cAAc,YAAY;EACxB,GAAG,cAAc;EACjB,SAAS;CACX;CAIF,cAAc,QAAQ,OAAO,KAAK;EAChC,MAAM;EACN,KAAK;CACP,CAAC;CAED,OAAO;AACT;;;;AAKA,MAAa,uBAAuB,EAClC,iCAGE,EACE,SAAS;CACP,SAAS,EAEP,KAAK,CACH,GAAI,YAAY,SAAS,SAAS,OAAO,CAAC,GAC1C,IAAIA,iCAAe,cAAc,CACnC,EACF;CAEA;AACF,EACF,GACA,WACF;;;;;AAMF,MAAa,sBAAmC;CAC9C;CACA;AACF"}

package/dist/types/findDuplicateWebpackPaths.d.ts

@@ -0,0 +1,38 @@
+//#region src/findDuplicateWebpackPaths.d.ts
+/**
+ * Resolves a function that maps a package name to the `webpack` entry point
+ * that package would load, or `undefined` when the package (or its webpack) is
+ * not installed.
+ */
+type WebpackResolver = (packageName: string) => string | undefined;
+/**
+ * Resolve `webpack` from a package's own resolution root, mirroring what Node
+ * does at runtime when that package calls `require('webpack')`.
+ *
+ * @param packageName - Name of the package to resolve `webpack` on behalf of.
+ * @returns Absolute path to the webpack entry point, or `undefined` when it
+ *   cannot be resolved.
+ */
+declare const resolveWebpackFrom: WebpackResolver;
+/**
+ * Detect whether the project tree contains more than one copy of webpack.
+ *
+ * `react-scripts` resolves webpack relative to itself, while hoisted plugins
+ * such as `webpack-manifest-plugin` resolve it from the project root. When the
+ * two resolutions land on different copies, the plugin's `Compilation` class is
+ * not the one the compiler instantiated and webpack throws the opaque
+ * `TypeError: The 'compilation' argument must be an instance of Compilation`.
+ *
+ * Neither `resolve.alias` nor any other webpack setting can fix this — the
+ * duplication happens in Node's own `require` resolution, before webpack ever
+ * runs — so the only remedy is deduplicating the install.
+ *
+ * @param resolver - Resolves the webpack entry a given package would load.
+ *   Injectable for testing; defaults to real Node resolution.
+ * @returns The distinct webpack entry points found, in discovery order. A
+ *   result of fewer than two entries means the install is consistent.
+ */
+declare const findDuplicateWebpackPaths: (resolver?: WebpackResolver) => string[];
+//#endregion
+export { WebpackResolver, findDuplicateWebpackPaths, resolveWebpackFrom };
+//# sourceMappingURL=findDuplicateWebpackPaths.d.ts.map

package/dist/types/findDuplicateWebpackPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findDuplicateWebpackPaths.d.ts","names":[],"sources":["../../src/findDuplicateWebpackPaths.ts"],"mappings":";;;;;;KAiBY,mBAAmB;;;;;;;;;cAUlB,oBAAoB;;;;;;;;;;;;;;;;;;;cA+BpB,4BAAyB,WAC1B"}

package/dist/types/intlayerCracoPlugin.d.ts

@@ -1,11 +1,20 @@
 import { CracoConfig, CracoConfigOverride, CracoPlugin, WebpackConfigOverride } from "@craco/types";
-import { Configuration } from "webpack";
 //#region src/intlayerCracoPlugin.d.ts
+/**
+ * The webpack `Configuration` type exactly as CRACO hands it to us.
+ *
+ * Deliberately derived from `@craco/types` rather than imported from `webpack`:
+ * the webpack copy CRACO resolves and the one this package resolves are two
+ * distinct type identities whenever their versions differ, which makes any
+ * conversion between them a compile error. Reusing CRACO's own type keeps a
+ * single identity, and — being an indexed access on an imported type — it stays
+ * nameable in the emitted declarations, avoiding TS2742.
+ */
+type CracoWebpackConfig = WebpackConfigOverride['webpackConfig'];
 /**
  * Override the final CRA Webpack config.
- * We explicitely type the return as WebpackConfig to solve TS2742.
  */
-declare const overrideWebpackConfig: ({ webpackConfig }: WebpackConfigOverride) => Configuration;
+declare const overrideWebpackConfig: ({ webpackConfig }: WebpackConfigOverride) => CracoWebpackConfig;
 /**
  * Override the CRACO config itself to set up aliases, fallbacks, and plugins.
  */

package/dist/types/intlayerCracoPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intlayerCracoPlugin.d.ts","names":[],"sources":["../../src/intlayerCracoPlugin.ts"],"mappings":";;;;;;;cAyBa,0BAAqB,iBAE/B,0BAAwB;;;;cAsBd,wBAAmB,eAE7B,wBAAsB;;;;;cAsBZ,qBAAqB"}
+{"version":3,"file":"intlayerCracoPlugin.d.ts","names":[],"sources":["../../src/intlayerCracoPlugin.ts"],"mappings":";;;;;;;;;;;;KAsBK,qBAAqB;;;;cAab,0BAAqB,iBAE/B,0BAAwB;;;;cAqBd,wBAAmB,eAE7B,wBAAsB;;;;;cAsBZ,qBAAqB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-scripts-intlayer",
-  "version": "9.1.2",
+  "version": "9.2.0",
   "private": false,
   "description": "Integrate Intlayer with Create React App using custom React scripts for internationalization i18n and advanced Webpack configurations",
   "keywords": [
@@ -79,14 +79,13 @@
   },
   "dependencies": {
     "@craco/craco": "7.1.0",
-    "@intlayer/config": "9.1.2",
-    "@intlayer/engine": "9.1.2",
-    "@intlayer/types": "9.1.2",
-    "@intlayer/webpack": "9.1.2",
+    "@intlayer/config": "9.2.0",
+    "@intlayer/engine": "9.2.0",
+    "@intlayer/types": "9.2.0",
+    "@intlayer/webpack": "9.2.0",
     "defu": "6.1.7",
     "node-loader": "2.1.0",
-    "process": "0.11.10",
-    "webpack": "5.108.4"
+    "process": "0.11.10"
   },
   "devDependencies": {
     "@craco/types": "7.1.0",
@@ -104,6 +103,11 @@
   "peerDependencies": {
     "webpack": ">=5.0.0"
   },
+  "peerDependenciesMeta": {
+    "webpack": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=14.18"
   },