@master/css-tooling 0.0.0-site.1793659883.g69c9aebcf628

package/dist/value-validation.js

@@ -0,0 +1,162 @@
+import { validateMathTypes } from "./math-types.js";
+import { mathFunctionStatus } from "./math-validation.js";
+import { cssTreeVersion } from "./css-tree-version.js";
+import { CSS_SYNTAX_CHECK, cssSyntaxStatus } from "./syntax-validation.js";
+import { definitionSyntax, generate, lexer, parse, property, walk } from "@eslint/css-tree";
+// src/value-validation.ts
+const CSS_VALUE_CHECK = Object.freeze({
+	name: "@eslint/css-tree",
+	version: cssTreeVersion,
+	phase: "css-value",
+	scope: "expanded-declarations-and-known-math-grammar-and-static-types-v1"
+});
+const units = new Set(Object.values(lexer.units).flat().map((unit) => unit.toLowerCase()));
+const cache = /* @__PURE__ */ new Map();
+let knownKeywords;
+function isKnownKeyword(name) {
+	if (!knownKeywords) {
+		knownKeywords = /* @__PURE__ */ new Set();
+		const grammar = lexer.dump(false, false);
+		for (const syntax of [...Object.values(grammar.properties), ...Object.values(grammar.types)]) {
+			if (typeof syntax !== "string") continue;
+			definitionSyntax.walk(definitionSyntax.parse(syntax), (node) => {
+				if (node.type === "Keyword") knownKeywords.add(node.name.toLowerCase());
+			});
+		}
+	}
+	return knownKeywords.has(name.toLowerCase());
+}
+/** Grammar knowledge is a report, never permission to generate a declaration. */
+function cssValueStatus(property, value) {
+	return validateValue(property, value);
+}
+function validateValue(property$1, value, atRule) {
+	const key = `${atRule ?? ""}\0${property$1}\0${value}`;
+	const cached = cache.get(key);
+	if (cached) return cached;
+	if (property(property$1).custom) return "unknown";
+	let status;
+	try {
+		const ast = parse(value, { context: "value" });
+		let dependent = property(property$1).custom;
+		const descriptor = atRule ? lexer.getAtrule(atRule)?.descriptors?.[property$1] : void 0;
+		const pageContext = atRule === "page" || /^(?:top|bottom)-(?:left|center|right)(?:-corner)?$|^(?:left|right)-(?:top|middle|bottom)$/.test(atRule ?? "");
+		const useDescriptor = Boolean(atRule && (descriptor || !pageContext));
+		let unresolved = dependent || (useDescriptor ? !descriptor : !lexer.getProperty(property$1));
+		let unknownCapability = false;
+		let invalidRepeat = false;
+		let invalidMath = false;
+		let unknownMath = false;
+		walk(ast, (node) => {
+			if (node.type === "Function") {
+				const name = node.name.toLowerCase();
+				const math = mathFunctionStatus(node);
+				invalidMath ||= math === "invalid";
+				unknownMath ||= math === "unknown";
+				if ([
+					"var",
+					"env",
+					"attr"
+				].includes(name)) dependent = true;
+				if (dependent || !lexer.getType(`${name}()`)) unresolved = true;
+				if (name === "repeat" && /^grid-template-(?:columns|rows)$/.test(property$1)) {
+					const count = node.children.first;
+					if (count?.type === "Number") invalidRepeat ||= !Number.isInteger(Number(count.value)) || Number(count.value) <= 0;
+					else if (count?.type === "Identifier") invalidRepeat ||= !["auto-fill", "auto-fit"].includes(count.name);
+				}
+			} else if (node.type === "Identifier" && !isKnownKeyword(node.name)) unresolved = true;
+			else if (node.type === "Dimension" && !units.has(node.unit.toLowerCase())) {
+				unresolved = true;
+				unknownCapability = true;
+			}
+		});
+		const matches = (value) => !(useDescriptor ? lexer.matchAtruleDescriptor(atRule, property$1, value) : lexer.matchProperty(property$1, value)).error;
+		const math = validateMathTypes(ast, matches);
+		invalidMath ||= math.status === "invalid";
+		unknownMath ||= math.status === "unknown";
+		const knownMatch = matches(math.ast);
+		if (math.status === "valid" && !knownMatch && !unresolved && !unknownCapability) invalidMath = true;
+		status = invalidRepeat || invalidMath ? "invalid" : dependent || unknownMath || unknownCapability ? "unknown" : knownMatch ? "valid" : unresolved ? "unknown" : "invalid";
+	} catch {
+		status = "invalid";
+	}
+	if (cache.size >= 4096) cache.delete(cache.keys().next().value);
+	cache.set(key, status);
+	return status;
+}
+function validateRuleDeclarations(text) {
+	const declarations = [];
+	let ast;
+	try {
+		ast = parse(text, {
+			positions: true,
+			parseAtrulePrelude: false,
+			parseRulePrelude: false,
+			parseCustomProperty: false
+		});
+	} catch {
+		return declarations;
+	}
+	walk(ast, {
+		visit: "Declaration",
+		enter(node) {
+			if (node.type !== "Declaration") return;
+			const value = generate(node.value);
+			const atRule = this.atrule && !this.rule ? this.atrule.name.toLowerCase() : void 0;
+			declarations.push({
+				property: node.property,
+				value,
+				...atRule ? { atRule } : {},
+				status: validateValue(node.property, value, atRule),
+				...node.loc ? { range: {
+					start: node.loc.start.offset,
+					end: node.loc.end.offset
+				} } : {}
+			});
+		}
+	});
+	return declarations;
+}
+function withCSSValueValidation(result) {
+	const declarations = result.rules.flatMap((rule) => validateRuleDeclarations(rule.text));
+	const diagnostics = [...result.diagnostics || []];
+	for (const declaration of declarations) {
+		if (declaration.status !== "invalid" && declaration.status !== "unknown") continue;
+		diagnostics.push({
+			code: declaration.status === "invalid" ? "CSS_VALUE_INVALID" : "CSS_VALUE_UNKNOWN",
+			phase: "css-value",
+			severity: declaration.status === "invalid" ? "error" : "info",
+			message: declaration.status === "invalid" ? `Invalid CSS value: ${declaration.property}:${declaration.value}` : `CSS value cannot be fully checked: ${declaration.property}:${declaration.value}`,
+			range: {
+				start: 0,
+				end: result.className.length
+			},
+			notes: []
+		});
+	}
+	const cssValueStatus = declarations.some((d) => d.status === "invalid") ? "invalid" : declarations.some((d) => d.status === "unknown") ? "unknown" : declarations.length ? "valid" : "not-checked";
+	const syntax = result.rules.map((rule) => cssSyntaxStatus(rule.text));
+	const syntaxStatus = result.cssSyntaxStatus === "invalid" || syntax.includes("invalid") ? "invalid" : syntax.includes("unknown") ? "unknown" : syntax.length ? "valid" : result.cssSyntaxStatus ?? "not-checked";
+	if (syntax.includes("invalid")) diagnostics.push({
+		code: "CSS_PARSE_ERROR",
+		phase: "css-syntax",
+		severity: "error",
+		message: "Invalid CSS token structure in expanded declarations, selectors or queries",
+		range: {
+			start: 0,
+			end: result.className.length
+		},
+		notes: []
+	});
+	const checks = [...syntax.length ? [CSS_SYNTAX_CHECK] : [], ...declarations.length ? [CSS_VALUE_CHECK] : []];
+	return {
+		...result,
+		cssSyntaxStatus: syntaxStatus,
+		cssValueStatus,
+		browserSupport: "not-checked",
+		checks,
+		declarations,
+		diagnostics
+	};
+}
+export { CSS_VALUE_CHECK, cssValueStatus, validateRuleDeclarations, withCSSValueValidation };

