fix: hmr crash in some situations

src/hmr/hotModuleReplacement.js

@@ -5,9 +5,6 @@
   func-names
 */
 
-// eslint-disable-next-line jsdoc/no-restricted-syntax
-/** @typedef {any} TODO */
-
 const normalizeUrl = require("./normalize-url");
 
 const srcByModuleId = Object.create(null);
@@ -47,9 +44,11 @@ function debounce(fn, time) {
  */
 function noop() {}
 
+/** @typedef {(filename?: string) => string[]} GetScriptSrc */
+
 /**
  * @param {string | number} moduleId a module id
- * @returns {TODO} current script url
+ * @returns {GetScriptSrc} current script url
  */
 function getCurrentScriptUrl(moduleId) {
   let src = srcByModuleId[moduleId];
@@ -69,13 +68,10 @@ function getCurrentScriptUrl(moduleId) {
     srcByModuleId[moduleId] = src;
   }
 
-  /**
-   * @param {string} fileMap file map
-   * @returns {null | string[]} normalized files
-   */
+  /** @type {GetScriptSrc} */
   return function (fileMap) {
     if (!src) {
-      return null;
+      return [];
     }
 
     const splitResult = src.split(/([^\\/]+)\.js$/);
@@ -114,8 +110,10 @@ function isUrlRequest(url) {
   return true;
 }
 
+/** @typedef {HTMLLinkElement & { isLoaded: boolean, visited: boolean }} HotHTMLLinkElement */
+
 /**
- * @param {TODO} el html link element
+ * @param {HotHTMLLinkElement} el html link element
  * @param {string=} url a URL
  */
 function updateCss(el, url) {
@@ -145,7 +143,9 @@ function updateCss(el, url) {
 
   el.visited = true;
 
-  const newEl = el.cloneNode();
+  const newEl =
+    /** @type {HotHTMLLinkElement} */
+    (el.cloneNode());
 
   newEl.isLoaded = false;
 
@@ -155,7 +155,10 @@ function updateCss(el, url) {
     }
 
     newEl.isLoaded = true;
-    el.parentNode.removeChild(el);
+
+    if (el.parentNode) {
+      el.parentNode.removeChild(el);
+    }
   });
 
   newEl.addEventListener("error", () => {
@@ -164,21 +167,26 @@ function updateCss(el, url) {
     }
 
     newEl.isLoaded = true;
-    el.parentNode.removeChild(el);
+
+    if (el.parentNode) {
+      el.parentNode.removeChild(el);
+    }
   });
 
   newEl.href = `${url}?${Date.now()}`;
 
-  if (el.nextSibling) {
-    el.parentNode.insertBefore(newEl, el.nextSibling);
-  } else {
-    el.parentNode.appendChild(newEl);
+  if (el.parentNode) {
+    if (el.nextSibling) {
+      el.parentNode.insertBefore(newEl, el.nextSibling);
+    } else {
+      el.parentNode.appendChild(newEl);
+    }
   }
 }
 
 /**
  * @param {string} href href
- * @param {TODO} src src
+ * @param {string[]} src src
  * @returns {undefined | string} a reload url
  */
 function getReloadUrl(href, src) {
@@ -192,6 +200,7 @@ function getReloadUrl(href, src) {
      */
     // eslint-disable-next-line array-callback-return
     (url) => {
+      // @ts-expect-error fix me in the next major release
       // eslint-disable-next-line unicorn/prefer-includes
       if (href.indexOf(src) > -1) {
         ret = url;
@@ -203,14 +212,10 @@ function getReloadUrl(href, src) {
 }
 
 /**
- * @param {string=} src source
+ * @param {string[]} src source
  * @returns {boolean} true when loaded, otherwise false
  */
 function reloadStyle(src) {
-  if (!src) {
-    return false;
-  }
-
   const elements = document.querySelectorAll("link");
   let loaded = false;
 
@@ -256,8 +261,8 @@ function reloadAll() {
 
 /**
  * @param {number | string} moduleId a module id
- * @param {TODO} options options
- * @returns {TODO} wrapper function
+ * @param {{ filename?: string, locals?: boolean }} options options
+ * @returns {() => void} wrapper function
  */
 module.exports = function (moduleId, options) {
   if (noDocument) {

src/index.js

@@ -21,7 +21,7 @@ const {
 /** @typedef {import("webpack").Compilation} Compilation */
 /** @typedef {import("webpack").ChunkGraph} ChunkGraph */
 /** @typedef {import("webpack").Chunk} Chunk */
-/** @typedef {Parameters<import("webpack").Chunk["isInGroup"]>[0]} ChunkGroup */
+/** @typedef {import("webpack").ChunkGroup} ChunkGroup */
 /** @typedef {import("webpack").Module} Module */
 /** @typedef {import("webpack").Dependency} Dependency */
 /** @typedef {import("webpack").sources.Source} Source */
@@ -30,6 +30,9 @@ const {
 /** @typedef {import("webpack").AssetInfo} AssetInfo */
 /** @typedef {import("./loader.js").Dependency} LoaderDependency */
 
+/** @typedef {NonNullable<Required<Configuration>['output']['filename']>} Filename */
+/** @typedef {NonNullable<Required<Configuration>['output']['chunkFilename']>} ChunkFilename */
+
 /**
  * @typedef {object} LoaderOptions
  * @property {string | ((resourcePath: string, rootContext: string) => string)=} publicPath public path
@@ -41,8 +44,8 @@ const {
 
 /**
  * @typedef {object} PluginOptions
- * @property {Required<Configuration>['output']['filename']=} filename filename
- * @property {Required<Configuration>['output']['chunkFilename']=} chunkFilename chunk filename
+ * @property {Filename=} filename filename
+ * @property {ChunkFilename=} chunkFilename chunk filename
  * @property {boolean=} ignoreOrder true when need to ignore order, otherwise false
  * @property {string | ((linkTag: HTMLLinkElement) => void)=} insert link insert place or a custom insert function
  * @property {Record<string, string>=} attributes link attributes
@@ -53,8 +56,8 @@ const {
 
 /**
  * @typedef {object} NormalizedPluginOptions
- * @property {Required<Configuration>['output']['filename']} filename filename
- * @property {Required<Configuration>['output']['chunkFilename']=} chunkFilename chunk filename
+ * @property {Filename} filename filename
+ * @property {ChunkFilename=} chunkFilename chunk filename
  * @property {boolean} ignoreOrder true when need to ignore order, otherwise false
  * @property {string | ((linkTag: HTMLLinkElement) => void)=} insert a link insert place or a custom insert function
  * @property {Record<string, string>=} attributes link attributes
@@ -70,9 +73,6 @@ const {
  * @property {Record<string, string>=} attributes link attributes
  */
 
-// eslint-disable-next-line jsdoc/no-restricted-syntax
-/** @typedef {any} TODO */
-
 const pluginName = "mini-css-extract-plugin";
 const pluginSymbol = Symbol(pluginName);
 
@@ -89,8 +89,9 @@ const CODE_GENERATION_RESULT = {
   runtimeRequirements: new Set(),
 };
 
-/** @typedef {Module & { content: Buffer, media?: string, sourceMap?: Buffer, supports?: string, layer?: string, assets?: { [key: string]: TODO }, assetsInfo?: Map<string, AssetInfo> }} CssModule */
-/** @typedef {{ context: string | null, identifier: string, identifierIndex: number, content: Buffer, sourceMap?: Buffer, media?: string, supports?: string, layer?: TODO, assetsInfo?: Map<string, AssetInfo>, assets?: { [key: string]: TODO }}} CssModuleDependency */
+// eslint-disable-next-line jsdoc/no-restricted-syntax
+/** @typedef {{ context: string | null, identifier: string, identifierIndex: number, content: Buffer, sourceMap?: Buffer, media?: string, supports?: string, layer?: any, assetsInfo?: Map<string, AssetInfo>, assets?: { [key: string]: Source }}} CssModuleDependency */
+/** @typedef {Module & { content: Buffer, media?: string, sourceMap?: Buffer, supports?: string, layer?: string, assets?: { [key: string]: Source }, assetsInfo?: Map<string, AssetInfo> }} CssModule */
 /** @typedef {{ new(dependency: CssModuleDependency): CssModule }} CssModuleConstructor */
 /** @typedef {Dependency & CssModuleDependency} CssDependency */
 /** @typedef {Omit<LoaderDependency, "context">} CssDependencyOptions */
@@ -437,10 +438,8 @@ class MiniCssExtractPlugin {
         this.sourceMap = sourceMap;
         this.context = context;
         /** @type {{ [key: string]: Source } | undefined}} */
-
         this.assets = undefined;
         /** @type {Map<string, AssetInfo> | undefined} */
-
         this.assetsInfo = undefined;
       }
 
@@ -486,7 +485,6 @@ class MiniCssExtractPlugin {
       }
     }
 
-    // @ts-expect-error
     cssDependencyCache.set(webpack, CssDependency);
 
     webpack.util.serialization.register(
@@ -525,7 +523,6 @@ class MiniCssExtractPlugin {
       },
     );
 
-    // @ts-expect-error
     return CssDependency;
   }
 
@@ -574,7 +571,6 @@ class MiniCssExtractPlugin {
       filename: DEFAULT_FILENAME,
       ignoreOrder: false,
       // TODO remove in the next major release
-
       experimentalUseImportModule: undefined,
       runtime: true,
       ...options,
@@ -639,7 +635,7 @@ class MiniCssExtractPlugin {
     ) {
       /** @type {Compiler["options"]["experiments"] & { executeModule?: boolean }} */
 
-      // @ts-expect-error
+      // @ts-expect-error TODO remove in the next major release
       compiler.options.experiments.executeModule = true;
     }
 
@@ -692,7 +688,7 @@ class MiniCssExtractPlugin {
       class CssModuleFactory {
         /**
          * @param {{ dependencies: Dependency[] }} dependencies
-         * @param {(arg0?: Error, arg1?: TODO) => void} callback
+         * @param {(err?: null | Error, result?: CssModule) => void} callback
          */
 
         create({ dependencies: [dependency] }, callback) {
@@ -705,6 +701,7 @@ class MiniCssExtractPlugin {
 
       compilation.dependencyFactories.set(
         CssDependency,
+        // @ts-expect-error TODO fix in the next major release and fix using `CssModuleFactory extends webpack.ModuleFactory`
         new CssModuleFactory(),
       );
 
@@ -722,7 +719,7 @@ class MiniCssExtractPlugin {
         /**
          * @param {ReturnType<Compilation["getRenderManifest"]>} result result
          * @param {Parameters<Compilation["getRenderManifest"]>[0]} chunk chunk
-         * @returns {TODO} a rendered manifest
+         * @returns {ReturnType<Compilation["getRenderManifest"]>} a rendered manifest
          */
         (result, { chunk }) => {
           const { chunkGraph } = compilation;
@@ -731,7 +728,7 @@ class MiniCssExtractPlugin {
           // We don't need hot update chunks for css
           // We will use the real asset instead to update
           if (chunk instanceof HotUpdateChunk) {
-            return;
+            return result;
           }
 
           const renderedModules =
@@ -774,6 +771,8 @@ class MiniCssExtractPlugin {
               hash: chunk.contentHash[MODULE_TYPE],
             });
           }
+
+          return result;
         },
       );
 
@@ -1232,16 +1231,16 @@ class MiniCssExtractPlugin {
             `${RuntimeGlobals.require}.miniCssF`,
             /**
              * @param {Chunk} referencedChunk a referenced chunk
-             * @returns {TODO} a template value
+             * @returns {ReturnType<import("webpack").runtime.GetChunkFilenameRuntimeModule["getFilenameForChunk"]>} a template value
              */
             (referencedChunk) => {
               if (!referencedChunk.contentHash[MODULE_TYPE]) {
                 return false;
               }
 
               return referencedChunk.canBeInitial()
-                ? this.options.filename
-                : this.options.chunkFilename;
+                ? /** @type {Filename} */ (this.options.filename)
+                : /** @type {ChunkFilename} */ (this.options.chunkFilename);
             },
             set.has(RuntimeGlobals.hmrDownloadUpdateHandlers),
           ),

src/loader.js

@@ -28,13 +28,13 @@ const MiniCssExtractPlugin = require("./index");
 /** @typedef {{[key: string]: string | Function }} Locals */
 
 // eslint-disable-next-line jsdoc/no-restricted-syntax
-/** @typedef {any} TODO */
+/** @typedef {any} EXPECTED_ANY */
 
 /**
  * @typedef {object} Dependency
  * @property {string} identifier identifier
  * @property {string | null} context context
- * @property {Buffer=} content content
+ * @property {Buffer} content content
  * @property {string=} media media
  * @property {string=} supports supports
  * @property {string=} layer layer
@@ -104,9 +104,9 @@ function pitch(request) {
   const options = this.getOptions(/** @type {Schema} */ (schema));
   const emit = typeof options.emit !== "undefined" ? options.emit : true;
   const callback = this.async();
-  const optionsFromPlugin = /** @type {TODO} */ (this)[
-    MiniCssExtractPlugin.pluginSymbol
-  ];
+  const optionsFromPlugin =
+    // @ts-expect-error
+    this[MiniCssExtractPlugin.pluginSymbol];
 
   if (!optionsFromPlugin) {
     callback(
@@ -121,7 +121,7 @@ function pitch(request) {
   const { webpack } = /** @type {Compiler} */ (this._compiler);
 
   /**
-   * @param {TODO} originalExports original exports
+   * @param {EXPECTED_ANY} originalExports original exports
    * @param {Compilation=} compilation compilation
    * @param {{ [name: string]: Source }=} assets assets
    * @param {Map<string, AssetInfo>=} assetsInfo assets info
@@ -201,14 +201,15 @@ function pitch(request) {
               locals = {};
             }
 
-            /** @type {Locals} */ (locals)[key] = originalExports[key];
+            /** @type {Locals} */
+            (locals)[key] = originalExports[key];
           }
         }
       } else {
         locals = exports && exports.locals;
       }
 
-      /** @type {Dependency[] | [null, TODO][]} */
+      /** @type {Dependency[] | [null, Record<string, string>][]} */
       let dependencies;
 
       if (!Array.isArray(exports)) {