@razerspine/webpack-core 1.2.1 → 1.4.0

package/CHANGELOG.md

@@ -8,14 +8,67 @@ required to ensure correct behavior in both development and production modes.
 
 ---
 
+## [1.4.0] - 2026-02-19
+
+### Changed
+
+- **Peer Dependency**: Updated `pug-plugin` peer dependency range from `^5` to `^5 || ^6`.
+  - Enables compatibility with `pug-plugin@6`.
+  - Removes installation conflicts when templates upgrade to the latest pug-plugin version.
+  - Preserves backward compatibility with existing templates using v5.
+- **Internal Dev Alignment**: Updated local `devDependencies` to use `pug-plugin@^6.0.0` for internal testing and
+  validation.
+
+### Security
+
+- Resolves npm audit warnings caused by transitive dependencies
+  (`js-beautify → editorconfig → glob → minimatch`).
+- No runtime changes were introduced.
+- No production bundle impact.
+
+### Notes
+
+- This release does **not introduce breaking changes**.
+- Public API remains unchanged.
+- Fully backward compatible with existing templates.
+- Recommended update before upgrading templates to `pug-plugin@6`.
+
+---
+
+## [1.2.3] - 2026-02-17
+
+### Added
+
+- **Validation Layer**: Introduced `validateCoreOptions()` inside `createBaseConfig`.
+  - Validates `mode`, `scripts`, and `styles` values.
+  - Ensures the templates entry directory exists before Webpack initialization.
+  - Prevents silent runtime failures in pug-plugin due to invalid configuration.
+
+### Changed
+
+- **Dev Server Default Behavior**: Enabled `open: true` in default `devServer` configuration.
+  - Development server now automatically opens the browser.
+  - Improves developer experience for starter templates.
+
+### Notes
+
+- This release does **not introduce breaking changes**.
+- Public API remains unchanged.
+- Existing templates continue to work without modification.
+
+---
+
 ## [1.2.1] - 2026-02-12
 
 ### Added
+
 - **Flexible Configurations:** Added an optional `options` argument to both `createDevConfig` and `createProdConfig`.
-- Users can now override default `devServer` settings or Webpack production optimizations without losing the base functionality.
+- Users can now override default `devServer` settings or Webpack production optimizations without losing the base
+  functionality.
 - Integrated `webpack-merge` into `createDevConfig` for safer property merging.
 
 ### Fixed
+
 - Updated internal documentation and clarified version history in `CHANGELOG.md`.
 
 ---
@@ -23,28 +76,37 @@ required to ensure correct behavior in both development and production modes.
 ## [1.2.0] - 2026-02-12
 
 ### Changed
-- **Enhanced File Watching:** Updated `createDevConfig` to watch all files recursively in the `src/` directory (`src/**/*`). This ensures `webpack-dev-server` reacts to changes in any file type (images, JSON, new assets) without manual configuration.
+
+- **Enhanced File Watching:** Updated `createDevConfig` to watch all files recursively in the `src/` directory (
+  `src/**/*`). This ensures `webpack-dev-server` reacts to changes in any file type (images, JSON, new assets) without
+  manual configuration.
 - **Improved Dev Routing:** Configured `historyApiFallback` in development mode.
   - Set `disableDotRule: true` to allow dots in URLs (useful for complex routing).
-  - Added a global rewrite rule to serve `/404.html` for any non-existent paths, enabling better local testing of 404 error pages and SPA-like navigation.
-- **DevServer Optimization:** Set `hot: false` and `liveReload: true` as a stable default for multi-page template builds to ensure consistent page refreshes upon file changes.
+  - Added a global rewrite rule to serve `/404.html` for any non-existent paths, enabling better local testing of 404
+    error pages and SPA-like navigation.
+- **DevServer Optimization:** Set `hot: false` and `liveReload: true` as a stable default for multi-page template builds
+  to ensure consistent page refreshes upon file changes.
 
 ---
 
 ## [1.1.7] - 2026-02-11
 
 ### Changed
