@webref/css 7.1.4 → 8.0.0

package/CHANGELOG.md

@@ -7,6 +7,17 @@ Webref adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
 applied to data. A new major version is released whenever a breaking change is
 made to the data structure.
 
+## v8.0.0 - 2025-10-17
+
+### Breaking change
+
+Subsidiary at-rules are now reported at the root level, scoped to their parent at-rule through a `for` property.
+
+### How to upgrade
+
+Unless you're processing at-rules and only expecting unscoped ones, upgrade from version 7 should not require any code update. If you need to list only unscoped at-rules, filter out those that have a `for` property.
+
+
 ## v7.0.11 - 2025-09-04
 
 CSS extracts are now consolidated into a single file.

package/README.md

@@ -51,6 +51,7 @@ const ast = definitionSyntax.parse(properties['flex'].syntax);
 Additional keys may be set depending on the type of the CSS feature. For example:
 
 - At-rules have a `descriptors` key that contains the list of descriptors defined for the given at-rule. That list may not be exhaustive. For example, it does not contain descriptors that are only implicitly defined in specs, such as families of properties that some at-rules (e.g, `@position-try`) accept as descriptors.
+- At-rule that are scoped to another at-rules have a `for` key that contains the list of scoping at-rules.
 - Functions and types that are scoped to a property or other feature have a `for` key that contains the list of scoping features for that feature. A scoping feature may be a property, a function or a type. When the scoping feature is a type, its name in the `for` key is enclosed between `<` and `>`.
 - Properties have a `styleDeclaration` key that contains the list of IDL attribute names that the property generates. A number of other keys may be set to describe the property's initial value, animation type and other parameters.
 

package/css.json

@@ -6,6 +6,16 @@
       "descriptors": [],
       "extended": []
     },
+    {
+      "descriptors": [],
+      "name": "@annotation",
+      "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-annotation",
+      "for": [
+        "@font-feature-values"
+      ],
+      "syntax": "@annotation { <declaration-list> }",
+      "extended": []
+    },
     {
       "name": "@apply",
       "href": "https://drafts.csswg.org/css-mixins-1/#at-ruledef-apply",
@@ -48,6 +58,16 @@
       "syntax": "@bottom-right-corner { <declaration-list> };",
       "extended": []
     },
