@cssdoc/providers 0.4.2 → 0.5.0

package/dist/index.mjs

@@ -177,6 +177,38 @@ const warn = (d) => ({
 	...d,
 	severity: "warning"
 });
+const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+/** A `*`-glob name (e.g. `-icon-*`) as a regex source over one class token (`*` → any `[\w-]` run). */
+const globSource = (name) => name.split("*").map(escapeRe).join("[\\w-]*");
+/** `class` attribute selectors, capturing the operator (`~`/`^`/`$`/`*`/`|`/none) and the value. */
+const CLASS_ATTR_RE = /\[\s*class\s*([~^$*|]?)=\s*(?:"([^"]*)"|'([^']*)'|([^\]\s]*))\s*\]/gu;
+/**
+* Whether `selectorText` (the record's concatenated selectors) defines the modifier/part `selector`
+* (`.name`, where `name` may be a `*` glob for a family like `.-icon-*`; a name with no `*` is exact).
+* Beyond a literal class token, `class` attribute selectors count with their real CSS operator
+* semantics — `[class~=v]`/`[class=v]` (exact word), `[class*=v]` (substring), and `[class$=v]` (suffix)
+* can define a chained modifier; `[class^=v]` cannot, since `^=` anchors to the start of the whole
+* attribute (the base class), never a chained modifier.
+*/
+const selectorDefines = (selectorText, selector) => {
+	if (!selector.startsWith(".")) return selectorText.includes(selector);
+	const name = stripDot(selector);
+	const wild = name.includes("*");
+	const prefix = name.split("*")[0];
+	if (new RegExp(`\\.${globSource(name)}(?![\\w-])`, "u").test(selectorText)) return true;
+	const glob = new RegExp(`^${globSource(name)}$`, "u");
+	for (const m of selectorText.matchAll(CLASS_ATTR_RE)) {
+		const op = m[1];
+		const v = m[2] ?? m[3] ?? m[4] ?? "";
+		if (!v || op === "^") continue;
+		if (op === "*") {
+			if (wild ? prefix.includes(v) || v.includes(prefix) : name.includes(v)) return true;
+		} else if (op === "$") {
+			if (wild ? v.endsWith(prefix) || prefix.endsWith(v) : name.endsWith(v)) return true;
+		} else if (glob.test(v)) return true;
+	}
+	return false;
+};
 /**
 * Match a class name against a `structureIgnore` pattern — a literal name or a simple glob where `*`
 * stands for any run of characters (e.g. `util-*`, `*--legacy`, `*`). Matched literally otherwise.
@@ -221,6 +253,7 @@ const record = {
 			if (info.entry.structure?.length) {
 				const known = /* @__PURE__ */ new Set([
 					stripDot(info.entry.className),
+					...index.records.map((r) => stripDot(r.entry.className)),
 					...info.entry.parts.flatMap((p) => [stripDot(p.name), ...(p.modifiers ?? []).map((m) => m.name)]),
 					...info.entry.shadowParts.map((p) => stripDot(p.name)),
 					...info.entry.states.map((s) => s.name),
@@ -390,13 +423,18 @@ const modifier = {
 					span
 				}));
 			}
-			for (const authored of info.authoredModifiers) if (!info.selectorText.includes(index.matcher.selectorFor(authored))) out.push(warn({
-				aspect: "modifier",
-				rule: "name-not-in-css",
-				message: `Documented modifier "${index.matcher.selectorFor(authored)}" of "${name}" is not defined by any selector.`,
-				record: name,
-				span: info.span
-			}));
+			const deprecated = new Set(info.entry.modifiers.filter((m) => m.deprecated).map((m) => m.name));
+			for (const authored of info.authoredModifiers) {
+				if (deprecated.has(authored)) continue;
+				const sel = index.matcher.selectorFor(authored);
+				if (!selectorDefines(info.selectorText, sel)) out.push(warn({
+					aspect: "modifier",
+					rule: "name-not-in-css",
+					message: `Documented modifier "${sel}" of "${name}" is not defined by any selector.`,
+					record: name,
+					span: info.span
+				}));
+			}
 		}
 		return out;
 	},
@@ -473,7 +511,7 @@ const part = { model(index, naming) {
 				span: info.memberSpans.get(memberKey("part", p.name)) ?? info.span
 			}));
 		}
-		for (const authored of info.authoredParts) if (!info.selectorText.includes(`.${authored}`)) out.push(warn({
+		for (const authored of info.authoredParts) if (!selectorDefines(info.selectorText, `.${authored}`)) out.push(warn({
 			aspect: "part",
 			rule: "name-not-in-css",
 			message: `Documented part ".${authored}" of "${name}" is not defined by any selector.`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cssdoc/providers",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Host-agnostic aspect providers over the @cssdoc/index — diagnostics, completions, hover, and definitions for modifiers, custom properties, structure, functions, states, and conditions.",
   "keywords": [
     "css",
@@ -29,8 +29,8 @@
   },
   "dependencies": {
     "css-tree": "^3.2.1",
-    "@cssdoc/core": "0.4.2",
-    "@cssdoc/index": "0.4.2"
+    "@cssdoc/core": "0.5.0",
+    "@cssdoc/index": "0.5.0"
   },
   "devDependencies": {
     "@types/css-tree": "^2.3.11",