hermes-parser 0.4.6 → 0.6.0

package/dist/index.js.flow

@@ -1,26 +1,85 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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
+ * @flow strict-local
  * @format
  */
 
 'use strict';
 
-declare type Options = {
-  allowReturnOutsideFunction?: boolean,
-  babel?: boolean,
-  flow?: 'all' | 'detect',
-  sourceFilename?: string,
-  sourceType?: 'module' | 'script' | 'unambiguous',
-  tokens?: boolean,
-};
+import type {Program as ESTreeProgram} from 'hermes-estree';
+import type {ParserOptions} from './ParserOptions';
 
-declare type Program = Object;
+import * as HermesParser from './HermesParser';
+import HermesToBabelAdapter from './HermesToBabelAdapter';
+import HermesToESTreeAdapter from './HermesToESTreeAdapter';
 
-declare module.exports: {
-  parse(code: string, opts: Options): Program,
+const DEFAULTS = {
+  flow: 'detect',
 };
+
+function getOptions(options?: ParserOptions = {...DEFAULTS}) {
+  // Default to detecting whether to parse Flow syntax by the presence
+  // of an @flow pragma.
+  if (options.flow == null) {
+    options.flow = DEFAULTS.flow;
+  } else if (options.flow !== 'all' && options.flow !== 'detect') {
+    throw new Error('flow option must be "all" or "detect"');
+  }
+
+  if (options.sourceType === 'unambiguous') {
+    // Clear source type so that it will be detected from the contents of the file
+    delete options.sourceType;
+  } else if (
+    options.sourceType != null &&
+    options.sourceType !== 'script' &&
+    options.sourceType !== 'module'
+  ) {
+    throw new Error(
+      'sourceType option must be "script", "module", or "unambiguous" if set',
+    );
+  }
+
+  options.tokens = options.tokens === true;
+  options.allowReturnOutsideFunction =
+    options.allowReturnOutsideFunction === true;
+
+  return options;
+}
+
+function getAdapter(options: ParserOptions, code: string) {
+  return options.babel === true
+    ? new HermesToBabelAdapter(options)
+    : new HermesToESTreeAdapter(options, code);
+}
+
+// $FlowExpectedError[unclear-type]
+type BabelProgram = Object;
+declare function parse(
+  code: string,
+  opts: {...ParserOptions, babel: true},
+): BabelProgram;
+// eslint-disable-next-line no-redeclare
+declare function parse(
+  code: string,
+  opts?:
+    | {...ParserOptions, babel?: false | void}
+    | {...ParserOptions, babel: false},
+): ESTreeProgram;
+
+// eslint-disable-next-line no-redeclare
+export function parse(
+  code: string,
+  opts?: ParserOptions,
+): BabelProgram | ESTreeProgram {
+  const options = getOptions(opts);
+  const ast = HermesParser.parse(code, options);
+  const adapter = getAdapter(options, code);
+
+  return adapter.transform(ast);
+}
+
+export type {ParserOptions} from './ParserOptions';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hermes-parser",
-  "version": "0.4.6",
+  "version": "0.6.0",
   "description": "A JavaScript parser built from the Hermes engine",
   "main": "dist/index.js",
   "license": "MIT",
@@ -8,6 +8,12 @@
     "type": "git",
     "url": "git@github.com:facebook/hermes.git"
   },
+  "dependencies": {
+    "hermes-estree": "0.6.0"
+  },
+  "devDependencies": {
+    "hermes-transform": "0.6.0"
+  },
   "files": [
     "dist"
   ]