csstree · Mar 3, 2025 · Mar 10, 2025 · Mar 12, 2025 · Mar 12, 2025 · Mar 12, 2025
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -5,16 +5,16 @@ on:
     pull_request:
 
 env:
-    PRIMARY_NODEJS_VERSION: 18
+    PRIMARY_NODEJS_VERSION: 20
 
 jobs:
     lint:
         name: Lint
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v2
+            - uses: actions/checkout@v4
             - name: Setup node ${{ env.PRIMARY_NODEJS_VERSION }}
-              uses: actions/setup-node@v2
+              uses: actions/setup-node@v4
               with:
                 node-version: ${{ env.PRIMARY_NODEJS_VERSION }}
                 cache: "npm"
@@ -28,9 +28,9 @@ jobs:
             matrix:
                 os: [ubuntu-latest, windows-latest]
         steps:
-            - uses: actions/checkout@v2
+            - uses: actions/checkout@v4
             - name: Setup node ${{ env.PRIMARY_NODEJS_VERSION }}
-              uses: actions/setup-node@v2
+              uses: actions/setup-node@v4
               with:
                 node-version: ${{ env.PRIMARY_NODEJS_VERSION }}
                 cache: "npm"
@@ -60,9 +60,9 @@ jobs:
                       node: 22
 
         steps:
-            - uses: actions/checkout@v2
+            - uses: actions/checkout@v4
             - name: Setup node ${{ matrix.node_version }}
-              uses: actions/setup-node@v2
+              uses: actions/setup-node@v4
               with:
                 node-version: ${{ matrix.node_version }}
                 cache: "npm"
@@ -80,6 +80,20 @@ jobs:
                 flag-name: node-${{ matrix.node_version }}
                 parallel: true
 
+    test_types:
+        name: Test Types
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+            - name: Setup Node.js
+              uses: actions/setup-node@v4
+              with:
+                  node-version: "lts/*"
+            - name: Install dependencies
+              run: npm install
+            - name: Check Types
+              run: npm run test:types
+
     send-to-coveralls:
         name: Send coverage to Coveralls
         needs: unit-tests

