babel/packages
Sophie Alpert 6a7223af29 Fix O(n^2) getLetReferences – 40% faster on large flat files
`this.blockPath.get("body")` constructs an array of paths corresponding to each node in `blocks.body` so takes O(n) time if n is that length. We were re-constructing that array on each iteration, so the entire loop was O(n^2).

On files with many statements in a single block (such as Rollup-generated bundles), this takes a large portion of time. In particular, this makes transforming react-dom.development.js about 40% faster. Not that you should be transforming our bundle with Babel.

Test Plan:
Make an HTML file with these three lines and watch it in the Chrome Performance tab to see timings (on my machine: 2.9s before, 1.6s after):

```
<!DOCTYPE html>
<script src="https://unpkg.com/babel-standalone@7.0.0-beta.3/babel.js"></script>
<script type="text/babel" src="https://unpkg.com/react-dom@16.2.0/umd/react-dom.development.js"></script>
```
2017-12-14 21:55:26 -08:00
..
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00
2017-12-14 16:47:27 -05:00

Woah, what's going on here?

A monorepo, muhahahahahaha. See the monorepo design doc for reasoning.

Core Packages

Package Version Dependencies
@babel/core npm Dependency Status
babylon npm Dependency Status
@babel/traverse npm Dependency Status
@babel/generator npm Dependency Status

@babel/core is the Babel compiler itself; it exposes the babel.transform method, where transformedCode = transform(src).code.

The compiler can be broken down into 3 parts:

The flow goes like this:

input string -> babylon parser -> AST -> transformer[s] -> AST -> @babel/generator -> output string

Check out the babel-handbook for more information on this.

Other

Package Version Dependencies
@babel/cli npm Dependency Status
@babel/types npm Dependency Status
@babel/polyfill npm Dependency Status
@babel/runtime npm Dependency Status
@babel/register npm Dependency Status
@babel/template npm Dependency Status
@babel/helpers npm Dependency Status
@babel/code-frame npm Dependency Status
  • @babel/cli is the CLI tool that runs @babel/core and helps with outputting to a directory, a file, stdout and more (also includes @babel/node cli). Check out the docs.
  • @babel/types is used to validate, build and change AST nodes.
  • @babel/polyfill is literally a wrapper around core-js and regenerator-runtime. Check out the docs.
  • @babel/runtime is similar to the polyfill except that it doesn't modify the global scope and is to be used with @babel/plugin-transform-runtime (usually in library/plugin code). Check out the docs.
  • @babel/register is a way to automatically compile files with Babel on the fly by binding to Node.js require. Check out the docs.
  • @babel/template is a helper function that allows constructing AST nodes from a string presentation of the code; this eliminates the tedium of using @babel/types for building AST nodes.
  • @babel/helpers is a set of pre-made @babel/template functions that are used in some Babel plugins.
  • @babel/code-frame is a standalone package used to generate errors that print the source code and point to error locations.

Presets

After Babel 6, the default transforms were removed; if you don't specify any plugins/presets, Babel will just return the original source code.

The transformer[s] used in Babel are the independent pieces of code that transform specific things. For example: the es2015-arrow-functions transform specifically changes arrow functions into regular functions. A preset is simply an array of plugins that make it easier to run a whole a set of transforms without specifying each one manually.

Package Version Dependencies Description
@babel/preset-env npm Dependency Status automatically determines plugins and polyfills you need based on your supported environments

You can find community maintained presets on npm

Plugins

Plugins are the heart of Babel and what make it work.

You can find community plugins on npm.

Transform Plugins

There are many kinds of plugins: ones that convert ES6/ES2015 to ES5, transform to ES3, minification, JSX, flow, experimental features, and more. Check out our website for more.

Syntax Plugins

These just enable the transform plugins to be able to parse certain features (the transform plugins already include the syntax plugins so you don't need both): @babel/plugin-syntax-x. Check out our website for more.

Helpers

These are mostly for internal use in various plugins: @babel/helper-x.