package/package.json

@@ -0,0 +1,127 @@
+{
+    "name": "@master/css-tooling",
+    "type": "module",
+    "engines": {
+        "node": "^24"
+    },
+    "license": "MIT",
+    "description": "Rust-backed extraction, scanning, linting, language, validation, and diagnostics sessions for Master CSS",
+    "author": "Aoyue Design LLC.",
+    "homepage": "https://css.master.co",
+    "bugs": {
+        "url": "https://github.com/master-co/css/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/master-co/css.git",
+        "directory": "packages/tooling"
+    },
+    "keywords": [
+        "tooling",
+        "scanner",
+        "lint",
+        "language-service",
+        "css",
+        "mastercss"
+    ],
+    "sideEffects": false,
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        },
+        "./node": {
+            "types": "./dist/node.d.ts",
+            "import": "./dist/node.js",
+            "default": "./dist/node.js"
+        },
+        "./lexer": {
+            "types": "./dist/lexer/index.d.ts",
+            "import": "./dist/lexer/index.js",
+            "default": "./dist/lexer/index.js"
+        },
+        "./lexer/node": {
+            "types": "./dist/lexer/node.d.ts",
+            "import": "./dist/lexer/node.js",
+            "default": "./dist/lexer/node.js"
+        },
+        "./source": {
+            "types": "./dist/source/index.d.ts",
+            "import": "./dist/source/index.js",
+            "default": "./dist/source/index.js"
+        },
+        "./source/node": {
+            "types": "./dist/source/node.d.ts",
+            "import": "./dist/source/node.js",
+            "default": "./dist/source/node.js"
+        },
+        "./scanner/node": {
+            "types": "./dist/scanner/node.d.ts",
+            "import": "./dist/scanner/node.js",
+            "default": "./dist/scanner/node.js"
+        },
+        "./validator": {
+            "types": "./dist/validator/index.d.ts",
+            "import": "./dist/validator/index.js",
+            "default": "./dist/validator/index.js"
+        },
+        "./validator/node": {
+            "types": "./dist/validator/node.d.ts",
+            "import": "./dist/validator/node.js",
+            "default": "./dist/validator/node.js"
+        },
+        "./lint": {
+            "types": "./dist/lint/index.d.ts",
+            "import": "./dist/lint/index.js",
+            "default": "./dist/lint/index.js"
+        },
+        "./lint/node": {
+            "types": "./dist/lint/node.d.ts",
+            "import": "./dist/lint/node.js",
+            "default": "./dist/lint/node.js"
+        },
+        "./language": {
+            "types": "./dist/language/index.d.ts",
+            "import": "./dist/language/index.js",
+            "default": "./dist/language/index.js"
+        },
+        "./language/node": {
+            "types": "./dist/language/node.d.ts",
+            "import": "./dist/language/node.js",
+            "default": "./dist/language/node.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "dependencies": {
+        "@eslint/css-tree": "^4.1.2",
+        "@master/css-binding": "0.0.0-site.1793659883.g69c9aebcf628",
+        "@master/css-schema": "0.0.0-site.1793659883.g69c9aebcf628",
+        "consola": "^3.4.2",
+        "defu": "^6.1.7",
+        "ignore": "^7.0.14",
+        "mdn-data": "^2.37.2",
+        "minimatch": "^10.2.6"
+    },
+    "peerDependencies": {
+        "svelte": ">=4",
+        "vue": ">=3"
+    },
+    "peerDependenciesMeta": {
+        "svelte": {
+            "optional": true
+        },
+        "vue": {
+            "optional": true
+        }
+    },
+    "version": "0.0.0-site.1793659883.g69c9aebcf628",
+    "gitHead": "69c9aebcf628eb529001b9fa1b3536306f1b139e"
+}