w3c / webref

Machine-readable references of terms defined in web browser specifications
https://w3c.github.io/webref/
MIT License
303 stars 72 forks source link

📦 Release @webref/css@6.17.2 #1384

Closed github-actions[bot] closed 4 days ago

github-actions[bot] commented 1 week ago

⚠ NEVER add commits to this pull request.

🤖 This pull request was automatically created to facilitate human review of @webref/css changes triggered by curated data at 5c9610550e77f1ec4ef73dbf7defbbdf9f93cfd2.

🧐 Please review the diff below and version numbers. If all looks good, merge this pull request to release the changes to npm.

📦 Latest released @webref/css package was v6.17.1. Merging this pull request will release v6.17.2. Make sure that the bump is the right one for the changes.

✍ If any change needs to be made before release, do not add a commit to this pull request. Changes should rather be handled in a separate pull request and pushed to the main branch. You may leave this pull request open in the meantime, or close it. The pre-release job will automatically update this pull request or create a new one once the updates have made their way to the main branch.

🛈 The actual change introduced by this pull request is a version bump in packages/css/package.json. You do not need to review that change. The bumped version is not the version that will be released when this pull request is merged, but rather the version that will be released next time.

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-cascade-6.json packages/css/css-cascade-6.json
--- webref/node_modules/@webref/css/css-cascade-6.json
+++ packages/css/css-cascade-6.json
@@ -10,7 +10,7 @@
       "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.",
       "href": "https://drafts.csswg.org/css-cascade-6/#at-ruledef-scope",
       "descriptors": [],
