/* MIT License http://www.opensource.org/licenses/mit-license.php Author Tobias Koppers @sokra */ "use strict"; const util = require("util"); const ExportsInfo = require("./ExportsInfo"); const ModuleGraphConnection = require("./ModuleGraphConnection"); const SortableSet = require("./util/SortableSet"); const WeakTupleMap = require("./util/WeakTupleMap"); /** @typedef {import("./DependenciesBlock")} DependenciesBlock */ /** @typedef {import("./Dependency")} Dependency */ /** @typedef {import("./ExportsInfo").ExportInfo} ExportInfo */ /** @typedef {import("./Module")} Module */ /** @typedef {import("./ModuleProfile")} ModuleProfile */ /** @typedef {import("./RequestShortener")} RequestShortener */ /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */ /** * @callback OptimizationBailoutFunction * @param {RequestShortener} requestShortener * @returns {string} */ const EMPTY_SET = new Set(); /** * @param {SortableSet} set input * @returns {readonly Map} mapped by origin module */ const getConnectionsByOriginModule = set => { const map = new Map(); /** @type {Module | 0} */ let lastModule = 0; /** @type {ModuleGraphConnection[]} */ let lastList = undefined; for (const connection of set) { const { originModule } = connection; if (lastModule === originModule) { lastList.push(connection); } else { lastModule = originModule; const list = map.get(originModule); if (list !== undefined) { lastList = list; list.push(connection); } else { const list = [connection]; lastList = list; map.set(originModule, list); } } } return map; }; class ModuleGraphModule { constructor() { /** @type {SortableSet} */ this.incomingConnections = new SortableSet(); /** @type {Set | undefined} */ this.outgoingConnections = undefined; /** @type {Module | null} */ this.issuer = undefined; /** @type {(string | OptimizationBailoutFunction)[]} */ this.optimizationBailout = []; /** @type {ExportsInfo} */ this.exports = new ExportsInfo(); /** @type {number} */ this.preOrderIndex = null; /** @type {number} */ this.postOrderIndex = null; /** @type {number} */ this.depth = null; /** @type {ModuleProfile} */ this.profile = undefined; /** @type {boolean} */ this.async = false; } } class ModuleGraph { constructor() { /** @type {Map} */ this._dependencyMap = new Map(); /** @type {Map} */ this._moduleMap = new Map(); /** @type {Map>} */ this._originMap = new Map(); /** @type {Map} */ this._metaMap = new Map(); // Caching this._cacheModuleGraphModuleKey1 = undefined; this._cacheModuleGraphModuleValue1 = undefined; this._cacheModuleGraphModuleKey2 = undefined; this._cacheModuleGraphModuleValue2 = undefined; this._cacheModuleGraphDependencyKey = undefined; this._cacheModuleGraphDependencyValue = undefined; /** @type {WeakTupleMap} */ this._cache = undefined; } /** * @param {Module} module the module * @returns {ModuleGraphModule} the internal module */ _getModuleGraphModule(module) { if (this._cacheModuleGraphModuleKey1 === module) return this._cacheModuleGraphModuleValue1; if (this._cacheModuleGraphModuleKey2 === module) return this._cacheModuleGraphModuleValue2; let mgm = this._moduleMap.get(module); if (mgm === undefined) { mgm = new ModuleGraphModule(); this._moduleMap.set(module, mgm); } this._cacheModuleGraphModuleKey2 = this._cacheModuleGraphModuleKey1; this._cacheModuleGraphModuleValue2 = this._cacheModuleGraphModuleValue1; this._cacheModuleGraphModuleKey1 = module; this._cacheModuleGraphModuleValue1 = mgm; return mgm; } /** * @param {Dependency} dependency the dependency * @param {DependenciesBlock} block parent block * @param {Module} module parent module * @returns {void} */ setParents(dependency, block, module) { dependency._parentDependenciesBlock = block; dependency._parentModule = module; } /** * @param {Dependency} dependency the dependency * @returns {Module} parent module */ getParentModule(dependency) { return dependency._parentModule; } /** * @param {Dependency} dependency the dependency * @returns {DependenciesBlock} parent block */ getParentBlock(dependency) { return dependency._parentDependenciesBlock; } /** * @param {Module} originModule the referencing module * @param {Dependency} dependency the referencing dependency * @param {Module} module the referenced module * @returns {void} */ setResolvedModule(originModule, dependency, module) { const connection = new ModuleGraphConnection( originModule, dependency, module, undefined, dependency.weak, dependency.getCondition(this) ); this._dependencyMap.set(dependency, connection); const connections = this._getModuleGraphModule(module).incomingConnections; connections.add(connection); const mgm = this._getModuleGraphModule(originModule); if (mgm.outgoingConnections === undefined) { mgm.outgoingConnections = new Set(); } mgm.outgoingConnections.add(connection); } /** * @param {Dependency} dependency the referencing dependency * @param {Module} module the referenced module * @returns {void} */ updateModule(dependency, module) { const connection = this._dependencyMap.get(dependency); if (connection.module === module) return; const newConnection = connection.clone(); newConnection.module = module; this._dependencyMap.set(dependency, newConnection); connection.setActive(false); const originMgm = this._getModuleGraphModule(connection.originModule); originMgm.outgoingConnections.add(newConnection); const targetMgm = this._getModuleGraphModule(module); targetMgm.incomingConnections.add(newConnection); } /** * @param {Dependency} dependency the referencing dependency * @returns {void} */ removeConnection(dependency) { const connection = this._dependencyMap.get(dependency); const targetMgm = this._getModuleGraphModule(connection.module); targetMgm.incomingConnections.delete(connection); const originMgm = this._getModuleGraphModule(connection.originModule); originMgm.outgoingConnections.delete(connection); this._dependencyMap.delete(dependency); } /** * @param {Dependency} dependency the referencing dependency * @param {string} explanation an explanation * @returns {void} */ addExplanation(dependency, explanation) { const connection = this._dependencyMap.get(dependency); connection.addExplanation(explanation); } /** * @param {Module} sourceModule the source module * @param {Module} targetModule the target module * @returns {void} */ cloneModuleAttributes(sourceModule, targetModule) { const oldMgm = this._getModuleGraphModule(sourceModule); const newMgm = this._getModuleGraphModule(targetModule); newMgm.postOrderIndex = oldMgm.postOrderIndex; newMgm.preOrderIndex = oldMgm.preOrderIndex; newMgm.depth = oldMgm.depth; newMgm.exports = oldMgm.exports; newMgm.async = oldMgm.async; } /** * @param {Module} module the module * @returns {void} */ removeModuleAttributes(module) { const mgm = this._getModuleGraphModule(module); mgm.postOrderIndex = null; mgm.preOrderIndex = null; mgm.depth = null; mgm.async = false; } /** * @returns {void} */ removeAllModuleAttributes() { for (const mgm of this._moduleMap.values()) { mgm.postOrderIndex = null; mgm.preOrderIndex = null; mgm.depth = null; mgm.async = false; } } /** * @param {Module} oldModule the old referencing module * @param {Module} newModule the new referencing module * @param {function(ModuleGraphConnection): boolean} filterConnection filter predicate for replacement * @returns {void} */ moveModuleConnections(oldModule, newModule, filterConnection) { if (oldModule === newModule) return; const oldMgm = this._getModuleGraphModule(oldModule); const newMgm = this._getModuleGraphModule(newModule); // Outgoing connections const oldConnections = oldMgm.outgoingConnections; if (oldConnections !== undefined) { if (newMgm.outgoingConnections === undefined) { newMgm.outgoingConnections = new Set(); } const newConnections = newMgm.outgoingConnections; for (const connection of oldConnections) { if (filterConnection(connection)) { connection.originModule = newModule; newConnections.add(connection); oldConnections.delete(connection); } } } // Incoming connections const oldConnections2 = oldMgm.incomingConnections; const newConnections2 = newMgm.incomingConnections; for (const connection of oldConnections2) { if (filterConnection(connection)) { connection.module = newModule; newConnections2.add(connection); oldConnections2.delete(connection); } } } /** * @param {Module} oldModule the old referencing module * @param {Module} newModule the new referencing module * @param {function(ModuleGraphConnection): boolean} filterConnection filter predicate for replacement * @returns {void} */ copyOutgoingModuleConnections(oldModule, newModule, filterConnection) { if (oldModule === newModule) return; const oldMgm = this._getModuleGraphModule(oldModule); const newMgm = this._getModuleGraphModule(newModule); // Outgoing connections const oldConnections = oldMgm.outgoingConnections; if (oldConnections !== undefined) { if (newMgm.outgoingConnections === undefined) { newMgm.outgoingConnections = new Set(); } const newConnections = newMgm.outgoingConnections; for (const connection of oldConnections) { if (filterConnection(connection)) { const newConnection = connection.clone(); newConnection.originModule = newModule; newConnections.add(newConnection); if (newConnection.module !== undefined) { const otherMgm = this._getModuleGraphModule(newConnection.module); otherMgm.incomingConnections.add(newConnection); } } } } } /** * @param {Module} module the referenced module * @param {string} explanation an explanation why it's referenced * @returns {void} */ addExtraReason(module, explanation) { const connections = this._getModuleGraphModule(module).incomingConnections; connections.add(new ModuleGraphConnection(null, null, module, explanation)); } /** * @param {Dependency} dependency the dependency to look for a referenced module * @returns {Module} the referenced module */ getResolvedModule(dependency) { const connection = this._dependencyMap.get(dependency); return connection !== undefined ? connection.resolvedModule : null; } /** * @param {Dependency} dependency the dependency to look for a referenced module * @returns {ModuleGraphConnection | undefined} the connection */ getConnection(dependency) { const connection = this._dependencyMap.get(dependency); return connection; } /** * @param {Dependency} dependency the dependency to look for a referenced module * @returns {Module} the referenced module */ getModule(dependency) { const connection = this._dependencyMap.get(dependency); return connection !== undefined ? connection.module : null; } /** * @param {Dependency} dependency the dependency to look for a referencing module * @returns {Module} the referencing module */ getOrigin(dependency) { const connection = this._dependencyMap.get(dependency); return connection !== undefined ? connection.originModule : null; } /** * @param {Dependency} dependency the dependency to look for a referencing module * @returns {Module} the original referencing module */ getResolvedOrigin(dependency) { const connection = this._dependencyMap.get(dependency); return connection !== undefined ? connection.resolvedOriginModule : null; } /** * @param {Module} module the module * @returns {Iterable} reasons why a module is included */ getIncomingConnections(module) { const connections = this._getModuleGraphModule(module).incomingConnections; return connections; } /** * @param {Module} module the module * @returns {Iterable} list of outgoing connections */ getOutgoingConnections(module) { const connections = this._getModuleGraphModule(module).outgoingConnections; return connections === undefined ? EMPTY_SET : connections; } /** * @param {Module} module the module * @returns {readonly Map} reasons why a module is included, in a map by source module */ getIncomingConnectionsByOriginModule(module) { const connections = this._getModuleGraphModule(module).incomingConnections; return connections.getFromUnorderedCache(getConnectionsByOriginModule); } /** * @param {Module} module the module * @returns {ModuleProfile | null} the module profile */ getProfile(module) { const mgm = this._getModuleGraphModule(module); return mgm.profile; } /** * @param {Module} module the module * @param {ModuleProfile | null} profile the module profile * @returns {void} */ setProfile(module, profile) { const mgm = this._getModuleGraphModule(module); mgm.profile = profile; } /** * @param {Module} module the module * @returns {Module | null} the issuer module */ getIssuer(module) { const mgm = this._getModuleGraphModule(module); return mgm.issuer; } /** * @param {Module} module the module * @param {Module | null} issuer the issuer module * @returns {void} */ setIssuer(module, issuer) { const mgm = this._getModuleGraphModule(module); mgm.issuer = issuer; } /** * @param {Module} module the module * @param {Module | null} issuer the issuer module * @returns {void} */ setIssuerIfUnset(module, issuer) { const mgm = this._getModuleGraphModule(module); if (mgm.issuer === undefined) mgm.issuer = issuer; } /** * @param {Module} module the module * @returns {(string | OptimizationBailoutFunction)[]} optimization bailouts */ getOptimizationBailout(module) { const mgm = this._getModuleGraphModule(module); return mgm.optimizationBailout; } /** * @param {Module} module the module * @returns {true | string[] | null} the provided exports */ getProvidedExports(module) { const mgm = this._getModuleGraphModule(module); return mgm.exports.getProvidedExports(); } /** * @param {Module} module the module * @param {string | string[]} exportName a name of an export * @returns {boolean | null} true, if the export is provided by the module. * null, if it's unknown. * false, if it's not provided. */ isExportProvided(module, exportName) { const mgm = this._getModuleGraphModule(module); const result = mgm.exports.isExportProvided(exportName); return result === undefined ? null : result; } /** * @param {Module} module the module * @returns {ExportsInfo} info about the exports */ getExportsInfo(module) { const mgm = this._getModuleGraphModule(module); return mgm.exports; } /** * @param {Module} module the module * @param {string} exportName the export * @returns {ExportInfo} info about the export */ getExportInfo(module, exportName) { const mgm = this._getModuleGraphModule(module); return mgm.exports.getExportInfo(exportName); } /** * @param {Module} module the module * @param {string} exportName the export * @returns {ExportInfo} info about the export (do not modify) */ getReadOnlyExportInfo(module, exportName) { const mgm = this._getModuleGraphModule(module); return mgm.exports.getReadOnlyExportInfo(exportName); } /** * @param {Module} module the module * @param {RuntimeSpec} runtime the runtime * @returns {false | true | SortableSet | null} the used exports * false: module is not used at all. * true: the module namespace/object export is used. * SortableSet: these export names are used. * empty SortableSet: module is used but no export. * null: unknown, worst case should be assumed. */ getUsedExports(module, runtime) { const mgm = this._getModuleGraphModule(module); return mgm.exports.getUsedExports(runtime); } /** * @param {Module} module the module * @returns {number} the index of the module */ getPreOrderIndex(module) { const mgm = this._getModuleGraphModule(module); return mgm.preOrderIndex; } /** * @param {Module} module the module * @returns {number} the index of the module */ getPostOrderIndex(module) { const mgm = this._getModuleGraphModule(module); return mgm.postOrderIndex; } /** * @param {Module} module the module * @param {number} index the index of the module * @returns {void} */ setPreOrderIndex(module, index) { const mgm = this._getModuleGraphModule(module); mgm.preOrderIndex = index; } /** * @param {Module} module the module * @param {number} index the index of the module * @returns {boolean} true, if the index was set */ setPreOrderIndexIfUnset(module, index) { const mgm = this._getModuleGraphModule(module); if (mgm.preOrderIndex === null) { mgm.preOrderIndex = index; return true; } return false; } /** * @param {Module} module the module * @param {number} index the index of the module * @returns {void} */ setPostOrderIndex(module, index) { const mgm = this._getModuleGraphModule(module); mgm.postOrderIndex = index; } /** * @param {Module} module the module * @param {number} index the index of the module * @returns {boolean} true, if the index was set */ setPostOrderIndexIfUnset(module, index) { const mgm = this._getModuleGraphModule(module); if (mgm.postOrderIndex === null) { mgm.postOrderIndex = index; return true; } return false; } /** * @param {Module} module the module * @returns {number} the depth of the module */ getDepth(module) { const mgm = this._getModuleGraphModule(module); return mgm.depth; } /** * @param {Module} module the module * @param {number} depth the depth of the module * @returns {void} */ setDepth(module, depth) { const mgm = this._getModuleGraphModule(module); mgm.depth = depth; } /** * @param {Module} module the module * @param {number} depth the depth of the module * @returns {boolean} true, if the depth was set */ setDepthIfLower(module, depth) { const mgm = this._getModuleGraphModule(module); if (mgm.depth === null || mgm.depth > depth) { mgm.depth = depth; return true; } return false; } /** * @param {Module} module the module * @returns {boolean} true, if the module is async */ isAsync(module) { const mgm = this._getModuleGraphModule(module); return mgm.async; } /** * @param {Module} module the module * @returns {void} */ setAsync(module) { const mgm = this._getModuleGraphModule(module); mgm.async = true; } /** * @param {any} thing any thing * @returns {Object} metadata */ getMeta(thing) { let meta = this._metaMap.get(thing); if (meta === undefined) { meta = Object.create(null); this._metaMap.set(thing, meta); } return meta; } /** * @param {any} thing any thing * @returns {Object} metadata */ getMetaIfExisting(thing) { return this._metaMap.get(thing); } freeze() { this._cache = new WeakTupleMap(); } unfreeze() { this._cache = undefined; } /** * @template {any[]} T * @template V * @param {(moduleGraph: ModuleGraph, ...args: T) => V} fn computer * @param {T} args arguments * @returns {V} computed value or cached */ cached(fn, ...args) { if (this._cache === undefined) return fn(this, ...args); return this._cache.provide(fn, ...args, () => fn(this, ...args)); } // TODO remove in webpack 6 /** * @param {Module} module the module * @param {string} deprecateMessage message for the deprecation message * @param {string} deprecationCode code for the deprecation * @returns {ModuleGraph} the module graph */ static getModuleGraphForModule(module, deprecateMessage, deprecationCode) { const fn = deprecateMap.get(deprecateMessage); if (fn) return fn(module); const newFn = util.deprecate( /** * @param {Module} module the module * @returns {ModuleGraph} the module graph */ module => { const moduleGraph = moduleGraphForModuleMap.get(module); if (!moduleGraph) throw new Error( deprecateMessage + "There was no ModuleGraph assigned to the Module for backward-compat (Use the new API)" ); return moduleGraph; }, deprecateMessage + ": Use new ModuleGraph API", deprecationCode ); deprecateMap.set(deprecateMessage, newFn); return newFn(module); } // TODO remove in webpack 6 /** * @param {Module} module the module * @param {ModuleGraph} moduleGraph the module graph * @returns {void} */ static setModuleGraphForModule(module, moduleGraph) { moduleGraphForModuleMap.set(module, moduleGraph); } // TODO remove in webpack 6 /** * @param {Module} module the module * @returns {void} */ static clearModuleGraphForModule(module) { moduleGraphForModuleMap.delete(module); } } // TODO remove in webpack 6 /** @type {WeakMap} */ const moduleGraphForModuleMap = new WeakMap(); // TODO remove in webpack 6 /** @type {Map ModuleGraph>} */ const deprecateMap = new Map(); module.exports = ModuleGraph; module.exports.ModuleGraphConnection = ModuleGraphConnection;