hermes-transform 0.8.0 → 0.10.0

package/dist/generated/special-case-node-types/misc.js.flow

@@ -0,0 +1,205 @@
+/**
+ * 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-local
+ * @format
+ */
+
+import type {
+  ArrowFunctionExpression as ArrowFunctionExpressionType,
+  ClassDeclaration as ClassDeclarationType,
+  DeclareFunction as DeclareFunctionType,
+  ESNode,
+  FunctionTypeAnnotation as FunctionTypeAnnotationType,
+  Identifier as IdentifierType,
+  InterpreterDirective as InterpreterDirectiveType,
+  Token as TokenType,
+  Comment as CommentType,
+  TemplateElement as TemplateElementType,
+  Program as ProgramType,
+  DocblockMetadata as DocblockMetadataType,
+} from 'hermes-estree';
+import type {DetachedNode, MaybeDetachedNode} from '../../detachedNode';
+
+import {
+  asDetachedNode,
+  detachedProps,
+  setParentPointersInDirectChildren,
+} from '../../detachedNode';
+
+/*********************************************************************
+ * this file should only contain one-off variant node type functions *
+ * if you are creating multiple variants for the same "type", then   *
+ * put them in their own file to help keep things organised          *
+ *********************************************************************/
+
+// hermes adds an `id` prop which is always null, and it adds an `expression`
+// boolean which is true when the body isn't a BlockStatement.
+// No need to make consumers set these
+export type ArrowFunctionExpressionProps = {
+  +params: $ReadOnlyArray<
+    MaybeDetachedNode<ArrowFunctionExpressionType['params'][number]>,
+  >,
+  +body: MaybeDetachedNode<ArrowFunctionExpressionType['body']>,
+  +typeParameters?: ?MaybeDetachedNode<
+    ArrowFunctionExpressionType['typeParameters'],
+  >,
+  +returnType?: ?MaybeDetachedNode<ArrowFunctionExpressionType['returnType']>,
+  +predicate?: ?MaybeDetachedNode<ArrowFunctionExpressionType['predicate']>,
+  +async: ArrowFunctionExpressionType['async'],
+};
+export function ArrowFunctionExpression(props: {
+  ...$ReadOnly<ArrowFunctionExpressionProps>,
+  +parent?: ESNode,
+}): DetachedNode<ArrowFunctionExpressionType> {
+  const node = detachedProps<ArrowFunctionExpressionType>(props.parent, {
+    type: 'ArrowFunctionExpression',
+    id: null,
+    // $FlowExpectedError[incompatible-use]
+    expression: props.body.type !== 'BlockStatement',
+    params: props.params.map(n => asDetachedNode(n)),
+    body: asDetachedNode(props.body),
+    typeParameters: asDetachedNode(props.typeParameters),
+    returnType: asDetachedNode(props.returnType),
+    predicate: asDetachedNode(props.predicate),
+    async: props.async,
+  });
+  setParentPointersInDirectChildren(node);
+  return node;
+}
+
+export type ClassDeclarationProps = {
+  +id?: ?MaybeDetachedNode<ClassDeclarationType['id']>,
+  +typeParameters?: ?MaybeDetachedNode<ClassDeclarationType['typeParameters']>,
+  +superClass?: ?MaybeDetachedNode<ClassDeclarationType['superClass']>,
+  +superTypeParameters?: ?MaybeDetachedNode<
+    ClassDeclarationType['superTypeParameters'],
+  >,
+  // make this optional as it's rarer that people would want to include them
+  +implements?: $ReadOnlyArray<
+    MaybeDetachedNode<ClassDeclarationType['implements'][number]>,
+  >,
+  // make this optional as it's rarer that people would want to include them
+  +decorators?: $ReadOnlyArray<
+    MaybeDetachedNode<ClassDeclarationType['decorators'][number]>,
+  >,
+  +body: MaybeDetachedNode<ClassDeclarationType['body']>,
+};
+export function ClassDeclaration(props: {
+  ...$ReadOnly<ClassDeclarationProps>,
+  +parent?: ESNode,
+}): DetachedNode<ClassDeclarationType> {
+  const node = detachedProps<ClassDeclarationType>(props.parent, {
+    type: 'ClassDeclaration',
+    id: asDetachedNode(props.id),
+    typeParameters: asDetachedNode(props.typeParameters),
+    superClass: asDetachedNode(props.superClass),
+    superTypeParameters: asDetachedNode(props.superTypeParameters),
+    decorators: (props.decorators ?? []).map(n => asDetachedNode(n)),
+    implements: (props.implements ?? []).map(n => asDetachedNode(n)),
+    body: asDetachedNode(props.body),
+  });
+  setParentPointersInDirectChildren(node);
+  return node;
+}
+
+// raw/cooked are on a subobject in the estree spec, but are flat on the hermes types
+export type TemplateElementProps = {
+  +tail: TemplateElementType['tail'],
+  +cooked: TemplateElementType['value']['cooked'],
+  +raw: TemplateElementType['value']['raw'],
+};
+export function TemplateElement(props: {
+  ...$ReadOnly<TemplateElementProps>,
+  +parent?: ESNode,
+}): DetachedNode<TemplateElementType> {
+  return detachedProps<TemplateElementType>(props.parent, {
+    type: 'TemplateElement',
+    tail: props.tail,
+    value: {
+      cooked: props.cooked,
+      raw: props.raw,
+    },
+  });
+}
+
+// Identifier has a bunch of stuff that usually you don't want to provide - so we have
+// this manual def to allow us to default some values
+export type IdentifierProps = {
+  +name: IdentifierType['name'],
+  +typeAnnotation?: ?MaybeDetachedNode<IdentifierType['typeAnnotation']>,
+  +optional?: IdentifierType['optional'],
+};
+export function Identifier(props: {
+  ...$ReadOnly<IdentifierProps>,
+  +parent?: ESNode,
+}): DetachedNode<IdentifierType> {
+  const node = detachedProps<IdentifierType>(props.parent, {
+    type: 'Identifier',
+    name: props.name,
+    optional: props.optional ?? false,
+    typeAnnotation: asDetachedNode(props.typeAnnotation),
+  });
+  setParentPointersInDirectChildren(node);
+  return node;
+}
+
+export type ProgramProps = {
+  +sourceType: ProgramType['sourceType'],
+  +body: $ReadOnlyArray<MaybeDetachedNode<ProgramType['body'][number]>>,
+  +tokens: $ReadOnlyArray<MaybeDetachedNode<TokenType>>,
+  +comments: $ReadOnlyArray<MaybeDetachedNode<CommentType>>,
+  +interpreter: null | string,
+  +docblock: null | DocblockMetadataType,
+};
+export function Program(props: {
+  ...$ReadOnly<ProgramProps>,
+}): DetachedNode<ProgramType> {
+  return detachedProps<ProgramType>(null, {
+    type: 'Program',
+    sourceType: props.sourceType,
+    body: props.body.map(n => asDetachedNode(n)),
+    tokens: props.tokens,
+    comments: props.comments,
+    interpreter:
+      props.interpreter != null
+        ? // $FlowFixMe[incompatible-call]
+          asDetachedNode<InterpreterDirectiveType>({
+            type: 'InterpreterDirective',
+            value: props.interpreter,
+          })
+        : null,
+    docblock: props.docblock,
+  });
+}
+
+// the type annotation is stored on the Identifier's typeAnnotation
+// which is super awkward to work with and type - so we flatten the input
+// and put it in the right spot after
+export type DeclareFunctionProps = {
+  +name: string,
+  +functionType: MaybeDetachedNode<FunctionTypeAnnotationType>,
+  +predicate?: ?MaybeDetachedNode<DeclareFunctionType['predicate']>,
+};
+export function DeclareFunction(props: {
+  ...$ReadOnly<DeclareFunctionProps>,
+  +parent?: ESNode,
+}): DetachedNode<DeclareFunctionType> {
+  const node = detachedProps<DeclareFunctionType>(props.parent, {
+    type: 'DeclareFunction',
+    id: detachedProps(null, {
+      type: 'Identifier',
+      name: props.name,
+      typeAnnotation: detachedProps(null, {
+        type: 'TypeAnnotation',
+        typeAnnotation: asDetachedNode(props.functionType),
+      }),
+    }),
+    predicate: asDetachedNode(props.predicate),
+  });
+  setParentPointersInDirectChildren(node);
+  return node;
+}

