nav tabs on admin dashboard

node_modules/webpack/lib/Module.js

@@ -11,6 +11,13 @@ const ModuleReason = require("./ModuleReason");
 const SortableSet = require("./util/SortableSet");
 const Template = require("./Template");
 
+/** @typedef {import("./Chunk")} Chunk */
+/** @typedef {import("./RequestShortener")} RequestShortener */
+/** @typedef {import("./WebpackError")} WebpackError */
+/** @typedef {import("./util/createHash").Hash} Hash */
+
+const EMPTY_RESOLVE_OPTIONS = {};
+
 let debugId = 1000;
 
 const sortById = (a, b) => {
@@ -21,43 +28,112 @@ const sortByDebugId = (a, b) => {
 	return a.debugId - b.debugId;
 };
 
-class Module extends DependenciesBlock {
+/** @typedef {(requestShortener: RequestShortener) => string} OptimizationBailoutFunction */
 
-	constructor() {
+class Module extends DependenciesBlock {
+	constructor(type, context = null) {
 		super();
-		this.context = null;
-		this.reasons = [];
+		/** @type {string} */
+		this.type = type;
+		/** @type {string} */
+		this.context = context;
+
+		// Unique Id
+		/** @type {number} */
 		this.debugId = debugId++;
-		this.id = null;
-		this.portableId = null;
-		this.index = null;
-		this.index2 = null;
-		this.depth = null;
-		this.used = null;
-		this.usedExports = null;
-		this.providedExports = null;
-		this._chunks = new SortableSet(undefined, sortById);
-		this._chunksDebugIdent = undefined;
+
+		// Hash
+		/** @type {string} */
+		this.hash = undefined;
+		/** @type {string} */
+		this.renderedHash = undefined;
+
+		// Info from Factory
+		/** @type {TODO} */
+		this.resolveOptions = EMPTY_RESOLVE_OPTIONS;
+		/** @type {object} */
+		this.factoryMeta = {};
+
+		// Info from Build
+		/** @type {WebpackError[]} */
 		this.warnings = [];
-		this.dependenciesWarnings = [];
+		/** @type {WebpackError[]} */
 		this.errors = [];
-		this.dependenciesErrors = [];
-		this.strict = false;
-		this.meta = {};
+		/** @type {object} */
+		this.buildMeta = undefined;
+		/** @type {object} */
+		this.buildInfo = undefined;
+
+		// Graph (per Compilation)
+		/** @type {ModuleReason[]} */
+		this.reasons = [];
+		/** @type {SortableSet<Chunk>} */
+		this._chunks = new SortableSet(undefined, sortById);
+
+		// Info from Compilation (per Compilation)
+		/** @type {number|string} */
+		this.id = null;
+		/** @type {number} */
+		this.index = null;
+		/** @type {number} */
+		this.index2 = null;
+		/** @type {number} */
+		this.depth = null;
+		/** @type {Module} */
+		this.issuer = null;
+		/** @type {undefined | object} */
+		this.profile = undefined;
+		/** @type {boolean} */
+		this.prefetched = false;
+		/** @type {boolean} */
+		this.built = false;
+
+		// Info from Optimization (per Compilation)
+		/** @type {null | boolean} */
+		this.used = null;
+		/** @type {false | true | string[]} */
+		this.usedExports = null;
+		/** @type {(string | OptimizationBailoutFunction)[]} */
 		this.optimizationBailout = [];
+
+		// delayed operations
+		/** @type {undefined | {oldChunk: Chunk, newChunks: Chunk[]}[] } */
+		this._rewriteChunkInReasons = undefined;
+
+		/** @type {boolean} */
+		this.useSourceMap = false;
+
+		// info from build
+		this._source = null;
+	}
+
+	get exportsArgument() {
+		return (this.buildInfo && this.buildInfo.exportsArgument) || "exports";
+	}
+
+	get moduleArgument() {
+		return (this.buildInfo && this.buildInfo.moduleArgument) || "module";
 	}
 
 	disconnect() {
+		this.hash = undefined;
+		this.renderedHash = undefined;
+
 		this.reasons.length = 0;
+		this._rewriteChunkInReasons = undefined;
+		this._chunks.clear();
+
 		this.id = null;
 		this.index = null;
 		this.index2 = null;
 		this.depth = null;
+		this.issuer = null;
+		this.profile = undefined;
+		this.prefetched = false;
+		this.built = false;
+
 		this.used = null;
 		this.usedExports = null;
-		this.providedExports = null;
-		this._chunks.clear();
-		this._chunksDebugIdent = undefined;
 		this.optimizationBailout.length = 0;
 		super.disconnect();
 	}
@@ -68,23 +144,21 @@ class Module extends DependenciesBlock {
 		this.index2 = null;
 		this.depth = null;
 		this._chunks.clear();
-		this._chunksDebugIdent = undefined;
 		super.unseal();
 	}
 
 	setChunks(chunks) {
 		this._chunks = new SortableSet(chunks, sortById);
-		this._chunksDebugIdent = undefined;
 	}
 
 	addChunk(chunk) {
+		if (this._chunks.has(chunk)) return false;
 		this._chunks.add(chunk);
-		this._chunksDebugIdent = undefined;
+		return true;
 	}
 
 	removeChunk(chunk) {
-		if(this._chunks.delete(chunk)) {
-			this._chunksDebugIdent = undefined;
+		if (this._chunks.delete(chunk)) {
 			chunk.removeModule(this);
 			return true;
 		}
@@ -95,32 +169,23 @@ class Module extends DependenciesBlock {
 		return this._chunks.has(chunk);
 	}
 
-	getChunkIdsIdent() {
-		if(this._chunksDebugIdent !== undefined) return this._chunksDebugIdent;
-		this._chunks.sortWith(sortByDebugId);
-		const chunks = this._chunks;
-		const list = [];
-		for(const chunk of chunks) {
-			const debugId = chunk.debugId;
-
-			if(typeof debugId !== "number") {
-				return this._chunksDebugIdent = null;
-			}
-
-			list.push(debugId);
+	isEntryModule() {
+		for (const chunk of this._chunks) {
+			if (chunk.entryModule === this) return true;
 		}
-
-		return this._chunksDebugIdent = list.join(",");
+		return false;
 	}
 
-	forEachChunk(fn) {
-		this._chunks.forEach(fn);
-	}
-
-	mapChunks(fn) {
-		return Array.from(this._chunks, fn);
+	get optional() {
+		return (
+			this.reasons.length > 0 &&
+			this.reasons.every(r => r.dependency && r.dependency.optional)
+		);
 	}
 
+	/**
+	 * @returns {Chunk[]} all chunks which contain the module
+	 */
 	getChunks() {
 		return Array.from(this._chunks);
 	}
@@ -129,28 +194,33 @@ class Module extends DependenciesBlock {
 		return this._chunks.size;
 	}
 
+	get chunksIterable() {
+		return this._chunks;
+	}
+
 	hasEqualsChunks(otherModule) {
-		if(this._chunks.size !== otherModule._chunks.size) return false;
+		if (this._chunks.size !== otherModule._chunks.size) return false;
 		this._chunks.sortWith(sortByDebugId);
 		otherModule._chunks.sortWith(sortByDebugId);
 		const a = this._chunks[Symbol.iterator]();
 		const b = otherModule._chunks[Symbol.iterator]();
-		while(true) { // eslint-disable-line
+		// eslint-disable-next-line no-constant-condition
+		while (true) {
 			const aItem = a.next();
 			const bItem = b.next();
-			if(aItem.done) return true;
-			if(aItem.value !== bItem.value) return false;
+			if (aItem.done) return true;
+			if (aItem.value !== bItem.value) return false;
 		}
 	}
 
-	addReason(module, dependency) {
-		this.reasons.push(new ModuleReason(module, dependency));
+	addReason(module, dependency, explanation) {
+		this.reasons.push(new ModuleReason(module, dependency, explanation));
 	}
 
 	removeReason(module, dependency) {
-		for(let i = 0; i < this.reasons.length; i++) {
+		for (let i = 0; i < this.reasons.length; i++) {
 			let r = this.reasons[i];
-			if(r.module === module && r.dependency === dependency) {
+			if (r.module === module && r.dependency === dependency) {
 				this.reasons.splice(i, 1);
 				return true;
 			}
@@ -159,36 +229,70 @@ class Module extends DependenciesBlock {
 	}
 
 	hasReasonForChunk(chunk) {
-		for(let i = 0; i < this.reasons.length; i++) {
-			if(this.reasons[i].hasChunk(chunk))
-				return true;
+		if (this._rewriteChunkInReasons) {
+			for (const operation of this._rewriteChunkInReasons) {
+				this._doRewriteChunkInReasons(operation.oldChunk, operation.newChunks);
+			}
+			this._rewriteChunkInReasons = undefined;
+		}
+		for (let i = 0; i < this.reasons.length; i++) {
+			if (this.reasons[i].hasChunk(chunk)) return true;
 		}
 		return false;
 	}
 
+	hasReasons() {
+		return this.reasons.length > 0;
+	}
+
 	rewriteChunkInReasons(oldChunk, newChunks) {
-		for(let i = 0; i < this.reasons.length; i++) {
+		// This is expensive. Delay operation until we really need the data
+		if (this._rewriteChunkInReasons === undefined) {
+			this._rewriteChunkInReasons = [];
+		}
+		this._rewriteChunkInReasons.push({
+			oldChunk,
+			newChunks
+		});
+	}
+
+	_doRewriteChunkInReasons(oldChunk, newChunks) {
+		for (let i = 0; i < this.reasons.length; i++) {
 			this.reasons[i].rewriteChunks(oldChunk, newChunks);
 		}
 	}
 
+	/**
+	 * @param {string=} exportName the name of the export
+	 * @returns {boolean|string} false if the export isn't used, true if no exportName is provided and the module is used, or the name to access it if the export is used
+	 */
 	isUsed(exportName) {
-		if(this.used === null) return exportName;
-		if(!exportName) return !!this.used;
-		if(!this.used) return false;
-		if(!this.usedExports) return false;
-		if(this.usedExports === true) return exportName;
+		if (!exportName) return this.used !== false;
+		if (this.used === null || this.usedExports === null) return exportName;
+		if (!this.used) return false;
+		if (!this.usedExports) return false;
+		if (this.usedExports === true) return exportName;
 		let idx = this.usedExports.indexOf(exportName);
-		if(idx < 0) return false;
-		if(this.isProvided(exportName))
-			return Template.numberToIdentifer(idx);
+		if (idx < 0) return false;
+
+		// Mangle export name if possible
+		if (this.isProvided(exportName)) {
+			if (this.buildMeta.exportsType === "namespace") {
+				return Template.numberToIdentifer(idx);
+			}
+			if (
+				this.buildMeta.exportsType === "named" &&
+				!this.usedExports.includes("default")
+			) {
+				return Template.numberToIdentifer(idx);
+			}
+		}
 		return exportName;
 	}
 
 	isProvided(exportName) {
-		if(!Array.isArray(this.providedExports))
-			return null;
-		return this.providedExports.indexOf(exportName) >= 0;
+		if (!Array.isArray(this.buildMeta.providedExports)) return null;
+		return this.buildMeta.providedExports.includes(exportName);
 	}
 
 	toString() {
@@ -199,27 +303,83 @@ class Module extends DependenciesBlock {
 		return true;
 	}
 
+	/**
+	 * @param {Hash} hash the hash used to track dependencies
+	 * @returns {void}
+	 */
 	updateHash(hash) {
-		hash.update(this.id + "" + this.used);
+		hash.update(`${this.id}`);
 		hash.update(JSON.stringify(this.usedExports));
 		super.updateHash(hash);
 	}
 
 	sortItems(sortChunks) {
 		super.sortItems();
-		if(sortChunks)
-			this._chunks.sort();
-		this.reasons.sort((a, b) => sortById(a.module, b.module));
-		if(Array.isArray(this.usedExports)) {
+		if (sortChunks) this._chunks.sort();
+		this.reasons.sort((a, b) => {
+			if (a.module === b.module) return 0;
+			if (!a.module) return -1;
+			if (!b.module) return 1;
+			return sortById(a.module, b.module);
+		});
+		if (Array.isArray(this.usedExports)) {
 			this.usedExports.sort();
 		}
 	}
 
 	unbuild() {
+		this.dependencies.length = 0;
+		this.blocks.length = 0;
+		this.variables.length = 0;
+		this.buildMeta = undefined;
+		this.buildInfo = undefined;
 		this.disconnect();
 	}
+
+	get arguments() {
+		throw new Error("Module.arguments was removed, there is no replacement.");
+	}
+
+	set arguments(value) {
+		throw new Error("Module.arguments was removed, there is no replacement.");
+	}
 }
 
+// TODO remove in webpack 5
+Object.defineProperty(Module.prototype, "forEachChunk", {
+	configurable: false,
+	value: util.deprecate(
+		/**
+		 * @deprecated
+		 * @param {function(any, any, Set<any>): void} fn callback function
+		 * @returns {void}
+		 * @this {Module}
+		 */
+		function(fn) {
+			this._chunks.forEach(fn);
+		},
+		"Module.forEachChunk: Use for(const chunk of module.chunksIterable) instead"
+	)
+});
+
+// TODO remove in webpack 5
+Object.defineProperty(Module.prototype, "mapChunks", {
+	configurable: false,
+	value: util.deprecate(
+		/**
+		 * @deprecated
+		 * @param {function(any, any): void} fn Mapper function
+		 * @returns {Array<TODO>} Array of chunks mapped
+		 * @this {Module}
+		 */
+		function(fn) {
+			return Array.from(this._chunks, fn);
+		},
+		"Module.mapChunks: Use Array.from(module.chunksIterable, fn) instead"
+	)
+});
+
+// TODO remove in webpack 5
 Object.defineProperty(Module.prototype, "entry", {
 	configurable: false,
 	get() {
@@ -230,21 +390,46 @@ Object.defineProperty(Module.prototype, "entry", {
 	}
 });
 
-Object.defineProperty(Module.prototype, "chunks", {
+// TODO remove in webpack 5
+Object.defineProperty(Module.prototype, "meta", {
 	configurable: false,
-	get: util.deprecate(function() {
-		return Array.from(this._chunks);
-	}, "Module.chunks: Use Module.forEachChunk/mapChunks/getNumberOfChunks/isInChunk/addChunk/removeChunk instead"),
-	set() {
-		throw new Error("Readonly. Use Module.addChunk/removeChunk to modify chunks.");
-	}
+	get: util.deprecate(
+		/**
+		 * @deprecated
+		 * @returns {void}
+		 * @this {Module}
+		 */
+		function() {
+			return this.buildMeta;
+		},
+		"Module.meta was renamed to Module.buildMeta"
+	),
+	set: util.deprecate(
+		/**
+		 * @deprecated
+		 * @param {TODO} value Value
+		 * @returns {void}
+		 * @this {Module}
+		 */
+		function(value) {
+			this.buildMeta = value;
+		},
+		"Module.meta was renamed to Module.buildMeta"
+	)
 });
 
+/** @type {function(): string} */
 Module.prototype.identifier = null;
+
+/** @type {function(RequestShortener): string} */
 Module.prototype.readableIdentifier = null;
+
 Module.prototype.build = null;
 Module.prototype.source = null;
 Module.prototype.size = null;
 Module.prototype.nameForCondition = null;
+/** @type {null | function(Chunk): boolean} */
+Module.prototype.chunkCondition = null;
+Module.prototype.updateCacheModule = null;
 
 module.exports = Module;