@webref/css 8.7.0 → 8.7.2

package/css.json

@@ -562,6 +562,14 @@
       "syntax": "@left-top { <declaration-list> };",
       "extended": []
     },
+    {
+      "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": [],
+      "syntax": "<location-rule>",
+      "extended": []
+    },
     {
       "name": "@macro",
       "href": "https://drafts.csswg.org/css-mixins-1/#macro-rule",
@@ -883,7 +891,7 @@
       "name": "@mixin",
       "href": "https://drafts.csswg.org/css-mixins-1/#at-ruledef-mixin",
       "descriptors": [],
-      "syntax": "@mixin <function-token> <function-parameter>#? ) { <declaration-rule-list> }",
+      "syntax": "@mixin [<function-token> <function-parameter>#? ) | <ident-token> ] { <declaration-rule-list> }",
       "extended": []
     },
     {
@@ -977,25 +985,25 @@
           "name": "inherits",
           "href": "https://drafts.css-houdini.org/css-properties-values-api-1/#descdef-property-inherits",
           "for": "@property",
-          "initial": "n/a (see prose)",
+          "initial": "true",
           "syntax": "true | false"
         },
         {
           "name": "initial-value",
           "href": "https://drafts.css-houdini.org/css-properties-values-api-1/#descdef-property-initial-value",
           "for": "@property",
-          "initial": "the guaranteed-invalid value (but see prose)",
+          "initial": "the guaranteed-invalid value",
           "syntax": "<declaration-value>?"
         },
         {
           "name": "syntax",
           "href": "https://drafts.css-houdini.org/css-properties-values-api-1/#descdef-property-syntax",
           "for": "@property",
-          "initial": "n/a (see prose)",
+          "initial": "\"*\"",
           "syntax": "<string>"
         }
       ],
-      "syntax": "@property <custom-property-name> { <declaration-list> }",
+      "syntax": "@property <custom-property-name># { <declaration-list> }",
       "extended": []
     },
     {
@@ -1026,14 +1034,6 @@
       "syntax": "@right-top { <declaration-list> };",
       "extended": []
     },
-    {
-      "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",
-      "descriptors": [],
-      "syntax": "<route-rule>",
-      "extended": []
-    },
     {
       "name": "@scope",
       "prose": "Scoped styles are described in CSS using the @scope block at-rule, which declares a scoping root and optional scoping limits associated with a set of style rules.",
@@ -1259,6 +1259,7 @@
     },
     {
       "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",
       "syntax": "calc-size( <calc-size-basis>, <calc-sum> )",
       "extended": []
@@ -3450,7 +3451,28 @@
     },
     {
       "name": "animation-delay",
-      "href": "https://drafts.csswg.org/css-animations-1/#propdef-animation-delay",
+      "href": "https://drafts.csswg.org/css-animations-2/#propdef-animation-delay",
+      "initial": "see individual properties",
+      "appliesTo": "see individual properties",
+      "inherited": "see individual properties",
+      "percentages": "see individual properties",
+      "computedValue": "see individual properties",
+      "animationType": "see individual properties",
+      "canonicalOrder": "per grammar",
+      "styleDeclaration": [
+        "animation-delay",
+        "animationDelay"
+      ],
+      "longhands": [
+        "animation-delay-start",
+        "animation-delay-end"
+      ],
+      "syntax": "[ <'animation-delay-start'> <'animation-delay-end'>? ]#",
+      "extended": []
+    },
+    {
+      "name": "animation-delay-end",
+      "href": "https://drafts.csswg.org/css-animations-2/#propdef-animation-delay-end",
       "initial": "0s",
       "appliesTo": "all elements",
       "inherited": "no",
@@ -3459,8 +3481,25 @@
       "canonicalOrder": "per grammar",
       "animationType": "not animatable",
       "styleDeclaration": [
-        "animation-delay",
-        "animationDelay"
+        "animation-delay-end",
+        "animationDelayEnd"
+      ],
+      "syntax": "<time [0s,∞]>#",
+      "extended": []
+    },
+    {
+      "name": "animation-delay-start",
+      "href": "https://drafts.csswg.org/css-animations-2/#propdef-animation-delay-start",
+      "initial": "0s",
+      "appliesTo": "all elements",
+      "inherited": "no",
+      "percentages": "N/A",
+      "computedValue": "list, each item a duration",
+      "canonicalOrder": "per grammar",
+      "animationType": "not animatable",
+      "styleDeclaration": [
+        "animation-delay-start",
+        "animationDelayStart"
       ],
       "syntax": "<time>#",
       "extended": []
@@ -4129,7 +4168,7 @@
       "name": "baseline-source",
       "href": "https://drafts.csswg.org/css-inline-3/#propdef-baseline-source",
       "initial": "auto",
-      "appliesTo": "inline-level boxes",
+      "appliesTo": "inline-level boxes that establish an independent formatting context",
       "inherited": "no",
       "percentages": "N/A",
       "computedValue": "specified keyword",
@@ -9544,7 +9583,7 @@
         "hyphenate-limit-chars",
         "hyphenateLimitChars"
       ],
