Migrate from "master" branch to "main" (#11715)
* Remove dead link * Use consistent "homepage" url in package.json * Update md links * Update comment link in parser d.ts * Add comment in gitpod config * Update circleci config * Update PULL_REQUEST_TEMPLATE * Update badges * Trigger CI * Update 404 link
This commit is contained in:
parent
e498bee10f
commit
eea156b2cb
@ -71,7 +71,7 @@ jobs:
|
|||||||
steps:
|
steps:
|
||||||
- checkout
|
- checkout
|
||||||
- run:
|
- run:
|
||||||
name: Sync with latest master branch (only on PRs)
|
name: Sync with latest main branch (only on PRs)
|
||||||
command: |
|
command: |
|
||||||
if [ -n "$CIRCLE_PULL_REQUEST" ]
|
if [ -n "$CIRCLE_PULL_REQUEST" ]
|
||||||
then
|
then
|
||||||
@ -92,8 +92,8 @@ jobs:
|
|||||||
npm i tap-mocha-reporter --save-dev
|
npm i tap-mocha-reporter --save-dev
|
||||||
node lib/download-node
|
node lib/download-node
|
||||||
- run:
|
- run:
|
||||||
name: Download master branch Test262 artifact
|
name: Download main branch Test262 artifact
|
||||||
command: node lib/download-master-artifact ~/master.tap
|
command: node lib/download-main-artifact ~/test262-main.tap
|
||||||
<<: *test262_workdir
|
<<: *test262_workdir
|
||||||
- run:
|
- run:
|
||||||
name: Run Test262
|
name: Run Test262
|
||||||
@ -106,10 +106,10 @@ jobs:
|
|||||||
cat ~/test262.tap | $(npm bin)/tap-mocha-reporter spec || true
|
cat ~/test262.tap | $(npm bin)/tap-mocha-reporter spec || true
|
||||||
<<: *test262_workdir
|
<<: *test262_workdir
|
||||||
- run:
|
- run:
|
||||||
name: Compare previous master branch & current job results
|
name: Compare previous main branch & current job results
|
||||||
command: |
|
command: |
|
||||||
mkdir -p ~/test-results/test262
|
mkdir -p ~/test-results/test262
|
||||||
node lib/compare-results ~/master.tap ~/test262.tap | tee ~/diff.tap
|
node lib/compare-results ~/test262-main.tap ~/test262.tap | tee ~/diff.tap
|
||||||
<<: *test262_workdir
|
<<: *test262_workdir
|
||||||
- store_artifacts: *artifact_test262_diff_tap
|
- store_artifacts: *artifact_test262_diff_tap
|
||||||
- run:
|
- run:
|
||||||
@ -171,28 +171,36 @@ workflows:
|
|||||||
build-standalone:
|
build-standalone:
|
||||||
jobs:
|
jobs:
|
||||||
- build-standalone
|
- build-standalone
|
||||||
test262-master:
|
test262:
|
||||||
jobs:
|
jobs:
|
||||||
- test262:
|
- test262:
|
||||||
filters:
|
filters:
|
||||||
branches:
|
branches:
|
||||||
only:
|
only:
|
||||||
- master
|
- main
|
||||||
test262:
|
- next-8-dev
|
||||||
|
- next-8-rebased
|
||||||
|
test262-pr:
|
||||||
jobs:
|
jobs:
|
||||||
- approve-test262-run:
|
- approve-test262-run:
|
||||||
type: approval
|
type: approval
|
||||||
filters:
|
filters:
|
||||||
branches:
|
branches:
|
||||||
ignore:
|
ignore:
|
||||||
|
- main
|
||||||
- master
|
- master
|
||||||
|
- next-8-dev
|
||||||
|
- next-8-rebased
|
||||||
- test262:
|
- test262:
|
||||||
requires:
|
requires:
|
||||||
- approve-test262-run
|
- approve-test262-run
|
||||||
filters:
|
filters:
|
||||||
branches:
|
branches:
|
||||||
ignore:
|
ignore:
|
||||||
|
- main
|
||||||
- master
|
- master
|
||||||
|
- next-8-dev
|
||||||
|
- next-8-rebased
|
||||||
e2e:
|
e2e:
|
||||||
jobs:
|
jobs:
|
||||||
- publish-verdaccio
|
- publish-verdaccio
|
||||||
|
|||||||
2
.github/PULL_REQUEST_TEMPLATE.md
vendored
2
.github/PULL_REQUEST_TEMPLATE.md
vendored
@ -1,6 +1,6 @@
|
|||||||
<!--
|
<!--
|
||||||
Before making a PR, please read our contributing guidelines
|
Before making a PR, please read our contributing guidelines
|
||||||
https://github.com/babel/babel/blob/master/CONTRIBUTING.md
|
https://github.com/babel/babel/blob/main/CONTRIBUTING.md
|
||||||
|
|
||||||
Please note that the Babel Team requires two approvals before merging most PRs.
|
Please note that the Babel Team requires two approvals before merging most PRs.
|
||||||
|
|
||||||
|
|||||||
@ -24,7 +24,7 @@ tasks:
|
|||||||
github:
|
github:
|
||||||
# https://www.gitpod.io/docs/prebuilds/#configure-prebuilds
|
# https://www.gitpod.io/docs/prebuilds/#configure-prebuilds
|
||||||
prebuilds:
|
prebuilds:
|
||||||
master: true
|
master: true # enable for the default branch (even if it's not named "master")
|
||||||
branches: true
|
branches: true
|
||||||
pullRequests: true
|
pullRequests: true
|
||||||
pullRequestsFromForks: true
|
pullRequestsFromForks: true
|
||||||
|
|||||||
@ -16,15 +16,15 @@
|
|||||||
|
|
||||||
# Contributing
|
# Contributing
|
||||||
|
|
||||||
Contributions are always welcome, no matter how large or small! Before contributing, please read the [code of conduct](https://github.com/babel/babel/blob/master/CODE_OF_CONDUCT.md).
|
Contributions are always welcome, no matter how large or small! Before contributing, please read the [code of conduct](https://github.com/babel/babel/blob/main/CODE_OF_CONDUCT.md).
|
||||||
|
|
||||||
If you want an already configured online IDE to contribute to Babel, you can use [Gitpod](https://gitpod.io/#https://github.com/babel/babel)!
|
If you want an already configured online IDE to contribute to Babel, you can use [Gitpod](https://gitpod.io/#https://github.com/babel/babel)!
|
||||||
|
|
||||||
## Not sure where to start?
|
## Not sure where to start?
|
||||||
|
|
||||||
- If you aren't just making a documentation change, you'll probably want to learn a bit about a few topics.
|
- If you aren't just making a documentation change, you'll probably want to learn a bit about a few topics.
|
||||||
- [ASTs](https://en.wikipedia.org/wiki/Abstract_syntax_tree) (Abstract Syntax Tree): The Babel AST [spec](https://github.com/babel/babel/blob/master/packages/babel-parser/ast/spec.md) is a bit different from [ESTree](https://github.com/estree/estree). The differences are listed [here](https://babeljs.io/docs/en/next/babel-parser.html#output).
|
- [ASTs](https://en.wikipedia.org/wiki/Abstract_syntax_tree) (Abstract Syntax Tree): The Babel AST [spec](https://github.com/babel/babel/blob/main/packages/babel-parser/ast/spec.md) is a bit different from [ESTree](https://github.com/estree/estree). The differences are listed [here](https://babeljs.io/docs/en/next/babel-parser.html#output).
|
||||||
- Check out [`/doc`](https://github.com/babel/babel/tree/master/doc) for information about Babel's internals
|
- Check out [`/doc`](https://github.com/babel/babel/tree/main/doc) for information about Babel's internals
|
||||||
- Check out [the Babel Plugin Handbook](https://github.com/thejameskyle/babel-handbook/blob/master/translations/en/plugin-handbook.md#babel-plugin-handbook) - core plugins are written the same way as any other plugin!
|
- Check out [the Babel Plugin Handbook](https://github.com/thejameskyle/babel-handbook/blob/master/translations/en/plugin-handbook.md#babel-plugin-handbook) - core plugins are written the same way as any other plugin!
|
||||||
- Check out [AST Explorer](http://astexplorer.net/#/scUfOmVOG5) to learn more about ASTs or make your own plugin in the browser
|
- Check out [AST Explorer](http://astexplorer.net/#/scUfOmVOG5) to learn more about ASTs or make your own plugin in the browser
|
||||||
- When you feel ready to jump into the Babel source code, a good place to start is to look for issues tagged with [help wanted](https://github.com/babel/babel/labels/help%20wanted) and/or [good first issue](https://github.com/babel/babel/labels/good%20first%20issue).
|
- When you feel ready to jump into the Babel source code, a good place to start is to look for issues tagged with [help wanted](https://github.com/babel/babel/labels/help%20wanted) and/or [good first issue](https://github.com/babel/babel/labels/good%20first%20issue).
|
||||||
@ -106,7 +106,7 @@ If you just want to run all tests:
|
|||||||
$ make test-only
|
$ make test-only
|
||||||
```
|
```
|
||||||
|
|
||||||
When working on an issue, you will most likely want to focus on a particular [packages](https://github.com/babel/babel/tree/master/packages). Using `TEST_ONLY` will only run tests for that specific package.
|
When working on an issue, you will most likely want to focus on a particular [packages](https://github.com/babel/babel/tree/main/packages). Using `TEST_ONLY` will only run tests for that specific package.
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
$ TEST_ONLY=babel-cli make test
|
$ TEST_ONLY=babel-cli make test
|
||||||
@ -137,7 +137,7 @@ To enable the Node.js debugger added in v6.3.0, set the `TEST_DEBUG` environment
|
|||||||
$ TEST_DEBUG=true make test
|
$ TEST_DEBUG=true make test
|
||||||
```
|
```
|
||||||
|
|
||||||
You can combine `TEST_DEBUG` with `TEST_GREP` or `TEST_ONLY` to debug a subset of tests. If you plan to stay long in the debugger (which you'll likely do!), you may increase the test timeout by editing [test/mocha.opts](https://github.com/babel/babel/blob/master/test/mocha.opts).
|
You can combine `TEST_DEBUG` with `TEST_GREP` or `TEST_ONLY` to debug a subset of tests. If you plan to stay long in the debugger (which you'll likely do!), you may increase the test timeout by editing [test/testSetupFile.js](https://github.com/babel/babel/blob/main/test/testSetupFile.js).
|
||||||
|
|
||||||
To overwrite any test fixtures when fixing a bug or anything, add the env variable `OVERWRITE=true`
|
To overwrite any test fixtures when fixing a bug or anything, add the env variable `OVERWRITE=true`
|
||||||
|
|
||||||
@ -165,26 +165,26 @@ In case you're locally getting errors which are not on the CI, it may be due to
|
|||||||
|
|
||||||
### Writing tests
|
### Writing tests
|
||||||
|
|
||||||
Most packages in [`/packages`](https://github.com/babel/babel/tree/master/packages) have a `test` folder, however some tests might be in other packages or in [`/packages/babel-core`](https://github.com/babel/babel/tree/master/packages/babel-core/test/fixtures).
|
Most packages in [`/packages`](https://github.com/babel/babel/tree/main/packages) have a `test` folder, however some tests might be in other packages or in [`/packages/babel-core`](https://github.com/babel/babel/tree/main/packages/babel-core/test/fixtures).
|
||||||
|
|
||||||
#### `@babel/plugin-x`
|
#### `@babel/plugin-x`
|
||||||
|
|
||||||
All the Babel plugins (and other packages) that have a `/test/fixtures` are written in a similar way.
|
All the Babel plugins (and other packages) that have a `/test/fixtures` are written in a similar way.
|
||||||
|
|
||||||
For example, in [`@babel/plugin-transform-exponentiation-operator/test`](https://github.com/babel/babel/tree/master/packages/babel-plugin-transform-exponentiation-operator/test):
|
For example, in [`@babel/plugin-transform-exponentiation-operator/test`](https://github.com/babel/babel/tree/main/packages/babel-plugin-transform-exponentiation-operator/test):
|
||||||
|
|
||||||
- There is an `index.js` file. It imports our [test helper](https://github.com/babel/babel/tree/master/packages/babel-helper-plugin-test-runner). (You don't have to worry about this).
|
- There is an `index.js` file. It imports our [test helper](https://github.com/babel/babel/tree/main/packages/babel-helper-plugin-test-runner). (You don't have to worry about this).
|
||||||
- There can be multiple folders under [`/fixtures`](https://github.com/babel/babel/tree/master/packages/babel-plugin-transform-exponentiation-operator/test/fixtures)
|
- There can be multiple folders under [`/fixtures`](https://github.com/babel/babel/tree/main/packages/babel-plugin-transform-exponentiation-operator/test/fixtures)
|
||||||
|
|
||||||
- There is an [`options.json`](https://github.com/babel/babel/blob/master/packages/babel-plugin-transform-exponentiation-operator/test/fixtures/exponentian-operator/options.json) file whose function is similar to a `.babelrc` file, allowing you to pass in the plugins and settings you need for your tests.
|
- There is an [`options.json`](https://github.com/babel/babel/blob/main/packages/babel-plugin-transform-exponentiation-operator/test/fixtures/exponentian-operator/options.json) file whose function is similar to a `.babelrc` file, allowing you to pass in the plugins and settings you need for your tests.
|
||||||
- For this test, we only need the relevant plugin, so it's just `{ "plugins": ["@babel/plugin-transform-exponentiation-operator"] }`.
|
- For this test, we only need the relevant plugin, so it's just `{ "plugins": ["@babel/plugin-transform-exponentiation-operator"] }`.
|
||||||
- If necessary, you can have an `options.json` with different options in each subfolder.
|
- If necessary, you can have an `options.json` with different options in each subfolder.
|
||||||
|
|
||||||
- In each subfolder, you can organize your directory structure by categories of tests. (Example: these folders can be named after the feature you are testing or can reference the issue number they fix)
|
- In each subfolder, you can organize your directory structure by categories of tests. (Example: these folders can be named after the feature you are testing or can reference the issue number they fix)
|
||||||
- Generally, there are two kinds of tests for plugins
|
- Generally, there are two kinds of tests for plugins
|
||||||
- The first is a simple test of the input and output produced by running Babel on some code. We do this by creating an [`input.js`](https://github.com/babel/babel/blob/master/packages/babel-plugin-transform-exponentiation-operator/test/fixtures/exponentian-operator/binary/input.js) file and an [`output.js`](https://github.com/babel/babel/blob/master/packages/babel-plugin-transform-exponentiation-operator/test/fixtures/exponentian-operator/binary/output.js) file. This kind of test only works in sub-subdirectories of `/fixtures`, i.e. `/fixtures/exponentian-operator/binary/input.js` and **not** `/fixtures/exponentian-operator/input.js`.
|
- The first is a simple test of the input and output produced by running Babel on some code. We do this by creating an [`input.js`](https://github.com/babel/babel/blob/main/packages/babel-plugin-transform-exponentiation-operator/test/fixtures/exponentian-operator/binary/input.js) file and an [`output.js`](https://github.com/babel/babel/blob/main/packages/babel-plugin-transform-exponentiation-operator/test/fixtures/exponentian-operator/binary/output.js) file. This kind of test only works in sub-subdirectories of `/fixtures`, i.e. `/fixtures/exponentian-operator/binary/input.js` and **not** `/fixtures/exponentian-operator/input.js`.
|
||||||
- If you need to expect an error, you can ignore creating the `output.js` file and pass a new `throws` key to the `options.json` that contains the error string that is created.
|
- If you need to expect an error, you can ignore creating the `output.js` file and pass a new `throws` key to the `options.json` that contains the error string that is created.
|
||||||
- The second and preferred type is a test that actually evaluates the produced code and asserts that certain properties are true or false. We do this by creating an [`exec.js`](https://github.com/babel/babel/blob/master/packages/babel-plugin-transform-exponentiation-operator/test/fixtures/exponentian-operator/comprehensive/exec.js) file.
|
- The second and preferred type is a test that actually evaluates the produced code and asserts that certain properties are true or false. We do this by creating an [`exec.js`](https://github.com/babel/babel/blob/main/packages/babel-plugin-transform-exponentiation-operator/test/fixtures/exponentian-operator/comprehensive/exec.js) file.
|
||||||
|
|
||||||
In a fixture test, you simply write out the code you want to transform in `input.js`.
|
In a fixture test, you simply write out the code you want to transform in `input.js`.
|
||||||
|
|
||||||
@ -310,16 +310,16 @@ Note that the code shown in Chrome DevTools is compiled code and therefore diffe
|
|||||||
|
|
||||||
- Create a new issue that describes the proposal (ex: [#538](https://github.com/babel/babylon/issues/538)). Include any relevant information like proposal repo/author, examples, parsing approaches, meeting notes, presentation slides, and more.
|
- Create a new issue that describes the proposal (ex: [#538](https://github.com/babel/babylon/issues/538)). Include any relevant information like proposal repo/author, examples, parsing approaches, meeting notes, presentation slides, and more.
|
||||||
- The pull request should include:
|
- The pull request should include:
|
||||||
- [ ] An update to the [plugins](https://github.com/babel/babel/tree/master/packages/babel-parser#plugins) part of the readme. Add a new entry to that list for the new plugin flag (and link to the proposal)
|
- [ ] An update to the [plugins](https://github.com/babel/babel/tree/main/packages/babel-parser#plugins) part of the readme. Add a new entry to that list for the new plugin flag (and link to the proposal)
|
||||||
- [ ] If any new nodes or modifications need to be added to the AST, update [ast/spec.md](https://github.com/babel/babel/blob/master/packages/babel-parser/ast/spec.md)
|
- [ ] If any new nodes or modifications need to be added to the AST, update [ast/spec.md](https://github.com/babel/babel/blob/main/packages/babel-parser/ast/spec.md)
|
||||||
- [ ] Make sure you use the `this.hasPlugin("plugin-name-here")` check in the babel parser so that your new plugin code only runs when that flag is turned on (not default behavior)
|
- [ ] Make sure you use the `this.hasPlugin("plugin-name-here")` check in the babel parser so that your new plugin code only runs when that flag is turned on (not default behavior)
|
||||||
- [ ] Add failing/passing tests according to spec behavior
|
- [ ] Add failing/passing tests according to spec behavior
|
||||||
- Start working about the Babel transform itself!
|
- Start working about the Babel transform itself!
|
||||||
|
|
||||||
## Internals
|
## Internals
|
||||||
|
|
||||||
- AST spec ([babel-parser/ast/spec.md](https://github.com/babel/babel/blob/master/packages/babel-parser/ast/spec.md))
|
- AST spec ([babel-parser/ast/spec.md](https://github.com/babel/babel/blob/main/packages/babel-parser/ast/spec.md))
|
||||||
- Versioning ([doc/design/versioning.md](https://github.com/babel/babel/blob/master/doc/design/versioning.md))
|
- Versioning ([doc/design/versioning.md](https://github.com/babel/babel/blob/main/doc/design/versioning.md))
|
||||||
- Monorepo ([doc/design/monorepo.md](https://github.com/babel/babel/blob/master/doc/design/monorepo.md))
|
- Monorepo ([doc/design/monorepo.md](https://github.com/babel/babel/blob/main/doc/design/monorepo.md))
|
||||||
- Compiler environment support ([doc/design/compiler-environment-support.md](https://github.com/babel/babel/blob/master/doc/design/compiler-environment-support.md))
|
- Compiler environment support ([doc/design/compiler-environment-support.md](https://github.com/babel/babel/blob/main/doc/design/compiler-environment-support.md))
|
||||||
- Compiler assumptions ([doc/design/compiler-assumptions.md](https://github.com/babel/babel/blob/master/doc/design/compiler-assumptions.md))
|
- Compiler assumptions ([doc/design/compiler-assumptions.md](https://github.com/babel/babel/blob/main/doc/design/compiler-assumptions.md))
|
||||||
|
|||||||
@ -16,9 +16,9 @@
|
|||||||
<a href="https://www.npmjs.com/package/babel-core"><img alt="v6 npm Downloads" src="https://img.shields.io/npm/dm/babel-core.svg?maxAge=43200&label=v6%20downloads"></a>
|
<a href="https://www.npmjs.com/package/babel-core"><img alt="v6 npm Downloads" src="https://img.shields.io/npm/dm/babel-core.svg?maxAge=43200&label=v6%20downloads"></a>
|
||||||
</p>
|
</p>
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<a href="https://travis-ci.com/babel/babel"><img alt="Travis Status" src="https://img.shields.io/travis/com/babel/babel/master.svg?label=travis&maxAge=43200"></a>
|
<a href="https://travis-ci.com/babel/babel"><img alt="Travis Status" src="https://img.shields.io/travis/com/babel/babel/main.svg?label=travis&maxAge=43200"></a>
|
||||||
<a href="https://circleci.com/gh/babel/babel"><img alt="CircleCI Status" src="https://img.shields.io/circleci/project/github/babel/babel/master.svg?label=circle&maxAge=43200"></a>
|
<a href="https://circleci.com/gh/babel/babel"><img alt="CircleCI Status" src="https://img.shields.io/circleci/project/github/babel/babel/main.svg?label=circle&maxAge=43200"></a>
|
||||||
<a href="https://codecov.io/github/babel/babel"><img alt="Coverage Status" src="https://img.shields.io/codecov/c/github/babel/babel/master.svg?maxAge=43200"></a>
|
<a href="https://codecov.io/github/babel/babel"><img alt="Coverage Status" src="https://img.shields.io/codecov/c/github/babel/babel/main.svg?maxAge=43200"></a>
|
||||||
<a href="https://slack.babeljs.io/"><img alt="Slack Status" src="https://slack.babeljs.io/badge.svg"></a>
|
<a href="https://slack.babeljs.io/"><img alt="Slack Status" src="https://slack.babeljs.io/badge.svg"></a>
|
||||||
<a href="https://twitter.com/intent/follow?screen_name=babeljs"><img alt="Follow on Twitter" src="https://img.shields.io/twitter/follow/babeljs.svg?style=social&label=Follow"></a>
|
<a href="https://twitter.com/intent/follow?screen_name=babeljs"><img alt="Follow on Twitter" src="https://img.shields.io/twitter/follow/babeljs.svg?style=social&label=Follow"></a>
|
||||||
</p>
|
</p>
|
||||||
@ -75,7 +75,7 @@ Babel is a tool that helps you write code in the latest version of JavaScript. W
|
|||||||
});
|
});
|
||||||
```
|
```
|
||||||
|
|
||||||
Try it out at our [REPL](https://babeljs.io/repl/build/master#?code_lz=NoRgNATGDMC6B0BbAhgBwBQDsAEBeAfNjgNTYgCUA3EA&lineWrap=true&presets=es2015%2Ces2016%2Ces2017&version=7.0.0-beta.2).
|
Try it out at our [REPL](https://babeljs.io/repl/build/main#?code_lz=NoRgNATGDMC6B0BbAhgBwBQDsAEBeAfNjgNTYgCUA3EA&lineWrap=true&presets=es2015%2Ces2016%2Ces2017&version=7.0.0-beta.2).
|
||||||
|
|
||||||
## FAQ
|
## FAQ
|
||||||
|
|
||||||
|
|||||||
@ -1 +1 @@
|
|||||||
The [AST specification](https://github.com/babel/babel/blob/master/packages/babel-parser/ast/spec.md) has been moved to the babel parser package, `packages/babel-parser`.
|
The [AST specification](https://github.com/babel/babel/blob/main/packages/babel-parser/ast/spec.md) has been moved to the babel parser package, `packages/babel-parser`.
|
||||||
|
|||||||
@ -1,4 +1,4 @@
|
|||||||
# @babel/eslint-parser [](https://www.npmjs.com/package/@babel/eslint-parser) [](https://travis-ci.org/babel/@babel/eslint-parser) [](https://www.npmjs.com/package/@babel/eslint-parser)
|
# @babel/eslint-parser [](https://www.npmjs.com/package/@babel/eslint-parser) [](https://travis-ci.org/babel/@babel/eslint-parser) [](https://www.npmjs.com/package/@babel/eslint-parser)
|
||||||
|
|
||||||
|
|
||||||
## This project is still experimental and will be released with Babel v8. You can track our progress [here](https://github.com/babel/babel/issues/10752)! Please use [babel-eslint](https://github.com/babel/babel-eslint) in the meantime.
|
## This project is still experimental and will be released with Babel v8. You can track our progress [here](https://github.com/babel/babel/issues/10752)! Please use [babel-eslint](https://github.com/babel/babel-eslint) in the meantime.
|
||||||
@ -18,7 +18,7 @@ ESLint allows for the use of [custom parsers](https://eslint.org/docs/developer-
|
|||||||
transformed into an [ESTree](https://github.com/estree/estree)-compliant structure that ESLint can understand. All location info such as line numbers,
|
transformed into an [ESTree](https://github.com/estree/estree)-compliant structure that ESLint can understand. All location info such as line numbers,
|
||||||
columns is also retained so you can track down errors with ease.
|
columns is also retained so you can track down errors with ease.
|
||||||
|
|
||||||
**Note:** ESLint's core rules do not support experimental syntax and may therefore not work as expected when using `@babel/eslint-parser`. Please use the companion [`@babel/eslint-plugin`](https://github.com/babel/babel/tree/master/eslint/babel-eslint-plugin) plugin for core rules that you have issues with.
|
**Note:** ESLint's core rules do not support experimental syntax and may therefore not work as expected when using `@babel/eslint-parser`. Please use the companion [`@babel/eslint-plugin`](https://github.com/babel/babel/tree/main/eslint/babel-eslint-plugin) plugin for core rules that you have issues with.
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
|
|||||||
@ -13,7 +13,7 @@
|
|||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/babel/babel/issues"
|
"url": "https://github.com/babel/babel/issues"
|
||||||
},
|
},
|
||||||
"homepage": "https://github.com/babel/babel/tree/master/eslint/babel-eslint-parser",
|
"homepage": "https://babeljs.io/",
|
||||||
"engines": {
|
"engines": {
|
||||||
"node": ">=10.9"
|
"node": ">=10.9"
|
||||||
},
|
},
|
||||||
|
|||||||
@ -32,5 +32,5 @@
|
|||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/babel/babel/issues"
|
"url": "https://github.com/babel/babel/issues"
|
||||||
},
|
},
|
||||||
"homepage": "https://github.com/babel/babel/tree/master/eslint/babel-eslint-plugin-development"
|
"homepage": "https://babeljs.io/"
|
||||||
}
|
}
|
||||||
|
|||||||
@ -24,7 +24,7 @@
|
|||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/babel/babel/issues"
|
"url": "https://github.com/babel/babel/issues"
|
||||||
},
|
},
|
||||||
"homepage": "https://github.com/babel/babel/tree/master/eslint/babel-eslint-plugin",
|
"homepage": "https://babeljs.io/",
|
||||||
"peerDependencies": {
|
"peerDependencies": {
|
||||||
"@babel/eslint-parser": "0.0.0",
|
"@babel/eslint-parser": "0.0.0",
|
||||||
"eslint": ">=6.0.0"
|
"eslint": ">=6.0.0"
|
||||||
|
|||||||
@ -9,11 +9,11 @@
|
|||||||
> - :house: [Internal]
|
> - :house: [Internal]
|
||||||
> - :nail_care: [Polish]
|
> - :nail_care: [Polish]
|
||||||
|
|
||||||
> Semver Policy: https://github.com/babel/babel/tree/master/packages/babel-parser#semver
|
> Semver Policy: https://github.com/babel/babel/tree/main/packages/babel-parser#semver
|
||||||
|
|
||||||
_Note: Gaps between patch versions are faulty, broken or test releases._
|
_Note: Gaps between patch versions are faulty, broken or test releases._
|
||||||
|
|
||||||
See the [Babel Changelog](https://github.com/babel/babel/blob/master/CHANGELOG.md) for the pre-6.8.0 version Changelog.
|
See the [Babel Changelog](https://github.com/babel/babel/blob/main/CHANGELOG.md) for the pre-6.8.0 version Changelog.
|
||||||
|
|
||||||
## 6.17.1 (2017-05-10)
|
## 6.17.1 (2017-05-10)
|
||||||
|
|
||||||
|
|||||||
@ -1,5 +1,5 @@
|
|||||||
// Type definitions for @babel/parser
|
// Type definitions for @babel/parser
|
||||||
// Project: https://github.com/babel/babel/tree/master/packages/babel-parser
|
// Project: https://github.com/babel/babel/tree/main/packages/babel-parser
|
||||||
// Definitions by: Troy Gerwien <https://github.com/yortus>
|
// Definitions by: Troy Gerwien <https://github.com/yortus>
|
||||||
// Marvin Hagemeister <https://github.com/marvinhagemeister>
|
// Marvin Hagemeister <https://github.com/marvinhagemeister>
|
||||||
// Avi Vahl <https://github.com/AviVahl>
|
// Avi Vahl <https://github.com/AviVahl>
|
||||||
|
|||||||
@ -3,7 +3,7 @@
|
|||||||
"author": "Ben Newman <bn@cs.stanford.edu>",
|
"author": "Ben Newman <bn@cs.stanford.edu>",
|
||||||
"description": "Explode async and generator functions into a state machine.",
|
"description": "Explode async and generator functions into a state machine.",
|
||||||
"version": "7.10.1",
|
"version": "7.10.1",
|
||||||
"homepage": "https://github.com/babel/babel/tree/master/packages/babel-plugin-transform-regenerator",
|
"homepage": "https://babeljs.io/",
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
"url": "https://github.com/babel/babel.git",
|
"url": "https://github.com/babel/babel.git",
|
||||||
|
|||||||
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
## Adding a new plugin or polyfill to support (when approved in the next ECMAScript version)
|
## Adding a new plugin or polyfill to support (when approved in the next ECMAScript version)
|
||||||
|
|
||||||
### Update [`plugin-features.js`](https://github.com/babel/babel/blob/master/packages/babel-compat-data/scripts/data/plugin-features.js)
|
### Update [`plugin-features.js`](https://github.com/babel/babel/blob/main/packages/babel-compat-data/scripts/data/plugin-features.js)
|
||||||
|
|
||||||
*Example:*
|
*Example:*
|
||||||
|
|
||||||
@ -42,7 +42,7 @@ Find the corresponding module on [`core-js@2`](https://github.com/zloirock/core-
|
|||||||
|
|
||||||
`es7.object.values.js`
|
`es7.object.values.js`
|
||||||
|
|
||||||
Find required ES version in [`corejs2-built-in-features.js`](https://github.com/babel/babel/blob/master/packages/babel-preset-env/data/corejs2-built-in-features.js) and add the new feature:
|
Find required ES version in [`corejs2-built-in-features.js`](https://github.com/babel/babel/blob/main/packages/babel-preset-env/data/corejs2-built-in-features.js) and add the new feature:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
const es = {
|
const es = {
|
||||||
@ -51,17 +51,17 @@ const es = {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
If you wan to transform a new built-in by `useBuiltIns: 'usage'`, add mapping to related `core-js` modules to [this file](https://github.com/babel/babel/blob/master/packages/babel-preset-env/polyfills/corejs2/built-in-definitions.js).
|
If you wan to transform a new built-in by `useBuiltIns: 'usage'`, add mapping to related `core-js` modules to [this file](https://github.com/babel/babel/blob/main/packages/babel-preset-env/polyfills/corejs2/built-in-definitions.js).
|
||||||
|
|
||||||
### Update data for `core-js@3` polyfilling
|
### Update data for `core-js@3` polyfilling
|
||||||
|
|
||||||
Just update the version of [`core-js-compat`](https://github.com/zloirock/core-js/tree/master/packages/core-js-compat) in dependencies.
|
Just update the version of [`core-js-compat`](https://github.com/zloirock/core-js/tree/main/packages/core-js-compat) in dependencies.
|
||||||
|
|
||||||
If you wan to transform a new built-in by `useBuiltIns: 'usage'`, add mapping to related [`core-js`](https://github.com/zloirock/core-js/tree/master/packages/core-js/modules) modules to [this file](https://github.com/babel/babel/blob/master/packages/babel-preset-env/polyfills/corejs3/built-in-definitions.js).
|
If you wan to transform a new built-in by `useBuiltIns: 'usage'`, add mapping to related [`core-js`](https://github.com/zloirock/core-js/tree/main/packages/core-js/modules) modules to [this file](https://github.com/babel/babel/blob/main/packages/babel-preset-env/polyfills/corejs3/built-in-definitions.js).
|
||||||
|
|
||||||
If you want to mark a new proposal as shipped, add it to [this list](https://github.com/babel/babel/blob/master/packages/babel-preset-env/polyfills/corejs3/shipped-proposals.js).
|
If you want to mark a new proposal as shipped, add it to [this list](https://github.com/babel/babel/blob/main/packages/babel-preset-env/polyfills/corejs3/shipped-proposals.js).
|
||||||
|
|
||||||
### Update [`plugins.json`](https://github.com/babel/babel/blob/master/packages/babel-preset-env/data/plugins.json)
|
### Update [`plugins.json`](https://github.com/babel/babel/blob/main/packages/babel-preset-env/data/plugins.json)
|
||||||
|
|
||||||
Until `compat-table` is a standalone npm module for data we are using the git commit in `packages/babel-compat-data/scripts/download-compat-table.sh`
|
Until `compat-table` is a standalone npm module for data we are using the git commit in `packages/babel-compat-data/scripts/download-compat-table.sh`
|
||||||
|
|
||||||
@ -72,7 +72,7 @@ So we update and then run `npm run build-data`. If there are no changes, then `p
|
|||||||
## Tests
|
## Tests
|
||||||
|
|
||||||
### Running tests
|
### Running tests
|
||||||
See general [CONTRIBUTING.md](https://github.com/babel/babel/blob/master/CONTRIBUTING.md#running-lintingtests).
|
See general [CONTRIBUTING.md](https://github.com/babel/babel/blob/main/CONTRIBUTING.md#running-lintingtests).
|
||||||
|
|
||||||
### Writing tests
|
### Writing tests
|
||||||
|
|
||||||
@ -80,7 +80,7 @@ See general [CONTRIBUTING.md](https://github.com/babel/babel/blob/master/CONTRIB
|
|||||||
|
|
||||||
All the tests for `@babel/preset-env` exist in the `test/fixtures` folder. The
|
All the tests for `@babel/preset-env` exist in the `test/fixtures` folder. The
|
||||||
test setup and conventions are exactly the same as testing a Babel plugin, so
|
test setup and conventions are exactly the same as testing a Babel plugin, so
|
||||||
please read our [documentation on writing tests](https://github.com/babel/babel/blob/master/CONTRIBUTING.md#babel-plugin-x).
|
please read our [documentation on writing tests](https://github.com/babel/babel/blob/main/CONTRIBUTING.md#babel-plugin-x).
|
||||||
|
|
||||||
#### Testing the `debug` option
|
#### Testing the `debug` option
|
||||||
|
|
||||||
|
|||||||
@ -11,7 +11,7 @@
|
|||||||
"url": "https://github.com/babel/babel.git",
|
"url": "https://github.com/babel/babel.git",
|
||||||
"directory": "packages/babel-runtime"
|
"directory": "packages/babel-runtime"
|
||||||
},
|
},
|
||||||
"homepage": "https://babeljs.io/docs/en/next/babel-runtime",
|
"homepage": "https://babeljs.io/",
|
||||||
"author": "Sebastian McKenzie <sebmck@gmail.com>",
|
"author": "Sebastian McKenzie <sebmck@gmail.com>",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"regenerator-runtime": "^0.13.4"
|
"regenerator-runtime": "^0.13.4"
|
||||||
|
|||||||
@ -123,7 +123,7 @@
|
|||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/babel/babel/issues"
|
"url": "https://github.com/babel/babel/issues"
|
||||||
},
|
},
|
||||||
"homepage": "https://github.com/babel/babel/tree/master/packages/babel-standalone",
|
"homepage": "https://babeljs.io/",
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
"url": "https://github.com/babel/babel.git",
|
"url": "https://github.com/babel/babel.git",
|
||||||
|
|||||||
@ -209,7 +209,7 @@ export function getOuterBindingIdentifiers(duplicates?: boolean): Object {
|
|||||||
return t.getOuterBindingIdentifiers(this.node, duplicates);
|
return t.getOuterBindingIdentifiers(this.node, duplicates);
|
||||||
}
|
}
|
||||||
|
|
||||||
// original source - https://github.com/babel/babel/blob/master/packages/babel-types/src/retrievers.js
|
// original source - https://github.com/babel/babel/blob/main/packages/babel-types/src/retrievers/getBindingIdentifiers.js
|
||||||
// path.getBindingIdentifiers returns nodes where the following re-implementation
|
// path.getBindingIdentifiers returns nodes where the following re-implementation
|
||||||
// returns paths
|
// returns paths
|
||||||
export function getBindingIdentifierPaths(
|
export function getBindingIdentifierPaths(
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user