@webref/css 6.25.2 → 6.25.4

package/css-sizing-4.json

@@ -435,12 +435,49 @@
       "href": "https://drafts.csswg.org/css-sizing-4/#propdef-frame-sizing",
       "value": "auto | content-width | content-height | content-block-size | content-inline-size",
       "initial": "auto",
-      "appliesTo": "iframe elements",
+      "appliesTo": "replaced elements (but see below for details)",
       "inherited": "no",
       "percentages": "n/a",
-      "computedValue": "specified keyword",
+      "computedValue": "as specified",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "auto",
+          "prose": "The element’s internal layout intrinsic size, if any, is ignored.",
+          "href": "https://drafts.csswg.org/css-sizing-4/#valdef-frame-sizing-auto",
+          "type": "value",
+          "value": "auto"
+        },
+        {
+          "name": "content-width",
+          "prose": "If the element has an internal layout intrinsic size, its intrinsic size takes the corresponding dimension (either width or height) from the internal layout intrinsic size. (The other dimension is determined normally.) Logical directions resolve based on the writing mode of the element. (Not the embedded document.)",
+          "href": "https://drafts.csswg.org/css-sizing-4/#valdef-frame-sizing-content-width",
+          "type": "value",
+          "value": "content-width"
+        },
+        {
+          "name": "content-height",
+          "prose": "If the element has an internal layout intrinsic size, its intrinsic size takes the corresponding dimension (either width or height) from the internal layout intrinsic size. (The other dimension is determined normally.) Logical directions resolve based on the writing mode of the element. (Not the embedded document.)",
+          "href": "https://drafts.csswg.org/css-sizing-4/#valdef-frame-sizing-content-height",
+          "type": "value",
+          "value": "content-height"
+        },
+        {
+          "name": "content-block-size",
+          "prose": "If the element has an internal layout intrinsic size, its intrinsic size takes the corresponding dimension (either width or height) from the internal layout intrinsic size. (The other dimension is determined normally.) Logical directions resolve based on the writing mode of the element. (Not the embedded document.)",
+          "href": "https://drafts.csswg.org/css-sizing-4/#valdef-frame-sizing-content-block-size",
+          "type": "value",
+          "value": "content-block-size"
+        },
+        {
+          "name": "content-inline-size",
+          "prose": "If the element has an internal layout intrinsic size, its intrinsic size takes the corresponding dimension (either width or height) from the internal layout intrinsic size. (The other dimension is determined normally.) Logical directions resolve based on the writing mode of the element. (Not the embedded document.)",
+          "href": "https://drafts.csswg.org/css-sizing-4/#valdef-frame-sizing-content-inline-size",
+          "type": "value",
+          "value": "content-inline-size"
+        }
+      ],
       "styleDeclaration": [
         "frame-sizing",
         "frameSizing"

package/css-text-4.json

@@ -1142,6 +1142,73 @@
         "textGroupAlign"
       ]
     },