-      "syntax": "[ auto | <integer> ]{1,3}",
+      "syntax": "[ auto | <integer [0,∞]> ]{1,3}",
       "extended": []
     },
     {
@@ -9578,7 +9617,7 @@
         "hyphenate-limit-lines",
         "hyphenateLimitLines"
       ],
-      "syntax": "no-limit | <integer>",
+      "syntax": "no-limit | <integer [0,∞]>",
       "extended": []
     },
     {
@@ -10601,17 +10640,17 @@
       "name": "margin-trim",
       "href": "https://drafts.csswg.org/css-box-4/#propdef-margin-trim",
       "initial": "none",
-      "appliesTo": "block containers, multi-column containers, flex containers, grid containers",
+      "appliesTo": "block containers, multi-column containers",
       "inherited": "no",
       "percentages": "N/A",
-      "computedValue": "a set of zero to four keywords indicating which sides to trim",
+      "computedValue": "a set of zero to two keywords indicating which sides to trim",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
       "styleDeclaration": [
         "margin-trim",
         "marginTrim"
       ],
-      "syntax": "none | [ block || inline ] | [ block-start || inline-start || block-end || inline-end ]",
+      "syntax": "none | block | [ block-start || block-end ]",
       "extended": []
     },
     {
@@ -13631,6 +13670,23 @@
       "syntax": "none | [ <number> | <percentage> ]{1,3}",
       "extended": []
     },
+    {
+      "name": "scroll-axis-lock",
+      "href": "https://drafts.csswg.org/css-overflow-5/#propdef-scroll-axis-lock",
+      "initial": "auto",
+      "appliesTo": "scroll container elements",
+      "inherited": "no",
+      "percentages": "n/a",
+      "computedValue": "specified value",
+      "canonicalOrder": "per grammar",
+      "animationType": "discrete",
+      "styleDeclaration": [
+        "scroll-axis-lock",
+        "scrollAxisLock"
+      ],
+      "syntax": "auto | none",
+      "extended": []
+    },
     {
       "name": "scroll-behavior",
       "href": "https://drafts.csswg.org/css-overflow-3/#propdef-scroll-behavior",
@@ -15124,7 +15180,7 @@
       "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",
@@ -15132,7 +15188,7 @@
         "text-decoration-inset",
         "textDecorationInset"
       ],
-      "syntax": "<length>{1,2} | auto",
+      "syntax": "<length-percentage>{1,2} | auto",
       "extended": []
     },
     {
@@ -15660,7 +15716,7 @@
         "text-wrap-style",
         "textWrapStyle"
       ],
-      "syntax": "auto | balance | stable | pretty | avoid-orphans",
+      "syntax": "auto | balance | stable | pretty | avoid-short-last-line",
       "extended": []
     },
     {
@@ -17100,7 +17156,7 @@
     },
     {
       "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",
       "syntax": "::view-transition",
       "extended": []
@@ -17170,7 +17226,7 @@
     },
     {
       "name": ":any-link",
-      "prose": "The :any-link pseudo-class represents an element that acts as the source anchor of a hyperlink. For example, in [HTML5], any a or area elements with an href attribute are hyperlinks, and thus match :any-link. It matches an element if the element would match either :link or :visited, and is equivalent to :is(:link, :visited).",
+      "prose": "The :any-link pseudo-class represents an element that acts as the source anchor of a hyperlink. For example, in [HTML], any a or area elements with an href attribute are hyperlinks, and thus match :any-link. It matches an element if the element would match either :link or :visited, and is equivalent to :is(:link, :visited).",
       "href": "https://drafts.csswg.org/selectors-4/#any-link-pseudo",
       "syntax": ":any-link",
       "extended": []
@@ -17204,7 +17260,7 @@
     },
     {
       "name": ":checked",
-      "prose": "When such elements are toggled “on” the :checked pseudo-class applies. For example, [HTML5] defines that checked checkboxes, radio buttons, and selected <option> elements match :checked. Similarly, when such elements are toggled “off”, the :unchecked pseudo-class applies.",
+      "prose": "When such elements are toggled “on” the :checked pseudo-class applies. For example, [HTML] defines that checked checkboxes, radio buttons, and selected <option> elements match :checked. Similarly, when such elements are toggled “off”, the :unchecked pseudo-class applies.",
       "href": "https://drafts.csswg.org/selectors-4/#checked-pseudo",
       "syntax": ":checked",
       "extended": []
@@ -17238,7 +17294,7 @@
     },
     {
       "name": ":dir()",
-      "prose": "The :dir() pseudo-class allows the author to write selectors that represent an element based on its directionality as determined by the document language. For example, [HTML5] defines how to determine the directionality of an element, based on a combination of the dir attribute, the surrounding text, and other factors. As another example, the its:dir and dirRule element of the Internationalization Tag Set [ITS20] are able to define the directionality of an element in [XML10].",
+      "prose": "The :dir() pseudo-class allows the author to write selectors that represent an element based on its directionality as determined by the document language. For example, [HTML] defines how to determine the directionality of an element, based on a combination of the dir attribute, the surrounding text, and other factors. As another example, the its:dir and dirRule element of the Internationalization Tag Set [ITS20] are able to define the directionality of an element in [XML10].",
       "href": "https://drafts.csswg.org/selectors-4/#dir-pseudo",
       "extended": []
     },
