@webref/css 6.4.0 → 6.4.1

package/css-color-5.json

@@ -59,6 +59,22 @@
   ],
   "selectors": [],
   "values": [
+    {
+      "name": "<color>",
+      "prose": "Colors in CSS are represented by the <color> type:",
+      "type": "type",
+      "value": "<absolute-color-base> | currentcolor | <system-color> | <device-cmyk()>"
+    },
+    {
+      "name": "<absolute-color-base>",
+      "type": "type",
+      "value": "<hex-color> | <absolute-color-function> | <named-color> | transparent"
+    },
+    {
+      "name": "<absolute-color-function>",
+      "type": "type",
+      "value": "<rgb()> | <rgba()> | <hsl()> | <hsla()> | <hwb()> | <lab()> | <lch()> | <oklab()> | <oklch()> | <color()>"
+    },
     {
       "name": "color-mix()",
       "type": "function",
@@ -67,7 +83,7 @@
     {
       "name": "rgb()",
       "type": "function",
-      "value": "rgb( [<percentage> | none]{3} [ / [<alpha-value> | none] ]? ) | rgb( [<number> | none]{3} [ / [<alpha-value> | none] ]? ) | rgb( [ from <color> ]? [ <number> | <percentage> | none]{3} [ / [<alpha-value> | none] ]? )",
+      "value": "rgb( [ from <color> ]? [ <number> | <percentage> | none]{3} [ / [<alpha-value> | none] ]? )",
       "values": [
         {
           "name": "r",
@@ -95,6 +111,11 @@
         }
       ]
     },
+    {
+      "name": "rgba()",
+      "type": "function",
+      "value": "rgba( [ from <color> ]? [ <number> | <percentage> | none]{3} [ / [<alpha-value> | none] ]? )"
+    },
     {
       "name": "<alpha-value>",
       "type": "type",
@@ -131,6 +152,11 @@
         }
       ]
     },
