@webref/css 8.5.1 → 8.5.2

package/README.md

@@ -4,6 +4,15 @@ This package contains a consolidated list of CSS features defined across specs,
 
 **Important:** If you're migrating from version 6, see the [changelog](https://github.com/w3c/webref/blob/main/packages/css/CHANGELOG.md) for "How to upgrade" considerations.
 
+## Table of Contents
+
+- [Usage](#usage)
+- [CSS features](#css-features)
+- [Feature keys](#feature-keys)
+- [Migrating from `mdn/data`](#migrating-from-mdndata)
+- [Guarantees](#guarantees)
+
+
 ## Usage
 
 Two async methods are exposed: `listAll()` and `index()`. They both resolve with an object that lists CSS features by feature type: `atrules`, `functions`, `properties`, `selectors` and `types`.
@@ -354,7 +363,7 @@ When a property is extended with new values in different specs, the `syntax` key
 The `type` key is only set for properties, when value is not empty. It maps to the [Media feature type](https://www.w3.org/TR/mediaqueries/#mq-ranges) part of a CSS property definition. Value should be one of `discrete` or `range`, but data may contain additional values depending on what specs actually define.
 
 
-### Migrating from `mdn/data`
+## Migrating from `mdn/data`
 
 The structure of the consolidated list of CSS features aligns with CSS data in [`mdn/data`](https://github.com/mdn/data). If you use the `index()` method, the `@webref/css` package can *almost* serve as a drop-in replacement for the `mdn/data` package **for syntaxes**, with the following structural nuances:
 

package/css.json

@@ -1018,7 +1018,7 @@
       "prose": "Scoped styles are described in CSS using the @scope block at-rule, which declares a scoping root and optional scoping limits associated with a set of style rules.",
       "href": "https://drafts.csswg.org/css-cascade-6/#at-ruledef-scope",
       "descriptors": [],
-      "syntax": "@scope <scope-boundaries> { <block-contents> }",
+      "syntax": "@scope <scope-boundaries>? { <block-contents> }",
       "extended": []
     },
     {
@@ -3290,10 +3290,8 @@
         "align-items",
         "alignItems"
       ],
-      "syntax": "normal | stretch | <baseline-position> | <overflow-position>? <self-position> | anchor-center",
-      "extended": [
-        "https://drafts.csswg.org/css-anchor-position-1/#propdef-align-items"
-      ]
+      "syntax": "normal | stretch | <baseline-position> | <overflow-position>? <self-position>",
+      "extended": []
     },
     {
       "name": "align-self",
@@ -6838,7 +6836,7 @@
         "contain-intrinsic-block-size",
         "containIntrinsicBlockSize"
       ],
-      "syntax": "[ auto | from-element ]? [ none | <length [0,∞]> ]",
+      "syntax": "auto? [ none | <length [0,∞]> ]",
       "extended": []
     },
     {
@@ -6856,7 +6854,7 @@
         "contain-intrinsic-height",
         "containIntrinsicHeight"
       ],
-      "syntax": "[ auto | from-element ]? [ none | <length [0,∞]> ]",
+      "syntax": "auto? [ none | <length [0,∞]> ]",
       "extended": []
     },
     {
@@ -6874,7 +6872,7 @@
         "contain-intrinsic-inline-size",
         "containIntrinsicInlineSize"
       ],
-      "syntax": "[ auto | from-element ]? [ none | <length [0,∞]> ]",
+      "syntax": "auto? [ none | <length [0,∞]> ]",
       "extended": []
     },
     {
@@ -6895,7 +6893,7 @@
         "contain-intrinsic-width",
         "contain-intrinsic-height"
       ],
-      "syntax": "[ [ auto | from-element ]? [ none | <length [0,∞]> ] ]{1,2}",
+      "syntax": "[ auto? [ none | <length [0,∞]> ] ]{1,2}",
       "extended": []
     },
     {
@@ -6913,7 +6911,7 @@
         "contain-intrinsic-width",
         "containIntrinsicWidth"
       ],
-      "syntax": "[ auto | from-element ]? [ none | <length [0,∞]> ]",
+      "syntax": "auto? [ none | <length [0,∞]> ]",
       "extended": []
     },
     {
@@ -9069,6 +9067,23 @@
       "syntax": "auto | none | preserve-parent-color",
       "extended": []
     },
+    {
+      "name": "frame-sizing",
+      "href": "https://drafts.csswg.org/css-sizing-4/#propdef-frame-sizing",
+      "initial": "auto",
+      "appliesTo": "iframe elements",
+      "inherited": "no",
+      "percentages": "n/a",
+      "computedValue": "specified keyword",
+      "canonicalOrder": "per grammar",
+      "animationType": "discrete",
+      "styleDeclaration": [
+        "frame-sizing",
+        "frameSizing"
+      ],
+      "syntax": "auto | content-width | content-height | content-block-size | content-inline-size",
+      "extended": []
+    },
     {
       "name": "gap",
       "href": "https://drafts.csswg.org/css-align-3/#propdef-gap",
@@ -10005,10 +10020,8 @@
         "justify-items",
         "justifyItems"
       ],