+    {
+      "name": "text-fit",
+      "href": "https://drafts.csswg.org/css-text-4/#propdef-text-fit",
+      "value": "[ none | grow | shrink ] [consistent | per-line | per-line-all]? <percentage>?",
+      "initial": "none",
+      "appliesTo": "block containers",
+      "inherited": "no",
+      "percentages": "N/A",
+      "computedValue": "specified keywords or computed <percentage> value",
+      "canonicalOrder": "per grammar",
+      "animationType": "discrete",
+      "values": [
+        {
+          "name": "none",
+          "prose": "The user agent doesn’t scale inline-level contents to fit to the line box.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-fit-none",
+          "type": "value",
+          "value": "none"
+        },
+        {
+          "name": "grow",
+          "prose": "The user agent scales up inline-level contents to fit to the line box.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-fit-grow",
+          "type": "value",
+          "value": "grow"
+        },
+        {
+          "name": "shrink",
+          "prose": "The user agent scales down inline-level contents to fit to the line box.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-fit-shrink",
+          "type": "value",
+          "value": "shrink"
+        },
+        {
+          "name": "consistent",
+          "prose": "Specifies that all lines in the container are scaled with a single scaling factor. This keyword has no effect if none is specified. If none of consistent, per-line, or per-line-all are specified, consistent is assumed.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-fit-consistent",
+          "type": "value",
+          "value": "consistent"
+        },
+        {
+          "name": "per-line",
+          "prose": "Specifies that each line is scaled with its own scaling factor. However, the last line of the block and lines that end in a forced break are not scaled. This keyword has no effect if none is specified.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-fit-per-line",
+          "type": "value",
+          "value": "per-line"
+        },
+        {
+          "name": "per-line-all",
+          "prose": "Specifies that each line is scaled with its own scaling factor, including the last line of the block and lines that end in a forced break. This keyword has no effect if none is specified.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-fit-per-line-all",
+          "type": "value",
+          "value": "per-line-all"
+        },
+        {
+          "name": "<percentage>",
+          "prose": "Specifies the limit of the scaling factor. If grow is specified and the value is 100% or greater, it is the maximum scaling factor. If shrink is specified and the value is between 0% and 100% inclusive, it is the minimum scaling factor. Otherwise, or if this component is omitted, there is no limit on the scaling factor.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-fit-percentage",
+          "type": "value",
+          "value": "<percentage>"
+        }
+      ],
+      "styleDeclaration": [
+        "text-fit",
+        "textFit"
+      ]
+    },
     {
       "name": "word-spacing",
       "href": "https://drafts.csswg.org/css-text-4/#propdef-word-spacing",
@@ -1149,7 +1216,7 @@
       "initial": "normal",
       "appliesTo": "text",
       "inherited": "yes",
-      "percentages": "relative to computed font-size, i.e. 1em",
+      "percentages": "relative to used font-size",
       "computedValue": "an absolute length and/or a percentage",
       "canonicalOrder": "n/a",
       "animationType": "by computed value type",
@@ -1181,7 +1248,7 @@
       "initial": "normal",
       "appliesTo": "inline boxes and text",
       "inherited": "yes",
-      "percentages": "relative to computed font-size, i.e. 1em",
+      "percentages": "relative to used font-size",
       "computedValue": "an absolute length and/or a percentage",
       "canonicalOrder": "n/a",
       "animationType": "by computed value type",

package/css-text-decor-4.json

@@ -140,14 +140,14 @@
         },
         {
           "name": "<length-percentage>",
-          "prose": "A length value specifies the thickness of text decoration lines as a fixed length. A percentage value specifies the thickness of text decoration lines as a percentage of 1em. The UA should round the actual value to the nearest integer device pixel, and ensure it is at least one device pixel.",
+          "prose": "A length value specifies the thickness of text decoration lines as a fixed length. A percentage value specifies the thickness of text decoration lines as a percentage of the used font-size. The UA should round the actual value to the nearest integer device pixel, and ensure it is at least one device pixel.",
           "href": "https://drafts.csswg.org/css-text-decor-4/#valdef-text-decoration-thickness-length-percentage",
           "type": "value",
           "value": "<length-percentage>"
         },
         {
           "name": "<line-width>",
-          "prose": "A length value specifies the thickness of text decoration lines as a fixed length. A percentage value specifies the thickness of text decoration lines as a percentage of 1em. The UA should round the actual value to the nearest integer device pixel, and ensure it is at least one device pixel.",
+          "prose": "A length value specifies the thickness of text decoration lines as a fixed length. A percentage value specifies the thickness of text decoration lines as a percentage of the used font-size. The UA should round the actual value to the nearest integer device pixel, and ensure it is at least one device pixel.",
           "href": "https://drafts.csswg.org/css-text-decor-4/#valdef-text-decoration-thickness-line-width",
           "type": "value",
           "value": "<line-width>"
@@ -254,7 +254,7 @@
         },
         {
           "name": "<length-percentage>",
-          "prose": "A length value specifies the offset of underlines as a fixed length. A percentage value specifies the offset of underlines as a percentage of 1em.",
+          "prose": "A length value specifies the offset of underlines as a fixed length. A percentage value specifies the offset of underlines as a percentage of the used font-size.",
           "href": "https://drafts.csswg.org/css-text-decor-4/#valdef-text-underline-offset-length-percentage",
           "type": "value",
           "value": "<length-percentage>"

package/css-ui.json

@@ -409,12 +409,12 @@
     {
       "name": "caret-color",
       "href": "https://drafts.csswg.org/css-ui-4/#propdef-caret-color",
-      "value": "auto | <color>",
+      "value": "auto | <color> [auto | <color>]?",
       "initial": "auto",
       "appliesTo": "text or elements that accept text input",
       "inherited": "yes",
       "percentages": "N/A",
-      "computedValue": "The computed value for auto is auto. For <color> values, see CSS Color 4 § 14. Resolving <color> Values.",
+      "computedValue": "The computed value for auto is auto. For <color> values, see CSS Color 4 § 15. Resolving <color> Values.",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value",
       "styleDeclaration": [

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.2",
+  "version": "6.25.4",
   "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

@@ -44,7 +44,7 @@
     },
     {
       "name": ":lang()",
-      "prose": "If the document language specifies how the (human) content language of an element is determined, it is possible to write selectors that represent an element based on its content language. The :lang() pseudo-class, which accepts a comma-separated list of one or more language ranges, represents an element whose content language is one of the languages listed in its argument. Each language range in :lang() must be a valid CSS <ident> or <string>. (Thus language ranges containing asterisks, for example, must be either correctly escaped or quoted as strings, e.g. :lang(\\*-Latn) or :lang(\"*-Latn\").)",
+      "prose": "If the document language specifies how the (human) content language of an element is determined, it is possible to write selectors that represent an element based on its content language. The :lang() pseudo-class, which accepts a comma-separated list of one or more language ranges, represents an element whose content language is one of the languages listed in its argument. Each language range in :lang() is an extended language range, as defined in BCP 47, and must be a valid CSS <ident> or <string>. (Thus language ranges containing asterisks, for example, must be either correctly escaped or quoted as strings, e.g. :lang(\\*-Latn) or :lang(\"*-Latn\").)",
       "href": "https://drafts.csswg.org/selectors-4/#lang-pseudo"
     },
     {
@@ -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",