@cssdoc/index 0.2.0 → 0.3.1

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import { CssAnimation, CssCondition, CssDocConfiguration, CssDocEntry, CssFunction, CssModifier, CssPart, CssPropertyDeclared, CssState, ModifierConventionInput, ModifierMatcher, StructureNode } from "@cssdoc/core";
+import postcss from "postcss";
 
 //#region src/index.d.ts
 /** A 1-based line/column position (matching PostCSS). */
@@ -52,7 +53,7 @@ interface CssValueSites {
   usages: PropertyUsage[];
 }
 /** The kinds of record member a span can be keyed to. */
-type MemberKind = "record" | "modifier" | "part" | "property" | "function" | "animation" | "layer" | "state" | "condition";
+type MemberKind = "record" | "modifier" | "part" | "shadow-part" | "property" | "function" | "animation" | "layer" | "state" | "condition";
 /** Build a stable span key for a member. */
 declare function memberKey(kind: MemberKind, id?: string): string;
 /** One record in the index: its model entry plus source spans and the facts drift checks need. */
@@ -64,8 +65,10 @@ interface RecordInfo {
   memberSpans: Map<string, SourceSpan>;
   /** Modifier names authored via `@modifier` (used for drift detection). */
   authoredModifiers: Set<string>;
-  /** Part names authored via `@part`/`@csspart` (used for drift detection). */
+  /** Part names authored via `@part` (used for drift detection). */
   authoredParts: Set<string>;
+  /** Shadow-part names authored via `@csspart` (used for drift detection). */
+  authoredShadowParts: Set<string>;
   /** The concatenated selector text of the record's rules (used for drift detection). */
   selectorText: string;
 }
@@ -92,6 +95,7 @@ declare class CssDocIndex {
   recordInfo(name: string): RecordInfo | undefined;
   modifiersFor(name: string): CssModifier[];
   partsFor(name: string): CssPart[];
+  shadowPartsFor(name: string): CssPart[];
   customPropertiesFor(name: string): CssPropertyDeclared[];
   functionsFor(name: string): CssFunction[];
   statesFor(name: string): CssState[];
@@ -133,7 +137,8 @@ declare function indexFromEntries(entries: CssDocEntry[], file?: string): CssDoc
 declare function createIndex(css: string, options?: {
   file?: string;
   configuration?: CssDocConfiguration;
-  modifierConvention?: ModifierConventionInput;
+  modifierConvention?: ModifierConventionInput; /** The PostCSS parser (inject a dialect parser for `.scss`/`.less`; default `postcss.parse`). */
+  parse?: (css: string) => ReturnType<typeof postcss.parse>;
 }): CssDocIndex;
 /**
  * Extract custom-property assignments (`--name: value`) and `var(--name, fallback)` references from
@@ -143,6 +148,8 @@ declare function createIndex(css: string, options?: {
  * @param css - The CSS source.
  * @returns The assignments and `var(…)` usages found.
  */
-declare function cssValueSites(css: string): CssValueSites;
+declare function cssValueSites(css: string, options?: {
+  parse?: (css: string) => ReturnType<typeof postcss.parse>;
+}): CssValueSites;
 //#endregion
 export { ClassUsage, CssDocIndex, CssDocManifest, CssValueSites, Location, MemberKind, Position, PropertyAssignment, PropertyUsage, RecordInfo, SourceSpan, createIndex, cssValueSites, indexFromEntries, memberKey };

package/dist/index.mjs

@@ -69,6 +69,9 @@ var CssDocIndex = class {
 	partsFor(name) {
 		return this.byName.get(name)?.entry.parts ?? [];
 	}
+	shadowPartsFor(name) {
+		return this.byName.get(name)?.entry.shadowParts ?? [];
+	}
 	customPropertiesFor(name) {
 		return this.byName.get(name)?.entry.cssPropertiesDeclared ?? [];
 	}
@@ -137,6 +140,7 @@ function indexFromEntries(entries, file) {
 		memberSpans: /* @__PURE__ */ new Map(),
 		authoredModifiers: /* @__PURE__ */ new Set(),
 		authoredParts: /* @__PURE__ */ new Set(),
+		authoredShadowParts: /* @__PURE__ */ new Set(),
 		selectorText: ""
 	})), file);
 }
