@webref/css 6.3.0 → 6.3.2

package/css-animations-2.json

@@ -62,19 +62,19 @@
         },
         {
           "name": "<custom-ident>",
-          "prose": "If a named scroll progress timeline or view progress timeline is in scope on this element, use the referenced timeline as defined in Scroll-linked Animations 1 § 4 Named Timeline Scoping. Otherwise the animation is not associated with a timeline.",
+          "prose": "If a named scroll progress timeline or view progress timeline is in scope on this element, use the referenced timeline as defined in Scroll-linked Animations § 4 Named Timeline Scoping. Otherwise the animation is not associated with a timeline.",
           "type": "value",
           "value": "<custom-ident>"
         },
         {
           "name": "<scroll()>",
-          "prose": "Use the scroll progress timeline indicated by the given scroll() function. See Scroll-linked Animations 1 § 2.1.1 The scroll() notation.",
+          "prose": "Use the scroll progress timeline indicated by the given scroll() function. See Scroll-linked Animations § 2.1.1 The scroll() notation.",
           "type": "value",
           "value": "<scroll()>"
         },
         {
           "name": "<view()>",
-          "prose": "Use the view progress timeline indicated by the given view() function. See Scroll-linked Animations 1 § 3.2.1 The view() notation.",
+          "prose": "Use the view progress timeline indicated by the given view() function. See Scroll-linked Animations § 3.2.1 The view() notation.",
           "type": "value",
           "value": "<view()>"
         }

package/css-color-5.json

