@depup/webpack 5.111.1-depup.1 → 5.112.0-depup.0

package/lib/DependencyTemplate.js

@@ -5,73 +5,6 @@
 
 "use strict";
 
-/** @import { ReplaceSource } from "webpack-sources" */
-/** @import ChunkGraph from "./ChunkGraph" */
-/** @import CodeGenerationResults from "./CodeGenerationResults" */
-/** @import ConcatenationScope from "./ConcatenationScope" */
-/** @import Dependency from "./Dependency" */
-/** @import DependencyTemplates from "./DependencyTemplates" */
-/** @import { GenerateContext } from "./Generator" */
-/** @import Module, { CodeGenerationResultData, RuntimeRequirements } from "./Module" */
-/** @import ModuleGraph from "./ModuleGraph" */
-/** @import RuntimeTemplate from "./RuntimeTemplate" */
-/** @import { RuntimeSpec } from "./util/runtime" */
-
-/**
- * Defines the init fragment type used by this module.
- * @template T
- * @typedef {import("./InitFragment")<T>} InitFragment
- */
-
-/**
- * Defines the dependency template context type used by this module.
- * @typedef {object} DependencyTemplateContext
- * @property {RuntimeTemplate} runtimeTemplate the runtime template
- * @property {DependencyTemplates} dependencyTemplates the dependency templates
- * @property {ModuleGraph} moduleGraph the module graph
- * @property {ChunkGraph} chunkGraph the chunk graph
- * @property {RuntimeRequirements} runtimeRequirements the requirements for runtime
- * @property {Module} module current module
- * @property {RuntimeSpec} runtime current runtimes, for which code is generated
- * @property {InitFragment<GenerateContext>[]} initFragments mutable array of init fragments for the current module
- * @property {ConcatenationScope=} concatenationScope when in a concatenated module, information about other concatenated modules
- * @property {CodeGenerationResults} codeGenerationResults the code generation results
- * @property {InitFragment<GenerateContext>[]} chunkInitFragments chunkInitFragments
- * @property {(() => CodeGenerationResultData)=} getData get access to the code generation data
- */
-
-/**
- * Defines the css dependency template context extras type used by this module.
- * @typedef {object} CssDependencyTemplateContextExtras
- * @property {CssData} cssData the css exports data
- * @property {string} type the css exports data
- */
-
-/**
- * Defines the css data type used by this module.
- * @typedef {object} CssData
- * @property {boolean} esModule whether export __esModule
- * @property {Map<string, string>} exports the css exports
- * @property {Map<string, { line: number, column: number }>=} exportLocs source position (line is 1-based, column is 0-based) of each export's defining identifier in the original CSS, used to emit fine-grained JS-to-CSS source mappings
- */
-
-/** @typedef {DependencyTemplateContext & CssDependencyTemplateContextExtras} CssDependencyTemplateContext */
-
-class DependencyTemplate {
-	/* istanbul ignore next */
-	/**
-	 * Applies the plugin by registering its hooks on the compiler.
-	 * @abstract
-	 * @param {Dependency} dependency the dependency for which the template should be applied
-	 * @param {ReplaceSource} source the current replace source which can be modified
-	 * @param {DependencyTemplateContext} templateContext the context object
-	 * @returns {void}
-	 */
-	apply(dependency, source, templateContext) {
-		const AbstractMethodError = require("./errors/AbstractMethodError");
-
-		throw new AbstractMethodError();
-	}
-}
-
-module.exports = DependencyTemplate;
+// TODO in the next major release: remove
+// Some old plugins use `require("webpack/lib/DependencyTemplate")`, in the next major release developer should migrate to `compiler.webpack.template.DependencyTemplate`
+module.exports = require("./template/DependencyTemplate");

package/lib/EntryPlugin.js

@@ -5,71 +5,6 @@
 
 "use strict";
 
