📦 Release @webref/[email protected]

[github-actions]

⚠ 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 35817a1.

🧐 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.12.2. Merging this pull request will release v6.12.3. 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-anchor-position.json packages/css/css-anchor-position.json
--- webref/node_modules/@webref/css/css-anchor-position.json
+++ packages/css/css-anchor-position.json
@@ -37,6 +37,45 @@
       ]
     },
     {
+      "name": "anchor-scope",
+      "href": "https://drafts.csswg.org/css-anchor-position-1/#propdef-anchor-scope",
+      "value": "none | all | <dashed-ident>#",
+      "initial": "none",
+      "appliesTo": "all elements",
+      "inherited": "no",
+      "percentages": "n/a",
+      "computedValue": "as specified",
+      "canonicalOrder": "per grammar",
+      "animationType": "discrete",
+      "values": [
+        {
+          "name": "none",
+          "prose": "No changes in anchor name scope.",
+          "href": "https://drafts.csswg.org/css-anchor-position-1/#valdef-anchor-scope-none",
+          "type": "value",
+          "value": "none"
+        },
+        {
+          "name": "all",
+          "prose": "Specifies that all anchor names defined by this element or its descendants—​whose scope is not already limited by a descendant using anchor-scope—​to be in scope only for this element’s descendants; and limits descendants to only match anchor names to anchor elements within this subtree.",
+          "href": "https://drafts.csswg.org/css-anchor-position-1/#valdef-anchor-scope-all",
+          "type": "value",
+          "value": "all"
+        },
+        {
+          "name": "<dashed-ident>",
+          "prose": "Specifies that a matching anchor name defined by this element or its descendants—​whose scope is not already limited by a descendant using anchor-scope—​to be in scope only for this element’s descendants; and limits descendants to only match these anchor names to anchor elements within this subtree.",
+          "href": "https://drafts.csswg.org/css-anchor-position-1/#valdef-anchor-scope-dashed-ident",
+          "type": "value",
+          "value": "<dashed-ident>"
+        }
+      ],
+      "styleDeclaration": [
+        "anchor-scope",
+        "anchorScope"
+      ]
+    },
+    {
       "name": "anchor-default",
       "href": "https://drafts.csswg.org/css-anchor-position-1/#propdef-anchor-default",
       "value": "<anchor-element>",
@@ -73,7 +112,7 @@
         },
         {
           "name": "<inset-area>",
-          "prose": "If the element does not have a default anchor element, or is not an absolutely-positioned element, this value has no effect. Otherwise, the property selects a region of the inset-area grid, and makes that the element’s containing block. Additionally, the normal value for the self-alignment properties behaves as either start, end, or anchor-center, depending on the positioning of the region, to give a good default alignment for the positioned element. See § 3.1.1 Resolving <inset-area>s for details on both of these effects. If the two <inset-area-span>s do not define a valid region, this property is invalid. Also, any auto inset properties resolve to 0.",
+          "prose": "If the element does not have a default anchor element, or is not an absolutely-positioned element, this value has no effect. Otherwise, the property selects a region of the inset-area grid, and makes that the element’s containing block. Additionally, the normal value for the self-alignment properties behaves as either start, end, or anchor-center, depending on the positioning of the region, to give a good default alignment for the positioned element. See § 3.1.1 Resolving <inset-area>s for details on both of these effects. Also, any auto inset properties resolve to 0.",
           "href": "https://drafts.csswg.org/css-anchor-position-1/#valdef-inset-area-inset-area",
           "type": "value",
           "value": "<inset-area>"
@@ -298,38 +337,6 @@
         "position-try",
         "positionTry"
       ]
