hermes-transform 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Facebook, Inc. and its 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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,8 @@
+# hermes-transform
+
+A package for traversing and transforming a hermes AST.
+
+This package is pieced together and inspired by code from:
+- [`@babel/traverse`](https://github.com/babel/babel/tree/35ec4394a72e6fc88553ce7dcf0fb1c91d9505a9/packages/babel-traverse)
+- [`eslint`](https://github.com/eslint/eslint/tree/e926b1735c77bf55abc1150b060a535a6c4e2778)
+- [`prettier`](https://github.com/prettier/prettier/tree/7054df719e1789a71ce9e28b5a5452bc60fd42e7)

package/dist/detachedNode.js

@@ -0,0 +1,128 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.deepCloneNode = deepCloneNode;
+exports.detachedProps = detachedProps;
+exports.setParentPointersInDirectChildren = setParentPointersInDirectChildren;
+exports.shallowCloneNode = shallowCloneNode;
+exports.updateAllParentPointers = updateAllParentPointers;
+
+var _getVisitorKeys = require("./getVisitorKeys");
+
+var _SimpleTraverser = require("./traverse/SimpleTraverser");
+
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+
+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 _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 ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+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; }
+
+// used by the node type function codegen
+function detachedProps(parent, props) {
+  // $FlowExpectedError[incompatible-return]
+  return _objectSpread(_objectSpread({}, props), {}, {
+    // if not provided, then we purposely don't set this here
+    // and will rely on the tooling to update it as appropriate.
+    // nothing should be reading from this before it's set anyway.
+    parent: parent,
+    range: [0, 0],
+    loc: {
+      start: {
+        line: 1,
+        column: 0
+      },
+      end: {
+        line: 1,
+        column: 0
+      }
+    }
+  });
+}
+/**
+ * Shallowly clones the node, but not its children.
+ */
+
+
+function shallowCloneNode(node) {
+  var newProps = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  return detachedProps(null, Object.assign({}, node, newProps));
+}
+/**
+ * Deeply clones node and its entire tree.
+ */
+
+
+function deepCloneNode(node) {
+  var newProps = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var clone = Object.assign(JSON.parse(JSON.stringify(node, function (key, value) {
+    // null out parent pointers
+    if (key === 'parent') {
+      return undefined;
+    }
+
+    return value;
+  })), newProps);
+  updateAllParentPointers(clone); // $FlowExpectedError[class-object-subtyping]
+
+  return detachedProps(null, clone);
+}
+/**
+ * Corrects the parent pointers in direct children of the given node
+ */
+
+
+function setParentPointersInDirectChildren(node) {
+  var _iterator = _createForOfIteratorHelper((0, _getVisitorKeys.getVisitorKeys)(node)),
+      _step;
+
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var key = _step.value;
+
+      if ((0, _getVisitorKeys.isNode)( // $FlowExpectedError[prop-missing]
+      node[key])) {
+        node[key].parent = node;
+      } else if (Array.isArray(node[key])) {
+        var _iterator2 = _createForOfIteratorHelper(node[key]),
+            _step2;
+
+        try {
+          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+            var child = _step2.value;
+            child.parent = node;
+          }
+        } catch (err) {
+          _iterator2.e(err);
+        } finally {
+          _iterator2.f();
+        }
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+}
+/**
+ * Traverses the entire subtree to ensure the parent pointers are set correctly
+ */
+
+
+function updateAllParentPointers(node) {
+  _SimpleTraverser.SimpleTraverser.traverse(node, {
+    enter: function enter(node, parent) {
+      // $FlowExpectedError[cannot-write]
+      node.parent = parent;
+    },
+    leave: function leave() {}
+  });
+}

package/dist/detachedNode.js.flow

@@ -0,0 +1,113 @@
+/**
+ * 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 {BaseNode, ESNode} from 'hermes-estree';
+
+import {getVisitorKeys, isNode} from './getVisitorKeys';
+import {SimpleTraverser} from './traverse/SimpleTraverser';
+
+export opaque type DetachedNode<+T> = T;
+
+// used by the node type function codegen
+export function detachedProps<T: BaseNode>(
+  parent: ?ESNode,
+  props: {...},
+): DetachedNode<T> {
+  // $FlowExpectedError[incompatible-return]
+  return {
+    ...props,
+    // if not provided, then we purposely don't set this here
+    // and will rely on the tooling to update it as appropriate.
+    // nothing should be reading from this before it's set anyway.
+    parent: (parent: $FlowFixMe),
+    range: [0, 0],
+    loc: {
+      start: {
+        line: 1,
+        column: 0,
+      },
+      end: {
+        line: 1,
+        column: 0,
+      },
+    },
+  };
+}
+
+/**
+ * Shallowly clones the node, but not its children.
+ */
+export function shallowCloneNode<T: ESNode>(
+  node: T,
+  newProps: $Shape<{...}> = {},
+): DetachedNode<T> {
+  return detachedProps(null, (Object.assign({}, node, newProps): $FlowFixMe));
+}
+
+/**
+ * Deeply clones node and its entire tree.
+ */
+export function deepCloneNode<T: ESNode>(
+  node: T,
+  newProps: $Shape<{...}> = {},
+): DetachedNode<T> {
+  const clone: DetachedNode<T> = Object.assign(
+    JSON.parse(
+      JSON.stringify(node, (key, value) => {
+        // null out parent pointers
+        if (key === 'parent') {
+          return undefined;
+        }
+        return value;
+      }),
+    ),
+    newProps,
+  );
+
+  updateAllParentPointers(clone);
+
+  // $FlowExpectedError[class-object-subtyping]
+  return detachedProps(null, clone);
+}
+
+/**
+ * Corrects the parent pointers in direct children of the given node
+ */
+export function setParentPointersInDirectChildren(
+  node: DetachedNode<ESNode>,
+): void {
+  for (const key of getVisitorKeys(node)) {
+    if (
+      isNode(
+        // $FlowExpectedError[prop-missing]
+        node[key],
+      )
+    ) {
+      node[key].parent = node;
+    } else if (Array.isArray(node[key])) {
+      for (const child of node[key]) {
+        child.parent = node;
+      }
+    }
+  }
+}
+
+/**
+ * Traverses the entire subtree to ensure the parent pointers are set correctly
+ */
+export function updateAllParentPointers(node: ESNode | DetachedNode<ESNode>) {
+  SimpleTraverser.traverse(node, {
+    enter(node, parent) {
+      // $FlowExpectedError[cannot-write]
+      node.parent = parent;
+    },
+    leave() {},
+  });
+}

package/dist/generated/TransformCloneSignatures.js.flow

@@ -0,0 +1,19 @@
+/**
+ * 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
+ */
+
+/*
+ * !!! THIS FILE WILL BE OVERWRITTEN BY CODEGEN !!!
+ *
+ * Statically it should only contain the minimal set of
+ * definitions required to typecheck the code and execute
+ * the transformation tests.
+ */
+
+export type TransformCloneSignatures = {};