@razerspine/webpack-core 1.7.2 → 1.8.0

package/CHANGELOG.md

@@ -8,6 +8,33 @@ required to ensure correct behavior in both development and production modes.
 
 ---
 
+## [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
@@ -29,7 +56,8 @@ required to ensure correct behavior in both development and production modes.
   - 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
+  - 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).
 
 ---

package/README.md

@@ -31,6 +31,8 @@ Can be used independently in any Pug-based project.
 - Config validation layer
 - 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.
 
 ---
 
@@ -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/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/package.json

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