@projectwallace/css-analyzer 9.4.0 → 9.6.0

package/dist/index.js

@@ -1,595 +1,10 @@
-import { ATTRIBUTE_SELECTOR, AT_RULE, BLOCK, BREAK, CLASS_SELECTOR, COMBINATOR, CONTAINER_QUERY, DECLARATION, DIMENSION, FUNCTION, HASH, IDENTIFIER, ID_SELECTOR, LAYER_NAME, MEDIA_FEATURE, MEDIA_TYPE, NTH_OF_SELECTOR, NTH_SELECTOR, NUMBER, OPERATOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SELECTOR, SELECTOR_LIST, SKIP, STYLE_RULE, SUPPORTS_QUERY, TYPE_SELECTOR, URL, is_custom, is_vendor_prefixed, parse, str_equals, str_starts_with, walk } from "@projectwallace/css-parser";
-import { parse_selector } from "@projectwallace/css-parser/parse-selector";
-//#region src/atrules/atrules.ts
-/**
-* Check if an @supports atRule is a browserhack (Wallace parser version)
-* @param node - The Atrule CSSNode from Wallace parser
-*/
-function isSupportsBrowserhack(node, on_hack) {
-	walk(node, function(n) {
-		if (n.type === SUPPORTS_QUERY) {
-			const normalizedPrelude = (n.prelude || n.value || "").toString().toLowerCase().replaceAll(/\s+/g, "");
-			if (normalizedPrelude.includes("-webkit-appearance:none")) {
-				on_hack("-webkit-appearance: none");
-				return BREAK;
-			}
-			if (normalizedPrelude.includes("-moz-appearance:meterbar")) {
-				on_hack("-moz-appearance: meterbar");
-				return BREAK;
-			}
-		}
-	});
-}
-/**
-* Check if a @media atRule is a browserhack (Wallace parser version)
-* @param node - The Atrule CSSNode from Wallace parser
-* @returns true if the atrule is a browserhack
-*/
-function isMediaBrowserhack(node, on_hack) {
-	walk(node, function(n) {
-		if (n.type === MEDIA_TYPE) {
-			const text = n.text || "";
-			if (text.startsWith("\\0")) {
-				on_hack("\\0");
-				return BREAK;
-			}
-			if (text.includes("\\9")) {
-				on_hack("\\9");
-				return BREAK;
-			}
-		}
-		if (n.type === MEDIA_FEATURE) {
-			const name = n.property || "";
-			if (str_equals("-moz-images-in-menus", name)) {
-				on_hack("-moz-images-in-menus");
-				return BREAK;
-			}
-			if (str_equals("min--moz-device-pixel-ratio", name)) {
-				on_hack("min--moz-device-pixel-ratio");
-				return BREAK;
-			}
-			if (str_equals("-ms-high-contrast", name)) {
-				on_hack("-ms-high-contrast");
-				return BREAK;
-			}
-			if (str_equals("min-resolution", name) && n.has_children) {
-				for (const child of n) if (child.type === DIMENSION && child.value === .001 && str_equals("dpcm", child.unit || "")) {
-					on_hack("min-resolution: .001dpcm");
-					return BREAK;
-				}
-			}
-			if (str_equals("-webkit-min-device-pixel-ratio", name) && n.has_children) {
-				for (const child of n) if (child.type === NUMBER && (child.value === 0 || child.value === 1e4)) {
-					on_hack("-webkit-min-device-pixel-ratio");
-					return BREAK;
-				}
-			}
-			if (n.has_children) {
-				for (const child of n) if (child.type === IDENTIFIER && child.text === "\\0") {
-					on_hack("\\0");
-					return BREAK;
-				}
-			}
-		}
-	});
-}
-//#endregion
-//#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, "");
-}
-/**
-* Case-insensitive compare two character codes
-* @see https://github.com/csstree/csstree/blob/41f276e8862d8223eeaa01a3d113ab70bb13d2d9/lib/tokenizer/utils.js#L22
-*/
-function compareChar(referenceCode, testCode) {
-	if (testCode >= 65 && testCode <= 90) testCode = testCode | 32;
-	return referenceCode === testCode;
-}
-/**
-* Case-insensitive testing whether a string ends with a given substring
-*
-* @example
-* endsWith('test', 'my-test') // true
-* endsWith('test', 'est') // false
-*
-* @param base e.g. '-webkit-transform'
-* @param maybe e.g. 'transform'
-* @returns true if `test` ends with `base`, false otherwise
-*/
-function endsWith(base, maybe) {
-	if (base === maybe) return true;
-	let len = maybe.length;
-	let offset = len - base.length;
-	if (offset < 0) return false;
-	for (let i = len - 1; i >= offset; i--) if (compareChar(base.charCodeAt(i - offset), maybe.charCodeAt(i)) === false) return false;
-	return true;
-}
-//#endregion
-//#region src/selectors/utils.ts
-const PSEUDO_FUNCTIONS = new KeywordSet([
-	"nth-child",
-	"where",
-	"not",
-	"is",
-	"has",
-	"nth-last-child",
-	"matches",
-	"-webkit-any",
-	"-moz-any"
-]);
-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 (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));
-			}
-		}
-	});
-}
-/**
-* Check if a Wallace selector is an accessibility selector (has aria-* or role attribute)
-*/
-function isAccessibility(selector, on_selector) {
-	function normalize(node) {
-		let clone = node.clone();
-		if (clone.value) return "[" + clone.name?.toLowerCase() + clone.attr_operator + "\"" + unquote(clone.value.toString()) + "\"]";
-		return "[" + clone.name?.toLowerCase() + "]";
-	}
-	walk(selector, function(node) {
-		if (node.type === ATTRIBUTE_SELECTOR) {
-			const name = node.name || "";
-			if (str_equals("role", name) || str_starts_with(name, "aria-")) on_selector(normalize(node));
-		}
-	});
-}
-/**
-* Get the Complexity for a Wallace Selector Node
-* @param selector - Wallace CSSNode for a Selector
-* @return The numeric complexity of the Selector
-*/
-function getComplexity(selector) {
-	let complexity = 0;
-	function findSelectors(node, complexities) {
-		walk(node, function(n) {
-			if (n.type === SELECTOR) complexities.push(getComplexity(n));
-		});
-	}
-	walk(selector, function(node) {
-		const type = node.type;
-		if (type === SELECTOR) return;
-		if (type === NTH_SELECTOR) {
-			if (node.text && node.text.trim()) complexity++;
-			return;
-		}
-		complexity++;
-		if (type === PSEUDO_ELEMENT_SELECTOR || type === TYPE_SELECTOR || type === PSEUDO_CLASS_SELECTOR) {
-			if (node.is_vendor_prefixed) complexity++;
-		}
-		if (type === ATTRIBUTE_SELECTOR) {
-			if (node.value) complexity++;
-			return SKIP;
-		}
-		if (type === PSEUDO_CLASS_SELECTOR) {
-			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));
-				else findSelectors(child, childComplexities);
-				if (childComplexities.length > 0) {
-					for (const c of childComplexities) complexity += c;
-					return SKIP;
-				}
-			}
-		}
-	});
-	return complexity;
-}
-/**
-* Walk a selector node and trigger a callback every time a Combinator was found
-*/
-function getCombinators(selector, onMatch) {
-	walk(selector, function(node) {
-		if (node.type === COMBINATOR) onMatch({
-			name: node.name?.trim() === "" ? " " : node.name,
-			loc: {
-				offset: node.start,
-				line: node.line,
-				column: node.column,
-				length: 1
-			}
-		});
-	});
-}
-//#endregion
-//#region src/selectors/specificity.ts
-function compare(s1, s2) {
-	if (s1[0] === s2[0]) {
-		if (s1[1] === s2[1]) return s1[2] - s2[2];
-		return s1[1] - s2[1];
-	}
-	return s1[0] - s2[0];
-}
-function max(list) {
-	return list.sort(compare).at(-1);
-}
-const calculateForAST = (selectorAST) => {
-	let a = 0;
-	let b = 0;
-	let c = 0;
-	let current = selectorAST.first_child;
-	while (current) {
-		switch (current.type) {
-			case ID_SELECTOR:
-				a += 1;
-				break;
-			case ATTRIBUTE_SELECTOR:
-			case CLASS_SELECTOR:
-				b += 1;
-				break;
-			case PSEUDO_CLASS_SELECTOR:
-				switch (current.name?.toLowerCase()) {
-					case "where": break;
-					case "-webkit-any":
-					case "any":
-						if (current.first_child) b += 1;
-						break;
-					case "-moz-any":
-					case "is":
-					case "matches":
-					case "not":
-					case "has":
-						if (current.has_children) {
-							const childSelectorList = current.first_child;
-							if (childSelectorList?.type === SELECTOR_LIST) {
-								const max1 = max(calculate(childSelectorList));
-								a += max1[0];
-								b += max1[1];
-								c += max1[2];
-							}
-						}
-						break;
-					case "nth-child":
-					case "nth-last-child":
-						b += 1;
-						const nthOf = current.first_child;
-						if (nthOf?.type === NTH_OF_SELECTOR && nthOf.selector) {
-							const max2 = max(calculate(nthOf.selector));
-							a += max2[0];
-							b += max2[1];
-							c += max2[2];
-						}
-						break;
-					case "host-context":
-					case "host":
-						b += 1;
-						const childSelector = current.first_child?.first_child;
-						if (childSelector?.type === SELECTOR) {
-							let childPart = childSelector.first_child;
-							while (childPart) {
-								if (childPart.type === COMBINATOR) break;
-								const partSpecificity = calculateForAST({
-									type_name: "Selector",
-									first_child: childPart,
-									has_children: true
-								});
-								a += partSpecificity[0] ?? 0;
-								b += partSpecificity[1] ?? 0;
-								c += partSpecificity[2] ?? 0;
-								childPart = childPart.next_sibling;
-							}
-						}
-						break;
-					case "after":
-					case "before":
-					case "first-letter":
-					case "first-line":
-						c += 1;
-						break;
-					default:
-						b += 1;
-						break;
-				}
-				break;
-			case PSEUDO_ELEMENT_SELECTOR:
-				switch (current.name?.toLowerCase()) {
-					case "slotted":
-						c += 1;
-						const childSelector = current.first_child?.first_child;
-						if (childSelector?.type === SELECTOR) {
-							let childPart = childSelector.first_child;
-							while (childPart) {
-								if (childPart.type === COMBINATOR) break;
-								const partSpecificity = calculateForAST({
-									type_name: "Selector",
-									first_child: childPart,
-									has_children: true
-								});
-								a += partSpecificity[0] ?? 0;
-								b += partSpecificity[1] ?? 0;
-								c += partSpecificity[2] ?? 0;
-								childPart = childPart.next_sibling;
-							}
-						}
-						break;
-					case "view-transition-group":
-					case "view-transition-image-pair":
-					case "view-transition-old":
-					case "view-transition-new":
-						if (current.first_child?.text === "*") break;
-						c += 1;
-						break;
-					default:
-						c += 1;
-						break;
-				}
-				break;
-			case TYPE_SELECTOR:
-				let typeSelector = current.name ?? "";
-				if (typeSelector.includes("|")) typeSelector = typeSelector.split("|")[1] ?? "";
-				if (typeSelector !== "*") c += 1;
-				break;
-			default: break;
-		}
-		current = current.next_sibling;
-	}
-	return [
-		a,
-		b,
-		c
-	];
-};
-const convertToAST = (source) => {
-	if (typeof source === "string") try {
-		return parse_selector(source);
-	} catch (e) {
-		const message = e instanceof Error ? e.message : String(e);
-		throw new TypeError(`Could not convert passed in source '${source}' to SelectorList: ${message}`);
-	}
-	if (source instanceof Object) {
-		if (source.type === SELECTOR_LIST) 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 specificities = [];
-	let selectorNode = ast.first_child;
-	while (selectorNode) {
-		specificities.push(calculateForAST(selectorNode));
-		selectorNode = selectorNode.next_sibling;
-	}
-	return specificities;
-};
-//#endregion
-//#region src/values/colors.ts
-const namedColors = new KeywordSet([
-	"white",
-	"black",
-	"red",
-	"gray",
-	"silver",
-	"grey",
-	"green",
-	"orange",
-	"blue",
-	"dimgray",
-	"whitesmoke",
-	"lightgray",
-	"lightgrey",
-	"yellow",
-	"gold",
-	"pink",
-	"gainsboro",
-	"magenta",
-	"purple",
-	"darkgray",
-	"navy",
-	"darkred",
-	"teal",
-	"maroon",
-	"darkgrey",
-	"tomato",
-	"darkorange",
-	"brown",
-	"crimson",
-	"lightyellow",
-	"slategray",
-	"salmon",
-	"lightgreen",
-	"lightblue",
-	"orangered",
-	"aliceblue",
-	"dodgerblue",
-	"lime",
-	"darkblue",
-	"darkgoldenrod",
-	"skyblue",
-	"royalblue",
-	"darkgreen",
-	"ivory",
-	"olive",
-	"aqua",
-	"turquoise",
-	"cyan",
-	"khaki",
-	"beige",
-	"snow",
-	"ghostwhite",
-	"limegreen",
-	"coral",
-	"dimgrey",
-	"hotpink",
-	"midnightblue",
-	"firebrick",
-	"indigo",
-	"wheat",
-	"mediumblue",
-	"lightpink",
-	"plum",
-	"azure",
-	"violet",
-	"lavender",
-	"deepskyblue",
-	"darkslategrey",
-	"goldenrod",
-	"cornflowerblue",
-	"lightskyblue",
-	"indianred",
-	"yellowgreen",
-	"saddlebrown",
-	"palegreen",
-	"bisque",
-	"tan",
-	"antiquewhite",
-	"steelblue",
-	"forestgreen",
-	"fuchsia",
-	"mediumaquamarine",
-	"seagreen",
-	"sienna",
-	"deeppink",
-	"mediumseagreen",
-	"peru",
-	"greenyellow",
-	"lightgoldenrodyellow",
-	"orchid",
-	"cadetblue",
-	"navajowhite",
-	"lightsteelblue",
-	"slategrey",
-	"linen",
-	"lightseagreen",
-	"darkcyan",
-	"lightcoral",
-	"aquamarine",
-	"blueviolet",
-	"cornsilk",
-	"lightsalmon",
-	"chocolate",
-	"lightslategray",
-	"floralwhite",
-	"darkturquoise",
-	"darkslategray",
-	"rebeccapurple",
-	"burlywood",
-	"chartreuse",
-	"lightcyan",
-	"lemonchiffon",
-	"palevioletred",
-	"darkslateblue",
-	"mediumpurple",
-	"lawngreen",
-	"slateblue",
-	"darkseagreen",
-	"blanchedalmond",
-	"mistyrose",
-	"darkolivegreen",
-	"seashell",
-	"olivedrab",
-	"peachpuff",
-	"darkviolet",
-	"powderblue",
-	"darkmagenta",
-	"lightslategrey",
-	"honeydew",
-	"palegoldenrod",
-	"darkkhaki",
-	"oldlace",
-	"mintcream",
-	"sandybrown",
-	"mediumturquoise",
-	"papayawhip",
-	"paleturquoise",
-	"mediumvioletred",
-	"thistle",
-	"springgreen",
-	"moccasin",
-	"rosybrown",
-	"lavenderblush",
-	"mediumslateblue",
-	"darkorchid",
-	"mediumorchid",
-	"darksalmon",
-	"mediumspringgreen"
-]);
-const systemColors = new KeywordSet([
-	"accentcolor",
-	"accentcolortext",
-	"activetext",
-	"buttonborder",
-	"buttonface",
-	"buttontext",
-	"canvas",
-	"canvastext",
-	"field",
-	"fieldtext",
-	"graytext",
-	"highlight",
-	"highlighttext",
-	"linktext",
-	"mark",
-	"marktext",
-	"selecteditem",
-	"selecteditemtext",
-	"visitedtext"
-]);
-const colorFunctions = new KeywordSet([
-	"rgba",
-	"rgb",
-	"hsla",
-	"hsl",
-	"oklch",
-	"color",
-	"hwb",
-	"lch",
-	"lab",
-	"oklab"
-]);
-const colorKeywords = new KeywordSet(["transparent", "currentcolor"]);
-//#endregion
-//#region src/values/values.ts
-const keywords = new KeywordSet([
-	"auto",
-	"none",
-	"inherit",
-	"initial",
-	"unset",
-	"revert",
-	"revert-layer"
-]);
-/**
-* Test whether a value is a reset (0, 0px, -0.0e0 etc.)
-*/
-function isValueReset(node) {
-	for (let child of node.children) {
-		if (child.type === NUMBER && child.value === 0) continue;
-		if (child.type === DIMENSION && child.value === 0) continue;
-		return false;
-	}
-	return true;
-}
-//#endregion
+import { n as isSupportsBrowserhack, t as isMediaBrowserhack } from "./atrules-CskmpIdJ.js";
+import { t as KeywordSet } from "./keyword-set-qSyAMR9o.js";
+import { n as unquote, t as endsWith } from "./string-utils-C97yyuqE.js";
+import { a as getComplexity, i as getCombinators, n as calculateForAST, o as isAccessibility, s as isPrefixed, t as calculate } from "./specificity-BKdu6JZr.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-Ckz2JiOQ.js";
+import { a as shorthand_properties, i as isHack, n as basename, r as border_radius_properties, t as SPACING_RESET_PROPERTIES } from "./property-utils-B3n9KkA9.js";
+import { ATTRIBUTE_SELECTOR, AT_RULE, BLOCK, CONTAINER_QUERY, DECLARATION, DIMENSION, FUNCTION, HASH, IDENTIFIER, LAYER_NAME, MEDIA_FEATURE, NUMBER, OPERATOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SELECTOR, SELECTOR_LIST, SKIP, STYLE_RULE, SUPPORTS_QUERY, TYPE_SELECTOR, URL, is_custom, is_vendor_prefixed, parse, str_starts_with, walk } from "@projectwallace/css-parser";
 //#region src/values/destructure-font-shorthand.ts
 const SYSTEM_FONTS = new KeywordSet([
 	"caption",
@@ -902,73 +317,11 @@ function getEmbedType(embed) {
 	return embed.substring(start, semicolon);
 }
 //#endregion
-//#region src/values/browserhacks.ts
-function isIe9Hack(node) {
-	let children = node.children;
-	if (children) {
-		let last = children.at(-1);
-		return last && last.type === IDENTIFIER && endsWith("\\9", last.text) ? true : false;
-	}
-	return false;
-}
-//#endregion
-//#region src/properties/property-utils.ts
-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
 //#region src/vendor-prefix.ts
-/** Kept for backwards compatibility */
+/**
+* Kept for backwards compatibility
+* @deprecated
+* */
 function hasVendorPrefix(keyword) {
 	return is_vendor_prefixed(keyword);
 }
@@ -1063,6 +416,7 @@ function analyzeInternal(css, options, useLocations) {
 	let propertyHacks = new Collection(useLocations);
 	let propertyVendorPrefixes = new Collection(useLocations);
 	let customProperties = new Collection(useLocations);
+	let shorthands = new Collection(useLocations);
 	let propertyComplexities = new AggregateCollection();
 	let valueComplexities = new AggregateCollection();
 	let vendorPrefixedValues = new Collection(useLocations);
@@ -1253,6 +607,7 @@ function analyzeInternal(css, options, useLocations) {
 				propertyHacks.p(property.charAt(0), propertyLoc);
 				propertyComplexities.push(2);
 			} else propertyComplexities.push(1);
+			if (shorthand_properties.has(normalizedProperty)) shorthands.p(property, propertyLoc);
 			{
 				let value = node.value;
 				let { text } = value;
@@ -1559,6 +914,7 @@ function analyzeInternal(css, options, useLocations) {
 				ratio: ratio(customProperties.size(), properties.size()),
 				importants: assign(importantCustomProperties.c(), { ratio: ratio(importantCustomProperties.size(), customProperties.size()) })
 			}),
+			shorthands: assign(shorthands.c(), { ratio: ratio(shorthands.size(), properties.size()) }),
 			browserhacks: assign(propertyHacks.c(), { ratio: ratio(propertyHacks.size(), properties.size()) }),
 			complexity: propertyComplexity
 		}),
@@ -1593,6 +949,7 @@ function analyzeInternal(css, options, useLocations) {
 }
 /**
 * Compare specificity A to Specificity B
+* @deprecated this one is the inverse of the one exported in /selectors/index.ts; wille be removed in next major version
 * @returns 0 when a==b, 1 when a<b, -1 when a>b
 */
 function compareSpecificity(a, b) {