hermes-parser 0.36.0 → 0.37.0

package/dist/getModuleDocblock.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/index.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -135,9 +135,10 @@ function getOptions(options = { ...DEFAULTS
   options.tokens = options.tokens === true;
   options.allowReturnOutsideFunction = options.allowReturnOutsideFunction === true;
   return options;
-}
-
+} // eslint-disable-next-line no-redeclare
 // eslint-disable-next-line no-redeclare
+
+
 function parse(code, opts) {
   var _options$transformOpt, _options$transformOpt2;
 

package/dist/index.js.flow

@@ -25,8 +25,8 @@ import * as StripFlowTypesForBabel from './estree/StripFlowTypesForBabel';
 import * as TransformESTreeToBabel from './babel/TransformESTreeToBabel';
 import * as StripFlowTypes from './estree/StripFlowTypes';
 
-const DEFAULTS = {
-  flow: ('detect': 'detect'),
+const DEFAULTS: {flow: 'detect'} = {
+  flow: 'detect',
 };
 
 function getOptions(options?: ParserOptions = {...DEFAULTS}) {
@@ -72,14 +72,14 @@ function getOptions(options?: ParserOptions = {...DEFAULTS}) {
 
 declare function parse(
   code: string,
-  opts: $ReadOnly<{...ParserOptions, babel: true}>,
+  opts: Readonly<{...ParserOptions, babel: true}>,
 ): BabelFile;
 // eslint-disable-next-line no-redeclare
 declare function parse(
   code: string,
   opts?:
-    | $ReadOnly<{...ParserOptions, babel?: false | void}>
-    | $ReadOnly<{...ParserOptions, babel: false}>,
+    | Readonly<{...ParserOptions, babel?: false | void}>
+    | Readonly<{...ParserOptions, babel: false}>,
 ): ESTreeProgram;
 
 // eslint-disable-next-line no-redeclare

package/dist/src/HermesASTAdapter.js

@@ -13,7 +13,7 @@ var _ParserVisitorKeys = require("./generated/ParserVisitorKeys");
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 

package/dist/src/HermesParser.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/HermesParserDecodeUTF8String.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/HermesParserDeserializer.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/HermesParserNodeDeserializers.js

@@ -18,7 +18,7 @@
 
 /* eslint no-undef: 'error', no-unused-vars: ['error', {vars: "local"}], no-redeclare: 'error' */
 
-/* global $NonMaybeType, Partial, $ReadOnly, $ReadOnlyArray, $FlowFixMe */
+/* global NonNullable, Partial, Readonly, ReadonlyArray, $FlowFixMe */
 'use strict';
 
 function deserializeEmpty() {

package/dist/src/HermesToESTreeAdapter.js

@@ -17,9 +17,10 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
+// eslint-disable-next-line no-unused-vars
 class HermesToESTreeAdapter extends _HermesASTAdapter.default {
   constructor(options, code) {
     super(options);
@@ -185,7 +186,7 @@ class HermesToESTreeAdapter extends _HermesASTAdapter.default {
 
     try {
       value = new RegExp(pattern, flags);
-    } catch (e) {
+    } catch {
       value = null;
     }
 

package/dist/src/ParserOptions.js

@@ -11,8 +11,10 @@ exports.ParserOptionsKeys = void 0;
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
- * @format
+ *  strict
+ * @noformat
  */
-const ParserOptionsKeys = new Set(['allowReturnOutsideFunction', 'babel', 'flow', 'enableExperimentalComponentSyntax', 'enableExperimentalFlowMatchSyntax', 'enableExperimentalFlowRecordSyntax', 'reactRuntimeTarget', 'sourceFilename', 'sourceType', 'tokens', 'transformOptions']);
+const ParserOptionsKeys
+/*: ReadonlySet<keyof ParserOptions> */
+= new Set(['allowReturnOutsideFunction', 'babel', 'flow', 'enableExperimentalComponentSyntax', 'enableExperimentalFlowMatchSyntax', 'enableExperimentalFlowRecordSyntax', 'reactRuntimeTarget', 'sourceFilename', 'sourceType', 'tokens', 'transformOptions']);
 exports.ParserOptionsKeys = ParserOptionsKeys;

package/dist/src/babel/TransformESTreeToBabel.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -277,14 +277,15 @@ function mapProperty(node) {
 
     return newNode;
   } // Non-method property nodes should be renamed to ObjectProperty
+  // $FlowExpectedError[incompatible-type]
 
 
+  const propertyValue = value;
   return {
     type: 'ObjectProperty',
     computed: node.computed,
     key: node.key,
-    // $FlowExpectedError[incompatible-type]
-    value: node.value,
+    value: propertyValue,
     method: node.method,
     shorthand: node.shorthand,
     loc: node.loc,

package/dist/src/estree/StripFlowTypes.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 

package/dist/src/estree/StripFlowTypesForBabel.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 

package/dist/src/estree/TransformComponentSyntax.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 

package/dist/src/estree/TransformEnumSyntax.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/estree/TransformMatchSyntax.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -48,6 +48,14 @@ function genIdent() {
  * location of to be tested against, or location to be extracted to a binding.
  */
 
+/**
+ * The conditional aspect of a match pattern for a single location.
+ */
+
+/**
+ * A binding introduced by a match pattern.
+ */
+
 
 function objKeyToString(node) {
   switch (node.type) {
@@ -368,7 +376,8 @@ function analyzePattern(pattern, key, seenBindingNames) {
           conditions,
           bindings
         } = analyzePattern(asPattern, key, seenBindingNames);
-        const [id, kind] = target.type === 'MatchBindingPattern' ? [target.id, target.kind] : [target, 'const'];
+        const constKind = 'const';
+        const [id, kind] = target.type === 'MatchBindingPattern' ? [target.id, target.kind] : [target, constKind];
         checkDuplicateBindingName(seenBindingNames, pattern, id.name);
         checkBindingKind(pattern, kind);
         const binding = {

package/dist/src/estree/TransformRecordSyntax.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/generated/ESTreeVisitorKeys.js

@@ -18,7 +18,7 @@
 
 /* eslint no-undef: 'error', no-unused-vars: ['error', {vars: "local"}], no-redeclare: 'error' */
 
-/* global $NonMaybeType, Partial, $ReadOnly, $ReadOnlyArray, $FlowFixMe */
+/* global NonNullable, Partial, Readonly, ReadonlyArray, $FlowFixMe */
 'use strict';
 
 module.exports = {

package/dist/src/generated/ParserVisitorKeys.js

@@ -18,7 +18,7 @@
 
 /* eslint no-undef: 'error', no-unused-vars: ['error', {vars: "local"}], no-redeclare: 'error' */
 
-/* global $NonMaybeType, Partial, $ReadOnly, $ReadOnlyArray, $FlowFixMe */
+/* global NonNullable, Partial, Readonly, ReadonlyArray, $FlowFixMe */
 'use strict';
 
 Object.defineProperty(exports, "__esModule", {

package/dist/src/getModuleDocblock.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/index.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -135,9 +135,10 @@ function getOptions(options = { ...DEFAULTS
   options.tokens = options.tokens === true;
   options.allowReturnOutsideFunction = options.allowReturnOutsideFunction === true;
   return options;
-}
-
+} // eslint-disable-next-line no-redeclare
 // eslint-disable-next-line no-redeclare
+
+
 function parse(code, opts) {
   var _options$transformOpt, _options$transformOpt2;
 

package/dist/src/transform/SimpleTransform.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -18,6 +18,15 @@ var _SimpleTraverser = require("../traverse/SimpleTraverser");
 
 var _astNodeMutationHelpers = require("./astNodeMutationHelpers");
 
+/**
+ * Transform callback
+ * @param node The node we are visiting
+ * @returns
+ *   - return input node, signals no changes were made will continue to the next node.
+ *   - return new node, the old node will be replaced in the AST. The new node and its
+ *     children are then traversed.
+ *   - return null, signals the node should be deleted from the AST.
+ */
 function setParentPointer(node, parent) {
   if (parent != null) {
     if (Array.isArray(node)) {

package/dist/src/transform/astArrayMutationHelpers.js

@@ -14,7 +14,7 @@ exports.replaceInArray = replaceInArray;
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 function assertArrayBounds(array, index) {

package/dist/src/transform/astNodeMutationHelpers.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -42,10 +42,11 @@ function getParentKey(target, parent, visitorKeys) {
           key
         };
       }
-    } else if (Array.isArray(parent[key])) {
+    } else if (Array.isArray( // $FlowExpectedError[prop-missing]
+    parent[key])) {
       for (let i = 0; i < parent[key].length; i += 1) {
         // $FlowExpectedError[invalid-tuple-index]
-        const current = parent[key][i];
+        const current = parent[key][i]; // $FlowFixMe[invalid-compare]
 
         if (current === target) {
           return {

package/dist/src/traverse/SimpleTraverser.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -80,7 +80,9 @@ class SimpleTraverser {
     const keys = (0, _getVisitorKeys.getVisitorKeys)(node, options.visitorKeys);
 
     for (const key of keys) {
-      const child = node[key];
+      const lookupKey = key;
+      const childAny = node[lookupKey];
+      const child = childAny;
 
       if (Array.isArray(child)) {
         for (let j = 0; j < child.length; ++j) {

package/dist/src/traverse/getVisitorKeys.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @noformat
  */
 'use strict';
@@ -20,12 +20,14 @@ var _ESTreeVisitorKeys = _interopRequireDefault(require("../generated/ESTreeVisi
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 function isNode(thing)
-/*: implies thing is {+[string]: mixed} */
+/*: implies thing is {readonly [string]: unknown} */
 {
   return typeof thing === 'object' && thing != null && typeof thing.type === 'string';
 }
 
-function getVisitorKeys(node, visitorKeys) {
+function getVisitorKeys(node, visitorKeys)
+/*: ReadonlyArray<keyof T> */
+{
   const keys = (visitorKeys != null ? visitorKeys : _ESTreeVisitorKeys.default)[node.type];
 
   if (keys == null) {

package/dist/src/utils/Builders.js

@@ -4,10 +4,10 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
-'use strict';
+'use strict'; // Rely on the mapper to fix up parent relationships.
 
 Object.defineProperty(exports, "__esModule", {
   value: true
@@ -26,7 +26,6 @@ exports.stringLiteral = stringLiteral;
 exports.throwStatement = throwStatement;
 exports.typeofExpression = typeofExpression;
 exports.variableDeclaration = variableDeclaration;
-// Rely on the mapper to fix up parent relationships.
 const EMPTY_PARENT = null;
 exports.EMPTY_PARENT = EMPTY_PARENT;
 

package/dist/src/utils/GenID.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/utils/createSyntaxError.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/utils/isReservedWord.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/utils/mutateESTreeASTForPrettier.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/transform/SimpleTransform.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -18,6 +18,15 @@ var _SimpleTraverser = require("../traverse/SimpleTraverser");
 
 var _astNodeMutationHelpers = require("./astNodeMutationHelpers");
 
+/**
+ * Transform callback
+ * @param node The node we are visiting
+ * @returns
+ *   - return input node, signals no changes were made will continue to the next node.
+ *   - return new node, the old node will be replaced in the AST. The new node and its
+ *     children are then traversed.
+ *   - return null, signals the node should be deleted from the AST.
+ */
 function setParentPointer(node, parent) {
   if (parent != null) {
     if (Array.isArray(node)) {

package/dist/transform/SimpleTransform.js.flow

@@ -31,9 +31,9 @@ import {
  */
 export type TransformCallback = (
   node: ESNode,
-) => ESNode | $ReadOnlyArray<ESNode> | null;
+) => ESNode | ReadonlyArray<ESNode> | null;
 
-export type TransformOptions = $ReadOnly<{
+export type TransformOptions = Readonly<{
   /** The callback function which is called on entering each node. */
   transform: TransformCallback,
 
@@ -42,7 +42,7 @@ export type TransformOptions = $ReadOnly<{
 }>;
 
 function setParentPointer(
-  node: ESNode | $ReadOnlyArray<ESNode>,
+  node: ESNode | ReadonlyArray<ESNode>,
   parent: ?ESNode,
 ): void {
   if (parent != null) {
@@ -75,11 +75,10 @@ export class SimpleTransform {
         // Ensure the parent pointers are correctly set before entering the node.
         setParentPointer(node, parent);
 
-        const resultNode: ESNode | $ReadOnlyArray<ESNode> | null =
+        const resultNode: ESNode | ReadonlyArray<ESNode> | null =
           options.transform(node);
         if (resultNode !== node) {
-          let traversedResultNode: ESNode | $ReadOnlyArray<ESNode> | null =
-            null;
+          let traversedResultNode: ESNode | ReadonlyArray<ESNode> | null = null;
 
           if (resultNode != null) {
             // Ensure the new node has the correct parent pointers before recursing again.
@@ -159,7 +158,7 @@ export class SimpleTransform {
    * @return Either the orginal node if the properties matched the existing node or a new node with
    *         the new properties.
    */
-  static nodeWith<T: ESNode>(
+  static nodeWith<T extends ESNode>(
     node: T,
     overrideProps: Partial<T>,
     visitorKeys?: VisitorKeysType,

package/dist/transform/astArrayMutationHelpers.js

@@ -14,7 +14,7 @@ exports.replaceInArray = replaceInArray;
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 function assertArrayBounds(array, index) {

package/dist/transform/astArrayMutationHelpers.js.flow

@@ -8,7 +8,7 @@
  * @format
  */
 
-function assertArrayBounds<T>(array: $ReadOnlyArray<T>, index: number): void {
+function assertArrayBounds<T>(array: ReadonlyArray<T>, index: number): void {
   if (index < 0 || index >= array.length) {
     throw new Error(
       `Invalid Mutation: Tried to mutate an elements array with an out of bounds index. Index: ${index}, Array Size: ${array.length}`,
@@ -17,8 +17,8 @@ function assertArrayBounds<T>(array: $ReadOnlyArray<T>, index: number): void {
 }
 
 export function arrayIsEqual(
-  a1: $ReadOnlyArray<mixed>,
-  a2: $ReadOnlyArray<mixed>,
+  a1: ReadonlyArray<unknown>,
+  a2: ReadonlyArray<unknown>,
 ): boolean {
   if (a1 === a2) {
     return true;
@@ -38,9 +38,9 @@ export function arrayIsEqual(
 }
 
 export function insertInArray<T>(
-  array: $ReadOnlyArray<T>,
+  array: ReadonlyArray<T>,
   index: number,
-  elements: $ReadOnlyArray<T>,
+  elements: ReadonlyArray<T>,
 ): Array<T> {
   if (index === array.length) {
     // Support the insert at end of array case.
@@ -51,7 +51,7 @@ export function insertInArray<T>(
 }
 
 export function removeFromArray<T>(
-  array: $ReadOnlyArray<T>,
+  array: ReadonlyArray<T>,
   index: number,
 ): Array<T> {
   assertArrayBounds(array, index);
@@ -59,9 +59,9 @@ export function removeFromArray<T>(
 }
 
 export function replaceInArray<T>(
-  array: $ReadOnlyArray<T>,
+  array: ReadonlyArray<T>,
   index: number,
-  elements: $ReadOnlyArray<T>,
+  elements: ReadonlyArray<T>,
 ): Array<T> {
   assertArrayBounds(array, index);
   return array

package/dist/transform/astNodeMutationHelpers.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -42,10 +42,11 @@ function getParentKey(target, parent, visitorKeys) {
           key
         };
       }
-    } else if (Array.isArray(parent[key])) {
+    } else if (Array.isArray( // $FlowExpectedError[prop-missing]
+    parent[key])) {
       for (let i = 0; i < parent[key].length; i += 1) {
         // $FlowExpectedError[invalid-tuple-index]
-        const current = parent[key][i];
+        const current = parent[key][i]; // $FlowFixMe[invalid-compare]
 
         if (current === target) {
           return {