hermes-parser 0.5.0 → 0.6.0

package/dist/HermesToBabelAdapter.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -73,6 +73,8 @@ export default class HermesToBabelAdapter extends HermesASTAdapter {
         return this.mapRestElement(node);
       case 'ImportExpression':
         return this.mapImportExpression(node);
+      case 'JSXStringLiteral':
+        return this.mapJSXStringLiteral(node);
       case 'PrivateName':
       case 'ClassPrivateProperty':
         return this.mapPrivateProperty(node);
@@ -198,7 +200,7 @@ export default class HermesToBabelAdapter extends HermesASTAdapter {
   mapGenericTypeAnnotation(node: HermesNode): HermesNode {
     // Convert simple `this` generic type to ThisTypeAnnotation
     if (
-      node.typeParameters === null &&
+      node.typeParameters == null &&
       node.id.type === 'Identifier' &&
       node.id.name === 'this'
     ) {
@@ -343,6 +345,19 @@ export default class HermesToBabelAdapter extends HermesASTAdapter {
     };
   }
 
+  mapJSXStringLiteral(node: HermesNode): HermesNode {
+    // Babel expects StringLiterals in JSX,
+    // but Hermes uses JSXStringLiteral to attach the raw value without
+    // having to internally attach it to every single string literal.
+    return {
+      type: 'StringLiteral',
+      loc: node.loc,
+      start: node.start,
+      end: node.end,
+      value: node.value,
+    };
+  }
+
   mapFunction(node: HermesNode): HermesNode {
     // Remove the first parameter if it is a this-type annotation,
     // which is not recognized by Babel.

package/dist/HermesToESTreeAdapter.js

@@ -1,216 +1,237 @@
 "use strict";
 
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
-
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = void 0;
-
-var _HermesASTAdapter2 = _interopRequireDefault(require("./HermesASTAdapter"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+exports.default = void 0;
+
+var _HermesASTAdapter = _interopRequireDefault(require("./HermesASTAdapter"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * 
+ * @format
+ */
+
+/*
+This class does some very "javascripty" things in the name of
+performance which are ultimately impossible to soundly type.
+
+So instead of adding strict types and a large number of suppression
+comments, instead it is left untyped and subclasses are strictly
+typed via a separate flow declaration file.
+*/
+class HermesToESTreeAdapter extends _HermesASTAdapter.default {
+  constructor(options, code) {
+    super(options);
+    this.code = void 0;
+    this.code = code;
+  }
 
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
+  fixSourceLocation(node) {
+    var _this$sourceFilename;
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+    const loc = node.loc;
 
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+    if (loc == null) {
+      return;
+    }
 
-function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+    node.loc = {
+      source: (_this$sourceFilename = this.sourceFilename) != null ? _this$sourceFilename : null,
+      start: loc.start,
+      end: loc.end
+    };
+    node.range = [loc.rangeStart, loc.rangeEnd];
+  }
 
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+  mapNode(node) {
+    this.fixSourceLocation(node);
 
-function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+    switch (node.type) {
+      case 'Program':
+        return this.mapProgram(node);
 
-function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+      case 'NullLiteral':
+        return this.mapNullLiteral(node);
 
-function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+      case 'BooleanLiteral':
+      case 'StringLiteral':
+      case 'NumericLiteral':
+      case 'JSXStringLiteral':
+        return this.mapSimpleLiteral(node);
 
-function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+      case 'BigIntLiteral':
+        return this.mapBigIntLiteral(node);
 
-function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+      case 'RegExpLiteral':
+        return this.mapRegExpLiteral(node);
 
-var HermesToESTreeAdapter = /*#__PURE__*/function (_HermesASTAdapter) {
-  _inherits(HermesToESTreeAdapter, _HermesASTAdapter);
+      case 'Empty':
+        return this.mapEmpty(node);
 
-  var _super = _createSuper(HermesToESTreeAdapter);
+      case 'TemplateElement':
+        return this.mapTemplateElement(node);
 
-  function HermesToESTreeAdapter(options, code) {
-    var _this;
+      case 'BigIntLiteralTypeAnnotation':
+        return this.mapBigIntLiteralTypeAnnotation(node);
 
-    _classCallCheck(this, HermesToESTreeAdapter);
+      case 'GenericTypeAnnotation':
+        return this.mapGenericTypeAnnotation(node);
 
-    _this = _super.call(this, options);
+      case 'ImportDeclaration':
+        return this.mapImportDeclaration(node);
 
-    _defineProperty(_assertThisInitialized(_this), "code", void 0);
+      case 'ImportSpecifier':
+        return this.mapImportSpecifier(node);
 
-    _this.code = code;
-    return _this;
-  }
+      case 'ExportDefaultDeclaration':
+        return this.mapExportDefaultDeclaration(node);
 
-  _createClass(HermesToESTreeAdapter, [{
-    key: "fixSourceLocation",
-    value: function fixSourceLocation(node) {
-      var _this$sourceFilename;
+      case 'ExportNamedDeclaration':
+        return this.mapExportNamedDeclaration(node);
 
-      var loc = node.loc;
+      case 'ExportAllDeclaration':
+        return this.mapExportAllDeclaration(node);
 
-      if (loc == null) {
-        return;
-      }
+      case 'PrivateName':
+      case 'ClassPrivateProperty':
+        return this.mapPrivateProperty(node);
 
-      node.loc = {
-        source: (_this$sourceFilename = this.sourceFilename) !== null && _this$sourceFilename !== void 0 ? _this$sourceFilename : null,
-        start: loc.start,
-        end: loc.end
-      };
-      node.range = [loc.rangeStart, loc.rangeEnd];
+      default:
+        return this.mapNodeDefault(node);
     }
-  }, {
-    key: "mapNode",
-    value: function mapNode(node) {
-      this.fixSourceLocation(node);
-
-      switch (node.type) {
-        case 'Program':
-          return this.mapProgram(node);
-
-        case 'NullLiteral':
-          return this.mapNullLiteral(node);
-
-        case 'BooleanLiteral':
-        case 'StringLiteral':
-        case 'NumericLiteral':
-          return this.mapSimpleLiteral(node);
+  }
 
-        case 'RegExpLiteral':
-          return this.mapRegExpLiteral(node);
+  mapProgram(node) {
+    node = this.mapNodeDefault(node);
+    node.sourceType = this.getSourceType();
+    return node;
+  }
 
-        case 'Empty':
-          return this.mapEmpty(node);
+  mapSimpleLiteral(node) {
+    return {
+      type: 'Literal',
+      loc: node.loc,
+      range: node.range,
+      value: node.value,
+      raw: this.code.slice(node.range[0], node.range[1]),
+      literalType: (() => {
+        switch (node.type) {
+          case 'NullLiteral':
+            return 'null';
+
+          case 'BooleanLiteral':
+            return 'boolean';
+
+          case 'StringLiteral':
+          case 'JSXStringLiteral':
+            return 'string';
+
+          case 'NumericLiteral':
+            return 'numeric';
+
+          case 'BigIntLiteral':
+            return 'bigint';
+
+          case 'RegExpLiteral':
+            return 'regexp';
+        }
 
-        case 'TemplateElement':
-          return this.mapTemplateElement(node);
+        return null;
+      })()
+    };
+  }
 
-        case 'GenericTypeAnnotation':
-          return this.mapGenericTypeAnnotation(node);
+  mapBigIntLiteral(node) {
+    const newNode = this.mapSimpleLiteral(node);
+    const bigint = node.bigint // estree spec is to not have a trailing `n` on this property
+    // https://github.com/estree/estree/blob/db962bb417a97effcfe9892f87fbb93c81a68584/es2020.md#bigintliteral
+    .replace(/n$/, '') // `BigInt` doesn't accept numeric separator and `bigint` property should not include numeric separator
+    .replace(/_/, '');
+    return { ...newNode,
+      // coerce the string to a bigint value if supported by the environment
+      value: typeof BigInt === 'function' ? BigInt(bigint) : null,
+      bigint
+    };
+  }
 
-        case 'ImportDeclaration':
-          return this.mapImportDeclaration(node);
+  mapNullLiteral(node) {
+    return { ...this.mapSimpleLiteral(node),
+      value: null
+    };
+  }
 
-        case 'ImportSpecifier':
-          return this.mapImportSpecifier(node);
+  mapRegExpLiteral(node) {
+    const {
+      pattern,
+      flags
+    } = node; // Create RegExp value if possible. This can fail when the flags are invalid.
 
-        case 'ExportDefaultDeclaration':
-          return this.mapExportDefaultDeclaration(node);
+    let value;
 
-        case 'ExportNamedDeclaration':
-          return this.mapExportNamedDeclaration(node);
+    try {
+      value = new RegExp(pattern, flags);
+    } catch (e) {
+      value = null;
+    }
 
-        case 'ExportAllDeclaration':
-          return this.mapExportAllDeclaration(node);
+    return { ...this.mapSimpleLiteral(node),
+      value,
+      regex: {
+        pattern,
+        flags
+      }
+    };
+  }
 
-        case 'PrivateName':
-        case 'ClassPrivateProperty':
-          return this.mapPrivateProperty(node);
+  mapBigIntLiteralTypeAnnotation(node) {
+    node.value = null;
+    return node;
+  }
 
-        default:
-          return this.mapNodeDefault(node);
-      }
-    }
-  }, {
-    key: "mapProgram",
-    value: function mapProgram(node) {
-      node = this.mapNodeDefault(node);
-      node.sourceType = this.getSourceType();
-      return node;
-    }
-  }, {
-    key: "mapSimpleLiteral",
-    value: function mapSimpleLiteral(node) {
-      node.type = 'Literal';
-      node.raw = this.code.slice(node.range[0], node.range[1]);
-      return node;
-    }
-  }, {
-    key: "mapNullLiteral",
-    value: function mapNullLiteral(node) {
-      node.type = 'Literal';
-      node.value = null;
-      node.raw = this.code.slice(node.range[0], node.range[1]);
-      return node;
-    }
-  }, {
-    key: "mapRegExpLiteral",
-    value: function mapRegExpLiteral(node) {
-      var pattern = node.pattern,
-          flags = node.flags; // Create RegExp value if possible. This can fail when the flags are invalid.
-
-      var value;
-
-      try {
-        value = new RegExp(pattern, flags);
-      } catch (e) {
-        value = null;
+  mapTemplateElement(node) {
+    return {
+      type: 'TemplateElement',
+      loc: node.loc,
+      range: node.range,
+      tail: node.tail,
+      value: {
+        cooked: node.cooked,
+        raw: node.raw
       }
+    };
+  }
 
+  mapGenericTypeAnnotation(node) {
+    // Convert simple `this` generic type to ThisTypeAnnotation
+    if (node.typeParameters == null && node.id.type === 'Identifier' && node.id.name === 'this') {
       return {
-        type: 'Literal',
-        loc: node.loc,
-        range: node.range,
-        value: value,
-        raw: this.code.slice(node.range[0], node.range[1]),
-        regex: {
-          pattern: pattern,
-          flags: flags
-        }
-      };
-    }
-  }, {
-    key: "mapTemplateElement",
-    value: function mapTemplateElement(node) {
-      return {
-        type: 'TemplateElement',
+        type: 'ThisTypeAnnotation',
         loc: node.loc,
-        range: node.range,
-        tail: node.tail,
-        value: {
-          cooked: node.cooked,
-          raw: node.raw
-        }
+        range: node.range
       };
     }
-  }, {
-    key: "mapGenericTypeAnnotation",
-    value: function mapGenericTypeAnnotation(node) {
-      // Convert simple `this` generic type to ThisTypeAnnotation
-      if (node.typeParameters === null && node.id.type === 'Identifier' && node.id.name === 'this') {
-        return {
-          type: 'ThisTypeAnnotation',
-          loc: node.loc,
-          range: node.range
-        };
-      }
 
-      return this.mapNodeDefault(node);
-    }
-  }, {
-    key: "mapComment",
-    value: function mapComment(node) {
-      if (node.type === 'CommentBlock') {
-        node.type = 'Block';
-      } else if (node.type === 'CommentLine') {
-        node.type = 'Line';
-      }
+    return this.mapNodeDefault(node);
+  }
 
-      return node;
+  mapComment(node) {
+    if (node.type === 'CommentBlock') {
+      node.type = 'Block';
+    } else if (node.type === 'CommentLine') {
+      node.type = 'Line';
     }
-  }]);
 
-  return HermesToESTreeAdapter;
-}(_HermesASTAdapter2["default"]);
+    return node;
+  }
+
+}
 
-exports["default"] = HermesToESTreeAdapter;
+exports.default = HermesToESTreeAdapter;

package/dist/HermesToESTreeAdapter.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -22,6 +22,8 @@ import type {ParserOptions} from './ParserOptions';
 
 import HermesASTAdapter from './HermesASTAdapter';
 
+declare var BigInt: ?(value: $FlowFixMe) => mixed;
+
 export default class HermesToESTreeAdapter extends HermesASTAdapter {
   +code: string;
 
@@ -55,13 +57,18 @@ export default class HermesToESTreeAdapter extends HermesASTAdapter {
       case 'BooleanLiteral':
       case 'StringLiteral':
       case 'NumericLiteral':
+      case 'JSXStringLiteral':
         return this.mapSimpleLiteral(node);
+      case 'BigIntLiteral':
+        return this.mapBigIntLiteral(node);
       case 'RegExpLiteral':
         return this.mapRegExpLiteral(node);
       case 'Empty':
         return this.mapEmpty(node);
       case 'TemplateElement':
         return this.mapTemplateElement(node);
+      case 'BigIntLiteralTypeAnnotation':
+        return this.mapBigIntLiteralTypeAnnotation(node);
       case 'GenericTypeAnnotation':
         return this.mapGenericTypeAnnotation(node);
       case 'ImportDeclaration':
@@ -90,18 +97,59 @@ export default class HermesToESTreeAdapter extends HermesASTAdapter {
   }
 
   mapSimpleLiteral(node: HermesNode): HermesNode {
-    node.type = 'Literal';
-    node.raw = this.code.slice(node.range[0], node.range[1]);
+    return {
+      type: 'Literal',
+      loc: node.loc,
+      range: node.range,
+      value: node.value,
+      raw: this.code.slice(node.range[0], node.range[1]),
+      literalType: (() => {
+        switch (node.type) {
+          case 'NullLiteral':
+            return 'null';
 
-    return node;
+          case 'BooleanLiteral':
+            return 'boolean';
+
+          case 'StringLiteral':
+          case 'JSXStringLiteral':
+            return 'string';
+
+          case 'NumericLiteral':
+            return 'numeric';
+
+          case 'BigIntLiteral':
+            return 'bigint';
+
+          case 'RegExpLiteral':
+            return 'regexp';
+        }
+        return null;
+      })(),
+    };
   }
 
-  mapNullLiteral(node: HermesNode): HermesNode {
-    node.type = 'Literal';
-    node.value = null;
-    node.raw = this.code.slice(node.range[0], node.range[1]);
+  mapBigIntLiteral(node: HermesNode): HermesNode {
+    const newNode = this.mapSimpleLiteral(node);
+    const bigint = node.bigint
+      // estree spec is to not have a trailing `n` on this property
+      // https://github.com/estree/estree/blob/db962bb417a97effcfe9892f87fbb93c81a68584/es2020.md#bigintliteral
+      .replace(/n$/, '')
+      // `BigInt` doesn't accept numeric separator and `bigint` property should not include numeric separator
+      .replace(/_/, '');
+    return {
+      ...newNode,
+      // coerce the string to a bigint value if supported by the environment
+      value: typeof BigInt === 'function' ? BigInt(bigint) : null,
+      bigint,
+    };
+  }
 
-    return node;
+  mapNullLiteral(node: HermesNode): HermesNode {
+    return {
+      ...this.mapSimpleLiteral(node),
+      value: null,
+    };
   }
 
   mapRegExpLiteral(node: HermesNode): HermesNode {
@@ -116,11 +164,8 @@ export default class HermesToESTreeAdapter extends HermesASTAdapter {
     }
 
     return {
-      type: 'Literal',
-      loc: node.loc,
-      range: node.range,
+      ...this.mapSimpleLiteral(node),
       value,
-      raw: this.code.slice(node.range[0], node.range[1]),
       regex: {
         pattern,
         flags,
@@ -128,6 +173,11 @@ export default class HermesToESTreeAdapter extends HermesASTAdapter {
     };
   }
 
+  mapBigIntLiteralTypeAnnotation(node: HermesNode): HermesNode {
+    node.value = null;
+    return node;
+  }
+
   mapTemplateElement(node: HermesNode): HermesNode {
     return {
       type: 'TemplateElement',
@@ -144,7 +194,7 @@ export default class HermesToESTreeAdapter extends HermesASTAdapter {
   mapGenericTypeAnnotation(node: HermesNode): HermesNode {
     // Convert simple `this` generic type to ThisTypeAnnotation
     if (
-      node.typeParameters === null &&
+      node.typeParameters == null &&
       node.id.type === 'Identifier' &&
       node.id.name === 'this'
     ) {

package/dist/ParserOptions.js.flow

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.