From 143ef780e34e013030cea71c3e9676089bfe10ba Mon Sep 17 00:00:00 2001 From: Francois Daoust Date: Fri, 17 Oct 2025 16:04:48 +0200 Subject: [PATCH 1/2] Bump major version of CSS package - v8.0.0 Latest Reffy release introduces a "breaking" change with the flattening of at-rules. The change should be more theoretically breaking than practically breaking in practice. --- packages/css/CHANGELOG.md | 11 +++++++++++ packages/css/README.md | 1 + packages/css/package.json | 2 +- 3 files changed, 13 insertions(+), 1 deletion(-) diff --git a/packages/css/CHANGELOG.md b/packages/css/CHANGELOG.md index a3ff42f596b6..b573ae005d63 100644 --- a/packages/css/CHANGELOG.md +++ b/packages/css/CHANGELOG.md @@ -7,6 +7,17 @@ Webref adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html), applied to data. A new major version is released whenever a breaking change is made to the data structure. +## v8.0.0 - 2025-10-17 + +### Breaking change + +Subsidiary at-rules are now reported at the root level, scoped to their parent at-rule through a `for` property. + +### How to upgrade + +Unless you're processing at-rules and only expecting unscoped ones, upgrade from version 7 should not require any code update. If you're willing to list unscoped at-rules, filter out those that have a `for` property. + + ## v7.0.11 - 2025-09-04 CSS extracts are now consolidated into a single file. diff --git a/packages/css/README.md b/packages/css/README.md index 3f1178323976..ea926fcb7265 100644 --- a/packages/css/README.md +++ b/packages/css/README.md @@ -51,6 +51,7 @@ const ast = definitionSyntax.parse(properties['flex'].syntax); Additional keys may be set depending on the type of the CSS feature. For example: - At-rules have a `descriptors` key that contains the list of descriptors defined for the given at-rule. That list may not be exhaustive. For example, it does not contain descriptors that are only implicitly defined in specs, such as families of properties that some at-rules (e.g, `@position-try`) accept as descriptors. +- At-rule that are scoped to another at-rules have a `for` key that contains the list of scoping at-rules. - Functions and types that are scoped to a property or other feature have a `for` key that contains the list of scoping features for that feature. A scoping feature may be a property, a function or a type. When the scoping feature is a type, its name in the `for` key is enclosed between `<` and `>`. - Properties have a `styleDeclaration` key that contains the list of IDL attribute names that the property generates. A number of other keys may be set to describe the property's initial value, animation type and other parameters. diff --git a/packages/css/package.json b/packages/css/package.json index d45343cfc9c0..aeced2a1b502 100644 --- a/packages/css/package.json +++ b/packages/css/package.json @@ -1,7 +1,7 @@ { "name": "@webref/css", "description": "CSS definitions of the web platform", - "version": "7.1.5", + "version": "8.0.0", "repository": { "type": "git", "url": "https://github.com/w3c/webref.git" From be1e3e2db7d73e3e74b754a862999c2676087f72 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fran=C3=A7ois=20Daoust?= Date: Mon, 20 Oct 2025 11:11:28 +0200 Subject: [PATCH 2/2] Update packages/css/CHANGELOG.md Co-authored-by: Dominique Hazael-Massieux --- packages/css/CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/css/CHANGELOG.md b/packages/css/CHANGELOG.md index b573ae005d63..98ff749e189c 100644 --- a/packages/css/CHANGELOG.md +++ b/packages/css/CHANGELOG.md @@ -15,7 +15,7 @@ Subsidiary at-rules are now reported at the root level, scoped to their parent a ### How to upgrade -Unless you're processing at-rules and only expecting unscoped ones, upgrade from version 7 should not require any code update. If you're willing to list unscoped at-rules, filter out those that have a `for` property. +Unless you're processing at-rules and only expecting unscoped ones, upgrade from version 7 should not require any code update. If you need to list only unscoped at-rules, filter out those that have a `for` property. ## v7.0.11 - 2025-09-04