@razerspine/build 1.0.0

package/dist/plugins/pug-templates-plugin.js

@@ -0,0 +1,90 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PugTemplatesPlugin = void 0;
+const pug_plugin_1 = __importDefault(require("pug-plugin"));
+const fs = __importStar(require("node:fs"));
+const path_1 = __importDefault(require("path"));
+class PugTemplatesPlugin {
+    constructor(options) {
+        this.entry = path_1.default.resolve(options.entry);
+        this.mode = options.mode;
+        this.appType = options.appType;
+        this.validate();
+    }
+    validate() {
+        if (!fs.existsSync(this.entry)) {
+            throw new Error(`[build] Templates entry not found: ${this.entry}`);
+        }
+        const stats = fs.statSync(this.entry);
+        if (this.appType === 'spa' && !stats.isFile()) {
+            throw new Error(`[build] SPA requires a single pug file as templates.entry`);
+        }
+        if (this.appType === 'mpa' && !stats.isDirectory()) {
+            throw new Error(`[build] MPA requires templates.entry to be a directory`);
+        }
+    }
+    apply(compiler) {
+        const pluginEntry = this.appType === 'spa' ? { index: this.entry } : this.entry;
+        const pugPlugin = new pug_plugin_1.default({
+            entry: pluginEntry,
+            filename: ({ chunk }) => {
+                if (this.appType === 'spa') {
+                    return 'index.html';
+                }
+                let [name] = chunk.name.split('/');
+                if (name === 'home') {
+                    name = 'index';
+                }
+                return `${name}.html`;
+            },
+            js: {
+                filename: this.mode === 'production'
+                    ? 'js/[name].[contenthash:8].js'
+                    : 'js/[name].js',
+            },
+            css: {
+                filename: this.mode === 'production'
+                    ? 'css/[name].[contenthash:8].css'
+                    : 'css/[name].css',
+            },
+        });
+        pugPlugin.apply(compiler);
+    }
+}
+exports.PugTemplatesPlugin = PugTemplatesPlugin;

package/dist/presets/react/index.d.ts

@@ -0,0 +1 @@
+export { reactPreset } from './react-preset';

package/dist/presets/react/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reactPreset = void 0;
+var react_preset_1 = require("./react-preset");
+Object.defineProperty(exports, "reactPreset", { enumerable: true, get: function () { return react_preset_1.reactPreset; } });

package/dist/presets/react/react-preset.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @module react-preset
+ * @description Production-ready React preset for @razerspine/build.
+ *
+ * Provides a modern React development experience using:
+ * - Babel (no ts-loader)
+ * - Automatic JSX runtime (react/jsx-runtime)
+ * - TypeScript support (.ts / .tsx)
+ * - React Fast Refresh (development only)
+ *
+ * ---
+ * Behavior:
+ *
+ * - Automatically sets `templates.type = 'none'` if not defined
+ * - Warns if incompatible template engines are used (pug/html)
+ * - Injects Babel-based React pipeline
+ * - Adds React Refresh plugin in development mode (if installed)
+ *
+ * ---
+ * Requirements (must be installed in user project):
+ *
+ * ```bash
+ * npm install -D \
+ *   babel-loader \
+ *   @babel/core \
+ *   @babel/preset-env \
+ *   @babel/preset-react \
+ *   @babel/preset-typescript \
+ *   @pmmmwh/react-refresh-webpack-plugin \
+ *   react-refresh
+ * ```
+ *
+ * ---
+ * Example:
+ *
+ * ```ts
+ * import {defineConfig, reactPreset} from '@razerspine/build';
+ *
+ * export default defineConfig({
+ *   mode: 'development',
+ *   scripts: 'ts',
+ *   styles: 'scss',
+ *   presets: [reactPreset()]
+ * });
+ * ```
+ */
+import { BuildPluginType } from '../../types';
+/**
+ * Options for React preset
+ */
+type ReactPresetOptions = {
+    /**
+     * Enables TypeScript support (.ts / .tsx)
+     *
+     * @default true
+     */
+    typescript?: boolean;
+};
+/**
+ * React preset factory
+ *
+ * @param options - React preset configuration
+ * @returns Build plugin instance
+ */
+export declare function reactPreset(options?: ReactPresetOptions): BuildPluginType;
+export {};

