@webref/css 6.25.11 → 6.25.14

package/css-image-animation.json

@@ -9,7 +9,7 @@
       "href": "https://drafts.csswg.org/css-image-animation-1/#propdef-image-animation",
       "value": "normal | paused | stopped | running",
       "initial": "normal",
-      "appliesTo": "content images and elements with decorative images",
+      "appliesTo": "declarative images",
       "inherited": "yes",
       "percentages": "n/a",
       "computedValue": "as specified",
@@ -39,7 +39,7 @@
         },
         {
           "name": "running",
-          "prose": "Like normal, the animation of animated images is run normally, as determined by the image format and the host language. However, animation timelines are scoped per element: among the content image and decorative images of a single element, any animated images with the same absolute URL, the same image data, and with an image-animation computed value of running must be rendered synchronized to the same timeline as a group, distinct from the timeline of images in other elements. If images are added to the element while the computed value is running, the timeline starts at the time of the least recent addition to the group. If the element is created or made visible after having previously been set to display: none, with images already added and with image-animation already set to running, the timeline starts when the element is included in the layout. If this property is switched to running from another value, the beginnig of this timeline is set so that the animation continues from the state that was displayed at the timem of the switch.",
+          "prose": "Like normal, the animation of animated images is run normally, as determined by the image format and the host language. However, animation timelines are scoped per element: among all images of a single element with an image-animation computed value of running, any animated images with the same absolute URL and the same image data must be rendered synchronized to the same timeline as a group, distinct from the timeline of images in other elements. If images are added to the element while the computed value is running, the timeline starts at the time of the least recent addition to the group. If the element is created or made visible after having previously been set to display: none, with images already added and with image-animation already set to running, the timeline starts when the element is included in the layout. If this property is switched to running from another value, the beginnig of this timeline is set so that the animation continues from the state that was displayed at the timem of the switch.",
           "href": "https://drafts.csswg.org/css-image-animation-1/#valdef-image-animation-running",
           "type": "value",
           "value": "running"
@@ -55,7 +55,7 @@
   "selectors": [
     {
       "name": ":animated-image",
-      "prose": "The :animated-image pseudo-class represents content image elements where a animated image has been loaded. For the animated-image pseudo-class to match, the image must not only be in a format that is capable of animation, but must also be an actually animated image.",
+      "prose": "The :animated-image pseudo-class matches elements representing a declarative image where a animated image has been loaded. For the animated-image pseudo-class to match, the image must not only be in a format that is capable of animation, but must also be an actually animated image.",
       "href": "https://drafts.csswg.org/css-image-animation-1/#selectordef-animated-image",
       "value": ":animated-image"
     }

package/css-inline.json

@@ -183,7 +183,7 @@
       "href": "https://drafts.csswg.org/css-inline-3/#propdef-baseline-source",
       "value": "auto | first | last",
       "initial": "auto",
-      "appliesTo": "inline-level boxes",
+      "appliesTo": "inline-level boxes that establish an independent formatting context",
       "inherited": "no",
       "percentages": "N/A",
       "computedValue": "specified keyword",

package/css-mixins.json

@@ -31,13 +31,7 @@
       "name": "@mixin",
       "href": "https://drafts.csswg.org/css-mixins-1/#at-ruledef-mixin",
       "descriptors": [],
-      "value": "@mixin <function-token> <function-parameter>#? ) { <declaration-rule-list> }"
-    },
-    {
-      "name": "@result",
-      "href": "https://drafts.csswg.org/css-mixins-1/#result-rule",
-      "descriptors": [],
-      "value": "@result { <declaration-rule-list> }"
+      "value": "@mixin [<function-token> <function-parameter>#? ) | <ident-token> ] { <block-contents> }"
     },
     {
       "name": "@contents",
@@ -45,17 +39,17 @@
       "descriptors": [],
       "value": "@contents [ { <declaration-list> } ]?"
     },
-    {
-      "name": "@macro",
-      "href": "https://drafts.csswg.org/css-mixins-1/#macro-rule",
-      "descriptors": [],
-      "value": "@macro <dashed-ident> { <declaration-rule-list> }"
-    },
     {
       "name": "@apply",
       "href": "https://drafts.csswg.org/css-mixins-1/#at-ruledef-apply",
       "descriptors": [],
       "value": "@apply [ <dashed-ident> | <dashed-function> ] [ { <declaration-list> } ]?;"
+    },
+    {
+      "name": "@private",
+      "href": "https://drafts.csswg.org/css-mixins-1/#private",
+      "descriptors": [],
+      "value": "@private { <declaration-rule-list> }"
     }
   ],
   "selectors": [],

