@razerspine/webpack-core 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Razerspine
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @razerspine/webpack-core
+
+Core webpack configurations and loaders for starter templates
+
+## Features
+
+- Pug templates support
+- JS / TS scripts
+- SCSS / Less styles
+- Environment-aware loaders
+- No aliases or UI-kit hardcoded
+
+## Usage
+
+```js
+const {
+  createBaseConfig,
+  createDevConfig,
+  createProdConfig
+} = require('@razerspine/webpack-core');
+
+module.exports = (env, argv) => {
+  const mode = argv.mode || 'development';
+
+  return {
+    ...createBaseConfig({
+      root: process.cwd(),
+      env: {
+        mode,
+        script: 'js',
+        style: 'scss'
+      },
+      templates: {
+        entry: 'src/views/pages'
+      }
+    }),
+
+    ...(mode === 'development'
+      ? createDevConfig()
+      : createProdConfig())
+  };
+};

package/dist/config/base.d.ts

@@ -0,0 +1,94 @@
+import { LoaderType } from '../types/loader-type';
+export declare function createBaseConfig(options: {
+    root: string;
+    env: LoaderType;
+    templates?: {
+        entry?: string;
+    };
+}): {
+    mode: import("..").ModeType;
+    context: string;
+    output: {
+        path: string;
+        clean: boolean;
+    };
+    module: {
+        rules: ({
+            oneOf: ({
+                test: RegExp;
+                oneOf: ({
+                    resourceQuery: RegExp;
+                    type: string;
+                    parser?: undefined;
+                    generator?: undefined;
+                } | {
+                    type: string;
+                    parser: {
+                        dataUrlCondition: {
+                            maxSize: number;
+                        };
+                    };
+                    generator: {
+                        filename: string;
+                    };
+                    resourceQuery?: undefined;
+                })[];
+                type?: undefined;
+                include?: undefined;
+                generator?: undefined;
+            } | {
+                test: RegExp;
+                type: string;
+                include: RegExp;
+                generator: {
+                    filename: string;
+                };
+                oneOf?: undefined;
+            } | {
+                test: RegExp;
+                type: string;
+                generator: {
+                    filename: string;
+                };
+                oneOf?: undefined;
+                include?: undefined;
+            })[];
+        } | {
+            test: RegExp;
+            exclude: RegExp;
+            use: {
+                loader: string;
+                options: {
+                    transpileOnly: boolean;
+                };
+            };
+        } | {
+            test: RegExp;
+            exclude: RegExp;
+            use: string;
+        } | {
+            test: RegExp;
+            use: (string | {
+                loader: string;
+                options: {
+                    postcssOptions: {
+                        plugins: string[];
+                    };
+                    lessOptions?: undefined;
+                };
+            } | {
+                loader: string;
+                options: {
+                    lessOptions: {
+                        javascriptEnabled: boolean;
+                    };
+                    postcssOptions?: undefined;
+                };
+            })[];
+        })[];
+    };
+    plugins: any[];
+    resolve: {
+        extensions: string[];
+    };
+};

package/dist/config/base.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBaseConfig = createBaseConfig;
+const path_1 = __importDefault(require("path"));
+const assets_1 = require("../loaders/assets");
+const scripts_1 = require("../loaders/scripts");
+const styles_1 = require("../loaders/styles");
+const templates_1 = require("../loaders/templates");
+function createBaseConfig(options) {
+    var _a;
+    const { root, env } = options;
+    return {
+        mode: env.mode,
+        context: root,
+        output: {
+            path: path_1.default.join(root, 'dist'),
+            clean: true
+        },
+        module: {
+            rules: [
+                (0, assets_1.assetsLoader)(),
+                (0, scripts_1.scriptsLoader)(env),
+                (0, styles_1.stylesLoader)(env)
+            ]
+        },
+        plugins: [
+            ...(0, templates_1.templatesLoader)({
+                entry: (_a = options.templates) === null || _a === void 0 ? void 0 : _a.entry,
+                mode: env.mode
+            })
+        ],
+        resolve: {
+            extensions: ['.ts', '.tsx', '.js', '.json']
+        }
+    };
+}

package/dist/config/dev.d.ts

@@ -0,0 +1,4 @@
+export declare function createDevConfig(): {
+    devtool: string;
+    stats: string;
+};

package/dist/config/dev.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDevConfig = createDevConfig;
+function createDevConfig() {
+    return {
+        devtool: 'source-map',
+        stats: 'minimal'
+    };
+}

package/dist/config/prod.d.ts

@@ -0,0 +1,9 @@
+export declare function createProdConfig(): {
+    devtool: boolean;
+    optimization: {
+        minimize: boolean;
+        splitChunks: {
+            chunks: string;
+        };
+    };
+};

package/dist/config/prod.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProdConfig = createProdConfig;
+function createProdConfig() {
+    return {
+        devtool: false,
+        optimization: {
+            minimize: true,
+            splitChunks: {
+                chunks: 'all'
+            }
+        }
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createBaseConfig } from './config/base';
+export { createDevConfig } from './config/dev';
+export { createProdConfig } from './config/prod';
+export * from './types/loader-type';
+export * from './types/mode-type';
+export * from './types/script-type';
+export * from './types/style-type';

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProdConfig = exports.createDevConfig = exports.createBaseConfig = void 0;
+var base_1 = require("./config/base");
+Object.defineProperty(exports, "createBaseConfig", { enumerable: true, get: function () { return base_1.createBaseConfig; } });
+var dev_1 = require("./config/dev");
+Object.defineProperty(exports, "createDevConfig", { enumerable: true, get: function () { return dev_1.createDevConfig; } });
+var prod_1 = require("./config/prod");
+Object.defineProperty(exports, "createProdConfig", { enumerable: true, get: function () { return prod_1.createProdConfig; } });
+__exportStar(require("./types/loader-type"), exports);
+__exportStar(require("./types/mode-type"), exports);
+__exportStar(require("./types/script-type"), exports);
+__exportStar(require("./types/style-type"), exports);

package/dist/loaders/assets.d.ts

@@ -0,0 +1,41 @@
+export declare function assetsLoader(): {
+    oneOf: ({
+        test: RegExp;
+        oneOf: ({
+            resourceQuery: RegExp;
+            type: string;
+            parser?: undefined;
+            generator?: undefined;
+        } | {
+            type: string;
+            parser: {
+                dataUrlCondition: {
+                    maxSize: number;
+                };
+            };
+            generator: {
+                filename: string;
+            };
+            resourceQuery?: undefined;
+        })[];
+        type?: undefined;
+        include?: undefined;
+        generator?: undefined;
+    } | {
+        test: RegExp;
+        type: string;
+        include: RegExp;
+        generator: {
+            filename: string;
+        };
+        oneOf?: undefined;
+    } | {
+        test: RegExp;
+        type: string;
+        generator: {
+            filename: string;
+        };
+        oneOf?: undefined;
+        include?: undefined;
+    })[];
+};

package/dist/loaders/assets.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assetsLoader = assetsLoader;
+function assetsLoader() {
+    return {
+        oneOf: [
+            {
+                test: /\.(png|jpe?g|svg|webp|ico)$/i,
+                oneOf: [
+                    {
+                        resourceQuery: /inline/,
+                        type: 'asset/inline',
+                    },
+                    {
+                        type: 'asset',
+                        parser: {
+                            dataUrlCondition: { maxSize: 2048 },
+                        },
+                        generator: {
+                            filename: 'img/[name].[hash:8][ext]',
+                        },
+                    },
+                ],
+            },
+            {
+                test: /\.(woff(2)?|ttf|otf|eot|svg)$/,
+                type: 'asset/resource',
+                include: /assets\/fonts|node_modules/,
+                generator: {
+                    filename: 'fonts/[name][ext][query]',
+                },
+            },
+            {
+                test: /\.webmanifest$/i,
+                type: 'asset/resource',
+                generator: {
+                    filename: 'favicons/[name][ext]',
+                },
+            },
+        ],
+    };
+}

package/dist/loaders/scripts.d.ts

@@ -0,0 +1,15 @@
+import { LoaderType } from '../types/loader-type';
+export declare function scriptsLoader(env: LoaderType): {
+    test: RegExp;
+    exclude: RegExp;
+    use: {
+        loader: string;
+        options: {
+            transpileOnly: boolean;
+        };
+    };
+} | {
+    test: RegExp;
+    exclude: RegExp;
+    use: string;
+};

package/dist/loaders/scripts.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scriptsLoader = scriptsLoader;
+function scriptsLoader(env) {
+    if (env.script === 'ts') {
+        return {
+            test: /\.ts$/,
+            exclude: /node_modules/,
+            use: {
+                loader: 'ts-loader',
+                options: {
+                    transpileOnly: env.mode === 'development'
+                }
+            }
+        };
+    }
+    return {
+        test: /\.m?js$/,
+        exclude: /node_modules/,
+        use: 'babel-loader'
+    };
+}

package/dist/loaders/styles.d.ts

@@ -0,0 +1,21 @@
+import { LoaderType } from '../types/loader-type';
+export declare function stylesLoader(env: LoaderType): {
+    test: RegExp;
+    use: (string | {
+        loader: string;
+        options: {
+            postcssOptions: {
+                plugins: string[];
+            };
+            lessOptions?: undefined;
+        };
+    } | {
+        loader: string;
+        options: {
+            lessOptions: {
+                javascriptEnabled: boolean;
+            };
+            postcssOptions?: undefined;
+        };
+    })[];
+};

package/dist/loaders/styles.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stylesLoader = stylesLoader;
+function stylesLoader(env) {
+    const isLess = env.style === 'less';
+    return {
+        test: isLess ? /\.(css|less)$/ : /\.(css|scss|sass)$/,
+        use: [
+            'css-loader',
+            {
+                loader: 'postcss-loader',
+                options: {
+                    postcssOptions: {
+                        plugins: ['autoprefixer']
+                    }
+                }
+            },
+            isLess
+                ? {
+                    loader: 'less-loader',
+                    options: {
+                        lessOptions: { javascriptEnabled: true }
+                    }
+                }
+                : 'sass-loader'
+        ]
+    };
+}

package/dist/loaders/templates.d.ts

@@ -0,0 +1,4 @@
+export declare function templatesLoader(options: {
+    entry?: string;
+    mode: 'development' | 'production';
+}): any[];

package/dist/loaders/templates.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templatesLoader = templatesLoader;
+const pug_plugin_1 = __importDefault(require("pug-plugin"));
+function templatesLoader(options) {
+    var _a;
+    return [
+        new pug_plugin_1.default({
+            entry: (_a = options.entry) !== null && _a !== void 0 ? _a : 'src/views/pages',
+            filename: ({ chunk }) => {
+                let [name] = chunk.name.split('/');
+                if (name === 'home')
+                    name = 'index';
+                return `${name}.html`;
+            },
+            js: {
+                filename: options.mode === 'production'
+                    ? 'js/[name].[contenthash:8].js'
+                    : 'js/[name].js'
+            },
+            css: {
+                filename: options.mode === 'production'
+                    ? 'css/[name].[contenthash:8].css'
+                    : 'css/[name].css'
+            }
+        })
+    ];
+}

package/dist/types/loader-type.d.ts

@@ -0,0 +1,8 @@
+import { ModeType } from './mode-type';
+import { StyleType } from './style-type';
+import { ScriptType } from './script-type';
+export interface LoaderType {
+    mode: ModeType;
+    script: ScriptType;
+    style: StyleType;
+}

package/dist/types/loader-type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/mode-type.d.ts

@@ -0,0 +1 @@
+export type ModeType = 'development' | 'production';

package/dist/types/mode-type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/script-type.d.ts

@@ -0,0 +1 @@
+export type ScriptType = 'js' | 'ts';

package/dist/types/script-type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/style-type.d.ts

@@ -0,0 +1 @@
+export type StyleType = 'scss' | 'less';

package/dist/types/style-type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@razerspine/webpack-core",
+  "version": "1.0.0",
+  "description": "Core webpack config and loaders for starter templates",
+  "license": "ISC",
+  "author": "Razerspine",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "webpack": "^5"
+  },
+  "dependencies": {
+    "pug-plugin": "^5.0.3"
+  },
+
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  }
+}