Files

Return to Package Diff Home.
Brought to you by Intrinsic.

Package Diff: webpack-cli @ 3.3.0 .. 3.3.2

bin/cli.js

@@ -5,6 +5,8 @@
Author Tobias Koppers @sokra
*/
+const { NON_COMPILATION_ARGS } = require("./utils/constants");
+
(function() {
// wrap in IIFE to be able to use return
@@ -16,18 +18,7 @@
require("v8-compile-cache");
- const ErrorHelpers = require("./errorHelpers");
-
- const NON_COMPILATION_ARGS = [
- "init",
- "migrate",
- "add",
- "remove",
- "serve",
- "generate-loader",
- "generate-plugin",
- "info"
- ];
+ const ErrorHelpers = require("./utils/errorHelpers");
const NON_COMPILATION_CMD = process.argv.find(arg => {
if (arg === "serve") {
@@ -38,7 +29,7 @@
});
if (NON_COMPILATION_CMD) {
- return require("./prompt-command")(NON_COMPILATION_CMD, ...process.argv);
+ return require("./utils/prompt-command")(NON_COMPILATION_CMD, ...process.argv);
}
const yargs = require("yargs").usage(`webpack-cli ${require("../package.json").version}
@@ -50,155 +41,7 @@
For more information, see https://webpack.js.org/api/cli/.`);
- require("./config-yargs")(yargs);
-
- const DISPLAY_GROUP = "Stats options:";
- const BASIC_GROUP = "Basic options:";
-
- yargs.options({
- silent: {
- type: "boolean",
- describe: "Prevent output from being displayed in stdout"
- },
- json: {
- type: "boolean",
- alias: "j",
- describe: "Prints the result as JSON."
- },
- progress: {
- type: "boolean",
- describe: "Print compilation progress in percentage",
- group: BASIC_GROUP
- },
- color: {
- type: "boolean",
- alias: "colors",
- default: function supportsColor() {
- return require("supports-color").stdout;
- },
- group: DISPLAY_GROUP,
- describe: "Force colors on the console"
- },
- "no-color": {
- type: "boolean",
- alias: "no-colors",
- group: DISPLAY_GROUP,
- describe: "Force no colors on the console"
- },
- "sort-modules-by": {
- type: "string",
- group: DISPLAY_GROUP,
- describe: "Sorts the modules list by property in module"
- },
- "sort-chunks-by": {
- type: "string",
- group: DISPLAY_GROUP,
- describe: "Sorts the chunks list by property in chunk"
- },
- "sort-assets-by": {
- type: "string",
- group: DISPLAY_GROUP,
- describe: "Sorts the assets list by property in asset"
- },
- "hide-modules": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Hides info about modules"
- },
- "display-exclude": {
- type: "string",
- group: DISPLAY_GROUP,
- describe: "Exclude modules in the output"
- },
- "display-modules": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display even excluded modules in the output"
- },
- "display-max-modules": {
- type: "number",
- group: DISPLAY_GROUP,
- describe: "Sets the maximum number of visible modules in output"
- },
- "display-chunks": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display chunks in the output"
- },
- "display-entrypoints": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display entry points in the output"
- },
- "display-origins": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display origins of chunks in the output"
- },
- "display-cached": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display also cached modules in the output"
- },
- "display-cached-assets": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display also cached assets in the output"
- },
- "display-reasons": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display reasons about module inclusion in the output"
- },
- "display-depth": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display distance from entry point for each module"
- },
- "display-used-exports": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display information about used exports in modules (Tree Shaking)"
- },
- "display-provided-exports": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display information about exports provided from modules"
- },
- "display-optimization-bailout": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display information about why optimization bailed out for modules"
- },
- "display-error-details": {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Display details about errors"
- },
- display: {
- type: "string",
- choices: ["", "verbose", "detailed", "normal", "minimal", "errors-only", "none"],
- group: DISPLAY_GROUP,
- describe: "Select display preset"
- },
- verbose: {
- type: "boolean",
- group: DISPLAY_GROUP,
- describe: "Show more details"
- },
- "info-verbosity": {
- type: "string",
- default: "info",
- choices: ["none", "info", "verbose"],
- group: DISPLAY_GROUP,
- describe: "Controls the output of lifecycle messaging e.g. Started watching files..."
- },
- "build-delimiter": {
- type: "string",
- group: DISPLAY_GROUP,
- describe: "Display custom text after build output"
- }
- });
+ require("./config/config-yargs")(yargs);
// yargs will terminate the process early when the user uses help or version.
// This causes large help outputs to be cut short (https://github.com/nodejs/node/wiki/API-changes-between-v0.10-and-v4#process).
@@ -225,7 +68,7 @@
let options;
try {
- options = require("./convert-argv")(argv);
+ options = require("./utils/convert-argv")(argv);
} catch (err) {
if (err.name !== "ValidationError") {
throw err;
@@ -473,6 +316,33 @@
const statsString = stats.toString(outputOptions);
const delimiter = outputOptions.buildDelimiter ? `${outputOptions.buildDelimiter}\n` : "";
if (statsString) stdout.write(`${statsString}\n${delimiter}`);
+
+ /**
+ * Show a hint to donate to our Opencollective
+ * once a week, only on Monday
+ */
+ const openCollectivePath = __dirname + "/opencollective.js";
+ const MONDAY = 1;
+ const SIX_DAYS = 518400000;
+ const now = new Date();
+ if (now.getDay() === MONDAY) {
+ const {
+ access,
+ constants,
+ statSync,
+ utimesSync,
+ } = require("fs");
+ const lastPrint = statSync(openCollectivePath).atime;
+ const lastPrintTS = new Date(lastPrint).getTime();
+ const timeSinceLastPrint = now.getTime() - lastPrintTS;
+ if (timeSinceLastPrint > SIX_DAYS) {
+ require(openCollectivePath);
+ // On windows we need to manually update the atime
+ access(openCollectivePath, constants.W_OK, (e) => {
+ if (!e) utimesSync(openCollectivePath, now, now);
+ });
+ }
+ }
}
if (!options.watch && stats.hasErrors()) {
process.exitCode = 2;

bin/config/config-yargs.js

@@ -0,0 +1,498 @@
+const optionsSchema = require("../config/optionsSchema.json");
+
+const { GROUPS } = require("../utils/constants");
+
+const {
+ CONFIG_GROUP,
+ BASIC_GROUP,
+ MODULE_GROUP,
+ OUTPUT_GROUP,
+ ADVANCED_GROUP,
+ RESOLVE_GROUP,
+ OPTIMIZE_GROUP,
+ DISPLAY_GROUP
+} = GROUPS;
+
+const nestedProperties = ["anyOf", "oneOf", "allOf"];
+
+const resolveSchema = schema => {
+ let current = schema;
+ if (schema && typeof schema === "object" && "$ref" in schema) {
+ const path = schema.$ref.split("/");
+ for (const element of path) {
+ if (element === "#") {
+ current = optionsSchema;
+ } else {
+ current = current[element];
+ }
+ }
+ }
+ return current;
+};
+
+const findPropertyInSchema = (schema, property, subProperty) => {
+ if (!schema) return null;
+ if (subProperty) {
+ if (schema[property] && typeof schema[property] === "object" && subProperty in schema[property]) {
+ return resolveSchema(schema[property][subProperty]);
+ }
+ } else {
+ if (property in schema) return resolveSchema(schema[property]);
+ }
+ for (const name of nestedProperties) {
+ if (schema[name]) {
+ for (const item of schema[name]) {
+ const resolvedItem = resolveSchema(item);
+ const result = findPropertyInSchema(resolvedItem, property, subProperty);
+ if (result) return result;
+ }
+ }
+ }
+ return undefined;
+};
+
+const getSchemaInfo = (path, property, subProperty) => {
+ const pathSegments = path.split(".");
+ let current = optionsSchema;
+ for (const segment of pathSegments) {
+ if (segment === "*") {
+ current = findPropertyInSchema(current, "additionalProperties") || findPropertyInSchema(current, "items");
+ } else {
+ current = findPropertyInSchema(current, "properties", segment);
+ }
+ if (!current) return undefined;
+ }
+ return findPropertyInSchema(current, property, subProperty);
+};
+
+module.exports = function(yargs) {
+ yargs
+ .help("help")
+ .alias("help", "h")
+ .version()
+ .alias("version", "v")
+ .options({
+ config: {
+ type: "string",
+ describe: "Path to the config file",
+ group: CONFIG_GROUP,
+ defaultDescription: "webpack.config.js or webpackfile.js",
+ requiresArg: true
+ },
+ "config-register": {
+ type: "array",
+ alias: "r",
+ describe: "Preload one or more modules before loading the webpack configuration",
+ group: CONFIG_GROUP,
+ defaultDescription: "module id or path",
+ requiresArg: true
+ },
+ "config-name": {
+ type: "string",
+ describe: "Name of the config to use",
+ group: CONFIG_GROUP,
+ requiresArg: true
+ },
+ env: {
+ describe: "Environment passed to the config, when it is a function",
+ group: CONFIG_GROUP
+ },
+ mode: {
+ type: getSchemaInfo("mode", "type"),
+ choices: getSchemaInfo("mode", "enum"),
+ describe: getSchemaInfo("mode", "description"),
+ group: CONFIG_GROUP,
+ requiresArg: true
+ },
+ context: {
+ type: getSchemaInfo("context", "type"),
+ describe: getSchemaInfo("context", "description"),
+ group: BASIC_GROUP,
+ defaultDescription: "The current directory",
+ requiresArg: true
+ },
+ entry: {
+ type: "string",
+ describe: getSchemaInfo("entry", "description"),
+ group: BASIC_GROUP,
+ requiresArg: true
+ },
+ "module-bind": {
+ type: "string",
+ describe: "Bind an extension to a loader",
+ group: MODULE_GROUP,
+ requiresArg: true
+ },
+ "module-bind-post": {
+ type: "string",
+ describe: "Bind an extension to a post loader",
+ group: MODULE_GROUP,
+ requiresArg: true
+ },
+ "module-bind-pre": {
+ type: "string",
+ describe: "Bind an extension to a pre loader",
+ group: MODULE_GROUP,
+ requiresArg: true
+ },
+ output: {
+ alias: "o",
+ describe: "The output path and file for compilation assets",
+ group: OUTPUT_GROUP,
+ requiresArg: true
+ },
+ "output-path": {
+ type: "string",
+ describe: getSchemaInfo("output.path", "description"),
+ group: OUTPUT_GROUP,
+ defaultDescription: "The current directory",
+ requiresArg: true
+ },
+ "output-filename": {
+ type: "string",
+ describe: getSchemaInfo("output.filename", "description"),
+ group: OUTPUT_GROUP,
+ defaultDescription: "[name].js",
+ requiresArg: true
+ },
+ "output-chunk-filename": {
+ type: "string",
+ describe: getSchemaInfo("output.chunkFilename", "description"),
+ group: OUTPUT_GROUP,
+ defaultDescription: "filename with [id] instead of [name] or [id] prefixed",
+ requiresArg: true
+ },
+ "output-source-map-filename": {
+ type: "string",
+ describe: getSchemaInfo("output.sourceMapFilename", "description"),
+ group: OUTPUT_GROUP,
+ requiresArg: true
+ },
+ "output-public-path": {
+ type: "string",
+ describe: getSchemaInfo("output.publicPath", "description"),
+ group: OUTPUT_GROUP,
+ requiresArg: true
+ },
+ "output-jsonp-function": {
+ type: "string",
+ describe: getSchemaInfo("output.jsonpFunction", "description"),
+ group: OUTPUT_GROUP,
+ requiresArg: true
+ },
+ "output-pathinfo": {
+ type: "boolean",
+ describe: getSchemaInfo("output.pathinfo", "description"),
+ group: OUTPUT_GROUP
+ },
+ "output-library": {
+ type: "array",
+ describe: "Expose the exports of the entry point as library",
+ group: OUTPUT_GROUP,
+ requiresArg: true
+ },
+ "output-library-target": {
+ type: "string",
+ describe: getSchemaInfo("output.libraryTarget", "description"),
+ choices: getSchemaInfo("output.libraryTarget", "enum"),
+ group: OUTPUT_GROUP,
+ requiresArg: true
+ },
+ "records-input-path": {
+ type: "string",
+ describe: getSchemaInfo("recordsInputPath", "description"),
+ group: ADVANCED_GROUP,
+ requiresArg: true
+ },
+ "records-output-path": {
+ type: "string",
+ describe: getSchemaInfo("recordsOutputPath", "description"),
+ group: ADVANCED_GROUP,
+ requiresArg: true
+ },
+ "records-path": {
+ type: "string",
+ describe: getSchemaInfo("recordsPath", "description"),
+ group: ADVANCED_GROUP,
+ requiresArg: true
+ },
+ define: {
+ type: "string",
+ describe: "Define any free var in the bundle",
+ group: ADVANCED_GROUP,
+ requiresArg: true
+ },
+ target: {
+ type: "string",
+ describe: getSchemaInfo("target", "description"),
+ group: ADVANCED_GROUP,
+ requiresArg: true
+ },
+ cache: {
+ type: "boolean",
+ describe: getSchemaInfo("cache", "description"),
+ default: null,
+ group: ADVANCED_GROUP,
+ defaultDescription: "It's enabled by default when watching"
+ },
+ watch: {
+ type: "boolean",
+ alias: "w",
+ describe: getSchemaInfo("watch", "description"),
+ group: BASIC_GROUP
+ },
+ "watch-stdin": {
+ type: "boolean",
+ alias: "stdin",
+ describe: getSchemaInfo("watchOptions.stdin", "description"),
+ group: ADVANCED_GROUP
+ },
+ "watch-aggregate-timeout": {
+ describe: getSchemaInfo("watchOptions.aggregateTimeout", "description"),
+ type: getSchemaInfo("watchOptions.aggregateTimeout", "type"),
+ group: ADVANCED_GROUP,
+ requiresArg: true
+ },
+ "watch-poll": {
+ type: "string",
+ describe: getSchemaInfo("watchOptions.poll", "description"),
+ group: ADVANCED_GROUP
+ },
+ hot: {
+ type: "boolean",
+ describe: "Enables Hot Module Replacement",
+ group: ADVANCED_GROUP
+ },
+ debug: {
+ type: "boolean",
+ describe: "Switch loaders to debug mode",
+ group: BASIC_GROUP
+ },
+ devtool: {
+ type: "string",
+ describe: getSchemaInfo("devtool", "description"),
+ group: BASIC_GROUP,
+ requiresArg: true
+ },
+ "resolve-alias": {
+ type: "string",
+ describe: getSchemaInfo("resolve.alias", "description"),
+ group: RESOLVE_GROUP,
+ requiresArg: true
+ },
+ "resolve-extensions": {
+ type: "array",
+ describe: getSchemaInfo("resolve.alias", "description"),
+ group: RESOLVE_GROUP,
+ requiresArg: true
+ },
+ "resolve-loader-alias": {
+ type: "string",
+ describe: "Setup a loader alias for resolving",
+ group: RESOLVE_GROUP,
+ requiresArg: true
+ },
+ "optimize-max-chunks": {
+ describe: "Try to keep the chunk count below a limit",
+ group: OPTIMIZE_GROUP,
+ requiresArg: true
+ },
+ "optimize-min-chunk-size": {
+ describe: getSchemaInfo("optimization.splitChunks.minSize", "description"),
+ group: OPTIMIZE_GROUP,
+ requiresArg: true
+ },
+ "optimize-minimize": {
+ type: "boolean",
+ describe: getSchemaInfo("optimization.minimize", "description"),
+ group: OPTIMIZE_GROUP
+ },
+ prefetch: {
+ type: "string",
+ describe: "Prefetch this request (Example: --prefetch ./file.js)",
+ group: ADVANCED_GROUP,
+ requiresArg: true
+ },
+ provide: {
+ type: "string",
+ describe: "Provide these modules as free vars in all modules (Example: --provide jQuery=jquery)",
+ group: ADVANCED_GROUP,
+ requiresArg: true
+ },
+ "labeled-modules": {
+ type: "boolean",
+ describe: "Enables labeled modules",
+ group: ADVANCED_GROUP
+ },
+ plugin: {
+ type: "string",
+ describe: "Load this plugin",
+ group: ADVANCED_GROUP,
+ requiresArg: true
+ },
+ bail: {
+ type: getSchemaInfo("bail", "type"),
+ describe: getSchemaInfo("bail", "description"),
+ group: ADVANCED_GROUP,
+ default: null
+ },
+ profile: {
+ type: "boolean",
+ describe: getSchemaInfo("profile", "description"),
+ group: ADVANCED_GROUP,
+ default: null
+ },
+ d: {
+ type: "boolean",
+ describe: "shortcut for --debug --devtool eval-cheap-module-source-map --output-pathinfo",
+ group: BASIC_GROUP
+ },
+ p: {
+ type: "boolean",
+ describe: "shortcut for --optimize-minimize --define process.env.NODE_ENV=\"production\"",
+ group: BASIC_GROUP
+ },
+ silent: {
+ type: "boolean",
+ describe: "Prevent output from being displayed in stdout"
+ },
+ json: {
+ type: "boolean",
+ alias: "j",
+ describe: "Prints the result as JSON."
+ },
+ progress: {
+ type: "boolean",
+ describe: "Print compilation progress in percentage",
+ group: BASIC_GROUP
+ },
+ color: {
+ type: "boolean",
+ alias: "colors",
+ default: function supportsColor() {
+ return require("supports-color").stdout;
+ },
+ group: DISPLAY_GROUP,
+ describe: "Force colors on the console"
+ },
+ "no-color": {
+ type: "boolean",
+ alias: "no-colors",
+ group: DISPLAY_GROUP,
+ describe: "Force no colors on the console"
+ },
+ "sort-modules-by": {
+ type: "string",
+ group: DISPLAY_GROUP,
+ describe: "Sorts the modules list by property in module"
+ },
+ "sort-chunks-by": {
+ type: "string",
+ group: DISPLAY_GROUP,
+ describe: "Sorts the chunks list by property in chunk"
+ },
+ "sort-assets-by": {
+ type: "string",
+ group: DISPLAY_GROUP,
+ describe: "Sorts the assets list by property in asset"
+ },
+ "hide-modules": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Hides info about modules"
+ },
+ "display-exclude": {
+ type: "string",
+ group: DISPLAY_GROUP,
+ describe: "Exclude modules in the output"
+ },
+ "display-modules": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display even excluded modules in the output"
+ },
+ "display-max-modules": {
+ type: "number",
+ group: DISPLAY_GROUP,
+ describe: "Sets the maximum number of visible modules in output"
+ },
+ "display-chunks": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display chunks in the output"
+ },
+ "display-entrypoints": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display entry points in the output"
+ },
+ "display-origins": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display origins of chunks in the output"
+ },
+ "display-cached": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display also cached modules in the output"
+ },
+ "display-cached-assets": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display also cached assets in the output"
+ },
+ "display-reasons": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display reasons about module inclusion in the output"
+ },
+ "display-depth": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display distance from entry point for each module"
+ },
+ "display-used-exports": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display information about used exports in modules (Tree Shaking)"
+ },
+ "display-provided-exports": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display information about exports provided from modules"
+ },
+ "display-optimization-bailout": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display information about why optimization bailed out for modules"
+ },
+ "display-error-details": {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Display details about errors"
+ },
+ display: {
+ type: "string",
+ choices: ["", "verbose", "detailed", "normal", "minimal", "errors-only", "none"],
+ group: DISPLAY_GROUP,
+ describe: "Select display preset"
+ },
+ verbose: {
+ type: "boolean",
+ group: DISPLAY_GROUP,
+ describe: "Show more details"
+ },
+ "info-verbosity": {
+ type: "string",
+ default: "info",
+ choices: ["none", "info", "verbose"],
+ group: DISPLAY_GROUP,
+ describe: "Controls the output of lifecycle messaging e.g. Started watching files..."
+ },
+ "build-delimiter": {
+ type: "string",
+ group: DISPLAY_GROUP,
+ describe: "Display custom text after build output"
+ }
+ });
+};

bin/config/optionsSchema.json

