@cross-css/native-darwin-arm64 0.3.1 → 0.3.3

package/README.md

@@ -42,7 +42,7 @@ These APIs do not compile CSS or read files. See the repository's
 
 
 
-## CSS declaration validation inputs (API v2, native 0.3.1)
+## CSS declaration validation inputs (API v2, native 0.3.2)
 
 `LanguageService.cssDeclarations(uri)` returns `{ revision, declarations }` from
 the same analysis snapshot as other editor queries, without compiling CSS.
@@ -59,7 +59,39 @@ Unknown references, native var(), recovery regions, transition groups and other
 unsupported transformations make values uncheckable; property names remain
 available. Parts on uncheckable declarations are incomplete and must not be
 validated. XCSS directives, variable registrations, and direct declarations in
-at-rule bodies (descriptors) are excluded. Rules nested inside at-rules remain
+descriptor at-rule bodies are excluded. Conditional blocks nested in rules inherit their declaration context. Rules nested inside at-rules remain
 eligible. Consumers may substitute representative CSS values for typed parts;
 this is a broad compatibility check, not proof for all values of that type.
 Changes to any file or resolution invalidate the snapshot revision.
+
+## Selector analysis and specificity (API v3)
+
+`LanguageService.selectors(uri)` returns `{ revision, selectors }` without
+compiling CSS. Each selector-list member has its original UTF-16 `range`,
+non-overlapping `parts` (`kind`, `range`), and either `specificity`
+(`ids`, `classes`, `types`) or an explanatory `reason` when an exact
+score is unavailable. Compare specificity tuples lexicographically, never as
+decimal numbers. This is selector specificity, not full cascade priority.
+
+Classification covers classes, IDs, tags, attribute names, pseudo-classes,
+pseudo-elements, universal selectors, nesting, combinators, and namespace prefixes.
+Attribute strings and numbers keep lexical highlighting. Functional pseudo names
+include colon prefixes, while their selector arguments have independent parts.
+The existing eight semantic token indices are stable; API v3 appends
+`selectorId`, `selectorTag`, `selectorAttribute`, `pseudoClass`,
+`pseudoElement`, `selectorUniversal`, `selectorNesting`,
+`selectorCombinator`, and `selectorNamespace`. IDs no longer use `variable`.
+
+Specificity follows [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Cascade/Specificity/)
+and the linked CSS specifications: zero-weight `:where()`, maximum arguments
+for `:is()`, `:not()`, and `:has()`, nth-child selector filters,
+shadow DOM selectors, legacy pseudo-elements, and implicit/explicit nesting.
+Parent lists contribute their maximum tuple; repeated `&` contributes repeatedly.
+XCSS `:local` and `:global` wrappers are transparent. Scoped renaming does
+not change specificity. At-rule boundaries add no specificity; an explicit
+`:scope` counts as a pseudo-class. Keyframe steps are excluded.
+
+Invalid/recovered selectors, unsupported functional selectors, unresolved parents,
+and selectors in injection definitions whose call-site context is unknown have
+no exact score. Other valid selector-list members remain queryable. This API does
+not expand injection calls or provide lint thresholds or editor hover UI.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cross-css/native-darwin-arm64",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Precompiled XCSS native binding for darwin/arm64",
   "license": "MIT",
   "author": "Ivan Kobtsev",