+    {
+      "descriptors": [],
+      "name": "@character-variant",
+      "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-character-variant",
+      "for": [
+        "@font-feature-values"
+      ],
+      "syntax": "@character-variant { <declaration-list> }",
+      "extended": []
+    },
     {
       "name": "@charset",
       "prose": "However, there is no actual at-rule named @charset. When a stylesheet is actually parsed, any occurrences of an @charset rule must be treated as an unrecognized rule, and thus dropped as invalid when the stylesheet is grammar-checked.",
@@ -438,55 +458,6 @@
       "name": "@font-feature-values",
       "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values",
       "descriptors": [
-        {
-          "name": "@annotation",
-          "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-annotation",
-          "type": "at-rule",
-          "for": "@font-feature-values",
-          "syntax": "@annotation { <declaration-list> }"
-        },
-        {
-          "name": "@character-variant",
-          "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-character-variant",
-          "type": "at-rule",
-          "for": "@font-feature-values",
-          "syntax": "@character-variant { <declaration-list> }"
-        },
-        {
-          "name": "@historical-forms",
-          "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-historical-forms",
-          "type": "at-rule",
-          "for": "@font-feature-values",
-          "syntax": "@historical-forms { <declaration-list> }"
-        },
-        {
-          "name": "@ornaments",
-          "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-ornaments",
-          "type": "at-rule",
-          "for": "@font-feature-values",
-          "syntax": "@ornaments { <declaration-list> }"
-        },
-        {
-          "name": "@styleset",
-          "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-styleset",
-          "type": "at-rule",
-          "for": "@font-feature-values",
-          "syntax": "@styleset { <declaration-list> }"
-        },
-        {
-          "name": "@stylistic",
-          "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-stylistic",
-          "type": "at-rule",
-          "for": "@font-feature-values",
-          "syntax": "@stylistic { <declaration-list> }"
-        },
-        {
-          "name": "@swash",
-          "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-swash",
-          "type": "at-rule",
-          "for": "@font-feature-values",
-          "syntax": "@swash { <declaration-list> }"
-        },
         {
           "name": "font-display",
           "href": "https://drafts.csswg.org/css-fonts-4/#descdef-font-feature-values-font-display",
@@ -543,6 +514,16 @@
       "syntax": "@function <function-token> <function-parameter>#? ) [ returns <css-type> ]? { <declaration-rule-list> }",
       "extended": []
     },
+    {
+      "descriptors": [],
+      "name": "@historical-forms",
+      "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-historical-forms",
+      "for": [
+        "@font-feature-values"
+      ],
+      "syntax": "@historical-forms { <declaration-list> }",
+      "extended": []
+    },
     {
       "name": "@import",
       "prose": "The @import rule allows users to import style rules from other style sheets. If an @import rule refers to a valid stylesheet, user agents must treat the contents of the stylesheet as if they were written in place of the @import rule, with two exceptions:",
@@ -892,6 +873,16 @@
       "syntax": "@namespace <namespace-prefix>? [ <string> | <url> ] ;",
       "extended": []
     },
+    {
+      "descriptors": [],
+      "name": "@ornaments",
+      "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-ornaments",
+      "for": [
+        "@font-feature-values"
+      ],
+      "syntax": "@ornaments { <declaration-list> }",
+      "extended": []
+    },
     {
       "name": "@page",
       "prose": "Authors can specify various aspects of a page box, such as its dimensions, orientation, and margins, within an @page rule. @page rules are allowed wherever rule-sets are allowed. An @page rule consists of the keyword @page, an optional comma-separated list of page selectors and a block of declarations (said to be in the page context). An @page rule can also contain other at-rules, interleaved between declarations. The current level of this specification only allows margin at-rules inside @page.",
@@ -1006,6 +997,26 @@
       "descriptors": [],
       "extended": []
     },
+    {
+      "descriptors": [],
+      "name": "@styleset",
+      "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-styleset",
+      "for": [
+        "@font-feature-values"
+      ],
+      "syntax": "@styleset { <declaration-list> }",
+      "extended": []
+    },
+    {
+      "descriptors": [],
+      "name": "@stylistic",
+      "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-stylistic",
+      "for": [
+        "@font-feature-values"
+      ],
+      "syntax": "@stylistic { <declaration-list> }",
+      "extended": []
+    },
     {
       "name": "@supports",
       "prose": "The @supports rule is a conditional group rule whose condition tests whether the user agent supports CSS property:value pairs. Authors can use it to write style sheets that use new features when available but degrade gracefully when those features are not supported. These queries are called CSS feature queries or (colloquially) supports queries.",
@@ -1014,6 +1025,24 @@
       "syntax": "@supports <supports-condition> { <rule-list> }",
       "extended": []
     },
+    {
+      "name": "@supports-condition",
+      "prose": "The @supports-condition at-rule is a conditional group rule that allows authors to define and name a supports query for later reuse, creating a named supports condition. This enables complex or frequently-used feature queries to be referenced by name, improving maintainability and readability.",
+      "href": "https://drafts.csswg.org/css-conditional-5/#at-ruledef-supports-condition",
+      "descriptors": [],
+      "syntax": "@supports-condition <supports-condition-name> { <block-contents> }",
+      "extended": []
+    },
+    {
+      "descriptors": [],
+      "name": "@swash",
+      "href": "https://drafts.csswg.org/css-fonts-4/#at-ruledef-font-feature-values-swash",
+      "for": [
+        "@font-feature-values"
+      ],
+      "syntax": "@swash { <declaration-list> }",
+      "extended": []
+    },
     {
       "name": "@top-center",
       "href": "https://drafts.csswg.org/css-page-3/#at-ruledef-top-center",
@@ -18925,10 +18954,16 @@
       "syntax": "not <supports-in-parens> | <supports-in-parens> [ and <supports-in-parens> ]* | <supports-in-parens> [ or <supports-in-parens> ]*",
       "extended": []
     },
+    {
+      "name": "supports-condition-name",
+      "prose": "Where <supports-condition-name> is an <extension-name> that defines the name of the supports query.",
+      "href": "https://drafts.csswg.org/css-conditional-5/#typedef-supports-condition-name",
+      "extended": []
+    },
     {
       "name": "supports-decl",
-      "href": "https://drafts.csswg.org/css-conditional-3/#typedef-supports-decl",
-      "syntax": "( <declaration> )",
+      "href": "https://drafts.csswg.org/css-conditional-5/#typedef-supports-decl",
+      "syntax": "( [ <declaration> | <supports-condition-name> ] )",
       "extended": []
     },
     {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@webref/css",
   "description": "CSS definitions of the web platform",
-  "version": "7.1.4",
+  "version": "8.0.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/w3c/webref.git"