@razerspine/webpack-core 1.7.1 → 1.8.0

package/CHANGELOG.md

@@ -8,7 +8,61 @@ required to ensure correct behavior in both development and production modes.
 
 ---
 
-## [1.7.0] - 2026-02-20
+## [1.8.0] - 2026-03-13
+
+### Added
+
+- **Automated Deployment Assets Generation**
+  - Integrated `RoutingPlugin` into `createProdConfig` to handle host-specific routing files.
+  - **Vercel Support**: Automatically generates `vercel.json` with correct rewrite rules based on `appType`.
+  - **Netlify/Cloudflare Support**: Automatically generates `_redirects` file.
+  - **Zero-Config Deployment**: Routing files are generated in-memory during the build and emitted directly to the
+    `dist` folder.
+- **Enhanced SPA Fallback**
+  - Added automatic generation of `404.html` (as a copy of `index.html`) for SPA mode.
+  - Ensures seamless routing on platforms like **GitHub Pages** without manual configuration.
+
+### Fixed
+
+- **Type Safety**: Improved Webpack 5 internal typing for asset emission using `sources.RawSource`.
+- **Build Reliability**: Replaced `copy-webpack-plugin` for generated assets with a native Webpack emission strategy to
+  prevent "file not found" errors during build.
+
+### Changed
+
+- **Production Alignment**: `createProdConfig` now actively reads `_meta.appType` from `LoaderOptionsPlugin` to
+  synchronize routing logic with the development server.
+
+---
+
+## [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,14 @@ 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
+- **New (v1.8.0) Automatic Deployment Configs**: Generates `_redirects` and `vercel.json` automatically.
+- **New (v1.8.0) GitHub Pages SPA Support**: Automatic `404.html` fallback for single-page apps.
 
 ---
 
-## Application Modes (v1.7.0+)
+## Application Modes (v1.7.1+)
 
 ### MPA (Default)
 
@@ -63,10 +65,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 +165,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+)
 
 ---
 
@@ -203,7 +205,11 @@ All options are validated before initialization.
 
 - `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.
+- **Default behavior**:
+  - Enables source maps and minification.
+  - Disables `splitChunks` for template compatibility.
+  - **New**: Generates routing assets (`_redirects`, `vercel.json`) based on `appType`.
+  - **New**: Creates `404.html` fallback for SPA mode.
 
 ---
 

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/config/prod.d.ts

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

package/dist/config/prod.js

@@ -1,8 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createProdConfig = createProdConfig;
+const webpack_1 = require("webpack");
 const webpack_merge_1 = require("webpack-merge");
+function getRedirects(appType) {
+    return appType === 'spa'
+        ? '/* /index.html   200\n'
+        : '/* /404.html     404\n';
+}
+function getVercelConfig(appType) {
+    const config = appType === 'spa'
+        ? { routes: [{ src: '/(.*)', dest: '/index.html' }] }
+        : {
+            routes: [
+                { handle: 'filesystem' },
+                { src: '/(.*)', dest: '/404.html', status: 404 }
+            ]
+        };
+    return JSON.stringify(config, null, 2);
+}
 function createProdConfig(baseConfig, options = {}) {
+    var _a, _b, _c, _d, _e;
+    const loaderPlugin = (_a = baseConfig.plugins) === null || _a === void 0 ? void 0 : _a.find((p) => p instanceof webpack_1.LoaderOptionsPlugin);
+    const appType = (_e = (_d = (_c = (_b = loaderPlugin === null || loaderPlugin === void 0 ? void 0 : loaderPlugin.options) === null || _b === void 0 ? void 0 : _b.options) === null || _c === void 0 ? void 0 : _c._meta) === null || _d === void 0 ? void 0 : _d.appType) !== null && _e !== void 0 ? _e : 'mpa';
+    const routingPlugin = {
+        apply(compiler) {
+            compiler.hooks.thisCompilation.tap('RoutingPlugin', (compilation) => {
+                compilation.hooks.processAssets.tap({
+                    name: 'RoutingPlugin',
+                    stage: webpack_1.Compilation.PROCESS_ASSETS_STAGE_ADDITIONS,
+                }, () => {
+                    const { RawSource } = webpack_1.sources;
+                    compilation.emitAsset('_redirects', new RawSource(getRedirects(appType)));
+                    compilation.emitAsset('vercel.json', new RawSource(getVercelConfig(appType)));
+                    if (appType === 'spa') {
+                        const indexAsset = compilation.getAsset('index.html');
+                        if (indexAsset) {
+                            compilation.emitAsset('404.html', indexAsset.source);
+                        }
+                    }
+                });
+            });
+        },
+    };
     const defaultConfig = {
         devtool: 'source-map',
         optimization: {
@@ -13,6 +53,7 @@ function createProdConfig(baseConfig, options = {}) {
         performance: {
             hints: false,
         },
+        plugins: [routingPlugin],
     };
     return (0, webpack_merge_1.merge)(baseConfig, defaultConfig, options);
 }

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.8.0",
   "description": "Core webpack config and loaders for starter templates",
   "keywords": [
     "webpack",