@razerspine/build 1.0.0

package/dist/types/config-option-type.d.ts

@@ -0,0 +1,120 @@
+import { Configuration, RuleSetRule, WebpackPluginInstance } from 'webpack';
+import { AppType } from 'app-type';
+import { StyleType } from 'style-type';
+import { ScriptType } from 'script-type';
+import { ModeType } from 'mode-type';
+import { TemplatesType } from 'templates-type';
+import { BuildPluginType } from 'build-plugin-type';
+/**
+ * Options for configuring the core build process.
+ */
+export type ConfigOptionType = {
+    /** Build mode: 'development' or 'production' */
+    mode: ModeType;
+    /** Script processing options JavaScript or TypeScript */
+    scripts: ScriptType;
+    /** Styling processing options SCSS or Less */
+    styles: StyleType;
+    /** Architecture type: 'spa' (Single Page) or 'mpa' (Multi Page) */
+    appType?: AppType;
+    /**
+     * Configuration for HTML/Pug templates
+     */
+    templates?: {
+        /**
+         * Template engine type
+         * - 'pug'  → uses PugTemplatesPlugin
+         * - 'html' → uses HtmlTemplatesPlugin
+         * - 'none' → disables template handling (React/Vue/custom setups)
+         *
+         * @default 'pug'
+         */
+        type?: TemplatesType;
+        /**
+         * Path to the templates entry
+         *
+         * SPA:
+         * - single file (e.g. src/views/app.pug / index.html)
+         *
+         * MPA:
+         * - directory with pages
+         *
+         * @default 'src/views/app.pug' (SPA) or 'src/views/pages' (MPA)
+         */
+        entry?: string;
+    };
+    /**
+     * Custom Webpack module rules control.
+     */
+    rules?: {
+        /**
+         * Extend internal rules (safe).
+         * Rules will be appended to the default pipeline.
+         */
+        extend?: RuleSetRule[];
+        /**
+         * ⚠️ Overrides ALL internal rules completely.
+         *
+         * Disables:
+         * - assetsRule
+         * - scriptsRule
+         * - stylesRule
+         * - pugRule (if enabled)
+         *
+         * Use only if you fully control the webpack pipeline.
+         */
+        override?: RuleSetRule[];
+    };
+    /**
+     * Custom Webpack plugins control.
+     */
+    plugins?: {
+        /**
+         * Extend internal plugins (safe).
+         * Plugins will be appended after core plugins.
+         */
+        extend?: WebpackPluginInstance[];
+        /**
+         * ⚠️ Overrides ALL internal plugins completely.
+         *
+         * Disables:
+         * - PugTemplatesPlugin / HtmlTemplatesPlugin
+         * - HostingRoutingPlugin (in production)
+         *
+         * Use only if you fully control plugin lifecycle.
+         */
+        override?: WebpackPluginInstance[];
+    };
+    /**
+     * Webpack resolve configuration (aliases, extensions, etc.)
+     * This is merged into the final Webpack config.
+     */
+    resolve?: Configuration['resolve'];
+    /**
+     * Build plugins (lite extension API)
+     *
+     * Allows hooking into config generation lifecycle
+     * without breaking webpack compatibility.
+     *
+     * Plugins can:
+     * - modify config before/after creation
+     * - inject rules/plugins programmatically
+     * - extend dev/prod behavior
+     *
+     * This is NOT a webpack plugin system replacement.
+     * It is a higher-level orchestration layer.
+     *
+     * Example:
+     * ```ts
+     * {
+     *   name: 'react-support',
+     *   setup(ctx) {
+     *     ctx.hooks.extendConfig.tap(config => {
+     *       config.resolve.extensions.push('.jsx', '.tsx');
+     *     });
+     *   }
+     * }
+     * ```
+     */
+    buildPlugins?: BuildPluginType[];
+};

package/dist/types/config-option-type.js

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

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

@@ -0,0 +1 @@
+export type HostingType = 'netlify' | 'vercel' | 'cloudflare' | 'github' | 'static';

package/dist/types/hosting-type.js

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

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+export type { AppType } from './app-type';
+export type { BaseWebpackConfigType } from './base-webpack-config-type';
+export type { ConfigOptionType } from './config-option-type';
+export type { HostingType } from './hosting-type';
+export type { ModeType } from './mode-type';
+export type { ScriptType } from './script-type';
+export type { StyleType } from './style-type';
+export type { TemplatesType } from './templates-type';
+export type { BuildContextType, BuildPluginType } from './build-plugin-type';

package/dist/types/index.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/dist/types/templates-type.d.ts

@@ -0,0 +1 @@
+export type TemplatesType = 'pug' | 'html' | 'none';

package/dist/types/templates-type.js

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

package/dist/utils/dedupe-plugins.d.ts

