@gustcss/postcss 0.9.2 → 0.10.0

package/README.md

@@ -70,6 +70,12 @@ Create `gustcss.config.json` in your project root:
 }
 ```
 
+### Class-Name Mangling
+
+The PostCSS plugin does not support `mangleClassNames` because PostCSS cannot rewrite HTML and JavaScript references to match shortened CSS selectors.
+
+The plugin explicitly disables config-based mangling. Use `@gustcss/vite` for synchronized production CSS and source transformation.
+
 ## How It Works
 
 1. The plugin scans files specified in the `content` array

package/dist/index.cjs

@@ -61,6 +61,24 @@ var require_runner = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		return null;
 	}
 	/**
+	* Report whether a resolved gustcss.config.json turns on class-name mangling.
+	*
+	* Callers that cannot rewrite source (dev server, PostCSS) use this to decide
+	* whether they must pass `--mangle-class-names=false`. Only passing the flag
+	* when needed keeps older CLI binaries that predate the flag working.
+	*
+	* @param {{ configPath: string|null, fs?: { readFileSync: Function } }} options
+	* @returns {boolean}
+	*/
+	function configEnablesMangling({ configPath, fs = require("fs") }) {
+		if (!configPath) return false;
+		try {
+			return JSON.parse(fs.readFileSync(configPath, "utf-8"))?.mangleClassNames === true;
+		} catch {
+			return false;
+		}
+	}
+	/**
 	* Write a temporary config file ({ content }) at <cwd>/<prefix>.<random8hex>.tmp.json,
 	* invoke `fn` with the temp file path, and always clean the file up afterwards.
 	*
@@ -92,21 +110,28 @@ var require_runner = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	* @param {string} [options.output]         output path (required for 'output' mode)
 	* @param {boolean} [options.cssLayers]     append --css-layers when truthy
 	* @param {boolean} [options.watch]         append --watch when truthy
+	* @param {boolean} [options.mangleClassNames] explicitly enable or disable mangling
+	* @param {string} [options.mangleMap]      class-name manifest output path
+	* @param {string[]} [options.mangleExclude] class names to preserve
 	* @param {string|null} [options.configPath] append --config <path> when present
 	* @returns {string[]}
 	*/
-	function buildArgs({ mode, output, cssLayers, configPath, watch }) {
+	function buildArgs({ mode, output, cssLayers, configPath, watch, mangleClassNames, mangleMap, mangleExclude }) {
 		const args = ["build"];
 		if (watch) args.push("--watch");
 		if (mode === "stdout") args.push("--stdout");
 		else args.push("-o", output);
 		if (cssLayers) args.push("--css-layers");
+		if (mangleClassNames !== void 0) args.push(`--mangle-class-names=${mangleClassNames}`);
+		if (mangleMap) args.push("--mangle-map", mangleMap);
+		if (mangleExclude?.length) args.push("--mangle-exclude", mangleExclude.join(","));
 		if (configPath) args.push("--config", configPath);
 		return args;
 	}
 	module.exports = {
 		resolveBinary,
 		resolveConfig,
+		configEnablesMangling,
 		withTempConfig,
 		buildArgs
 	};
@@ -158,7 +183,8 @@ const plugin = (opts = {}) => {
 				const args = runner.buildArgs({
 					mode: "stdout",
 					cssLayers: outputToCssLayers,
-					configPath: cfgPath
+					configPath: cfgPath,
+					mangleClassNames: runner.configEnablesMangling({ configPath: cfgPath }) ? false : void 0
 				});
 				try {
 					const spawnResult = childProcess.spawnSync(binaryPath, args, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gustcss/postcss",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "PostCSS plugin for GustCSS",
   "main": "dist/index.cjs",
   "types": "dist/index.d.cts",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "gustcss": "^0.9.2"
+    "gustcss": "^0.10.0"
   },
   "peerDependencies": {
     "postcss": "^8.0.0"