-const EntryDependency = require("./dependencies/EntryDependency");
-
-/** @import Compiler from "./Compiler" */
-/** @import { EntryOptions } from "./Entrypoint" */
-
-const PLUGIN_NAME = "EntryPlugin";
-
-class EntryPlugin {
-	/**
-	 * An entry plugin which will handle creation of the EntryDependency
-	 * @param {string} context context path
-	 * @param {string} entry entry path
-	 * @param {EntryOptions | string=} options entry options (passing a string is deprecated)
-	 */
-	constructor(context, entry, options) {
-		/** @type {string} */
-		this.context = context;
-		/** @type {string} */
-		this.entry = entry;
-		this.options = options || "";
-	}
-
-	/**
-	 * Applies the plugin by registering its hooks on the compiler.
-	 * @param {Compiler} compiler the compiler instance
-	 * @returns {void}
-	 */
-	apply(compiler) {
-		compiler.hooks.compilation.tap(
-			PLUGIN_NAME,
-			(compilation, { normalModuleFactory }) => {
-				compilation.dependencyFactories.set(
-					EntryDependency,
-					normalModuleFactory
-				);
-			}
-		);
-
-		const { entry, options, context } = this;
-		const dep = EntryPlugin.createDependency(entry, options);
-
-		compiler.hooks.make.tapAsync(PLUGIN_NAME, (compilation, callback) => {
-			compilation.addEntry(context, dep, options, (err) => {
-				callback(err);
-			});
-		});
-	}
-
-	/**
-	 * Creates a dependency.
-	 * @param {string} entry entry request
-	 * @param {EntryOptions | string} options entry options (passing string is deprecated)
-	 * @returns {EntryDependency} the dependency
-	 */
-	static createDependency(entry, options) {
-		const dep = new EntryDependency(entry);
-		// TODO webpack 6 remove string option
-		dep.loc = {
-			name:
-				typeof options === "object"
-					? /** @type {string} */ (options.name)
-					: options
-		};
-		return dep;
-	}
-}
-
-module.exports = EntryPlugin;
+// TODO in the next major release: remove
+// Some old plugins use `require("webpack/lib/EntryPlugin")`, in the next major release developer should migrate to `compiler.webpack.EntryPlugin`
+module.exports = require("./entry/EntryPlugin");

package/lib/Entrypoint.js

@@ -5,124 +5,6 @@
 
 "use strict";
 
-const ChunkGroup = require("./ChunkGroup");
-const SortableSet = require("./util/SortableSet");
-
-/**
- * @import {
- * 	EntryDescriptionNormalized as EntryDescription
- * } from "../declarations/WebpackOptions"
- */
-/** @import Chunk from "./Chunk" */
-
-/** @typedef {{ name?: string, worklet?: boolean } & Omit<EntryDescription, "import">} EntryOptions */
-
-/**
- * Entrypoint serves as an encapsulation primitive for chunks that are
- * a part of a single ChunkGroup. They represent all bundles that need to be loaded for a
- * single instance of a page. Multi-page application architectures will typically yield multiple Entrypoint objects
- * inside of the compilation, whereas a Single Page App may only contain one with many lazy-loaded chunks.
- */
-class Entrypoint extends ChunkGroup {
-	/**
-	 * Creates an instance of Entrypoint.
-	 * @param {EntryOptions | string} entryOptions the options for the entrypoint (or name)
-	 * @param {boolean=} initial false, when the entrypoint is not initial loaded
-	 */
-	constructor(entryOptions, initial = true) {
-		if (typeof entryOptions === "string") {
-			entryOptions = { name: entryOptions };
-		}
-		super({
-			name: entryOptions.name
-		});
-		this.options = entryOptions;
-		/** @type {Chunk=} */
-		this._runtimeChunk = undefined;
-		/** @type {Chunk=} */
-		this._entrypointChunk = undefined;
-		/** @type {boolean} */
-		this._initial = initial;
-		/** @type {SortableSet<Entrypoint>} */
-		this._dependOn = new SortableSet();
-	}
-
-	/**
-	 * Indicates whether this chunk group is loaded as part of the initial page
-	 * load instead of being created lazily.
-	 * @returns {boolean} true, when this chunk group will be loaded on initial page load
-	 */
-	isInitial() {
-		return this._initial;
-	}
-
-	/**
-	 * Sets the runtimeChunk for an entrypoint.
-	 * @param {Chunk} chunk the chunk being set as the runtime chunk.
-	 * @returns {void}
-	 */
-	setRuntimeChunk(chunk) {
-		this._runtimeChunk = chunk;
-	}
-
-	/**
-	 * Fetches the chunk reference containing the webpack bootstrap code
-	 * @returns {Chunk | null} returns the runtime chunk or null if there is none
-	 */
-	getRuntimeChunk() {
-		if (this._runtimeChunk) return this._runtimeChunk;
-		for (const parent of this.parentsIterable) {
-			if (parent instanceof Entrypoint) return parent.getRuntimeChunk();
-		}
-		return null;
-	}
-
-	/**
-	 * Sets the chunk with the entrypoint modules for an entrypoint.
-	 * @param {Chunk} chunk the chunk being set as the entrypoint chunk.
-	 * @returns {void}
-	 */
-	setEntrypointChunk(chunk) {
-		this._entrypointChunk = chunk;
-	}
-
-	/**
-	 * Returns the chunk which contains the entrypoint modules
-	 * (or at least the execution of them)
-	 * @returns {Chunk} chunk
-	 */
-	getEntrypointChunk() {
-		return /** @type {Chunk} */ (this._entrypointChunk);
-	}
-
-	/**
-	 * Replaces one member chunk with another while preserving the group's
-	 * ordering and avoiding duplicates.
-	 * @param {Chunk} oldChunk chunk to be replaced
-	 * @param {Chunk} newChunk New chunk that will be replaced with
-	 * @returns {boolean | undefined} returns true if the replacement was successful
-	 */
-	replaceChunk(oldChunk, newChunk) {
-		if (this._runtimeChunk === oldChunk) this._runtimeChunk = newChunk;
-		if (this._entrypointChunk === oldChunk) this._entrypointChunk = newChunk;
-		return super.replaceChunk(oldChunk, newChunk);
-	}
-
-	/**
-	 * @param {Entrypoint} entrypoint the entrypoint
-	 * @returns {void}
-	 */
-	addDependOn(entrypoint) {
-		this._dependOn.add(entrypoint);
-	}
-
-	/**
-	 * @param {Entrypoint} entrypoint the entrypoint
-	 * @returns {boolean} true if the entrypoint is in the dependOn set
-	 */
-	dependOn(entrypoint) {
-		return this._dependOn.has(entrypoint);
-	}
-}
-
-module.exports = Entrypoint;
+// TODO in the next major release: remove
+// Some old plugins use `require("webpack/lib/Entrypoint")`, in the next major release developer should migrate to `compiler.webpack.Entrypoint`
+module.exports = require("./graph/Entrypoint");