@@ -0,0 +1,5 @@
+import { WebpackPluginInstance } from 'webpack';
+/**
+ * Prevent duplicate plugins (by constructor name)
+ */
+export declare function dedupePlugins(plugins: WebpackPluginInstance[]): WebpackPluginInstance[];

package/dist/utils/dedupe-plugins.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dedupePlugins = dedupePlugins;
+/**
+ * Prevent duplicate plugins (by constructor name)
+ */
+function dedupePlugins(plugins) {
+    const seen = new Set();
+    return plugins.filter((plugin) => {
+        var _a;
+        const name = (_a = plugin === null || plugin === void 0 ? void 0 : plugin.constructor) === null || _a === void 0 ? void 0 : _a.name;
+        if (!name)
+            return true;
+        if (seen.has(name)) {
+            return false;
+        }
+        seen.add(name);
+        return true;
+    });
+}

package/dist/utils/dedupe-rules.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @module dedupe-rules
+ * @description Removes duplicate webpack rules based on their test pattern.
+ */
+import { RuleSetRule } from 'webpack';
+/**
+ * Dedupe rules (last one wins)
+ */
+export declare function dedupeRules(rules: RuleSetRule[]): RuleSetRule[];

package/dist/utils/dedupe-rules.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * @module dedupe-rules
+ * @description Removes duplicate webpack rules based on their test pattern.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dedupeRules = dedupeRules;
+/**
+ * Extracts a comparable key from a rule
+ */
+function getRuleKey(rule) {
+    if (rule.test instanceof RegExp) {
+        return rule.test.toString();
+    }
+    return JSON.stringify(rule.test || rule.include || rule.exclude || {});
+}
+/**
+ * Dedupe rules (last one wins)
+ */
+function dedupeRules(rules) {
+    const map = new Map();
+    for (const rule of rules) {
+        const key = getRuleKey(rule);
+        map.set(key, rule);
+    }
+    return Array.from(map.values());
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { dedupePlugins } from './dedupe-plugins';
+export { dedupeRules } from './dedupe-rules';
+export { textCapitalize } from './text-capitalize';

package/dist/utils/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.textCapitalize = exports.dedupeRules = exports.dedupePlugins = void 0;
+var dedupe_plugins_1 = require("./dedupe-plugins");
+Object.defineProperty(exports, "dedupePlugins", { enumerable: true, get: function () { return dedupe_plugins_1.dedupePlugins; } });
+var dedupe_rules_1 = require("./dedupe-rules");
+Object.defineProperty(exports, "dedupeRules", { enumerable: true, get: function () { return dedupe_rules_1.dedupeRules; } });
+var text_capitalize_1 = require("./text-capitalize");
+Object.defineProperty(exports, "textCapitalize", { enumerable: true, get: function () { return text_capitalize_1.textCapitalize; } });

package/dist/utils/text-capitalize.d.ts

@@ -0,0 +1 @@
+export declare function textCapitalize(value: string): string;

package/dist/utils/text-capitalize.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.textCapitalize = textCapitalize;
+function textCapitalize(value) {
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@razerspine/build",
+  "version": "1.0.0",
+  "description": "Scalable Webpack build system for Pug, HTML, and React applications with smart hosting support",
+  "keywords": [
+    "webpack",
+    "webpack-config",
+    "pug",
+    "react",
+    "spa",
+    "mpa",
+    "define-config",
+    "vercel",
+    "build-tool"
+  ],
+  "license": "ISC",
+  "author": "Razerspine",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Razerspine/webpack-starter-monorepo.git",
+    "directory": "packages/build"
+  },
+  "homepage": "https://github.com/Razerspine/webpack-starter-monorepo/blob/main/packages/build#readme",
+  "bugs": {
+    "url": "https://github.com/Razerspine/webpack-starter-monorepo/issues"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/types/index.js"
+    }
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:snapshots": "vitest run tests/snapshots",
+    "test:e2e:prepare": "npm install --prefix tests/fixtures/mpa && npm install --prefix tests/fixtures/spa",
+    "test:e2e": "vitest run tests/e2e",
+    "test:e2e:full": "npm run test:e2e:prepare && npm run test:e2e"
+  },
+  "peerDependencies": {
+    "pug-plugin": "^5 || ^6",
+    "webpack": "^5",
+    "webpack-dev-server": "^5",
+    "html-webpack-plugin": "^5",
+    "@pmmmwh/react-refresh-webpack-plugin": "^0.6.2"
+  },
+  "peerDependenciesMeta": {
+    "pug-plugin": {
+      "optional": true
+    },
+    "html-webpack-plugin": {
+      "optional": true
+    },
+    "@pmmmwh/react-refresh-webpack-plugin": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "html-webpack-plugin": "^5.6.6",
+    "jsdom": "^29.0.0",
+    "pug-plugin": "^6.1.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.1.0",
+    "webpack": "^5.105.0",
+    "webpack-dev-server": "^5.2.3",
+    "webpack-merge": "^5.10.0"
+  }
+}