@@ -0,0 +1,1989 @@
+{
+ "additionalProperties": false,
+ "definitions": {
+ "common.pluginFunction": {
+ "description": "Function acting as plugin",
+ "instanceof": "Function",
+ "properties": {
+ "apply": {
+ "description": "The run point of the plugin, required method.",
+ "instanceof": "Function"
+ }
+ },
+ "additionalProperties": true,
+ "required": [
+ "apply"
+ ]
+ },
+ "common.pluginObject": {
+ "description": "Plugin instance",
+ "type": "object",
+ "properties": {
+ "apply": {
+ "description": "The run point of the plugin, required method.",
+ "instanceof": "Function"
+ }
+ },
+ "additionalProperties": true,
+ "required": [
+ "apply"
+ ]
+ },
+ "common.arrayOfStringOrStringArrayValues": {
+ "items": {
+ "description": "string or array of strings",
+ "anyOf": [
+ {
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "items": {
+ "description": "A non-empty string",
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": "array"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ "common.arrayOfStringValues": {
+ "items": {
+ "description": "A non-empty string",
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "common.nonEmptyArrayOfUniqueStringValues": {
+ "items": {
+ "description": "A non-empty string",
+ "minLength": 1,
+ "type": "string"
+ },
+ "minItems": 1,
+ "type": "array",
+ "uniqueItems": true
+ },
+ "entry": {
+ "oneOf": [
+ {
+ "minProperties": 1,
+ "additionalProperties": {
+ "description": "An entry point with name",
+ "oneOf": [
+ {
+ "description": "The string is resolved to a module which is loaded upon startup.",
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "description": "All modules are loaded upon startup. The last one is exported.",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.nonEmptyArrayOfUniqueStringValues"
+ }
+ ]
+ }
+ ]
+ },
+ "description": "Multiple entry bundles are created. The key is the chunk name. The value can be a string or an array.",
+ "type": "object"
+ },
+ {
+ "description": "An entry point without name. The string is resolved to a module which is loaded upon startup.",
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "description": "An entry point without name. All modules are loaded upon startup. The last one is exported.",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.nonEmptyArrayOfUniqueStringValues"
+ }
+ ]
+ },
+ {
+ "description": "A Function returning an entry object, an entry string, an entry array or a promise to these things.",
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "externals": {
+ "anyOf": [
+ {
+ "description": "An exact matched dependency becomes external. The same string is used as external dependency.",
+ "type": "string"
+ },
+ {
+ "additionalProperties": {
+ "description": "The dependency used for the external",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "object"
+ },
+ {
+ "type": "boolean"
+ }
+ ]
+ },
+ "description": "If an dependency matches exactly a property of the object, the property value is used as dependency.",
+ "type": "object"
+ },
+ {
+ "description": "`function(context, request, callback(err, result))` The function is called on each dependency.",
+ "instanceof": "Function"
+ },
+ {
+ "description": "Every matched dependency becomes external.",
+ "instanceof": "RegExp"
+ },
+ {
+ "items": {
+ "description": "External configuration",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/externals"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ ]
+ },
+ "module": {
+ "additionalProperties": false,
+ "properties": {
+ "exprContextCritical": {
+ "description": "Enable warnings for full dynamic dependencies",
+ "type": "boolean"
+ },
+ "exprContextRecursive": {
+ "description": "Enable recursive directory lookup for full dynamic dependencies",
+ "type": "boolean"
+ },
+ "exprContextRegExp": {
+ "description": "Sets the default regular expression for full dynamic dependencies",
+ "anyOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "instanceof": "RegExp"
+ }
+ ]
+ },
+ "exprContextRequest": {
+ "description": "Set the default request for full dynamic dependencies",
+ "type": "string"
+ },
+ "noParse": {
+ "description": "Don't parse files matching. It's matched against the full resolved request.",
+ "anyOf": [
+ {
+ "items": {
+ "description": "A regular expression, when matched the module is not parsed",
+ "instanceof": "RegExp"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ {
+ "instanceof": "RegExp"
+ },
+ {
+ "instanceof": "Function"
+ },
+ {
+ "items": {
+ "description": "An absolute path, when the module starts with this path it is not parsed",
+ "type": "string",
+ "absolutePath": true
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ {
+ "type": "string",
+ "absolutePath": true
+ }
+ ]
+ },
+ "rules": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ruleSet-rules"
+ }
+ ],
+ "description": "An array of rules applied for modules."
+ },
+ "defaultRules": {
+ "description": "An array of rules applied by default for modules.",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-rules"
+ }
+ ]
+ },
+ "unknownContextCritical": {
+ "description": "Enable warnings when using the require function in a not statically analyse-able way",
+ "type": "boolean"
+ },
+ "unknownContextRecursive": {
+ "description": "Enable recursive directory lookup when using the require function in a not statically analyse-able way",
+ "type": "boolean"
+ },
+ "unknownContextRegExp": {
+ "description": "Sets the regular expression when using the require function in a not statically analyse-able way",
+ "anyOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "instanceof": "RegExp"
+ }
+ ]
+ },
+ "unknownContextRequest": {
+ "description": "Sets the request when using the require function in a not statically analyse-able way",
+ "type": "string"
+ },
+ "unsafeCache": {
+ "description": "Cache the resolving of module requests",
+ "anyOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "wrappedContextCritical": {
+ "description": "Enable warnings for partial dynamic dependencies",
+ "type": "boolean"
+ },
+ "wrappedContextRecursive": {
+ "description": "Enable recursive directory lookup for partial dynamic dependencies",
+ "type": "boolean"
+ },
+ "wrappedContextRegExp": {
+ "description": "Set the inner regular expression for partial dynamic dependencies",
+ "instanceof": "RegExp"
+ },
+ "strictExportPresence": {
+ "description": "Emit errors instead of warnings when imported names don't exist in imported module",
+ "type": "boolean"
+ },
+ "strictThisContextOnImports": {
+ "description": "Handle the this context correctly according to the spec for namespace objects",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "output": {
+ "additionalProperties": false,
+ "properties": {
+ "auxiliaryComment": {
+ "description": "Add a comment in the UMD wrapper.",
+ "anyOf": [
+ {
+ "description": "Append the same comment above each import style.",
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Set explicit comments for `commonjs`, `commonjs2`, `amd`, and `root`.",
+ "properties": {
+ "amd": {
+ "description": "Set comment for `amd` section in UMD",
+ "type": "string"
+ },
+ "commonjs": {
+ "description": "Set comment for `commonjs` (exports) section in UMD",
+ "type": "string"
+ },
+ "commonjs2": {
+ "description": "Set comment for `commonjs2` (module.exports) section in UMD",
+ "type": "string"
+ },
+ "root": {
+ "description": "Set comment for `root` (global variable) section in UMD",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "chunkFilename": {
+ "description": "The filename of non-entry chunks as relative path inside the `output.path` directory.",
+ "type": "string",
+ "absolutePath": false
+ },
+ "webassemblyModuleFilename": {
+ "description": "The filename of WebAssembly modules as relative path inside the `output.path` directory.",
+ "type": "string",
+ "absolutePath": false
+ },
+ "globalObject": {
+ "description": "An expression which is used to address the global object/scope in runtime code",
+ "type": "string",
+ "minLength": 1
+ },
+ "crossOriginLoading": {
+ "description": "This option enables cross-origin loading of chunks.",
+ "enum": [
+ false,
+ "anonymous",
+ "use-credentials"
+ ]
+ },
+ "jsonpScriptType": {
+ "description": "This option enables loading async chunks via a custom script type, such as script type=\"module\"",
+ "enum": [
+ false,
+ "text/javascript",
+ "module"
+ ]
+ },
+ "chunkLoadTimeout": {
+ "description": "Number of milliseconds before chunk request expires",
+ "type": "number"
+ },
+ "devtoolFallbackModuleFilenameTemplate": {
+ "description": "Similar to `output.devtoolModuleFilenameTemplate`, but used in the case of duplicate module identifiers.",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "devtoolLineToLine": {
+ "description": "Enable line to line mapped mode for all/specified modules. Line to line mapped mode uses a simple SourceMap where each line of the generated source is mapped to the same line of the original source. It’s a performance optimization. Only use it if your performance need to be better and you are sure that input lines match which generated lines.",
+ "anyOf": [
+ {
+ "description": "`true` enables it for all modules (not recommended)",
+ "type": "boolean"
+ },
+ {
+ "description": "An object similar to `module.loaders` enables it for specific files.",
+ "type": "object"
+ }
+ ]
+ },
+ "devtoolModuleFilenameTemplate": {
+ "description": "Filename template string of function for the sources array in a generated SourceMap.",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "devtoolNamespace": {
+ "description": "Module namespace to use when interpolating filename template string for the sources array in a generated SourceMap. Defaults to `output.library` if not set. It's useful for avoiding runtime collisions in sourcemaps from multiple webpack projects built as libraries.",
+ "type": "string"
+ },
+ "filename": {
+ "description": "Specifies the name of each output file on disk. You must **not** specify an absolute path here! The `output.path` option determines the location on disk the files are written to, filename is used solely for naming the individual files.",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "Function"
+ }
+ ],
+ "absolutePath": false
+ },
+ "hashDigest": {
+ "description": "Digest type used for the hash",
+ "enum": [
+ "latin1",
+ "hex",
+ "base64"
+ ]
+ },
+ "hashDigestLength": {
+ "description": "Number of chars which are used for the hash",
+ "minimum": 1,
+ "type": "number"
+ },
+ "hashFunction": {
+ "description": "Algorithm used for generation the hash (see node.js crypto package)",
+ "anyOf": [
+ {
+ "type": "string",
+ "minLength": 1
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "hashSalt": {
+ "description": "Any string which is added to the hash to salt it",
+ "minLength": 1,
+ "type": "string"
+ },
+ "hotUpdateChunkFilename": {
+ "description": "The filename of the Hot Update Chunks. They are inside the output.path directory.",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "Function"
+ }
+ ],
+ "absolutePath": false
+ },
+ "hotUpdateFunction": {
+ "description": "The JSONP function used by webpack for async loading of hot update chunks.",
+ "type": "string"
+ },
+ "hotUpdateMainFilename": {
+ "description": "The filename of the Hot Update Main File. It is inside the `output.path` directory.",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "Function"
+ }
+ ],
+ "absolutePath": false
+ },
+ "jsonpFunction": {
+ "description": "The JSONP function used by webpack for async loading of chunks.",
+ "type": "string"
+ },
+ "chunkCallbackName": {
+ "description": "The callback function name used by webpack for loading of chunks in WebWorkers.",
+ "type": "string"
+ },
+ "library": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "items": {
+ "description": "A part of the library name",
+ "type": "string"
+ },
+ "type": "array"
+ },
+ {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "root": {
+ "description": "Name of the property exposed globally by a UMD library",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "$ref": "#/definitions/common.arrayOfStringValues"
+ }
+ ]
+ },
+ "amd": {
+ "description": "Name of the exposed AMD library in the UMD",
+ "type": "string"
+ },
+ "commonjs": {
+ "description": "Name of the exposed commonjs export in the UMD",
+ "type": "string"
+ }
+ }
+ }
+ ],
+ "description": "If set, export the bundle as library. `output.library` is the name."
+ },
+ "libraryTarget": {
+ "description": "Type of library",
+ "enum": [
+ "var",
+ "assign",
+ "this",
+ "window",
+ "self",
+ "global",
+ "commonjs",
+ "commonjs2",
+ "commonjs-module",
+ "amd",
+ "umd",
+ "umd2",
+ "jsonp"
+ ]
+ },
+ "libraryExport": {
+ "description": "Specify which export should be exposed as library",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "$ref": "#/definitions/common.arrayOfStringValues"
+ }
+ ]
+ },
+ "path": {
+ "description": "The output directory as **absolute path** (required).",
+ "type": "string",
+ "absolutePath": true
+ },
+ "pathinfo": {
+ "description": "Include comments with information about the modules.",
+ "type": "boolean"
+ },
+ "publicPath": {
+ "description": "The `publicPath` specifies the public URL address of the output files when referenced in a browser.",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "sourceMapFilename": {
+ "description": "The filename of the SourceMaps for the JavaScript files. They are inside the `output.path` directory.",
+ "type": "string",
+ "absolutePath": false
+ },
+ "sourcePrefix": {
+ "description": "Prefixes every line of the source in the bundle with this string.",
+ "type": "string"
+ },
+ "strictModuleExceptionHandling": {
+ "description": "Handles exceptions in module loading correctly at a performance cost.",
+ "type": "boolean"
+ },
+ "umdNamedDefine": {
+ "description": "If `output.libraryTarget` is set to umd and `output.library` is set, setting this to true will name the AMD module.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "resolve": {
+ "additionalProperties": false,
+ "properties": {
+ "alias": {
+ "description": "Redirect module requests",
+ "anyOf": [
+ {
+ "additionalProperties": {
+ "description": "New request",
+ "type": "string"
+ },
+ "type": "object"
+ },
+ {
+ "items": {
+ "description": "Alias configuration",
+ "additionalProperties": false,
+ "properties": {
+ "alias": {
+ "description": "New request",
+ "type": "string"
+ },
+ "name": {
+ "description": "Request to be redirected",
+ "type": "string"
+ },
+ "onlyModule": {
+ "description": "Redirect only exact matching request",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ ]
+ },
+ "aliasFields": {
+ "description": "Fields in the description file (package.json) which are used to redirect requests inside the module",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.arrayOfStringOrStringArrayValues"
+ }
+ ]
+ },
+ "cachePredicate": {
+ "description": "Predicate function to decide which requests should be cached",
+ "instanceof": "Function"
+ },
+ "cacheWithContext": {
+ "description": "Include the context information in the cache identifier when caching",
+ "type": "boolean"
+ },
+ "descriptionFiles": {
+ "description": "Filenames used to find a description file",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.arrayOfStringValues"
+ }
+ ]
+ },
+ "enforceExtension": {
+ "description": "Enforce using one of the extensions from the extensions option",
+ "type": "boolean"
+ },
+ "enforceModuleExtension": {
+ "description": "Enforce using one of the module extensions from the moduleExtensions option",
+ "type": "boolean"
+ },
+ "extensions": {
+ "description": "Extensions added to the request when trying to find the file",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.arrayOfStringValues"
+ }
+ ]
+ },
+ "fileSystem": {
+ "description": "Filesystem for the resolver"
+ },
+ "mainFields": {
+ "description": "Field names from the description file (package.json) which are used to find the default entry point",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.arrayOfStringOrStringArrayValues"
+ }
+ ]
+ },
+ "mainFiles": {
+ "description": "Filenames used to find the default entry point if there is no description file or main field",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.arrayOfStringValues"
+ }
+ ]
+ },
+ "moduleExtensions": {
+ "description": "Extensions added to the module request when trying to find the module",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.arrayOfStringValues"
+ }
+ ]
+ },
+ "modules": {
+ "description": "Folder names or directory paths where to find modules",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.arrayOfStringValues"
+ }
+ ]
+ },
+ "plugins": {
+ "description": "Plugins for the resolver",
+ "type": "array",
+ "items": {
+ "description": "Plugin of type object or instanceof Function",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.pluginObject"
+ },
+ {
+ "$ref": "#/definitions/common.pluginFunction"
+ }
+ ]
+ }
+ },
+ "resolver": {
+ "description": "Custom resolver"
+ },
+ "symlinks": {
+ "description": "Enable resolving symlinks to the original location",
+ "type": "boolean"
+ },
+ "concord": {
+ "description": "Enable concord resolving extras",
+ "type": "boolean"
+ },
+ "unsafeCache": {
+ "description": "Enable caching of successfully resolved requests",
+ "anyOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "additionalProperties": true,
+ "type": "object"
+ }
+ ]
+ },
+ "useSyncFileSystemCalls": {
+ "description": "Use synchronous filesystem calls for the resolver",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "ruleSet-condition": {
+ "anyOf": [
+ {
+ "instanceof": "RegExp"
+ },
+ {
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "instanceof": "Function"
+ },
+ {
+ "$ref": "#/definitions/ruleSet-conditions"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "and": {
+ "description": "Logical AND",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-conditions"
+ }
+ ]
+ },
+ "exclude": {
+ "description": "Exclude all modules matching any of these conditions",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ }
+ ]
+ },
+ "include": {
+ "description": "Exclude all modules matching not any of these conditions",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ }
+ ]
+ },
+ "not": {
+ "description": "Logical NOT",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-conditions"
+ }
+ ]
+ },
+ "or": {
+ "description": "Logical OR",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-conditions"
+ }
+ ]
+ },
+ "test": {
+ "description": "Exclude all modules matching any of these conditions",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "ruleSet-conditions": {
+ "items": {
+ "description": "A rule condition",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ "ruleSet-loader": {
+ "minLength": 1,
+ "type": "string"
+ },
+ "ruleSet-query": {
+ "anyOf": [
+ {
+ "type": "object"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "ruleSet-rule": {
+ "additionalProperties": false,
+ "properties": {
+ "enforce": {
+ "description": "Enforce this rule as pre or post step",
+ "enum": [
+ "pre",
+ "post"
+ ]
+ },
+ "exclude": {
+ "description": "Shortcut for resource.exclude",
+ "allOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ },
+ {
+ "absolutePath": true
+ }
+ ]
+ },
+ "include": {
+ "description": "Shortcut for resource.include",
+ "allOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ },
+ {
+ "absolutePath": true
+ }
+ ]
+ },
+ "issuer": {
+ "description": "Match the issuer of the module (The module pointing to this module)",
+ "allOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ },
+ {
+ "absolutePath": true
+ }
+ ]
+ },
+ "loader": {
+ "description": "Shortcut for use.loader",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-loader"
+ },
+ {
+ "$ref": "#/definitions/ruleSet-use"
+ }
+ ]
+ },
+ "loaders": {
+ "description": "Shortcut for use.loader",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-use"
+ }
+ ]
+ },
+ "oneOf": {
+ "description": "Only execute the first matching rule in this array",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-rules"
+ }
+ ]
+ },
+ "options": {
+ "description": "Shortcut for use.options",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-query"
+ }
+ ]
+ },
+ "parser": {
+ "description": "Options for parsing",
+ "additionalProperties": true,
+ "type": "object"
+ },
+ "resolve": {
+ "description": "Options for the resolver",
+ "type": "object",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/resolve"
+ }
+ ]
+ },
+ "sideEffects": {
+ "description": "Flags a module as with or without side effects",
+ "type": "boolean"
+ },
+ "query": {
+ "description": "Shortcut for use.query",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-query"
+ }
+ ]
+ },
+ "type": {
+ "description": "Module type to use for the module",
+ "enum": [
+ "javascript/auto",
+ "javascript/dynamic",
+ "javascript/esm",
+ "json",
+ "webassembly/experimental"
+ ]
+ },
+ "resource": {
+ "description": "Match the resource path of the module",
+ "allOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ },
+ {
+ "absolutePath": true
+ }
+ ]
+ },
+ "resourceQuery": {
+ "description": "Match the resource query of the module",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ }
+ ]
+ },
+ "compiler": {
+ "description": "Match the child compiler name",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ }
+ ]
+ },
+ "rules": {
+ "description": "Match and execute these rules when this rule is matched",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-rules"
+ }
+ ]
+ },
+ "test": {
+ "description": "Shortcut for resource.test",
+ "allOf": [
+ {
+ "$ref": "#/definitions/ruleSet-condition"
+ },
+ {
+ "absolutePath": true
+ }
+ ]
+ },
+ "use": {
+ "description": "Modifiers applied to the module when rule is matched",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-use"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ruleSet-rules": {
+ "items": {
+ "description": "A rule",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-rule"
+ }
+ ]
+ },
+ "type": "array"
+ },
+ "ruleSet-use": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-use-item"
+ },
+ {
+ "instanceof": "Function"
+ },
+ {
+ "items": {
+ "description": "An use item",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-use-item"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ ]
+ },
+ "ruleSet-use-item": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-loader"
+ },
+ {
+ "instanceof": "Function"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "loader": {
+ "description": "Loader name",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-loader"
+ }
+ ]
+ },
+ "options": {
+ "description": "Loader options",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-query"
+ }
+ ]
+ },
+ "ident": {
+ "description": "Unique loader identifier",
+ "type": "string"
+ },
+ "query": {
+ "description": "Loader query",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ruleSet-query"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "filter-item-types": {
+ "anyOf": [
+ {
+ "instanceof": "RegExp"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "filter-types": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/filter-item-types"
+ },
+ {
+ "type": "array",
+ "items": {
+ "description": "Rule to filter",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/filter-item-types"
+ }
+ ]
+ }
+ }
+ ]
+ }
+ },
+ "properties": {
+ "mode": {
+ "description": "Enable production optimizations or development hints.",
+ "enum": [
+ "development",
+ "production",
+ "none"
+ ]
+ },
+ "amd": {
+ "description": "Set the value of `require.amd` and `define.amd`."
+ },
+ "bail": {
+ "description": "Report the first error as a hard error instead of tolerating it.",
+ "type": "boolean"
+ },
+ "cache": {
+ "description": "Cache generated modules and chunks to improve performance for multiple incremental builds.",
+ "anyOf": [
+ {
+ "description": "You can pass `false` to disable it.",
+ "type": "boolean"
+ },
+ {
+ "description": "You can pass an object to enable it and let webpack use the passed object as cache. This way you can share the cache object between multiple compiler calls.",
+ "type": "object"
+ }
+ ]
+ },
+ "context": {
+ "description": "The base directory (absolute path!) for resolving the `entry` option. If `output.pathinfo` is set, the included pathinfo is shortened to this directory.",
+ "type": "string",
+ "absolutePath": true
+ },
+ "dependencies": {
+ "description": "References to other configurations to depend on.",
+ "items": {
+ "description": "References to another configuration to depend on.",
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "devServer": {
+ "description": "Options for the webpack-dev-server",
+ "type": "object"
+ },
+ "devtool": {
+ "description": "A developer tool to enhance debugging.",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "enum": [
+ false
+ ]
+ }
+ ]
+ },
+ "entry": {
+ "description": "The entry point(s) of the compilation.",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/entry"
+ }
+ ]
+ },
+ "externals": {
+ "description": "Specify dependencies that shouldn't be resolved by webpack, but should become dependencies of the resulting bundle. The kind of the dependency depends on `output.libraryTarget`.",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/externals"
+ }
+ ]
+ },
+ "loader": {
+ "description": "Custom values available in the loader context.",
+ "type": "object"
+ },
+ "module": {
+ "description": "Options affecting the normal modules (`NormalModuleFactory`).",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/module"
+ }
+ ]
+ },
+ "name": {
+ "description": "Name of the configuration. Used when loading multiple configurations.",
+ "type": "string"
+ },
+ "node": {
+ "description": "Include polyfills or mocks for various node stuff.",
+ "anyOf": [
+ {
+ "enum": [
+ false
+ ]
+ },
+ {
+ "additionalProperties": {
+ "description": "Include a polyfill for the node.js module",
+ "enum": [
+ false,
+ true,
+ "mock",
+ "empty"
+ ]
+ },
+ "properties": {
+ "Buffer": {
+ "description": "Include a polyfill for the 'Buffer' variable",
+ "enum": [
+ false,
+ true,
+ "mock"
+ ]
+ },
+ "__dirname": {
+ "description": "Include a polyfill for the '__dirname' variable",
+ "enum": [
+ false,
+ true,
+ "mock"
+ ]
+ },
+ "__filename": {
+ "description": "Include a polyfill for the '__filename' variable",
+ "enum": [
+ false,
+ true,
+ "mock"
+ ]
+ },
+ "console": {
+ "description": "Include a polyfill for the 'console' variable",
+ "enum": [
+ false,
+ true,
+ "mock"
+ ]
+ },
+ "global": {
+ "description": "Include a polyfill for the 'global' variable",
+ "type": "boolean"
+ },
+ "process": {
+ "description": "Include a polyfill for the 'process' variable",
+ "enum": [
+ false,
+ true,
+ "mock"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "output": {
+ "description": "Options affecting the output of the compilation. `output` options tell webpack how to write the compiled files to disk.",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/output"
+ }
+ ]
+ },
+ "optimization": {
+ "description": "Enables/Disables integrated optimizations",
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "removeAvailableModules": {
+ "description": "Removes modules from chunks when these modules are already included in all parents",
+ "type": "boolean"
+ },
+ "removeEmptyChunks": {
+ "description": "Remove chunks which are empty",
+ "type": "boolean"
+ },
+ "mergeDuplicateChunks": {
+ "description": "Merge chunks which contain the same modules",
+ "type": "boolean"
+ },
+ "flagIncludedChunks": {
+ "description": "Also flag chunks as loaded which contain a subset of the modules",
+ "type": "boolean"
+ },
+ "occurrenceOrder": {
+ "description": "Figure out a order of modules which results in the smallest initial bundle",
+ "type": "boolean"
+ },
+ "sideEffects": {
+ "description": "Skip over modules which are flagged to contain no side effects when exports are not used",
+ "type": "boolean"
+ },
+ "providedExports": {
+ "description": "Figure out which exports are provided by modules to generate more efficient code",
+ "type": "boolean"
+ },
+ "usedExports": {
+ "description": "Figure out which exports are used by modules to mangle export names, omit unused exports and generate more efficient code",
+ "type": "boolean"
+ },
+ "concatenateModules": {
+ "description": "Concatenate modules when possible to generate less modules, more efficient code and enable more optimizations by the minimizer",
+ "type": "boolean"
+ },
+ "splitChunks": {
+ "description": "Optimize duplication and caching by splitting chunks by shared modules and cache group",
+ "oneOf": [
+ {
+ "enum": [
+ false
+ ]
+ },
+ {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "chunks": {
+ "description": "Select chunks for determining shared modules (defaults to \"async\", \"initial\" and \"all\" requires adding these chunks to the HTML)",
+ "oneOf": [
+ {
+ "enum": [
+ "initial",
+ "async",
+ "all"
+ ]
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "minSize": {
+ "description": "Minimal size for the created chunk",
+ "type": "number",
+ "minimum": 0
+ },
+ "minChunks": {
+ "description": "Minimum number of times a module has to be duplicated until it's considered for splitting",
+ "type": "number",
+ "minimum": 1
+ },
+ "maxAsyncRequests": {
+ "description": "Maximum number of requests which are accepted for on-demand loading",
+ "type": "number",
+ "minimum": 1
+ },
+ "maxInitialRequests": {
+ "description": "Maximum number of initial chunks which are accepted for an entry point",
+ "type": "number",
+ "minimum": 1
+ },
+ "name": {
+ "description": "Give chunks created a name (chunks with equal name are merged)",
+ "oneOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "instanceof": "Function"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "filename": {
+ "description": "Sets the template for the filename for created chunks (Only works for initial chunks)",
+ "type": "string",
+ "minLength": 1
+ },
+ "automaticNameDelimiter": {
+ "description": "Sets the name delimiter for created chunks",
+ "type": "string",
+ "minLength": 1
+ },
+ "cacheGroups": {
+ "description": "Assign modules to a cache group (modules from different cache groups are tried to keep in separate chunks)",
+ "type": "object",
+ "additionalProperties": {
+ "description": "Configuration for a cache group",
+ "anyOf": [
+ {
+ "enum": [
+ false
+ ]
+ },
+ {
+ "instanceof": "Function"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "RegExp"
+ },
+ {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "test": {
+ "description": "Assign modules to a cache group",
+ "oneOf": [
+ {
+ "instanceof": "Function"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "RegExp"
+ }
+ ]
+ },
+ "chunks": {
+ "description": "Select chunks for determining cache group content (defaults to \"initial\", \"initial\" and \"all\" requires adding these chunks to the HTML)",
+ "oneOf": [
+ {
+ "enum": [
+ "initial",
+ "async",
+ "all"
+ ]
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "enforce": {
+ "description": "Ignore minimum size, minimum chunks and maximum requests and always create chunks for this cache group",
+ "type": "boolean"
+ },
+ "priority": {
+ "description": "Priority of this cache group",
+ "type": "number"
+ },
+ "minSize": {
+ "description": "Minimal size for the created chunk",
+ "type": "number",
+ "minimum": 0
+ },
+ "minChunks": {
+ "description": "Minimum number of times a module has to be duplicated until it's considered for splitting",
+ "type": "number",
+ "minimum": 1
+ },
+ "maxAsyncRequests": {
+ "description": "Maximum number of requests which are accepted for on-demand loading",
+ "type": "number",
+ "minimum": 1
+ },
+ "maxInitialRequests": {
+ "description": "Maximum number of initial chunks which are accepted for an entry point",
+ "type": "number",
+ "minimum": 1
+ },
+ "reuseExistingChunk": {
+ "description": "Try to reuse existing chunk (with name) when it has matching modules",
+ "type": "boolean"
+ },
+ "name": {
+ "description": "Give chunks for this cache group a name (chunks with equal name are merged)",
+ "oneOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "instanceof": "Function"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "filename": {
+ "description": "Sets the template for the filename for created chunks (Only works for initial chunks)",
+ "type": "string",
+ "minLength": 1
+ }
+ }
+ }
+ ]
+ }
+ }
+ }
+ }
+ ]
+ },
+ "runtimeChunk": {
+ "description": "Create an additional chunk which contains only the webpack runtime and chunk hash maps",
+ "oneOf": [
+ {
+ "type": "boolean"
+ },
+ {
+ "enum": [
+ "single",
+ "multiple"
+ ]
+ },
+ {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "name": {
+ "description": "The name or name factory for the runtime chunks",
+ "oneOf": [
+ {
+ "type": "string"
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "noEmitOnErrors": {
+ "description": "Avoid emitting assets when errors occur",
+ "type": "boolean"
+ },
+ "namedModules": {
+ "description": "Use readable module identifiers for better debugging",
+ "type": "boolean"
+ },
+ "namedChunks": {
+ "description": "Use readable chunk identifiers for better debugging",
+ "type": "boolean"
+ },
+ "portableRecords": {
+ "description": "Generate records with relative paths to be able to move the context folder",
+ "type": "boolean"
+ },
+ "minimize": {
+ "description": "Enable minimizing the output. Uses optimization.minimizer.",
+ "type": "boolean"
+ },
+ "minimizer": {
+ "description": "Minimizer(s) to use for minimizing the output",
+ "type": "array",
+ "items": {
+ "description": "Plugin of type object or instanceof Function",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.pluginObject"
+ },
+ {
+ "$ref": "#/definitions/common.pluginFunction"
+ }
+ ]
+ }
+ },
+ "nodeEnv": {
+ "description": "Set process.env.NODE_ENV to a specific value",
+ "anyOf": [
+ {
+ "enum": [
+ false
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ }
+ },
+ "parallelism": {
+ "description": "The number of parallel processed modules in the compilation.",
+ "minimum": 1,
+ "type": "number"
+ },
+ "performance": {
+ "description": "Configuration for web performance recommendations.",
+ "anyOf": [
+ {
+ "enum": [
+ false
+ ]
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "assetFilter": {
+ "description": "Filter function to select assets that are checked",
+ "instanceof": "Function"
+ },
+ "hints": {
+ "description": "Sets the format of the hints: warnings, errors or nothing at all",
+ "enum": [
+ false,
+ "warning",
+ "error"
+ ]
+ },
+ "maxEntrypointSize": {
+ "description": "Total size of an entry point (in bytes)",
+ "type": "number"
+ },
+ "maxAssetSize": {
+ "description": "Filesize limit (in bytes) when exceeded, that webpack will provide performance hints",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "plugins": {
+ "description": "Add additional plugins to the compiler.",
+ "type": "array",
+ "items": {
+ "description": "Plugin of type object or instanceof Function",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/common.pluginObject"
+ },
+ {
+ "$ref": "#/definitions/common.pluginFunction"
+ }
+ ]
+ }
+ },
+ "profile": {
+ "description": "Capture timing information for each module.",
+ "type": "boolean"
+ },
+ "recordsInputPath": {
+ "description": "Store compiler state to a json file.",
+ "type": "string",
+ "absolutePath": true
+ },
+ "recordsOutputPath": {
+ "description": "Load compiler state from a json file.",
+ "type": "string",
+ "absolutePath": true
+ },
+ "recordsPath": {
+ "description": "Store/Load compiler state from/to a json file. This will result in persistent ids of modules and chunks. An absolute path is expected. `recordsPath` is used for `recordsInputPath` and `recordsOutputPath` if they left undefined.",
+ "type": "string",
+ "absolutePath": true
+ },
+ "resolve": {
+ "description": "Options for the resolver",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/resolve"
+ }
+ ]
+ },
+ "resolveLoader": {
+ "description": "Options for the resolver when resolving loaders",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/resolve"
+ }
+ ]
+ },
+ "serve": {
+ "description": "Options for webpack-dev-server",
+ "type": "object"
+ },
+ "stats": {
+ "description": "Used by the webpack CLI program to pass stats options.",
+ "anyOf": [
+ {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "all": {
+ "type": "boolean",
+ "description": "fallback value for stats options when an option is not defined (has precedence over local webpack defaults)"
+ },
+ "context": {
+ "type": "string",
+ "description": "context directory for request shortening",
+ "absolutePath": true
+ },
+ "hash": {
+ "type": "boolean",
+ "description": "add the hash of the compilation"
+ },
+ "version": {
+ "type": "boolean",
+ "description": "add webpack version information"
+ },
+ "timings": {
+ "type": "boolean",
+ "description": "add timing information"
+ },
+ "builtAt": {
+ "type": "boolean",
+ "description": "add built at time information"
+ },
+ "performance": {
+ "type": "boolean",
+ "description": "add performance hint flags"
+ },
+ "depth": {
+ "type": "boolean",
+ "description": "add module depth in module graph"
+ },
+ "assets": {
+ "type": "boolean",
+ "description": "add assets information"
+ },
+ "env": {
+ "type": "boolean",
+ "description": "add --env information"
+ },
+ "colors": {
+ "description": "Enables/Disables colorful output",
+ "oneOf": [
+ {
+ "type": "boolean",
+ "description": "`webpack --colors` equivalent"
+ },
+ {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "bold": {
+ "description": "Custom color for bold text",
+ "type": "string"
+ },
+ "red": {
+ "description": "Custom color for red text",
+ "type": "string"
+ },
+ "green": {
+ "description": "Custom color for green text",
+ "type": "string"
+ },
+ "cyan": {
+ "description": "Custom color for cyan text",
+ "type": "string"
+ },
+ "magenta": {
+ "description": "Custom color for magenta text",
+ "type": "string"
+ },
+ "yellow": {
+ "description": "Custom color for yellow text",
+ "type": "string"
+ }
+ }
+ }
+ ]
+ },
+ "maxModules": {
+ "type": "number",
+ "description": "Set the maximum number of modules to be shown"
+ },
+ "chunks": {
+ "type": "boolean",
+ "description": "add chunk information"
+ },
+ "chunkModules": {
+ "type": "boolean",
+ "description": "add built modules information to chunk information"
+ },
+ "modules": {
+ "type": "boolean",
+ "description": "add built modules information"
+ },
+ "nestedModules": {
+ "type": "boolean",
+ "description": "add information about modules nested in other modules (like with module concatenation)"
+ },
+ "moduleAssets": {
+ "type": "boolean",
+ "description": "add information about assets inside modules"
+ },
+ "children": {
+ "type": "boolean",
+ "description": "add children information"
+ },
+ "cached": {
+ "type": "boolean",
+ "description": "add also information about cached (not built) modules"
+ },
+ "cachedAssets": {
+ "type": "boolean",
+ "description": "Show cached assets (setting this to `false` only shows emitted files)"
+ },
+ "reasons": {
+ "type": "boolean",
+ "description": "add information about the reasons why modules are included"
+ },
+ "source": {
+ "type": "boolean",
+ "description": "add the source code of modules"
+ },
+ "warnings": {
+ "type": "boolean",
+ "description": "add warnings"
+ },
+ "errors": {
+ "type": "boolean",
+ "description": "add errors"
+ },
+ "warningsFilter": {
+ "description": "Suppress warnings that match the specified filters. Filters can be Strings, RegExps or Functions",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/filter-types"
+ }
+ ]
+ },
+ "excludeAssets": {
+ "description": "Suppress assets that match the specified filters. Filters can be Strings, RegExps or Functions",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/filter-types"
+ }
+ ]
+ },
+ "excludeModules": {
+ "description": "Suppress modules that match the specified filters. Filters can be Strings, RegExps, Booleans or Functions",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/filter-types"
+ },
+ {
+ "type": "boolean"
+ }
+ ]
+ },
+ "exclude": {
+ "description": "Please use excludeModules instead.",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/filter-types"
+ },
+ {
+ "type": "boolean"
+ }
+ ]
+ },
+ "entrypoints": {
+ "type": "boolean",
+ "description": "Display the entry points with the corresponding bundles"
+ },
+ "chunkGroups": {
+ "type": "boolean",
+ "description": "Display all chunk groups with the corresponding bundles"
+ },
+ "errorDetails": {
+ "type": "boolean",
+ "description": "add details to errors (like resolving log)"
+ },
+ "chunkOrigins": {
+ "type": "boolean",
+ "description": "add the origins of chunks and chunk merging info"
+ },
+ "modulesSort": {
+ "type": "string",
+ "description": "sort the modules by that field"
+ },
+ "moduleTrace": {
+ "type": "boolean",
+ "description": "add dependencies and origin of warnings/errors"
+ },
+ "chunksSort": {
+ "type": "string",
+ "description": "sort the chunks by that field"
+ },
+ "assetsSort": {
+ "type": "string",
+ "description": "sort the assets by that field"
+ },
+ "publicPath": {
+ "type": "boolean",
+ "description": "Add public path information"
+ },
+ "outputPath": {
+ "type": "boolean",
+ "description": "Add output path information"
+ },
+ "providedExports": {
+ "type": "boolean",
+ "description": "show exports provided by modules"
+ },
+ "usedExports": {
+ "type": "boolean",
+ "description": "show exports used by modules"
+ },
+ "optimizationBailout": {
+ "type": "boolean",
+ "description": "show reasons why optimization bailed out for modules"
+ }
+ }
+ },
+ {
+ "type": "boolean"
+ },
+ {
+ "enum": [
+ "none",
+ "errors-only",
+ "minimal",
+ "normal",
+ "detailed",
+ "verbose"
+ ]
+ }
+ ]
+ },
+ "target": {
+ "description": "Environment to build for",
+ "anyOf": [
+ {
+ "enum": [
+ "web",
+ "webworker",
+ "node",
+ "async-node",
+ "node-webkit",
+ "electron-main",
+ "electron-renderer"
+ ]
+ },
+ {
+ "instanceof": "Function"
+ }
+ ]
+ },
+ "watch": {
+ "description": "Enter watch mode, which rebuilds on file change.",
+ "type": "boolean"
+ },
+ "watchOptions": {
+ "description": "Options for the watcher",
+ "additionalProperties": false,
+ "properties": {
+ "aggregateTimeout": {
+ "description": "Delay the rebuilt after the first change. Value is a time in ms.",
+ "type": "number"
+ },
+ "ignored": {
+ "description": "Ignore some files from watching"
+ },
+ "stdin": {
+ "description": "Stop watching when stdin stream has ended",
+ "type": "boolean"
+ },
+ "poll": {
+ "description": "Enable polling mode for watching",
+ "anyOf": [
+ {
+ "description": "`true`: use polling.",
+ "type": "boolean"
+ },
+ {
+ "description": "`number`: use polling with specified interval.",
+ "type": "number"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+
\ No newline at end of file

bin/config/webpackConfigurationSchema.json

@@ -0,0 +1,20 @@
+{
+ "anyOf": [
+ {
+ "type": "object",
+ "description": "A webpack configuration object."
+ },
+ {
+ "type": "array",
+ "description": "An array of webpack configuration objects.",
+ "items": {
+ "description": "A webpack configuration object.",
+ "type": "object"
+ }
+ },
+ {
+ "instanceof": "Promise",
+ "description": "A promise that resolves with a configuration object, or an array of configuration objects."
+ }
+ ]
+}

bin/config-yargs.js

@@ -1,351 +0,0 @@
-const optionsSchema = require("./optionsSchema.json");
-
-const nestedProperties = ["anyOf", "oneOf", "allOf"];
-
-const resolveSchema = schema => {
- let current = schema;
- if (schema && typeof schema === "object" && "$ref" in schema) {
- const path = schema.$ref.split("/");
- for (const element of path) {
- if (element === "#") {
- current = optionsSchema;
- } else {
- current = current[element];
- }
- }
- }
- return current;
-};
-
-const findPropertyInSchema = (schema, property, subProperty) => {
- if (!schema) return null;
- if (subProperty) {
- if (schema[property] && typeof schema[property] === "object" && subProperty in schema[property]) {
- return resolveSchema(schema[property][subProperty]);
- }
- } else {
- if (property in schema) return resolveSchema(schema[property]);
- }
- for (const name of nestedProperties) {
- if (schema[name]) {
- for (const item of schema[name]) {
- const resolvedItem = resolveSchema(item);
- const result = findPropertyInSchema(resolvedItem, property, subProperty);
- if (result) return result;
- }
- }
- }
- return undefined;
-};
-
-const getSchemaInfo = (path, property, subProperty) => {
- const pathSegments = path.split(".");
- let current = optionsSchema;
- for (const segment of pathSegments) {
- if (segment === "*") {
- current = findPropertyInSchema(current, "additionalProperties") || findPropertyInSchema(current, "items");
- } else {
- current = findPropertyInSchema(current, "properties", segment);
- }
- if (!current) return undefined;
- }
- return findPropertyInSchema(current, property, subProperty);
-};
-
-const CONFIG_GROUP = "Config options:";
-const BASIC_GROUP = "Basic options:";
-const MODULE_GROUP = "Module options:";
-const OUTPUT_GROUP = "Output options:";
-const ADVANCED_GROUP = "Advanced options:";
-const RESOLVE_GROUP = "Resolving options:";
-const OPTIMIZE_GROUP = "Optimizing options:";
-
-module.exports = function(yargs) {
- yargs
- .help("help")
- .alias("help", "h")
- .version()
- .alias("version", "v")
- .options({
- config: {
- type: "string",
- describe: "Path to the config file",
- group: CONFIG_GROUP,
- defaultDescription: "webpack.config.js or webpackfile.js",
- requiresArg: true
- },
- "config-register": {
- type: "array",
- alias: "r",
- describe: "Preload one or more modules before loading the webpack configuration",
- group: CONFIG_GROUP,
- defaultDescription: "module id or path",
- requiresArg: true
- },
- "config-name": {
- type: "string",
- describe: "Name of the config to use",
- group: CONFIG_GROUP,
- requiresArg: true
- },
- env: {
- describe: "Environment passed to the config, when it is a function",
- group: CONFIG_GROUP
- },
- mode: {
- type: getSchemaInfo("mode", "type"),
- choices: getSchemaInfo("mode", "enum"),
- describe: getSchemaInfo("mode", "description"),
- group: CONFIG_GROUP,
- requiresArg: true
- },
- context: {
- type: getSchemaInfo("context", "type"),
- describe: getSchemaInfo("context", "description"),
- group: BASIC_GROUP,
- defaultDescription: "The current directory",
- requiresArg: true
- },
- entry: {
- type: "string",
- describe: getSchemaInfo("entry", "description"),
- group: BASIC_GROUP,
- requiresArg: true
- },
- "module-bind": {
- type: "string",
- describe: "Bind an extension to a loader",
- group: MODULE_GROUP,
- requiresArg: true
- },
- "module-bind-post": {
- type: "string",
- describe: "Bind an extension to a post loader",
- group: MODULE_GROUP,
- requiresArg: true
- },
- "module-bind-pre": {
- type: "string",
- describe: "Bind an extension to a pre loader",
- group: MODULE_GROUP,
- requiresArg: true
- },
- output: {
- alias: "o",
- describe: "The output path and file for compilation assets",
- group: OUTPUT_GROUP,
- requiresArg: true
- },
- "output-path": {
- type: "string",
- describe: getSchemaInfo("output.path", "description"),
- group: OUTPUT_GROUP,
- defaultDescription: "The current directory",
- requiresArg: true
- },
- "output-filename": {
- type: "string",
- describe: getSchemaInfo("output.filename", "description"),
- group: OUTPUT_GROUP,
- defaultDescription: "[name].js",
- requiresArg: true
- },
- "output-chunk-filename": {
- type: "string",
- describe: getSchemaInfo("output.chunkFilename", "description"),
- group: OUTPUT_GROUP,
- defaultDescription: "filename with [id] instead of [name] or [id] prefixed",
- requiresArg: true
- },
- "output-source-map-filename": {
- type: "string",
- describe: getSchemaInfo("output.sourceMapFilename", "description"),
- group: OUTPUT_GROUP,
- requiresArg: true
- },
- "output-public-path": {
- type: "string",
- describe: getSchemaInfo("output.publicPath", "description"),
- group: OUTPUT_GROUP,
- requiresArg: true
- },
- "output-jsonp-function": {
- type: "string",
- describe: getSchemaInfo("output.jsonpFunction", "description"),
- group: OUTPUT_GROUP,
- requiresArg: true
- },
- "output-pathinfo": {
- type: "boolean",
- describe: getSchemaInfo("output.pathinfo", "description"),
- group: OUTPUT_GROUP
- },
- "output-library": {
- type: "array",
- describe: "Expose the exports of the entry point as library",
- group: OUTPUT_GROUP,
- requiresArg: true
- },
- "output-library-target": {
- type: "string",
- describe: getSchemaInfo("output.libraryTarget", "description"),
- choices: getSchemaInfo("output.libraryTarget", "enum"),
- group: OUTPUT_GROUP,
- requiresArg: true
- },
- "records-input-path": {
- type: "string",
- describe: getSchemaInfo("recordsInputPath", "description"),
- group: ADVANCED_GROUP,
- requiresArg: true
- },
- "records-output-path": {
- type: "string",
- describe: getSchemaInfo("recordsOutputPath", "description"),
- group: ADVANCED_GROUP,
- requiresArg: true
- },
- "records-path": {
- type: "string",
- describe: getSchemaInfo("recordsPath", "description"),
- group: ADVANCED_GROUP,
- requiresArg: true
- },
- define: {
- type: "string",
- describe: "Define any free var in the bundle",
- group: ADVANCED_GROUP,
- requiresArg: true
- },
- target: {
- type: "string",
- describe: getSchemaInfo("target", "description"),
- group: ADVANCED_GROUP,
- requiresArg: true
- },
- cache: {
- type: "boolean",
- describe: getSchemaInfo("cache", "description"),
- default: null,
- group: ADVANCED_GROUP,
- defaultDescription: "It's enabled by default when watching"
- },
- watch: {
- type: "boolean",
- alias: "w",
- describe: getSchemaInfo("watch", "description"),
- group: BASIC_GROUP
- },
- "watch-stdin": {
- type: "boolean",
- alias: "stdin",
- describe: getSchemaInfo("watchOptions.stdin", "description"),
- group: ADVANCED_GROUP
- },
- "watch-aggregate-timeout": {
- describe: getSchemaInfo("watchOptions.aggregateTimeout", "description"),
- type: getSchemaInfo("watchOptions.aggregateTimeout", "type"),
- group: ADVANCED_GROUP,
- requiresArg: true
- },
- "watch-poll": {
- type: "string",
- describe: getSchemaInfo("watchOptions.poll", "description"),
- group: ADVANCED_GROUP
- },
- hot: {
- type: "boolean",
- describe: "Enables Hot Module Replacement",
- group: ADVANCED_GROUP
- },
- debug: {
- type: "boolean",
- describe: "Switch loaders to debug mode",
- group: BASIC_GROUP
- },
- devtool: {
- type: "string",
- describe: getSchemaInfo("devtool", "description"),
- group: BASIC_GROUP,
- requiresArg: true
- },
- "resolve-alias": {
- type: "string",
- describe: getSchemaInfo("resolve.alias", "description"),
- group: RESOLVE_GROUP,
- requiresArg: true
- },
- "resolve-extensions": {
- type: "array",
- describe: getSchemaInfo("resolve.alias", "description"),
- group: RESOLVE_GROUP,
- requiresArg: true
- },
- "resolve-loader-alias": {
- type: "string",
- describe: "Setup a loader alias for resolving",
- group: RESOLVE_GROUP,
- requiresArg: true
- },
- "optimize-max-chunks": {
- describe: "Try to keep the chunk count below a limit",
- group: OPTIMIZE_GROUP,
- requiresArg: true
- },
- "optimize-min-chunk-size": {
- describe: getSchemaInfo("optimization.splitChunks.minSize", "description"),
- group: OPTIMIZE_GROUP,
- requiresArg: true
- },
- "optimize-minimize": {
- type: "boolean",
- describe: getSchemaInfo("optimization.minimize", "description"),
- group: OPTIMIZE_GROUP
- },
- prefetch: {
- type: "string",
- describe: "Prefetch this request (Example: --prefetch ./file.js)",
- group: ADVANCED_GROUP,
- requiresArg: true
- },
- provide: {
- type: "string",
- describe: "Provide these modules as free vars in all modules (Example: --provide jQuery=jquery)",
- group: ADVANCED_GROUP,
- requiresArg: true
- },
- "labeled-modules": {
- type: "boolean",
- describe: "Enables labeled modules",
- group: ADVANCED_GROUP
- },
- plugin: {
- type: "string",
- describe: "Load this plugin",
- group: ADVANCED_GROUP,
- requiresArg: true
- },
- bail: {
- type: getSchemaInfo("bail", "type"),
- describe: getSchemaInfo("bail", "description"),
- group: ADVANCED_GROUP,
- default: null
- },
- profile: {
- type: "boolean",
- describe: getSchemaInfo("profile", "description"),
- group: ADVANCED_GROUP,
- default: null
- },
- d: {
- type: "boolean",
- describe: "shortcut for --debug --devtool eval-cheap-module-source-map --output-pathinfo",
- group: BASIC_GROUP
- },
- p: {
- type: "boolean",
- describe: "shortcut for --optimize-minimize --define process.env.NODE_ENV=\"production\"",
- group: BASIC_GROUP
- }
- });
-};

bin/convert-argv.js

@@ -1,560 +0,0 @@
-const path = require("path");
-const fs = require("fs");
-fs.existsSync = fs.existsSync || path.existsSync;
-const interpret = require("interpret");
-const prepareOptions = require("./prepareOptions");
-const webpackConfigurationSchema = require("./webpackConfigurationSchema.json");
-const validateSchema = require("webpack").validateSchema;
-const WebpackOptionsValidationError = require("webpack").WebpackOptionsValidationError;
-const findup = require("findup-sync");
-
-module.exports = function(...args) {
- const argv = args[1] || args[0];
- const options = [];
- // Shortcuts
- if (argv.d) {
- argv.debug = true;
- argv["output-pathinfo"] = true;
- if (!argv.devtool) {
- argv.devtool = "eval-cheap-module-source-map";
- }
- if (!argv.mode) {
- argv.mode = "development";
- }
- }
- if (argv.p) {
- argv["optimize-minimize"] = true;
- argv["define"] = [].concat(argv["define"] || []).concat("process.env.NODE_ENV=\"production\"");
- if (!argv.mode) {
- argv.mode = "production";
- }
- }
-
- if (argv.output) {
- let output = argv.output;
- if (!path.isAbsolute(argv.o)) {
- output = path.resolve(process.cwd(), output);
- }
- argv["output-filename"] = path.basename(output);
- argv["output-path"] = path.dirname(output);
- }
-
- let configFileLoaded = false;
- let configFiles = [];
- const extensions = Object.keys(interpret.extensions).sort(function(a, b) {
- return a === ".js" ? -1 : b === ".js" ? 1 : a.length - b.length;
- });
-
- let i;
- if (argv.config) {
- const getConfigExtension = function getConfigExtension(configPath) {
- for (i = extensions.length - 1; i >= 0; i--) {
- const tmpExt = extensions[i];
- if (configPath.indexOf(tmpExt, configPath.length - tmpExt.length) > -1) {
- return tmpExt;
- }
- }
- return path.extname(configPath);
- };
-
- const mapConfigArg = function mapConfigArg(configArg) {
- const resolvedPath = path.resolve(configArg);
- const extension = getConfigExtension(resolvedPath);
- return {
- path: resolvedPath,
- ext: extension
- };
- };
-
- const configArgList = Array.isArray(argv.config) ? argv.config : [argv.config];
- configFiles = configArgList.map(mapConfigArg);
- } else {
- const defaultConfigFileNames = ["webpack.config", "webpackfile"].join("|");
- const webpackConfigFileRegExp = `(${defaultConfigFileNames})(${extensions.join("|")})`;
- const pathToWebpackConfig = findup(webpackConfigFileRegExp);
-
- if (pathToWebpackConfig) {
- const resolvedPath = path.resolve(pathToWebpackConfig);
- const actualConfigFileName = path.basename(resolvedPath);
- const ext = actualConfigFileName.replace(new RegExp(defaultConfigFileNames), "");
- configFiles.push({
- path: resolvedPath,
- ext
- });
- }
- }
- if (configFiles.length > 0) {
- const registerCompiler = function registerCompiler(moduleDescriptor) {
- if (moduleDescriptor) {
- if (typeof moduleDescriptor === "string") {
- require(moduleDescriptor);
- } else if (!Array.isArray(moduleDescriptor)) {
- moduleDescriptor.register(require(moduleDescriptor.module));
- } else {
- for (let i = 0; i < moduleDescriptor.length; i++) {
- try {
- registerCompiler(moduleDescriptor[i]);
- break;
- } catch (e) {
- // do nothing
- }
- }
- }
- }
- };
-
- const requireConfig = function requireConfig(configPath) {
- let options = (function WEBPACK_OPTIONS() {
- if (argv.configRegister && argv.configRegister.length) {
- module.paths.unshift(path.resolve(process.cwd(), "node_modules"), process.cwd());
- argv.configRegister.forEach(dep => {
- require(dep);
- });
- return require(configPath);
- } else {
- return require(configPath);
- }
- })();
- options = prepareOptions(options, argv);
- return options;
- };
-
- configFiles.forEach(function(file) {
- registerCompiler(interpret.extensions[file.ext]);
- options.push(requireConfig(file.path));
- });
- configFileLoaded = true;
- }
-
- if (!configFileLoaded) {
- return processConfiguredOptions({});
- } else if (options.length === 1) {
- return processConfiguredOptions(options[0]);
- } else {
- return processConfiguredOptions(options);
- }
-
- function processConfiguredOptions(options) {
- const webpackConfigurationValidationErrors = validateSchema(webpackConfigurationSchema, options);
- if (webpackConfigurationValidationErrors.length) {
- const error = new WebpackOptionsValidationError(webpackConfigurationValidationErrors);
- console.error(error.message, `\nReceived: ${typeof options} : ${JSON.stringify(options, null, 2)}`);
- process.exit(-1); // eslint-disable-line
- }
-
- // process Promise
- if (typeof options.then === "function") {
- return options.then(processConfiguredOptions);
- }
-
- // process ES6 default
- if (typeof options === "object" && typeof options.default === "object") {
- return processConfiguredOptions(options.default);
- }
-
- // filter multi-config by name
- if (Array.isArray(options) && argv["config-name"]) {
- const namedOptions = options.filter(function(opt) {
- return opt.name === argv["config-name"];
- });
- if (namedOptions.length === 0) {
- console.error("Configuration with name '" + argv["config-name"] + "' was not found.");
- process.exit(-1); // eslint-disable-line
- } else if (namedOptions.length === 1) {
- return processConfiguredOptions(namedOptions[0]);
- }
- options = namedOptions;
- }
-
- if (Array.isArray(options)) {
- options.forEach(processOptions);
- } else {
- processOptions(options);
- }
-
- if (argv.context) {
- options.context = path.resolve(argv.context);
- }
- if (!options.context) {
- options.context = process.cwd();
- }
-
- if (argv.watch) {
- options.watch = true;
- }
-
- if (argv["watch-aggregate-timeout"]) {
- options.watchOptions = options.watchOptions || {};
- options.watchOptions.aggregateTimeout = +argv["watch-aggregate-timeout"];
- }
-
- if (typeof argv["watch-poll"] !== "undefined") {
- options.watchOptions = options.watchOptions || {};
- if (argv["watch-poll"] === "true" || argv["watch-poll"] === "") options.watchOptions.poll = true;
- else if (!isNaN(argv["watch-poll"])) options.watchOptions.poll = +argv["watch-poll"];
- }
-
- if (argv["watch-stdin"]) {
- options.watchOptions = options.watchOptions || {};
- options.watchOptions.stdin = true;
- options.watch = true;
- }
-
- return options;
- }
-
- function processOptions(options) {
- function ifArg(name, fn, init, finalize) {
- const isArray = Array.isArray(argv[name]);
- const isSet = typeof argv[name] !== "undefined" && argv[name] !== null;
- if (!isArray && !isSet) return;
-
- init && init();
- if (isArray) argv[name].forEach(fn);
- else if (isSet) fn(argv[name], -1);
- finalize && finalize();
- }
-
- function ifArgPair(name, fn, init, finalize) {
- ifArg(
- name,
- function(content, idx) {
- const i = content.indexOf("=");
- if (i < 0) {
- return fn(null, content, idx);
- } else {
- return fn(content.substr(0, i), content.substr(i + 1), idx);
- }
- },
- init,
- finalize
- );
- }
-
- function ifBooleanArg(name, fn) {
- ifArg(name, function(bool) {
- if (bool) {
- fn();
- }
- });
- }
-
- function mapArgToBoolean(name, optionName) {
- ifArg(name, function(bool) {
- if (bool === true) options[optionName || name] = true;
- else if (bool === false) options[optionName || name] = false;
- });
- }
-
- function loadPlugin(name) {
- const loadUtils = require("loader-utils");
- let args;
- try {
- const p = name && name.indexOf("?");
- if (p > -1) {
- args = loadUtils.parseQuery(name.substring(p));
- name = name.substring(0, p);
- }
- } catch (e) {
- console.log("Invalid plugin arguments " + name + " (" + e + ").");
- process.exit(-1); // eslint-disable-line
- }
-
- let path;
- try {
- const resolve = require("enhanced-resolve");
- path = resolve.sync(process.cwd(), name);
- } catch (e) {
- console.log("Cannot resolve plugin " + name + ".");
- process.exit(-1); // eslint-disable-line
- }
- let Plugin;
- try {
- Plugin = require(path);
- } catch (e) {
- console.log("Cannot load plugin " + name + ". (" + path + ")");
- throw e;
- }
- try {
- return new Plugin(args);
- } catch (e) {
- console.log("Cannot instantiate plugin " + name + ". (" + path + ")");
- throw e;
- }
- }
-
- function ensureObject(parent, name, force) {
- if (force || typeof parent[name] !== "object" || parent[name] === null) {
- parent[name] = {};
- }
- }
-
- function ensureArray(parent, name) {
- if (!Array.isArray(parent[name])) {
- parent[name] = [];
- }
- }
-
- function addPlugin(options, plugin) {
- ensureArray(options, "plugins");
- options.plugins.unshift(plugin);
- }
-
- ifArg("mode", function(value) {
- options.mode = value;
- });
-
- ifArgPair(
- "entry",
- function(name, entry) {
- if (typeof options.entry[name] !== "undefined" && options.entry[name] !== null) {
- options.entry[name] = [].concat(options.entry[name]).concat(entry);
- } else {
- options.entry[name] = entry;
- }
- },
- function() {
- ensureObject(options, "entry", true);
- }
- );
-
- function bindRules(arg) {
- ifArgPair(
- arg,
- function(name, binding) {
- if (name === null) {
- name = binding;
- binding += "-loader";
- }
- const rule = {
- test: new RegExp("\\." + name.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, "\\$&") + "$"), // eslint-disable-line no-useless-escape
- loader: binding
- };
- if (arg === "module-bind-pre") {
- rule.enforce = "pre";
- } else if (arg === "module-bind-post") {
- rule.enforce = "post";
- }
- options.module.rules.push(rule);
- },
- function() {
- ensureObject(options, "module");
- ensureArray(options.module, "rules");
- }
- );
- }
- bindRules("module-bind");
- bindRules("module-bind-pre");
- bindRules("module-bind-post");
-
- let defineObject;
- ifArgPair(
- "define",
- function(name, value) {
- if (name === null) {
- name = value;
- value = true;
- }
- defineObject[name] = value;
- },
- function() {
- defineObject = {};
- },
- function() {
- const DefinePlugin = require("webpack").DefinePlugin;
- addPlugin(options, new DefinePlugin(defineObject));
- }
- );
-
- ifArg("output-path", function(value) {
- ensureObject(options, "output");
- options.output.path = path.resolve(value);
- });
-
- ifArg("output-filename", function(value) {
- ensureObject(options, "output");
-
- options.output.filename = value;
- });
-
- ifArg("output-chunk-filename", function(value) {
- ensureObject(options, "output");
- options.output.chunkFilename = value;
- });
-
- ifArg("output-source-map-filename", function(value) {
- ensureObject(options, "output");
- options.output.sourceMapFilename = value;
- });
-
- ifArg("output-public-path", function(value) {
- ensureObject(options, "output");
- options.output.publicPath = value;
- });
-
- ifArg("output-jsonp-function", function(value) {
- ensureObject(options, "output");
- options.output.jsonpFunction = value;
- });
-
- ifBooleanArg("output-pathinfo", function() {
- ensureObject(options, "output");
- options.output.pathinfo = true;
- });
-
- ifArg("output-library", function(value) {
- ensureObject(options, "output");
- ensureArray(options.output, "library");
- options.output.library.push(value);
- });
-
- ifArg("output-library-target", function(value) {
- ensureObject(options, "output");
- options.output.libraryTarget = value;
- });
-
- ifArg("records-input-path", function(value) {
- options.recordsInputPath = path.resolve(value);
- });
-
- ifArg("records-output-path", function(value) {
- options.recordsOutputPath = path.resolve(value);
- });
-
- ifArg("records-path", function(value) {
- options.recordsPath = path.resolve(value);
- });
-
- ifArg("target", function(value) {
- options.target = value;
- });
-
- mapArgToBoolean("cache");
-
- ifBooleanArg("hot", function() {
- const HotModuleReplacementPlugin = require("webpack").HotModuleReplacementPlugin;
- addPlugin(options, new HotModuleReplacementPlugin());
- });
-
- ifBooleanArg("debug", function() {
- const LoaderOptionsPlugin = require("webpack").LoaderOptionsPlugin;
- addPlugin(
- options,
- new LoaderOptionsPlugin({
- debug: true
- })
- );
- });
-
- ifArg("devtool", function(value) {
- options.devtool = value;
- });
-
- function processResolveAlias(arg, key) {
- ifArgPair(arg, function(name, value) {
- if (!name) {
- throw new Error("--" + arg + " <string>=<string>");
- }
- ensureObject(options, key);
- ensureObject(options[key], "alias");
- options[key].alias[name] = value;
- });
- }
- processResolveAlias("resolve-alias", "resolve");
- processResolveAlias("resolve-loader-alias", "resolveLoader");
-
- ifArg("resolve-extensions", function(value) {
- ensureObject(options, "resolve");
- if (Array.isArray(value)) {
- options.resolve.extensions = value;
- } else {
- options.resolve.extensions = value.split(/,\s*/);
- }
- });
-
- ifArg("optimize-max-chunks", function(value) {
- const LimitChunkCountPlugin = require("webpack").optimize.LimitChunkCountPlugin;
- addPlugin(
- options,
- new LimitChunkCountPlugin({
- maxChunks: parseInt(value, 10)
- })
- );
- });
-
- ifArg("optimize-min-chunk-size", function(value) {
- const MinChunkSizePlugin = require("webpack").optimize.MinChunkSizePlugin;
- addPlugin(
- options,
- new MinChunkSizePlugin({
- minChunkSize: parseInt(value, 10)
- })
- );
- });
-
- ifBooleanArg("optimize-minimize", function() {
- const LoaderOptionsPlugin = require("webpack").LoaderOptionsPlugin;
- addPlugin(
- options,
- new LoaderOptionsPlugin({
- minimize: true
- })
- );
- });
-
- ifArg("prefetch", function(request) {
- const PrefetchPlugin = require("webpack").PrefetchPlugin;
- addPlugin(options, new PrefetchPlugin(request));
- });
-
- ifArg("provide", function(value) {
- const idx = value.indexOf("=");
- let name;
- if (idx >= 0) {
- name = value.substr(0, idx);
- value = value.substr(idx + 1);
- } else {
- name = value;
- }
- const ProvidePlugin = require("webpack").ProvidePlugin;
- addPlugin(options, new ProvidePlugin(name, value));
- });
-
- ifArg("plugin", function(value) {
- addPlugin(options, loadPlugin(value));
- });
-
- mapArgToBoolean("bail");
-
- mapArgToBoolean("profile");
-
- if (argv._.length > 0) {
- ensureObject(options, "entry", true);
-
- const addTo = function addTo(name, entry) {
- if (options.entry[name]) {
- if (!Array.isArray(options.entry[name])) {
- options.entry[name] = [options.entry[name]];
- }
- options.entry[name].push(entry);
- } else {
- options.entry[name] = entry;
- }
- };
- argv._.forEach(function(content) {
- const i = content.indexOf("=");
- const j = content.indexOf("?");
- if (i < 0 || (j >= 0 && j < i)) {
- const resolved = path.resolve(content);
- if (fs.existsSync(resolved)) {
- addTo("main", `${resolved}${fs.statSync(resolved).isDirectory() ? path.sep : ""}`);
- } else {
- addTo("main", content);
- }
- } else {
- addTo(content.substr(0, i), content.substr(i + 1));
- }
- });
- }
- }
-};

bin/errorHelpers.js

@@ -1,33 +0,0 @@
-/*
- MIT License http://www.opensource.org/licenses/mit-license.php
- Author Tobias Koppers @sokra
-*/
-"use strict";
-
-const webpackOptionsFlag = "WEBPACK_OPTIONS";
-
-exports.cutOffByFlag = (stack, flag) => {
- stack = stack.split("\n");
- for (let i = 0; i < stack.length; i++) if (stack[i].indexOf(flag) >= 0) stack.length = i;
- return stack.join("\n");
-};
-
-exports.cutOffWebpackOptions = stack => exports.cutOffByFlag(stack, webpackOptionsFlag);
-
-exports.cutOffMultilineMessage = (stack, message) => {
- stack = stack.split("\n");
- message = message.split("\n");
-
- return stack
- .reduce(
- (acc, line, idx) => (line === message[idx] || line === `Error: ${message[idx]}` ? acc : acc.concat(line)),
- []
- )
- .join("\n");
-};
-
-exports.cleanUpWebpackOptions = (stack, message) => {
- stack = exports.cutOffWebpackOptions(stack);
- stack = exports.cutOffMultilineMessage(stack, message);
- return stack;
-};

bin/.eslintrc.js

@@ -0,0 +1,63 @@
+module.exports = {
+ root: true,
+ plugins: ["node"],
+ extends: ["../.eslintrc.js", "plugin:node/recommended"],
+ env: {
+ node: true,
+ es6: true,
+ jest: true
+ },
+ parserOptions: { ecmaVersion: 2017, sourceType: "module" },
+ rules: {
+ "node/no-unsupported-features": ["error", { version: 6 }],
+ "node/no-deprecated-api": "error",
+ "node/no-missing-import": "error",
+ "node/no-missing-require": [
+ "error",
+ {
+ resolvePaths: ["./packages"],
+ allowModules: [
+ "webpack",
+ "@webpack-cli/generators",
+ "@webpack-cli/init",
+ "@webpack-cli/migrate",
+ "@webpack-cli/utils",
+ "@webpack-cli/generate-loader",
+ "@webpack-cli/generate-plugin",
+ "@webpack-cli/webpack-scaffold"
+ ]
+ }
+ ],
+ "node/no-unpublished-bin": "error",
+ "node/no-unpublished-require": [
+ "error",
+ {
+ allowModules: [
+ "webpack",
+ "webpack-dev-server",
+ "@webpack-cli/generators",
+ "@webpack-cli/init",
+ "@webpack-cli/migrate",
+ "@webpack-cli/utils",
+ "@webpack-cli/generate-loader",
+ "@webpack-cli/generate-plugin",
+ "@webpack-cli/webpack-scaffold"
+ ]
+ }
+ ],
+ "node/no-extraneous-require": [
+ "error",
+ {
+ allowModules: [
+ "@webpack-cli/migrate",
+ "@webpack-cli/generators",
+ "@webpack-cli/utils",
+ "@webpack-cli/generate-loader",
+ "@webpack-cli/generate-plugin",
+ "@webpack-cli/webpack-scaffold"
+ ]
+ }
+ ],
+ "node/process-exit-as-throw": "error"
+ }
+};

bin/opencollective.js

@@ -0,0 +1,38 @@
+const chalk = require("chalk");
+
+// Only show emoji on OSx (Windows shell doesn't like them that much ¯\_(ツ)_/¯ )
+function emoji(emoji) {
+ if (process.stdout.isTTY && process.platform === "darwin") {
+ return emoji;
+ } else {
+ return "";
+ }
+}
+
+function print(str = "", color = "dim") {
+ const terminalCols = 80;
+ // eslint-disable-next-line no-control-regex
+ const ansiEscapeSeq = /\u001b\[[0-9]{1,2}m/g;
+ const strLength = str.replace(ansiEscapeSeq, "").length;
+ const leftPaddingLength = Math.floor((terminalCols - strLength) / 2);
+ const leftPadding = " ".repeat(leftPaddingLength);
+ str = chalk[color](str);
+ console.log(leftPadding, str);
+}
+
+function printBadge() {
+ console.log("\n");
+ print(`${chalk.bold("Thanks for using")} ${chalk.bold.blue("Webpack!")}`);
+ print(`Please consider donating to our ${chalk.bold.blue("Open Collective")}`);
+ print("to help us maintain this package.");
+ console.log("\n\n");
+ print(`${emoji("👉")} ${chalk.bold.yellow(" Donate:")} ${chalk.reset.underline.yellow("https://opencollective.com/webpack/donate")}`);
+ console.log("\n");
+}
+
+function isTrue(value) {
+ return !!value && value !== "0" && value !== "false";
+}
+const envDisable = isTrue(process.env.DISABLE_OPENCOLLECTIVE) || isTrue(process.env.CI);
+
+if (!envDisable) printBadge();

bin/optionsSchema.json

@@ -1,1989 +0,0 @@
-{
- "additionalProperties": false,
- "definitions": {
- "common.pluginFunction": {
- "description": "Function acting as plugin",
- "instanceof": "Function",
- "properties": {
- "apply": {
- "description": "The run point of the plugin, required method.",
- "instanceof": "Function"
- }
- },
- "additionalProperties": true,
- "required": [
- "apply"
- ]
- },
- "common.pluginObject": {
- "description": "Plugin instance",
- "type": "object",
- "properties": {
- "apply": {
- "description": "The run point of the plugin, required method.",
- "instanceof": "Function"
- }
- },
- "additionalProperties": true,
- "required": [
- "apply"
- ]
- },
- "common.arrayOfStringOrStringArrayValues": {
- "items": {
- "description": "string or array of strings",
- "anyOf": [
- {
- "minLength": 1,
- "type": "string"
- },
- {
- "items": {
- "description": "A non-empty string",
- "minLength": 1,
- "type": "string"
- },
- "type": "array"
- }
- ]
- },
- "type": "array"
- },
- "common.arrayOfStringValues": {
- "items": {
- "description": "A non-empty string",
- "minLength": 1,
- "type": "string"
- },
- "type": "array"
- },
- "common.nonEmptyArrayOfUniqueStringValues": {
- "items": {
- "description": "A non-empty string",
- "minLength": 1,
- "type": "string"
- },
- "minItems": 1,
- "type": "array",
- "uniqueItems": true
- },
- "entry": {
- "oneOf": [
- {
- "minProperties": 1,
- "additionalProperties": {
- "description": "An entry point with name",
- "oneOf": [
- {
- "description": "The string is resolved to a module which is loaded upon startup.",
- "minLength": 1,
- "type": "string"
- },
- {
- "description": "All modules are loaded upon startup. The last one is exported.",
- "anyOf": [
- {
- "$ref": "#/definitions/common.nonEmptyArrayOfUniqueStringValues"
- }
- ]
- }
- ]
- },
- "description": "Multiple entry bundles are created. The key is the chunk name. The value can be a string or an array.",
- "type": "object"
- },
- {
- "description": "An entry point without name. The string is resolved to a module which is loaded upon startup.",
- "minLength": 1,
- "type": "string"
- },
- {
- "description": "An entry point without name. All modules are loaded upon startup. The last one is exported.",
- "anyOf": [
- {
- "$ref": "#/definitions/common.nonEmptyArrayOfUniqueStringValues"
- }
- ]
- },
- {
- "description": "A Function returning an entry object, an entry string, an entry array or a promise to these things.",
- "instanceof": "Function"
- }
- ]
- },
- "externals": {
- "anyOf": [
- {
- "description": "An exact matched dependency becomes external. The same string is used as external dependency.",
- "type": "string"
- },
- {
- "additionalProperties": {
- "description": "The dependency used for the external",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "object"
- },
- {
- "type": "boolean"
- }
- ]
- },
- "description": "If an dependency matches exactly a property of the object, the property value is used as dependency.",
- "type": "object"
- },
- {
- "description": "`function(context, request, callback(err, result))` The function is called on each dependency.",
- "instanceof": "Function"
- },
- {
- "description": "Every matched dependency becomes external.",
- "instanceof": "RegExp"
- },
- {
- "items": {
- "description": "External configuration",
- "anyOf": [
- {
- "$ref": "#/definitions/externals"
- }
- ]
- },
- "type": "array"
- }
- ]
- },
- "module": {
- "additionalProperties": false,
- "properties": {
- "exprContextCritical": {
- "description": "Enable warnings for full dynamic dependencies",
- "type": "boolean"
- },
- "exprContextRecursive": {
- "description": "Enable recursive directory lookup for full dynamic dependencies",
- "type": "boolean"
- },
- "exprContextRegExp": {
- "description": "Sets the default regular expression for full dynamic dependencies",
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "instanceof": "RegExp"
- }
- ]
- },
- "exprContextRequest": {
- "description": "Set the default request for full dynamic dependencies",
- "type": "string"
- },
- "noParse": {
- "description": "Don't parse files matching. It's matched against the full resolved request.",
- "anyOf": [
- {
- "items": {
- "description": "A regular expression, when matched the module is not parsed",
- "instanceof": "RegExp"
- },
- "minItems": 1,
- "type": "array"
- },
- {
- "instanceof": "RegExp"
- },
- {
- "instanceof": "Function"
- },
- {
- "items": {
- "description": "An absolute path, when the module starts with this path it is not parsed",
- "type": "string",
- "absolutePath": true
- },
- "minItems": 1,
- "type": "array"
- },
- {
- "type": "string",
- "absolutePath": true
- }
- ]
- },
- "rules": {
- "allOf": [
- {
- "$ref": "#/definitions/ruleSet-rules"
- }
- ],
- "description": "An array of rules applied for modules."
- },
- "defaultRules": {
- "description": "An array of rules applied by default for modules.",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-rules"
- }
- ]
- },
- "unknownContextCritical": {
- "description": "Enable warnings when using the require function in a not statically analyse-able way",
- "type": "boolean"
- },
- "unknownContextRecursive": {
- "description": "Enable recursive directory lookup when using the require function in a not statically analyse-able way",
- "type": "boolean"
- },
- "unknownContextRegExp": {
- "description": "Sets the regular expression when using the require function in a not statically analyse-able way",
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "instanceof": "RegExp"
- }
- ]
- },
- "unknownContextRequest": {
- "description": "Sets the request when using the require function in a not statically analyse-able way",
- "type": "string"
- },
- "unsafeCache": {
- "description": "Cache the resolving of module requests",
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "instanceof": "Function"
- }
- ]
- },
- "wrappedContextCritical": {
- "description": "Enable warnings for partial dynamic dependencies",
- "type": "boolean"
- },
- "wrappedContextRecursive": {
- "description": "Enable recursive directory lookup for partial dynamic dependencies",
- "type": "boolean"
- },
- "wrappedContextRegExp": {
- "description": "Set the inner regular expression for partial dynamic dependencies",
- "instanceof": "RegExp"
- },
- "strictExportPresence": {
- "description": "Emit errors instead of warnings when imported names don't exist in imported module",
- "type": "boolean"
- },
- "strictThisContextOnImports": {
- "description": "Handle the this context correctly according to the spec for namespace objects",
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "output": {
- "additionalProperties": false,
- "properties": {
- "auxiliaryComment": {
- "description": "Add a comment in the UMD wrapper.",
- "anyOf": [
- {
- "description": "Append the same comment above each import style.",
- "type": "string"
- },
- {
- "additionalProperties": false,
- "description": "Set explicit comments for `commonjs`, `commonjs2`, `amd`, and `root`.",
- "properties": {
- "amd": {
- "description": "Set comment for `amd` section in UMD",
- "type": "string"
- },
- "commonjs": {
- "description": "Set comment for `commonjs` (exports) section in UMD",
- "type": "string"
- },
- "commonjs2": {
- "description": "Set comment for `commonjs2` (module.exports) section in UMD",
- "type": "string"
- },
- "root": {
- "description": "Set comment for `root` (global variable) section in UMD",
- "type": "string"
- }
- },
- "type": "object"
- }
- ]
- },
- "chunkFilename": {
- "description": "The filename of non-entry chunks as relative path inside the `output.path` directory.",
- "type": "string",
- "absolutePath": false
- },
- "webassemblyModuleFilename": {
- "description": "The filename of WebAssembly modules as relative path inside the `output.path` directory.",
- "type": "string",
- "absolutePath": false
- },
- "globalObject": {
- "description": "An expression which is used to address the global object/scope in runtime code",
- "type": "string",
- "minLength": 1
- },
- "crossOriginLoading": {
- "description": "This option enables cross-origin loading of chunks.",
- "enum": [
- false,
- "anonymous",
- "use-credentials"
- ]
- },
- "jsonpScriptType": {
- "description": "This option enables loading async chunks via a custom script type, such as script type=\"module\"",
- "enum": [
- false,
- "text/javascript",
- "module"
- ]
- },
- "chunkLoadTimeout": {
- "description": "Number of milliseconds before chunk request expires",
- "type": "number"
- },
- "devtoolFallbackModuleFilenameTemplate": {
- "description": "Similar to `output.devtoolModuleFilenameTemplate`, but used in the case of duplicate module identifiers.",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "instanceof": "Function"
- }
- ]
- },
- "devtoolLineToLine": {
- "description": "Enable line to line mapped mode for all/specified modules. Line to line mapped mode uses a simple SourceMap where each line of the generated source is mapped to the same line of the original source. It’s a performance optimization. Only use it if your performance need to be better and you are sure that input lines match which generated lines.",
- "anyOf": [
- {
- "description": "`true` enables it for all modules (not recommended)",
- "type": "boolean"
- },
- {
- "description": "An object similar to `module.loaders` enables it for specific files.",
- "type": "object"
- }
- ]
- },
- "devtoolModuleFilenameTemplate": {
- "description": "Filename template string of function for the sources array in a generated SourceMap.",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "instanceof": "Function"
- }
- ]
- },
- "devtoolNamespace": {
- "description": "Module namespace to use when interpolating filename template string for the sources array in a generated SourceMap. Defaults to `output.library` if not set. It's useful for avoiding runtime collisions in sourcemaps from multiple webpack projects built as libraries.",
- "type": "string"
- },
- "filename": {
- "description": "Specifies the name of each output file on disk. You must **not** specify an absolute path here! The `output.path` option determines the location on disk the files are written to, filename is used solely for naming the individual files.",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "instanceof": "Function"
- }
- ],
- "absolutePath": false
- },
- "hashDigest": {
- "description": "Digest type used for the hash",
- "enum": [
- "latin1",
- "hex",
- "base64"
- ]
- },
- "hashDigestLength": {
- "description": "Number of chars which are used for the hash",
- "minimum": 1,
- "type": "number"
- },
- "hashFunction": {
- "description": "Algorithm used for generation the hash (see node.js crypto package)",
- "anyOf": [
- {
- "type": "string",
- "minLength": 1
- },
- {
- "instanceof": "Function"
- }
- ]
- },
- "hashSalt": {
- "description": "Any string which is added to the hash to salt it",
- "minLength": 1,
- "type": "string"
- },
- "hotUpdateChunkFilename": {
- "description": "The filename of the Hot Update Chunks. They are inside the output.path directory.",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "instanceof": "Function"
- }
- ],
- "absolutePath": false
- },
- "hotUpdateFunction": {
- "description": "The JSONP function used by webpack for async loading of hot update chunks.",
- "type": "string"
- },
- "hotUpdateMainFilename": {
- "description": "The filename of the Hot Update Main File. It is inside the `output.path` directory.",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "instanceof": "Function"
- }
- ],
- "absolutePath": false
- },
- "jsonpFunction": {
- "description": "The JSONP function used by webpack for async loading of chunks.",
- "type": "string"
- },
- "chunkCallbackName": {
- "description": "The callback function name used by webpack for loading of chunks in WebWorkers.",
- "type": "string"
- },
- "library": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "items": {
- "description": "A part of the library name",
- "type": "string"
- },
- "type": "array"
- },
- {
- "type": "object",
- "additionalProperties": false,
- "properties": {
- "root": {
- "description": "Name of the property exposed globally by a UMD library",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "$ref": "#/definitions/common.arrayOfStringValues"
- }
- ]
- },
- "amd": {
- "description": "Name of the exposed AMD library in the UMD",
- "type": "string"
- },
- "commonjs": {
- "description": "Name of the exposed commonjs export in the UMD",
- "type": "string"
- }
- }
- }
- ],
- "description": "If set, export the bundle as library. `output.library` is the name."
- },
- "libraryTarget": {
- "description": "Type of library",
- "enum": [
- "var",
- "assign",
- "this",
- "window",
- "self",
- "global",
- "commonjs",
- "commonjs2",
- "commonjs-module",
- "amd",
- "umd",
- "umd2",
- "jsonp"
- ]
- },
- "libraryExport": {
- "description": "Specify which export should be exposed as library",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "$ref": "#/definitions/common.arrayOfStringValues"
- }
- ]
- },
- "path": {
- "description": "The output directory as **absolute path** (required).",
- "type": "string",
- "absolutePath": true
- },
- "pathinfo": {
- "description": "Include comments with information about the modules.",
- "type": "boolean"
- },
- "publicPath": {
- "description": "The `publicPath` specifies the public URL address of the output files when referenced in a browser.",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "instanceof": "Function"
- }
- ]
- },
- "sourceMapFilename": {
- "description": "The filename of the SourceMaps for the JavaScript files. They are inside the `output.path` directory.",
- "type": "string",
- "absolutePath": false
- },
- "sourcePrefix": {
- "description": "Prefixes every line of the source in the bundle with this string.",
- "type": "string"
- },
- "strictModuleExceptionHandling": {
- "description": "Handles exceptions in module loading correctly at a performance cost.",
- "type": "boolean"
- },
- "umdNamedDefine": {
- "description": "If `output.libraryTarget` is set to umd and `output.library` is set, setting this to true will name the AMD module.",
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "resolve": {
- "additionalProperties": false,
- "properties": {
- "alias": {
- "description": "Redirect module requests",
- "anyOf": [
- {
- "additionalProperties": {
- "description": "New request",
- "type": "string"
- },
- "type": "object"
- },
- {
- "items": {
- "description": "Alias configuration",
- "additionalProperties": false,
- "properties": {
- "alias": {
- "description": "New request",
- "type": "string"
- },
- "name": {
- "description": "Request to be redirected",
- "type": "string"
- },
- "onlyModule": {
- "description": "Redirect only exact matching request",
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "type": "array"
- }
- ]
- },
- "aliasFields": {
- "description": "Fields in the description file (package.json) which are used to redirect requests inside the module",
- "anyOf": [
- {
- "$ref": "#/definitions/common.arrayOfStringOrStringArrayValues"
- }
- ]
- },
- "cachePredicate": {
- "description": "Predicate function to decide which requests should be cached",
- "instanceof": "Function"
- },
- "cacheWithContext": {
- "description": "Include the context information in the cache identifier when caching",
- "type": "boolean"
- },
- "descriptionFiles": {
- "description": "Filenames used to find a description file",
- "anyOf": [
- {
- "$ref": "#/definitions/common.arrayOfStringValues"
- }
- ]
- },
- "enforceExtension": {
- "description": "Enforce using one of the extensions from the extensions option",
- "type": "boolean"
- },
- "enforceModuleExtension": {
- "description": "Enforce using one of the module extensions from the moduleExtensions option",
- "type": "boolean"
- },
- "extensions": {
- "description": "Extensions added to the request when trying to find the file",
- "anyOf": [
- {
- "$ref": "#/definitions/common.arrayOfStringValues"
- }
- ]
- },
- "fileSystem": {
- "description": "Filesystem for the resolver"
- },
- "mainFields": {
- "description": "Field names from the description file (package.json) which are used to find the default entry point",
- "anyOf": [
- {
- "$ref": "#/definitions/common.arrayOfStringOrStringArrayValues"
- }
- ]
- },
- "mainFiles": {
- "description": "Filenames used to find the default entry point if there is no description file or main field",
- "anyOf": [
- {
- "$ref": "#/definitions/common.arrayOfStringValues"
- }
- ]
- },
- "moduleExtensions": {
- "description": "Extensions added to the module request when trying to find the module",
- "anyOf": [
- {
- "$ref": "#/definitions/common.arrayOfStringValues"
- }
- ]
- },
- "modules": {
- "description": "Folder names or directory paths where to find modules",
- "anyOf": [
- {
- "$ref": "#/definitions/common.arrayOfStringValues"
- }
- ]
- },
- "plugins": {
- "description": "Plugins for the resolver",
- "type": "array",
- "items": {
- "description": "Plugin of type object or instanceof Function",
- "anyOf": [
- {
- "$ref": "#/definitions/common.pluginObject"
- },
- {
- "$ref": "#/definitions/common.pluginFunction"
- }
- ]
- }
- },
- "resolver": {
- "description": "Custom resolver"
- },
- "symlinks": {
- "description": "Enable resolving symlinks to the original location",
- "type": "boolean"
- },
- "concord": {
- "description": "Enable concord resolving extras",
- "type": "boolean"
- },
- "unsafeCache": {
- "description": "Enable caching of successfully resolved requests",
- "anyOf": [
- {
- "type": "boolean"
- },
- {
- "additionalProperties": true,
- "type": "object"
- }
- ]
- },
- "useSyncFileSystemCalls": {
- "description": "Use synchronous filesystem calls for the resolver",
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "ruleSet-condition": {
- "anyOf": [
- {
- "instanceof": "RegExp"
- },
- {
- "minLength": 1,
- "type": "string"
- },
- {
- "instanceof": "Function"
- },
- {
- "$ref": "#/definitions/ruleSet-conditions"
- },
- {
- "additionalProperties": false,
- "properties": {
- "and": {
- "description": "Logical AND",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-conditions"
- }
- ]
- },
- "exclude": {
- "description": "Exclude all modules matching any of these conditions",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- }
- ]
- },
- "include": {
- "description": "Exclude all modules matching not any of these conditions",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- }
- ]
- },
- "not": {
- "description": "Logical NOT",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-conditions"
- }
- ]
- },
- "or": {
- "description": "Logical OR",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-conditions"
- }
- ]
- },
- "test": {
- "description": "Exclude all modules matching any of these conditions",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- }
- ]
- }
- },
- "type": "object"
- }
- ]
- },
- "ruleSet-conditions": {
- "items": {
- "description": "A rule condition",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- }
- ]
- },
- "type": "array"
- },
- "ruleSet-loader": {
- "minLength": 1,
- "type": "string"
- },
- "ruleSet-query": {
- "anyOf": [
- {
- "type": "object"
- },
- {
- "type": "string"
- }
- ]
- },
- "ruleSet-rule": {
- "additionalProperties": false,
- "properties": {
- "enforce": {
- "description": "Enforce this rule as pre or post step",
- "enum": [
- "pre",
- "post"
- ]
- },
- "exclude": {
- "description": "Shortcut for resource.exclude",
- "allOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- },
- {
- "absolutePath": true
- }
- ]
- },
- "include": {
- "description": "Shortcut for resource.include",
- "allOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- },
- {
- "absolutePath": true
- }
- ]
- },
- "issuer": {
- "description": "Match the issuer of the module (The module pointing to this module)",
- "allOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- },
- {
- "absolutePath": true
- }
- ]
- },
- "loader": {
- "description": "Shortcut for use.loader",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-loader"
- },
- {
- "$ref": "#/definitions/ruleSet-use"
- }
- ]
- },
- "loaders": {
- "description": "Shortcut for use.loader",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-use"
- }
- ]
- },
- "oneOf": {
- "description": "Only execute the first matching rule in this array",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-rules"
- }
- ]
- },
- "options": {
- "description": "Shortcut for use.options",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-query"
- }
- ]
- },
- "parser": {
- "description": "Options for parsing",
- "additionalProperties": true,
- "type": "object"
- },
- "resolve": {
- "description": "Options for the resolver",
- "type": "object",
- "anyOf": [
- {
- "$ref": "#/definitions/resolve"
- }
- ]
- },
- "sideEffects": {
- "description": "Flags a module as with or without side effects",
- "type": "boolean"
- },
- "query": {
- "description": "Shortcut for use.query",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-query"
- }
- ]
- },
- "type": {
- "description": "Module type to use for the module",
- "enum": [
- "javascript/auto",
- "javascript/dynamic",
- "javascript/esm",
- "json",
- "webassembly/experimental"
- ]
- },
- "resource": {
- "description": "Match the resource path of the module",
- "allOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- },
- {
- "absolutePath": true
- }
- ]
- },
- "resourceQuery": {
- "description": "Match the resource query of the module",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- }
- ]
- },
- "compiler": {
- "description": "Match the child compiler name",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- }
- ]
- },
- "rules": {
- "description": "Match and execute these rules when this rule is matched",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-rules"
- }
- ]
- },
- "test": {
- "description": "Shortcut for resource.test",
- "allOf": [
- {
- "$ref": "#/definitions/ruleSet-condition"
- },
- {
- "absolutePath": true
- }
- ]
- },
- "use": {
- "description": "Modifiers applied to the module when rule is matched",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-use"
- }
- ]
- }
- },
- "type": "object"
- },
- "ruleSet-rules": {
- "items": {
- "description": "A rule",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-rule"
- }
- ]
- },
- "type": "array"
- },
- "ruleSet-use": {
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-use-item"
- },
- {
- "instanceof": "Function"
- },
- {
- "items": {
- "description": "An use item",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-use-item"
- }
- ]
- },
- "type": "array"
- }
- ]
- },
- "ruleSet-use-item": {
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-loader"
- },
- {
- "instanceof": "Function"
- },
- {
- "additionalProperties": false,
- "properties": {
- "loader": {
- "description": "Loader name",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-loader"
- }
- ]
- },
- "options": {
- "description": "Loader options",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-query"
- }
- ]
- },
- "ident": {
- "description": "Unique loader identifier",
- "type": "string"
- },
- "query": {
- "description": "Loader query",
- "anyOf": [
- {
- "$ref": "#/definitions/ruleSet-query"
- }
- ]
- }
- },
- "type": "object"
- }
- ]
- },
- "filter-item-types": {
- "anyOf": [
- {
- "instanceof": "RegExp"
- },
- {
- "type": "string"
- },
- {
- "instanceof": "Function"
- }
- ]
- },
- "filter-types": {
- "anyOf": [
- {
- "$ref": "#/definitions/filter-item-types"
- },
- {
- "type": "array",
- "items": {
- "description": "Rule to filter",
- "anyOf": [
- {
- "$ref": "#/definitions/filter-item-types"
- }
- ]
- }
- }
- ]
- }
- },
- "properties": {
- "mode": {
- "description": "Enable production optimizations or development hints.",
- "enum": [
- "development",
- "production",
- "none"
- ]
- },
- "amd": {
- "description": "Set the value of `require.amd` and `define.amd`."
- },
- "bail": {
- "description": "Report the first error as a hard error instead of tolerating it.",
- "type": "boolean"
- },
- "cache": {
- "description": "Cache generated modules and chunks to improve performance for multiple incremental builds.",
- "anyOf": [
- {
- "description": "You can pass `false` to disable it.",
- "type": "boolean"
- },
- {
- "description": "You can pass an object to enable it and let webpack use the passed object as cache. This way you can share the cache object between multiple compiler calls.",
- "type": "object"
- }
- ]
- },
- "context": {
- "description": "The base directory (absolute path!) for resolving the `entry` option. If `output.pathinfo` is set, the included pathinfo is shortened to this directory.",
- "type": "string",
- "absolutePath": true
- },
- "dependencies": {
- "description": "References to other configurations to depend on.",
- "items": {
- "description": "References to another configuration to depend on.",
- "type": "string"
- },
- "type": "array"
- },
- "devServer": {
- "description": "Options for the webpack-dev-server",
- "type": "object"
- },
- "devtool": {
- "description": "A developer tool to enhance debugging.",
- "anyOf": [
- {
- "type": "string"
- },
- {
- "enum": [
- false
- ]
- }
- ]
- },
- "entry": {
- "description": "The entry point(s) of the compilation.",
- "anyOf": [
- {
- "$ref": "#/definitions/entry"
- }
- ]
- },
- "externals": {
- "description": "Specify dependencies that shouldn't be resolved by webpack, but should become dependencies of the resulting bundle. The kind of the dependency depends on `output.libraryTarget`.",
- "anyOf": [
- {
- "$ref": "#/definitions/externals"
- }
- ]
- },
- "loader": {
- "description": "Custom values available in the loader context.",
- "type": "object"
- },
- "module": {
- "description": "Options affecting the normal modules (`NormalModuleFactory`).",
- "anyOf": [
- {
- "$ref": "#/definitions/module"
- }
- ]
- },
- "name": {
- "description": "Name of the configuration. Used when loading multiple configurations.",
- "type": "string"
- },
- "node": {
- "description": "Include polyfills or mocks for various node stuff.",
- "anyOf": [
- {
- "enum": [
- false
- ]
- },
- {
- "additionalProperties": {
- "description": "Include a polyfill for the node.js module",
- "enum": [
- false,
- true,
- "mock",
- "empty"
- ]
- },
- "properties": {
- "Buffer": {
- "description": "Include a polyfill for the 'Buffer' variable",
- "enum": [
- false,
- true,
- "mock"
- ]
- },
- "__dirname": {
- "description": "Include a polyfill for the '__dirname' variable",
- "enum": [
- false,
- true,
- "mock"
- ]
- },
- "__filename": {
- "description": "Include a polyfill for the '__filename' variable",
- "enum": [
- false,
- true,
- "mock"
- ]
- },
- "console": {
- "description": "Include a polyfill for the 'console' variable",
- "enum": [
- false,
- true,
- "mock"
- ]
- },
- "global": {
- "description": "Include a polyfill for the 'global' variable",
- "type": "boolean"
- },
- "process": {
- "description": "Include a polyfill for the 'process' variable",
- "enum": [
- false,
- true,
- "mock"
- ]
- }
- },
- "type": "object"
- }
- ]
- },
- "output": {
- "description": "Options affecting the output of the compilation. `output` options tell webpack how to write the compiled files to disk.",
- "anyOf": [
- {
- "$ref": "#/definitions/output"
- }
- ]
- },
- "optimization": {
- "description": "Enables/Disables integrated optimizations",
- "type": "object",
- "additionalProperties": false,
- "properties": {
- "removeAvailableModules": {
- "description": "Removes modules from chunks when these modules are already included in all parents",
- "type": "boolean"
- },
- "removeEmptyChunks": {
- "description": "Remove chunks which are empty",
- "type": "boolean"
- },
- "mergeDuplicateChunks": {
- "description": "Merge chunks which contain the same modules",
- "type": "boolean"
- },
- "flagIncludedChunks": {
- "description": "Also flag chunks as loaded which contain a subset of the modules",
- "type": "boolean"
- },
- "occurrenceOrder": {
- "description": "Figure out a order of modules which results in the smallest initial bundle",
- "type": "boolean"
- },
- "sideEffects": {
- "description": "Skip over modules which are flagged to contain no side effects when exports are not used",
- "type": "boolean"
- },
- "providedExports": {
- "description": "Figure out which exports are provided by modules to generate more efficient code",
- "type": "boolean"
- },
- "usedExports": {
- "description": "Figure out which exports are used by modules to mangle export names, omit unused exports and generate more efficient code",
- "type": "boolean"
- },
- "concatenateModules": {
- "description": "Concatenate modules when possible to generate less modules, more efficient code and enable more optimizations by the minimizer",
- "type": "boolean"
- },
- "splitChunks": {
- "description": "Optimize duplication and caching by splitting chunks by shared modules and cache group",
- "oneOf": [
- {
- "enum": [
- false
- ]
- },
- {
- "type": "object",
- "additionalProperties": false,
- "properties": {
- "chunks": {
- "description": "Select chunks for determining shared modules (defaults to \"async\", \"initial\" and \"all\" requires adding these chunks to the HTML)",
- "oneOf": [
- {
- "enum": [
- "initial",
- "async",
- "all"
- ]
- },
- {
- "instanceof": "Function"
- }
- ]
- },
- "minSize": {
- "description": "Minimal size for the created chunk",
- "type": "number",
- "minimum": 0
- },
- "minChunks": {
- "description": "Minimum number of times a module has to be duplicated until it's considered for splitting",
- "type": "number",
- "minimum": 1
- },
- "maxAsyncRequests": {
- "description": "Maximum number of requests which are accepted for on-demand loading",
- "type": "number",
- "minimum": 1
- },
- "maxInitialRequests": {
- "description": "Maximum number of initial chunks which are accepted for an entry point",
- "type": "number",
- "minimum": 1
- },
- "name": {
- "description": "Give chunks created a name (chunks with equal name are merged)",
- "oneOf": [
- {
- "type": "boolean"
- },
- {
- "instanceof": "Function"
- },
- {
- "type": "string"
- }
- ]
- },
- "filename": {
- "description": "Sets the template for the filename for created chunks (Only works for initial chunks)",
- "type": "string",
- "minLength": 1
- },
- "automaticNameDelimiter": {
- "description": "Sets the name delimiter for created chunks",
- "type": "string",
- "minLength": 1
- },
- "cacheGroups": {
- "description": "Assign modules to a cache group (modules from different cache groups are tried to keep in separate chunks)",
- "type": "object",
- "additionalProperties": {
- "description": "Configuration for a cache group",
- "anyOf": [
- {
- "enum": [
- false
- ]
- },
- {
- "instanceof": "Function"
- },
- {
- "type": "string"
- },
- {
- "instanceof": "RegExp"
- },
- {
- "type": "object",
- "additionalProperties": false,
- "properties": {
- "test": {
- "description": "Assign modules to a cache group",
- "oneOf": [
- {
- "instanceof": "Function"
- },
- {
- "type": "string"
- },
- {
- "instanceof": "RegExp"
- }
- ]
- },
- "chunks": {
- "description": "Select chunks for determining cache group content (defaults to \"initial\", \"initial\" and \"all\" requires adding these chunks to the HTML)",
- "oneOf": [
- {
- "enum": [
- "initial",
- "async",
- "all"
- ]
- },
- {
- "instanceof": "Function"
- }
- ]
- },
- "enforce": {
- "description": "Ignore minimum size, minimum chunks and maximum requests and always create chunks for this cache group",
- "type": "boolean"
- },
- "priority": {
- "description": "Priority of this cache group",
- "type": "number"
- },
- "minSize": {
- "description": "Minimal size for the created chunk",
- "type": "number",
- "minimum": 0
- },
- "minChunks": {
- "description": "Minimum number of times a module has to be duplicated until it's considered for splitting",
- "type": "number",
- "minimum": 1
- },
- "maxAsyncRequests": {
- "description": "Maximum number of requests which are accepted for on-demand loading",
- "type": "number",
- "minimum": 1
- },
- "maxInitialRequests": {
- "description": "Maximum number of initial chunks which are accepted for an entry point",
- "type": "number",
- "minimum": 1
- },
- "reuseExistingChunk": {
- "description": "Try to reuse existing chunk (with name) when it has matching modules",
- "type": "boolean"
- },
- "name": {
- "description": "Give chunks for this cache group a name (chunks with equal name are merged)",
- "oneOf": [
- {
- "type": "boolean"
- },
- {
- "instanceof": "Function"
- },
- {
- "type": "string"
- }
- ]
- },
- "filename": {
- "description": "Sets the template for the filename for created chunks (Only works for initial chunks)",
- "type": "string",
- "minLength": 1
- }
- }
- }
- ]
- }
- }
- }
- }
- ]
- },
- "runtimeChunk": {
- "description": "Create an additional chunk which contains only the webpack runtime and chunk hash maps",
- "oneOf": [
- {
- "type": "boolean"
- },
- {
- "enum": [
- "single",
- "multiple"
- ]
- },
- {
- "type": "object",
- "additionalProperties": false,
- "properties": {
- "name": {
- "description": "The name or name factory for the runtime chunks",
- "oneOf": [
- {
- "type": "string"
- },
- {
- "instanceof": "Function"
- }
- ]
- }
- }
- }
- ]
- },
- "noEmitOnErrors": {
- "description": "Avoid emitting assets when errors occur",
- "type": "boolean"
- },
- "namedModules": {
- "description": "Use readable module identifiers for better debugging",
- "type": "boolean"
- },
- "namedChunks": {
- "description": "Use readable chunk identifiers for better debugging",
- "type": "boolean"
- },
- "portableRecords": {
- "description": "Generate records with relative paths to be able to move the context folder",
- "type": "boolean"
- },
- "minimize": {
- "description": "Enable minimizing the output. Uses optimization.minimizer.",
- "type": "boolean"
- },
- "minimizer": {
- "description": "Minimizer(s) to use for minimizing the output",
- "type": "array",
- "items": {
- "description": "Plugin of type object or instanceof Function",
- "anyOf": [
- {
- "$ref": "#/definitions/common.pluginObject"
- },
- {
- "$ref": "#/definitions/common.pluginFunction"
- }
- ]
- }
- },
- "nodeEnv": {
- "description": "Set process.env.NODE_ENV to a specific value",
- "anyOf": [
- {
- "enum": [
- false
- ]
- },
- {
- "type": "string"
- }
- ]
- }
- }
- },
- "parallelism": {
- "description": "The number of parallel processed modules in the compilation.",
- "minimum": 1,
- "type": "number"
- },
- "performance": {
- "description": "Configuration for web performance recommendations.",
- "anyOf": [
- {
- "enum": [
- false
- ]
- },
- {
- "additionalProperties": false,
- "properties": {
- "assetFilter": {
- "description": "Filter function to select assets that are checked",
- "instanceof": "Function"
- },
- "hints": {
- "description": "Sets the format of the hints: warnings, errors or nothing at all",
- "enum": [
- false,
- "warning",
- "error"
- ]
- },
- "maxEntrypointSize": {
- "description": "Total size of an entry point (in bytes)",
- "type": "number"
- },
- "maxAssetSize": {
- "description": "Filesize limit (in bytes) when exceeded, that webpack will provide performance hints",
- "type": "number"
- }
- },
- "type": "object"
- }
- ]
- },
- "plugins": {
- "description": "Add additional plugins to the compiler.",
- "type": "array",
- "items": {
- "description": "Plugin of type object or instanceof Function",
- "anyOf": [
- {
- "$ref": "#/definitions/common.pluginObject"
- },
- {
- "$ref": "#/definitions/common.pluginFunction"
- }
- ]
- }
- },
- "profile": {
- "description": "Capture timing information for each module.",
- "type": "boolean"
- },
- "recordsInputPath": {
- "description": "Store compiler state to a json file.",
- "type": "string",
- "absolutePath": true
- },
- "recordsOutputPath": {
- "description": "Load compiler state from a json file.",
- "type": "string",
- "absolutePath": true
- },
- "recordsPath": {
- "description": "Store/Load compiler state from/to a json file. This will result in persistent ids of modules and chunks. An absolute path is expected. `recordsPath` is used for `recordsInputPath` and `recordsOutputPath` if they left undefined.",
- "type": "string",
- "absolutePath": true
- },
- "resolve": {
- "description": "Options for the resolver",
- "anyOf": [
- {
- "$ref": "#/definitions/resolve"
- }
- ]
- },
- "resolveLoader": {
- "description": "Options for the resolver when resolving loaders",
- "anyOf": [
- {
- "$ref": "#/definitions/resolve"
- }
- ]
- },
- "serve": {
- "description": "Options for webpack-serve",
- "type": "object"
- },
- "stats": {
- "description": "Used by the webpack CLI program to pass stats options.",
- "anyOf": [
- {
- "type": "object",
- "additionalProperties": false,
- "properties": {
- "all": {
- "type": "boolean",
- "description": "fallback value for stats options when an option is not defined (has precedence over local webpack defaults)"
- },
- "context": {
- "type": "string",
- "description": "context directory for request shortening",
- "absolutePath": true
- },
- "hash": {
- "type": "boolean",
- "description": "add the hash of the compilation"
- },
- "version": {
- "type": "boolean",
- "description": "add webpack version information"
- },
- "timings": {
- "type": "boolean",
- "description": "add timing information"
- },
- "builtAt": {
- "type": "boolean",
- "description": "add built at time information"
- },
- "performance": {
- "type": "boolean",
- "description": "add performance hint flags"
- },
- "depth": {
- "type": "boolean",
- "description": "add module depth in module graph"
- },
- "assets": {
- "type": "boolean",
- "description": "add assets information"
- },
- "env": {
- "type": "boolean",
- "description": "add --env information"
- },
- "colors": {
- "description": "Enables/Disables colorful output",
- "oneOf": [
- {
- "type": "boolean",
- "description": "`webpack --colors` equivalent"
- },
- {
- "type": "object",
- "additionalProperties": false,
- "properties": {
- "bold": {
- "description": "Custom color for bold text",
- "type": "string"
- },
- "red": {
- "description": "Custom color for red text",
- "type": "string"
- },
- "green": {
- "description": "Custom color for green text",
- "type": "string"
- },
- "cyan": {
- "description": "Custom color for cyan text",
- "type": "string"
- },
- "magenta": {
- "description": "Custom color for magenta text",
- "type": "string"
- },
- "yellow": {
- "description": "Custom color for yellow text",
- "type": "string"
- }
- }
- }
- ]
- },
- "maxModules": {
- "type": "number",
- "description": "Set the maximum number of modules to be shown"
- },
- "chunks": {
- "type": "boolean",
- "description": "add chunk information"
- },
- "chunkModules": {
- "type": "boolean",
- "description": "add built modules information to chunk information"
- },
- "modules": {
- "type": "boolean",
- "description": "add built modules information"
- },
- "nestedModules": {
- "type": "boolean",
- "description": "add information about modules nested in other modules (like with module concatenation)"
- },
- "moduleAssets": {
- "type": "boolean",
- "description": "add information about assets inside modules"
- },
- "children": {
- "type": "boolean",
- "description": "add children information"
- },
- "cached": {
- "type": "boolean",
- "description": "add also information about cached (not built) modules"
- },
- "cachedAssets": {
- "type": "boolean",
- "description": "Show cached assets (setting this to `false` only shows emitted files)"
- },
- "reasons": {
- "type": "boolean",
- "description": "add information about the reasons why modules are included"
- },
- "source": {
- "type": "boolean",
- "description": "add the source code of modules"
- },
- "warnings": {
- "type": "boolean",
- "description": "add warnings"
- },
- "errors": {
- "type": "boolean",
- "description": "add errors"
- },
- "warningsFilter": {
- "description": "Suppress warnings that match the specified filters. Filters can be Strings, RegExps or Functions",
- "anyOf": [
- {
- "$ref": "#/definitions/filter-types"
- }
- ]
- },
- "excludeAssets": {
- "description": "Suppress assets that match the specified filters. Filters can be Strings, RegExps or Functions",
- "anyOf": [
- {
- "$ref": "#/definitions/filter-types"
- }
- ]
- },
- "excludeModules": {
- "description": "Suppress modules that match the specified filters. Filters can be Strings, RegExps, Booleans or Functions",
- "anyOf": [
- {
- "$ref": "#/definitions/filter-types"
- },
- {
- "type": "boolean"
- }
- ]
- },
- "exclude": {
- "description": "Please use excludeModules instead.",
- "anyOf": [
- {
- "$ref": "#/definitions/filter-types"
- },
- {
- "type": "boolean"
- }
- ]
- },
- "entrypoints": {
- "type": "boolean",
- "description": "Display the entry points with the corresponding bundles"
- },
- "chunkGroups": {
- "type": "boolean",
- "description": "Display all chunk groups with the corresponding bundles"
- },
- "errorDetails": {
- "type": "boolean",
- "description": "add details to errors (like resolving log)"
- },
- "chunkOrigins": {
- "type": "boolean",
- "description": "add the origins of chunks and chunk merging info"
- },
- "modulesSort": {
- "type": "string",
- "description": "sort the modules by that field"
- },
- "moduleTrace": {
- "type": "boolean",
- "description": "add dependencies and origin of warnings/errors"
- },
- "chunksSort": {
- "type": "string",
- "description": "sort the chunks by that field"
- },
- "assetsSort": {
- "type": "string",
- "description": "sort the assets by that field"
- },
- "publicPath": {
- "type": "boolean",
- "description": "Add public path information"
- },
- "outputPath": {
- "type": "boolean",
- "description": "Add output path information"
- },
- "providedExports": {
- "type": "boolean",
- "description": "show exports provided by modules"
- },
- "usedExports": {
- "type": "boolean",
- "description": "show exports used by modules"
- },
- "optimizationBailout": {
- "type": "boolean",
- "description": "show reasons why optimization bailed out for modules"
- }
- }
- },
- {
- "type": "boolean"
- },
- {
- "enum": [
- "none",
- "errors-only",
- "minimal",
- "normal",
- "detailed",
- "verbose"
- ]
- }
- ]
- },
- "target": {
- "description": "Environment to build for",
- "anyOf": [
- {
- "enum": [
- "web",
- "webworker",
- "node",
- "async-node",
- "node-webkit",
- "electron-main",
- "electron-renderer"
- ]
- },
- {
- "instanceof": "Function"
- }
- ]
- },
- "watch": {
- "description": "Enter watch mode, which rebuilds on file change.",
- "type": "boolean"
- },
- "watchOptions": {
- "description": "Options for the watcher",
- "additionalProperties": false,
- "properties": {
- "aggregateTimeout": {
- "description": "Delay the rebuilt after the first change. Value is a time in ms.",
- "type": "number"
- },
- "ignored": {
- "description": "Ignore some files from watching"
- },
- "stdin": {
- "description": "Stop watching when stdin stream has ended",
- "type": "boolean"
- },
- "poll": {
- "description": "Enable polling mode for watching",
- "anyOf": [
- {
- "description": "`true`: use polling.",
- "type": "boolean"
- },
- {
- "description": "`number`: use polling with specified interval.",
- "type": "number"
- }
- ]
- }
- },
- "type": "object"
- }
- },
- "type": "object"
- }
-
\ No newline at end of file

