v7.0.0-beta.50

* isConstantExpression should return true for immuable bindings

* New test

* Don't return undefined

.circleci/config.yml

@@ -34,7 +34,7 @@ jobs:
   build:
     working_directory: ~/babel
     docker:
-      - image: circleci/node:9
+      - image: circleci/node:10
     steps:
       - checkout
       - restore-cache: *restore-yarn-cache

.travis.yml

@@ -8,6 +8,7 @@ cache:
     - node_modules
 node_js:
   # We test the latest version on circleci
+  - '9'
   - '8'
   - '6'
 

Makefile

@@ -1,6 +1,6 @@
 MAKEFLAGS = -j1
 FLOW_COMMIT = 395e045c18d537fcbbc552a96ef2cdcd70b4ab52
-TEST262_COMMIT = 40883f4c6ae17e073dfd03e34f73a6bf8c855595
+TEST262_COMMIT = f90a52b39609a620c0854e0bd0b3a906c930fd17
 
 # Fix color output until TravisCI fixes https://github.com/travis-ci/travis-ci/issues/7967
 export FORCE_COLOR = true
@@ -17,8 +17,6 @@ build: clean clean-lib
 	# generate flow and typescript typings
 	node scripts/generators/flow.js > ./packages/babel-types/lib/index.js.flow
 	node scripts/generators/typescript.js > ./packages/babel-types/lib/index.d.ts
-	# generate docs
-	node scripts/generators/docs.js > ./packages/babel-types/README.md
 ifneq ("$(BABEL_COVERAGE)", "true")
 	make build-standalone
 	make build-preset-env-standalone
@@ -52,8 +50,6 @@ lint:
 	./node_modules/.bin/eslint scripts $(SOURCES) '*.js' '**/.*.js' --format=codeframe --rulesdir="./scripts/eslint_rules"
 
 fix:
-	# The config is hardcoded because otherwise prettier searches for it and also picks up some broken package.json files from tests
-	./node_modules/.bin/prettier --config .prettierrc --write --ignore-path .eslintignore '**/*.json'
 	./node_modules/.bin/eslint scripts $(SOURCES) '*.js' '**/.*.js' --format=codeframe --fix --rulesdir="./scripts/eslint_rules"
 
 clean: test-clean

codemods/babel-plugin-codemod-object-assign-to-object-spread/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/plugin-codemod-object-assign-to-object-spread",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Transforms Object.assign into object spread syntax",
   "repository": "https://github.com/babel/babel/tree/master/codemods/babel-plugin-codemod-object-assign-to-object-spread",
   "license": "MIT",
@@ -10,14 +10,14 @@
     "@babel/plugin"
   ],
   "dependencies": {
-    "@babel/plugin-syntax-object-rest-spread": "7.0.0-beta.48"
+    "@babel/plugin-syntax-object-rest-spread": "7.0.0-beta.50"
   },
   "peerDependencies": {
-    "@babel/core": "7.0.0-beta.48"
+    "@babel/core": "7.0.0-beta.49"
   },
   "devDependencies": {
-    "@babel/core": "7.0.0-beta.48",
-    "@babel/helper-plugin-test-runner": "7.0.0-beta.48"
+    "@babel/core": "7.0.0-beta.50",
+    "@babel/helper-plugin-test-runner": "7.0.0-beta.50"
   },
   "publishConfig": {
     "access": "public"

codemods/babel-plugin-codemod-optional-catch-binding/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/plugin-codemod-optional-catch-binding",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Remove unused catch bindings",
   "repository": "https://github.com/babel/babel/tree/master/codemods/babel-plugin-codemod-remove-unused-catch-binding",
   "license": "MIT",
@@ -10,13 +10,13 @@
     "@babel/plugin"
   ],
   "dependencies": {
-    "@babel/plugin-syntax-optional-catch-binding": "7.0.0-beta.48"
+    "@babel/plugin-syntax-optional-catch-binding": "7.0.0-beta.50"
   },
   "peerDependencies": {
-    "@babel/core": "7.0.0-beta.48"
+    "@babel/core": "7.0.0-beta.49"
   },
   "devDependencies": {
-    "@babel/core": "7.0.0-beta.48",
-    "@babel/helper-plugin-test-runner": "7.0.0-beta.48"
+    "@babel/core": "7.0.0-beta.50",
+    "@babel/helper-plugin-test-runner": "7.0.0-beta.50"
   }
 }

lerna.json

