hermes-transform 0.5.0 → 0.8.0

package/dist/generated/special-case-node-types.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.
@@ -20,6 +20,7 @@ import type {
   RegExpLiteral as RegExpLiteralType,
   TemplateElement as TemplateElementType,
   Identifier as IdentifierType,
+  BigIntLiteral as BigIntLiteralType,
   BooleanLiteral as BooleanLiteralType,
   NumericLiteral as NumericLiteralType,
   NullLiteral as NullLiteralType,
@@ -144,6 +145,31 @@ export function Identifier({
 // Literals require a "raw" which is added by the estree transform, not hermes.
 //
 
+export type BigIntLiteralProps = {
+  +value: $FlowFixMe /* bigint | null */,
+  /**
+   * Only set this if you want to use a source-code representation like 1_1n, etc.
+   * By default "raw" will just be the exact number you've given.
+   */
+  +raw?: NumericLiteralType['raw'],
+};
+export function BigIntLiteral({
+  parent,
+  ...props
+}: {
+  ...$ReadOnly<BigIntLiteralProps>,
+  +parent?: ESNode,
+}): DetachedNode<BigIntLiteralType> {
+  const node = detachedProps<BigIntLiteralType>(parent, {
+    type: 'Literal',
+    ...props,
+    raw: props.raw ?? `${props.value}n`,
+    bigint: `${props.value}`,
+  });
+  setParentPointersInDirectChildren(node);
+  return node;
+}
+
 export type BooleanLiteralProps = {
   +value: BooleanLiteralType['value'],
 };
@@ -164,7 +190,7 @@ export function BooleanLiteral({
 export type NumericLiteralProps = {
   +value: NumericLiteralType['value'],
   /**
-   * Only set this if you want to use a source-code representation like 1e100, 0x11, etc.
+   * Only set this if you want to use a source-code representation like 1e100, 0x11, 1_1, etc.
    * By default "raw" will just be the exact number you've given.
    */
   +raw?: NumericLiteralType['raw'],

package/dist/getVisitorKeys.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.
@@ -17,17 +17,15 @@ exports.isNode = isNode;
 
 var _hermesEslint = require("hermes-eslint");
 
-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); }
-
 function isNode(thing) {
-  return _typeof(thing) === 'object' && thing != null && typeof thing.type === 'string';
+  return typeof thing === 'object' && thing != null && typeof thing.type === 'string';
 }
 
 function getVisitorKeys(node) {
-  var keys = _hermesEslint.VisitorKeys[node.type];
+  const keys = _hermesEslint.VisitorKeys[node.type];
 
   if (keys == null) {
-    throw new Error("No visitor keys found for node type \"".concat(node.type, "\"."));
+    throw new Error(`No visitor keys found for node type "${node.type}".`);
   } // $FlowExpectedError[prop-missing]
 
 

package/dist/getVisitorKeys.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/index.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.
@@ -9,33 +9,28 @@
  */
 '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.t = void 0;
-Object.defineProperty(exports, "transform", {
-  enumerable: true,
-  get: function get() {
-    return _transform.transform;
-  }
-});
-Object.defineProperty(exports, "traverse", {
-  enumerable: true,
-  get: function get() {
-    return _traverse.traverse;
-  }
-});
+exports.traverseWithContext = exports.traverse = exports.transform = exports.t = exports.SimpleTraverser = void 0;
+
+var _SimpleTraverser = require("./traverse/SimpleTraverser");
+
+exports.SimpleTraverser = _SimpleTraverser.SimpleTraverser;
 
 var _traverse = require("./traverse/traverse");
 
+exports.traverse = _traverse.traverse;
+exports.traverseWithContext = _traverse.traverseWithContext;
+
 var _transform = require("./transform/transform");
 
+exports.transform = _transform.transform;
+
 var _t = _interopRequireWildcard(require("./generated/node-types"));
 
 exports.t = _t;
 
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }

package/dist/index.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.
@@ -10,6 +10,12 @@
 
 'use strict';
 
-export {traverse} from './traverse/traverse';
+export type {TraversalContextBase, Visitor} from './traverse/traverse';
+export type {TransformVisitor} from './transform/transform';
+export type {TransformContext} from './transform/TransformContext';
+export type {DetachedNode} from './detachedNode';
+
+export {SimpleTraverser} from './traverse/SimpleTraverser';
+export {traverse, traverseWithContext} from './traverse/traverse';
 export {transform} from './transform/transform';
 export * as t from './generated/node-types';

package/dist/transform/Errors.js

@@ -1,36 +1,12 @@
 "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.UnexpectedTransformationState = exports.NodeIsMutatedError = exports.NodeIsDeletedError = exports.InvalidStatementError = exports.InvalidReplacementError = exports.InvalidRemovalError = exports.InvalidInsertionError = void 0;
 
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-
-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); }
-
-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); }; }
-
-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); }
-
-function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
-
-function _wrapNativeSuper(Class) { var _cache = typeof Map === "function" ? new Map() : undefined; _wrapNativeSuper = function _wrapNativeSuper(Class) { if (Class === null || !_isNativeFunction(Class)) return Class; if (typeof Class !== "function") { throw new TypeError("Super expression must either be null or a function"); } if (typeof _cache !== "undefined") { if (_cache.has(Class)) return _cache.get(Class); _cache.set(Class, Wrapper); } function Wrapper() { return _construct(Class, arguments, _getPrototypeOf(this).constructor); } Wrapper.prototype = Object.create(Class.prototype, { constructor: { value: Wrapper, enumerable: false, writable: true, configurable: true } }); return _setPrototypeOf(Wrapper, Class); }; return _wrapNativeSuper(Class); }
-
-function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct; } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
-
-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; } }
-
-function _isNativeFunction(fn) { return Function.toString.call(fn).indexOf("[native code]") !== -1; }
-
-function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
-
-function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
-
 /**
- * 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.
@@ -38,114 +14,30 @@ function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.g
  * 
  * @format
  */