+
 - Updated `README.md`
 - Updated `package.json` metadata (keywords, published files)
 
 ### Stable Release Note
-- **Important:** Versions prior to 1.1.6 were part of a stabilization phase and are not recommended for production use. This release marks the stable baseline.
+
+- **Important:** Versions prior to 1.1.6 were part of a stabilization phase and are not recommended for production use.
+  This release marks the stable baseline.
 
 ---
 
 ## [1.1.6] - 2026-02-05
 
 ### Changed
+
 - Updated `package.json` metadata (keywords, published files)
 - Updated `README.md`
 
@@ -53,12 +115,14 @@ required to ensure correct behavior in both development and production modes.
 ## [1.1.5] - 2026-02-05
 
 ### Fixed
+
 - Stabilized production webpack configuration for pug-plugin driven builds
 - Disabled `splitChunks` and `runtimeChunk` to prevent asset resolution issues
 - Ensured predictable output structure in production mode
 - Reduced risk of entry-related build failures
 
 ### Notes
+
 - This release finalizes the stabilization phase of the production configuration
 - Recommended as a stable baseline for template usage
 
@@ -67,6 +131,7 @@ required to ensure correct behavior in both development and production modes.
 ## [1.1.4] - 2026-02-05
 
 ### Fixed
+
 - Final stabilization of production configuration
 - Ensured consistent build behavior for pug-plugin driven templates
 
@@ -75,6 +140,7 @@ required to ensure correct behavior in both development and production modes.
 ## [1.1.0 – 1.1.3] - 2026-02-05
 
 ### Fixed
+
 - Multiple fixes for production configuration edge cases
 - Improved compatibility between pug-plugin, assets loader, and webpack optimization
 - Stabilized production builds for template-driven entry points
@@ -84,6 +150,7 @@ required to ensure correct behavior in both development and production modes.
 ## [1.0.9] - 2026-02-05
 
 ### Fixed
+
 - Removed implicit webpack entry from production config
 - Fixed production build failure caused by default webpack entry resolution
 
@@ -92,6 +159,7 @@ required to ensure correct behavior in both development and production modes.
 ## [1.0.8] - 2026-02-05
 
 ### Fixed
+
 - Fixed `resolve.alias` handling across loaders and pug-plugin
 
 ---
@@ -99,6 +167,7 @@ required to ensure correct behavior in both development and production modes.
 ## [1.0.7] - 2026-02-05
 
 ### Fixed
+
 - Fixed Pug asset resolution in production mode
 - Passed webpack `resolve.alias` into pug-plugin resolver
 - Ensured consistent alias behavior in development and production
@@ -108,6 +177,7 @@ required to ensure correct behavior in both development and production modes.
 ## [1.0.6] - 2026-02-05
 
 ### Fixed
+
 - Fixed webpack plugin instance mismatch when used via `npm link`
 - Moved `webpack-dev-server` and `pug-plugin` to `peerDependencies`
 - Ensured a single webpack instance is used in consumer templates
@@ -117,6 +187,7 @@ required to ensure correct behavior in both development and production modes.
 ## [1.0.5] - 2026-02-04
 
 ### Fixed
+
 - Explicitly disabled webpack default entry (`./src`)
 - Ensured stable behavior when using pug-plugin as the primary entry system
 
@@ -125,6 +196,7 @@ required to ensure correct behavior in both development and production modes.
 ## [1.0.4] - 2026-02-04
 
 ### Fixed
+
 - Fixed TypeScript typing for `webpack-dev-server`
 - Properly extended webpack Configuration with devServer types
 
@@ -133,11 +205,13 @@ required to ensure correct behavior in both development and production modes.
 ## [1.0.3] - 2026-02-04
 
 ### Fixed
+
 - Fixed webpack default entry fallback (`./src`)
 - Prevented webpack from resolving non-existing JS entry when using pug-plugin
 - Stabilized template entry handling via `templatesLoader`
 
 ### Internal
