@webref/css 6.4.1 → 6.4.3

package/css-text-4.json

@@ -115,13 +115,13 @@
         },
         {
           "name": "space",
-          "prose": "Instances of U+200B ZERO WIDTH SPACE within the text run children of this element are replaced by U+0020 SPACE.",
+          "prose": "Instances of U+200B ZERO WIDTH SPACE within the child text of this element are replaced by U+0020 SPACE.",
           "type": "value",
           "value": "space"
         },
         {
           "name": "ideographic-space",
-          "prose": "Instances of U+200B ZERO WIDTH SPACE within the text run children of this element are replaced by U+3000 IDEOGRAPHIC SPACE.",
+          "prose": "Instances of U+200B ZERO WIDTH SPACE within the child text of this element are replaced by U+3000 IDEOGRAPHIC SPACE.",
           "type": "value",
           "value": "ideographic-space"
         }
@@ -133,7 +133,7 @@
     },
     {
       "name": "white-space",
-      "value": "normal | pre | nowrap | pre-wrap | break-spaces | pre-line",
+      "value": "normal | pre | nowrap | pre-wrap | pre-line | <'white-space-collapse'> || <'text-wrap'> || <'text-space-trim'>",
       "initial": "normal",
       "appliesTo": "text",
       "inherited": "yes",
@@ -144,37 +144,21 @@
       "values": [
         {
           "name": "normal",
-          "prose": "This value directs user agents to collapse sequences of white space into a single character (or in some cases, no character). Lines may wrap at allowed soft wrap opportunities, as determined by the line-breaking rules in effect, in order to minimize inline-axis overflow.",
           "type": "value",
           "value": "normal"
         },
         {
           "name": "pre",
-          "prose": "This value prevents user agents from collapsing sequences of white space. Segment breaks such as line feeds are preserved as forced line breaks. Lines only break at forced line breaks; content that does not fit within the block container overflows it.",
           "type": "value",
           "value": "pre"
         },
-        {
-          "name": "nowrap",
-          "prose": "Like normal, this value collapses white space; but like pre, it does not allow wrapping.",
-          "type": "value",
-          "value": "nowrap"
-        },
         {
           "name": "pre-wrap",
-          "prose": "Like pre, this value preserves white space; but like normal, it allows wrapping.",
           "type": "value",
           "value": "pre-wrap"
         },
-        {
-          "name": "break-spaces",
-          "prose": "The behavior is identical to that of pre-wrap, except that: Any sequence of preserved white space or other space separators always takes up space, including at the end of the line. Tests white-space-intrinsic-size-001.html (live test) (source) white-space-intrinsic-size-002.html (live test) (source) A line breaking opportunity exists after every preserved white space character and after every other space separator (including between adjacent spaces). Tests overflow-wrap-break-word-002.html (live test) (source) overflow-wrap-anywhere-002.html (live test) (source) break-spaces-001.html (live test) (source) break-spaces-002.html (live test) (source) break-spaces-003.html (live test) (source) break-spaces-004.html (live test) (source) break-spaces-005.html (live test) (source) break-spaces-006.html (live test) (source) break-spaces-007.html (live test) (source) break-spaces-008.html (live test) (source) break-spaces-009.html (live test) (source) break-spaces-010.html (live test) (source) break-spaces-051.html (live test) (source) break-spaces-052.html (live test) (source) white-space-pre-034.html (live test) (source) textarea-break-spaces-001.html (live test) (source) textarea-break-spaces-002.html (live test) (source) break-spaces-before-first-char-001.html (live test) (source) break-spaces-before-first-char-002.html (live test) (source) break-spaces-before-first-char-003.html (live test) (source) break-spaces-before-first-char-004.html (live test) (source) break-spaces-before-first-char-005.html (live test) (source) break-spaces-before-first-char-006.html (live test) (source) break-spaces-before-first-char-007.html (live test) (source) break-spaces-before-first-char-008.html (live test) (source) break-spaces-before-first-char-009.html (live test) (source) break-spaces-before-first-char-010.html (live test) (source) break-spaces-before-first-char-011.html (live test) (source) break-spaces-before-first-char-012.html (live test) (source) break-spaces-before-first-char-013.html (live test) (source) break-spaces-before-first-char-014.html (live test) (source) break-spaces-before-first-char-015.html (live test) (source) break-spaces-before-first-char-016.html (live test) (source) break-spaces-before-first-char-017.html (live test) (source) break-spaces-before-first-char-018.html (live test) (source) break-spaces-before-first-ideographic-char-001.html (live test) (source) break-spaces-before-first-ideographic-char-002.html (live test) (source) break-spaces-before-first-ideographic-char-003.html (live test) (source) break-spaces-before-first-ideographic-char-004.html (live test) (source) break-spaces-before-first-ideographic-char-005.html (live test) (source) break-spaces-before-first-ideographic-char-006.html (live test) (source) break-spaces-before-first-ideographic-char-007.html (live test) (source) break-spaces-before-first-ideographic-char-008.html (live test) (source) break-spaces-before-first-ideographic-char-009.html (live test) (source) break-spaces-before-first-ideographic-char-010.html (live test) (source) break-spaces-before-first-ideographic-char-011.html (live test) (source) break-spaces-before-first-ideographic-char-012.html (live test) (source) break-spaces-before-first-ideographic-char-013.html (live test) (source) break-spaces-before-first-ideographic-char-014.html (live test) (source) break-spaces-before-first-ideographic-char-015.html (live test) (source) break-spaces-before-first-ideographic-char-016.html (live test) (source) break-spaces-before-first-ideographic-char-017.html (live test) (source) break-spaces-before-first-ideographic-char-018.html (live test) (source) tab-stop-threshold-005.html (live test) (source) tab-stop-threshold-006.html (live test) (source) word-break-break-all-017.html (live test) (source) break-spaces-tab-001.html (live test) (source) break-spaces-tab-002.html (live test) (source) break-spaces-tab-003.html (live test) (source) break-spaces-tab-004.html (live test) (source) break-spaces-tab-005.html (live test) (source) break-spaces-tab-006.html (live test) (source) break-spaces-with-overflow-wrap-001.html (live test) (source) break-spaces-with-overflow-wrap-002.html (live test) (source) break-spaces-with-overflow-wrap-003.html (live test) (source) break-spaces-with-overflow-wrap-004.html (live test) (source) break-spaces-with-overflow-wrap-005.html (live test) (source) break-spaces-with-overflow-wrap-006.html (live test) (source) break-spaces-with-overflow-wrap-007.html (live test) (source) break-spaces-with-overflow-wrap-008.html (live test) (source) break-spaces-with-overflow-wrap-009.html (live test) (source) break-spaces-with-overflow-wrap-010.html (live test) (source) break-spaces-with-ideographic-space-001.html (live test) (source) break-spaces-with-ideographic-space-002.html (live test) (source) break-spaces-with-ideographic-space-003.html (live test) (source) break-spaces-with-ideographic-space-004.html (live test) (source) break-spaces-with-ideographic-space-005.html (live test) (source) break-spaces-with-ideographic-space-006.html (live test) (source) break-spaces-with-ideographic-space-007.html (live test) (source) break-spaces-with-ideographic-space-008.html (live test) (source) break-spaces-with-ideographic-space-009.html (live test) (source) break-spaces-with-ideographic-space-010.html (live test) (source) line-break-anywhere-and-white-space-008.html (live test) (source) line-break-anywhere-and-white-space-009.html (live test) (source) ws-break-spaces-applies-to-001.html (live test) (source) ws-break-spaces-applies-to-002.html (live test) (source) ws-break-spaces-applies-to-003.html (live test) (source) ws-break-spaces-applies-to-005.html (live test) (source) ws-break-spaces-applies-to-006.html (live test) (source) ws-break-spaces-applies-to-007.html (live test) (source) ws-break-spaces-applies-to-008.html (live test) (source) ws-break-spaces-applies-to-009.html (live test) (source) ws-break-spaces-applies-to-010.html (live test) (source) ws-break-spaces-applies-to-011.html (live test) (source) ws-break-spaces-applies-to-012.html (live test) (source) ws-break-spaces-applies-to-013.html (live test) (source) ws-break-spaces-applies-to-014.html (live test) (source) ws-break-spaces-applies-to-015.html (live test) (source) break-spaces-newline-011.html (live test) (source) break-spaces-newline-012.html (live test) (source) break-spaces-newline-013.html (live test) (source) break-spaces-newline-014.html (live test) (source) break-spaces-newline-015.html (live test) (source) break-spaces-newline-016.html (live test) (source) trailing-ideographic-space-break-spaces-001.html (live test) (source) trailing-ideographic-space-break-spaces-002.html (live test) (source) trailing-ideographic-space-break-spaces-003.html (live test) (source) trailing-ideographic-space-break-spaces-004.html (live test) (source) trailing-ideographic-space-break-spaces-005.html (live test) (source) trailing-ideographic-space-break-spaces-006.html (live test) (source) trailing-ideographic-space-break-spaces-007.html (live test) (source) trailing-ideographic-space-break-spaces-008.html (live test) (source)",
-          "type": "value",
-          "value": "break-spaces"
-        },
         {
           "name": "pre-line",
-          "prose": "Like normal, this value collapses consecutive white space characters and allows wrapping, but it preserves segment breaks in the source as forced line breaks.",
           "type": "value",
           "value": "pre-line"
         }
@@ -185,8 +169,8 @@
       ]
     },
     {
-      "name": "text-space-collapse",
-      "value": "collapse | discard | preserve | preserve-breaks | preserve-spaces",
+      "name": "white-space-collapse",
+      "value": "collapse | discard | preserve | preserve-breaks | preserve-spaces | break-spaces",
       "initial": "collapse",
       "appliesTo": "text",
       "inherited": "yes",
@@ -203,32 +187,38 @@
         },
         {
           "name": "preserve",
-          "prose": "This value prevents user agents from collapsing sequences of white space. Segment breaks are preserved as forced line breaks.",
+          "prose": "This value prevents user agents from collapsing sequences of white space. Segment breaks such as line feeds are preserved as forced line breaks.",
           "type": "value",
           "value": "preserve"
         },
         {
           "name": "preserve-breaks",
-          "prose": "This value collapses white space as for collapse, but preserves segment breaks as forced line breaks.",
+          "prose": "Like collapse, this value collapses consecutive white space characters, but preserves segment breaks in the source as forced line breaks.",
           "type": "value",
           "value": "preserve-breaks"
         },
         {
           "name": "preserve-spaces",
-          "prose": "This value prevents user agents from collapsing sequences of white space, and converts tabs and segment breaks to spaces. (This value is intended to match the behavior of xml:space=\"preserve\" in SVG.)",
+          "prose": "This value prevents user agents from collapsing sequences of white space, and converts tabs and segment breaks to spaces. (This value is intended to represent the behavior of xml:space=\"preserve\" in SVG.)",
           "type": "value",
           "value": "preserve-spaces"
         },