package/lib/ExternalsPlugin.js

@@ -5,95 +5,6 @@
 
 "use strict";
 
-const { ModuleExternalInitFragment } = require("./ExternalModule");
-const ExternalModuleFactoryPlugin = require("./ExternalModuleFactoryPlugin");
-const ConcatenatedModule = require("./optimize/ConcatenatedModule");
-
-/**
- * @import {
- * 	ExternalsType,
- * 	Externals
- * } from "../declarations/WebpackOptions"
- */
-/** @import Compiler from "./Compiler" */
-/** @import { Imported } from "./ExternalModule" */
-/** @import Dependency from "./Dependency" */
-
-const PLUGIN_NAME = "ExternalsPlugin";
-
-class ExternalsPlugin {
-	/**
-	 * Creates an instance of ExternalsPlugin.
-	 * @param {ExternalsType | ((dependency: Dependency) => ExternalsType)} type default external type
-	 * @param {Externals} externals externals config
-	 */
-	constructor(type, externals) {
-		this.type = type;
-		/** @type {Externals} */
-		this.externals = externals;
-	}
-
-	/**
-	 * Applies the plugin by registering its hooks on the compiler.
-	 * @param {Compiler} compiler the compiler instance
-	 * @returns {void}
-	 */
-	apply(compiler) {
-		compiler.hooks.compile.tap(PLUGIN_NAME, ({ normalModuleFactory }) => {
-			new ExternalModuleFactoryPlugin(this.type, this.externals).apply(
-				normalModuleFactory
-			);
-		});
-
-		compiler.hooks.compilation.tap(PLUGIN_NAME, (compilation) => {
-			const { concatenatedModuleInfo } =
-				ConcatenatedModule.getCompilationHooks(compilation);
-			concatenatedModuleInfo.tap(PLUGIN_NAME, (updatedInfo, moduleInfo) => {
-				const rawExportMap = updatedInfo.rawExportMap;
-
-				if (!rawExportMap) {
-					return;
-				}
-
-				const chunkInitFragments = moduleInfo.chunkInitFragments;
-				const moduleExternalInitFragments =
-					/** @type {InstanceType<ModuleExternalInitFragment>[]} */
-					(
-						chunkInitFragments
-							? /** @type {unknown[]} */
-								(chunkInitFragments).filter(
-									(fragment) => fragment instanceof ModuleExternalInitFragment
-								)
-							: []
-					);
-
-				let initFragmentChanged = false;
-
-				for (const fragment of moduleExternalInitFragments) {
-					const imported = fragment.getImported();
-
-					if (Array.isArray(imported)) {
-						const newImported =
-							/** @type {Imported} */
-							(
-								imported.map(([specifier, finalName]) => [
-									specifier,
-									rawExportMap.has(specifier)
-										? rawExportMap.get(specifier)
-										: finalName
-								])
-							);
-						fragment.setImported(newImported);
-						initFragmentChanged = true;
-					}
-				}
-
-				if (initFragmentChanged) {
-					return true;
-				}
-			});
-		});
-	}
-}
-
-module.exports = ExternalsPlugin;
+// TODO in the next major release: remove
+// Some old plugins use `require("webpack/lib/ExternalsPlugin")`, in the next major release developer should migrate to `compiler.webpack.ExternalsPlugin`
+module.exports = require("./externals/ExternalsPlugin");