+    {
+      "name": "hsla()",
+      "type": "function",
+      "value": "hsla([from <color>]? [<hue> | none] [<percentage> | <number> | none] [<percentage> | <number> | none] [ / [<alpha-value> | none] ]? )"
+    },
     {
       "name": "hwb()",
       "type": "function",

package/css-color.json

@@ -825,12 +825,32 @@
     {
       "name": "rgb()",
       "type": "function",
-      "value": "rgb( [<percentage> | none]{3} [ / [<alpha-value> | none] ]? ) | rgb( [<number> | none]{3} [ / [<alpha-value> | none] ]? ) | rgb( <percentage>#{3} , <alpha-value>? ) | rgb( <number>#{3} , <alpha-value>? ) | rgb( [<percentage> | none]{3} [ / [<alpha-value> | none] ]? ) | rgb( [<number> | none]{3} [ / [<alpha-value> | none] ]? )"
+      "value": "[ <legacy-rgb-syntax> | <modern-rgb-syntax> ]"
     },
     {
       "name": "rgba()",
-      "prose": "Also, an rgba() legacy color syntax also exists, with an identical grammar and behavior to rgb().",
-      "type": "function"
+      "type": "function",
+      "value": "[ <legacy-rgba-syntax> | <modern-rgba-syntax> ]"
+    },
+    {
+      "name": "<legacy-rgb-syntax>",
+      "type": "type",
+      "value": "rgb( <percentage>#{3} , <alpha-value>? ) | rgb( <number>#{3} , <alpha-value>? )"
+    },
+    {
+      "name": "<legacy-rgba-syntax>",
+      "type": "type",
+      "value": "rgba( <percentage>#{3} , <alpha-value>? ) | rgba( <number>#{3} , <alpha-value>? )"
+    },
+    {
+      "name": "<modern-rgb-syntax>",
+      "type": "type",
+      "value": "rgb( [ <number> | <percentage> | none]{3} [ / [<alpha-value> | none] ]? )"
+    },
+    {
+      "name": "<modern-rgba-syntax>",
+      "type": "type",
+      "value": "rgba( [ <number> | <percentage> | none]{3} [ / [<alpha-value> | none] ]? )"
     },
     {
       "name": "<hex-color>",
@@ -966,11 +986,11 @@
     {
       "name": "hsl()",
       "type": "function",
-      "value": "hsl( [<hue> | none] [<percentage> | none] [<percentage> | none] [ / [<alpha-value> | none] ]? ) | hsl( <hue>, <percentage>, <percentage>, <alpha-value>? ) | hsl( [<hue> | none] [<percentage> | none] [<percentage> | none] [ / [<alpha-value> | none] ]? )",
+      "value": "[ <legacy-hsl-syntax> | <modern-hsl-syntax> ]",
       "values": [
         {
           "name": "HSL",
-          "prose": "HSL colors are specified as a triplet of hue, saturation, and lightness. The syntax of the hsl() function is:",
+          "prose": "HSL colors are specified as a triplet of hue, saturation, and lightness. The syntax of the hsl() and hsla() functions is:",
           "type": "value",
           "value": "HSL"
         }
@@ -978,8 +998,28 @@
     },
     {
       "name": "hsla()",
-      "prose": "Also, an hsla() legacy color syntax also exists, with an identical grammar and behavior to hsl().",
-      "type": "function"
+      "type": "function",
+      "value": "[ <legacy-hsla-syntax> | <modern-hsla-syntax> ]"
+    },
+    {
+      "name": "<modern-hsl-syntax>",
+      "type": "type",
+      "value": "hsl( [<hue> | none] [<percentage> | <number> | none] [<percentage> | <number> | none] [ / [<alpha-value> | none] ]? )"
+    },
+    {
+      "name": "<modern-hsla-syntax>",
+      "type": "type",
+      "value": "hsla( [<hue> | none] [<percentage> | <number> | none] [<percentage> | <number> | none] [ / [<alpha-value> | none] ]? )"
+    },
+    {
+      "name": "<legacy-hsl-syntax>",
+      "type": "type",
+      "value": "hsl( <hue>, <percentage>, <percentage>, <alpha-value>? )"
+    },
+    {
+      "name": "<legacy-hsla-syntax>",
+      "type": "type",
+      "value": "hsla( <hue>, <percentage>, <percentage>, <alpha-value>? )"
     },
     {
       "name": "hwb()",

package/css-easing.json

@@ -100,7 +100,7 @@
         },
         {
           "name": "steps()",
-          "value": "steps(<integer>[, <step-position> ]?)",
+          "value": "steps(<integer>, <step-position>?)",
           "type": "function",
           "values": [
             {

package/css-text-4.json

@@ -880,7 +880,7 @@
     },
     {
       "name": "text-justify",
-      "value": "auto | none | inter-word | inter-character",
+      "value": "[ auto | none | inter-word | inter-character ] || no-compress",
       "initial": "auto",
       "appliesTo": "text",
       "inherited": "yes",
@@ -924,6 +924,12 @@
           "prose": "Justification adjusts spacing as for auto except: Justification opportunities are disabled at word separators. Justification opportunities are disabled between Bopomofo characters",
           "type": "value",
           "value": "ruby"
+        },
+        {
+          "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.",
+          "type": "value",
+          "value": "no-compress"
         }
       ],
       "styleDeclaration": [
@@ -1058,10 +1064,10 @@
       ]
     },
     {
-      "name": "text-spacing",
-      "value": "normal | none | auto | no-compress || [ trim-start | space-start | space-first ] || [ trim-end | space-end | allow-end ] || [ trim-adjacent | space-adjacent ] || ideograph-alpha || ideograph-numeric || punctuation",
+      "name": "text-autospace",
+      "value": "normal | <autospace>",
       "initial": "normal",
-      "appliesTo": "block containers",
+      "appliesTo": "text",
       "inherited": "yes",
       "percentages": "N/A",
       "computedValue": "specified keyword(s)",
@@ -1070,93 +1076,139 @@
       "values": [
         {
           "name": "normal",
-          "prose": "Specifies the baseline behavior, equivalent to space-start trim-end trim-adjacent ideograph-alpha ideograph-numeric.",
+          "prose": "Same behavior as ideograph-alpha ideograph-numeric.",
           "type": "value",
           "value": "normal"
         },
         {
-          "name": "none",
-          "prose": "Turns off all text-spacing features. All fullwidth characters are set with full-width glyphs.",
+          "name": "no-autospace",
+          "prose": "No automatic space is inserted.",
           "type": "value",
-          "value": "none"
+          "value": "no-autospace"
         },
         {
-          "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.",
+          "name": "insert",
+          "prose": "The specified spacing is automatically inserted if there are no space characters of any kind (Unicode general category Z) already there. If neither insert nor replace are specified, the behavior is the same as insert.",
           "type": "value",
-          "value": "auto"
+          "value": "insert"
         },
         {
-          "name": "no-compress",
-          "prose": "Justification must not compress text-spacing. (If this value is not specified, the justification process may reduce autospacing except when the spacing is at the start or end of the line.)",
+          "name": "replace",
+          "prose": "The specified spacing is automatically inserted even if there is already a space (U+0020) at that point; additionally, the space (U+0020) is removed. Other types of space characters (Unicode general category Z) suppress automatic spacing, as for insert.",
           "type": "value",
-          "value": "no-compress"
+          "value": "replace"
         },
         {
-          "name": "space-start",
-          "prose": "Set fullwidth opening punctuation with full-width glyphs (spaced) at the start of each line.",
+          "name": "ideograph-alpha",
+          "prose": "Creates extra spacing between runs of ideographs and non-ideographic letters, see § 8.4.1 Inter-script Spacing.",
           "type": "value",
-          "value": "space-start"
+          "value": "ideograph-alpha"
         },
         {
-          "name": "trim-start",
-          "prose": "Set fullwidth opening punctuation with half-width glyphs (flush) at the start of each line.",
+          "name": "ideograph-numeric",
+          "prose": "Creates extra spacing between runs of ideographs and non-ideographic numerals, see § 8.4.1 Inter-script Spacing.",
           "type": "value",
-          "value": "trim-start"
+          "value": "ideograph-numeric"
         },
         {
-          "name": "space-first",
-          "prose": "Behaves as space-start on the first line the block container and each line after a forced line break but as trim-start on all other lines.",
+          "name": "punctuation",
+          "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": "space-first"
+          "value": "punctuation"
+        }
+      ],
+      "styleDeclaration": [
+        "text-autospace",
+        "textAutospace"
+      ]
+    },
+    {
+      "name": "text-spacing-trim",
+      "value": "<spacing-trim> | auto",
+      "initial": "space-first",
+      "appliesTo": "text",
+      "inherited": "yes",
+      "percentages": "N/A",
+      "computedValue": "specified keyword(s)",
+      "canonicalOrder": "per grammar",
+      "animationType": "discrete",
+      "values": [
+        {
+          "name": "space-all",
+          "prose": "All fullwidth punctuation characters are set with full-width glyphs (spaced).",
+          "type": "value",
+          "value": "space-all"
         },
         {
-          "name": "allow-end",
-          "prose": "Set fullwidth closing punctuation with half-width glyphs (flush) at the end of each line if it does not otherwise fit prior to justification; otherwise set the punctuation with full-width glyphs.",
+          "name": "trim-auto",
+          "prose": "Set fullwidth opening punctuation with half-width glyphs (flush) at the start of each line; set fullwidth closing punctuation with half-width glyphs (flush) at the end of each line; and collapse spacing between punctuation glyphs as described below.",
           "type": "value",
-          "value": "allow-end"
+          "value": "trim-auto"
         },
         {
-          "name": "space-end",
-          "prose": "Set fullwidth closing punctuation with full-width glyphs (spaced) at the end of each line.",
+          "name": "space-first",
+          "prose": "Set fullwidth opening punctuation with full-width glyphs (spaced) on the first line the block container. Otherwise as trim-auto (unless allow-end is also specified).",
           "type": "value",
-          "value": "space-end"
+          "value": "space-first"
         },
         {
-          "name": "trim-end",
-          "prose": "Set fullwidth closing punctuation with half-width glyphs (flush) at the end of each line.",
+          "name": "allow-end",
+          "prose": "Set fullwidth closing punctuation with half-width glyphs (flush) at the end of each line if it does not otherwise fit prior to justification, else set the punctuation with full-width glyphs. Otherwise as trim-auto (unless space-first is also specified).",
           "type": "value",
-          "value": "trim-end"
+          "value": "allow-end"
         },
         {
-          "name": "space-adjacent",
-          "prose": "Set fullwidth opening punctuation with full-width glyphs (spaced) when not at the start of the line. Set fullwidth closing punctuation with full-width glyphs (spaced) when not at the end of the line.",
+          "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. Do we need auto? It would be weird for the author to choose platform-dependent behavior at the start of the first line, and it should otherwise use trim-auto.",
+          "type": "value",
+          "value": "auto"
+        }
+      ],
+      "styleDeclaration": [
+        "text-spacing-trim",
+        "textSpacingTrim"
+      ]
+    },
+    {
+      "name": "text-spacing",
+      "value": "normal | none | auto | <autospace> || <spacing-trim>",
+      "initial": "see individual properties",
+      "appliesTo": "text",
+      "inherited": "yes",
+      "percentages": "N/A",
+      "computedValue": "specified keyword(s)",
+      "animationType": "discrete",
+      "canonicalOrder": "per grammar",
+      "values": [
+        {
+          "name": "normal",
+          "prose": "Specifies the baseline behavior, setting each sub-property to its initial value. Equivalent to space-first ideograph-alpha ideograph-numeric.",
           "type": "value",
-          "value": "space-adjacent"
+          "value": "normal"
         },
         {
-          "name": "trim-adjacent",
-          "prose": "Collapse spacing between punctuation glyphs as described below.",
+          "name": "none",
+          "prose": "Turns off all text-spacing features: sets text-spacing-trim to space-all and text-autospace to no-autospace.",
           "type": "value",
-          "value": "trim-adjacent"
+          "value": "none"
         },
         {
-          "name": "ideograph-alpha",
-          "prose": "Creates extra spacing between runs of ideographs and non-ideographic letters, see § 8.4.1 Inter-script Spacing.",
+          "name": "auto",
+          "prose": "Sets both text-spacing-trim and text-autospace to auto.",
           "type": "value",
-          "value": "ideograph-alpha"
+          "value": "auto"
         },
         {
-          "name": "ideograph-numeric",
-          "prose": "Creates extra spacing between runs of ideographs and non-ideographic numerals, see § 8.4.1 Inter-script Spacing.",
+          "name": "<spacing-trim>",
+          "prose": "Sets text-spacing-trim to the specified value. If no <autospace> value is given, text-autospace is set to its initial value.",
           "type": "value",
-          "value": "ideograph-numeric"
+          "value": "<spacing-trim>"
         },
         {
-          "name": "punctuation",
-          "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. Integrate rules for correcting incorrect spaces? Issue 318",
+          "name": "<autospace>",
+          "prose": "Sets text-autospace to the specified value. If no <spacing-trim> value is given, text-spacing-trim is set to its initial value.",
           "type": "value",
-          "value": "punctuation"
+          "value": "<autospace>"
         }
       ],
       "styleDeclaration": [
@@ -1224,7 +1276,7 @@
         },
         {
           "name": "first",
-          "prose": "An opening bracket or quote at the start of the first formatted line of an element hangs. This applies to all characters in the Unicode categories Ps, Pf, Pi plus the ASCII quote marks U+0027 ' APOSTROPHE and U+0022 \" QUOTATION MARK.",
+          "prose": "An opening bracket, quote, or ideographic space at the start of the first formatted line of an element hangs. This applies to all characters in the Unicode categories Ps, Pf, Pi plus the ASCII quote marks U+0027 ' APOSTROPHE and U+0022 \" QUOTATION MARK and the IDEOGRAPHIC SPACE U+3000.",
           "type": "value",
           "value": "first"
         },
@@ -1255,5 +1307,16 @@
   ],
   "atrules": [],
   "selectors": [],
-  "values": []
+  "values": [
+    {
+      "name": "<autospace>",
+      "type": "type",
+      "value": "no-autospace | [ ideograph-alpha || ideograph-numeric || punctuation ] || [ insert | replace ]"
+    },
+    {
+      "name": "<spacing-trim>",
+      "type": "type",
+      "value": "space-all | trim-auto | [ allow-end || space-first ]"
+    }
+  ]
 }

package/package.json

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