package/dist/generated/special-case-node-types.js

@@ -3,197 +3,59 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.ArrowFunctionExpression = ArrowFunctionExpression;
-exports.BigIntLiteral = BigIntLiteral;
-exports.BlockComment = BlockComment;
-exports.BooleanLiteral = BooleanLiteral;
-exports.Identifier = Identifier;
-exports.LineComment = LineComment;
-exports.NullLiteral = NullLiteral;
-exports.NumericLiteral = NumericLiteral;
-exports.RegExpLiteral = RegExpLiteral;
-exports.StringLiteral = StringLiteral;
-exports.TemplateElement = TemplateElement;
 
-var _detachedNode = require("../detachedNode");
+var _Comment = require("./special-case-node-types/Comment");
 
-/**
- * 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
- */
-
-/*
-These are a number of special-case node creation functions that we can't auto-generate.
-The list of exported functions here must be kept in sync with the `NODES_WITH_SPECIAL_HANDLING`
-list in `scripts/genTransformNodeTypes` to ensure there's no duplicates
-*/
-function ArrowFunctionExpression({
-  parent,
-  ...props
-}) {
-  const node = (0, _detachedNode.detachedProps)(parent, {
-    type: 'ArrowFunctionExpression',
-    id: null,
-    // $FlowExpectedError[incompatible-use]
-    expression: props.body.type !== 'BlockStatement',
-    ...props
-  });
-  (0, _detachedNode.setParentPointersInDirectChildren)(node);
-  return node;
-} // pattern/flags are on a subobject in the estree spec, but are flat on the hermes types
-// also the value is supposed to be a RegExp instance
-
-
-function RegExpLiteral({
-  pattern,
-  flags,
-  parent
-}) {
-  const value = new RegExp(pattern, flags);
-  return (0, _detachedNode.detachedProps)(parent, {
-    type: 'Literal',
-    value,
-    raw: value.toString(),
-    regex: {
-      pattern,
-      flags
-    }
-  });
-} // raw/cooked are on a subobject in the estree spec, but are flat on the hermes types
-
-
-function TemplateElement({
-  tail,
-  parent,
-  ...value
-}) {
-  return (0, _detachedNode.detachedProps)(parent, {
-    type: 'TemplateElement',
-    tail,
-    value
-  });
-} // Identifier has a bunch of stuff that usually you don't want to provide - so we have
-// this manual def to allow us to default some values
-
-
-function Identifier({
-  parent,
-  optional = false,
-  typeAnnotation = null,
-  ...props
-}) {
-  const node = (0, _detachedNode.detachedProps)(parent, {
-    type: 'Identifier',
-    optional,
-    typeAnnotation,
-    ...props
-  });
-  (0, _detachedNode.setParentPointersInDirectChildren)(node);
-  return node;
-} //
-// Literals require a "raw" which is added by the estree transform, not hermes.
-//
+Object.keys(_Comment).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _Comment[key]) return;
+  exports[key] = _Comment[key];
+});
 