package/css-navigation.json

@@ -1,16 +1,16 @@
 {
   "spec": {
-    "title": "CSS Route Matching",
+    "title": "CSS Navigation Matching",
     "url": "https://drafts.csswg.org/css-navigation-1/"
   },
   "properties": [],
   "atrules": [
     {
-      "name": "@route",
-      "prose": "The @route rule is an at-rule that associates an author-defined name with a URL pattern. This name can be referenced in @navigation rules and in :link-to() pseudo-classes.",
-      "href": "https://drafts.csswg.org/css-navigation-1/#at-ruledef-route",
+      "name": "@location",
+      "prose": "The @location rule is an at-rule that associates an author-defined name with a URL pattern. This name can be referenced in @navigation rules and in :link-to() pseudo-classes.",
+      "href": "https://drafts.csswg.org/css-navigation-1/#at-ruledef-location",
       "descriptors": [],
-      "value": "<route-rule>"
+      "value": "<location-rule>"
     },
     {
       "name": "@navigation",
@@ -27,34 +27,34 @@
       "href": "https://drafts.csswg.org/css-navigation-1/#link-to-pseudo"
     },
     {
-      "name": ":nav-source",
-      "prose": "This specification defines a :nav-source pseudo-class, matching the element that triggered the current navigation. It is a CSS reflection of the sourceElement property in the Navigation API. The trigger element can be an [^a^], [^area^], [^form^], a [^input/type/submit^] input, or a [^button^].",
-      "href": "https://drafts.csswg.org/css-navigation-1/#nav-source-pseudo",
-      "value": ":nav-source"
+      "name": ":navigation-source",
+      "prose": "This specification defines a :navigation-source pseudo-class, matching the element that triggered the current navigation. It is a CSS reflection of the sourceElement property in the Navigation API. The trigger element can be an [^a^], [^area^], [^form^], a [^input/type/submit^] input, or a [^button^].",
+      "href": "https://drafts.csswg.org/css-navigation-1/#navigation-source-pseudo",
+      "value": ":navigation-source"
     }
   ],
   "values": [
     {
-      "name": "<route-location>",
-      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-route-location",
+      "name": "<navigation-location>",
+      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-navigation-location",
       "type": "type",
-      "value": "<url> | [ <route-name> | <url-pattern()> ]"
+      "value": "<url> | [ <location-name> | <url-pattern()> ]"
     },
     {
-      "name": "<route-name>",
-      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-route-name",
+      "name": "<location-name>",
+      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-location-name",
       "type": "type",
       "value": "<dashed-ident>"
     },
     {
-      "name": "<route-rule>",
-      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-route-rule",
+      "name": "<location-rule>",
+      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-location-rule",
       "type": "type",
-      "value": "@route <dashed-ident> { <declaration-list> }"
+      "value": "@location <dashed-ident> { <declaration-list> }"
     },
     {
-      "name": "<route-descriptor>",
-      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-route-descriptor",
+      "name": "<location-descriptor>",
+      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-location-descriptor",
       "type": "type",
       "value": "<pattern-descriptor> | <init-descriptor> | <base-descriptor>"
     },
@@ -111,19 +111,19 @@
       "name": "<navigation-location-test>",
       "href": "https://drafts.csswg.org/css-navigation-1/#typedef-navigation-location-test",
       "type": "type",
-      "value": "<navigation-relation> : <route-location>"
+      "value": "<navigation-relation> : <navigation-location>"
     },
     {
       "name": "<navigation-relation>",
       "href": "https://drafts.csswg.org/css-navigation-1/#typedef-navigation-relation",
       "type": "type",
-      "value": "at | with | from | to"
+      "value": "at | from | to"
     },
     {
       "name": "<navigation-location-between-test>",
       "href": "https://drafts.csswg.org/css-navigation-1/#typedef-navigation-location-between-test",
       "type": "type",
-      "value": "between : <route-location> and <route-location>"
+      "value": "between : <navigation-location> and <navigation-location>"
     },
     {
       "name": "<navigation-type-test>",

package/css-overflow-5.json

@@ -89,6 +89,38 @@
         "scrollMarkerGroup"
       ]
     },
