@depup/webpack 5.106.1-depup.0 → 5.109.2-depup.0

package/lib/dependencies/StaticExportsDependency.js

@@ -10,19 +10,22 @@ const NullDependency = require("./NullDependency");
 
 /** @typedef {import("../Dependency").ExportsSpec} ExportsSpec */
 /** @typedef {import("../ModuleGraph")} ModuleGraph */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
-
 /** @typedef {string[] | true} Exports */
 
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<[Exports, boolean]>} ObjectDeserializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext<[Exports, boolean]>} ObjectSerializerContext */
+
 class StaticExportsDependency extends NullDependency {
 	/**
+	 * Creates an instance of StaticExportsDependency.
 	 * @param {Exports} exports export names
 	 * @param {boolean} canMangle true, if mangling exports names is allowed
 	 */
 	constructor(exports, canMangle) {
 		super();
+		/** @type {Exports} */
 		this.exports = exports;
+		/** @type {boolean} */
 		this.canMangle = canMangle;
 	}
 
@@ -44,23 +47,23 @@ class StaticExportsDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
-		const { write } = context;
-		write(this.exports);
-		write(this.canMangle);
+		context.write(this.exports).write(this.canMangle);
 		super.serialize(context);
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
-		const { read } = context;
-		this.exports = read();
-		this.canMangle = read();
-		super.deserialize(context);
+		this.exports = context.read();
+		const c1 = context.rest;
+		this.canMangle = c1.read();
+		super.deserialize(c1.rest);
 	}
 }
 

package/lib/dependencies/SystemPlugin.js

@@ -10,7 +10,7 @@ const {
 	JAVASCRIPT_MODULE_TYPE_DYNAMIC
 } = require("../ModuleTypeConstants");
 const RuntimeGlobals = require("../RuntimeGlobals");
