webpack 5.106.1 → 5.107.0

package/lib/stats/DefaultStatsPrinterPlugin.js

@@ -36,6 +36,7 @@ const DATA_URI_CONTENT_LENGTH = 16;
 const MAX_MODULE_IDENTIFIER_LENGTH = 80;
 
 /**
+ * Returns if n is 1, singular, else plural.
  * @param {number} n a number
  * @param {string} singular singular
  * @param {string} plural plural
@@ -44,6 +45,7 @@ const MAX_MODULE_IDENTIFIER_LENGTH = 80;
 const plural = (n, singular, plural) => (n === 1 ? singular : plural);
 
 /**
+ * Returns text.
  * @param {Record<string, number>} sizes sizes by source type
  * @param {StatsPrinterContext} options options
  * @returns {string | undefined} text
@@ -58,6 +60,7 @@ const printSizes = (sizes, { formatSize = (n) => `${n}` }) => {
 };
 
 /**
+ * Gets resource name.
  * @param {string | null} resource resource
  * @returns {string} resource name for display
  */
@@ -75,6 +78,7 @@ const getResourceName = (resource) => {
 };
 
 /**
+ * Returns prefix and module name.
  * @param {string} name module name
  * @returns {[string, string]} prefix and module name
  */
@@ -99,6 +103,7 @@ const getModuleName = (name) => {
 };
 
 /**
+ * Returns joined string.
  * @param {string} str string
  * @param {(item: string) => string} fn function to apply to each line
  * @returns {string} joined string
@@ -106,12 +111,14 @@ const getModuleName = (name) => {
 const mapLines = (str, fn) => str.split("\n").map(fn).join("\n");
 
 /**
+ * Returns number as two digit string, leading 0.
  * @param {number} n a number
  * @returns {string} number as two digit string, leading 0
  */
 const twoDigit = (n) => (n >= 10 ? `${n}` : `0${n}`);
 
 /**
+ * Checks whether this object is valid id.
  * @param {string | number | null} id an id
  * @returns {id is string | number} is i
  */
