@rootreeweb/rt-webpack-helper 4.1.1

package/README.md

@@ -0,0 +1,20 @@
+# @rootreeweb/rt-webpack-helper
+
+## What is This?
+
+@rootreeweb/rt-webpack-helper is a JavaScript package for generating standardized webpack configurations for projects.
+There are three different base options to choose from:
+
+- `getWebpackConfig` Returns a configuration for bundling web page scripts and styles for use in-browser.
+  This is the most commonly used option.
+- `getCssConfig` Is a modified version of `getWebpackConfig` that is specialized for generating stylesheets only.
+  This is useful for scenarios in which the JavaScript portion of the project is not being bundled for browsers.
+  An example of this would be when creating a component library such as @rootreeweb/ui.
+- `getWebpackDevConfig` Returns a configuration designed for testing JavaScript based apps locally.
+  It takes an HTML page, and a script entry point. It provides a local development server with hot-module-reload.
+  An example use case for this would be the aforementioned @rootreeweb/ui.
+  That library utilizes this configuration to give component authors a live view of the components they are working on.
+
+## Usage
+
+Usage instructions can be found in the [Bundling With Webpack](https://docs.cappy.rootree.ca/guides/webpack/) guide.

package/dist/esm/base.d.ts

@@ -0,0 +1,20 @@
+import type { EntryObject, Configuration as WebpackConfiguration } from "webpack";
+import { type GetConfigOptions, type OutputOptions } from "./types.js";
+/**
+ * Creates the name of an output file.
+ *
+ * @param postfix The file postfix. Ex. `chunk`
+ * @param extension The file extension. Ex. `js`
+ * @param options The config options pertaining to hashing and filenaming.
+ * @returns The output file name to use.
+ */
+export declare function getOutputName(postfix: string, extension: string, options?: OutputOptions): string;
+/**
+ * Get the webpack configuration.
+ *
+ * @param entry The entry object to use.
+ * @param options The options for the configuration.
+ * @returns The webpack configuration.
+ */
+export declare function getWebpackConfig(entry?: EntryObject, options?: GetConfigOptions): WebpackConfiguration;
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/base.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,WAAW,EACX,aAAa,IAAI,oBAAoB,EACrC,MAAM,SAAS,CAAC;AAKjB,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,aAAa,GACrB,MAAM,CAUR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,CAAC,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,gBAAgB,GACxB,oBAAoB,CA8CtB"}

package/dist/esm/base.js

@@ -0,0 +1,109 @@
+import path from "path";
+import CssMinimizerPlugin from "css-minimizer-webpack-plugin";
+import { getPlugins } from "./getPlugins.js";
+import { getRules } from "./getRules.js";
+import { getOutputOptions } from "./outputOptions.js";
+import {} from "./types.js";
+/**
+ * Creates the name of an output file.
+ *
+ * @param postfix The file postfix. Ex. `chunk`
+ * @param extension The file extension. Ex. `js`
+ * @param options The config options pertaining to hashing and filenaming.
+ * @returns The output file name to use.
+ */
+export function getOutputName(postfix, extension, options) {
+    const { useHash, usePostfix } = getOutputOptions(options);
+    let name = "[name]";
+    if (useHash) {
+        name += ".[contenthash]";
+    }
+    if (usePostfix && postfix) {
+        name += "." + postfix;
+    }
+    return name + "." + extension;
+}
+/**
+ * Get the webpack configuration.
+ *
+ * @param entry The entry object to use.
+ * @param options The options for the configuration.
+ * @returns The webpack configuration.
+ */
+export function getWebpackConfig(entry, options) {
+    const { additionalExtensions = [], aliases, devtool = "source-map", outputPath = path.resolve("dist"), } = options ?? {};
+    const extensions = [
+        ".tsx",
+        ".ts",
+        ".js",
+        ".css",
+        ".scss",
+        ...additionalExtensions,
+    ];
+    const resolve = {
+        extensionAlias: {
+            ".js": [".js", ".ts", ".tsx"],
+        },
+        extensions,
+    };
+    if (aliases) {
+        resolve.alias = aliases;
+    }
+    const baseConfig = {
+        devtool,
+        module: {
+            rules: getRules(options),
+        },
+        output: {
+            chunkFilename: getOutputName("chunk", "js", options),
+            filename: getOutputName("bundle", "js", options),
+            path: outputPath,
+        },
+        plugins: getPlugins(options),
+        resolve,
+    };
+    const optimization = getOptimizationOptions(options);
+    if (optimization) {
+        baseConfig.optimization = optimization;
+    }
+    if (entry) {
+        baseConfig.entry = entry;
+    }
+    return baseConfig;
+}
+/**
+ * Get the options pertaining to optimization.
+ *
+ * @param options The output options.
+ * @returns The optimization settings.
+ */
+function getOptimizationOptions(options) {
+    const { optimize } = getOutputOptions(options);
+    return optimize
+        ? {
+            minimizer: [`...`, new CssMinimizerPlugin()],
+            sideEffects: true,
+            splitChunks: {
+                automaticNameDelimiter: "~",
+                cacheGroups: {
+                    default: {
+                        minChunks: 2,
+                        priority: -20,
+                        reuseExistingChunk: true,
+                    },
+                    defaultVendors: {
+                        priority: -10,
+                        test: /[\\/]node_modules[\\/]/,
+                    },
+                },
+                enforceSizeThreshold: 50000,
+                maxAsyncRequests: 30,
+                maxInitialRequests: 30,
+                minChunks: 1,
+                minSize: 20000,
+            },
+            usedExports: true,
+        }
+        : undefined;
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/base.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"path\";\nimport CssMinimizerPlugin from \"css-minimizer-webpack-plugin\";\nimport type {\n\tEntryObject,\n\tConfiguration as WebpackConfiguration,\n} from \"webpack\";\n\nimport { getPlugins } from \"./getPlugins.js\";\nimport { getRules } from \"./getRules.js\";\nimport { getOutputOptions } from \"./outputOptions.js\";\nimport { type GetConfigOptions, type OutputOptions } from \"./types.js\";\n\n/**\n * Creates the name of an output file.\n *\n * @param postfix The file postfix. Ex. `chunk`\n * @param extension The file extension. Ex. `js`\n * @param options The config options pertaining to hashing and filenaming.\n * @returns The output file name to use.\n */\nexport function getOutputName(\n\tpostfix: string,\n\textension: string,\n\toptions?: OutputOptions,\n): string {\n\tconst { useHash, usePostfix } = getOutputOptions(options);\n\tlet name = \"[name]\";\n\tif (useHash) {\n\t\tname += \".[contenthash]\";\n\t}\n\tif (usePostfix && postfix) {\n\t\tname += \".\" + postfix;\n\t}\n\treturn name + \".\" + extension;\n}\n\n/**\n * Get the webpack configuration.\n *\n * @param entry The entry object to use.\n * @param options The options for the configuration.\n * @returns The webpack configuration.\n */\nexport function getWebpackConfig(\n\tentry?: EntryObject,\n\toptions?: GetConfigOptions,\n): WebpackConfiguration {\n\tconst {\n\t\tadditionalExtensions = [],\n\t\taliases,\n\t\tdevtool = \"source-map\",\n\t\toutputPath = path.resolve(\"dist\"),\n\t} = options ?? {};\n\tconst extensions: string[] = [\n\t\t\".tsx\",\n\t\t\".ts\",\n\t\t\".js\",\n\t\t\".css\",\n\t\t\".scss\",\n\t\t...additionalExtensions,\n\t];\n\tconst resolve: NonNullable<WebpackConfiguration[\"resolve\"]> = {\n\t\textensionAlias: {\n\t\t\t\".js\": [\".js\", \".ts\", \".tsx\"],\n\t\t},\n\t\textensions,\n\t};\n\tif (aliases) {\n\t\tresolve.alias = aliases;\n\t}\n\n\tconst baseConfig: WebpackConfiguration = {\n\t\tdevtool,\n\t\tmodule: {\n\t\t\trules: getRules(options),\n\t\t},\n\t\toutput: {\n\t\t\tchunkFilename: getOutputName(\"chunk\", \"js\", options),\n\t\t\tfilename: getOutputName(\"bundle\", \"js\", options),\n\t\t\tpath: outputPath,\n\t\t},\n\t\tplugins: getPlugins(options),\n\t\tresolve,\n\t};\n\tconst optimization = getOptimizationOptions(options);\n\tif (optimization) {\n\t\tbaseConfig.optimization = optimization;\n\t}\n\tif (entry) {\n\t\tbaseConfig.entry = entry;\n\t}\n\treturn baseConfig;\n}\n\n/**\n * Get the options pertaining to optimization.\n *\n * @param options The output options.\n * @returns The optimization settings.\n */\nfunction getOptimizationOptions(\n\toptions?: OutputOptions,\n): WebpackConfiguration[\"optimization\"] {\n\tconst { optimize } = getOutputOptions(options);\n\treturn optimize\n\t\t? {\n\t\t\t\tminimizer: [`...`, new CssMinimizerPlugin()],\n\t\t\t\tsideEffects: true,\n\t\t\t\tsplitChunks: {\n\t\t\t\t\tautomaticNameDelimiter: \"~\",\n\t\t\t\t\tcacheGroups: {\n\t\t\t\t\t\tdefault: {\n\t\t\t\t\t\t\tminChunks: 2,\n\t\t\t\t\t\t\tpriority: -20,\n\t\t\t\t\t\t\treuseExistingChunk: true,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tdefaultVendors: {\n\t\t\t\t\t\t\tpriority: -10,\n\t\t\t\t\t\t\ttest: /[\\\\/]node_modules[\\\\/]/,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\tenforceSizeThreshold: 50000,\n\t\t\t\t\tmaxAsyncRequests: 30,\n\t\t\t\t\tmaxInitialRequests: 30,\n\t\t\t\t\tminChunks: 1,\n\t\t\t\t\tminSize: 20000,\n\t\t\t\t},\n\t\t\t\tusedExports: true,\n\t\t\t}\n\t\t: undefined;\n}\n"]}

