hermes-parser 0.32.0 → 0.33.0

package/dist/estree/TransformRecordSyntax.js

@@ -0,0 +1,294 @@
+/**
+ * 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 record declarations.
+ */
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.transformProgram = transformProgram;
+
+var _hermesEstree = require("hermes-estree");
+
+var _SimpleTransform = require("../transform/SimpleTransform");
+
+var _astNodeMutationHelpers = require("../transform/astNodeMutationHelpers");
+
+var _Builders = require("../utils/Builders");
+
+var _isReservedWord = _interopRequireDefault(require("../utils/isReservedWord"));
+
+var _GenID = _interopRequireDefault(require("../utils/GenID"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function nameOfKey(key) {
+  switch (key.type) {
+    case 'Identifier':
+      return key.name;
+
+    case 'Literal':
+      if ((0, _hermesEstree.isBigIntLiteral)(key)) {
+        return key.bigint;
+      }
+
+      return String(key.value);
+  }
+}
+
+function mapRecordDeclaration(genID, node) {
+  const ownProperties = [];
+  const staticProperties = [];
+  const methods = [];
+  const staticMethods = [];
+
+  for (const element of node.body.elements) {
+    switch (element.type) {
+      case 'RecordDeclarationProperty':
+        ownProperties.push(element);
+        break;
+
+      case 'RecordDeclarationStaticProperty':
+        staticProperties.push(element);
+        break;
+
+      case 'MethodDefinition':
+        if (element.static) {
+          staticMethods.push(element);
+        } else {
+          methods.push(element);
+        }
+
+        break;
+    }
+  }
+
+  const reservedPropNames = new Map(); // Create constructor parameter as an object pattern with all properties
+
+  const constructorParam = {
+    type: 'ObjectPattern',
+    properties: ownProperties.map(prop => {
+      const {
+        key,
+        defaultValue
+      } = prop;
+      const keyName = nameOfKey(key);
+
+      const getValue = bindingIdent => defaultValue != null ? {
+        type: 'AssignmentPattern',
+        left: bindingIdent,
+        right: (0, _astNodeMutationHelpers.deepCloneNode)(defaultValue),
+        ...(0, _Builders.etc)()
+      } : bindingIdent;
+
+      switch (key.type) {
+        case 'Identifier':
+          {
+            const needsNewBinding = (0, _isReservedWord.default)(keyName);
+            const bindingName = needsNewBinding ? genID.id() : keyName;
+            const bindingIdent = (0, _Builders.ident)(bindingName);
+
+            if (needsNewBinding) {
+              reservedPropNames.set(keyName, bindingName);
+            }
+
+            if (needsNewBinding) {
+              return {
+                type: 'Property',
+                kind: 'init',
+                key: (0, _astNodeMutationHelpers.shallowCloneNode)(key),
+                value: getValue(bindingIdent),
+                shorthand: false,
+                method: false,
+                computed: false,
+                ...(0, _Builders.etc)(),
+                parent: _Builders.EMPTY_PARENT
+              };
+            } else {
+              return {
+                type: 'Property',
+                kind: 'init',
+                key: (0, _astNodeMutationHelpers.shallowCloneNode)(key),
+                value: getValue(bindingIdent),
+                shorthand: true,
+                method: false,
+                computed: false,
+                ...(0, _Builders.etc)(),
+                parent: _Builders.EMPTY_PARENT
+              };
+            }
+          }
+
+        case 'Literal':
+          {
+            const bindingName = genID.id();
+            const bindingIdent = (0, _Builders.ident)(bindingName);
+            reservedPropNames.set(keyName, bindingName);
+            return {
+              type: 'Property',
+              kind: 'init',
+              key: (0, _astNodeMutationHelpers.shallowCloneNode)(key),
+              value: getValue(bindingIdent),
+              shorthand: false,
+              method: false,
+              computed: false,
+              ...(0, _Builders.etc)(),
+              parent: _Builders.EMPTY_PARENT
+            };
+          }
+      }
+    }),
+    typeAnnotation: null,
+    ...(0, _Builders.etc)()
+  }; // Create the constructor method
+
+  const constructor = {
+    type: 'MethodDefinition',
+    key: (0, _Builders.ident)('constructor'),
+    kind: 'constructor',
+    computed: false,
+    static: false,
+    value: {
+      type: 'FunctionExpression',
+      id: null,
+      params: [constructorParam],
+      body: {
+        type: 'BlockStatement',
+        body: ownProperties.map(({
+          key
+        }) => {
+          var _reservedPropNames$ge;
+
+          const keyName = nameOfKey(key);
+          const bindingIdent = (0, _Builders.ident)((_reservedPropNames$ge = reservedPropNames.get(keyName)) != null ? _reservedPropNames$ge : keyName);
+          const object = {
+            type: 'ThisExpression',
+            ...(0, _Builders.etc)()
+          };
+          const memberExpression = key.type === 'Identifier' ? {
+            type: 'MemberExpression',
+            object,
+            property: (0, _astNodeMutationHelpers.shallowCloneNode)(key),
+            computed: false,
+            optional: false,
+            ...(0, _Builders.etc)()
+          } : {
+            type: 'MemberExpression',
+            object,
+            property: (0, _astNodeMutationHelpers.shallowCloneNode)(key),
+            computed: true,
+            optional: false,
+            ...(0, _Builders.etc)()
+          };
+          return {
+            type: 'ExpressionStatement',
+            expression: {
+              type: 'AssignmentExpression',
+              operator: '=',
+              left: memberExpression,
+              right: bindingIdent,
+              ...(0, _Builders.etc)()
+            },
+            directive: null,
+            ...(0, _Builders.etc)()
+          };
+        }),
+        ...(0, _Builders.etc)()
+      },
+      generator: false,
+      async: false,
+      predicate: null,
+      returnType: null,
+      typeParameters: null,
+      ...(0, _Builders.etc)()
+    },
+    ...(0, _Builders.etc)(),
+    parent: _Builders.EMPTY_PARENT
+  };
+  const classStaticProperties = staticProperties.map(prop => ({
+    type: 'PropertyDefinition',
+    key: (0, _astNodeMutationHelpers.shallowCloneNode)(prop.key),
+    value: (0, _astNodeMutationHelpers.deepCloneNode)(prop.value),
+    static: true,
+    typeAnnotation: null,
+    variance: null,
+    computed: false,
+    declare: false,
+    optional: false,
+    ...(0, _Builders.etc)(),
+    parent: _Builders.EMPTY_PARENT
+  }));
+  const classBodyElements = [constructor, ...methods, ...classStaticProperties, ...staticMethods];
+  return {
+    type: 'ClassDeclaration',
+    id: (0, _astNodeMutationHelpers.shallowCloneNode)(node.id),
+    body: {
+      type: 'ClassBody',
+      body: classBodyElements,
+      ...(0, _Builders.etc)(),
+      parent: _Builders.EMPTY_PARENT
+    },
+    superClass: null,
+    typeParameters: null,
+    superTypeArguments: null,
+    implements: [],
+    decorators: [],
+    ...(0, _Builders.etc)()
+  };
+}
+
+function mapRecordExpression(node) {
+  const obj = {
+    type: 'ObjectExpression',
+    properties: node.properties.properties,
+    ...(0, _Builders.etc)()
+  };
+  return {
+    type: 'NewExpression',
+    callee: node.recordConstructor,
+    arguments: [obj],
+    typeArguments: null,
+    ...(0, _Builders.etc)()
+  };
+}
+
+function transformProgram(program, _options) {
+  const genID = new _GenID.default('r');
+  return _SimpleTransform.SimpleTransform.transformProgram(program, {
+    transform(node) {
+      switch (node.type) {
+        case 'RecordDeclaration':
+          {
+            return mapRecordDeclaration(genID, node);
+          }
+
+        case 'RecordExpression':
+          {
+            return mapRecordExpression(node);
+          }
+
+        case 'Identifier':
+          {
+            // A rudimentary check to avoid some collisions with our generated
+            // variable names. Ideally, we would have access a scope analyzer
+            // inside the transform instead.
+            genID.addUsage(node.name);
+            return node;
+          }
+
+        default:
+          return node;
+      }
+    }
+
+  });
+}

package/dist/estree/TransformRecordSyntax.js.flow

@@ -0,0 +1,308 @@
+/**
+ * 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.
+ *
+ * @flow strict
+ * @format
+ */
+
+'use strict';
+
+/**
+ * Transform record declarations.
+ */
+
+import type {ParserOptions} from '../ParserOptions';
+import type {
+  AssignmentPattern,
+  ClassDeclaration,
+  ClassMember,
+  ESNode,
+  Identifier,
+  MemberExpression,
+  MethodDefinition,
+  NewExpression,
+  ObjectExpression,
+  ObjectPattern,
+  ObjectPropertyKey,
+  Program,
+  RecordDeclaration,
+  RecordDeclarationProperty,
+  RecordDeclarationStaticProperty,
+  RecordExpression,
+  ThisExpression,
+} from 'hermes-estree';
+
+import {isBigIntLiteral} from 'hermes-estree';
+import {SimpleTransform} from '../transform/SimpleTransform';
+import {
+  deepCloneNode,
+  shallowCloneNode,
+} from '../transform/astNodeMutationHelpers';
+import {EMPTY_PARENT, etc, ident} from '../utils/Builders';
+import isReservedWord from '../utils/isReservedWord';
+import GenID from '../utils/GenID';
+
+function nameOfKey(key: ObjectPropertyKey): string {
+  switch (key.type) {
+    case 'Identifier':
+      return key.name;
+    case 'Literal':
+      if (isBigIntLiteral(key)) {
+        return key.bigint;
+      }
+      return String(key.value);
+  }
+}
+
+function mapRecordDeclaration(
+  genID: GenID,
+  node: RecordDeclaration,
+): ClassDeclaration {
+  const ownProperties: Array<RecordDeclarationProperty> = [];
+  const staticProperties: Array<RecordDeclarationStaticProperty> = [];
+  const methods: Array<MethodDefinition> = [];
+  const staticMethods: Array<MethodDefinition> = [];
+
+  for (const element of node.body.elements) {
+    switch (element.type) {
+      case 'RecordDeclarationProperty':
+        ownProperties.push(element);
+        break;
+      case 'RecordDeclarationStaticProperty':
+        staticProperties.push(element);
+        break;
+      case 'MethodDefinition':
+        if (element.static) {
+          staticMethods.push(element);
+        } else {
+          methods.push(element);
+        }
+        break;
+    }
+  }
+
+  const reservedPropNames = new Map<string, string>();
+
+  // Create constructor parameter as an object pattern with all properties
+  const constructorParam: ObjectPattern = {
+    type: 'ObjectPattern',
+    properties: ownProperties.map(prop => {
+      const {key, defaultValue} = prop;
+      const keyName = nameOfKey(key);
+
+      const getValue = (
+        bindingIdent: Identifier,
+      ): AssignmentPattern | Identifier =>
+        defaultValue != null
+          ? {
+              type: 'AssignmentPattern',
+              left: bindingIdent,
+              right: deepCloneNode(defaultValue),
+              ...etc(),
+            }
+          : bindingIdent;
+
+      switch (key.type) {
+        case 'Identifier': {
+          const needsNewBinding = isReservedWord(keyName);
+          const bindingName = needsNewBinding ? genID.id() : keyName;
+          const bindingIdent = ident(bindingName);
+          if (needsNewBinding) {
+            reservedPropNames.set(keyName, bindingName);
+          }
+
+          if (needsNewBinding) {
+            return {
+              type: 'Property',
+              kind: 'init',
+              key: shallowCloneNode(key),
+              value: getValue(bindingIdent),
+              shorthand: false,
+              method: false,
+              computed: false,
+              ...etc(),
+              parent: EMPTY_PARENT,
+            };
+          } else {
+            return {
+              type: 'Property',
+              kind: 'init',
+              key: shallowCloneNode(key),
+              value: getValue(bindingIdent),
+              shorthand: true,
+              method: false,
+              computed: false,
+              ...etc(),
+              parent: EMPTY_PARENT,
+            };
+          }
+        }
+        case 'Literal': {
+          const bindingName = genID.id();
+          const bindingIdent = ident(bindingName);
+          reservedPropNames.set(keyName, bindingName);
+
+          return {
+            type: 'Property',
+            kind: 'init',
+            key: shallowCloneNode(key),
+            value: getValue(bindingIdent),
+            shorthand: false,
+            method: false,
+            computed: false,
+            ...etc(),
+            parent: EMPTY_PARENT,
+          };
+        }
+      }
+    }),
+    typeAnnotation: null,
+    ...etc(),
+  };
+
+  // Create the constructor method
+  const constructor: MethodDefinition = {
+    type: 'MethodDefinition',
+    key: ident('constructor'),
+    kind: 'constructor',
+    computed: false,
+    static: false,
+    value: {
+      type: 'FunctionExpression',
+      id: null,
+      params: [constructorParam],
+      body: {
+        type: 'BlockStatement',
+        body: ownProperties.map(({key}) => {
+          const keyName = nameOfKey(key);
+          const bindingIdent = ident(reservedPropNames.get(keyName) ?? keyName);
+          const object: ThisExpression = {type: 'ThisExpression', ...etc()};
+          const memberExpression: MemberExpression =
+            key.type === 'Identifier'
+              ? {
+                  type: 'MemberExpression',
+                  object,
+                  property: shallowCloneNode(key),
+                  computed: false,
+                  optional: false,
+                  ...etc(),
+                }
+              : {
+                  type: 'MemberExpression',
+                  object,
+                  property: shallowCloneNode(key),
+                  computed: true,
+                  optional: false,
+                  ...etc(),
+                };
+          return {
+            type: 'ExpressionStatement',
+            expression: {
+              type: 'AssignmentExpression',
+              operator: '=',
+              left: memberExpression,
+              right: bindingIdent,
+              ...etc(),
+            },
+            directive: null,
+            ...etc(),
+          };
+        }),
+        ...etc(),
+      },
+      generator: false,
+      async: false,
+      predicate: null,
+      returnType: null,
+      typeParameters: null,
+      ...etc(),
+    },
+    ...etc(),
+    parent: EMPTY_PARENT,
+  };
+
+  const classStaticProperties: ReadonlyArray<ClassMember> =
+    staticProperties.map(prop => ({
+      type: 'PropertyDefinition',
+      key: shallowCloneNode(prop.key),
+      value: deepCloneNode(prop.value),
+      static: true,
+      typeAnnotation: null,
+      variance: null,
+      computed: false,
+      declare: false,
+      optional: false,
+      ...etc(),
+      parent: EMPTY_PARENT,
+    }));
+
+  const classBodyElements: ReadonlyArray<ClassMember> = [
+    constructor,
+    ...methods,
+    ...classStaticProperties,
+    ...staticMethods,
+  ];
+
+  return {
+    type: 'ClassDeclaration',
+    id: shallowCloneNode(node.id),
+    body: {
+      type: 'ClassBody',
+      body: classBodyElements,
+      ...etc(),
+      parent: EMPTY_PARENT,
+    },
+    superClass: null,
+    typeParameters: null,
+    superTypeArguments: null,
+    implements: [],
+    decorators: [],
+    ...etc(),
+  };
+}
+
+function mapRecordExpression(node: RecordExpression): NewExpression {
+  const obj: ObjectExpression = {
+    type: 'ObjectExpression',
+    properties: node.properties.properties,
+    ...etc(),
+  };
+  return {
+    type: 'NewExpression',
+    callee: node.recordConstructor,
+    arguments: [obj],
+    typeArguments: null,
+    ...etc(),
+  };
+}
+
+export function transformProgram(
+  program: Program,
+  _options: ParserOptions,
+): Program {
+  const genID = new GenID('r');
+  return SimpleTransform.transformProgram(program, {
+    transform(node: ESNode) {
+      switch (node.type) {
+        case 'RecordDeclaration': {
+          return mapRecordDeclaration(genID, node);
+        }
+        case 'RecordExpression': {
+          return mapRecordExpression(node);
+        }
+        case 'Identifier': {
+          // A rudimentary check to avoid some collisions with our generated
+          // variable names. Ideally, we would have access a scope analyzer
+          // inside the transform instead.
+          genID.addUsage(node.name);
+          return node;
+        }
+        default:
+          return node;
+      }
+    },
+  });
+}

package/dist/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'],