@projectwallace/css-analyzer 9.5.0 → 9.6.2

package/dist/property-utils-B3n9KkA9.js

@@ -0,0 +1,107 @@
+import { t as KeywordSet } from "./keyword-set-qSyAMR9o.js";
+import { is_custom, is_vendor_prefixed } from "@projectwallace/css-parser";
+//#region src/properties/property-utils.ts
+const shorthand_properties = new Set([
+	"all",
+	"animation",
+	"background",
+	"border",
+	"border-block-end",
+	"border-block-start",
+	"border-bottom",
+	"border-color",
+	"border-image",
+	"border-inline-end",
+	"border-inline-start",
+	"border-left",
+	"border-radius",
+	"border-right",
+	"border-style",
+	"border-top",
+	"border-width",
+	"column-rule",
+	"columns",
+	"contain-intrinsic-size",
+	"flex",
+	"flex-flow",
+	"font",
+	"gap",
+	"grid",
+	"grid-area",
+	"grid-column",
+	"grid-row",
+	"grid-template",
+	"inset",
+	"list-style",
+	"margin",
+	"mask",
+	"offset",
+	"outline",
+	"overflow",
+	"padding",
+	"place-content",
+	"place-items",
+	"place-self",
+	"scroll-margin",
+	"scroll-padding",
+	"scroll-timeline",
+	"text-decoration",
+	"text-emphasis",
+	"transition",
+	"vertical-align"
+]);
+const SPACING_RESET_PROPERTIES = new Set([
+	"margin",
+	"margin-block",
+	"margin-inline",
+	"margin-top",
+	"margin-block-start",
+	"margin-block-end",
+	"margin-inline-end",
+	"margin-inline-end",
+	"margin-right",
+	"margin-bottom",
+	"margin-left",
+	"padding",
+	"padding-block",
+	"padding-inline",
+	"padding-top",
+	"padding-right",
+	"padding-bottom",
+	"padding-left",
+	"padding-block-start",
+	"padding-block-end",
+	"padding-inline-start",
+	"padding-inline-end"
+]);
+const border_radius_properties = new KeywordSet([
+	"border-radius",
+	"border-top-left-radius",
+	"border-top-right-radius",
+	"border-bottom-right-radius",
+	"border-bottom-left-radius",
+	"border-start-start-radius",
+	"border-start-end-radius",
+	"border-end-end-radius",
+	"border-end-start-radius"
+]);
+/**
+* @see https://github.com/csstree/csstree/blob/master/lib/utils/names.js#L69
+*/
+function isHack(property) {
+	if (is_custom(property) || is_vendor_prefixed(property)) return false;
+	let code = property.charCodeAt(0);
+	return code === 47 || code === 42 || code === 95 || code === 43 || code === 38 || code === 36 || code === 35;
+}
+/**
+* Get the normalized basename for a property with a vendor prefix
+* @returns The property name without vendor prefix
+*/
+function basename(property) {
+	if (is_custom(property)) return property;
+	if (is_vendor_prefixed(property)) return property.slice(property.indexOf("-", 2) + 1).toLowerCase();
+	if (isHack(property)) return property.slice(1).toLowerCase();
+	return property.toLowerCase();
+}
+//#endregion
+export { shorthand_properties as a, isHack as i, basename as n, border_radius_properties as r, SPACING_RESET_PROPERTIES as t };

package/dist/property-utils-MKX6iGvg.d.ts

@@ -0,0 +1,17 @@
+import { t as KeywordSet } from "./keyword-set-BXSoLQ6m.js";
+
+//#region src/properties/property-utils.d.ts
+declare const shorthand_properties: Set<string>;
+declare const SPACING_RESET_PROPERTIES: Set<string>;
+declare const border_radius_properties: KeywordSet;
+/**
+ * @see https://github.com/csstree/csstree/blob/master/lib/utils/names.js#L69
+ */
+declare function isHack(property: string): boolean;
+/**
+ * Get the normalized basename for a property with a vendor prefix
+ * @returns The property name without vendor prefix
+ */
+declare function basename(property: string): string;
+//#endregion
+export { shorthand_properties as a, isHack as i, basename as n, border_radius_properties as r, SPACING_RESET_PROPERTIES as t };

package/dist/selectors/index.d.ts

@@ -1,2 +1,2 @@
-import { a as calculate, i as isPrefixed, n as getComplexity, o as calculateForAST, r as isAccessibility, s as compare, t as getCombinators } from "../utils-BUeYqEL1.js";
+import { a as calculate, i as isPrefixed, n as getComplexity, o as calculateForAST, r as isAccessibility, s as compare, t as getCombinators } from "../utils-yIUD7vGy.js";
 export { compare as compareSpecificity, getCombinators, getComplexity, calculate as getSpecificity, calculateForAST as getSpecificityForAST, isAccessibility, isPrefixed };