package/dist/esm/cssConfig.d.ts

@@ -0,0 +1,9 @@
+import type { EntryObject, Configuration as WebpackConfiguration } from "webpack";
+/**
+ * Gets a configuration for bundling from a CSS entrypoint.
+ *
+ * @param entry The entrypoint for the CSS.
+ * @returns The webpack configuration.
+ */
+export declare function getCssConfig(entry: EntryObject): WebpackConfiguration;
+//# sourceMappingURL=cssConfig.d.ts.map

package/dist/esm/cssConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssConfig.d.ts","sourceRoot":"","sources":["../../src/cssConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,aAAa,IAAI,oBAAoB,EACrC,MAAM,SAAS,CAAC;AAIjB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,oBAAoB,CAErE"}

package/dist/esm/cssConfig.js

@@ -0,0 +1,11 @@
+import { getWebpackConfig } from "./base.js";
+/**
+ * Gets a configuration for bundling from a CSS entrypoint.
+ *
+ * @param entry The entrypoint for the CSS.
+ * @returns The webpack configuration.
+ */
+export function getCssConfig(entry) {
+    return getWebpackConfig(entry, { useHash: false, usePostfix: false });
+}
+//# sourceMappingURL=cssConfig.js.map

package/dist/esm/cssConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssConfig.js","sourceRoot":"","sources":["../../src/cssConfig.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC9C,OAAO,gBAAgB,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import type {\n\tEntryObject,\n\tConfiguration as WebpackConfiguration,\n} from \"webpack\";\n\nimport { getWebpackConfig } from \"./base.js\";\n\n/**\n * Gets a configuration for bundling from a CSS entrypoint.\n *\n * @param entry The entrypoint for the CSS.\n * @returns The webpack configuration.\n */\nexport function getCssConfig(entry: EntryObject): WebpackConfiguration {\n\treturn getWebpackConfig(entry, { useHash: false, usePostfix: false });\n}\n"]}