bin/prepareOptions.js

@@ -1,24 +0,0 @@
-"use strict";
-
-module.exports = function prepareOptions(options, argv) {
- argv = argv || {};
- options = handleExport(options);
-
- return Array.isArray(options)
- ? options.map(_options => handleFunction(_options, argv))
- : handleFunction(options, argv);
-};
-
-function handleExport(options) {
- const isES6DefaultExported =
- typeof options === "object" && options !== null && typeof options.default !== "undefined";
-
- return isES6DefaultExported ? options.default : options;
-}
-
-function handleFunction(options, argv) {
- if (typeof options === "function") {
- options = options(argv.env, argv);
- }
- return options;
-}

bin/prompt-command.js

@@ -1,137 +0,0 @@
-// based on https://github.com/webpack/webpack/blob/master/bin/webpack.js
-
-/**
- * @param {string} command process to run
- * @param {string[]} args commandline arguments
- * @returns {Promise<void>} promise
- */
-const runCommand = (command, args) => {
- const cp = require("child_process");
- return new Promise((resolve, reject) => {
- const executedCommand = cp.spawn(command, args, {
- stdio: "inherit",
- shell: true
- });
-
- executedCommand.on("error", error => {
- reject(error);
- });
-
- executedCommand.on("exit", code => {
- if (code === 0) {
- resolve();
- } else {
- reject();
- }
- });
- });
-};
-
-const npmGlobalRoot = () => {
- const cp = require("child_process");
- return new Promise((resolve, reject) => {
- const command = cp.spawn("npm", ["root", "-g"]);
- command.on("error", (error) => reject(error));
- command.stdout.on("data", (data) => resolve(data.toString()));
- command.stderr.on("data", (data) => reject(data));
- });
-};
-
-module.exports = function promptForInstallation(packages, ...args) {
- const nameOfPackage = "@webpack-cli/" + packages;
- let packageIsInstalled = false;
- let pathForCmd;
- try {
- const path = require("path");
- const fs = require("fs");
- pathForCmd = path.resolve(process.cwd(), "node_modules", "@webpack-cli", packages);
- if (!fs.existsSync(pathForCmd)) {
- const globalModules = require("global-modules");
- pathForCmd = globalModules + "/@webpack-cli/" + packages;
- require.resolve(pathForCmd);
- } else {
- require.resolve(pathForCmd);
- }
- packageIsInstalled = true;
- } catch (err) {
- packageIsInstalled = false;
- }
- if (!packageIsInstalled) {
- const path = require("path");
- const fs = require("fs");
- const readLine = require("readline");
- const isYarn = fs.existsSync(path.resolve(process.cwd(), "yarn.lock"));
-
- const packageManager = isYarn ? "yarn" : "npm";
- const options = ["install", "-D", nameOfPackage];
-
- if (isYarn) {
- options[0] = "add";
- }
-
- if (packages === "init") {
- if (isYarn) {
- options.splice(1, 1); // remove '-D'
- options.splice(0, 0, "global");
- } else {
- options[1] = "-g";
- }
- }
-
- const commandToBeRun = `${packageManager} ${options.join(" ")}`;
-
- const question = `Would you like to install ${packages}? (That will run ${commandToBeRun}) (yes/NO) : `;
-
- console.error(`The command moved into a separate package: ${nameOfPackage}`);
- const questionInterface = readLine.createInterface({
- input: process.stdin,
- output: process.stdout
- });
- questionInterface.question(question, answer => {
- questionInterface.close();
- switch (answer.toLowerCase()) {
- case "y":
- case "yes":
- case "1": {
-
- runCommand(packageManager, options)
- .then(_=> {
- if (packages === "init") {
- npmGlobalRoot()
- .then((root) => {
- const pathtoInit = path.resolve(root.trim(), "@webpack-cli", "init");
- return pathtoInit;
- })
- .then((pathForInit) => {
- return require(pathForInit).default(...args);
- })
- .catch((error) => {
- console.error(error);
- process.exitCode = 1;
- });
- return;
- }
-
- pathForCmd = path.resolve(process.cwd(), "node_modules", "@webpack-cli", packages);
- if (packages === "serve") {
- return require(pathForCmd).default.serve();
- }
- return require(pathForCmd).default(...args); //eslint-disable-line
- })
- .catch(error => {
- console.error(error);
- process.exitCode = 1;
- });
- break;
- }
- default: {
- console.error(`${nameOfPackage} needs to be installed in order to run the command.`);
- process.exitCode = 1;
- break;
- }
- }
- });
- } else {
- require(pathForCmd).default(...args); // eslint-disable-line
- }
-};

