fix: use resolve hook for modules to avoid caching of ESM files

Author: webdiscus

package.json

@@ -1,6 +1,6 @@
 {
   "name": "html-bundler-webpack-plugin",
-  "version": "4.20.0-beta.4",
+  "version": "4.20.0-beta.5",
   "description": "Generates complete single-page or multi-page website from source assets. Build-in support for Markdown, Eta, EJS, Handlebars, Nunjucks, Pug. Alternative to html-webpack-plugin.",
   "keywords": [
     "html",

src/Common/FileSystem/Module/moduleLoader.js

@@ -0,0 +1,10 @@
+const { pathToFileURL } = require('url');
+
+const esmLoader = (absolutePath) => {
+  const fileUrl = pathToFileURL(absolutePath).href;
+
+  // Note: read real data after changes from root file, sub-imported files are still cached.
+  return import(`${fileUrl}?nocache=${Date.now()}`);
+};
+
+module.exports = esmLoader;

src/Common/FileSystem/Module/nocacheLoader.js

@@ -0,0 +1,35 @@
+// This module exports ESM loader hooks used for custom resolution and loading behavior.
+// It is registered dynamically via moduleRegister.js.
+
+/**
+ * Custom resolve hook.
+ *
+ * Appends a unique cache-busting query parameter to module URLs when the parent
+ * module was imported with the `nocache` flag.
+ * This helps force reloads of changed ESM modules, useful for features like Live Reload or HMR.
+ *
+ * @param {string} specifier The raw import value.
+ * @param {{conditions: string[], importAttributes: Object, parentURL: string | undefined}} context Info.
+ * @param {Function} nextResolve The default or next resolve hook in the chain.
+ * @return {Promise<{url: string, format?: string, shortCircuit?: boolean, importAttributes?: Object}>}
+ */
+async function resolve(specifier, context, nextResolve) {
+  const resolved = await nextResolve(specifier, context);
+  const resolvedUrl = new URL(resolved.url);
+  const parentUrl = new URL(context.parentURL);
+  const flag = 'nocache';
+
+  if (!resolvedUrl.searchParams.get(flag) && parentUrl.searchParams.get(flag)) {
+    resolvedUrl.searchParams.set(flag, Date.now().toString());
+
+    return {
+      ...resolved,
+      url: resolvedUrl.href,
+      shortCircuit: false, // if false, continue to next loader in chain
+    };
+  }
+
+  return resolved;
+}
+
+module.exports = { resolve };

src/Common/FileSystem/Module/register.js

@@ -0,0 +1,16 @@
+const path = require('path');
+const { pathToFileURL } = require('url');
+const { register } = require('module');
+
+/**
+ * Registers the module loader.
+ *
+ * @param {string} loader
+ */
+function registerLoader(loader = 'nocacheLoader.js') {
+  const loaderPath = path.resolve(__dirname, loader);
+
+  register(pathToFileURL(loaderPath));
+}
+
+module.exports = registerLoader;