webpack · sokra · Oct 10, 2019 · Sep 30, 2019 · Oct 2, 2019 · Oct 2, 2019
diff --git a/.gitignore b/.gitignore
@@ -1,7 +1,7 @@
 /node_modules
 /test/js
 /test/browsertest/js
-/test/fixtures/temp-cache-fixture*
+/test/fixtures/temp-*
 /benchmark/js
 /benchmark/fixtures
 /examples/**/dist

diff --git a/declarations.d.ts b/declarations.d.ts
@@ -7,6 +7,15 @@ declare namespace NodeJS {
 	}
 }
 
+// TODO remove when https://github.com/DefinitelyTyped/DefinitelyTyped/pull/38753 is merged
+declare module "util" {
+	function deprecate<T extends Function>(
+		fn: T,
+		message: string,
+		code?: string
+	): T;
+}
+
 declare module "neo-async" {
 	interface QueueObject<T, E> {
 		push(item: T): void;

diff --git a/declarations/WebpackOptions.d.ts b/declarations/WebpackOptions.d.ts
@@ -552,6 +552,10 @@ export interface Experiments {
 	 * Support .mjs files as way to define strict ESM file (node.js)
 	 */
 	mjs?: boolean;
+	/**
+	 * Allow outputing javascript files as module source type
+	 */
+	outputModule?: boolean;
 	/**
 	 * Support WebAssembly as synchronous EcmaScript Module (outdated)
 	 */
@@ -1163,26 +1167,7 @@ export interface OutputOptions {
 	/**
 	 * Add a comment in the UMD wrapper.
 	 */
-	auxiliaryComment?:
-		| string
-		| {
-				/**
-				 * Set comment for `amd` section in UMD
-				 */
-				amd?: string;
-				/**
-				 * Set comment for `commonjs` (exports) section in UMD
-				 */
-				commonjs?: string;
-				/**
-				 * Set comment for `commonjs2` (module.exports) section in UMD
-				 */
-				commonjs2?: string;
-				/**
-				 * Set comment for `root` (global variable) section in UMD
-				 */
-				root?: string;
-		  };
+	auxiliaryComment?: string | LibraryCustomUmdCommentObject;
 	/**
 	 * The callback function name used by webpack for loading of chunks in WebWorkers.
 	 */
@@ -1256,6 +1241,10 @@ export interface OutputOptions {
 	 * The filename of the Hot Update Main File. It is inside the `output.path` directory.
 	 */
 	hotUpdateMainFilename?: string;
+	/**
+	 * Wrap javascript code into IIFEs to avoid leaking into global scope.
+	 */
+	iife?: boolean;
 	/**
 	 * The JSONP function used by webpack for async loading of chunks.
 	 */
@@ -1277,6 +1266,7 @@ export interface OutputOptions {
 	 */
 	libraryTarget?:
 		| "var"
+		| "module"
 		| "assign"
 		| "this"
 		| "window"
@@ -1291,6 +1281,10 @@ export interface OutputOptions {
 		| "umd2"
 		| "jsonp"
 		| "system";
+	/**
+	 * Output javascript files as module source type.
+	 */
+	module?: boolean;
 	/**
 	 * The output directory as **absolute path** (required).
 	 */
@@ -1302,7 +1296,12 @@ export interface OutputOptions {
 	/**
 	 * The `publicPath` specifies the public URL address of the output files when referenced in a browser.
 	 */
-	publicPath?: string | Function;
+	publicPath?:
+		| string
+		| ((
+				pathData: import("../lib/Compilation").PathData,
+				assetInfo?: import("../lib/Compilation").AssetInfo
+		  ) => string);
 	/**
 	 * The filename of the SourceMaps for the JavaScript files. They are inside the `output.path` directory.
 	 */
@@ -1324,6 +1323,30 @@ export interface OutputOptions {
 	 */
 	webassemblyModuleFilename?: string;
 }
+/**
+ * Set explicit comments for `commonjs`, `commonjs2`, `amd`, and `root`.
+ *
+ * This interface was referenced by `WebpackOptions`'s JSON-Schema
+ * via the `definition` "LibraryCustomUmdCommentObject".
+ */
+export interface LibraryCustomUmdCommentObject {
+	/**
+	 * Set comment for `amd` section in UMD
+	 */
+	amd?: string;
+	/**
+	 * Set comment for `commonjs` (exports) section in UMD
+	 */
+	commonjs?: string;
+	/**
+	 * Set comment for `commonjs2` (module.exports) section in UMD
+	 */
+	commonjs2?: string;
+	/**
+	 * Set comment for `root` (global variable) section in UMD
+	 */
+	root?: string;
+}
 /**
  * This interface was referenced by `WebpackOptions`'s JSON-Schema
  * via the `definition` "LibraryCustomUmdObject".

diff --git a/examples/aggressive-merging/webpack.config.js b/examples/aggressive-merging/webpack.config.js
@@ -1,5 +1,6 @@
 var path = require("path");
-var AggressiveMergingPlugin = require("../../lib/optimize/AggressiveMergingPlugin");
+var { AggressiveMergingPlugin } = require("../../").optimize;
+
 module.exports = {
 	// mode: "development" || "production",
 	entry: {

diff --git a/examples/module/README.md b/examples/module/README.md
@@ -0,0 +1,117 @@
+# example.js
+
+```javascript
+import { increment as inc, value } from "./counter";
+import { resetCounter, print } from "./methods";
+print(value);
+inc();
+inc();
+inc();
+print(value);
+resetCounter();
+print(value);
+```
+
+# methods.js
+
+```javascript
+export { reset as resetCounter } from "./counter";
+
+export const print = value => console.log(value);
+```
+
+# counter.js
+
+```javascript
+export let value = 0;
+export function increment() {
+	value++;
+}
+export function decrement() {
+	value--;
+}
+export function reset() {
+	value = 0;
+}
+```
+
+# dist/output.js
+
+```javascript
+/******/ "use strict";
+/*!********************************!*\
+  !*** ./example.js + 2 modules ***!
+  \********************************/
+/*! exports [not provided] [unused] */
+/*! runtime requirements: supports-symbols-deconflicting */
+
+// CONCATENATED MODULE: ./counter.js
+let value = 0;
+function increment() {
+	value++;
+}
+function decrement() {
+	value--;
+}
+function counter_reset() {
+	value = 0;
+}
+
+// CONCATENATED MODULE: ./methods.js
+
+
+const print = value => console.log(value);
+
+// CONCATENATED MODULE: ./example.js
+
+
+print(value);
+increment();
+increment();
+increment();
+print(value);
+counter_reset();
+print(value);
+```
+
+# dist/output.js (production)
+
+```javascript
+let o=0;function n(){o++}const c=o=>console.log(o);c(o),n(),n(),n(),c(o),c(o=0);
+```
+
+# Info
+
+## Unoptimized
+
+```
+Hash: 0a1b2c3d4e5f6a7b8c9d
+Version: webpack 5.0.0-alpha.30
+    Asset       Size  Chunks             Chunk Names
+output.js  621 bytes     {0}  [emitted]  main
+Entrypoint main = output.js
+chunk {0} output.js (main) 429 bytes [entry] [rendered]
+    > ./example.js main
+ [0] ./example.js + 2 modules 429 bytes {0} [built]
+     [no exports]
+     [no exports used]
+     entry ./example.js main
+     used a library export
+```
+
+## Production mode
+
+```
+Hash: 0a1b2c3d4e5f6a7b8c9d
+Version: webpack 5.0.0-alpha.30
+    Asset      Size  Chunks             Chunk Names
+output.js  80 bytes   {179}  [emitted]  main
+Entrypoint main = output.js
+chunk {179} output.js (main) 429 bytes [entry] [rendered]
+    > ./example.js main
+ [291] ./example.js + 2 modules 429 bytes {179} [built]
+       [no exports]
+       [no exports used]
+       entry ./example.js main
+       used a library export
+```
diff --git a/examples/module/build.js b/examples/module/build.js
@@ -0,0 +1 @@
+require("../build-common");
diff --git a/examples/module/counter.js b/examples/module/counter.js
@@ -0,0 +1,10 @@
+export let value = 0;
+export function increment() {
+	value++;
+}
+export function decrement() {
+	value--;
+}
+export function reset() {
+	value = 0;
+}
diff --git a/examples/module/example.js b/examples/module/example.js
@@ -0,0 +1,9 @@
+import { increment as inc, value } from "./counter";
+import { resetCounter, print } from "./methods";
+print(value);
+inc();
+inc();
+inc();
+print(value);
+resetCounter();
+print(value);
diff --git a/examples/module/methods.js b/examples/module/methods.js
@@ -0,0 +1,3 @@
+export { reset as resetCounter } from "./counter";
+
+export const print = value => console.log(value);
diff --git a/examples/module/template.md b/examples/module/template.md
@@ -0,0 +1,43 @@
+# example.js
+
+```javascript
+_{{example.js}}_
+```
+
+# methods.js
+
+```javascript
+_{{methods.js}}_
+```
+
+# counter.js
+
+```javascript
+_{{counter.js}}_
+```
+
+# dist/output.js
+
+```javascript
+_{{dist/output.js}}_
+```
+
+# dist/output.js (production)
+
+```javascript
+_{{production:dist/output.js}}_
+```
+
+# Info
+
+## Unoptimized
+
+```
+_{{stdout}}_
+```
+
+## Production mode
+
+```
+_{{production:stdout}}_
+```
diff --git a/examples/module/webpack.config.js b/examples/module/webpack.config.js
@@ -0,0 +1,12 @@
+module.exports = {
+	output: {
+		module: true
+	},
+	optimization: {
+		usedExports: true,
+		concatenateModules: true
+	},
+	experiments: {
+		outputModule: true
+	}
+};
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		export { reset as resetCounter } from "./counter";

		export const print = value => console.log(value);