bin/utils/constants.js

@@ -0,0 +1,37 @@
+const NON_COMPILATION_ARGS = [
+ "init",
+ "migrate",
+ "add",
+ "remove",
+ "serve",
+ "generate-loader",
+ "generate-plugin",
+ "info"
+];
+
+const CONFIG_GROUP = "Config options:";
+const BASIC_GROUP = "Basic options:";
+const MODULE_GROUP = "Module options:";
+const OUTPUT_GROUP = "Output options:";
+const ADVANCED_GROUP = "Advanced options:";
+const RESOLVE_GROUP = "Resolving options:";
+const OPTIMIZE_GROUP = "Optimizing options:";
+const DISPLAY_GROUP = "Stats options:";
+const GROUPS = {
+ CONFIG_GROUP,
+ BASIC_GROUP,
+ MODULE_GROUP,
+ OUTPUT_GROUP,
+ ADVANCED_GROUP,
+ RESOLVE_GROUP,
+ OPTIMIZE_GROUP,
+ DISPLAY_GROUP
+};
+
+const WEBPACK_OPTIONS_FLAG = "WEBPACK_OPTIONS";
+
+module.exports = {
+ NON_COMPILATION_ARGS,
+ GROUPS,
+ WEBPACK_OPTIONS_FLAG
+};

