move tooling into separate repo, add type generation and test types

Author: sokra

.prettierignore

@@ -1,3 +1,5 @@
+package.json
+
 # Ignore test fixtures
 test/*.*
 !test/*.js

.prettierrc.js

@@ -8,8 +8,15 @@ module.exports = {
 		{
 			files: "*.json",
 			options: {
+				parser: "json",
 				useTabs: false
 			}
+		},
+		{
+			files: "*.ts",
+			options: {
+				parser: "typescript"
+			}
 		}
 	]
 };

declarations.d.ts

@@ -385,3 +385,8 @@ declare module "enhanced-resolve" {
 }
 
 type TODO = any;
+
+type RecursiveArrayOrRecord<T> =
+	| { [index: string]: RecursiveArrayOrRecord<T> }
+	| Array<RecursiveArrayOrRecord<T>>
+	| T;

declarations/WebpackOptions.d.ts

@@ -19,11 +19,14 @@ export type Bail = boolean;
 /**
  * Cache generated modules and chunks to improve performance for multiple incremental builds.
  */
-export type Cache = true | CacheNormalized;
+export type CacheOptions = true | CacheOptionsNormalized;
 /**
  * Cache generated modules and chunks to improve performance for multiple incremental builds.
  */
-export type CacheNormalized = false | MemoryCacheOptions | FileCacheOptions;
+export type CacheOptionsNormalized =
+	| false
+	| MemoryCacheOptions
+	| FileCacheOptions;
 /**
  * The base directory (absolute path!) for resolving the `entry` option. If `output.pathinfo` is set, the included pathinfo is shortened to this directory.
  */
@@ -489,7 +492,7 @@ export type ResolveLoader = ResolveOptions;
 /**
  * Stats options object or preset name.
  */