package/dist/esm/devConfig.d.ts

@@ -0,0 +1,18 @@
+import type { EntryObject } from "webpack";
+import type { WebpackConfiguration } from "webpack-dev-server";
+import type { GetConfigOptions } from "./types.js";
+export type DevConfigOptions = GetConfigOptions & {
+    additionalEntrypoints?: EntryObject;
+    port?: NonNullable<WebpackConfiguration["devServer"]>["port"];
+};
+/**
+ * Get the webpack configuration.
+ *
+ * @param jsEntry The JS entry point for the development server.
+ * @param htmlTemplate The HTML template to use. This will be a page that
+ *   utilizes the JS entry point.
+ * @param options Additional options for customizing the configuration.
+ * @returns The webpack configuration.
+ */
+export declare function getWebpackDevConfig(jsEntry: string, htmlTemplate: string, options?: DevConfigOptions): WebpackConfiguration;
+//# sourceMappingURL=devConfig.d.ts.map

package/dist/esm/devConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devConfig.d.ts","sourceRoot":"","sources":["../../src/devConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG;IACjD,qBAAqB,CAAC,EAAE,WAAW,CAAC;IACpC,IAAI,CAAC,EAAE,WAAW,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CAC9D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACxB,oBAAoB,CA4BtB"}

package/dist/esm/devConfig.js

@@ -0,0 +1,38 @@
+import * as path from "path";
+import HtmlWebpackPlugin from "html-webpack-plugin";
+import { getWebpackConfig } from "./base.js";
+/**
+ * Get the webpack configuration.
+ *
+ * @param jsEntry The JS entry point for the development server.
+ * @param htmlTemplate The HTML template to use. This will be a page that
+ *   utilizes the JS entry point.
+ * @param options Additional options for customizing the configuration.
+ * @returns The webpack configuration.
+ */
+export function getWebpackDevConfig(jsEntry, htmlTemplate, options) {
+    const { additionalEntrypoints, port, ...rest } = options ?? {};
+    const config = getWebpackConfig({
+        index: jsEntry,
+        ...(additionalEntrypoints ?? {}),
+    }, {
+        additionalPlugins: [
+            new HtmlWebpackPlugin({
+                template: htmlTemplate,
+            }),
+        ],
+        devtool: "inline-source-map",
+        optimize: false,
+        useHash: false,
+        usePostfix: false,
+        ...rest,
+    });
+    config.devServer = {
+        hot: true,
+        port: port ?? 8080,
+        static: path.resolve("dist"),
+    };
+    config.mode = "development";
+    return config;
+}
+//# sourceMappingURL=devConfig.js.map

package/dist/esm/devConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devConfig.js","sourceRoot":"","sources":["../../src/devConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAIpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAQ7C;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAClC,OAAe,EACf,YAAoB,EACpB,OAA0B;IAE1B,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAC/D,MAAM,MAAM,GAAG,gBAAgB,CAC9B;QACC,KAAK,EAAE,OAAO;QACd,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;KAChC,EACD;QACC,iBAAiB,EAAE;YAClB,IAAI,iBAAiB,CAAC;gBACrB,QAAQ,EAAE,YAAY;aACtB,CAAC;SACF;QACD,OAAO,EAAE,mBAAmB;QAC5B,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,KAAK;QACjB,GAAG,IAAI;KACP,CACD,CAAC;IACF,MAAM,CAAC,SAAS,GAAG;QAClB,GAAG,EAAE,IAAI;QACT,IAAI,EAAE,IAAI,IAAI,IAAI;QAClB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;KAC5B,CAAC;IAEF,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,OAAO,MAAM,CAAC;AACf,CAAC","sourcesContent":["import * as path from \"path\";\nimport HtmlWebpackPlugin from \"html-webpack-plugin\";\nimport type { EntryObject } from \"webpack\";\nimport type { WebpackConfiguration } from \"webpack-dev-server\";\n\nimport { getWebpackConfig } from \"./base.js\";\nimport type { GetConfigOptions } from \"./types.js\";\n\nexport type DevConfigOptions = GetConfigOptions & {\n\tadditionalEntrypoints?: EntryObject;\n\tport?: NonNullable<WebpackConfiguration[\"devServer\"]>[\"port\"];\n};\n\n/**\n * Get the webpack configuration.\n *\n * @param jsEntry The JS entry point for the development server.\n * @param htmlTemplate The HTML template to use. This will be a page that\n *   utilizes the JS entry point.\n * @param options Additional options for customizing the configuration.\n * @returns The webpack configuration.\n */\nexport function getWebpackDevConfig(\n\tjsEntry: string,\n\thtmlTemplate: string,\n\toptions?: DevConfigOptions,\n): WebpackConfiguration {\n\tconst { additionalEntrypoints, port, ...rest } = options ?? {};\n\tconst config = getWebpackConfig(\n\t\t{\n\t\t\tindex: jsEntry,\n\t\t\t...(additionalEntrypoints ?? {}),\n\t\t},\n\t\t{\n\t\t\tadditionalPlugins: [\n\t\t\t\tnew HtmlWebpackPlugin({\n\t\t\t\t\ttemplate: htmlTemplate,\n\t\t\t\t}),\n\t\t\t],\n\t\t\tdevtool: \"inline-source-map\",\n\t\t\toptimize: false,\n\t\t\tuseHash: false,\n\t\t\tusePostfix: false,\n\t\t\t...rest,\n\t\t},\n\t);\n\tconfig.devServer = {\n\t\thot: true,\n\t\tport: port ?? 8080,\n\t\tstatic: path.resolve(\"dist\"),\n\t};\n\n\tconfig.mode = \"development\";\n\treturn config;\n}\n"]}