-var NodeIsDeletedError = /*#__PURE__*/function (_Error) {
-  _inherits(NodeIsDeletedError, _Error);
-
-  var _super = _createSuper(NodeIsDeletedError);
-
-  function NodeIsDeletedError() {
-    _classCallCheck(this, NodeIsDeletedError);
-
-    return _super.apply(this, arguments);
-  }
-
-  return NodeIsDeletedError;
-}( /*#__PURE__*/_wrapNativeSuper(Error));
+class NodeIsDeletedError extends Error {}
 
 exports.NodeIsDeletedError = NodeIsDeletedError;
 
-var NodeIsMutatedError = /*#__PURE__*/function (_Error2) {
-  _inherits(NodeIsMutatedError, _Error2);
-
-  var _super2 = _createSuper(NodeIsMutatedError);
-
-  function NodeIsMutatedError() {
-    _classCallCheck(this, NodeIsMutatedError);
-
-    return _super2.apply(this, arguments);
-  }
-
-  return NodeIsMutatedError;
-}( /*#__PURE__*/_wrapNativeSuper(Error));
+class NodeIsMutatedError extends Error {}
 
 exports.NodeIsMutatedError = NodeIsMutatedError;
 
-var InvalidInsertionError = /*#__PURE__*/function (_Error3) {
-  _inherits(InvalidInsertionError, _Error3);
-
-  var _super3 = _createSuper(InvalidInsertionError);
-
-  function InvalidInsertionError() {
-    _classCallCheck(this, InvalidInsertionError);
-
-    return _super3.apply(this, arguments);
-  }
-
-  return InvalidInsertionError;
-}( /*#__PURE__*/_wrapNativeSuper(Error));
+class InvalidInsertionError extends Error {}
 
 exports.InvalidInsertionError = InvalidInsertionError;
 