@@ -71,25 +71,25 @@
       "values": [
         {
           "name": "r",
-          "prose": "r, g, and b are all <percentage>s or <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to sRGB. For <number>s, 255 (or 255.0) is equivalent to 100%.",
+          "prose": "r, g, and b are all <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to sRGB. 255.0 is equivalent to 100%.",
           "type": "value",
           "value": "r"
         },
         {
           "name": "g",
-          "prose": "r, g, and b are all <percentage>s or <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to sRGB. For <number>s, 255 (or 255.0) is equivalent to 100%.",
+          "prose": "r, g, and b are all <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to sRGB. 255.0 is equivalent to 100%.",
           "type": "value",
           "value": "g"
         },
         {
           "name": "b",
-          "prose": "r, g, and b are all <percentage>s or <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to sRGB. For <number>s, 255 (or 255.0) is equivalent to 100%.",
+          "prose": "r, g, and b are all <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to sRGB. 255.0 is equivalent to 100%.",
           "type": "value",
           "value": "b"
         },
         {
           "name": "alpha",
-          "prose": "alpha is a <number> or <percentage> that corresponds to the origin color’s alpha transparency",
+          "prose": "alpha is a <number> that corresponds to the origin color’s alpha transparency",
           "type": "value",
           "value": "alpha"
         }
@@ -107,25 +107,25 @@
       "values": [
         {
           "name": "h",
-          "prose": "h is an <angle> that corresponds to the origin color’s HSL hue after its conversion to sRGB, normalized to a [0deg, 360deg) range",
+          "prose": "h is an <angle> that corresponds to the origin color’s HSL hue after its conversion to sRGB, normalized to a [0, 360] range",
           "type": "value",
           "value": "h"
         },
         {
           "name": "s",
-          "prose": "s and l are <percentage>s or <number>s that correspond to the origin color’s HSL saturation and lightness after its conversion to sRGB",
+          "prose": "s and l are <percentage>s that correspond to the origin color’s HSL saturation and lightness, after its conversion to sRGB",
           "type": "value",
           "value": "s"
         },
         {
           "name": "l",
-          "prose": "s and l are <percentage>s or <number>s that correspond to the origin color’s HSL saturation and lightness after its conversion to sRGB",
+          "prose": "s and l are <percentage>s that correspond to the origin color’s HSL saturation and lightness, after its conversion to sRGB",
           "type": "value",
           "value": "l"
         },
         {
           "name": "alpha",
-          "prose": "alpha is a <number> or <percentage> that corresponds to the origin color’s alpha transparency",
+          "prose": "alpha is a <number> that corresponds to the origin color’s alpha transparency",
           "type": "value",
           "value": "alpha"
         }
@@ -138,25 +138,25 @@
       "values": [
         {
           "name": "h",
-          "prose": "h is an <angle> that corresponds to the origin color’s HWB hue after its conversion to sRGB, normalized to a [0deg, 360deg) range",
+          "prose": "h is an <angle> that corresponds to the origin color’s HWB hue after its conversion to sRGB, normalized to a [0, 360] range",
           "type": "value",
           "value": "h"
         },
         {
           "name": "w",
-          "prose": "w and b are <percentage>s or <number>s that correspond to the origin color’s HWB whiteness and blackness after its conversion to sRGB",
+          "prose": "w and b are <percentage>s that correspond to the origin color’s HWB whiteness and blackness after its conversion to sRGB",
           "type": "value",
           "value": "w"
         },
         {
           "name": "b",
-          "prose": "w and b are <percentage>s or <number>s that correspond to the origin color’s HWB whiteness and blackness after its conversion to sRGB",
+          "prose": "w and b are <percentage>s that correspond to the origin color’s HWB whiteness and blackness after its conversion to sRGB",
           "type": "value",
           "value": "b"
         },
         {
           "name": "alpha",
-          "prose": "alpha is a <number> or <percentage> that corresponds to the origin color’s alpha transparency",
+          "prose": "alpha is a <number> that corresponds to the origin color’s alpha transparency",
           "type": "value",
           "value": "alpha"
         }
@@ -169,25 +169,25 @@
       "values": [
         {
           "name": "l",
-          "prose": "l is a <percentage> or <number> that corresponds to the origin color’s CIE Lightness",
+          "prose": "l is a <number> that corresponds to the origin color’s CIE Lightness",
           "type": "value",
           "value": "l"
         },
         {
           "name": "a",
-          "prose": "a and b are <percentage>s or <number>s that correspond to the origin color’s CIELab a and b axes",
+          "prose": "a and b are <number>s that correspond to the origin color’s CIELab a and b axes",
           "type": "value",
           "value": "a"
         },
         {
           "name": "b",
-          "prose": "a and b are <percentage>s or <number>s that correspond to the origin color’s CIELab a and b axes",
+          "prose": "a and b are <number>s that correspond to the origin color’s CIELab a and b axes",
           "type": "value",
           "value": "b"
         },
         {
           "name": "alpha",
-          "prose": "alpha is a <number> or <percentage> that corresponds to the origin color’s alpha transparency",
+          "prose": "alpha is a <number> that corresponds to the origin color’s alpha transparency",
           "type": "value",
           "value": "alpha"
         }
@@ -200,25 +200,25 @@
       "values": [
         {
           "name": "l",
-          "prose": "l is a <percentage> or <number> that corresponds to the origin color’s Oklab Lightness",
+          "prose": "l is a <number> that corresponds to the origin color’s Oklab Lightness",
           "type": "value",
           "value": "l"
         },
         {
           "name": "a",
-          "prose": "a and b are <percentage>s or <number>s that correspond to the origin color’s Oklab a and b axes",
+          "prose": "a and b are <number>s that correspond to the origin color’s Oklab a and b axes",
           "type": "value",
           "value": "a"
         },
         {
           "name": "b",
-          "prose": "a and b are <percentage>s or <number>s that correspond to the origin color’s Oklab a and b axes",
+          "prose": "a and b are <number>s that correspond to the origin color’s Oklab a and b axes",
           "type": "value",
           "value": "b"
         },
         {
           "name": "alpha",
-          "prose": "alpha is a <number> or <percentage> that corresponds to the origin color’s alpha transparency",
+          "prose": "alpha is a <number> that corresponds to the origin color’s alpha transparency",
           "type": "value",
           "value": "alpha"
         }
@@ -231,25 +231,25 @@
       "values": [
         {
           "name": "l",
-          "prose": "l is a <percentage> or <number> that corresponds to the origin color’s CIE Lightness",
+          "prose": "l is a <number> that corresponds to the origin color’s CIE Lightness",
           "type": "value",
           "value": "l"
         },
         {
           "name": "c",
-          "prose": "c is a <percentage> or <number> that corresponds to the origin color’s LCH chroma",
+          "prose": "c is a <number> that corresponds to the origin color’s LCH chroma",
           "type": "value",
           "value": "c"
         },
         {
           "name": "h",
-          "prose": "h is an <angle> that corresponds to the origin color’s LCH hue, normalized to a [0deg, 360deg) range.",
+          "prose": "h is an <angle> that corresponds to the origin color’s LCH hue, normalized to a [0, 360] range.",
           "type": "value",
           "value": "h"
         },
         {
           "name": "alpha",
-          "prose": "alpha is a <number> or <percentage> that corresponds to the origin color’s alpha transparency",
+          "prose": "alpha is a <number> that corresponds to the origin color’s alpha transparency",
           "type": "value",
           "value": "alpha"
         }
@@ -262,25 +262,25 @@
       "values": [
         {
           "name": "l",
-          "prose": "l is a <percentage> or <number> that corresponds to the origin color’s Oklab Lightness",
+          "prose": "l is a <number> that corresponds to the origin color’s Oklab Lightness",
           "type": "value",
           "value": "l"
         },
         {
           "name": "c",
-          "prose": "c is a <percentage> or <number> that corresponds to the origin color’s Oklch chroma",
+          "prose": "c is a <number> that corresponds to the origin color’s Oklch chroma",
           "type": "value",
           "value": "c"
         },
         {
           "name": "h",
-          "prose": "h is an <angle> that corresponds to the origin color’s Oklch hue, normalized to a [0deg, 360deg) range.",
+          "prose": "h is an <angle> that corresponds to the origin color’s Oklch hue, normalized to a [0, 360] range.",
           "type": "value",
           "value": "h"
         },
         {
           "name": "alpha",
-          "prose": "alpha is a <number> or <percentage> that corresponds to the origin color’s alpha transparency",
+          "prose": "alpha is a <number> that corresponds to the origin color’s alpha transparency",
           "type": "value",
           "value": "alpha"
         }
@@ -293,37 +293,37 @@
       "values": [
         {
           "name": "r",
-          "prose": "r, g, and b are all <percentage>s or <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to the predefined RGB color space.",
+          "prose": "r, g, and b are all <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to the predefined RGB color space.",
           "type": "value",
           "value": "r"
         },
         {
           "name": "g",
-          "prose": "r, g, and b are all <percentage>s or <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to the predefined RGB color space.",
+          "prose": "r, g, and b are all <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to the predefined RGB color space.",
           "type": "value",
           "value": "g"
         },
         {
           "name": "b",
-          "prose": "r, g, and b are all <percentage>s or <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to the predefined RGB color space.",
+          "prose": "r, g, and b are all <number>s that correspond to the origin color’s red, green, and blue channels after its conversion to the predefined RGB color space.",
           "type": "value",
           "value": "b"
         },
         {
           "name": "x",
-          "prose": "x, y, z are all <percentage>s or <number>s that correspond to the origin color’s X, Y and Z channels after its conversion to relative CIE XYZ color space adapted to the relevant white point.",
+          "prose": "x, y, z are all <number>s that correspond to the origin color’s X, Y and Z channels after its conversion to relative CIE XYZ color space adapted to the relevant white point.",
           "type": "value",
           "value": "x"
         },
         {
           "name": "y",
-          "prose": "x, y, z are all <percentage>s or <number>s that correspond to the origin color’s X, Y and Z channels after its conversion to relative CIE XYZ color space adapted to the relevant white point.",
+          "prose": "x, y, z are all <number>s that correspond to the origin color’s X, Y and Z channels after its conversion to relative CIE XYZ color space adapted to the relevant white point.",
           "type": "value",
           "value": "y"
         },
         {
           "name": "z",
-          "prose": "x, y, z are all <percentage>s or <number>s that correspond to the origin color’s X, Y and Z channels after its conversion to relative CIE XYZ color space adapted to the relevant white point.",
+          "prose": "x, y, z are all <number>s that correspond to the origin color’s X, Y and Z channels after its conversion to relative CIE XYZ color space adapted to the relevant white point.",
           "type": "value",
           "value": "z"
         }

package/css-color-6.json

@@ -41,7 +41,7 @@
     {
       "name": "<wcag2>",
       "type": "type",
-      "value": "wcag | wcag2([<number> | [ aa | aaa ] && large? ])"
+      "value": "wcag2 | wcag2([<number> | [ aa | aaa ] && large? ])"
     }
   ]
 }

package/css-color.json

@@ -1001,7 +1001,7 @@
       "values": [
         {
           "name": "Lab",
-          "prose": "Lab is a rectangular coordinate system with a central Lightness axis. This value is usually written as a unitless number; for compatibility with the rest of CSS, it is written as a percentage. 100% means an L value of 100, not 1.0. L=0% is deep black (no light at all) while L=100% is a diffuse white",
+          "prose": "Lab is a rectangular coordinate system with a central Lightness (L) axis. This value is usually written as a unitless number; for compatibility with the rest of CSS, it may also be written as a percentage. 100% means an L value of 100, not 1.0. L=0% or 0 is deep black (no light at all) while L=100% or 100 is a diffuse white.",
           "type": "value",
           "value": "Lab"
         }

package/css-display.json

@@ -28,7 +28,7 @@
     },
     {
       "name": "order",
-      "value": "[ <'layout-order'> <'reading-order'>? ] | [ reading && <'reading-order'> ] | [ layout && <'layout-order'> ] | [ reading-and-layout && <integer> ]",
+      "value": "[ <'layout-order'> <'reading-order'>? ] | [ [ reading || layout ] && <integer> ]",
       "initial": "see individual properties",
       "appliesTo": "flex items and grid items",
       "inherited": "no",
@@ -38,16 +38,22 @@
       "canonicalOrder": "per grammar",
       "values": [
         {
-          "name": "reading-and-layout",
-          "prose": "The order property sets both layout-order and reading-order in a single declaration. Unless reading-and-layout is specified—in which case both <'reading-order'> and <'layout-order'> are set to the specified <integer> value—the omitted longhand is set to zero.",
+          "name": "<integer>",
+          "prose": "If one integer and no keyword is specified, then sets layout-order to the specified integer, and sets reading-order to its initial value. If two integers are specified, the first sets layout-order and the second sets reading-order. Otherwise sets the appropriate longhand(s) to the specified integer(s).",
           "type": "value",
-          "value": "reading-and-layout"
+          "value": "<integer>"
         },
         {
-          "name": "<integer>",
-          "prose": "Specifically, the layout-order property controls the order in which flex items or grid items appear within their container by assigning them to the ordinal groups, as specified by its <integer> value.",
+          "name": "layout",
+          "prose": "Indicates setting layout-order to the specified integer. If reading is not specified, reading-order is set to its initial value.",
           "type": "value",
-          "value": "<integer>"
+          "value": "layout"
+        },
+        {
+          "name": "reading",
+          "prose": "Indicates setting reading-order to the specified integer. If layout is not specified, layout-order is set to its initial value.",
+          "type": "value",
+          "value": "reading"
         }
       ],
       "styleDeclaration": [
@@ -87,6 +93,14 @@
       "computedValue": "specified integer",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value type",
+      "values": [
+        {
+          "name": "<integer>",
+          "prose": "Specifically, the layout-order property controls the order in which flex items or grid items appear within their container by assigning them to the ordinal groups, as specified by its <integer> value.",
+          "type": "value",
+          "value": "<integer>"
+        }
+      ],
       "styleDeclaration": [
         "layout-order",
         "layoutOrder"

package/css-ui.json

@@ -55,7 +55,7 @@
       "appliesTo": "all elements",
       "inherited": "no",
       "percentages": "N/A",
-      "computedValue": "The computed value for invert is invert. For <color> values, see CSS Color 4 § 14 Resolving <color> Values in [CSS-COLOR-4]. For <image-1D> values, see CSS Images 4 § 4 1D Image Values: the <image-1D> type and stripes() notation in [CSS-IMAGES-4].",
+      "computedValue": "The computed value for invert is invert. For <color> values, see CSS Color 4 § 14. Resolving <color> Values in [CSS-COLOR-4]. For <image-1D> values, see CSS Images 4 § 4 1D Image Values: the <image-1D> type and stripes() notation in [CSS-IMAGES-4].",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value",
       "values": [

package/css-values-5.json

@@ -106,6 +106,23 @@
       "name": "<dimension-unit>",
       "prose": "The <dimension-unit> production matches a literal \"%\" character (that is, a <delim-token> with a value of \"%\") or an ident whose value is any of the CSS units for <length>, <angle>, <time>, <frequency>, or <flex> values (such as px or ms).",
       "type": "type"
+    },
+    {
+      "name": "random()",
+      "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:",
+      "type": "function",
+      "value": "random( <random-caching-options>? , <calc-sum>, <calc-sum>, [by <calc-sum>]? );"
+    },
+    {
+      "name": "<random-caching-options>",
+      "type": "type",
+      "value": "<dashed-ident> || per-element"
+    },
+    {
+      "name": "random-item()",
+      "prose": "The random-item() function resolves to a random item from among its list of items.",
+      "type": "function",
+      "value": "random-item( <random-caching-options> ';' <any-value> [ ';' <any-value> ]* )"
     }
   ]
 }

package/css-view-transitions.json

@@ -38,7 +38,7 @@
   "selectors": [
     {
       "name": "::view-transition",
-      "prose": "This pseudo-element is the grouping container of all the other view-transition pseudo-elements. Its originating element is the document’s document element. The following is added to the HTML user agent style sheet: html::view-transition { position: fixed; inset: 0; }"
+      "prose": "A tree-abiding pseudo-element that is also a pseudo-element root. Its originating element is the document’s document element. Its containing block is the snapshot root. The following is added to the HTML user agent style sheet: html::view-transition { position: fixed; inset: 0; }"
     },
     {
       "name": "::view-transition-group()",

package/mediaqueries-5.json

@@ -501,7 +501,7 @@
           "values": [
             {
               "name": "active",
-              "prose": "Indicates that forced colors mode is active: the user agent enforces a user-chosen limited color palette on the page, The UA will provide the color palette to authors through the CSS system color keywords. See CSS Color Adjust § 3 Forced Color Palettes for details. This does not necessarily indicate a preference for more contrast. The colors have been forcibly adjusted to match the preference of the user, but that preference can be for less or more contrast, or some other arrangement that is neither particularly low or high contrast. In addition to forced-colors: active, the user agent must also match one of prefers-contrast: more or prefers-contrast: less if it can determine that the forced color palette chosen by the user has a particularly high or low contrast, and must make prefers-contrast: custom match otherwise. Similarly, if the forced color palette chosen by the user fits within one of the color schemes described by prefers-color-scheme, the corresponding value must also match.",
+              "prose": "Indicates that forced colors mode is active: the user agent enforces a user-chosen limited color palette on the page, The UA will provide the color palette to authors through the CSS system color keywords. See CSS Color Adjustment 1 § 3 Forced Color Palettes for details. This does not necessarily indicate a preference for more contrast. The colors have been forcibly adjusted to match the preference of the user, but that preference can be for less or more contrast, or some other arrangement that is neither particularly low or high contrast. In addition to forced-colors: active, the user agent must also match one of prefers-contrast: more or prefers-contrast: less if it can determine that the forced color palette chosen by the user has a particularly high or low contrast, and must make prefers-contrast: custom match otherwise. Similarly, if the forced color palette chosen by the user fits within one of the color schemes described by prefers-color-scheme, the corresponding value must also match.",
               "type": "value",
               "value": "active"
             },

package/package.json

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

package/scroll-animations.json

@@ -1,6 +1,6 @@
 {
   "spec": {
-    "title": "Scroll-linked Animations",
+    "title": "Scroll-driven Animations",
     "url": "https://drafts.csswg.org/scroll-animations-1/"
   },
   "properties": [