package/dist/esm/getPlugins.d.ts

@@ -0,0 +1,10 @@
+import type { WebpackPluginInstance } from "webpack";
+import type { GetPluginsOptions } from "./types.js";
+/**
+ * Gets the plugins for the configuration
+ *
+ * @param options The options to use for generating the plugin configuration.
+ * @returns The plugins to use.
+ */
+export declare function getPlugins(options?: GetPluginsOptions): WebpackPluginInstance[];
+//# sourceMappingURL=getPlugins.d.ts.map

package/dist/esm/getPlugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPlugins.d.ts","sourceRoot":"","sources":["../../src/getPlugins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAMrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,UAAU,CACzB,OAAO,CAAC,EAAE,iBAAiB,GACzB,qBAAqB,EAAE,CAkBzB"}

package/dist/esm/getPlugins.js

@@ -0,0 +1,30 @@
+import MiniCssExtractPlugin from "mini-css-extract-plugin";
+import { WebpackManifestPlugin } from "webpack-manifest-plugin";
+import RemoveEmptyScriptsPlugin from "webpack-remove-empty-scripts";
+import { getOutputName } from "./base.js";
+import { getOutputOptions } from "./outputOptions.js";
+/**
+ * Gets the plugins for the configuration
+ *
+ * @param options The options to use for generating the plugin configuration.
+ * @returns The plugins to use.
+ */
+export function getPlugins(options) {
+    const { useHash } = getOutputOptions(options);
+    const plugins = [
+        new MiniCssExtractPlugin({
+            chunkFilename: getOutputName("chunk", "css", options),
+            filename: getOutputName("", "css", options),
+        }),
+        new RemoveEmptyScriptsPlugin(),
+    ];
+    if (useHash)
+        plugins.push(new WebpackManifestPlugin({
+            fileName: "manifest.json",
+            filter: (file) => file.isInitial,
+        }));
+    if (options?.additionalPlugins)
+        plugins.push(...options.additionalPlugins);
+    return plugins;
+}
+//# sourceMappingURL=getPlugins.js.map

package/dist/esm/getPlugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPlugins.js","sourceRoot":"","sources":["../../src/getPlugins.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,wBAAwB,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACzB,OAA2B;IAE3B,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,OAAO,GAA4B;QACxC,IAAI,oBAAoB,CAAC;YACxB,aAAa,EAAE,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC;YACrD,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC;SAC3C,CAAC;QACF,IAAI,wBAAwB,EAAE;KAC9B,CAAC;IACF,IAAI,OAAO;QACV,OAAO,CAAC,IAAI,CACX,IAAI,qBAAqB,CAAC;YACzB,QAAQ,EAAE,eAAe;YACzB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS;SAChC,CAAC,CACF,CAAC;IACH,IAAI,OAAO,EAAE,iBAAiB;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3E,OAAO,OAAO,CAAC;AAChB,CAAC","sourcesContent":["import MiniCssExtractPlugin from \"mini-css-extract-plugin\";\nimport type { WebpackPluginInstance } from \"webpack\";\nimport { WebpackManifestPlugin } from \"webpack-manifest-plugin\";\nimport RemoveEmptyScriptsPlugin from \"webpack-remove-empty-scripts\";\n\nimport { getOutputName } from \"./base.js\";\nimport { getOutputOptions } from \"./outputOptions.js\";\nimport type { GetPluginsOptions } from \"./types.js\";\n\n/**\n * Gets the plugins for the configuration\n *\n * @param options The options to use for generating the plugin configuration.\n * @returns The plugins to use.\n */\nexport function getPlugins(\n\toptions?: GetPluginsOptions,\n): WebpackPluginInstance[] {\n\tconst { useHash } = getOutputOptions(options);\n\tconst plugins: WebpackPluginInstance[] = [\n\t\tnew MiniCssExtractPlugin({\n\t\t\tchunkFilename: getOutputName(\"chunk\", \"css\", options),\n\t\t\tfilename: getOutputName(\"\", \"css\", options),\n\t\t}),\n\t\tnew RemoveEmptyScriptsPlugin(),\n\t];\n\tif (useHash)\n\t\tplugins.push(\n\t\t\tnew WebpackManifestPlugin({\n\t\t\t\tfileName: \"manifest.json\",\n\t\t\t\tfilter: (file) => file.isInitial,\n\t\t\t}),\n\t\t);\n\tif (options?.additionalPlugins) plugins.push(...options.additionalPlugins);\n\treturn plugins;\n}\n"]}

package/dist/esm/getRules.d.ts

@@ -0,0 +1,10 @@
+import type { RuleSetRule } from "webpack";
+import type { GetRulesOptions } from "./types.js";
+/**
+ * Gets the rules for the configuration.
+ *
+ * @param options The options for the resolution rules.
+ * @returns The resolution rules.
+ */
+export declare function getRules(options?: GetRulesOptions): RuleSetRule[];
+//# sourceMappingURL=getRules.d.ts.map

package/dist/esm/getRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRules.d.ts","sourceRoot":"","sources":["../../src/getRules.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAM3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkFlD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,WAAW,EAAE,CAUjE"}

package/dist/esm/getRules.js

