hermes-parser 0.15.0 → 0.16.0

package/dist/HermesToBabelAdapter.js

@@ -1,787 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-
-var _HermesASTAdapter = _interopRequireDefault(require("./HermesASTAdapter"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-/**
- * 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
- */
-function createDefaultPosition() {
-  return {
-    line: 1,
-    column: 0
-  };
-}
-
-function createSyntaxError(node, err) {
-  const syntaxError = new SyntaxError(err); // $FlowExpectedError[prop-missing]
-
-  syntaxError.loc = {
-    line: node.loc.start.line,
-    column: node.loc.start.column
-  };
-  return syntaxError;
-}
-
-class HermesToBabelAdapter extends _HermesASTAdapter.default {
-  fixSourceLocation(node) {
-    var _this$sourceFilename;
-
-    const loc = node.loc;
-
-    if (loc == null) {
-      return;
-    }
-
-    node.loc = {
-      source: (_this$sourceFilename = this.sourceFilename) != null ? _this$sourceFilename : null,
-      start: loc.start,
-      end: loc.end
-    };
-    node.start = loc.rangeStart;
-    node.end = loc.rangeEnd;
-  }
-
-  mapNode(node) {
-    this.fixSourceLocation(node);
-
-    switch (node.type) {
-      case 'Program':
-        return this.mapProgram(node);
-
-      case 'BlockStatement':
-        return this.mapNodeWithDirectives(node);
-
-      case 'Empty':
-        return this.mapEmpty(node);
-
-      case 'Identifier':
-        return this.mapIdentifier(node);
-
-      case 'TemplateElement':
-        return this.mapTemplateElement(node);
-
-      case 'GenericTypeAnnotation':
-        return this.mapGenericTypeAnnotation(node);
-
-      case 'SymbolTypeAnnotation':
-        return this.mapSymbolTypeAnnotation(node);
-
-      case 'Property':
-        return this.mapProperty(node);
-
-      case 'MethodDefinition':
-        return this.mapMethodDefinition(node);
-
-      case 'ImportDeclaration':
-        return this.mapImportDeclaration(node);
-
-      case 'ImportSpecifier':
-        return this.mapImportSpecifier(node);
-
-      case 'ExportDefaultDeclaration':
-        return this.mapExportDefaultDeclaration(node);
-
-      case 'ExportNamedDeclaration':
-        return this.mapExportNamedDeclaration(node);
-
-      case 'ExportNamespaceSpecifier':
-        return this.mapExportNamespaceSpecifier(node);
-
-      case 'ExportAllDeclaration':
-        return this.mapExportAllDeclaration(node);
-
-      case 'RestElement':
-        return this.mapRestElement(node);
-
-      case 'ImportExpression':
-        return this.mapImportExpression(node);
-
-      case 'JSXStringLiteral':
-        return this.mapJSXStringLiteral(node);
-
-      case 'PrivateName':
-        return this.mapPrivateName(node);
-
-      case 'ClassPrivateProperty':
-        return this.mapPrivateProperty(node);
-
-      case 'FunctionDeclaration':
-      case 'FunctionExpression':
-        return this.mapFunction(node);
-
-      case 'IndexedAccessType':
-      case 'OptionalIndexedAccessType':
-      case 'KeyofTypeAnnotation':
-      case 'ConditionalTypeAnnotation':
-      case 'InferTypeAnnotation':
-      case 'TupleTypeLabeledElement':
-      case 'TupleTypeSpreadElement':
-      case 'ObjectTypeMappedTypeProperty':
-      case 'ComponentTypeAnnotation':
-      case 'TypePredicate':
-        return this.mapUnsupportedTypeAnnotation(node);
-
-      case 'BigIntLiteral':
-        return this.mapBigIntLiteral(node);
-
-      case 'BigIntLiteralTypeAnnotation':
-        return this.mapBigIntLiteralTypeAnnotation(node);
-
-      case 'BigIntTypeAnnotation':
-        return this.mapBigIntTypeAnnotation(node);
-
-      case 'TypeofTypeAnnotation':
-        return this.mapTypeofTypeAnnotation(node);
-
-      case 'QualifiedTypeofIdentifier':
-        return this.mapQualifiedTypeofIdentifier(node);
-
-      case 'DeclareVariable':
-        return this.mapDeclareVariable(node);
-
-      case 'DeclareEnum':
-        return this.mapDeclareEnum(node);
-
-      case 'DeclareComponent':
-        return this.mapDeclareComponent(node);
-
-      case 'JSXElement':
-        return this.mapJSXElement(node);
-
-      case 'ComponentDeclaration':
-        return this.mapComponentDeclaration(node);
-
-      default:
-        return this.mapNodeDefault(node);
-    }
-  }
-
-  mapProgram(node) {
-    // Visit child nodes and convert to directives
-    const {
-      comments,
-      ...program
-    } = this.mapNodeWithDirectives(node);
-    program.sourceType = this.getSourceType(); // Adjust start loc to beginning of file
-
-    program.loc.start = {
-      line: 1,
-      column: 0
-    };
-    program.start = 0; // Adjust end loc to include last comment if program ends with a comment
-
-    if (comments.length > 0) {
-      const lastComment = comments[comments.length - 1];
-
-      if (lastComment.end > program.end) {
-        program.loc.end = lastComment.loc.end;
-        program.end = lastComment.end;
-      }
-    } // Rename root node to File node and move Program node under program property
-
-
-    return {
-      type: 'File',
-      loc: program.loc,
-      start: program.start,
-      end: program.end,
-      program,
-      comments
-    };
-  }
-
-  mapNodeWithDirectives(node) {
-    const directives = [];
-
-    for (const child of node.body) {
-      if (child.type === 'ExpressionStatement' && child.directive != null) {
-        // Visit directive children
-        const directiveChild = this.mapNode(child); // Modify string literal node to be DirectiveLiteral node
-
-        directiveChild.expression.type = 'DirectiveLiteral'; // Construct Directive node with DirectiveLiteral value
-
-        directives.push({
-          type: 'Directive',
-          loc: directiveChild.loc,
-          start: directiveChild.start,
-          end: directiveChild.end,
-          value: directiveChild.expression
-        });
-      } else {
-        // Once we have found the first non-directive node we know there cannot be any more directives
-        break;
-      }
-    } // Move directives from body to new directives array
-
-
-    node.directives = directives;
-
-    if (directives.length !== 0) {
-      node.body = node.body.slice(directives.length);
-    } // Visit expression statement children
-
-
-    const body = node.body;
-
-    for (let i = 0; i < body.length; i++) {
-      const child = body[i];
-
-      if (child != null) {
-        body[i] = this.mapNode(child);
-      }
-    }
-
-    return node;
-  }
-
-  mapIdentifier(node) {
-    node.loc.identifierName = node.name;
-    return this.mapNodeDefault(node);
-  }
-
-  mapTemplateElement(node) {
-    // Adjust start loc to exclude "`" at beginning of template literal if this is the first quasi,
-    // otherwise exclude "}" from previous expression.
-    const startCharsToExclude = 1; // Adjust end loc to exclude "`" at end of template literal if this is the last quasi,
-    // otherwise exclude "${" from next expression.
-
-    const endCharsToExclude = node.tail ? 1 : 2;
-    return {
-      type: 'TemplateElement',
-      loc: {
-        start: {
-          line: node.loc.start.line,
-          column: node.loc.start.column + startCharsToExclude
-        },
-        end: {
-          line: node.loc.end.line,
-          column: node.loc.end.column - endCharsToExclude
-        }
-      },
-      start: node.start + startCharsToExclude,
-      end: node.end - endCharsToExclude,
-      tail: node.tail,
-      value: {
-        cooked: node.cooked,
-        raw: node.raw
-      }
-    };
-  }
-
-  mapGenericTypeAnnotation(node) {
-    // Convert simple `this` generic type to ThisTypeAnnotation
-    if (node.typeParameters == null && node.id.type === 'Identifier' && node.id.name === 'this') {
-      return {
-        type: 'ThisTypeAnnotation',
-        loc: node.loc,
-        start: node.start,
-        end: node.end
-      };
-    }
-
-    return this.mapNodeDefault(node);
-  }
-
-  mapSymbolTypeAnnotation(node) {
-    return {
-      type: 'GenericTypeAnnotation',
-      loc: node.loc,
-      start: node.start,
-      end: node.end,
-      id: {
-        type: 'Identifier',
-        loc: node.loc,
-        start: node.start,
-        end: node.end,
-        name: 'symbol'
-      },
-      typeParameters: null
-    };
-  }
-
-  mapProperty(node) {
-    const key = this.mapNode(node.key);
-    const value = this.mapNode(node.value); // Convert methods, getters, and setters to ObjectMethod nodes
-
-    if (node.method || node.kind !== 'init') {
-      // Properties under the FunctionExpression value that should be moved
-      // to the ObjectMethod node itself.
-      const {
-        id,
-        params,
-        body,
-        async,
-        generator,
-        returnType,
-        typeParameters,
-        predicate
-      } = value;
-      const newNode = {
-        type: 'ObjectMethod',
-        loc: node.loc,
-        start: node.start,
-        end: node.end,
-        // Non getter or setter methods have `kind = method`
-        kind: node.kind === 'init' ? 'method' : node.kind,
-        method: node.kind === 'init' ? true : false,
-        computed: node.computed,
-        key,
-        id,
-        params,
-        body,
-        async,
-        generator,
-        returnType,
-        typeParameters,
-        predicate
-      };
-
-      if (node.kind !== 'init') {
-        // babel emits an empty variance property on accessors for some reason
-        newNode.variance = null;
-      }
-
-      return newNode;
-    } else {
-      // Non-method property nodes should be renamed to ObjectProperty
-      node.type = 'ObjectProperty';
-      return node;
-    }
-  }
-
-  mapMethodDefinition(node) {
-    const key = this.mapNode(node.key);
-    const value = this.mapNode(node.value); // Properties under the FunctionExpression value that should be moved
-    // to the ClassMethod node itself.
-
-    const {
-      id,
-      params,
-      body,
-      async,
-      generator,
-      returnType,
-      typeParameters,
-      predicate
-    } = value;
-    return {
-      type: key.type === 'PrivateName' ? 'ClassPrivateMethod' : 'ClassMethod',
-      loc: node.loc,
-      start: node.start,
-      end: node.end,
-      kind: node.kind,
-      computed: node.computed,
-      static: node.static,
-      key,
-      id,
-      params,
-      body,
-      async,
-      generator,
-      returnType,
-      typeParameters,
-      predicate
-    };
-  }
-
-  mapRestElement(node) {
-    const restElement = this.mapNodeDefault(node); // Hermes puts type annotations on rest elements on the argument node,
-    // but Babel expects type annotations on the rest element node itself.
-
-    const annotation = restElement.argument.typeAnnotation;
-
-    if (annotation != null) {
-      restElement.typeAnnotation = annotation;
-      restElement.argument.typeAnnotation = null; // Unfortunately there's no way for us to recover the end location of
-      // the argument for the general case
-
-      if (restElement.argument.type === 'Identifier') {
-        restElement.argument.end = restElement.argument.start + restElement.argument.name.length;
-        restElement.argument.loc.end = { ...restElement.argument.loc.start,
-          column: restElement.argument.loc.start.column + restElement.argument.name.length
-        };
-      }
-    }
-
-    return restElement;
-  }
-
-  mapImportExpression(node) {
-    // Babel expects ImportExpression to be structued as a regular
-    // CallExpression where the callee is an Import node.
-    return {
-      type: 'CallExpression',
-      loc: node.loc,
-      start: node.start,
-      end: node.end,
-      callee: {
-        type: 'Import',
-        loc: { ...node.loc,
-          end: { ...node.loc.start,
-            column: node.loc.start.column + 'import'.length
-          }
-        },
-        start: node.start,
-        end: node.start + 'import'.length
-      },
-      arguments: [this.mapNode(node.source)]
-    };
-  }
-
-  mapJSXStringLiteral(node) {
-    // Babel expects StringLiterals in JSX,
-    // but Hermes uses JSXStringLiteral to attach the raw value without
-    // having to internally attach it to every single string literal.
-    return {
-      type: 'StringLiteral',
-      loc: node.loc,
-      start: node.start,
-      end: node.end,
-      value: node.value
-    };
-  }
-
-  mapFunction(node) {
-    // Remove the first parameter if it is a this-type annotation,
-    // which is not recognized by Babel.
-    if (node.params.length !== 0 && node.params[0].name === 'this') {
-      node.params.shift();
-    }
-
-    return this.mapNodeDefault(node);
-  }
-  /**
-   * If Babel (the version we target) does not support a type annotation we
-   * parse, we need to return some other valid type annotation in its place.
-   */
-
-
-  mapUnsupportedTypeAnnotation(node) {
-    return {
-      type: 'AnyTypeAnnotation',
-      loc: node.loc,
-      start: node.start,
-      end: node.end
-    };
-  }
-
-  mapBigIntLiteral(node) {
-    node.value = this.getBigIntLiteralValue(node.bigint).value;
-    return node;
-  }
-
-  mapBigIntLiteralTypeAnnotation(node) {
-    node.value = this.getBigIntLiteralValue(node.raw).value;
-    return node;
-  }
-  /**
-   * Babel does not parse the bigint keyword type as the keyword node.
-   * So we need to down-level the AST to a plain GenericTypeAnnotation
-   */
-
-
-  mapBigIntTypeAnnotation(node) {
-    return {
-      type: 'GenericTypeAnnotation',
-      id: {
-        type: 'Identifier',
-        name: 'bigint',
-        loc: node.loc,
-        start: node.start,
-        end: node.end
-      },
-      typeParameters: null,
-      loc: node.loc,
-      start: node.start,
-      end: node.end
-    };
-  }
-
-  mapPrivateProperty(nodeUnprocessed) {
-    const node = this.mapNodeDefault(nodeUnprocessed);
-    node.key = {
-      type: 'PrivateName',
-      id: { ...node.key,
-        // babel doesn't include the hash in the identifier
-        start: node.key.start + 1,
-        loc: { ...node.key.loc,
-          start: { ...node.key.loc.start,
-            column: node.key.loc.start.column + 1
-          }
-        }
-      },
-      start: node.key.start,
-      end: node.key.end,
-      loc: node.key.loc
-    };
-    return node;
-  }
-
-  mapPrivateName(node) {
-    // babel doesn't include the hash in the identifier
-    node.id.start += 1;
-    node.id.loc.start.column += 1;
-    return node;
-  }
-
-  mapExportNamespaceSpecifier(nodeUnprocessed) {
-    const node = this.mapNodeDefault(nodeUnprocessed); // the hermes AST emits the location as the location of the entire export
-    // but babel emits the location as *just* the "* as id" bit
-    // the end will always align with the end of the identifier (ezpz)
-    // but the start will align with the "*" token - which we can't recover from just the AST
-    // so we just fudge the start location a bit to get it "good enough"
-    // it will be wrong if the AST is anything like "export      * as x from 'y'"... but oh well
-
-    node.start = node.start + 'export '.length;
-    node.loc.start.column = node.loc.start.column + 'export '.length;
-    node.end = node.exported.end;
-    node.loc.end = {
-      column: node.exported.loc.end.column,
-      line: node.exported.loc.end.line
-    };
-    return node;
-  }
-
-  mapTypeofTypeAnnotation(nodeUnprocessed) {
-    nodeUnprocessed.argument = {
-      type: 'GenericTypeAnnotation',
-      id: nodeUnprocessed.argument,
-      typeParameters: null,
-      loc: nodeUnprocessed.argument.loc
-    };
-    return this.mapNodeDefault(nodeUnprocessed);
-  }
-
-  mapQualifiedTypeofIdentifier(nodeUnprocessed) {
-    nodeUnprocessed.type = 'QualifiedTypeIdentifier';
-    return this.mapNodeDefault(nodeUnprocessed);
-  }
-
-  mapDeclareVariable(nodeUnprocessed) {
-    delete nodeUnprocessed.kind;
-    return this.mapNodeDefault(nodeUnprocessed);
-  }
-
-  mapDeclareEnum(nodeUnprocessed) {
-    nodeUnprocessed.id.typeAnnotation = this.mapUnsupportedTypeAnnotation(nodeUnprocessed.body);
-    delete nodeUnprocessed.body;
-    nodeUnprocessed.type = 'DeclareVariable';
-    return this.mapDeclareVariable(nodeUnprocessed);
-  }
-
-  mapDeclareComponent(nodeUnprocessed) {
-    nodeUnprocessed.id.typeAnnotation = this.mapUnsupportedTypeAnnotation(nodeUnprocessed);
-    delete nodeUnprocessed.params;
-    delete nodeUnprocessed.rest;
-    delete nodeUnprocessed.typeParameters;
-    delete nodeUnprocessed.rendersType;
-    nodeUnprocessed.type = 'DeclareVariable';
-    return this.mapDeclareVariable(nodeUnprocessed);
-  }
-
-  mapJSXElement(nodeUnprocessed) {
-    delete nodeUnprocessed.openingElement.typeArguments;
-    return this.mapNodeDefault(nodeUnprocessed);
-  }
-
-  mapComponentDeclaration(nodeUnprocessed) {
-    let rendersType = nodeUnprocessed.rendersType;
-
-    if (rendersType == null) {
-      // Create empty loc for return type annotation nodes
-      const createRendersTypeLoc = () => ({
-        loc: {
-          start: { ...nodeUnprocessed.body.loc.end
-          },
-          end: { ...nodeUnprocessed.body.loc.end
-          },
-          rangeStart: nodeUnprocessed.body.loc.rangeStart,
-          rangeEnd: nodeUnprocessed.body.loc.rangeEnd
-        }
-      });
-
-      rendersType = {
-        type: 'TypeAnnotation',
-        typeAnnotation: {
-          type: 'GenericTypeAnnotation',
-          id: {
-            type: 'QualifiedTypeIdentifier',
-            qualification: {
-              type: 'Identifier',
-              name: 'React',
-              ...createRendersTypeLoc()
-            },
-            id: {
-              type: 'Identifier',
-              name: 'Node',
-              ...createRendersTypeLoc()
-            }
-          },
-          typeParameters: null,
-          ...createRendersTypeLoc()
-        },
-        ...createRendersTypeLoc()
-      };
-    }
-
-    function getParamName(paramName) {
-      switch (paramName.type) {
-        case 'Identifier':
-          return paramName.name;
-
-        case 'StringLiteral':
-          return paramName.value;
-
-        default:
-          throw createSyntaxError(paramName, `Unknown Component parameter name type of "${paramName.type}"`);
-      }
-    }
-
-    function createPropsTypeAnnotation(loc) {
-      // Create empty loc for type annotation nodes
-      const createParamsTypeLoc = () => ({
-        loc: {
-          start: loc.start != null ? { ...loc.start
-          } : createDefaultPosition(),
-          end: loc.end != null ? { ...loc.end
-          } : createDefaultPosition(),
-          rangeStart: loc.rangeStart,
-          rangeEnd: loc.rangeEnd
-        }
-      });
-
-      return {
-        type: 'TypeAnnotation',
-        typeAnnotation: {
-          type: 'GenericTypeAnnotation',
-          id: {
-            type: 'Identifier',
-            name: '$ReadOnly',
-            ...createParamsTypeLoc()
-          },
-          typeParameters: {
-            type: 'TypeParameterInstantiation',
-            params: [{
-              type: 'ObjectTypeAnnotation',
-              callProperties: [],
-              properties: [],
-              indexers: [],
-              internalSlots: [],
-              exact: false,
-              inexact: true,
-              ...createParamsTypeLoc()
-            }],
-            ...createParamsTypeLoc()
-          },
-          ...createParamsTypeLoc()
-        },
-        ...createParamsTypeLoc()
-      };
-    }
-
-    const params = (() => {
-      if (nodeUnprocessed.params.length === 0) {
-        return [];
-      } // Optimize `component Foo(...props: Props) {}` to `function Foo(props: Props) {}
-
-
-      if (nodeUnprocessed.params.length === 1 && nodeUnprocessed.params[0].type === 'RestElement') {
-        const restElement = nodeUnprocessed.params[0];
-        return [{ ...restElement.argument,
-          typeAnnotation: createPropsTypeAnnotation(restElement.argument.typeAnnotation.loc)
-        }];
-      }
-
-      const properties = nodeUnprocessed.params.map(param => {
-        switch (param.type) {
-          case 'RestElement':
-            {
-              delete param.typeAnnotation;
-              return param;
-            }
-
-          case 'ComponentParameter':
-            {
-              if (getParamName(param.name) === 'ref') {
-                throw createSyntaxError(param, 'Component parameters named "ref" are currently not supported');
-              }
-
-              if (param.name.type === 'Identifier') {
-                delete param.name.typeAnnotation;
-              }
-
-              if (param.local.type === 'AssignmentPattern') {
-                delete param.local.left.typeAnnotation;
-                delete param.local.left.optional;
-              } else {
-                delete param.local.typeAnnotation;
-                delete param.local.optional;
-              }
-
-              return {
-                type: 'ObjectProperty',
-                key: param.name,
-                value: param.local,
-                method: false,
-                shorthand: param.shorthand,
-                computed: false,
-                loc: param.loc,
-                start: param.start,
-                end: param.end
-              };
-            }
-
-          default:
-            {
-              throw createSyntaxError(param, `Unknown Component parameter type of "${param.type}"`);
-            }
-        }
-      });
-      const paramsLoc = {
-        start: properties[0].loc.start,
-        end: properties[properties.length - 1].loc.end,
-        rangeStart: properties[0].loc.rangeStart,
-        rangeEnd: properties[properties.length - 1].loc.rangeEnd
-      };
-      return [{
-        type: 'ObjectPattern',
-        properties,
-        typeAnnotation: createPropsTypeAnnotation({ ...paramsLoc,
-          start: paramsLoc.end,
-          rangeStart: paramsLoc.rangeEnd
-        }),
-        loc: paramsLoc
-      }];
-    })();
-
-    const functionComponent = {
-      type: 'FunctionDeclaration',
-      id: nodeUnprocessed.id,
-      typeParameters: nodeUnprocessed.typeParameters,
-      params,
-      returnType: rendersType,
-      body: nodeUnprocessed.body,
-      async: false,
-      generator: false,
-      predicate: null,
-      loc: nodeUnprocessed.loc
-    };
-    return this.mapNodeDefault(functionComponent);
-  }
-
-}
-
-exports.default = HermesToBabelAdapter;