webpack 5.100.2 → 5.101.0

package/lib/cli.js

@@ -6,6 +6,7 @@
 "use strict";
 
 const path = require("path");
+const tty = require("tty");
 const webpackSchema = require("../schemas/WebpackOptions.json");
 
 /** @typedef {import("json-schema").JSONSchema4} JSONSchema4 */
@@ -82,7 +83,7 @@ const getArguments = (schema = webpackSchema) => {
 	 * @param {string} input input
 	 * @returns {string} result
 	 */
-	const pathToArgumentName = input =>
+	const pathToArgumentName = (input) =>
 		input
 			.replace(/\./g, "-")
 			.replace(/\[\]/g, "")
@@ -97,7 +98,7 @@ const getArguments = (schema = webpackSchema) => {
 	 * @param {string} path path
 	 * @returns {Schema} schema part
 	 */
-	const getSchemaPart = path => {
+	const getSchemaPart = (path) => {
 		const newPath = path.split("/");
 
 		let schemaPart = schema;
@@ -119,7 +120,7 @@ const getArguments = (schema = webpackSchema) => {
 	 * @param {PathItem[]} path path in the schema
 	 * @returns {string | undefined} description
 	 */
-	const getDescription = path => {
+	const getDescription = (path) => {
 		for (const { schema } of path) {
 			if (schema.cli) {
 				if (schema.cli.helper) continue;
@@ -133,7 +134,7 @@ const getArguments = (schema = webpackSchema) => {
 	 * @param {PathItem[]} path path in the schema
 	 * @returns {string | undefined} negative description
 	 */
-	const getNegatedDescription = path => {
+	const getNegatedDescription = (path) => {
 		for (const { schema } of path) {
 			if (schema.cli) {
 				if (schema.cli.helper) continue;
@@ -146,7 +147,7 @@ const getArguments = (schema = webpackSchema) => {
 	 * @param {PathItem[]} path path in the schema
 	 * @returns {string | undefined} reset description
 	 */
-	const getResetDescription = path => {
+	const getResetDescription = (path) => {
 		for (const { schema } of path) {
 			if (schema.cli) {
 				if (schema.cli.helper) continue;
@@ -159,7 +160,7 @@ const getArguments = (schema = webpackSchema) => {
 	 * @param {Schema} schemaPart schema
 	 * @returns {Pick<ArgumentConfig, "type" | "values"> | undefined} partial argument config
 	 */
-	const schemaToArgumentConfig = schemaPart => {
+	const schemaToArgumentConfig = (schemaPart) => {
 		if (schemaPart.enum) {
 			return {
 				type: "enum",
@@ -192,7 +193,7 @@ const getArguments = (schema = webpackSchema) => {
 	 * @param {PathItem[]} path path in the schema
 	 * @returns {void}
 	 */
-	const addResetFlag = path => {
+	const addResetFlag = (path) => {
 		const schemaPath = path[0].path;
 		const name = pathToArgumentName(`${schemaPath}.reset`);
 		const description =
@@ -253,7 +254,7 @@ const getArguments = (schema = webpackSchema) => {
 
 		if (
 			flags[name].configs.some(
-				item => JSON.stringify(item) === JSON.stringify(argConfig)
+				(item) => JSON.stringify(item) === JSON.stringify(argConfig)
 			)
 		) {
 			return 0;
@@ -261,7 +262,7 @@ const getArguments = (schema = webpackSchema) => {
 
 		if (
 			flags[name].configs.some(
-				item => item.type === argConfig.type && item.multiple !== multiple
+				(item) => item.type === argConfig.type && item.multiple !== multiple
 			)
 		) {
 			if (multiple) {
@@ -411,8 +412,8 @@ const getArguments = (schema = webpackSchema) => {
 								/** @type {NonNullable<ArgumentConfig["values"]>} */
 								(argConfig.values);
 
-							if (values.every(v => typeof v === "boolean")) type = "boolean";
-							if (values.every(v => typeof v === "number")) type = "number";
+							if (values.every((v) => typeof v === "boolean")) type = "boolean";
+							if (values.every((v) => typeof v === "number")) type = "number";
 							break;
 						}
 					}
@@ -420,7 +421,7 @@ const getArguments = (schema = webpackSchema) => {
 					return t === type ? t : "string";
 				}, /** @type {SimpleType | undefined} */ (undefined))
 			);
-		argument.multiple = argument.configs.some(c => c.multiple);
+		argument.multiple = argument.configs.some((c) => c.multiple);
 	}
 
 	return flags;
@@ -580,7 +581,7 @@ const processArgumentConfig = (argConfig, config, value, index) => {
  * @param {ArgumentConfig} argConfig processing instructions
  * @returns {string | undefined} expected message
  */
-const getExpectedValue = argConfig => {
+const getExpectedValue = (argConfig) => {
 	switch (argConfig.type) {
 		case "boolean":
 			return "true | false";
@@ -590,7 +591,7 @@ const getExpectedValue = argConfig => {
 			return /** @type {NonNullable<ArgumentConfig["values"]>} */ (
 				argConfig.values
 			)
-				.map(v => `${v}`)
+				.map((v) => `${v}`)
 				.join(" | ");
 		case "reset":
 			return "true (will reset the previous value to an empty array)";
@@ -712,5 +713,186 @@ const processArguments = (args, config, values) => {
 	return problems;
 };
 
+/**
+ * @returns {boolean} true when colors supported, otherwise false
+ */
+const isColorSupported = () => {
+	const { env = {}, argv = [], platform = "" } = process;
+
+	const isDisabled = "NO_COLOR" in env || argv.includes("--no-color");
+	const isForced = "FORCE_COLOR" in env || argv.includes("--color");
+	const isWindows = platform === "win32";
+	const isDumbTerminal = env.TERM === "dumb";
+
+	const isCompatibleTerminal = tty.isatty(1) && env.TERM && !isDumbTerminal;
+
+	const isCI =
+		"CI" in env &&
+		("GITHUB_ACTIONS" in env || "GITLAB_CI" in env || "CIRCLECI" in env);
+
+	return (
+		!isDisabled &&
+		(isForced || (isWindows && !isDumbTerminal) || isCompatibleTerminal || isCI)
+	);
+};
+
+/**
+ * @param {number} index index
+ * @param {string} string string
+ * @param {string} close close
+ * @param {string=} replace replace
+ * @param {string=} head head
+ * @param {string=} tail tail
+ * @param {number=} next next
+ * @returns {string} result
+ */
+const replaceClose = (
+	index,
+	string,
+	close,
+	replace,
+	head = string.slice(0, Math.max(0, index)) + replace,
+	tail = string.slice(Math.max(0, index + close.length)),
+	next = tail.indexOf(close)
+) => head + (next < 0 ? tail : replaceClose(next, tail, close, replace));
+
+/**
+ * @param {number} index index to replace
+ * @param {string} string string
+ * @param {string} open open string
+ * @param {string} close close string
+ * @param {string=} replace extra replace
+ * @returns {string} result
+ */
+const clearBleed = (index, string, open, close, replace) =>
+	index < 0
+		? open + string + close
+		: open + replaceClose(index, string, close, replace) + close;
+
+/** @typedef {(value: EXPECTED_ANY) => string} PrintFunction */
+
+/**
+ * @param {string} open open string
+ * @param {string} close close string
+ * @param {string=} replace extra replace
+ * @param {number=} at at
+ * @returns {PrintFunction} function to create color
+ */
+const filterEmpty =
+	(open, close, replace = open, at = open.length + 1) =>
+	(string) =>
+		string || !(string === "" || string === undefined)
+			? clearBleed(`${string}`.indexOf(close, at), string, open, close, replace)
+			: "";
+
+/**
+ * @param {number} open open code
+ * @param {number} close close code
+ * @param {string=} replace extra replace
+ * @returns {PrintFunction} result
+ */
+const init = (open, close, replace) =>
+	filterEmpty(`\u001B[${open}m`, `\u001B[${close}m`, replace);
+
+/**
+ * @typedef {{
+ * reset: PrintFunction
+ * bold: PrintFunction
+ * dim: PrintFunction
+ * italic: PrintFunction
+ * underline: PrintFunction
+ * inverse: PrintFunction
+ * hidden: PrintFunction
+ * strikethrough: PrintFunction
+ * black: PrintFunction
+ * red: PrintFunction
+ * green: PrintFunction
+ * yellow: PrintFunction
+ * blue: PrintFunction
+ * magenta: PrintFunction
+ * cyan: PrintFunction
+ * white: PrintFunction
+ * gray: PrintFunction
+ * bgBlack: PrintFunction
+ * bgRed: PrintFunction
+ * bgGreen: PrintFunction
+ * bgYellow: PrintFunction
+ * bgBlue: PrintFunction
+ * bgMagenta: PrintFunction
+ * bgCyan: PrintFunction
+ * bgWhite: PrintFunction
+ * blackBright: PrintFunction
+ * redBright: PrintFunction
+ * greenBright: PrintFunction
+ * yellowBright: PrintFunction
+ * blueBright: PrintFunction
+ * magentaBright: PrintFunction
+ * cyanBright: PrintFunction
+ * whiteBright: PrintFunction
+ * bgBlackBright: PrintFunction
+ * bgRedBright: PrintFunction
+ * bgGreenBright: PrintFunction
+ * bgYellowBright: PrintFunction
+ * bgBlueBright: PrintFunction
+ * bgMagentaBright: PrintFunction
+ * bgCyanBright: PrintFunction
+ * bgWhiteBright: PrintFunction
+ }} Colors */
+
+/**
+ * @typedef {object} ColorsOptions
+ * @property {boolean=} useColor force use colors
+ */
+
+/**
+ * @param {ColorsOptions=} options options
+ * @returns {Colors} colors
+ */
+const createColors = ({ useColor = isColorSupported() } = {}) => ({
+	reset: useColor ? init(0, 0) : String,
+	bold: useColor ? init(1, 22, "\u001B[22m\u001B[1m") : String,
+	dim: useColor ? init(2, 22, "\u001B[22m\u001B[2m") : String,
+	italic: useColor ? init(3, 23) : String,
+	underline: useColor ? init(4, 24) : String,
+	inverse: useColor ? init(7, 27) : String,
+	hidden: useColor ? init(8, 28) : String,
+	strikethrough: useColor ? init(9, 29) : String,
+	black: useColor ? init(30, 39) : String,
+	red: useColor ? init(31, 39) : String,
+	green: useColor ? init(32, 39) : String,
+	yellow: useColor ? init(33, 39) : String,
+	blue: useColor ? init(34, 39) : String,
+	magenta: useColor ? init(35, 39) : String,
+	cyan: useColor ? init(36, 39) : String,
+	white: useColor ? init(37, 39) : String,
+	gray: useColor ? init(90, 39) : String,
+	bgBlack: useColor ? init(40, 49) : String,
+	bgRed: useColor ? init(41, 49) : String,
+	bgGreen: useColor ? init(42, 49) : String,
+	bgYellow: useColor ? init(43, 49) : String,
+	bgBlue: useColor ? init(44, 49) : String,
+	bgMagenta: useColor ? init(45, 49) : String,
+	bgCyan: useColor ? init(46, 49) : String,
+	bgWhite: useColor ? init(47, 49) : String,
+	blackBright: useColor ? init(90, 39) : String,
+	redBright: useColor ? init(91, 39) : String,
+	greenBright: useColor ? init(92, 39) : String,
+	yellowBright: useColor ? init(93, 39) : String,
+	blueBright: useColor ? init(94, 39) : String,
+	magentaBright: useColor ? init(95, 39) : String,
+	cyanBright: useColor ? init(96, 39) : String,
+	whiteBright: useColor ? init(97, 39) : String,
+	bgBlackBright: useColor ? init(100, 49) : String,
+	bgRedBright: useColor ? init(101, 49) : String,
+	bgGreenBright: useColor ? init(102, 49) : String,
+	bgYellowBright: useColor ? init(103, 49) : String,
+	bgBlueBright: useColor ? init(104, 49) : String,
+	bgMagentaBright: useColor ? init(105, 49) : String,
+	bgCyanBright: useColor ? init(106, 49) : String,
+	bgWhiteBright: useColor ? init(107, 49) : String
+});
+
+module.exports.createColors = createColors;
 module.exports.getArguments = getArguments;
+module.exports.isColorSupported = isColorSupported;
 module.exports.processArguments = processArguments;

package/lib/config/browserslistTargetHandler.js

@@ -74,14 +74,14 @@ const load = (input, context) => {
  * @param {string[]} browsers supported browsers list
  * @returns {EcmaTargetProperties & PlatformTargetProperties & ApiTargetProperties} target properties
  */
-const resolve = browsers => {
+const resolve = (browsers) => {
 	/**
 	 * Checks all against a version number
 	 * @param {Record<string, number | [number, number]>} versions first supported version
 	 * @returns {boolean} true if supports
 	 */
-	const rawChecker = versions =>
-		browsers.every(v => {
+	const rawChecker = (versions) =>
+		browsers.every((v) => {
 			const [name, parsedVersion] = v.split(" ");
 			if (!name) return false;
 			const requiredVersion = versions[name];
@@ -100,8 +100,8 @@ const resolve = browsers => {
 				? Number(parserMinor) >= requiredVersion[1]
 				: Number(parsedMajor) > requiredVersion[0];
 		});
-	const anyNode = browsers.some(b => b.startsWith("node "));
-	const anyBrowser = browsers.some(b => /^(?!node)/.test(b));
+	const anyNode = browsers.some((b) => b.startsWith("node "));
+	const anyBrowser = browsers.some((b) => /^(?!node)/.test(b));
 	const browserProperty = !anyBrowser ? false : anyNode ? null : true;
 	const nodeProperty = !anyNode ? false : anyBrowser ? null : true;
 	// Internet Explorer Mobile, Blackberry browser and Opera Mini are very old browsers, they do not support new features
@@ -349,7 +349,7 @@ const resolve = browsers => {
 		nodeBuiltins: nodeProperty,
 		nodePrefixForCoreModules:
 			nodeProperty &&
-			!browsers.some(b => b.startsWith("node 15")) &&
+			!browsers.some((b) => b.startsWith("node 15")) &&
 			rawChecker({
 				node: [14, 18]
 			}),

package/lib/config/defaults.js

@@ -159,7 +159,7 @@ const A = (obj, prop, factory) => {
  * @param {WebpackOptionsNormalized} options options to be modified
  * @returns {void}
  */
-const applyWebpackOptionsBaseDefaults = options => {
+const applyWebpackOptionsBaseDefaults = (options) => {
 	F(options, "context", () => process.cwd());
 	applyInfrastructureLoggingDefaults(options.infrastructureLogging);
 };
@@ -242,7 +242,7 @@ const applyWebpackOptionsDefaults = (options, compilerIndex) => {
 			target === undefined ||
 			(typeof target === "string" && target.startsWith("browserslist")) ||
 			(Array.isArray(target) &&
-				target.some(target => target.startsWith("browserslist"))),
+				target.some((target) => target.startsWith("browserslist"))),
 		outputModule:
 			/** @type {NonNullable<ExperimentsNormalized["outputModule"]>} */
 			(options.experiments.outputModule),
@@ -265,6 +265,9 @@ const applyWebpackOptionsDefaults = (options, compilerIndex) => {
 		css:
 			/** @type {NonNullable<ExperimentsNormalized["css"]>} */
 			(options.experiments.css),
+		deferImport:
+			/** @type {NonNullable<ExperimentsNormalized["deferImport"]>} */
+			(options.experiments.deferImport),
 		futureDefaults,
 		isNode: targetProperties && targetProperties.node === true,
 		uniqueName: /** @type {string} */ (options.output.uniqueName),
@@ -384,6 +387,7 @@ const applyExperimentsDefaults = (
 	D(experiments, "lazyCompilation", undefined);
 	D(experiments, "buildHttp", undefined);
 	D(experiments, "cacheUnaffected", experiments.futureDefaults);
+	D(experiments, "deferImport", false);
 	F(experiments, "css", () => (experiments.futureDefaults ? true : undefined));
 
 	// TODO webpack 6: remove this. topLevelAwait should be enabled by default
@@ -561,12 +565,13 @@ const applySnapshotDefaults = (snapshot, { production, futureDefaults }) => {
  * @param {JavascriptParserOptions} parserOptions parser options
  * @param {object} options options
  * @param {boolean} options.futureDefaults is future defaults enabled
+ * @param {boolean} options.deferImport is defer import enabled
  * @param {boolean} options.isNode is node target platform
  * @returns {void}
  */
 const applyJavascriptParserOptionsDefaults = (
 	parserOptions,
-	{ futureDefaults, isNode }
+	{ futureDefaults, deferImport, isNode }
 ) => {
 	D(parserOptions, "unknownContextRequest", ".");
 	D(parserOptions, "unknownContextRegExp", false);
@@ -587,6 +592,7 @@ const applyJavascriptParserOptionsDefaults = (
 	D(parserOptions, "dynamicImportFetchPriority", false);
 	D(parserOptions, "createRequire", isNode);
 	D(parserOptions, "dynamicUrl", true);
+	D(parserOptions, "deferImport", deferImport);
 	if (futureDefaults) D(parserOptions, "exportsPresence", "error");
 };
 
@@ -594,7 +600,7 @@ const applyJavascriptParserOptionsDefaults = (
  * @param {JsonGeneratorOptions} generatorOptions generator options
  * @returns {void}
  */
-const applyJsonGeneratorOptionsDefaults = generatorOptions => {
+const applyJsonGeneratorOptionsDefaults = (generatorOptions) => {
 	D(generatorOptions, "JSONParse", true);
 };
 
@@ -626,6 +632,7 @@ const applyCssGeneratorOptionsDefaults = (
  * @param {boolean} options.futureDefaults is future defaults enabled
  * @param {string} options.uniqueName the unique name
  * @param {boolean} options.isNode is node target platform
+ * @param {boolean} options.deferImport is defer import enabled
  * @param {TargetProperties | false} options.targetProperties target properties
  * @param {Mode | undefined} options.mode mode
  * @returns {void}
@@ -641,7 +648,8 @@ const applyModuleDefaults = (
 		isNode,
 		uniqueName,
 		targetProperties,
-		mode
+		mode,
+		deferImport
 	}
 ) => {
 	if (cache) {
@@ -652,7 +660,7 @@ const applyModuleDefaults = (
 			 * @param {Module} module module
 			 * @returns {boolean} true, if we want to cache the module
 			 */
-			module => {
+			(module) => {
 				const name = module.nameForCondition();
 				if (!name) {
 					return false;
@@ -699,6 +707,7 @@ const applyModuleDefaults = (
 		(module.parser.javascript),
 		{
 			futureDefaults,
+			deferImport,
 			isNode
 		}
 	);
@@ -964,7 +973,7 @@ const applyOutputDefaults = (
 	 * @param {Library=} library the library option
 	 * @returns {string} a readable library name
 	 */
-	const getLibraryName = library => {
+	const getLibraryName = (library) => {
 		const libraryName =
 			typeof library === "object" &&
 			library &&
@@ -1015,7 +1024,7 @@ const applyOutputDefaults = (
 	 * @param {boolean | undefined} v value
 	 * @returns {boolean} true, when v is truthy or undefined
 	 */
-	const optimistic = v => v || v === undefined;
+	const optimistic = (v) => v || v === undefined;
 	/**
 	 * @param {boolean | undefined} v value
 	 * @param {boolean | undefined} c condition
@@ -1322,7 +1331,7 @@ const applyOutputDefaults = (
 	 * @param {(entryDescription: EntryDescription) => void} fn iterator
 	 * @returns {void}
 	 */
-	const forEachEntry = fn => {
+	const forEachEntry = (fn) => {
 		for (const name of Object.keys(entry)) {
 			fn(/** @type {{[k: string] : EntryDescription}} */ (entry)[name]);
 		}
@@ -1333,7 +1342,7 @@ const applyOutputDefaults = (
 		if (output.library) {
 			enabledLibraryTypes.push(output.library.type);
 		}
-		forEachEntry(desc => {
+		forEachEntry((desc) => {
 			if (desc.library) {
 				enabledLibraryTypes.push(desc.library.type);
 			}
@@ -1349,7 +1358,7 @@ const applyOutputDefaults = (
 		if (output.workerChunkLoading) {
 			enabledChunkLoadingTypes.add(output.workerChunkLoading);
 		}
-		forEachEntry(desc => {
+		forEachEntry((desc) => {
 			if (desc.chunkLoading) {
 				enabledChunkLoadingTypes.add(desc.chunkLoading);
 			}
@@ -1365,7 +1374,7 @@ const applyOutputDefaults = (
 		if (output.workerWasmLoading) {
 			enabledWasmLoadingTypes.add(output.workerWasmLoading);
 		}
-		forEachEntry(desc => {
+		forEachEntry((desc) => {
 			if (desc.wasmLoading) {
 				enabledWasmLoadingTypes.add(desc.wasmLoading);
 			}
@@ -1553,7 +1562,7 @@ const applyOptimizationDefaults = (
 	D(optimization, "minimize", production);
 	A(optimization, "minimizer", () => [
 		{
-			apply: compiler => {
+			apply: (compiler) => {
 				// Lazy load the Terser plugin
 				const TerserPlugin = require("terser-webpack-plugin");
 
@@ -1735,7 +1744,7 @@ const getResolveLoaderDefaults = ({ cache }) => {
  * @param {InfrastructureLogging} infrastructureLogging options
  * @returns {void}
  */
-const applyInfrastructureLoggingDefaults = infrastructureLogging => {
+const applyInfrastructureLoggingDefaults = (infrastructureLogging) => {
 	F(infrastructureLogging, "stream", () => process.stderr);
 	const tty =
 		/** @type {NonNullable<InfrastructureLogging["stream"]>} */