-      "syntax": "normal | stretch | <baseline-position> | <overflow-position>? [ <self-position> | left | right ] | legacy | legacy && [ left | right | center ] | anchor-center",
-      "extended": [
-        "https://drafts.csswg.org/css-anchor-position-1/#propdef-justify-items"
-      ]
+      "syntax": "normal | stretch | <baseline-position> | <overflow-position>? [ <self-position> | left | right ] | legacy | legacy && [ left | right | center ]",
+      "extended": []
     },
     {
       "name": "justify-self",
@@ -12608,7 +12621,7 @@
         "position-anchor",
         "positionAnchor"
       ],
-      "syntax": "normal | none | auto | <anchor-name>",
+      "syntax": "normal | none | auto | <anchor-name> | match-parent",
       "extended": []
     },
     {
@@ -12620,7 +12633,7 @@
       "percentages": "n/a",
       "computedValue": "the keyword none or a pair of keywords, see § 3.1.3 Computed Value and Serialization of <position-area>",
       "canonicalOrder": "per grammar",
-      "animationType": "TBD",
+      "animationType": "discrete",
       "styleDeclaration": [
         "position-area",
         "positionArea"
@@ -14836,7 +14849,7 @@
         "stroke-width",
         "strokeWidth"
       ],
-      "syntax": "[<length-percentage> | <number>]#",
+      "syntax": "[ <length-percentage> | <line-width> | <number> ]#",
       "extended": []
     },
     {
@@ -18711,6 +18724,12 @@
       "href": "https://drafts.csswg.org/css-speech-1/#typedef-voice-volume-decibel",
       "extended": []
     },
+    {
+      "name": "declaration",
+      "prose": "<declaration> here matches anything that would be successfully parsed by consume a declaration, ignoring the context-validation check at the end of that algorithm. Notably, this includes a trailing !important, which is valid but ignored for the purpose of @supports.",
+      "href": "https://drafts.csswg.org/css-conditional-5/#typedef-declaration",
+      "extended": []
+    },
     {
       "name": "declaration-list",
       "prose": "<declaration-list>: only declarations are allowed; at-rules and qualified rules are automatically invalid.",
@@ -19440,7 +19459,7 @@
     {
       "name": "light-dark-image",
       "href": "https://drafts.csswg.org/css-color-5/#typedef-light-dark-image",
-      "syntax": "light-dark(<image> | none, <image> | none)",
+      "syntax": "light-dark( [ <image> | none ] , [ <image> | none ] )",
       "extended": []
     },
     {
@@ -20377,7 +20396,7 @@
     {
       "name": "scope-boundaries",
       "href": "https://drafts.csswg.org/css-cascade-6/#typedef-scope-boundaries",
-      "syntax": "[ ( <scope-start> ) ]? [ to ( <scope-end> ) ]?",
+      "syntax": "[ [ ( <scope-start> ) ]? [ to ( <scope-end> ) ]? ]!",
       "extended": []
     },
     {
@@ -20738,6 +20757,12 @@
       "syntax": "( [ <declaration> | <supports-condition-name> ] )",
       "extended": []
     },
+    {
+      "name": "supports-env-fn",
+      "href": "https://drafts.csswg.org/css-conditional-5/#typedef-supports-env-fn",
+      "syntax": "env( <ident> )",
+      "extended": []
+    },
     {
       "name": "supports-feature",
       "href": "https://drafts.csswg.org/css-conditional-5/#typedef-supports-feature",
@@ -20842,7 +20867,7 @@
     },
     {
       "name": "system-color",
-      "prose": "However, in forced colors mode, most colors on the page are forced into a restricted, user-chosen palette. The <system-color> keywords expose these user-chosen colors so that the rest of the page can integrate with this restricted palette.",
+      "prose": "However, in forced colors mode, most colors on the page are forced into a restricted, user-chosen palette, see CSS Color Adjustment 1 § 5.2 Forced Colors Mode Color Palettes. The <system-color> keywords expose these user-chosen colors so that the rest of the page can integrate with this restricted palette.",
       "href": "https://drafts.csswg.org/css-color-4/#typedef-system-color",
       "syntax": "AccentColor | AccentColorText | ActiveText | ButtonBorder | ButtonFace | ButtonText | Canvas | CanvasText | Field | FieldText | GrayText | Highlight | HighlightText | LinkText | Mark | MarkText | SelectedItem | SelectedItemText | VisitedText | <deprecated-color>",
       "extended": []

package/package.json

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