hermes-estree 0.10.1 → 0.11.1

package/dist/getModuleDocblock.js

@@ -1,112 +0,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
- */
-'use strict';
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getModuleDocblock = getModuleDocblock;
-exports.parseDocblockString = parseDocblockString;
-const DIRECTIVE_REGEX = /^\s*@([a-zA-Z0-9_-]+)( +.+)?$/;
-
-function parseDocblockString(docblock) {
-  const directiveLines = docblock.split('\n') // remove the leading " *" from each line
-  .map(line => line.trimStart().replace(/^\* ?/, '').trim()).filter(line => line.startsWith('@'));
-  const directives = // $FlowExpectedError[incompatible-type] - flow types  this return as {...}
-  Object.create(null);
-
-  for (const line of directiveLines) {
-    var _match$;
-
-    const match = DIRECTIVE_REGEX.exec(line);
-
-    if (match == null) {
-      continue;
-    }
-
-    const name = match[1]; // explicitly use an empty string if there's no value
-    // this way the array length tracks how many instances of the directive there was
-
-    const value = ((_match$ = match[2]) != null ? _match$ : '').trim();
-
-    if (directives[name]) {
-      directives[name].push(value);
-    } else {
-      directives[name] = [value];
-    }
-  }
-
-  return directives;
-}
-
-function getModuleDocblock(hermesProgram) {
-  const docblockNode = (() => {
-    if (hermesProgram.type !== 'Program') {
-      return null;
-    } // $FlowExpectedError[incompatible-type] - escape out of the unsafe hermes types
-
-
-    const program = hermesProgram;
-
-    if (program.comments.length === 0) {
-      return null;
-    }
-
-    const firstComment = (() => {
-      const first = program.comments[0];
-
-      if (first.type === 'Block') {
-        return first;
-      }
-
-      if (program.comments.length === 1) {
-        return null;
-      } // ESLint will always strip out the shebang comment from the code before passing it to the parser
-      // https://github.com/eslint/eslint/blob/21d647904dc30f9484b22acdd9243a6d0ecfba38/lib/linter/linter.js#L779
-      // this means that we're forced to parse it as a line comment :(
-      // this hacks around it by selecting the second comment in this case
-
-
-      const second = program.comments[1];
-
-      if (first.type === 'Line' && first.range[0] === 0 && second.type === 'Block') {
-        return second;
-      }
-
-      return null;
-    })();
-
-    if (firstComment == null) {
-      return null;
-    }
-    /*
-    Handle cases like this where the comment isn't actually the first thing in the code:
-    ```
-    const x = 1; /* docblock *./
-    ```
-    */
-
-
-    if (program.body.length > 0 && program.body[0].range[0] < firstComment.range[0]) {
-      return null;
-    }
-
-    return firstComment;
-  })();
-
-  if (docblockNode == null) {
-    return null;
-  }
-
-  return {
-    directives: parseDocblockString(docblockNode.value),
-    comment: docblockNode
-  };
-}

package/dist/getModuleDocblock.js.flow

@@ -1,118 +0,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.
- *
- * @flow strict
- * @format
- */
-
-'use strict';
-
-import type {HermesNode} from './HermesAST';
-import type {DocblockDirectives, Program} from 'hermes-estree';
-
-const DIRECTIVE_REGEX = /^\s*@([a-zA-Z0-9_-]+)( +.+)?$/;
-
-export function parseDocblockString(docblock: string): DocblockDirectives {
-  const directiveLines = docblock
-    .split('\n')
-    // remove the leading " *" from each line
-    .map(line => line.trimStart().replace(/^\* ?/, '').trim())
-    .filter(line => line.startsWith('@'));
-
-  const directives: {
-    [string]: Array<string>,
-  } =
-    // $FlowExpectedError[incompatible-type] - flow types  this return as {...}
-    Object.create(null);
-
-  for (const line of directiveLines) {
-    const match = DIRECTIVE_REGEX.exec(line);
-    if (match == null) {
-      continue;
-    }
-    const name = match[1];
-    // explicitly use an empty string if there's no value
-    // this way the array length tracks how many instances of the directive there was
-    const value = (match[2] ?? '').trim();
-    if (directives[name]) {
-      directives[name].push(value);
-    } else {
-      directives[name] = [value];
-    }
-  }
-
-  return directives;
-}
-
-export function getModuleDocblock(
-  hermesProgram: HermesNode,
-): Program['docblock'] {
-  const docblockNode = (() => {
-    if (hermesProgram.type !== 'Program') {
-      return null;
-    }
-
-    // $FlowExpectedError[incompatible-type] - escape out of the unsafe hermes types
-    const program: Program = hermesProgram;
-
-    if (program.comments.length === 0) {
-      return null;
-    }
-
-    const firstComment = (() => {
-      const first = program.comments[0];
-      if (first.type === 'Block') {
-        return first;
-      }
-
-      if (program.comments.length === 1) {
-        return null;
-      }
-
-      // ESLint will always strip out the shebang comment from the code before passing it to the parser
-      // https://github.com/eslint/eslint/blob/21d647904dc30f9484b22acdd9243a6d0ecfba38/lib/linter/linter.js#L779
-      // this means that we're forced to parse it as a line comment :(
-      // this hacks around it by selecting the second comment in this case
-      const second = program.comments[1];
-      if (
-        first.type === 'Line' &&
-        first.range[0] === 0 &&
-        second.type === 'Block'
-      ) {
-        return second;
-      }
-
-      return null;
-    })();
-    if (firstComment == null) {
-      return null;
-    }
-
-    /*
-    Handle cases like this where the comment isn't actually the first thing in the code:
-    ```
-    const x = 1; /* docblock *./
-    ```
-    */
-    if (
-      program.body.length > 0 &&
-      program.body[0].range[0] < firstComment.range[0]
-    ) {
-      return null;
-    }
-
-    return firstComment;
-  })();
-
-  if (docblockNode == null) {
-    return null;
-  }
-
-  return {
-    directives: parseDocblockString(docblockNode.value),
-    comment: docblockNode,
-  };
-}