@@ -124,6 +131,7 @@ const isValidId = (id) => {
 };
 
 /**
+ * Returns string representation of list.
  * @template T
  * @param {T[] | undefined} list of items
  * @param {number} count number of items to show
@@ -133,28 +141,33 @@ const moreCount = (list, count) =>
 	list && list.length > 0 ? `+ ${count}` : `${count}`;
 
 /**
+ * Defines the with required type used by this module.
  * @template T
  * @template {keyof T} K
  * @typedef {{ [P in K]-?: T[P] }} WithRequired
  */
 
 /**
+ * Defines the define stats printer context type used by this module.
  * @template {keyof StatsPrinterContext} RequiredStatsPrinterContextKeys
  * @typedef {StatsPrinterContextWithExtra & WithRequired<StatsPrinterContext, "compilation" | RequiredStatsPrinterContextKeys>} DefineStatsPrinterContext
  */
 
 /**
+ * Defines the simple printer type used by this module.
  * @template T
  * @template {keyof StatsPrinterContext} RequiredStatsPrinterContextKeys
  * @typedef {(thing: Exclude<T, undefined>, context: DefineStatsPrinterContext<RequiredStatsPrinterContextKeys>, printer: StatsPrinter) => string | undefined} SimplePrinter
  */
 
 /**
+ * Defines the unpacked type used by this module.
  * @template T
  * @typedef {T extends (infer U)[] ? U : T} Unpacked
  */
 
 /**
+ * Defines the property name type used by this module.
  * @template {object} O
  * @template {keyof O} K
  * @template {string} B
@@ -162,6 +175,7 @@ const moreCount = (list, count) =>
  */
 
 /**
+ * Defines the array property name type used by this module.
  * @template {object} O
  * @template {keyof O} K
  * @template {string} B
@@ -169,6 +183,7 @@ const moreCount = (list, count) =>
  */
 
 /**
+ * Defines the exclamation type used by this module.
  * @template {object} O
  * @template {string} K
  * @template {string} E
@@ -176,6 +191,7 @@ const moreCount = (list, count) =>
  */
 
 /**
+ * Defines the shared type used by this module.
  * @template {object} O
  * @template {string} B
  * @template {string} [R=B]
@@ -184,6 +200,7 @@ const moreCount = (list, count) =>
  */
 
 /**
+ * Defines the shared type used by this module.
  * @typedef {Printers<KnownStatsCompilation, "compilation"> &
  * { ["compilation.summary!"]?: SimplePrinter<KnownStatsCompilation, "compilation"> } &
  * { ["compilation.errorsInChildren!"]?: SimplePrinter<KnownStatsCompilation, "compilation"> } &
@@ -406,6 +423,7 @@ const COMPILATION_SIMPLE_PRINTERS = {
 };
 
 /**
+ * Defines the shared type used by this module.
  * @typedef {Printers<KnownStatsAsset, "asset"> &
  * Printers<KnownStatsAsset["info"], "asset.info"> &
  * Exclamation<KnownStatsAsset, "asset.separator", "asset"> &
@@ -467,6 +485,7 @@ const ASSET_SIMPLE_PRINTERS = {
 };
 
 /**
+ * Defines the shared type used by this module.
  * @typedef {Printers<KnownStatsModule, "module"> &
  * Exclamation<KnownStatsModule, "module.separator", "module"> &
  * { ["module.filteredChildren"]?: SimplePrinter<number, "module"> } &
@@ -588,6 +607,7 @@ const MODULE_SIMPLE_PRINTERS = {
 };
 
 /**
+ * Defines the module issuer printers type used by this module.
  * @typedef {Printers<KnownStatsModuleIssuer, "moduleIssuer"> & Printers<KnownStatsModuleIssuer["profile"], "moduleIssuer.profile", "moduleIssuer">} ModuleIssuerPrinters
  */
 
@@ -598,6 +618,7 @@ const MODULE_ISSUER_PRINTERS = {
 };
 
 /**
+ * Defines the module reasons printers type used by this module.
  * @typedef {Printers<KnownStatsModuleReason, "moduleReason"> & { ["moduleReason.filteredChildren"]?: SimplePrinter<number, "moduleReason"> }} ModuleReasonsPrinters
  */
 
@@ -652,6 +673,7 @@ const MODULE_PROFILE_PRINTERS = {
 };
 
 /**
+ * Defines the shared type used by this module.
  * @typedef {Exclamation<KnownStatsChunkGroup, "chunkGroup.kind", "chunkGroupKind"> &
  * Exclamation<KnownStatsChunkGroup, "chunkGroup.separator", "chunkGroup"> &
  * Printers<KnownStatsChunkGroup, "chunkGroup"> &
@@ -716,6 +738,7 @@ const CHUNK_GROUP_PRINTERS = {
 };
 
 /**
+ * Defines the shared type used by this module.
  * @typedef {Printers<KnownStatsChunk, "chunk"> &
  * { ["chunk.childrenByOrder[].type"]: SimplePrinter<string, "chunk"> } &
  * { ["chunk.childrenByOrder[].children[]"]: SimplePrinter<ChunkId, "chunk"> } &
@@ -778,6 +801,7 @@ const CHUNK_PRINTERS = {
 };
 
 /**
+ * Defines the shared type used by this module.
  * @typedef {Printers<KnownStatsError, "error"> &
  * { ["error.filteredDetails"]?: SimplePrinter<number, "error"> } &
  * Exclamation<KnownStatsError, "error.separator", "error">} ErrorPrinters
@@ -822,6 +846,7 @@ const ERROR_PRINTERS = {
 };
 
 /**
+ * Defines the shared type used by this module.
  * @typedef {Printers<KnownStatsLoggingEntry, `loggingEntry(${LogTypeEnum}).loggingEntry`> &
  * { ["loggingEntry(clear).loggingEntry"]?: SimplePrinter<KnownStatsLoggingEntry, "logging"> } &
  * { ["loggingEntry.trace[]"]?: SimplePrinter<Exclude<KnownStatsLoggingEntry["trace"], undefined>[number], "logging"> } &
@@ -1178,6 +1203,7 @@ const SIMPLE_ITEMS_JOINER = {
 };
 
 /**
+ * Returns result.
  * @param {Item[]} items items
  * @returns {string} result
  */