package/dist/presets/react/react-preset.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * @module react-preset
+ * @description Production-ready React preset for @razerspine/build.
+ *
+ * Provides a modern React development experience using:
+ * - Babel (no ts-loader)
+ * - Automatic JSX runtime (react/jsx-runtime)
+ * - TypeScript support (.ts / .tsx)
+ * - React Fast Refresh (development only)
+ *
+ * ---
+ * Behavior:
+ *
+ * - Automatically sets `templates.type = 'none'` if not defined
+ * - Warns if incompatible template engines are used (pug/html)
+ * - Injects Babel-based React pipeline
+ * - Adds React Refresh plugin in development mode (if installed)
+ *
+ * ---
+ * Requirements (must be installed in user project):
+ *
+ * ```bash
+ * npm install -D \
+ *   babel-loader \
+ *   @babel/core \
+ *   @babel/preset-env \
+ *   @babel/preset-react \
+ *   @babel/preset-typescript \
+ *   @pmmmwh/react-refresh-webpack-plugin \
+ *   react-refresh
+ * ```
+ *
+ * ---
+ * Example:
+ *
+ * ```ts
+ * import {defineConfig, reactPreset} from '@razerspine/build';
+ *
+ * export default defineConfig({
+ *   mode: 'development',
+ *   scripts: 'ts',
+ *   styles: 'scss',
+ *   presets: [reactPreset()]
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reactPreset = reactPreset;
+/**
+ * React preset factory
+ *
+ * @param options - React preset configuration
+ * @returns Build plugin instance
+ */
+function reactPreset(options = {}) {
+    var _a;
+    const useTS = (_a = options.typescript) !== null && _a !== void 0 ? _a : true;
+    return {
+        name: 'react-preset',
+        /**
+         * Setup phase
+         *
+         * - Ensures templates are disabled by default (React does not use Pug/HTML templates)
+         * - Emits warning if user explicitly enables incompatible template engines
+         */
+        setup({ options }) {
+            var _a;
+            const type = (_a = options.templates) === null || _a === void 0 ? void 0 : _a.type;
+            // Default to "none" if not explicitly defined
+            if (!type) {
+                options.templates = { type: 'none' };
+            }
+            // Warn about potential conflicts
+            if (type === 'pug' || type === 'html') {
+                console.warn(`[react-preset] templates.type='${type}' may conflict with React setup.`);
+            }
+        },
+        /**
+         * Base configuration extension
+         *
+         * Injects:
+         * - entry (if not provided)
+         * - resolve.extensions
+         * - Babel loader rule for React
+         * - React Refresh plugin (development only)
+         */
+        applyBase(config) {
+            var _a, _b;
+            const isDev = config.mode === 'development';
+            /**
+             * Entry
+             */
+            if (!config.entry) {
+                config.entry = useTS ? './src/main.tsx' : './src/main.jsx';
+            }
+            /**
+             * Resolve extensions
+             */
+            config.resolve = {
+                ...config.resolve,
+                extensions: Array.from(new Set([
+                    ...(((_a = config.resolve) === null || _a === void 0 ? void 0 : _a.extensions) || []),
+                    '.jsx',
+                    '.js',
+                    ...(useTS ? ['.tsx', '.ts'] : []),
+                ])),
+            };
+            /**
+             * Babel loader configuration
+             */
+            const babelLoader = {
+                loader: 'babel-loader',
+                options: {
+                    cacheDirectory: true,
+                    presets: [
+                        [
+                            '@babel/preset-env',
+                            {
+                                targets: 'defaults',
+                            },
+                        ],
+                        [
+                            '@babel/preset-react',
+                            {
+                                runtime: 'automatic',
+                                development: isDev,
+                            },
+                        ],
+                        ...(useTS ? ['@babel/preset-typescript'] : []),
+                    ],
+                    plugins: isDev ? ['react-refresh/babel'] : [],
+                },
+            };
+            const reactRule = {
+                test: useTS ? /\.(ts|tsx)$/ : /\.(js|jsx)$/,
+                exclude: /node_modules/,
+                use: [babelLoader],
+            };
+            /**
+             * Prevent rule duplication
+             */
+            const existingRules = ((_b = config.module) === null || _b === void 0 ? void 0 : _b.rules) || [];
+            const hasReactRule = existingRules.some(rule => {
+                var _a;
+                return (rule &&
+                    typeof rule === 'object' &&
+                    'test' in rule &&
+                    ((_a = rule.test) === null || _a === void 0 ? void 0 : _a.toString().includes(useTS ? 'tsx' : 'jsx')));
+            });
+            if (!hasReactRule) {
+                config.module = {
+                    ...config.module,
+                    rules: [...existingRules, reactRule],
+                };
+            }
+            /**
+             * React Fast Refresh (development only)
+             */
+            if (isDev) {
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-var-requires
+                    const ReactRefreshPlugin = require('@pmmmwh/react-refresh-webpack-plugin');
+                    const plugins = config.plugins || [];
+                    const hasPlugin = plugins.some(p => {
+                        var _a;
+                        return p &&
+                            typeof p === 'object' &&
+                            ((_a = p.constructor) === null || _a === void 0 ? void 0 : _a.name) === 'ReactRefreshPlugin';
+                    });
+                    if (!hasPlugin) {
+                        plugins.push(new ReactRefreshPlugin());
+                        config.plugins = plugins;
+                    }
+                }
+                catch {
+                    /**
+                     * Do not throw — keep build stable
+                     */
+                    console.warn('\n[react-preset] Warning: "@pmmmwh/react-refresh-webpack-plugin" not found.\n' +
+                        'Fast Refresh is disabled. Install it to enable better DX.\n');
+                }
+            }
+        },
+        /**
+         * Development-specific configuration
+         */
+        applyDev(config) {
+            config.devtool = 'eval-source-map';
+        },
+        /**
+         * Production-specific configuration
+         */
+        applyProd(config) {
+            config.devtool = 'source-map';
+        },
+    };
+}

package/dist/rules/assets-rule.d.ts

@@ -0,0 +1,27 @@
+export declare function assetsRule(): {
+    oneOf: ({
+        test: RegExp;
+        type: string;
+        include: RegExp;
+        generator: {
+            filename: string;
+        };
+        exclude?: undefined;
+    } | {
+        test: RegExp;
+        exclude: RegExp;
+        type: string;
+        generator: {
+            filename: string;
+        };
+        include?: undefined;
+    } | {
+        test: RegExp;
+        type: string;
+        generator: {
+            filename: string;
+        };
+        include?: undefined;
+        exclude?: undefined;
+    })[];
+};

package/dist/rules/assets-rule.js

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

package/dist/rules/index.d.ts

@@ -0,0 +1,4 @@
+export { assetsRule } from './assets-rule';
+export { pugRule } from './pug-rule';
+export { scriptsRule } from './scripts-rule';
+export { stylesRule } from './styles-rule';

package/dist/rules/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stylesRule = exports.scriptsRule = exports.pugRule = exports.assetsRule = void 0;
+var assets_rule_1 = require("./assets-rule");
+Object.defineProperty(exports, "assetsRule", { enumerable: true, get: function () { return assets_rule_1.assetsRule; } });
+var pug_rule_1 = require("./pug-rule");
+Object.defineProperty(exports, "pugRule", { enumerable: true, get: function () { return pug_rule_1.pugRule; } });
+var scripts_rule_1 = require("./scripts-rule");
+Object.defineProperty(exports, "scriptsRule", { enumerable: true, get: function () { return scripts_rule_1.scriptsRule; } });
+var styles_rule_1 = require("./styles-rule");
+Object.defineProperty(exports, "stylesRule", { enumerable: true, get: function () { return styles_rule_1.stylesRule; } });

package/dist/rules/pug-rule.d.ts

@@ -0,0 +1,16 @@
+export declare function pugRule(): {
+    test: RegExp;
+    oneOf: ({
+        issuer: RegExp;
+        loader: any;
+        options: {
+            method: string;
+        };
+    } | {
+        loader: any;
+        options: {
+            method: string;
+        };
+        issuer?: undefined;
+    })[];
+};

package/dist/rules/pug-rule.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pugRule = pugRule;
+const pug_plugin_1 = __importDefault(require("pug-plugin"));
+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',
+                },
+            },
+        ],
+    };
+}

package/dist/rules/scripts-rule.d.ts

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

package/dist/rules/scripts-rule.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scriptsRule = scriptsRule;
+function scriptsRule(env) {
+    if (env.scripts === '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/rules/styles-rule.d.ts

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

package/dist/rules/styles-rule.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stylesRule = stylesRule;
+function stylesRule(env) {
+    const isLess = env.styles === '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/types/app-type.d.ts

@@ -0,0 +1 @@
+export type AppType = 'mpa' | 'spa';

package/dist/types/app-type.js

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

package/dist/types/base-webpack-config-type.d.ts

@@ -0,0 +1,2 @@
+import type { Configuration as WebpackConfiguration } from 'webpack';
+export type BaseWebpackConfigType = WebpackConfiguration;

package/dist/types/base-webpack-config-type.js

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

package/dist/types/build-plugin-type.d.ts

@@ -0,0 +1,24 @@
+import { Configuration } from 'webpack';
+import { NormalizedCoreOptions } from '../options';
+export type BuildContextType = {
+    options: NormalizedCoreOptions;
+};
+export type BuildPluginType = {
+    name: string;
+    /**
+     * Runs once during base config creation
+     */
+    setup?: (ctx: BuildContextType) => void;
+    /**
+     * Extends base config
+     */
+    applyBase?: (config: Configuration) => void;
+    /**
+     * Extends dev config
+     */
+    applyDev?: (config: Configuration) => void;
+    /**
+     * Extends production config
+     */
+    applyProd?: (config: Configuration) => void;
+};

package/dist/types/build-plugin-type.js

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