-const WebpackError = require("../WebpackError");
+const WebpackError = require("../errors/WebpackError");
 const {
 	evaluateToString,
 	expressionIsUnsupported,
@@ -30,7 +30,7 @@ const PLUGIN_NAME = "SystemPlugin";
 
 class SystemPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -51,6 +51,7 @@ class SystemPlugin {
 					});
 
 				/**
+				 * Handles the hook callback for this code path.
 				 * @param {Parser} parser parser parser
 				 * @param {JavascriptParserOptions} parserOptions parserOptions
 				 * @returns {void}
@@ -61,6 +62,7 @@ class SystemPlugin {
 					}
 
 					/**
+					 * Sets not supported.
 					 * @param {string} name name
 					 */
 					const setNotSupported = (name) => {
@@ -107,16 +109,14 @@ class SystemPlugin {
 							/** @type {Range} */ (expr.range),
 							[RuntimeGlobals.system]
 						);
-						dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+						dep.loc = parser.getLocation(expr);
 						parser.state.module.addPresentationalDependency(dep);
 						return true;
 					});
 
 					parser.hooks.call.for("System.import").tap(PLUGIN_NAME, (expr) => {
 						parser.state.module.addWarning(
-							new SystemImportDeprecationWarning(
-								/** @type {DependencyLocation} */ (expr.loc)
-							)
+							new SystemImportDeprecationWarning(parser.getLocation(expr))
 						);
 
 						return parser.hooks.importCall.call({
@@ -144,6 +144,7 @@ class SystemPlugin {
 
 class SystemImportDeprecationWarning extends WebpackError {
 	/**
+	 * Creates an instance of SystemImportDeprecationWarning.
 	 * @param {DependencyLocation} loc location
 	 */
 	constructor(loc) {
@@ -152,8 +153,10 @@ class SystemImportDeprecationWarning extends WebpackError {
 				"For more info visit https://webpack.js.org/guides/code-splitting/"
 		);
 
+		/** @type {string} */
 		this.name = "SystemImportDeprecationWarning";
 
+		/** @type {DependencyLocation} */
 		this.loc = loc;
 	}
 }

package/lib/dependencies/SystemRuntimeModule.js

@@ -15,6 +15,7 @@ class SystemRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/dependencies/TopLevelAwaitDependency.js

@@ -0,0 +1,93 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+*/
+
+"use strict";
+
+const isGeneratorLowered = require("../async-modules/isGeneratorLowered");
+const makeSerializable = require("../util/makeSerializable");
+const NullDependency = require("./NullDependency");
+
+/** @typedef {import("webpack-sources").ReplaceSource} ReplaceSource */
+/** @typedef {import("../Dependency")} Dependency */
+/** @typedef {import("../DependencyTemplate").DependencyTemplateContext} DependencyTemplateContext */
+/** @typedef {import("../Module")} Module */
+/** @typedef {import("../javascript/JavascriptParser").Range} Range */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+
+/**
+ * Marks a top-level `await` expression so it can be rewritten to `(yield …)`
+ * when the module is lowered to a generator (target without `async`/`await`).
+ */
+class TopLevelAwaitDependency extends NullDependency {
+	/**
+	 * @param {Range} range range of the whole `await` expression
+	 * @param {Range} argumentRange range of the awaited argument
+	 */
+	constructor(range, argumentRange) {
+		super();
+		/** @type {Range} */
+		this.range = range;
+		/** @type {Range} */
+		this.argumentRange = argumentRange;
+	}
+
+	/**
+	 * Serializes this instance into the provided serializer context.
+	 * @param {ObjectSerializerContext} context context
+	 */
+	serialize(context) {
+		const { write } = context;
+		write(this.range);
+		write(this.argumentRange);
+		super.serialize(context);
+	}
+
+	/**
+	 * Restores this instance from the provided deserializer context.
+	 * @param {ObjectDeserializerContext} context context
+	 */
+	deserialize(context) {
+		const { read } = context;
+		this.range = read();
+		this.argumentRange = read();
+		super.deserialize(context);
+	}
+}
+
+makeSerializable(
+	TopLevelAwaitDependency,
+	"webpack/lib/dependencies/TopLevelAwaitDependency"
+);
+
+TopLevelAwaitDependency.Template = class TopLevelAwaitDependencyTemplate extends (
+	NullDependency.Template
+) {
+	/**
+	 * Applies the plugin by registering its hooks on the compiler.
+	 * @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, { module, moduleGraph, runtimeTemplate }) {
+		// Only rewrite when the body is a generator (no `async`/`await`, but
+		// generators). `await` and `yield` differ in precedence, so wrap the
+		// whole expression: `await X` -> `(yield X)`.
+		if (
+			!isGeneratorLowered(
+				/** @type {Module} */ (module),
+				moduleGraph,
+				runtimeTemplate
+			)
+		) {
+			return;
+		}
+		const dep = /** @type {TopLevelAwaitDependency} */ (dependency);
+		source.replace(dep.range[0], dep.argumentRange[0] - 1, "(yield ");
+		source.insert(dep.argumentRange[1], ")");
+	}
+};
+
+module.exports = TopLevelAwaitDependency;

package/lib/dependencies/URLContextDependency.js

@@ -11,13 +11,14 @@ const ContextDependencyTemplateAsRequireCall = require("./ContextDependencyTempl
 
 /** @typedef {import("../ContextModule").ContextOptions} ContextOptions */
 /** @typedef {import("../javascript/JavascriptParser").Range} Range */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<[Range]>} ObjectDeserializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext<[Range]>} ObjectSerializerContext */
 
 /** @typedef {ContextOptions & { request: string }} ContextDependencyOptions */
 
 class URLContextDependency extends ContextDependency {
 	/**
+	 * Creates an instance of URLContextDependency.
 	 * @param {ContextDependencyOptions} options options
 	 * @param {Range} range range
 	 * @param {Range} valueRange value range
@@ -37,21 +38,21 @@ class URLContextDependency extends ContextDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
-		const { write } = context;
-		write(this.valueRange);
+		context.write(this.valueRange);
 		super.serialize(context);
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
-		const { read } = context;
-		this.valueRange = read();
-		super.deserialize(context);
+		this.valueRange = context.read();
+		super.deserialize(context.rest);
 	}
 }
 

package/lib/dependencies/URLDependency.js

@@ -5,16 +5,23 @@
 
 "use strict";
 
+const {
+	ASSET_URL_TYPE,
+	JAVASCRIPT_TYPE
+} = require("../ModuleSourceTypeConstants");
 const RuntimeGlobals = require("../RuntimeGlobals");
 const RawDataUrlModule = require("../asset/RawDataUrlModule");
 const {
 	getDependencyUsedByExportsCondition
 } = require("../optimize/InnerGraph");
+const { toJsStringLiteral } = require("../util/identifier");
 const makeSerializable = require("../util/makeSerializable");
 const memoize = require("../util/memoize");
 const ModuleDependency = require("./ModuleDependency");
 
 /** @typedef {import("webpack-sources").ReplaceSource} ReplaceSource */
+/** @typedef {import("../ChunkGraph")} ChunkGraph */
+/** @typedef {import("../Compilation")} Compilation */
 /** @typedef {import("../Dependency")} Dependency */
 /** @typedef {import("../Dependency").GetConditionFn} GetConditionFn */
 /** @typedef {import("../DependencyTemplate").DependencyTemplateContext} DependencyTemplateContext */
@@ -22,15 +29,74 @@ const ModuleDependency = require("./ModuleDependency");
 /** @typedef {import("../ModuleGraph")} ModuleGraph */
 /** @typedef {import("../javascript/JavascriptParser").Range} Range */
 /** @typedef {import("../optimize/InnerGraph").UsedByExports} UsedByExports */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<[Range, boolean, UsedByExports | undefined, true | undefined, true | undefined, ("high" | "low" | "auto" | undefined), string | undefined, string | undefined, string | undefined]>} ObjectDeserializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext<[Range, boolean, UsedByExports | undefined, true | undefined, true | undefined, ("high" | "low" | "auto" | undefined), string | undefined, string | undefined, string | undefined]>} ObjectSerializerContext */
 
 const getIgnoredRawDataUrlModule = memoize(
 	() => new RawDataUrlModule("data:,", "ignored-asset", "(ignored asset)")
 );
 
