hermes-estree 0.32.1 → 0.33.0

package/dist/generated/ParserVisitorKeys.js.flow

@@ -1,17 +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
- */
-
-declare export var NODE_CHILD: 'Node';
-declare export var NODE_LIST_CHILD: 'NodeList';
-declare export var HERMES_AST_VISITOR_KEYS: $ReadOnly<{
-  [string]: $ReadOnly<{
-    [string]: 'Node' | 'NodeList',
-  }>,
-}>;

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/src/HermesASTAdapter.js

@@ -1,192 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-
-var _ParserVisitorKeys = require("./generated/ParserVisitorKeys");
-
-/**
- * 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
- */
-
-/**
- * The base class for transforming the Hermes AST to the desired output format.
- * Extended by concrete adapters which output an ESTree or Babel AST.
- */
-class HermesASTAdapter {
-  constructor(options) {
-    this.sourceFilename = void 0;
-    this.sourceType = void 0;
-    this.sourceFilename = options.sourceFilename;
-    this.sourceType = options.sourceType;
-  }
-  /**
-   * Transform the input Hermes AST to the desired output format.
-   * This modifies the input AST in place instead of constructing a new AST.
-   */
-
-
-  transform(program) {
-    // Comments are not traversed via visitor keys
-    const comments = program.comments;
-
-    for (let i = 0; i < comments.length; i++) {
-      const comment = comments[i];
-      this.fixSourceLocation(comment);
-      comments[i] = this.mapComment(comment);
-    } // The first comment may be an interpreter directive and is stored directly on the program node
-
-
-    program.interpreter = comments.length > 0 && comments[0].type === 'InterpreterDirective' ? comments.shift() : null; // Tokens are not traversed via visitor keys
-
-    const tokens = program.tokens;
-
-    if (tokens) {
-      for (let i = 0; i < tokens.length; i++) {
-        this.fixSourceLocation(tokens[i]);
-      }
-    }
-
-    const resultNode = this.mapNode(program);
-
-    if (resultNode.type !== 'Program') {
-      throw new Error(`HermesToESTreeAdapter: Must return a Program node, instead of "${resultNode.type}". `);
-    } // $FlowExpectedError[incompatible-type] We know this is a program at this point.
-
-
-    return resultNode;
-  }
-  /**
-   * Transform a Hermes AST node to the output AST format.
-   *
-   * This may modify the input node in-place and return that same node, or a completely
-   * new node may be constructed and returned. Overriden in child classes.
-   */
-
-
-  mapNode(_node) {
-    throw new Error('Implemented in subclasses');
-  }
-
-  mapNodeDefault(node) {
-    const visitorKeys = _ParserVisitorKeys.HERMES_AST_VISITOR_KEYS[node.type];
-
-    for (const key in visitorKeys) {
-      const childType = visitorKeys[key];
-
-      if (childType === _ParserVisitorKeys.NODE_CHILD) {
-        const child = node[key];
-
-        if (child != null) {
-          node[key] = this.mapNode(child);
-        }
-      } else if (childType === _ParserVisitorKeys.NODE_LIST_CHILD) {
-        const children = node[key];
-
-        for (let i = 0; i < children.length; i++) {
-          const child = children[i];
-
-          if (child != null) {
-            children[i] = this.mapNode(child);
-          }
-        }
-      }
-    }
-
-    return node;
-  }
-  /**
-   * Update the source location for this node depending on the output AST format.
-   * This can modify the input node in-place. Overriden in child classes.
-   */
-
-
-  fixSourceLocation(_node) {
-    throw new Error('Implemented in subclasses');
-  }
-
-  getSourceType() {
-    var _this$sourceType;
-
-    return (_this$sourceType = this.sourceType) != null ? _this$sourceType : 'script';
-  }
-
-  setModuleSourceType() {
-    if (this.sourceType == null) {
-      this.sourceType = 'module';
-    }
-  }
-
-  mapComment(node) {
-    return node;
-  }
-
-  mapEmpty(_node) {
-    // $FlowExpectedError[incompatible-type]
-    return null;
-  }
-
-  mapImportDeclaration(node) {
-    if (node.importKind === 'value') {
-      this.setModuleSourceType();
-    }
-
-    return this.mapNodeDefault(node);
-  }
-
-  mapImportSpecifier(node) {
-    if (node.importKind === 'value') {
-      node.importKind = null;
-    }
-
-    return this.mapNodeDefault(node);
-  }
-
-  mapExportDefaultDeclaration(node) {
-    this.setModuleSourceType();
-    return this.mapNodeDefault(node);
-  }
-
-  mapExportNamedDeclaration(node) {
-    if (node.exportKind === 'value') {
-      this.setModuleSourceType();
-    }
-
-    return this.mapNodeDefault(node);
-  }
-
-  mapExportAllDeclaration(node) {
-    if (node.exportKind === 'value') {
-      this.setModuleSourceType();
-    }
-
-    return this.mapNodeDefault(node);
-  }
-
-  formatError(node, message) {
-    return `${message} (${node.loc.start.line}:${node.loc.start.column})`;
-  }
-
-  getBigIntLiteralValue(bigintString) {
-    const bigint = bigintString // estree spec is to not have a trailing `n` on this property
-    // https://github.com/estree/estree/blob/db962bb417a97effcfe9892f87fbb93c81a68584/es2020.md#bigintliteral
-    .replace(/n$/, '') // `BigInt` doesn't accept numeric separator and `bigint` property should not include numeric separator
-    .replaceAll('_', '');
-    return {
-      bigint,
-      // coerce the string to a bigint value if supported by the environment
-      value: typeof BigInt === 'function' ? BigInt(bigint) : null
-    };
-  }
-
-}
-
-exports.default = HermesASTAdapter;

