@webref/css 4.3.4 → 5.0.0

package/CSS.json

@@ -65,7 +65,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<uri>": {
       "prose": "URI values (Uniform Resource Identifiers, see [RFC3986], which includes URLs, URNs, etc) in this specification are denoted by <uri>. The functional notation used to designate URIs in property values is \"url()\", as in:"

package/README.md

@@ -15,7 +15,7 @@ for (const [shortname, data] of Object.entries(parsedFiles)) {
 }
 ```
 
-CSS fragments that appear in the objects, in other words the contents of the `properties[].value`, `properties[].newValues`, `descriptors[].value` and `valuespaces[].value` properties can be parsed with the [CSSTree Value Definition Syntax parser](https://github.com/csstree/csstree/blob/master/docs/definition-syntax.md#value-definition-syntax). Example:
+CSS fragments that appear in the objects, in other words the contents of the `properties[].value`, `properties[].newValues`, `atrules[].value`, `atrules[].descriptors[].value` and `valuespaces[].value` properties can be parsed with the [CSSTree Value Definition Syntax parser](https://github.com/csstree/csstree/blob/master/docs/definition-syntax.md#value-definition-syntax). Example:
 
 ```js
 const css = require('@webref/css');
@@ -40,6 +40,6 @@ for (const [shortname, data] of Object.entries(parsedFiles)) {
 # Guarantees
 
 The following guarantees are provided by this package:
-- All CSS files can be parsed by the version of [CSSTree](https://github.com/csstree/csstree) used in `peerDependencies` in `package.json`, with the exception of a handful CSS value definitions that, although valid, are not yet supported by CSSTree.
+- All values in CSS files can be parsed by the version of [CSSTree](https://github.com/csstree/csstree) used in `peerDependencies` in `package.json`.
 - No duplicate definitions of CSS properties provided that CSS extracts of [delta specs](https://github.com/w3c/browser-specs/#seriescomposition) are not taken into account (such extracts end with `-n.json`, where `n` is a level number).
 - CSS extracts contain a base definition of all CSS properties that get extended by other CSS property definitions (those for which `newValues` is set).

package/SVG.json

@@ -338,7 +338,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<points>": {
       "value": "[ <number>+ ]#"

package/compat.json

@@ -593,23 +593,23 @@
       ]
     }
   },
-  "descriptors": {
-    "-webkit-device-pixel-ratio": [
-      {
-        "name": "-webkit-device-pixel-ratio",
-        "for": "@media",
-        "value": "<number>",
-        "type": "range"
-      }
-    ],
-    "-webkit-transform-3d": [
-      {
-        "name": "-webkit-transform-3d",
-        "for": "@media",
-        "value": "<mq-boolean>",
-        "acceptsMin/maxPrefixes": "no"
-      }
-    ]
+  "atrules": {
+    "@media": {
+      "descriptors": [
+        {
+          "name": "-webkit-device-pixel-ratio",
+          "for": "@media",
+          "value": "<number>",
+          "type": "range"
+        },
+        {
+          "name": "-webkit-transform-3d",
+          "for": "@media",
+          "value": "<mq-boolean>",
+          "acceptsMin/maxPrefixes": "no"
+        }
+      ]
+    }
   },
   "valuespaces": {}
 }

package/compositing.json

@@ -52,7 +52,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<blend-mode>": {
       "value": "normal | multiply | screen | overlay | darken | lighten | color-dodge |color-burn | hard-light | soft-light | difference | exclusion | hue | saturation | color | luminosity"

package/css-align.json

@@ -205,7 +205,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<self-position>": {
       "value": "center | start | end | self-start | self-end | flex-start | flex-end"

package/css-animations-2.json

@@ -35,7 +35,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<single-animation-composition>": {
       "value": "replace | add | accumulate"

package/css-animations.json

@@ -139,7 +139,12 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {
+    "@keyframes": {
+      "value": "@keyframes <keyframes-name> { <rule-list> }",
+      "descriptors": []
+    }
+  },
   "valuespaces": {
     "<single-animation-iteration-count>": {
       "value": "infinite | <number [0,∞]>"

package/css-backgrounds-4.json

@@ -304,7 +304,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<position>": {
       "value": "[ [ left | center | right | top | bottom | start | end | <length-percentage> ] | [ left | center | right | x-start | x-end | <length-percentage> ] [ top | center | bottom | y-start | y-end | <length-percentage> ] | [ center | [ left | right | x-start | x-end ] <length-percentage>? ] && [ center | [ top | bottom | y-start | y-end ] <length-percentage>? ] | [ center | [ start | end ] <length-percentage>? ] [ center | [ start | end ] <length-percentage>? ] ]"

package/css-backgrounds.json

@@ -618,7 +618,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<bg-image>": {
       "value": "<image> | none"

package/css-box.json

@@ -168,7 +168,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<visual-box>": {
       "value": "content-box | padding-box | border-box"

package/css-break.json

@@ -108,6 +108,6 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {}
 }

package/css-cascade-6.json

@@ -4,7 +4,12 @@
     "url": "https://drafts.csswg.org/css-cascade-6/"
   },
   "properties": {},
-  "descriptors": {},
+  "atrules": {
+    "@scope": {
+      "value": "@scope (<scope-start>) [to (<scope-end>)]? { <stylesheet> }",
+      "descriptors": []
+    }
+  },
   "valuespaces": {
     "<scope-start>": {
       "prose": "The <scope-start> is a <forgiving-selector-list>. Each element matched by <scope-start> is a scoping element, creating a scope with itself as the scoping root."

package/css-cascade.json

@@ -19,10 +19,19 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {
+    "@import": {
+      "value": "@import [ <url> | <string> ] [ layer | layer(<layer-name>) ]? <import-condition> ;",
+      "descriptors": []
+    },
+    "@layer": {
+      "value": "@layer <layer-name>? { <stylesheet> }",
+      "descriptors": []
+    }
+  },
   "valuespaces": {
-    "<import-condition>": {
-      "value": "[ supports( [ <supports-condition> | <declaration> ] ) ]? <media-query-list>? ;"
+    "<import-conditions>": {
+      "value": "[ supports( [ <supports-condition> | <declaration> ] ) ]? <media-query-list>?"
     },
     "<layer-name>": {
       "value": "<ident> [ '.' <ident> ]*"

package/css-color-5.json

@@ -4,31 +4,30 @@
     "url": "https://drafts.csswg.org/css-color-5/"
   },
   "properties": {},
-  "descriptors": {
-    "src": [
-      {
-        "name": "src",
-        "for": "@color-profile",
-        "value": "<url>",
-        "initial": "n/a"
-      }
-    ],
-    "rendering-intent": [
-      {
-        "name": "rendering-intent",
-        "for": "@color-profile",
-        "value": "relative-colorimetric | absolute-colorimetric | perceptual | saturation",
-        "initial": "relative-colorimetric"
-      }
-    ],
-    "components": [
-      {
-        "name": "components",
-        "for": "@color-profile",
-        "value": "<ident>#",
-        "initial": "n/a"
-      }
-    ]
+  "atrules": {
+    "@color-profile": {
+      "value": "@color-profile [<dashed-ident> | device-cmyk] { <declaration-list> }",
+      "descriptors": [
+        {
+          "name": "src",
+          "for": "@color-profile",
+          "value": "<url>",
+          "initial": "n/a"
+        },
+        {
+          "name": "rendering-intent",
+          "for": "@color-profile",
+          "value": "relative-colorimetric | absolute-colorimetric | perceptual | saturation",
+          "initial": "relative-colorimetric"
+        },
+        {
+          "name": "components",
+          "for": "@color-profile",
+          "value": "<ident>#",
+          "initial": "n/a"
+        }
+      ]
+    }
   },
   "valuespaces": {
     "<color-mix()>": {

package/css-color-adjust.json

@@ -65,6 +65,6 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {}
 }

package/css-color.json

@@ -1,7 +1,7 @@
 {
   "spec": {
     "title": "CSS Color Module Level 4",
-    "url": "https://drafts.csswg.org/css-color/"
+    "url": "https://drafts.csswg.org/css-color-4/"
   },
   "properties": {
     "color": {
@@ -33,7 +33,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<color>": {
       "prose": "Colors in CSS are represented by the <color> type:",

package/css-conditional-4.json

@@ -4,7 +4,7 @@
     "url": "https://drafts.csswg.org/css-conditional-4/"
   },
   "properties": {},
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<supports-feature>": {
       "value": "<supports-selector-fn> | <supports-decl>"

package/css-conditional-5.json

@@ -4,7 +4,16 @@
     "url": "https://drafts.csswg.org/css-conditional-5/"
   },
   "properties": {},
-  "descriptors": {},
+  "atrules": {
+    "@when": {
+      "value": "@when <boolean-condition> { <stylesheet> }",
+      "descriptors": []
+    },
+    "@else": {
+      "value": "@else <boolean-condition>? { <stylesheet> }",
+      "descriptors": []
+    }
+  },
   "valuespaces": {
     "<supports-feature>": {
       "value": "<supports-selector-fn> | <supports-font-tech-fn> | <supports-font-format-fn> | <supports-decl>"

package/css-conditional.json

@@ -4,7 +4,16 @@
     "url": "https://drafts.csswg.org/css-conditional-3/"
   },
   "properties": {},
-  "descriptors": {},
+  "atrules": {
+    "@media": {
+      "value": "@media <media-query-list> { <stylesheet> }",
+      "descriptors": []
+    },
+    "@supports": {
+      "value": "@supports <supports-condition> { <stylesheet> }",
+      "descriptors": []
+    }
+  },
   "valuespaces": {
     "<supports-condition>": {
       "value": "not <supports-in-parens> | <supports-in-parens> [ and <supports-in-parens> ]* | <supports-in-parens> [ or <supports-in-parens> ]*"

package/css-contain-3.json

@@ -56,55 +56,48 @@
       ]
     }
   },
-  "descriptors": {
-    "width": [
-      {
-        "name": "width",
-        "for": "@container",
-        "value": "<length>",
-        "type": "range"
-      }
-    ],
-    "height": [
-      {
-        "name": "height",
-        "for": "@container",
-        "value": "<length>",
-        "type": "range"
-      }
-    ],
-    "inline-size": [
-      {
-        "name": "inline-size",
-        "for": "@container",
-        "value": "<length>",
-        "type": "range"
-      }
-    ],
-    "block-size": [
-      {
-        "name": "block-size",
-        "for": "@container",
-        "value": "<length>",
-        "type": "range"
-      }
-    ],
-    "aspect-ratio": [
-      {
-        "name": "aspect-ratio",
-        "for": "@container",
-        "value": "<ratio>",
-        "type": "range"
-      }
-    ],
-    "orientation": [
-      {
-        "name": "orientation",
-        "for": "@container",
-        "value": "portrait | landscape",
-        "type": "discrete"
-      }
-    ]
+  "atrules": {
+    "@container": {
+      "value": "@container [ <container-name> ]? <container-condition> { <stylesheet> }",
+      "descriptors": [
+        {
+          "name": "width",
+          "for": "@container",
+          "value": "<length>",
+          "type": "range"
+        },
+        {
+          "name": "height",
+          "for": "@container",
+          "value": "<length>",
+          "type": "range"
+        },
+        {
+          "name": "inline-size",
+          "for": "@container",
+          "value": "<length>",
+          "type": "range"
+        },
+        {
+          "name": "block-size",
+          "for": "@container",
+          "value": "<length>",
+          "type": "range"
+        },
+        {
+          "name": "aspect-ratio",
+          "for": "@container",
+          "value": "<ratio>",
+          "type": "range"
+        },
+        {
+          "name": "orientation",
+          "for": "@container",
+          "value": "portrait | landscape",
+          "type": "discrete"
+        }
+      ]
+    }
   },
   "valuespaces": {
     "<size-feature>": {

package/css-contain.json

@@ -34,6 +34,6 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {}
 }

package/css-content.json

@@ -93,7 +93,7 @@
       ]
     }
   },
-  "descriptors": {},
+  "atrules": {},
   "valuespaces": {
     "<content-replacement>": {
       "value": "<image>"

package/css-counter-styles.json

@@ -4,87 +4,72 @@
     "url": "https://drafts.csswg.org/css-counter-styles/"
   },
   "properties": {},
-  "descriptors": {
-    "system": [
-      {
-        "name": "system",
-        "for": "@counter-style",
-        "value": "cyclic | numeric | alphabetic | symbolic | additive | [fixed <integer>?] | [ extends <counter-style-name> ]",
-        "initial": "symbolic"
-      }
-    ],
-    "negative": [
-      {
-        "name": "negative",
-        "for": "@counter-style",
-        "value": "<symbol> <symbol>?",
-        "initial": "\"\\2D\" (\"-\" hyphen-minus)"
-      }
-    ],
-    "prefix": [
-      {
-        "name": "prefix",
-        "for": "@counter-style",
-        "value": "<symbol>",
-        "initial": "\"\" (the empty string)"
-      }
-    ],
-    "suffix": [
-      {
-        "name": "suffix",
-        "for": "@counter-style",
-        "value": "<symbol>",
-        "initial": "\"\\2E\\20\" (\".\" full stop followed by a space)"
-      }
-    ],
-    "range": [
-      {
-        "name": "range",
-        "for": "@counter-style",
-        "value": "[ [ <integer> | infinite ]{2} ]# | auto",
-        "initial": "auto"
-      }
-    ],
-    "pad": [
-      {
-        "name": "pad",
-        "for": "@counter-style",
-        "value": "<integer [0,∞]> && <symbol>",
-        "initial": "0 \"\""
-      }
-    ],
-    "fallback": [
-      {
-        "name": "fallback",
-        "for": "@counter-style",
-        "value": "<counter-style-name>",
-        "initial": "decimal"
-      }
-    ],
-    "symbols": [
-      {
-        "name": "symbols",
-        "for": "@counter-style",
-        "value": "<symbol>+",
-        "initial": "n/a"
-      }
-    ],
-    "additive-symbols": [
-      {
-        "name": "additive-symbols",
-        "for": "@counter-style",
-        "value": "[ <integer [0,∞]> && <symbol> ]#",
-        "initial": "n/a"
-      }
-    ],
-    "speak-as": [
-      {
-        "name": "speak-as",
-        "for": "@counter-style",
-        "value": "auto | bullets | numbers | words | spell-out | <counter-style-name>",
-        "initial": "auto"
-      }
-    ]
+  "atrules": {
+    "@counter-style": {
+      "value": "@counter-style <counter-style-name> { <declaration-list> }",
+      "descriptors": [
+        {
+          "name": "system",
+          "for": "@counter-style",
+          "value": "cyclic | numeric | alphabetic | symbolic | additive | [fixed <integer>?] | [ extends <counter-style-name> ]",
+          "initial": "symbolic"
+        },
+        {
+          "name": "negative",
+          "for": "@counter-style",
+          "value": "<symbol> <symbol>?",
+          "initial": "\"\\2D\" (\"-\" hyphen-minus)"
+        },
+        {
+          "name": "prefix",
+          "for": "@counter-style",
+          "value": "<symbol>",
+          "initial": "\"\" (the empty string)"
+        },
+        {
+          "name": "suffix",
+          "for": "@counter-style",
+          "value": "<symbol>",
+          "initial": "\"\\2E\\20\" (\".\" full stop followed by a space)"
+        },
+        {
+          "name": "range",
+          "for": "@counter-style",
+          "value": "[ [ <integer> | infinite ]{2} ]# | auto",
+          "initial": "auto"
+        },
+        {
+          "name": "pad",
+          "for": "@counter-style",
+          "value": "<integer [0,∞]> && <symbol>",
+          "initial": "0 \"\""
+        },
+        {
+          "name": "fallback",
+          "for": "@counter-style",
+          "value": "<counter-style-name>",
+          "initial": "decimal"
+        },
+        {
+          "name": "symbols",
+          "for": "@counter-style",
+          "value": "<symbol>+",
+          "initial": "n/a"
+        },
+        {
+          "name": "additive-symbols",
+          "for": "@counter-style",
+          "value": "[ <integer [0,∞]> && <symbol> ]#",
+          "initial": "n/a"
+        },
+        {
+          "name": "speak-as",
+          "for": "@counter-style",
+          "value": "auto | bullets | numbers | words | spell-out | <counter-style-name>",
+          "initial": "auto"
+        }
+      ]
+    }
   },
   "valuespaces": {
     "<counter-style-name>": {