hermes-estree 0.32.1 → 0.33.0

package/dist/src/HermesToESTreeAdapter.js

@@ -1,439 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-
-var _HermesASTAdapter = _interopRequireDefault(require("./HermesASTAdapter"));
-
-var _getModuleDocblock = require("./getModuleDocblock");
-
-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
- */
-class HermesToESTreeAdapter extends _HermesASTAdapter.default {
-  constructor(options, code) {
-    super(options);
-    this.code = void 0;
-    this.code = code;
-  }
-
-  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.range = [loc.rangeStart, loc.rangeEnd];
-    delete node.start;
-    delete node.end;
-  }
-
-  mapNode(node) {
-    this.fixSourceLocation(node);
-
-    switch (node.type) {
-      case 'Program':
-        return this.mapProgram(node);
-
-      case 'NullLiteral':
-        return this.mapNullLiteral(node);
-
-      case 'BooleanLiteral':
-      case 'StringLiteral':
-      case 'NumericLiteral':
-      case 'JSXStringLiteral':
-        return this.mapSimpleLiteral(node);
-
-      case 'BigIntLiteral':
-        return this.mapBigIntLiteral(node);
-
-      case 'RegExpLiteral':
-        return this.mapRegExpLiteral(node);
-
-      case 'Empty':
-        return this.mapEmpty(node);
-
-      case 'TemplateElement':
-        return this.mapTemplateElement(node);
-
-      case 'BigIntLiteralTypeAnnotation':
-        return this.mapBigIntLiteralTypeAnnotation(node);
-
-      case 'GenericTypeAnnotation':
-        return this.mapGenericTypeAnnotation(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 'ExportAllDeclaration':
-        return this.mapExportAllDeclaration(node);
-
-      case 'FunctionDeclaration':
-      case 'FunctionExpression':
-      case 'ArrowFunctionExpression':
-        return this.mapFunction(node);
-
-      case 'PrivateName':
-        return this.mapPrivateName(node);
-
-      case 'ClassProperty':
-      case 'ClassPrivateProperty':
-        return this.mapClassProperty(node);
-
-      case 'MemberExpression':
-      case 'OptionalMemberExpression':
-      case 'CallExpression':
-      case 'OptionalCallExpression':
-        return this.mapChainExpression(node);
-
-      case 'BlockStatement':
-        return this.mapBlockStatement(node);
-
-      default:
-        return this.mapNodeDefault(node);
-    }
-  }
-
-  mapProgram(node) {
-    const nodeDefault = this.mapNodeDefault(node);
-    node.sourceType = this.getSourceType();
-    node.docblock = (0, _getModuleDocblock.getModuleDocblock)(nodeDefault);
-    return nodeDefault;
-  }
-
-  mapSimpleLiteral(node) {
-    return {
-      type: 'Literal',
-      loc: node.loc,
-      range: node.range,
-      value: node.value,
-      raw: this.code.slice(node.range[0], node.range[1]),
-      literalType: (() => {
-        switch (node.type) {
-          case 'NullLiteral':
-            return 'null';
-
-          case 'BooleanLiteral':
-            return 'boolean';
-
-          case 'StringLiteral':
-          case 'JSXStringLiteral':
-            return 'string';
-
-          case 'NumericLiteral':
-            return 'numeric';
-
-          case 'BigIntLiteral':
-            return 'bigint';
-
-          case 'RegExpLiteral':
-            return 'regexp';
-        }
-
-        return null;
-      })()
-    };
-  }
-
-  mapBigIntLiteral(node) {
-    const newNode = this.mapSimpleLiteral(node);
-    return { ...newNode,
-      ...this.getBigIntLiteralValue(node.bigint)
-    };
-  }
-
-  mapNullLiteral(node) {
-    return { ...this.mapSimpleLiteral(node),
-      value: null
-    };
-  }
-
-  mapRegExpLiteral(node) {
-    const {
-      pattern,
-      flags
-    } = node; // Create RegExp value if possible. This can fail when the flags are invalid.
-
-    let value;
-
-    try {
-      value = new RegExp(pattern, flags);
-    } catch (e) {
-      value = null;
-    }
-
-    return { ...this.mapSimpleLiteral(node),
-      value,
-      regex: {
-        pattern,
-        flags
-      }
-    };
-  }
-
-  mapBigIntLiteralTypeAnnotation(node) {
-    return { ...node,
-      ...this.getBigIntLiteralValue(node.raw)
-    };
-  }
-
-  mapTemplateElement(node) {
-    return {
-      type: 'TemplateElement',
-      loc: node.loc,
-      range: node.range,
-      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,
-        range: node.range
-      };
-    }
-
-    return this.mapNodeDefault(node);
-  }
-
-  mapComment(node) {
-    if (node.type === 'CommentBlock') {
-      node.type = 'Block';
-    } else if (node.type === 'CommentLine') {
-      node.type = 'Line';
-    }
-
-    return node;
-  }
-
-  mapFunction(nodeUnprocessed) {
-    const node = this.mapNodeDefault(nodeUnprocessed);
-
-    switch (node.type) {
-      // This prop should ideally only live on `ArrowFunctionExpression` but to
-      // match espree output we place it on all functions types.
-      case 'FunctionDeclaration':
-      case 'FunctionExpression':
-        node.expression = false;
-        return node;
-
-      case 'ArrowFunctionExpression':
-        node.expression = node.body.type !== 'BlockStatement';
-        return node;
-    }
-
-    return node;
-  }
-
-  mapChainExpression(nodeUnprocessed) {
-    /*
-    NOTE - In the below comments `MemberExpression` and `CallExpression`
-           are completely interchangable. For terseness we just reference
-           one each time.
-    */
-
-    /*
-    Hermes uses the old babel-style AST:
-    ```
-    (one?.two).three?.four;
-    ^^^^^^^^^^^^^^^^^^^^^^ OptionalMemberExpression
-    ^^^^^^^^^^^^^^^^ MemberExpression
-     ^^^^^^^^ OptionalMemberExpression
-    ```
-     We need to convert it to the ESTree representation:
-    ```
-    (one?.two).three?.four;
-    ^^^^^^^^^^^^^^^^^^^^^^ ChainExpression
-    ^^^^^^^^^^^^^^^^^^^^^^ MemberExpression[optional = true]
-    ^^^^^^^^^^^^^^^^ MemberExpression[optional = false]
-     ^^^^^^^^ ChainExpression
-     ^^^^^^^^ MemberExpression[optional = true]
-    ```
-     We do this by converting the AST and its children (depth first), and then unwrapping
-    the resulting AST as appropriate.
-     Put another way:
-    1) traverse to the leaf
-    2) if the current node is an `OptionalMemberExpression`:
-      a) if the `.object` is a `ChainExpression`:
-        i)   unwrap the child (`node.object = child.expression`)
-      b) convert this node to a `MemberExpression[optional = true]`
-      c) wrap this node (`node = ChainExpression[expression = node]`)
-    3) if the current node is a `MemberExpression`:
-      a) convert this node to a `MemberExpression[optional = true]`
-    */
-    const node = this.mapNodeDefault(nodeUnprocessed);
-
-    const {
-      child,
-      childKey,
-      isOptional
-    } = (() => {
-      const isOptional = node.optional === true;
-
-      if (node.type.endsWith('MemberExpression')) {
-        return {
-          child: node.object,
-          childKey: 'object',
-          isOptional
-        };
-      } else if (node.type.endsWith('CallExpression')) {
-        return {
-          child: node.callee,
-          childKey: 'callee',
-          isOptional
-        };
-      } else {
-        return {
-          child: node.expression,
-          childKey: 'expression',
-          isOptional: false
-        };
-      }
-    })();
-
-    const isChildUnwrappable = child.type === 'ChainExpression' && // (x?.y).z is semantically different to `x?.y.z`.
-    // In the un-parenthesised case `.z` is only executed if and only if `x?.y` returns a non-nullish value.
-    // In the parenthesised case, `.z` is **always** executed, regardless of the return of `x?.y`.
-    // As such the AST is different between the two cases.
-    //
-    // In the hermes AST - any member part of a non-short-circuited optional chain is represented with `OptionalMemberExpression`
-    // so if we see a `MemberExpression`, then we know we've hit a parenthesis boundary.
-    node.type !== 'MemberExpression' && node.type !== 'CallExpression';
-
-    if (node.type.startsWith('Optional')) {
-      node.type = node.type.replace('Optional', '');
-      node.optional = isOptional;
-    } else {
-      node.optional = false;
-    }
-
-    if (!isChildUnwrappable && !isOptional) {
-      return node;
-    }
-
-    if (isChildUnwrappable) {
-      const newChild = child.expression;
-      node[childKey] = newChild;
-    }
-
-    return {
-      type: 'ChainExpression',
-      expression: node,
-      loc: node.loc,
-      range: node.range
-    };
-  }
-
-  mapClassProperty(nodeUnprocessed) {
-    const node = this.mapNodeDefault(nodeUnprocessed);
-
-    const key = (() => {
-      if (node.type === 'ClassPrivateProperty') {
-        const key = this.mapNodeDefault(node.key);
-        return {
-          type: 'PrivateIdentifier',
-          name: key.name,
-          range: key.range,
-          loc: key.loc
-        };
-      }
-
-      return node.key;
-    })();
-
-    return { ...node,
-      computed: node.type === 'ClassPrivateProperty' ? false : node.computed,
-      key,
-      type: 'PropertyDefinition'
-    };
-  }
-
-  mapPrivateName(node) {
-    return {
-      type: 'PrivateIdentifier',
-      name: node.id.name,
-      // estree the location refers to the entire string including the hash token
-      range: node.range,
-      loc: node.loc
-    };
-  }
-
-  mapExportNamedDeclaration(nodeUnprocessed) {
-    const node = super.mapExportNamedDeclaration(nodeUnprocessed);
-    const namespaceSpecifier = node.specifiers.find(spec => spec.type === 'ExportNamespaceSpecifier');
-
-    if (namespaceSpecifier != null) {
-      var _node$exportKind;
-
-      if (node.specifiers.length !== 1) {
-        // this should already a hermes parser error - but let's be absolutely sure we're aligned with the spec
-        throw new Error('Cannot use an export all with any other specifiers');
-      }
-
-      return {
-        type: 'ExportAllDeclaration',
-        source: node.source,
-        exportKind: (_node$exportKind = node.exportKind) != null ? _node$exportKind : 'value',
-        exported: namespaceSpecifier.exported,
-        range: node.range,
-        loc: node.loc
-      };
-    }
-
-    return node;
-  }
-
-  mapExportAllDeclaration(nodeUnprocessed) {
-    var _node$exported;
-
-    const node = super.mapExportAllDeclaration(nodeUnprocessed);
-    node.exported = (_node$exported = node.exported) != null ? _node$exported : null;
-    return node;
-  }
-
-  mapBlockStatement(node) {
-    if (node.implicit && node.body.length) {
-      return this.mapNode(node.body[0]);
-    }
-
-    delete node.implicit;
-    return this.mapNodeDefault(node);
-  }
-
-}
-
-exports.default = HermesToESTreeAdapter;

package/dist/src/ParserOptions.js

@@ -1,18 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ParserOptionsKeys = void 0;
-
-/**
- * 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
- */
-const ParserOptionsKeys = new Set(['allowReturnOutsideFunction', 'babel', 'flow', 'enableExperimentalComponentSyntax', 'enableExperimentalFlowMatchSyntax', 'reactRuntimeTarget', 'sourceFilename', 'sourceType', 'tokens', 'transformOptions']);
-exports.ParserOptionsKeys = ParserOptionsKeys;