@webref/css 6.25.3 → 6.25.5

package/css-values-5.json

@@ -652,18 +652,18 @@
       "type": "type",
       "value": "type( <syntax> ) | raw-string | number | <attr-unit>"
     },
+    {
+      "name": "<attr-unit>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-attr-unit",
+      "type": "type",
+      "value": "<custom-ident>"
+    },
     {
       "name": "<attr-args>",
       "href": "https://drafts.csswg.org/css-values-5/#typedef-attr-args",
       "type": "type",
       "value": "attr( <declaration-value>, <declaration-value>? )"
     },
-    {
-      "name": "<attr-unit>",
-      "prose": "The <attr-unit> production matches any identifier that is an ASCII case-insensitive match for the name of a CSS dimension unit, such as px, or the <delim-token> %. It is not expanded literally here, as the set of units expands over time.",
-      "href": "https://drafts.csswg.org/css-values-5/#typedef-attr-unit",
-      "type": "type"
-    },
     {
       "name": "ident()",
       "prose": "The ident() function represents an <ident>, and can be used to manually construct <custom-ident> values from several parts.",
@@ -682,83 +682,88 @@
       "prose": "The random() function is a math function that represents a random value between a minimum and maximum value, drawn from a uniform distribution, optionally limiting the possible values to a step between those limits:",
       "href": "https://drafts.csswg.org/css-values-5/#funcdef-random",
       "type": "function",
-      "value": "random( <random-cache-key>? , <calc-sum>, <calc-sum>, <calc-sum>? )"
+      "value": "random( <random-key>? , <calc-sum>, <calc-sum>, <calc-sum>? )"
     },
     {
-      "name": "<random-cache-key>",
-      "href": "https://drafts.csswg.org/css-values-5/#typedef-random-cache-key",
+      "name": "random-item()",
+      "prose": "The random-item() function resolves to a random item from among its list of items.",
+      "href": "https://drafts.csswg.org/css-values-5/#funcdef-random-item",
+      "type": "function",
+      "value": "random-item( <random-key> , [ <declaration-value>? ]# )"
+    },
+    {
+      "name": "<random-item-args>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-random-item-args",
       "type": "type",
-      "value": "auto | <random-name> | fixed <number [0,1]>",
+      "value": "random-item( <declaration-value>, [ <declaration-value>? ]# )"
+    },
+    {
+      "name": "<random-key>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-random-key",
+      "type": "type",
+      "value": "auto | <random-cache-key> | fixed <number [0,1]>",
       "values": [
         {
           "name": "auto",
-          "prose": "The random function is roughly \"as random as possible\": every usage in a property, between different properties, and between different elements will get a different random cache key. (See below for exact details.) If the <random-cache-key> is omitted, it behaves as auto.",
+          "prose": "The random function is roughly “as random as possible”: the random cache name, and thus the result, varies across every random() instance in a multi-component value, across different properties, and across different elements. This is equivalent to specifying element-scoped property-index-scoped, and simplifies in exactly the same way.",
           "href": "https://drafts.csswg.org/css-values-5/#valdef-random-auto",
           "type": "value",
           "value": "auto"
         },
         {
-          "name": "<random-name>",
-          "prose": "The <random-name> specifies the random cache key directly. It always contains a <dashed-ident>, specifying the name, and can optionally contain additional dynamic information: element adds an element identifier to the random cache key, so different elements will get different random values property adds the property name the random function is being used on to the random cache key, so different properties will get different random values property index adds the property name and the index of the random function among all the random functions used in the same property value to the random cache key, so multiple uses of a random function in the same property will get different random values.",
-          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-random-name",
+          "name": "<random-cache-key>",
+          "prose": "The <random-cache-key> specifies the random cache name, allowing it to be explicitly shared (or not) with other uses of random functions. Every random function using the same random cache name will get the same random value; every one using a different random cache name will get unrelated random values. The <dashed-ident> gives the value an explicit name. If omitted, this part of the name is null. element-scoped adds an element-specific identifier to the random cache name, so different elements will get different random values. property-scoped adds the property name the random function is being used on to the random cache name, so different properties will get different random values. Note that shorthand declarations will apply the shorthand property’s name. property-index-scoped adds the property name and the index of the random function among all the random functions used in the same property value to the random cache name, so multiple instances of a random function in the same declaration will each get different random cache names. Note this index is assigned before shorthand expansion. See § 9.4.1 Simplification of <random-key> for how these values resolve. The <random-ua-ident> value, like fixed below, isn’t intended to be specified by authors, but can show up in computed values. It is a <custom-ident> that must start with the prefix ua-, or else it is invalid. When generated automatically by the user agent, it will always be ua-PROPERTY or ua-PROPERTY-INDEX, with the PROPERTY and INDEX parts replaced with a property name or integer index, like ua-margin-3.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-random-cache-key",
           "type": "value",
-          "value": "<random-name>"
+          "value": "<random-cache-key>"
         },
         {
-          "name": "element",
-          "prose": "element adds an element identifier to the random cache key, so different elements will get different random values",
-          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-element",
+          "name": "<random-ua-ident>",
+          "prose": "The <random-ua-ident> value, like fixed below, isn’t intended to be specified by authors, but can show up in computed values. It is a <custom-ident> that must start with the prefix ua-, or else it is invalid. When generated automatically by the user agent, it will always be ua-PROPERTY or ua-PROPERTY-INDEX, with the PROPERTY and INDEX parts replaced with a property name or integer index, like ua-margin-3.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-random-ua-ident",
           "type": "value",
-          "value": "element"
+          "value": "<random-ua-ident>"
         },
         {
-          "name": "property",
-          "prose": "property adds the property name the random function is being used on to the random cache key, so different properties will get different random values",
-          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-property",
+          "name": "<number>",
+          "prose": "If fixed <number> is specified, the random function bypasses the random cache name entirely, and just uses the <number> as its random base value directly. While 1 is technically allowed as a valid value (because CSS grammars can only express closed ranges), the random base value is clamped to the highest representable value less than 1, so random base values remain in the half-open range `[0, 1)`.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-fixed",
           "type": "value",
-          "value": "property"
-        },
+          "value": "<number>"
+        }
+      ]
+    },
+    {
+      "name": "<random-cache-key>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-random-cache-key",
+      "type": "type",
+      "value": "<dashed-ident> || element-scoped || [ property-scoped | property-index-scoped | <random-ua-ident> ]",
+      "values": [
         {
-          "name": "index",
-          "prose": "property index adds the property name and the index of the random function among all the random functions used in the same property value to the random cache key, so multiple uses of a random function in the same property will get different random values.",
-          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-index",
+          "name": "element-scoped",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-element-scoped",
           "type": "value",
-          "value": "index"
+          "value": "element-scoped"
         },
         {
-          "name": "property index",
-          "prose": "property index adds the property name and the index of the random function among all the random functions used in the same property value to the random cache key, so multiple uses of a random function in the same property will get different random values.",
-          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-index",
+          "name": "property-scoped",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-property-scoped",
           "type": "value",
-          "value": "property index"
+          "value": "property-scoped"
         },
         {
-          "name": "<number>",
-          "prose": "If fixed <number> is specified, the random function bypasses the random cache key entirely, and just uses the <number> as its random base value directly. While 1 is technically allowed as a valid value (because CSS grammars can only express closed ranges), the random base value is clamped to the highest representable value less than 1, so random base values remain in the half-open range `[0, 1)`.",
-          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-fixed",
+          "name": "property-index-scoped",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-random-property-index-scoped",
           "type": "value",
-          "value": "<number>"
+          "value": "property-index-scoped"
         }
       ]
     },
     {
-      "name": "<random-name>",
-      "href": "https://drafts.csswg.org/css-values-5/#typedef-random-name",
+      "name": "<random-ua-ident>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-random-ua-ident",
       "type": "type",
-      "value": "<dashed-ident> [ element | property index? ]?"
-    },
-    {
-      "name": "random-item()",
-      "prose": "The random-item() function resolves to a random item from among its list of items.",
-      "href": "https://drafts.csswg.org/css-values-5/#funcdef-random-item",
-      "type": "function",
-      "value": "random-item( <random-cache-key> , [ <declaration-value>? ]# )"
-    },
-    {
-      "name": "<random-item-args>",
-      "href": "https://drafts.csswg.org/css-values-5/#typedef-random-item-args",
-      "type": "type",
-      "value": "random-item( <declaration-value>, [ <declaration-value>? ]# )"
+      "value": "<custom-ident>"
     },
     {
       "name": "sibling-count()",

package/motion.json

@@ -267,7 +267,7 @@
       "name": "<ray-size>",
       "href": "https://drafts.csswg.org/motion-1/#typedef-ray-size",
       "type": "type",
-      "value": "closest-side | closest-corner | farthest-side | farthest-corner | sides",
+      "value": "<radial-extent> | sides",
       "values": [
         {
           "name": "closest-side",

package/package.json

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

package/scroll-animations.json

@@ -12,7 +12,7 @@
       "appliesTo": "all elements",
       "inherited": "no",
       "percentages": "n/a",
-      "computedValue": "the keyword none or a list of CSS identifiers",
+      "computedValue": "list, each item either a CSS identifier or the keyword none",
       "canonicalOrder": "per grammar",
       "animationType": "not animatable",
       "styleDeclaration": [
@@ -115,7 +115,7 @@
       "appliesTo": "all elements",
       "inherited": "no",
       "percentages": "n/a",
-      "computedValue": "the keyword none or a list of CSS identifiers",
+      "computedValue": "list, each item either a CSS identifier or the keyword none",
       "canonicalOrder": "per grammar",
       "animationType": "not animatable",
       "styleDeclaration": [

package/selectors-5.json

@@ -93,6 +93,12 @@
       "prose": "where <level> is a <number-token> with its type flag set to \"integer\".",
       "href": "https://drafts.csswg.org/selectors-5/#typedef-level",
       "type": "type"
+    },
+    {
+      "name": "<combinator>",
+      "href": "https://drafts.csswg.org/selectors-5/#typedef-combinator",
+      "type": "type",
+      "value": "'>' | '+' | '~' | [ '|' '|' ] | [ / <wq-name> / ]"
     }
   ]
 }

package/selectors.json

@@ -469,7 +469,7 @@
       "name": "<combinator>",
       "href": "https://drafts.csswg.org/selectors-4/#typedef-combinator",
       "type": "type",
-      "value": "'>' | '+' | '~' | [ '|' '|' ]"
+      "value": "'>' | '+' | '~'"
     },
     {
       "name": "<wq-name>",

package/svg-strokes.json

@@ -13,7 +13,7 @@
       "inherited": "yes",
       "percentages": "N/A",
       "media": "visual",
-      "computed value": "as specified",
+      "computedValue": "as specified",
       "animatable": "yes",
       "styleDeclaration": [
         "stroke-alignment",
@@ -29,7 +29,7 @@
       "inherited": "yes",
       "percentages": "refer to the size of the current viewport (see Units)",
       "media": "visual",
-      "computed value": "absolute length or keyword specified",
+      "computedValue": "absolute length or keyword specified",
       "animatable": "yes",
       "styleDeclaration": [
         "stroke-dashcorner",
@@ -45,7 +45,7 @@
       "inherited": "yes",
       "percentages": "N/A",
       "media": "visual",
-      "computed value": "as specified",
+      "computedValue": "as specified",
       "animatable": "yes",
       "styleDeclaration": [
         "stroke-dashadjust",