Packages: Change how required built-ins are polyfilled with Babel 7 (#…

…9171) * Packages: Change how required built-ins are polyfilled * Optimize Babel config for the distribution code * Improve Babel configuration for packages * Update dependencies for token-list package * Revert incorrect config for packages module code * Docs: Add information about polyfills for each package that needs them * Update Babel to 7.0.0 version * Update message about the need of using polyfills with packages * Fix some dependencies in the root folder * Docs: Update all changelogs related to this PR
WordPress · Sep 5, 2018 · 4abf4a7 · 4abf4a7
1 parent 4fec0d2
commit 4abf4a7
Show file tree

Hide file tree

Showing 96 changed files with 794 additions and 924 deletions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -141,7 +141,7 @@ When creating a new package you need to provide at least the following:
 		"module": "build-module/index.js",
 		"react-native": "src/index",
 		"dependencies": {
-			"@babel/runtime-corejs2": "7.0.0-beta.56"
+			"@babel/runtime": "^7.0.0"
 		},
 		"publishConfig": {
 			"access": "public"

diff --git a/bin/packages/get-babel-config.js b/bin/packages/get-babel-config.js
@@ -19,29 +19,55 @@ if ( ! process.env.SKIP_JSX_PRAGMA_TRANSFORM ) {
 	} ] );
 }
 
+const overrideOptions = ( target, targetName, options ) => {
+	if ( get( target, [ 'file', 'request' ] ) === targetName ) {
+		return [ targetName, Object.assign(
+			{},
+			target.options,
+			options
+		) ];
+	}
+	return target;
+};
+
 const babelConfigs = {
 	main: Object.assign(
 		{},
 		babelDefaultConfig,
 		{
-			plugins,
-			presets: map( babelDefaultConfig.presets, ( preset ) => {
-				if ( get( preset, [ 'file', 'request' ] ) === '@babel/preset-env' ) {
-					return [ '@babel/preset-env', Object.assign(
-						{},
-						preset.options,
-						{ modules: 'commonjs' }
-					) ];
-				}
-				return preset;
-			} ),
+			plugins: map(
+				plugins,
+				( plugin ) => overrideOptions( plugin, '@babel/plugin-transform-runtime', {
+					corejs: false,
+				} )
+			),
+			presets: map(
+				babelDefaultConfig.presets,
+				( preset ) => overrideOptions( preset, '@babel/preset-env', {
+					modules: 'commonjs',
+					useBuiltIns: false,
+				} )
+			),
 		}
 	),
 	module: Object.assign(
 		{},
 		babelDefaultConfig,
 		{
-			plugins,
+			plugins: map(
+				plugins,
+				( plugin ) => overrideOptions( plugin, '@babel/plugin-transform-runtime', {
+					corejs: false,
+					useESModules: true,
+				} )
+			),
+			presets: map(
+				babelDefaultConfig.presets,
+				( preset ) => overrideOptions( preset, '@babel/preset-env', {
+					modules: false,
+					useBuiltIns: false,
+				} )
+			),
 		}
 	),
 };

diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -58,7 +58,8 @@
 		"rememo": "3.0.0"
 	},
 	"devDependencies": {
-		"@babel/core": "7.0.0-beta.56",
+		"@babel/core": "7.0.0",
+		"@babel/runtime-corejs2": "7.0.0",
 		"@wordpress/babel-plugin-import-jsx-pragma": "file:packages/babel-plugin-import-jsx-pragma",
 		"@wordpress/babel-plugin-makepot": "file:packages/babel-plugin-makepot",
 		"@wordpress/babel-preset-default": "file:packages/babel-preset-default",
@@ -72,7 +73,7 @@
 		"@wordpress/scripts": "file:packages/scripts",
 		"autoprefixer": "8.2.0",
 		"babel-eslint": "8.0.3",
-		"babel-loader": "8.0.0-beta.4",
+		"babel-loader": "8.0.0",
 		"chalk": "2.4.1",
 		"check-node-version": "3.1.1",
 		"codecov": "3.0.2",

diff --git a/packages/a11y/CHANGELOG.md b/packages/a11y/CHANGELOG.md
@@ -1,3 +1,9 @@
+## 2.0.0 (Unreleased)
+
+### Breaking Change
+
+- Change how required built-ins are polyfilled with Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).  If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods.
+
 ## 1.1.0 (2018-07-12)
 
 ### New feature

