@razerspine/webpack-core 1.1.7 → 1.2.1

package/CHANGELOG.md

@@ -8,6 +8,29 @@ required to ensure correct behavior in both development and production modes.
 
 ---
 
+## [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.
+- Integrated `webpack-merge` into `createDevConfig` for safer property merging.
+
+### Fixed
+- Updated internal documentation and clarified version history in `CHANGELOG.md`.
+
+---
+
+## [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.
+- **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.
+
+---
+
 ## [1.1.7] - 2026-02-11
 
 ### Changed
@@ -17,6 +40,7 @@ required to ensure correct behavior in both development and production modes.
 ### 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.
 
+---
 
 ## [1.1.6] - 2026-02-05
 

package/README.md

@@ -13,7 +13,7 @@ Versions prior to 1.1.6 were part of a stabilization phase and are not recommend
 
 Please use:
 ```bash
-npm install @razerspine/webpack-core@^1.1.6
+npm install @razerspine/webpack-core@^1.2.1
 ```
 
 ## Designed for
@@ -28,35 +28,22 @@ templates, but can also be used independently.
 
 ## Design principles
 
-- Webpack is responsible for:
-  - module resolution
-  - aliases (`resolve.alias`)
-  - asset handling
-
-- Loaders and plugins:
-  - do not define aliases
-  - do not depend on UI kits
-  - do not assume project structure
-
-- `pug-plugin` is used only to compile templates  
-  Asset paths are resolved by webpack.
-
-- Webpack JS entry is intentionally disabled  
-  Builds are driven by template entries.
-
-- No aggressive production optimizations by default  
-  (e.g. no `splitChunks`)
+- **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.
+- **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.
 
 ---
 
 ## Features
 
-- Pug templates support
-- JavaScript / TypeScript
-- SCSS / Less
-- Environment-aware configuration
-- No hardcoded aliases
-- Production-safe defaults
+- **Pug templates support** with auto-discovery.
+- **JavaScript / TypeScript** integration.
+- **SCSS / Less** styling support.
+- **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.
 
 ---
 
@@ -70,6 +57,8 @@ npm install @razerspine/webpack-core
 
 ## Usage
 
+### Basic Setup
+
 ```js
 const path = require('path');
 const {
@@ -83,8 +72,8 @@ module.exports = (env = {}, argv = {}) => {
 
   const baseConfig = createBaseConfig({
     mode,
-    scripts: 'js',
-    styles: 'less',
+    scripts: 'js', // or 'ts'
+    styles: 'scss', // or 'less'
     templates: {
       entry: 'src/views/pages',
     },
@@ -92,19 +81,57 @@ module.exports = (env = {}, argv = {}) => {
       alias: {
         '@views': path.resolve(process.cwd(), 'src/views'),
         '@styles': path.resolve(process.cwd(), 'src/assets/styles'),
-        '@scripts': path.resolve(process.cwd(), 'src/assets/scripts'),
-        '@images': path.resolve(process.cwd(), 'src/assets/images'),
       },
     },
   });
 
-  return mode === 'development'
-    ? createDevConfig(baseConfig)
-    : createProdConfig(baseConfig);
+  if (mode === 'development') {
+    return createDevConfig(baseConfig);
+  }
+
+  return createProdConfig(baseConfig);
 };
 ```
 
+### Customizing Configuration (v1.2.1+)
+
+You can now pass an optional second argument to `createDevConfig` and `createProdConfig` to override defaults:
+
+```js
+// Customizing the Dev Server (port, open browser, etc.)
+if (mode === 'development') {
+  return createDevConfig(baseConfig, {
+    port: 3000,
+    open: true,
+    // extra devServer options...
+  });
+}
+
+// Customizing Production (minification, performance hints, etc.)
+if (mode === 'production') {
+  return createProdConfig(baseConfig, {
+    performance: {
+        hints: 'warning',
+    }
+  });
+}
+```
+
 ---
 
+## API Reference
+
+`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.
+- `options`: (Optional) Webpack configuration object for production overrides.
+- **Default behavior**: Enables source maps, minification, and disables `splitChunks` for template compatibility.
+
 ## 📄 License
 This project is licensed under the ISC License.

package/dist/config/dev.d.ts

@@ -3,5 +3,5 @@ import type { Configuration as DevServerConfiguration } from 'webpack-dev-server
 type DevConfig = WebpackConfiguration & {
     devServer?: DevServerConfiguration;
 };
-export declare function createDevConfig(baseConfig: WebpackConfiguration): DevConfig;
+export declare function createDevConfig(baseConfig: WebpackConfiguration, options?: DevServerConfiguration): DevConfig;
 export {};

package/dist/config/dev.js

@@ -1,22 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDevConfig = createDevConfig;
-function createDevConfig(baseConfig) {
-    return {
-        ...baseConfig,
-        /**
-         * Prevent webpack-dev-server from injecting ./src entry
-         */
-        entry: () => ({}),
-        devtool: 'eval-source-map',
-        devServer: {
-            static: {
-                directory: 'public',
-            },
-            hot: true,
-            open: true,
-            compress: true,
-            port: 8080,
-        },
+const webpack_merge_1 = require("webpack-merge");
+function createDevConfig(baseConfig, options = {}) {
+    const defaultDevServer = {
+        hot: false,
+        liveReload: true,
+        compress: true,
+        port: 8080,
+        watchFiles: ['src/**/*'],
+        historyApiFallback: {
+            disableDotRule: true,
+            rewrites: [{ from: /./, to: '/404.html' }]
+        }
     };
+    return (0, webpack_merge_1.merge)(baseConfig, {
+        devtool: 'source-map',
+        devServer: (0, webpack_merge_1.merge)(defaultDevServer, options)
+    });
 }

package/dist/config/prod.d.ts

@@ -1,2 +1,2 @@
 import type { Configuration } from 'webpack';
-export declare function createProdConfig(baseConfig: Configuration): Configuration;
+export declare function createProdConfig(baseConfig: Configuration, options?: Configuration): Configuration;

package/dist/config/prod.js

@@ -2,18 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createProdConfig = createProdConfig;
 const webpack_merge_1 = require("webpack-merge");
-function createProdConfig(baseConfig) {
-    return (0, webpack_merge_1.merge)(baseConfig, {
+function createProdConfig(baseConfig, options = {}) {
+    const defaultConfig = {
         devtool: 'source-map',
         optimization: {
             minimize: true,
-            // ⚠️ splitChunks deliberately disabled
-            // pug-plugin manages assets & entries itself
             splitChunks: false,
             runtimeChunk: false,
         },
         performance: {
             hints: false,
         },
-    });
+    };
+    return (0, webpack_merge_1.merge)(baseConfig, defaultConfig, options);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razerspine/webpack-core",
-  "version": "1.1.7",
+  "version": "1.2.1",
   "description": "Core webpack config and loaders for starter templates",
   "keywords": [
     "webpack",