bin/utils/convert-argv.js

@@ -0,0 +1,560 @@
+const path = require("path");
+const fs = require("fs");
+fs.existsSync = fs.existsSync || path.existsSync;
+const interpret = require("interpret");
+const prepareOptions = require("./prepareOptions");
+const webpackConfigurationSchema = require("../config/webpackConfigurationSchema.json");
+const validateSchema = require("webpack").validateSchema;
+const WebpackOptionsValidationError = require("webpack").WebpackOptionsValidationError;
+const findup = require("findup-sync");
+
+module.exports = function(...args) {
+ const argv = args[1] || args[0];
+ const options = [];
+ // Shortcuts
+ if (argv.d) {
+ argv.debug = true;
+ argv["output-pathinfo"] = true;
+ if (!argv.devtool) {
+ argv.devtool = "eval-cheap-module-source-map";
+ }
+ if (!argv.mode) {
+ argv.mode = "development";
+ }
+ }
+ if (argv.p) {
+ argv["optimize-minimize"] = true;
+ argv["define"] = [].concat(argv["define"] || []).concat("process.env.NODE_ENV=\"production\"");
+ if (!argv.mode) {
+ argv.mode = "production";
+ }
+ }
+
+ if (argv.output) {
+ let output = argv.output;
+ if (!path.isAbsolute(argv.o)) {
+ output = path.resolve(process.cwd(), output);
+ }
+ argv["output-filename"] = path.basename(output);
+ argv["output-path"] = path.dirname(output);
+ }
+
+ let configFileLoaded = false;
+ let configFiles = [];
+ const extensions = Object.keys(interpret.extensions).sort(function(a, b) {
+ return a === ".js" ? -1 : b === ".js" ? 1 : a.length - b.length;
+ });
+
+ let i;
+ if (argv.config) {
+ const getConfigExtension = function getConfigExtension(configPath) {
+ for (i = extensions.length - 1; i >= 0; i--) {
+ const tmpExt = extensions[i];
+ if (configPath.indexOf(tmpExt, configPath.length - tmpExt.length) > -1) {
+ return tmpExt;
+ }
+ }
+ return path.extname(configPath);
+ };
+
+ const mapConfigArg = function mapConfigArg(configArg) {
+ const resolvedPath = path.resolve(configArg);
+ const extension = getConfigExtension(resolvedPath);
+ return {
+ path: resolvedPath,
+ ext: extension
+ };
+ };
+
+ const configArgList = Array.isArray(argv.config) ? argv.config : [argv.config];
+ configFiles = configArgList.map(mapConfigArg);
+ } else {
+ const defaultConfigFileNames = ["webpack.config", "webpackfile"].join("|");
+ const webpackConfigFileRegExp = `(${defaultConfigFileNames})(${extensions.join("|")})`;
+ const pathToWebpackConfig = findup(webpackConfigFileRegExp);
+
+ if (pathToWebpackConfig) {
+ const resolvedPath = path.resolve(pathToWebpackConfig);
+ const actualConfigFileName = path.basename(resolvedPath);
+ const ext = actualConfigFileName.replace(new RegExp(defaultConfigFileNames), "");
+ configFiles.push({
+ path: resolvedPath,
+ ext
+ });
+ }
+ }
+ if (configFiles.length > 0) {
+ const registerCompiler = function registerCompiler(moduleDescriptor) {
+ if (moduleDescriptor) {
+ if (typeof moduleDescriptor === "string") {
+ require(moduleDescriptor);
+ } else if (!Array.isArray(moduleDescriptor)) {
+ moduleDescriptor.register(require(moduleDescriptor.module));
+ } else {
+ for (let i = 0; i < moduleDescriptor.length; i++) {
+ try {
+ registerCompiler(moduleDescriptor[i]);
+ break;
+ } catch (e) {
+ // do nothing
+ }
+ }
+ }
+ }
+ };
+
+ const requireConfig = function requireConfig(configPath) {
+ let options = (function WEBPACK_OPTIONS() {
+ if (argv.configRegister && argv.configRegister.length) {
+ module.paths.unshift(path.resolve(process.cwd(), "node_modules"), process.cwd());
+ argv.configRegister.forEach(dep => {
+ require(dep);
+ });
+ return require(configPath);
+ } else {
+ return require(configPath);
+ }
+ })();
+ options = prepareOptions(options, argv);
+ return options;
+ };
+
+ configFiles.forEach(function(file) {
+ registerCompiler(interpret.extensions[file.ext]);
+ options.push(requireConfig(file.path));
+ });
+ configFileLoaded = true;
+ }
+
+ if (!configFileLoaded) {
+ return processConfiguredOptions({});
+ } else if (options.length === 1) {
+ return processConfiguredOptions(options[0]);
+ } else {
+ return processConfiguredOptions(options);
+ }
+
+ function processConfiguredOptions(options) {
+ const webpackConfigurationValidationErrors = validateSchema(webpackConfigurationSchema, options);
+ if (webpackConfigurationValidationErrors.length) {
+ const error = new WebpackOptionsValidationError(webpackConfigurationValidationErrors);
+ console.error(error.message, `\nReceived: ${typeof options} : ${JSON.stringify(options, null, 2)}`);
+ process.exit(-1); // eslint-disable-line
+ }
+
+ // process Promise
+ if (typeof options.then === "function") {
+ return options.then(processConfiguredOptions);
+ }
+
+ // process ES6 default
+ if (typeof options === "object" && typeof options.default === "object") {
+ return processConfiguredOptions(options.default);
+ }
+
+ // filter multi-config by name
+ if (Array.isArray(options) && argv["config-name"]) {
+ const namedOptions = options.filter(function(opt) {
+ return opt.name === argv["config-name"];
+ });
+ if (namedOptions.length === 0) {
+ console.error("Configuration with name '" + argv["config-name"] + "' was not found.");
+ process.exit(-1); // eslint-disable-line
+ } else if (namedOptions.length === 1) {
+ return processConfiguredOptions(namedOptions[0]);
+ }
+ options = namedOptions;
+ }
+
+ if (Array.isArray(options)) {
+ options.forEach(processOptions);
+ } else {
+ processOptions(options);
+ }
+
+ if (argv.context) {
+ options.context = path.resolve(argv.context);
+ }
+ if (!options.context) {
+ options.context = process.cwd();
+ }
+
+ if (argv.watch) {
+ options.watch = true;
+ }
+
+ if (argv["watch-aggregate-timeout"]) {
+ options.watchOptions = options.watchOptions || {};
+ options.watchOptions.aggregateTimeout = +argv["watch-aggregate-timeout"];
+ }
+
+ if (typeof argv["watch-poll"] !== "undefined") {
+ options.watchOptions = options.watchOptions || {};
+ if (argv["watch-poll"] === "true" || argv["watch-poll"] === "") options.watchOptions.poll = true;
+ else if (!isNaN(argv["watch-poll"])) options.watchOptions.poll = +argv["watch-poll"];
+ }
+
+ if (argv["watch-stdin"]) {
+ options.watchOptions = options.watchOptions || {};
+ options.watchOptions.stdin = true;
+ options.watch = true;
+ }
+
+ return options;
+ }
+
+ function processOptions(options) {
+ function ifArg(name, fn, init, finalize) {
+ const isArray = Array.isArray(argv[name]);
+ const isSet = typeof argv[name] !== "undefined" && argv[name] !== null;
+ if (!isArray && !isSet) return;
+
+ init && init();
+ if (isArray) argv[name].forEach(fn);
+ else if (isSet) fn(argv[name], -1);
+ finalize && finalize();
+ }
+
+ function ifArgPair(name, fn, init, finalize) {
+ ifArg(
+ name,
+ function(content, idx) {
+ const i = content.indexOf("=");
+ if (i < 0) {
+ return fn(null, content, idx);
+ } else {
+ return fn(content.substr(0, i), content.substr(i + 1), idx);
+ }
+ },
+ init,
+ finalize
+ );
+ }
+
+ function ifBooleanArg(name, fn) {
+ ifArg(name, function(bool) {
+ if (bool) {
+ fn();
+ }
+ });
+ }
+
+ function mapArgToBoolean(name, optionName) {
+ ifArg(name, function(bool) {
+ if (bool === true) options[optionName || name] = true;
+ else if (bool === false) options[optionName || name] = false;
+ });
+ }
+
+ function loadPlugin(name) {
+ const loadUtils = require("loader-utils");
+ let args;
+ try {
+ const p = name && name.indexOf("?");
+ if (p > -1) {
+ args = loadUtils.parseQuery(name.substring(p));
+ name = name.substring(0, p);
+ }
+ } catch (e) {
+ console.log("Invalid plugin arguments " + name + " (" + e + ").");
+ process.exit(-1); // eslint-disable-line
+ }
+
+ let path;
+ try {
+ const resolve = require("enhanced-resolve");
+ path = resolve.sync(process.cwd(), name);
+ } catch (e) {
+ console.log("Cannot resolve plugin " + name + ".");
+ process.exit(-1); // eslint-disable-line
+ }
+ let Plugin;
+ try {
+ Plugin = require(path);
+ } catch (e) {
+ console.log("Cannot load plugin " + name + ". (" + path + ")");
+ throw e;
+ }
+ try {
+ return new Plugin(args);
+ } catch (e) {
+ console.log("Cannot instantiate plugin " + name + ". (" + path + ")");
+ throw e;
+ }
+ }
+
+ function ensureObject(parent, name, force) {
+ if (force || typeof parent[name] !== "object" || parent[name] === null) {
+ parent[name] = {};
+ }
+ }
+
+ function ensureArray(parent, name) {
+ if (!Array.isArray(parent[name])) {
+ parent[name] = [];
+ }
+ }
+
+ function addPlugin(options, plugin) {
+ ensureArray(options, "plugins");
+ options.plugins.unshift(plugin);
+ }
+
+ ifArg("mode", function(value) {
+ options.mode = value;
+ });
+
+ ifArgPair(
+ "entry",
+ function(name, entry) {
+ if (typeof options.entry[name] !== "undefined" && options.entry[name] !== null) {
+ options.entry[name] = [].concat(options.entry[name]).concat(entry);
+ } else {
+ options.entry[name] = entry;
+ }
+ },
+ function() {
+ ensureObject(options, "entry", true);
+ }
+ );
+
+ function bindRules(arg) {
+ ifArgPair(
+ arg,
+ function(name, binding) {
+ if (name === null) {
+ name = binding;
+ binding += "-loader";
+ }
+ const rule = {
+ test: new RegExp("\\." + name.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, "\\$&") + "$"), // eslint-disable-line no-useless-escape
+ loader: binding
+ };
+ if (arg === "module-bind-pre") {
+ rule.enforce = "pre";
+ } else if (arg === "module-bind-post") {
+ rule.enforce = "post";
+ }
+ options.module.rules.push(rule);
+ },
+ function() {
+ ensureObject(options, "module");
+ ensureArray(options.module, "rules");
+ }
+ );
+ }
+ bindRules("module-bind");
+ bindRules("module-bind-pre");
+ bindRules("module-bind-post");
+
+ let defineObject;
+ ifArgPair(
+ "define",
+ function(name, value) {
+ if (name === null) {
+ name = value;
+ value = true;
+ }
+ defineObject[name] = value;
+ },
+ function() {
+ defineObject = {};
+ },
+ function() {
+ const DefinePlugin = require("webpack").DefinePlugin;
+ addPlugin(options, new DefinePlugin(defineObject));
+ }
+ );
+
+ ifArg("output-path", function(value) {
+ ensureObject(options, "output");
+ options.output.path = path.resolve(value);
+ });
+
+ ifArg("output-filename", function(value) {
+ ensureObject(options, "output");
+
+ options.output.filename = value;
+ });
+
+ ifArg("output-chunk-filename", function(value) {
+ ensureObject(options, "output");
+ options.output.chunkFilename = value;
+ });
+
+ ifArg("output-source-map-filename", function(value) {
+ ensureObject(options, "output");
+ options.output.sourceMapFilename = value;
+ });
+
+ ifArg("output-public-path", function(value) {
+ ensureObject(options, "output");
+ options.output.publicPath = value;
+ });
+
+ ifArg("output-jsonp-function", function(value) {
+ ensureObject(options, "output");
+ options.output.jsonpFunction = value;
+ });
+
+ ifBooleanArg("output-pathinfo", function() {
+ ensureObject(options, "output");
+ options.output.pathinfo = true;
+ });
+
+ ifArg("output-library", function(value) {
+ ensureObject(options, "output");
+ ensureArray(options.output, "library");
+ options.output.library.push(value);
+ });
+
+ ifArg("output-library-target", function(value) {
+ ensureObject(options, "output");
+ options.output.libraryTarget = value;
+ });
+
+ ifArg("records-input-path", function(value) {
+ options.recordsInputPath = path.resolve(value);
+ });
+
+ ifArg("records-output-path", function(value) {
+ options.recordsOutputPath = path.resolve(value);
+ });
+
+ ifArg("records-path", function(value) {
+ options.recordsPath = path.resolve(value);
+ });
+
+ ifArg("target", function(value) {
+ options.target = value;
+ });
+
+ mapArgToBoolean("cache");
+
+ ifBooleanArg("hot", function() {
+ const HotModuleReplacementPlugin = require("webpack").HotModuleReplacementPlugin;
+ addPlugin(options, new HotModuleReplacementPlugin());
+ });
+
+ ifBooleanArg("debug", function() {
+ const LoaderOptionsPlugin = require("webpack").LoaderOptionsPlugin;
+ addPlugin(
+ options,
+ new LoaderOptionsPlugin({
+ debug: true
+ })
+ );
+ });
+
+ ifArg("devtool", function(value) {
+ options.devtool = value;
+ });
+
+ function processResolveAlias(arg, key) {
+ ifArgPair(arg, function(name, value) {
+ if (!name) {
+ throw new Error("--" + arg + " <string>=<string>");
+ }
+ ensureObject(options, key);
+ ensureObject(options[key], "alias");
+ options[key].alias[name] = value;
+ });
+ }
+ processResolveAlias("resolve-alias", "resolve");
+ processResolveAlias("resolve-loader-alias", "resolveLoader");
+
+ ifArg("resolve-extensions", function(value) {
+ ensureObject(options, "resolve");
+ if (Array.isArray(value)) {
+ options.resolve.extensions = value;
+ } else {
+ options.resolve.extensions = value.split(/,\s*/);
+ }
+ });
+
+ ifArg("optimize-max-chunks", function(value) {
+ const LimitChunkCountPlugin = require("webpack").optimize.LimitChunkCountPlugin;
+ addPlugin(
+ options,
+ new LimitChunkCountPlugin({
+ maxChunks: parseInt(value, 10)
+ })
+ );
+ });
+
+ ifArg("optimize-min-chunk-size", function(value) {
+ const MinChunkSizePlugin = require("webpack").optimize.MinChunkSizePlugin;
+ addPlugin(
+ options,
+ new MinChunkSizePlugin({
+ minChunkSize: parseInt(value, 10)
+ })
+ );
+ });
+
+ ifBooleanArg("optimize-minimize", function() {
+ const LoaderOptionsPlugin = require("webpack").LoaderOptionsPlugin;
+ addPlugin(
+ options,
+ new LoaderOptionsPlugin({
+ minimize: true
+ })
+ );
+ });
+
+ ifArg("prefetch", function(request) {
+ const PrefetchPlugin = require("webpack").PrefetchPlugin;
+ addPlugin(options, new PrefetchPlugin(request));
+ });
+
+ ifArg("provide", function(value) {
+ const idx = value.indexOf("=");
+ let name;
+ if (idx >= 0) {
+ name = value.substr(0, idx);
+ value = value.substr(idx + 1);
+ } else {
+ name = value;
+ }
+ const ProvidePlugin = require("webpack").ProvidePlugin;
+ addPlugin(options, new ProvidePlugin(name, value));
+ });
+
+ ifArg("plugin", function(value) {
+ addPlugin(options, loadPlugin(value));
+ });
+
+ mapArgToBoolean("bail");
+
+ mapArgToBoolean("profile");
+
+ if (argv._.length > 0) {
+ ensureObject(options, "entry", true);
+
+ const addTo = function addTo(name, entry) {
+ if (options.entry[name]) {
+ if (!Array.isArray(options.entry[name])) {
+ options.entry[name] = [options.entry[name]];
+ }
+ options.entry[name].push(entry);
+ } else {
+ options.entry[name] = entry;
+ }
+ };
+ argv._.forEach(function(content) {
+ const i = content.indexOf("=");
+ const j = content.indexOf("?");
+ if (i < 0 || (j >= 0 && j < i)) {
+ const resolved = path.resolve(content);
+ if (fs.existsSync(resolved)) {
+ addTo("main", `${resolved}${fs.statSync(resolved).isDirectory() ? path.sep : ""}`);
+ } else {
+ addTo("main", content);
+ }
+ } else {
+ addTo(content.substr(0, i), content.substr(i + 1));
+ }
+ });
+ }
+ }
+};

