webpack 5.106.1 → 5.107.0

package/lib/library/ExportPropertyLibraryPlugin.js

@@ -21,25 +21,30 @@ const AbstractLibraryPlugin = require("./AbstractLibraryPlugin");
 /** @typedef {import("../Module").RuntimeRequirements} RuntimeRequirements */
 /** @typedef {import("../javascript/JavascriptModulesPlugin").StartupRenderContext} StartupRenderContext */
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("./AbstractLibraryPlugin").LibraryContext<T>} LibraryContext<T>
  */
 
 /**
+ * Defines the export property library plugin parsed type used by this module.
  * @typedef {object} ExportPropertyLibraryPluginParsed
  * @property {LibraryExport=} export
  */
 
 /**
+ * Defines the export property library plugin options type used by this module.
  * @typedef {object} ExportPropertyLibraryPluginOptions
  * @property {LibraryType} type
  */
 /**
+ * Represents the export property library plugin runtime component.
  * @typedef {ExportPropertyLibraryPluginParsed} T
  * @extends {AbstractLibraryPlugin<ExportPropertyLibraryPluginParsed>}
  */
 class ExportPropertyLibraryPlugin extends AbstractLibraryPlugin {
 	/**
+	 * Creates an instance of ExportPropertyLibraryPlugin.
 	 * @param {ExportPropertyLibraryPluginOptions} options options
 	 */
 	constructor({ type }) {
@@ -50,6 +55,7 @@ class ExportPropertyLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Returns preprocess as needed by overriding.
 	 * @param {LibraryOptions} library normalized library option
 	 * @returns {T} preprocess as needed by overriding
 	 */
@@ -60,6 +66,7 @@ class ExportPropertyLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Finish entry module.
 	 * @param {Module} module the exporting entry module
 	 * @param {string} entryName the name of the entrypoint
 	 * @param {LibraryContext<T>} libraryContext context
@@ -86,6 +93,7 @@ class ExportPropertyLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Processes the provided chunk.
 	 * @param {Chunk} chunk the chunk
 	 * @param {RuntimeRequirements} set runtime requirements
 	 * @param {LibraryContext<T>} libraryContext context
@@ -96,6 +104,7 @@ class ExportPropertyLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Renders source with library export.
 	 * @param {Source} source source
 	 * @param {Module} module module
 	 * @param {StartupRenderContext} renderContext render context

package/lib/{FalseIIFEUmdWarning.js → library/FalseIIFEUmdWarning.js}

@@ -5,7 +5,7 @@
 
 "use strict";
 
-const WebpackError = require("./WebpackError");
+const WebpackError = require("../errors/WebpackError");
 
 class FalseIIFEUmdWarning extends WebpackError {
 	constructor() {

package/lib/library/JsonpLibraryPlugin.js

@@ -17,26 +17,31 @@ const AbstractLibraryPlugin = require("./AbstractLibraryPlugin");
 /** @typedef {import("../util/Hash")} Hash */
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("./AbstractLibraryPlugin").LibraryContext<T>} LibraryContext<T>
  */
 
 /**
+ * Defines the jsonp library plugin options type used by this module.
  * @typedef {object} JsonpLibraryPluginOptions
  * @property {LibraryType} type
  */
 
 /**
+ * Defines the jsonp library plugin parsed type used by this module.
  * @typedef {object} JsonpLibraryPluginParsed
  * @property {string} name
  */
 
 /**
+ * Represents the jsonp library plugin runtime component.
  * @typedef {JsonpLibraryPluginParsed} T
  * @extends {AbstractLibraryPlugin<JsonpLibraryPluginParsed>}
  */
 class JsonpLibraryPlugin extends AbstractLibraryPlugin {
 	/**
+	 * Creates an instance of JsonpLibraryPlugin.
 	 * @param {JsonpLibraryPluginOptions} options the plugin options
 	 */
 	constructor(options) {
@@ -47,6 +52,7 @@ class JsonpLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Returns preprocess as needed by overriding.
 	 * @param {LibraryOptions} library normalized library option
 	 * @returns {T} preprocess as needed by overriding
 	 */
@@ -64,6 +70,7 @@ class JsonpLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Returns source with library export.
 	 * @param {Source} source source
 	 * @param {RenderContext} renderContext render context
 	 * @param {LibraryContext<T>} libraryContext context
@@ -77,6 +84,7 @@ class JsonpLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Processes the provided chunk.
 	 * @param {Chunk} chunk the chunk
 	 * @param {Hash} hash hash
 	 * @param {ChunkHashContext} chunkHashContext chunk hash context

package/lib/library/ModuleLibraryPlugin.js

@@ -11,6 +11,7 @@ const ExternalModule = require("../ExternalModule");
 const RuntimeGlobals = require("../RuntimeGlobals");
 const Template = require("../Template");
 const HarmonyExportImportedSpecifierDependency = require("../dependencies/HarmonyExportImportedSpecifierDependency");
+const JavascriptModulesPlugin = require("../javascript/JavascriptModulesPlugin");
 const ConcatenatedModule = require("../optimize/ConcatenatedModule");
 const { propertyAccess } = require("../util/property");
 const { getEntryRuntime, getRuntimeKey } = require("../util/runtime");
@@ -32,16 +33,19 @@ const AbstractLibraryPlugin = require("./AbstractLibraryPlugin");
 /** @typedef {import("../RuntimeTemplate")} RuntimeTemplate */
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("./AbstractLibraryPlugin").LibraryContext<T>} LibraryContext<T>
  */
 
 /**
+ * Defines the module library plugin options type used by this module.
  * @typedef {object} ModuleLibraryPluginOptions
  * @property {LibraryType} type
  */
 
 /**
+ * Defines the module library plugin parsed type used by this module.
  * @typedef {object} ModuleLibraryPluginParsed
  * @property {string} name
  * @property {LibraryExport=} export
@@ -50,11 +54,13 @@ const AbstractLibraryPlugin = require("./AbstractLibraryPlugin");
 const PLUGIN_NAME = "ModuleLibraryPlugin";
 
 /**
+ * Represents the module library plugin runtime component.
  * @typedef {ModuleLibraryPluginParsed} T
  * @extends {AbstractLibraryPlugin<ModuleLibraryPluginParsed>}
  */
 class ModuleLibraryPlugin extends AbstractLibraryPlugin {
 	/**
+	 * Creates an instance of ModuleLibraryPlugin.
 	 * @param {ModuleLibraryPluginOptions} options the plugin options
 	 */
 	constructor(options) {
@@ -65,7 +71,7 @@ class ModuleLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -75,6 +81,8 @@ class ModuleLibraryPlugin extends AbstractLibraryPlugin {
 		compiler.hooks.thisCompilation.tap(PLUGIN_NAME, (compilation) => {
 			const { onDemandExportsGeneration } =
 				ConcatenatedModule.getCompilationHooks(compilation);
+			const javascriptHooks =
+				JavascriptModulesPlugin.getCompilationHooks(compilation);
 			onDemandExportsGeneration.tap(
 				PLUGIN_NAME,
 				(module, runtimes, source, finalName) => {
@@ -100,10 +108,82 @@ class ModuleLibraryPlugin extends AbstractLibraryPlugin {
 					return true;
 				}
 			);
+
+			// `ModuleLibraryPlugin` stashes the on-demand exports source via
+			// `onDemandExportsGeneration` and only re-emits it when the
+			// module is wrapped in an IIFE/factory. When a single concatenated
+			// entry is inlined directly, the stashed source — and the
+			// `definePropertyGetters` / `requireScope` runtime helpers it
+			// pulled in — never make it into the output. Drop those helpers
+			// from the chunk's set in that simple shape so the bundle stays
+			// clean.
+			compilation.hooks.additionalChunkRuntimeRequirements.tap(
+				PLUGIN_NAME,
+				(chunk, set, { chunkGraph, codeGenerationResults }) => {
+					if (!set.has(RuntimeGlobals.definePropertyGetters)) return;
+
+					// Only handle the simple "single concatenated entry"
+					// shape. Anything else (additional modules, multiple
+					// entries, sibling runtime chunks, or chunk-level
+					// requirements that disable inline startup) forces the
+					// module through factory/IIFE rendering, which re-emits
+					// the source.
+					if (chunkGraph.getNumberOfChunkModules(chunk) !== 1) return;
+					if (chunkGraph.getNumberOfEntryModules(chunk) !== 1) return;
+					if (chunkGraph.hasChunkEntryDependentChunks(chunk)) return;
+					if (
+						set.has(RuntimeGlobals.moduleFactories) ||
+						set.has(RuntimeGlobals.moduleCache) ||
+						set.has(RuntimeGlobals.interceptModuleExecution) ||
+						set.has(RuntimeGlobals.module) ||
+						set.has(RuntimeGlobals.thisAsExports)
+					) {
+						return;
+					}
+					// Anyone tapping `inlineInRuntimeBailout` may force factory
+					// rendering at render time, so conservatively bail out.
+					if (javascriptHooks.inlineInRuntimeBailout.isUsed()) return;
+
+					const [module] = chunkGraph.getChunkEntryModulesIterable(chunk);
+					const exportsSourceByRuntime =
+						module.buildMeta && module.buildMeta.exportsSourceByRuntime;
+					if (
+						!exportsSourceByRuntime ||
+						!exportsSourceByRuntime.has(getRuntimeKey(chunk.runtime))
+					) {
+						return;
+					}
+					// If the generated source references any
+					// `__webpack_require__.<helper>` (the on-demand `.d(...)`
+					// is stashed, but `.r(__webpack_exports__)` from the ESM
+					// compat flag, namespace objects, deferred externals, ...
+					// stay in the result) the helpers and the require scope
+					// they live in are still needed. The dot in the substring
+					// avoids matching the bare `"__webpack_require__"` string
+					// literals that some test fixtures include.
+					const codeGenResult = codeGenerationResults.get(
+						module,
+						chunk.runtime
+					);
+					const jsSource =
+						codeGenResult && codeGenResult.sources.get("javascript");
+					if (
+						jsSource &&
+						String(jsSource.source()).includes(`${RuntimeGlobals.require}.`)
+					) {
+						return;
+					}
+
+					set.delete(RuntimeGlobals.definePropertyGetters);
+					set.delete(RuntimeGlobals.exports);
+					set.delete(RuntimeGlobals.requireScope);
+				}
+			);
 		});
 	}
 
 	/**
+	 * Finish entry module.
 	 * @param {Module} module the exporting entry module
 	 * @param {string} entryName the name of the entrypoint
 	 * @param {LibraryContext<T>} libraryContext context
@@ -140,6 +220,7 @@ class ModuleLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Returns preprocess as needed by overriding.
 	 * @param {LibraryOptions} library normalized library option
 	 * @returns {T} preprocess as needed by overriding
 	 */
@@ -158,6 +239,7 @@ class ModuleLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Analyze unknown provided exports.
 	 * @param {Source} source source
 	 * @param {Module} module module
 	 * @param {ModuleGraph} moduleGraph moduleGraph
@@ -181,6 +263,7 @@ class ModuleLibraryPlugin extends AbstractLibraryPlugin {
 		const unknownProvidedExports = new Map();
 
 		/**
+		 * Resolves dynamic star reexport.
 		 * @param {Module} module the module
 		 * @param {boolean} isDynamicReexport if module is dynamic reexported
 		 */
@@ -246,6 +329,7 @@ class ModuleLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Renders source with library export.
 	 * @param {Source} source source
 	 * @param {Module} module module
 	 * @param {StartupRenderContext} renderContext render context
@@ -431,6 +515,7 @@ class ModuleLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Renders module content.
 	 * @param {Source} source source
 	 * @param {Module} module module
 	 * @param {ModuleRenderContext} renderContext render context

package/lib/library/SystemLibraryPlugin.js

@@ -21,26 +21,31 @@ const AbstractLibraryPlugin = require("./AbstractLibraryPlugin");
 /** @typedef {import("../javascript/JavascriptModulesPlugin").RenderContext} RenderContext */
 /** @typedef {import("../util/Hash")} Hash */
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("./AbstractLibraryPlugin").LibraryContext<T>} LibraryContext<T>
  */
 
 /**
+ * Defines the system library plugin options type used by this module.
  * @typedef {object} SystemLibraryPluginOptions
  * @property {LibraryType} type
  */
 
 /**
+ * Defines the system library plugin parsed type used by this module.
  * @typedef {object} SystemLibraryPluginParsed
  * @property {string} name
  */
 
 /**
+ * Represents the system library plugin runtime component.
  * @typedef {SystemLibraryPluginParsed} T
  * @extends {AbstractLibraryPlugin<SystemLibraryPluginParsed>}
  */
 class SystemLibraryPlugin extends AbstractLibraryPlugin {
 	/**
+	 * Creates an instance of SystemLibraryPlugin.
 	 * @param {SystemLibraryPluginOptions} options the plugin options
 	 */
 	constructor(options) {
@@ -51,6 +56,7 @@ class SystemLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Returns preprocess as needed by overriding.
 	 * @param {LibraryOptions} library normalized library option
 	 * @returns {T} preprocess as needed by overriding
 	 */
@@ -68,6 +74,7 @@ class SystemLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Returns source with library export.
 	 * @param {Source} source source
 	 * @param {RenderContext} renderContext render context
 	 * @param {LibraryContext<T>} libraryContext context
@@ -239,6 +246,7 @@ class SystemLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Processes the provided chunk.
 	 * @param {Chunk} chunk the chunk
 	 * @param {Hash} hash hash
 	 * @param {ChunkHashContext} chunkHashContext chunk hash context

package/lib/library/UmdLibraryPlugin.js

@@ -20,11 +20,13 @@ const AbstractLibraryPlugin = require("./AbstractLibraryPlugin");
 /** @typedef {import("../ExternalModule").RequestRecord} RequestRecord */
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("./AbstractLibraryPlugin").LibraryContext<T>} LibraryContext<T>
  */
 
 /**
+ * Accessor to object access.
  * @param {string[]} accessor the accessor to convert to path
  * @returns {string} the path
  */
@@ -34,6 +36,7 @@ const accessorToObjectAccess = (accessor) =>
 /** @typedef {string | string[]} Accessor */
 
 /**
+ * Returns the path.
  * @param {string | undefined} base the path prefix
  * @param {Accessor} accessor the accessor
  * @param {string=} joinWith the element separator
@@ -56,12 +59,14 @@ const accessorAccess = (base, accessor, joinWith = ", ") => {
 };
 
 /**
+ * Defines the umd library plugin options type used by this module.
  * @typedef {object} UmdLibraryPluginOptions
  * @property {LibraryType} type
  * @property {boolean=} optionalAmdExternalAsGlobal
  */
 
 /**
+ * Defines the umd library plugin parsed type used by this module.
  * @typedef {object} UmdLibraryPluginParsed
  * @property {string | string[] | undefined} name
  * @property {LibraryCustomUmdObject} names
@@ -70,11 +75,13 @@ const accessorAccess = (base, accessor, joinWith = ", ") => {
  */
 
 /**
+ * Represents the umd library plugin runtime component.
  * @typedef {UmdLibraryPluginParsed} T
  * @extends {AbstractLibraryPlugin<UmdLibraryPluginParsed>}
  */
 class UmdLibraryPlugin extends AbstractLibraryPlugin {
 	/**
+	 * Creates an instance of UmdLibraryPlugin.
 	 * @param {UmdLibraryPluginOptions} options the plugin option
 	 */
 	constructor(options) {
@@ -88,6 +95,7 @@ class UmdLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Returns preprocess as needed by overriding.
 	 * @param {LibraryOptions} library normalized library option
 	 * @returns {T} preprocess as needed by overriding
 	 */
@@ -117,6 +125,7 @@ class UmdLibraryPlugin extends AbstractLibraryPlugin {
 	}
 
 	/**
+	 * Returns source with library export.
 	 * @param {Source} source source
 	 * @param {RenderContext} renderContext render context
 	 * @param {LibraryContext<T>} libraryContext context
@@ -153,6 +162,7 @@ class UmdLibraryPlugin extends AbstractLibraryPlugin {
 		}
 
 		/**
+		 * Returns the replaced keys.
 		 * @param {string} str the string to replace
 		 * @returns {string} the replaced keys
 		 */
@@ -162,6 +172,7 @@ class UmdLibraryPlugin extends AbstractLibraryPlugin {
 			});
 
 		/**
+		 * Externals deps array.
 		 * @param {ExternalModule[]} modules external modules
 		 * @returns {string} result
 		 */
@@ -180,6 +191,7 @@ class UmdLibraryPlugin extends AbstractLibraryPlugin {
 			)}]`;
 
 		/**
+		 * Externals root array.
 		 * @param {ExternalModule[]} modules external modules
 		 * @returns {string} result
 		 */
@@ -201,6 +213,7 @@ class UmdLibraryPlugin extends AbstractLibraryPlugin {
 			);
 
 		/**
+		 * Externals require array.
 		 * @param {string} type the type
 		 * @returns {string} external require array
 		 */
@@ -233,6 +246,7 @@ class UmdLibraryPlugin extends AbstractLibraryPlugin {
 			);
 
 		/**
+		 * Externals arguments.
 		 * @param {ExternalModule[]} modules external modules
 		 * @returns {string} arguments
 		 */
@@ -247,6 +261,7 @@ class UmdLibraryPlugin extends AbstractLibraryPlugin {
 				.join(", ");
 
 		/**
+		 * Returns stringified library name.
 		 * @param {Accessor} library library name
 		 * @returns {string} stringified library name
 		 */
@@ -279,6 +294,7 @@ class UmdLibraryPlugin extends AbstractLibraryPlugin {
 		const { auxiliaryComment, namedDefine, names } = options;
 
 		/**
+		 * Gets auxiliary comment.
 		 * @param {keyof LibraryCustomUmdCommentObject} type type
 		 * @returns {string} comment
 		 */

package/lib/logging/Logger.js

@@ -42,6 +42,7 @@ const TIMERS_AGGREGATES_SYMBOL = Symbol("webpack logger aggregated times");
 
 class WebpackLogger {
 	/**
+	 * Creates an instance of WebpackLogger.
 	 * @param {LogFn} log log function
 	 * @param {GetChildLogger} getChildLogger function to create child logger
 	 */
@@ -53,6 +54,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	error(...args) {
@@ -60,6 +62,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	warn(...args) {
@@ -67,6 +70,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	info(...args) {
@@ -74,6 +78,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	log(...args) {
@@ -81,6 +86,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	debug(...args) {
@@ -88,6 +94,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided condition.
 	 * @param {boolean=} condition condition
 	 * @param {Args} args args
 	 */
@@ -106,6 +113,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	status(...args) {
@@ -113,6 +121,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	group(...args) {
@@ -120,6 +129,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	groupCollapsed(...args) {
@@ -131,6 +141,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	profile(label) {
@@ -138,6 +149,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	profileEnd(label) {
@@ -145,6 +157,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string} label label
 	 */
 	time(label) {
@@ -154,6 +167,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	timeLog(label) {
@@ -166,6 +180,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	timeEnd(label) {
@@ -180,6 +195,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	timeAggregate(label) {
@@ -209,6 +225,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Time aggregate end.
 	 * @param {string=} label label
 	 */
 	timeAggregateEnd(label) {

package/lib/logging/createConsoleLogger.js

@@ -16,6 +16,7 @@ const { LogType } = require("./Logger");
 /** @typedef {(value: string, type: LogTypeEnum, args?: Args) => void} LoggingFunction */
 
 /**
+ * Defines the logger console type used by this module.
  * @typedef {object} LoggerConsole
  * @property {() => void} clear
  * @property {() => void} trace
@@ -34,6 +35,7 @@ const { LogType } = require("./Logger");
  */
 
 /**
+ * Defines the logger options type used by this module.
  * @typedef {object} LoggerOptions
  * @property {false | true | "none" | "error" | "warn" | "info" | "log" | "verbose"} level loglevel
  * @property {FilterTypes | boolean} debug filter for debug logging
@@ -41,6 +43,7 @@ const { LogType } = require("./Logger");
  */
 
 /**
+ * Filter to function.
  * @param {FilterItemTypes} item an input item
  * @returns {FilterFunction | undefined} filter function
  */
@@ -63,6 +66,7 @@ const filterToFunction = (item) => {
 };
 
 /**
+ * Enumerates the available values.
  * @enum {number}
  */
 const LogLevel = {
@@ -77,6 +81,7 @@ const LogLevel = {
 };
 
 /**
+ * Returns logging function.
  * @param {LoggerOptions} options options object
  * @returns {LoggingFunction} logging function
  */
@@ -93,6 +98,7 @@ module.exports = ({ level = "info", debug = false, console }) => {
 	const loglevel = LogLevel[`${level}`] || 0;
 
 	/**
+	 * Processes the provided name.
 	 * @param {string} name name of the logger
 	 * @param {LogTypeEnum} type type of the log entry
 	 * @param {Args=} args arguments of the log entry
@@ -100,6 +106,7 @@ module.exports = ({ level = "info", debug = false, console }) => {
 	 */
 	const logger = (name, type, args) => {
 		/**
+		 * Returns labeled args.
 		 * @template T
 		 * @returns {[string?, ...T[]]} labeled args
 		 */

package/lib/logging/runtime.js

@@ -18,6 +18,7 @@ const currentDefaultLoggerOptions = {
 let currentDefaultLogger = createConsoleLogger(currentDefaultLoggerOptions);
 
 /**
+ * Processes the provided create console logger.logger option.
  * @param {createConsoleLogger.LoggerOptions} options new options, merge with old options
  * @returns {void}
  */
@@ -27,6 +28,7 @@ module.exports.configureDefaultLogger = (options) => {
 };
 
 /**
+ * Returns a logger.
  * @param {string} name name of the logger
  * @returns {Logger} a logger
  */

package/lib/logging/truncateArgs.js

@@ -6,6 +6,7 @@
 "use strict";
 
 /**
+ * Returns sum of all numbers in array.
  * @param {number[]} array array of numbers
  * @returns {number} sum of all numbers in array
  */
@@ -16,6 +17,7 @@ const arraySum = (array) => {
 };
 
 /**
+ * Returns truncated args.
  * @param {string[]} args items to be truncated
  * @param {number} maxLength maximum length of args including spaces between
  * @returns {string[]} truncated args