@@ -0,0 +1,103 @@
+import { createRequire } from "node:module";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import path from "path";
+import MiniCssExtractPlugin from "mini-css-extract-plugin";
+import { protectSupportsPlugin, restoreSupportsPlugin, } from "./postcssProtectSupports.js";
+const require = createRequire(import.meta.url);
+/* v8 ignore next 8 */
+let dir;
+try {
+    dir = __dirname;
+    // eslint-disable-next-line sonarjs/no-ignored-exceptions
+}
+catch (_e) {
+    // eslint-disable-next-line
+    // @ts-ignore
+    dir = dirname(fileURLToPath(import.meta.url));
+}
+const postcssLoader = {
+    loader: require.resolve("postcss-loader"),
+    options: {
+        postcssOptions: {
+            plugins: [
+                "@tailwindcss/postcss",
+                protectSupportsPlugin(),
+                [
+                    "postcss-preset-env",
+                    {
+                        autoprefixer: true,
+                        browsers: "> 1% in CA, not dead",
+                    },
+                ],
+                restoreSupportsPlugin(),
+            ],
+        },
+    },
+};
+const baseRules = [
+    {
+        exclude: /node_modules/,
+        test: /\.tsx?$/,
+        use: require.resolve("ts-loader"),
+    },
+    {
+        resolve: {
+            fullySpecified: false,
+        },
+        test: /\.m?js/,
+    },
+    {
+        exclude: /\.module\.s?css$/,
+        test: /\.s?css$/,
+        use: [
+            MiniCssExtractPlugin.loader,
+            require.resolve("css-loader"),
+            postcssLoader,
+            path.resolve(dir, "prefixPatcher.js"),
+            require.resolve("sass-loader"),
+        ],
+    },
+    {
+        include: /\.module\.s?css$/,
+        test: /\.s?css$/,
+        use: [
+            MiniCssExtractPlugin.loader,
+            {
+                loader: require.resolve("css-loader"),
+                options: {
+                    modules: {
+                        localIdentName: "[name]__[local]--[hash:base64:5]",
+                    },
+                },
+            },
+            postcssLoader,
+            require.resolve("sass-loader"),
+        ],
+    },
+    {
+        generator: {
+            filename: "assets/[name].[hash][ext]",
+        },
+        test: /\.(png|jpe?g|gif|svg|webp)$/i,
+        type: "asset/resource",
+    },
+];
+/**
+ * Gets the rules for the configuration.
+ *
+ * @param options The options for the resolution rules.
+ * @returns The resolution rules.
+ */
+export function getRules(options) {
+    const { additionalRules = [], excludedRules = [] } = options ?? {};
+    const rules = [];
+    for (const baseRule of baseRules) {
+        const { test } = baseRule;
+        if (!excludedRules.some((rule) => test.toString() === rule.toString())) {
+            rules.push(baseRule);
+        }
+    }
+    return rules.concat(additionalRules);
+}
+//# sourceMappingURL=getRules.js.map

package/dist/esm/getRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRules.js","sourceRoot":"","sources":["../../src/getRules.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRequire } from \"node:module\";\nimport { dirname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport path from \"path\";\nimport MiniCssExtractPlugin from \"mini-css-extract-plugin\";\nimport type { RuleSetRule } from \"webpack\";\n\nimport {\n\tprotectSupportsPlugin,\n\trestoreSupportsPlugin,\n} from \"./postcssProtectSupports.js\";\nimport type { GetRulesOptions } from \"./types.js\";\n\nconst require = createRequire(import.meta.url);\n/* v8 ignore next 8 */\nlet dir;\ntry {\n\tdir = __dirname;\n\t// eslint-disable-next-line sonarjs/no-ignored-exceptions\n} catch (_e) {\n\t// eslint-disable-next-line\n\t// @ts-ignore\n\tdir = dirname(fileURLToPath(import.meta.url));\n}\nconst postcssLoader = {\n\tloader: require.resolve(\"postcss-loader\"),\n\toptions: {\n\t\tpostcssOptions: {\n\t\t\tplugins: [\n\t\t\t\t\"@tailwindcss/postcss\",\n\t\t\t\tprotectSupportsPlugin(),\n\t\t\t\t[\n\t\t\t\t\t\"postcss-preset-env\",\n\t\t\t\t\t{\n\t\t\t\t\t\tautoprefixer: true,\n\t\t\t\t\t\tbrowsers: \"> 1% in CA, not dead\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\trestoreSupportsPlugin(),\n\t\t\t],\n\t\t},\n\t},\n};\n\nconst baseRules: (RuleSetRule & { test: RegExp })[] = [\n\t{\n\t\texclude: /node_modules/,\n\t\ttest: /\\.tsx?$/,\n\t\tuse: require.resolve(\"ts-loader\"),\n\t},\n\t{\n\t\tresolve: {\n\t\t\tfullySpecified: false,\n\t\t},\n\t\ttest: /\\.m?js/,\n\t},\n\t{\n\t\texclude: /\\.module\\.s?css$/,\n\t\ttest: /\\.s?css$/,\n\t\tuse: [\n\t\t\tMiniCssExtractPlugin.loader,\n\t\t\trequire.resolve(\"css-loader\"),\n\t\t\tpostcssLoader,\n\t\t\tpath.resolve(dir, \"prefixPatcher.js\"),\n\t\t\trequire.resolve(\"sass-loader\"),\n\t\t],\n\t},\n\t{\n\t\tinclude: /\\.module\\.s?css$/,\n\t\ttest: /\\.s?css$/,\n\t\tuse: [\n\t\t\tMiniCssExtractPlugin.loader,\n\t\t\t{\n\t\t\t\tloader: require.resolve(\"css-loader\"),\n\t\t\t\toptions: {\n\t\t\t\t\tmodules: {\n\t\t\t\t\t\tlocalIdentName: \"[name]__[local]--[hash:base64:5]\",\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t\tpostcssLoader,\n\t\t\trequire.resolve(\"sass-loader\"),\n\t\t],\n\t},\n\t{\n\t\tgenerator: {\n\t\t\tfilename: \"assets/[name].[hash][ext]\",\n\t\t},\n\t\ttest: /\\.(png|jpe?g|gif|svg|webp)$/i,\n\t\ttype: \"asset/resource\",\n\t},\n];\n\n/**\n * Gets the rules for the configuration.\n *\n * @param options The options for the resolution rules.\n * @returns The resolution rules.\n */\nexport function getRules(options?: GetRulesOptions): RuleSetRule[] {\n\tconst { additionalRules = [], excludedRules = [] } = options ?? {};\n\tconst rules: RuleSetRule[] = [];\n\tfor (const baseRule of baseRules) {\n\t\tconst { test } = baseRule;\n\t\tif (!excludedRules.some((rule) => test.toString() === rule.toString())) {\n\t\t\trules.push(baseRule);\n\t\t}\n\t}\n\treturn rules.concat(additionalRules);\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./base.js";
+export * from "./cssConfig.js";
+export * from "./devConfig.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export * from "./base.js";
+export * from "./cssConfig.js";
+export * from "./devConfig.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC","sourcesContent":["export * from \"./base.js\";\nexport * from \"./cssConfig.js\";\nexport * from \"./devConfig.js\";\n"]}

