Rename undocumented opts.used to opts.prune

lauriro · lauriro · commit a4ca02e924ad · 2026-04-10T01:56:48.000+03:00
diff --git a/README.md b/README.md
@@ -53,11 +53,22 @@ xhr.send();
 // Minify CSS
 import { CSS } from "@litejs/dom/css.js";
 const sheet = new CSSStyleSheet()
-sheet.replaceSync(".a { color: hsl(0 0% 100%) }")
-console.log(CSS.minify(sheet, { color: true }))
-// .a{color:#fff}
+sheet.replaceSync(":root{--gap:10px} .a { color: hsl(0 0% 100%); top: calc(var(--gap) + 5px) }")
+console.log(CSS.minify(sheet, { var: true, calc: true, color: true }))
+// .a{color:#fff;top:15px}
 ```
 
+### CSS.minify options
+
+- **calc** &ndash; resolve static `calc()` expressions, e.g. `calc(10px + 5px)` &rarr; `15px`
+- **color** &ndash; shorten `rgb()`/`hsl()` to hex, e.g. `rgb(255,0,0)` &rarr; `#f00`
+- **import** &ndash; inline `@import` rules, rewriting relative URLs
+- **prefix** &ndash; add vendor prefixes, e.g. `{ "mask-image": ["-webkit-"] }`
+- **prune** &ndash; remove unused selectors `{ keep: Set, keepRe: RegExp }`
+- **root** &ndash; base directory for resolving `@import` paths
+- **url** &ndash; URL rewrite callback `(path) => newPath`
+- **var** &ndash; inline CSS custom properties from `:root`
+
 ## Contributing
 
 Follow [Coding Style Guide](https://github.com/litejs/litejs/wiki/Style-Guide),
diff --git a/css.js b/css.js
@@ -40,8 +40,8 @@ var URL = global.URL || require("url").URL
 				return CSS.minify(imported, opts)
 			}
 
-			if (opts && opts.used && sel) {
-				sel = filterSelectors(sel, opts.used)
+			if (opts && opts.prune && sel) {
+				sel = filterSelectors(sel, opts.prune)
 				if (!sel) return ""
 			}
 
@@ -66,11 +66,11 @@ var URL = global.URL || require("url").URL
 	}
 }
 , filterSelectors = (text, used) => {
-	var classes = used.classes
-	, keep = used.keep
+	var keep = used.keep
+	, keepRe = used.keepRe
 	return require("./selector.js").selectorSplit(text).filter(sel => {
 		for (var m, classRe = /\.([-\w]+)/g; (m = classRe.exec(sel)); ) {
-			if (!(classes && classes.has(m[1]) || keep && keep.test(m[1]))) return false
+			if (!(keep && keep.has(m[1]) || keepRe && keepRe.test(m[1]))) return false
 		}
 		return true
 	}).join(",")
diff --git a/test/css.js b/test/css.js
@@ -109,7 +109,7 @@ describe("css.js {0}", describe.env === "browser" ?
 			var DOMParser = DOM.DOMParser
 			, doc = new DOMParser().parseFromString("<html><head><style>.unused{color:red}</style></head><body></body></html>")
 			assert
-			.equal(doc.toString({ css: { used: { classes: new Set(["btn"]) } } }), "<html><head></head><body></body></html>")
+			.equal(doc.toString({ css: { prune: { keep: new Set(["btn"]) } } }), "<html><head></head><body></body></html>")
 			.end()
 		})
 
@@ -194,26 +194,26 @@ describe("css.js {0}", describe.env === "browser" ?
 				assert.equal(minify(sheet, opts), expected).end()
 			})
 
-			test("used {i} '{1}'", [
-				[ { used: { classes: new Set(["btn"]) } },
+			test("prune {i} '{1}'", [
+				[ { prune: { keep: new Set(["btn"]) } },
 					".btn{color:red}.nav{top:1}",
 					".btn{color:red}" ],
-				[ { used: { classes: new Set(["btn"]) } },
+				[ { prune: { keep: new Set(["btn"]) } },
 					".btn,.nav{color:red}",
 					".btn{color:red}" ],
-				[ { used: { classes: new Set(["btn", "nav"]) } },
+				[ { prune: { keep: new Set(["btn", "nav"]) } },
 					".btn .nav{color:red}.unused{top:1}",
 					".btn .nav{color:red}" ],
-				[ { used: { classes: new Set(["btn"]) } },
+				[ { prune: { keep: new Set(["btn"]) } },
 					".btn .nav{color:red}",
 					"" ],
-				[ { used: { keep: /^is-/ } },
+				[ { prune: { keepRe: /^is-/ } },
 					".is-active{color:red}.btn{top:1}",
 					".is-active{color:red}" ],
-				[ { used: { classes: new Set(["btn"]), keep: /^icon-/ } },
+				[ { prune: { keep: new Set(["btn"]), keepRe: /^icon-/ } },
 					".btn{color:red}.icon-star{top:1}.unused{left:0}",
 					".btn{color:red}\n.icon-star{top:1}" ],
-				[ { used: { classes: new Set(["btn"]) } },
+				[ { prune: { keep: new Set(["btn"]) } },
 					"body{margin:0}.btn{color:red}",
 					"body{margin:0}\n.btn{color:red}" ],
 			], (opts, text, expected, assert) => {
diff --git a/test/readme.out.ok b/test/readme.out.ok
@@ -1,4 +1,4 @@
 <h1 id="123" class="large"><b>hello world</b></h1>
 <h1 id=123 class=large><b>hello world</b></h1>
-.a{color:#fff}
+.a{color:#fff;top:15px}
 LiteJS

Original file line number	Diff line number	Diff line change
`@@ -40,8 +40,8 @@ var URL = global.URL \|\| require("url").URL`
`40`	`40`	`return CSS.minify(imported, opts)`
`41`	`41`	`}`
`42`	`42`
`43`		`- if (opts && opts.used && sel) {`
`44`		`- sel = filterSelectors(sel, opts.used)`
	`43`	`+ if (opts && opts.prune && sel) {`
	`44`	`+ sel = filterSelectors(sel, opts.prune)`
`45`	`45`	`if (!sel) return ""`
`46`	`46`	`}`
`47`	`47`
`@@ -66,11 +66,11 @@ var URL = global.URL \|\| require("url").URL`
`66`	`66`	`}`
`67`	`67`	`}`
`68`	`68`	`, filterSelectors = (text, used) => {`
`69`		`- var classes = used.classes`
`70`		`- , keep = used.keep`
	`69`	`+ var keep = used.keep`
	`70`	`+ , keepRe = used.keepRe`
`71`	`71`	`return require("./selector.js").selectorSplit(text).filter(sel => {`
`72`	`72`	`for (var m, classRe = /\.([-\w]+)/g; (m = classRe.exec(sel)); ) {`
`73`		`- if (!(classes && classes.has(m[1]) \|\| keep && keep.test(m[1]))) return false`
	`73`	`+ if (!(keep && keep.has(m[1]) \|\| keepRe && keepRe.test(m[1]))) return false`
`74`	`74`	`}`
`75`	`75`	`return true`
`76`	`76`	`}).join(",")`