@@ -152,12 +156,19 @@ function scanNodes(nodes, build, base, matcher) {
 		if (`.${stripDot(node.selector.trim())}` === base && !build.span) build.span = spanOf(node);
 		for (const selector of node.selector.split(",")) {
 			for (const s of selector.matchAll(/:state\(\s*([\w-]+)\s*\)/gu)) set(memberKey("state", s[1]), node);
+			for (const ps of matcher.pseudoStatesIn(selector)) set(memberKey("state", ps.name), node);
+			for (const sp of selector.matchAll(/::part\(\s*([\w-]+)\s*\)/gu)) set(memberKey("shadow-part", sp[1]), node);
 			const bare = selector.replace(/::?[\w-]+(\([^)]*\))?/gu, "");
 			const modNames = /* @__PURE__ */ new Set();
 			for (const mod of matcher.modifiersIn(bare, baseNoDot)) {
 				modNames.add(mod.name);
 				set(memberKey("modifier", mod.name), node);
 			}
+			for (const el of matcher.elementsIn(bare, baseNoDot)) {
+				set(memberKey("part", el.name), node);
+				for (const m of el.modifiers) set(memberKey("modifier", m.name), node);
+			}
+			for (const st of matcher.statesIn(bare, baseNoDot)) set(memberKey("state", st.name), node);
 			for (const p of bare.matchAll(/\.([a-z][\w-]*)/gu)) {
 				if (modNames.has(p[1])) continue;
 				set(memberKey("part", p[1]), node);
@@ -189,11 +200,12 @@ function createIndex(css, options = {}) {
 	const matcher = new ModifierMatcher(resolveModifierConvention(options.modifierConvention ?? options.configuration?.modifierConvention));
 	const entries = parseCssDocs(css, {
 		configuration: options.configuration,
-		modifierConvention: options.modifierConvention
+		modifierConvention: options.modifierConvention,
+		parse: options.parse
 	});
 	const byName = new Map(entries.map((e) => [e.name, e]));
 	const builds = /* @__PURE__ */ new Map();
-	const root = postcss.parse(css);
+	const root = (options.parse ?? postcss.parse)(css);
 	let current;
 	for (const node of root.nodes) {
 		if (node.type === "comment") {
@@ -207,6 +219,7 @@ function createIndex(css, options = {}) {
 					memberSpans: /* @__PURE__ */ new Map(),
 					authoredModifiers: new Set(doc.modifiers.keys()),
 					authoredParts: new Set(doc.parts.keys()),
+					authoredShadowParts: new Set(doc.cssParts.keys()),
 					selectorText: ""
 				};
 				builds.set(name, current);
@@ -220,6 +233,7 @@ function createIndex(css, options = {}) {
 		memberSpans: /* @__PURE__ */ new Map(),
 		authoredModifiers: /* @__PURE__ */ new Set(),
 		authoredParts: /* @__PURE__ */ new Set(),
+		authoredShadowParts: /* @__PURE__ */ new Set(),
 		selectorText: ""
 	}), options.file, matcher);
 }
@@ -231,10 +245,10 @@ function createIndex(css, options = {}) {
 * @param css - The CSS source.
 * @returns The assignments and `var(…)` usages found.
 */
-function cssValueSites(css) {
+function cssValueSites(css, options = {}) {
 	const assignments = [];
 	const usages = [];
-	postcss.parse(css).walkDecls((decl) => {
+	(options.parse ?? postcss.parse)(css).walkDecls((decl) => {
 		const loc = spanOf(decl);
 		if (decl.prop.startsWith("--")) assignments.push({
 			name: decl.prop,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cssdoc/index",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "A queryable semantic index over the @cssdoc/core model, plus a host-agnostic Usage abstraction and source spans — the shared data layer for cssdoc's linters and language server.",
   "keywords": [
     "css",
@@ -30,7 +30,7 @@
   "dependencies": {
     "postcss": "^8.5.16",
     "postcss-value-parser": "^4.2.0",
-    "@cssdoc/core": "0.2.0"
+    "@cssdoc/core": "0.3.1"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",