+    {
+      "name": "scroll-axis-lock",
+      "href": "https://drafts.csswg.org/css-overflow-5/#propdef-scroll-axis-lock",
+      "value": "auto | none",
+      "initial": "auto",
+      "appliesTo": "scroll container elements",
+      "inherited": "no",
+      "percentages": "n/a",
+      "computedValue": "specified value",
+      "canonicalOrder": "per grammar",
+      "animationType": "discrete",
+      "values": [
+        {
+          "name": "none",
+          "prose": "The user agent must not lock scrolls on the element to one axis.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-axis-lock-none",
+          "type": "value",
+          "value": "none"
+        },
+        {
+          "name": "auto",
+          "prose": "The user agent may lock scrolls on the element to one axis.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-axis-lock-auto",
+          "type": "value",
+          "value": "auto"
+        }
+      ],
+      "styleDeclaration": [
+        "scroll-axis-lock",
+        "scrollAxisLock"
+      ]
+    },
     {
       "name": "continue",
       "newValues": "overflow | paginate | fragments",

package/css-properties-values-api.json

@@ -14,24 +14,24 @@
           "href": "https://drafts.css-houdini.org/css-properties-values-api-1/#descdef-property-syntax",
           "for": "@property",
           "value": "<string>",
-          "initial": "n/a (see prose)"
+          "initial": "\"*\""
         },
         {
           "name": "inherits",
           "href": "https://drafts.css-houdini.org/css-properties-values-api-1/#descdef-property-inherits",
           "for": "@property",
           "value": "true | false",
-          "initial": "n/a (see prose)"
+          "initial": "true"
         },
         {
           "name": "initial-value",
           "href": "https://drafts.css-houdini.org/css-properties-values-api-1/#descdef-property-initial-value",
           "for": "@property",
           "value": "<declaration-value>?",
-          "initial": "the guaranteed-invalid value (but see prose)"
+          "initial": "the guaranteed-invalid value"
         }
       ],
-      "value": "@property <custom-property-name> { <declaration-list> }"
+      "value": "@property <custom-property-name># { <declaration-list> }"
     }
   ],
   "selectors": [],

package/css-text-4.json