+/**
+ * Resolves the static literal specifier (already quoted) for `new URL(<here>, import.meta.url)`,
+ * or `null` when the asset url can't be determined statically (e.g. a runtime/dynamic publicPath).
+ * @param {URLDependency} dep the dependency
+ * @param {DependencyTemplateContext} templateContext the template context
+ * @returns {string | null} a JS string literal, or `null` to fall back to the runtime form
+ */
+const getAnalyzableUrlSpecifier = (dep, templateContext) => {
+	const {
+		module: consumingModule,
+		moduleGraph,
+		chunkGraph,
+		runtime,
+		codeGenerationResults,
+		runtimeTemplate
+	} = templateContext;
+	const assetModule = moduleGraph.getModule(dep);
+	if (!assetModule || !codeGenerationResults.has(assetModule, runtime)) {
+		return null;
+	}
+	const urlData = codeGenerationResults.getData(assetModule, runtime, "url");
+	if (!urlData) return null;
+
+	const jsUrl = urlData[JAVASCRIPT_TYPE];
+	if (typeof jsUrl === "string") {
+		// The asset concatenates the runtime publicPath; rebuild a literal from the
+		// resolved filename. The base is the consuming chunk (`import.meta.url`).
+		if (jsUrl.includes(RuntimeGlobals.require)) {
+			const filename = codeGenerationResults.getData(
+				assetModule,
+				runtime,
+				"filename"
+			);
+			if (typeof filename !== "string") return null;
+			const { publicPath } = runtimeTemplate.outputOptions;
+			if (publicPath === "auto") {
+				const undo = runtimeTemplate._getModuleUndoPath(
+					consumingModule,
+					chunkGraph
+				);
+				return undo === null ? null : toJsStringLiteral(undo + filename);
+			}
+			if (typeof publicPath === "string" && !publicPath.includes("[")) {
+				return toJsStringLiteral(publicPath + filename);
+			}
+			return null;
+		}
+		// An already-quoted literal (generator `publicPath` / data: url) is used as-is;
+		// a raw value (external asset) is normalized to a quoted string.
+		return jsUrl.startsWith('"') ? jsUrl : toJsStringLiteral(jsUrl);
+	}
+
+	// Wrapper dropped: the asset is consumed as `asset-url` (absolute publicPath),
+	// so its resolved url is already a chunk-independent literal.
+	const assetUrl = urlData[ASSET_URL_TYPE];
+	return typeof assetUrl === "string" ? toJsStringLiteral(assetUrl) : null;
+};
+
 class URLDependency extends ModuleDependency {
 	/**
+	 * Creates an instance of URLDependency.
 	 * @param {string} request request
 	 * @param {Range} range range of the arguments of new URL( |> ... <| )
 	 * @param {Range} outerRange range of the full |> new URL(...) <|
@@ -40,9 +106,22 @@ class URLDependency extends ModuleDependency {
 		super(request);
 		this.range = range;
 		this.outerRange = outerRange;
+		/** @type {boolean} */
 		this.relative = relative || false;
 		/** @type {UsedByExports | undefined} */
 		this.usedByExports = undefined;
+		/** @type {true | undefined} */
+		this.prefetch = undefined;
+		/** @type {true | undefined} */
+		this.preload = undefined;
+		/** @type {"high" | "low" | "auto" | undefined} */
+		this.fetchPriority = undefined;
+		/** @type {string | undefined} */
+		this.asAttribute = undefined;
+		/** @type {string | undefined} */
+		this.typeAttribute = undefined;
+		/** @type {string | undefined} */
+		this.mediaAttribute = undefined;
 	}
 
 	get type() {
@@ -54,18 +133,16 @@ class URLDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Returns function to determine if the connection is active.
 	 * @param {ModuleGraph} moduleGraph module graph
 	 * @returns {null | false | GetConditionFn} function to determine if the connection is active
 	 */
 	getCondition(moduleGraph) {
-		return getDependencyUsedByExportsCondition(
-			this,
-			this.usedByExports,
-			moduleGraph
-		);
+		return getDependencyUsedByExportsCondition(this, moduleGraph);
 	}
 
 	/**
+	 * Creates an ignored module.
 	 * @param {string} context context directory
 	 * @returns {Module} ignored module
 	 */
@@ -74,25 +151,46 @@ class URLDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
-		const { write } = context;
-		write(this.outerRange);
-		write(this.relative);
-		write(this.usedByExports);
+		context
+			.write(this.outerRange)
+			.write(this.relative)
+			.write(this.usedByExports)
+			.write(this.prefetch)
+			.write(this.preload)
+			.write(this.fetchPriority)
+			.write(this.asAttribute)
+			.write(this.typeAttribute)
+			.write(this.mediaAttribute);
 		super.serialize(context);
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
-		const { read } = context;
-		this.outerRange = read();
-		this.relative = read();
-		this.usedByExports = read();
-		super.deserialize(context);
+		this.outerRange = context.read();
+		const c1 = context.rest;
+		this.relative = c1.read();
+		const c2 = c1.rest;
+		this.usedByExports = c2.read();
+		const c3 = c2.rest;
+		this.prefetch = c3.read();
+		const c4 = c3.rest;
+		this.preload = c4.read();
+		const c5 = c4.rest;
+		this.fetchPriority = c5.read();
+		const c6 = c5.rest;
+		this.asAttribute = c6.read();
+		const c7 = c6.rest;
+		this.typeAttribute = c7.read();
+		const c8 = c7.rest;
+		this.mediaAttribute = c8.read();
+		super.deserialize(c8.rest);
 	}
 }
 