-export type Stats =
+export type StatsValue =
 	| (
 			| "none"
 			| "errors-only"
@@ -555,7 +558,7 @@ export interface WebpackOptions {
 	/**
 	 * Cache generated modules and chunks to improve performance for multiple incremental builds.
 	 */
-	cache?: Cache;
+	cache?: CacheOptions;
 	/**
 	 * The base directory (absolute path!) for resolving the `entry` option. If `output.pathinfo` is set, the included pathinfo is shortened to this directory.
 	 */
@@ -603,7 +606,7 @@ export interface WebpackOptions {
 	/**
 	 * Options affecting the normal modules (`NormalModuleFactory`).
 	 */
-	module?: Module;
+	module?: ModuleOptions;
 	/**
 	 * Name of the configuration. Used when loading multiple configurations.
 	 */
@@ -659,7 +662,7 @@ export interface WebpackOptions {
 	/**
 	 * Stats options object or preset name.
 	 */
-	stats?: Stats;
+	stats?: StatsValue;
 	/**
 	 * Environment to build for.
 	 */
@@ -906,7 +909,7 @@ export interface Loader {
 /**
  * Options affecting the normal modules (`NormalModuleFactory`).
  */
-export interface Module {
+export interface ModuleOptions {
 	/**
 	 * An array of rules applied by default for modules.
 	 */
@@ -2096,7 +2099,7 @@ export interface WebpackOptionsNormalized {
 	/**
 	 * Cache generated modules and chunks to improve performance for multiple incremental builds.
 	 */
-	cache: CacheNormalized;
+	cache: CacheOptionsNormalized;
 	/**
 	 * The base directory (absolute path!) for resolving the `entry` option. If `output.pathinfo` is set, the included pathinfo is shortened to this directory.
 	 */
@@ -2144,7 +2147,7 @@ export interface WebpackOptionsNormalized {
 	/**
 	 * Options affecting the normal modules (`NormalModuleFactory`).
 	 */
-	module: Module;
+	module: ModuleOptions;
 	/**
 	 * Name of the configuration. Used when loading multiple configurations.
 	 */
@@ -2196,7 +2199,7 @@ export interface WebpackOptionsNormalized {
 	/**
 	 * Stats options object or preset name.
 	 */
-	stats: Stats;
+	stats: StatsValue;
 	/**
 	 * Environment to build for.
 	 */

generate-types-config.js

@@ -0,0 +1,5 @@
+module.exports = {
+	nameMapping: {
+		FsStats: /^Stats Import fs/
+	}
+};

lib/DefinePlugin.js

@@ -16,8 +16,8 @@ const {
 
 /** @typedef {import("./Compiler")} Compiler */
 /** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
-/** @typedef {null|undefined|RegExp|Function|string|number} CodeValuePrimitive */
-/** @typedef {CodeValuePrimitive|Record<string, CodeValuePrimitive>|RuntimeValue} CodeValue */
+/** @typedef {null|undefined|RegExp|Function|string|number|boolean|bigint|undefined} CodeValuePrimitive */
+/** @typedef {RecursiveArrayOrRecord<CodeValuePrimitive|RuntimeValue>} CodeValue */
 
 class RuntimeValue {
 	constructor(fn, fileDependencies) {

lib/cli.js

@@ -15,9 +15,11 @@ const webpackSchema = require("../schemas/WebpackOptions.json");
  * @property {string} path the path in the config
  */
 
+/** @typedef {"unknown-argument" | "unexpected-non-array-in-path" | "unexpected-non-object-in-path" | "multiple-values-unexpected" | "invalid-value"} ProblemType */
+
 /**
  * @typedef {Object} Problem
- * @property {string} type
+ * @property {ProblemType} type
  * @property {string} path
  * @property {string} argument
  * @property {any=} value
@@ -27,7 +29,7 @@ const webpackSchema = require("../schemas/WebpackOptions.json");
 
 /**
  * @typedef {Object} LocalProblem
- * @property {string} type
+ * @property {ProblemType} type
  * @property {string} path
  * @property {string=} expected
  */
@@ -563,7 +565,7 @@ const parseValueForArgumentConfig = (argConfig, value) => {
 /**
  * @param {Record<string, Argument>} args object of arguments
  * @param {any} config configuration
- * @param {Record<string, string | number | boolean | RegExp>} values object with values
+ * @param {Record<string, string | number | boolean | RegExp | (string | number | boolean | RegExp)[]>} values object with values
  * @returns {Problem[] | null} problems or null for success
  */
 const processArguments = (args, config, values) => {

lib/config/defaults.js

@@ -8,13 +8,13 @@
 const path = require("path");
 const Template = require("../Template");
 
-/** @typedef {import("../../declarations/WebpackOptions").CacheNormalized} WebpackCache */
+/** @typedef {import("../../declarations/WebpackOptions").CacheOptionsNormalized} CacheOptions */
 /** @typedef {import("../../declarations/WebpackOptions").Experiments} Experiments */
 /** @typedef {import("../../declarations/WebpackOptions").InfrastructureLogging} InfrastructureLogging */
 /** @typedef {import("../../declarations/WebpackOptions").Library} Library */
 /** @typedef {import("../../declarations/WebpackOptions").LibraryName} LibraryName */
 /** @typedef {import("../../declarations/WebpackOptions").LibraryOptions} LibraryOptions */
-/** @typedef {import("../../declarations/WebpackOptions").Module} WebpackModule */
+/** @typedef {import("../../declarations/WebpackOptions").ModuleOptions} ModuleOptions */
 /** @typedef {import("../../declarations/WebpackOptions").Node} WebpackNode */
 /** @typedef {import("../../declarations/WebpackOptions").Optimization} Optimization */
 /** @typedef {import("../../declarations/WebpackOptions").Output} Output */
@@ -178,7 +178,7 @@ const applyExperimentsDefaults = experiments => {
 };
 
 /**
- * @param {WebpackCache} cache options
+ * @param {CacheOptions} cache options
  * @param {Object} options options
  * @param {string} options.name name
  * @param {string} options.mode mode
@@ -256,7 +256,7 @@ const applyCacheDefaults = (cache, { name, mode }) => {
 };
 
 /**
- * @param {WebpackModule} module options
+ * @param {ModuleOptions} module options
  * @param {Object} options options
  * @param {boolean} options.cache is caching enabled
  * @param {boolean} options.mjs is mjs enabled

lib/dependencies/AMDPlugin.js

@@ -28,7 +28,7 @@ const ConstDependency = require("./ConstDependency");
 const LocalModuleDependency = require("./LocalModuleDependency");
 const UnsupportedDependency = require("./UnsupportedDependency");
 
-/** @typedef {import("../../declarations/WebpackOptions").Module} ModuleOptions */
+/** @typedef {import("../../declarations/WebpackOptions").ModuleOptions} ModuleOptions */
 /** @typedef {import("../Compiler")} Compiler */
 
 class AMDPlugin {