@razerspine/webpack-core 1.7.1 → 1.7.2

package/CHANGELOG.md

@@ -8,7 +8,33 @@ required to ensure correct behavior in both development and production modes.
 
 ---
 
-## [1.7.0] - 2026-02-20
+## [1.7.2] - 2026-02-22
+
+### Added
+
+- **Universal Pug Loading Strategy**
+  - Introduced `pugRule()` with `oneOf` logic to handle different Pug contexts.
+  - **Component Support**: Pug files imported via JS/TS are now compiled into functions (`method: 'compile'`), enabling
+    Angular-like component architecture.
+  - **Static Entry Support**: Pug files used as entry points continue to render as static HTML (`method: 'render'`).
+  - This dual-mode approach ensures SPA components work seamlessly without breaking existing MPA templates.
+- **Dynamic SPA Routing Infrastructure**
+  - Added support for client-side routing by decoupling Pug templates from the global layout in SPA mode.
+  - Enabled support for `document.title` updates and `data-link` interception within the starter templates.
+
+### Changed
+
+- **Refactored** `templatesLoader`
+  - Decoupled loader logic from the `PugPlugin` instance.
+  - Removed global `loaderOptions` from `PugPlugin` to delegate responsibility to the new specialized `pugRule()`.
+  - Improved compatibility between dynamic imports and static page generation.
+- **Clean Architecture Alignment**
+  - Updated `base.ts` to include `pugRule()` in `module.rules`, establishing a standard for how assets are resolved across all 8
+  - template variations (JS/TS, SCSS/Less, MPA/SPA).
+
+---
+
+## [1.7.1] - 2026-02-22
 
 ### Added
 

package/README.md

@@ -29,12 +29,12 @@ Can be used independently in any Pug-based project.
 - Recursive file watching (`src/**/*`)
 - SPA-friendly dev server
 - Config validation layer
-- Centralized options normalization (v1.7.0+)
+- Centralized options normalization (v1.7.1+)
 - Fully customizable dev & prod configs
 
 ---
 
-## Application Modes (v1.7.0+)
+## Application Modes (v1.7.1+)
 
 ### MPA (Default)
 
@@ -63,10 +63,10 @@ appType: 'spa'
 - **Webpack is responsible for**: module resolution, aliases (`resolve.alias`), and asset handling.
 - **Template-driven architecture**: Webpack JS entry is intentionally disabled. Builds are driven by Pug template entries.
 - **MPA by default**: Directory-based page generation remains the primary mode.
-- **Optional SPA support (v1.7.0+)**: Single-entry template mode is supported without breaking MPA workflow.
+- **Optional SPA support (v1.7.1+)**: Single-entry template mode is supported without breaking MPA workflow.
 - **Stability-first production defaults**: No aggressive optimizations (e.g. `splitChunks`) are enabled by default to prevent template asset resolution issues.
 - **Validated configuration layer**: Core options are validated before Webpack initialization.
-- **Centralized option normalization (v1.7.0+)**: Default resolution is handled internally through a normalization layer to avoid configuration drift.
+- **Centralized option normalization (v1.7.1+)**: Default resolution is handled internally through a normalization layer to avoid configuration drift.
 - **Flexible overrides**: Dev and Prod configs can be extended safely via optional parameters.
 
 ---
@@ -163,7 +163,7 @@ if (mode === 'production') {
 - No implicit webpack JS entry
 - No aggressive production optimizations by default
 - Options validated before build initialization
-- Defaults resolved through a normalization layer (v1.7.0+)
+- Defaults resolved through a normalization layer (v1.7.1+)
 
 ---
 

package/dist/config/base.d.ts

@@ -65,6 +65,21 @@ export declare function createBaseConfig(options: ConfigOptionType): {
                     postcssOptions?: undefined;
                 };
             })[];
+        } | {
+            test: RegExp;
+            oneOf: ({
+                issuer: RegExp;
+                loader: any;
+                options: {
+                    method: string;
+                };
+            } | {
+                loader: any;
+                options: {
+                    method: string;
+                };
+                issuer?: undefined;
+            })[];
         })[];
     };
     plugins: any[];

package/dist/config/base.js

@@ -24,6 +24,7 @@ function createBaseConfig(options) {
         },
         module: {
             rules: [
+                (0, templates_1.pugRule)(),
                 (0, assets_1.assetsLoader)(),
                 (0, scripts_1.scriptsLoader)(normalized),
                 (0, styles_1.stylesLoader)(normalized),

package/dist/loaders/templates.d.ts

@@ -1,5 +1,21 @@
 import { ModeType } from '../types/mode-type';
 import { AppType } from '../types/app-type';
+export declare function pugRule(): {
+    test: RegExp;
+    oneOf: ({
+        issuer: RegExp;
+        loader: any;
+        options: {
+            method: string;
+        };
+    } | {
+        loader: any;
+        options: {
+            method: string;
+        };
+        issuer?: undefined;
+    })[];
+};
 export declare function templatesLoader(options: {
     entry: string;
     mode: ModeType;

package/dist/loaders/templates.js

@@ -3,9 +3,30 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.pugRule = pugRule;
 exports.templatesLoader = templatesLoader;
 const pug_plugin_1 = __importDefault(require("pug-plugin"));
 const fs_1 = __importDefault(require("fs"));
+function pugRule() {
+    return {
+        test: /\.pug$/,
+        oneOf: [
+            {
+                issuer: /\.(js|ts|tsx|jsx)$/,
+                loader: pug_plugin_1.default.loader,
+                options: {
+                    method: 'compile',
+                },
+            },
+            {
+                loader: pug_plugin_1.default.loader,
+                options: {
+                    method: 'render',
+                },
+            },
+        ],
+    };
+}
 function templatesLoader(options) {
     const { entry, appType } = options;
     if (!fs_1.default.existsSync(entry)) {
@@ -22,9 +43,6 @@ function templatesLoader(options) {
     return [
         new pug_plugin_1.default({
             entry: pluginEntry,
-            loaderOptions: {
-                method: 'compile'
-            },
             filename: ({ chunk }) => {
                 if (appType === 'spa') {
                     return 'index.html';

package/package.json

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