hermes-parser 0.32.0 → 0.33.0

package/dist/src/generated/ESTreeVisitorKeys.js

@@ -26,7 +26,7 @@ module.exports = {
   ArrayExpression: ['elements'],
   ArrayPattern: ['elements', 'typeAnnotation'],
   ArrayTypeAnnotation: ['elementType'],
-  ArrowFunctionExpression: ['id', 'params', 'body', 'typeParameters', 'returnType', 'predicate'],
+  ArrowFunctionExpression: ['params', 'body', 'typeParameters', 'returnType', 'predicate'],
   AsConstExpression: ['expression'],
   AsExpression: ['expression', 'typeAnnotation'],
   AssignmentExpression: ['left', 'right'],
@@ -43,8 +43,8 @@ module.exports = {
   CatchClause: ['param', 'body'],
   ChainExpression: ['expression'],
   ClassBody: ['body'],
-  ClassDeclaration: ['id', 'typeParameters', 'superClass', 'superTypeParameters', 'implements', 'decorators', 'body'],
-  ClassExpression: ['id', 'typeParameters', 'superClass', 'superTypeParameters', 'implements', 'decorators', 'body'],
+  ClassDeclaration: ['id', 'typeParameters', 'superClass', 'superTypeArguments', 'implements', 'decorators', 'body'],
+  ClassExpression: ['id', 'typeParameters', 'superClass', 'superTypeArguments', 'implements', 'decorators', 'body'],
   ClassImplements: ['id', 'typeParameters'],
   ComponentDeclaration: ['id', 'params', 'body', 'typeParameters', 'rendersType'],
   ComponentParameter: ['name', 'local'],
@@ -138,6 +138,8 @@ module.exports = {
   MatchExpression: ['argument', 'cases'],
   MatchExpressionCase: ['pattern', 'body', 'guard'],
   MatchIdentifierPattern: ['id'],
+  MatchInstanceObjectPattern: ['properties', 'rest'],
+  MatchInstancePattern: ['targetConstructor', 'properties'],
   MatchLiteralPattern: ['literal'],
   MatchMemberPattern: ['base', 'property'],
   MatchObjectPattern: ['properties', 'rest'],
@@ -152,6 +154,7 @@ module.exports = {
   MetaProperty: ['meta', 'property'],
   MethodDefinition: ['key', 'value'],
   MixedTypeAnnotation: [],
+  NeverTypeAnnotation: [],
   NewExpression: ['callee', 'typeArguments', 'arguments'],
   NullableTypeAnnotation: ['typeAnnotation'],
   NullLiteralTypeAnnotation: [],
@@ -174,6 +177,13 @@ module.exports = {
   PropertyDefinition: ['key', 'value', 'variance', 'typeAnnotation'],
   QualifiedTypeIdentifier: ['qualification', 'id'],
   QualifiedTypeofIdentifier: ['qualification', 'id'],
+  RecordDeclaration: ['id', 'typeParameters', 'implements', 'body'],
+  RecordDeclarationBody: ['elements'],
+  RecordDeclarationImplements: ['id', 'typeArguments'],
+  RecordDeclarationProperty: ['key', 'typeAnnotation', 'defaultValue'],
+  RecordDeclarationStaticProperty: ['key', 'typeAnnotation', 'value'],
+  RecordExpression: ['recordConstructor', 'typeArguments', 'properties'],
+  RecordExpressionProperties: ['properties'],
   RestElement: ['argument'],
   ReturnStatement: ['argument'],
   SequenceExpression: ['expressions'],
@@ -192,7 +202,7 @@ module.exports = {
   ThisTypeAnnotation: [],
   ThrowStatement: ['argument'],
   TryStatement: ['block', 'handler', 'finalizer'],
-  TupleTypeAnnotation: ['types'],
+  TupleTypeAnnotation: ['elementTypes'],
   TupleTypeLabeledElement: ['label', 'elementType', 'variance'],
   TupleTypeSpreadElement: ['label', 'typeAnnotation'],
   TypeAlias: ['id', 'typeParameters', 'right'],
@@ -205,7 +215,9 @@ module.exports = {
   TypeParameterInstantiation: ['params'],
   TypePredicate: ['parameterName', 'typeAnnotation'],
   UnaryExpression: ['argument'],
+  UndefinedTypeAnnotation: [],
   UnionTypeAnnotation: ['types'],
+  UnknownTypeAnnotation: [],
   UpdateExpression: ['argument'],
   VariableDeclaration: ['declarations'],
   VariableDeclarator: ['id', 'init'],

package/dist/src/generated/ParserVisitorKeys.js

@@ -42,7 +42,6 @@ const HERMES_AST_VISITOR_KEYS = {
     elementType: 'Node'
   },
   ArrowFunctionExpression: {
-    id: 'Node',
     params: 'NodeList',
     body: 'Node',
     typeParameters: 'Node',
@@ -102,7 +101,7 @@ const HERMES_AST_VISITOR_KEYS = {
     id: 'Node',
     typeParameters: 'Node',
     superClass: 'Node',
-    superTypeParameters: 'Node',
+    superTypeArguments: 'Node',
     implements: 'NodeList',
     decorators: 'NodeList',
     body: 'Node'
@@ -111,7 +110,7 @@ const HERMES_AST_VISITOR_KEYS = {
     id: 'Node',
     typeParameters: 'Node',
     superClass: 'Node',
-    superTypeParameters: 'Node',
+    superTypeArguments: 'Node',
     implements: 'NodeList',
     decorators: 'NodeList',
     body: 'Node'
@@ -484,6 +483,14 @@ const HERMES_AST_VISITOR_KEYS = {
   MatchIdentifierPattern: {
     id: 'Node'
   },
+  MatchInstanceObjectPattern: {
+    properties: 'NodeList',
+    rest: 'Node'
+  },
+  MatchInstancePattern: {
+    targetConstructor: 'Node',
+    properties: 'Node'
+  },
   MatchLiteralPattern: {
     literal: 'Node'
   },
@@ -531,6 +538,7 @@ const HERMES_AST_VISITOR_KEYS = {
     value: 'Node'
   },
   MixedTypeAnnotation: {},
+  NeverTypeAnnotation: {},
   NewExpression: {
     callee: 'Node',
     typeArguments: 'Node',
@@ -618,6 +626,37 @@ const HERMES_AST_VISITOR_KEYS = {
     qualification: 'Node',
     id: 'Node'
   },
+  RecordDeclaration: {
+    id: 'Node',
+    typeParameters: 'Node',
+    implements: 'NodeList',
+    body: 'Node'
+  },
+  RecordDeclarationBody: {
+    elements: 'NodeList'
+  },
+  RecordDeclarationImplements: {
+    id: 'Node',
+    typeArguments: 'Node'
+  },
+  RecordDeclarationProperty: {
+    key: 'Node',
+    typeAnnotation: 'Node',
+    defaultValue: 'Node'
+  },
+  RecordDeclarationStaticProperty: {
+    key: 'Node',
+    typeAnnotation: 'Node',
+    value: 'Node'
+  },
+  RecordExpression: {
+    recordConstructor: 'Node',
+    typeArguments: 'Node',
+    properties: 'Node'
+  },
+  RecordExpressionProperties: {
+    properties: 'NodeList'
+  },
   RegExpLiteral: {},
   RestElement: {
     argument: 'Node'
@@ -667,7 +706,7 @@ const HERMES_AST_VISITOR_KEYS = {
     finalizer: 'Node'
   },
   TupleTypeAnnotation: {
-    types: 'NodeList'
+    elementTypes: 'NodeList'
   },
   TupleTypeLabeledElement: {
     label: 'Node',
@@ -715,9 +754,11 @@ const HERMES_AST_VISITOR_KEYS = {
   UnaryExpression: {
     argument: 'Node'
   },
+  UndefinedTypeAnnotation: {},
   UnionTypeAnnotation: {
     types: 'NodeList'
   },
+  UnknownTypeAnnotation: {},
   UpdateExpression: {
     argument: 'Node'
   },

package/dist/src/index.js

@@ -31,10 +31,14 @@ 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"));
 
+var TransformRecordSyntax = _interopRequireWildcard(require("./estree/TransformRecordSyntax"));
+
 var StripFlowTypesForBabel = _interopRequireWildcard(require("./estree/StripFlowTypesForBabel"));
 
 var TransformESTreeToBabel = _interopRequireWildcard(require("./babel/TransformESTreeToBabel"));
@@ -124,6 +128,10 @@ function getOptions(options = { ...DEFAULTS
     options.enableExperimentalFlowMatchSyntax = true; // Enable by default
   }
 
+  if (options.enableExperimentalFlowRecordSyntax == null) {
+    options.enableExperimentalFlowRecordSyntax = true; // Enable by default
+  }
+
   options.tokens = options.tokens === true;
   options.allowReturnOutsideFunction = options.allowReturnOutsideFunction === true;
   return options;
@@ -140,13 +148,15 @@ 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, TransformRecordSyntax.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,
+  transformRecordSyntax: TransformRecordSyntax.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/src/utils/GenID.js

@@ -12,30 +12,35 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.createGenID = createGenID;
+exports.default = void 0;
 const genPrefix = '$$gen$';
 
-function createGenID(uniqueTransformPrefix) {
-  let genN = 0;
-  const used = new Set();
-  return {
-    genID() {
-      let name;
-
-      do {
-        name = `${genPrefix}${uniqueTransformPrefix}${genN}`;
-        genN++;
-      } while (used.has(name));
-
-      used.add(name);
-      return name;
-    },
-
-    addUsage(name) {
-      if (name.startsWith(genPrefix)) {
-        used.add(name);
-      }
+class GenID {
+  constructor(uniqueTransformPrefix) {
+    this.genN = 0;
+    this.used = new Set();
+    this.prefix = void 0;
+    this.prefix = `${genPrefix}${uniqueTransformPrefix}`;
+  }
+
+  id() {
+    let name;
+
+    do {
+      name = `${this.prefix}${this.genN}`;
+      this.genN++;
+    } while (this.used.has(name));
+
+    this.used.add(name);
+    return name;
+  }
+
+  addUsage(name) {
+    if (name.startsWith(this.prefix)) {
+      this.used.add(name);
     }
+  }
+
+}
 
-  };
-}
+exports.default = GenID;

package/dist/src/utils/isReservedWord.js

@@ -0,0 +1,62 @@
+/**
+ * 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';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = isReservedWord;
+
+function isReservedWord(name) {
+  switch (name) {
+    case 'await':
+    case 'break':
+    case 'case':
+    case 'catch':
+    case 'class':
+    case 'const':
+    case 'continue':
+    case 'debugger':
+    case 'default':
+    case 'delete':
+    case 'do':
+    case 'else':
+    case 'enum':
+    case 'export':
+    case 'extends':
+    case 'false':
+    case 'finally':
+    case 'for':
+    case 'function':
+    case 'if':
+    case 'import':
+    case 'in':
+    case 'instanceof':
+    case 'new':
+    case 'null':
+    case 'return':
+    case 'super':
+    case 'switch':
+    case 'this':
+    case 'throw':
+    case 'true':
+    case 'try':
+    case 'typeof':
+    case 'var':
+    case 'void':
+    case 'while':
+    case 'with':
+    case 'yield':
+      return true;
+
+    default:
+      return false;
+  }
+}

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/dist/utils/GenID.js

@@ -12,30 +12,35 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.createGenID = createGenID;
+exports.default = void 0;
 const genPrefix = '$$gen$';
 
-function createGenID(uniqueTransformPrefix) {
-  let genN = 0;
-  const used = new Set();
-  return {
-    genID() {
-      let name;
-
-      do {
-        name = `${genPrefix}${uniqueTransformPrefix}${genN}`;
-        genN++;
-      } while (used.has(name));
-
-      used.add(name);
-      return name;
-    },
-
-    addUsage(name) {
-      if (name.startsWith(genPrefix)) {
-        used.add(name);
-      }
+class GenID {
+  constructor(uniqueTransformPrefix) {
+    this.genN = 0;
+    this.used = new Set();
+    this.prefix = void 0;
+    this.prefix = `${genPrefix}${uniqueTransformPrefix}`;
+  }
+
+  id() {
+    let name;
+
+    do {
+      name = `${this.prefix}${this.genN}`;
+      this.genN++;
+    } while (this.used.has(name));
+
+    this.used.add(name);
+    return name;
+  }
+
+  addUsage(name) {
+    if (name.startsWith(this.prefix)) {
+      this.used.add(name);
     }
+  }
+
+}
 
-  };
-}
+exports.default = GenID;