@@ -1,6 +1,6 @@
 {
-  "lerna": "2.0.0-rc.4",
-  "version": "7.0.0-beta.48",
+  "lerna": "2.11.0",
+  "version": "7.0.0-beta.50",
   "changelog": {
     "repo": "babel/babel",
     "cacheDir": ".changelog",

lib/third-party-libs.js.flow

@@ -166,3 +166,9 @@ declare module "convert-source-map" {
     generateMapFileComment(path: string, options?: ?{ multiline: boolean }): string,
   };
 }
+
+declare module "js-levenshtein" {
+  declare module.exports: {
+    (string, string): number,
+  };
+}

package.json

@@ -10,19 +10,18 @@
     "test": "make test"
   },
   "devDependencies": {
-    "@babel/cli": "7.0.0-beta.46",
-    "@babel/core": "7.0.0-beta.46",
-    "@babel/plugin-transform-modules-commonjs": "7.0.0-beta.46",
-    "@babel/preset-env": "7.0.0-beta.46",
-    "@babel/preset-flow": "7.0.0-beta.46",
-    "@babel/preset-stage-0": "7.0.0-beta.46",
-    "@babel/register": "7.0.0-beta.46",
+    "@babel/cli": "7.0.0-beta.48",
+    "@babel/core": "7.0.0-beta.48",
+    "@babel/plugin-transform-modules-commonjs": "7.0.0-beta.48",
+    "@babel/preset-env": "7.0.0-beta.48",
+    "@babel/preset-flow": "7.0.0-beta.48",
+    "@babel/preset-stage-0": "7.0.0-beta.48",
+    "@babel/register": "7.0.0-beta.48",
     "babel-core": "^7.0.0-0",
     "babel-eslint": "^8.0.1",
     "babel-jest": "^22.4.1",
     "babel-loader": "8.0.0-beta.0",
     "babel-plugin-transform-charcodes": "^0.1.0",
-    "babylon": "7.0.0-beta.46",
     "browserify": "^13.1.1",
     "bundle-collapser": "^1.2.1",
     "chalk": "^2.3.2",
@@ -32,8 +31,8 @@
     "eslint": "^4.18.2",
     "eslint-config-babel": "^7.0.2",
     "eslint-plugin-flowtype": "^2.20.0",
-    "eslint-plugin-prettier": "^2.5.0",
-    "flow-bin": "^0.66.0",
+    "eslint-plugin-prettier": "^2.6.0",
+    "flow-bin": "^0.73.0",
     "graceful-fs": "^4.1.11",
     "gulp": "^4.0.0",
     "gulp-babel": "^8.0.0-beta.2",
@@ -46,19 +45,19 @@
     "gulp-watch": "^5.0.0",
     "husky": "^0.14.3",
     "jest": "^22.4.2",
-    "lerna": "2.0.0",
+    "lerna": "^2.11.0",
     "lerna-changelog": "^0.5.0",
     "lint-staged": "^6.0.1",
     "lodash": "^4.17.5",
     "merge-stream": "^1.0.1",
     "output-file-sync": "^2.0.0",
-    "prettier": "1.11.1",
+    "prettier": "1.13.2",
     "pump": "^1.0.2",
     "rimraf": "^2.4.3",
     "rollup-plugin-babel": "^4.0.0-beta.0",
     "rollup-plugin-node-resolve": "^3.0.2",
     "rollup-stream": "^1.24.1",
-    "test262-stream": "^1.1.0",
+    "test262-stream": "^1.2.0",
     "through2": "^2.0.0",
     "uglify-js": "^2.4.16",
     "vinyl-buffer": "^1.0.1",

packages/babel-cli/README.md

@@ -2,20 +2,18 @@
 
 > Babel 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`.
+See our website [@babel/cli](https://new.babeljs.io/docs/en/next/babel-cli.html) for more information or the [issues](https://github.com/babel/babel/issues?utf8=%E2%9C%93&q=is%3Aissue+label%3A%22pkg%3A%20cli%22+is%3Aopen) associated with this package.
 
 ## Install
 
-```sh
-npm install --save-dev @babel/core @babel/cli
-```
-
-## Usage
+Using npm:
 
 ```sh
-babel script.js
+npm install --save @babel/cli
 ```
 
-For more in depth documentation see: http://babeljs.io/docs/usage/cli/
+or using yarn:
+
+```sh
+yarn add --save @babel/cli
+```

packages/babel-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/cli",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Babel command line.",
   "author": "Sebastian McKenzie <sebmck@gmail.com>",
   "homepage": "https://babeljs.io/",
@@ -29,11 +29,11 @@
     "chokidar": "^2.0.3"
   },
   "peerDependencies": {
-    "@babel/core": "7.0.0-beta.48"
+    "@babel/core": "7.0.0-beta.49"
   },
   "devDependencies": {
-    "@babel/core": "7.0.0-beta.48",
-    "@babel/helper-fixtures": "7.0.0-beta.48"
+    "@babel/core": "7.0.0-beta.50",
+    "@babel/helper-fixtures": "7.0.0-beta.50"
   },
   "bin": {
     "babel": "./bin/babel.js",

packages/babel-cli/src/babel/dir.js

@@ -73,8 +73,14 @@ export default async function({ cliOptions, babelOptions }) {
 
   function outputDestFolder(outDir) {
     const outDirPath = path.resolve(outDir);
-    if (!fs.existsSync(outDirPath)) {
+
+    try {
       fs.mkdirSync(outDirPath);
+    } catch (err) {
+      // Testing for the directory and then creating it can lead to race
+      // conditions if there are multiple processes, so we try to create it
+      // and bail if it already exists.
+      if (err.code !== "EEXIST") throw err;
     }
   }
 

packages/babel-cli/test/fixtures/babel/stdin --filename/stderr.txt

@@ -1 +1 @@
-SyntaxError: test.js: Unexpected token, expected ";" (2:10)
+SyntaxError: <CWD>/test.js: Unexpected token, expected ";" (2:10)

packages/babel-cli/test/index.js

@@ -46,7 +46,20 @@ const saveInFiles = function(files) {
   });
 };
 
-const assertTest = function(stdout, stderr, opts) {
+const replacePaths = function(str, cwd) {
+  let prev;
+  do {
+    prev = str;
+    str = str.replace(cwd, "<CWD>");
+  } while (str !== prev);
+
+  return str;
+};
+
+const assertTest = function(stdout, stderr, opts, cwd) {
+  stdout = replacePaths(stdout, cwd);
+  stderr = replacePaths(stderr, cwd);
+
   const expectStderr = opts.stderr.trim();
   stderr = stderr.trim();
 
@@ -138,7 +151,7 @@ const buildTest = function(binName, testName, opts) {
       let err;
 
       try {
-        assertTest(stdout, stderr, opts);
+        assertTest(stdout, stderr, opts, tmpLoc);
       } catch (e) {
         err = e;
       }

packages/babel-code-frame/README.md

@@ -2,141 +2,18 @@
 
 > Generate errors that contain a code frame that point to source locations.
 
+See our website [@babel/code-frame](https://new.babeljs.io/docs/en/next/babel-code-frame.html) for more information.
+
 ## Install
 
+Using npm:
+
 ```sh
-npm install --save-dev @babel/code-frame
+npm install --save @babel/code-frame
 ```
 
-## Usage
+or using yarn:
 
-```js
-import { codeFrameColumns } from '@babel/code-frame';
-
-const rawLines = `class Foo {
-  constructor()
-}`;
-const location = { start: { line: 2, column: 16 } };
-
-const result = codeFrameColumns(rawLines, location, { /* options */ });
-
-console.log(result);
-```
-
-```
-  1 | class Foo {
-> 2 |   constructor()
-    |                ^
-  3 | }
-```
-
-If the column number is not known, you may omit it.
-
-You can also pass an `end` hash in `location`.
-
-```js
-import { codeFrameColumns } from '@babel/code-frame';
-
-const rawLines = `class Foo {
-  constructor() {
-    console.log("hello");
-  }
-}`;
-const location = { start: { line: 2, column: 17 }, end: { line: 4, column: 3 } };
-
-const result = codeFrameColumns(rawLines, location, { /* options */ });
-
-console.log(result);
-```
-
-```
-  1 | class Foo {
-> 2 |   constructor() {
-    |                 ^
-> 3 |     console.log("hello");
-    | ^^^^^^^^^^^^^^^^^^^^^^^^^
-> 4 |   }
-    | ^^^
-  5 | };
-```
-
-## Options
-
-### `highlightCode`
-
-`boolean`, defaults to `false`.
-
-Toggles syntax highlighting the code as JavaScript for terminals.
-
-
-### `linesAbove`
-
-`number`, defaults to `2`.
-
-Adjust the number of lines to show above the error.
-
-### `linesBelow`
-
-`number`, defaults to `3`.
-
-Adjust the number of lines to show below the error.
-
-### `forceColor`
-
-`boolean`, defaults to `false`.
-
-Enable this to forcibly syntax highlight the code as JavaScript (for non-terminals); overrides `highlightCode`.
-
-### `message`
-
-`string`, otherwise nothing
-
-Pass in a string to be displayed inline (if possible) next to the highlighted
-location in the code. If it can't be positioned inline, it will be placed above
-the code frame.
-
-```
-1 | class Foo {
-> 2 |   constructor()
-  |                ^ Missing {
-3 | };
-```
-
-## Upgrading from prior versions
-
-Prior to version 7, the only API exposed by this module was for a single line and optional column pointer. The old API will now log a deprecation warning.
-
-The new API takes a `location` object, similar to what is available in an AST.
-
-This is an example of the deprecated (but still available) API:
-
-```js
-import codeFrame from '@babel/code-frame';
-
-const rawLines = `class Foo {
-  constructor()
-}`;
-const lineNumber = 2;
-const colNumber = 16;
-
-const result = codeFrame(rawLines, lineNumber, colNumber, { /* options */ });
-
-console.log(result);
-```
-
-To get the same highlighting using the new API:
-
-```js
-import { codeFrameColumns } from '@babel/code-frame';
-
-const rawLines = `class Foo {
-  constructor() {
-    console.log("hello");
-  }
-}`;
-const location = { start: { line: 2, column: 16 } };
-
-const result = codeFrameColumns(rawLines, location, { /* options */ });
-
-console.log(result);
+```sh
+yarn add --save @babel/code-frame
 ```

packages/babel-code-frame/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/code-frame",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Generate errors that contain a code frame that point to source locations.",
   "author": "Sebastian McKenzie <sebmck@gmail.com>",
   "homepage": "https://babeljs.io/",
@@ -8,7 +8,7 @@
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-code-frame",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/highlight": "7.0.0-beta.48"
+    "@babel/highlight": "7.0.0-beta.50"
   },
   "devDependencies": {
     "chalk": "^2.0.0",

packages/babel-core/README.md

@@ -2,249 +2,18 @@
 
 > Babel compiler core.
 
+See our website [@babel/core](https://new.babeljs.io/docs/en/next/babel-core.html) for more information or the [issues](https://github.com/babel/babel/issues?utf8=%E2%9C%93&q=is%3Aissue+label%3A%22pkg%3A%20core%22+is%3Aopen) associated with this package.
 
-```javascript
-var babel = require("@babel/core");
-import { transform } from "@babel/core";
-import * as babel from "@babel/core";
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/core
 ```
 
-All transformations will use your local configuration files (`.babelrc` or in `package.json`). See [options](#options) to disable it.
+or using yarn:
 
-
-## babel.transform(code: string, [options?](#options): Object, callback: Function)
-
-Transforms the passed in `code`. Calling a callback with an object with the generated code,
-source map, and AST.
-
-```js
-babel.transform(code, options, function(err, result) {
-  result; // => { code, map, ast }
-});
+```sh
+yarn add --save @babel/core
 ```
-
-**Example**
-
-```js
-babel.transform("code();", options, function(err, result) {
-  result.code;
-  result.map;
-  result.ast;
-});
-```
-
-### Compat Note:
-
-In Babel 6, this method was synchronous and `transformSync` did not exist. For backward-compatibility,
-this function will behave synchronously if no callback is given. If you're starting with Babel 7
-and need synchronous behavior, please use `transformSync` since this backward-compat may be dropped in
-future major versions of Babel.
-
-
-## babel.transformSync(code: string, [options?](#options): Object)
-
-Transforms the passed in `code`. Returning an object with the generated code,
-source map, and AST.
-
-```js
-babel.transformSync(code, options) // => { code, map, ast }
-```
-
-**Example**
-
-```js
-var result = babel.transformSync("code();", options);
-result.code;
-result.map;
-result.ast;
-```
-
-
-## babel.transformFile(filename: string, [options?](#options): Object, callback: Function)
-
-Asynchronously transforms the entire contents of a file.
-
-```js
-babel.transformFile(filename, options, callback)
-```
-
-**Example**
-
-```js
-babel.transformFile("filename.js", options, function (err, result) {
-  result; // => { code, map, ast }
-});
-```
-
-
-## babel.transformFileSync(filename: string, [options?](#options): Object)
-
-Synchronous version of `babel.transformFile`. Returns the transformed contents of
-the `filename`.
-
-```js
-babel.transformFileSync(filename, options) // => { code, map, ast }
-```
-
-**Example**
-
-```js
-babel.transformFileSync("filename.js", options).code;
-```
-
-
-## babel.transformFromAst(ast: Object, code?: string, [options?](#options): Object, callback: Function): FileNode | null
-
-Given an [AST](https://astexplorer.net/), transform it.
-
-```js
-const sourceCode = "if (true) return;";
-const parsedAst = babel.parse(sourceCode, { allowReturnOutsideFunction: true });
-babel.transformFromAst(parsedAst, sourceCode, options, function(err, result) {
-  const { code, map, ast } = result;
-});
-```
-
-### Compat Note:
-
-In Babel 6, this method was synchronous and `transformFromAstSync` did not exist. For backward-compatibility,
-this function will behave synchronously if no callback is given. If you're starting with Babel 7
-and need synchronous behavior, please use `transformFromAstSync` since this backward-compat may be dropped in
-future major versions of Babel.
-
-
-## babel.transformFromAstSync(ast: Object, code?: string, [options?](#options): Object)
-
-Given an [AST](https://astexplorer.net/), transform it.
-
-```js
-const sourceCode = "if (true) return;";
-const parsedAst = babel.parse(sourceCode, { allowReturnOutsideFunction: true });
-const { code, map, ast } = babel.transformFromAstSync(parsedAst, sourceCode, options);
-```
-
-## babel.parse(code: string, [options?](#options): Object)
-
-Given some code, parse it using Babel's standard behavior. Referenced presets and
-plugins will be loaded such that optional syntax plugins are automatically
-enabled.
-
-
-## Advanced APIs
-
-Many systems that wrap Babel like to automatically inject plugins and presets,
-or override options. To accomplish this goal, Babel exposes several functions
-that aid in loading the configuration part-way without transforming.
-
-### babel.loadOptions([options?](#options): Object)
-
-Resolve Babel's options fully, resulting in an options object where:
-
-* `opts.plugins` is a full list of `Plugin` instances.
-* `opts.presets` is empty and all presets are flattened into `opts`.
-* It can be safely passed back to Babel. Fields like `babelrc` have been set to 
-  false so that later calls to Babel will not make a second attempt to load
-  config files.
-
-`Plugin` instances aren't meant to be manipulated directly, but often
-callers will serialize this `opts` to JSON to use it as a cache key representing
-the options Babel has received. Caching on this isn't 100% guaranteed to
-invalidate properly, but it is the best we have at the moment.
-
-
-### babel.loadPartialConfig([options?](#options): Object): PartialConfig
-
-To allow systems to easily manipulate and validate a user's config, this function
-resolves the plugins and presets and proceeds no further. The expectation is
-that callers will take the config's `.options`, manipulate it as then see fit
-and pass it back to Babel again.
-
-* `babelrc: string | void` - The path of the `.babelrc` file, if there was one.
-* `babelignore: string | void` - The path of the `.babelignore` file, if there was one.
-* `options: ValidatedOptions` - The partially resolved options, which can be manipulated and passed back to Babel again.
-  * `plugins: Array<ConfigItem>` - See below.
-  * `presets: Array<ConfigItem>` - See below.
-  * It can be safely passed back to Babel. Fields like `babelrc` have been set
-    to false so that later calls to Babel will not make a second attempt to 
-    load config files.
-* `hasFilesystemConfig(): boolean` - Check if the resolved config loaded any settings from the filesystem.
-
-[`ConfigItem`](#configitem-type) instances expose properties to introspect the values, but each
-item should be treated as immutable. If changes are desired, the item should be
-removed from the list and replaced with either a normal Babel config value, or
-with a replacement item created by `babel.createConfigItem`. See that
-function for information about `ConfigItem` fields.
-
-
-### babel.createConfigItem(value: string | {} | Function | [string | {} | Function, {} | void], { dirname?: string, type?: "preset" | "plugin" }): ConfigItem
-
-Allows build tooling to create and cache config items up front. If this function
-is called multiple times for a given plugin, Babel will call the plugin's function itself
-multiple times. If you have a clear set of expected plugins and presets to
-inject, pre-constructing the config items would be recommended.
-
-
-### `ConfigItem` type
-
-Each `ConfigItem` exposes all of the information Babel knows. The fields are:
-
-* `value: {} | Function` - The resolved value of the plugin.
-* `options: {} | void` - The options object passed to the plugin.
-* `dirname: string` - The path that the options are relative to.
-* `name: string | void` - The name that the user gave the plugin instance, e.g. `plugins: [ ['env', {}, 'my-env'] ]` 
-* `file: Object | void` - Information about the plugin's file, if Babel knows it.
-  * `request: string` - The file that the user requested, e.g. `"@babel/env"`
-  * `resolved: string` - The full path of the resolved file, e.g. `"/tmp/node_modules/@babel/preset-env/lib/index.js"`
-
-
-## Options
-
-<blockquote class="babel-callout babel-callout-info">
-  <h4>Babel CLI</h4>
-  <p>
-    You can pass these options from the Babel CLI like so:
-  </p>
-  <p>
-    <code>babel --option-name<span class="o">=</span>value</code>
-  </p>
-</blockquote>
-
-Following is a table of the options you can use:
-
-| Option                   | Default              | Description                     |
-| ------------------------ | -------------------- | ------------------------------- |
-| `ast`                    | `false`              | Include the AST in the returned object |
-| `auxiliaryCommentAfter`  | `null`               | Attach a comment after all non-user injected code |
-| `auxiliaryCommentBefore` | `null`               | Attach a comment before all non-user injected code |
-| `root`                   | `"."`                | Specify the "root" folder that defines the location to search for "babel.config.js", and the default folder to allow `.babelrc` files inside of.|
-| `configFile`             | `undefined`          | The config file to load Babel's config from. Defaults to searching for "babel.config.js" inside the "root" folder. `false` will disable searching for config files.|
-| `babelrc`                | `true`               | Specify whether or not to use .babelrc and .babelignore files. Not available when using the CLI, [use `--no-babelrc` instead](https://babeljs.io/docs/usage/cli/#babel-ignoring-babelrc) |
-| `babelrcRoots`           | `(root)`             | Specify which packages should be search for .babelrc files when they are being compiled. `true` to _always_ search, or a path string or an array of paths to packages to search inside of. Defaults to only searching the "root" package. |
-| `envName`                | env vars             | Defaults to environment variable `BABEL_ENV` if set, or else `NODE_ENV` if set, or else it defaults to `"development"` |
-| `code`                   | `true`               | Enable code generation |
-| `comments`               | `true`               | Output comments in generated output |
-| `compact`                | `"auto"`             | Do not include superfluous whitespace characters and line terminators. When set to `"auto"` compact is set to `true` on input sizes of >500KB |
-| `env`                    | `{}`                 | This is an object of keys that represent different environments. For example, you may have: `{ env: { production: { /* specific options */ } } }` which will use those options when the `envName` is `production` |
-| `extends`                | `null`               | A path to a `.babelrc` file to extend |
-| `filename`               | `"unknown"`          | Filename for use in errors etc |
-| `filenameRelative`       | `(filename)`         | Filename relative to `sourceRoot` |
-| `generatorOpts`          | `{}`                 | An object containing the options to be passed down to the babel code generator, @babel/generator |
-| `getModuleId`            | `null`               | Specify a custom callback to generate a module id with. Called as `getModuleId(moduleName)`. If falsy value is returned then the generated module id is used |
-| `highlightCode`          | `true`               | ANSI highlight syntax error code frames |
-| `ignore`                 | `null`               | Opposite to the `only` option. `ignore` is disregarded if `only` is specified |
-| `inputSourceMap`         | `null`               | A source map object that the output source map will be based on |
-| `minified`               | `false`              | Should the output be minified (not printing last semicolons in blocks, printing literal string values instead of escaped ones, stripping `()` from `new` when safe) |
-| `moduleId`               | `null`               | Specify a custom name for module ids |
-| `moduleIds`              | `false`              | If truthy, insert an explicit id for modules. By default, all modules are anonymous. (Not available for `common` modules) |
-| `moduleRoot`             | `(sourceRoot)`       | Optional prefix for the AMD module formatter that will be prepend to the filename on module definitions |
-| `only`                   | `null`               | A [glob](https://github.com/isaacs/minimatch), regex, or mixed array of both, matching paths to **only** compile. Can also be an array of arrays containing paths to explicitly match. When attempting to compile a non-matching file it's returned verbatim |
-| `parserOpts`             | `{}`                 | An object containing the options to be passed down to the babel parser, @babel/parser |
-| `plugins`                | `[]`                 | List of [plugins](https://babeljs.io/docs/plugins/) to load and use |
-| `presets`                | `[]`                 | List of [presets](https://babeljs.io/docs/plugins/#presets) (a set of plugins) to load and use |
-| `retainLines`            | `false`              | Retain line numbers. This will lead to wacky code but is handy for scenarios where you can't use source maps. (**NOTE:** This will not retain the columns) |
-| `shouldPrintComment`     | `null`               | An optional callback that controls whether a comment should be output or not. Called as `shouldPrintComment(commentContents)`. **NOTE:** This overrides the `comment` option when used |
-| `sourceFileName`         | `(filenameRelative)` | Set `sources[0]` on returned source map |
-| `sourceMaps`             | `false`              | If truthy, adds a `map` property to returned output. If set to `"inline"`, a comment with a sourceMappingURL directive is added to the bottom of the returned code. If set to `"both"` then a `map` property is returned as well as a source map comment appended. **This does not emit sourcemap files by itself!** To have sourcemaps emitted using the CLI, you must pass it the `--source-maps` option |
-| `sourceRoot`             | `(moduleRoot)`       | The root from which all sources are relative |
-| `sourceType`             | `"module"`           | Indicate the mode the code should be parsed in. Can be one of "script", "module", or "unambiguous". `"unambiguous"` will make Babel attempt to _guess_, based on the presence of ES6 `import` or `export` statements. Files with ES6 `import`s and `export`s are considered `"module"` and are otherwise `"script"`. |
-| `wrapPluginVisitorMethod`| `null`               | An optional callback that can be used to wrap visitor methods. **NOTE:** This is useful for things like introspection, and not really needed for implementing anything. Called as `wrapPluginVisitorMethod(pluginAlias, visitorType, callback)`.

packages/babel-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/core",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Babel compiler core.",
   "main": "lib/index.js",
   "author": "Sebastian McKenzie <sebmck@gmail.com>",
@@ -27,28 +27,27 @@
   },
   "browser": {
     "./lib/config/files/index.js": "./lib/config/files/index-browser.js",
-    "./lib/transform-file.js": "./lib/transform-file-browser.js",
-    "./lib/transform-file-sync.js": "./lib/transform-file-sync-browser.js"
+    "./lib/transform-file.js": "./lib/transform-file-browser.js"
   },
   "dependencies": {
-    "@babel/code-frame": "7.0.0-beta.48",
-    "@babel/generator": "7.0.0-beta.48",
-    "@babel/helpers": "7.0.0-beta.48",
-    "@babel/parser": "7.0.0-beta.48",
-    "@babel/template": "7.0.0-beta.48",
-    "@babel/traverse": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48",
+    "@babel/code-frame": "7.0.0-beta.50",
+    "@babel/generator": "7.0.0-beta.50",
+    "@babel/helpers": "7.0.0-beta.50",
+    "@babel/parser": "7.0.0-beta.50",
+    "@babel/template": "7.0.0-beta.50",
+    "@babel/traverse": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50",
     "convert-source-map": "^1.1.0",
     "debug": "^3.1.0",
     "json5": "^0.5.0",
     "lodash": "^4.17.5",
-    "micromatch": "^2.3.11",
+    "micromatch": "^3.1.10",
     "resolve": "^1.3.2",
     "semver": "^5.4.1",
     "source-map": "^0.5.0"
   },
   "devDependencies": {
-    "@babel/helper-transform-fixture-test-runner": "7.0.0-beta.48",
-    "@babel/register": "7.0.0-beta.48"
+    "@babel/helper-transform-fixture-test-runner": "7.0.0-beta.50",
+    "@babel/register": "7.0.0-beta.50"
   }
 }

packages/babel-core/src/config/config-chain.js

@@ -236,11 +236,13 @@ function babelrcLoadEnabled(
   return micromatch(pkgData.directories, babelrcPatterns).length > 0;
 }
 
-const validateConfigFile = makeWeakCache((file: ConfigFile): ValidatedFile => ({
-  filepath: file.filepath,
-  dirname: file.dirname,
-  options: validate("configfile", file.options),
-}));
+const validateConfigFile = makeWeakCache(
+  (file: ConfigFile): ValidatedFile => ({
+    filepath: file.filepath,
+    dirname: file.dirname,
+    options: validate("configfile", file.options),
+  }),
+);
 
 const validateBabelrcFile = makeWeakCache(
   (file: ConfigFile): ValidatedFile => ({
@@ -250,11 +252,13 @@ const validateBabelrcFile = makeWeakCache(
   }),
 );
 
-const validateExtendFile = makeWeakCache((file: ConfigFile): ValidatedFile => ({
-  filepath: file.filepath,
-  dirname: file.dirname,
-  options: validate("extendsfile", file.options),
-}));
+const validateExtendFile = makeWeakCache(
+  (file: ConfigFile): ValidatedFile => ({
+    filepath: file.filepath,
+    dirname: file.dirname,
+    options: validate("extendsfile", file.options),
+  }),
+);
 
 /**
  * Build a config chain for just the programmatic options passed into Babel.

packages/babel-core/src/config/files/configuration.js

@@ -198,8 +198,9 @@ const readConfigJS = makeStrongCache(
 
 const packageToBabelConfig = makeWeakCache(
   (file: ConfigFile): ConfigFile | null => {
-    if (typeof file.options.babel === "undefined") return null;
-    const babel = file.options.babel;
+    const babel = file.options[("babel": string)];
+
+    if (typeof babel === "undefined") return null;
 
     if (typeof babel !== "object" || Array.isArray(babel) || babel === null) {
       throw new Error(`${file.filepath}: .babel property must be an object`);

packages/babel-core/src/config/index.js

@@ -17,10 +17,3 @@ export function loadOptions(opts: {}): Object | null {
 
   return config ? config.options : null;
 }
-
-// For easier backward-compatibility, provide an API like the one we exposed in Babel 6.
-export class OptionManager {
-  init(opts: {}) {
-    return loadOptions(opts);
-  }
-}

packages/babel-core/src/config/partial.js

@@ -60,9 +60,7 @@ export default function loadPrivatePartialConfig(
   options.cwd = context.cwd;
   options.root = context.root;
   options.filename =
-    typeof context.filename === "string"
-      ? path.relative(context.cwd, context.filename)
-      : undefined;
+    typeof context.filename === "string" ? context.filename : undefined;
 
   options.plugins = configChain.plugins.map(descriptor =>
     createItemFromDescriptor(descriptor),

packages/babel-core/src/index.js

@@ -13,26 +13,22 @@ export * as types from "@babel/types";
 export { default as traverse } from "@babel/traverse";
 export { default as template } from "@babel/template";
 
-export { loadPartialConfig, loadOptions, OptionManager } from "./config";
-
 export { createConfigItem } from "./config/item";
 
-export function Plugin(alias: string) {
-  throw new Error(
-    `The (${alias}) Babel 5 plugin is being run with an unsupported Babel version.`,
-  );
-}
+export { loadPartialConfig, loadOptions } from "./config";
 
-export { default as transform } from "./transform";
-export { default as transformSync } from "./transform-sync";
-
-export { default as transformFile } from "./transform-file";
-export { default as transformFileSync } from "./transform-file-sync";
-
-export { default as transformFromAst } from "./transform-ast";
-export { default as transformFromAstSync } from "./transform-ast-sync";
-
-export { default as parse } from "./parse";
+export { transform, transformSync, transformAsync } from "./transform";
+export {
+  transformFile,
+  transformFileSync,
+  transformFileAsync,
+} from "./transform-file";
+export {
+  transformFromAst,
+  transformFromAstSync,
+  transformFromAstAsync,
+} from "./transform-ast";
+export { parse, parseSync, parseAsync } from "./parse";
 
 /**
  * Recommended set of compilable extensions. Not used in @babel/core directly, but meant as
@@ -45,3 +41,17 @@ export const DEFAULT_EXTENSIONS = Object.freeze([
   ".es",
   ".mjs",
 ]);
+
+// For easier backward-compatibility, provide an API like the one we exposed in Babel 6.
+import { loadOptions } from "./config";
+export class OptionManager {
+  init(opts: {}) {
+    return loadOptions(opts);
+  }
+}
+
+export function Plugin(alias: string) {
+  throw new Error(
+    `The (${alias}) Babel 5 plugin is being run with an unsupported Babel version.`,
+  );
+}

packages/babel-core/src/parse.js

@@ -6,17 +6,79 @@ import normalizeOptions from "./transformation/normalize-opts";
 
 type AstRoot = BabelNodeFile | BabelNodeProgram;
 
-export default function parse(
-  code: string,
-  opts: InputOptions,
-): AstRoot | null {
+export type ParseResult = AstRoot;
+
+export type FileParseCallback = {
+  (Error, null): any,
+  (null, ParseResult | null): any,
+};
+
+type Parse = {
+  (code: string, callback: FileParseCallback): void,
+  (code: string, opts: ?InputOptions, callback: FileParseCallback): void,
+
+  // Here for backward-compatibility. Ideally use ".parseSync" if you want
+  // a synchronous API.
+  (code: string, opts: ?InputOptions): ParseResult | null,
+};
+
+export const parse: Parse = (function parse(code, opts, callback) {
+  if (typeof opts === "function") {
+    opts = undefined;
+    callback = opts;
+  }
+
+  // For backward-compat with Babel 7's early betas, we allow sync parsing when
+  // no callback is given. Will be dropped in some future Babel major version.
+  if (callback === undefined) return parseSync(code, opts);
+
   const config = loadConfig(opts);
 
   if (config === null) {
     return null;
   }
 
-  const file = normalizeFile(config.passes, normalizeOptions(config), code);
+  // Reassign to keep Flowtype happy.
+  const cb = callback;
 
-  return file.ast;
+  // Just delaying the transform one tick for now to simulate async behavior
+  // but more async logic may land here eventually.
+  process.nextTick(() => {
+    let ast = null;
+    try {
+      const cfg = loadConfig(opts);
+      if (cfg === null) return cb(null, null);
+
+      ast = normalizeFile(cfg.passes, normalizeOptions(cfg), code).ast;
+    } catch (err) {
+      return cb(err);
+    }
+
+    cb(null, ast);
+  });
+}: Function);
+
+export function parseSync(
+  code: string,
+  opts?: InputOptions,
+): ParseResult | null {
+  const config = loadConfig(opts);
+
+  if (config === null) {
+    return null;
+  }
+
+  return normalizeFile(config.passes, normalizeOptions(config), code).ast;
+}
+
+export function parseAsync(
+  code: string,
+  opts?: InputOptions,
+): Promise<ParseResult | null> {
+  return new Promise((res, rej) => {
+    parse(code, opts, (err, result) => {
+      if (err == null) res(result);
+      else rej(err);
+    });
+  });
 }

packages/babel-core/src/transform-ast-sync.js

@@ -1,18 +0,0 @@
-// @flow
-import loadConfig, { type InputOptions } from "./config";
-import { runSync, type FileResult } from "./transformation";
-
-type AstRoot = BabelNodeFile | BabelNodeProgram;
-
-export default function transformFromAstSync(
-  ast: AstRoot,
-  code: string,
-  opts: ?InputOptions,
-): FileResult | null {
-  const config = loadConfig(opts);
-  if (config === null) return null;
-
-  if (!ast) throw new Error("No AST given");
-
-  return runSync(config, code, ast);
-}

packages/babel-core/src/transform-ast.js

@@ -2,16 +2,15 @@
 
 import loadConfig, { type InputOptions } from "./config";
 import {
+  runSync,
   runAsync,
   type FileResult,
   type FileResultCallback,
 } from "./transformation";
 
-import transformAstSync from "./transform-ast-sync";
-
 type AstRoot = BabelNodeFile | BabelNodeProgram;
 
-type TransformAst = {
+type TransformFromAst = {
   (ast: AstRoot, code: string, callback: FileResultCallback): void,
   (
     ast: AstRoot,
@@ -25,7 +24,12 @@ type TransformAst = {
   (ast: AstRoot, code: string, opts: ?InputOptions): FileResult | null,
 };
 
-export default ((function transformFromAst(ast, code, opts, callback) {
+export const transformFromAst: TransformFromAst = (function transformFromAst(
+  ast,
+  code,
+  opts,
+  callback,
+) {
   if (typeof opts === "function") {
     opts = undefined;
     callback = opts;
@@ -33,7 +37,7 @@ export default ((function transformFromAst(ast, code, opts, callback) {
 
   // For backward-compat with Babel 6, we allow sync transformation when
   // no callback is given. Will be dropped in some future Babel major version.
-  if (callback === undefined) return transformAstSync(ast, code, opts);
+  if (callback === undefined) return transformFromAstSync(ast, code, opts);
 
   // Reassign to keep Flowtype happy.
   const cb = callback;
@@ -53,4 +57,30 @@ export default ((function transformFromAst(ast, code, opts, callback) {
 
     runAsync(cfg, code, ast, cb);
   });
-}: Function): TransformAst);
+}: Function);
+
+export function transformFromAstSync(
+  ast: AstRoot,
+  code: string,
+  opts: ?InputOptions,
+): FileResult | null {
+  const config = loadConfig(opts);
+  if (config === null) return null;
+
+  if (!ast) throw new Error("No AST given");
+
+  return runSync(config, code, ast);
+}
+
+export function transformFromAstAsync(
+  ast: AstRoot,
+  code: string,
+  opts: ?InputOptions,
+): Promise<FileResult | null> {
+  return new Promise((res, rej) => {
+    transformFromAst(ast, code, opts, (err, result) => {
+      if (err == null) res(result);
+      else rej(err);
+    });
+  });
+}

packages/babel-core/src/transform-file-sync.js

@@ -1,25 +0,0 @@
-// @flow
-import fs from "fs";
-
-import loadConfig, { type InputOptions } from "./config";
-import { runSync, type FileResult } from "./transformation";
-
-export default function transformFileSync(
-  filename: string,
-  opts: ?InputOptions,
-): FileResult | null {
-  let options;
-  if (opts == null) {
-    options = { filename };
-  } else if (opts && typeof opts === "object") {
-    options = {
-      ...opts,
-      filename,
-    };
-  }
-
-  const config = loadConfig(options);
-  if (config === null) return null;
-
-  return runSync(config, fs.readFileSync(filename, "utf8"));
-}

packages/babel-core/src/transform-file.js

@@ -2,14 +2,23 @@
 import fs from "fs";
 
 import loadConfig, { type InputOptions } from "./config";
-import { runAsync, type FileResultCallback } from "./transformation";
+import {
+  runSync,
+  runAsync,
+  type FileResult,
+  type FileResultCallback,
+} from "./transformation";
 
 type TransformFile = {
   (filename: string, callback: FileResultCallback): void,
   (filename: string, opts: ?InputOptions, callback: FileResultCallback): void,
 };
 
-export default ((function transformFile(filename, opts, callback) {
+export const transformFile: TransformFile = (function transformFile(
+  filename,
+  opts,
+  callback,
+) {
   let options;
   if (typeof opts === "function") {
     callback = opts;
@@ -43,4 +52,36 @@ export default ((function transformFile(filename, opts, callback) {
       runAsync(config, code, null, callback);
     });
   });
-}: Function): TransformFile);
+}: Function);
+
+export function transformFileSync(
+  filename: string,
+  opts: ?InputOptions,
+): FileResult | null {
+  let options;
+  if (opts == null) {
+    options = { filename };
+  } else if (opts && typeof opts === "object") {
+    options = {
+      ...opts,
+      filename,
+    };
+  }
+
+  const config = loadConfig(options);
+  if (config === null) return null;
+
+  return runSync(config, fs.readFileSync(filename, "utf8"));
+}
+
+export function transformFileAsync(
+  filename: string,
+  opts: ?InputOptions,
+): Promise<FileResult | null> {
+  return new Promise((res, rej) => {
+    transformFile(filename, opts, (err, result) => {
+      if (err == null) res(result);
+      else rej(err);
+    });
+  });
+}

packages/babel-core/src/transform-sync.js

@@ -1,13 +0,0 @@
-// @flow
-import loadConfig, { type InputOptions } from "./config";
-import { runSync, type FileResult } from "./transformation";
-
-export default function transformSync(
-  code: string,
-  opts: ?InputOptions,
-): FileResult | null {
-  const config = loadConfig(opts);
-  if (config === null) return null;
-
-  return runSync(config, code);
-}

packages/babel-core/src/transform.js

@@ -1,13 +1,12 @@
 // @flow
 import loadConfig, { type InputOptions } from "./config";
 import {
+  runSync,
   runAsync,
   type FileResult,
   type FileResultCallback,
 } from "./transformation";
 
-import transformSync from "./transform-sync";
-
 type Transform = {
   (code: string, callback: FileResultCallback): void,
   (code: string, opts: ?InputOptions, callback: FileResultCallback): void,
@@ -17,7 +16,7 @@ type Transform = {
   (code: string, opts: ?InputOptions): FileResult | null,
 };
 
-export default ((function transform(code, opts, callback) {
+export const transform: Transform = (function transform(code, opts, callback) {
   if (typeof opts === "function") {
     opts = undefined;
     callback = opts;
@@ -43,4 +42,26 @@ export default ((function transform(code, opts, callback) {
 
     runAsync(cfg, code, null, cb);
   });
-}: Function): Transform);
+}: Function);
+
+export function transformSync(
+  code: string,
+  opts: ?InputOptions,
+): FileResult | null {
+  const config = loadConfig(opts);
+  if (config === null) return null;
+
+  return runSync(config, code);
+}
+
+export function transformAsync(
+  code: string,
+  opts: ?InputOptions,
+): Promise<FileResult | null> {
+  return new Promise((res, rej) => {
+    transform(code, opts, (err, result) => {
+      if (err == null) res(result);
+      else rej(err);
+    });
+  });
+}

packages/babel-core/src/transformation/plugin-pass.js

@@ -8,10 +8,11 @@ export default class PluginPass {
   file: File;
   opts: Object;
 
-  // The working directory that Babel's options are loaded relative to.
+  // The working directory that Babel's programmatic options are loaded
+  // relative to.
   cwd: string;
 
-  // The path of the file being compiled, relative to the working directory.
+  // The absolute path of the file being compiled.
   filename: string | void;
 
   constructor(file: File, key: ?string, options: ?Object) {

packages/babel-core/test/config-chain.js

@@ -936,7 +936,7 @@ describe("buildConfigChain", function() {
         }),
       ).toEqual({
         ...getDefaults(),
-        filename: path.basename(filename),
+        filename: filename,
         cwd: path.dirname(filename),
         root: path.dirname(filename),
         comments: true,
@@ -948,7 +948,7 @@ describe("buildConfigChain", function() {
 
       expect(loadOptions({ filename, cwd: path.dirname(filename) })).toEqual({
         ...getDefaults(),
-        filename: path.basename(filename),
+        filename: filename,
         cwd: path.dirname(filename),
         root: path.dirname(filename),
         comments: true,
@@ -960,7 +960,7 @@ describe("buildConfigChain", function() {
 
       expect(loadOptions({ filename, cwd: path.dirname(filename) })).toEqual({
         ...getDefaults(),
-        filename: path.basename(filename),
+        filename: filename,
         cwd: path.dirname(filename),
         root: path.dirname(filename),
         comments: true,
@@ -1002,7 +1002,7 @@ describe("buildConfigChain", function() {
 
       expect(loadOptions({ filename, cwd: path.dirname(filename) })).toEqual({
         ...getDefaults(),
-        filename: path.basename(filename),
+        filename: filename,
         cwd: path.dirname(filename),
         root: path.dirname(filename),
         comments: true,

packages/babel-core/test/fixtures/option-manager/presets/es2015_default_function.js

@@ -12,6 +12,11 @@ Object.defineProperty(exports, "__esModule", {
 
 exports.default = function () {
   return {
-    plugins: [require('../../../../../babel-plugin-syntax-decorators')]
+    plugins: [
+      [
+        require('../../../../../babel-plugin-syntax-decorators'),
+        { legacy: true }
+      ],
+    ]
   };
 };

packages/babel-core/test/fixtures/option-manager/presets/es2015_default_object.js

@@ -9,6 +9,11 @@
 exports.__esModule = true;
 module.exports = function() {
   return {
-    plugins: [require('../../../../../babel-plugin-syntax-decorators')]
+    plugins: [
+      [
+        require('../../../../../babel-plugin-syntax-decorators'),
+        { legacy: true }
+      ],
+    ]
   };
 };

packages/babel-core/test/fixtures/option-manager/presets/es5_function.js

@@ -1,7 +1,10 @@
 module.exports = function () {
   return {
     plugins: [
-      require('../../../../../babel-plugin-syntax-decorators'),
+      [
+        require('../../../../../babel-plugin-syntax-decorators'),
+        { legacy: true }
+      ],
     ]
   };
 };

packages/babel-core/test/fixtures/option-manager/presets/es5_object.js

@@ -1,7 +1,10 @@
 module.exports = function() {
   return {
     plugins: [
-      require('../../../../../babel-plugin-syntax-decorators'),
+      [
+        require('../../../../../babel-plugin-syntax-decorators'),
+        { legacy: true }
+      ],
     ]
   };
 };

packages/babel-core/test/fixtures/parse/output.json

@@ -58,7 +58,7 @@
                 "column": 11
               }
             },
-            "callee": {
+            "expression": {
               "type": "Identifier",
               "start": 1,
               "end": 11,

packages/babel-generator/README.md

@@ -1,78 +1,19 @@
 # @babel/generator
 
-> Turns the [babel AST](https://github.com/babel/babel/blob/master/packages/babel-parser/ast/spec.md) into code.
+> Turns an AST into code.
+
+See our website [@babel/generator](https://new.babeljs.io/docs/en/next/babel-generator.html) for more information or the [issues](https://github.com/babel/babel/issues?utf8=%E2%9C%93&q=is%3Aissue+label%3A%22pkg%3A%20generator%22+is%3Aopen) associated with this package.
 
 ## Install
 
+Using npm:
+
 ```sh
-npm install --save-dev @babel/generator
+npm install --save @babel/generator
 ```
 
-## Usage
+or using yarn:
 
-```js
-import {parse} from '@babel/parser';
-import generate from '@babel/generator';
-
-const code = 'class Example {}';
-const ast = parse(code);
-
-const output = generate(ast, { /* options */ }, code);
-```
-
-## Options
-
-Options for formatting output:
-
-name                   | type     | default         | description
------------------------|----------|-----------------|--------------------------------------------------------------------------
-auxiliaryCommentBefore | string   |                 | Optional string to add as a block comment at the start of the output file
-auxiliaryCommentAfter  | string   |                 | Optional string to add as a block comment at the end of the output file
-shouldPrintComment     | function | `opts.comments` | Function that takes a comment (as a string) and returns `true` if the comment should be included in the output.  By default, comments are included if `opts.comments` is `true` or if `opts.minifed` is `false` and the comment contains `@preserve` or `@license`
-retainLines            | boolean  | `false`         | Attempt to use the same line numbers in the output code as in the source code (helps preserve stack traces)
-retainFunctionParens   | boolean  | `false`         | Retain parens around function expressions (could be used to change engine parsing behavior)
-comments               | boolean  | `true`          | Should comments be included in output
-compact                | boolean or `'auto'` | `opts.minified` | Set to `true` to avoid adding whitespace for formatting
-minified               | boolean  | `false`         | Should the output be minified
-concise                | boolean  | `false`         | Set to `true` to reduce whitespace (but not as much as `opts.compact`)
-filename               | string   |                 | Used in warning messages
-jsonCompatibleStrings  | boolean  | `false`         | Set to true to run `jsesc` with "json": true to print "\u00A9" vs. "©";
-
-Options for source maps:
-
-name                   | type     | default         | description
------------------------|----------|-----------------|--------------------------------------------------------------------------
-sourceMaps             | boolean  | `false`         | Enable generating source maps
-sourceRoot             | string   |                 | A root for all relative URLs in the source map
-sourceFileName         | string   |                 | The filename for the source code (i.e. the code in the `code` argument).  This will only be used if `code` is a string.
-
-## AST from Multiple Sources
-
-In most cases, Babel does a 1:1 transformation of input-file to output-file.  However,
-you may be dealing with AST constructed from multiple sources - JS files, templates, etc.
-If this is the case, and you want the sourcemaps to reflect the correct sources, you'll need
-to pass an object to `generate` as the `code` parameter.  Keys
-should be the source filenames, and values should be the source content.
-
-Here's an example of what that might look like:
-
-```js
-import {parse} from '@babel/parser';
-import generate from '@babel/generator';
-
-const a = 'var a = 1;';
-const b = 'var b = 2;';
-const astA = parse(a, { sourceFilename: 'a.js' });
-const astB = parse(b, { sourceFilename: 'b.js' });
-const ast = {
-  type: 'Program',
-  body: [].concat(astA.program.body, astB.program.body)
-};
-
-const { code, map } = generate(ast, { sourceMaps: true }, {
-  'a.js': a,
-  'b.js': b
-});
-
-// Sourcemap will point to both a.js and b.js where appropriate.
+```sh
+yarn add --save @babel/generator
 ```

packages/babel-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/generator",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Turns an AST into code.",
   "author": "Sebastian McKenzie <sebmck@gmail.com>",
   "homepage": "https://babeljs.io/",
@@ -11,14 +11,14 @@
     "lib"
   ],
   "dependencies": {
-    "@babel/types": "7.0.0-beta.48",
+    "@babel/types": "7.0.0-beta.50",
     "jsesc": "^2.5.1",
     "lodash": "^4.17.5",
     "source-map": "^0.5.0",
     "trim-right": "^1.0.1"
   },
   "devDependencies": {
-    "@babel/helper-fixtures": "7.0.0-beta.48",
-    "@babel/parser": "7.0.0-beta.48"
+    "@babel/helper-fixtures": "7.0.0-beta.50",
+    "@babel/parser": "7.0.0-beta.50"
   }
 }

packages/babel-generator/src/generators/classes.js

@@ -2,8 +2,9 @@ import * as t from "@babel/types";
 
 export function ClassDeclaration(node: Object, parent: Object) {
   if (
-    !t.isExportDefaultDeclaration(parent) &&
-    !t.isExportNamedDeclaration(parent)
+    !this.format.decoratorsBeforeExport ||
+    (!t.isExportDefaultDeclaration(parent) &&
+      !t.isExportNamedDeclaration(parent))
   ) {
     this.printJoin(node.decorators, node);
   }

packages/babel-generator/src/generators/expressions.js

@@ -92,7 +92,7 @@ export function Super() {
 
 export function Decorator(node: Object) {
   this.token("@");
-  this.print(node.callee, node);
+  this.print(node.expression, node);
   this.newline();
 }
 

packages/babel-generator/src/generators/flow.js

@@ -472,6 +472,10 @@ export function ObjectTypeIndexer(node: Object) {
 }
 
 export function ObjectTypeProperty(node: Object) {
+  if (node.proto) {
+    this.word("proto");
+    this.space();
+  }
   if (node.static) {
     this.word("static");
     this.space();

packages/babel-generator/src/generators/modules.js

@@ -57,7 +57,10 @@ export function ExportAllDeclaration(node: Object) {
 }
 
 export function ExportNamedDeclaration(node: Object) {
-  if (t.isClassDeclaration(node.declaration)) {
+  if (
+    this.format.decoratorsBeforeExport &&
+    t.isClassDeclaration(node.declaration)
+  ) {
     this.printJoin(node.declaration.decorators, node);
   }
 
@@ -67,7 +70,10 @@ export function ExportNamedDeclaration(node: Object) {
 }
 
 export function ExportDefaultDeclaration(node: Object) {
-  if (t.isClassDeclaration(node.declaration)) {
+  if (
+    this.format.decoratorsBeforeExport &&
+    t.isClassDeclaration(node.declaration)
+  ) {
     this.printJoin(node.declaration.decorators, node);
   }
 

packages/babel-generator/src/generators/types.js

@@ -132,10 +132,7 @@ export function StringLiteral(node: Object) {
   }
 
   // ensure the output is ASCII-safe
-  const opts = {
-    quotes: "double",
-    wrap: true,
-  };
+  const opts = this.format.jsescOption;
   if (this.format.jsonCompatibleStrings) {
     opts.json = true;
   }

packages/babel-generator/src/index.js

@@ -52,6 +52,12 @@ function normalizeOptions(code, opts): Format {
       style: "  ",
       base: 0,
     },
+    decoratorsBeforeExport: !!opts.decoratorsBeforeExport,
+    jsescOption: {
+      quotes: "double",
+      wrap: true,
+      ...opts.jsescOption,
+    },
   };
 
   if (format.minified) {

packages/babel-generator/src/printer.js

@@ -25,6 +25,7 @@ export type Format = {
     style: string,
     base: number,
   },
+  decoratorsBeforeExport: boolean,
 };
 
 export default class Printer {

packages/babel-generator/test/fixtures/decoratorsBeforeExport/false-to-false/input.js

@@ -0,0 +1,3 @@
+export default @dec class Foo {}
+
+export @dec class Bar {}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/false-to-false/options.json

@@ -0,0 +1,6 @@
+{
+  "plugins": [
+    ["decorators", { "decoratorsBeforeExport": false }]
+  ],
+  "decoratorsBeforeExport": false
+}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/false-to-false/output.js

@@ -0,0 +1,4 @@
+export default @dec
+class Foo {}
+export @dec
+class Bar {}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/false-to-true/input.js

@@ -0,0 +1,3 @@
+export default @dec class Foo {}
+
+export @dec class Bar {}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/false-to-true/options.json

@@ -0,0 +1,6 @@
+{
+  "plugins": [
+    ["decorators", { "decoratorsBeforeExport": false }]
+  ],
+  "decoratorsBeforeExport": true
+}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/false-to-true/output.js

@@ -0,0 +1,4 @@
+@dec
+export default class Foo {}
+@dec
+export class Bar {}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/true-to-false/input.js

@@ -0,0 +1,5 @@
+@dec
+export default class Foo {}
+
+@dec
+export class Bar {}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/true-to-false/options.json

@@ -0,0 +1,6 @@
+{
+  "plugins": [
+    ["decorators", { "decoratorsBeforeExport": true }]
+  ],
+  "decoratorsBeforeExport": false
+}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/true-to-false/output.js

@@ -0,0 +1,4 @@
+export default @dec
+class Foo {}
+export @dec
+class Bar {}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/true-to-true/input.js

@@ -0,0 +1,5 @@
+@dec
+export default class Foo {}
+
+@dec
+export class Bar {}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/true-to-true/options.json

@@ -0,0 +1,6 @@
+{
+  "plugins": [
+    ["decorators", { "decoratorsBeforeExport": true }]
+  ],
+  "decoratorsBeforeExport": true
+}

packages/babel-generator/test/fixtures/decoratorsBeforeExport/true-to-true/output.js

@@ -0,0 +1,4 @@
+@dec
+export default class Foo {}
+@dec
+export class Bar {}

packages/babel-generator/test/fixtures/types/Decorator/output.js

@@ -32,15 +32,15 @@ class Foo {
 
 }
 
-@foo
-export default class Foo {
+export default @foo
+class Foo {
   bar() {
     class Baz {}
   }
 
 }
-@foo
-export class Foo {
+export @foo
+class Foo {
   bar() {
     class Baz {}
   }

packages/babel-helper-annotate-as-pure/README.md

@@ -1,40 +1,19 @@
 # @babel/helper-annotate-as-pure
 
-## API
+> Helper function to annotate paths and nodes with #__PURE__ comment
 
-```js
-declare export default annotateAsPure(nodeOrPath: Node | NodePath);
+See our website [@babel/helper-annotate-as-pure](https://new.babeljs.io/docs/en/next/babel-helper-annotate-as-pure.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-annotate-as-pure
 ```
 
-## Usage
+or using yarn:
 
-```js
-import traverse from "@babel/traverse";
-import annotateAsPure from "@babel/helper-annotate-as-pure";
-
-// ...
-
-traverse(file, {
-  CallExpression(path) {
-    annotateAsPure(path);
-  },
-});
-```
-
-## Caveat with UglifyJS pre v3.1.0
-
-`@babel/helper-annotate-as-pure` will append any existing leading comments to the `#__PURE__` annotation. Versions of UglifyJS prior to v3.1.0 will **ignore** these annotations, as they only check the _last_ leading comment for the annotation.
-
-For example, using the `Usage` snippet above:
-
-**In**
-
-```js
-const four = /* foo */ add(2, 2);
-```
-
-**Out**
-
-```js
-const four = /* #__PURE__ */ /* foo */ add(2, 2);
+```sh
+yarn add --save @babel/helper-annotate-as-pure
 ```

packages/babel-helper-annotate-as-pure/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@babel/helper-annotate-as-pure",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to annotate paths and nodes with #__PURE__ comment",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-annotate-as-pure",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-bindify-decorators/README.md

@@ -1,9 +1,19 @@
 # @babel/helper-bindify-decorators
 
-## API
-```javascript
-declare export default bindifyDecorators(decorators: Array<NodePath>);
-```
-## Usage
+> Helper function to bindify decorators
 
-TODO
+See our website [@babel/helper-bindify-decorators](https://new.babeljs.io/docs/en/next/babel-helper-bindify-decorators.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-bindify-decorators
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-bindify-decorators
+```

packages/babel-helper-bindify-decorators/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@babel/helper-bindify-decorators",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to bindify decorators",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-bindify-decorators",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/traverse": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/traverse": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-builder-binary-assignment-operator-visitor/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-builder-binary-assignment-operator-visitor
 
-## Usage
+> Helper function to build binary assignment operator visitors
 
-TODO
+See our website [@babel/helper-builder-binary-assignment-operator-visitor](https://new.babeljs.io/docs/en/next/babel-helper-builder-binary-assignment-operator-visitor.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-builder-binary-assignment-operator-visitor
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-builder-binary-assignment-operator-visitor
+```

packages/babel-helper-builder-binary-assignment-operator-visitor/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@babel/helper-builder-binary-assignment-operator-visitor",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to build binary assignment operator visitors",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-builder-binary-assignment-operator-visitor",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/helper-explode-assignable-expression": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/helper-explode-assignable-expression": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-builder-react-jsx/README.md

@@ -1,28 +1,19 @@
 # @babel/helper-builder-react-jsx
 
-## Usage
+> Helper function to build react jsx
 
-```javascript
-type ElementState = {
-  tagExpr: Object; // tag node
-  tagName: string; // raw string tag name
-  args: Array<Object>; // array of call arguments
-  call?: Object; // optional call property that can be set to override the call expression returned
-};
+See our website [@babel/helper-builder-react-jsx](https://new.babeljs.io/docs/en/next/babel-helper-builder-react-jsx.html) for more information.
 
-require("@babel/helper-builder-react-jsx")({
-  filter: function (element: JSXElement) {
-    // if returns false, the element isn't transformed
-  },
+## Install
 
-  pre: function (state: ElementState) {
-    // function called with (state: ElementState) before building attribs
-  },
+Using npm:
 
-  post: function (state: ElementState) {
-    // function called with (state: ElementState) after building attribs
-  },
-
-  compat?: boolean // true if React is in compat mode
-});
+```sh
+npm install --save @babel/helper-builder-react-jsx
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-builder-react-jsx
 ```

packages/babel-helper-builder-react-jsx/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@babel/helper-builder-react-jsx",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to build react jsx",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-builder-react-jsx",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/types": "7.0.0-beta.48",
+    "@babel/types": "7.0.0-beta.50",
     "esutils": "^2.0.0"
   }
 }

packages/babel-helper-builder-react-jsx/src/index.js

@@ -89,14 +89,14 @@ You can turn on the 'throwIfNamespace' flag to bypass this warning.`,
       }
     }
 
-    if (t.isValidIdentifier(node.name.name)) {
+    if (t.isJSXNamespacedName(node.name)) {
+      node.name = t.stringLiteral(
+        node.name.namespace.name + ":" + node.name.name.name,
+      );
+    } else if (esutils.keyword.isIdentifierNameES6(node.name.name)) {
       node.name.type = "Identifier";
     } else {
-      node.name = t.stringLiteral(
-        t.isJSXNamespacedName(node.name)
-          ? node.name.namespace.name + ":" + node.name.name.name
-          : node.name.name,
-      );
+      node.name = t.stringLiteral(node.name.name);
     }
 
     return t.inherits(t.objectProperty(node.name, value), node);

packages/babel-helper-call-delegate/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-call-delegate
 
-## Usage
+> Helper function to call delegate
 
-TODO
+See our website [@babel/helper-call-delegate](https://new.babeljs.io/docs/en/next/babel-helper-call-delegate.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-call-delegate
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-call-delegate
+```

packages/babel-helper-call-delegate/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@babel/helper-call-delegate",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to call delegate",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-call-delegate",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/helper-hoist-variables": "7.0.0-beta.48",
-    "@babel/traverse": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/helper-hoist-variables": "7.0.0-beta.50",
+    "@babel/traverse": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-define-map/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-define-map
 
-## Usage
+> Helper function to define a map
 
-TODO
+See our website [@babel/helper-define-map](https://new.babeljs.io/docs/en/next/babel-helper-define-map.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-define-map
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-define-map
+```

packages/babel-helper-define-map/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@babel/helper-define-map",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to define a map",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-define-map",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/helper-function-name": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48",
+    "@babel/helper-function-name": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50",
     "lodash": "^4.17.5"
   }
 }

packages/babel-helper-explode-assignable-expression/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-explode-assignable-expression
 
-## Usage
+> Helper function to explode an assignable expression
 
-TODO
+See our website [@babel/helper-explode-assignable-expression](https://new.babeljs.io/docs/en/next/babel-helper-explode-assignable-expression.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-explode-assignable-expression
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-explode-assignable-expression
+```

packages/babel-helper-explode-assignable-expression/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@babel/helper-explode-assignable-expression",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to explode an assignable expression",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-explode-assignable-expression",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/traverse": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/traverse": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-explode-class/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-explode-class
 
-## Usage
+> Helper function to explode class
 
-TODO
+See our website [@babel/helper-explode-class](https://new.babeljs.io/docs/en/next/babel-helper-explode-class.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-explode-class
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-explode-class
+```

packages/babel-helper-explode-class/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@babel/helper-explode-class",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to explode class",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-explode-class",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/helper-bindify-decorators": "7.0.0-beta.48",
-    "@babel/traverse": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/helper-bindify-decorators": "7.0.0-beta.50",
+    "@babel/traverse": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-fixtures/README.md

@@ -1,33 +1,19 @@
 # @babel/helper-fixtures
 
-**NOTE:** This is an internal Babel module and may not work outside. Use at your own risk.
+> Helper function to support fixtures
 
-## Usage
+See our website [@babel/helper-fixtures](https://new.babeljs.io/docs/en/next/babel-helper-fixtures.html) for more information.
 
-```javascript
-import getFixtures from "@babel/helper-fixtures";
+## Install
 
-type TestFile = {
-  loc: string;
-  code: string;
-  filename: string;
-};
+Using npm:
 
-type Test = {
-  title: string;
-  disabled: boolean;
-  options: Object;
-  exec: TestFile;
-  actual: TestFile;
-  expected: TestFile;
-};
-
-type Suite = {
-  options: Object;
-  tests: Array<Test>;
-  title: string;
-  filename: string;
-};
-
-let fixtures: Array<Suite> = getFixtures("/User/sebmck/Projects/babel-something/test/fixtures");
+```sh
+npm install --save @babel/helper-fixtures
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-fixtures
 ```

packages/babel-helper-fixtures/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/helper-fixtures",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to support fixtures",
   "author": "Sebastian McKenzie <sebmck@gmail.com>",
   "license": "MIT",

packages/babel-helper-function-name/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-function-name
 
-## Usage
+> Helper function to change the property 'name' of every function
 
-TODO
+See our website [@babel/helper-function-name](https://new.babeljs.io/docs/en/next/babel-helper-function-name.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-function-name
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-function-name
+```

packages/babel-helper-function-name/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@babel/helper-function-name",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to change the property 'name' of every function",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-function-name",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/helper-get-function-arity": "7.0.0-beta.48",
-    "@babel/template": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/helper-get-function-arity": "7.0.0-beta.50",
+    "@babel/template": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-get-function-arity/README.md

@@ -1,21 +1,19 @@
 # @babel/helper-get-function-arity
 
-Function that returns the number of arguments that a function takes.
-* Examples of what is considered an argument can be found at [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/length)
+> Helper function to get function arity
 
-## Usage
+See our website [@babel/helper-get-function-arity](https://new.babeljs.io/docs/en/next/babel-helper-get-function-arity.html) for more information.
 
-```javascript
-import getFunctionArity from "@babel/helper-get-function-arity";
+## Install
 
-function wrap(state, method, id, scope) {
-  // ...
-  if (!t.isFunction(method)) {
-    return false;
-  }
+Using npm:
 
-  const argumentsLength = getFunctionArity(method);
-
-  // ...
-}
+```sh
+npm install --save @babel/helper-get-function-arity
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-get-function-arity
 ```

packages/babel-helper-get-function-arity/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@babel/helper-get-function-arity",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to get function arity",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-get-function-arity",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-hoist-variables/README.md

@@ -1,17 +1,19 @@
 # @babel/helper-hoist-variables
 
-## Installation
+> Helper function to hoist variables
+
+See our website [@babel/helper-hoist-variables](https://new.babeljs.io/docs/en/next/babel-helper-hoist-variables.html) for more information.
+
+## Install
+
+Using npm:
 
 ```sh
-npm install @babel/helper-hoist-variables --save
+npm install --save @babel/helper-hoist-variables
 ```
 
-## API
+or using yarn:
 
-```javascript
-declare export default hoistVariables(path: NodePath, emit: Function, kind: "var" | "let" = "var");
+```sh
+yarn add --save @babel/helper-hoist-variables
 ```
-
-## Usage
-
-TODO

packages/babel-helper-hoist-variables/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@babel/helper-hoist-variables",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to hoist variables",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-hoist-variables",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-hoist-variables/src/index.js

@@ -29,7 +29,7 @@ const visitor = {
       }
 
       for (const name in declar.getBindingIdentifiers()) {
-        state.emit(t.identifier(name), name);
+        state.emit(t.identifier(name), name, declar.node.init !== null);
       }
     }
 

packages/babel-helper-member-expression-to-functions/README.md

@@ -1,75 +1,19 @@
 # @babel/helper-member-expression-to-functions
 
-Helper function to replace certain member expressions with function calls
+> Helper function to replace certain member expressions with function calls
 
-## Usage
+See our website [@babel/helper-member-expression-to-functions](https://new.babeljs.io/docs/en/next/babel-helper-member-expression-to-functions.html) for more information.
 
-> Designed for internal Babel use.
+## Install
 
-Traverses the `path` using the supplied `visitor` and an augmented `state`.
+Using npm:
 
-```js
-const visitor = {
-  MemberExpression(memberPath, state) {
-
-    if (someCondition(memberPath)) {
-
-      // The handle method is supplied by memberExpressionToFunctions.
-      // It should be called whenever a MemberExpression should be
-      // converted into the proper function calls.
-      state.handle(memberPath);
-
-    }
-
-  },
-};
-
-// The helper requires three special methods on state: `get`, `set`, and
-// `call`.
-// Optionally, a special `memoise` method may be defined, which gets
-// called if the member is in a self-referential update expression.
-// Everything else will be passed through as normal.
-const state = {
-  get(memberPath) {
-    // Return some AST that will get the member
-    return t.callExpression(
-      this.file.addHelper('superGet'),
-      [t.thisExpression(), memberPath.node.property]
-    );
-  },
-
-  set(memberPath, value) {
-    // Return some AST that will set the member
-    return t.callExpression(
-      this.file.addHelper('superSet'),
-      [t.thisExpression(), memberPath.node.property, value]
-    );
-  },
-
-  call(memberPath, args) {
-    // Return some AST that will call the member with the proper context
-    // and args
-    return t.callExpression(
-      t.memberExpression(this.get(memberPath), t.identifier("apply")),
-      [t.thisExpression(), t.arrayExpression(args)]
-    );
-  },
-
-  memoise(memberPath) {
-    const { node } = memberPath;
-    if (node.computed) {
-      MEMOISED.set(node, ...);
-    }
-  },
-
-  // The handle method is provided by memberExpressionToFunctions.
-  // handle(memberPath) { ... }
-
-  // Other state stuff is left untouched.
-  someState: new Set(),
-};
-
-// Replace all the special MemberExpressions in rootPath, as determined
-// by our visitor, using the state methods.
-memberExpressionToFunctions(rootPath, visitor, state);
+```sh
+npm install --save @babel/helper-member-expression-to-functions
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-member-expression-to-functions
 ```

packages/babel-helper-member-expression-to-functions/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@babel/helper-member-expression-to-functions",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to replace certain member expressions with function calls",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-member-expression-to-functions",
   "license": "MIT",
   "main": "lib/index.js",
   "author": "Justin Ridgewell <justin@ridgewell.name>",
   "dependencies": {
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-module-imports/README.md

@@ -1,77 +1,19 @@
 # @babel/helper-module-imports
 
-## Installation
+> Babel helper functions for inserting module loads
+
+See our website [@babel/helper-module-imports](https://new.babeljs.io/docs/en/next/babel-helper-module-imports.html) for more information.
+
+## Install
+
+Using npm:
 
 ```sh
-npm install @babel/helper-module-imports --save
+npm install --save @babel/helper-module-imports
 ```
 
-## Usage
+or using yarn:
 
-### `import "source"`
-
-```js
-import { addSideEffect } from "@babel/helper-module-imports";
-addSideEffect(path, 'source');
-```
-
-### `import { named } from "source"`
-
-```js
-import { addNamed } from "@babel/helper-module-imports";
-addNamed(path, 'named', 'source');
-```
-
-### `import { named as _hintedName } from "source"`
-
-```js
-import { addNamed } from "@babel/helper-module-imports";
-addNamed(path, 'named', 'source', { nameHint: "hintedName" });
-```
-
-### `import _default from "source"`
-
-```js
-import { addDefault } from "@babel/helper-module-imports";
-addDefault(path, 'source');
-```
-
-### `import hintedName from "source"`
-
-```js
-import { addDefault } from "@babel/helper-module-imports";
-addDefault(path, 'source', { nameHint: "hintedName" })
-```
-
-### `import * as _namespace from "source"`
-
-```js
-import { addNamespace } from "@babel/helper-module-imports";
-addNamespace(path, 'source');
-```
-
-## Examples
-
-### Adding a named import
-
-```js
-import { addNamed } from "@babel/helper-module-imports";
-
-export default function({ types: t }) {
-  return {
-    visitor: {
-      ReferencedIdentifier(path) {
-        let importName = this.importName;
-        if (importName) {
-          importName = t.cloneDeep(importName);
-        } else {
-          // require('bluebird').coroutine
-          importName = this.importName = addNamed(path, 'coroutine', 'bluebird');
-        }
-
-        path.replaceWith(importName);
-      }
-    },
-  };
-}
+```sh
+yarn add --save @babel/helper-module-imports
 ```

packages/babel-helper-module-imports/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/helper-module-imports",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Babel helper functions for inserting module loads",
   "author": "Logan Smyth <loganfsmyth@gmail.com>",
   "homepage": "https://babeljs.io/",
@@ -8,10 +8,10 @@
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-module-imports",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/types": "7.0.0-beta.48",
+    "@babel/types": "7.0.0-beta.50",
     "lodash": "^4.17.5"
   },
   "devDependencies": {
-    "@babel/core": "7.0.0-beta.48"
+    "@babel/core": "7.0.0-beta.50"
   }
 }

packages/babel-helper-module-transforms/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-module-transforms
 
-## Usage
+> Babel helper functions for implementing ES6 module transformations
 
-TODO
+See our website [@babel/helper-module-transforms](https://new.babeljs.io/docs/en/next/babel-helper-module-transforms.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-module-transforms
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-module-transforms
+```

packages/babel-helper-module-transforms/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/helper-module-transforms",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Babel helper functions for implementing ES6 module transformations",
   "author": "Logan Smyth <loganfsmyth@gmail.com>",
   "homepage": "https://babeljs.io/",
@@ -8,11 +8,11 @@
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-module-transforms",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/helper-module-imports": "7.0.0-beta.48",
-    "@babel/helper-simple-access": "7.0.0-beta.48",
-    "@babel/helper-split-export-declaration": "7.0.0-beta.48",
-    "@babel/template": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48",
+    "@babel/helper-module-imports": "7.0.0-beta.50",
+    "@babel/helper-simple-access": "7.0.0-beta.50",
+    "@babel/helper-split-export-declaration": "7.0.0-beta.50",
+    "@babel/template": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50",
     "lodash": "^4.17.5"
   }
 }

packages/babel-helper-optimise-call-expression/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-optimise-call-expression
 
-## Usage
+> Helper function to optimise call expression
 
-TODO
+See our website [@babel/helper-optimise-call-expression](https://new.babeljs.io/docs/en/next/babel-helper-optimise-call-expression.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-optimise-call-expression
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-optimise-call-expression
+```

packages/babel-helper-optimise-call-expression/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@babel/helper-optimise-call-expression",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to optimise call expression",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-optimise-call-expression",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/types": "7.0.0-beta.50"
   }
 }

packages/babel-helper-plugin-test-runner/README.md

@@ -1,17 +1,19 @@
 # @babel/helper-plugin-test-runner
 
-**NOTE:** This is an internal Babel module and may not work outside. Use at your own risk.
+> Helper function to support test runner
 
-## Usage:
+See our website [@babel/helper-plugin-test-runner](https://new.babeljs.io/docs/en/next/babel-helper-plugin-test-runner.html) for more information.
 
-> Check Babel for an example: https://github.com/babel/babel/tree/master/packages/babel-plugin-transform-exponentiation-operator/test
+## Install
 
-1. Inside a `/test` directory, add an `index.js` with the contents
-```js
-import runner from "@babel/helper-plugin-test-runner";
+Using npm:
 
-runner(__dirname);
+```sh
+npm install --save @babel/helper-plugin-test-runner
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-plugin-test-runner
 ```
-2. Inside `/test/fixtures`, create a folder for each suite (eg; one suite for each feature of your plugin).
-3. Suite folders may contain files and folders. Files will be transformed and run; use `expect()` assertions to verify correct behavior. Folders may contain `input.js`, `output.js`, and/or `exec.js`. The output of transforming `input.js` will be checked to match the contents of `output.js`. `exec.js`, if it exists, will be transformed and run, as with a file in the suite folder.
-3. To run a specific test, run `TEST_GREP=testName make test`. [Read more](https://github.com/babel/babel/blob/master/CONTRIBUTING.md#running-lintingtests).

packages/babel-helper-plugin-test-runner/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@babel/helper-plugin-test-runner",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to support test runner",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-plugin-test-runner",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/helper-transform-fixture-test-runner": "7.0.0-beta.48"
+    "@babel/helper-transform-fixture-test-runner": "7.0.0-beta.50"
   }
 }

packages/babel-helper-plugin-utils/README.md

@@ -1,41 +1,19 @@
 # @babel/helper-plugin-utils
 
-The intention of this module is to provide a place for us to expose a
-standardized API layer over top of what Babel's core API provides on its own.
+> General utilities for plugins to use
 
-This is not aiming to implement APIs that are missing on a given Babel version,
-but it is means to provide clear error messages if a plugin is run on a version
-of Babel that doesn't have the APIs that the plugin is trying to use.
+See our website [@babel/helper-plugin-utils](https://new.babeljs.io/docs/en/next/babel-helper-plugin-utils.html) for more information.
 
-Every one of Babel's core plugins and presets will use this module, and ideally
-because of that its size should be kept to a miminum because this may or may
-not be deduplicated when installed.
+## Install
 
+Using npm:
 
-## Usage
-
-```js
-import { declare } from "@babel/helper-plugin-utils";
-
-export default declare((api, options, dirname) => {
-  return {};
-});
+```sh
+npm install --save @babel/helper-plugin-utils
 ```
 
+or using yarn:
 
-## What this does
-
-Currently, this plugin provides a few services to ensure that plugins function
-well-enough to throw useful errors.
-
-### `options` is always passed
-
-Babel 6 does not pass a second parameter. This frequently means that plugins
-written for Babel 7 that use `options` will attempt to destructure options
-out of an `undefined` value. By supplying the default, we avoid that risk.
-
-### `api.assertVersion` always exists
-
-Babel 6 and early betas of Babel 7 do not have `assertVersion`, so this
-wrapper ensures that it exists and throws a useful error message when not
-supplied by Babel itself.
+```sh
+yarn add --save @babel/helper-plugin-utils
+```

packages/babel-helper-plugin-utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/helper-plugin-utils",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "General utilities for plugins to use",
   "author": "Logan Smyth <loganfsmyth@gmail.com>",
   "homepage": "https://babeljs.io/",

packages/babel-helper-regex/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-regex
 
-## Usage
+> Helper function to check for literal RegEx
 
-TODO
+See our website [@babel/helper-regex](https://new.babeljs.io/docs/en/next/babel-helper-regex.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-regex
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-regex
+```

packages/babel-helper-regex/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babel/helper-regex",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to check for literal RegEx",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-regex",
   "license": "MIT",

packages/babel-helper-remap-async-to-generator/README.md

@@ -1,5 +1,19 @@
 # @babel/helper-remap-async-to-generator
 
-## Usage
+> Helper function to remap async functions to generators
 
-TODO
+See our website [@babel/helper-remap-async-to-generator](https://new.babeljs.io/docs/en/next/babel-helper-remap-async-to-generator.html) for more information.
+
+## Install
+
+Using npm:
+
+```sh
+npm install --save @babel/helper-remap-async-to-generator
+```
+
+or using yarn:
+
+```sh
+yarn add --save @babel/helper-remap-async-to-generator
+```

packages/babel-helper-remap-async-to-generator/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@babel/helper-remap-async-to-generator",
-  "version": "7.0.0-beta.48",
+  "version": "7.0.0-beta.50",
   "description": "Helper function to remap async functions to generators",
   "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-remap-async-to-generator",
   "license": "MIT",
   "main": "lib/index.js",
   "dependencies": {
-    "@babel/helper-annotate-as-pure": "7.0.0-beta.48",
-    "@babel/helper-wrap-function": "7.0.0-beta.48",
-    "@babel/template": "7.0.0-beta.48",
-    "@babel/traverse": "7.0.0-beta.48",
-    "@babel/types": "7.0.0-beta.48"
+    "@babel/helper-annotate-as-pure": "7.0.0-beta.50",
+    "@babel/helper-wrap-function": "7.0.0-beta.50",
+    "@babel/template": "7.0.0-beta.50",
+    "@babel/traverse": "7.0.0-beta.50",
+    "@babel/types": "7.0.0-beta.50"
   }
 }