package/dist/src/HermesParser.js

@@ -1,108 +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.parse = parse;
-
-var _HermesParserDeserializer = _interopRequireDefault(require("./HermesParserDeserializer"));
-
-var _HermesParserWASM = _interopRequireDefault(require("./HermesParserWASM"));
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-let HermesParserWASM;
-let hermesParse;
-let hermesParseResult_free;
-let hermesParseResult_getError;
-let hermesParseResult_getErrorLine;
-let hermesParseResult_getErrorColumn;
-let hermesParseResult_getProgramBuffer;
-let hermesParseResult_getPositionBuffer;
-let hermesParseResult_getPositionBufferSize;
-/**
- * Init the WASM wrapper code generated by `emscripten` to preparse the
- * HermesParser WASM code.
- */
-
-function initHermesParserWASM() {
-  if (HermesParserWASM != null) {
-    return;
-  }
-
-  HermesParserWASM = (0, _HermesParserWASM.default)({
-    /**
-     * The emscripten version of `quit` unconditionally assigns the `status` to
-     * `process.exitCode` which overrides any pre-existing code that has been
-     * set, even if it is non zero. For our use case we never want an
-     * `exitCode` to be set so this override removes that functionality.
-     */
-    quit(_status, toThrow) {
-      throw toThrow;
-    }
-
-  });
-  hermesParse = HermesParserWASM.cwrap('hermesParse', 'number', ['number', 'number', 'number', 'number', 'number', 'number', 'number']);
-  hermesParseResult_free = HermesParserWASM.cwrap('hermesParseResult_free', 'void', ['number']);
-  hermesParseResult_getError = HermesParserWASM.cwrap('hermesParseResult_getError', 'string', ['number']);
-  hermesParseResult_getErrorLine = HermesParserWASM.cwrap('hermesParseResult_getErrorLine', 'number', ['number']);
-  hermesParseResult_getErrorColumn = HermesParserWASM.cwrap('hermesParseResult_getErrorColumn', 'number', ['number']);
-  hermesParseResult_getProgramBuffer = HermesParserWASM.cwrap('hermesParseResult_getProgramBuffer', 'number', ['number']);
-  hermesParseResult_getPositionBuffer = HermesParserWASM.cwrap('hermesParseResult_getPositionBuffer', 'number', ['number']);
-  hermesParseResult_getPositionBufferSize = HermesParserWASM.cwrap('hermesParseResult_getPositionBufferSize', 'number', ['number']);
-} // Copy a string into the WASM heap and null-terminate
-
-
-function copyToHeap(buffer, addr) {
-  HermesParserWASM.HEAP8.set(buffer, addr);
-  HermesParserWASM.HEAP8[addr + buffer.length] = 0;
-}
-
-function parse(source, options) {
-  initHermesParserWASM(); // Allocate space on heap for source text
-
-  const sourceBuffer = Buffer.from(source, 'utf8');
-
-  const sourceAddr = HermesParserWASM._malloc(sourceBuffer.length + 1);
-
-  if (!sourceAddr) {
-    throw new Error('Parser out of memory');
-  }
-
-  try {
-    // Copy source text onto WASM heap
-    copyToHeap(sourceBuffer, sourceAddr);
-    const parseResult = hermesParse(sourceAddr, sourceBuffer.length + 1, options.flow === 'detect', options.enableExperimentalComponentSyntax, options.enableExperimentalFlowMatchSyntax, options.tokens, options.allowReturnOutsideFunction);
-
-    try {
-      // Extract and throw error from parse result if parsing failed
-      const err = hermesParseResult_getError(parseResult);
-
-      if (err) {
-        const syntaxError = new SyntaxError(err); // $FlowExpectedError[prop-missing]
-
-        syntaxError.loc = {
-          line: hermesParseResult_getErrorLine(parseResult),
-          column: hermesParseResult_getErrorColumn(parseResult)
-        };
-        throw syntaxError;
-      }
-
-      const deserializer = new _HermesParserDeserializer.default(hermesParseResult_getProgramBuffer(parseResult), hermesParseResult_getPositionBuffer(parseResult), hermesParseResult_getPositionBufferSize(parseResult), HermesParserWASM, options);
-      return deserializer.deserialize();
-    } finally {
-      hermesParseResult_free(parseResult);
-    }
-  } finally {
-    HermesParserWASM._free(sourceAddr);
-  }
-}

