es-check 9.0.0-0 → 9.0.0

package/README.md

@@ -20,9 +20,9 @@ Ensuring that JavaScript files can pass ES Check is important in a [modular and
 
 ---
 
-## Version 9 (beta) 🎉
+## Version 9 🎉
 
-**ES Check** version 9 is a major release update that can enforce actual ES version specific features checks, implements intitial browserslist integration, basic (naive) polyfill detection, and supports an allowlist. To enable ecmaVersion specific checks, pass the `--checkFeatures` flag. To enable browserslist integration, pass the `--checkBrowser` flag. To enable polyfill detection, pass the `--checkForPolyfills` flag. There is also more config file support. Besides this, there are other feature updates based on user feedback. This version should not break any existing scripts. Please report any issues!
+**ES Check** version 9 is a major release update that can enforce more ES version specific features checks, implements initial browserslist integration, basic (naive) polyfill detection, and supports an allowlist. To enable ecmaVersion specific checks, pass the `--checkFeatures` flag. To enable browserslist integration, pass the `--checkBrowser` flag. To enable polyfill detection, pass the `--checkForPolyfills` flag. There is also more config file support. Besides this, there are other feature updates based on user feedback. This version should not break any existing scripts but, as significant changes/features have been added and it's know that es-check supports protecting against breaking errors going to production, a major version bump feels appropriate. Please report any issues!
 
 ```sh
 es-check es6 './dist/**/*.js' --checkFeatures
@@ -141,6 +141,7 @@ Here's a comprehensive list of all available options:
 | `--ignoreFile <path>` | Path to JSON file containing features to ignore |
 | `--allowList <features>` | Comma-separated list of features to allow even in lower ES versions, e.g., "const,let" |
 | `--checkBrowser` | Use browserslist configuration to determine ES version (default: false) |
+| `--browserslistQuery <query>` | Custom browserslist query (e.g., "last 2 versions") |
 | `--browserslistPath <path>` | Path to custom browserslist configuration (default: uses standard browserslist config resolution) |
 | `--browserslistEnv <env>` | Browserslist environment to use (default: production) |
 | `--config <path>` | Path to custom .escheckrc config file |
@@ -198,6 +199,16 @@ es-check es2022 './dist/**/*.js' --checkFeatures --checkForPolyfills
 es-check --config=./configs/production.escheckrc.json
 ```
 
+**Using a custom browserslist query:**
+```sh
+es-check --checkBrowser --browserslistQuery="last 2 versions" ./dist/**/*.js
+```
+
+**Using browserslist with custom query and feature checking:**
+```sh
+es-check --checkBrowser --browserslistQuery=">0.5%, not dead" --checkFeatures ./dist/**/*.js
+```
+
 ---
 
 ## Usage
@@ -235,6 +246,7 @@ Here's an example of what an `.escheckrc` file will look like:
   "ignore": ["ErrorCause", "TopLevelAwait"],
   "allowList": ["ArrayToSorted", "ObjectHasOwn"],
   "checkBrowser": false,
+  "browserslistQuery": "last 2 versions",
   "browserslistPath": "./config/.browserslistrc",
   "browserslistEnv": "production"
 }
@@ -255,6 +267,7 @@ Here's an example of what an `.escheckrc` file will look like:
 | `ignore` | Array | Features to ignore when checking |
 | `allowList` | Array | Features to allow even in lower ES versions |
 | `checkBrowser` | Boolean | Whether to use browserslist configuration to determine ES version |
+| `browserslistQuery` | String | Custom browserslist query to use |
 | `browserslistPath` | String | Path to custom browserslist configuration |
 | `browserslistEnv` | String | Browserslist environment to use |
 

package/browserslist.js

