@purgeon/rolldown-plugin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-PRESENT Konstantin Kireyev <https://github.com/knst0>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -0,0 +1,16 @@
+import { AnalyzerPlugin } from "@purgeon/core";
+import { Plugin } from "rolldown";
+//#region src/index.d.ts
+type PurgeonPluginResult = Plugin & {
+  enforce?: "pre" | "post";
+};
+declare function purgeon(options?: PluginOptions): PurgeonPluginResult;
+interface PluginOptions {
+  plugins?: AnalyzerPlugin[];
+  debug?: boolean | {
+    outFile: string;
+  };
+}
+//#endregion
+export { PluginOptions, purgeon };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;KAOK,sBAAsB;EAAmB;;iBAE9B,QAAQ,UAAS,gBAAqB;UAmIrC;EACf,UAAU;EACV;IAAoB"}

package/dist/index.mjs

@@ -0,0 +1,101 @@
+import { writeFileSync } from "node:fs";
+import { toCssPurgeIR } from "@purgeon/analyzer-css";
+import { toJsxPurgeIR } from "@purgeon/analyzer-jsx";
+import { extractUsedClasses, extractUsedVars, isAnalyzer, purgeUnusedCss } from "@purgeon/core";
+//#region src/index.ts
+function purgeon(options = {}) {
+	const wrappers = (options.plugins ?? []).filter((p) => isAnalyzer(p)).map((p) => ({
+		plugin: p.toRolldownPlugin(),
+		getGraph: () => p.getGraph()
+	}));
+	const outFile = resolveDebugOutFile(options.debug);
+	let usage = null;
+	return {
+		name: "purgeon",
+		enforce: "pre",
+		transform(code, id) {
+			for (const wrapper of wrappers) try {
+				wrapper.plugin.transform.call(this, code, id);
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				this.warn(`[${wrapper.plugin.name}] failed to analyze ${id}: ${message}`);
+			}
+			return null;
+		},
+		moduleParsed(moduleInfo) {
+			for (const wrapper of wrappers) wrapper.plugin.moduleParsed.call(this, moduleInfo);
+		},
+		generateBundle(options, bundle) {
+			for (const wrapper of wrappers) wrapper.plugin.generateBundle.call(this, options, bundle);
+			usage = reportUsage(wrappers, this);
+			if (usage) purgeBundle(bundle, usage.usedClasses, usage.usedVars);
+		},
+		writeBundle() {
+			if (!outFile) return;
+			const graphs = {};
+			for (const wrapper of wrappers) graphs[wrapper.plugin.name] = wrapper.getGraph().toObject();
+			if (usage) {
+				graphs.usedClasses = usage.classes;
+				graphs.usedVars = usage.vars;
+			}
+			try {
+				writeFileSync(outFile, JSON.stringify(graphs, null, 2), "utf-8");
+				this.info(`Wrote debug output to ${outFile}`);
+			} catch (error) {
+				this.warn(`Failed to write debug output to ${outFile}: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		}
+	};
+}
+function summarize(used, total) {
+	const unused = [...total].filter((name) => !used.has(name));
+	return {
+		used: [...used],
+		unused,
+		total: total.size,
+		usedCount: used.size,
+		unusedCount: unused.length
+	};
+}
+function reportUsage(wrappers, ctx) {
+	const jsxWrapper = wrappers.find((w) => w.plugin.name === "jsx-graph");
+	const cssWrapper = wrappers.find((w) => w.plugin.name === "css-graph");
+	if (!jsxWrapper || !cssWrapper) return null;
+	const jsxNodes = [...jsxWrapper.getGraph().values()].map((n) => toJsxPurgeIR(n));
+	const cssRules = [...cssWrapper.getGraph().values()].flatMap((node) => toCssPurgeIR(node.rules));
+	const cssClasses = /* @__PURE__ */ new Set();
+	for (const rule of cssRules) for (const className of rule.classes) cssClasses.add(className);
+	const usedClasses = extractUsedClasses(jsxNodes, cssClasses);
+	const classes = summarize(usedClasses, cssClasses);
+	const allVars = /* @__PURE__ */ new Set();
+	for (const rule of cssRules) {
+		for (const varName of rule.declaredVars) allVars.add(varName);
+		for (const varName of rule.referencedVars) allVars.add(varName);
+	}
+	const usedVars = extractUsedVars(cssRules, usedClasses);
+	const vars = summarize(usedVars, allVars);
+	ctx.info(`[purgeon] CSS classes: ${classes.usedCount} used, ${classes.unusedCount} unused (of ${classes.total} total)`);
+	ctx.info(`[purgeon] CSS vars: ${vars.usedCount} used, ${vars.unusedCount} unused (of ${vars.total} total)`);
+	return {
+		classes,
+		vars,
+		usedClasses,
+		usedVars
+	};
+}
+function purgeBundle(bundle, usedClasses, usedVars) {
+	for (const fileName in bundle) {
+		const output = bundle[fileName];
+		if (output.type !== "asset" || !fileName.endsWith(".css")) continue;
+		output.source = purgeUnusedCss(typeof output.source === "string" ? output.source : Buffer.from(output.source).toString("utf-8"), fileName, usedClasses, usedVars);
+	}
+}
+function resolveDebugOutFile(debug) {
+	if (!debug) return null;
+	if (typeof debug === "object") return debug.outFile;
+	return "graph.json";
+}
+//#endregion
+export { purgeon };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { writeFileSync } from \"node:fs\";\n\nimport { toCssPurgeIR, type CssGraphNode } from \"@purgeon/analyzer-css\";\nimport { toJsxPurgeIR, type JsxGraphNode } from \"@purgeon/analyzer-jsx\";\nimport { extractUsedClasses, extractUsedVars, isAnalyzer, purgeUnusedCss, type AnalyzerPlugin, type OutputBundle } from \"@purgeon/core\";\nimport type { Plugin as RolldownPlugin } from \"rolldown\";\n\ntype PurgeonPluginResult = RolldownPlugin & { enforce?: \"pre\" | \"post\" };\n\nexport function purgeon(options: PluginOptions = {}): PurgeonPluginResult {\n  const wrappers = (options.plugins ?? [])\n    .filter((p) => isAnalyzer(p))\n    .map((p) => ({ plugin: p.toRolldownPlugin(), getGraph: () => p.getGraph() }));\n  const outFile = resolveDebugOutFile(options.debug);\n  let usage: UsageReport | null = null;\n\n  return {\n    name: \"purgeon\",\n    enforce: \"pre\",\n\n    transform(code, id) {\n      for (const wrapper of wrappers) {\n        try {\n          wrapper.plugin.transform.call(this as any, code, id);\n        } catch (error) {\n          const message = error instanceof Error ? error.message : String(error);\n          this.warn(`[${wrapper.plugin.name}] failed to analyze ${id}: ${message}`);\n        }\n      }\n      return null;\n    },\n\n    moduleParsed(moduleInfo) {\n      for (const wrapper of wrappers) {\n        wrapper.plugin.moduleParsed.call(this, moduleInfo);\n      }\n    },\n\n    generateBundle(options, bundle) {\n      for (const wrapper of wrappers) {\n        wrapper.plugin.generateBundle.call(this as any, options, bundle as any);\n      }\n\n      usage = reportUsage(wrappers, this);\n      if (usage) purgeBundle(bundle as unknown as OutputBundle, usage.usedClasses, usage.usedVars);\n    },\n\n    writeBundle() {\n      if (!outFile) return;\n\n      const graphs: Record<string, unknown> = {};\n      for (const wrapper of wrappers) {\n        graphs[wrapper.plugin.name] = wrapper.getGraph().toObject();\n      }\n      if (usage) {\n        graphs.usedClasses = usage.classes;\n        graphs.usedVars = usage.vars;\n      }\n\n      try {\n        writeFileSync(outFile, JSON.stringify(graphs, null, 2), \"utf-8\");\n        this.info(`Wrote debug output to ${outFile}`);\n      } catch (error) {\n        this.warn(`Failed to write debug output to ${outFile}: ${error instanceof Error ? error.message : String(error)}`);\n      }\n    },\n  };\n}\n\ninterface UsageSummary {\n  used: string[];\n  unused: string[];\n  total: number;\n  usedCount: number;\n  unusedCount: number;\n}\n\nfunction summarize(used: Set<string>, total: Set<string>): UsageSummary {\n  const unused = [...total].filter((name) => !used.has(name));\n  return { used: [...used], unused, total: total.size, usedCount: used.size, unusedCount: unused.length };\n}\n\ninterface UsageReport {\n  classes: UsageSummary;\n  vars: UsageSummary;\n  usedClasses: Set<string>;\n  usedVars: Set<string>;\n}\n\ninterface AnalyzerWrapper {\n  plugin: ReturnType<AnalyzerPlugin[\"toRolldownPlugin\"]>;\n  getGraph: () => ReturnType<AnalyzerPlugin[\"getGraph\"]>;\n}\n\nfunction reportUsage(wrappers: AnalyzerWrapper[], ctx: { info(msg: string): void }): UsageReport | null {\n  const jsxWrapper = wrappers.find((w) => w.plugin.name === \"jsx-graph\");\n  const cssWrapper = wrappers.find((w) => w.plugin.name === \"css-graph\");\n  if (!jsxWrapper || !cssWrapper) return null;\n\n  const jsxNodes = [...jsxWrapper.getGraph().values()].map((n) => toJsxPurgeIR(n as JsxGraphNode));\n  const cssRules = [...cssWrapper.getGraph().values()].flatMap((node) => toCssPurgeIR((node as CssGraphNode).rules));\n\n  const cssClasses = new Set<string>();\n  for (const rule of cssRules) {\n    for (const className of rule.classes) cssClasses.add(className);\n  }\n\n  const usedClasses = extractUsedClasses(jsxNodes, cssClasses);\n  const classes = summarize(usedClasses, cssClasses);\n\n  const allVars = new Set<string>();\n  for (const rule of cssRules) {\n    for (const varName of rule.declaredVars) allVars.add(varName);\n    for (const varName of rule.referencedVars) allVars.add(varName);\n  }\n  const usedVars = extractUsedVars(cssRules, usedClasses);\n  const vars = summarize(usedVars, allVars);\n\n  ctx.info(`[purgeon] CSS classes: ${classes.usedCount} used, ${classes.unusedCount} unused (of ${classes.total} total)`);\n  ctx.info(`[purgeon] CSS vars: ${vars.usedCount} used, ${vars.unusedCount} unused (of ${vars.total} total)`);\n\n  return { classes, vars, usedClasses, usedVars };\n}\n\nfunction purgeBundle(bundle: OutputBundle, usedClasses: Set<string>, usedVars: Set<string>): void {\n  for (const fileName in bundle) {\n    const output = bundle[fileName]!;\n    if (output.type !== \"asset\" || !fileName.endsWith(\".css\")) continue;\n\n    const source = typeof output.source === \"string\" ? output.source : Buffer.from(output.source).toString(\"utf-8\");\n    output.source = purgeUnusedCss(source, fileName, usedClasses, usedVars);\n  }\n}\n\nfunction resolveDebugOutFile(debug?: boolean | { outFile: string }): string | null {\n  if (!debug) return null;\n  if (typeof debug === \"object\") return debug.outFile;\n  return \"graph.json\";\n}\n\nexport interface PluginOptions {\n  plugins?: AnalyzerPlugin[];\n  debug?: boolean | { outFile: string };\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@purgeon/rolldown-plugin",
+  "version": "0.1.0",
+  "description": "Rolldown/Vite plugin that cross-references JSX usage against CSS graphs and purges unused rules from emitted CSS",
+  "keywords": [
+    "css",
+    "purge",
+    "rolldown-plugin",
+    "tree-shaking",
+    "vite-plugin"
+  ],
+  "license": "MIT",
+  "author": "Konstantin Kireyev <https://github.com/knst0>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/knst0/purgeon.git",
+    "directory": "packages/rolldown-plugin"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@purgeon/analyzer-css": "0.1.0",
+    "@purgeon/core": "0.1.0",
+    "@purgeon/analyzer-jsx": "0.1.0"
+  },
+  "devDependencies": {
+    "rolldown": "^1.1.4"
+  },
+  "peerDependencies": {
+    "rolldown": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
+}