+
 - Clarified responsibility between webpack entry and pug-plugin entry
 
 ---
@@ -145,9 +219,12 @@ required to ensure correct behavior in both development and production modes.
 ## [1.0.2] - 2026-02-04
 
 ### Fixed
+
 - Fixed ENV mode option typing
 - Stabilized base configuration behavior
 
 ## [Unreleased]
+
 ### Changed
+
 - Updated README.md

package/README.md

@@ -1,4 +1,8 @@
 # @razerspine/webpack-core
+[![npm version](https://img.shields.io/npm/v/@razerspine/webpack-core.svg)](https://www.npmjs.com/package/@razerspine/webpack-core)
+[![changelog](https://img.shields.io/badge/docs-changelog-blue.svg)](./CHANGELOG.md)
+[![license](https://img.shields.io/npm/l/@razerspine/webpack-core.svg)](./LICENSE)
+
 
 Core webpack configuration and loaders for **Pug-based** projects.
 
@@ -12,6 +16,7 @@ template-driven builds using `pug-plugin`.
 Versions prior to 1.1.6 were part of a stabilization phase and are not recommended for production use.
 
 Please use:
+
 ```bash
 npm install @razerspine/webpack-core@^1.2.1
 ```
@@ -29,10 +34,15 @@ templates, but can also be used independently.
 ## Design principles
 
 - **Webpack is responsible for**: module resolution, aliases (`resolve.alias`), and asset handling.
-- **Flexibility:** Since v1.2.1, you can override any part of the dev or prod configuration using an optional `options` argument.
+- **Flexibility:** Since v1.2.1, you can override any part of the dev or prod configuration using an optional `options`
+  argument.
 - **Stability:** `pug-plugin` is used to compile templates, and asset paths are resolved by webpack.
-- **Template-driven**: Webpack JS entry is intentionally disabled. Builds are driven by template entries in `src/views/pages`.
-  - **Sensible Defaults**: No aggressive production optimizations (like `splitChunks`) are enabled by default to prevent asset resolution issues in templates.
+- **Template-driven**: Webpack JS entry is intentionally disabled. Builds are driven by template entries in
+  `src/views/pages`.
+- **Sensible Defaults**: No aggressive production optimizations (like `splitChunks`) are enabled by default to prevent
+  asset resolution issues in templates.
+- **Validated configuration layer (v1.2.2+)**: Core options are validated before build initialization to prevent silent
+  runtime failures.
 
 ---
 
@@ -41,9 +51,22 @@ templates, but can also be used independently.
 - **Pug templates support** with auto-discovery.
 - **JavaScript / TypeScript** integration.
 - **SCSS / Less** styling support.
-- **Recursive File Watching**: Dev server watches all changes in src/**/*.
+- **Recursive File Watching**: Dev server watches all changes in `src/**/*`.
 - **SPA-friendly Dev Server**: Integrated historyApiFallback (redirects to 404.html).
 - **Customizable**: Easily override devServer or optimization settings.
+- **Configuration validation layer**
+- **Automatic browser open in development (v1.2.2+)**
+
+---
+
+## What’s New in v1.2.2
+
+- Added `validateCoreOptions()` inside `createBaseConfig`
+  - Validates `mode`, `scripts`, and `styles`
+  - Ensures templates entry directory exists before Webpack starts
+- Dev server now opens the browser automatically (`open: true` by default)
+
+> No breaking changes were introduced.
 
 ---
 
@@ -111,7 +134,7 @@ if (mode === 'development') {
 if (mode === 'production') {
   return createProdConfig(baseConfig, {
     performance: {
-        hints: 'warning',
+      hints: 'warning',
     }
   });
 }
@@ -121,12 +144,30 @@ if (mode === 'production') {
 
 ## API Reference
 
+`createBaseConfig(options)`
+
+Core configuration factory.
+
+**Options include**:
+
+- `mode` — `'development' | 'production'`
+- `scripts` — `'js' | 'ts'`
+- `styles` — `'scss' | 'less'`
+- `templates.entry` — Path to template pages directory
+- `resolve.alias` — Webpack aliases
+
+All options are validated before initialization.
+
+---
+
 `createDevConfig(baseConfig, options?)`
 
 - `baseConfig`: The configuration returned by createBaseConfig.
 - `options`: (Optional) webpack-dev-server configuration object.
 - **Default behavior**: Watches `src/**/*`, uses port `8080`, and rewrites 404s to `/404.html`.
 
+---
+
 `createProdConfig(baseConfig, options?)`
 
 - `baseConfig`: The configuration returned by createBaseConfig.
@@ -134,4 +175,5 @@ if (mode === 'production') {
 - **Default behavior**: Enables source maps, minification, and disables `splitChunks` for template compatibility.
 
 ## 📄 License
+
 This project is licensed under the ISC License.

package/dist/config/base.js

@@ -9,8 +9,10 @@ const scripts_1 = require("../loaders/scripts");
 const styles_1 = require("../loaders/styles");
 const templates_1 = require("../loaders/templates");
 const path_1 = __importDefault(require("path"));
+const validate_core_options_1 = require("../validation/validate-core-options");
 function createBaseConfig(options) {
     var _a, _b, _c, _d;
+    (0, validate_core_options_1.validateCoreOptions)(options);
     const mode = (_a = options.mode) !== null && _a !== void 0 ? _a : 'development';
     return {
         mode,

package/dist/config/dev.js

@@ -5,6 +5,7 @@ const webpack_merge_1 = require("webpack-merge");
 function createDevConfig(baseConfig, options = {}) {
     const defaultDevServer = {
         hot: false,
+        open: true,
         liveReload: true,
         compress: true,
         port: 8080,

package/dist/validation/validate-core-options.d.ts

@@ -0,0 +1,2 @@
+import { ConfigOptionType } from '../types/config-option-type';
+export declare function validateCoreOptions(options: ConfigOptionType): void;

package/dist/validation/validate-core-options.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCoreOptions = validateCoreOptions;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function validateCoreOptions(options) {
+    var _a, _b;
+    if (!options) {
+        throw new Error('[webpack-core] Options are required.');
+    }
+    const { mode, scripts, styles } = options;
+    // --- mode
+    if (!['development', 'production'].includes(mode)) {
+        throw new Error(`[webpack-core] Invalid mode "${mode}". Expected "development" or "production".`);
+    }
+    // --- scripts
+    if (!['js', 'ts'].includes(scripts)) {
+        throw new Error(`[webpack-core] Invalid scripts option "${scripts}". Expected "js" or "ts".`);
+    }
+    // --- styles
+    if (!['scss', 'less'].includes(styles)) {
+        throw new Error(`[webpack-core] Invalid styles option "${styles}". Expected "scss" or "less".`);
+    }
+    // --- templates entry
+    const entryRelative = (_b = (_a = options.templates) === null || _a === void 0 ? void 0 : _a.entry) !== null && _b !== void 0 ? _b : 'src/views/pages';
+    const entryAbsolute = path_1.default.resolve(process.cwd(), entryRelative);
+    if (!fs_1.default.existsSync(entryAbsolute)) {
+        throw new Error(`[webpack-core] Templates entry directory does not exist: ${entryAbsolute}`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razerspine/webpack-core",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "Core webpack config and loaders for starter templates",
   "keywords": [
     "webpack",
@@ -25,7 +25,7 @@
   "peerDependencies": {
     "webpack": "^5",
     "webpack-dev-server": "^5",
-    "pug-plugin": "^5"
+    "pug-plugin": "^5 || ^6"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
@@ -33,6 +33,6 @@
     "webpack": "^5.105.0",
     "webpack-dev-server": "^5.2.3",
     "webpack-merge": "^5.10.0",
-    "pug-plugin": "^5.0.3"
+    "pug-plugin": "^6.0.0"
   }
 }