@@ -465,7 +465,7 @@
     {
       "name": "text-wrap-style",
       "href": "https://drafts.csswg.org/css-text-4/#propdef-text-wrap-style",
-      "value": "auto | balance | stable | pretty | avoid-orphans",
+      "value": "auto | balance | stable | pretty | avoid-short-last-line",
       "initial": "auto",
       "appliesTo": "block containers hat establish an inline formatting context",
       "inherited": "yes",
@@ -497,17 +497,17 @@
         },
         {
           "name": "pretty",
-          "prose": "Specifies the UA should bias for better layout over speed, and is expected to consider multiple lines when making break decisions. Otherwise equivalent to auto. The user agent may among other things attempt to avoid excessively short last lines, similarly to avoid-orphans, but it should also improve the layout in additional ways. The precise set of improvements is user agent dependent, and may include things such as: reducing the variation in length between lines; avoiding typographic rivers; prioritizing different classes of soft wrap opportunities, hyphenation opportunities, or justification opportunities; avoiding hyphenation on too many consecutive lines… The necessary computations may be expensive, especially when applied to large amounts of text. Authors are encouraged to assess the impact on performance when using text-wrap-style: pretty, and possibly use it selectively where it matters most.",
+          "prose": "Specifies the UA should bias for better layout over speed, and is expected to consider multiple lines when making break decisions. Otherwise equivalent to auto. The user agent may among other things attempt to avoid excessively short last lines, similarly to avoid-short-last-line, but it should also improve the layout in additional ways. The precise set of improvements is user agent dependent, and may include things such as: reducing the variation in length between lines; avoiding typographic rivers; prioritizing different classes of soft wrap opportunities, hyphenation opportunities, or justification opportunities; avoiding hyphenation on too many consecutive lines… The necessary computations may be expensive, especially when applied to large amounts of text. Authors are encouraged to assess the impact on performance when using text-wrap-style: pretty, and possibly use it selectively where it matters most.",
           "href": "https://drafts.csswg.org/css-text-4/#valdef-text-wrap-style-pretty",
           "type": "value",
           "value": "pretty"
         },
         {
-          "name": "avoid-orphans",
-          "prose": "Specifies the UA should avoid excessively short last lines, and is expected to consider more than one line when making break decisions (for example, to avoid \"fixing\" an orphan by making the previous line too short). The user agent may decide against improving the last line when it would make some prior line(s) substantially unbalanced. The user agent should not attempt to improve other aspects of the layout beyond what auto if those improvements come at a significant performance cost. For instance, with the given line length, the following test would be wrapped with a single word on the last line, which could be judged too short. ἄνδρα μοι ἔννεπε, μοῦσα, πολύτροπον, ὃς μάλα πολλὰ πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν. Applying text-wrap-style: avoid-orphans could yield something like this instead, which is arguably more pleasing: ἄνδρα μοι ἔννεπε, μοῦσα, πολύτροπον, ὃς μάλα πολλὰ πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν. However, the following fragment is more vexing: Circumnavigating the Mississippi river An attempt to make the last line less short by wrapping the previous line earlier would result in the following: Circumnavigating the Mississippi river While the last line would indeed no longer be short, the penultimate line would be unsightly. In such cases, user agents are expected to prefer the first rendering despite text-wrap-style: avoid-orphans being set.",
-          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-wrap-style-avoid-orphans",
+          "name": "avoid-short-last-line",
+          "prose": "Specifies the UA should avoid excessively short last lines, and is expected to consider more than one line when making break decisions (for example, to avoid \"fixing\" an orphan by making the previous line too short). The user agent may decide against improving the last line when it would make some prior line(s) substantially unbalanced. The user agent should not attempt to improve other aspects of the layout beyond what auto if those improvements come at a significant performance cost. For instance, with the given line length, the following test would be wrapped with a single word on the last line, which could be judged too short. ἄνδρα μοι ἔννεπε, μοῦσα, πολύτροπον, ὃς μάλα πολλὰ πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν. Applying text-wrap-style: avoid-short-last-line could yield something like this instead, which is arguably more pleasing: ἄνδρα μοι ἔννεπε, μοῦσα, πολύτροπον, ὃς μάλα πολλὰ πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν. However, the following fragment is more vexing: Circumnavigating the Mississippi river An attempt to make the last line less short by wrapping the previous line earlier would result in the following: Circumnavigating the Mississippi river While the last line would indeed no longer be short, the penultimate line would be unsightly. In such cases, user agents are expected to prefer the first rendering despite text-wrap-style: avoid-short-last-line being set.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-wrap-style-avoid-short-last-line",
           "type": "value",
-          "value": "avoid-orphans"
+          "value": "avoid-short-last-line"
         }
       ],
       "styleDeclaration": [
@@ -737,7 +737,7 @@
     {
       "name": "hyphenate-limit-chars",
       "href": "https://drafts.csswg.org/css-text-4/#propdef-hyphenate-limit-chars",
-      "value": "[ auto | <integer> ]{1,3}",
+      "value": "[ auto | <integer [0,∞]> ]{1,3}",
       "initial": "auto",
       "appliesTo": "text",
       "inherited": "yes",
@@ -762,7 +762,7 @@
     {
       "name": "hyphenate-limit-lines",
       "href": "https://drafts.csswg.org/css-text-4/#propdef-hyphenate-limit-lines",
-      "value": "no-limit | <integer>",
+      "value": "no-limit | <integer [0,∞]>",
       "initial": "no-limit",
       "appliesTo": "block containers",
       "inherited": "yes",
@@ -1232,20 +1232,6 @@
           "type": "value",
           "value": "no-autospace"
         },
-        {
-          "name": "insert",
-          "prose": "The specified spacing is automatically inserted if there are no space characters of any kind (Unicode general category Z) already there. If neither insert nor replace are specified, the behavior is the same as insert.",
-          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-autospace-insert",
-          "type": "value",
-          "value": "insert"
-        },
-        {
-          "name": "replace",
-          "prose": "The specified spacing is automatically inserted even if there is already a space (U+0020) at that point; additionally, the space (U+0020) is removed. Other types of space characters (Unicode general category Z) suppress automatic spacing, as for insert.",
-          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-autospace-replace",
-          "type": "value",
-          "value": "replace"
-        },
         {
           "name": "ideograph-alpha",
           "prose": "Creates extra spacing between runs of ideographs and non-ideographic letters, see § 8.4.1 Inter-script Spacing.",
@@ -1267,6 +1253,20 @@
           "type": "value",
           "value": "punctuation"
         },
+        {
+          "name": "insert",
+          "prose": "The specified spacing is automatically inserted if there are no space characters of any kind (Unicode general category Z) already there. This is the default behavior: if neither insert nor replace are specified, insert is assumed.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-autospace-insert",
+          "type": "value",
+          "value": "insert"
+        },
+        {
+          "name": "replace",
+          "prose": "The specified spacing is automatically inserted even if there is already a space (U+0020) at that point; additionally, the space (U+0020) is removed. Other types of space characters (Unicode general category Z) suppress automatic spacing, as for insert.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-autospace-replace",
+          "type": "value",
+          "value": "replace"
+        },
         {
           "name": "auto",
           "prose": "The user agent chooses a set of typographically high quality spacing values. Different user agents running on different platforms may pick different values.",

package/css-text-decor-4.json

@@ -268,21 +268,21 @@
     {
       "name": "text-decoration-inset",
       "href": "https://drafts.csswg.org/css-text-decor-4/#propdef-text-decoration-inset",
-      "value": "<length>{1,2} | auto",
+      "value": "<length-percentage>{1,2} | auto",
       "initial": "0",
       "appliesTo": "all elements",
       "inherited": "no",
-      "percentages": "N/A",
+      "percentages": "Depending on the value of box-decoration-break, either refer to the inline size of the decorating box or of each individual box fragment",
       "computedValue": "specified keyword or absolute length",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value",
       "values": [
         {
-          "name": "<length>",
-          "prose": "Adjusts the start or end endpoint of the affected line decorations. Positive values move the endpoint inward (trimming), negative values move it outward (extending). The following example offsets an extra thick underline 1em endwards with respect to the text h1 { text-decoration: underline 0.3em rgba(36,148,187,0.25); text-decoration-inset: 1em -1em; }",
-          "href": "https://drafts.csswg.org/css-text-decor-4/#valdef-text-decoration-inset-length",
+          "name": "<length-percentage>",
+          "prose": "Adjusts the start or end endpoint of the affected line decorations. Positive values move the endpoint inward (trimming), negative values move it outward (extending). Percentage values either refer to the total inline size of the decorating box, if box-decoration-break is set to slice, or to the inline size of each individual box fragment, if it is set to clone. The following example offsets an extra thick underline 1em endwards with respect to the text h1 { text-decoration: underline 0.3em rgb(36 148 187 / 0.25); text-decoration-inset: 1em -1em; } In this example, the underline is inset 10% of the inline size of the decorating box from the start and end of it. h1 { text-decoration: underline 0.2em rgb(216 148 23); text-decoration-inset: 10%; } This results in the orange underline being inset by 10 percent from the start and end of the headline. In this example, the underline is inset 10% of the inline size of each box fragment from the end of that fragment. h1 { text-decoration: underline 0.2em rgb(216 148 23); text-decoration-inset: 0 10%; box-decoration-break: clone; } This results in the orange underline of each line being inset by 10 percent from the end.",
+          "href": "https://drafts.csswg.org/css-text-decor-4/#valdef-text-decoration-inset-length-percentage",
           "type": "value",
-          "value": "<length>"
+          "value": "<length-percentage>"
         },
         {
           "name": "auto",

package/css-ui.json

@@ -963,7 +963,8 @@
         "-webkit-appearance",
         "WebkitAppearance",
         "webkitAppearance"
-      ]
+      ],
+      "value": "none | auto | base | base-select | <compat-auto> | <compat-special>"
     },
     {
       "name": "-webkit-user-select",

package/css-values-5.json

@@ -18,14 +18,14 @@
       "values": [
         {
           "name": "numeric-only",
-          "prose": "An <intrinsic-size-keyword> cannot be interpolated.",
+          "prose": "A <size-keyword> can only be combined with a compatible <calc-size()>.",
           "href": "https://drafts.csswg.org/css-values-5/#valdef-interpolate-size-numeric-only",
           "type": "value",
           "value": "numeric-only"
         },
         {
           "name": "allow-keywords",
-          "prose": "Two values can also be interpolated if one of them is an <intrinsic-size-keyword> and the other is a <length-percentage>. This is done by treating the <intrinsic-size-keyword> keyword as though it is calc-size(keyword, size) and applying the rules in § 11.3 Interpolating calc-size(). In other cases, an <intrinsic-size-keyword> still cannot be interpolated.",
+          "prose": "Sizing values can also be combined if one of them is an <size-keyword> and the other is a <length-percentage>. This is done by treating the <size-keyword> keyword as though it is calc-size(keyword, size) and applying the rules in § 11.2 Interpolating calc-size(). In other cases, a <size-keyword> still cannot be interpolated.",
           "href": "https://drafts.csswg.org/css-values-5/#valdef-interpolate-size-allow-keywords",
           "type": "value",
           "value": "allow-keywords"
@@ -615,11 +615,11 @@
       "value": "<declaration-value> : <declaration-value>?"
     },
     {
-      "name": "toggle()",
-      "prose": "The toggle() expression allows descendant elements to cycle over a list of values instead of inheriting the same value.",
-      "href": "https://drafts.csswg.org/css-values-5/#funcdef-toggle",
+      "name": "cycle()",
+      "prose": "The cycle() expression allows descendant elements to cycle over a list of values instead of inheriting the same value.",
+      "href": "https://drafts.csswg.org/css-values-5/#funcdef-cycle",
       "type": "function",
-      "value": "toggle( <whole-value># )"
+      "value": "cycle( <whole-value># )"
     },
     {
       "name": "inherit()",
@@ -675,7 +675,7 @@
     },
     {
       "name": "ident()",
-      "prose": "The ident() function represents an <ident>, and can be used to manually construct <custom-ident> values from several parts.",
+      "prose": "The ident() function represents an arbitrary <ident>, built from one or more separate idents, strings, and integers. It is an arbitrary substitution function.",
       "href": "https://drafts.csswg.org/css-values-5/#funcdef-ident",
       "type": "function",
       "value": "ident( <ident-arg>+ )"
@@ -686,6 +686,12 @@
       "type": "type",
       "value": "<string> | <integer> | <ident>"
     },
+    {
+      "name": "<ident-args>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-ident-args",
+      "type": "type",
+      "value": "ident( <declaration-value> )"
+    },
     {
       "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:",
@@ -721,7 +727,7 @@
         },
         {
           "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 follows certain specific patterns; see § 9.4.1 Simplification of <random-key> for details.",
+          "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. If the random function is being evaluated inside of a custom function, the element-specific identifier is for the \"hypothetical element\" that the function’s styles are evaluated on, so element-scoped will give you different random values on every function invocation. 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 follows certain specific patterns; see § 9.4.1 Simplification of <random-key> for details.",
           "href": "https://drafts.csswg.org/css-values-5/#valdef-random-random-cache-key",
           "type": "value",
           "value": "<random-cache-key>"
@@ -788,23 +794,44 @@
     },
     {
       "name": "calc-size()",
+      "prose": "The calc-size() function allows math and transition/animation to be performed on these sizes in a safe, well-defined way. Its syntax is as follows:",
       "href": "https://drafts.csswg.org/css-values-5/#funcdef-calc-size",
       "type": "function",
       "value": "calc-size( <calc-size-basis>, <calc-sum> )",
       "values": [
         {
-          "name": "size",
-          "prose": "Within the calc-size calculation, if the calc-size basis is not any, the keyword size is allowed. This keyword is a <length>, and resolves at used value time.",
-          "href": "https://drafts.csswg.org/css-values-5/#valdef-calc-size-size",
+          "name": "<size-keyword>",
+          "prose": "Indicates that the calc-size() is basing its size off of the specified keyword. Represents any sizing keywords allowed in the context where the function is used. For example, in width, it matches auto, min-content, stretch, etc. Also allows any related sizing functions, like the fit-content() function in width/etc., which is a variation of the fit-content keyword. For all purposes other than actually resolving the size, the calc-size() acts like this keyword. The calc-size calculation will use the corresponding size as the value of its size keyword.",
+          "href": "https://drafts.csswg.org/css-values-5/#typedef-calc-size-size-keyword",
+          "type": "type"
+        },
+        {
+          "name": "<calc-sum>",
+          "prose": "Indicates that the calc-size() is basing its size off of the specified calculation. For all purposes other than actually resolving the size, the calc-size() acts like this calculation wrapped in a calc() (including, for example, whether it represents a definite or indefinite size). The calc-size calculation will use the corresponding size as the value of its size keyword.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-calc-size-calc-sum",
           "type": "value",
-          "value": "size"
+          "value": "<calc-sum>"
+        },
+        {
+          "name": "<calc-size()>",
+          "prose": "Indicates that the outer calc-size() is basing its size off of this inner calc-size(), and will share the same behavior as it. The calc-size calculation will use the size of the inner calc-size() as its size keyword. The size keyword is allowed, in this case, even if the inner calc-size() uses any. For example, in calc-size(calc-size(min-content, size / 2), size + 10%), the outer calc-size() acts as if its calc-size basis was min-content, and will calculate its own size using the result of the inner calc-size(), equivalent to calc-size(min-content, size / 2 + 10%).",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-calc-size-calc-size",
+          "type": "value",
+          "value": "<calc-size()>"
         },
         {
           "name": "any",
-          "prose": "(If the calc-size basis is any, the calc-size() is a definite length, equal to its calc-size calculation.)",
+          "prose": "Indicates that the calc-size() does not depend on any additional information, and thus can be interpolated with any other size. The calc-size() function represents a definite size. The calc-size calculation cannot use the size keyword; it is a syntax error for size to appear in the calc-size calculation.",
           "href": "https://drafts.csswg.org/css-values-5/#valdef-calc-size-any",
           "type": "value",
           "value": "any"
+        },
+        {
+          "name": "size",
+          "prose": "Within the calc-size calculation, the size is a <calc-keyword> which is a <length>, and resolves at used value time to the size specified above.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-calc-size-size",
+          "type": "value",
+          "value": "size"
         }
       ]
     },
@@ -812,13 +839,7 @@
       "name": "<calc-size-basis>",
       "href": "https://drafts.csswg.org/css-values-5/#typedef-calc-size-basis",
       "type": "type",
-      "value": "[ <size-keyword> | <calc-size()> | any | <calc-sum> ]"
-    },
-    {
-      "name": "<size-keyword>",
-      "prose": "The <size-keyword> production matches any sizing keywords allowed in the context. For example, in width, it matches auto, min-content, stretch, etc.",
-      "href": "https://drafts.csswg.org/css-values-5/#typedef-size-keyword",
-      "type": "type"
+      "value": "[ <size-keyword> | <calc-sum> | <calc-size()> | any ]"
     }
   ],
   "warnings": [
@@ -841,6 +862,15 @@
       "msg": "Missing definition",
       "name": "interpolate-function()",
       "value": "interpolate-function( [ <progress-source> && [ by <easing-function> ]? && <easing-function>? && <segment-options>? ] , <input-position>{1,2} : <output-value> , [ [ <easing-function> || <segment-options> ]? , <input-position>{1,2} : <output-value> ]#? )"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "size",
+      "prose": "Within the calc-size calculation, the size is a <calc-keyword> which is a <length>, and resolves at used value time to the size specified above.",
+      "href": "https://drafts.csswg.org/css-values-5/#valdef-calc-size-size",
+      "type": "value",
+      "value": "size",
+      "for": "calc()"
     }
   ]
 }

package/css-values.json

@@ -7,12 +7,6 @@
   "atrules": [],
   "selectors": [],
   "values": [
-    {
-      "name": "<string>",
-      "prose": "Strings, denoted by <string>, are sequences of characters representing arbitrary textual data. When written literally, they are delimited by double quotes or single quotes, and correspond to the <string-token> production. [CSS-SYNTAX-3].",
-      "href": "https://drafts.csswg.org/css-values-4/#string-value",
-      "type": "type"
-    },
     {
       "name": "<ident>",
       "prose": "CSS identifiers, generically denoted by <ident>, represent names, and are written as an unquoted sequence of (potentially escaped) characters corresponding to the <ident-token> grammar. [CSS-SYNTAX-3] Identifiers cannot be quoted; otherwise they would be interpreted as strings. CSS properties accept two classes of identifiers: pre-defined keywords and author-defined identifiers.",
@@ -31,6 +25,12 @@
       "href": "https://drafts.csswg.org/css-values-4/#typedef-dashed-ident",
       "type": "type"
     },
+    {
+      "name": "<string>",
+      "prose": "Strings, denoted by <string>, are sequences of characters representing arbitrary textual data. When written literally, they are delimited by double quotes or single quotes, and correspond to the <string-token> production. [CSS-SYNTAX-3].",
+      "href": "https://drafts.csswg.org/css-values-4/#string-value",
+      "type": "type"
+    },
     {
       "name": "url()",
       "prose": "The <url> type, written with the url() and src() functions, represents a URL, which is a pointer to a resource.",
@@ -878,14 +878,5 @@
       "href": "https://drafts.csswg.org/css-values-4/#typedef-quirky-length",
       "type": "type"
     }
-  ],
-  "warnings": [
-    {
-      "msg": "Duplicate definition",
-      "name": "<string>",
-      "prose": "Strings, denoted by <string>, are sequences of characters representing arbitrary textual data. When written literally, they are delimited by double quotes or single quotes, and correspond to the <string-token> production. [CSS-SYNTAX-3].",
-      "href": "https://drafts.csswg.org/css-values-4/#string-value%E2%91%A0",
-      "type": "type"
-    }
   ]
 }

package/css-view-transitions.json

@@ -189,7 +189,7 @@
   "selectors": [
     {
       "name": "::view-transition",
-      "prose": "The ::view-transition pseudo-element is a tree-abiding pseudo-element that is also a pseudo-element root. If its originating element is the document’s document element, its containing block is the snapshot containing block.",
+      "prose": "The ::view-transition pseudo-element is a fully styleable pseudo-element that is also a pseudo-element root. If its originating element is the document’s document element, its containing block is the snapshot containing block.",
       "href": "https://drafts.csswg.org/css-view-transitions-2/#selectordef-view-transition",
       "value": "::view-transition"
     },
@@ -241,7 +241,8 @@
       "name": "<view-transition-type>",
       "prose": "where <view-transition-type> is any <custom-ident> other than none, and not starting with the string \"-ua-\".",
       "href": "https://drafts.csswg.org/css-view-transitions-2/#typedef-view-transition-type",
-      "type": "type"
+      "type": "type",
+      "value": "<custom-ident>"
     },
     {
       "name": "<pt-name-and-class-selector>",

package/package.json

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