hermes-parser 0.5.0 → 0.6.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) Facebook, Inc. and its affiliates.
+Copyright (c) Meta Platforms, Inc. and affiliates.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/HermesAST.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.
@@ -33,6 +33,7 @@ export type HermesToken = {
     | 'Keyword'
     | 'Null'
     | 'Numeric'
+    | 'BigInt'
     | 'Punctuator'
     | 'String'
     | 'RegularExpression'

package/dist/HermesASTAdapter.js

@@ -3,30 +3,37 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = void 0;
+exports.default = void 0;
 
 var _visitorKeys = require("./generated/visitor-keys");
 
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-
-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); } }
+/**
+ * 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
+ */
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+/*
+This class does some very "javascripty" things in the name of
+performance which are ultimately impossible to soundly type.
 
-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; }
+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.
+*/
 
 /**
  * The base class for transforming the Hermes AST to the desired output format.
  * Extended by concrete adapters which output an ESTree or Babel AST.
  */
-var HermesASTAdapter = /*#__PURE__*/function () {
-  function HermesASTAdapter(options) {
-    _classCallCheck(this, HermesASTAdapter);
-
-    _defineProperty(this, "sourceFilename", void 0);
-
-    _defineProperty(this, "sourceType", void 0);
-
+class HermesASTAdapter {
+  constructor(options) {
+    this.sourceFilename = void 0;
+    this.sourceType = void 0;
     this.sourceFilename = options.sourceFilename;
     this.sourceType = options.sourceType;
   }
@@ -36,162 +43,144 @@ var HermesASTAdapter = /*#__PURE__*/function () {
    */
 
 
-  _createClass(HermesASTAdapter, [{
-    key: "transform",
-    value: function transform(program) {
-      // Comments are not traversed via visitor keys
-      var comments = program.comments;
+  transform(program) {
+    // Comments are not traversed via visitor keys
+    const comments = program.comments;
 
-      for (var i = 0; i < comments.length; i++) {
-        var comment = comments[i];
-        this.fixSourceLocation(comment);
-        comments[i] = this.mapComment(comment);
-      } // The first comment may be an interpreter directive and is stored directly on the program node
+    for (let i = 0; i < comments.length; i++) {
+      const comment = comments[i];
+      this.fixSourceLocation(comment);
+      comments[i] = this.mapComment(comment);
+    } // The first comment may be an interpreter directive and is stored directly on the program node
 
 
-      program.interpreter = comments.length > 0 && comments[0].type === 'InterpreterDirective' ? comments.shift() : null; // Tokens are not traversed via visitor keys
+    program.interpreter = comments.length > 0 && comments[0].type === 'InterpreterDirective' ? comments.shift() : null; // Tokens are not traversed via visitor keys
 
-      var tokens = program.tokens;
+    const tokens = program.tokens;
 
-      if (tokens) {
-        for (var _i = 0; _i < tokens.length; _i++) {
-          this.fixSourceLocation(tokens[_i]);
-        }
+    if (tokens) {
+      for (let i = 0; i < tokens.length; i++) {
+        this.fixSourceLocation(tokens[i]);
       }
-
-      return this.mapNode(program);
-    }
-    /**
-     * Transform a Hermes AST node to the output AST format.
-     *
-     * This may modify the input node in-place and return that same node, or a completely
-     * new node may be constructed and returned. Overriden in child classes.
-     */
-
-  }, {
-    key: "mapNode",
-    value: function mapNode(_node) {
-      throw new Error('Implemented in subclasses');
     }
-  }, {
-    key: "mapNodeDefault",
-    value: function mapNodeDefault(node) {
-      var visitorKeys = _visitorKeys.HERMES_AST_VISITOR_KEYS[node.type];
 
-      for (var key in visitorKeys) {
-        var childType = visitorKeys[key];
+    return this.mapNode(program);
+  }
+  /**
+   * Transform a Hermes AST node to the output AST format.
+   *
+   * This may modify the input node in-place and return that same node, or a completely
+   * new node may be constructed and returned. Overriden in child classes.
+   */
 
-        if (childType === _visitorKeys.NODE_CHILD) {
-          var child = node[key];
 
-          if (child != null) {
-            node[key] = this.mapNode(child);
-          }
-        } else if (childType === _visitorKeys.NODE_LIST_CHILD) {
-          var children = node[key];
+  mapNode(_node) {
+    throw new Error('Implemented in subclasses');
+  }
 
-          for (var i = 0; i < children.length; i++) {
-            var _child = children[i];
+  mapNodeDefault(node) {
+    const visitorKeys = _visitorKeys.HERMES_AST_VISITOR_KEYS[node.type];
 
-            if (_child != null) {
-              children[i] = this.mapNode(_child);
-            }
-          }
+    for (const key in visitorKeys) {
+      const childType = visitorKeys[key];
+
+      if (childType === _visitorKeys.NODE_CHILD) {
+        const child = node[key];
+
+        if (child != null) {
+          node[key] = this.mapNode(child);
         }
-      }
+      } else if (childType === _visitorKeys.NODE_LIST_CHILD) {
+        const children = node[key];
 
-      return node;
-    }
-    /**
-     * Update the source location for this node depending on the output AST format.
-     * This can modify the input node in-place. Overriden in child classes.
-     */
-
-  }, {
-    key: "fixSourceLocation",
-    value: function fixSourceLocation(_node) {
-      throw new Error('Implemented in subclasses');
-    }
-  }, {
-    key: "getSourceType",
-    value: function getSourceType() {
-      var _this$sourceType;
+        for (let i = 0; i < children.length; i++) {
+          const child = children[i];
 
-      return (_this$sourceType = this.sourceType) !== null && _this$sourceType !== void 0 ? _this$sourceType : 'script';
-    }
-  }, {
-    key: "setModuleSourceType",
-    value: function setModuleSourceType() {
-      if (this.sourceType == null) {
-        this.sourceType = 'module';
+          if (child != null) {
+            children[i] = this.mapNode(child);
+          }
+        }
       }
     }
-  }, {
-    key: "mapComment",
-    value: function mapComment(node) {
-      return node;
-    }
-  }, {
-    key: "mapEmpty",
-    value: function mapEmpty(_node) {
-      // $FlowExpectedError
-      return null;
-    }
-  }, {
-    key: "mapImportDeclaration",
-    value: function mapImportDeclaration(node) {
-      if (node.importKind === 'value') {
-        this.setModuleSourceType();
-      }
 
-      return this.mapNodeDefault(node);
-    }
-  }, {
-    key: "mapImportSpecifier",
-    value: function mapImportSpecifier(node) {
-      if (node.importKind === 'value') {
-        node.importKind = null;
-      }
+    return node;
+  }
+  /**
+   * Update the source location for this node depending on the output AST format.
+   * This can modify the input node in-place. Overriden in child classes.
+   */
 
-      return this.mapNodeDefault(node);
+
+  fixSourceLocation(_node) {
+    throw new Error('Implemented in subclasses');
+  }
+
+  getSourceType() {
+    var _this$sourceType;
+
+    return (_this$sourceType = this.sourceType) != null ? _this$sourceType : 'script';
+  }
+
+  setModuleSourceType() {
+    if (this.sourceType == null) {
+      this.sourceType = 'module';
     }
-  }, {
-    key: "mapExportDefaultDeclaration",
-    value: function mapExportDefaultDeclaration(node) {
+  }
+
+  mapComment(node) {
+    return node;
+  }
+
+  mapEmpty(_node) {
+    // $FlowExpectedError
+    return null;
+  }
+
+  mapImportDeclaration(node) {
+    if (node.importKind === 'value') {
       this.setModuleSourceType();
-      return this.mapNodeDefault(node);
     }
-  }, {
-    key: "mapExportNamedDeclaration",
-    value: function mapExportNamedDeclaration(node) {
-      if (node.exportKind === 'value') {
-        this.setModuleSourceType();
-      }
 
-      return this.mapNodeDefault(node);
-    }
-  }, {
-    key: "mapExportAllDeclaration",
-    value: function mapExportAllDeclaration(node) {
-      if (node.exportKind === 'value') {
-        this.setModuleSourceType();
-      }
+    return this.mapNodeDefault(node);
+  }
 
-      return this.mapNodeDefault(node);
+  mapImportSpecifier(node) {
+    if (node.importKind === 'value') {
+      node.importKind = null;
     }
-  }, {
-    key: "mapPrivateProperty",
-    value: function mapPrivateProperty(node) {
-      throw new SyntaxError(this.formatError(node, 'Private properties are not supported'));
+
+    return this.mapNodeDefault(node);
+  }
+
+  mapExportDefaultDeclaration(node) {
+    this.setModuleSourceType();
+    return this.mapNodeDefault(node);
+  }
+
+  mapExportNamedDeclaration(node) {
+    if (node.exportKind === 'value') {
+      this.setModuleSourceType();
     }
-  }, {
-    key: "formatError",
-    value: function formatError(node, message) {
-      return "".concat(message, " (").concat(node.loc.start.line, ":").concat(node.loc.start.column, ")");
+
+    return this.mapNodeDefault(node);
+  }
+
+  mapExportAllDeclaration(node) {
+    if (node.exportKind === 'value') {
+      this.setModuleSourceType();
     }
-  }]);
 
-  return HermesASTAdapter;
-}();
+    return this.mapNodeDefault(node);
+  }
+
+  mapPrivateProperty(node) {
+    throw new SyntaxError(this.formatError(node, 'Private properties are not supported'));
+  }
+
+  formatError(node, message) {
+    return `${message} (${node.loc.start.line}:${node.loc.start.column})`;
+  }
+
+}
 
-exports["default"] = HermesASTAdapter;
+exports.default = HermesASTAdapter;

package/dist/HermesASTAdapter.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.

package/dist/HermesParser.js

@@ -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.
@@ -18,36 +18,36 @@ var _HermesParserDeserializer = _interopRequireDefault(require("./HermesParserDe
 
 var _HermesParserWASM = _interopRequireDefault(require("./HermesParserWASM"));
 
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-var hermesParse = _HermesParserWASM["default"].cwrap('hermesParse', 'number', ['number', 'number', 'number', 'number', 'number']);
+const hermesParse = _HermesParserWASM.default.cwrap('hermesParse', 'number', ['number', 'number', 'number', 'number', 'number']);
 
-var hermesParseResult_free = _HermesParserWASM["default"].cwrap('hermesParseResult_free', 'void', ['number']);
+const hermesParseResult_free = _HermesParserWASM.default.cwrap('hermesParseResult_free', 'void', ['number']);
 
-var hermesParseResult_getError = _HermesParserWASM["default"].cwrap('hermesParseResult_getError', 'string', ['number']);
+const hermesParseResult_getError = _HermesParserWASM.default.cwrap('hermesParseResult_getError', 'string', ['number']);
 
-var hermesParseResult_getErrorLine = _HermesParserWASM["default"].cwrap('hermesParseResult_getErrorLine', 'number', ['number']);
+const hermesParseResult_getErrorLine = _HermesParserWASM.default.cwrap('hermesParseResult_getErrorLine', 'number', ['number']);
 
-var hermesParseResult_getErrorColumn = _HermesParserWASM["default"].cwrap('hermesParseResult_getErrorColumn', 'number', ['number']);
+const hermesParseResult_getErrorColumn = _HermesParserWASM.default.cwrap('hermesParseResult_getErrorColumn', 'number', ['number']);
 
-var hermesParseResult_getProgramBuffer = _HermesParserWASM["default"].cwrap('hermesParseResult_getProgramBuffer', 'number', ['number']);
+const hermesParseResult_getProgramBuffer = _HermesParserWASM.default.cwrap('hermesParseResult_getProgramBuffer', 'number', ['number']);
 
-var hermesParseResult_getPositionBuffer = _HermesParserWASM["default"].cwrap('hermesParseResult_getPositionBuffer', 'number', ['number']);
+const hermesParseResult_getPositionBuffer = _HermesParserWASM.default.cwrap('hermesParseResult_getPositionBuffer', 'number', ['number']);
 
-var hermesParseResult_getPositionBufferSize = _HermesParserWASM["default"].cwrap('hermesParseResult_getPositionBufferSize', 'number', ['number']); // Copy a string into the WASM heap and null-terminate
+const hermesParseResult_getPositionBufferSize = _HermesParserWASM.default.cwrap('hermesParseResult_getPositionBufferSize', 'number', ['number']); // Copy a string into the WASM heap and null-terminate
 
 
 function copyToHeap(buffer, addr) {
-  _HermesParserWASM["default"].HEAP8.set(buffer, addr);
+  _HermesParserWASM.default.HEAP8.set(buffer, addr);
 
-  _HermesParserWASM["default"].HEAP8[addr + buffer.length] = 0;
+  _HermesParserWASM.default.HEAP8[addr + buffer.length] = 0;
 }
 
 function parse(source, options) {
   // Allocate space on heap for source text
-  var sourceBuffer = Buffer.from(source, 'utf8');
+  const sourceBuffer = Buffer.from(source, 'utf8');
 
-  var sourceAddr = _HermesParserWASM["default"]._malloc(sourceBuffer.length + 1);
+  const sourceAddr = _HermesParserWASM.default._malloc(sourceBuffer.length + 1);
 
   if (!sourceAddr) {
     throw new Error('Parser out of memory');
@@ -56,14 +56,14 @@ function parse(source, options) {
   try {
     // Copy source text onto WASM heap
     copyToHeap(sourceBuffer, sourceAddr);
-    var parseResult = hermesParse(sourceAddr, sourceBuffer.length + 1, options.flow === 'detect', options.tokens, options.allowReturnOutsideFunction);
+    const parseResult = hermesParse(sourceAddr, sourceBuffer.length + 1, options.flow === 'detect', options.tokens, options.allowReturnOutsideFunction);
 
     try {
       // Extract and throw error from parse result if parsing failed
-      var err = hermesParseResult_getError(parseResult);
+      const err = hermesParseResult_getError(parseResult);
 
       if (err) {
-        var syntaxError = new SyntaxError(err); // $FlowExpectedError[prop-missing]
+        const syntaxError = new SyntaxError(err); // $FlowExpectedError[prop-missing]
 
         syntaxError.loc = {
           line: hermesParseResult_getErrorLine(parseResult),
@@ -72,12 +72,12 @@ function parse(source, options) {
         throw syntaxError;
       }
 
-      var deserializer = new _HermesParserDeserializer["default"](hermesParseResult_getProgramBuffer(parseResult), hermesParseResult_getPositionBuffer(parseResult), hermesParseResult_getPositionBufferSize(parseResult), _HermesParserWASM["default"], options);
+      const deserializer = new _HermesParserDeserializer.default(hermesParseResult_getProgramBuffer(parseResult), hermesParseResult_getPositionBuffer(parseResult), hermesParseResult_getPositionBufferSize(parseResult), _HermesParserWASM.default, options);
       return deserializer.deserialize();
     } finally {
       hermesParseResult_free(parseResult);
     }
   } finally {
-    _HermesParserWASM["default"]._free(sourceAddr);
+    _HermesParserWASM.default._free(sourceAddr);
   }
 }

package/dist/HermesParser.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.

package/dist/HermesParserDecodeUTF8String.js

@@ -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.
@@ -20,16 +20,16 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = HermesParserDecodeUTF8String;
+exports.default = HermesParserDecodeUTF8String;
 
 function HermesParserDecodeUTF8String(ptrIn, length, heap) {
-  var ptr = ptrIn;
-  var endPtr = ptr + length;
-  var str = '';
+  let ptr = ptrIn;
+  const endPtr = ptr + length;
+  let str = '';
 
   while (ptr < endPtr) {
     // ASCII characters fit in single byte code point
-    var u0 = heap[ptr++];
+    let u0 = heap[ptr++];
 
     if (!(u0 & 0x80)) {
       str += String.fromCharCode(u0);
@@ -37,16 +37,16 @@ function HermesParserDecodeUTF8String(ptrIn, length, heap) {
     } // Two byte code point
 
 
-    var u1 = heap[ptr++] & 0x3f;
+    const u1 = heap[ptr++] & 0x3f;
 
-    if ((u0 & 0xe0) == 0xc0) {
+    if ((u0 & 0xe0) === 0xc0) {
       str += String.fromCharCode((u0 & 0x1f) << 6 | u1);
       continue;
     }
 
-    var u2 = heap[ptr++] & 0x3f;
+    const u2 = heap[ptr++] & 0x3f;
 
-    if ((u0 & 0xf0) == 0xe0) {
+    if ((u0 & 0xf0) === 0xe0) {
       // Three byte code point
       u0 = (u0 & 0x0f) << 12 | u1 << 6 | u2;
     } else {

package/dist/HermesParserDecodeUTF8String.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.
@@ -37,13 +37,13 @@ export default function HermesParserDecodeUTF8String(
 
     // Two byte code point
     const u1 = heap[ptr++] & 0x3f;
-    if ((u0 & 0xe0) == 0xc0) {
+    if ((u0 & 0xe0) === 0xc0) {
       str += String.fromCharCode(((u0 & 0x1f) << 6) | u1);
       continue;
     }
 
     const u2 = heap[ptr++] & 0x3f;
-    if ((u0 & 0xf0) == 0xe0) {
+    if ((u0 & 0xf0) === 0xe0) {
       // Three byte code point
       u0 = ((u0 & 0x0f) << 12) | (u1 << 6) | u2;
     } else {