webpack 5.106.1 → 5.107.0

package/lib/cache/MemoryCachePlugin.js

@@ -13,7 +13,7 @@ const Cache = require("../Cache");
 
 class MemoryCachePlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/cache/MemoryWithGcCachePlugin.js

@@ -12,6 +12,7 @@ const Cache = require("../Cache");
 /** @typedef {import("../Compiler")} Compiler */
 
 /**
+ * Defines the memory with gc cache plugin options type used by this module.
  * @typedef {object} MemoryWithGcCachePluginOptions
  * @property {number} maxGenerations max generations
  */
@@ -20,6 +21,7 @@ const PLUGIN_NAME = "MemoryWithGcCachePlugin";
 
 class MemoryWithGcCachePlugin {
 	/**
+	 * Creates an instance of MemoryWithGcCachePlugin.
 	 * @param {MemoryWithGcCachePluginOptions} options options
 	 */
 	constructor({ maxGenerations }) {
@@ -27,7 +29,7 @@ class MemoryWithGcCachePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/cache/PackFileCacheStrategy.js

@@ -7,9 +7,9 @@
 
 const FileSystemInfo = require("../FileSystemInfo");
 const ProgressPlugin = require("../ProgressPlugin");
-const { formatSize } = require("../SizeFormatHelpers");
 const SerializerMiddleware = require("../serialization/SerializerMiddleware");
 const LazySet = require("../util/LazySet");
+const formatSize = require("../util/formatSize");
 const makeSerializable = require("../util/makeSerializable");
 const memoize = require("../util/memoize");
 const {
@@ -37,6 +37,7 @@ const {
 
 class PackContainer {
 	/**
+	 * Creates an instance of PackContainer.
 	 * @param {Pack} data stored data
 	 * @param {string} version version identifier
 	 * @param {Snapshot} buildSnapshot snapshot of all build dependencies
@@ -67,6 +68,7 @@ class PackContainer {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write, writeLazy }) {
@@ -80,6 +82,7 @@ class PackContainer {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize({ read }) {
@@ -102,10 +105,11 @@ const MIN_CONTENT_SIZE = 1024 * 1024; // 1 MB
 const CONTENT_COUNT_TO_MERGE = 10;
 const MIN_ITEMS_IN_FRESH_PACK = 100;
 const MAX_ITEMS_IN_FRESH_PACK = 50000;
-const MAX_TIME_IN_FRESH_PACK = 1 * 60 * 1000; // 1 min
+const MAX_TIME_IN_FRESH_PACK = 60 * 1000; // 1 min
 
 class PackItemInfo {
 	/**
+	 * Creates an instance of PackItemInfo.
 	 * @param {string} identifier identifier of item
 	 * @param {string | null | undefined} etag etag of item
 	 * @param {Data} value fresh value of item
@@ -126,6 +130,7 @@ class PackItemInfo {
 
 class Pack {
 	/**
+	 * Creates an instance of Pack.
 	 * @param {Logger} logger a logger
 	 * @param {number} maxAge max age of cache items
 	 */
@@ -149,6 +154,7 @@ class Pack {
 	}
 
 	/**
+	 * Adds the provided identifier to the pack.
 	 * @param {string} identifier identifier
 	 */
 	_addRequest(identifier) {
@@ -170,6 +176,7 @@ class Pack {
 	}
 
 	/**
+	 * Returns cached content.
 	 * @param {string} identifier unique name for the resource
 	 * @param {string | null} etag etag of the resource
 	 * @returns {Data} cached content
@@ -193,6 +200,7 @@ class Pack {
 	}
 
 	/**
+	 * Updates value using the provided identifier.
 	 * @param {string} identifier unique name for the resource
 	 * @param {string | null} etag etag of the resource
 	 * @param {Data} data cached content
@@ -244,6 +252,7 @@ class Pack {
 	}
 
 	/**
+	 * Returns new location of data entries.
 	 * @returns {number} new location of data entries
 	 */
 	_findLocation() {
@@ -254,6 +263,7 @@ class Pack {
 	}
 
 	/**
+	 * Gc and update location.
 	 * @private
 	 * @param {Items} items items
 	 * @param {Items} usedItems used items
@@ -604,6 +614,7 @@ class Pack {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write, writeSeparate }) {
@@ -637,6 +648,7 @@ class Pack {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext & { logger: Logger }} context context
 	 */
 	deserialize({ read, logger }) {
@@ -694,6 +706,7 @@ makeSerializable(Pack, "webpack/lib/cache/PackFileCacheStrategy", "Pack");
 
 class PackContentItems {
 	/**
+	 * Creates an instance of PackContentItems.
 	 * @param {Content} map items
 	 */
 	constructor(map) {
@@ -701,6 +714,7 @@ class PackContentItems {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext & { logger: Logger, profile: boolean | undefined }} context context
 	 */
 	serialize({ write, snapshot, rollback, logger, profile }) {
@@ -778,13 +792,14 @@ class PackContentItems {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext & { logger: Logger, profile: boolean | undefined }} context context
 	 */
 	deserialize({ read, logger, profile }) {
 		if (read()) {
 			this.map = read();
 		} else if (profile) {
-			/** @type {Map<EXPECTED_ANY, EXPECTED_ANY>} */
+			/** @type {Content} */
 			const map = new Map();
 			let key = read();
 			while (key !== null) {
@@ -810,7 +825,7 @@ class PackContentItems {
 			}
 			this.map = map;
 		} else {
-			/** @type {Map<EXPECTED_ANY, EXPECTED_ANY>} */
+			/** @type {Content} */
 			const map = new Map();
 			let key = read();
 			while (key !== null) {
@@ -851,6 +866,7 @@ class PackContent {
 	*/
 
 	/**
+	 * Creates an instance of PackContent.
 	 * @param {Items} items keys
 	 * @param {Items} usedItems used keys
 	 * @param {PackContentItems | (() => Promise<PackContentItems>)} dataOrFn sync or async content
@@ -875,6 +891,7 @@ class PackContent {
 	}
 
 	/**
+	 * Returns result.
 	 * @param {string} identifier identifier
 	 * @returns {string | Promise<string>} result
 	 */
@@ -927,6 +944,7 @@ class PackContent {
 	}
 
 	/**
+	 * Returns maybe a promise if lazy.
 	 * @param {string} reason explanation why unpack is necessary
 	 * @returns {void | Promise<void>} maybe a promise if lazy
 	 */
@@ -971,6 +989,7 @@ class PackContent {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @returns {number} size of the content or -1 if not known
 	 */
 	getSize() {
@@ -985,6 +1004,7 @@ class PackContent {
 	}
 
 	/**
+	 * Processes the provided identifier.
 	 * @param {string} identifier identifier
 	 */
 	delete(identifier) {
@@ -994,6 +1014,7 @@ class PackContent {
 	}
 
 	/**
+	 * Processes the provided write.
 	 * @param {(lazy: LazyFunction) => (() => PackContentItems | Promise<PackContentItems>)} write write function
 	 * @returns {void}
 	 */
@@ -1086,6 +1107,7 @@ class PackContent {
 }
 
 /**
+ * Allow collecting memory.
  * @param {Buffer} buf buffer
  * @returns {Buffer} buffer that can be collected
  */
@@ -1099,6 +1121,7 @@ const allowCollectingMemory = (buf) => {
 
 class PackFileCacheStrategy {
 	/**
+	 * Creates an instance of PackFileCacheStrategy.
 	 * @param {object} options options
 	 * @param {Compiler} options.compiler the compiler
 	 * @param {IntermediateFileSystem} options.fs the filesystem
@@ -1186,6 +1209,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Returns pack.
 	 * @returns {Promise<Pack>} pack
 	 */
 	_getPack() {
@@ -1196,6 +1220,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Returns the pack.
 	 * @returns {Promise<Pack>} the pack
 	 */
 	_openPack() {
@@ -1362,6 +1387,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Returns promise.
 	 * @param {string} identifier unique name for the resource
 	 * @param {Etag | null} etag etag of the resource
 	 * @param {Data} data cached content
@@ -1376,6 +1402,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Returns promise to the cached content.
 	 * @param {string} identifier unique name for the resource
 	 * @param {Etag | null} etag etag of the resource
 	 * @returns {Promise<Data>} promise to the cached content
@@ -1396,6 +1423,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Stores build dependencies.
 	 * @param {FileSystemDependencies | Iterable<string>} dependencies dependencies to store
 	 */
 	storeBuildDependencies(dependencies) {
@@ -1429,6 +1457,7 @@ class PackFileCacheStrategy {
 					);
 					promise = new Promise(
 						/**
+						 * Handles the callback logic for this hook.
 						 * @param {(value?: undefined) => void} resolve resolve
 						 * @param {(reason?: Error) => void} reject reject
 						 */

package/lib/cache/ResolverCachePlugin.js

@@ -22,6 +22,7 @@ const makeSerializable = require("../util/makeSerializable");
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 
 /**
+ * Defines the sync hook type used by this module.
  * @template T
  * @typedef {import("tapable").SyncHook<T>} SyncHook
  */
@@ -30,6 +31,7 @@ const makeSerializable = require("../util/makeSerializable");
 
 class CacheEntry {
 	/**
+	 * Creates an instance of CacheEntry.
 	 * @param {ResolveRequest} result result
 	 * @param {Snapshot} snapshot snapshot
 	 */
@@ -39,6 +41,7 @@ class CacheEntry {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write }) {
@@ -47,6 +50,7 @@ class CacheEntry {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize({ read }) {
@@ -58,6 +62,7 @@ class CacheEntry {
 makeSerializable(CacheEntry, "webpack/lib/cache/ResolverCachePlugin");
 
 /**
+ * Adds the provided set to the cache entry.
  * @template T
  * @param {Set<T> | LazySet<T>} set set to add items to
  * @param {Set<T> | LazySet<T> | Iterable<T>} otherSet set to add items from
@@ -74,6 +79,7 @@ const addAllToSet = (set, otherSet) => {
 };
 
 /**
+ * Returns stringified version.
  * @template {object} T
  * @param {T} object an object
  * @param {boolean} excludeContext if true, context is not included in string
@@ -98,7 +104,7 @@ const PLUGIN_NAME = "ResolverCachePlugin";
 
 class ResolverCachePlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -135,6 +141,7 @@ class ResolverCachePlugin {
 		/** @typedef {ResolveRequest & { _ResolverCachePluginCacheMiss: true }} ResolveRequestWithCacheMiss */
 
 		/**
+		 * Processes the provided item cache.
 		 * @param {ItemCacheFacade} itemCache cache
 		 * @param {Resolver} resolver the resolver
 		 * @param {ResolveContext} resolveContext context for resolving meta info
@@ -175,6 +182,7 @@ class ResolverCachePlugin {
 					(yieldResult).push(obj);
 			}
 			/**
+			 * Processes the provided key.
 			 * @param {"fileDependencies" | "contextDependencies" | "missingDependencies"} key key
 			 */
 			const propagate = (key) => {
@@ -375,6 +383,7 @@ class ResolverCachePlugin {
 										}
 									};
 							/**
+							 * Process cache result.
 							 * @param {(Error | null)=} err error if any
 							 * @param {(CacheEntry | null)=} cacheEntry cache entry
 							 * @returns {void}

package/lib/cache/getLazyHashedEtag.js

@@ -13,12 +13,14 @@ const createHash = require("../util/createHash");
 /** @typedef {import("../util/Hash").HashFunction} HashFunction */
 
 /**
+ * Represents the lazy hashed etag runtime component.
  * @typedef {object} HashableObject
  * @property {(hash: Hash) => void} updateHash
  */
 
 class LazyHashedEtag {
 	/**
+	 * Creates an instance of LazyHashedEtag.
 	 * @param {HashableObject} obj object with updateHash method
 	 * @param {HashFunction} hashFunction the hash function to use
 	 */
@@ -32,6 +34,7 @@ class LazyHashedEtag {
 	}
 
 	/**
+	 * Returns a string representation.
 	 * @returns {string} hash of object
 	 */
 	toString() {
@@ -53,6 +56,7 @@ const mapStrings = new Map();
 const mapObjects = new WeakMap();
 
 /**
+ * Returns etag.
  * @param {HashableObject} obj object with updateHash method
  * @param {HashFunction=} hashFunction the hash function to use
  * @returns {LazyHashedEtag} etag

package/lib/cache/mergeEtags.js

@@ -9,6 +9,7 @@
 
 class MergedEtag {
 	/**
+	 * Creates an instance of MergedEtag.
 	 * @param {Etag} a first
 	 * @param {Etag} b second
 	 */
@@ -28,6 +29,7 @@ const dualObjectMap = new WeakMap();
 const objectStringMap = new WeakMap();
 
 /**
+ * Merges the provided values into a single result.
  * @param {Etag} a first
  * @param {Etag} b second
  * @returns {string | MergedEtag} result

package/lib/cli.js

@@ -7,7 +7,9 @@
 
 const path = require("path");
 const tty = require("tty");
-const webpackSchema = require("../schemas/WebpackOptions.json");
+const webpackSchema =
+	/** @type {EXPECTED_ANY} */
+	(require("../schemas/WebpackOptions.json"));
 
 /** @typedef {import("json-schema").JSONSchema4} JSONSchema4 */
 /** @typedef {import("json-schema").JSONSchema6} JSONSchema6 */
@@ -17,6 +19,7 @@ const webpackSchema = require("../schemas/WebpackOptions.json");
 
 // TODO add originPath to PathItem for better errors
 /**
+ * Defines the path item type used by this module.
  * @typedef {object} PathItem
  * @property {Schema} schema the part of the schema
  * @property {string} path the path in the config
@@ -27,6 +30,7 @@ const webpackSchema = require("../schemas/WebpackOptions.json");
 /** @typedef {string | number | boolean | RegExp} Value */
 
 /**
+ * Defines the problem type used by this module.
  * @typedef {object} Problem
  * @property {ProblemType} type
  * @property {string} path
@@ -37,6 +41,7 @@ const webpackSchema = require("../schemas/WebpackOptions.json");
  */
 
 /**
+ * Defines the local problem type used by this module.
  * @typedef {object} LocalProblem
  * @property {ProblemType} type
  * @property {string} path
@@ -48,6 +53,7 @@ const webpackSchema = require("../schemas/WebpackOptions.json");
 /** @typedef {string | number | boolean | EnumValueObject | EnumValueArray | null} EnumValue */
 
 /**
+ * Defines the argument config type used by this module.
  * @typedef {object} ArgumentConfig
  * @property {string=} description
  * @property {string=} negatedDescription
@@ -60,6 +66,7 @@ const webpackSchema = require("../schemas/WebpackOptions.json");
 /** @typedef {"string" | "number" | "boolean"} SimpleType */
 
 /**
+ * Defines the argument type used by this module.
  * @typedef {object} Argument
  * @property {string | undefined} description
  * @property {SimpleType} simpleType
@@ -72,6 +79,7 @@ const webpackSchema = require("../schemas/WebpackOptions.json");
 /** @typedef {Record<string, EXPECTED_ANY>} ObjectConfiguration */
 
 /**
+ * Returns object of arguments.
  * @param {Schema=} schema a json schema to create arguments for (by default webpack schema is used)
  * @returns {Flags} object of arguments
  */
@@ -80,6 +88,7 @@ const getArguments = (schema = webpackSchema) => {
 	const flags = {};
 
 	/**
+	 * Path to argument name.
 	 * @param {string} input input
 	 * @returns {string} result
 	 */
@@ -95,6 +104,7 @@ const getArguments = (schema = webpackSchema) => {
 			.toLowerCase();
 
 	/**
+	 * Returns schema part.
 	 * @param {string} path path
 	 * @returns {Schema} schema part
 	 */
@@ -117,6 +127,7 @@ const getArguments = (schema = webpackSchema) => {
 	};
 
 	/**
+	 * Returns description.
 	 * @param {PathItem[]} path path in the schema
 	 * @returns {string | undefined} description
 	 */
@@ -131,6 +142,7 @@ const getArguments = (schema = webpackSchema) => {
 	};
 
 	/**
+	 * Gets negated description.
 	 * @param {PathItem[]} path path in the schema
 	 * @returns {string | undefined} negative description
 	 */
@@ -144,6 +156,7 @@ const getArguments = (schema = webpackSchema) => {
 	};
 
 	/**
+	 * Gets reset description.
 	 * @param {PathItem[]} path path in the schema
 	 * @returns {string | undefined} reset description
 	 */
@@ -157,6 +170,7 @@ const getArguments = (schema = webpackSchema) => {
 	};
 
 	/**
+	 * Schema to argument config.
 	 * @param {Schema} schemaPart schema
 	 * @returns {Pick<ArgumentConfig, "type" | "values"> | undefined} partial argument config
 	 */
@@ -190,6 +204,7 @@ const getArguments = (schema = webpackSchema) => {
 	};
 
 	/**
+	 * Adds the provided path to this object.
 	 * @param {PathItem[]} path path in the schema
 	 * @returns {void}
 	 */
@@ -219,6 +234,7 @@ const getArguments = (schema = webpackSchema) => {
 	};
 
 	/**
+	 * Adds the provided path to this object.
 	 * @param {PathItem[]} path full path in schema
 	 * @param {boolean} multiple inside of an array
 	 * @returns {number} number of arguments added
@@ -281,6 +297,7 @@ const getArguments = (schema = webpackSchema) => {
 	// TODO support `not` and `if/then/else`
 	// TODO support `const`, but we don't use it on our schema
 	/**
+	 * Returns added arguments.
 	 * @param {Schema} schemaPart the current schema
 	 * @param {string} schemaPath the current path in the schema
 	 * @param {PathItem[]} path all previous visited schemaParts
@@ -433,6 +450,7 @@ const cliAddedItems = new WeakMap();
 /** @typedef {string | number} Property */
 
 /**
+ * Gets object and property.
  * @param {ObjectConfiguration} config configuration
  * @param {string} schemaPath path in the config
  * @param {number | undefined} index index of value when multiple values are provided, otherwise undefined
@@ -533,6 +551,7 @@ const getObjectAndProperty = (config, schemaPath, index = 0) => {
 };
 
 /**
+ * Updates value using the provided config.
  * @param {ObjectConfiguration} config configuration
  * @param {string} schemaPath path in the config
  * @param {ParsedValue} value parsed value
@@ -552,6 +571,7 @@ const setValue = (config, schemaPath, value, index) => {
 };
 
 /**
+ * Process argument config.
  * @param {ArgumentConfig} argConfig processing instructions
  * @param {ObjectConfiguration} config configuration
  * @param {Value} value the value
@@ -579,6 +599,7 @@ const processArgumentConfig = (argConfig, config, value, index) => {
 };
 
 /**
+ * Gets expected value.
  * @param {ArgumentConfig} argConfig processing instructions
  * @returns {string | undefined} expected message
  */
@@ -606,6 +627,7 @@ const getExpectedValue = (argConfig) => {
 const DECIMAL_NUMBER_REGEXP = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i;
 
 /**
+ * Parses value for argument config.
  * @param {ArgumentConfig} argConfig processing instructions
  * @param {Value} value the value
  * @returns {ParsedValue | undefined} parsed value
@@ -665,6 +687,7 @@ const parseValueForArgumentConfig = (argConfig, value) => {
 /** @typedef {Record<string, Value[]>} Values */
 
 /**
+ * Processes the provided arg.
  * @param {Flags} args object of arguments
  * @param {ObjectConfiguration} config configuration
  * @param {Values} values object with values
@@ -684,6 +707,7 @@ const processArguments = (args, config, values) => {
 			continue;
 		}
 		/**
+		 * Processes the provided value.
 		 * @param {Value} value value
 		 * @param {number | undefined} i index
 		 */
@@ -718,6 +742,7 @@ const processArguments = (args, config, values) => {
 };
 
 /**
+ * Checks whether this object is color supported.
  * @returns {boolean} true when colors supported, otherwise false
  */
 const isColorSupported = () => {
@@ -741,6 +766,7 @@ const isColorSupported = () => {
 };
 
 /**
+ * Returns result.
  * @param {number} index index
  * @param {string} string string
  * @param {string} close close
@@ -761,6 +787,7 @@ const replaceClose = (
 ) => head + (next < 0 ? tail : replaceClose(next, tail, close, replace));
 
 /**
+ * Returns result.
  * @param {number} index index to replace
  * @param {string} string string
  * @param {string} open open string
@@ -776,6 +803,7 @@ const clearBleed = (index, string, open, close, replace) =>
 /** @typedef {(value: EXPECTED_ANY) => string} PrintFunction */
 
 /**
+ * Returns function to create color.
  * @param {string} open open string
  * @param {string} close close string
  * @param {string=} replace extra replace
@@ -790,6 +818,7 @@ const filterEmpty =
 			: "";
 
 /**
+ * Returns result.
  * @param {number} open open code
  * @param {number} close close code
  * @param {string=} replace extra replace
@@ -799,15 +828,18 @@ const init = (open, close, replace) =>
 	filterEmpty(`\u001B[${open}m`, `\u001B[${close}m`, replace);
 
 /**
+ * Defines the colors type used by this module.
  * @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
  */
 
 /**
+ * Defines the colors options type used by this module.
  * @typedef {object} ColorsOptions
  * @property {boolean=} useColor force use colors
  */
 
 /**
+ * Creates a colors from the provided colors option.
  * @param {ColorsOptions=} options options
  * @returns {Colors} colors
  */

package/lib/config/browserslistTargetHandler.js

@@ -16,6 +16,7 @@ const browserslist = require("browserslist");
 const inputRx = /^(?:((?:[A-Z]:)?[/\\].*?))?(?::(.+?))?$/i;
 
 /**
+ * Returns selected browsers.
  * @param {string | null | undefined} input input string
  * @param {string} context the context directory
  * @returns {string[] | undefined} selected browsers
@@ -58,6 +59,7 @@ const load = (input, context) => {
 };
 
 /**
+ * Returns target properties.
  * @param {string[]} browsers supported browsers list
  * @returns {EcmaTargetProperties & PlatformTargetProperties & ApiTargetProperties} target properties
  */