@@ -17428,7 +17484,7 @@
     },
     {
       "name": ":invalid",
-      "prose": "An element is :valid or :invalid when its contents or value is, respectively, valid or invalid with respect to data validity semantics defined by the document language (e.g. [XFORMS11] or [HTML5]). An element which lacks data validity semantics is neither :valid nor :invalid.",
+      "prose": "An element is :valid or :invalid when its contents or value is, respectively, valid or invalid with respect to data validity semantics defined by the document language (e.g. [XFORMS11] or [HTML]). An element which lacks data validity semantics is neither :valid nor :invalid.",
       "href": "https://drafts.csswg.org/selectors-4/#invalid-pseudo",
       "syntax": ":invalid",
       "extended": []
@@ -17646,7 +17702,7 @@
     },
     {
       "name": ":placeholder-shown",
-      "prose": "Input elements can sometimes show placeholder text as a hint to the user on what to type in. See, for example, the placeholder attribute in [HTML5]. The :placeholder-shown pseudo-class matches an input element that is showing such placeholder text, whether that text is given by an attribute or a real element, or is otherwise implied by the UA.",
+      "prose": "Input elements can sometimes show placeholder text as a hint to the user on what to type in. See, for example, the placeholder attribute in [HTML]. The :placeholder-shown pseudo-class matches an input element that is showing such placeholder text, whether that text is given by an attribute or a real element, or is otherwise implied by the UA.",
       "href": "https://drafts.csswg.org/selectors-4/#placeholder-shown-pseudo",
       "syntax": ":placeholder-shown",
       "extended": []
@@ -17799,7 +17855,7 @@
     },
     {
       "name": ":unchecked",
-      "prose": "When such elements are toggled “on” the :checked pseudo-class applies. For example, [HTML5] defines that checked checkboxes, radio buttons, and selected <option> elements match :checked. Similarly, when such elements are toggled “off”, the :unchecked pseudo-class applies.",
+      "prose": "When such elements are toggled “on” the :checked pseudo-class applies. For example, [HTML] defines that checked checkboxes, radio buttons, and selected <option> elements match :checked. Similarly, when such elements are toggled “off”, the :unchecked pseudo-class applies.",
       "href": "https://drafts.csswg.org/selectors-4/#unchecked-pseudo",
       "syntax": ":unchecked",
       "extended": []
@@ -17820,7 +17876,7 @@
     },
     {
       "name": ":valid",
-      "prose": "An element is :valid or :invalid when its contents or value is, respectively, valid or invalid with respect to data validity semantics defined by the document language (e.g. [XFORMS11] or [HTML5]). An element which lacks data validity semantics is neither :valid nor :invalid.",
+      "prose": "An element is :valid or :invalid when its contents or value is, respectively, valid or invalid with respect to data validity semantics defined by the document language (e.g. [XFORMS11] or [HTML]). An element which lacks data validity semantics is neither :valid nor :invalid.",
       "href": "https://drafts.csswg.org/selectors-4/#valid-pseudo",
       "syntax": ":valid",
       "extended": []
@@ -18241,7 +18297,7 @@
     {
       "name": "bg-layer",
       "href": "https://drafts.csswg.org/css-backgrounds-4/#typedef-bg-layer",
-      "syntax": "<bg-image> || <bg-position> [ / <bg-size> ]? || <repeat-style> || <attachment> || <bg-clip> || <visual-box>",
+      "syntax": "<bg-image> || <bg-position> [ / <bg-size> ]? || <repeat-style> || <attachment> || <visual-box> || <bg-clip>",
       "extended": []
     },
     {
@@ -18327,7 +18383,7 @@
     {
       "name": "calc-size-basis",
       "href": "https://drafts.csswg.org/css-values-5/#typedef-calc-size-basis",
-      "syntax": "[ <size-keyword> | <calc-size()> | any | <calc-sum> ]",
+      "syntax": "[ <size-keyword> | <calc-sum> | <calc-size()> | any ]",
       "extended": []
     },
     {
@@ -18975,7 +19031,7 @@
     {
       "name": "final-bg-layer",
       "href": "https://drafts.csswg.org/css-backgrounds-4/#typedef-final-bg-layer",
-      "syntax": "<bg-image> || <bg-position> [ / <bg-size> ]? || <repeat-style> || <attachment> || <bg-clip> || <visual-box> || <'background-color'>",
+      "syntax": "<bg-image> || <bg-position> [ / <bg-size> ]? || <repeat-style> || <attachment> || <visual-box> || <bg-clip> || <'background-color'>",
       "extended": []
     },
     {
@@ -19643,6 +19699,24 @@
       "syntax": "[ [ <angle> | <zero> | to <side-or-corner> ] || <color-interpolation-method> ]? , <color-stop-list>",
       "extended": []
     },
+    {
+      "name": "location-descriptor",
+      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-location-descriptor",
+      "syntax": "<pattern-descriptor> | <init-descriptor> | <base-descriptor>",
+      "extended": []
+    },
+    {
+      "name": "location-name",
+      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-location-name",
+      "syntax": "<dashed-ident>",
+      "extended": []
+    },
+    {
+      "name": "location-rule",
+      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-location-rule",
+      "syntax": "@location <dashed-ident> { <declaration-list> }",
+      "extended": []
+    },
     {
       "name": "margin-width",
       "prose": "The properties defined in this section refer to the <margin-width> value type, which may take one of the following values:",
@@ -19881,16 +19955,22 @@
       "syntax": "( <navigation-condition> ) | ( <navigation-test> ) | <general-enclosed>",
       "extended": []
     },
+    {
+      "name": "navigation-location",
+      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-navigation-location",
+      "syntax": "<url> | [ <location-name> | <url-pattern()> ]",
+      "extended": []
+    },
     {
       "name": "navigation-location-between-test",
       "href": "https://drafts.csswg.org/css-navigation-1/#typedef-navigation-location-between-test",
-      "syntax": "between : <route-location> and <route-location>",
+      "syntax": "between : <navigation-location> and <navigation-location>",
       "extended": []
     },
     {
       "name": "navigation-location-test",
       "href": "https://drafts.csswg.org/css-navigation-1/#typedef-navigation-location-test",
-      "syntax": "<navigation-relation> : <route-location>",
+      "syntax": "<navigation-relation> : <navigation-location>",
       "extended": []
     },
     {
@@ -19908,7 +19988,7 @@
     {
       "name": "navigation-relation",
       "href": "https://drafts.csswg.org/css-navigation-1/#typedef-navigation-relation",
-      "syntax": "at | with | from | to",
+      "syntax": "at | from | to",
       "extended": []
     },
     {
@@ -20427,30 +20507,6 @@
       "syntax": "nearest | up | down | to-zero | line-width",
       "extended": []
     },
-    {
-      "name": "route-descriptor",
-      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-route-descriptor",
-      "syntax": "<pattern-descriptor> | <init-descriptor> | <base-descriptor>",
-      "extended": []
-    },
-    {
-      "name": "route-location",
-      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-route-location",
-      "syntax": "<url> | [ <route-name> | <url-pattern()> ]",
-      "extended": []
-    },
-    {
-      "name": "route-name",
-      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-route-name",
-      "syntax": "<dashed-ident>",
-      "extended": []
-    },
-    {
-      "name": "route-rule",
-      "href": "https://drafts.csswg.org/css-navigation-1/#typedef-route-rule",
-      "syntax": "@route <dashed-ident> { <declaration-list> }",
-      "extended": []
-    },
     {
       "name": "rule-list",
       "prose": "<rule-list>: qualified rules and at-rules are allowed; declarations are automatically invalid.",
@@ -20611,7 +20667,7 @@
     {
       "name": "single-animation",
       "href": "https://drafts.csswg.org/css-animations-2/#typedef-single-animation",
-      "syntax": "<'animation-duration'> || <easing-function> || <'animation-delay'> || <single-animation-iteration-count> || <single-animation-direction> || <single-animation-fill-mode> || <single-animation-play-state> || [ none | <keyframes-name> ] || <single-animation-timeline>",
+      "syntax": "<'animation-duration'> || <easing-function> || <'animation-delay-start'> || <single-animation-iteration-count> || <single-animation-direction> || <single-animation-fill-mode> || <single-animation-play-state> || [ none | <keyframes-name> ] || <single-animation-timeline>",
       "extended": []
     },
     {
@@ -20669,9 +20725,12 @@
       "extended": []
     },
     {
+      "for": [
+        "calc-size()"
+      ],
       "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",
+      "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",
       "extended": []
     },
     {
@@ -21133,6 +21192,7 @@
       "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",
+      "syntax": "<custom-ident>",
       "extended": []
     },
     {

package/package.json

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