hermes-parser 0.31.2 → 0.32.1

package/dist/src/estree/TransformEnumSyntax.js

@@ -0,0 +1,106 @@
+/**
+ * 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
+ */
+'use strict';
+/**
+ * Transform Flow Enum declarations (https://flow.org/en/docs/enums/).
+ */
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.transformProgram = transformProgram;
+
+var _hermesEstree = require("hermes-estree");
+
+var _SimpleTransform = require("../transform/SimpleTransform");
+
+var _Builders = require("../utils/Builders");
+
+function mapEnumDeclaration(node, options) {
+  var _options$transformOpt, _options$transformOpt2;
+
+  const {
+    body
+  } = node;
+  const {
+    members
+  } = body;
+  const getRuntime = (_options$transformOpt = options.transformOptions) == null ? void 0 : (_options$transformOpt2 = _options$transformOpt.TransformEnumSyntax) == null ? void 0 : _options$transformOpt2.getRuntime;
+  const enumModule = typeof getRuntime === 'function' ? getRuntime() : (0, _Builders.callExpression)((0, _Builders.ident)('require'), [(0, _Builders.stringLiteral)('flow-enums-runtime')]);
+  const mirrored = body.type === 'EnumStringBody' && (!members.length || members[0].type === 'EnumDefaultedMember');
+  const enumExpression = mirrored ? (0, _Builders.callExpression)({
+    type: 'MemberExpression',
+    object: enumModule,
+    property: (0, _Builders.ident)('Mirrored'),
+    computed: false,
+    optional: false,
+    ...(0, _Builders.etc)()
+  }, [{
+    type: 'ArrayExpression',
+    elements: members.map(member => (0, _Builders.stringLiteral)(member.id.name)),
+    trailingComma: false,
+    ...(0, _Builders.etc)()
+  }]) : (0, _Builders.callExpression)(enumModule, [{
+    type: 'ObjectExpression',
+    properties: members.map(member => ({
+      type: 'Property',
+      key: member.id,
+      value: // String enums with `EnumDefaultedMember` are handled above by
+      // calculation of `mirrored`.
+      member.type === 'EnumDefaultedMember' ? (0, _Builders.callExpression)((0, _Builders.ident)('Symbol'), [(0, _Builders.stringLiteral)(member.id.name)]) : member.init,
+      kind: 'init',
+      method: false,
+      shorthand: false,
+      computed: false,
+      ...(0, _Builders.etc)(),
+      parent: _Builders.EMPTY_PARENT
+    })),
+    ...(0, _Builders.etc)()
+  }]);
+  return (0, _Builders.variableDeclaration)('const', node.id, enumExpression);
+}
+
+function transformProgram(program, options) {
+  return _SimpleTransform.SimpleTransform.transformProgram(program, {
+    transform(node) {
+      switch (node.type) {
+        case 'EnumDeclaration':
+          {
+            return mapEnumDeclaration(node, options);
+          }
+
+        case 'ExportDefaultDeclaration':
+          {
+            const {
+              declaration
+            } = node;
+
+            if ((0, _hermesEstree.isEnumDeclaration)(declaration)) {
+              const enumDeclaration = mapEnumDeclaration(declaration, options);
+
+              const exportDefault = _SimpleTransform.SimpleTransform.nodeWith(node, {
+                declaration: (0, _Builders.ident)(declaration.id.name)
+              });
+
+              return [enumDeclaration, exportDefault];
+            } else {
+              return node;
+            }
+          }
+
+        default:
+          {
+            return node;
+          }
+      }
+    }
+
+  });
+}

package/dist/src/index.js

