webpack 5.97.1 → 5.104.1

package/lib/container/ContainerEntryModuleFactory.js

@@ -8,14 +8,14 @@
 const ModuleFactory = require("../ModuleFactory");
 const ContainerEntryModule = require("./ContainerEntryModule");
 
+/** @typedef {import("../ModuleFactory").ModuleFactoryCallback} ModuleFactoryCallback */
 /** @typedef {import("../ModuleFactory").ModuleFactoryCreateData} ModuleFactoryCreateData */
-/** @typedef {import("../ModuleFactory").ModuleFactoryResult} ModuleFactoryResult */
 /** @typedef {import("./ContainerEntryDependency")} ContainerEntryDependency */
 
 module.exports = class ContainerEntryModuleFactory extends ModuleFactory {
 	/**
 	 * @param {ModuleFactoryCreateData} data data object
-	 * @param {function((Error | null)=, ModuleFactoryResult=): void} callback callback
+	 * @param {ModuleFactoryCallback} callback callback
 	 * @returns {void}
 	 */
 	create({ dependencies: [dependency] }, callback) {

package/lib/container/ContainerPlugin.js

@@ -14,7 +14,6 @@ const { parseOptions } = require("./options");
 
 /** @typedef {import("../../declarations/plugins/container/ContainerPlugin").ContainerPluginOptions} ContainerPluginOptions */
 /** @typedef {import("../Compiler")} Compiler */
-/** @typedef {import("./ContainerEntryModule").ExposeOptions} ExposeOptions */
 /** @typedef {import("./ContainerEntryModule").ExposesList} ExposesList */
 
 const getModuleFederationPlugin = memoize(() =>
@@ -22,7 +21,7 @@ const getModuleFederationPlugin = memoize(() =>
 );
 
 const validate = createSchemaValidation(
-	require("../../schemas/plugins/container/ContainerPlugin.check.js"),
+	require("../../schemas/plugins/container/ContainerPlugin.check"),
 	() => require("../../schemas/plugins/container/ContainerPlugin.json"),
 	{
 		name: "Container Plugin",
@@ -51,11 +50,11 @@ class ContainerPlugin {
 			exposes: /** @type {ExposesList} */ (
 				parseOptions(
 					options.exposes,
-					item => ({
+					(item) => ({
 						import: Array.isArray(item) ? item : [item],
 						name: undefined
 					}),
-					item => ({
+					(item) => ({
 						import: Array.isArray(item.import) ? item.import : [item.import],
 						name: item.name || undefined
 					})
@@ -83,7 +82,7 @@ class ContainerPlugin {
 			const dep = new ContainerEntryDependency(name, exposes, shareScope);
 			dep.loc = { name };
 			compilation.addEntry(
-				/** @type {string} */ (compilation.options.context),
+				compilation.options.context,
 				dep,
 				{
 					name,
@@ -91,7 +90,7 @@ class ContainerPlugin {
 					runtime,
 					library
 				},
-				error => {
+				(error) => {
 					if (error) return callback(error);
 					hooks.addContainerEntryDependency.call(dep);
 					callback();

package/lib/container/ContainerReferencePlugin.js

@@ -17,11 +17,10 @@ const RemoteToExternalDependency = require("./RemoteToExternalDependency");
 const { parseOptions } = require("./options");
 
 /** @typedef {import("../../declarations/plugins/container/ContainerReferencePlugin").ContainerReferencePluginOptions} ContainerReferencePluginOptions */
-/** @typedef {import("../../declarations/plugins/container/ContainerReferencePlugin").RemotesConfig} RemotesConfig */
 /** @typedef {import("../Compiler")} Compiler */
 
 const validate = createSchemaValidation(
-	require("../../schemas/plugins/container/ContainerReferencePlugin.check.js"),
+	require("../../schemas/plugins/container/ContainerReferencePlugin.check"),
 	() =>
 		require("../../schemas/plugins/container/ContainerReferencePlugin.json"),
 	{
@@ -31,6 +30,7 @@ const validate = createSchemaValidation(
 );
 
 const slashCode = "/".charCodeAt(0);
+const PLUGIN_NAME = "ContainerReferencePlugin";
 
 class ContainerReferencePlugin {
 	/**
@@ -42,11 +42,11 @@ class ContainerReferencePlugin {
 		this._remoteType = options.remoteType;
 		this._remotes = parseOptions(
 			options.remotes,
-			item => ({
+			(item) => ({
 				external: Array.isArray(item) ? item : [item],
 				shareScope: options.shareScope || "default"
 			}),
-			item => ({
+			(item) => ({
 				external: Array.isArray(item.external)
 					? item.external
 					: [item.external],
@@ -79,7 +79,7 @@ class ContainerReferencePlugin {
 		new ExternalsPlugin(remoteType, remoteExternals).apply(compiler);
 
 		compiler.hooks.compilation.tap(
-			"ContainerReferencePlugin",
+			PLUGIN_NAME,
 			(compilation, { normalModuleFactory }) => {
 				compilation.dependencyFactories.set(
 					RemoteToExternalDependency,
@@ -96,37 +96,34 @@ class ContainerReferencePlugin {
 					new FallbackModuleFactory()
 				);
 
-				normalModuleFactory.hooks.factorize.tap(
-					"ContainerReferencePlugin",
-					data => {
-						if (!data.request.includes("!")) {
-							for (const [key, config] of remotes) {
-								if (
-									data.request.startsWith(`${key}`) &&
-									(data.request.length === key.length ||
-										data.request.charCodeAt(key.length) === slashCode)
-								) {
-									return new RemoteModule(
-										data.request,
-										config.external.map((external, i) =>
-											external.startsWith("internal ")
-												? external.slice(9)
-												: `webpack/container/reference/${key}${
-														i ? `/fallback-${i}` : ""
-													}`
-										),
-										`.${data.request.slice(key.length)}`,
-										config.shareScope
-									);
-								}
+				normalModuleFactory.hooks.factorize.tap(PLUGIN_NAME, (data) => {
+					if (!data.request.includes("!")) {
+						for (const [key, config] of remotes) {
+							if (
+								data.request.startsWith(`${key}`) &&
+								(data.request.length === key.length ||
+									data.request.charCodeAt(key.length) === slashCode)
+							) {
+								return new RemoteModule(
+									data.request,
+									config.external.map((external, i) =>
+										external.startsWith("internal ")
+											? external.slice(9)
+											: `webpack/container/reference/${key}${
+													i ? `/fallback-${i}` : ""
+												}`
+									),
+									`.${data.request.slice(key.length)}`,
+									config.shareScope
+								);
 							}
 						}
 					}
-				);
+				});
 
 				compilation.hooks.runtimeRequirementInTree
 					.for(RuntimeGlobals.ensureChunkHandlers)
-					.tap("ContainerReferencePlugin", (chunk, set) => {
+					.tap(PLUGIN_NAME, (chunk, set) => {
 						set.add(RuntimeGlobals.module);
 						set.add(RuntimeGlobals.moduleFactoriesAddOnly);
 						set.add(RuntimeGlobals.hasOwnProperty);

package/lib/container/FallbackDependency.js

@@ -8,12 +8,13 @@
 const Dependency = require("../Dependency");
 const makeSerializable = require("../util/makeSerializable");
 
+/** @typedef {import("./RemoteModule").ExternalRequests} ExternalRequests */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 
 class FallbackDependency extends Dependency {
 	/**
-	 * @param {string[]} requests requests
+	 * @param {ExternalRequests} requests requests
 	 */
 	constructor(requests) {
 		super();

package/lib/container/FallbackModule.js

@@ -7,36 +7,40 @@
 
 const { RawSource } = require("webpack-sources");
 const Module = require("../Module");
-const { JS_TYPES } = require("../ModuleSourceTypesConstants");
+const {
+	JAVASCRIPT_TYPE,
+	JAVASCRIPT_TYPES
+} = require("../ModuleSourceTypeConstants");
 const { WEBPACK_MODULE_TYPE_FALLBACK } = require("../ModuleTypeConstants");
 const RuntimeGlobals = require("../RuntimeGlobals");
 const Template = require("../Template");
 const makeSerializable = require("../util/makeSerializable");
 const FallbackItemDependency = require("./FallbackItemDependency");
 
-/** @typedef {import("../../declarations/WebpackOptions").WebpackOptionsNormalized} WebpackOptions */
+/** @typedef {import("../config/defaults").WebpackOptionsNormalizedWithDefaults} WebpackOptions */
 /** @typedef {import("../Chunk")} Chunk */
-/** @typedef {import("../ChunkGraph")} ChunkGraph */
-/** @typedef {import("../ChunkGroup")} ChunkGroup */
 /** @typedef {import("../Compilation")} Compilation */
+/** @typedef {import("../Module").BuildCallback} BuildCallback */
 /** @typedef {import("../Module").CodeGenerationContext} CodeGenerationContext */
 /** @typedef {import("../Module").CodeGenerationResult} CodeGenerationResult */
 /** @typedef {import("../Module").LibIdentOptions} LibIdentOptions */
+/** @typedef {import("../Module").LibIdent} LibIdent */
+/** @typedef {import("../Module").NameForCondition} NameForCondition */
+/** @typedef {import("../Module").NeedBuildCallback} NeedBuildCallback */
 /** @typedef {import("../Module").NeedBuildContext} NeedBuildContext */
 /** @typedef {import("../Module").SourceTypes} SourceTypes */
 /** @typedef {import("../RequestShortener")} RequestShortener */
 /** @typedef {import("../ResolverFactory").ResolverWithOptions} ResolverWithOptions */
-/** @typedef {import("../WebpackError")} WebpackError */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
-/** @typedef {import("../util/Hash")} Hash */
 /** @typedef {import("../util/fs").InputFileSystem} InputFileSystem */
+/** @typedef {import("./RemoteModule").ExternalRequests} ExternalRequests */
 
 const RUNTIME_REQUIREMENTS = new Set([RuntimeGlobals.module]);
 
 class FallbackModule extends Module {
 	/**
-	 * @param {string[]} requests list of requests to choose one
+	 * @param {ExternalRequests} requests list of requests to choose one
 	 */
 	constructor(requests) {
 		super(WEBPACK_MODULE_TYPE_FALLBACK);
@@ -61,7 +65,7 @@ class FallbackModule extends Module {
 
 	/**
 	 * @param {LibIdentOptions} options options
-	 * @returns {string | null} an identifier for library inclusion
+	 * @returns {LibIdent | null} an identifier for library inclusion
 	 */
 	libIdent(options) {
 		return `${this.layer ? `(${this.layer})/` : ""}webpack/container/fallback/${
@@ -80,7 +84,7 @@ class FallbackModule extends Module {
 
 	/**
 	 * @param {NeedBuildContext} context context info
-	 * @param {function((WebpackError | null)=, boolean=): void} callback callback function, returns true, if the module needs a rebuild
+	 * @param {NeedBuildCallback} callback callback function, returns true, if the module needs a rebuild
 	 * @returns {void}
 	 */
 	needBuild(context, callback) {
@@ -92,7 +96,7 @@ class FallbackModule extends Module {
 	 * @param {Compilation} compilation the compilation
 	 * @param {ResolverWithOptions} resolver the resolver
 	 * @param {InputFileSystem} fs the file system
-	 * @param {function(WebpackError=): void} callback callback function
+	 * @param {BuildCallback} callback callback function
 	 * @returns {void}
 	 */
 	build(options, compilation, resolver, fs, callback) {
@@ -102,8 +106,9 @@ class FallbackModule extends Module {
 		};
 
 		this.clearDependenciesAndBlocks();
-		for (const request of this.requests)
+		for (const request of this.requests) {
 			this.addDependency(new FallbackItemDependency(request));
+		}
 
 		callback();
 	}
@@ -120,7 +125,7 @@ class FallbackModule extends Module {
 	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
-		return JS_TYPES;
+		return JAVASCRIPT_TYPES;
 	}
 
 	/**
@@ -128,7 +133,7 @@ class FallbackModule extends Module {
 	 * @returns {CodeGenerationResult} result
 	 */
 	codeGeneration({ runtimeTemplate, moduleGraph, chunkGraph }) {
-		const ids = this.dependencies.map(dep =>
+		const ids = this.dependencies.map((dep) =>
 			chunkGraph.getModuleId(/** @type {Module} */ (moduleGraph.getModule(dep)))
 		);
 		const code = Template.asString([
@@ -154,7 +159,7 @@ class FallbackModule extends Module {
 			"module.exports = loop();"
 		]);
 		const sources = new Map();
-		sources.set("javascript", new RawSource(code));
+		sources.set(JAVASCRIPT_TYPE, new RawSource(code));
 		return { sources, runtimeRequirements: RUNTIME_REQUIREMENTS };
 	}
 

package/lib/container/FallbackModuleFactory.js

@@ -8,14 +8,14 @@
 const ModuleFactory = require("../ModuleFactory");
 const FallbackModule = require("./FallbackModule");
 
+/** @typedef {import("../ModuleFactory").ModuleFactoryCallback} ModuleFactoryCallback */
 /** @typedef {import("../ModuleFactory").ModuleFactoryCreateData} ModuleFactoryCreateData */
-/** @typedef {import("../ModuleFactory").ModuleFactoryResult} ModuleFactoryResult */
 /** @typedef {import("./FallbackDependency")} FallbackDependency */
 
 module.exports = class FallbackModuleFactory extends ModuleFactory {
 	/**
 	 * @param {ModuleFactoryCreateData} data data object
-	 * @param {function((Error | null)=, ModuleFactoryResult=): void} callback callback
+	 * @param {ModuleFactoryCallback} callback callback
 	 * @returns {void}
 	 */
 	create({ dependencies: [dependency] }, callback) {

package/lib/container/HoistContainerReferencesPlugin.js

@@ -31,19 +31,19 @@ class HoistContainerReferences {
 	 * @param {Compiler} compiler The webpack compiler instance.
 	 */
 	apply(compiler) {
-		compiler.hooks.thisCompilation.tap(PLUGIN_NAME, compilation => {
+		compiler.hooks.thisCompilation.tap(PLUGIN_NAME, (compilation) => {
 			const hooks =
 				getModuleFederationPlugin().getCompilationHooks(compilation);
 			const depsToTrace = new Set();
 			const entryExternalsToHoist = new Set();
-			hooks.addContainerEntryDependency.tap(PLUGIN_NAME, dep => {
+			hooks.addContainerEntryDependency.tap(PLUGIN_NAME, (dep) => {
 				depsToTrace.add(dep);
 			});
-			hooks.addFederationRuntimeDependency.tap(PLUGIN_NAME, dep => {
+			hooks.addFederationRuntimeDependency.tap(PLUGIN_NAME, (dep) => {
 				depsToTrace.add(dep);
 			});
 
-			compilation.hooks.addEntry.tap(PLUGIN_NAME, entryDep => {
+			compilation.hooks.addEntry.tap(PLUGIN_NAME, (entryDep) => {
 				if (entryDep.type === "entry") {
 					entryExternalsToHoist.add(entryDep);
 				}
@@ -56,7 +56,7 @@ class HoistContainerReferences {
 					// advanced stage is where SplitChunksPlugin runs.
 					stage: STAGE_ADVANCED + 1
 				},
-				chunks => {
+				(_chunks) => {
 					this.hoistModulesInChunks(
 						compilation,
 						depsToTrace,
@@ -92,7 +92,7 @@ class HoistContainerReferences {
 			const runtimes = new Set();
 
 			for (const runtimeSpec of containerRuntimes) {
-				forEachRuntime(runtimeSpec, runtimeKey => {
+				forEachRuntime(runtimeSpec, (runtimeKey) => {
 					if (runtimeKey) {
 						runtimes.add(runtimeKey);
 					}
@@ -139,7 +139,7 @@ class HoistContainerReferences {
 			const runtimes = new Set();
 
 			for (const runtimeSpec of containerRuntimes) {
-				forEachRuntime(runtimeSpec, runtimeKey => {
+				forEachRuntime(runtimeSpec, (runtimeKey) => {
 					if (runtimeKey) {
 						runtimes.add(runtimeKey);
 					}

package/lib/container/ModuleFederationPlugin.js

@@ -6,7 +6,7 @@
 "use strict";
 
 const { SyncHook } = require("tapable");
-const isValidExternalsType = require("../../schemas/plugins/container/ExternalsType.check.js");
+const isValidExternalsType = require("../../schemas/plugins/container/ExternalsType.check");
 const Compilation = require("../Compilation");
 const SharePlugin = require("../sharing/SharePlugin");
 const createSchemaValidation = require("../util/create-schema-validation");
@@ -16,7 +16,6 @@ const HoistContainerReferences = require("./HoistContainerReferencesPlugin");
 
 /** @typedef {import("../../declarations/plugins/container/ModuleFederationPlugin").ExternalsType} ExternalsType */
 /** @typedef {import("../../declarations/plugins/container/ModuleFederationPlugin").ModuleFederationPluginOptions} ModuleFederationPluginOptions */
-/** @typedef {import("../../declarations/plugins/container/ModuleFederationPlugin").Shared} Shared */
 /** @typedef {import("../Compiler")} Compiler */
 /** @typedef {import("../Dependency")} Dependency */
 
@@ -27,7 +26,7 @@ const HoistContainerReferences = require("./HoistContainerReferencesPlugin");
  */
 
 const validate = createSchemaValidation(
-	require("../../schemas/plugins/container/ModuleFederationPlugin.check.js"),
+	require("../../schemas/plugins/container/ModuleFederationPlugin.check"),
 	() => require("../../schemas/plugins/container/ModuleFederationPlugin.json"),
 	{
 		name: "Module Federation Plugin",
@@ -37,6 +36,7 @@ const validate = createSchemaValidation(
 
 /** @type {WeakMap<Compilation, CompilationHooks>} */
 const compilationHooksMap = new WeakMap();
+const PLUGIN_NAME = "ModuleFederationPlugin";
 
 class ModuleFederationPlugin {
 	/**
@@ -89,7 +89,7 @@ class ModuleFederationPlugin {
 		) {
 			compiler.options.output.enabledLibraryTypes.push(library.type);
 		}
-		compiler.hooks.afterPlugins.tap("ModuleFederationPlugin", () => {
+		compiler.hooks.afterPlugins.tap(PLUGIN_NAME, () => {
 			if (
 				options.exposes &&
 				(Array.isArray(options.exposes)

package/lib/container/RemoteModule.js

@@ -7,38 +7,38 @@
 
 const { RawSource } = require("webpack-sources");
 const Module = require("../Module");
-const {
-	REMOTE_AND_SHARE_INIT_TYPES
-} = require("../ModuleSourceTypesConstants");
+const { REMOTE_AND_SHARE_INIT_TYPES } = require("../ModuleSourceTypeConstants");
 const { WEBPACK_MODULE_TYPE_REMOTE } = require("../ModuleTypeConstants");
 const RuntimeGlobals = require("../RuntimeGlobals");
 const makeSerializable = require("../util/makeSerializable");
 const FallbackDependency = require("./FallbackDependency");
 const RemoteToExternalDependency = require("./RemoteToExternalDependency");
 
-/** @typedef {import("../../declarations/WebpackOptions").WebpackOptionsNormalized} WebpackOptions */
-/** @typedef {import("../ChunkGraph")} ChunkGraph */
-/** @typedef {import("../ChunkGroup")} ChunkGroup */
+/** @typedef {import("../config/defaults").WebpackOptionsNormalizedWithDefaults} WebpackOptions */
 /** @typedef {import("../Compilation")} Compilation */
+/** @typedef {import("../Module").BuildCallback} BuildCallback */
 /** @typedef {import("../Module").CodeGenerationContext} CodeGenerationContext */
 /** @typedef {import("../Module").CodeGenerationResult} CodeGenerationResult */
 /** @typedef {import("../Module").LibIdentOptions} LibIdentOptions */
+/** @typedef {import("../Module").LibIdent} LibIdent */
+/** @typedef {import("../Module").NameForCondition} NameForCondition */
+/** @typedef {import("../Module").NeedBuildCallback} NeedBuildCallback */
 /** @typedef {import("../Module").NeedBuildContext} NeedBuildContext */
 /** @typedef {import("../Module").SourceTypes} SourceTypes */
 /** @typedef {import("../RequestShortener")} RequestShortener */
 /** @typedef {import("../ResolverFactory").ResolverWithOptions} ResolverWithOptions */
-/** @typedef {import("../WebpackError")} WebpackError */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
-/** @typedef {import("../util/Hash")} Hash */
 /** @typedef {import("../util/fs").InputFileSystem} InputFileSystem */
 
 const RUNTIME_REQUIREMENTS = new Set([RuntimeGlobals.module]);
 
+/** @typedef {string[]} ExternalRequests */
+
 class RemoteModule extends Module {
 	/**
 	 * @param {string} request request string
-	 * @param {string[]} externalRequests list of external requests to containers
+	 * @param {ExternalRequests} externalRequests list of external requests to containers
 	 * @param {string} internalRequest name of exposed module in container
 	 * @param {string} shareScope the used share scope name
 	 */
@@ -70,7 +70,7 @@ class RemoteModule extends Module {
 
 	/**
 	 * @param {LibIdentOptions} options options
-	 * @returns {string | null} an identifier for library inclusion
+	 * @returns {LibIdent | null} an identifier for library inclusion
 	 */
 	libIdent(options) {
 		return `${this.layer ? `(${this.layer})/` : ""}webpack/container/remote/${
@@ -80,7 +80,7 @@ class RemoteModule extends Module {
 
 	/**
 	 * @param {NeedBuildContext} context context info
-	 * @param {function((WebpackError | null)=, boolean=): void} callback callback function, returns true, if the module needs a rebuild
+	 * @param {NeedBuildCallback} callback callback function, returns true, if the module needs a rebuild
 	 * @returns {void}
 	 */
 	needBuild(context, callback) {
@@ -92,7 +92,7 @@ class RemoteModule extends Module {
 	 * @param {Compilation} compilation the compilation
 	 * @param {ResolverWithOptions} resolver the resolver
 	 * @param {InputFileSystem} fs the file system
-	 * @param {function(WebpackError=): void} callback callback function
+	 * @param {BuildCallback} callback callback function
 	 * @returns {void}
 	 */
 	build(options, compilation, resolver, fs, callback) {
@@ -129,7 +129,7 @@ class RemoteModule extends Module {
 	}
 
 	/**
-	 * @returns {string | null} absolute path which should be used for condition matching (usually the resource path)
+	 * @returns {NameForCondition | null} absolute path which should be used for condition matching (usually the resource path)
 	 */
 	nameForCondition() {
 		return this.request;
@@ -139,7 +139,7 @@ class RemoteModule extends Module {
 	 * @param {CodeGenerationContext} context context for code generation
 	 * @returns {CodeGenerationResult} result
 	 */
-	codeGeneration({ runtimeTemplate, moduleGraph, chunkGraph }) {
+	codeGeneration({ moduleGraph, chunkGraph }) {
 		const module = moduleGraph.getModule(this.dependencies[0]);
 		const id = module && chunkGraph.getModuleId(module);
 		const sources = new Map();

package/lib/container/RemoteRuntimeModule.js

@@ -28,9 +28,9 @@ class RemoteRuntimeModule extends RuntimeModule {
 		const compilation = /** @type {Compilation} */ (this.compilation);
 		const chunkGraph = /** @type {ChunkGraph} */ (this.chunkGraph);
 		const { runtimeTemplate, moduleGraph } = compilation;
-		/** @type {Record<ChunkId, (string | number)[]>} */
+		/** @type {Record<ChunkId, ModuleId[]>} */
 		const chunkToRemotesMapping = {};
-		/** @type {Record<ModuleId, [string, string, string | number | null]>} */
+		/** @type {Record<ModuleId, [string, string, ModuleId]>} */
 		const idToExternalAndNameMapping = {};
 		for (const chunk of /** @type {Chunk} */ (
 			this.chunk

package/lib/container/options.js

@@ -19,16 +19,16 @@
  * @template T
  * @template N
  * @param {ContainerOptionsFormat<T>} options options passed by the user
- * @param {function(string | string[], string) : N} normalizeSimple normalize a simple item
- * @param {function(T, string) : N} normalizeOptions normalize a complex item
- * @param {function(string, N): void} fn processing function
+ * @param {(item: string | string[], itemOrKey: string) => N} normalizeSimple normalize a simple item
+ * @param {(value: T, key: string) => N} normalizeOptions normalize a complex item
+ * @param {(item: string, normalized: N) => void} fn processing function
  * @returns {void}
  */
 const process = (options, normalizeSimple, normalizeOptions, fn) => {
 	/**
 	 * @param {(string | Item<T>)[]} items items
 	 */
-	const array = items => {
+	const array = (items) => {
 		for (const item of items) {
 			if (typeof item === "string") {
 				fn(item, normalizeSimple(item, item));
@@ -42,7 +42,7 @@ const process = (options, normalizeSimple, normalizeOptions, fn) => {
 	/**
 	 * @param {Item<T>} obj an object
 	 */
-	const object = obj => {
+	const object = (obj) => {
 		for (const [key, value] of Object.entries(obj)) {
 			if (typeof value === "string" || Array.isArray(value)) {
 				fn(key, normalizeSimple(value, key));
@@ -66,8 +66,8 @@ const process = (options, normalizeSimple, normalizeOptions, fn) => {
  * @template T
  * @template R
  * @param {ContainerOptionsFormat<T>} options options passed by the user
- * @param {function(string | string[], string) : R} normalizeSimple normalize a simple item
- * @param {function(T, string) : R} normalizeOptions normalize a complex item
+ * @param {(item: string | string[], itemOrKey: string) => R} normalizeSimple normalize a simple item
+ * @param {(value: T, key: string) => R} normalizeOptions normalize a complex item
  * @returns {[string, R][]} parsed options
  */
 const parseOptions = (options, normalizeSimple, normalizeOptions) => {
@@ -90,8 +90,8 @@ const scope = (scope, options) => {
 	const obj = {};
 	process(
 		options,
-		item => /** @type {string | string[] | T} */ (item),
-		item => /** @type {string | string[] | T} */ (item),
+		(item) => /** @type {string | string[] | T} */ (item),
+		(item) => /** @type {string | string[] | T} */ (item),
 		(key, value) => {
 			obj[
 				key.startsWith("./") ? `${scope}${key.slice(1)}` : `${scope}/${key}`