Rename all proposal plugins to -proposal- from -transform- (#6570)

This commit is contained in:
Henry Zhu
2017-10-27 15:26:38 -04:00
committed by GitHub
parent a94aa54230
commit c41abd79a1
599 changed files with 372 additions and 372 deletions

View File

@@ -0,0 +1,3 @@
src
test
*.log

View File

@@ -0,0 +1,114 @@
# @babel/plugin-proposal-numeric-separator
> This plugin allows Babel to transform Decimal, Binary, Hex and Octal literals containing Numeric Literal Separator to their non-separated form.
## Example
### Decimal Literals
```js
let budget = 1_000_000_000_000;
// What is the value of `budget`? It's 1 trillion!
//
// Let's confirm:
console.log(budget === 10 ** 12); // true
```
### Binary Literals
```js
let nibbles = 0b1010_0001_1000_0101;
// Is bit 7 on? It sure is!
// 0b1010_0001_1000_0101
// ^
//
// We can double check:
console.log(!!(nibbles & (1 << 7))); // true
```
### Hex Literal
```js
// Messages are sent as 24 bit values, but should be
// treated as 3 distinct bytes:
let message = 0xA0_B0_C0;
// What's the value of the upper most byte? It's A0, or 160.
// We can confirm that:
let a = (message >> 16) & 0xFF;
console.log(a.toString(16), a); // a0, 160
// What's the value of the middle byte? It's B0, or 176.
// Let's just make sure...
let b = (message >> 8) & 0xFF;
console.log(b.toString(16), b); // b0, 176
// What's the value of the lower most byte? It's C0, or 192.
// Again, let's prove that:
let c = message & 0xFF;
console.log(c.toString(16), b); // c0, 192
```
### Octal Literal
*hand wave emoji*
Octals are great for permissions, but also look better when represented in `0o0000` form. No real benefit with separators here.
## Installation
```sh
npm install --save-dev @babel/plugin-proposal-numeric-separator
```
## Usage
### Via `.babelrc` (Recommended)
**.babelrc**
```json
{
"plugins": ["@babel/proposal-numeric-separator"]
}
```
### Via CLI
```sh
babel --plugins @babel/proposal-numeric-separator script.js
```
### Via Node API
```javascript
require("@babel/core").transform("code", {
plugins: ["@babel/proposal-numeric-separator"]
});
```
## Additional Information
If you need to further compile ES2015 Decimal, Binary, Hex and Octal number representations to their pre-ES2015 numeric literal form, add the [`"@babel/transform-es2015-literals"`](http://babeljs.io/docs/plugins/transform-es2015-literals/) plugin:
> `transform-es2015-literals` is already included in [@babel/preset-env](https://github.com/babel/babel/tree/master/experimental/babel-preset-env) and @babel/preset-es2015.
### Via `.babelrc` (Recommended)
**.babelrc**
```json
{
"presets": ["@babel/env"],
"plugins": ["@babel/proposal-numeric-separator"]
}
{
"plugins": ["@babel/proposal-numeric-separator", "@babel/transform-es2015-literals"]
}
```
## References
* [Proposal: Numeric Separators](https://github.com/samuelgoto/proposal-numeric-separator)

View File

@@ -0,0 +1,20 @@
{
"name": "@babel/plugin-proposal-numeric-separator",
"version": "7.0.0-beta.3",
"description": "Remove numeric separators from Decimal, Binary, Hex and Octal literals",
"repository": "https://github.com/babel/babel/tree/master/packages/babel-plugin-proposal-numeric-separator",
"license": "MIT",
"main": "lib/index.js",
"keywords": [
"babel-plugin"
],
"dependencies": {
"@babel/plugin-syntax-numeric-separator": "7.0.0-beta.3"
},
"peerDependencies": {
"@babel/core": "7.0.0-beta.3"
},
"devDependencies": {
"@babel/helper-plugin-test-runner": "7.0.0-beta.3"
}
}

View File

@@ -0,0 +1,31 @@
import syntaxNumericSeparator from "@babel/plugin-syntax-numeric-separator";
export default function({ types: t }) {
function replaceNumberArg({ node }) {
if (node.callee.name !== "Number") {
return;
}
const arg = node.arguments[0];
if (!t.isStringLiteral(arg)) {
return;
}
arg.value = arg.value.replace(/_/g, "");
}
return {
inherits: syntaxNumericSeparator,
visitor: {
CallExpression: replaceNumberArg,
NewExpression: replaceNumberArg,
NumericLiteral({ node }) {
const { extra } = node;
if (extra && /_/.test(extra.raw)) {
extra.raw = extra.raw.replace(/_/g, "");
}
},
},
};
}

View File

@@ -0,0 +1,19 @@
assert.equal(Number("1_000"), Number("1000"));
assert.equal(Number("0xAE_BE_CE"), Number("0xAEBECE"));
assert.equal(Number("0b1010_0001_1000_0101"), Number("0b1010000110000101"));
assert.equal(Number("0o0_6_6_6"), Number("0o0666"));
assert.equal(new Number("1_000").valueOf(), new Number("1000").valueOf());
assert.equal(new Number("0xAE_BE_CE").valueOf(), new Number("0xAEBECE").valueOf());
assert.equal(new Number("0b1010_0001_1000_0101").valueOf(), new Number("0b1010000110000101").valueOf());
assert.equal(new Number("0o0_6_6_6").valueOf(), new Number("0o0666").valueOf());
assert.equal(Number(1_000), Number("1000"));
assert.equal(Number(0xAE_BE_CE), Number("0xAEBECE"));
assert.equal(Number(0b1010_0001_1000_0101), Number("0b1010000110000101"));
assert.equal(Number(0o0_6_6_6), Number("0o0666"));
assert.equal(new Number(1_000).valueOf(), new Number("1000").valueOf());
assert.equal(new Number(0xAE_BE_CE).valueOf(), new Number("0xAEBECE").valueOf());
assert.equal(new Number(0b1010_0001_1000_0101).valueOf(), new Number("0b1010000110000101").valueOf());
assert.equal(new Number(0o0_6_6_6).valueOf(), new Number("0o0666").valueOf());

View File

@@ -0,0 +1,3 @@
{
"plugins": ["proposal-numeric-separator"]
}

View File

@@ -0,0 +1,4 @@
assert.equal(1_000, 1000);
assert.equal(0xAE_BE_CE, 0xAEBECE);
assert.equal(0b1010_0001_1000_0101, 0b1010000110000101);
assert.equal(0o0_6_6_6, 0o0666);

View File

@@ -0,0 +1,3 @@
{
"plugins": ["proposal-numeric-separator"]
}

View File

@@ -0,0 +1,4 @@
1_000;
0xA0_B0_C0;
0b1010_0001_1000_0101;
0o0_6_6_6;

View File

@@ -0,0 +1,4 @@
assert.equal(1_000, 1000);
assert.equal(0xAE_BE_CE, 11452110);
assert.equal(0b1010_0001_1000_0101, 41349);
assert.equal(0o0_6_6_6, 438);

View File

@@ -0,0 +1,3 @@
{
"plugins": ["proposal-numeric-separator", "transform-es2015-literals"]
}

View File

@@ -0,0 +1,3 @@
import runner from "@babel/helper-plugin-test-runner";
runner(__dirname);