@webref/css 6.15.2 → 6.16.1

package/css-text-4.json

@@ -461,7 +461,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 | avoid-orphans",
       "initial": "auto",
       "appliesTo": "block containers hat establish an inline formatting context",
       "inherited": "yes",
@@ -493,10 +493,17 @@
         },
         {
           "name": "pretty",
-          "prose": "Specifies the UA should bias for better layout over speed, and is expected to consider multiple lines, when making break decisions. Otherwise equivalent to auto,",
+          "prose": "Specifies the UA should bias for better layout over speed, and is expected to consider multiple lines when making break decisions. Otherwise equivalent to auto. The user agent may among other things attempt to avoid excessively short last lines, similarly to avoid-orphans, but it should also improve the layout in additional ways. The precise set of improvements is user agent dependent, and may include things such as: reducing the variation in length between lines; avoiding typographic rivers; prioritizing different classes of soft wrap opportunities, hyphenation opportunities, or justification opportunities; avoiding hyphenation on too many consecutive lines… The necessary computations may be expensive, especially when applied to large amounts of text. Authors are encouraged to assess the impact on performance when using text-wrap-style: pretty, and possibly use it selectively where it matters most.",
           "href": "https://drafts.csswg.org/css-text-4/#valdef-text-wrap-style-pretty",
           "type": "value",
           "value": "pretty"
+        },
+        {
+          "name": "avoid-orphans",
+          "prose": "Specifies the UA should avoid excessively short last lines, and is expected to consider more than one line when making break decisions (for example, to avoid \"fixing\" an orphan by making the previous line too short). The user agent may decide against improving the last line when it would make some prior line(s) substantially unbalanced. The user agent should not attempt to improve other aspects of the layout beyond what auto if those improvements come at a significant performance cost. For instance, with the given line length, the following test would be wrapped with a single word on the last line, which could be judged too short. ἄνδρα μοι ἔννεπε, μοῦσα, πολύτροπον, ὃς μάλα πολλὰ πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν. Applying text-wrap-style: avoid-orphans could yield something like this instead, which is arguably more pleasing: ἄνδρα μοι ἔννεπε, μοῦσα, πολύτροπον, ὃς μάλα πολλὰ πλάγχθη, ἐπεὶ Τροίης ἱερὸν πτολίεθρον ἔπερσεν. However, the following fragment is more vexing: Circumnavigating the Mississippi river An attempt to make the last line less short by wrapping the previous line earlier would result in the following: Circumnavigating the Mississippi river While the last line would indeed no longer be short, the penultimate line would be unsightly. In such cases, user agents are expected to prefer the first rendering despite text-wrap-style: avoid-orphans being set.",
+          "href": "https://drafts.csswg.org/css-text-4/#valdef-text-wrap-style-avoid-orphans",
+          "type": "value",
+          "value": "avoid-orphans"
         }
       ],
       "styleDeclaration": [

package/css-ui.json

@@ -629,7 +629,7 @@
     {
       "name": "appearance",
       "href": "https://drafts.csswg.org/css-ui-4/#propdef-appearance",
-      "value": "none | auto | <compat-auto> | <compat-special>",
+      "value": "none | auto | base | <compat-auto> | <compat-special>",
       "initial": "none",
       "appliesTo": "all elements",
       "inherited": "no",
@@ -652,6 +652,13 @@
           "type": "value",
           "value": "auto"
         },
+        {
+          "name": "base",
+          "prose": "The effect of base depends on the element it is applied to:",
+          "href": "https://drafts.csswg.org/css-ui-4/#valdef-appearance-base",
+          "type": "value",
+          "value": "base"
+        },
         {
           "name": "<compat-auto>",
           "value": "searchfield | textarea | checkbox | radio | menulist | listbox | meter | progress-bar | button",

package/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 § 9.3 Interpolating calc-size(). In other cases, an <intrinsic-size-keyword> still cannot be interpolated.",
+          "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.",
           "href": "https://drafts.csswg.org/css-values-5/#valdef-interpolate-size-allow-keywords",
           "type": "value",
           "value": "allow-keywords"
@@ -155,9 +155,134 @@
         }
       ]
     },