@@ -117,16 +117,17 @@ function getESVersionForBrowser(browser, version) {
 /**
  * Determines the minimum ES version required to support all browsers in the browserslist
  * @param {Object} options - Options object
+ * @param {string} [options.browserslistQuery]
  * @param {string} [options.browserslistPath] - Optional custom path to browserslist config
  * @param {string} [options.browserslistEnv] - Optional browserslist environment to use
  * @returns {number} - The ES version to use (e.g., 5, 6, etc.)
  */
 function getESVersionFromBrowserslist(options = {}) {
-  const { browserslistPath, browserslistEnv } = options;
+  const { browserslistPath, browserslistEnv, browserslistQuery } = options;
 
   try {
     // Get the browserslist configuration
-    const browsers = browserslist(null, {
+    const browsers = browserslist(browserslistQuery ?? null, {
       path: browserslistPath,
       env: browserslistEnv
     });

package/constants.js

@@ -143,6 +143,24 @@ const ES_FEATURES = {
       callee: 'Promise',
     },
   },
+  PromiseResolve: {
+    minVersion: 6,
+    example: 'Promise.resolve(value)',
+    astInfo: {
+      nodeType: 'CallExpression',
+      object: 'Promise',
+      property: 'resolve',
+    },
+  },
+  PromiseReject: {
+    minVersion: 6,
+    example: 'Promise.reject(value)',
+    astInfo: {
+      nodeType: 'CallExpression',
+      object: 'Promise',
+      property: 'reject',
+    },
+  },
   Symbol: {
     minVersion: 6,
     example: 'Symbol("desc")',

package/index.js

@@ -51,6 +51,7 @@ program
   .option('--ignoreFile <path>', 'path to JSON file containing features to ignore')
   .option('--allowList <features>', 'comma-separated list of features to allow even in lower ES versions, e.g., "const,let"')
   .option('--checkBrowser', 'use browserslist configuration to determine ES version')
+  .option('--browserslistQuery <query>', 'browserslist query')
   .option('--browserslistPath <path>', 'path to custom browserslist configuration')
   .option('--browserslistEnv <env>', 'browserslist environment to use')
   .option('--config <path>', 'path to custom .escheckrc config file')
@@ -140,6 +141,7 @@ program
         ignoreFile: options.ignoreFile || options['ignore-file'],
         allowList: options.allowList,
         checkBrowser: options.checkBrowser,
+        browserslistQuery: options.browserslistQuery,
         browserslistPath: options.browserslistPath,
         browserslistEnv: options.browserslistEnv
       };
@@ -217,6 +219,7 @@ async function runChecks(configs, logger) {
       try {
         const { getESVersionFromBrowserslist } = require('./browserslist');
         const esVersionFromBrowserslist = getESVersionFromBrowserslist({
+          browserslistQuery: config.browserslistQuery,
           browserslistPath: config.browserslistPath,
           browserslistEnv: config.browserslistEnv
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-check",
-  "version": "9.0.0-0",
+  "version": "9.0.0",
   "description": "Checks the ECMAScript version of .js glob against a specified version of ECMAScript with a shell command",
   "main": "index.js",
   "license": "MIT",
@@ -23,7 +23,7 @@
     "pre-commit": "pnpm lint && pnpm test",
     "prepare": "husky",
     "prepublishOnly": "pnpm test",
-    "release": "release-it",
+    "release": "release-it --no-git.requireUpstream",
     "report:coverage": "nyc report --reporter=lcov > coverage.lcov && codecov",
     "setup": "pnpm install --reporter=silent",
     "test": "nyc mocha test.js utils.test.js browserslist.test.js polyfill.test.js --timeout 10s",
@@ -103,10 +103,27 @@
   },
   "release-it": {
     "git": {
-      "commitMessage": "chore: release v${version}"
+      "commitMessage": "chore: release v${version}",
+      "requireBranch": "main",
+      "requireCleanWorkingDir": true
     },
     "github": {
-      "release": true
+      "release": true,
+      "web": true
+    },
+    "npm": {
+      "publishConfig": {
+        "registry": "https://registry.npmjs.org/",
+        "access": "public"
+      }
+    },
+    "hooks": {
+      "before:init": [
+        "pnpm run lint",
+        "pnpm test"
+      ],
+      "after:release": "echo Successfully released ${name} v${version} to ${repo.repository}."
     }
-  }
+  },
+  "packageManager": "pnpm@10.6.5+sha512.cdf928fca20832cd59ec53826492b7dc25dc524d4370b6b4adbf65803d32efaa6c1c88147c0ae4e8d579a6c9eec715757b50d4fa35eea179d868eada4ed043af"
 }

package/utils.js

@@ -141,6 +141,16 @@ const checkMap = {
     }
     return false;
   },
+  NewExpression: (node, astInfo) => {
+    if (!astInfo.callee) {
+      return false;
+    }
+    // e.g. node.callee.type === 'Identifier' && node.callee.name === 'Promise'
+    if (!node.callee || node.callee.type !== 'Identifier') {
+      return false;
+    }
+    return node.callee.name === astInfo.callee;
+  },
   default: () => false
 };