Skip to content

docs(cli): point Babel 8 users to @babel/build-external-helpers - #3264

Merged
JLHwung merged 4 commits into
babel:mainfrom
officialasishkumar:docs-cli-build-external-helpers
Nov 14, 2026
Merged

JLHwung merged 4 commits into
babel:mainfrom
officialasishkumar:docs-cli-build-external-helpers

Conversation

@officialasishkumar

Copy link
Copy Markdown
Contributor

In Babel 8, @babel/cli/bin no longer contains babel-external-helpers.js; that utility is shipped by @babel/build-external-helpers.

  • Remove the outdated claim from the @babel/cli guide and add a note linking to the @babel/build-external-helpers page.
  • Update the example package.json snippet from ^7.0.0 to ^8.0.0, matching what an unversioned install resolves to.

Fixes #3261

@babel/cli no longer ships bin/babel-external-helpers.js in Babel 8; the
helper generator lives in @babel/build-external-helpers. Replace the
outdated statement and update the example package.json versions to ^8.0.0.

Fixes babel#3261
@babel/cli no longer ships bin/babel-external-helpers.js in Babel 8; the
helper generator lives in @babel/build-external-helpers. Replace the
outdated statement and update the example package.json versions to ^8.0.0.

Fixes babel#3261
@netlify

netlify Bot commented Nov 11, 2026 •

Copy link
Copy Markdown

👷 Deploy request for babel-v9 pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit e6c5e1c

@netlify

netlify Bot commented Nov 11, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for babel-v8 ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit e6c5e1c
🔍 Latest deploy log https://app.netlify.com/projects/babel-v8/deploys/6af88dff2b8d06b35b70eca5
😎 Deploy Preview https://deploy-preview-3264--babel-v8.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@JLHwung JLHwung left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Other changes look good to me, thank you.

Comment thread docs/cli.md Outdated
The main Babel CLI script, `babel.js`, lives in the top-level package at `@babel/cli/bin`.

:::note
In Babel 7, `@babel/cli/bin` also included a `babel-external-helpers.js` utility script. Starting from Babel 8, it has moved to a separate package: see [`@babel/build-external-helpers`](./build-external-helpers.md).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The current website is for Babel 8 only, could you move this note to the migration docs? At the moment when we introduced this change we don't expect users are still depending on this script so we didn't add it to the migration docs.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done, the note is gone from cli.md and the script move is now under a new @babel/cli section in the v8 migration guide.

Comment thread docs/v8-migration.md Outdated
Comment on lines +863 to +864
- The `babel-external-helpers.js` script in `@babel/cli/bin` has been moved to a separate package, [`@babel/build-external-helpers`](./build-external-helpers.md).
**Migration**: If you are running `@babel/cli/bin/babel-external-helpers.js`, install `@babel/build-external-helpers` and use it instead.

@JLHwung JLHwung Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The `babel-external-helpers.js` script in `@babel/cli/bin` has been moved to a separate package, [`@babel/build-external-helpers`](./build-external-helpers.md).
**Migration**: If you are running `@babel/cli/bin/babel-external-helpers.js`, install `@babel/build-external-helpers` and use it instead.
- `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

In general we will include the PR link in each breaking changes.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied your suggestion as is: officialasishkumar@e6c5e1c

@JLHwung
JLHwung merged commit aafe227 into babel:main Nov 14, 2026
4 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Babel 8 CLI guide references a helper script no longer shipped by @babel/cli

2 participants