bin/utils/errorHelpers.js

@@ -0,0 +1,33 @@
+/*
+ MIT License http://www.opensource.org/licenses/mit-license.php
+ Author Tobias Koppers @sokra
+*/
+"use strict";
+
+const { WEBPACK_OPTIONS_FLAG } = require("./constants");
+
+exports.cutOffByFlag = (stack, flag) => {
+ stack = stack.split("\n");
+ for (let i = 0; i < stack.length; i++) if (stack[i].indexOf(flag) >= 0) stack.length = i;
+ return stack.join("\n");
+};
+
+exports.cutOffWebpackOptions = stack => exports.cutOffByFlag(stack, WEBPACK_OPTIONS_FLAG);
+
+exports.cutOffMultilineMessage = (stack, message) => {
+ stack = stack.split("\n");
+ message = message.split("\n");
+
+ return stack
+ .reduce(
+ (acc, line, idx) => (line === message[idx] || line === `Error: ${message[idx]}` ? acc : acc.concat(line)),
+ []
+ )
+ .join("\n");
+};
+
+exports.cleanUpWebpackOptions = (stack, message) => {
+ stack = exports.cutOffWebpackOptions(stack);
+ stack = exports.cutOffMultilineMessage(stack, message);
+ return stack;
+};

bin/utils/prepareOptions.js

