hermes-estree 0.32.1 → 0.33.0

package/dist/traverse/SimpleTraverser.js.flow

@@ -1,133 +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 './getVisitorKeys';
-import type {ESNode} from 'hermes-estree';
-
-import {getVisitorKeys, isNode} from './getVisitorKeys';
-
-export type TraverserCallback = (node: ESNode, parent: ?ESNode) => void;
-export type TraverserOptions = $ReadOnly<{
-  /** The callback function which is called on entering each node. */
-  enter: TraverserCallback,
-  /** The callback function which is called on leaving each node. */
-  leave: TraverserCallback,
-  /** The set of visitor keys to use for traversal. Defaults to the Flow ESTree visitor keys */
-  visitorKeys?: ?VisitorKeysType,
-}>;
-
-/**
- * Can be thrown within the traversal "enter" function to prevent the traverser
- * from traversing the node any further, essentially culling the remainder of the
- * AST branch
- */
-export const SimpleTraverserSkip: Error = new Error();
-/**
- * Can be thrown at any point during the traversal to immediately stop traversal
- * entirely.
- */
-export const SimpleTraverserBreak: Error = new Error();
-
-/**
- * A very simple traverser class to traverse AST trees.
- */
-export class SimpleTraverser {
-  static Break: Error = SimpleTraverserBreak;
-  static Skip: Error = SimpleTraverserSkip;
-
-  /**
-   * Traverse the given AST tree.
-   * @param node The root node to traverse.
-   * @param options The option object.
-   */
-  traverse(node: ESNode, options: TraverserOptions): void {
-    try {
-      this._traverse(node, null, options);
-    } catch (ex) {
-      if (ex === SimpleTraverserBreak) {
-        return;
-      }
-      throw ex;
-    }
-  }
-
-  /**
-   * Traverse the given AST tree recursively.
-   * @param node The current node.
-   * @param parent The parent node.
-   * @private
-   */
-  _traverse(node: ESNode, parent: ?ESNode, options: TraverserOptions): void {
-    if (!isNode(node)) {
-      return;
-    }
-
-    try {
-      options.enter(node, parent);
-    } catch (ex) {
-      if (ex === SimpleTraverserSkip) {
-        return;
-      }
-      this._setErrorContext(ex, node);
-      throw ex;
-    }
-
-    const keys = getVisitorKeys(node, options.visitorKeys);
-    for (const key of keys) {
-      const child: ESNode | $ReadOnlyArray<ESNode> = (node[
-        (key: $FlowFixMe)
-      ]: $FlowFixMe);
-
-      if (Array.isArray(child)) {
-        for (let j = 0; j < child.length; ++j) {
-          this._traverse(child[j], node, options);
-        }
-      } else {
-        this._traverse(child, node, options);
-      }
-    }
-
-    try {
-      options.leave(node, parent);
-    } catch (ex) {
-      if (ex === SimpleTraverserSkip) {
-        return;
-      }
-      this._setErrorContext(ex, node);
-      throw ex;
-    }
-  }
-
-  /**
-   * Set useful contextual information onto the error object.
-   * @param ex The error object.
-   * @param node The current node.
-   * @private
-   */
-  _setErrorContext(ex: Error, node: ESNode): void {
-    // $FlowFixMe[prop-missing]
-    ex.currentNode = {
-      type: node.type,
-      range: node.range,
-      loc: node.loc,
-    };
-  }
-
-  /**
-   * Traverse the given AST tree.
-   * @param node The root node to traverse.
-   * @param options The option object.
-   */
-  static traverse(node: ESNode, options: TraverserOptions) {
-    new SimpleTraverser().traverse(node, options);
-  }
-}

package/dist/traverse/getVisitorKeys.js

