@razerspine/webpack-core 1.1.5 → 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,60 +1,110 @@
 # @razerspine/webpack-core
 
+Core webpack configuration and loaders for **Pug-based** projects.
 
-Core webpack configuration and loaders for modern Pug-based projects.
+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
+This package is developed as part of the  
 [Webpack Starter Monorepo](https://github.com/Razerspine/webpack-starter-monorepo).
 
-It provides shared webpack configuration and loaders used by the
-starter templates, but can also be used independently in custom setups.
+It contains shared webpack configuration and loaders used by the starter
+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
-- JS / TS scripts
-- SCSS / Less styles
-- Environment-aware loaders
-- No aliases or UI-kit hardcoded
+- JavaScript / TypeScript
+- SCSS / Less
+- Environment-aware configuration
+- No hardcoded aliases
+- Production-safe defaults
+
+---
 
 ## Installation
+
 ```bash
-npm i @razerspine/webpack-core
+npm install @razerspine/webpack-core
 ```
 
+---
+
 ## Usage
 
 ```js
+const path = require('path');
 const {
   createBaseConfig,
   createDevConfig,
-  createProdConfig
+  createProdConfig,
 } = require('@razerspine/webpack-core');
 
-module.exports = (env, argv) => {
+module.exports = (env = {}, argv = {}) => {
   const mode = argv.mode || 'development';
 
-  return {
-    ...createBaseConfig({
-      root: process.cwd(),
-      env: {
-        mode,
-        script: 'js',
-        style: 'scss'
+  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'),
       },
-      templates: {
-        entry: 'src/views/pages'
-      }
-    }),
-
-    ...(mode === 'development'
-      ? createDevConfig()
-      : createProdConfig())
-  };
+    },
+  });
+
+  return mode === 'development'
+    ? createDevConfig(baseConfig)
+    : createProdConfig(baseConfig);
 };
 ```
 
+---
+
 ## 📄 License
 This project is licensed under the ISC License.

package/package.json

@@ -1,14 +1,22 @@
 {
   "name": "@razerspine/webpack-core",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "Core webpack config and loaders for starter templates",
+  "keywords": [
+    "webpack",
+    "webpack-config",
+    "pug",
+    "pug-plugin"
+  ],
   "license": "ISC",
   "author": "Razerspine",
   "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",