es-check 9.1.3-1 → 9.1.4

package/README.md

@@ -248,6 +248,18 @@ es-check --checkBrowser --browserslistQuery="last 2 versions" ./dist/**/*.js
 es-check --checkBrowser --browserslistQuery=">0.5%, not dead" --checkFeatures ./dist/**/*.js
 ```
 
+**Using browserlist just like an es version**
+
+```sh
+es-check checkBrowser ./dist/**/*.js --browserslistQuery=">0.5%, not dead"
+```
+
+**Using browserlist with a pre-defined browserlist**
+
+```sh
+es-check checkBrowser ./dist/**/*.js
+```
+
 ---
 
 ## Usage
@@ -442,6 +454,9 @@ es-check --checkBrowser --browserslistQuery="last 2 versions" ./dist/**/*.js
 
 # Using 'checkBrowser' as the ES version argument
 es-check checkBrowser --browserslistQuery="last 2 versions" ./dist/**/*.js
+
+# Using a pre-defined browserslist configuration
+es-check checkBrowser ./dist/**/*.js
 ```
 
 This will read your browserslist configuration (from `.browserslistrc`, `package.json`, etc.) and determine the appropriate ES version based on your targeted browsers.
@@ -466,7 +481,7 @@ es-check --checkBrowser --browserslistEnv="production" ./dist/**/*.js
 es-check --checkBrowser --checkFeatures ./dist/**/*.js
 ```
 
-⚠️ **NOTE:** When using `--checkBrowser`, you must also provide a `--browserslistQuery` or have a valid browserslist configuration in your project.
+⚠️ **NOTE:** When using `--checkBrowser`, you must also provide a `--browserslistQuery` or have a valid browserslist configuration in your project. You cannot have a files directly after your `--checkBrowser` option; it will read as 
 
 ---
 

package/constants.js

@@ -574,6 +574,13 @@ const BROWSER_TO_ES_VERSION = {
   }
 };
 
+const JS_VERSIONS = [
+  'es3', 'es4', 'es5', 'es6', 'es2015',
+  'es7', 'es2016', 'es8', 'es2017', 'es9', 'es2018',
+  'es10', 'es2019', 'es11', 'es2020', 'es12', 'es2021',
+  'es13', 'es2022', 'es14', 'es2023', 'checkBrowser'
+];
+
 /**
  * Maps feature names from ES_FEATURES to their polyfill patterns
  * This helps us identify which features are being polyfilled
@@ -640,5 +647,6 @@ module.exports = {
   ES_FEATURES,
   NODE_TYPES,
   BROWSER_TO_ES_VERSION,
-  FEATURE_TO_POLYFILL_MAP
+  FEATURE_TO_POLYFILL_MAP,
+  JS_VERSIONS,
 };

package/index.js

@@ -10,6 +10,7 @@ const detectFeatures = require('./detectFeatures')
 let polyfillDetector = null;
 const pkg = require('./package.json')
 const { lilconfig } = require('lilconfig');
+const { JS_VERSIONS } = require('./constants');
 const { parseIgnoreList, createLogger, generateBashCompletion, generateZshCompletion } = require('./utils');
 
 program.configureOutput({
@@ -92,7 +93,7 @@ program
   .addOption(new Option('--ignore-file <path>', 'path to JSON file containing features to ignore').hideHelp())
   .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"')
-  .addOption(new Option('--checkBrowser', 'use browserslist configuration to determine ES version, use checkBrowser argument instead of ecmaVersion').hideHelp())
+  .addOption(new Option('--checkBrowser', 'use browserslist configuration to determine ES version, use checkBrowser argument instead of ecmaVersion', false).hideHelp())
   .option('--browserslistQuery <query>', 'browserslist query')
   .option('--browserslistPath <path>', 'path to custom browserslist configuration')
   .option('--browserslistEnv <env>', 'browserslist environment to use')
@@ -145,6 +146,13 @@ program
       process.exit(1)
     }
 
+    const validEcmaVersionValues = new Set(JS_VERSIONS);
+
+    if (options.checkBrowser && ecmaVersionArg && !validEcmaVersionValues.has(ecmaVersionArg)) {
+      filesArg.unshift(ecmaVersionArg);
+      ecmaVersionArg = 'checkBrowser';
+    }
+
     const configs = await loadConfig(options.config);
     const baseConfig = configs[0] || {};
 
@@ -257,7 +265,7 @@ async function runChecks(configs, logger) {
 
     let ecmaVersion
 
-    const isBrowserslistCheck = Boolean(expectedEcmaVersion === 'checkBrowser' || checkBrowser);
+    const isBrowserslistCheck = Boolean(expectedEcmaVersion === 'checkBrowser' || checkBrowser !== undefined);
     if (isBrowserslistCheck) {
       const browserslistQuery = config.browserslistQuery;
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-check",
-  "version": "9.1.3-1",
+  "version": "9.1.4",
   "description": "Checks the ECMAScript version of .js glob against a specified version of ECMAScript with a shell command",
   "main": "index.js",
   "license": "MIT",