@@ -100,6 +198,7 @@ URLDependency.Template = class URLDependencyTemplate extends (
 	ModuleDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @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
@@ -125,36 +224,61 @@ URLDependency.Template = class URLDependencyTemplate extends (
 			return;
 		}
 
+		// For ESM module output, emit the analyzable `new URL("./asset", import.meta.url)`
+		// form (literal specifier, no runtime helpers) so other bundlers and webpack itself
+		// can statically follow the asset. `url: "relative"` and prefetch/preload hints
+		// (which need the runtime asset reference) keep the runtime form.
+		if (
+			!dep.relative &&
+			!dep.prefetch &&
+			!dep.preload &&
+			runtimeTemplate.supportsAnalyzableEsm()
+		) {
+			const specifier = getAnalyzableUrlSpecifier(dep, templateContext);
+			if (specifier !== null) {
+				source.replace(
+					dep.range[0],
+					dep.range[1] - 1,
+					`/* asset import */ ${specifier}, ${runtimeTemplate.outputOptions.importMetaName}.url`
+				);
+				return;
+			}
+		}
+
 		runtimeRequirements.add(RuntimeGlobals.require);
 
+		const module = moduleGraph.getModule(dep);
+		const moduleRaw = runtimeTemplate.moduleRaw({
+			chunkGraph,
+			module,
+			request: dep.request,
+			runtimeRequirements,
+			weak: false
+		});
+
+		// Resource hints fire eagerly at chunk startup via the marker
+		// requirement / `StartupAssetHintRuntimeModule`; the call site stays
+		// a plain URL expression, so the browser is already prefetching by
+		// the time user code reaches this line.
+		if (dep.prefetch || dep.preload) {
+			runtimeRequirements.add(RuntimeGlobals.startupAssetHints);
+			if (dep.prefetch) runtimeRequirements.add(RuntimeGlobals.prefetchAsset);
+			if (dep.preload) runtimeRequirements.add(RuntimeGlobals.preloadAsset);
+		}
+
 		if (dep.relative) {
 			runtimeRequirements.add(RuntimeGlobals.relativeUrl);
 			source.replace(
 				dep.outerRange[0],
 				dep.outerRange[1] - 1,
-				`/* asset import */ new ${
-					RuntimeGlobals.relativeUrl
-				}(${runtimeTemplate.moduleRaw({
-					chunkGraph,
-					module: moduleGraph.getModule(dep),
-					request: dep.request,
-					runtimeRequirements,
-					weak: false
-				})})`
+				`/* asset import */ new ${RuntimeGlobals.relativeUrl}(${moduleRaw})`
 			);
 		} else {
 			runtimeRequirements.add(RuntimeGlobals.baseURI);
-
 			source.replace(
 				dep.range[0],
 				dep.range[1] - 1,
-				`/* asset import */ ${runtimeTemplate.moduleRaw({
-					chunkGraph,
-					module: moduleGraph.getModule(dep),
-					request: dep.request,
-					runtimeRequirements,
-					weak: false
-				})}, ${RuntimeGlobals.baseURI}`
+				`/* asset import */ ${moduleRaw}, ${RuntimeGlobals.baseURI}`
 			);
 		}
 	}