-var UnexpectedTransformationState = /*#__PURE__*/function (_Error4) {
-  _inherits(UnexpectedTransformationState, _Error4);
-
-  var _super4 = _createSuper(UnexpectedTransformationState);
-
-  function UnexpectedTransformationState() {
-    _classCallCheck(this, UnexpectedTransformationState);
-
-    return _super4.apply(this, arguments);
-  }
-
-  return UnexpectedTransformationState;
-}( /*#__PURE__*/_wrapNativeSuper(Error));
+class UnexpectedTransformationState extends Error {}
 
 exports.UnexpectedTransformationState = UnexpectedTransformationState;
 
-var InvalidStatementError = /*#__PURE__*/function (_Error5) {
-  _inherits(InvalidStatementError, _Error5);
-
-  var _super5 = _createSuper(InvalidStatementError);
-
-  function InvalidStatementError() {
-    _classCallCheck(this, InvalidStatementError);
-
-    return _super5.apply(this, arguments);
-  }
-
-  return InvalidStatementError;
-}( /*#__PURE__*/_wrapNativeSuper(Error));
+class InvalidStatementError extends Error {}
 
 exports.InvalidStatementError = InvalidStatementError;
 
-var InvalidRemovalError = /*#__PURE__*/function (_Error6) {
-  _inherits(InvalidRemovalError, _Error6);
-
-  var _super6 = _createSuper(InvalidRemovalError);
-
-  function InvalidRemovalError() {
-    _classCallCheck(this, InvalidRemovalError);
-
-    return _super6.apply(this, arguments);
-  }
-
-  return InvalidRemovalError;
-}( /*#__PURE__*/_wrapNativeSuper(Error));
+class InvalidRemovalError extends Error {}
 
 exports.InvalidRemovalError = InvalidRemovalError;
 
-var InvalidReplacementError = /*#__PURE__*/function (_Error7) {
-  _inherits(InvalidReplacementError, _Error7);
-
-  var _super7 = _createSuper(InvalidReplacementError);
-
-  function InvalidReplacementError() {
-    _classCallCheck(this, InvalidReplacementError);
-
-    return _super7.apply(this, arguments);
-  }
-
-  return InvalidReplacementError;
-}( /*#__PURE__*/_wrapNativeSuper(Error));
+class InvalidReplacementError extends Error {}
 
 exports.InvalidReplacementError = InvalidReplacementError;

package/dist/transform/Errors.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/transform/MutationContext.js

@@ -9,86 +9,73 @@ var _Errors = require("./Errors");
 
 var _comments = require("./comments/comments");
 