+        {
+          "name": "break-spaces",
+          "prose": "The behavior is identical to that of preserve, except that: Any sequence of preserved white space or other space separators always takes up space, including at the end of the line. A line breaking opportunity exists after every preserved white space character and after every other space separator (including between adjacent spaces).",
+          "type": "value",
+          "value": "break-spaces"
+        },
         {
           "name": "discard",
-          "prose": "This value directs user agents to “discard” all white space in the element. Does this preserve line break opportunities or no? Do we need a \"hide\" value?",
+          "prose": "This value directs user agents to “discard” all white space in the element. Does this preserve line break opportunities or no? Do we need a distinct \"hide\" value? If it preserves line break opportunities, maybe it should be replaced with a word-boundary-expansion value?",
           "type": "value",
           "value": "discard"
         }
       ],
       "styleDeclaration": [
-        "text-space-collapse",
-        "textSpaceCollapse"
+        "white-space-collapse",
+        "whiteSpaceCollapse"
       ]
     },
     {
@@ -927,7 +917,7 @@
         },
         {
           "name": "no-compress",
-          "prose": "Justification must not compress spacing controlled by text-spacing-trim or text-autospace. (If this value is not specified, the justification process may reduce such spacing except when the spacing is at the start or end of the line.) This keyword used to be part of text-spacing; it might need renaming to be more specific now that it’s here, as it implies that e.g. U+0020 cannot be compressed.",
+          "prose": "Justification must not compress spacing controlled by text-spacing-trim or text-autospace. (If this value is not specified, the justification process may reduce such spacing except when the spacing is at the start or end of the line.) This keyword used to be part of text-spacing; it might need renaming to be more specific now that it’s here, as it implies that e.g. U+0020 cannot be compressed. [Issue #7079]",
           "type": "value",
           "value": "no-compress"
         }