@@ -1188,6 +1214,7 @@ const joinOneLine = (items) =>
 		.join(" ");
 
 /**
+ * Returns result.
  * @param {Item[]} items items
  * @returns {string} result
  */
@@ -1235,6 +1262,7 @@ const joinInBrackets = (items) => {
 };
 
 /**
+ * Returns result.
  * @param {string} str a string
  * @param {string} prefix prefix
  * @param {boolean=} noPrefixInFirstLine need prefix in the first line?
@@ -1248,6 +1276,7 @@ const indent = (str, prefix, noPrefixInFirstLine) => {
 };
 
 /**
+ * Join explicit new line.
  * @param {(false | Item)[]} items items
  * @param {string} indenter indenter
  * @returns {string} result
@@ -1274,12 +1303,14 @@ const joinExplicitNewLine = (items, indenter) => {
 };
 
 /**
+ * Returns joiner.
  * @param {boolean} error is an error
  * @returns {SimpleElementJoiner} joiner
  */
 const joinError =
 	(error) =>
 	/**
+	 * Handles the callback logic for this hook.
 	 * @param {Item[]} items items
 	 * @param {StatsPrinterContextWithExtra} ctx context
 	 * @returns {string} result
@@ -1447,11 +1478,13 @@ const AVAILABLE_COLORS = {
 };
 
 /**
+ * Defines the tail type used by this module.
  * @template T
  * @typedef {T extends [infer Head, ...infer Tail] ? Tail : undefined} Tail
  */
 
 /**
+ * Defines the tail parameters type used by this module.
  * @template {(...args: EXPECTED_ANY[]) => EXPECTED_ANY} T
  * @typedef {T extends (firstArg: EXPECTED_ANY, ...rest: infer R) => EXPECTED_ANY ? R : never} TailParameters
  */
