📦 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 92cf383.

🧐 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.15.1. Merging this pull request will release v6.15.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-easing.json packages/css/css-easing.json
--- webref/node_modules/@webref/css/css-easing.json
+++ packages/css/css-easing.json
@@ -9,18 +9,15 @@
   "values": [
     {
       "name": "<easing-function>",
-      "value": "linear | <linear-easing-function> | <cubic-bezier-easing-function> | <step-easing-function>",
       "href": "https://drafts.csswg.org/css-easing-2/#typedef-easing-function",
       "type": "type",
-      "values": [
-        {
-          "name": "linear",
-          "prose": "The linear keyword produces an identity linear easing function whose output progress value is equal to the input progress value for all inputs.",
-          "href": "https://drafts.csswg.org/css-easing-2/#valdef-easing-function-linear",
-          "type": "value",
-          "value": "linear"
-        }
-      ]
+      "value": "<linear-easing-function> | <cubic-bezier-easing-function> | <step-easing-function>"
+    },
+    {
+      "name": "<linear-easing-function>",
+      "href": "https://drafts.csswg.org/css-easing-2/#typedef-linear-easing-function",
+      "type": "type",
+      "value": "linear | <linear()>"
     },
     {
       "name": "linear()",
@@ -30,123 +27,123 @@
     },
     {
       "name": "<cubic-bezier-easing-function>",
-      "value": "ease | ease-in | ease-out | ease-in-out | cubic-bezier(<number [0,1]>, <number>, <number [0,1]>, <number>)",
       "href": "https://drafts.csswg.org/css-easing-2/#typedef-cubic-bezier-easing-function",
       "type": "type",
+      "value": "ease | ease-in | ease-out | ease-in-out | <cubic-bezier()>",
       "values": [
         {
-          "name": "ease",
-          "prose": "Equivalent to cubic-bezier(0.25, 0.1, 0.25, 1).",
-          "href": "https://drafts.csswg.org/css-easing-2/#valdef-cubic-bezier-easing-function-ease",
-          "type": "value",
-          "value": "ease"
-        },
-        {
           "name": "ease-in",
-          "prose": "Equivalent to cubic-bezier(0.42, 0, 1, 1).",
+          "prose": "A function that starts slowly and smoothly, then quickly approaches the endpoint with an almost linear curve. Equivalent to cubic-bezier(0.42, 0, 1, 1).",
           "href": "https://drafts.csswg.org/css-easing-2/#valdef-cubic-bezier-easing-function-ease-in",
           "type": "value",
           "value": "ease-in"
         },
         {
           "name": "ease-out",
-          "prose": "Equivalent to cubic-bezier(0, 0, 0.58, 1).",
+          "prose": "A function that starts quickly with an almost linear curve, then slowly and smoothly approaches the endpoint. Equivalent to cubic-bezier(0, 0, 0.58, 1).",
           "href": "https://drafts.csswg.org/css-easing-2/#valdef-cubic-bezier-easing-function-ease-out",
           "type": "value",
           "value": "ease-out"
         },
         {
           "name": "ease-in-out",
-          "prose": "Equivalent to cubic-bezier(0.42, 0, 0.58, 1).",
+          "prose": "A function that starts and ends slowly and smoothly, quickly traversing the middle part. Equivalent to cubic-bezier(0.42, 0, 0.58, 1).",
           "href": "https://drafts.csswg.org/css-easing-2/#valdef-cubic-bezier-easing-function-ease-in-out",
           "type": "value",
           "value": "ease-in-out"
         },
         {
-          "name": "cubic-bezier()",
-          "value": "cubic-bezier(<number [0,1]>, <number>, <number [0,1]>, <number>)",
-          "href": "https://drafts.csswg.org/css-easing-2/#funcdef-cubic-bezier-easing-function-cubic-bezier",
-          "type": "function"
+          "name": "ease",
+          "prose": "Similar to ease-in-out, but with a quicker start and a slower finish. Equivalent to cubic-bezier(0.25, 0.1, 0.25, 1).",
+          "href": "https://drafts.csswg.org/css-easing-2/#valdef-cubic-bezier-easing-function-ease",
+          "type": "value",
+          "value": "ease"
         }
       ]
     },
     {
+      "name": "cubic-bezier()",
+      "href": "https://drafts.csswg.org/css-easing-2/#funcdef-cubic-bezier",
+      "type": "function",
+      "value": "cubic-bezier( [ <number [0,1]>, <number> ]#{2} )"
+    },
+    {
       "name": "<step-easing-function>",
-      "value": "step-start | step-end | steps(<integer> , <step-position>?)",
       "href": "https://drafts.csswg.org/css-easing-2/#typedef-step-easing-function",
       "type": "type",
+      "value": "step-start | step-end | <steps()>"
+    },
+    {
+      "name": "steps()",
+      "href": "https://drafts.csswg.org/css-easing-2/#funcdef-steps",
+      "type": "function",
+      "value": "steps( <integer>, <step-position>?)",
       "values": [
         {
           "name": "step-start",
-          "prose": "Computes to steps(1, start)",
+          "prose": "Jumps from the starting to the ending value at the start of the easing interval. Computes to steps(1, start)",
           "href": "https://drafts.csswg.org/css-easing-2/#valdef-step-easing-function-step-start",
           "type": "value",
           "value": "step-start"
         },
         {
           "name": "step-end",
-          "prose": "Computes to steps(1, end) Example step easing function keyword values.",
+          "prose": "Jumps from the starting to the ending value at the end of the easing interval. Computes to steps(1, end) Example step easing function keyword values.",
           "href": "https://drafts.csswg.org/css-easing-2/#valdef-step-easing-function-step-end",
           "type": "value",
           "value": "step-end"
-        },
-        {
-          "name": "steps()",
-          "value": "steps(<integer>, <step-position>?)",
-          "href": "https://drafts.csswg.org/css-easing-2/#funcdef-step-easing-function-steps",
-          "type": "function",
-          "values": [
-            {
-              "name": "jump-start",
-              "prose": "The first rise occurs at input progress value of 0.",
-              "href": "https://drafts.csswg.org/css-easing-2/#valdef-steps-jump-start",
-              "type": "value",
-              "value": "jump-start"
-            },
-            {
-              "name": "jump-end",
-              "prose": "The last rise occurs at input progress value of 1.",
-              "href": "https://drafts.csswg.org/css-easing-2/#valdef-steps-jump-end",
-              "type": "value",
-              "value": "jump-end"
-            },
-            {
-              "name": "jump-none",
-              "prose": "All rises occur within the range (0, 1).",
-              "href": "https://drafts.csswg.org/css-easing-2/#valdef-steps-jump-none",
-              "type": "value",
-              "value": "jump-none"
-            },
-            {
-              "name": "jump-both",
-              "prose": "The first rise occurs at input progress value of 0 and the last rise occurs at input progress value of 1.",
-              "href": "https://drafts.csswg.org/css-easing-2/#valdef-steps-jump-both",
-              "type": "value",
-              "value": "jump-both"
-            },
-            {
-              "name": "start",
-              "prose": "Behaves as jump-start.",
-              "href": "https://drafts.csswg.org/css-easing-2/#valdef-steps-start",
-              "type": "value",
-              "value": "start"
-            },
-            {
-              "name": "end",
-              "prose": "Behaves as jump-end.",
-              "href": "https://drafts.csswg.org/css-easing-2/#valdef-steps-end",
-              "type": "value",
-              "value": "end"
-            }
-          ]
         }
       ]
     },
     {
       "name": "<step-position>",
-      "value": "jump-start | jump-end | jump-none | jump-both | start | end",
       "href": "https://drafts.csswg.org/css-easing-2/#typedef-step-position",
-      "type": "type"
+      "type": "type",
+      "value": "jump-start | jump-end | jump-none | jump-both | start | end",
+      "values": [
+        {
+          "name": "jump-start",
+          "prose": "The first interval has an output progress value of 1/steps, and subsequent intervals rise by 1/steps. (It \"jumps at the start\", with no step returning 0.)",
+          "href": "https://drafts.csswg.org/css-easing-2/#valdef-step-position-jump-start",
+          "type": "value",
+          "value": "jump-start"
+        },
+        {
+          "name": "jump-end",
+          "prose": "The first interval has an output progress value of 0, and subsequent intervals rise by 1/steps. (It \"jumps at the end\", with no step returning 1.)",
+          "href": "https://drafts.csswg.org/css-easing-2/#valdef-step-position-jump-end",
+          "type": "value",
+          "value": "jump-end"
+        },
+        {
+          "name": "jump-none",
+          "prose": "The first interval has an output progress value of 0, and subsequent intervals rise by 1/(steps-1). (It \"never jumps\", with steps returning both 0 and 1.)",
+          "href": "https://drafts.csswg.org/css-easing-2/#valdef-step-position-jump-none",
+          "type": "value",
+          "value": "jump-none"
+        },
+        {
+          "name": "jump-both",
+          "prose": "The first interval has an output progress value of 1/(steps+1), and subsequent intervals rise by 1/(steps+1). (It \"jumps at both ends\", with no steps returning 0 or 1.)",
+          "href": "https://drafts.csswg.org/css-easing-2/#valdef-step-position-jump-both",
+          "type": "value",
+          "value": "jump-both"
+        },
+        {
+          "name": "start",
+          "prose": "Behaves as jump-start.",
+          "href": "https://drafts.csswg.org/css-easing-2/#valdef-step-position-start",
+          "type": "value",
+          "value": "start"
+        },
+        {
+          "name": "end",
+          "prose": "Behaves as jump-end.",
+          "href": "https://drafts.csswg.org/css-easing-2/#valdef-step-position-end",
+          "type": "value",
+          "value": "end"
+        }
+      ]
     }
   ]
 }

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-grid-3.json packages/css/css-grid-3.json
--- webref/node_modules/@webref/css/css-grid-3.json
+++ packages/css/css-grid-3.json
@@ -46,21 +46,21 @@
       "values": [
         {
           "name": "row-reverse",
-          "prose": "This specification extends the grid-auto-flow property to add row-reverse, column-reverse, and wrap-reverse, which reverse the directions of the auto-placement algorithm.",
+          "prose": "This specification extends the grid-auto-flow property to add row-reverse, column-reverse, and wrap-reverse, which reverse the directions of the grid item placement algorithm.",
           "href": "https://drafts.csswg.org/css-grid-3/#valdef-grid-auto-flow-row-reverse",
           "type": "value",
           "value": "row-reverse"
         },
         {
           "name": "column-reverse",
-          "prose": "This specification extends the grid-auto-flow property to add row-reverse, column-reverse, and wrap-reverse, which reverse the directions of the auto-placement algorithm.",
+          "prose": "This specification extends the grid-auto-flow property to add row-reverse, column-reverse, and wrap-reverse, which reverse the directions of the grid item placement algorithm.",
           "href": "https://drafts.csswg.org/css-grid-3/#valdef-grid-auto-flow-column-reverse",
           "type": "value",
           "value": "column-reverse"
         },
         {
           "name": "wrap-reverse",
-          "prose": "This specification extends the grid-auto-flow property to add row-reverse, column-reverse, and wrap-reverse, which reverse the directions of the auto-placement algorithm.",
+          "prose": "This specification extends the grid-auto-flow property to add row-reverse, column-reverse, and wrap-reverse, which reverse the directions of the grid item placement algorithm.",
           "href": "https://drafts.csswg.org/css-grid-3/#valdef-grid-auto-flow-wrap-reverse",
           "type": "value",
           "value": "wrap-reverse"
@@ -108,28 +108,28 @@
       "values": [
         {
           "name": "column",
-          "prose": "The masonry container’s masonry axis is its block axis, and masonry layout starts from its block-start edge.",
+          "prose": "The masonry container’s stacking axis is its block axis, and masonry layout starts from its block-start edge.",
           "href": "https://drafts.csswg.org/css-grid-3/#valdef-masonry-direction-column",
           "type": "value",
           "value": "column"
         },
         {
           "name": "column-reverse",
-          "prose": "The masonry container’s masonry axis is its block axis, and masonry layout starts from its block-end edge.",
+          "prose": "The masonry container’s stacking axis is its block axis, and masonry layout starts from its block-end edge.",
           "href": "https://drafts.csswg.org/css-grid-3/#valdef-masonry-direction-column-reverse",
           "type": "value",
           "value": "column-reverse"
         },
         {
           "name": "row",
-          "prose": "The masonry container’s masonry axis is its inline axis, and masonry layout starts from its inline-start edge.",
+          "prose": "The masonry container’s stacking axis is its inline axis, and masonry layout starts from its inline-start edge.",
           "href": "https://drafts.csswg.org/css-grid-3/#valdef-masonry-direction-row",
           "type": "value",
           "value": "row"
         },
         {
           "name": "row-reverse",
-          "prose": "The masonry container’s masonry axis is its inline axis, and masonry layout starts from its inline-end edge.",
+          "prose": "The masonry container’s stacking axis is its inline axis, and masonry layout starts from its inline-end edge.",
           "href": "https://drafts.csswg.org/css-grid-3/#valdef-masonry-direction-row-reverse",
           "type": "value",
           "value": "row-reverse"
@@ -189,6 +189,21 @@
       ]
     },
     {
+      "name": "masonry",
+      "href": "https://drafts.csswg.org/css-grid-3/#propdef-masonry",
+      "value": "<'masonry-template-areas'> || <'masonry-template-tracks'> || <'masonry-direction'> || <'masonry-fill'>",
+      "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": [
+        "masonry"
+      ]
+    },
+    {
       "name": "masonry-template-tracks",
       "href": "https://drafts.csswg.org/css-grid-3/#propdef-masonry-template-tracks",
       "value": "<'grid-template-columns'>",
@@ -237,6 +252,31 @@
       ]
     },
     {
+      "name": "masonry-slack",
+      "href": "https://drafts.csswg.org/css-grid-3/#propdef-masonry-slack",
+      "value": "<length-percentage>",
+      "initial": "1em",
+      "appliesTo": "masonry containers",
+      "inherited": "no",
+      "percentages": "relative to the grid-axis content box size of the masonry container",
+      "computedValue": "a computed length",
+      "canonicalOrder": "per grammar",
+      "animationType": "discrete",
+      "values": [
+        {
+          "name": "<length>",
+          "prose": "Specifies the tie threshold for the masonry container. Placement positions are considered to be equally good (“tied”) if they are within the specified distance from the shortest position.",
+          "href": "https://drafts.csswg.org/css-grid-3/#valdef-masonry-slack-length",
+          "type": "value",
+          "value": "<length>"
+        }
+      ],
+      "styleDeclaration": [
+        "masonry-slack",
+        "masonrySlack"
+      ]
+    },
+    {
       "name": "masonry-track-start",
       "href": "https://drafts.csswg.org/css-grid-3/#propdef-masonry-track-start",
       "styleDeclaration": [
@@ -263,5 +303,16 @@
   ],
   "atrules": [],
   "selectors": [],
-  "values": []
+  "values": [],
+  "warnings": [
+    {
+      "msg": "Dangling value",
+      "name": "auto-areas",
+      "prose": "The new auto-areas value for the repeat() notation represents the number of repetitions necessary for the total number of explicit tracks to match the grid-template-areas / masonry-template-areas value in effect in the corresponding axis. If multiple tracks are listed for the repetition, the final repetition is truncated as necessary to produce the correct number of tracks.",
+      "href": "https://drafts.csswg.org/css-grid-3/#valdef-repeat-auto-areas",
+      "type": "value",
+      "value": "auto-areas",
+      "for": "repeat()"
+    }
+  ]
 }

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-shapes-2.json packages/css/css-shapes-2.json
--- webref/node_modules/@webref/css/css-shapes-2.json
+++ packages/css/css-shapes-2.json
@@ -32,7 +32,7 @@
         },
         {
           "name": "<basic-shape>",
-          "prose": "The shape is computed based on the values of one of inset(), circle(), ellipse() or polygon().",
+          "prose": "The shape is computed based on the values of one of the <basic-shape> functions.",
           "href": "https://drafts.csswg.org/css-shapes-2/#valdef-shape-inside-basic-shape",
           "type": "value",
           "value": "<basic-shape>"

diff --ignore-trailing-space '--exclude=package.json' '--exclude=README.md' '--exclude=CHANGELOG.md' '--unified=3' webref/node_modules/@webref/css/css-shapes.json packages/css/css-shapes.json
--- webref/node_modules/@webref/css/css-shapes.json
+++ packages/css/css-shapes.json
@@ -25,7 +25,7 @@
         },
         {
           "name": "<basic-shape>",
-          "prose": "The shape is computed based on the values of one of inset(), circle(), ellipse() or polygon(). If a <shape-box> is also supplied, this defines the reference box for the <basic-shape> function. If <shape-box> is not supplied, then the reference box defaults to margin-box.",
+          "prose": "The shape is computed based on one of the <basic-shape> functions. If a <shape-box> is also supplied, this defines the reference box for the <basic-shape> function. If <shape-box> is not supplied, then the reference box defaults to margin-box.",
           "href": "https://drafts.csswg.org/css-shapes-1/#valdef-shape-outside-basic-shape",
           "type": "value",
           "value": "<basic-shape>"
@@ -126,24 +126,24 @@
         },
         {
           "name": "circle()",
-          "prose": "The <radial-size> argument defines the circle’s radius. Rather than referring to the gradient box, values are resolved against the [=/reference box=]. Two <length-percentage> values are invalid. The <position> argument defines the center of the circle. Unless otherwise specified, this defaults to center if omitted.",
+          "prose": "The <radial-size> argument defines the circle’s radius. Rather than referring to the gradient box, values are resolved against the reference box. Two <length-percentage> values are invalid. The <position> argument defines the center of the circle. Unless otherwise specified, this defaults to center if omitted.",
           "href": "https://drafts.csswg.org/css-shapes-1/#funcdef-basic-shape-circle",
           "type": "function",
           "value": "circle( <radial-size>? [ at <position> ]? )"
         },
         {
           "name": "ellipse()",
-          "prose": "The <radial-size> argument defines the horizontal and vertical radiuses of the ellipse. Rather than referring to the gradient box, values are resolved against the [=/reference box=]. The <position> argument defines the center of the ellipse. Unless otherwise specified, this defaults to center if omitted.",
+          "prose": "The <radial-size> argument defines the horizontal and vertical radiuses of the ellipse. Rather than referring to the gradient box, values are resolved against the reference box. The <position> argument defines the center of the ellipse. Unless otherwise specified, this defaults to center if omitted.",
           "href": "https://drafts.csswg.org/css-shapes-1/#funcdef-basic-shape-ellipse",
           "type": "function",
           "value": "ellipse( <radial-size>? [ at <position> ]? )"
         },
         {
           "name": "polygon()",
-          "prose": "The <'fill-rule'> specifies the filling rule used to determine the interior Defaults to nonzero if omitted. Each <length-percentage> pair specifies a vertex of the polygon, as a horizontal and vertical offset from the left and top edges of the [=/reference box=]. The UA must close a polygon by connecting the last vertex with the first vertex of the list.",
+          "prose": "The <'fill-rule'> specifies the filling rule used to determine the interior Defaults to nonzero if omitted. An optional <length> after a round keyword defines rounding for each vertex of the polygon. The length is the radius of a circle whose center lies on the bisector of the smaller angle of the vertex, and that is tangential to both sides of the vertex. Rounding polygon vertices that are both convex and concave. To avoid rounding more than half of any line segment, the rounding of each vertex must be clamped separately such that the radius is never more than the smaller of tan(angle/2) segment / 2 evaluated against both vertex line segments. This diagram shows the intent of the clamping formula. Each <length-percentage> pair specifies a vertex of the polygon, as a horizontal and vertical offset from the left and top edges of the reference box. The UA must close a polygon by connecting the last vertex with the first vertex of the list.",
           "href": "https://drafts.csswg.org/css-shapes-1/#funcdef-basic-shape-polygon",
           "type": "function",
-          "value": "polygon( <'fill-rule'>? , [<length-percentage> <length-percentage>]# )"
+          "value": "polygon( <'fill-rule'>? [ round <length> ]? , [<length-percentage> <length-percentage>]# )"
         },
         {
           "name": "path()",

[tidoust]

Dangling value for auto-areas in css-grid-3 is due to repeat() being defined in another spec (css-grid-2). Ideally, we'd be able to record with some "new value" mechanism. See w3c/reffy#1647 for a related issue.