esm only (#1763)

Author: romainmenke

.github/bin/format-package-json.mjs

@@ -75,20 +75,22 @@ const formatted = {};
 	delete packageJSONInfo.private;
 
 	formatted.engines = {
-		node: '>=18',
+		node: '>=20.19.0',
 	};
 	delete packageJSONInfo.engines;
 
+	// json only package
+	if (formatted.name === '@csstools/css-syntax-patches-for-csstree') {
+		delete formatted.engines;
+	}
+
 	formatted.type = packageJSONInfo.type;
 	delete packageJSONInfo.type;
 }
 
 // Exports and packaged
 {
-	formatted.main = packageJSONInfo.main;
 	delete packageJSONInfo.main;
-
-	formatted.module = packageJSONInfo.module;
 	delete packageJSONInfo.module;
 
 	formatted.bin = packageJSONInfo.bin;
@@ -103,16 +105,8 @@ const formatted = {};
 	formatted.unpkg = packageJSONInfo.unpkg;
 	delete packageJSONInfo.unpkg;
 
-	if (packageJSONInfo.exports) {
-		formatted.exports = packageJSONInfo.exports;
-		if (packageJSONInfo.exports['.'] && packageJSONInfo.exports['.'].types) {
-			formatted.exports['.'] = {
-				types: packageJSONInfo.exports['.'].types,
-				...formatted.exports['.'],
-			};
-		}
-		delete packageJSONInfo.exports;
-	}
+	formatted.exports = packageJSONInfo.exports;
+	delete packageJSONInfo.exports;
 
 	formatted.files = packageJSONInfo.files;
 	delete packageJSONInfo.files;

.github/workflows/codeql.yml

@@ -4,6 +4,10 @@ on:
   schedule:
     - cron: '0 4 * * 1'
   workflow_dispatch:
+  push:
+    branches:
+    - 'main'
+  pull_request:
 
 defaults:
   run:
@@ -33,14 +37,5 @@ jobs:
         languages: ${{ matrix.language }}
         queries: security-extended
 
-    - name: setup node
-      uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f
-      with:
-        node-version: 24
-        cache: 'npm'
-
-    - run: npm ci --ignore-scripts
-    - run: npm run build --workspaces --if-present
-
     - name: Perform CodeQL Analysis
       uses: github/codeql-action/analyze@5d4e8d1aca955e8d8589aabd499c5cae939e33c7

.github/workflows/test.yml

@@ -23,7 +23,7 @@ jobs:
       # Enable annotations only for node 24 + ubuntu
       matrix:
         os: [ubuntu-latest]
-        node: [18, 20, 22, 24, 25]
+        node: [20, 22, 24, 25]
         include:
         - os: macos-latest
           node: 24

cli/csstools-cli/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changes to CSSTools CLI
 
+### Unreleased (major)
+
+- Updated: Support for Node `20.19.0` or later (major).
+- Removed: `commonjs` API. In supported Node versions `require(esm)` will work without needing to make code changes.
+
 ### 4.0.25
 
 _January 10, 2026_

cli/csstools-cli/package.json

@@ -25,12 +25,11 @@
 		}
 	],
 	"engines": {
-		"node": ">=18"
+		"node": ">=20.19.0"
 	},
 	"bin": {
 		"csstools-cli": "dist/cli.cjs"
 	},
-	"types": "dist/cli.d.ts",
 	"files": [
 		"CHANGELOG.md",
 		"LICENSE.md",

e2e/package-lock.json

@@ -1,5 +1,15 @@
 import assert from 'node:assert';
 import plugin from 'postcss-preset-env';
-plugin({ preserve: true });
+plugin({
+    preserve: true,
+    features: {
+        'all-property': [true, { preserve: true }],
+        'any-link-pseudo-class': [false, { preserve: true }],
+        'cascade-layers': ['auto', { onImportLayerRule: 'warn' }],
+        'color-function': { preserve: true, enableProgressiveCustomProperties: false },
+        'color-mix': false,
+        'light-dark-function': true,
+    },
+});
 assert.ok(plugin.postcss, 'should have "postcss flag"');
 assert.equal(typeof plugin, 'function', 'should return a function');

e2e/typescript/esm--node-next/dist/index.js

@@ -1,5 +1,5 @@
 const postcss = require('postcss');
-const postcssPresetEnv = require('postcss-preset-env');
+const postcssPresetEnv = require('postcss-preset-env').default;
 
 try {
 	postcss([postcssPresetEnv({

e2e/webpack/bundle-through/index.cjs

@@ -34,7 +34,7 @@ export default [
 			globals: {
 				...globals.node,
 			},
-			ecmaVersion: 2022,
+			ecmaVersion: 2025,
 			sourceType: 'module',
 		},
 
@@ -71,7 +71,7 @@ export default [
 			globals: {
 				...globals.browser,
 			},
-			ecmaVersion: 2022,
+			ecmaVersion: 2025,
 			sourceType: 'module',
 		},
 

eslint.config.mjs

@@ -1,5 +1,10 @@
 # Changes to CSS Has Pseudo
 
+### Unreleased (major)
+
+- Updated: Support for Node `20.19.0` or later (major).
+- Removed: `commonjs` API. In supported Node versions `require(esm)` will work without needing to make code changes.
+
 ### 1.0.0
 
 _August 3, 2024_