@@ -31,7 +31,9 @@ var _ESTreeVisitorKeys = _interopRequireDefault(require("./generated/ESTreeVisit
 
 exports.FlowVisitorKeys = _ESTreeVisitorKeys.default;
 
-var StripComponentSyntax = _interopRequireWildcard(require("./estree/StripComponentSyntax"));
+var TransformComponentSyntax = _interopRequireWildcard(require("./estree/TransformComponentSyntax"));
+
+var TransformEnumSyntax = _interopRequireWildcard(require("./estree/TransformEnumSyntax"));
 
 var TransformMatchSyntax = _interopRequireWildcard(require("./estree/TransformMatchSyntax"));
 
@@ -140,13 +142,14 @@ function parse(code, opts) {
     return estreeAST;
   }
 
-  const loweredESTreeAST = [TransformMatchSyntax.transformProgram, StripComponentSyntax.transformProgram, StripFlowTypesForBabel.transformProgram].reduce((ast, transform) => transform(ast, options), estreeAST);
+  const loweredESTreeAST = [TransformEnumSyntax.transformProgram, TransformMatchSyntax.transformProgram, TransformComponentSyntax.transformProgram, StripFlowTypesForBabel.transformProgram].reduce((ast, transform) => transform(ast, options), estreeAST);
   return TransformESTreeToBabel.transformProgram(loweredESTreeAST, options);
 }
 
 const Transforms = {
+  transformEnumSyntax: TransformEnumSyntax.transformProgram,
   transformMatchSyntax: TransformMatchSyntax.transformProgram,
-  stripComponentSyntax: StripComponentSyntax.transformProgram,
+  transformComponentSyntax: TransformComponentSyntax.transformProgram,
   stripFlowTypesForBabel: StripFlowTypesForBabel.transformProgram,
   stripFlowTypes: StripFlowTypes.transformProgram
 };

package/dist/src/transform/SimpleTransform.js

@@ -20,8 +20,15 @@ var _astNodeMutationHelpers = require("./astNodeMutationHelpers");
 
 function setParentPointer(node, parent) {
   if (parent != null) {
-    // $FlowExpectedError[cannot-write]
-    node.parent = parent;
+    if (Array.isArray(node)) {
+      for (const item of node) {
+        // $FlowExpectedError[cannot-write]
+        item.parent = parent;
+      }
+    } else {
+      // $FlowExpectedError[cannot-write]
+      node.parent = parent;
+    }
   }
 }
 /**
@@ -51,7 +58,12 @@ class SimpleTransform {
           if (resultNode != null) {
             // Ensure the new node has the correct parent pointers before recursing again.
             setParentPointer(resultNode, parent);
-            traversedResultNode = this.transform(resultNode, options);
+
+            if (Array.isArray(resultNode)) {
+              traversedResultNode = resultNode.map(item => this.transform(item, options)).filter(item => item != null);
+            } else {
+              traversedResultNode = this.transform(resultNode, options);
+            }
           }
 
           if (parent == null) {
@@ -59,7 +71,11 @@ class SimpleTransform {
               throw new Error('SimpleTransform infra error: Parent not set on non root node, this should not be possible');
             }
 
-            resultRootNode = traversedResultNode;
+            if (Array.isArray(traversedResultNode)) {
+              throw new Error('SimpleTransform: invalid array result for root node');
+            } else {
+              resultRootNode = traversedResultNode;
+            }
           } else if (traversedResultNode == null) {
             (0, _astNodeMutationHelpers.removeNodeOnParent)(node, parent, options.visitorKeys);
           } else {

package/dist/src/transform/astNodeMutationHelpers.js

@@ -34,6 +34,7 @@ function getParentKey(target, parent, visitorKeys) {
   for (const key of (0, _getVisitorKeys.getVisitorKeys)(parent, visitorKeys)) {
     if ((0, _getVisitorKeys.isNode)( // $FlowExpectedError[prop-missing]
     parent[key])) {
+      // $FlowFixMe[invalid-compare]
       if (parent[key] === target) {
         return {
           type: 'single',
@@ -73,9 +74,13 @@ function replaceNodeOnParent(originalNode, originalNodeParent, nodeToReplaceWith
   if (replacementParent.type === 'array') {
     // $FlowExpectedError[prop-missing]
     parent[replacementParent.key] = (0, _astArrayMutationHelpers.replaceInArray)( // $FlowExpectedError[prop-missing]
-    parent[replacementParent.key], replacementParent.targetIndex, [nodeToReplaceWith]);
+    parent[replacementParent.key], replacementParent.targetIndex, Array.isArray(nodeToReplaceWith) ? nodeToReplaceWith : [nodeToReplaceWith]);
   } else {
-    // $FlowExpectedError[prop-missing]
+    if (Array.isArray(nodeToReplaceWith)) {
+      throw new Error(`Cannot insert array into non-array parent type: ${parent.type}`);
+    } // $FlowExpectedError[prop-missing]
+
+
     parent[replacementParent.key] = nodeToReplaceWith;
   }
 }

package/dist/transform/SimpleTransform.js

@@ -20,8 +20,15 @@ var _astNodeMutationHelpers = require("./astNodeMutationHelpers");
 
 function setParentPointer(node, parent) {
   if (parent != null) {
-    // $FlowExpectedError[cannot-write]
-    node.parent = parent;
+    if (Array.isArray(node)) {
+      for (const item of node) {
+        // $FlowExpectedError[cannot-write]
+        item.parent = parent;
+      }
+    } else {
+      // $FlowExpectedError[cannot-write]
+      node.parent = parent;
+    }
   }
 }
 /**
@@ -51,7 +58,12 @@ class SimpleTransform {
           if (resultNode != null) {
             // Ensure the new node has the correct parent pointers before recursing again.
             setParentPointer(resultNode, parent);
-            traversedResultNode = this.transform(resultNode, options);
+
+            if (Array.isArray(resultNode)) {
+              traversedResultNode = resultNode.map(item => this.transform(item, options)).filter(item => item != null);
+            } else {
+              traversedResultNode = this.transform(resultNode, options);
+            }
           }
 
           if (parent == null) {
@@ -59,7 +71,11 @@ class SimpleTransform {
               throw new Error('SimpleTransform infra error: Parent not set on non root node, this should not be possible');
             }
 
-            resultRootNode = traversedResultNode;
+            if (Array.isArray(traversedResultNode)) {
+              throw new Error('SimpleTransform: invalid array result for root node');
+            } else {
+              resultRootNode = traversedResultNode;
+            }
           } else if (traversedResultNode == null) {
             (0, _astNodeMutationHelpers.removeNodeOnParent)(node, parent, options.visitorKeys);
           } else {

package/dist/transform/SimpleTransform.js.flow

@@ -29,7 +29,9 @@ import {
  *     children are then traversed.
  *   - return null, signals the node should be deleted from the AST.
  */
-export type TransformCallback = (node: ESNode) => ESNode | null;
+export type TransformCallback = (
+  node: ESNode,
+) => ESNode | $ReadOnlyArray<ESNode> | null;
 
 export type TransformOptions = $ReadOnly<{
   /** The callback function which is called on entering each node. */
@@ -39,10 +41,20 @@ export type TransformOptions = $ReadOnly<{
   visitorKeys?: ?VisitorKeysType,
 }>;
 
-function setParentPointer(node: ESNode, parent: ?ESNode): void {
+function setParentPointer(
+  node: ESNode | $ReadOnlyArray<ESNode>,
+  parent: ?ESNode,
+): void {
   if (parent != null) {
-    // $FlowExpectedError[cannot-write]
-    node.parent = parent;
+    if (Array.isArray(node)) {
+      for (const item of node) {
+        // $FlowExpectedError[cannot-write]
+        item.parent = parent;
+      }
+    } else {
+      // $FlowExpectedError[cannot-write]
+      node.parent = parent;
+    }
   }
 }
 
@@ -63,15 +75,23 @@ export class SimpleTransform {
         // Ensure the parent pointers are correctly set before entering the node.
         setParentPointer(node, parent);
 
-        const resultNode = options.transform(node);
+        const resultNode: ESNode | $ReadOnlyArray<ESNode> | null =
+          options.transform(node);
         if (resultNode !== node) {
-          let traversedResultNode = null;
+          let traversedResultNode: ESNode | $ReadOnlyArray<ESNode> | null =
+            null;
 
           if (resultNode != null) {
             // Ensure the new node has the correct parent pointers before recursing again.
             setParentPointer(resultNode, parent);
 
-            traversedResultNode = this.transform(resultNode, options);
+            if (Array.isArray(resultNode)) {
+              traversedResultNode = resultNode
+                .map(item => this.transform(item, options))
+                .filter(item => item != null);
+            } else {
+              traversedResultNode = this.transform(resultNode, options);
+            }
           }
 
           if (parent == null) {
@@ -80,7 +100,13 @@ export class SimpleTransform {
                 'SimpleTransform infra error: Parent not set on non root node, this should not be possible',
               );
             }
-            resultRootNode = traversedResultNode;
+            if (Array.isArray(traversedResultNode)) {
+              throw new Error(
+                'SimpleTransform: invalid array result for root node',
+              );
+            } else {
+              resultRootNode = traversedResultNode;
+            }
           } else if (traversedResultNode == null) {
             removeNodeOnParent(node, parent, options.visitorKeys);
           } else {

package/dist/transform/astNodeMutationHelpers.js

@@ -34,6 +34,7 @@ function getParentKey(target, parent, visitorKeys) {
   for (const key of (0, _getVisitorKeys.getVisitorKeys)(parent, visitorKeys)) {
     if ((0, _getVisitorKeys.isNode)( // $FlowExpectedError[prop-missing]
     parent[key])) {
+      // $FlowFixMe[invalid-compare]
       if (parent[key] === target) {
         return {
           type: 'single',
@@ -73,9 +74,13 @@ function replaceNodeOnParent(originalNode, originalNodeParent, nodeToReplaceWith
   if (replacementParent.type === 'array') {
     // $FlowExpectedError[prop-missing]
     parent[replacementParent.key] = (0, _astArrayMutationHelpers.replaceInArray)( // $FlowExpectedError[prop-missing]
-    parent[replacementParent.key], replacementParent.targetIndex, [nodeToReplaceWith]);
+    parent[replacementParent.key], replacementParent.targetIndex, Array.isArray(nodeToReplaceWith) ? nodeToReplaceWith : [nodeToReplaceWith]);
   } else {
-    // $FlowExpectedError[prop-missing]
+    if (Array.isArray(nodeToReplaceWith)) {
+      throw new Error(`Cannot insert array into non-array parent type: ${parent.type}`);
+    } // $FlowExpectedError[prop-missing]
+
+
     parent[replacementParent.key] = nodeToReplaceWith;
   }
 }

package/dist/transform/astNodeMutationHelpers.js.flow

@@ -48,6 +48,7 @@ function getParentKey(
         parent[key],
       )
     ) {
+      // $FlowFixMe[invalid-compare]
       if (parent[key] === target) {
         return {type: 'single', node: parent, key};
       }
@@ -74,7 +75,7 @@ function getParentKey(
 export function replaceNodeOnParent(
   originalNode: ESNode,
   originalNodeParent: ESNode,
-  nodeToReplaceWith: ESNode,
+  nodeToReplaceWith: ESNode | $ReadOnlyArray<ESNode>,
   visitorKeys?: ?VisitorKeysType,
 ): void {
   const replacementParent = getParentKey(
@@ -89,9 +90,16 @@ export function replaceNodeOnParent(
       // $FlowExpectedError[prop-missing]
       parent[replacementParent.key],
       replacementParent.targetIndex,
-      [nodeToReplaceWith],
+      Array.isArray(nodeToReplaceWith)
+        ? nodeToReplaceWith
+        : [nodeToReplaceWith],
     );
   } else {
+    if (Array.isArray(nodeToReplaceWith)) {
+      throw new Error(
+        `Cannot insert array into non-array parent type: ${parent.type}`,
+      );
+    }
     // $FlowExpectedError[prop-missing]
     parent[replacementParent.key] = nodeToReplaceWith;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hermes-parser",
-  "version": "0.31.2",
+  "version": "0.32.1",
   "description": "A JavaScript parser built from the Hermes engine",
   "main": "dist/index.js",
   "license": "MIT",
@@ -9,7 +9,7 @@
     "url": "git@github.com:facebook/hermes.git"
   },
   "dependencies": {
-    "hermes-estree": "0.31.2"
+    "hermes-estree": "0.32.1"
   },
   "devDependencies": {
     "@babel/parser": "7.7.4",