package/dist/esm/outputOptions.d.ts

@@ -0,0 +1,10 @@
+import type { OutputOptions } from "./types.js";
+/**
+ * Creates an object with the required output options. Filling from defaults
+ * where required.
+ *
+ * @param supplied The consumer-supplied options.
+ * @returns The options, defaulted where necessary.
+ */
+export declare function getOutputOptions(supplied?: OutputOptions): Required<OutputOptions>;
+//# sourceMappingURL=outputOptions.d.ts.map

package/dist/esm/outputOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputOptions.d.ts","sourceRoot":"","sources":["../../src/outputOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQhD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,CAAC,EAAE,aAAa,GACtB,QAAQ,CAAC,aAAa,CAAC,CAEzB"}

package/dist/esm/outputOptions.js

@@ -0,0 +1,16 @@
+const defaultOutputOptions = Object.freeze({
+    optimize: true,
+    useHash: true,
+    usePostfix: true,
+});
+/**
+ * Creates an object with the required output options. Filling from defaults
+ * where required.
+ *
+ * @param supplied The consumer-supplied options.
+ * @returns The options, defaulted where necessary.
+ */
+export function getOutputOptions(supplied) {
+    return Object.assign({}, defaultOutputOptions, supplied);
+}
+//# sourceMappingURL=outputOptions.js.map

package/dist/esm/outputOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputOptions.js","sourceRoot":"","sources":["../../src/outputOptions.ts"],"names":[],"mappings":"AAEA,MAAM,oBAAoB,GAAsC,MAAM,CAAC,MAAM,CAAC;IAC7E,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,IAAI;CAChB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC/B,QAAwB;IAExB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["import type { OutputOptions } from \"./types.js\";\n\nconst defaultOutputOptions: Readonly<Required<OutputOptions>> = Object.freeze({\n\toptimize: true,\n\tuseHash: true,\n\tusePostfix: true,\n});\n\n/**\n * Creates an object with the required output options. Filling from defaults\n * where required.\n *\n * @param supplied The consumer-supplied options.\n * @returns The options, defaulted where necessary.\n */\nexport function getOutputOptions(\n\tsupplied?: OutputOptions,\n): Required<OutputOptions> {\n\treturn Object.assign({}, defaultOutputOptions, supplied);\n}\n"]}

package/dist/esm/postcssProtectSupports.d.ts

@@ -0,0 +1,25 @@
+import type { Plugin } from "postcss";
+/**
+ * PostCSS plugin that protects logical CSS properties inside `@supports` blocks
+ * by prefixing them with a temporary marker, preventing downstream
+ * transpilation.
+ *
+ * @returns A PostCSS plugin object that protects logical CSS properties within
+ *   an `@supports` block.
+ */
+export declare function protectSupportsPlugin(): Plugin;
+export declare namespace protectSupportsPlugin {
+    var postcss: boolean;
+}
+/**
+ * PostCSS plugin that restores the original property names of protected CSS
+ * properties.
+ *
+ * @returns A PostCSS plugin object that restores the original property names of
+ *   the rules within an `@supports` block.
+ */
+export declare function restoreSupportsPlugin(): Plugin;
+export declare namespace restoreSupportsPlugin {
+    var postcss: boolean;
+}
+//# sourceMappingURL=postcssProtectSupports.d.ts.map

package/dist/esm/postcssProtectSupports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcssProtectSupports.d.ts","sourceRoot":"","sources":["../../src/postcssProtectSupports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,MAAM,EAAQ,MAAM,SAAS,CAAC;AAIzD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAW9C;;;;AAsBD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAW9C"}

package/dist/esm/postcssProtectSupports.js