package/dist/transform/SimpleTransform.js

@@ -1,92 +0,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
- */
-'use strict';
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.SimpleTransform = void 0;
-
-var _SimpleTraverser = require("../traverse/SimpleTraverser");
-
-var _astNodeMutationHelpers = require("./astNodeMutationHelpers");
-
-/**
- * A simple class to recursively tranform AST trees.
- */
-class SimpleTransform {
-  /**
-   * Transform the given AST tree.
-   * @param rootNode The root node to traverse.
-   * @param options The option object.
-   * @return The modified rootNode or a new node if the rootNode was transformed directly.
-   */
-  transform(rootNode, options) {
-    let resultRootNode = rootNode;
-
-    _SimpleTraverser.SimpleTraverser.traverse(rootNode, {
-      enter: (node, parent) => {
-        const resultNode = options.transform(node);
-
-        if (resultNode !== node) {
-          const traversedResultNode = resultNode != null ? this.transform(resultNode, options) : null;
-
-          if (parent == null) {
-            if (node !== rootNode) {
-              throw new Error('SimpleTransform infra error: Parent not set on non root node, this should not be possible');
-            }
-
-            resultRootNode = traversedResultNode;
-          } else if (traversedResultNode == null) {
-            (0, _astNodeMutationHelpers.removeNodeOnParent)(node, parent);
-          } else {
-            (0, _astNodeMutationHelpers.replaceNodeOnParent)(node, parent, traversedResultNode);
-          }
-
-          throw _SimpleTraverser.SimpleTraverser.Skip;
-        }
-      },
-
-      leave(_node) {}
-
-    });
-
-    return resultRootNode;
-  }
-  /**
-   * Transform the given AST tree.
-   * @param node The root node to traverse.
-   * @param options The option object.
-   */
-
-
-  static transform(node, options) {
-    return new SimpleTransform().transform(node, options);
-  }
-  /**
-   * Return a new AST node with the given properties overrided if needed.
-   *
-   * This function takes care to only create new nodes when needed. Referential equality of nodes
-   * is important as its used to know if a node should be re-traversed.
-   *
-   * @param node The base AST node.
-   * @param overrideProps New properties to apply to the node.
-   * @return Either the orginal node if the properties matched the existing node or a new node with
-   *         the new properties.
-   */
-
-
-  static nodeWith(node, overrideProps) {
-    return (0, _astNodeMutationHelpers.nodeWith)(node, overrideProps);
-  }
-
-}
-
-exports.SimpleTransform = SimpleTransform;

package/dist/transform/SimpleTransform.js.flow

