diff --git a/docs/cli.md b/docs/cli.md index 135f5324f8..a18da15288 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -5,7 +5,7 @@ title: "@babel/cli" Babel comes with a built-in CLI which can be used to compile files from the command line. -In addition, various entry point scripts live in the top-level package at `@babel/cli/bin`. There is a shell-executable utility script, `babel-external-helpers.js`, and the main Babel cli script, `babel.js`. +The main Babel CLI script, `babel.js`, lives in the top-level package at `@babel/cli/bin`. ## Install @@ -34,8 +34,8 @@ After that finishes installing, your `package.json` file should include: ```diff { "devDependencies": { -+ "@babel/cli": "^7.0.0", -+ "@babel/core": "^7.0.0" ++ "@babel/cli": "^8.0.0", ++ "@babel/core": "^8.0.0" } } ``` diff --git a/docs/v8-migration.md b/docs/v8-migration.md index cddf6d9077..7f57daba76 100644 --- a/docs/v8-migration.md +++ b/docs/v8-migration.md @@ -856,6 +856,19 @@ Make sure to also check the [@babel/plugin-transform-flow-strip-types](#babel-pl } ``` +### `@babel/cli` {#babel-cli} + +![low](https://img.shields.io/badge/risk%20of%20breakage%3F-low-yellowgreen.svg) + +- `babel-external-helpers` has been moved from `@babel/cli` to a new package, [`@babel/build-external-helpers`](./build-external-helpers.md) ([#17746](https://github.com/babel/babel/pull/17746)). The `--whitelist` option has been removed in favor of `-l`/`--allowlist`. + + **Migration**: Install `@babel/build-external-helpers` and replace `babel-external-helpers` with `build-external-helpers` (or `npx @babel/build-external-helpers`): + + ```diff + - babel-external-helpers --whitelist createClass -t umd > helpers.js + + build-external-helpers --allowlist createClass -t umd > helpers.js + ``` + ### `@babel/node` {#babel-node} ![low](https://img.shields.io/badge/risk%20of%20breakage%3F-low-yellowgreen.svg)