package/dist/selectors/index.js

@@ -1,3 +1,2 @@
-import "../string-utils-olNNcOlY.js";
-import { a as getComplexity, i as getCombinators, n as calculateForAST, o as isAccessibility, r as compare, s as isPrefixed, t as calculate } from "../specificity-svLpcKkT.js";
+import { a as getComplexity, i as getCombinators, n as calculateForAST, o as isAccessibility, r as compare, s as isPrefixed, t as calculate } from "../specificity-DKo9lvB5.js";
 export { compare as compareSpecificity, getCombinators, getComplexity, calculate as getSpecificity, calculateForAST as getSpecificityForAST, isAccessibility, isPrefixed };

package/dist/{specificity-svLpcKkT.js → specificity-DKo9lvB5.js}

@@ -1,5 +1,6 @@
-import { n as unquote, r as KeywordSet } from "./string-utils-olNNcOlY.js";
-import { ATTRIBUTE_SELECTOR, CLASS_SELECTOR, COMBINATOR, ID_SELECTOR, NTH_OF_SELECTOR, NTH_SELECTOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SELECTOR, SELECTOR_LIST, SKIP, TYPE_SELECTOR, str_equals, str_starts_with, walk } from "@projectwallace/css-parser";
+import { t as KeywordSet } from "./keyword-set-qSyAMR9o.js";
+import { n as unquote } from "./string-utils-C97yyuqE.js";
+import { ATTRIBUTE_SELECTOR, CLASS_SELECTOR, ID_SELECTOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SKIP, TYPE_SELECTOR, is_attribute_selector, is_combinator, is_nth_of_selector, is_nth_selector, is_pseudo_class_selector, is_pseudo_element_selector, is_selector, is_selector_list, is_type_selector, str_equals, str_starts_with, walk } from "@projectwallace/css-parser";
 import { parse_selector } from "@projectwallace/css-parser/parse-selector";
 //#region src/selectors/utils.ts
 const PSEUDO_FUNCTIONS = new KeywordSet([
@@ -15,12 +16,12 @@ const PSEUDO_FUNCTIONS = new KeywordSet([
 ]);
 function isPrefixed(selector, on_selector) {
 	walk(selector, function(node) {
-		if (node.type === PSEUDO_ELEMENT_SELECTOR || node.type === PSEUDO_CLASS_SELECTOR || node.type === TYPE_SELECTOR) {
+		if (is_pseudo_element_selector(node) || is_pseudo_class_selector(node) || is_type_selector(node)) {
 			if (node.is_vendor_prefixed) {
 				let prefix = "";
-				if (node.type === PSEUDO_CLASS_SELECTOR) prefix = ":";
-				else if (node.type === PSEUDO_ELEMENT_SELECTOR) prefix = "::";
-				on_selector(prefix + (node.name || node.text));
+				if (is_pseudo_class_selector(node)) prefix = ":";
+				else if (is_pseudo_element_selector(node)) prefix = "::";
+				on_selector(prefix + node.name);
 			}
 		}
 	});
@@ -35,7 +36,7 @@ function isAccessibility(selector, on_selector) {
 		return "[" + clone.name?.toLowerCase() + "]";
 	}
 	walk(selector, function(node) {
-		if (node.type === ATTRIBUTE_SELECTOR) {
+		if (is_attribute_selector(node)) {
 			const name = node.name || "";
 			if (str_equals("role", name) || str_starts_with(name, "aria-")) on_selector(normalize(node));
 		}
@@ -48,31 +49,31 @@ function isAccessibility(selector, on_selector) {
 */
 function getComplexity(selector) {
 	let complexity = 0;
-	function findSelectors(node, complexities) {
-		walk(node, function(n) {
-			if (n.type === SELECTOR) complexities.push(getComplexity(n));
+	function findSelectors(tree, complexities) {
+		walk(tree, function(node) {
+			if (is_selector(node)) complexities.push(getComplexity(node));
 		});
 	}
 	walk(selector, function(node) {
-		const type = node.type;
-		if (type === SELECTOR) return;
-		if (type === NTH_SELECTOR) {
-			if (node.text && node.text.trim()) complexity++;
+		node.type;
+		if (is_selector(node)) return;
+		if (is_nth_selector(node)) {
+			if (node.text.trim()) complexity++;
 			return;
 		}
 		complexity++;
-		if (type === PSEUDO_ELEMENT_SELECTOR || type === TYPE_SELECTOR || type === PSEUDO_CLASS_SELECTOR) {
+		if (is_pseudo_class_selector(node) || is_type_selector(node) || is_pseudo_element_selector(node)) {
 			if (node.is_vendor_prefixed) complexity++;
 		}
-		if (type === ATTRIBUTE_SELECTOR) {
+		if (is_attribute_selector(node)) {
 			if (node.value) complexity++;
 			return SKIP;
 		}
-		if (type === PSEUDO_CLASS_SELECTOR) {
-			const name = node.name || "";
+		if (is_pseudo_class_selector(node)) {
+			const name = node.name;
 			if (PSEUDO_FUNCTIONS.has(name.toLowerCase())) {
 				const childComplexities = [];
-				if (node.has_children) for (const child of node) if (child.type === SELECTOR) childComplexities.push(getComplexity(child));
+				if (node.has_children) for (const child of node) if (is_selector(child)) childComplexities.push(getComplexity(child));
 				else findSelectors(child, childComplexities);
 				if (childComplexities.length > 0) {
 					for (const c of childComplexities) complexity += c;
@@ -88,8 +89,8 @@ function getComplexity(selector) {
 */
 function getCombinators(selector, onMatch) {
 	walk(selector, function(node) {
-		if (node.type === COMBINATOR) onMatch({
-			name: node.name?.trim() === "" ? " " : node.name,
+		if (is_combinator(node)) onMatch({
+			name: node.name.trim() === "" ? " " : node.name,
 			loc: {
 				offset: node.start,
 				line: node.line,
@@ -129,7 +130,7 @@ const calculateForAST = (selectorAST) => {
 				b += 1;
 				break;
 			case PSEUDO_CLASS_SELECTOR:
-				switch (current.name?.toLowerCase()) {
+				switch (current.name.toLowerCase()) {
 					case "where": break;
 					case "-webkit-any":
 					case "any":
@@ -142,7 +143,7 @@ const calculateForAST = (selectorAST) => {
 					case "has":
 						if (current.has_children) {
 							const childSelectorList = current.first_child;
-							if (childSelectorList?.type === SELECTOR_LIST) {
+							if (is_selector_list(childSelectorList)) {
 								const max1 = max(calculate(childSelectorList));
 								a += max1[0];
 								b += max1[1];
@@ -154,7 +155,7 @@ const calculateForAST = (selectorAST) => {
 					case "nth-last-child":
 						b += 1;
 						const nthOf = current.first_child;
-						if (nthOf?.type === NTH_OF_SELECTOR && nthOf.selector) {
+						if (is_nth_of_selector(nthOf) && nthOf.selector) {
 							const max2 = max(calculate(nthOf.selector));
 							a += max2[0];
 							b += max2[1];
@@ -164,11 +165,11 @@ const calculateForAST = (selectorAST) => {
 					case "host-context":
 					case "host":
 						b += 1;
-						const childSelector = current.first_child?.first_child;
-						if (childSelector?.type === SELECTOR) {
+						const childSelector = current.first_child.first_child;
+						if (childSelector && is_selector(childSelector)) {
 							let childPart = childSelector.first_child;
 							while (childPart) {
-								if (childPart.type === COMBINATOR) break;
+								if (is_combinator(childPart)) break;
 								const partSpecificity = calculateForAST({
 									type_name: "Selector",
 									first_child: childPart,
@@ -193,14 +194,14 @@ const calculateForAST = (selectorAST) => {
 				}
 				break;
 			case PSEUDO_ELEMENT_SELECTOR:
-				switch (current.name?.toLowerCase()) {
+				switch (current.name.toLowerCase()) {
 					case "slotted":
 						c += 1;
-						const childSelector = current.first_child?.first_child;
-						if (childSelector?.type === SELECTOR) {
+						const childSelector = current.first_child.first_child;
+						if (is_selector(childSelector)) {
 							let childPart = childSelector.first_child;
 							while (childPart) {
-								if (childPart.type === COMBINATOR) break;
+								if (is_combinator(childPart)) break;
 								const partSpecificity = calculateForAST({
 									type_name: "Selector",
 									first_child: childPart,
@@ -248,20 +249,16 @@ const convertToAST = (source) => {
 		throw new TypeError(`Could not convert passed in source '${source}' to SelectorList: ${message}`);
 	}
 	if (source instanceof Object) {
-		if (source.type === SELECTOR_LIST) return source;
+		if (is_selector_list(source)) return source;
 		throw new TypeError(`Passed in source is an Object but no AST / AST of the type SelectorList`);
 	}
 	throw new TypeError(`Passed in source is not a String nor an Object. I don't know what to do with it.`);
 };
 const calculate = (selector) => {
 	if (!selector) return [];
-	const ast = convertToAST(selector);
+	const selector_list = convertToAST(selector);
 	const specificities = [];
-	let selectorNode = ast.first_child;
-	while (selectorNode) {
-		specificities.push(calculateForAST(selectorNode));
-		selectorNode = selectorNode.next_sibling;
-	}
+	for (const selector_node of selector_list) specificities.push(calculateForAST(selector_node));
 	return specificities;
 };
 //#endregion

package/dist/{string-utils-olNNcOlY.js → string-utils-C97yyuqE.js}

@@ -1,19 +1,4 @@
 import "@projectwallace/css-parser";
-//#region src/keyword-set.ts
-/**
-* @description A Set-like construct to search CSS keywords in a case-insensitive way
-*/
-var KeywordSet = class {
-	set;
-	constructor(items) {
-		/** @type {Set<string>} */
-		this.set = new Set(items);
-	}
-	has(item) {
-		return this.set.has(item.toLowerCase());
-	}
-};
-//#endregion
 //#region src/string-utils.ts
 function unquote(str) {
 	return str.replaceAll(/(?:^['"])|(?:['"]$)/g, "");
@@ -46,4 +31,4 @@ function endsWith(base, maybe) {
 	return true;
 }
 //#endregion
-export { unquote as n, KeywordSet as r, endsWith as t };
+export { unquote as n, endsWith as t };

package/dist/{utils-BUeYqEL1.d.ts → utils-yIUD7vGy.d.ts}

@@ -1,4 +1,4 @@
-import { CSSNode } from "@projectwallace/css-parser";
+import { CSSNode, Selector } from "@projectwallace/css-parser";
 
 //#region src/collection.d.ts
 type Location = {
@@ -25,7 +25,7 @@ type Specificity = [number, number, number];
  * @returns 0 if s1 equals s2, a negative number if s1 is lower than s2, or a positive number if s1 higher than s2
  */
 declare function compare(s1: Specificity, s2: Specificity): number;
-declare const calculateForAST: (selectorAST: CSSNode) => Specificity;
+declare const calculateForAST: (selectorAST: Selector) => Specificity;
 declare const calculate: (selector: string | CSSNode) => Specificity[];
 //#endregion
 //#region src/selectors/utils.d.ts

package/dist/values/index.d.ts

@@ -1,7 +1,29 @@
-import { a as namedColors, i as colorKeywords, n as keywords, o as systemColors, r as colorFunctions, t as isValueReset } from "../values-Dw53soqy.js";
-import { CSSNode } from "@projectwallace/css-parser";
+import { a as namedColors, i as colorKeywords, n as keywords, o as systemColors, r as colorFunctions, t as isValueReset } from "../values-DgD2lJqZ.js";
+import { Value } from "@projectwallace/css-parser";
 
 //#region src/values/browserhacks.d.ts
-declare function isIe9Hack(node: CSSNode): boolean;
+declare function isIe9Hack(node: Value): boolean;
 //#endregion
-export { colorFunctions, colorKeywords, isIe9Hack, isValueReset, keywords, namedColors, systemColors };
+//#region src/values/destructure-font-shorthand.d.ts
+/**
+ * Parse the CSS `font` shorthand value and extract its structural components.
+ *
+ * Grammar:
+ *   font: [<font-style> || <font-variant> || <font-weight> || <font-stretch>]?
+ *         <font-size>[/<line-height>]? <font-family>
+ *
+ * Does NOT handle system fonts (caption, icon, menu, …) — the caller should
+ * check SYSTEM_FONTS before calling this function.
+ *
+ * Returns null when the value is a single var() and can't be decomposed.
+ *
+ * @param value - The VALUE CSSNode for a `font` declaration
+ * @param cb    - Called for every global CSS keyword found in the value (e.g. inherit)
+ */
+declare function destructure(value: Value, cb: (keyword: string) => void): {
+  font_size?: string;
+  line_height?: string;
+  font_family?: string | null;
+} | null;
+//#endregion
+export { colorFunctions, colorKeywords, destructure as destructureFontShorthand, isIe9Hack, isValueReset, keywords, namedColors, systemColors };

package/dist/values/index.js

@@ -1,3 +1,2 @@
-import "../string-utils-olNNcOlY.js";
-import { a as colorKeywords, i as colorFunctions, n as isValueReset, o as namedColors, r as keywords, s as systemColors, t as isIe9Hack } from "../browserhacks-eP_e1D5u.js";
-export { colorFunctions, colorKeywords, isIe9Hack, isValueReset, keywords, namedColors, systemColors };
+import { a as keywords, c as namedColors, i as isValueReset, l as systemColors, o as colorFunctions, r as destructure, s as colorKeywords, t as isIe9Hack } from "../browserhacks-BtVwVqdU.js";
+export { colorFunctions, colorKeywords, destructure as destructureFontShorthand, isIe9Hack, isValueReset, keywords, namedColors, systemColors };

package/dist/values-DgD2lJqZ.d.ts

@@ -0,0 +1,17 @@
+import { t as KeywordSet } from "./keyword-set-BXSoLQ6m.js";
+import { Value } from "@projectwallace/css-parser";
+
+//#region src/values/colors.d.ts
+declare const namedColors: KeywordSet;
+declare const systemColors: KeywordSet;
+declare const colorFunctions: KeywordSet;
+declare const colorKeywords: KeywordSet;
+//#endregion
+//#region src/values/values.d.ts
+declare const keywords: KeywordSet;
+/**
+ * Test whether a value is a reset (0, 0px, -0.0e0 etc.)
+ */
+declare function isValueReset(value: Value): boolean;
+//#endregion
+export { namedColors as a, colorKeywords as i, keywords as n, systemColors as o, colorFunctions as r, isValueReset as t };

package/package.json

@@ -1,19 +1,36 @@
 {
 	"name": "@projectwallace/css-analyzer",
+	"version": "9.6.2",
 	"description": "The best CSS analyzer out there. Check design tokens, complexity, specificity, performance and more.",
-	"version": "9.5.0",
+	"keywords": [
+		"analytics",
+		"code",
+		"colors",
+		"css",
+		"designsystem",
+		"fonts",
+		"metrics",
+		"performance",
+		"projectwallace",
+		"quality",
+		"statistics",
+		"stats",
+		"styleguide",
+		"stylesheet",
+		"wallace"
+	],
+	"homepage": "https://github.com/projectwallace/css-analyzer",
+	"bugs": "https://github.com/projectwallace/css-analyzer/issues",
+	"license": "MIT",
 	"author": "Bart Veneman",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/projectwallace/css-analyzer.git"
 	},
-	"homepage": "https://github.com/projectwallace/css-analyzer",
-	"issues": "https://github.com/projectwallace/css-analyzer/issues",
-	"license": "MIT",
-	"type": "module",
 	"files": [
 		"dist"
 	],
+	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
 	"exports": {
@@ -32,48 +49,35 @@
 		"./values": {
 			"types": "./dist/values/index.d.ts",
 			"default": "./dist/values/index.js"
+		},
+		"./properties": {
+			"types": "./dist/properties/index.d.ts",
+			"default": "./dist/properties/index.js"
 		}
 	},
-	"engines": {
-		"node": ">=18.0.0"
-	},
 	"scripts": {
-		"lint": "oxlint --config .oxlintrc.json",
+		"lint": "oxlint --config .oxlintrc.json; oxfmt --check",
 		"lint-package": "publint",
 		"test": "vitest --coverage",
 		"check": "tsc --noEmit",
 		"build": "tsdown",
 		"knip": "knip"
 	},
-	"keywords": [
-		"projectwallace",
-		"wallace",
-		"css",
-		"stylesheet",
-		"stats",
-		"statistics",
-		"analytics",
-		"performance",
-		"styleguide",
-		"metrics",
-		"designsystem",
-		"fonts",
-		"colors",
-		"quality",
-		"code"
-	],
 	"dependencies": {
-		"@projectwallace/css-parser": "^0.13.8"
+		"@projectwallace/css-parser": "^0.14.8"
 	},
 	"devDependencies": {
 		"@codecov/rollup-plugin": "^1.9.1",
-		"@vitest/coverage-v8": "^4.0.18",
-		"knip": "^6.0.4",
-		"oxlint": "^1.43.0",
-		"prettier": "^3.6.2",
-		"publint": "^0.3.17",
-		"tsdown": "^0.21.0",
-		"typescript": "^5.9.3",
-		"vitest": "^4.0.18"
+		"@vitest/coverage-v8": "^4.1.2",
+		"knip": "^6.3.0",
+		"oxfmt": "^0.43.0",
+		"oxlint": "^1.58.0",
+		"publint": "^0.3.18",
+		"tsdown": "^0.21.7",
+		"typescript": "^6.0.2",
+		"vitest": "^4.1.2"
+	},
+	"engines": {
+		"node": ">=18.0.0"
 	}
 }