From e386766b538e043bb5b3eafec00a09758289cb63 Mon Sep 17 00:00:00 2001 From: Henry Zhu Date: Thu, 2 Sep 2021 11:06:58 -0400 Subject: [PATCH] move plugins to stage 4, es2022 (#2570) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * move plugins to stage 4 * Update plugins-list.md * Update website/sidebars.json Co-authored-by: Huáng Jùnliàng Co-authored-by: Huáng Jùnliàng --- ...lugin-proposal-async-generator-functions.md | 2 +- docs/plugin-proposal-class-properties.md | 3 +-- docs/plugin-proposal-class-static-block.md | 2 ++ docs/plugin-proposal-export-namespace-from.md | 2 +- docs/plugin-proposal-json-strings.md | 2 +- ...in-proposal-logical-assignment-operators.md | 2 +- ...gin-proposal-nullish-coalescing-operator.md | 2 +- docs/plugin-proposal-numeric-separator.md | 2 +- docs/plugin-proposal-object-rest-spread.md | 2 +- docs/plugin-proposal-optional-catch-binding.md | 2 +- docs/plugin-proposal-optional-chaining.md | 2 +- ...ugin-proposal-private-property-in-object.md | 2 +- docs/plugin-proposal-unicode-property-regex.md | 2 +- docs/plugin-syntax-bigint.md | 1 + docs/plugin-syntax-dynamic-import.md | 2 ++ docs/plugin-syntax-import-meta.md | 2 ++ docs/plugin-syntax-top-level-await.md | 2 +- docs/plugin-transform-async-to-generator.md | 2 +- docs/plugin-transform-dotall-regex.md | 2 +- ...plugin-transform-exponentiation-operator.md | 2 +- ...n-transform-named-capturing-groups-regex.md | 2 +- docs/plugins-list.md | 18 +++++++++++------- website/sidebars.json | 13 +++++++++++-- 23 files changed, 46 insertions(+), 27 deletions(-) diff --git a/docs/plugin-proposal-async-generator-functions.md b/docs/plugin-proposal-async-generator-functions.md index 3ca8650149..712d871cde 100644 --- a/docs/plugin-proposal-async-generator-functions.md +++ b/docs/plugin-proposal-async-generator-functions.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-async-generator-functions sidebar_label: async-generator-functions --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2018](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-proposal-class-properties.md b/docs/plugin-proposal-class-properties.md index 9adb64419e..297d6e1d9f 100644 --- a/docs/plugin-proposal-class-properties.md +++ b/docs/plugin-proposal-class-properties.md @@ -4,8 +4,7 @@ title: @babel/plugin-proposal-class-properties sidebar_label: class-properties --- -> **NOTE**: This plugin is included in `@babel/preset-env` - +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2022](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example Below is a class with four class properties which will be transformed. diff --git a/docs/plugin-proposal-class-static-block.md b/docs/plugin-proposal-class-static-block.md index 9bea73523c..4a08d549ee 100644 --- a/docs/plugin-proposal-class-static-block.md +++ b/docs/plugin-proposal-class-static-block.md @@ -4,6 +4,8 @@ title: @babel/plugin-proposal-class-static-block sidebar_label: class-static-block --- +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2022](https://github.com/tc39/proposals/blob/master/finished-proposals.md) + A class with a static block will be transformed into a static private property, whose initializer is the static block wrapped in an IIAFE (immediate invoked arrow function expression). ## Example diff --git a/docs/plugin-proposal-export-namespace-from.md b/docs/plugin-proposal-export-namespace-from.md index 69d0fdcf47..afc2b3a2db 100644 --- a/docs/plugin-proposal-export-namespace-from.md +++ b/docs/plugin-proposal-export-namespace-from.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-export-namespace-from sidebar_label: export-namespace-from --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2020](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-proposal-json-strings.md b/docs/plugin-proposal-json-strings.md index 8df932d69e..1302891b11 100644 --- a/docs/plugin-proposal-json-strings.md +++ b/docs/plugin-proposal-json-strings.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-json-strings sidebar_label: json-strings --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2019](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Examples diff --git a/docs/plugin-proposal-logical-assignment-operators.md b/docs/plugin-proposal-logical-assignment-operators.md index 93ceca5b96..1b621bc16d 100644 --- a/docs/plugin-proposal-logical-assignment-operators.md +++ b/docs/plugin-proposal-logical-assignment-operators.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-logical-assignment-operators sidebar_label: logical-assignment-operators --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2021](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-proposal-nullish-coalescing-operator.md b/docs/plugin-proposal-nullish-coalescing-operator.md index 001cc07b4a..5cb7e4b442 100644 --- a/docs/plugin-proposal-nullish-coalescing-operator.md +++ b/docs/plugin-proposal-nullish-coalescing-operator.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-nullish-coalescing-operator sidebar_label: nullish-coalescing-operator --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2020](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-proposal-numeric-separator.md b/docs/plugin-proposal-numeric-separator.md index e102c5e01c..c6974fe6ff 100644 --- a/docs/plugin-proposal-numeric-separator.md +++ b/docs/plugin-proposal-numeric-separator.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-numeric-separator sidebar_label: numeric-separator --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2021](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-proposal-object-rest-spread.md b/docs/plugin-proposal-object-rest-spread.md index 1f41d45ab6..533eb5e753 100644 --- a/docs/plugin-proposal-object-rest-spread.md +++ b/docs/plugin-proposal-object-rest-spread.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-object-rest-spread sidebar_label: object-rest-spread --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2018](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-proposal-optional-catch-binding.md b/docs/plugin-proposal-optional-catch-binding.md index 1e1f6c02de..dfb1a4ec1d 100644 --- a/docs/plugin-proposal-optional-catch-binding.md +++ b/docs/plugin-proposal-optional-catch-binding.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-optional-catch-binding sidebar_label: optional-catch-binding --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2019](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Examples diff --git a/docs/plugin-proposal-optional-chaining.md b/docs/plugin-proposal-optional-chaining.md index e21b0f497c..67cea2d651 100644 --- a/docs/plugin-proposal-optional-chaining.md +++ b/docs/plugin-proposal-optional-chaining.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-optional-chaining sidebar_label: optional-chaining --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2020](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-proposal-private-property-in-object.md b/docs/plugin-proposal-private-property-in-object.md index 28332d1714..e23b2948b8 100644 --- a/docs/plugin-proposal-private-property-in-object.md +++ b/docs/plugin-proposal-private-property-in-object.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-private-property-in-object sidebar_label: private-property-in-object --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2022](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-proposal-unicode-property-regex.md b/docs/plugin-proposal-unicode-property-regex.md index 9925a55d95..8b507496f4 100644 --- a/docs/plugin-proposal-unicode-property-regex.md +++ b/docs/plugin-proposal-unicode-property-regex.md @@ -4,7 +4,7 @@ title: @babel/plugin-proposal-unicode-property-regex sidebar_label: unicode-property-regex --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2018](https://github.com/tc39/proposals/blob/master/finished-proposals.md) [Here’s an online demo.](https://mothereff.in/regexpu#input=var+regex+%3D+/%5Cp%7BScript_Extensions%3DGreek%7D/u%3B&unicodePropertyEscape=1) diff --git a/docs/plugin-syntax-bigint.md b/docs/plugin-syntax-bigint.md index 71faa0ed1c..4842fa0e1d 100644 --- a/docs/plugin-syntax-bigint.md +++ b/docs/plugin-syntax-bigint.md @@ -4,6 +4,7 @@ title: @babel/plugin-syntax-bigint sidebar_label: syntax-bigint --- +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2020](https://github.com/tc39/proposals/blob/master/finished-proposals.md) > #### Syntax only > > This plugin only enables parsing of this feature. Babel doesn't support transforming BigInts. One recommendation is to use the JSBI library and eventually run `babel-plugin-transform-jsbi-to-bigint` to codemod it to BigInt in the future. diff --git a/docs/plugin-syntax-dynamic-import.md b/docs/plugin-syntax-dynamic-import.md index fa7fd29c11..900f476da5 100644 --- a/docs/plugin-syntax-dynamic-import.md +++ b/docs/plugin-syntax-dynamic-import.md @@ -4,6 +4,8 @@ title: @babel/plugin-syntax-dynamic-import sidebar_label: syntax-dynamic-import --- +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2020](https://github.com/tc39/proposals/blob/master/finished-proposals.md) + ## Installation ```sh diff --git a/docs/plugin-syntax-import-meta.md b/docs/plugin-syntax-import-meta.md index 8e48dcefa0..e91f4b0118 100644 --- a/docs/plugin-syntax-import-meta.md +++ b/docs/plugin-syntax-import-meta.md @@ -4,6 +4,8 @@ title: @babel/plugin-syntax-import-meta sidebar_label: syntax-import-meta --- +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2020](https://github.com/tc39/proposals/blob/master/finished-proposals.md) + ## Installation ```sh diff --git a/docs/plugin-syntax-top-level-await.md b/docs/plugin-syntax-top-level-await.md index 3ac6cf8e58..7c6befcac1 100644 --- a/docs/plugin-syntax-top-level-await.md +++ b/docs/plugin-syntax-top-level-await.md @@ -4,7 +4,7 @@ title: @babel/plugin-syntax-top-level-await sidebar_label: syntax-top-level-await --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2022](https://github.com/tc39/proposals/blob/master/finished-proposals.md) > > #### Syntax only > diff --git a/docs/plugin-transform-async-to-generator.md b/docs/plugin-transform-async-to-generator.md index 21ad009254..5e93adc1be 100644 --- a/docs/plugin-transform-async-to-generator.md +++ b/docs/plugin-transform-async-to-generator.md @@ -4,7 +4,7 @@ title: @babel/plugin-transform-async-to-generator sidebar_label: async-to-generator --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2017](https://github.com/tc39/proposals/blob/master/finished-proposals.md) > In Babel 7, `transform-async-to-module-method` was merged into this plugin ## Example diff --git a/docs/plugin-transform-dotall-regex.md b/docs/plugin-transform-dotall-regex.md index 52fc35fb3e..114787e752 100644 --- a/docs/plugin-transform-dotall-regex.md +++ b/docs/plugin-transform-dotall-regex.md @@ -4,7 +4,7 @@ title: @babel/plugin-transform-dotall-regex sidebar_label: dotall-regex --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2018](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-transform-exponentiation-operator.md b/docs/plugin-transform-exponentiation-operator.md index c8ec1c6349..74f9513abb 100644 --- a/docs/plugin-transform-exponentiation-operator.md +++ b/docs/plugin-transform-exponentiation-operator.md @@ -4,7 +4,7 @@ title: @babel/plugin-transform-exponentiation-operator sidebar_label: exponentiation-operator --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2016](https://github.com/tc39/proposals/blob/master/finished-proposals.md) ## Example diff --git a/docs/plugin-transform-named-capturing-groups-regex.md b/docs/plugin-transform-named-capturing-groups-regex.md index eee962d88e..2f1f338ce0 100644 --- a/docs/plugin-transform-named-capturing-groups-regex.md +++ b/docs/plugin-transform-named-capturing-groups-regex.md @@ -4,7 +4,7 @@ title: @babel/plugin-transform-named-capturing-groups-regex sidebar_label: named-capturing-groups-regex --- -> **NOTE**: This plugin is included in `@babel/preset-env` +> **NOTE**: This plugin is included in `@babel/preset-env`, in [ES2018](https://github.com/tc39/proposals/blob/master/finished-proposals.md) > NOTE: This plugin generates code that needs ES6 regular expressions > functionalities. If you need to support older browsers, use either > the `runtime: false` option or import a proper polyfill (e.g. `core-js`). diff --git a/docs/plugins-list.md b/docs/plugins-list.md index 5606a7473b..9216e75e37 100644 --- a/docs/plugins-list.md +++ b/docs/plugins-list.md @@ -8,7 +8,6 @@ sidebar_label: Plugins List ### TC39 Proposals -- [class-static-block](plugin-proposal-class-static-block.md) - [decorators](plugin-proposal-decorators.md) - [do-expressions](plugin-proposal-do-expressions.md) - [export-default-from](plugin-proposal-export-default-from.md) @@ -23,25 +22,23 @@ sidebar_label: Plugins List ### ES2022 - [class-properties](plugin-proposal-class-properties.md) -- [private-methods](plugin-proposal-private-methods.md) +- [class-static-block](plugin-proposal-class-static-block.md) - [private-property-in-object](plugin-proposal-private-property-in-object.md) +- [syntax-top-level-await](plugin-syntax-top-level-await.md) ### ES2021 -- [numeric-separator](plugin-proposal-numeric-separator.md) - [logical-assignment-operators](plugin-proposal-logical-assignment-operators.md) +- [numeric-separator](plugin-proposal-numeric-separator.md) ### ES2020 - [export-namespace-from](plugin-proposal-export-namespace-from.md) - [nullish-coalescing-operator](plugin-proposal-nullish-coalescing-operator.md) - [optional-chaining](plugin-proposal-optional-chaining.md) - -#### Syntax Only - -- [syntax-bigint](plugin-syntax-bigint.md) - [syntax-dynamic-import](plugin-syntax-dynamic-import.md) - [syntax-import-meta](plugin-syntax-import-meta.md) +- [syntax-bigint](plugin-syntax-bigint.md) ### ES2019 @@ -136,3 +133,10 @@ sidebar_label: Plugins List - [regenerator](plugin-transform-regenerator.md) - [runtime](plugin-transform-runtime.md) - [strict-mode](plugin-transform-strict-mode.md) + +#### Syntax Only + +- [syntax-bigint](plugin-syntax-bigint.md) (ES2020) +- [syntax-dynamic-import](plugin-syntax-dynamic-import.md) (ES2020) +- [syntax-import-meta](plugin-syntax-import-meta.md) (ES2020) +- [syntax-top-level-await](plugin-syntax-top-level-await.md) (ES2022) diff --git a/website/sidebars.json b/website/sidebars.json index 958d20bfad..606674dc73 100644 --- a/website/sidebars.json +++ b/website/sidebars.json @@ -52,11 +52,9 @@ ], "TC39 Proposals": [ "babel-plugin-proposal-async-do-expressions", - "babel-plugin-proposal-class-static-block", "babel-plugin-proposal-decorators", "babel-plugin-proposal-do-expressions", "babel-plugin-proposal-export-default-from", - "babel-plugin-proposal-export-namespace-from", "babel-plugin-proposal-function-bind", "babel-plugin-proposal-function-sent", "babel-plugin-proposal-partial-application", @@ -66,6 +64,17 @@ "babel-plugin-proposal-throw-expressions" ], "@babel/preset-env": [ + { + "type": "subcategory", + "label": "ES2022", + "ids": [ + "babel-plugin-proposal-class-private-methods", + "babel-plugin-proposal-class-properties", + "babel-plugin-proposal-class-static-block", + "babel-plugin-proposal-private-property-in-object", + "babel-plugin-syntax-top-level-await" + ] + }, { "type": "subcategory", "label": "ES2021",