@@ -1065,7 +1055,7 @@
     },
     {
       "name": "text-autospace",
-      "value": "normal | <autospace>",
+      "value": "normal | <autospace> | auto",
       "initial": "normal",
       "appliesTo": "text",
       "inherited": "yes",
@@ -1115,6 +1105,12 @@
           "prose": "Creates extra non-breaking spacing around punctuation as required by language-specific typographic conventions. In this level, if the element’s content language is French, narrow no-break space (U+202F) and no-break space (U+00A0) is inserted where required by French typographic guidelines. Otherwise this value has no effect. However future specifications may add automatic spacing behavior for other languages.",
           "type": "value",
           "value": "punctuation"
+        },
+        {
+          "name": "auto",
+          "prose": "The user agent chooses a set of typographically high quality spacing values. Different user agents running on different platforms may pick different values.",
+          "type": "value",
+          "value": "auto"
         }
       ],
       "styleDeclaration": [

package/css-ui.json

@@ -25,7 +25,7 @@
       "appliesTo": "all elements",
       "inherited": "no",
       "percentages": "N/A",
-      "computedValue": "absolute length; 0 if the outline style is none.",
+      "computedValue": "absolute length, snapped as a border width; 0 if the outline style is none.",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value",
       "styleDeclaration": [

package/css-values.json

@@ -50,23 +50,123 @@
     {
       "name": "url()",
       "prose": "The <url> type, written with the url() and src() functions, represents a URL, which is a pointer to a resource.",
-      "type": "function"
+      "type": "function",
+      "value": "url( <string> <url-modifier>* ) | <url-token>"
     },
     {
       "name": "src()",
       "prose": "The <url> type, written with the url() and src() functions, represents a URL, which is a pointer to a resource.",
-      "type": "function"
+      "type": "function",
+      "value": "src( <string> <url-modifier>* )"
     },
     {
       "name": "<url>",
       "type": "type",
-      "value": "url( <string> <url-modifier>* ) | src( <string> <url-modifier>* )"
+      "value": "<url()> | <src()>"
     },
     {
       "name": "<url-modifier>",
       "prose": "<url>s support specifying additional <url-modifier>s, which change the meaning or the interpretation of the URL somehow. A <url-modifier> is either an <ident> or a functional notation.",
       "type": "type"
     },
+    {
+      "name": "<request-url-modifier>",
+      "prose": "The <request-url-modifier>s represent <url-modifier>s that affect the resource’s request. Each <request-url-modifier> has a request modifier steps which accepts a request.",
+      "type": "type",
+      "value": "<crossorigin-modifier> | <integrity-modifier> | <referrerpolicy-modifier>",
+      "values": [
+        {
+          "name": "<crossorigin-modifier>",
+          "value": "crossorigin(anonymous | use-credentials)",
+          "type": "type"
+        },
+        {
+          "name": "crossorigin()",
+          "prose": "<crossorigin-modifier> = crossorigin(anonymous | use-credentials)",
+          "type": "function"
+        },
+        {
+          "name": "anonymous",
+          "prose": "<crossorigin-modifier> = crossorigin(anonymous | use-credentials)",
+          "type": "value",
+          "value": "anonymous"
+        },
+        {
+          "name": "use-credentials",
+          "prose": "<crossorigin-modifier> = crossorigin(anonymous | use-credentials)",
+          "type": "value",
+          "value": "use-credentials"
+        },
+        {
+          "name": "<integrity-modifier>",
+          "value": "integrity(<string>)",
+          "type": "type"
+        },
+        {
+          "name": "integrity()",
+          "prose": "<integrity-modifier> = integrity(<string>)",
+          "type": "function"
+        },
+        {
+          "name": "<referrerpolicy-modifier>",
+          "value": "referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "type"
+        },
+        {
+          "name": "referrerpolicy()",
+          "prose": "<referrerpolicy-modifier> = referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "function"
+        },
+        {
+          "name": "no-referrer",
+          "prose": "<referrerpolicy-modifier> = referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "value",
+          "value": "no-referrer"
+        },
+        {
+          "name": "no-referrer-when-downgrade",
+          "prose": "<referrerpolicy-modifier> = referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "value",
+          "value": "no-referrer-when-downgrade"
+        },
+        {
+          "name": "same-origin",
+          "prose": "<referrerpolicy-modifier> = referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "value",
+          "value": "same-origin"
+        },
+        {
+          "name": "origin",
+          "prose": "<referrerpolicy-modifier> = referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "value",
+          "value": "origin"
+        },
+        {
+          "name": "strict-origin",
+          "prose": "<referrerpolicy-modifier> = referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "value",
+          "value": "strict-origin"
+        },
+        {
+          "name": "origin-when-cross-origin",
+          "prose": "<referrerpolicy-modifier> = referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "value",
+          "value": "origin-when-cross-origin"
+        },
+        {
+          "name": "strict-origin-when-cross-origin",
+          "prose": "<referrerpolicy-modifier> = referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "value",
+          "value": "strict-origin-when-cross-origin"
+        },
+        {
+          "name": "unsafe-url",
+          "prose": "<referrerpolicy-modifier> = referrerpolicy(no-referrer | no-referrer-when-downgrade | same-origin | origin | strict-origin | origin-when-cross-origin | strict-origin-when-cross-origin | unsafe-url)",
+          "type": "value",
+          "value": "unsafe-url"
+        }
+      ]
+    },
     {
       "name": "<integer>",
       "prose": "Integer values are denoted by <integer>.",

package/css-view-transitions.json

@@ -37,8 +37,7 @@
   "atrules": [],
   "selectors": [
     {
-      "name": "::view-transition",
-      "prose": "A tree-abiding pseudo-element that is also a pseudo-element root. Its originating element is the document’s document element. Its containing block is the snapshot root. The following is added to the HTML user agent style sheet: html::view-transition { position: fixed; inset: 0; }"
+      "name": "::view-transition"
     },
     {
       "name": "::view-transition-group()",

package/html.json

@@ -10,7 +10,7 @@
     {
       "name": "<source-size-list>",
       "type": "type",
-      "value": "[ <source-size># , ]? <source-size-value>"
+      "value": "<source-size>#? , <source-size-value>"
     },
     {
       "name": "<source-size>",

package/motion.json

@@ -6,7 +6,7 @@
   "properties": [
     {
       "name": "offset-path",
-      "value": "none | <ray()> | <path()> | <url> | [ <basic-shape> && <coord-box>? ] | <coord-box>",
+      "value": "none | <offset-path> || <coord-box>",
       "initial": "none",
       "appliesTo": "transformable elements",
       "inherited": "no",
@@ -18,9 +18,39 @@
       "values": [
         {
           "name": "none",
-          "prose": "No offset path gets created. When offset-path is none, offset-distance and offset-rotate have no effect.",
+          "prose": "The element does not have an offset transform.",
           "type": "value",
           "value": "none"
+        },
+        {
+          "name": "<offset-path> || <coord-box>",
+          "prose": "The element has an offset transform, defined by some offset path. See § 2.7 Calculating The Offset Transform for details on how to calculate the offset transform. All the usual effects of having a transform apply (such as creating a stacking context, etc.) See CSS Transforms 1 § 2 The Transform Rendering Model for details. If <offset-path> is omitted, it defaults to inset(0 round X), where X is the value of border-radius on the element that establishes the containing block for this element. If <coord-box> is omitted, it defaults to border-box. See the specific values (below) for the interpretation of each component.",
+          "type": "value",
+          "value": "<offset-path> || <coord-box>"
+        },
+        {
+          "name": "<ray()>",
+          "prose": "The offset path is a line extending from the offset starting position at some angle. See § 2.1.1 The ray() Function for details. The <coord-box> provides the reference box for the ray.",
+          "type": "value",
+          "value": "<ray()>"
+        },
+        {
+          "name": "<url>",
+          "prose": "A URL reference to an SVG shape element. The offset path is the referenced element’s equivalent path. [SVG2] If the URL does not reference a shape element (because it references a different element, or resolves to a non-SVG document, or doesn’t resolve at all, etc) this behaves as path(\"m 0 0\") (a <basic-shape>) instead. The <coord-box> defines the viewport and user coordinate system for the shape element, with the origin (the 0,0 point) at the top left corner, and units being 1px in size.",
+          "type": "value",
+          "value": "<url>"
+        },
+        {
+          "name": "<basic-shape>",
+          "prose": "The offset path is the equivalent path of the <basic-shape> function. If circle() or ellipse() is used, and an explicit center position is not given, they default to using the offset starting position, rather than their standard default. The <coord-box> provides the [=/reference box=] for the <basic-shape>.",
+          "type": "value",
+          "value": "<basic-shape>"
+        },
+        {
+          "name": "<coord-box>",
+          "prose": "Defines the box that the <offset-path> sizes into. In CSS contexts, the boxes being referenced are from the element that establishes the containing block for this element. In SVG contexts, all values behave as view-box.",
+          "type": "value",
+          "value": "<coord-box>"
         }
       ],
       "styleDeclaration": [
@@ -34,7 +64,7 @@
       "initial": "0",
       "appliesTo": "transformable elements",
       "inherited": "no",
-      "percentages": "refer to the total path length",
+      "percentages": "relative to the offset path length",
       "computedValue": "a computed <length-percentage> value",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value",
@@ -51,20 +81,20 @@
       "appliesTo": "transformable elements",
       "inherited": "no",
       "percentages": "Refer to the size of containing block",
-      "computedValue": "For <length> the absolute value, otherwise a percentage.",
+      "computedValue": "The auto keyword or a computed <position>",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value",
       "media": "visual",
       "values": [
         {
           "name": "auto",
-          "prose": "Indicates the initial position is the position of the box specified with position property.",
+          "prose": "The offset starting position is the top-left corner of the box.",
           "type": "value",
           "value": "auto"
         },
         {
           "name": "<position>",
-          "prose": "Specifies the initial position, with the the containing block as the positioning area and a dimensionless point (zero-sized box) as the object area.",
+          "prose": "The offset starting position is the result of using the <position> to position a 0x0 object area within the box’s containing block.",
           "type": "value",
           "value": "<position>"
         }
@@ -80,11 +110,25 @@
       "initial": "auto",
       "appliesTo": "transformable elements",
       "inherited": "no",
-      "percentages": "Relative to the width and the height of a box",
-      "computedValue": "For <length> the absolute value, otherwise a percentage.",
+      "percentages": "relative to the width and the height of the element’s reference box",
+      "computedValue": "the auto keyword or a computed <position>",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value",
       "media": "visual",
+      "values": [
+        {
+          "name": "auto",
+          "prose": "The anchor point is the same as the point indicated by transform-origin. Specifically, the computed value of transform-origin is resolved as a <position> against the element’s reference box.",
+          "type": "value",
+          "value": "auto"
+        },
+        {
+          "name": "<position>",
+          "prose": "The anchor point is the result of resolving the <position> against the element’s reference box.",
+          "type": "value",
+          "value": "<position>"
+        }
+      ],
       "styleDeclaration": [
         "offset-anchor",
         "offsetAnchor"
@@ -104,15 +148,21 @@
       "values": [
         {
           "name": "auto",
-          "prose": "Indicates that the object is rotated (over time if offset-distance is animated) by the angle of the direction (i.e., directional tangent vector) of the offset path, relative to the positive x-axis. If specified in combination with <angle>, the computed value of <angle> is added to the computed value of auto.",
+          "prose": "The offset transform will have a rotation component equal to the difference between the offset path’s direction at the offset position and the direction of the positive X axis (that is, a line going toward the right). See SVG’s direction of a path for details on how to calculate this. If specified with an <angle>, the angle is added to the rotation component.",
           "type": "value",
           "value": "auto"
         },
         {
           "name": "reverse",
-          "prose": "Indicates that the object is rotated (over time if offset-distance is animated) by the angle of the direction (i.e., directional tangent vector) of the offset path, relative to the positive x-axis, plus 180 degrees. If specified in combination with <angle>, the computed value of <angle> is added to the computed value of reverse.",
+          "prose": "Identical to auto, but adds an additional 180deg to the rotation.",
           "type": "value",
           "value": "reverse"
+        },
+        {
+          "name": "<angle>",
+          "prose": "When specified on its own, adds a rotation component to the offset transform of the specified angle. (That is, offset-rotate: 45deg; is similar to transform: rotate(45deg); it’s just ordered to be part of the offset transform.)",
+          "type": "value",
+          "value": "<angle>"
         }
       ],
       "styleDeclaration": [
@@ -138,26 +188,31 @@
   "atrules": [],
   "selectors": [],
   "values": [
+    {
+      "name": "<offset-path>",
+      "type": "type",
+      "value": "<ray()> | <url> | <basic-shape>"
+    },
     {
       "name": "ray()",
       "type": "function",
-      "value": "ray( <angle> && <ray-size> && contain? )",
+      "value": "ray( <angle> && <ray-size>? && contain? )",
       "values": [
         {
           "name": "<angle>",
-          "prose": "The offset path is a line segment that starts from the initial position and proceeds in the direction defined by the specified <angle>. As with gradient functions, <angle> values are interpreted as bearing angles, with 0deg pointing up and positive angles representing clockwise rotation. This is also the initial direction.",
+          "prose": "The offset path is a single line segment that starts from the offset starting position and proceeds in the direction defined by the specified <angle>. (Its length is determined by the other arguments.) As with gradient functions, <angle> values are interpreted as bearing angles, with 0deg pointing up and positive angles representing clockwise rotation.",
           "type": "value",
           "value": "<angle>"
         },
         {
           "name": "<ray-size>",
-          "prose": "Specifies the length of the offset path (the distance between the offset-distance: 0% and offset-distance: 100% points) relative to the containing box. Individual keywords are:",
+          "prose": "Specifies the length of the offset path (the distance between the offset-distance: 0% and offset-distance: 100% points) relative to the containing box. If no <ray-size> is specified it defaults to closest-side. Individual keywords are:",
           "type": "value",
           "value": "<ray-size>"
         },
         {
           "name": "contain",
-          "prose": "The used value of offset-distance is clamped so that the box is entirely contained within the path. If no offset-distance would lead to the box being enclosed by the path, the path size is minimally increased so that such an offset-distance exists. Not clear what this actually means. See Issue 363.",
+          "prose": "The length of the offset path is reduced so that the element stays within the containing block even at offset-distance: 100%. Specifically, the path’s length is reduced by half the width or half the height of the element’s border box, whichever is larger, and floored at zero.",
           "type": "value",
           "value": "contain"
         }
@@ -170,45 +225,35 @@
       "values": [
         {
           "name": "closest-side",
-          "prose": "The distance from the initial position to whichever side of the containing block is closest.",
+          "prose": "The distance from the ray’s starting point to whichever side of the containing block is closest.",
           "type": "value",
           "value": "closest-side"
         },
         {
           "name": "closest-corner",
-          "prose": "The distance from the initial position to whichever corner of the containing block is closest.",
+          "prose": "The distance from the ray’s starting point to whichever corner of the containing block is closest.",
           "type": "value",
           "value": "closest-corner"
         },
         {
           "name": "farthest-side",
-          "prose": "The distance from the initial position to whichever side of the containing block is farthest.",
+          "prose": "The distance from the ray’s starting point to whichever side of the containing block is farthest.",
           "type": "value",
           "value": "farthest-side"
         },
         {
           "name": "farthest-corner",
-          "prose": "The distance from the initial position to whichever corner of the containing block is farthest.",
+          "prose": "The distance from the ray’s starting point to whichever corner of the containing block is farthest.",
           "type": "value",
           "value": "farthest-corner"
         },
         {
           "name": "sides",
-          "prose": "The distance from the initial position to the point where the offset path intersects the containing block’s boundary. If the initial position is on the containing block’s boundary, or outside its bounds entirely, the distance is zero.",
+          "prose": "The distance from the ray’s starting point to the point where the offset path intersects the containing block’s boundary. If the ray’s starting point is on the containing block’s boundary, or outside its bounds entirely, the distance is zero.",
           "type": "value",
           "value": "sides"
         }
       ]
     }
-  ],
-  "warnings": [
-    {
-      "msg": "Dangling value",
-      "name": "path()",
-      "value": "path( <string> )",
-      "pureSyntax": true,
-      "type": "function",
-      "for": "offsetpath-pathfunc"
-    }
   ]
 }

package/package.json

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