@@ -1,104 +0,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.
- *
- * @flow strict
- * @format
- */
-
-'use strict';
-
-import type {VisitorKeysType} from '../traverse/getVisitorKeys';
-import type {ESNode} from 'hermes-estree';
-
-import {SimpleTraverser} from '../traverse/SimpleTraverser';
-import {
-  nodeWith,
-  removeNodeOnParent,
-  replaceNodeOnParent,
-} from './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.
- */
-export type TransformCallback = (node: ESNode) => ESNode | null;
-
-export type TransformOptions = $ReadOnly<{
-  /** The callback function which is called on entering each node. */
-  transform: TransformCallback,
-
-  /** The set of visitor keys to use for traversal. Defaults to the Flow ESTree visitor keys */
-  visitorKeys?: ?VisitorKeysType,
-}>;
-
-/**
- * A simple class to recursively tranform AST trees.
- */
-export class SimpleTransform {
-  /**
-   * Transform the given AST tree.
-   * @param rootNode The root node to traverse.
-   * @param options The option object.
-   * @return The modified rootNode or a new node if the rootNode was transformed directly.
-   */
-  transform(rootNode: ESNode, options: TransformOptions): ESNode | null {
-    let resultRootNode: ESNode | null = rootNode;
-    SimpleTraverser.traverse(rootNode, {
-      enter: (node: ESNode, parent: ?ESNode) => {
-        const resultNode = options.transform(node);
-        if (resultNode !== node) {
-          const traversedResultNode =
-            resultNode != null ? this.transform(resultNode, options) : null;
-          if (parent == null) {
-            if (node !== rootNode) {
-              throw new Error(
-                'SimpleTransform infra error: Parent not set on non root node, this should not be possible',
-              );
-            }
-            resultRootNode = traversedResultNode;
-          } else if (traversedResultNode == null) {
-            removeNodeOnParent(node, parent);
-          } else {
-            replaceNodeOnParent(node, parent, traversedResultNode);
-          }
-
-          throw SimpleTraverser.Skip;
-        }
-      },
-      leave(_node: ESNode) {},
-    });
-    return resultRootNode;
-  }
-
-  /**
-   * Transform the given AST tree.
-   * @param node The root node to traverse.
-   * @param options The option object.
-   */
-  static transform(node: ESNode, options: TransformOptions): ESNode | null {
-    return new SimpleTransform().transform(node, options);
-  }
-
-  /**
-   * Return a new AST node with the given properties overrided if needed.
-   *
-   * This function takes care to only create new nodes when needed. Referential equality of nodes
-   * is important as its used to know if a node should be re-traversed.
-   *
-   * @param node The base AST node.
-   * @param overrideProps New properties to apply to the node.
-   * @return Either the orginal node if the properties matched the existing node or a new node with
-   *         the new properties.
-   */
-  static nodeWith<T: ESNode>(node: T, overrideProps: Partial<T>): T {
-    return nodeWith<T>(node, overrideProps);
-  }
-}

package/dist/transform/astArrayMutationHelpers.js

@@ -1,62 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.arrayIsEqual = arrayIsEqual;
-exports.insertInArray = insertInArray;
-exports.removeFromArray = removeFromArray;
-exports.replaceInArray = replaceInArray;
-
-/**
- * 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 assertArrayBounds(array, index) {
-  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}`);
-  }
-}
-
-function arrayIsEqual(a1, a2) {
-  if (a1 === a2) {
-    return true;
-  }
-
-  if (a1.length !== a2.length) {
-    return false;
-  }
-
-  for (let i = 0; i < a1.length; i++) {
-    if (a1[i] !== a2[i]) {
-      return false;
-    }
-  }
-
-  return true;
-}
-
-function insertInArray(array, index, elements) {
-  if (index === array.length) {
-    // Support the insert at end of array case.
-    return array.concat(elements);
-  }
-
-  assertArrayBounds(array, index);
-  return array.slice(0, index).concat(elements).concat(array.slice(index));
-}
-
-function removeFromArray(array, index) {
-  assertArrayBounds(array, index);
-  return [...array.slice(0, index), ...array.slice(index + 1)];
-}
-
-function replaceInArray(array, index, elements) {
-  assertArrayBounds(array, index);
-  return array.slice(0, index).concat(elements).concat(array.slice(index + 1));
-}

package/dist/transform/astArrayMutationHelpers.js.flow

@@ -1,71 +0,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.
- *
- * @flow strict
- * @format
- */
-
-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}`,
-    );
-  }
-}
-
-export function arrayIsEqual(
-  a1: $ReadOnlyArray<mixed>,
-  a2: $ReadOnlyArray<mixed>,
-): boolean {
-  if (a1 === a2) {
-    return true;
-  }
-
-  if (a1.length !== a2.length) {
-    return false;
-  }
-
-  for (let i = 0; i < a1.length; i++) {
-    if (a1[i] !== a2[i]) {
-      return false;
-    }
-  }
-
-  return true;
-}
-
-export function insertInArray<T>(
-  array: $ReadOnlyArray<T>,
-  index: number,
-  elements: $ReadOnlyArray<T>,
-): Array<T> {
-  if (index === array.length) {
-    // Support the insert at end of array case.
-    return array.concat(elements);
-  }
-  assertArrayBounds(array, index);
-  return array.slice(0, index).concat(elements).concat(array.slice(index));
-}
-
-export function removeFromArray<T>(
-  array: $ReadOnlyArray<T>,
-  index: number,
-): Array<T> {
-  assertArrayBounds(array, index);
-  return [...array.slice(0, index), ...array.slice(index + 1)];
-}
-
-export function replaceInArray<T>(
-  array: $ReadOnlyArray<T>,
-  index: number,
-  elements: $ReadOnlyArray<T>,
-): Array<T> {
-  assertArrayBounds(array, index);
-  return array
-    .slice(0, index)
-    .concat(elements)
-    .concat(array.slice(index + 1));
-}