hermes-transform 0.5.0

package/dist/transform/Errors.js

@@ -0,0 +1,151 @@
+"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.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * 
+ * @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));
+
+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));
+
+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));
+
+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));
+
+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));
+
+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));
+
+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));
+
+exports.InvalidReplacementError = InvalidReplacementError;

package/dist/transform/Errors.js.flow

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+export class NodeIsDeletedError extends Error {}
+export class NodeIsMutatedError extends Error {}
+export class InvalidInsertionError extends Error {}
+export class UnexpectedTransformationState extends Error {}
+export class InvalidStatementError extends Error {}
+export class InvalidRemovalError extends Error {}
+export class InvalidReplacementError extends Error {}

package/dist/transform/MutationContext.js

@@ -0,0 +1,94 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MutationContext = void 0;
+
+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 () {
+  // TODO - do we care about this? Arrays are pretty safe to concurrently mutate
+  function MutationContext(code) {
+    _classCallCheck(this, MutationContext);
+
+    _defineProperty(this, "_deletedNodes", new Set());
+
+    _defineProperty(this, "_mutatedKeys", new Map());
+
+    _defineProperty(this, "_mutatedArrays", new Map());
+
+    _defineProperty(this, "code", void 0);
+
+    this.code = code;
+  }
+  /**
+   * Marks a node and its entire subtree as 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);
+      }
+    }
+  }, {
+    key: "appendCommentToSource",
+    value: function appendCommentToSource(comment) {
+      this.code = (0, _comments.appendCommentToSource)(this.code, comment);
+    }
+  }]);
+
+  return MutationContext;
+}();
+
+exports.MutationContext = MutationContext;

package/dist/transform/MutationContext.js.flow

@@ -0,0 +1,80 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+import type {Comment, ESNode} from 'hermes-estree';
+
+import {NodeIsDeletedError, NodeIsMutatedError} from './Errors';
+import {appendCommentToSource} from './comments/comments';
+
+export class MutationContext {
+  +_deletedNodes: Set<ESNode> = new Set();
+  +_mutatedKeys: Map<ESNode, Set<string>> = new Map();
+  // TODO - do we care about this? Arrays are pretty safe to concurrently mutate
+  +_mutatedArrays: Map<ESNode, Set<string>> = new Map();
+
+  code: string;
+
+  constructor(code: string) {
+    this.code = code;
+  }
+
+  /**
+   * Marks a node and its entire subtree as deleted.
+   */
+  markDeletion(node: ESNode): void {
+    this._deletedNodes.add(node);
+  }
+
+  /**
+   * Marks the key of the node as having been mutated.
+   */
+  markMutation(node: ESNode, key: string): void {
+    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(node)?.add(key) ?? new Set([key]));
+  }
+
+  /**
+   * Throws if the node has been deleted
+   */
+  assertNotDeleted(node: ESNode, message: string): void {
+    if (this._deletedNodes.has(node)) {
+      throw new NodeIsDeletedError(message);
+    }
+  }
+
+  /**
+   * Throws if the key of the node has been mutated
+   */
+  assertNotMutated(node: ESNode, key: string, message: string): void {
+    if (this._mutatedKeys.get(node)?.has(key) === true) {
+      throw new NodeIsMutatedError(message);
+    }
+  }
+
+  appendCommentToSource(comment: Comment): void {
+    this.code = appendCommentToSource(this.code, comment);
+  }
+}

package/dist/transform/TransformContext.js

@@ -0,0 +1,136 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getTransformContext = getTransformContext;
+
+var _detachedNode = require("../detachedNode");
+
+var _comments = require("./comments/comments");
+
+var _AddLeadingComments = require("./mutations/AddLeadingComments");
+
+var _AddTrailingComments = require("./mutations/AddTrailingComments");
+
+var _CloneCommentsTo = require("./mutations/CloneCommentsTo");
+
+var _InsertStatement = require("./mutations/InsertStatement");
+
+var _RemoveComment = require("./mutations/RemoveComment");
+
+var _RemoveStatement = require("./mutations/RemoveStatement");
+
+var _ReplaceNode = require("./mutations/ReplaceNode");
+
+var _ReplaceStatementWithMany = require("./mutations/ReplaceStatementWithMany");
+
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+function getTransformContext() {
+  /**
+   * The mutations in order of collection.
+   */
+  var mutations = [];
+
+  function pushMutation(mutation) {
+    if (mutation != null) {
+      mutations.push(mutation);
+    }
+  }
+
+  return {
+    mutations: mutations,
+
+    // $FlowExpectedError[unsafe-getters-setters]
+    get astWasMutated() {
+      return mutations.length > 0;
+    },
+
+    // $FlowExpectedError[incompatible-exact]
+    shallowCloneNode: function (node, newProps) {
+      if (node == null) {
+        return null;
+      }
+
+      return (0, _detachedNode.shallowCloneNode)(node, newProps);
+    },
+    shallowCloneArray: function (nodes) {
+      if (nodes == null) {
+        return null;
+      }
+
+      return nodes.map(function (node) {
+        return (0, _detachedNode.shallowCloneNode)(node);
+      });
+    },
+    // $FlowExpectedError[incompatible-exact]
+    deepCloneNode: function (node, newProps) {
+      if (node == null) {
+        return null;
+      }
+
+      return (0, _detachedNode.deepCloneNode)(node, newProps);
+    },
+    insertAfterStatement: function (target, nodesToInsert) {
+      pushMutation((0, _InsertStatement.createInsertStatementMutation)('after', target, toArray(nodesToInsert)));
+    },
+    insertBeforeStatement: function (target, nodesToInsert) {
+      pushMutation((0, _InsertStatement.createInsertStatementMutation)('before', target, toArray(nodesToInsert)));
+    },
+    replaceNode: function (target, nodeToReplaceWith, options) {
+      pushMutation((0, _ReplaceNode.createReplaceNodeMutation)(target, nodeToReplaceWith, options));
+    },
+    replaceStatementWithMany: function (target, nodesToReplaceWith, options) {
+      pushMutation((0, _ReplaceStatementWithMany.createReplaceStatementWithManyMutation)(target, nodesToReplaceWith, options));
+    },
+    removeStatement: function (node) {
+      pushMutation((0, _RemoveStatement.createRemoveStatementMutation)(node));
+    },
+    //
+    // Comment APIs
+    //
+    getComments: function (node) {
+      return _toConsumableArray((0, _comments.getCommentsForNode)(node));
+    },
+    getLeadingComments: function (node) {
+      return (0, _comments.getCommentsForNode)(node).filter(_comments.isLeadingComment);
+    },
+    getTrailingComments: function (node) {
+      return (0, _comments.getCommentsForNode)(node).filter(_comments.isTrailingComment);
+    },
+    cloneCommentsTo: function (target, destination) {
+      pushMutation((0, _CloneCommentsTo.createCloneCommentsToMutation)(target, destination));
+    },
+    addLeadingComments: function (node, comments) {
+      pushMutation((0, _AddLeadingComments.createAddLeadingCommentsMutation)(node, toArray(comments)));
+    },
+    addTrailingComments: function (node, comments) {
+      pushMutation((0, _AddTrailingComments.createAddTrailingCommentsMutation)(node, toArray(comments)));
+    },
+    removeComments: function (comments) {
+      toArray(comments).forEach(function (comment) {
+        pushMutation((0, _RemoveComment.createRemoveCommentMutation)(comment));
+      });
+    }
+  };
+}
+
+function toArray(thing) {
+  if (Array.isArray(thing)) {
+    // $FlowExpectedError[incompatible-return]
+    return thing;
+  }
+
+  return [thing];
+}