-      "value": "@scope [(<scope-start>)]? [to (<scope-end>)]? { <rule-list> }"
+      "value": "@scope [(<scope-start>)]? [to (<scope-end>)]? { <block-contents> }"
     }
   ],
   "selectors": [],

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-color-hdr.json packages/css/css-color-hdr.json
--- webref/node_modules/@webref/css/css-color-hdr.json
+++ packages/css/css-color-hdr.json
@@ -1,12 +1,12 @@
 {
   "spec": {
     "title": "CSS Color HDR Module Level 1",
-    "url": "https://drafts.csswg.org/css-color-hdr/"
+    "url": "https://drafts.csswg.org/css-color-hdr-1/"
   },
   "properties": [
     {
       "name": "dynamic-range-limit",
-      "href": "https://drafts.csswg.org/css-color-hdr/#propdef-dynamic-range-limit",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#propdef-dynamic-range-limit",
       "value": "standard | high | constrained-high | <dynamic-range-limit-mix()>",
       "initial": "high",
       "appliesTo": "all elements",
@@ -19,21 +19,21 @@
         {
           "name": "standard",
           "prose": "The highest luminance color that is displayed is the same as media white, i.e. the CSS color white.",
-          "href": "https://drafts.csswg.org/css-color-hdr/#valdef-dynamic-range-limit-standard",
+          "href": "https://drafts.csswg.org/css-color-hdr-1/#valdef-dynamic-range-limit-standard",
           "type": "value",
           "value": "standard"
         },
         {
           "name": "high",
           "prose": "The highest peak luminance that is displayed is much greater than media white, i.e. the CSS color white; the precise level is not specified.",
-          "href": "https://drafts.csswg.org/css-color-hdr/#valdef-dynamic-range-limit-high",
+          "href": "https://drafts.csswg.org/css-color-hdr-1/#valdef-dynamic-range-limit-high",
           "type": "value",
           "value": "high"
         },
         {
           "name": "constrained-high",
           "prose": "The highest peak luminance that is displayed is somewhat greater than media white, i.e. the CSS color white, such that a mix of SDR and HDR content can be comfortably viewed together.",
-          "href": "https://drafts.csswg.org/css-color-hdr/#valdef-dynamic-range-limit-constrained-high",
+          "href": "https://drafts.csswg.org/css-color-hdr-1/#valdef-dynamic-range-limit-constrained-high",
           "type": "value",
           "value": "constrained-high"
         }
@@ -49,67 +49,67 @@
   "values": [
     {
       "name": "dynamic-range-limit-mix()",
-      "href": "https://drafts.csswg.org/css-color-hdr/#funcdef-dynamic-range-limit-mix",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#funcdef-dynamic-range-limit-mix",
       "type": "function",
       "value": "dynamic-range-limit-mix( [ <ident> && <percentage [0,100]> ]+)"
     },
     {
       "name": "color()",
-      "href": "https://drafts.csswg.org/css-color-hdr/#funcdef-color",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#funcdef-color",
       "type": "function",
       "value": "color( [from <color>]? <colorspace-params> [ / [ <alpha-value> | none ] ]? )"
     },
     {
       "name": "<colorspace-params>",
-      "href": "https://drafts.csswg.org/css-color-hdr/#typedef-colorspace-params",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#typedef-colorspace-params",
       "type": "type",
       "value": "[<custom-params> | <predefined-rgb-params> | <predefined-polar-params> | <predefined-rectangular-params> | <xyz-params>]"
     },
     {
       "name": "<custom-params>",
-      "href": "https://drafts.csswg.org/css-color-hdr/#typedef-custom-params",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#typedef-custom-params",
       "type": "type",
       "value": "<dashed-ident> [ <number> | <percentage> | none ]+"
     },
     {
       "name": "<predefined-rgb-params>",
-      "href": "https://drafts.csswg.org/css-color-hdr/#typedef-predefined-rgb-params",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#typedef-predefined-rgb-params",
       "type": "type",
       "value": "<predefined-rgb> [ <number> | <percentage> | none ]{3}"
     },
     {
       "name": "<predefined-polar-params>",
-      "href": "https://drafts.csswg.org/css-color-hdr/#typedef-predefined-polar-params",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#typedef-predefined-polar-params",
       "type": "type",
       "value": "jzczhz [ <number> | <percentage> | none ]{2} [ <hue> | none]"
     },
     {
       "name": "<predefined-rectangular-params>",
-      "href": "https://drafts.csswg.org/css-color-hdr/#typedef-predefined-rectangular-params",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#typedef-predefined-rectangular-params",
       "type": "type",
       "value": "<predefined-rectangular> [ <number> | <percentage> | none ]{3}"
     },
     {
       "name": "<predefined-rgb>",
-      "href": "https://drafts.csswg.org/css-color-hdr/#typedef-predefined-rgb",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#typedef-predefined-rgb",
       "type": "type",
       "value": "srgb | srgb-linear | display-p3 | a98-rgb | prophoto-rgb | rec2020 | rec2100-pq | rec2100-hlg | rec2100-linear"
     },
     {
       "name": "<predefined-rectangular>",
-      "href": "https://drafts.csswg.org/css-color-hdr/#typedef-predefined-rectangular",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#typedef-predefined-rectangular",
       "type": "type",
       "value": "jzazbz | ictcp"
     },
     {
       "name": "<xyz-params>",
-      "href": "https://drafts.csswg.org/css-color-hdr/#typedef-xyz-params",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#typedef-xyz-params",
       "type": "type",
       "value": "<xyz> [ <number> | <percentage> | none ]{3}"
     },
     {
       "name": "<xyz>",
-      "href": "https://drafts.csswg.org/css-color-hdr/#typedef-xyz",
+      "href": "https://drafts.csswg.org/css-color-hdr-1/#typedef-xyz",
       "type": "type",
       "value": "xyz | xyz-d50 | xyz-d65"
     }

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-conditional-5.json packages/css/css-conditional-5.json
--- webref/node_modules/@webref/css/css-conditional-5.json
+++ packages/css/css-conditional-5.json
@@ -404,7 +404,7 @@
       "name": "<container-condition>",
       "href": "https://drafts.csswg.org/css-conditional-5/#typedef-container-condition",
       "type": "type",
-      "value": "[ <container-name> ]? <container-query>"
+      "value": "[ <container-name>? <container-query>? ]!"
     },
     {
       "name": "<container-name>",

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-display.json packages/css/css-display.json
--- webref/node_modules/@webref/css/css-display.json
+++ packages/css/css-display.json
@@ -101,7 +101,7 @@
         },
         {
           "name": "grid-order",
-          "prose": "Follows the order-modified document order. Therefore, as normal unless the order property has been used to change the order of items.",
+          "prose": "Only takes effect on grid containers. Follows the order-modified document order. Therefore, as normal unless the order property has been used to change the order of items.",
           "href": "https://drafts.csswg.org/css-display-4/#valdef-reading-flow-grid-order",
           "type": "value",
           "value": "grid-order"

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-fonts.json packages/css/css-fonts.json
--- webref/node_modules/@webref/css/css-fonts.json
+++ packages/css/css-fonts.json
@@ -1072,7 +1072,7 @@
       "percentages": "n/a",
       "computedValue": "the keyword normal or a list, each item a string paired with a number",
       "canonicalOrder": "per grammar",
-      "animationType": "(see prose)",
+      "animationType": "see prose",
       "styleDeclaration": [
         "font-variation-settings",
         "fontVariationSettings"

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-overflow-5.json packages/css/css-overflow-5.json
--- webref/node_modules/@webref/css/css-overflow-5.json
+++ packages/css/css-overflow-5.json
@@ -93,10 +93,94 @@
       "href": "https://drafts.csswg.org/css-overflow-5/#selectordef-scroll-marker"
     },
     {
+      "name": "::scroll-button()",
+      "value": "::scroll-button( <scroll-button-direction> )",
+      "href": "https://drafts.csswg.org/css-overflow-5/#selectordef-scroll-button-scroll-button-direction"
+    },
+    {
       "name": "::nth-fragment()",
       "prose": "The ::nth-fragment() pseudo-element is a pseudo-element that describes some of the fragment boxes generated by an element. The argument to the pseudo-element takes the same syntax as the argument to the :nth-child() pseudo-class defined in [SELECT], and has the same meaning except that the number is relative to fragment boxes generated by the element instead of siblings of the element.",
       "href": "https://drafts.csswg.org/css-overflow-5/#selectordef-nth-fragment"
     }
   ],
-  "values": []
+  "values": [
+    {
+      "name": "<scroll-button-direction>",
+      "prose": "The four ::scroll-button() pseudo-elements are individually selected by the selector’s argument. The possible <scroll-button-direction> values are:",
+      "href": "https://drafts.csswg.org/css-overflow-5/#typedef-scroll-button-direction",
+      "type": "type",
+      "values": [
+        {
+          "name": "up",
+          "prose": "Selects the ''::scroll-button()' corresponding to the given physical direction.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-up",
+          "type": "value",
+          "value": "up"
+        },
+        {
+          "name": "down",
+          "prose": "Selects the ''::scroll-button()' corresponding to the given physical direction.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-down",
+          "type": "value",
+          "value": "down"
+        },
+        {
+          "name": "left",
+          "prose": "Selects the ''::scroll-button()' corresponding to the given physical direction.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-left",
+          "type": "value",
+          "value": "left"
+        },
+        {
+          "name": "right",
+          "prose": "Selects the ''::scroll-button()' corresponding to the given physical direction.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-right",
+          "type": "value",
+          "value": "right"
+        },
+        {
+          "name": "block-start",
+          "prose": "Selects the indicated ::scroll-button() pseudo-element.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-block-start",
+          "type": "value",
+          "value": "block-start"
+        },
+        {
+          "name": "block-end",
+          "prose": "Selects the indicated ::scroll-button() pseudo-element.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-block-end",
+          "type": "value",
+          "value": "block-end"
+        },
+        {
+          "name": "inline-start",
+          "prose": "Selects the indicated ::scroll-button() pseudo-element.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-inline-start",
+          "type": "value",
+          "value": "inline-start"
+        },
+        {
+          "name": "inline-end",
+          "prose": "Selects the indicated ::scroll-button() pseudo-element.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-inline-end",
+          "type": "value",
+          "value": "inline-end"
+        },
+        {
+          "name": "prev",
+          "prose": "Selects either the block-start or inline-start ::scroll-button(), whichever’s axis has more \"scrollable pages\" in the originating element: the originating element’s scrollable overflow height divided by its scrollport height, or the same but for widths. If both dimensions are equally sized, selects the block-start ::scroll-button(). For example, say the originating element was 800px wide and 500px tall, while its scrollable overflow area was 1200px wide and 1000px tall. The horizontal scrolling thus represents 1.5 \"pages\" (1200/800), while the vertical scrolling represents 2 \"pages\" (1000/500), so (assuming the element is in English) the ::scroll-button(prev) selector would select the block-start button.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-prev",
+          "type": "value",
+          "value": "prev"
+        },
+        {
+          "name": "next",
+          "prose": "Identical to prev, except it selects the block-end or inline-end ::scroll-button() instead.",
+          "href": "https://drafts.csswg.org/css-overflow-5/#valdef-scroll-button-direction-next",
+          "type": "value",
+          "value": "next"
+        }
+      ]
+    }
+  ]
 }

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-position-4.json packages/css/css-position-4.json
--- webref/node_modules/@webref/css/css-position-4.json
+++ packages/css/css-position-4.json
@@ -14,7 +14,7 @@
       "percentages": "n/a",
       "computedValue": "as specified",
       "canonicalOrder": "per grammar",
-      "animationType": "(see prose)",
+      "animationType": "see prose",
       "values": [
         {
           "name": "none",

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-rhythm.json packages/css/css-rhythm.json
--- webref/node_modules/@webref/css/css-rhythm.json
+++ packages/css/css-rhythm.json
@@ -23,8 +23,8 @@
     {
       "name": "block-step-insert",
       "href": "https://drafts.csswg.org/css-rhythm-1/#propdef-block-step-insert",
-      "value": "margin | padding",
-      "initial": "margin",
+      "value": "margin-box | padding-box | content-box",
+      "initial": "margin-box",
       "appliesTo": "block-level boxes",
       "inherited": "no",
       "percentages": "N/A",
@@ -33,18 +33,25 @@
       "animationType": "discrete",
       "values": [
         {
-          "name": "margin",
+          "name": "margin-box",
           "prose": "Any extra space resulting from a block-step-size-induced adjustment is inserted outside the box’s border, as extra margin.",
-          "href": "https://drafts.csswg.org/css-rhythm-1/#valdef-block-step-insert-margin",
+          "href": "https://drafts.csswg.org/css-rhythm-1/#valdef-block-step-insert-margin-box",
           "type": "value",
-          "value": "margin"
+          "value": "margin-box"
         },
         {
-          "name": "padding",
+          "name": "padding-box",
           "prose": "Any extra space resulting from a block-step-size-induced adjustment is inserted inside the box’s border, as extra padding.",
-          "href": "https://drafts.csswg.org/css-rhythm-1/#valdef-block-step-insert-padding",
+          "href": "https://drafts.csswg.org/css-rhythm-1/#valdef-block-step-insert-padding-box",
           "type": "value",
-          "value": "padding"
+          "value": "padding-box"
+        },
+        {
+          "name": "content-box",
+          "prose": "Any extra space resulting from a block-step-size-induced adjustment is inserted inside the box’s border by increasing the height of the content area.",
+          "href": "https://drafts.csswg.org/css-rhythm-1/#valdef-block-step-insert-content-box",
+          "type": "value",
+          "value": "content-box"
         }
       ],
       "styleDeclaration": [
@@ -155,7 +162,7 @@
       "name": "line-height-step",
       "href": "https://drafts.csswg.org/css-rhythm-1/#propdef-line-height-step",
       "value": "<length [0,∞]>",
-      "initial": "0px",
+      "initial": "0",
       "appliesTo": "block containers",
       "inherited": "yes",
       "percentages": "N/A",

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-scroll-snap-2.json packages/css/css-scroll-snap-2.json
--- webref/node_modules/@webref/css/css-scroll-snap-2.json
+++ packages/css/css-scroll-snap-2.json
@@ -7,7 +7,7 @@
     {
       "name": "scroll-start-target",
       "href": "https://drafts.csswg.org/css-scroll-snap-2/#propdef-scroll-start-target",
-      "value": "[ none | auto ]",
+      "value": "none | auto",
       "initial": "none",
       "appliesTo": "all elements",
       "inherited": "no",

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-values-5.json packages/css/css-values-5.json
--- webref/node_modules/@webref/css/css-values-5.json
+++ packages/css/css-values-5.json
@@ -25,7 +25,7 @@
         },
         {
           "name": "allow-keywords",
-          "prose": "Two values can 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 § 10.3 Interpolating calc-size(). In other cases, an <intrinsic-size-keyword> still cannot be interpolated.",
+          "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 § 10.3 Interpolating calc-size(). In other cases, an <intrinsic-size-keyword> still cannot be interpolated.",
           "href": "https://drafts.csswg.org/css-values-5/#valdef-interpolate-size-allow-keywords",
           "type": "value",
           "value": "allow-keywords"
@@ -41,6 +41,12 @@
   "selectors": [],
   "values": [
     {
+      "name": "<boolean-expr[]>",
+      "prose": "Several contexts (such as @media, @supports, if(), ...) specify conditions, and allow combining those conditions with boolean logic (and/or/not/grouping). Because they use the same non-trivial recursive syntax structure, the special <boolean-expr[]> production represents this pattern generically.",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-boolean-expr",
+      "type": "type"
+    },
+    {
       "name": "<syntax>",
       "href": "https://drafts.csswg.org/css-values-5/#typedef-syntax",
       "type": "type",
@@ -504,7 +510,7 @@
       "prose": "The attr() function substitutes the value of an attribute on an element into a property, similar to how the var() function substitutes a custom property value into a function.",
       "href": "https://drafts.csswg.org/css-values-5/#funcdef-attr",
       "type": "function",
-      "value": "attr( <attr-name> <syntax>? , <declaration-value>?)"
+      "value": "attr( <attr-name> <attr-type>? , <declaration-value>?)"
     },
     {
       "name": "<attr-name>",
@@ -513,6 +519,18 @@
       "value": "[ <ident-token> '|' ]? <ident-token>"
     },
     {
+      "name": "<attr-type>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-attr-type",
+      "type": "type",
+      "value": "type( <syntax> ) | string | <attr-unit>"
+    },
+    {
+      "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": "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:",
       "href": "https://drafts.csswg.org/css-values-5/#funcdef-random",
@@ -583,12 +601,12 @@
     {
       "msg": "Missing definition",
       "name": "]>",
-      "value": "not <boolean-group> | <boolean-group> [ [ and <boolean-group> ]* | [ or <boolean-group> ]* ]"
+      "value": "not <boolean-expr-group> | <boolean-expr-group> [ [ and <boolean-expr-group> ]* | [ or <boolean-expr-group> ]* ]"
     },
     {
       "msg": "Missing definition",
-      "name": "<boolean-group>",
-      "value": "<test> | ( <boolean[ <test> ]> ) | <general-enclosed>"
+      "name": "<boolean-expr-group>",
+      "value": "<test> | ( <boolean-expr[ <test> ]> ) | <general-enclosed>"
     },
     {
       "msg": "Missing definition",