+var _DeclareExportDeclaration = require("./special-case-node-types/DeclareExportDeclaration");
 
-function BigIntLiteral({
-  parent,
-  ...props
-}) {
-  var _props$raw;
+Object.keys(_DeclareExportDeclaration).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _DeclareExportDeclaration[key]) return;
+  exports[key] = _DeclareExportDeclaration[key];
+});
 
-  const node = (0, _detachedNode.detachedProps)(parent, {
-    type: 'Literal',
-    ...props,
-    raw: (_props$raw = props.raw) != null ? _props$raw : `${props.value}n`,
-    bigint: `${props.value}`
-  });
-  (0, _detachedNode.setParentPointersInDirectChildren)(node);
-  return node;
-}
+var _ExportNamedDeclaration = require("./special-case-node-types/ExportNamedDeclaration");
 
-function BooleanLiteral({
-  parent,
-  value
-}) {
-  return (0, _detachedNode.detachedProps)(parent, {
-    type: 'Literal',
-    raw: value ? 'true' : 'false',
-    value
-  });
-}
+Object.keys(_ExportNamedDeclaration).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _ExportNamedDeclaration[key]) return;
+  exports[key] = _ExportNamedDeclaration[key];
+});
 
-function NumericLiteral({
-  parent,
-  ...props
-}) {
-  var _props$raw2;
+var _Literal = require("./special-case-node-types/Literal");
 
-  return (0, _detachedNode.detachedProps)(parent, {
-    type: 'Literal',
-    ...props,
-    raw: (_props$raw2 = props.raw) != null ? _props$raw2 : `${props.value}`
-  });
-}
+Object.keys(_Literal).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _Literal[key]) return;
+  exports[key] = _Literal[key];
+});
 
-function NullLiteral({
-  parent
-} = {}) {
-  return (0, _detachedNode.detachedProps)(parent, {
-    type: 'Literal',
-    value: null,
-    raw: 'null'
-  });
-}
+var _ObjectTypeProperty = require("./special-case-node-types/ObjectTypeProperty");
 
-function StringLiteral({
-  parent,
-  raw: rawIn,
-  value
-}) {
-  const hasSingleQuote = value.includes('"');
-  const hasDoubleQuote = value.includes("'");
-  let raw = rawIn;
+Object.keys(_ObjectTypeProperty).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _ObjectTypeProperty[key]) return;
+  exports[key] = _ObjectTypeProperty[key];
+});
 
-  if (raw == null) {
-    if (hasSingleQuote && hasDoubleQuote) {
-      raw = `'${value.replace(/'/g, "\\'")}'`;
-    } else if (hasSingleQuote) {
-      raw = `"${value}"`;
-    } else {
-      raw = `'${value}'`;
-    }
-  }
+var _misc = require("./special-case-node-types/misc");
 
-  return (0, _detachedNode.detachedProps)(parent, {
-    type: 'Literal',
-    raw,
-    value
-  });
-}
+Object.keys(_misc).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _misc[key]) return;
+  exports[key] = _misc[key];
+});
 
-function LineComment({
-  value
-}) {
-  // $FlowExpectedError[prop-missing]
-  // $FlowExpectedError[incompatible-return]
-  return (0, _detachedNode.detachedProps)(undefined, {
-    type: 'Line',
-    value
-  });
-}
+var _Property = require("./special-case-node-types/Property");
 
-function BlockComment({
-  value
-}) {
-  // $FlowExpectedError[prop-missing]
-  // $FlowExpectedError[incompatible-return]
-  return (0, _detachedNode.detachedProps)(undefined, {
-    type: 'Block',
-    value
-  });
-}
+Object.keys(_Property).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _Property[key]) return;
+  exports[key] = _Property[key];
+});