es-check 9.4.4 → 9.4.5-0

package/README.md

@@ -10,20 +10,17 @@
 
 # ES Check ✔️
 
-[![npm version](https://badge.fury.io/js/es-check.svg)](https://www.npmjs.com/package/es-check)
+[![npm version](https://badge.fury.io/js/es-check.svg)](https://www.npmjs.com/package/es-check) [![codecov](https://codecov.io/gh/yowainwright/es-check/branch/main/graph/badge.svg)](https://codecov.io/gh/yowainwright/es-check)
 
 ---
 
-**ES Check** checks JavaScript files against a specified version of ECMAScript (ES) with a shell command. If a specified file's ES version doesn't match the ES version argument passed in the ES Check command, ES Check will throw an error and log the files that didn't match the check.
-
-Ensuring that JavaScript files can pass ES Check is important in a [modular and bundled](https://www.sitepoint.com/javascript-modules-bundling-transpiling/) world. Read more about [why](#why).
+**ES Check** validates JavaScript files against specified ECMAScript versions. Files failing version checks throw errors with detailed logging.
 
 ---
 
 ## Version 9 🎉
 
-**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!
-
+Version 9 adds ES version feature checks (`--checkFeatures`), browserslist integration (`--checkBrowser`), polyfill detection (`--checkForPolyfills`), and enhanced config support. Backward compatible.
 
 ### `--checkFeatures`
 
@@ -42,12 +39,12 @@ es-check checkBrowser ./dist/**/*.js --browserslistQuery="last 2 versions"
 <p align="center">
   <a href="#get-started">Get Started</a>&nbsp;&nbsp;
   <a href="#why-es-check">Why ES Check?</a>&nbsp;&nbsp;
-  <a href="#usage">Usage</a>&nbsp;&nbsp;
-  <a href="#walk-through">Walk Through</a>&nbsp;&nbsp;
   <a href="#api">API</a>&nbsp;&nbsp;
-  <a href="#debugging">Debugging</a>&nbsp;&nbsp;
+  <a href="#usage">Usage</a>&nbsp;&nbsp;
+  <a href="#configuration">Configuration</a>&nbsp;&nbsp;
+  <a href="#how-es-check-works">How ES Check Works</a>&nbsp;&nbsp;
   <a href="#contributing">Contributing</a>&nbsp;&nbsp;
-  <a href="/issues">Issues</a>
+  <a href="https://github.com/yowainwright/es-check/issues">Issues</a>
 </p>
 
 ---
@@ -79,11 +76,11 @@ es-check es5 './vendor/js/*.js' './dist/**/*.js'
 
 ## Why ES Check?
 
-In modern JavaScript builds, files are bundled up so they can be served in an optimized manner in the browsers. It is assumed by developers that future JavaScript—like ES8 will be transpiled (changed from future JavaScript to current JavaScript) appropriately by a tool like Babel. Sometimes there is an issue where files are not transpiled. There was no efficient way to test for files that weren't transpiled—until now. That's what ES Check does.
+Modern JavaScript builds assume proper transpilation via tools like Babel. ES Check verifies transpilation succeeded, catching untranspiled files before production.
 
 ## What features does ES Check check for?
 
-ES Check checks syntax out of the box—to protect against breaking errors going to production. Additionally, by adding the `--checkFeatures` flag, ES Check will check for actual ES version specific features. This ensures that your code is syntactically correct and only using features that are available in the specified ES version. Look here to view/add [features](./constants.js) that ES Check checks for with the `--checkFeatures` flag!
+ES Check validates syntax by default. Add `--checkFeatures` for ES version-specific feature checking. View supported [features](./lib/helpers/detectFeatures/constants/es-features/).
 
 ---
 
@@ -99,7 +96,7 @@ The images below demonstrate command line scripts and their corresponding logged
 
 ![fail](https://user-images.githubusercontent.com/1074042/31471486-d65c3a80-ae9d-11e7-94fd-68b7acdb2d89.jpg)
 
-**ES Check** is run above with node commands. It can also be run within npm scripts, ci tools, or testing suites. It also provide minimal support for use in node apps. 
+Run ES Check via CLI, npm scripts, CI tools, or programmatically in Node apps.
 
 ---
 
@@ -130,71 +127,33 @@ Arguments:
 
 Here's a comprehensive list of all available options:
 
-| Option | Description |
-|--------|-------------|
-| `-V, --version` | Output the version number |
-| `--module` | Use ES modules (default: false) |
-| `--light` | Lightweight mode: 2-3x faster checking using pattern matching only (default: false) |
-| `--allowHashBang` | If the code starts with #! treat it as a comment (default: false) |
-| `--files <files>` | A glob of files to test the ECMAScript version against (alias for [files...]) |
-| `--not <files>` | Folder or file names to skip |
-| `--noColor` | Disable use of colors in output (default: false) |
-| `-v, --verbose` | Verbose mode: will also output debug messages (default: false) |
-| `--quiet` | Quiet mode: only displays warn and error messages (default: false) |
-| `--looseGlobMatching` | Doesn't fail if no files are found in some globs/files (default: false) |
-| `--silent` | Silent mode: does not output anything, giving no indication of success or failure other than the exit code (default: false) |
-| `--checkFeatures` | Check for actual ES version specific features (default: false) |
-| `--checkForPolyfills` | Consider polyfills when checking features (only works with --checkFeatures) (default: false) |
-| `--ignore <features>` | Comma-separated list of features to ignore, e.g., "ErrorCause,TopLevelAwait" |
-| `--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 |
-| `--batchSize <number>` | Number of files to process concurrently (0 for unlimited, default: 0) |
-| `--noCache` | Disable file caching (cache is enabled by default) |
-| `-h, --help` | Display help for command |
-
-### Shell Completion
-
-ES Check supports shell tab completion for commands and options. You can generate completion scripts for bash and zsh shells:
-
-```sh
-# Generate completion script for bash (default)
-es-check completion
-
-# Generate completion script for zsh
-es-check completion zsh
-```
-
-To enable completions in your shell:
-
-**Bash:**
-
-```sh
-# Add to ~/.bashrc or ~/.bash_profile
-es-check completion > ~/.es-check-completion.bash
-echo 'source ~/.es-check-completion.bash' >> ~/.bashrc
-```
-
-**Zsh:**
-
-```sh
-# Add to ~/.zshrc
-es-check completion zsh > ~/.es-check-completion.zsh
-echo 'source ~/.es-check-completion.zsh' >> ~/.zshrc
-```
-
-Once enabled, you can use tab completion for:
-
-- ES versions (es5, es6, etc.)
-- Commands (completion)
-- Options (--module, --checkFeatures, etc.)
-- File paths
-
-#### Examples
+| Option                        | Description                                                                                                                 |
+| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| `-V, --version`               | Output the version number                                                                                                   |
+| `--module`                    | Use ES modules (default: false)                                                                                             |
+| `--allowHashBang`             | If the code starts with #! treat it as a comment (default: false)                                                           |
+| `--files <files>`             | A glob of files to test the ECMAScript version against (alias for [files...])                                               |
+| `--not <files>`               | Folder or file names to skip                                                                                                |
+| `--noColor`                   | Disable use of colors in output (default: false)                                                                            |
+| `-v, --verbose`               | Verbose mode: will also output debug messages (default: false)                                                              |
+| `--quiet`                     | Quiet mode: only displays warn and error messages (default: false)                                                          |
+| `--looseGlobMatching`         | Doesn't fail if no files are found in some globs/files (default: false)                                                     |
+| `--silent`                    | Silent mode: does not output anything, giving no indication of success or failure other than the exit code (default: false) |
+| `--checkFeatures`             | Check for actual ES version specific features (default: false)                                                              |
+| `--checkForPolyfills`         | Consider polyfills when checking features (only works with --checkFeatures) (default: false)                                |
+| `--ignore <features>`         | Comma-separated list of features to ignore, e.g., "ErrorCause,TopLevelAwait"                                                |
+| `--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                                                                                       |
+| `--batchSize <number>`        | Number of files to process concurrently (0 for unlimited, default: 0)                                                       |
+| `--noCache`                   | Disable file caching (cache is enabled by default)                                                                          |
+| `-h, --help`                  | Display help for command                                                                                                    |
+
+### Examples
 
 **Using ES modules:**
 
@@ -202,12 +161,6 @@ Once enabled, you can use tab completion for:
 es-check es6 './dist/**/*.js' --module
 ```
 
-**Fast checking with light mode (2-3x faster):**
-
-```sh
-es-check es5 './dist/**/*.js' --light
-```
-
 **Checking files with hash bang:**
 
 ```sh
@@ -297,24 +250,26 @@ es-check es6 ./js/*.js ./dist/*.js
 In addition to its CLI utility, ES Check can be used programmatically in Node.js applications:
 
 ```javascript
-const { runChecks, loadConfig } = require('es-check');
+const { runChecks, loadConfig } = require("es-check");
 
 async function checkMyFiles() {
-  const configs = [{
-    ecmaVersion: 'es5',
-    files: ['dist/**/*.js'],
-    module: false,
-    checkFeatures: true
-  }];
-  
+  const configs = [
+    {
+      ecmaVersion: "es5",
+      files: ["dist/**/*.js"],
+      module: false,
+      checkFeatures: true,
+    },
+  ];
+
   const result = await runChecks(configs);
-  
+
   if (result.success) {
-    console.log('All files passed ES5 check!');
+    console.log("All files passed ES5 check!");
     // Output: All files passed ES5 check!
   } else {
     console.error(`ES Check failed with ${result.errors.length} errors`);
-    result.errors.forEach(error => {
+    result.errors.forEach((error) => {
       console.error(`- ${error.file}: ${error.err.message}`);
     });
     // Example output:
@@ -322,7 +277,7 @@ async function checkMyFiles() {
     // - dist/app.js: Unsupported features used: const, arrow-functions but your target is ES5.
     // - dist/utils.js: Unsupported features used: template-literals but your target is ES5.
   }
-  
+
   return result;
 }
 ```
@@ -356,22 +311,22 @@ Here's an example of what an `.escheckrc` file will look like:
 
 ### Configuration Options
 
-| Option | Type | Description |
-|--------|------|-------------|
-| `ecmaVersion` | String | ECMAScript version to check against (e.g., "es5", "es6", "es2020") |
-| `files` | String or Array | Files or glob patterns to check |
-| `module` | Boolean | Whether to parse files as ES modules |
-| `not` | Array | Files or glob patterns to exclude |
-| `allowHashBang` | Boolean | Whether to allow hash bang in files |
-| `looseGlobMatching` | Boolean | Whether to ignore missing files in globs |
-| `checkFeatures` | Boolean | Whether to check for ES version specific features |
-| `checkForPolyfills` | Boolean | Whether to consider polyfills when checking features |
-| `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 |
+| Option              | Type            | Description                                                        |
+| ------------------- | --------------- | ------------------------------------------------------------------ |
+| `ecmaVersion`       | String          | ECMAScript version to check against (e.g., "es5", "es6", "es2020") |
+| `files`             | String or Array | Files or glob patterns to check                                    |
+| `module`            | Boolean         | Whether to parse files as ES modules                               |
+| `not`               | Array           | Files or glob patterns to exclude                                  |
+| `allowHashBang`     | Boolean         | Whether to allow hash bang in files                                |
+| `looseGlobMatching` | Boolean         | Whether to ignore missing files in globs                           |
+| `checkFeatures`     | Boolean         | Whether to check for ES version specific features                  |
+| `checkForPolyfills` | Boolean         | Whether to consider polyfills when checking features               |
+| `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                                    |
 
 ### Multiple Configurations
 
@@ -442,10 +397,7 @@ Example `.escheckignore` file:
 
 ```json
 {
-  "features": [
-    "ErrorCause",
-    "TopLevelAwait"
-  ]
+  "features": ["ErrorCause", "TopLevelAwait"]
 }
 ```
 
@@ -471,11 +423,13 @@ This option tells ES Check to look for common polyfill patterns in your code and
 ES Check provides three ways to handle polyfilled features:
 
 1. **--checkForPolyfills**: Automatically detects polyfills in your code
+
    ```sh
    es-check es2022 './dist/**/*.js' --checkFeatures --checkForPolyfills
    ```
 
 2. **--allowList**: Explicitly specify features to allow regardless of ES version
+
    ```sh
    es-check es2022 './dist/**/*.js' --checkFeatures --allowList="ArrayToSorted,ObjectHasOwn"
    ```
@@ -532,7 +486,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. You cannot have a files directly after your `--checkBrowser` option; it will read as 
+⚠️ **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
 
 ---
 
@@ -541,6 +495,7 @@ es-check --checkBrowser --checkFeatures ./dist/**/*.js
 ES Check includes several performance optimizations:
 
 ### File Caching
+
 File caching is **enabled by default** for faster re-checking:
 
 ```sh
@@ -552,11 +507,13 @@ es-check es5 './dist/**/*.js' --noCache
 ```
 
 We observed ~28% performance improvement in our [benchmark tests](./benchmarks/README.md). Your results may vary based on file sizes and system configuration. Try the benchmarks yourself:
+
 ```sh
 node benchmarks/compare-tools.js 3 ./benchmarks/test-files
 ```
 
 ### Batch Processing
+
 The `--batchSize` option optimizes memory usage:
 
 ```sh
@@ -572,17 +529,18 @@ es-check es5 './dist/**/*.js' --batchSize 50
 
 ### Performance Guidelines
 
-| Scenario | Recommended `--batchSize` | Reason |
-|----------|---------------------------|---------|
-| Small codebases (< 100 files) | `0` (unlimited) | Maximum parallelism for fastest results |
-| Medium codebases (100-500 files) | `0` or `50` | Balance between speed and memory |
-| Large codebases (> 500 files) | `50-100` | Prevent memory spikes |
-| CI/CD with limited memory | `10-20` | Conservative memory usage |
-| Local development | `0` (default) | Utilize available hardware |
+| Scenario                         | Recommended `--batchSize` | Reason                                  |
+| -------------------------------- | ------------------------- | --------------------------------------- |
+| Small codebases (< 100 files)    | `0` (unlimited)           | Maximum parallelism for fastest results |
+| Medium codebases (100-500 files) | `0` or `50`               | Balance between speed and memory        |
+| Large codebases (> 500 files)    | `50-100`                  | Prevent memory spikes                   |
+| CI/CD with limited memory        | `10-20`                   | Conservative memory usage               |
+| Local development                | `0` (default)             | Utilize available hardware              |
 
 ### Recent Performance Improvements
 
 As of August 2025, ES Check has been optimized with:
+
 - **Single-parse optimization**: Files are parsed once and the AST is reused
 - **Async file processing**: Non-blocking I/O for better performance
 - **Configurable batch processing**: Fine-tune based on your needs
@@ -605,21 +563,132 @@ A simple example script is available in `examples/check-node-modules.js`.
 
 ---
 
-## Acknowledgements
+## How ES Check Works
+
+```mermaid
+flowchart LR
+    A[Input: ES Version<br/>+ File Globs] --> B[Full AST Parsing<br/>Acorn]
+    B --> C{Syntax<br/>Valid?}
+    C -->|Pass| E{--checkFeatures?}
+    C -->|Fail| D[Report Error]
+    E -->|Yes| G[Check ES Features<br/>AST Walk]
+    E -->|No| F[Success]
+    G --> G1{Features<br/>Valid?}
+    G1 -->|Pass| H{--checkForPolyfills?}
+    G1 -->|Fail| D
+    H -->|Yes| I{Polyfills<br/>Detected?}
+    H -->|No| F
+    I -->|Yes| F
+    I -->|No| D
+    D --> J[Exit 1]
+    F --> K[Exit 0]
+
+    classDef inputStyle fill:#e1f5ff,stroke:#0288d1,stroke-width:2px
+    classDef processStyle fill:#fff3e0,stroke:#f57c00,stroke-width:2px
+    classDef decisionStyle fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
+    classDef successStyle fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
+    classDef errorStyle fill:#ffebee,stroke:#d32f2f,stroke-width:2px
+
+    class A inputStyle
+    class B,G processStyle
+    class C,E,G1,H,I decisionStyle
+    class F,K successStyle
+    class D,J errorStyle
+```
+
+---
+
+## Source Maps
 
-ES Check is a small utility using powerful tools that [Isaac Z. Schlueter](https://github.com/isaacs), [Marijn Haverbeke](https://github.com/marijnh), and [Matthias Etienne](https://github.com/mattallty) built. [ES Checker](https://github.com/ruanyf/es-checker) by [Ruan YiFeng](https://github.com/ruanyf) checks the JavaScript version supported within a [browser](http://ruanyf.github.io/es-checker/) at run time. ES Check offers similar feedback to ES Checker but at build time and is specific to the product that is using it. ES Check was started after reading [Philip Walton](https://github.com/philipwalton)'s post about [deploying es2015 code to production today](https://philipwalton.com/articles/deploying-es2015-code-in-production-today/).
+ES Check supports source maps for better error reporting. When a `.map` file exists alongside your JavaScript file, ES Check will automatically map error positions from transpiled code back to the original source:
+
+```sh
+es-check es5 './dist/bundle.js'
+```
+
+If `bundle.js.map` exists, errors will reference the original source file and line numbers instead of the minified positions. This helps quickly identify issues in your source code.
+
+---
+
+## Shell Completion
+
+ES Check supports shell tab completion for commands and options. You can generate completion scripts for bash and zsh shells:
+
+```sh
+# Generate completion script for bash (default)
+es-check completion
+
+# Generate completion script for zsh
+es-check completion zsh
+```
+
+To enable completions in your shell:
+
+**Bash:**
+
+```sh
+# Add to ~/.bashrc or ~/.bash_profile
+es-check completion > ~/.es-check-completion.bash
+echo 'source ~/.es-check-completion.bash' >> ~/.bashrc
+```
+
+**Zsh:**
+
+```sh
+# Add to ~/.zshrc
+es-check completion zsh > ~/.es-check-completion.zsh
+echo 'source ~/.es-check-completion.zsh' >> ~/.zshrc
+```
+
+Once enabled, you can use tab completion for:
+
+- ES versions (es5, es6, etc.)
+- Commands (completion)
+- Options (--module, --checkFeatures, etc.)
+- File paths
+
+---
+
+## Performance
+
+ES Check is benchmarked against similar tools using real-world production libraries. Results from 11/02/2025:
+
+| Tool                  | Average (ms) | Relative Performance |
+| --------------------- | ------------ | -------------------- |
+| **es-check-batch-50** | **7.20**     | **1x (fastest)**     |
+| es-check-batch-10     | 7.67         | 1.06x slower         |
+| es-check-bundled      | 8.04         | 1.12x slower         |
+| es-check              | 9.17         | 1.27x slower         |
+| are-you-es5           | 15.05        | 2.09x slower         |
+| acorn (direct)        | 47.11        | 6.54x slower         |
+| eslint                | 55.21        | 7.67x slower         |
+| swc/core              | 55.69        | 7.73x slower         |
+| babel-parser          | 65.00        | 9.03x slower         |
+
+Tested on lodash, axios, react, moment, express, and chalk. See [benchmarks](./tests/benchmarks/README.md) for details.
 
 ---
 
 ## Contributing
 
-ES Check has 7 dependencies: [acorn and acorn-walk](https://github.com/ternjs/acorn/), [fast-glob](https://github.com/mrmlnc/fast-glob), [supports-color](https://github.com/chalk/supports-color), [winston](https://github.com/winstonjs/winston), [browserslist](https://github.com/browserslist/browserslist), and [commander](https://github.com/tj/commander). To contribute, file an [issue](https://github.com/yowainwright/es-check/issues) or submit a pull request.
+ES Check has only 4 core dependencies: [acorn](https://github.com/ternjs/acorn/) for JavaScript parsing, [fast-brake](https://github.com/stackblitz/fast-brake) for lightweight feature detection, [fast-glob](https://github.com/mrmlnc/fast-glob) for file globbing, and [browserslist](https://github.com/browserslist/browserslist) for browser targeting.
+
+The CLI, logging, and source map support are implemented with custom lightweight solutions using Node.js built-ins to minimize dependencies. To contribute, file an [issue](https://github.com/yowainwright/es-check/issues) or submit a pull request.
 
-To update es versions, check out these lines of code [here](https://github.com/yowainwright/es-check/blob/main/index.js#L92-L153) and [here (in acorn.js)](https://github.com/acornjs/acorn/blob/3221fa54f9dea30338228b97210c4f1fd332652d/acorn/src/acorn.d.ts#L586).
+### Contributing to ES Features
 
-To update es feature detection, update these files [here](./utils.js) and [here](./constants.js) as enabled feature testing using [acorn walk](https://github.com/acornjs/acorn/blob/master/acorn-walk/README.md).
+To update ES version support:
 
-[tests](./test.js) to go with new version and/or feature detection updates are great to have!
+- Update [ES version mappings](./lib/constants/versions.js)
+- Reference [Acorn ES version support](https://github.com/acornjs/acorn/blob/3221fa54f9dea30338228b97210c4f1fd332652d/acorn/src/acorn.d.ts#L586)
+
+To update ES feature detection:
+
+- Add features to [version-specific files](./lib/helpers/detectFeatures/constants/es-features/) (e.g., `6.js` for ES6 features)
+- Update [polyfill patterns](./lib/helpers/detectFeatures/constants/polyfills.js) if needed
+- Feature detection uses [acorn walk](https://github.com/acornjs/acorn/blob/master/acorn-walk/README.md)
+
+Tests are located in `tests/unit/` and mirror the `lib/` structure. Please add tests for new features!
 
 ### Contributors
 
@@ -630,3 +699,9 @@ To update es feature detection, update these files [here](./utils.js) and [here]
 - [Ben Junya](https://github.com/MrBenJ)
 - [Jeff Barczewski](https://github.com/jeffbski)
 - [Brandon Casey](https://github.com/BrandonOCasey)
+
+---
+
+## License
+
+[MIT](./LICENSE) © [Jeff Wainwright](https://github.com/yowainwright)

package/{browserslist.js → lib/browserslist.js}

@@ -1,5 +1,5 @@
-const browserslist = require('browserslist');
-const { BROWSER_TO_ES_VERSION } = require('./constants');
+const browserslist = require("browserslist");
+const { BROWSER_TO_ES_VERSION } = require("./constants/versions");
 
 /**
  * Determines the ES version supported by a specific browser and version
@@ -15,7 +15,7 @@ function getESVersionForBrowser(browser, version) {
   }
 
   const browserVersions = Object.keys(BROWSER_TO_ES_VERSION[browser])
-    .map(v => parseFloat(v))
+    .map((v) => parseFloat(v))
     .sort((a, b) => a - b);
 
   const targetVersion = parseFloat(version);
@@ -29,7 +29,10 @@ function getESVersionForBrowser(browser, version) {
     }
   }
 
-  if (matchedVersion === null && (browser === 'chrome' || browser === 'firefox')) {
+  if (
+    matchedVersion === null &&
+    (browser === "chrome" || browser === "firefox")
+  ) {
     return 6;
   }
 
@@ -54,51 +57,57 @@ function getESVersionFromBrowserslist(options = {}) {
   try {
     const browsers = browserslist(browserslistQuery ?? null, {
       path: browserslistPath,
-      env: browserslistEnv
+      env: browserslistEnv,
     });
 
     if (!browsers || browsers.length === 0) {
       return 5;
     }
 
-    const hasIE = browsers.some(browser => browser.includes('ie '));
-    const hasOldEdge = browsers.some(browser => {
-      const [name, version] = browser.split(' ');
-      return name === 'edge' && parseInt(version, 10) < 79;
+    const hasIE = browsers.some((browser) => browser.includes("ie "));
+    const hasOldEdge = browsers.some((browser) => {
+      const [name, version] = browser.split(" ");
+      return name === "edge" && parseInt(version, 10) < 79;
     });
 
     if (hasIE || hasOldEdge) {
       return 5;
     }
 
-    if ((browserslistPath && browserslistPath.includes('legacy')) ||
-        (browserslistEnv && browserslistEnv.includes('legacy'))) {
+    if (
+      (browserslistPath && browserslistPath.includes("legacy")) ||
+      (browserslistEnv && browserslistEnv.includes("legacy"))
+    ) {
       return 5;
     }
 
-    if (browsers.length === 0 || (browserslistPath && browserslistPath.includes('non-existent'))) {
+    if (
+      browsers.length === 0 ||
+      (browserslistPath && browserslistPath.includes("non-existent"))
+    ) {
       return 5;
     }
 
-    if (browserslistPath && browserslistPath.includes('mixed')) {
+    if (browserslistPath && browserslistPath.includes("mixed")) {
       return 5;
     }
 
-    const hasModernBrowsers = browsers.some(browser =>
-      browser.includes('chrome') || browser.includes('firefox')
-    );
+    const esVersions = browsers.map((browser) => {
+      const [browserName, version] = browser.split(" ");
+      return getESVersionForBrowser(browserName, version);
+    });
 
-    if (hasModernBrowsers) {
-      return 6;
-    }
+    const maxESVersion = esVersions.reduce((max, version) => {
+      return version > max ? version : max;
+    }, 5);
 
-    return 5;
-  } catch (error) {
+    return maxESVersion;
+  } catch {
     return 5;
   }
 }
 
 module.exports = {
   getESVersionFromBrowserslist,
-  getESVersionForBrowser
+  getESVersionForBrowser,
 };