@@ -0,0 +1,59 @@
+const MARKER = "__skip_logical__";
+/**
+ * PostCSS plugin that protects logical CSS properties inside `@supports` blocks
+ * by prefixing them with a temporary marker, preventing downstream
+ * transpilation.
+ *
+ * @returns A PostCSS plugin object that protects logical CSS properties within
+ *   an `@supports` block.
+ */
+export function protectSupportsPlugin() {
+    return {
+        Once(root) {
+            root.walkDecls((decl) => {
+                if (!decl.prop.startsWith(MARKER) && isInsideSupports(decl)) {
+                    decl.prop = `${MARKER}${decl.prop}`;
+                }
+            });
+        },
+        postcssPlugin: "postcss-protect-supports",
+    };
+}
+/**
+ * Checks if a PostCSS node is nested within a `@supports` at-rule.
+ *
+ * @param node The PostCSS node to verify.
+ * @returns True if the node is inside a `@supports` rule, false otherwise.
+ */
+function isInsideSupports(node) {
+    let parent = node.parent;
+    while (parent) {
+        if (parent.type === "atrule" && parent.name === "supports") {
+            return true;
+        }
+        parent = parent.parent;
+    }
+    return false;
+}
+protectSupportsPlugin.postcss = true;
+/**
+ * PostCSS plugin that restores the original property names of protected CSS
+ * properties.
+ *
+ * @returns A PostCSS plugin object that restores the original property names of
+ *   the rules within an `@supports` block.
+ */
+export function restoreSupportsPlugin() {
+    return {
+        OnceExit(root) {
+            root.walkDecls((decl) => {
+                if (decl.prop.startsWith(MARKER)) {
+                    decl.prop = decl.prop.slice(MARKER.length);
+                }
+            });
+        },
+        postcssPlugin: "postcss-restore-supports",
+    };
+}
+restoreSupportsPlugin.postcss = true;
+//# sourceMappingURL=postcssProtectSupports.js.map

package/dist/esm/postcssProtectSupports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcssProtectSupports.js","sourceRoot":"","sources":["../../src/postcssProtectSupports.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,kBAAkB,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB;IACpC,OAAO;QACN,IAAI,CAAC,IAAU;YACd,IAAI,CAAC,SAAS,CAAC,CAAC,IAAiB,EAAE,EAAE;gBACpC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7D,IAAI,CAAC,IAAI,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBACrC,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC;QACD,aAAa,EAAE,0BAA0B;KACzC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,IAAiB;IAC1C,IAAI,MAAM,GAEwC,IAAI,CAAC,MAAM,CAAC;IAC9D,OAAO,MAAM,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AACD,qBAAqB,CAAC,OAAO,GAAG,IAAI,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACpC,OAAO;QACN,QAAQ,CAAC,IAAU;YAClB,IAAI,CAAC,SAAS,CAAC,CAAC,IAAiB,EAAE,EAAE;gBACpC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5C,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC;QACD,aAAa,EAAE,0BAA0B;KACzC,CAAC;AACH,CAAC;AACD,qBAAqB,CAAC,OAAO,GAAG,IAAI,CAAC","sourcesContent":["import type { Declaration, Plugin, Root } from \"postcss\";\n\nconst MARKER = \"__skip_logical__\";\n\n/**\n * PostCSS plugin that protects logical CSS properties inside `@supports` blocks\n * by prefixing them with a temporary marker, preventing downstream\n * transpilation.\n *\n * @returns A PostCSS plugin object that protects logical CSS properties within\n *   an `@supports` block.\n */\nexport function protectSupportsPlugin(): Plugin {\n\treturn {\n\t\tOnce(root: Root) {\n\t\t\troot.walkDecls((decl: Declaration) => {\n\t\t\t\tif (!decl.prop.startsWith(MARKER) && isInsideSupports(decl)) {\n\t\t\t\t\tdecl.prop = `${MARKER}${decl.prop}`;\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t\tpostcssPlugin: \"postcss-protect-supports\",\n\t};\n}\n\n/**\n * Checks if a PostCSS node is nested within a `@supports` at-rule.\n *\n * @param node The PostCSS node to verify.\n * @returns True if the node is inside a `@supports` rule, false otherwise.\n */\nfunction isInsideSupports(node: Declaration): boolean {\n\tlet parent:\n\t\t| Declaration[\"parent\"]\n\t\t| NonNullable<Declaration[\"parent\"]>[\"parent\"] = node.parent;\n\twhile (parent) {\n\t\tif (parent.type === \"atrule\" && parent.name === \"supports\") {\n\t\t\treturn true;\n\t\t}\n\t\tparent = parent.parent;\n\t}\n\treturn false;\n}\nprotectSupportsPlugin.postcss = true;\n\n/**\n * PostCSS plugin that restores the original property names of protected CSS\n * properties.\n *\n * @returns A PostCSS plugin object that restores the original property names of\n *   the rules within an `@supports` block.\n */\nexport function restoreSupportsPlugin(): Plugin {\n\treturn {\n\t\tOnceExit(root: Root) {\n\t\t\troot.walkDecls((decl: Declaration) => {\n\t\t\t\tif (decl.prop.startsWith(MARKER)) {\n\t\t\t\t\tdecl.prop = decl.prop.slice(MARKER.length);\n\t\t\t\t}\n\t\t\t});\n\t\t},\n\t\tpostcssPlugin: \"postcss-restore-supports\",\n\t};\n}\nrestoreSupportsPlugin.postcss = true;\n"]}

package/dist/esm/prefixPatcher.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fixes an issue where the sass-loader removes the space between the tailwind
+ * import and a prefix.
+ *
+ * @param source The source code
+ * @returns The adjusted source.
+ */
+export default function (source: any): any;
+//# sourceMappingURL=prefixPatcher.d.ts.map

package/dist/esm/prefixPatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefixPatcher.d.ts","sourceRoot":"","sources":["../../src/prefixPatcher.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,WAAW,MAAM,KAAA,OAE9B"}

package/dist/esm/prefixPatcher.js

@@ -0,0 +1,11 @@
+/**
+ * Fixes an issue where the sass-loader removes the space between the tailwind
+ * import and a prefix.
+ *
+ * @param source The source code
+ * @returns The adjusted source.
+ */
+export default function (source) {
+    return source.replace(/(\S)(prefix\(\w+\))/g, "$1 $2");
+}
+//# sourceMappingURL=prefixPatcher.js.map

