@razerspine/webpack-core 1.1.6 → 1.1.7

package/CHANGELOG.md

@@ -0,0 +1,129 @@
+# 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.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razerspine/webpack-core",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "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",