@razerspine/webpack-core 1.1.6 → 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,141 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+This package went through an intensive stabilization phase while integrating
+Webpack, pug-plugin, and template-driven builds. Multiple patch releases were
+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.
+- **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
+- 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.
+
+---
+
+## [1.1.6] - 2026-02-05
+
+### Changed
+- Updated `package.json` metadata (keywords, published files)
+- Updated `README.md`
+
+---
+
+## [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
+
+---
+
+## [1.1.4] - 2026-02-05
+
+### Fixed
+- Final stabilization of production configuration
+- Ensured consistent build behavior for pug-plugin driven templates
+
+---
+
+## [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
+
+---
+
+## [1.0.9] - 2026-02-05
+
+### Fixed
+- Removed implicit webpack entry from production config
+- Fixed production build failure caused by default webpack entry resolution
+
+---
+
+## [1.0.8] - 2026-02-05
+
+### Fixed
+- Fixed `resolve.alias` handling across loaders and pug-plugin
+
+---
+
+## [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
+
+---
+
+## [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
+
+---
+
+## [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
+
+---
+
+## [1.0.4] - 2026-02-04
+
+### Fixed
+- Fixed TypeScript typing for `webpack-dev-server`
+- Properly extended webpack Configuration with devServer types
+
+---
+
+## [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
+
+---
+
+## [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,30 +1,62 @@
 # @razerspine/webpack-core
 
-Core webpack configuration and loaders for modern **Pug-based** projects.
+Core webpack configuration and loaders for **Pug-based** projects.
 
-This package provides a stable, production-safe webpack foundation designed
-to work seamlessly with `pug-plugin` and template-driven builds.
+This package provides a stable, production-safe webpack foundation for
+template-driven builds using `pug-plugin`.
 
 ---
 
+## ⚠️ Important
+
+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.1.6
+```
+
 ## Designed for
 
 This package is developed as part of the  
 [Webpack Starter Monorepo](https://github.com/Razerspine/webpack-starter-monorepo).
 
 It contains shared webpack configuration and loaders used by the starter
-templates, but **can also be used independently** in custom setups.
+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`)
 
 ---
 
 ## Features
 
-- ✅ Pug templates support (via `pug-plugin`)
-- ✅ JavaScript / TypeScript scripts
-- ✅ SCSS / Less styles
-- ✅ Environment-aware configuration
-- ✅ No hardcoded aliases or UI-kit dependencies
-- ✅ Production-safe defaults (no aggressive chunk splitting)
+- Pug templates support
+- JavaScript / TypeScript
+- SCSS / Less
+- Environment-aware configuration
+- No hardcoded aliases
+- Production-safe defaults
 
 ---
 
@@ -32,3 +64,47 @@ templates, but **can also be used independently** in custom setups.
 
 ```bash
 npm install @razerspine/webpack-core
+```
+
+---
+
+## Usage
+
+```js
+const path = require('path');
+const {
+  createBaseConfig,
+  createDevConfig,
+  createProdConfig,
+} = require('@razerspine/webpack-core');
+
+module.exports = (env = {}, argv = {}) => {
+  const mode = argv.mode || 'development';
+
+  const baseConfig = createBaseConfig({
+    mode,
+    scripts: 'js',
+    styles: 'less',
+    templates: {
+      entry: 'src/views/pages',
+    },
+    resolve: {
+      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);
+};
+```
+
+---
+
+## 📄 License
+This project is licensed under the ISC License.

package/dist/config/dev.js

@@ -4,19 +4,21 @@ exports.createDevConfig = createDevConfig;
 function createDevConfig(baseConfig) {
     return {
         ...baseConfig,
-        /**
-         * Prevent webpack-dev-server from injecting ./src entry
-         */
-        entry: () => ({}),
-        devtool: 'eval-source-map',
+        devtool: 'source-map',
         devServer: {
-            static: {
-                directory: 'public',
-            },
-            hot: true,
-            open: true,
+            hot: false,
+            liveReload: true,
             compress: true,
             port: 8080,
-        },
+            watchFiles: [
+                'src/**/*',
+            ],
+            historyApiFallback: {
+                disableDotRule: true,
+                rewrites: [
+                    { from: /./, to: '/404.html' }
+                ]
+            }
+        }
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razerspine/webpack-core",
-  "version": "1.1.6",
+  "version": "1.2.0",
   "description": "Core webpack config and loaders for starter templates",
   "keywords": [
     "webpack",
@@ -8,7 +8,6 @@
     "pug",
     "pug-plugin"
   ],
-
   "license": "ISC",
   "author": "Razerspine",
   "type": "commonjs",
@@ -16,7 +15,8 @@
   "types": "dist/index.d.ts",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",