@@ -0,0 +1,24 @@
+"use strict";
+
+module.exports = function prepareOptions(options, argv) {
+ argv = argv || {};
+ options = handleExport(options);
+
+ return Array.isArray(options)
+ ? options.map(_options => handleFunction(_options, argv))
+ : handleFunction(options, argv);
+};
+
+function handleExport(options) {
+ const isES6DefaultExported =
+ typeof options === "object" && options !== null && typeof options.default !== "undefined";
+
+ return isES6DefaultExported ? options.default : options;
+}
+
+function handleFunction(options, argv) {
+ if (typeof options === "function") {
+ options = options(argv.env, argv);
+ }
+ return options;
+}

bin/utils/prompt-command.js

@@ -0,0 +1,142 @@
+// based on https://github.com/webpack/webpack/blob/master/bin/webpack.js
+
+/**
+ * @param {string} command process to run
+ * @param {string[]} args commandline arguments
+ * @returns {Promise<void>} promise
+ */
+const runCommand = (command, args) => {
+ const cp = require("child_process");
+ return new Promise((resolve, reject) => {
+ const executedCommand = cp.spawn(command, args, {
+ stdio: "inherit",
+ shell: true
+ });
+
+ executedCommand.on("error", error => {
+ reject(error);
+ });
+
+ executedCommand.on("exit", code => {
+ if (code === 0) {
+ resolve();
+ } else {
+ reject();
+ }
+ });
+ });
+};
+
+const npmGlobalRoot = () => {
+ const cp = require("child_process");
+ return new Promise((resolve, reject) => {
+ const command = cp.spawn("npm", ["root", "-g"]);
+ command.on("error", error => reject(error));
+ command.stdout.on("data", data => resolve(data.toString()));
+ command.stderr.on("data", data => reject(data));
+ });
+};
+
+const runWhenInstalled = (packages, pathForCmd, ...args) => {
+ const currentPackage = require(pathForCmd);
+ const func = currentPackage.default;
+ if (typeof func !== "function") {
+ throw new Error(`@webpack-cli/${packages} failed to export a default function`);
+ }
+ return func(...args);
+};
+
+module.exports = function promptForInstallation(packages, ...args) {
+ const nameOfPackage = "@webpack-cli/" + packages;
+ let packageIsInstalled = false;
+ let pathForCmd;
+ try {
+ const path = require("path");
+ const fs = require("fs");
+ pathForCmd = path.resolve(process.cwd(), "node_modules", "@webpack-cli", packages);
+ if (!fs.existsSync(pathForCmd)) {
+ const globalModules = require("global-modules");
+ pathForCmd = globalModules + "/@webpack-cli/" + packages;
+ require.resolve(pathForCmd);
+ } else {
+ require.resolve(pathForCmd);
+ }
+ packageIsInstalled = true;
+ } catch (err) {
+ packageIsInstalled = false;
+ }
+ if (!packageIsInstalled) {
+ const path = require("path");
+ const fs = require("fs");
+ const readLine = require("readline");
+ const isYarn = fs.existsSync(path.resolve(process.cwd(), "yarn.lock"));
+
+ const packageManager = isYarn ? "yarn" : "npm";
+ const options = ["install", "-D", nameOfPackage];
+
+ if (isYarn) {
+ options[0] = "add";
+ }
+
+ if (packages === "init") {
+ if (isYarn) {
+ options.splice(1, 1); // remove '-D'
+ options.splice(0, 0, "global");
+ } else {
+ options[1] = "-g";
+ }
+ }
+
+ const commandToBeRun = `${packageManager} ${options.join(" ")}`;
+
+ const question = `Would you like to install ${packages}? (That will run ${commandToBeRun}) (yes/NO) : `;
+
+ console.error(`The command moved into a separate package: ${nameOfPackage}`);
+ const questionInterface = readLine.createInterface({
+ input: process.stdin,
+ output: process.stdout
+ });
+ questionInterface.question(question, answer => {
+ questionInterface.close();
+ switch (answer.toLowerCase()) {
+ case "y":
+ case "yes":
+ case "1": {
+ runCommand(packageManager, options)
+ .then(_ => {
+ if (packages === "init") {
+ npmGlobalRoot()
+ .then(root => {
+ const pathtoInit = path.resolve(root.trim(), "@webpack-cli", "init");
+ return pathtoInit;
+ })
+ .then(pathForInit => {
+ return require(pathForInit).default(...args);
+ })
+ .catch(error => {
+ console.error(error);
+ process.exitCode = 1;
+ });
+ return;
+ }
+
+ pathForCmd = path.resolve(process.cwd(), "node_modules", "@webpack-cli", packages);
+ return runWhenInstalled(packages, pathForCmd, ...args);
+ })
+ .catch(error => {
+ console.error(error);
+ process.exitCode = 1;
+ });
+ break;
+ }
+ default: {
+ console.error(`${nameOfPackage} needs to be installed in order to run the command.`);
+ process.exitCode = 1;
+ break;
+ }
+ }
+ });
+ } else {
+ return runWhenInstalled(packages, pathForCmd, ...args);
+ }
+};

bin/webpackConfigurationSchema.json

@@ -1,20 +0,0 @@
-{
- "anyOf": [
- {
- "type": "object",
- "description": "A webpack configuration object."
- },
- {
- "type": "array",
- "description": "An array of webpack configuration objects.",
- "items": {
- "description": "A webpack configuration object.",
- "type": "object"
- }
- },
- {
- "instanceof": "Promise",
- "description": "A promise that resolves with a configuration object, or an array of configuration objects."
- }
- ]
-}

CHANGELOG.md