diff --git a/packages/a11y/README.md b/packages/a11y/README.md
@@ -10,6 +10,8 @@ Install the module
 npm install @wordpress/a11y --save
 ```
 
+_This package assumes that your code will run in an **ES2015+** environment. If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._
+
 ## speak
 
 Allows you to easily announce dynamic interface updates to screen readers using ARIA live regions. This module is inspired by the `speak` function in wp-a11y.js

diff --git a/packages/a11y/package.json b/packages/a11y/package.json
@@ -21,7 +21,7 @@
 	"module": "build-module/index.js",
 	"react-native": "src/index",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56",
+		"@babel/runtime": "^7.0.0",
 		"@wordpress/dom-ready": "file:../dom-ready"
 	},
 	"publishConfig": {

diff --git a/packages/api-fetch/CHANGELOG.md b/packages/api-fetch/CHANGELOG.md
@@ -0,0 +1,5 @@
+## 2.0.0 (Unreleased)
+
+### Breaking Change
+
+- Change how required built-ins are polyfilled with Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).  If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods.
diff --git a/packages/api-fetch/README.md b/packages/api-fetch/README.md
@@ -10,6 +10,8 @@ Install the module
 npm install @wordpress/api-fetch --save
 ```
 
+_This package assumes that your code will run in an **ES2015+** environment. If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._
+
 ## Usage
 
 ```js

diff --git a/packages/api-fetch/package.json b/packages/api-fetch/package.json
@@ -20,7 +20,7 @@
 	"main": "build/index.js",
 	"module": "build-module/index.js",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56",
+		"@babel/runtime": "^7.0.0",
 		"@wordpress/hooks": "file:../hooks",
 		"@wordpress/i18n": "file:../i18n"
 	},

diff --git a/packages/autop/CHANGELOG.md b/packages/autop/CHANGELOG.md
@@ -1,3 +1,9 @@
+## 2.0.0 (Unreleased)
+
+### Breaking Change
+
+- Change how required built-ins are polyfilled with Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).  If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods.
+
 ## 1.1.0 (2018-07-12)
 
 ### New Feature

diff --git a/packages/autop/README.md b/packages/autop/README.md
@@ -10,6 +10,8 @@ Install the module
 npm install @wordpress/autop --save
 ```
 
+_This package assumes that your code will run in an **ES2015+** environment. If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._
+
 ### Usage
 
 Import the desired function(s) from `@wordpress/autop`:

diff --git a/packages/autop/package.json b/packages/autop/package.json
@@ -19,7 +19,7 @@
 	"main": "build/index.js",
 	"module": "build-module/index.js",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56"
+		"@babel/runtime": "^7.0.0"
 	},
 	"publishConfig": {
 		"access": "public"

diff --git a/packages/babel-plugin-import-jsx-pragma/CHANGELOG.md b/packages/babel-plugin-import-jsx-pragma/CHANGELOG.md
@@ -0,0 +1,5 @@
+## 1.1.0 (Unreleased)
+
+### New Feature
+
+- Plugin updated to work with the stable version of Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).
diff --git a/packages/babel-plugin-import-jsx-pragma/package.json b/packages/babel-plugin-import-jsx-pragma/package.json
@@ -26,14 +26,14 @@
 	"main": "build/index.js",
 	"module": "build-module/index.js",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56"
+		"@babel/runtime": "^7.0.0"
 	},
 	"devDependencies": {
-		"@babel/core": "7.0.0-beta.56",
-		"@babel/plugin-syntax-jsx": "7.0.0-beta.56"
+		"@babel/core": "^7.0.0",
+		"@babel/plugin-syntax-jsx": "^7.0.0"
 	},
 	"peerDependencies": {
-		"@babel/core": "7.0.0-beta.56"
+		"@babel/core": "^7.0.0"
 	},
 	"publishConfig": {
 		"access": "public"

diff --git a/packages/babel-plugin-makepot/CHANGELOG.md b/packages/babel-plugin-makepot/CHANGELOG.md
@@ -1,3 +1,9 @@
+## 2.1.0 (Unreleased)
+
+### New Feature
+
+- Plugin updated to work with the stable version of Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).
+
 ## 2.0.0 (2018-07-12)
 
 ### Breaking Change

diff --git a/packages/babel-plugin-makepot/package.json b/packages/babel-plugin-makepot/package.json
@@ -25,16 +25,16 @@
 	"main": "build/index.js",
 	"module": "build-module/index.js",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56",
+		"@babel/runtime": "^7.0.0",
 		"gettext-parser": "^1.3.1",
 		"lodash": "^4.17.10"
 	},
 	"devDependencies": {
-		"@babel/core": "7.0.0-beta.56",
-		"@babel/traverse": "7.0.0-beta.56"
+		"@babel/core": "^7.0.0",
+		"@babel/traverse": "^7.0.0"
 	},
 	"peerDependencies": {
-		"@babel/core": "7.0.0-beta.56"
+		"@babel/core": "^7.0.0"
 	},
 	"publishConfig": {
 		"access": "public"

diff --git a/packages/babel-preset-default/CHANGELOG.md b/packages/babel-preset-default/CHANGELOG.md
@@ -1,3 +1,9 @@
+## 2.1.0 (Unreleased)
+
+### New Feature
+
+- Plugin updated to work with the stable version of Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).
+
 ## 2.0.0 (2018-07-12)
 
 ### Breaking Change

diff --git a/packages/babel-preset-default/package.json b/packages/babel-preset-default/package.json
@@ -23,17 +23,17 @@
 	},
 	"main": "index.js",
 	"dependencies": {
-		"@babel/plugin-proposal-async-generator-functions": "7.0.0-beta.56",
-		"@babel/plugin-proposal-object-rest-spread": "7.0.0-beta.56",
-		"@babel/plugin-transform-react-jsx": "7.0.0-beta.56",
-		"@babel/plugin-transform-runtime": "7.0.0-beta.56",
-		"@babel/preset-env": "7.0.0-beta.56",
-		"@babel/runtime-corejs2": "7.0.0-beta.56",
+		"@babel/plugin-proposal-async-generator-functions": "^7.0.0",
+		"@babel/plugin-proposal-object-rest-spread": "^7.0.0",
+		"@babel/plugin-transform-react-jsx": "^7.0.0",
+		"@babel/plugin-transform-runtime": "^7.0.0",
+		"@babel/preset-env": "^7.0.0",
+		"@babel/runtime": "^7.0.0",
 		"@wordpress/browserslist-config": "file:../browserslist-config",
 		"babel-core": "^7.0.0-bridge.0"
 	},
 	"peerDependencies": {
-		"@babel/core": "^7.0.0-beta.50"
+		"@babel/core": "^7.0.0"
 	},
 	"publishConfig": {
 		"access": "public"

diff --git a/packages/blob/CHANGELOG.md b/packages/blob/CHANGELOG.md
@@ -0,0 +1,5 @@
+## 2.0.0 (Unreleased)
+
+### Breaking Change
+
+- Change how required built-ins are polyfilled with Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).  If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods.
diff --git a/packages/blob/package.json b/packages/blob/package.json
@@ -19,7 +19,7 @@
 	"main": "build/index.js",
 	"module": "build-module/index.js",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56"
+		"@babel/runtime": "^7.0.0"
 	},
 	"publishConfig": {
 		"access": "public"

diff --git a/packages/block-library/CHANGELOG.md b/packages/block-library/CHANGELOG.md
@@ -0,0 +1,5 @@
+## 2.0.0 (Unreleased)
+
+### Breaking Change
+
+- Change how required built-ins are polyfilled with Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).  If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods.
diff --git a/packages/block-library/README.md b/packages/block-library/README.md
@@ -10,6 +10,8 @@ Install the module
 npm install @wordpress/block-library --save
 ```
 
+_This package assumes that your code will run in an **ES2015+** environment. If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._
+
 ## Usage
 
 ```js

