@webref/css 5.4.4 → 6.1.0

package/css-extensions.json

@@ -3,22 +3,30 @@
     "title": "CSS Extensions",
     "url": "https://drafts.csswg.org/css-extensions-1/"
   },
-  "properties": {},
-  "atrules": {
-    "@custom-selector": {
-      "value": "@custom-selector <custom-selector> <selector-list> ;",
-      "descriptors": []
+  "properties": [],
+  "atrules": [
+    {
+      "name": "@custom-selector",
+      "descriptors": [],
+      "value": "@custom-selector <custom-selector> <selector-list> ;"
     }
-  },
-  "valuespaces": {
-    "<extension-name>": {
-      "prose": "All extensions defined in this specification use a common syntax for defining their ”names”: the <extension-name> production. An <extension-name> is any identifier that starts with two dashes (U+002D HYPHEN-MINUS), like --foo, or even exotic names like -- or ------. The CSS language will never use identifiers of this form for any language-defined purpose, so it’s safe to use them for author-defined purposes without ever having to worry about colliding with CSS-defined names."
+  ],
+  "selectors": [],
+  "values": [
+    {
+      "name": "<extension-name>",
+      "prose": "All extensions defined in this specification use a common syntax for defining their ”names”: the <extension-name> production. An <extension-name> is any identifier that starts with two dashes (U+002D HYPHEN-MINUS), like --foo, or even exotic names like -- or ------. The CSS language will never use identifiers of this form for any language-defined purpose, so it’s safe to use them for author-defined purposes without ever having to worry about colliding with CSS-defined names.",
+      "type": "type"
     },
-    "<custom-selector>": {
+    {
+      "name": "<custom-selector>",
+      "type": "type",
       "value": "<custom-arg>? : <extension-name> [ ( <custom-arg>+#? ) ]? ;"
     },
-    "<custom-arg>": {
+    {
+      "name": "<custom-arg>",
+      "type": "type",
       "value": "$ <ident-token> ;"
     }
-  }
+  ]
 }

package/css-flexbox.json

@@ -3,8 +3,8 @@
     "title": "CSS Flexible Box Layout Module Level 1",
     "url": "https://drafts.csswg.org/css-flexbox-1/"
   },
-  "properties": {
-    "flex-direction": {
+  "properties": [
+    {
       "name": "flex-direction",
       "value": "row | row-reverse | column | column-reverse",
       "initial": "row",
@@ -14,12 +14,38 @@
       "computedValue": "specified keyword",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "row",
+          "prose": "The flex container’s main axis has the same orientation as the inline axis of the current writing mode. The main-start and main-end directions are equivalent to the inline-start and inline-end directions, respectively, of the current writing mode.",
+          "type": "value",
+          "value": "row"
+        },
+        {
+          "name": "row-reverse",
+          "prose": "Same as row, except the main-start and main-end directions are swapped.",
+          "type": "value",
+          "value": "row-reverse"
+        },
+        {
+          "name": "column",
+          "prose": "The flex container’s main axis has the same orientation as the block axis of the current writing mode. The main-start and main-end directions are equivalent to the block-start and block-end directions, respectively, of the current writing mode.",
+          "type": "value",
+          "value": "column"
+        },
+        {
+          "name": "column-reverse",
+          "prose": "Same as column, except the main-start and main-end directions are swapped.",
+          "type": "value",
+          "value": "column-reverse"
+        }
+      ],
       "styleDeclaration": [
         "flex-direction",
         "flexDirection"
       ]
     },
-    "flex-wrap": {
+    {
       "name": "flex-wrap",
       "value": "nowrap | wrap | wrap-reverse",
       "initial": "nowrap",
@@ -29,12 +55,32 @@
       "computedValue": "specified keyword",
       "canonicalOrder": "per grammar",
       "animationType": "discrete",
+      "values": [
+        {
+          "name": "nowrap",
+          "prose": "The flex container is single-line.",
+          "type": "value",
+          "value": "nowrap"
+        },
+        {
+          "name": "wrap",
+          "prose": "The flex container is multi-line.",
+          "type": "value",
+          "value": "wrap"
+        },
+        {
+          "name": "wrap-reverse",
+          "prose": "Same as wrap.",
+          "type": "value",
+          "value": "wrap-reverse"
+        }
+      ],
       "styleDeclaration": [
         "flex-wrap",
         "flexWrap"
       ]
     },
-    "flex-flow": {
+    {
       "name": "flex-flow",
       "value": "<'flex-direction'> || <'flex-wrap'>",
       "initial": "see individual properties",
@@ -49,7 +95,7 @@
         "flexFlow"
       ]
     },
-    "flex": {
+    {
       "name": "flex",
       "value": "none | [ <'flex-grow'> <'flex-shrink'>? || <'flex-basis'> ]",
       "initial": "0 1 auto",
@@ -59,11 +105,37 @@
       "computedValue": "see individual properties",
       "animationType": "by computed value type",
       "canonicalOrder": "per grammar",
+      "values": [
+        {
+          "name": "<'flex-grow'>",
+          "prose": "This <number [0,∞]> component sets flex-grow longhand and specifies the flex grow factor, which determines how much the flex item will grow relative to the rest of the flex items in the flex container when positive free space is distributed. When omitted, it is set to 1.",
+          "type": "value",
+          "value": "<'flex-grow'>"
+        },
+        {
+          "name": "<'flex-shrink'>",
+          "prose": "This <number [0,∞]> component sets flex-shrink longhand and specifies the flex shrink factor, which determines how much the flex item will shrink relative to the rest of the flex items in the flex container when negative free space is distributed. When omitted, it is set to 1.",
+          "type": "value",
+          "value": "<'flex-shrink'>"
+        },
+        {
+          "name": "<'flex-basis'>",
+          "prose": "This component sets the flex-basis longhand, which specifies the flex basis: the initial main size of the flex item, before free space is distributed according to the flex factors. <'flex-basis'> accepts the same values as the width and height properties (except that auto is treated differently) plus the content keyword: When omitted from the flex shorthand, its specified value is 0.",
+          "type": "value",
+          "value": "<'flex-basis'>"
+        },
+        {
+          "name": "none",
+          "prose": "The keyword none expands to 0 0 auto.",
+          "type": "value",
+          "value": "none"
+        }
+      ],
       "styleDeclaration": [
         "flex"
       ]
     },
-    "flex-grow": {
+    {
       "name": "flex-grow",
       "value": "<number [0,∞]>",
       "initial": "0",
@@ -73,12 +145,20 @@
       "computedValue": "specified number",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value type",
+      "values": [
+        {
+          "name": "<number>",
+          "prose": "The flex-grow property sets the flex grow factor to the provided <number>. Negative values are not allowed.",
+          "type": "value",
+          "value": "<number>"
+        }
+      ],
       "styleDeclaration": [
         "flex-grow",
         "flexGrow"
       ]
     },
-    "flex-shrink": {
+    {
       "name": "flex-shrink",
       "value": "<number [0,∞]>",
       "initial": "1",
@@ -88,12 +168,20 @@
       "computedValue": "specified value",
       "canonicalOrder": "per grammar",
       "animationType": "number",
+      "values": [
+        {
+          "name": "<number>",
+          "prose": "The flex-shrink property sets the flex shrink factor to the provided <number>. Negative values are not allowed.",
+          "type": "value",
+          "value": "<number>"
+        }
+      ],
       "styleDeclaration": [
         "flex-shrink",
         "flexShrink"
       ]
     },
-    "flex-basis": {
+    {
       "name": "flex-basis",
       "value": "content | <'width'>",
       "initial": "auto",
@@ -103,12 +191,45 @@
       "computedValue": "specified keyword or a computed <length-percentage> value",
       "canonicalOrder": "per grammar",
       "animationType": "by computed value type",
+      "values": [
+        {
+          "name": "auto",
+          "prose": "When specified on a flex item, the auto keyword retrieves the value of the main size property as the used flex-basis. If that value is itself auto, then the used value is content.",
+          "type": "value",
+          "value": "auto"
+        },
+        {
+          "name": "content",
+          "prose": "Indicates an automatic size based on the flex item’s content. (This is typically equivalent to the max-content size, but with adjustments to handle preferred aspect ratios, intrinsic sizing constraints, and orthogonal flows; see details in § 9 Flex Layout Algorithm.)",
+          "type": "value",
+          "value": "content"
+        }
+      ],
       "styleDeclaration": [
         "flex-basis",
         "flexBasis"
       ]
     }
-  },
-  "atrules": {},
-  "valuespaces": {}
+  ],
+  "atrules": [],
+  "selectors": [],
+  "values": [],
+  "warnings": [
+    {
+      "msg": "Dangling value",
+      "name": "flex",
+      "prose": "This value causes an element to generate a flex container box that is block-level when placed in flow layout.",
+      "type": "value",
+      "value": "flex",
+      "for": "display"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "inline-flex",
+      "prose": "This value causes an element to generate a flex container box that is inline-level when placed in flow layout.",
+      "type": "value",
+      "value": "inline-flex",
+      "for": "display"
+    }
+  ]
 }

package/css-fonts-5.json

@@ -3,8 +3,8 @@
     "title": "CSS Fonts Module Level 5",
     "url": "https://drafts.csswg.org/css-fonts-5/"
   },
-  "properties": {
-    "font-size-adjust": {
+  "properties": [
+    {
       "name": "font-size-adjust",
       "value": "none | [ ex-height | cap-height | ch-width | ic-width | ic-height ]? [ from-font | <number> ]",
       "initial": "none",
@@ -14,20 +14,91 @@
       "computedValue": "the keyword none, or a pair of a metric keyword and a <number>",
       "canonicalOrder": "per grammar",
       "animationType": "discrete if the keywords differ, otherwise by computed value type",
+      "values": [
+        {
+          "name": "none",
+          "prose": "No special font-size adjustment is applied.",
+          "type": "value",
+          "value": "none"
+        },
+        {
+          "name": "ex-height | cap-height | ch-width | ic-width | ic-height",
+          "prose": "Specifies the font metric to normalize, defaulting to ex-height: w3c/csswg-drafts/6384[css-fonts-5] font-size-adjust with missing metrics",
+          "type": "value",
+          "value": "ex-height | cap-height | ch-width | ic-width | ic-height"
+        },
+        {
+          "name": "ex-height",
+          "prose": "Normalize the aspect value of the fonts, using the x-height divided by the font size.",
+          "type": "value",
+          "value": "ex-height"
+        },
+        {
+          "name": "cap-height",
+          "prose": "Normalize the cap-height of the fonts, using the cap-height by the font size.",
+          "type": "value",
+          "value": "cap-height"
+        },
+        {
+          "name": "ch-width",
+          "prose": "Normalize the horizontal narrow pitch of the fonts, using the advance width of “0” (ZERO, U+0030) divided by the font size.",
+          "type": "value",
+          "value": "ch-width"
+        },
+        {
+          "name": "ic-width",
+          "prose": "Normalize the horizontal wide pitch of the font, using the advance width of “水” (CJK water ideograph, U+6C34) divided by the font size.",
+          "type": "value",
+          "value": "ic-width"
+        },
+        {
+          "name": "ic-height",
+          "prose": "Normalize the vertical wide pitch of the font, using the advance height of “水” (CJK water ideograph, U+6C34) divided by the font size.",
+          "type": "value",
+          "value": "ic-height"
+        },
+        {
+          "name": "<number>",
+          "prose": "Each font’s used size is normalized to match the chosen font metric to this specified proportion of the computed font-size. In other words, for each glyph, the adjusted font size to use u is calculated as: u = ( m / m′ ) s where: s = computed 'font-size!!property' value m = metric as specified by the 'font-size-adjust' property m′ = metric as specified in the actual font u = adjusted font-size to use Negative values are invalid.",
+          "type": "value",
+          "value": "<number>"
+        },
+        {
+          "name": "from-font",
+          "prose": "Computes to the <number> corresponding to the specified metric of the first available font. w3c/csswg-drafts/6384[css-fonts-5] font-size-adjust with missing metrics",
+          "type": "value",
+          "value": "from-font"
+        }
+      ],
       "styleDeclaration": [
         "font-size-adjust",
         "fontSizeAdjust"
       ]
     }
-  },
-  "atrules": {
-    "@font-face": {
+  ],
+  "atrules": [
+    {
+      "name": "@font-face",
       "descriptors": [
         {
           "name": "font-size",
           "for": "@font-face",
           "value": "auto | [<number>]{1,2}",
-          "initial": "normal"
+          "initial": "normal",
+          "values": [
+            {
+              "name": "auto",
+              "prose": "The font matches any font size",
+              "type": "value",
+              "value": "auto"
+            },
+            {
+              "name": "<number>",
+              "prose": "If a single <number> is given the font matches that specific font size, only. If two <number>s are given, they specify a range of font sizes which will match.",
+              "type": "value",
+              "value": "<number>"
+            }
+          ]
         },
         {
           "name": "size-adjust",
@@ -79,19 +150,190 @@
         }
       ]
     }
-  },
-  "valuespaces": {
-    "<font-format>": {
+  ],
+  "selectors": [],
+  "values": [
+    {
+      "name": "<font-format>",
+      "type": "type",
       "value": "[<string> | collection | embedded-opentype | opentype | svg | truetype | woff | woff2 ]"
     },
-    "<font-tech>": {
+    {
+      "name": "<font-tech>",
+      "type": "type",
       "value": "[<font-features-tech> | <color-font-tech> | variations | palettes | incremental ]"
     },
-    "<font-features-tech>": {
+    {
+      "name": "<font-features-tech>",
+      "type": "type",
       "value": "[features-opentype | features-aat | features-graphite]"
     },
-    "<color-font-tech>": {
+    {
+      "name": "<color-font-tech>",
+      "type": "type",
       "value": "[color-COLRv0 | color-COLRv1 | color-SVG | color-sbix | color-CBDT ]"
     }
-  }
+  ],
+  "warnings": [
+    {
+      "msg": "Dangling value",
+      "name": "xxx",
+      "prose": "Placeholder text for the xxx generic font family.",
+      "type": "value",
+      "value": "xxx",
+      "for": "font-family"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "xxx",
+      "prose": "Placeholder text for the xxx generic font family.",
+      "type": "value",
+      "value": "xxx",
+      "for": "<generic-family>"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "normal",
+      "prose": "The corresponding metric value is obtained from the font as usual, as if this descriptor were absent from the @font-face block.",
+      "type": "value",
+      "value": "normal",
+      "for": "ascent-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "normal",
+      "prose": "The corresponding metric value is obtained from the font as usual, as if this descriptor were absent from the @font-face block.",
+      "type": "value",
+      "value": "normal",
+      "for": "descent-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "normal",
+      "prose": "The corresponding metric value is obtained from the font as usual, as if this descriptor were absent from the @font-face block.",
+      "type": "value",
+      "value": "normal",
+      "for": "line-gap-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "<percentage>",
+      "prose": "The corresponding metric is replaced by the given percentage multiplied by the used font size.",
+      "type": "value",
+      "value": "<percentage>",
+      "for": "ascent-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "<percentage>",
+      "prose": "The corresponding metric is replaced by the given percentage multiplied by the used font size.",
+      "type": "value",
+      "value": "<percentage>",
+      "for": "descent-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "<percentage>",
+      "prose": "The corresponding metric is replaced by the given percentage multiplied by the used font size.",
+      "type": "value",
+      "value": "<percentage>",
+      "for": "line-gap-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "normal",
+      "prose": "The UA determines what metrics value to use, whether derived from the font or from some heuristic.",
+      "type": "value",
+      "value": "normal",
+      "for": "superscript-position-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "normal",
+      "prose": "The UA determines what metrics value to use, whether derived from the font or from some heuristic.",
+      "type": "value",
+      "value": "normal",
+      "for": "subscript-position-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "normal",
+      "prose": "The UA determines what metrics value to use, whether derived from the font or from some heuristic.",
+      "type": "value",
+      "value": "normal",
+      "for": "superscript-size-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "normal",
+      "prose": "The UA determines what metrics value to use, whether derived from the font or from some heuristic.",
+      "type": "value",
+      "value": "normal",
+      "for": "subscript-size-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "from-font",
+      "prose": "The corresponding metric in the font data is used, if any. (If the metric is missing, same as normal.)",
+      "type": "value",
+      "value": "from-font",
+      "for": "superscript-position-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "from-font",
+      "prose": "The corresponding metric in the font data is used, if any. (If the metric is missing, same as normal.)",
+      "type": "value",
+      "value": "from-font",
+      "for": "subscript-position-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "from-font",
+      "prose": "The corresponding metric in the font data is used, if any. (If the metric is missing, same as normal.)",
+      "type": "value",
+      "value": "from-font",
+      "for": "superscript-size-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "from-font",
+      "prose": "The corresponding metric in the font data is used, if any. (If the metric is missing, same as normal.)",
+      "type": "value",
+      "value": "from-font",
+      "for": "subscript-size-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "<percentage>",
+      "prose": "The corresponding metric is replaced by the given percentage multiplied by the used font size.",
+      "type": "value",
+      "value": "<percentage>",
+      "for": "superscript-position-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "<percentage>",
+      "prose": "The corresponding metric is replaced by the given percentage multiplied by the used font size.",
+      "type": "value",
+      "value": "<percentage>",
+      "for": "subscript-position-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "<percentage>",
+      "prose": "The corresponding metric is replaced by the given percentage multiplied by the used font size.",
+      "type": "value",
+      "value": "<percentage>",
+      "for": "superscript-size-override!!descriptor"
+    },
+    {
+      "msg": "Dangling value",
+      "name": "<percentage>",
+      "prose": "The corresponding metric is replaced by the given percentage multiplied by the used font size.",
+      "type": "value",
+      "value": "<percentage>",
+      "for": "subscript-size-override!!descriptor"
+    }
+  ]
 }