+    {
+      "name": "<position>",
+      "prose": "The <position> value specifies the position of an alignment subject (e.g. a background image) inside an alignment container (e.g. its background positioning area) as a pair of offsets between the specified edges (defaulting to the left and top). Its syntax is:",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-position",
+      "type": "type",
+      "value": "<position-one> | <position-two> | <position-four>",
+      "values": [
+        {
+          "name": "<length-percentage>",
+          "prose": "A <length-percentage> value specifies the size of the offset between the specified edges of the alignment subject and alignment container. For example, for background-position: 2cm 1cm, the top left corner of the background image is placed 2cm to the right and 1cm below the top left corner of the background positioning area. A <percentage> for the horizontal offset is relative to (width of alignment container - width of alignment subject). A <percentage> for the vertical offset is relative to (height of alignment container - height of alignment subject). For example, with a value pair of 0% 0%, the upper left corner of the alignment subject is aligned with the upper left corner of the alignment container A value pair of 100% 100% places the lower right corner of the alignment subject in the lower right corner of the alignment container. With a value pair of 75% 50%, the point 75% across and 50% down the alignment subject is to be placed at the point 75% across and 50% down the alignment container. Diagram of the meaning of background-position: 75% 50%.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-length-percentage",
+          "type": "value",
+          "value": "<length-percentage>"
+        },
+        {
+          "name": "top",
+          "prose": "Offsets the top/left/right/bottom edges (respectively) of the alignment subject and alignment container by the specified amount (defaulting to 0%) in the corresponding axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-top",
+          "type": "value",
+          "value": "top"
+        },
+        {
+          "name": "right",
+          "prose": "Offsets the top/left/right/bottom edges (respectively) of the alignment subject and alignment container by the specified amount (defaulting to 0%) in the corresponding axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-right",
+          "type": "value",
+          "value": "right"
+        },
+        {
+          "name": "bottom",
+          "prose": "Offsets the top/left/right/bottom edges (respectively) of the alignment subject and alignment container by the specified amount (defaulting to 0%) in the corresponding axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-bottom",
+          "type": "value",
+          "value": "bottom"
+        },
+        {
+          "name": "left",
+          "prose": "Offsets the top/left/right/bottom edges (respectively) of the alignment subject and alignment container by the specified amount (defaulting to 0%) in the corresponding axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-left",
+          "type": "value",
+          "value": "left"
+        },
+        {
+          "name": "y-start",
+          "prose": "Computes the same as the physical edge keyword corresponding to the start/end side in the [=y-axis|y/x axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-y-start",
+          "type": "value",
+          "value": "y-start"
+        },
+        {
+          "name": "y-end",
+          "prose": "Computes the same as the physical edge keyword corresponding to the start/end side in the [=y-axis|y/x axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-y-end",
+          "type": "value",
+          "value": "y-end"
+        },
+        {
+          "name": "x-start",
+          "prose": "Computes the same as the physical edge keyword corresponding to the start/end side in the [=y-axis|y/x axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-x-start",
+          "type": "value",
+          "value": "x-start"
+        },
+        {
+          "name": "x-end",
+          "prose": "Computes the same as the physical edge keyword corresponding to the start/end side in the [=y-axis|y/x axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-x-end",
+          "type": "value",
+          "value": "x-end"
+        },
+        {
+          "name": "block-start",
+          "prose": "Computes the same as the physical edge keyword corresponding to the start/end side in the block/inline axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-block-start",
+          "type": "value",
+          "value": "block-start"
+        },
+        {
+          "name": "block-end",
+          "prose": "Computes the same as the physical edge keyword corresponding to the start/end side in the block/inline axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-block-end",
+          "type": "value",
+          "value": "block-end"
+        },
+        {
+          "name": "inline-start",
+          "prose": "Computes the same as the physical edge keyword corresponding to the start/end side in the block/inline axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-inline-start",
+          "type": "value",
+          "value": "inline-start"
+        },
+        {
+          "name": "inline-end",
+          "prose": "Computes the same as the physical edge keyword corresponding to the start/end side in the block/inline axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-inline-end",
+          "type": "value",
+          "value": "inline-end"
+        },
+        {
+          "name": "center",
+          "prose": "Computes to a 50% offset in the corresponding axis.",
+          "href": "https://drafts.csswg.org/css-values-5/#valdef-position-center",
+          "type": "value",
+          "value": "center"
+        }
+      ]
+    },
+    {
+      "name": "<position-one>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-position-one",
+      "type": "type",
+      "value": "[ left | center | right | top | bottom | x-start | x-end | y-start | y-end | block-start | block-end | inline-start | inline-end | <length-percentage> ]"
+    },
+    {
+      "name": "<position-two>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-position-two",
+      "type": "type",
+      "value": "[ [ left | center | right | x-start | x-end ] && [ top | center | bottom | y-start | y-end ] | [ left | center | right | x-start | x-end | <length-percentage> ] [ top | center | bottom | y-start | y-end | <length-percentage> ] | [ block-start | center | block-end ] && [ inline-start | center | inline-end ] | [ start | center | end ]{2} ]"
+    },
+    {
+      "name": "<position-four>",
+      "href": "https://drafts.csswg.org/css-values-5/#typedef-position-four",
+      "type": "type",
+      "value": "[ [ [ left | right | x-start | x-end ] <length-percentage> ] && [ [ top | bottom | y-start | y-end ] <length-percentage> ] | [ [ block-start | block-end ] <length-percentage> ] && [ [ inline-start | inline-end ] <length-percentage> ] | [ [ start | end ] <length-percentage> ]{2} ]"
+    },
     {
       "name": "progress()",
-      "prose": "The progress() functional notation returns a <number> value representing the position of one calculation (the progress value) between two other calculations (the progress start value and progress end value). The argument calculations can resolve to any <number>, <dimension>, or <percentage>, but must have a consistent type or else the function is invalid. The result will be a <number>, made consistent with the consistent type of the arguments.",
+      "prose": "The progress() functional notation returns a <number> value representing the position of one calculation (the progress value) between two other calculations (the progress start value and progress end value). progress() is a math function.",
       "href": "https://drafts.csswg.org/css-values-5/#funcdef-progress",
       "type": "function"
     },