-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); } }
-
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
-
-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; }
-
-var MutationContext = /*#__PURE__*/function () {
+/**
+ * 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
+ */
+class MutationContext {
   // TODO - do we care about this? Arrays are pretty safe to concurrently mutate
-  function MutationContext(code) {
-    _classCallCheck(this, MutationContext);
+  constructor(code) {
+    this._deletedNodes = new Set();
+    this._mutatedKeys = new Map();
+    this._mutatedArrays = new Map();
+    this.code = void 0;
+    this.code = code;
+  }
+  /**
+   * Marks a node and its entire subtree as deleted.
+   */
 
-    _defineProperty(this, "_deletedNodes", new Set());
 
-    _defineProperty(this, "_mutatedKeys", new Map());
+  markDeletion(node) {
+    this._deletedNodes.add(node);
+  }
+  /**
+   * Marks the key of the node as having been mutated.
+   */
 
-    _defineProperty(this, "_mutatedArrays", new Map());
 
-    _defineProperty(this, "code", void 0);
+  markMutation(node, key) {
+    var _map$get$add, _map$get;
 
-    this.code = code;
+    this.assertNotDeleted(node, `Attempted to mutate a \`${node.type}.${key}\` on a deleted node.`);
+    this.assertNotMutated(node, key, `Attempted to mutate a \`${node.type}.${key}\` when it has already been mutated.`);
+    const map = Array.isArray( // $FlowExpectedError[prop-missing]
+    node[key]) ? this._mutatedArrays : this._mutatedKeys;
+    map.set(node, (_map$get$add = (_map$get = map.get(node)) == null ? void 0 : _map$get.add(key)) != null ? _map$get$add : new Set([key]));
   }
   /**
-   * Marks a node and its entire subtree as deleted.
+   * Throws if the node has been deleted
    */
 
 
-  _createClass(MutationContext, [{
-    key: "markDeletion",
-    value: function markDeletion(node) {
-      this._deletedNodes.add(node);
-    }
-    /**
-     * Marks the key of the node as having been mutated.
-     */
-
-  }, {
-    key: "markMutation",
-    value: function markMutation(node, key) {
-      var _map$get$add, _map$get;
-
-      this.assertNotDeleted(node, "Attempted to mutate a `".concat(node.type, ".").concat(key, "` on a deleted node."));
-      this.assertNotMutated(node, key, "Attempted to mutate a `".concat(node.type, ".").concat(key, "` when it has already been mutated."));
-      var map = Array.isArray( // $FlowExpectedError[prop-missing]
-      node[key]) ? this._mutatedArrays : this._mutatedKeys;
-      map.set(node, (_map$get$add = (_map$get = map.get(node)) === null || _map$get === void 0 ? void 0 : _map$get.add(key)) !== null && _map$get$add !== void 0 ? _map$get$add : new Set([key]));
-    }
-    /**
-     * Throws if the node has been deleted
-     */
-
-  }, {
-    key: "assertNotDeleted",
-    value: function assertNotDeleted(node, message) {
-      if (this._deletedNodes.has(node)) {
-        throw new _Errors.NodeIsDeletedError(message);
-      }
-    }
-    /**
-     * Throws if the key of the node has been mutated
-     */
-
-  }, {
-    key: "assertNotMutated",
-    value: function assertNotMutated(node, key, message) {
-      var _this$_mutatedKeys$ge;
-
-      if (((_this$_mutatedKeys$ge = this._mutatedKeys.get(node)) === null || _this$_mutatedKeys$ge === void 0 ? void 0 : _this$_mutatedKeys$ge.has(key)) === true) {
-        throw new _Errors.NodeIsMutatedError(message);
-      }
+  assertNotDeleted(node, message) {
+    if (this._deletedNodes.has(node)) {
+      throw new _Errors.NodeIsDeletedError(message);
     }
-  }, {
-    key: "appendCommentToSource",
-    value: function appendCommentToSource(comment) {
-      this.code = (0, _comments.appendCommentToSource)(this.code, comment);
+  }
+  /**
+   * Throws if the key of the node has been mutated
+   */
+
+
+  assertNotMutated(node, key, message) {
+    var _this$_mutatedKeys$ge;
+
+    if (((_this$_mutatedKeys$ge = this._mutatedKeys.get(node)) == null ? void 0 : _this$_mutatedKeys$ge.has(key)) === true) {
+      throw new _Errors.NodeIsMutatedError(message);
     }
-  }]);
+  }
+
+  appendCommentToSource(comment, placement) {
+    this.code = (0, _comments.appendCommentToSource)(this.code, comment, placement);
+  }
 
-  return MutationContext;
-}();
+}
 
 exports.MutationContext = MutationContext;

package/dist/transform/MutationContext.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.
@@ -8,6 +8,7 @@
  * @format
  */
 
+import type {CommentPlacement} from './comments/comments';
 import type {Comment, ESNode} from 'hermes-estree';
 
 import {NodeIsDeletedError, NodeIsMutatedError} from './Errors';
@@ -74,7 +75,7 @@ export class MutationContext {
     }
   }
 
-  appendCommentToSource(comment: Comment): void {
-    this.code = appendCommentToSource(this.code, comment);
+  appendCommentToSource(comment: Comment, placement: CommentPlacement): void {
+    this.code = appendCommentToSource(this.code, comment, placement);
   }
 }