-    },
-    {
-      "name": "position-animation",
-      "href": "https://drafts.csswg.org/css-anchor-position-1/#propdef-position-animation",
-      "value": "normal | magic",
-      "initial": "normal",
-      "appliesTo": "absolutely positioned elements",
-      "inherited": "no",
-      "percentages": "n/a",
-      "computedValue": "normal, or an overriding position rectangle (see prose)",
-      "canonicalOrder": "per grammar",
-      "animationType": "(see prose)",
-      "values": [
-        {
-          "name": "normal",
-          "prose": "This value has no effect.",
-          "href": "https://drafts.csswg.org/css-anchor-position-1/#valdef-position-animation-normal",
-          "type": "value",
-          "value": "normal"
-        },
-        {
-          "name": "magic",
-          "prose": "At computed value time, resolves to a overriding position rectangle, using interleaving. At used value time, overrides the position and size of the element’s margin box, setting it to match the computed overriding position rectangle.",
-          "href": "https://drafts.csswg.org/css-anchor-position-1/#valdef-position-animation-magic",
-          "type": "value",
-          "value": "magic"
-        }
-      ],
-      "styleDeclaration": [
-        "position-animation",
-        "positionAnimation"
-      ]
     }
   ],
   "atrules": [

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-backgrounds.json packages/css/css-backgrounds.json
--- webref/node_modules/@webref/css/css-backgrounds.json
+++ packages/css/css-backgrounds.json
@@ -34,7 +34,7 @@
       "values": [
         {
           "name": "none",
-          "prose": "A value of none counts as an image layer but draws nothing. An image that is empty (zero width or zero height), that fails to download, or that cannot be displayed (e.g., because it is not in a supported image format) likewise counts as a layer but draws nothing.",
+          "prose": "A value of none counts as a background image layer but draws nothing. An image that is empty (zero width or zero height), that fails to download, or that cannot be displayed (e.g., because it is not in a supported image format) likewise counts as a layer but draws nothing.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-background-image-none",
           "type": "value",
           "value": "none"
@@ -80,7 +80,7 @@
         },
         {
           "name": "space",
-          "prose": "The image is repeated as often as will fit within the background positioning area without being clipped and then the images are spaced out to fill the area. The first and last images touch the edges of the area. If the background painting area is larger than the background positioning area, then the pattern repeats to fill the background painting area. The value of background-position for this direction is ignored, unless there is not enough space for two copies of the image in this direction, in which case only one image is placed and background-position determines its position in this direction.",
+          "prose": "The image is repeated as often as will fit within the background positioning area without being clipped, and then the images are spaced out to fill the area. The first and last images touch the edges of the area. If the background painting area is larger than the background positioning area, then the pattern repeats to fill the background painting area. The value of background-position for this direction is ignored unless there is not enough space for two copies of the image in this axis, in which case only one image is placed, and background-position determines its position in this axis.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-background-repeat-space",
           "type": "value",
           "value": "space"
@@ -126,14 +126,14 @@
         },
         {
           "name": "local",
-          "prose": "The background is fixed with regard to the element’s contents: if the element has a scrolling mechanism, the background scrolls with the element’s contents, and the background painting area and background positioning area are relative to the scrollable area of the element rather than to the border framing them. Because the scrollable area does not include the border area, for scrollable elements the border-box value of background-clip may be treated the same as padding-box.",
+          "prose": "The background is fixed with regard to the box’s contents: if the box has a scrolling mechanism, the background scrolls with the box’s contents, and the background painting area and background positioning area are relative to the scrollable overflow area of the box rather than to the border framing them. Because the scrollable overflow area does not include the border area, for scroll containers the border-box value of background-clip may be treated the same as padding-box.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-background-attachment-local",
           "type": "value",
           "value": "local"
         },
         {
           "name": "scroll",
-          "prose": "The background is fixed with regard to the element itself and does not scroll with its contents. (It is effectively attached to the element’s border.)",
+          "prose": "The background is fixed with regard to the box itself and does not scroll with its contents. (It is effectively attached to the box’s border.)",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-background-attachment-scroll",
           "type": "value",
           "value": "scroll"
@@ -317,14 +317,14 @@
         },
         {
           "name": "<length-percentage [0,∞]>",
-          "prose": "The first value gives the width of the corresponding image, the second value its height. If only one value is given the second is assumed to be auto. A percentage is relative to the background positioning area. An auto value for one dimension is resolved by using the image’s natural aspect ratio and the size of the other dimension, or failing that, using the image’s natural size, or failing that, treating it as 100%. If both values are auto then the natural width and/or height of the image should be used, if any, the missing dimension (if any) behaving as auto as described above. If the image has neither natural size, its size is determined as for contain. Negative values are invalid.",
+          "prose": "The first value gives the width of the corresponding image, the second value its height. If only one value is given the second is assumed to be auto. A <percentage> is relative to the background positioning area. An auto value for one dimension is resolved by using the image’s natural aspect ratio and the size of the other dimension, or failing that, using the image’s natural size, or failing that, treating it as 100%. If both values are auto then the natural width and/or height of the image should be used, if any, the missing dimension (if any) behaving as auto as described above. If the image has neither natural size, its size is determined as for contain. Negative values are invalid.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-background-size-length-percentage-0",
           "type": "value",
           "value": "<length-percentage [0,∞]>"
         },
         {
           "name": "auto",
-          "prose": "The first value gives the width of the corresponding image, the second value its height. If only one value is given the second is assumed to be auto. A percentage is relative to the background positioning area. An auto value for one dimension is resolved by using the image’s natural aspect ratio and the size of the other dimension, or failing that, using the image’s natural size, or failing that, treating it as 100%. If both values are auto then the natural width and/or height of the image should be used, if any, the missing dimension (if any) behaving as auto as described above. If the image has neither natural size, its size is determined as for contain. Negative values are invalid.",
+          "prose": "The first value gives the width of the corresponding image, the second value its height. If only one value is given the second is assumed to be auto. A <percentage> is relative to the background positioning area. An auto value for one dimension is resolved by using the image’s natural aspect ratio and the size of the other dimension, or failing that, using the image’s natural size, or failing that, treating it as 100%. If both values are auto then the natural width and/or height of the image should be used, if any, the missing dimension (if any) behaving as auto as described above. If the image has neither natural size, its size is determined as for contain. Negative values are invalid.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-background-size-auto",
           "type": "value",
           "value": "auto"
@@ -480,7 +480,7 @@
         },
         {
           "name": "auto",
-          "prose": "If auto is specified then the border image width is the natural width or height (whichever is applicable) of the corresponding image slice (see border-image-slice). If the image does not have the required natural dimension then the corresponding computed border-width is used instead.",
+          "prose": "If auto is specified then the used border-image-width is the natural width or height (whichever is applicable) of the corresponding image slice (see border-image-slice). If the image does not have the required natural dimension then the corresponding computed border-width is used instead.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-border-image-width-auto",
           "type": "value",
           "value": "auto"
@@ -521,28 +521,28 @@
       "values": [
         {
           "name": "stretch",
-          "prose": "The image is stretched to fill the area.",
+          "prose": "The image is stretched to fill its corresponding region.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-border-image-repeat-stretch",
           "type": "value",
           "value": "stretch"
         },
         {
           "name": "repeat",
-          "prose": "The image is tiled (repeated) to fill the area.",
+          "prose": "The image is tiled (repeated) to fill its corresponding region.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-border-image-repeat-repeat",
           "type": "value",
           "value": "repeat"
         },
         {
           "name": "round",
-          "prose": "The image is tiled (repeated) to fill the area. If it does not fill the area with a whole number of tiles, the image is rescaled so that it does.",
+          "prose": "The image is tiled (repeated) to fill its corresponding region. If it does not fill the area with a whole number of tiles, the image is rescaled so that it does.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-border-image-repeat-round",
           "type": "value",
           "value": "round"
         },
         {
           "name": "space",
-          "prose": "The image is tiled (repeated) to fill the area. If it does not fill the area with a whole number of tiles, the extra space is distributed around the tiles.",
+          "prose": "The image is tiled (repeated) to fill its corresponding region. If it does not fill the region with a whole number of tiles, the extra space is distributed around the tiles.",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-border-image-repeat-space",
           "type": "value",
           "value": "space"
@@ -665,7 +665,7 @@
         },
         {
           "name": "groove",
-          "prose": "Looks as if it were carved in the canvas. (This is typically achieved by creating a “shadow” from two colors that are slightly lighter and darker than the border-color.)",
+          "prose": "Looks as if it were carved in the canvas. (This is typically achieved by creating a “shadow” from two colors that are slightly lighter and darker than the specified border-color.)",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-line-style-groove",
           "type": "value",
           "value": "groove"
@@ -686,7 +686,7 @@
         },
         {
           "name": "outset",
-          "prose": "Looks as if the content on the inside of the border is coming out of the canvas. Treated as groove in the collapsing border model. [CSS2]",
+          "prose": "Looks as if the content on the inside of the border is raised out of the canvas. Treated as groove in the collapsing border model. [CSS2]",
           "href": "https://drafts.csswg.org/css-backgrounds-3/#valdef-line-style-outset",
           "type": "value",
           "value": "outset"

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-box.json packages/css/css-box.json
--- webref/node_modules/@webref/css/css-box.json
+++ packages/css/css-box.json
@@ -108,28 +108,28 @@
         },
         {
           "name": "block-start",
-          "prose": "For in-flow boxes and floats contained by this box, margins adjacent to the box’s specified edges are truncated to zero. It also truncates any descendant margins collapsed with such a margin (but not its own, its siblings’, or its ancestors’).",
+          "prose": "For in-flow boxes contained by this box, margins adjacent to the box’s specified edges are truncated to zero. It also truncates any descendant margins collapsed with such a margin (but not its own, its siblings’, or its ancestors’).",
           "href": "https://drafts.csswg.org/css-box-4/#valdef-margin-trim-block-start",
           "type": "value",
           "value": "block-start"
         },
         {
           "name": "inline-start",
-          "prose": "For in-flow boxes and floats contained by this box, margins adjacent to the box’s specified edges are truncated to zero. It also truncates any descendant margins collapsed with such a margin (but not its own, its siblings’, or its ancestors’).",
+          "prose": "For in-flow boxes contained by this box, margins adjacent to the box’s specified edges are truncated to zero. It also truncates any descendant margins collapsed with such a margin (but not its own, its siblings’, or its ancestors’).",
           "href": "https://drafts.csswg.org/css-box-4/#valdef-margin-trim-inline-start",
           "type": "value",
           "value": "inline-start"
         },
         {
           "name": "inline-end",
-          "prose": "For in-flow boxes and floats contained by this box, margins adjacent to the box’s specified edges are truncated to zero. It also truncates any descendant margins collapsed with such a margin (but not its own, its siblings’, or its ancestors’).",
+          "prose": "For in-flow boxes contained by this box, margins adjacent to the box’s specified edges are truncated to zero. It also truncates any descendant margins collapsed with such a margin (but not its own, its siblings’, or its ancestors’).",
           "href": "https://drafts.csswg.org/css-box-4/#valdef-margin-trim-inline-end",
           "type": "value",
           "value": "inline-end"
         },
         {
           "name": "block-end",
-          "prose": "For in-flow boxes and floats contained by this box, margins adjacent to the box’s specified edges are truncated to zero. It also truncates any descendant margins collapsed with such a margin (but not its own, its siblings’, or its ancestors’).",
+          "prose": "For in-flow boxes contained by this box, margins adjacent to the box’s specified edges are truncated to zero. It also truncates any descendant margins collapsed with such a margin (but not its own, its siblings’, or its ancestors’).",
           "href": "https://drafts.csswg.org/css-box-4/#valdef-margin-trim-block-end",
           "type": "value",
           "value": "block-end"

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-text-4.json packages/css/css-text-4.json
--- webref/node_modules/@webref/css/css-text-4.json
+++ packages/css/css-text-4.json
@@ -454,7 +454,7 @@
     {
       "name": "text-wrap-style",
       "href": "https://drafts.csswg.org/css-text-4/#propdef-text-wrap-style",
-      "value": "auto| balance | stable | pretty",
+      "value": "auto | balance | stable | pretty",
       "initial": "auto",
       "appliesTo": "block containers hat establish an inline formatting context",
       "inherited": "yes",

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-text-decor-4.json packages/css/css-text-decor-4.json
--- webref/node_modules/@webref/css/css-text-decor-4.json
+++ packages/css/css-text-decor-4.json
@@ -120,7 +120,7 @@
       "appliesTo": "all elements",
       "inherited": "no",
       "percentages": "N/A",
-      "computedValue": "specified keyword or absolute length",
+      "computedValue": "as specified, with <length-percentage> values computed",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value",
       "values": [
@@ -235,7 +235,7 @@
       "appliesTo": "all elements",
       "inherited": "yes",
       "percentages": "N/A",
-      "computedValue": "specified keyword or absolute length",
+      "computedValue": "as specified, with <length-percentage> values computed",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value",
       "values": [

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-values.json packages/css/css-values.json
--- webref/node_modules/@webref/css/css-values.json
+++ packages/css/css-values.json
@@ -538,7 +538,7 @@
     },
     {
       "name": "<position>",
-      "prose": "The <position> value specifies the position of a object area (e.g. background image) inside a positioning area (e.g. background positioning area). It is interpreted as specified for background-position. [CSS3-BACKGROUND]",
+      "prose": "The <position> value specifies the position of a object area (e.g. background image) inside a positioning area (e.g. background positioning area). It is computed and interpreted as specified for background-position. [CSS3-BACKGROUND]",
       "href": "https://drafts.csswg.org/css-values-4/#typedef-position",
       "type": "type",
       "value": "[ [ left | center | right | top | bottom | <length-percentage> ] | [ left | center | right ] && [ top | center | bottom ] | [ left | center | right | <length-percentage> ] [ top | center | bottom | <length-percentage> ] | [ [ left | right ] <length-percentage> ] && [ [ top | bottom ] <length-percentage> ] ]"
@@ -606,11 +606,20 @@
       "prose": "The clamp() function takes three calculations—​a minimum value, a central value, and a maximum value—​and represents its central calculation, clamped according to its min and max calculations, favoring the min calculation if it conflicts with the max. (That is, given clamp(MIN, VAL, MAX), it represents exactly the same value as max(MIN, min(VAL, MAX))).",
       "href": "https://drafts.csswg.org/css-values-4/#funcdef-clamp",
       "type": "function",
-      "value": "clamp( <calc-sum>#{3} )"
+      "value": "clamp( [ <calc-sum> | none ], <calc-sum>, [ <calc-sum> | none ] )",
+      "values": [
+        {
+          "name": "none",
+          "prose": "Either the min or max calculations (or even both) can instead be the keyword none, which indicates the value is not clamped from that side. (That is, clamp(MIN, VAL, none) is equivalent to max(MIN, VAL), clamp(none, VAL, MAX) is equivalent to min(VAL, MAX), and clamp(none, VAL, none) is equivalent to just calc(VAL).)",
+          "href": "https://drafts.csswg.org/css-values-4/#valdef-clamp-none",
+          "type": "value",
+          "value": "none"
+        }
+      ]
     },
     {
       "name": "round()",
-      "value": "round( <rounding-strategy>?, <calc-sum>, <calc-sum> )",
+      "value": "round( <rounding-strategy>?, <calc-sum>, <calc-sum>? )",
       "href": "https://drafts.csswg.org/css-values-4/#funcdef-round",
       "type": "function"
     },