package/lib/dependencies/URLPlugin.js

@@ -22,6 +22,7 @@ const PLUGIN_NAME = "URLPlugin";
 
 class URLPlugin {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler compiler
 	 */
 	apply(compiler) {
@@ -43,6 +44,7 @@ class URLPlugin {
 				);
 
 				/**
+				 * Handles the hook callback for this code path.
 				 * @param {JavascriptParser} parser parser parser
 				 * @param {JavascriptParserOptions} parserOptions parserOptions
 				 * @returns {void}

package/lib/dependencies/UnsupportedDependency.js

@@ -12,43 +12,41 @@ const NullDependency = require("./NullDependency");
 /** @typedef {import("../Dependency")} Dependency */
 /** @typedef {import("../DependencyTemplate").DependencyTemplateContext} DependencyTemplateContext */
 /** @typedef {import("../javascript/JavascriptParser").Range} Range */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<[string, Range]>} ObjectDeserializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext<[string, Range]>} ObjectSerializerContext */
 
 class UnsupportedDependency extends NullDependency {
 	/**
+	 * Creates an instance of UnsupportedDependency.
 	 * @param {string} request the request string
 	 * @param {Range} range location in source code
 	 */
 	constructor(request, range) {
 		super();
 
+		/** @type {string} */
 		this.request = request;
 		this.range = range;
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
-		const { write } = context;
-
-		write(this.request);
-		write(this.range);
-
+		context.write(this.request).write(this.range);
 		super.serialize(context);
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
-		const { read } = context;
-
-		this.request = read();
-		this.range = read();
-
-		super.deserialize(context);
+		this.request = context.read();
+		const c1 = context.rest;
+		this.range = c1.read();
+		super.deserialize(c1.rest);
 	}
 }
 
@@ -61,6 +59,7 @@ UnsupportedDependency.Template = class UnsupportedDependencyTemplate extends (
 	NullDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @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