package/dist/src/HermesParserDecodeUTF8String.js

@@ -1,68 +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';
-/**
- * Decode a UTF-8 encoded string from Hermes with a known length.
- * Based on Emscripten's UTF8ToString with the following differences:
- * - Always reads all bytes up to the given length, including null bytes. This
- *   means that we can decode strings that contain null bytes in the middle.
- * - Allow UTF-8 encoded code points that are part of a surrogate pair, even though
- *   this is technically invalid UTF-8 that UTF8ToString would convert to 0xfffd.
- */
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = HermesParserDecodeUTF8String;
-
-function HermesParserDecodeUTF8String(ptrIn, length, heap) {
-  let ptr = ptrIn;
-  const endPtr = ptr + length;
-  let str = '';
-
-  while (ptr < endPtr) {
-    // ASCII characters fit in single byte code point
-    let u0 = heap[ptr++];
-
-    if (!(u0 & 0x80)) {
-      str += String.fromCharCode(u0);
-      continue;
-    } // Two byte code point
-
-
-    const u1 = heap[ptr++] & 0x3f;
-
-    if ((u0 & 0xe0) === 0xc0) {
-      str += String.fromCharCode((u0 & 0x1f) << 6 | u1);
-      continue;
-    }
-
-    const u2 = heap[ptr++] & 0x3f;
-
-    if ((u0 & 0xf0) === 0xe0) {
-      // Three byte code point
-      u0 = (u0 & 0x0f) << 12 | u1 << 6 | u2;
-    } else {
-      // Four byte code point
-      u0 = (u0 & 0x07) << 18 | u1 << 12 | u2 << 6 | heap[ptr++] & 0x3f;
-    }
-
-    if (u0 < 0x10000) {
-      // Code point fits into a single UTF-16 code unit
-      str += String.fromCharCode(u0);
-    } else {
-      // Code point does not fit into single UTF-16 code unit so convert to surrogate pair
-      u0 -= 0x10000;
-      str += String.fromCharCode(0xd800 | u0 >> 10, 0xdc00 | u0 & 0x3ff);
-    }
-  }
-
-  return str;
-}