@@ -1477,7 +1510,7 @@ const AVAILABLE_FORMATS = {
 		(oversize ? yellow : green)(filename),
 	formatFlag: (flag) => `[${flag}]`,
 	formatLayer: (layer) => `(in ${layer})`,
-	formatSize: require("../SizeFormatHelpers").formatSize,
+	formatSize: require("../util/formatSize"),
 	formatDateTime: (dateTime, { bold }) => {
 		const d = new Date(dateTime);
 		const x = twoDigit;
@@ -1538,6 +1571,7 @@ const AVAILABLE_FORMATS = {
 			message = message.replace(
 				regExp,
 				/**
+				 * Handles the format callback for this hook.
 				 * @param {string} match match
 				 * @param {string} content content
 				 * @returns {string} result
@@ -1556,6 +1590,7 @@ const RESULT_MODIFIER = {
 };
 
 /**
+ * Creates an order from the provided array.
  * @param {string[]} array array
  * @param {string[]} preferredOrder preferred order
  * @returns {string[]} result
@@ -1585,7 +1620,7 @@ const PLUGIN_NAME = "DefaultStatsPrinterPlugin";
 
 class DefaultStatsPrinterPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -1626,6 +1661,7 @@ class DefaultStatsPrinterPlugin {
 									}\u001B[39m\u001B[22m`;
 							} else {
 								/**
+								 * Returns str string.
 								 * @param {string} str string
 								 * @returns {string} str string
 								 */

package/lib/stats/StatsFactory.js

@@ -18,10 +18,11 @@ const smartGrouping = require("../util/smartGrouping");
 /** @typedef {import("../Module")} Module */
 /** @typedef {import("../ModuleGraph").ModuleProfile} ModuleProfile */
 /** @typedef {import("../ModuleGraphConnection")} ModuleGraphConnection */
-/** @typedef {import("../WebpackError")} WebpackError */
+/** @typedef {import("../errors/WebpackError")} WebpackError */
 /** @typedef {import("../util/comparators").Comparator<EXPECTED_ANY>} Comparator */
 /** @typedef {import("../util/runtime").RuntimeSpec} RuntimeSpec */
 /**
+ * Defines the group config type used by this module.
  * @template T, R
  * @typedef {import("../util/smartGrouping").GroupConfig<T, R>} GroupConfig
  */
@@ -42,6 +43,7 @@ const smartGrouping = require("../util/smartGrouping");
 /** @typedef {import("./DefaultStatsFactoryPlugin").StatsProfile} StatsProfile */
 
 /**
+ * Defines the known stats factory context type used by this module.
  * @typedef {object} KnownStatsFactoryContext
  * @property {string} type
  * @property {Compilation} compilation
@@ -59,12 +61,14 @@ const smartGrouping = require("../util/smartGrouping");
 // StatsLogging StatsLoggingEntry
 
 /**
+ * Defines the stats object type used by this module.
  * @template T
  * @template F
  * @typedef {T extends Compilation ? StatsCompilation : T extends ChunkGroupInfoWithName ? StatsChunkGroup : T extends Chunk ? StatsChunk : T extends OriginRecord ? StatsChunkOrigin : T extends Module ? StatsModule : T extends ModuleGraphConnection ? StatsModuleReason : T extends Asset ? StatsAsset : T extends ModuleTrace ? StatsModuleTraceItem : T extends Dependency ? StatsModuleTraceDependency : T extends Error ? StatsError : T extends ModuleProfile ? StatsProfile : F} StatsObject
  */
 
 /**
+ * Defines the created object type used by this module.
  * @template T
  * @template F
  * @typedef {T extends ChunkGroupInfoWithName[] ? Record<string, StatsObject<ChunkGroupInfoWithName, F>> : T extends (infer V)[] ? StatsObject<V, F>[] : StatsObject<T, F>} CreatedObject
@@ -76,6 +80,7 @@ const smartGrouping = require("../util/smartGrouping");
 /** @typedef {EXPECTED_ANY} Result */
 
 /**
+ * Defines the stats factory hooks type used by this module.
  * @typedef {object} StatsFactoryHooks
  * @property {HookMap<SyncBailHook<[ObjectForExtract, FactoryData, StatsFactoryContext], void>>} extract
  * @property {HookMap<SyncBailHook<[FactoryDataItem, StatsFactoryContext, number, number], boolean | void>>} filter
@@ -91,6 +96,7 @@ const smartGrouping = require("../util/smartGrouping");
  */
 
 /**
+ * Represents the stats factory runtime component.
  * @template T
  * @typedef {Map<string, T[]>} Caches
  */
@@ -133,6 +139,7 @@ class StatsFactory {
 	}
 
 	/**
+	 * Get all level hooks.
 	 * @template {StatsFactoryHooks[keyof StatsFactoryHooks]} HM
 	 * @template {HM extends HookMap<infer H> ? H : never} H
 	 * @param {HM} hookMap hook map
@@ -159,6 +166,7 @@ class StatsFactory {
 	}
 
 	/**
+	 * Returns hook.
 	 * @template {StatsFactoryHooks[keyof StatsFactoryHooks]} HM
 	 * @template {HM extends HookMap<infer H> ? H : never} H
 	 * @template {H extends import("tapable").Hook<EXPECTED_ANY, infer R> ? R : never} R
@@ -177,6 +185,7 @@ class StatsFactory {
 	}
 
 	/**
+	 * For each level waterfall.
 	 * @template {StatsFactoryHooks[keyof StatsFactoryHooks]} HM
 	 * @template {HM extends HookMap<infer H> ? H : never} H
 	 * @param {HM} hookMap hook map
@@ -195,6 +204,7 @@ class StatsFactory {
 	}
 
 	/**
+	 * For each level filter.
 	 * @template {StatsFactoryHooks[keyof StatsFactoryHooks]} T
 	 * @template {T extends HookMap<infer H> ? H : never} H
 	 * @template {H extends import("tapable").Hook<EXPECTED_ANY, infer R> ? R : never} R
@@ -225,6 +235,7 @@ class StatsFactory {
 	}
 
 	/**
+	 * Returns created object.
 	 * @template FactoryData
 	 * @template FallbackCreatedObject
 	 * @param {string} type type
@@ -248,6 +259,7 @@ class StatsFactory {
 	}
 
 	/**
+	 * Returns created object.
 	 * @private
 	 * @template FactoryData
 	 * @template FallbackCreatedObject

package/lib/stats/StatsPrinter.js

@@ -21,12 +21,14 @@ const { HookMap, SyncBailHook, SyncWaterfallHook } = require("tapable");
 /** @typedef {import("./DefaultStatsFactoryPlugin").StatsProfile} StatsProfile */
 
 /**
+ * Defines the printed element type used by this module.
  * @typedef {object} PrintedElement
  * @property {string} element
  * @property {string | undefined} content
  */
 
 /**
+ * Defines the known stats printer context type used by this module.
  * @typedef {object} KnownStatsPrinterContext
  * @property {string=} type
  * @property {StatsCompilation=} compilation
@@ -47,6 +49,7 @@ const { HookMap, SyncBailHook, SyncWaterfallHook } = require("tapable");
 /** @typedef {(value: string | number) => string} ColorFunction */
 
 /**
+ * Defines the known stats printer color functions type used by this module.
  * @typedef {object} KnownStatsPrinterColorFunctions
  * @property {ColorFunction=} bold
  * @property {ColorFunction=} yellow
@@ -57,6 +60,7 @@ const { HookMap, SyncBailHook, SyncWaterfallHook } = require("tapable");
  */
 
 /**
+ * Defines the known stats printer formatters type used by this module.
  * @typedef {object} KnownStatsPrinterFormatters
  * @property {(file: string, oversize?: boolean) => string=} formatFilename
  * @property {(id: string | number) => string=} formatModuleId
@@ -74,6 +78,7 @@ const { HookMap, SyncBailHook, SyncWaterfallHook } = require("tapable");
 /** @typedef {EXPECTED_ANY} PrintObject */
 
 /**
+ * Represents the stats printer runtime component.
  * @typedef {object} StatsPrintHooks
  * @property {HookMap<SyncBailHook<[string[], StatsPrinterContext], void>>} sortElements
  * @property {HookMap<SyncBailHook<[PrintedElement[], StatsPrinterContext], string | undefined | void>>} printElements
@@ -176,6 +181,7 @@ class StatsPrinter {
 	}
 
 	/**
+	 * Returns printed result.
 	 * @param {string} type The type
 	 * @param {PrintObject} object Object to print
 	 * @param {StatsPrinterContext=} baseContext The base context
@@ -195,6 +201,7 @@ class StatsPrinter {
 	}
 
 	/**
+	 * Returns printed result.
 	 * @private
 	 * @param {string} type type
 	 * @param {PrintObject} object object

package/lib/typescript/TypeScriptPlugin.js

@@ -0,0 +1,210 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+	Author Alexander Akait @alexander-akait
+*/
+
+"use strict";
+
+const mod = require("module");
+const {
+	JAVASCRIPT_MODULE_TYPE_AUTO,
+	JAVASCRIPT_MODULE_TYPE_DYNAMIC,
+	JAVASCRIPT_MODULE_TYPE_ESM
+} = require("../ModuleTypeConstants");
+const NormalModule = require("../NormalModule");
+const ModuleBuildError = require("../errors/ModuleBuildError");
+const memoize = require("../util/memoize");
+const removeBOM = require("../util/removeBOM");
+
+/** @typedef {import("webpack-sources").RawSourceMap} RawSourceMap */
+/** @typedef {import("../Compiler")} Compiler */
+/** @typedef {import("../NormalModule")} NormalModuleType */
+/** @typedef {import("../NormalModule").Result} Result */
+/** @typedef {import("../javascript/JavascriptParser")} JavascriptParser */
+
+const getSourceMapSource = memoize(
+	() => require("webpack-sources").SourceMapSource
+);
+
+const PLUGIN_NAME = "TypeScriptPlugin";
+
+/** @type {Set<string>} */
+const JS_MODULE_TYPES = new Set([
+	JAVASCRIPT_MODULE_TYPE_AUTO,
+	JAVASCRIPT_MODULE_TYPE_DYNAMIC,
+	JAVASCRIPT_MODULE_TYPE_ESM
+]);
+
+const TS_RESOURCE_RE = /\.(?:[mc]?tsx?)$/i;
+const TSX_RESOURCE_RE = /\.[mc]?tsx$/i;
+const TS_DATA_URI_RE = /^data:(?:text|application)\/typescript/i;
+
+const TSX_NOT_SUPPORTED =
+	"experiments.typescript does not support .tsx/JSX. " +
+	"Use a TSX-capable loader (e.g. swc-loader, esbuild-loader, ts-loader) for .tsx files.";
+
+const NODE_API_MISSING =
+	"experiments.typescript requires Node.js >= 22.6. " +
+	"`module.stripTypeScriptTypes` is not available on this Node.js version.";
+
+/**
+ * Whether the resource (path or `data:` URI) should go through the TypeScript
+ * transform. Returns true for `.ts`, `.cts`, `.mts`, and the JSX-flavoured
+ * variants (so the `.tsx` branch can throw a friendly error), as well as the
+ * `text/typescript` / `application/typescript` data URIs.
+ * @param {string} resource module resource (without query string)
+ * @returns {boolean} true if the resource should be transformed
+ */
+const isTypeScriptResource = (resource) =>
+	TS_RESOURCE_RE.test(resource) || TS_DATA_URI_RE.test(resource);
+
+/**
+ * Build a line-granularity identity source map for a strip-types output.
+ * `mode: "strip"` replaces type annotations with whitespace, so the stripped
+ * output preserves the original line layout — an identity mapping is correct.
+ * Node's API does not emit a source map in strip mode (`sourceMap: true` is
+ * rejected on Node 22+ and Node 26+), so we construct one by hand.
+ * @param {string} resource module resource path
+ * @param {string} originalSource pre-strip source content
+ * @returns {RawSourceMap} identity source map
+ */
+const createIdentitySourceMap = (resource, originalSource) => {
+	const lineCount = (originalSource.match(/\n/g) || []).length + 1;
+	// Mappings: each line emits a single segment at column 0 mapping to
+	// column 0 of the same line in the source. `AAAA` for line 1, `;AACA`
+	// for each subsequent line (cumulative source-line delta of +1 per line).
+	const mappings = `AAAA${";AACA".repeat(lineCount - 1)}`;
+
+	return {
+		version: 3,
+		file: resource,
+		sources: [resource],
+		sourcesContent: [originalSource],
+		names: [],
+		mappings
+	};
+};
+
+/**
+ * Compose the strip-types source map with an upstream loader source map so the
+ * final map points back to the loader's original input (e.g. a `.vue` /
+ * `.svelte` / custom loader that emits TS code).
+ * @param {string} resource module resource
+ * @param {string} strippedSource post-strip JS
+ * @param {RawSourceMap} stripMap identity map for the strip step
+ * @param {string} preStripSource pre-strip TS (loader output)
+ * @param {string | RawSourceMap} loaderSourceMap upstream loader source map
+ * @returns {RawSourceMap} composed map
+ */
+const composeWithLoaderSourceMap = (
+	resource,
+	strippedSource,
+	stripMap,
+	preStripSource,
+	loaderSourceMap
+) => {
+	const SourceMapSource = getSourceMapSource();
+	const composed = new SourceMapSource(
+		strippedSource,
+		resource,
+		stripMap,
+		preStripSource,
+		loaderSourceMap,
+		true
+	);
+	return /** @type {RawSourceMap} */ (composed.sourceAndMap().map) || stripMap;
+};
+
+/**
+ * Run `module.stripTypeScriptTypes` on the input, wrapping any thrown
+ * `TypeScript ...` errors as `ModuleBuildError` so they surface as
+ * per-module build errors instead of uncaught exceptions.
+ * @param {string} input pre-strip TS source (BOM-free string)
+ * @returns {string} stripped JS
+ */
+const stripTypes = (input) => {
+	try {
+		// Pass only `mode`. `sourceUrl` would emit a `//# sourceURL=…` pragma
+		// into the output (V8 debugger hint), and `sourceMap: true` is
+		// rejected in strip mode — we build the source map by hand instead.
+		// eslint-disable-next-line n/no-unsupported-features/node-builtins
+		return mod.stripTypeScriptTypes(input, { mode: "strip" });
+	} catch (err) {
+		throw new ModuleBuildError(/** @type {Error} */ (err));
+	}
+};
+
+/**
+ * Coerce a Buffer-or-string source to a UTF-8 string, dropping any BOM.
+ * @param {string | Buffer} source raw source from the loader pipeline
+ * @returns {string} UTF-8 string without BOM
+ */
+const toBomFreeString = (source) => {
+	const text = Buffer.isBuffer(source) ? source.toString("utf8") : source;
+	const stripped = removeBOM(text);
+	return typeof stripped === "string" ? stripped : stripped.toString("utf8");
+};
+
+class TypeScriptPlugin {
+	/**
+	 * @param {Compiler} compiler webpack compiler
+	 * @returns {void}
+	 */
+	apply(compiler) {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, (compilation) => {
+			NormalModule.getCompilationHooks(compilation).processResult.tap(
+				PLUGIN_NAME,
+				(result, module) => this._processResult(result, module)
+			);
+		});
+	}
+
+	/**
+	 * processResult tap body. Returns the input untouched unless this is a
+	 * TypeScript module that needs to be transformed.
+	 * @param {Result} result loader result tuple
+	 * @param {NormalModuleType} module the normal module
+	 * @returns {Result} possibly transformed result
+	 */
+	_processResult(result, module) {
+		if (!JS_MODULE_TYPES.has(module.type)) return result;
+
+		const parser = /** @type {JavascriptParser} */ (module.parser);
+		if (!parser.options.typescript) return result;
+
+		const resource = module.nameForCondition();
+		if (!resource || !isTypeScriptResource(resource)) return result;
+
+		if (TSX_RESOURCE_RE.test(resource)) {
+			throw new ModuleBuildError(new Error(TSX_NOT_SUPPORTED));
+		}
+
+		if (!("stripTypeScriptTypes" in mod)) {
+			throw new ModuleBuildError(new Error(NODE_API_MISSING));
+		}
+
+		const [rawSource, loaderSourceMap, ...rest] = result;
+		const preStripSource = toBomFreeString(rawSource);
+		const strippedSource = stripTypes(preStripSource);
+
+		const needSourceMap = module.useSourceMap || module.useSimpleSourceMap;
+		const stripMap = needSourceMap
+			? createIdentitySourceMap(module.resource, preStripSource)
+			: undefined;
+
+		const outputSourceMap =
+			stripMap && loaderSourceMap
+				? composeWithLoaderSourceMap(
+						module.resource,
+						strippedSource,
+						stripMap,
+						preStripSource,
+						loaderSourceMap
+					)
+				: stripMap || loaderSourceMap;
+
+		return [strippedSource, outputSourceMap, ...rest];
+	}
+}
+
+module.exports = TypeScriptPlugin;