@@ -196,7 +321,7 @@
       "prose": "The <progress> value type represents the mix progress value in a mix notation, and ultimately resolves to a percentage. It can, however, draw that percentage value from sources such as media queries and animation timelines, and can also convert it through an easing function before using it for interpolation.",
       "href": "https://drafts.csswg.org/css-values-5/#typedef-progress",
       "type": "type",
-      "value": "[ <percentage> | <number> | <'animation-timeline'> ]? && by <easing-function>",
+      "value": "[ <percentage> | <number> | <'animation-timeline'> ] && [ by <easing-function> ]?",
       "values": [
         {
           "name": "<percentage-token>",
@@ -473,7 +598,7 @@
     {
       "msg": "Missing definition",
       "name": "<color-mix()>",
-      "value": "color-mix( <progress> && <color-interpolation-method>?, <color>, <color> ) | color-mix( <color-interpolation-method>, [<color> && <percentage [0,100]>?]#{2} )"
+      "value": "color-mix( [ <progress> && <color-interpolation-method>? ] , <color>, <color> ) | color-mix( <color-interpolation-method>, [<color> && <percentage [0,100]>?]#{2} )"
     },
     {
       "msg": "Missing definition",

package/package.json

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

package/selectors-5.json

@@ -13,8 +13,8 @@
     },
     {
       "name": ":state()",
-      "prose": "The :state() pseudo-class takes a case-sensitive argument and matches custom elements whose exposed custom states include the argument.",
-      "href": "https://drafts.csswg.org/selectors-5/#selectordef-state"
+      "value": ":state( <ident> )",
+      "href": "https://drafts.csswg.org/selectors-5/#state-pseudo"
     }
   ],
   "values": []

package/webxr-dom-overlays.json

@@ -0,0 +1,16 @@
+{
+  "spec": {
+    "title": "WebXR DOM Overlays Module",
+    "url": "https://immersive-web.github.io/dom-overlays/"
+  },
+  "properties": [],
+  "atrules": [],
+  "selectors": [
+    {
+      "name": ":xr-overlay",
+      "prose": "The :xr-overlay pseudo-class MUST match the overlay element for the duration of an immersive session using a DOM Overlay.",
+      "href": "https://immersive-web.github.io/dom-overlays/#selectordef-xr-overlay"
+    }
+  ],
+  "values": []
+}