package/dist/esm/prefixPatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefixPatcher.js","sourceRoot":"","sources":["../../src/prefixPatcher.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,WAAW,MAAM;IAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC","sourcesContent":["/**\n * Fixes an issue where the sass-loader removes the space between the tailwind\n * import and a prefix.\n *\n * @param source The source code\n * @returns The adjusted source.\n */\nexport default function (source) {\n\treturn source.replace(/(\\S)(prefix\\(\\w+\\))/g, \"$1 $2\");\n}\n"]}

package/dist/esm/types.d.ts

@@ -0,0 +1,20 @@
+import type { RuleSetRule, Configuration as WebpackConfiguration, WebpackPluginInstance } from "webpack";
+export type GetConfigOptions = GetPluginsOptions & GetRulesOptions & {
+    additionalExtensions?: string[];
+    aliases?: Record<string, string>;
+    devtool?: WebpackConfiguration["devtool"];
+    outputPath?: string;
+};
+export type GetPluginsOptions = OutputOptions & {
+    additionalPlugins?: WebpackPluginInstance[];
+};
+export type GetRulesOptions = {
+    additionalRules?: RuleSetRule[];
+    excludedRules?: RegExp[];
+};
+export type OutputOptions = {
+    optimize?: boolean;
+    useHash?: boolean;
+    usePostfix?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,aAAa,IAAI,oBAAoB,EACrC,qBAAqB,EACrB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAC/C,eAAe,GAAG;IACjB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG;IAC/C,iBAAiB,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC"}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tRuleSetRule,\n\tConfiguration as WebpackConfiguration,\n\tWebpackPluginInstance,\n} from \"webpack\";\n\nexport type GetConfigOptions = GetPluginsOptions &\n\tGetRulesOptions & {\n\t\tadditionalExtensions?: string[];\n\t\taliases?: Record<string, string>;\n\t\tdevtool?: WebpackConfiguration[\"devtool\"];\n\t\toutputPath?: string;\n\t};\n\nexport type GetPluginsOptions = OutputOptions & {\n\tadditionalPlugins?: WebpackPluginInstance[];\n};\n\nexport type GetRulesOptions = {\n\tadditionalRules?: RuleSetRule[];\n\texcludedRules?: RegExp[];\n};\n\nexport type OutputOptions = {\n\toptimize?: boolean;\n\tuseHash?: boolean;\n\tusePostfix?: boolean;\n};\n"]}

package/package.json

@@ -0,0 +1,85 @@
+{
+	"name": "@rootreeweb/rt-webpack-helper",
+	"version": "4.1.1",
+	"description": "JavaScript package for generating a standardized WebPack configuration for projects",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/rootreeweb/meta-tools.git"
+	},
+	"author": {
+		"name": "Rootree Web",
+		"email": "web@rootree.ca"
+	},
+	"sideEffects": false,
+	"type": "module",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/esm/index.d.ts",
+				"default": "./dist/esm/index.js"
+			}
+		}
+	},
+	"types": "./dist/esm/index.d.ts",
+	"files": [
+		"dist/**/*"
+	],
+	"scripts": {
+		"build": "yarn run clean && yarn run build:esm",
+		"build:esm": "tsgo -p ./configs/tsconfig.esm.json",
+		"check": "tsgo --noEmit",
+		"clean": "del-cli ./dist",
+		"format": "prettier . --cache --write",
+		"lint": "eslint --fix --cache",
+		"prepare": "husky",
+		"release": "yarn dlx -p @rootreeweb/rt-node-lib release ${0}",
+		"test": "vitest run --coverage",
+		"test:watch": "vitest --coverage --ui"
+	},
+	"dependencies": {
+		"@tailwindcss/postcss": "4.3.0",
+		"css-loader": "7.1.4",
+		"css-minimizer-webpack-plugin": "8.0.0",
+		"cssnano": "8.0.1",
+		"html-webpack-plugin": "5.6.7",
+		"mini-css-extract-plugin": "2.10.2",
+		"postcss": "8.5.15",
+		"postcss-loader": "8.2.1",
+		"postcss-media-minmax": "5.0.0",
+		"postcss-preset-env": "11.3.0",
+		"sass": "1.100.0",
+		"sass-loader": "17.0.0",
+		"tailwindcss": "^4.3.0",
+		"ts-loader": "9.5.7",
+		"webpack-dev-server": "^5.2.4",
+		"webpack-manifest-plugin": "6.0.1",
+		"webpack-remove-empty-scripts": "1.1.1"
+	},
+	"devDependencies": {
+		"@rootreeweb/fonts": "^1.0.37",
+		"@rootreeweb/linting": "4.2.1",
+		"@rootreeweb/rt-node-lib": "8.1.26",
+		"@rootreeweb/tsconfigs": "3.3.8",
+		"@types/node": "^25.9.1",
+		"@types/webpack-dev-server": "^4.7.2",
+		"@typescript/native-preview": "^7.0.0-dev.20260522.1",
+		"@vitest/coverage-v8": "^4.1.7",
+		"@vitest/ui": "^4.1.7",
+		"del-cli": "^7.0.0",
+		"eslint": "^10.4.0",
+		"husky": "^9.1.7",
+		"knip": "^6.14.2",
+		"lint-staged": "^17.0.5",
+		"memfs": "^4.57.2",
+		"prettier": "^3.8.3",
+		"stylelint": "^17.12.0",
+		"typescript": "^6.0.3",
+		"vitest": "^4.1.7",
+		"webpack": "^5.107.1",
+		"webpack-cli": "^7.0.2"
+	},
+	"peerDependencies": {
+		"webpack": "^5",
+		"webpack-cli": "^7"
+	}
+}