css-syntax-patches-for-csstree (#1466)

Author: romainmenke

.github/labeler.yml

@@ -2,16 +2,22 @@
   - changed-files:
     - any-glob-to-any-file:
       - .github/**
+      - base-cli
       - packages/base-cli/**
       - packages/cascade-layer-name-parser/**
       - packages/color-helpers/**
       - packages/css-calc/**
       - packages/css-color-parser/**
       - packages/css-parser-algorithms/**
+      - packages/css-syntax-patches-for-csstree/**
       - packages/css-tokenizer/**
+      - packages/generate-test-cases/**
       - packages/media-query-list-parser/**
+      - packages/pack-test/**
       - packages/postcss-tape/**
+      - packages/selector-resolve-nested/**
       - packages/selector-specificity/**
+      - packages/utilities/**
       - plugins/postcss-base-plugin/**
       - plugins/postcss-debug-logger/**
       - rollup/**

package-lock.json

@@ -0,0 +1,5 @@
+# Changes to CSS Syntax Patches For CSSTree
+
+### Unreleased (patch)
+
+- initial version 

packages/css-syntax-patches-for-csstree/CHANGELOG.md

@@ -0,0 +1,18 @@
+MIT No Attribution (MIT-0)
+
+Copyright © CSSTools Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the “Software”), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/css-syntax-patches-for-csstree/LICENSE.md

@@ -0,0 +1,36 @@
+# CSS Syntax Patches For CSSTree
+
+[<img alt="npm version" src="https://img.shields.io/npm/v/@csstools/css-syntax-patches-for-csstree.svg" height="20">][npm-url]
+[<img alt="Build Status" src="https://github.com/csstools/postcss-plugins/workflows/test/badge.svg" height="20">][cli-url]
+
+Path [csstree](https://github.com/csstree/csstree) syntax definitions with the latest data from CSS specifications.  
+
+## Usage
+
+```bash
+npm install @csstools/css-syntax-patches-for-csstree --save-dev
+```
+
+```js
+import { fork } from 'css-tree-3.0.0';
+import syntax_patches from '@csstools/css-syntax-patches-for-csstree' with { type: 'json' };
+
+const forkedLexer = fork({
+	atrules: syntax_patches.next.atrules,
+	properties: syntax_patches.next.properties,
+	types: syntax_patches.next.types,
+}).lexer;
+```
+
+## `next`
+
+CSS specifications are often still in flux and various parts might change or disappear altogether.  
+Specifications also contains parts that haven't been implemented yet in a browser.  
+Only CSS that is widely adopted can be expected to be stable.
+
+The `next` grouping contains a combination of what is currently valid in browsers and the progress in various specifications.
+
+_In the future more groupings might be added._
+
+[cli-url]: https://github.com/csstools/postcss-plugins/actions/workflows/test.yml?query=workflow/test
+[npm-url]: https://www.npmjs.com/package/@csstools/css-syntax-patches-for-csstree

packages/css-syntax-patches-for-csstree/README.md

@@ -0,0 +1,66 @@
+{
+	"name": "@csstools/css-syntax-patches-for-csstree",
+	"description": "CSS syntax patches for CSS tree",
+	"version": "0.0.0",
+	"contributors": [
+		{
+			"name": "Antonio Laguna",
+			"email": "antonio@laguna.es",
+			"url": "https://antonio.laguna.es"
+		},
+		{
+			"name": "Romain Menke",
+			"email": "romainmenke@gmail.com"
+		}
+	],
+	"license": "MIT-0",
+	"funding": [
+		{
+			"type": "github",
+			"url": "https://github.com/sponsors/csstools"
+		},
+		{
+			"type": "opencollective",
+			"url": "https://opencollective.com/csstools"
+		}
+	],
+	"engines": {
+		"node": ">=18"
+	},
+	"main": "dist/index.json",
+	"files": [
+		"CHANGELOG.md",
+		"LICENSE.md",
+		"README.md",
+		"dist"
+	],
+	"peerDependencies": {
+		"postcss": "^8.4"
+	},
+	"devDependencies": {
+		"@webref/css": "^6.15.2",
+		"css-tree": "^2.3.1",
+		"css-tree-3.0.0": "npm:css-tree@~3.0.0"
+	},
+	"scripts": {
+		"build": "node ./scripts/index.mjs",
+		"lint": "node ../../.github/bin/format-package-json.mjs",
+		"prepublishOnly": "npm run build && npm run test",
+		"test": "node --test"
+	},
+	"homepage": "https://github.com/csstools/postcss-plugins/tree/main/packages/css-syntax-patches-for-csstree#readme",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/csstools/postcss-plugins.git",
+		"directory": "packages/css-syntax-patches-for-csstree"
+	},
+	"bugs": "https://github.com/csstools/postcss-plugins/issues",
+	"keywords": [
+		"css",
+		"csstree",
+		"syntax"
+	],
+	"volta": {
+		"extends": "../../package.json"
+	}
+}