@@ -1,37 +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.
- *
- * 
- * @noformat
- */
-'use strict';
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getVisitorKeys = getVisitorKeys;
-exports.isNode = isNode;
-
-var _ESTreeVisitorKeys = _interopRequireDefault(require("../generated/ESTreeVisitorKeys"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-function isNode(thing)
-/*: implies thing is {+[string]: mixed} */
-{
-  return typeof thing === 'object' && thing != null && typeof thing.type === 'string';
-}
-
-function getVisitorKeys(node, visitorKeys) {
-  const keys = (visitorKeys != null ? visitorKeys : _ESTreeVisitorKeys.default)[node.type];
-
-  if (keys == null) {
-    throw new Error(`No visitor keys found for node type "${node.type}".`);
-  } // $FlowExpectedError[prop-missing]
-
-
-  return keys;
-}

package/dist/traverse/getVisitorKeys.js.flow

@@ -1,36 +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
- * @noformat
- */
-
-'use strict';
-
-import type {ESNode} from 'hermes-estree';
-import type {VisitorKeys as VisitorKeysType} from '../generated/ESTreeVisitorKeys';
-
-import FlowVisitorKeys from '../generated/ESTreeVisitorKeys';
-
-export function isNode(thing: mixed) /*: implies thing is {+[string]: mixed} */ {
-  return (
-    typeof thing === 'object' && thing != null && typeof thing.type === 'string'
-  );
-}
-
-export type {VisitorKeysType};
-export function getVisitorKeys<T: ESNode>(
-  node: T,
-  visitorKeys?: ?VisitorKeysType,
-): $ReadOnlyArray<$Keys<T>> {
-  const keys = (visitorKeys ?? FlowVisitorKeys)[node.type];
-  if (keys == null) {
-    throw new Error(`No visitor keys found for node type "${node.type}".`);
-  }
-
-  // $FlowExpectedError[prop-missing]
-  return keys;
-}

package/dist/utils/Builders.js

@@ -1,191 +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.EMPTY_PARENT = void 0;
-exports.callExpression = callExpression;
-exports.conjunction = conjunction;
-exports.createDefaultPosition = createDefaultPosition;
-exports.disjunction = disjunction;
-exports.etc = etc;
-exports.ident = ident;
-exports.iife = iife;
-exports.nullLiteral = nullLiteral;
-exports.numberLiteral = numberLiteral;
-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;
-
-function createDefaultPosition() {
-  return {
-    line: 1,
-    column: 0
-  };
-}
-
-function etc({
-  loc,
-  range,
-  parent
-} = {}) {
-  return {
-    loc: {
-      start: (loc == null ? void 0 : loc.start) != null ? loc.start : createDefaultPosition(),
-      end: (loc == null ? void 0 : loc.end) != null ? loc.end : createDefaultPosition()
-    },
-    range: range != null ? range : [0, 0],
-    parent: parent != null ? parent : EMPTY_PARENT
-  };
-}
-
-function ident(name, info) {
-  return {
-    type: 'Identifier',
-    name,
-    optional: false,
-    typeAnnotation: null,
-    ...etc(info)
-  };
-}
-
-function stringLiteral(value, info) {
-  return {
-    type: 'Literal',
-    value,
-    raw: `"${value}"`,
-    literalType: 'string',
-    ...etc(info)
-  };
-}
-
-function numberLiteral(value, info) {
-  return {
-    type: 'Literal',
-    value,
-    raw: String(value),
-    literalType: 'numeric',
-    ...etc(info)
-  };
-}
-
-function nullLiteral(info) {
-  return {
-    type: 'Literal',
-    value: null,
-    raw: 'null',
-    literalType: 'null',
-    ...etc(info)
-  };
-}
-
-function conjunction(tests) {
-  if (tests.length === 0) {
-    throw new Error('Must have at least one test.');
-  }
-
-  return tests.reduce((acc, test) => ({
-    type: 'LogicalExpression',
-    left: acc,
-    right: test,
-    operator: '&&',
-    ...etc()
-  }));
-}
-
-function disjunction(tests) {
-  if (tests.length === 0) {
-    throw new Error('Must have at least one test.');
-  }
-
-  return tests.reduce((acc, test) => ({
-    type: 'LogicalExpression',
-    left: acc,
-    right: test,
-    operator: '||',
-    ...etc()
-  }));
-}
-
-function variableDeclaration(kind, id, init, info) {
-  return {
-    type: 'VariableDeclaration',
-    kind,
-    declarations: [{
-      type: 'VariableDeclarator',
-      init,
-      id,
-      ...etc(),
-      parent: EMPTY_PARENT
-    }],
-    ...etc(info)
-  };
-}
-
-function callExpression(callee, args, info) {
-  return {
-    type: 'CallExpression',
-    callee,
-    arguments: args,
-    typeArguments: null,
-    optional: false,
-    ...etc(info)
-  };
-}
-
-function throwStatement(arg, info) {
-  return {
-    type: 'ThrowStatement',
-    argument: callExpression(ident('Error'), [arg]),
-    ...etc(info)
-  };
-}
-
-function iife(statements, params = [], args = []) {
-  const callee = {
-    type: 'ArrowFunctionExpression',
-    params,
-    expression: false,
-    async: false,
-    predicate: null,
-    returnType: null,
-    typeParameters: null,
-    id: null,
-    body: {
-      type: 'BlockStatement',
-      body: statements,
-      ...etc()
-    },
-    ...etc()
-  };
-  return callExpression(callee, args);
-}
-
-function typeofExpression(arg, kind) {
-  return {
-    type: 'BinaryExpression',
-    left: {
-      type: 'UnaryExpression',
-      operator: 'typeof',
-      argument: arg,
-      prefix: true,
-      ...etc()
-    },
-    right: stringLiteral(kind),
-    operator: '===',
-    ...etc()
-  };
-}

package/dist/utils/Builders.js.flow

@@ -1,218 +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 {
-  ArrowFunctionExpression,
-  BinaryExpression,
-  BindingName,
-  CallExpression,
-  ESNode,
-  Expression,
-  Identifier,
-  LogicalExpression,
-  NullLiteral,
-  NumericLiteral,
-  Position,
-  Range,
-  SourceLocation,
-  SpreadElement,
-  Statement,
-  StringLiteral,
-  Super,
-  ThrowStatement,
-  VariableDeclaration,
-} from 'hermes-estree';
-
-// Rely on the mapper to fix up parent relationships.
-export const EMPTY_PARENT: $FlowFixMe = null;
-
-export function createDefaultPosition(): Position {
-  return {
-    line: 1,
-    column: 0,
-  };
-}
-
-export type Etc = {
-  parent?: ESNode,
-  loc?: SourceLocation,
-  range?: Range,
-};
-
-export function etc({loc, range, parent}: Etc = {}): {
-  parent: ESNode,
-  loc: SourceLocation,
-  range: Range,
-} {
-  return {
-    loc: {
-      start: loc?.start != null ? loc.start : createDefaultPosition(),
-      end: loc?.end != null ? loc.end : createDefaultPosition(),
-    },
-    range: range ?? [0, 0],
-    parent: parent ?? EMPTY_PARENT,
-  };
-}
-
-export function ident(name: string, info?: Etc): Identifier {
-  return {
-    type: 'Identifier',
-    name,
-    optional: false,
-    typeAnnotation: null,
-    ...etc(info),
-  };
-}
-
-export function stringLiteral(value: string, info?: Etc): StringLiteral {
-  return {
-    type: 'Literal',
-    value,
-    raw: `"${value}"`,
-    literalType: 'string',
-    ...etc(info),
-  };
-}
-
-export function numberLiteral(value: number, info?: Etc): NumericLiteral {
-  return {
-    type: 'Literal',
-    value,
-    raw: String(value),
-    literalType: 'numeric',
-    ...etc(info),
-  };
-}
-
-export function nullLiteral(info?: Etc): NullLiteral {
-  return {
-    type: 'Literal',
-    value: null,
-    raw: 'null',
-    literalType: 'null',
-    ...etc(info),
-  };
-}
-
-export function conjunction(tests: $ReadOnlyArray<Expression>): Expression {
-  if (tests.length === 0) {
-    throw new Error('Must have at least one test.');
-  }
-  return tests.reduce((acc, test): LogicalExpression => ({
-    type: 'LogicalExpression',
-    left: acc,
-    right: test,
-    operator: '&&',
-    ...etc(),
-  }));
-}
-
-export function disjunction(tests: $ReadOnlyArray<Expression>): Expression {
-  if (tests.length === 0) {
-    throw new Error('Must have at least one test.');
-  }
-  return tests.reduce((acc, test): LogicalExpression => ({
-    type: 'LogicalExpression',
-    left: acc,
-    right: test,
-    operator: '||',
-    ...etc(),
-  }));
-}
-
-export function variableDeclaration(
-  kind: VariableDeclaration['kind'],
-  id: BindingName,
-  init: Expression,
-  info?: Etc,
-): VariableDeclaration {
-  return {
-    type: 'VariableDeclaration',
-    kind,
-    declarations: [
-      {
-        type: 'VariableDeclarator',
-        init,
-        id,
-        ...etc(),
-        parent: EMPTY_PARENT,
-      },
-    ],
-    ...etc(info),
-  };
-}
-
-export function callExpression(
-  callee: Expression | Super,
-  args: $ReadOnlyArray<Expression | SpreadElement>,
-  info?: Etc,
-): CallExpression {
-  return {
-    type: 'CallExpression',
-    callee,
-    arguments: args,
-    typeArguments: null,
-    optional: false,
-    ...etc(info),
-  };
-}
-
-export function throwStatement(arg: Expression, info?: Etc): ThrowStatement {
-  return {
-    type: 'ThrowStatement',
-    argument: callExpression(ident('Error'), [arg]),
-    ...etc(info),
-  };
-}
-
-export function iife(
-  statements: $ReadOnlyArray<Statement>,
-  params: $ReadOnlyArray<BindingName> = [],
-  args: $ReadOnlyArray<Expression> = [],
-): CallExpression {
-  const callee: ArrowFunctionExpression = {
-    type: 'ArrowFunctionExpression',
-    params,
-    expression: false,
-    async: false,
-    predicate: null,
-    returnType: null,
-    typeParameters: null,
-    id: null,
-    body: {
-      type: 'BlockStatement',
-      body: statements,
-      ...etc(),
-    },
-    ...etc(),
-  };
-  return callExpression(callee, args);
-}
-
-export function typeofExpression(
-  arg: Expression,
-  kind: string,
-): BinaryExpression {
-  return {
-    type: 'BinaryExpression',
-    left: {
-      type: 'UnaryExpression',
-      operator: 'typeof',
-      argument: arg,
-      prefix: true,
-      ...etc(),
-    },
-    right: stringLiteral(kind),
-    operator: '===',
-    ...etc(),
-  };
-}

package/dist/utils/GenID.js

@@ -1,41 +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.createGenID = createGenID;
-const genPrefix = '$$gen$';
-
-function createGenID(uniqueTransformPrefix) {
-  let genN = 0;
-  const used = new Set();
-  return {
-    genID() {
-      let name;
-
-      do {
-        name = `${genPrefix}${uniqueTransformPrefix}${genN}`;
-        genN++;
-      } while (used.has(name));
-
-      used.add(name);
-      return name;
-    },
-
-    addUsage(name) {
-      if (name.startsWith(genPrefix)) {
-        used.add(name);
-      }
-    }
-
-  };
-}

package/dist/utils/GenID.js.flow

@@ -1,38 +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';
-
-const genPrefix = '$$gen$';
-
-export function createGenID(uniqueTransformPrefix: string): {
-  genID(): string,
-  addUsage(string): void,
-} {
-  let genN: number = 0;
-  const used = new Set<string>();
-
-  return {
-    genID(): string {
-      let name;
-      do {
-        name = `${genPrefix}${uniqueTransformPrefix}${genN}`;
-        genN++;
-      } while (used.has(name));
-      used.add(name);
-      return name;
-    },
-    addUsage(name: string): void {
-      if (name.startsWith(genPrefix)) {
-        used.add(name);
-      }
-    },
-  };
-}

package/dist/utils/createSyntaxError.js

@@ -1,25 +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.createSyntaxError = createSyntaxError;
-
-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;
-}