diff --git a/.github/workflows/release-please.yml b/.github/workflows/release-please.yml
@@ -0,0 +1,53 @@
+on:
+    push:
+        branches:
+            - main
+name: release-please
+jobs:
+    release-please:
+        runs-on: ubuntu-latest
+        permissions:
+            contents: write
+            pull-requests: write
+            id-token: write
+            models: read
+        steps:
+            - uses: googleapis/release-please-action@v4
+              id: release
+            - uses: actions/checkout@v4
+              if: ${{ steps.release.outputs.release_created }}
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: lts/*
+                  registry-url: https://registry.npmjs.org
+              if: ${{ steps.release.outputs.release_created }}
+
+            - name: Publish to npm
+              run: |
+                  npm install
+                  npm run build --if-present
+                  npm publish --provenance
+              env:
+                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+              if: ${{ steps.release.outputs.release_created }}
+
+            # Generates the social media post
+            - run: npx @humanwhocodes/social-changelog --org ${{ github.repository_owner }} --repo ${{ github.event.repository.name }} --name 'eslint/css-tree' --tag ${{ steps.release.outputs.tag_name }} > social-post.txt
+              if: ${{ steps.release.outputs.release_created }}
+              env:
+                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+            - name: Post release announcement
+              run: npx @humanwhocodes/crosspost -t -b -m --discord-webhook --file social-post.txt
+              if: ${{ steps.release.outputs.release_created }}
+              env:
+                  TWITTER_API_CONSUMER_KEY: ${{ secrets.TWITTER_CONSUMER_KEY }}
+                  TWITTER_API_CONSUMER_SECRET: ${{ secrets.TWITTER_CONSUMER_SECRET }}
+                  TWITTER_ACCESS_TOKEN_KEY: ${{ secrets.TWITTER_ACCESS_TOKEN_KEY }}
+                  TWITTER_ACCESS_TOKEN_SECRET: ${{ secrets.TWITTER_ACCESS_TOKEN_SECRET }}
+                  MASTODON_ACCESS_TOKEN: ${{ secrets.MASTODON_ACCESS_TOKEN }}
+                  MASTODON_HOST: ${{ secrets.MASTODON_HOST }}
+                  BLUESKY_IDENTIFIER: ${{ vars.BLUESKY_IDENTIFIER }}
+                  BLUESKY_PASSWORD: ${{ secrets.BLUESKY_PASSWORD }}
+                  BLUESKY_HOST: ${{ vars.BLUESKY_HOST }}
+                  DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -0,0 +1,3 @@
+{
+  ".": "3.6.1"
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,4 +1,135 @@
-## next
+# Changelog
+
+## [3.6.1](https://github.com/eslint/csstree/compare/css-tree-v3.6.0...css-tree-v3.6.1) (2025-06-09)
+
+
+### Bug Fixes
+
+* ParserContext to have all methods ([e069f6f](https://github.com/eslint/csstree/commit/e069f6f50e64bb1728208e845498561fa5afe287))
+* ParserContext type to have all methods ([#57](https://github.com/eslint/csstree/issues/57)) ([e069f6f](https://github.com/eslint/csstree/commit/e069f6f50e64bb1728208e845498561fa5afe287))
+* Types for node generate() function ([#56](https://github.com/eslint/csstree/issues/56)) ([846120b](https://github.com/eslint/csstree/commit/846120b5a0e64b6e7b8105ddef904a07b93e5c8b))
+
+## [3.6.0](https://github.com/eslint/csstree/compare/css-tree-v3.5.4...css-tree-v3.6.0) (2025-06-05)
+
+
+### Features
+
+* Add support for math functions ([#53](https://github.com/eslint/csstree/issues/53)) ([b7c4915](https://github.com/eslint/csstree/commit/b7c491587de974630bcde75034e3cb55a2edbeca))
+* Parse nested element selector ([#51](https://github.com/eslint/csstree/issues/51)) ([ed3ae55](https://github.com/eslint/csstree/commit/ed3ae5503e0d92facaf8d0a81d60b2e35af6c891))
+
+
+### Bug Fixes
+
+* isDelim() type ([#55](https://github.com/eslint/csstree/issues/55)) ([9605092](https://github.com/eslint/csstree/commit/9605092a76cd7620ad49f1747d6086dd9021fd5a))
+* Update MDN data and patch ([#54](https://github.com/eslint/csstree/issues/54)) ([8a707a7](https://github.com/eslint/csstree/commit/8a707a7519ea50f64a68cd77bff1dac678e59326))
+
+## [3.5.4](https://github.com/eslint/csstree/compare/css-tree-v3.5.3...css-tree-v3.5.4) (2025-05-28)
+
+
+### Bug Fixes
+
+* Types for atrule parsing ([#49](https://github.com/eslint/csstree/issues/49)) ([7194e95](https://github.com/eslint/csstree/commit/7194e958521ffb43cd25ba82645a9ba0f3ec875b))
+
+## [3.5.3](https://github.com/eslint/csstree/compare/css-tree-v3.5.2...css-tree-v3.5.3) (2025-05-23)
+
+
+### Bug Fixes
+
+* Types for custom nodes and scopes ([#47](https://github.com/eslint/csstree/issues/47)) ([3a663e1](https://github.com/eslint/csstree/commit/3a663e1e94a65b1bc2da4b2cdb052700988efcc4))
+
+## [3.5.2](https://github.com/eslint/csstree/compare/css-tree-v3.5.1...css-tree-v3.5.2) (2025-05-15)
+
+
+### Bug Fixes
+
+* Types for default-syntax-data and nodes ([#44](https://github.com/eslint/csstree/issues/44)) ([2edbf80](https://github.com/eslint/csstree/commit/2edbf80347b08999197e2dc696aebf1bdcf61b8c))
+
+## [3.5.1](https://github.com/eslint/csstree/compare/css-tree-v3.5.0...css-tree-v3.5.1) (2025-05-08)
+
+
+### Bug Fixes
+
+* Add missing &lt;parenthesis-block&gt; type ([#42](https://github.com/eslint/csstree/issues/42)) ([1695a47](https://github.com/eslint/csstree/commit/1695a4743bd452438612ab04d7738dc703eb1263))
+* Types for NodeSyntaxConfig ([#41](https://github.com/eslint/csstree/issues/41)) ([d7dc09d](https://github.com/eslint/csstree/commit/d7dc09d3d2fda0e34e3573a2c009ee48da8c89ec))
+
+## [3.5.0](https://github.com/eslint/csstree/compare/css-tree-v3.4.0...css-tree-v3.5.0) (2025-04-22)
+
+
+### Features
+
+* Add support for most CSS nesting rules ([#37](https://github.com/eslint/csstree/issues/37)) ([9d6b65f](https://github.com/eslint/csstree/commit/9d6b65fd1d6d975f188de27d41df83a82c4d7cc2))
+* Nested selector support ([9d6b65f](https://github.com/eslint/csstree/commit/9d6b65fd1d6d975f188de27d41df83a82c4d7cc2))
+
+## [3.4.0](https://github.com/eslint/csstree/compare/css-tree-v3.3.4...css-tree-v3.4.0) (2025-04-16)
+
+
+### Features
+
+* Customize tokenize function via the fork API ([#36](https://github.com/eslint/csstree/issues/36)) ([e62301c](https://github.com/eslint/csstree/commit/e62301cdb67dc7813870712e7302c5d1e00af968))
+
+
+### Bug Fixes
+
+* Types for Node definitions ([#34](https://github.com/eslint/csstree/issues/34)) ([e553a25](https://github.com/eslint/csstree/commit/e553a25b9ea0562ef75b46583e9375ef307a8318))
+
+## [3.3.4](https://github.com/eslint/csstree/compare/css-tree-v3.3.3...css-tree-v3.3.4) (2025-04-09)
+
+
+### Bug Fixes
+
+* Remove outdated `anchor()` & `anchor-size()` descriptor patch ([afd673a](https://github.com/eslint/csstree/commit/afd673ad211653084b3d44935c42b972b911de12))
+* Remove outdated `anchor()` & `anchor-size()` function patch ([#29](https://github.com/eslint/csstree/issues/29)) ([afd673a](https://github.com/eslint/csstree/commit/afd673ad211653084b3d44935c42b972b911de12))
+* Update mdn-data and patch ([#32](https://github.com/eslint/csstree/issues/32)) ([20b412f](https://github.com/eslint/csstree/commit/20b412f1692bd98dcadd732d62c4799882bced73))
+
+## [3.3.3](https://github.com/eslint/csstree/compare/css-tree-v3.3.2...css-tree-v3.3.3) (2025-04-04)
+
+
+### Bug Fixes
+
+* Add patch for &lt;cubic-bezier-easing-function&gt; ([#28](https://github.com/eslint/csstree/issues/28)) ([c4d6c44](https://github.com/eslint/csstree/commit/c4d6c44931114edfbbacf1de8b26288d15cf9e48)), closes [#27](https://github.com/eslint/csstree/issues/27)
+* Remove `src` descriptor patch ([#23](https://github.com/eslint/csstree/issues/23)) ([e3d17f0](https://github.com/eslint/csstree/commit/e3d17f0fc4e1c29df8d80985fbc8a7f9d8c78e2b))
+* Remove `unicode-range` descriptor patch ([#25](https://github.com/eslint/csstree/issues/25)) ([2048240](https://github.com/eslint/csstree/commit/2048240bd3811a7fb4f7bbbc18c73e7064196e4e))
+* Remove outdated `@font-face/unicode-range` descriptor patch ([#26](https://github.com/eslint/csstree/issues/26)) ([1ea54f7](https://github.com/eslint/csstree/commit/1ea54f7f6c1477c5a9cbae3a233061c85e336f8f))
+* Remove wrong `scroll-timeline` property patch ([#22](https://github.com/eslint/csstree/issues/22)) ([b142b20](https://github.com/eslint/csstree/commit/b142b205c0d2d73c5ef27799a35ade92dc271ef7))
+* Remove wrong scroll-timeline property patch ([b142b20](https://github.com/eslint/csstree/commit/b142b205c0d2d73c5ef27799a35ade92dc271ef7))
+
+## [3.3.2](https://github.com/eslint/csstree/compare/css-tree-v3.3.1...css-tree-v3.3.2) (2025-03-29)
+
+
+### Bug Fixes
+
+* Add missing node types and update other types ([#18](https://github.com/eslint/csstree/issues/18)) ([37a6dd4](https://github.com/eslint/csstree/commit/37a6dd47ca30b626852f6cb61b5f7a4744da2e71))
+
+## [3.3.1](https://github.com/eslint/csstree/compare/css-tree-v3.3.0...css-tree-v3.3.1) (2025-03-20)
+
+
+### Bug Fixes
+
+* SyntaxParseError type ([#15](https://github.com/eslint/csstree/issues/15)) ([d95706e](https://github.com/eslint/csstree/commit/d95706e95b2ef8cbfd27211a753adf73381c643f))
+
+## [3.3.0](https://github.com/eslint/csstree/compare/css-tree-v3.2.0...css-tree-v3.3.0) (2025-03-18)
+
+
+### Features
+
+* add support for typed custom properties ([0e9d141](https://github.com/eslint/csstree/commit/0e9d14129a108f79bc4c772ee0cc4f1812070215))
+* Add support for typed custom properties ([#11](https://github.com/eslint/csstree/issues/11)) ([0e9d141](https://github.com/eslint/csstree/commit/0e9d14129a108f79bc4c772ee0cc4f1812070215))
+* passthrough env in lexer syntax matching ([c0e22c0](https://github.com/eslint/csstree/commit/c0e22c0e7c042a60764a51a519b53f18a8ceae62))
+* passthrough env() in lexer syntax matching ([#12](https://github.com/eslint/csstree/issues/12)) ([c0e22c0](https://github.com/eslint/csstree/commit/c0e22c0e7c042a60764a51a519b53f18a8ceae62))
+
+
+### Bug Fixes
+
+* Add parse.SyntaxError and parse.config types ([#14](https://github.com/eslint/csstree/issues/14)) ([d201786](https://github.com/eslint/csstree/commit/d20178613d5b4d6bf6dce36f94cbb04b0eddfe59))
+* Add types for onToken callback ([#9](https://github.com/eslint/csstree/issues/9)) ([b403ffb](https://github.com/eslint/csstree/commit/b403ffb6085d5e8c481f62026d88eebd632a3cb5))
+
+## [3.2.0](https://github.com/eslint/csstree/compare/css-tree-v3.1.0...css-tree-v3.2.0) (2025-03-12)
+
+
+### Features
+
+* Add type definitions ([#4](https://github.com/eslint/csstree/issues/4)) ([e407bae](https://github.com/eslint/csstree/commit/e407bae294cdec1f987fac94b75b7ca7f749c229))
+* Rename to @eslint/css-tree ([#1](https://github.com/eslint/csstree/issues/1)) ([6f20a43](https://github.com/eslint/csstree/commit/6f20a4328e323cc0d40dd9407908171a54fac0c0))
 
 - Added `onToken` option to the `parse()` method, which can be either an array or a function:
     - When the value is an array, it is populated with objects `{ type, start, end }` (token type, and its start and end offsets).
@@ -26,12 +157,17 @@
     - `getBlockTokenPairIndex(tokenIndex)` – returns the index of the pair token for a block, or `-1` if no pair exists
 - Fixed `fork()` to extend `node` definitions instead of overriding them. For example, `fork({ node: { Dimension: { generate() { /* ... */ } } } })` will now update only the `generate()` method on the `Dimension` node, while inheriting all other properties from the previous syntax definition.
 
+
+### Bug Fixes
+
+* Update CSS syntax ([#8](https://github.com/eslint/csstree/issues/8)) ([ff07c1e](https://github.com/eslint/csstree/commit/ff07c1e8ce1989f1c94cbb9ae44e3c8feee1de9e))
+
 ## 3.1.0 (December 6, 2024)
 
 - Added support for [boolean expression multiplier](https://drafts.csswg.org/css-values-5/#boolean) in syntax definition, i.e. `<boolean-expr[ test ]>` (#304)
 - Added `source`, `startOffset`, `startLine`, and `startColumn` parameters to `OffsetToLocation` constructor, eliminating the need to call `setSource()` after creating a new `OffsetToLocation` instance
 - Exposed `OffsetToLocation` class in the main entry point, which was previously accessible only via `css-tree/tokenizer`
-- Fixed `Raw` node value consumption by ignoring stop tokens inside blocks, resolving an issue where `Raw` value consumption stopped prematurely. This fix also enables parsing of functions whose content includes stop characters (e.g., semicolons and curly braces) within declaration values, aligning with the latest draft of CSS Values and Units Module Level 5.  
+- Fixed `Raw` node value consumption by ignoring stop tokens inside blocks, resolving an issue where `Raw` value consumption stopped prematurely. This fix also enables parsing of functions whose content includes stop characters (e.g., semicolons and curly braces) within declaration values, aligning with the latest draft of CSS Values and Units Module Level 5.
 - Fixed `TokenStream#balance` computation to handle unmatched brackets correctly. Previously, when encountering a closing bracket, the `TokenStream` would prioritize it over unmatched opening brackets, leading to improper parsing. For example, the parser would incorrectly consume the declaration value of `.a { prop: ([{); }` as `([{)` instead of consuming it until all opened brackets were closed (`([{); }`). Now, unmatched closing brackets are discarded unless they match the most recent opening bracket on the stack. This change aligns CSSTree with CSS specifications and browser behavior.
 - Fixed syntax definition parser to allow a token to be followed by a multiplier (#303)
 - Fixed location for `Layer` node (#310)

diff --git a/LICENSE b/LICENSE
@@ -1,4 +1,5 @@
 Copyright (C) 2016-2024 by Roman Dvornov
+Copyright OpenJS Foundation and other contributors, <www.openjsf.org>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal