Merge pull request #56 from babel/builtins-option

add useBuiltIns option

README.md

@@ -120,6 +120,47 @@ Useful if there is a bug in a native implementation, or a combination of a non-s
 
 Ex: Node 4 supports native classes but not spread.
 
+### `useBuiltIns`: `boolean`
+
+Defaults to `false`.
+
+A way to apply `babel-preset-env` for polyfills (via "babel-polyfill").
+
+> NOTE: This does not currently polyfill experimental/stage-x built-ins like the regular "babel-polyfill" does.
+> This will only work with npm >= 3 (which should be used with Babel 6 anyway)
+
+```
+npm install babel-polyfill --save
+```
+
+This option will apply a new plugin that replaces the statement `import "babel-polyfill"` or `require("babel-polyfill")` with individual requires for `babel-polyfill` based on environment.
+
+> NOTE: Only use `require("babel-polyfill");` once in your whole app. One option is to create single entry file that only contains the require statement.
+
+In
+
+```js
+import "babel-polyfill";
+```
+
+Out (different based on environment)
+
+```js
+import "core-js/modules/es7.string.pad-start";
+import "core-js/modules/es7.string.pad-end";
+import "core-js/modules/web.timers";
+import "core-js/modules/web.immediate";
+import "core-js/modules/web.dom.iterable";
+```
+
+> This will also work for "core-js" directly (`import "core-js";`)
+
+```
+npm install core-js --save
+```
+
+---
+
 ## Examples
 
 ```js

data/builtInFeatures.js

@@ -0,0 +1,134 @@
+// https://github.com/zloirock/core-js
+
+const es2015 = {
+  // "es6.typed/array-buffer": "typed arrays / ",
+  "es6.typed.data-view": "typed arrays / DataView",
+  "es6.typed.int8-array": "typed arrays / Int8Array",
+  "es6.typed.uint8-array": "typed arrays / Uint8Array",
+  "es6.typed.uint8-clamped-array": "typed arrays / Uint8ClampedArray",
+  "es6.typed.int16-array": "typed arrays / Int16Array",
+  "es6.typed.uint16-array": "typed arrays / Uint16Array",
+  "es6.typed.int32-array": "typed arrays / Int32Array",
+  "es6.typed.uint32-array": "typed arrays / Uint32Array",
+  "es6.typed.float32-array": "typed arrays / Float32Array",
+  "es6.typed.float64-array": "typed arrays / Float64Array",
+
+  "es6.map": "Map",
+  "es6.set": "Set",
+  "es6.weak-map": "WeakMap",
+  "es6.weak-set": "WeakSet",
+  // Proxy not implementable
+
+  "es6.reflect.apply": "Reflect / Reflect.apply",
+  "es6.reflect.construct": "Reflect / Reflect.construct",
+  "es6.reflect.define-property": "Reflect / Reflect.defineProperty",
+  "es6.reflect.delete-property": "Reflect / Reflect.deleteProperty",
+  "es6.reflect.get": "Reflect / Reflect.get",
+  "es6.reflect.get-own-property-descriptor": "Reflect / Reflect.getOwnPropertyDescriptor",
+  "es6.reflect.get-prototype-of": "Reflect / Reflect.getPrototypeOf",
+  "es6.reflect.has": "Reflect / Reflect.has",
+  "es6.reflect.is-extensible": "Reflect / Reflect.isExtensible",
+  "es6.reflect.own-keys": "Reflect / Reflect.ownKeys",
+  "es6.reflect.prevent-extensions": "Reflect / Reflect.preventExtensions",
+  "es6.reflect.set": "Reflect / Reflect.set",
+  "es6.reflect.set-prototype-of": "Reflect / Reflect.setPrototypeOf",
+
+  "es6.promise": "Promise",
+
+  "es6.symbol": {
+    features: [
+      "Symbol",
+      "well-known symbols / Symbol.hasInstance",
+      "well-known symbols / Symbol.isConcatSpreadable",
+      "well-known symbols / Symbol.iterator",
+      "well-known symbols / Symbol.match",
+      "well-known symbols / Symbol.replace",
+      "well-known symbols / Symbol.search",
+      "well-known symbols / Symbol.species",
+      "well-known symbols / Symbol.split",
+      "well-known symbols / Symbol.toPrimitive",
+      "well-known symbols / Symbol.toStringTag",
+      "well-known symbols / Symbol.unscopables",
+    ]
+  },
+
+  "es6.object.assign": "Object static methods / Object.assign",
+  "es6.object.is": "Object static methods / Object.is",
+  "es6.object.get-own-property-symbols": "Object static methods / Object.getOwnPropertySymbols",
+  "es6.object.set-prototype-of": "Object static methods / Object.setPrototypeOf",
+
+  "es6.function.name": 'function "name" property',
+
+  "es6.string.raw": "String static methods / String.raw",
+  "es6.string.from-code-point": "String static methods / String.fromCodePoint",
+
+  "es6.string.code-point-at": "String.prototype methods / String.prototype.codePointAt",
+  // "String.prototype methods / String.prototype.normalize" not implemented
+  "es6.string.repeat": "String.prototype methods / String.prototype.repeat",
+  "es6.string.starts-with": "String.prototype methods / String.prototype.startsWith",
+  "es6.string.ends-with": "String.prototype methods / String.prototype.endsWith",
+  "es6.string.includes": "String.prototype methods / String.prototype.includes",
+
+  "es6.regexp.flags": "RegExp.prototype properties / RegExp.prototype.flags",
+  "es6.regexp.match": "RegExp.prototype properties / RegExp.prototype[Symbol.match]",
+  "es6.regexp.replace": "RegExp.prototype properties / RegExp.prototype[Symbol.replace]",
+  "es6.regexp.split": "RegExp.prototype properties / RegExp.prototype[Symbol.split]",
+  "es6.regexp.search": "RegExp.prototype properties / RegExp.prototype[Symbol.search]",
+
+  "es6.array.from": "Array static methods / Array.from",
+  "es6.array.of": "Array static methods / Array.of",
+
+  "es6.array.copy-within": "Array.prototype methods / Array.prototype.copyWithin",
+  "es6.array.find": "Array.prototype methods / Array.prototype.find",
+  "es6.array.find-index": "Array.prototype methods / Array.prototype.findIndex",
+  "es6.array.fill": "Array.prototype methods / Array.prototype.fill",
+
+  "es6.array.iterator": {
+   features: [
+     "Array.prototype methods / Array.prototype.keys",
+     // can use Symbol.iterator, not implemented in many environments
+     // "Array.prototype methods / Array.prototype.values",
+     "Array.prototype methods / Array.prototype.entries",
+    ]
+  },
+
+  "es6.number.is-finite": "Number properties / Number.isFinite",
+  "es6.number.is-integer": "Number properties / Number.isInteger",
+  "es6.number.is-safe-integer": "Number properties / Number.isSafeInteger",
+  "es6.number.is-nan": "Number properties / Number.isNaN",
+  "es6.number.epsilon": "Number properties / Number.EPSILON",
+  "es6.number.min-safe-integer": "Number properties / Number.MIN_SAFE_INTEGER",
+  "es6.number.max-safe-integer": "Number properties / Number.MAX_SAFE_INTEGER",
+
+  "es6.math.acosh": "Math methods / Math.acosh",
+  "es6.math.asinh": "Math methods / Math.asinh",
+  "es6.math.atanh": "Math methods / Math.atanh",
+  "es6.math.cbrt": "Math methods / Math.cbrt",
+  "es6.math.clz32": "Math methods / Math.clz32",
+  "es6.math.cosh": "Math methods / Math.cosh",
+  "es6.math.expm1": "Math methods / Math.expm1",
+  "es6.math.fround": "Math methods / Math.fround",
+  "es6.math.hypot": "Math methods / Math.hypot",
+  "es6.math.imul": "Math methods / Math.imul",
+  "es6.math.log1p": "Math methods / Math.log1p",
+  "es6.math.log10": "Math methods / Math.log10",
+  "es6.math.log2": "Math methods / Math.log2",
+  "es6.math.sign": "Math methods / Math.sign",
+  "es6.math.sinh": "Math methods / Math.sinh",
+  "es6.math.tanh": "Math methods / Math.tanh",
+  "es6.math.trunc": "Math methods / Math.trunc",
+};
+
+const es2016 = {
+  "es7.array.includes.js": "Array.prototype.includes",
+};
+
+const es2017 = {
+  "es7.object.values": "Object.values",
+  "es7.object.entries": "Object.entries",
+  "es7.object.get-own-property-descriptors": "Object.getOwnPropertyDescriptors",
+  "es7.string.pad-start": "String padding / String.prototype.padStart",
+  "es7.string.pad-end": "String padding / String.prototype.padEnd",
+};
+
+module.exports = Object.assign({}, es2015, es2016, es2017);