diff --git a/packages/block-library/package.json b/packages/block-library/package.json
@@ -20,7 +20,7 @@
 	"module": "build-module/index.js",
 	"react-native": "src/index",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56",
+		"@babel/runtime": "^7.0.0",
 		"@wordpress/autop": "file:../autop",
 		"@wordpress/blob": "file:../blob",
 		"@wordpress/blocks": "file:../blocks",

diff --git a/packages/blocks/CHANGELOG.md b/packages/blocks/CHANGELOG.md
@@ -1,8 +1,9 @@
-## v3.0.0 (Unreleased)
+## 3.0.0 (Unreleased)
 
 ### Breaking Change
 
 - The `isSharedBlock` function is removed. Use `isReusableBlock` instead.
+- Change how required built-ins are polyfilled with Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).  If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods.
 
 ### Deprecations
 

diff --git a/packages/blocks/README.md b/packages/blocks/README.md
@@ -14,6 +14,16 @@ blog.
 The following documentation outlines steps you as a developer will need to
 follow to add your own custom blocks to WordPress's editor interfaces.
 
+## Installation
+
+Install the module
+
+```bash
+npm install @wordpress/bocks --save
+```
+
+_This package assumes that your code will run in an **ES2015+** environment. If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._
+
 ## Getting Started
 
 If you're not already accustomed to working with JavaScript in your WordPress

diff --git a/packages/blocks/package.json b/packages/blocks/package.json
@@ -20,7 +20,7 @@
 	"module": "build-module/index.js",
 	"react-native": "src/index",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56",
+		"@babel/runtime": "^7.0.0",
 		"@wordpress/autop": "file:../autop",
 		"@wordpress/blob": "file:../blob",
 		"@wordpress/block-serialization-spec-parser": "file:../block-serialization-spec-parser",

diff --git a/packages/components/CHANGELOG.md b/packages/components/CHANGELOG.md
@@ -1,9 +1,10 @@
-## v3.0.0 (Unreleased)
+## 3.0.0 (Unreleased)
 
 ### Breaking Change
 
 - `withAPIData` has been removed. Please use the Core Data module or `@wordpress/api-fetch` directly instead.
 - `wp.components.Draggable` as a DOM node drag handler has been deprecated. Please, use `wp.components.Draggable` as a wrap component for your DOM node drag handler.
+- Change how required built-ins are polyfilled with Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).  If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods.
 
 ### New Feature
 

diff --git a/packages/components/README.md b/packages/components/README.md
@@ -10,6 +10,8 @@ Install the module
 npm install @wordpress/components --save
 ```
 
+_This package assumes that your code will run in an **ES2015+** environment. If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._
+
 ## Usage
 
 Within Gutenberg, these components can be accessed by importing from the `components` root directory:

diff --git a/packages/components/package.json b/packages/components/package.json
@@ -20,7 +20,7 @@
 	"module": "build-module/index.js",
 	"react-native": "src/index",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56",
+		"@babel/runtime": "^7.0.0",
 		"@wordpress/a11y": "file:../a11y",
 		"@wordpress/api-fetch": "file:../api-fetch",
 		"@wordpress/compose": "file:../compose",

diff --git a/packages/compose/CHANGELOG.md b/packages/compose/CHANGELOG.md
@@ -0,0 +1,5 @@
+## 2.0.0 (Unreleased)
+
+### Breaking Change
+
+- Change how required built-ins are polyfilled with Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)).  If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods.
diff --git a/packages/compose/README.md b/packages/compose/README.md
@@ -10,6 +10,8 @@ Install the module
 npm install @wordpress/compose --save
 ```
 
+_This package assumes that your code will run in an **ES2015+** environment. If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._
+
 ## Usage
 
 ```js

diff --git a/packages/compose/package.json b/packages/compose/package.json
@@ -21,7 +21,7 @@
 	"module": "build-module/index.js",
 	"react-native": "src/index",
 	"dependencies": {
-		"@babel/runtime-corejs2": "7.0.0-beta.56",
+		"@babel/runtime": "^7.0.0",
 		"@wordpress/element": "file:../element",
 		"@wordpress/is-shallow-equal": "file:../is-shallow-equal",
 		"lodash": "^4.17.10"