@@ -1,3 +1,193 @@
+ <a name="3.3.2"></a>
+# 3.3.2 (2019-05-04)
+[Full Changelog](https://github.com/webpack/webpack-cli/compare/v0.1.5...v3.3.2)
+
+## New Features
+
+* opencollective prompt: add option to disable it + doc ([d4643ae](https://github.com/webpack/webpack-cli/commit/d4643ae))
+* terser: clean old files ([89e6b74](https://github.com/webpack/webpack-cli/commit/89e6b74))
+* terser: remove leftover files ([27d5b4d](https://github.com/webpack/webpack-cli/commit/27d5b4d))
+* terser: replace after merging master ([c404655](https://github.com/webpack/webpack-cli/commit/c404655))
+* replace Uglify with Terser in generators ([2b8651b](https://github.com/webpack/webpack-cli/commit/2b8651b))
+* use terserPlugin in loaderOptionsPlugin ([14f5337](https://github.com/webpack/webpack-cli/commit/14f5337))
+* use terserJsPlugin for transformations during migrate ([33c6185](https://github.com/webpack/webpack-cli/commit/33c6185))
+* replace uglifyJsPlugin with terserPlugin in migrate ([d467f3b](https://github.com/webpack/webpack-cli/commit/d467f3b))
+* opencollective prompt: work on windows setting atime by code ([3af73a8](https://github.com/webpack/webpack-cli/commit/3af73a8))
+* opencollective prompt: fix typo ([c2351b1](https://github.com/webpack/webpack-cli/commit/c2351b1))
+* opencollective prompt: remove .lastocprint file from fs ([b96ad56](https://github.com/webpack/webpack-cli/commit/b96ad56))
+* opencollective prompt: extract weekday to variable ([790d27a](https://github.com/webpack/webpack-cli/commit/790d27a))
+* opencollective prompt: set terminal cols to 80 ([badc32d](https://github.com/webpack/webpack-cli/commit/badc32d))
+* opencollective prompt: fix azure ci ([ea0039a](https://github.com/webpack/webpack-cli/commit/ea0039a))
+* opencollective prompt: lint ([ea906d8](https://github.com/webpack/webpack-cli/commit/ea906d8))
+* opencollective prompt: clear package.json modifications ([f080733](https://github.com/webpack/webpack-cli/commit/f080733))
+* opencollective prompt: add prompt in postinstall script ([dd9d528](https://github.com/webpack/webpack-cli/commit/dd9d528))
+
+## Ast
+
+* change tooltip property from uglify to terser ([ea9e4b8](https://github.com/webpack/webpack-cli/commit/ea9e4b8))
+* replace requires and inits for uglify with terser ([3011a6c](https://github.com/webpack/webpack-cli/commit/3011a6c))
+* replace UglifyJsPlugin with TerserPlugin ([21da35f](https://github.com/webpack/webpack-cli/commit/21da35f))
+
+## Chore
+
+* cli: move constants to a separate file ([#798](https://github.com/webpack/webpack-cli/pull/798))
+* deps: fix security vulnerabilities ([#857](https://github.com/webpack/webpack-cli/pull/857))
+* deps: upgrade lerna to fix vulnerabilities & update webpack-dev-server ([#823](https://github.com/webpack/webpack-cli/pull/823))
+* docs: minor fixes in the docs ([#874](https://github.com/webpack/webpack-cli/pull/874))
+* docs: removes scaffolding docs from the root ([8c1db03](https://github.com/webpack/webpack-cli/commit/8c1db03))
+* junit: reverting the junit.xml ([80fd4fa](https://github.com/webpack/webpack-cli/commit/80fd4fa))
+* travis: removed stable ([#871](https://github.com/webpack/webpack-cli/pull/871))
+* types: move to @types/yeoman-generator ([#869](https://github.com/webpack/webpack-cli/pull/869))
+* addon generator to async/await ([#849](https://github.com/webpack/webpack-cli/pull/849))
+* v.3.1.1 ([d3f8e20](https://github.com/webpack/webpack-cli/commit/d3f8e20))
+* tests: updated test regex, some helper scripts ([#809](https://github.com/webpack/webpack-cli/pull/809))
+* types: add type information ([#791](https://github.com/webpack/webpack-cli/pull/791))
+* replace instances of uglify with terser ([f9cb8ce](https://github.com/webpack/webpack-cli/commit/f9cb8ce))
+* use actual package name in comment about removing uglify ([b1cf4cc](https://github.com/webpack/webpack-cli/commit/b1cf4cc))
+* align file in the same way as other terserPlugin test fixtures ([b6c6484](https://github.com/webpack/webpack-cli/commit/b6c6484))
+* remove gitHash from package.json ([2af08be](https://github.com/webpack/webpack-cli/commit/2af08be))
+
+## Docs
+
+* code of conduct ([#873](https://github.com/webpack/webpack-cli/pull/873))
+* contribute: adds table of contents and info about dependencies. ([#842](https://github.com/webpack/webpack-cli/pull/842))
+* contributing: fixes dead link ([#835](https://github.com/webpack/webpack-cli/pull/835))
+* opencollective prompt: improve code clarity ([55992a4](https://github.com/webpack/webpack-cli/commit/55992a4))
+* packages: adds downloads/month shield ([6a0375a](https://github.com/webpack/webpack-cli/commit/6a0375a))
+* readme: fix typos, add summary of all commands ([#845](https://github.com/webpack/webpack-cli/pull/845))
+* readme: adds contributors shield ([958d064](https://github.com/webpack/webpack-cli/commit/958d064))
+* README: phrase change ([3a11a16](https://github.com/webpack/webpack-cli/commit/3a11a16))
+* README: add link to webpack-scaffold-starter ([e35a194](https://github.com/webpack/webpack-cli/commit/e35a194))
+* README: update scaffolding links ([74179b5](https://github.com/webpack/webpack-cli/commit/74179b5))
+* serve: link to webpack-dev-server ([cb68b1b](https://github.com/webpack/webpack-cli/commit/cb68b1b))
+* serve: update docs to use webpack-dev-server ([f7451d4](https://github.com/webpack/webpack-cli/commit/f7451d4))
+* replace tooltip link to terser plugin ([4254730](https://github.com/webpack/webpack-cli/commit/4254730))
+* replace Uglify with Terser in comments ([799577d](https://github.com/webpack/webpack-cli/commit/799577d))
+* replace UglifyJsPlugin with TerserPlugin in migrate docs ([326f783](https://github.com/webpack/webpack-cli/commit/326f783))
+
+## Enh
+
+* webpack-scaffold: improve prompt and doc ([#794](https://github.com/webpack/webpack-cli/pull/794))
+
+## Fix
+
+* add: add types ([d4ce6f2](https://github.com/webpack/webpack-cli/commit/d4ce6f2))
+* add: fix runTransform ([dbc3e9e](https://github.com/webpack/webpack-cli/commit/dbc3e9e))
+* add: lint code ([163b309](https://github.com/webpack/webpack-cli/commit/163b309))
+* add: add handling for topScope ([1162cf5](https://github.com/webpack/webpack-cli/commit/1162cf5))
+* bin, serve: force default package export, add serve default ([#815](https://github.com/webpack/webpack-cli/pull/815))
+* init: refactored the init.ts success message ([#810](https://github.com/webpack/webpack-cli/pull/810))
+* opencollective prompt: fix grammar ([246db42](https://github.com/webpack/webpack-cli/commit/246db42))
+* opencollective-prompt: check write permissions ([5284b7e](https://github.com/webpack/webpack-cli/commit/5284b7e))
+* scaffold: config file is always generated at the project root ([#801](https://github.com/webpack/webpack-cli/pull/801))
+* utils: refactors utils ([7fe3543](https://github.com/webpack/webpack-cli/commit/7fe3543))
+* clear up comment about default function purpose ([e48507d](https://github.com/webpack/webpack-cli/commit/e48507d))
+* remove unused files ([ec242ab](https://github.com/webpack/webpack-cli/commit/ec242ab))
+* reset files ([9863445](https://github.com/webpack/webpack-cli/commit/9863445))
+* replace lookups for TerserPlugin in webpack.optimise ([ef23fec](https://github.com/webpack/webpack-cli/commit/ef23fec))
+
+## Tests
+
+* update snapshots ([ce9fbc8](https://github.com/webpack/webpack-cli/commit/ce9fbc8))
+* replace uglify with terser in ast-utils tests ([73f493f](https://github.com/webpack/webpack-cli/commit/73f493f))
+* migration: typescript ([#613](https://github.com/webpack/webpack-cli/pull/613))
+
+## Misc
+
+* chore(docs): Refactors links for badges ([#859](https://github.com/webpack/webpack-cli/pull/859))
+* opencollective-prompt: improve grammar ([e17a26d](https://github.com/webpack/webpack-cli/commit/e17a26d))
+* Remove tslint in favour of eslint ([#834](https://github.com/webpack/webpack-cli/pull/834))
+* cli: refactor functions into utils and config dirs, merge yargs options ([#781](https://github.com/webpack/webpack-cli/pull/781))
+* utils: refactors scaffold ([0b28fb3](https://github.com/webpack/webpack-cli/commit/0b28fb3))
+
+ <a name="3.3.1"></a>
+# 3.3.1 (2019-04-21)
+[Full Changelog](https://github.com/webpack/webpack-cli/compare/v0.1.5...v3.3.1)
+
+## New Features
+
+* terser: clean old files ([89e6b74](https://github.com/webpack/webpack-cli/commit/89e6b74))
+* terser: remove leftover files ([27d5b4d](https://github.com/webpack/webpack-cli/commit/27d5b4d))
+* terser: replace after merging master ([c404655](https://github.com/webpack/webpack-cli/commit/c404655))
+* replace Uglify with Terser in generators ([2b8651b](https://github.com/webpack/webpack-cli/commit/2b8651b))
+* use terserPlugin in loaderOptionsPlugin ([14f5337](https://github.com/webpack/webpack-cli/commit/14f5337))
+* use terserJsPlugin for transformations during migrate ([33c6185](https://github.com/webpack/webpack-cli/commit/33c6185))
+* replace uglifyJsPlugin with terserPlugin in migrate ([d467f3b](https://github.com/webpack/webpack-cli/commit/d467f3b))
+* opencollective prompt: work on windows setting atime by code ([3af73a8](https://github.com/webpack/webpack-cli/commit/3af73a8))
+* opencollective prompt: fix typo ([c2351b1](https://github.com/webpack/webpack-cli/commit/c2351b1))
+* opencollective prompt: remove .lastocprint file from fs ([b96ad56](https://github.com/webpack/webpack-cli/commit/b96ad56))
+* opencollective prompt: extract weekday to variable ([790d27a](https://github.com/webpack/webpack-cli/commit/790d27a))
+* opencollective prompt: set terminal cols to 80 ([badc32d](https://github.com/webpack/webpack-cli/commit/badc32d))
+* opencollective prompt: fix azure ci ([ea0039a](https://github.com/webpack/webpack-cli/commit/ea0039a))
+* opencollective prompt: lint ([ea906d8](https://github.com/webpack/webpack-cli/commit/ea906d8))
+* opencollective prompt: clear package.json modifications ([f080733](https://github.com/webpack/webpack-cli/commit/f080733))
+* opencollective prompt: add prompt in postinstall script ([dd9d528](https://github.com/webpack/webpack-cli/commit/dd9d528))
+
+## Ast
+
+* change tooltip property from uglify to terser ([ea9e4b8](https://github.com/webpack/webpack-cli/commit/ea9e4b8))
+* replace requires and inits for uglify with terser ([3011a6c](https://github.com/webpack/webpack-cli/commit/3011a6c))
+* replace UglifyJsPlugin with TerserPlugin ([21da35f](https://github.com/webpack/webpack-cli/commit/21da35f))
+
+## Chore
+
+* cli: move constants to a separate file ([#798](https://github.com/webpack/webpack-cli/pull/798))
+* deps: upgrade lerna to fix vulnerabilities & update webpack-dev-server ([#823](https://github.com/webpack/webpack-cli/pull/823))
+* docs: removes scaffolding docs from the root ([8c1db03](https://github.com/webpack/webpack-cli/commit/8c1db03))
+* junit: reverting the junit.xml ([80fd4fa](https://github.com/webpack/webpack-cli/commit/80fd4fa))
+* tests: updated test regex, some helper scripts ([#809](https://github.com/webpack/webpack-cli/pull/809))
+* types: add type information ([#791](https://github.com/webpack/webpack-cli/pull/791))
+* replace instances of uglify with terser ([f9cb8ce](https://github.com/webpack/webpack-cli/commit/f9cb8ce))
+* use actual package name in comment about removing uglify ([b1cf4cc](https://github.com/webpack/webpack-cli/commit/b1cf4cc))
+* align file in the same way as other terserPlugin test fixtures ([b6c6484](https://github.com/webpack/webpack-cli/commit/b6c6484))
+* remove gitHash from package.json ([2af08be](https://github.com/webpack/webpack-cli/commit/2af08be))
+
+## Docs
+
+* contributing: fixes dead link ([#835](https://github.com/webpack/webpack-cli/pull/835))
+* opencollective prompt: improve code clarity ([55992a4](https://github.com/webpack/webpack-cli/commit/55992a4))
+* packages: adds downloads/month shield ([6a0375a](https://github.com/webpack/webpack-cli/commit/6a0375a))
+* readme: adds contributors shield ([958d064](https://github.com/webpack/webpack-cli/commit/958d064))
+* README: phrase change ([3a11a16](https://github.com/webpack/webpack-cli/commit/3a11a16))
+* README: add link to webpack-scaffold-starter ([e35a194](https://github.com/webpack/webpack-cli/commit/e35a194))
+* README: update scaffolding links ([74179b5](https://github.com/webpack/webpack-cli/commit/74179b5))
+* serve: link to webpack-dev-server ([cb68b1b](https://github.com/webpack/webpack-cli/commit/cb68b1b))
+* serve: update docs to use webpack-dev-server ([f7451d4](https://github.com/webpack/webpack-cli/commit/f7451d4))
+* replace tooltip link to terser plugin ([4254730](https://github.com/webpack/webpack-cli/commit/4254730))
+* replace Uglify with Terser in comments ([799577d](https://github.com/webpack/webpack-cli/commit/799577d))
+* replace UglifyJsPlugin with TerserPlugin in migrate docs ([326f783](https://github.com/webpack/webpack-cli/commit/326f783))
+
+## Enh
+
+* webpack-scaffold: improve prompt and doc ([#794](https://github.com/webpack/webpack-cli/pull/794))
+
+## Fix
+
+* add: add types ([d4ce6f2](https://github.com/webpack/webpack-cli/commit/d4ce6f2))
+* add: fix runTransform ([dbc3e9e](https://github.com/webpack/webpack-cli/commit/dbc3e9e))
+* add: lint code ([163b309](https://github.com/webpack/webpack-cli/commit/163b309))
+* add: add handling for topScope ([1162cf5](https://github.com/webpack/webpack-cli/commit/1162cf5))
+* bin, serve: force default package export, add serve default ([#815](https://github.com/webpack/webpack-cli/pull/815))
+* init: refactored the init.ts success message ([#810](https://github.com/webpack/webpack-cli/pull/810))
+* scaffold: config file is always generated at the project root ([#801](https://github.com/webpack/webpack-cli/pull/801))
+* utils: refactors utils ([7fe3543](https://github.com/webpack/webpack-cli/commit/7fe3543))
+* clear up comment about default function purpose ([e48507d](https://github.com/webpack/webpack-cli/commit/e48507d))
+* remove unused files ([ec242ab](https://github.com/webpack/webpack-cli/commit/ec242ab))
+* reset files ([9863445](https://github.com/webpack/webpack-cli/commit/9863445))
+* replace lookups for TerserPlugin in webpack.optimise ([ef23fec](https://github.com/webpack/webpack-cli/commit/ef23fec))
+
+## Tests
+
+* update snapshots ([ce9fbc8](https://github.com/webpack/webpack-cli/commit/ce9fbc8))
+* replace uglify with terser in ast-utils tests ([73f493f](https://github.com/webpack/webpack-cli/commit/73f493f))
+* migration: typescript ([#613](https://github.com/webpack/webpack-cli/pull/613))
+
+## Misc
+
+* Remove tslint in favour of eslint ([#834](https://github.com/webpack/webpack-cli/pull/834))
+* cli: refactor functions into utils and config dirs, merge yargs options ([#781](https://github.com/webpack/webpack-cli/pull/781))
+* utils: refactors scaffold ([0b28fb3](https://github.com/webpack/webpack-cli/commit/0b28fb3))
+
<a name="3.3.0"></a>
# 3.3.0 (2019-03-15)
[Full Changelog](https://github.com/webpack/webpack-cli/compare/v0.1.3...v3.3.0)

package.json

@@ -1,6 +1,6 @@
{
"name": "webpack-cli",
- "version": "3.3.0",
+ "version": "3.3.2",
"description": "CLI for webpack & friends",
"license": "MIT",
"repository": {
@@ -35,14 +35,16 @@
"docs": "typedoc",
"format": "prettier-eslint ./bin/*.js ./test/**/*.js ./packages/**/*.js --write",
"lint:codeOnly": "eslint \"{bin}/**/!(__testfixtures__)/*.js\" \"{bin}/**.js\"",
- "lint": "eslint \"./bin/*.js\" \"./test/**/*.js\" \"packages/**/!(node_modules)/*.test.js\"",
- "pretest": "npm run build && npm run lint && npm run tslint",
+ "lint": "eslint \"./bin/*.js\" \"./test/**/*.js\" \"packages/**/!(node_modules)/*.ts\"",
+ "postinstall": "node ./bin/opencollective.js",
+ "pretest": "npm run build && npm run lint",
"reportCoverage": "nyc report --reporter=json && codecov -f coverage/coverage-final.json --disable=gcov",
"test": "nyc jest --maxWorkers=4 --reporters=default --reporters=jest-junit",
+ "test:cli": "nyc jest test/ --maxWorkers=4 --reporters=default --reporters=jest-junit",
+ "test:packages": "nyc jest packages/ --maxWorkers=4 --reporters=default --reporters=jest-junit",
"test:ci": "nyc jest --maxWorkers=$(nproc) --reporters=default --reporters=jest-junit",
"travis:integration": "npm run build && npm run test && npm run reportCoverage",
- "travis:lint": "npm run build && npm run lint && npm run tslint",
- "tslint": "tslint -c tslint.json \"packages/**/*.ts\"",
+ "travis:lint": "npm run build && npm run lint",
"watch": "npm run build && tsc -w"
},
"husky": {
@@ -55,15 +57,10 @@
"{packages,bin}/**/!(__testfixtures__)/**.js": [
"eslint --fix",
"git add"
- ],
- "{packages,bin}/**/!(__testfixtures__)/**.ts": [
- "tslint --fix",
- "git add"
]
},
"jest": {
"testPathIgnorePatterns": [
- "^.+\\.(ts)?$",
"/node_modules/"
],
"testEnvironment": "node",
@@ -73,9 +70,18 @@
"html",
"cobertura"
],
- "moduleNameMapper": {
+ "transform": {
"^.+\\.(ts)?$": "ts-jest"
- }
+ },
+ "testRegex": [
+ "/__tests__/.*\\.(test.js|test.ts)$",
+ "/test/.*\\.(test.js|test.ts)$"
+ ],
+ "moduleFileExtensions": [
+ "ts",
+ "js",
+ "json"
+ ]
},
"nyc": {
"include": [
@@ -134,6 +140,8 @@
"@commitlint/travis-cli": "^7.2.1",
"@types/jest": "^23.3.14",
"@types/node": "^10.12.9",
+ "@typescript-eslint/eslint-plugin": "^1.6.0",
+ "@typescript-eslint/parser": "^1.6.0",
"babel-preset-env": "^1.7.0",
"babel-preset-jest": "^24.3.0",
"bundlesize": "^0.17.0",
@@ -143,6 +151,7 @@
"conventional-changelog-cli": "^2.0.11",
"cz-customizable": "^5.3.0",
"eslint": "^5.9.0",
+ "eslint-config-prettier": "^4.1.0",
"eslint-plugin-node": "^8.0.0",
"esm": "^3.2.14",
"execa": "^1.0.0",
@@ -150,21 +159,20 @@
"jest": "^24.3.1",
"jest-cli": "^24.3.1",
"jest-junit": "^6.3.0",
- "lerna": "^3.13.1",
+ "lerna": "^3.13.4",
"lint-staged": "7.x.x",
- "nyc": "^13.3.0",
+ "nyc": "^14.1.0",
"prettier-eslint-cli": "^4.7.1",
"readable-stream": "^3.0.6",
"rimraf": "^2.6.2",
"schema-utils": "^1.0.0",
"ts-jest": "^23.10.5",
"ts-node": "^7.0.1",
- "tslint": "^5.11.0",
- "typedoc": "^0.13.0",
+ "typedoc": "^0.14.2",
"typedoc-plugin-monorepo": "^0.1.0",
"typescript": "^3.3.1",
"webpack": "4.x.x",
- "webpack-dev-server": "^3.1.10"
+ "webpack-dev-server": "^3.3.1"
},
"collective": {
"type": "opencollective",

README.md

@@ -11,33 +11,26 @@
</p>
<br>
-[![npm](https://img.shields.io/npm/v/webpack-cli.svg)](https://www.npmjs.com/package/webpack-cli)
-[![Build Status](https://travis-ci.org/webpack/webpack-cli.svg)](https://travis-ci.org/webpack/webpack-cli)
-[![Build2 Status](https://dev.azure.com/webpack/webpack/_apis/build/status/webpack.webpack-cli)](https://dev.azure.com/webpack/webpack/_build/latest?definitionId=4)
+[![npm][npm]][npm-url]
+[![Build Status][build-status]][build-status-url]
+[![Build2 Status][build-status-azure]][build-status-azure-url]
[![deps][deps]][deps-url]
-[![Code Climate](https://codeclimate.com/github/webpack/webpack-cli/badges/gpa.svg)](https://codeclimate.com/github/webpack/webpack-cli)
-[![chat on gitter](https://badges.gitter.im/webpack/webpack.svg)](https://gitter.im/webpack/webpack)
-[![Install Size](https://packagephobia.now.sh/badge?p=webpack-cli)](https://packagephobia.now.sh/result?p=webpack-cli)
-[![npm](https://img.shields.io/npm/dw/webpack-cli.svg)](https://www.npmjs.com/package/webpack-cli)
-[![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lernajs.io/)
+[![Code Climate][maintainability]][maintainability-url]
+[![chat on gitter][chat]][chat-url]
+[![Install Size][size]][size-url]
+[![Downloads][downloads]][downloads-url]
+[![lerna][lerna]][lerna-url]
+[![GitHub contributors][contributors]][contributors-url]
-
-* [About](#about)
+- [About](#about)
- [How to install](#how-to-install)
-* [Getting Started](#getting-started)
-* [webpack CLI Scaffolds](#webpack-cli-scaffolds)
-* Commands
- - [`webpack-cli init`](./packages/init/README.md#webpack-cli-init)
- - [`webpack-cli add`](./packages/add/README.md#webpack-cli-add)
- - [`webpack-cli info`](./packages/info/README.md#webpack-cli-info)
- - [`webpack-cli migrate`](./packages/migrate/README.md#webpack-cli-migrate)
- - [`webpack-cli remove`](./packages/remove/README.md#webpack-cli-remove)
- - [`webpack-cli generate-plugin`](./packages/generate-plugin/README.md#webpack-cli-generate-plugin)
- - [`webpack-cli generate-loader`](./packages/generate-loader/README.md#webpack-cli-generate-loader)
- - [`webpack-cli serve`](./packages/serve/README.md#webpack-cli-serve)
- - [`webpack-cli update`](./packages/update/README.md#webpack-cli-update)
-* [webpack.config.js](https://webpack.js.org/concepts/configuration/)
-* [Contributing and Internal Documentation](#contributing-and-internal-documentation)
+- [Packages](#packages)
+ - [Commands](#commands)
+ - [Utilities](#utilities)
+- [Getting started](#getting-started)
+- [webpack CLI Scaffolds](#webpack-cli-scaffolds)
+- [Contributing and Internal Documentation](#contributing-and-internal-documentation)
+- [Open Collective](#open-collective)
## About
@@ -49,30 +42,76 @@
Otherwise `npm install --save-dev webpack-cli` or `yarn add webpack-cli --dev` will install it.
+## Packages
+
+We organize webpack CLI as a multi-package repository using [lerna](https://github.com/lerna/lerna). Every command has a dedicated subfolder in the `packages` Folder. Here's a summary of commands provided by the CLI.
+
### Commands
-Supporting developers is an important task for webpack CLI. Thus, webpack CLI provides different commands for many common tasks. We organize webpack CLI as a [multi-package repository](https://github.com/lerna/lerna). Every command has a dedicated subfolder in the `packages` Folder.
+Supporting developers is an important task for webpack CLI. Thus, webpack CLI provides different commands for many common tasks.
+
+- [`webpack-cli init`](./packages/init/README.md#webpack-cli-init) - Create a new webpack configuration.
+- [`webpack-cli add`](./packages/add/README.md#webpack-cli-add) - Add new properties to a webpack configuration file.
+- [`webpack-cli info`](./packages/info/README.md#webpack-cli-info) - Returns information related to the local environment.
+- [`webpack-cli migrate`](./packages/migrate/README.md#webpack-cli-migrate) - Migrate project from one version to another.
+- [`webpack-cli remove`](./packages/remove/README.md#webpack-cli-remove) - Remove properties from a webpack configuration file.
+- [`webpack-cli generate-plugin`](./packages/generate-plugin/README.md#webpack-cli-generate-plugin) - Initiate new plugin project.
+- [`webpack-cli generate-loader`](./packages/generate-loader/README.md#webpack-cli-generate-loader) - Initiate new loader project.
+- [`webpack-cli serve`](./packages/serve/README.md#webpack-cli-serve) - Use webpack with a development server that provides live reloading.
+- [`webpack-cli update`](./packages/update/README.md#webpack-cli-update) - Update properties in a webpack configuration file.
+
+### Utilities
+
+The project also has several utility packages which are used by other commands
+
+- [`utils`](./packages/utils/README.md) - Several utilities used across webpack-cli.
+- [`generators`](./packages/generators/README.md) - Contains all webpack-cli related yeoman generators.
+- [`webpack-scaffold`](./packages/info/README.md#webpack-cli-info) - Utilities to create a webpack scaffold.
## Getting started
-When you have followed the [Getting Started](https://webpack.js.org/guides/getting-started/) guide of webpack then webpack CLI is already installed! Otherwise, you would need to install webpack CLI and the packages you want to use. If we want to use the `init` functionality to create a new `webpack.config.js` configuration file:
+When you have followed the [Getting Started](https://webpack.js.org/guides/getting-started/) guide of webpack then webpack CLI is already installed! Otherwise, you would need to install webpack CLI and the packages you want to use. If we want to use the `init` command to create a new `webpack.config.js` configuration file:
```sh
npm i webpack-cli @webpack-cli/init
npx webpack-cli init
```
-You will answer many questions when running the `init` so webpack CLI can provide the best fitting configuration.
+You will be prompted for some questions about what how you want to generate your config file when running the `init` command so webpack CLI can provide the best fitting configuration.
## webpack CLI Scaffolds
-With v3 of webpack CLI, we introduced scaffolding as an integral part of the CLI. Our goal is to simplify the creation of webpack configurations for different purposes. Additionally, sharing such solutions with the community is beneficial and with webpack webpack's we want to allow this. We provide `webpack-scaffold` as a utility suite for creating these scaffolds. It contains functions that could be of use for creating an scaffold yourself.
+With v3 of webpack CLI, we introduced scaffolding as an integral part of the CLI. Our goal is to simplify the creation of webpack configurations for different purposes. Additionally, sharing such solutions with the community is beneficial and with webpack, we want to allow this. We provide `webpack-scaffold` as a utility suite for creating these scaffolds. It contains functions that could be of use for creating a scaffold yourself.
-You can read more about [Scaffolding](./SCAFFOLDING.md) or check out the example project [How do I compose a webpack-scaffold?](https://github.com/evenstensberg/webpack-scaffold-demo).
+You can read more about [Scaffolding](https://webpack.js.org/guides/scaffolding), learn [How to compose a webpack-scaffold?](https://webpack.js.org/contribute/writing-a-scaffold) or generate one with [webpack-scaffold-starter](https://github.com/rishabh3112/webpack-scaffold-starter).
## Contributing and Internal Documentation
The webpack family welcomes any contributor, small or big. We are happy to elaborate, guide you through the source code and find issues you might want to work on! To get started have a look at our [documentation on contributing](./.github/CONTRIBUTING.md).
+## Open Collective
+
+If you like **webpack**, please consider donating to our [Open Collective](https://opencollective.com/webpack) to help us maintain it.
+
+We show this message in the terminal once a week, if you want you can disable it by setting the environment variable `DISABLE_OPENCOLLECTIVE=true` or `CI=true`.
+
+[build-status]: https://travis-ci.org/webpack/webpack-cli.svg
+[build-status-url]: https://travis-ci.org/webpack/webpack-cli
+[build-status-azure]: https://dev.azure.com/webpack/webpack/_apis/build/status/webpack.webpack-cli
+[build-status-azure-url]: https://dev.azure.com/webpack/webpack/_build/latest?definitionId=4
+[chat]: https://badges.gitter.im/webpack/webpack.svg
+[chat-url]: https://gitter.im/webpack/webpack
+[contributors]: https://img.shields.io/github/contributors/webpack/webpack-cli.svg
+[contributors-url]: https://github.com/webpack/webpack-cli/graphs/contributors
[deps]: https://img.shields.io/david/webpack/webpack.svg
[deps-url]: https://david-dm.org/webpack/webpack-cli
+[downloads]: https://img.shields.io/npm/dw/webpack-cli.svg
+[downloads-url]: https://www.npmjs.com/package/webpack-cli
+[lerna]: https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg
+[lerna-url]: http://www.lernajs.io/
+[npm]: https://img.shields.io/npm/v/webpack-cli.svg
+[npm-url]: https://www.npmjs.com/package/webpack-cli
+[maintainability]: https://codeclimate.com/github/webpack/webpack-cli/badges/gpa.svg
+[maintainability-url]: https://codeclimate.com/github/webpack/webpack-cli
+[size]: https://packagephobia.now.sh/badge?p=webpack-cli
+[size-url]: https://packagephobia.now.sh/result?p=webpack-cli