fix: disallow undefined value for optional properties by route option

Author: webdiscus

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 4.20.1 (2025-04-17)
+
+- fix: disallow `undefined` value for optional properties by `route` option
+
 ## 4.20.0
 
 - feat: add support for ESM data files

package.json

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

types.d.ts

@@ -391,17 +391,17 @@ type Sources =
 type Router =
   | boolean
   | {
-      enabled?: boolean;
+      enabled: boolean;
       // replaces matched source route with its output URL, defaults is <PluginOption>.test depends on used preprocessor
-      test?: RegExp | Array<RegExp>;
+      test: RegExp | Array<RegExp>;
       // Note: if a route contains a query or a segment (e.g. index.html#contact), the rewriteIndex is ignored!
       // if rewriteIndex is `false` (defaults), do nothing
       // if rewriteIndex is a string:
       //   - if publicPath is `auto` replaces "index.html" with the specified string, should be on of: ".", ""
       //   - if publicPath is not empty, replaces "index.html" with "" (empty string) regardless of specified value
-      rewriteIndex?: false | string;
+      rewriteIndex: false | string;
       // called after the resolving of output filenames
-      resolve?: (props: {
+      resolve: (props: {
         sourceRoute: string; // resolved href value (absolute path)
         outputRoute: string; // output URL regards publicPath, e.g. by auto publicPath is relative to outputFile
         sourceFile: string; // absolute path to the template file
@@ -410,6 +410,13 @@ type Router =
         // - void - do nothing
         // - any string - the returned string replaces the value
       }) => void | string;
+    }
+  // disallow `undefined` value for optional properties
+  | {
+      enabled?: never;
+      test?: never;
+      rewriteIndex?: never;
+      resolve?: never;
     };
 
 type WatchFiles = {