flow-api-translator 0.28.1 → 0.29.1

package/dist/src/flowDefToTSDef.js

@@ -0,0 +1,3853 @@
+/**
+ * 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.flowDefToTSDef = flowDefToTSDef;
+
+var FlowESTree = _interopRequireWildcard(require("hermes-estree"));
+
+var TSESTree = _interopRequireWildcard(require("./utils/ts-estree-ast-types"));
+
+var _hermesTransform = require("hermes-transform");
+
+var _ErrorUtils = require("./utils/ErrorUtils");
+
+var _DocblockUtils = require("./utils/DocblockUtils");
+
+var _os = require("os");
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+const DUMMY_LOC = {
+  start: {
+    line: 1,
+    column: 0
+  },
+  end: {
+    line: 1,
+    column: 0
+  }
+};
+
+function constructFlowNode(node) {
+  return node;
+}
+
+const cloneJSDocCommentsToNewNode = // $FlowExpectedError[incompatible-cast] - trust me this re-type is 100% safe
+_hermesTransform.cloneJSDocCommentsToNewNode;
+const makeCommentOwnLine = // $FlowExpectedError[incompatible-cast] - trust me this re-type is 100% safe
+_hermesTransform.makeCommentOwnLine;
+const VALID_REACT_IMPORTS = new Set(['React', 'react']);
+
+function isValidReactImportOrGlobal(id) {
+  return VALID_REACT_IMPORTS.has(id.name) || id.name.startsWith('React$');
+}
+
+let shouldAddReactImport = null; // Returns appropriate Identifier for `React` import.
+// If a global is in use, set a flag to indicate that we should add the import.
+
+function getReactIdentifier(hasReactImport) {
+  if (shouldAddReactImport !== false) {
+    shouldAddReactImport = !hasReactImport;
+  }
+
+  return {
+    type: 'Identifier',
+    loc: DUMMY_LOC,
+    name: `React`
+  };
+}
+
+function flowDefToTSDef(originalCode, ast, scopeManager, opts) {
+  const tsBody = [];
+  const tsProgram = {
+    type: 'Program',
+    body: tsBody,
+    sourceType: ast.sourceType,
+    loc: ast.loc,
+    docblock: ast.docblock == null ? null : (0, _DocblockUtils.removeAtFlowFromDocblock)(ast.docblock)
+  };
+  shouldAddReactImport = null;
+  const [transform, code] = getTransforms(originalCode, scopeManager, opts);
+
+  for (const node of ast.body) {
+    if (node.type in transform) {
+      const result = transform[// $FlowExpectedError[prop-missing]
+      node.type]( // $FlowExpectedError[incompatible-type]
+      // $FlowExpectedError[prop-missing]
+      // $FlowFixMe[incompatible-call]
+      node);
+      tsBody.push(...(Array.isArray(result) ? result : [result]));
+    } else {
+      throw (0, _ErrorUtils.unexpectedTranslationError)(node, `Unexpected node type ${node.type}`, {
+        code
+      });
+    }
+  }
+
+  if (shouldAddReactImport === true) {
+    tsBody.unshift({
+      type: 'ImportDeclaration',
+      assertions: [],
+      loc: DUMMY_LOC,
+      source: {
+        type: 'Literal',
+        loc: DUMMY_LOC,
+        value: 'react',
+        raw: "'react'"
+      },
+      specifiers: [{
+        type: 'ImportNamespaceSpecifier',
+        loc: DUMMY_LOC,
+        local: {
+          type: 'Identifier',
+          loc: DUMMY_LOC,
+          name: 'React'
+        }
+      }],
+      importKind: 'value'
+    });
+  }
+
+  return [tsProgram, code];
+}
+
+const getTransforms = (originalCode, scopeManager, opts) => {
+  let code = originalCode;
+
+  function translationError(node, message) {
+    return (0, _ErrorUtils.translationError)(node, message, {
+      code
+    });
+  }
+
+  function unexpectedTranslationError(node, message) {
+    return (0, _ErrorUtils.unexpectedTranslationError)(node, message, {
+      code
+    });
+  }
+
+  function unsupportedFeatureMessage(thing) {
+    return `Unsupported feature: Translating "${thing}" is currently not supported.`;
+  }
+
+  function buildCodeFrameForComment(node, message) {
+    return (0, _ErrorUtils.buildCodeFrame)(node, message, code, false);
+  }
+
+  function addErrorComment(node, message) {
+    var _node$comments;
+
+    const comment = {
+      type: 'Block',
+      loc: DUMMY_LOC,
+      value: `*${_os.EOL} * ${message.replace(new RegExp(_os.EOL, 'g'), `${_os.EOL} * `)}${_os.EOL}*`,
+      leading: true,
+      printed: false
+    };
+    code = makeCommentOwnLine(code, comment); // $FlowExpectedError[prop-missing]
+    // $FlowExpectedError[cannot-write]
+
+    (_node$comments = node.comments) != null ? _node$comments : node.comments = []; // $FlowExpectedError[incompatible-cast]
+
+    node.comments.push(comment);
+  }
+
+  function unsupportedAnnotation(node, thing) {
+    const message = unsupportedFeatureMessage(thing);
+
+    if (opts.recoverFromErrors) {
+      const codeFrame = buildCodeFrameForComment(node, message);
+      const newNode = {
+        type: 'TSAnyKeyword',
+        loc: DUMMY_LOC
+      };
+      addErrorComment(newNode, codeFrame);
+      return newNode;
+    }
+
+    throw translationError(node, message);
+  }
+
+  function unsupportedDeclaration(node, thing, id, declare = false, typeParameters = null) {
+    const message = unsupportedFeatureMessage(thing);
+
+    if (opts.recoverFromErrors) {
+      const codeFrame = buildCodeFrameForComment(node, message);
+      const newNode = {
+        type: 'TSTypeAliasDeclaration',
+        loc: DUMMY_LOC,
+        declare,
+        id: transform.Identifier(id, false),
+        typeAnnotation: {
+          type: 'TSAnyKeyword',
+          loc: DUMMY_LOC
+        },
+        typeParameters: typeParameters == null ? undefined : transform.TypeParameterDeclaration(typeParameters)
+      };
+      addErrorComment(newNode, codeFrame);
+      return newNode;
+    }
+
+    throw translationError(node, message);
+  }
+
+  const topScope = (() => {
+    const globalScope = scopeManager.globalScope;
+
+    if (globalScope.childScopes.length > 0 && globalScope.childScopes[0].type === 'module') {
+      return globalScope.childScopes[0];
+    }
+
+    return globalScope;
+  })();
+
+  function isReactImport(scopeNode, name) {
+    let currentScope = (() => {
+      let scope = null;
+      let node = scopeNode;
+
+      while (!scope && node) {
+        scope = scopeManager.acquire(node, true);
+        node = node.parent;
+      }
+
+      return scope;
+    })();
+
+    if (currentScope == null) {
+      throw new Error('unable to resolve scope');
+    }
+
+    const variableDef = (() => {
+      while (currentScope != null) {
+        for (const variable of currentScope.variables) {
+          if (variable.defs.length && variable.name === name) {
+            return variable;
+          }
+        }
+
+        currentScope = currentScope.upper;
+      }
+    })(); // No variable found, it is not imported.
+    // It could be a global though if isValidReactImportOrGlobal returns true.
+
+
+    if (variableDef == null) {
+      return false;
+    }
+
+    const def = variableDef.defs[0]; // Detect:
+
+    switch (def.type) {
+      // import React from 'react';
+      // import * as React from 'react';
+      case 'ImportBinding':
+        {
+          if (def.node.type === 'ImportDefaultSpecifier' || def.node.type === 'ImportNamespaceSpecifier') {
+            return VALID_REACT_IMPORTS.has(def.parent.source.value);
+          }
+
+          return false;
+        }
+      // Globals
+
+      case 'ImplicitGlobalVariable':
+        {
+          return VALID_REACT_IMPORTS.has(name);
+        }
+      // TODO Handle:
+      // const React = require('react');
+      // const Something = React;
+    }
+
+    return false;
+  }
+
+  function EnumImpl(node) {
+    const body = node.body;
+
+    if (body.type === 'EnumSymbolBody') {
+      /*
+      There's unfortunately no way for us to support this in a clean way.
+      We can get really close using this code:
+      ```
+      declare namespace SymbolEnum {
+          export const member1: unique symbol;
+          export type member1 = typeof member1;
+           export const member2: unique symbol;
+          export type member2 = typeof member2;
+      }
+      type SymbolEnum = typeof SymbolEnum[keyof typeof SymbolEnum];
+      ```
+       However as explained in https://github.com/microsoft/TypeScript/issues/43657:
+      "A unique symbol type is never transferred from one declaration to another through inference."
+      This intended behaviour in TS means that the usage of the fake-enum would look like this:
+      ```
+      const value: SymbolEnum.member1 = SymbolEnum.member1;
+      //           ^^^^^^^^^^^^^^^^^^ required to force TS to retain the information
+      ```
+      Which is really clunky and shitty. It definitely works, but ofc it's not good.
+      We can go with this design if users are okay with it!
+       Considering how rarely used symbol enums are ATM, let's just put a pin in it for now.
+      */
+      return unsupportedDeclaration(node, 'symbol enums', node.id, FlowESTree.isDeclareEnum(node));
+    }
+
+    if (body.type === 'EnumBooleanBody') {
+      /*
+      TODO - TS enums only allow strings or numbers as their values - not booleans.
+      This means we need a non-ts-enum representation of the enum.
+      We can support boolean enums using a construct like this:
+      ```ts
+      declare namespace BooleanEnum {
+          export const member1: true;
+          export type member1 = typeof member1;
+           export const member2: false;
+          export type member2 = typeof member1;
+      }
+      declare type BooleanEnum = boolean;
+      ```
+       But it's pretty clunky and ugly.
+      Considering how rarely used boolean enums are ATM, let's just put a pin in it for now.
+      */
+      return unsupportedDeclaration(node, 'boolean enums', node.id, FlowESTree.isDeclareEnum(node));
+    }
+
+    const members = [];
+
+    for (const member of body.members) {
+      switch (member.type) {
+        case 'EnumDefaultedMember':
+          {
+            if (body.type === 'EnumNumberBody') {
+              // this should be impossible!
+              throw unexpectedTranslationError(member, 'Unexpected defaulted number enum member');
+            }
+
+            members.push({
+              type: 'TSEnumMember',
+              loc: DUMMY_LOC,
+              computed: false,
+              id: transform.Identifier(member.id, false),
+              initializer: {
+                type: 'Literal',
+                loc: DUMMY_LOC,
+                raw: `"${member.id.name}"`,
+                value: member.id.name
+              }
+            });
+            break;
+          }
+
+        case 'EnumNumberMember':
+        case 'EnumStringMember':
+          members.push({
+            type: 'TSEnumMember',
+            loc: DUMMY_LOC,
+            computed: false,
+            id: transform.Identifier(member.id, false),
+            initializer: member.init.literalType === 'string' ? transform.StringLiteral(member.init) : transform.NumericLiteral(member.init)
+          });
+      }
+    }
+
+    const bodyRepresentationType = body.type === 'EnumNumberBody' ? {
+      type: 'TSNumberKeyword',
+      loc: DUMMY_LOC
+    } : {
+      type: 'TSStringKeyword',
+      loc: DUMMY_LOC
+    };
+    const enumName = transform.Identifier(node.id, false);
+    return [{
+      type: 'TSEnumDeclaration',
+      loc: DUMMY_LOC,
+      const: false,
+      declare: true,
+      id: enumName,
+      members
+    }, // flow also exports `.cast`, `.isValid`, `.members` and `.getName` for enums
+    // we can use declaration merging to declare these functions on the enum:
+
+    /*
+    declare enum Foo {
+      A = 1,
+      B = 2,
+    }
+    declare namespace Foo {
+      export function cast(value: number | null | undefined): Foo;
+      export function isValid(value: number | null | undefined): value is Foo;
+      export function members(): IterableIterator<Foo>;
+      export function getName(value: Foo): string;
+    }
+    */
+    {
+      type: 'TSModuleDeclaration',
+      loc: DUMMY_LOC,
+      declare: true,
+      id: enumName,
+      body: {
+        type: 'TSModuleBlock',
+        loc: DUMMY_LOC,
+        body: [// export function cast(value: number | null | undefined): Foo
+        {
+          type: 'ExportNamedDeclaration',
+          loc: DUMMY_LOC,
+          declaration: {
+            type: 'TSDeclareFunction',
+            loc: DUMMY_LOC,
+            id: {
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: 'cast'
+            },
+            generator: false,
+            expression: false,
+            async: false,
+            params: [{
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: 'value',
+              typeAnnotation: {
+                type: 'TSTypeAnnotation',
+                loc: DUMMY_LOC,
+                typeAnnotation: {
+                  type: 'TSUnionType',
+                  loc: DUMMY_LOC,
+                  types: [bodyRepresentationType, {
+                    type: 'TSNullKeyword',
+                    loc: DUMMY_LOC
+                  }, {
+                    type: 'TSUndefinedKeyword',
+                    loc: DUMMY_LOC
+                  }]
+                }
+              }
+            }],
+            returnType: {
+              type: 'TSTypeAnnotation',
+              loc: DUMMY_LOC,
+              typeAnnotation: {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: enumName
+              }
+            }
+          },
+          specifiers: [],
+          source: null,
+          exportKind: 'value',
+          assertions: []
+        }, // export function isValid(value: number | null | undefined): value is Foo;
+        {
+          type: 'ExportNamedDeclaration',
+          loc: DUMMY_LOC,
+          declaration: {
+            type: 'TSDeclareFunction',
+            loc: DUMMY_LOC,
+            id: {
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: 'isValid'
+            },
+            generator: false,
+            expression: false,
+            async: false,
+            params: [{
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: 'value',
+              typeAnnotation: {
+                type: 'TSTypeAnnotation',
+                loc: DUMMY_LOC,
+                typeAnnotation: {
+                  type: 'TSUnionType',
+                  loc: DUMMY_LOC,
+                  types: [bodyRepresentationType, {
+                    type: 'TSNullKeyword',
+                    loc: DUMMY_LOC
+                  }, {
+                    type: 'TSUndefinedKeyword',
+                    loc: DUMMY_LOC
+                  }]
+                }
+              }
+            }],
+            returnType: {
+              type: 'TSTypeAnnotation',
+              loc: DUMMY_LOC,
+              typeAnnotation: {
+                type: 'TSTypePredicate',
+                loc: DUMMY_LOC,
+                asserts: false,
+                parameterName: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: 'value'
+                },
+                typeAnnotation: {
+                  type: 'TSTypeAnnotation',
+                  loc: DUMMY_LOC,
+                  typeAnnotation: {
+                    type: 'TSTypeReference',
+                    loc: DUMMY_LOC,
+                    typeName: enumName
+                  }
+                }
+              }
+            }
+          },
+          specifiers: [],
+          source: null,
+          exportKind: 'value',
+          assertions: []
+        }, // export function members(): IterableIterator<Foo>;
+        {
+          type: 'ExportNamedDeclaration',
+          loc: DUMMY_LOC,
+          declaration: {
+            type: 'TSDeclareFunction',
+            loc: DUMMY_LOC,
+            id: {
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: 'members'
+            },
+            generator: false,
+            expression: false,
+            async: false,
+            params: [],
+            returnType: {
+              type: 'TSTypeAnnotation',
+              loc: DUMMY_LOC,
+              typeAnnotation: {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: 'IterableIterator'
+                },
+                typeParameters: {
+                  type: 'TSTypeParameterInstantiation',
+                  loc: DUMMY_LOC,
+                  params: [{
+                    type: 'TSTypeReference',
+                    loc: DUMMY_LOC,
+                    typeName: enumName
+                  }]
+                }
+              }
+            }
+          },
+          specifiers: [],
+          source: null,
+          exportKind: 'value',
+          assertions: []
+        }, // export function getName(value: Foo): string;
+        {
+          type: 'ExportNamedDeclaration',
+          loc: DUMMY_LOC,
+          declaration: {
+            type: 'TSDeclareFunction',
+            loc: DUMMY_LOC,
+            id: {
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: 'getName'
+            },
+            generator: false,
+            expression: false,
+            async: false,
+            params: [{
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: 'value',
+              typeAnnotation: {
+                type: 'TSTypeAnnotation',
+                loc: DUMMY_LOC,
+                typeAnnotation: {
+                  type: 'TSTypeReference',
+                  loc: DUMMY_LOC,
+                  typeName: enumName
+                }
+              }
+            }],
+            returnType: {
+              type: 'TSTypeAnnotation',
+              loc: DUMMY_LOC,
+              typeAnnotation: {
+                type: 'TSStringKeyword',
+                loc: DUMMY_LOC
+              }
+            }
+          },
+          specifiers: [],
+          source: null,
+          exportKind: 'value',
+          assertions: []
+        }]
+      }
+    }];
+  }
+
+  const getPlaceholderNameForTypeofImport = (() => {
+    let typeof_import_count = 0;
+    return () => `$$IMPORT_TYPEOF_${++typeof_import_count}$$`;
+  })();
+
+  const transformTypeAnnotationType = node => {
+    switch (node.type) {
+      case 'AnyTypeAnnotation':
+        return transform.AnyTypeAnnotation(node);
+
+      case 'ArrayTypeAnnotation':
+        return transform.ArrayTypeAnnotation(node);
+
+      case 'BigIntLiteralTypeAnnotation':
+        return transform.BigIntLiteralTypeAnnotation(node);
+
+      case 'BigIntTypeAnnotation':
+        return transform.BigIntTypeAnnotation(node);
+
+      case 'BooleanLiteralTypeAnnotation':
+        return transform.BooleanLiteralTypeAnnotation(node);
+
+      case 'BooleanTypeAnnotation':
+        return transform.BooleanTypeAnnotation(node);
+
+      case 'EmptyTypeAnnotation':
+        return transform.EmptyTypeAnnotation(node);
+
+      case 'ExistsTypeAnnotation':
+        return transform.ExistsTypeAnnotation(node);
+
+      case 'FunctionTypeAnnotation':
+        return transform.FunctionTypeAnnotation(node);
+
+      case 'GenericTypeAnnotation':
+        return transform.GenericTypeAnnotation(node);
+
+      case 'IndexedAccessType':
+        return transform.IndexedAccessType(node);
+
+      case 'InterfaceTypeAnnotation':
+        return transform.InterfaceTypeAnnotation(node);
+
+      case 'IntersectionTypeAnnotation':
+        return transform.IntersectionTypeAnnotation(node);
+
+      case 'MixedTypeAnnotation':
+        return transform.MixedTypeAnnotation(node);
+
+      case 'NullLiteralTypeAnnotation':
+        return transform.NullLiteralTypeAnnotation(node);
+
+      case 'NullableTypeAnnotation':
+        return transform.NullableTypeAnnotation(node);
+
+      case 'NumberLiteralTypeAnnotation':
+        return transform.NumberLiteralTypeAnnotation(node);
+
+      case 'NumberTypeAnnotation':
+        return transform.NumberTypeAnnotation(node);
+
+      case 'ObjectTypeAnnotation':
+        return transform.ObjectTypeAnnotation(node);
+
+      case 'OptionalIndexedAccessType':
+        return transform.OptionalIndexedAccessType(node);
+
+      case 'QualifiedTypeIdentifier':
+        return transform.QualifiedTypeIdentifier(node);
+
+      case 'StringLiteralTypeAnnotation':
+        return transform.StringLiteralTypeAnnotation(node);
+
+      case 'StringTypeAnnotation':
+        return transform.StringTypeAnnotation(node);
+
+      case 'SymbolTypeAnnotation':
+        return transform.SymbolTypeAnnotation(node);
+
+      case 'ThisTypeAnnotation':
+        return transform.ThisTypeAnnotation(node);
+
+      case 'TupleTypeAnnotation':
+        return transform.TupleTypeAnnotation(node);
+
+      case 'TypeofTypeAnnotation':
+        return transform.TypeofTypeAnnotation(node);
+
+      case 'UnionTypeAnnotation':
+        return transform.UnionTypeAnnotation(node);
+
+      case 'VoidTypeAnnotation':
+        return transform.VoidTypeAnnotation(node);
+
+      case 'TypePredicate':
+        return transform.TypePredicateAnnotation(node);
+
+      case 'ConditionalTypeAnnotation':
+        return transform.ConditionalTypeAnnotation(node);
+
+      case 'InferTypeAnnotation':
+        return transform.InferTypeAnnotation(node);
+
+      case 'KeyofTypeAnnotation':
+        return transform.KeyofTypeAnnotation(node);
+
+      case 'TypeOperator':
+        return transform.TypeOperator(node);
+
+      case 'ComponentTypeAnnotation':
+        return transform.ComponentTypeAnnotation(node);
+
+      default:
+        throw unexpectedTranslationError(node, `Unhandled type ${node.type}`);
+    }
+  };
+
+  const transform = {
+    AnyTypeAnnotation(_node) {
+      return {
+        type: 'TSAnyKeyword',
+        loc: DUMMY_LOC
+      };
+    },
+
+    ArrayTypeAnnotation(node) {
+      return {
+        type: 'TSArrayType',
+        loc: DUMMY_LOC,
+        elementType: transformTypeAnnotationType(node.elementType)
+      };
+    },
+
+    BigIntLiteral(node) {
+      return {
+        type: 'Literal',
+        loc: DUMMY_LOC,
+        bigint: node.bigint,
+        raw: node.raw,
+        value: node.value
+      };
+    },
+
+    BigIntLiteralTypeAnnotation(node) {
+      var _node$bigint;
+
+      // technically hermes doesn't support this yet
+      // but future proofing amirite
+      const bigint = // $FlowExpectedError[prop-missing]
+      (_node$bigint = node.bigint) != null ? _node$bigint : node.raw // 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
+      .replace(/_/, '');
+      return {
+        type: 'TSLiteralType',
+        loc: DUMMY_LOC,
+        literal: {
+          type: 'Literal',
+          loc: DUMMY_LOC,
+          value: node.value,
+          raw: node.raw,
+          bigint
+        }
+      };
+    },
+
+    BigIntTypeAnnotation(_node) {
+      return {
+        type: 'TSBigIntKeyword',
+        loc: DUMMY_LOC
+      };
+    },
+
+    BooleanLiteral(node) {
+      return {
+        type: 'Literal',
+        loc: DUMMY_LOC,
+        raw: node.raw,
+        value: node.value
+      };
+    },
+
+    BooleanLiteralTypeAnnotation(node) {
+      return {
+        type: 'TSLiteralType',
+        loc: DUMMY_LOC,
+        literal: {
+          type: 'Literal',
+          loc: DUMMY_LOC,
+          value: node.value,
+          raw: node.raw
+        }
+      };
+    },
+
+    BooleanTypeAnnotation(_node) {
+      return {
+        type: 'TSBooleanKeyword',
+        loc: DUMMY_LOC
+      };
+    },
+
+    ClassImplements(node) {
+      return {
+        type: 'TSClassImplements',
+        loc: DUMMY_LOC,
+        expression: transform.Identifier(node.id, false),
+        typeParameters: transform.TypeParameterInstantiation(node.typeParameters)
+      };
+    },
+
+    DeclareClass(node) {
+      const classMembers = [];
+      const transformedBody = transform.ObjectTypeAnnotation(node.body);
+
+      if (transformedBody.type !== 'TSTypeLiteral') {
+        return unsupportedDeclaration(node.body, 'Spreads in declare class are not allowed', node.id, true, node.typeParameters);
+      }
+
+      for (const member of transformedBody.members) {
+        // TS uses the real ClassDeclaration AST so we need to
+        // make the signatures real methods/properties
+        switch (member.type) {
+          case 'TSIndexSignature':
+            {
+              classMembers.push(member);
+              break;
+            }
+
+          case 'TSMethodSignature':
+            {
+              // flow just creates a method signature like any other for a constructor
+              // but the proper AST has `kind = 'constructor'`
+              const isConstructor = (() => {
+                if (member.computed === true) {
+                  return false;
+                }
+
+                return member.key.type === 'Identifier' && member.key.name === 'constructor' || member.key.type === 'Literal' && member.key.value === 'constructor';
+              })();
+
+              if (isConstructor) {
+                const newNode = {
+                  type: 'MethodDefinition',
+                  loc: DUMMY_LOC,
+                  accessibility: undefined,
+                  computed: false,
+                  key: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: 'constructor'
+                  },
+                  kind: 'constructor',
+                  optional: false,
+                  override: false,
+                  static: false,
+                  value: {
+                    type: 'TSEmptyBodyFunctionExpression',
+                    loc: DUMMY_LOC,
+                    async: false,
+                    body: null,
+                    declare: false,
+                    expression: false,
+                    generator: false,
+                    id: null,
+                    params: member.params,
+                    // constructors explicitly have no return type
+                    returnType: undefined,
+                    typeParameters: member.typeParameters
+                  }
+                };
+                cloneJSDocCommentsToNewNode(member, newNode);
+                classMembers.push(newNode);
+              } else {
+                var _member$static;
+
+                const [key, computed] = (() => {
+                  const _key = member.key;
+
+                  if (_key.type === 'Identifier' && _key.name.startsWith('@@')) {
+                    const name = _key.name.slice(2);
+
+                    if (['iterator', 'asyncIterator'].includes(name)) {
+                      return [{
+                        type: 'MemberExpression',
+                        computed: false,
+                        object: {
+                          type: 'Identifier',
+                          name: 'Symbol',
+                          optional: false,
+                          loc: DUMMY_LOC
+                        },
+                        optional: false,
+                        property: {
+                          type: 'Identifier',
+                          name,
+                          optional: false,
+                          loc: DUMMY_LOC
+                        },
+                        loc: DUMMY_LOC
+                      }, true];
+                    }
+                  }
+
+                  return [member.key, member.computed];
+                })();
+
+                const newNode = {
+                  type: 'MethodDefinition',
+                  loc: DUMMY_LOC,
+                  accessibility: member.accessibility,
+                  computed: computed != null ? computed : false,
+                  key,
+                  kind: member.kind,
+                  optional: member.optional,
+                  override: false,
+                  static: (_member$static = member.static) != null ? _member$static : false,
+                  value: {
+                    type: 'TSEmptyBodyFunctionExpression',
+                    loc: DUMMY_LOC,
+                    async: false,
+                    body: null,
+                    declare: false,
+                    expression: false,
+                    generator: false,
+                    id: null,
+                    params: member.params,
+                    returnType: member.returnType,
+                    typeParameters: member.typeParameters
+                  }
+                };
+                cloneJSDocCommentsToNewNode(member, newNode);
+                classMembers.push(newNode);
+              }
+
+              break;
+            }
+
+          case 'TSPropertySignature':
+            {
+              var _member$computed, _member$static2;
+
+              const newNode = {
+                type: 'PropertyDefinition',
+                loc: DUMMY_LOC,
+                accessibility: member.accessibility,
+                computed: (_member$computed = member.computed) != null ? _member$computed : false,
+                declare: false,
+                key: member.key,
+                optional: member.optional,
+                readonly: member.readonly,
+                static: (_member$static2 = member.static) != null ? _member$static2 : false,
+                typeAnnotation: member.typeAnnotation,
+                value: null
+              };
+              cloneJSDocCommentsToNewNode(member, newNode);
+              classMembers.push(newNode);
+              break;
+            }
+
+          case 'TSCallSignatureDeclaration':
+            {
+              var _node$body$callProper;
+
+              /*
+              TODO - callProperties
+              It's not valid to directly declare a call property on a class in TS
+              You can do it, but it's a big complication in the AST:
+              ```ts
+              declare Class {
+                // ...
+              }
+              interface ClassConstructor {
+                new (): Class;
+                // call sigs
+                (): Type;
+              }
+              ```
+              Let's put a pin in it for now and deal with it later if the need arises.
+              */
+              return unsupportedDeclaration((_node$body$callProper = node.body.callProperties[0]) != null ? _node$body$callProper : node.body, 'call signatures on classes', node.id, true, node.typeParameters);
+            }
+
+          default:
+            throw unexpectedTranslationError(node.body, `Unexpected member type ${member.type}`);
+        }
+      }
+
+      const superClass = node.extends.length > 0 ? node.extends[0] : undefined;
+      return {
+        type: 'ClassDeclaration',
+        loc: DUMMY_LOC,
+        body: {
+          type: 'ClassBody',
+          loc: DUMMY_LOC,
+          body: classMembers
+        },
+        declare: true,
+        id: transform.Identifier(node.id, false),
+        implements: node.implements == null ? undefined : node.implements.map(transform.ClassImplements),
+        superClass: superClass == null ? null : superClass.id.type === 'QualifiedTypeIdentifier' ? transform.QualifiedTypeIdentifier(superClass.id) : transform.Identifier(superClass.id, false),
+        superTypeParameters: transform.TypeParameterInstantiation(superClass == null ? void 0 : superClass.typeParameters),
+        typeParameters: node.typeParameters == null ? undefined : transform.TypeParameterDeclaration(node.typeParameters) // TODO - mixins??
+
+      };
+    },
+
+    DeclareExportDeclaration(node) {
+      if (node.default === true) {
+        const declaration = node.declaration;
+
+        switch (declaration.type) {
+          // TS doesn't support direct default export for declare'd classes
+          case 'DeclareClass':
+            {
+              const classDecl = transform.DeclareClass(declaration);
+              const name = declaration.id.name;
+              return [classDecl, {
+                type: 'ExportDefaultDeclaration',
+                loc: DUMMY_LOC,
+                declaration: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name
+                },
+                exportKind: 'value'
+              }];
+            }
+          // TS doesn't support direct default export for declare'd functions
+
+          case 'DeclareFunction':
+            {
+              const functionDecl = transform.DeclareFunction(declaration);
+              const name = declaration.id.name;
+              return [functionDecl, {
+                type: 'ExportDefaultDeclaration',
+                loc: DUMMY_LOC,
+                declaration: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name
+                },
+                exportKind: 'value'
+              }];
+            }
+          // TS doesn't support direct default export for declare'd functions
+
+          case 'DeclareComponent':
+            {
+              const functionDecl = transform.DeclareComponent(declaration);
+              const name = declaration.id.name;
+              return [functionDecl, {
+                type: 'ExportDefaultDeclaration',
+                loc: DUMMY_LOC,
+                declaration: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name
+                },
+                exportKind: 'value'
+              }];
+            }
+          // TS doesn't support direct default export for declare'd functions
+
+          case 'DeclareHook':
+            {
+              const functionDecl = transform.DeclareHook(declaration);
+              const name = declaration.id.name;
+              return [functionDecl, {
+                type: 'ExportDefaultDeclaration',
+                loc: DUMMY_LOC,
+                declaration: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name
+                },
+                exportKind: 'value'
+              }];
+            }
+          // Flow's declare export default Identifier is ambiguous.
+          // the Identifier might reference a type, or it might reference a value
+          // - If it's a value, then that's all good, TS supports that.
+          // - If it's a type, that's a problem - TS only allows value variables to be exported
+          //   so we need to create an intermediate variable to hold the type.
+
+          case 'GenericTypeAnnotation':
+            {
+              const referencedId = declaration.id; // QualifiedTypeIdentifiers are types so cannot be handled without the intermediate variable so
+              // only Identifiers can be handled here.
+
+              if (referencedId.type === 'Identifier') {
+                const exportedVar = topScope.set.get(referencedId.name);
+
+                if (exportedVar != null && exportedVar.defs.length === 1) {
+                  const def = exportedVar.defs[0];
+
+                  switch (def.type) {
+                    case 'ImportBinding':
+                      {
+                        // `import type { Wut } from 'mod'; declare export default Wut;`
+                        // `import { type Wut } from 'mod'; declare export default Wut;`
+                        // these cases should be wrapped in a variable because they're exporting a type, not a value
+                        const specifier = def.node;
+
+                        if (specifier.importKind === 'type' || specifier.parent.importKind === 'type') {
+                          // fallthrough to the "default" handling
+                          break;
+                        } // intentional fallthrough to the "value" handling
+
+                      }
+
+                    case 'ClassName':
+                    case 'Enum':
+                    case 'FunctionName':
+                    case 'ImplicitGlobalVariable':
+                    case 'Variable':
+                      // there's already a variable defined to hold the type
+                      return {
+                        type: 'ExportDefaultDeclaration',
+                        loc: DUMMY_LOC,
+                        declaration: {
+                          type: 'Identifier',
+                          loc: DUMMY_LOC,
+                          name: referencedId.name
+                        },
+                        exportKind: 'value'
+                      };
+
+                    case 'CatchClause':
+                    case 'Parameter':
+                    case 'TypeParameter':
+                      throw translationError(def.node, `Unexpected variable def type: ${def.type}`);
+
+                    case 'Type':
+                      // fallthrough to the "default" handling
+                      break;
+                  }
+                }
+              } // intentional fallthrough to the "default" handling
+
+            }
+
+          case 'TypeofTypeAnnotation':
+            {
+              if (declaration.type === 'TypeofTypeAnnotation' && declaration.argument.type === 'Identifier') {
+                const name = declaration.argument.name;
+                const exportedVar = topScope.set.get(name);
+
+                if (exportedVar != null && exportedVar.defs.length === 1) {
+                  const def = exportedVar.defs[0];
+
+                  switch (def.type) {
+                    case 'ClassName':
+                      {
+                        return {
+                          type: 'ExportDefaultDeclaration',
+                          declaration: {
+                            type: 'Identifier',
+                            decorators: [],
+                            name,
+                            optional: false,
+                            loc: DUMMY_LOC
+                          },
+                          exportKind: 'value',
+                          loc: DUMMY_LOC
+                        };
+                      }
+                  }
+                }
+              } // intentional fallthrough to the "default" handling
+
+            }
+
+          default:
+            {
+              /*
+              flow allows syntax like
+              ```
+              declare export default TypeName;
+              ```
+              but TS does not, so we have to declare a temporary variable to
+              reference in the export declaration:
+              ```
+              declare const $$EXPORT_DEFAULT_DECLARATION$$: TypeName;
+              export default $$EXPORT_DEFAULT_DECLARATION$$;
+              ```
+              */
+              const SPECIFIER = '$$EXPORT_DEFAULT_DECLARATION$$';
+              return [{
+                type: 'VariableDeclaration',
+                loc: DUMMY_LOC,
+                declarations: [{
+                  type: 'VariableDeclarator',
+                  loc: DUMMY_LOC,
+                  id: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: SPECIFIER,
+                    typeAnnotation: {
+                      type: 'TSTypeAnnotation',
+                      loc: DUMMY_LOC,
+                      typeAnnotation: transformTypeAnnotationType(declaration)
+                    }
+                  },
+                  init: null
+                }],
+                declare: true,
+                kind: 'const'
+              }, {
+                type: 'TSTypeAliasDeclaration',
+                declare: true,
+                id: {
+                  type: 'Identifier',
+                  decorators: [],
+                  name: SPECIFIER,
+                  optional: false,
+                  loc: DUMMY_LOC
+                },
+                typeAnnotation: {
+                  type: 'TSTypeQuery',
+                  exprName: {
+                    type: 'Identifier',
+                    decorators: [],
+                    name: SPECIFIER,
+                    optional: false,
+                    loc: DUMMY_LOC
+                  },
+                  loc: DUMMY_LOC
+                },
+                loc: DUMMY_LOC
+              }, {
+                type: 'ExportDefaultDeclaration',
+                loc: DUMMY_LOC,
+                declaration: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: SPECIFIER
+                },
+                exportKind: 'value'
+              }];
+            }
+        }
+      } else {
+        // eslint-disable-next-line eqeqeq
+        if (node.source === null) {
+          // eslint-disable-next-line eqeqeq
+          if (node.declaration === null) {
+            return {
+              type: 'ExportNamedDeclaration',
+              loc: DUMMY_LOC,
+              // flow does not currently support assertions
+              assertions: [],
+              declaration: null,
+              // flow does not support declared type exports with specifiers
+              exportKind: 'value',
+              source: null,
+              specifiers: node.specifiers.map(transform.ExportSpecifier)
+            };
+          }
+
+          const declarations = (() => {
+            switch (node.declaration.type) {
+              case 'DeclareClass':
+                return [{
+                  declaration: transform.DeclareClass(node.declaration),
+                  exportKind: 'value'
+                }];
+
+              case 'DeclareComponent':
+                return [{
+                  declaration: transform.DeclareComponent(node.declaration),
+                  exportKind: 'value'
+                }];
+
+              case 'DeclareHook':
+                return [{
+                  declaration: transform.DeclareHook(node.declaration),
+                  exportKind: 'value'
+                }];
+
+              case 'DeclareFunction':
+                return [{
+                  declaration: transform.DeclareFunction(node.declaration),
+                  exportKind: 'value'
+                }];
+
+              case 'DeclareInterface':
+                return [{
+                  declaration: transform.DeclareInterface(node.declaration),
+                  exportKind: 'type'
+                }];
+
+              case 'DeclareOpaqueType':
+                return [{
+                  declaration: transform.DeclareOpaqueType(node.declaration),
+                  exportKind: 'type'
+                }];
+
+              case 'DeclareVariable':
+                return [{
+                  declaration: transform.DeclareVariable(node.declaration),
+                  exportKind: 'value'
+                }];
+
+              case 'DeclareEnum':
+                {
+                  const result = transform.DeclareEnum(node.declaration);
+                  return Array.isArray(result) ? [{
+                    declaration: result[0],
+                    exportKind: 'type'
+                  }, {
+                    declaration: result[1],
+                    exportKind: 'type'
+                  }] : [{
+                    declaration: result,
+                    exportKind: 'type'
+                  }];
+                }
+            }
+          })();
+
+          const mappedDeclarations = declarations.map(({
+            declaration,
+            exportKind
+          }) => {
+            if (declaration.type === 'VariableDeclaration' && declaration.declarations.length === 1) {
+              const ident = declaration.declarations[0].id;
+
+              if (ident.type === 'Identifier') {
+                const name = ident.name;
+                return [{
+                  type: 'ExportNamedDeclaration',
+                  loc: DUMMY_LOC,
+                  // flow does not currently support assertions
+                  assertions: [],
+                  declaration,
+                  exportKind,
+                  source: null,
+                  specifiers: []
+                }, {
+                  type: 'ExportNamedDeclaration',
+                  declaration: {
+                    type: 'TSTypeAliasDeclaration',
+                    declare: true,
+                    id: {
+                      type: 'Identifier',
+                      decorators: [],
+                      name,
+                      optional: false,
+                      loc: DUMMY_LOC
+                    },
+                    typeAnnotation: {
+                      type: 'TSTypeQuery',
+                      exprName: {
+                        type: 'Identifier',
+                        decorators: [],
+                        name,
+                        optional: false,
+                        loc: DUMMY_LOC
+                      },
+                      loc: DUMMY_LOC
+                    },
+                    loc: DUMMY_LOC
+                  },
+                  source: null,
+                  loc: DUMMY_LOC,
+                  specifiers: [],
+                  exportKind: 'type',
+                  // flow does not currently support assertions
+                  assertions: []
+                }];
+              }
+            }
+
+            const exportNamedDeclaration = {
+              type: 'ExportNamedDeclaration',
+              loc: DUMMY_LOC,
+              // flow does not currently support assertions
+              assertions: [],
+              declaration,
+              exportKind,
+              source: null,
+              specifiers: []
+            };
+            return exportNamedDeclaration;
+          });
+          return mappedDeclarations.flat();
+        } else {
+          return {
+            type: 'ExportNamedDeclaration',
+            loc: DUMMY_LOC,
+            // flow does not currently support assertions
+            assertions: [],
+            declaration: null,
+            // flow does not support declared type exports with a source
+            exportKind: 'value',
+            source: transform.StringLiteral(node.source),
+            specifiers: node.specifiers.map(transform.ExportSpecifier)
+          };
+        }
+      }
+    },
+
+    DeclareComponent(node) {
+      const id = transform.Identifier(node.id, false);
+      const typeParameters = node.typeParameters == null ? undefined : transform.TypeParameterDeclaration(node.typeParameters);
+      const params = transform.ComponentTypeParameters(node.params, node.rest); // TS cannot support `renderType` so we always use ReactNode as the return type.
+
+      const hasReactImport = isReactImport(node, 'React');
+      const returnType = {
+        type: 'TSTypeAnnotation',
+        loc: DUMMY_LOC,
+        // If no rendersType we assume its ReactNode type.
+        typeAnnotation: {
+          type: 'TSTypeReference',
+          loc: DUMMY_LOC,
+          typeName: {
+            type: 'TSQualifiedName',
+            loc: DUMMY_LOC,
+            left: getReactIdentifier(hasReactImport),
+            right: {
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: `ReactNode`
+            }
+          },
+          typeParameters: undefined
+        }
+      };
+      return {
+        type: 'TSDeclareFunction',
+        loc: DUMMY_LOC,
+        async: false,
+        body: undefined,
+        declare: true,
+        expression: false,
+        generator: false,
+        id: {
+          type: 'Identifier',
+          loc: DUMMY_LOC,
+          name: id.name
+        },
+        params,
+        returnType: returnType,
+        typeParameters: typeParameters
+      };
+    },
+
+    ComponentTypeParameters(params, rest) {
+      if (params.length === 0 && rest != null) {
+        return [{
+          type: 'Identifier',
+          loc: DUMMY_LOC,
+          name: 'props',
+          typeAnnotation: {
+            type: 'TSTypeAnnotation',
+            loc: DUMMY_LOC,
+            typeAnnotation: transformTypeAnnotationType(rest.typeAnnotation)
+          },
+          optional: false
+        }];
+      }
+
+      const flowPropsType = [];
+
+      if (rest != null) {
+        flowPropsType.push(constructFlowNode({
+          type: 'ObjectTypeSpreadProperty',
+          argument: rest.typeAnnotation,
+          range: rest.range,
+          loc: rest.loc
+        }));
+      }
+
+      for (let i = 0; i < params.length; i++) {
+        var _param$name;
+
+        const param = params[i];
+        flowPropsType.push(constructFlowNode({
+          type: 'ObjectTypeProperty',
+          kind: 'init',
+          method: false,
+          optional: param.optional,
+          variance: null,
+          proto: false,
+          static: false,
+          key: (_param$name = param.name) != null ? _param$name : constructFlowNode({
+            type: 'Identifier',
+            name: `$$PARAM_${i}$$`,
+            optional: false,
+            typeAnnotation: null
+          }),
+          value: param.typeAnnotation,
+          range: param.range,
+          loc: param.loc
+        }));
+      }
+
+      const tsPropsObjectType = transform.ObjectTypeAnnotation(constructFlowNode({
+        type: 'ObjectTypeAnnotation',
+        inexact: false,
+        exact: true,
+        properties: flowPropsType,
+        indexers: [],
+        callProperties: [],
+        internalSlots: []
+      }));
+      return [{
+        type: 'Identifier',
+        loc: DUMMY_LOC,
+        name: 'props',
+        typeAnnotation: {
+          type: 'TSTypeAnnotation',
+          loc: DUMMY_LOC,
+          typeAnnotation: tsPropsObjectType
+        },
+        optional: false
+      }];
+    },
+
+    DeclareHook(node) {
+      // the hook params/returnType are stored as an annotation on the ID...
+      const id = transform.Identifier(node.id, false);
+      const functionInfo = transform.FunctionTypeAnnotation(node.id.typeAnnotation.typeAnnotation);
+      return {
+        type: 'TSDeclareFunction',
+        loc: DUMMY_LOC,
+        async: false,
+        body: undefined,
+        declare: true,
+        expression: false,
+        generator: false,
+        id: {
+          type: 'Identifier',
+          loc: DUMMY_LOC,
+          name: id.name
+        },
+        params: functionInfo.params,
+        returnType: functionInfo.returnType,
+        typeParameters: functionInfo.typeParameters
+      };
+    },
+
+    DeclareFunction(node) {
+      // the function information is stored as an annotation on the ID...
+      const id = transform.Identifier(node.id, false);
+      const functionInfo = transform.FunctionTypeAnnotation(node.id.typeAnnotation.typeAnnotation);
+      return {
+        type: 'TSDeclareFunction',
+        loc: DUMMY_LOC,
+        async: false,
+        body: undefined,
+        declare: true,
+        expression: false,
+        generator: false,
+        id: {
+          type: 'Identifier',
+          loc: DUMMY_LOC,
+          name: id.name
+        },
+        params: functionInfo.params,
+        returnType: functionInfo.returnType,
+        typeParameters: functionInfo.typeParameters
+      };
+    },
+
+    DeclareInterface(node) {
+      const transformedBody = transform.ObjectTypeAnnotation(node.body);
+
+      if (transformedBody.type !== 'TSTypeLiteral') {
+        throw translationError(node.body, 'Spreads in interfaces are not allowed');
+      }
+
+      return {
+        type: 'TSInterfaceDeclaration',
+        loc: DUMMY_LOC,
+        body: {
+          type: 'TSInterfaceBody',
+          loc: DUMMY_LOC,
+          body: transformedBody.members
+        },
+        declare: node.type !== 'InterfaceDeclaration',
+        extends: node.extends.map(transform.InterfaceExtends),
+        id: transform.Identifier(node.id, false),
+        typeParameters: node.typeParameters == null ? undefined : transform.TypeParameterDeclaration(node.typeParameters)
+      };
+    },
+
+    DeclareTypeAlias(node) {
+      return {
+        type: 'TSTypeAliasDeclaration',
+        loc: DUMMY_LOC,
+        declare: node.type === 'DeclareTypeAlias',
+        id: transform.Identifier(node.id, false),
+        typeAnnotation: transformTypeAnnotationType(node.right),
+        typeParameters: node.typeParameters == null ? undefined : transform.TypeParameterDeclaration(node.typeParameters)
+      };
+    },
+
+    DeclareOpaqueType(node) {
+      // TS doesn't currently have nominal types - https://github.com/Microsoft/Typescript/issues/202
+      // TODO - we could simulate this in a variety of ways
+      // Examples - https://basarat.gitbook.io/typescript/main-1/nominaltyping
+      if (node.supertype == null && node.typeParameters == null) {
+        const name = `__${node.id.name}__`;
+        return {
+          type: 'TSTypeAliasDeclaration',
+          loc: DUMMY_LOC,
+          declare: true,
+          id: transform.Identifier(node.id, false),
+          typeAnnotation: {
+            type: 'TSIntersectionType',
+            types: [{
+              type: 'TSSymbolKeyword',
+              loc: DUMMY_LOC
+            }, {
+              type: 'TSTypeLiteral',
+              loc: DUMMY_LOC,
+              members: [{
+                type: 'TSPropertySignature',
+                computed: false,
+                loc: DUMMY_LOC,
+                key: {
+                  type: 'Identifier',
+                  name: name,
+                  loc: DUMMY_LOC
+                },
+                typeAnnotation: {
+                  type: 'TSTypeAnnotation',
+                  loc: DUMMY_LOC,
+                  typeAnnotation: {
+                    type: 'TSStringKeyword',
+                    loc: DUMMY_LOC
+                  }
+                }
+              }]
+            }],
+            loc: DUMMY_LOC
+          }
+        };
+      }
+
+      return {
+        type: 'TSTypeAliasDeclaration',
+        loc: DUMMY_LOC,
+        declare: true,
+        id: transform.Identifier(node.id, false),
+        typeAnnotation: node.supertype == null ? {
+          type: 'TSUnknownKeyword',
+          loc: DUMMY_LOC
+        } : transformTypeAnnotationType(node.supertype),
+        typeParameters: node.typeParameters == null ? undefined : transform.TypeParameterDeclaration(node.typeParameters)
+      };
+    },
+
+    DeclareVariable(node) {
+      return {
+        type: 'VariableDeclaration',
+        loc: DUMMY_LOC,
+        declare: true,
+        declarations: [{
+          type: 'VariableDeclarator',
+          loc: DUMMY_LOC,
+          declare: true,
+          id: transform.Identifier(node.id, true),
+          init: null
+        }],
+        kind: node.kind
+      };
+    },
+
+    DeclareEnum(node) {
+      return EnumImpl(node);
+    },
+
+    EmptyTypeAnnotation(node) {
+      // Flow's `empty` type doesn't map well to any types in TS.
+      // The closest is `never`, but `never` has a number of different semantics
+      // In reality no human code should ever directly use the `empty` type in flow
+      // So let's put a pin in it for now
+      return unsupportedAnnotation(node, 'empty type');
+    },
+
+    EnumDeclaration(node) {
+      return EnumImpl(node);
+    },
+
+    DeclareModuleExports(node) {
+      throw translationError(node, 'CommonJS exports are not supported.');
+    },
+
+    ExistsTypeAnnotation(node) {
+      // The existential type does not map to any types in TS
+      // It's also super deprecated - so let's not ever worry
+      return unsupportedAnnotation(node, 'existential type');
+    },
+
+    ExportAllDeclaration(node) {
+      return {
+        type: 'ExportAllDeclaration',
+        loc: DUMMY_LOC,
+        // flow does not currently support import/export assertions
+        assertions: [],
+        exportKind: node.exportKind,
+        source: transform.StringLiteral(node.source),
+        exported: node.exported == null ? null : transform.Identifier(node.exported)
+      };
+    },
+
+    ExportNamedDeclaration(node) {
+      if (node.source != null || node.specifiers.length > 0) {
+        // can never have a declaration with a source
+        return {
+          type: 'ExportNamedDeclaration',
+          loc: DUMMY_LOC,
+          // flow does not currently support import/export assertions
+          assertions: [],
+          declaration: null,
+          exportKind: node.exportKind,
+          source: node.source == null ? null : transform.StringLiteral(node.source),
+          specifiers: node.specifiers.map(transform.ExportSpecifier)
+        };
+      }
+
+      const [exportedDeclaration, mergedDeclaration] = (() => {
+        if (node.declaration == null) {
+          return [null, null];
+        }
+
+        switch (node.declaration.type) {
+          case 'ClassDeclaration':
+          case 'ComponentDeclaration':
+          case 'HookDeclaration':
+          case 'FunctionDeclaration':
+          case 'VariableDeclaration':
+            // These cases shouldn't happen in flow defs because they have their own special
+            // AST node (DeclareClass, DeclareFunction, DeclareVariable)
+            throw unexpectedTranslationError(node.declaration, `Unexpected named declaration found ${node.declaration.type}`);
+
+          case 'EnumDeclaration':
+            {
+              const result = transform.EnumDeclaration(node.declaration);
+              return Array.isArray(result) ? result : [result, null];
+            }
+
+          case 'InterfaceDeclaration':
+            return [transform.InterfaceDeclaration(node.declaration), null];
+
+          case 'OpaqueType':
+            return [transform.OpaqueType(node.declaration), null];
+
+          case 'TypeAlias':
+            return [transform.TypeAlias(node.declaration), null];
+        }
+      })();
+
+      const mainExport = {
+        type: 'ExportNamedDeclaration',
+        loc: DUMMY_LOC,
+        assertions: [],
+        declaration: exportedDeclaration,
+        exportKind: node.exportKind,
+        source: null,
+        specifiers: []
+      };
+
+      if (mergedDeclaration != null) {
+        // for cases where there is a merged declaration, TS enforces BOTH are exported
+        return [mainExport, {
+          type: 'ExportNamedDeclaration',
+          loc: DUMMY_LOC,
+          assertions: [],
+          declaration: mergedDeclaration,
+          exportKind: node.exportKind,
+          source: null,
+          specifiers: []
+        }];
+      }
+
+      return mainExport;
+    },
+
+    ExportSpecifier(node) {
+      return {
+        type: 'ExportSpecifier',
+        loc: DUMMY_LOC,
+        exported: transform.Identifier(node.exported, false),
+        local: transform.Identifier(node.local, false),
+        // flow does not support inline exportKind for named exports
+        exportKind: 'value'
+      };
+    },
+
+    FunctionTypeAnnotation(node) {
+      const params = node.params.map(transform.FunctionTypeParam);
+
+      if (node.type === 'FunctionTypeAnnotation' && node.this != null) {
+        params.unshift({
+          type: 'Identifier',
+          loc: DUMMY_LOC,
+          name: 'this',
+          typeAnnotation: {
+            type: 'TSTypeAnnotation',
+            loc: DUMMY_LOC,
+            typeAnnotation: transformTypeAnnotationType(node.this.typeAnnotation)
+          }
+        });
+      }
+
+      if (node.rest != null) {
+        const rest = node.rest;
+        params.push({
+          type: 'RestElement',
+          loc: DUMMY_LOC,
+          argument: rest.name == null ? {
+            type: 'Identifier',
+            loc: DUMMY_LOC,
+            name: '$$REST$$'
+          } : transform.Identifier(rest.name, false),
+          typeAnnotation: {
+            type: 'TSTypeAnnotation',
+            loc: DUMMY_LOC,
+            typeAnnotation: transformTypeAnnotationType(rest.typeAnnotation)
+          }
+        });
+      }
+
+      return {
+        type: 'TSFunctionType',
+        loc: DUMMY_LOC,
+        params,
+        returnType: {
+          type: 'TSTypeAnnotation',
+          loc: DUMMY_LOC,
+          typeAnnotation: transformTypeAnnotationType(node.returnType)
+        },
+        typeParameters: node.typeParameters == null ? undefined : transform.TypeParameterDeclaration(node.typeParameters)
+      };
+    },
+
+    FunctionTypeParam(node, idx = 0) {
+      return {
+        type: 'Identifier',
+        loc: DUMMY_LOC,
+        name: node.name == null ? `$$PARAM_${idx}$$` : node.name.name,
+        typeAnnotation: {
+          type: 'TSTypeAnnotation',
+          loc: DUMMY_LOC,
+          typeAnnotation: transformTypeAnnotationType(node.typeAnnotation)
+        },
+        optional: node.optional
+      };
+    },
+
+    GenericTypeAnnotation(node) {
+      const [fullTypeName, baseId] = (() => {
+        let names = [];
+        let currentNode = node.id;
+
+        while (currentNode != null) {
+          switch (currentNode.type) {
+            case 'Identifier':
+              {
+                names.unshift(currentNode.name);
+                return [names.join('.'), currentNode];
+              }
+
+            case 'QualifiedTypeIdentifier':
+              {
+                names.unshift(currentNode.id.name);
+                currentNode = currentNode.qualification;
+                break;
+              }
+          }
+        }
+
+        throw translationError(node, `Invalid program state, types should only contain 'Identifier' and 'QualifiedTypeIdentifier' nodes.`);
+      })();
+
+      const assertHasExactlyNTypeParameters = count => {
+        if (node.typeParameters != null) {
+          if (node.typeParameters.params.length !== count) {
+            throw translationError(node, `Expected exactly ${count} type parameter${count > 1 ? 's' : ''} with \`${fullTypeName}\``);
+          }
+
+          const res = [];
+
+          for (const param of node.typeParameters.params) {
+            res.push(transformTypeAnnotationType(param));
+          }
+
+          return res;
+        }
+
+        if (count !== 0) {
+          throw translationError(node, `Expected no type parameters with \`${fullTypeName}\``);
+        }
+
+        return [];
+      };
+
+      function assertHasTypeParametersInRange(min, max) {
+        const {
+          typeParameters
+        } = node;
+
+        if (typeParameters == null) {
+          if (min > 0) {
+            throw translationError(node, `Expected between ${min} and ${max} type parameters with \`${fullTypeName}\`, but got none.`);
+          }
+
+          return [];
+        }
+
+        const params = typeParameters.params;
+
+        if (params.length < min || params.length > max) {
+          throw translationError(node, `Expected between ${min} and ${max} type parameters with \`${fullTypeName}\`, but got ${params.length}.`);
+        }
+
+        return typeParameters.params.map(transformTypeAnnotationType);
+      }
+
+      switch (fullTypeName) {
+        case '$Call':
+        case '$ObjMap':
+        case '$ObjMapConst':
+        case '$ObjMapi':
+        case '$TupleMap':
+          {
+            /*
+            TODO - I don't think it's possible to make these types work in the generic case.
+             TS has no utility types that allow you to generically mimic this functionality.
+            You really need intimiate knowledge of the user's intent in order to correctly
+            transform the code.
+             For example the simple example for $Call from the flow docs:
+            ```
+            type ExtractPropType = <T>({prop: T}) => T;
+            type Obj = {prop: number};
+            type PropType = $Call<ExtractPropType, Obj>;
+            // expected -- typeof PropType === number
+            ```
+             The equivalent in TS would be:
+            ```
+            type ExtractPropType<T extends { prop: any }> = (arg: T) => T['prop'];
+            type Obj = { prop: number };
+            type PropType = ReturnType<ExtractPropType<Obj>>; // number
+            ```
+            */
+            return unsupportedAnnotation(node, fullTypeName);
+          }
+
+        case '$ArrayBufferView':
+          {
+            // `$ArrayBufferView` => `ArrayBufferView`
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'Identifier',
+                loc: DUMMY_LOC,
+                name: 'ArrayBufferView'
+              }
+            };
+          }
+
+        case '$ArrayLike':
+          {
+            // `$ArrayLike<T>` => `ArrayLike<T>`
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'Identifier',
+                loc: DUMMY_LOC,
+                name: 'ArrayLike'
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: assertHasExactlyNTypeParameters(1)
+              }
+            };
+          }
+
+        case '$Diff':
+        case '$Rest':
+          {
+            // `$Diff<A, B>` => `Pick<A, Exclude<keyof A, keyof B>>`
+            const params = assertHasExactlyNTypeParameters(2);
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'Identifier',
+                loc: DUMMY_LOC,
+                name: 'Pick'
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: [params[0], {
+                  type: 'TSTypeReference',
+                  loc: DUMMY_LOC,
+                  typeName: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: 'Exclude'
+                  },
+                  typeParameters: {
+                    type: 'TSTypeParameterInstantiation',
+                    loc: DUMMY_LOC,
+                    params: [{
+                      type: 'TSTypeOperator',
+                      loc: DUMMY_LOC,
+                      operator: 'keyof',
+                      typeAnnotation: params[0]
+                    }, {
+                      type: 'TSTypeOperator',
+                      loc: DUMMY_LOC,
+                      operator: 'keyof',
+                      typeAnnotation: params[1]
+                    }]
+                  }
+                }]
+              }
+            };
+          }
+
+        case '$ElementType':
+        case '$PropertyType':
+          {
+            // `$ElementType<T, K>` => `T[K]`
+            const params = assertHasExactlyNTypeParameters(2);
+            return {
+              type: 'TSIndexedAccessType',
+              loc: DUMMY_LOC,
+              objectType: params[0],
+              indexType: params[1]
+            };
+          }
+
+        case '$Exact':
+          {
+            // `$Exact<T>` => `T`
+            // TS has no concept of exact vs inexact types
+            return assertHasExactlyNTypeParameters(1)[0];
+          }
+
+        case '$Exports':
+          {
+            // `$Exports<'module'>` => `typeof import('module')`
+            const moduleName = assertHasExactlyNTypeParameters(1)[0];
+
+            if (moduleName.type !== 'TSLiteralType' || moduleName.literal.type !== 'Literal' || typeof moduleName.literal.value !== 'string') {
+              throw translationError(node, '$Exports must have a string literal argument');
+            }
+
+            return {
+              type: 'TSImportType',
+              loc: DUMMY_LOC,
+              isTypeOf: true,
+              argument: moduleName,
+              qualifier: null,
+              typeParameters: null
+            };
+          }
+
+        case '$FlowFixMe':
+          {
+            // `$FlowFixMe` => `any`
+            return {
+              type: 'TSAnyKeyword',
+              loc: DUMMY_LOC
+            };
+          }
+
+        case '$KeyMirror':
+          {
+            // `$KeyMirror<T>` => `{[K in keyof T]: K}`
+            return {
+              type: 'TSMappedType',
+              loc: DUMMY_LOC,
+              typeParameter: {
+                type: 'TSTypeParameter',
+                loc: DUMMY_LOC,
+                name: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: 'K'
+                },
+                constraint: {
+                  type: 'TSTypeOperator',
+                  loc: DUMMY_LOC,
+                  operator: 'keyof',
+                  typeAnnotation: assertHasExactlyNTypeParameters(1)[0]
+                },
+                in: false,
+                out: false
+              },
+              nameType: null,
+              typeAnnotation: {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: 'K'
+                }
+              }
+            };
+          }
+
+        case '$Keys':
+          {
+            // `$Keys<T>` => `keyof T`
+            return {
+              type: 'TSTypeOperator',
+              loc: DUMMY_LOC,
+              operator: 'keyof',
+              typeAnnotation: assertHasExactlyNTypeParameters(1)[0]
+            };
+          }
+
+        case '$NonMaybeType':
+          {
+            // `$NonMaybeType<T>` => `NonNullable<T>`
+            // Not a great name because `NonNullable` also excludes `undefined`
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'Identifier',
+                loc: DUMMY_LOC,
+                name: 'NonNullable'
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: assertHasExactlyNTypeParameters(1)
+              }
+            };
+          }
+
+        case '$ReadOnly':
+          {
+            // `$ReadOnly<T>` => `Readonly<T>`
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'Identifier',
+                loc: DUMMY_LOC,
+                name: 'Readonly'
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: assertHasExactlyNTypeParameters(1)
+              }
+            };
+          }
+
+        case '$ReadOnlyArray':
+          {
+            // `$ReadOnlyArray<T>` => `ReadonlyArray<T>`
+            //
+            // we could also do    => `readonly T[]`
+            // TODO - maybe a config option?
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'Identifier',
+                loc: DUMMY_LOC,
+                name: 'ReadonlyArray'
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: assertHasExactlyNTypeParameters(1)
+              }
+            };
+          }
+
+        case '$ReadOnlyMap':
+          {
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'Identifier',
+                loc: DUMMY_LOC,
+                name: 'ReadonlyMap'
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: assertHasExactlyNTypeParameters(2)
+              }
+            };
+          }
+
+        case '$ReadOnlySet':
+          {
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'Identifier',
+                loc: DUMMY_LOC,
+                name: 'ReadonlySet'
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: assertHasExactlyNTypeParameters(1)
+              }
+            };
+          }
+
+        case '$Values':
+          {
+            // `$Values<T>` => `T[keyof T]`
+            const transformedType = assertHasExactlyNTypeParameters(1)[0];
+            return {
+              type: 'TSIndexedAccessType',
+              loc: DUMMY_LOC,
+              objectType: transformedType,
+              indexType: {
+                type: 'TSTypeOperator',
+                loc: DUMMY_LOC,
+                operator: 'keyof',
+                typeAnnotation: transformedType
+              }
+            };
+          }
+
+        case 'Class':
+          {
+            // `Class<T>` => `new (...args: any[]) => T`
+            const param = assertHasExactlyNTypeParameters(1)[0];
+
+            if (param.type !== 'TSTypeReference') {
+              throw translationError(node, 'Expected a type reference within Class<T>');
+            }
+
+            return {
+              type: 'TSConstructorType',
+              loc: DUMMY_LOC,
+              abstract: false,
+              params: [{
+                type: 'RestElement',
+                loc: DUMMY_LOC,
+                argument: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: 'args'
+                },
+                typeAnnotation: {
+                  type: 'TSTypeAnnotation',
+                  loc: DUMMY_LOC,
+                  typeAnnotation: {
+                    type: 'TSArrayType',
+                    loc: DUMMY_LOC,
+                    elementType: {
+                      type: 'TSAnyKeyword',
+                      loc: DUMMY_LOC
+                    }
+                  }
+                }
+              }],
+              returnType: {
+                type: 'TSTypeAnnotation',
+                loc: DUMMY_LOC,
+                typeAnnotation: param
+              }
+            };
+          }
+
+        case 'StringPrefix':
+          {
+            var _params$;
+
+            // `StringPrefix<foo>` => `foo${string}`
+            // `StringPrefix<foo, T>` => `foo${T}`
+            const params = assertHasTypeParametersInRange(1, 2);
+            const prefix = params[0];
+
+            if (prefix.type !== 'TSLiteralType' || typeof prefix.literal.value !== 'string') {
+              throw translationError(node, 'Expected a string literal for the first type parameter.');
+            }
+
+            const prefixStr = prefix.literal.value;
+            const remainder = (_params$ = params[1]) != null ? _params$ : {
+              type: 'TSStringKeyword',
+              loc: DUMMY_LOC
+            };
+            return {
+              type: 'TSTemplateLiteralType',
+              loc: DUMMY_LOC,
+              quasis: [{
+                type: 'TemplateElement',
+                loc: DUMMY_LOC,
+                value: {
+                  raw: prefixStr,
+                  cooked: prefixStr
+                },
+                tail: false
+              }, {
+                type: 'TemplateElement',
+                loc: DUMMY_LOC,
+                value: {
+                  raw: '',
+                  cooked: ''
+                },
+                tail: true
+              }],
+              types: [remainder]
+            };
+          }
+
+        case 'StringSuffix':
+          {
+            var _params$2;
+
+            // `StringSuffix<foo>` => `${string}foo`
+            // `StringSuffix<foo, T>` => `${T}foo`
+            const params = assertHasTypeParametersInRange(1, 2);
+            const suffix = params[0];
+
+            if (suffix.type !== 'TSLiteralType' || typeof suffix.literal.value !== 'string') {
+              throw translationError(node, 'Expected a string literal for the first type parameter.');
+            }
+
+            const suffixStr = suffix.literal.value;
+            const remainder = (_params$2 = params[1]) != null ? _params$2 : {
+              type: 'TSStringKeyword',
+              loc: DUMMY_LOC
+            };
+            return {
+              type: 'TSTemplateLiteralType',
+              loc: DUMMY_LOC,
+              quasis: [{
+                type: 'TemplateElement',
+                loc: DUMMY_LOC,
+                value: {
+                  raw: '',
+                  cooked: ''
+                },
+                tail: false
+              }, {
+                type: 'TemplateElement',
+                loc: DUMMY_LOC,
+                value: {
+                  raw: suffixStr,
+                  cooked: suffixStr
+                },
+                tail: true
+              }],
+              types: [remainder]
+            };
+          }
+      } // React special conversion:
+
+
+      const validReactImportOrGlobal = isValidReactImportOrGlobal(baseId);
+      const hasReactImport = isReactImport(baseId, baseId.name);
+
+      if (validReactImportOrGlobal || hasReactImport) {
+        switch (fullTypeName) {
+          // TODO: In flow this is `ChildrenArray<T> = T | $ReadOnlyArray<ChildrenArray<T>>`.
+          // The recursive nature of it is rarely needed, so we're simplifying this for now
+          // but omitting that aspect. Once we're able to provide utility types for our translations,
+          // we should update this.
+          // React.ChildrenArray<T> -> T | ReadonlyArray<T>
+          // React$ChildrenArray<T> -> T | ReadonlyArray<T>
+          case 'React.ChildrenArray':
+          case 'React$ChildrenArray':
+            {
+              const [param] = assertHasExactlyNTypeParameters(1);
+              return {
+                type: 'TSUnionType',
+                loc: DUMMY_LOC,
+                types: [param, {
+                  type: 'TSTypeReference',
+                  loc: DUMMY_LOC,
+                  typeName: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: 'ReadonlyArray'
+                  },
+                  typeParameters: {
+                    type: 'TSTypeParameterInstantiation',
+                    loc: DUMMY_LOC,
+                    params: [param]
+                  }
+                }]
+              };
+            }
+          // React.Component<A,B> -> React.Component<A,B>
+          // React$Component<A,B> -> React.Component<A,B>
+
+          case 'React.Component':
+          case 'React$Component':
+            {
+              const typeParameters = node.typeParameters;
+
+              if (typeParameters == null || typeParameters.params.length === 0) {
+                throw translationError(node, `Expected at least 1 type parameter with \`${fullTypeName}\``);
+              }
+
+              const params = typeParameters.params;
+
+              if (params.length > 2) {
+                throw translationError(node, `Expected at no more than 2 type parameters with \`${fullTypeName}\``);
+              }
+
+              return {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'TSQualifiedName',
+                  loc: DUMMY_LOC,
+                  left: getReactIdentifier(hasReactImport),
+                  right: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: 'Component'
+                  }
+                },
+                typeParameters: {
+                  type: 'TSTypeParameterInstantiation',
+                  loc: DUMMY_LOC,
+                  params: params.map(param => transformTypeAnnotationType(param))
+                }
+              };
+            }
+          // React.Context<A> -> React.Context<A>
+          // React$Context<A> -> React.Context<A>
+
+          case 'React$Context':
+          case 'React.Context':
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'TSQualifiedName',
+                loc: DUMMY_LOC,
+                left: getReactIdentifier(hasReactImport),
+                right: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: `Context`
+                }
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: assertHasExactlyNTypeParameters(1)
+              }
+            };
+          // React.Key -> React.Key
+          // React$Key -> React.Key
+
+          case 'React.Key':
+          case 'React$Key':
+            assertHasExactlyNTypeParameters(0);
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'TSQualifiedName',
+                loc: DUMMY_LOC,
+                left: getReactIdentifier(hasReactImport),
+                right: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: 'Key'
+                }
+              }
+            };
+          // React.ElementType -> React.ElementType
+          // React$ElementType -> React.ElementType
+
+          case 'React$ElementType':
+          case 'React.ElementType':
+            {
+              assertHasExactlyNTypeParameters(0);
+              return {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'TSQualifiedName',
+                  loc: DUMMY_LOC,
+                  left: getReactIdentifier(hasReactImport),
+                  right: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: `ElementType`
+                  }
+                },
+                typeParameters: undefined
+              };
+            }
+          // React.Node -> React.ReactNode
+
+          case 'React$Node':
+          case 'React.Node':
+            {
+              assertHasExactlyNTypeParameters(0);
+              return {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'TSQualifiedName',
+                  loc: DUMMY_LOC,
+                  left: getReactIdentifier(hasReactImport),
+                  right: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: `ReactNode`
+                  }
+                },
+                typeParameters: undefined
+              };
+            }
+          // React.Element<typeof Component> -> React.ReactElement<typeof Component>
+
+          case 'React$Element':
+          case 'React.Element':
+            {
+              return {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'TSQualifiedName',
+                  loc: DUMMY_LOC,
+                  left: getReactIdentifier(hasReactImport),
+                  right: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: `ReactElement`
+                  }
+                },
+                typeParameters: {
+                  type: 'TSTypeParameterInstantiation',
+                  loc: DUMMY_LOC,
+                  params: assertHasExactlyNTypeParameters(1)
+                }
+              };
+            }
+          // React.ElementRef<typeof Component> -> React.ComponentRef<typeof Component>
+          // React$ElementRef<typeof Component> -> React.ComponentRef<typeof Component>
+
+          case 'React$ElementRef':
+          case 'React.ElementRef':
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'TSQualifiedName',
+                loc: DUMMY_LOC,
+                left: getReactIdentifier(hasReactImport),
+                right: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: `ComponentRef`
+                }
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: assertHasExactlyNTypeParameters(1)
+              }
+            };
+          // React$Fragment -> React.Fragment
+          // React.Fragment -> React.Fragment
+
+          case 'React$FragmentType':
+          case 'React.Fragment':
+            assertHasExactlyNTypeParameters(0);
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'TSQualifiedName',
+                loc: DUMMY_LOC,
+                left: getReactIdentifier(hasReactImport),
+                right: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: `Fragment`
+                }
+              }
+            };
+          // React.MixedElement -> React.JSX.Element
+
+          case 'React$MixedElement':
+          case 'React.MixedElement':
+            {
+              assertHasExactlyNTypeParameters(0);
+              return {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'TSQualifiedName',
+                  loc: DUMMY_LOC,
+                  left: {
+                    type: 'TSQualifiedName',
+                    loc: DUMMY_LOC,
+                    left: {
+                      type: 'Identifier',
+                      loc: DUMMY_LOC,
+                      name: 'React'
+                    },
+                    right: {
+                      type: 'Identifier',
+                      loc: DUMMY_LOC,
+                      name: 'JSX'
+                    }
+                  },
+                  right: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: 'Element'
+                  }
+                },
+                typeParameters: undefined
+              };
+            }
+          // React.ComponentType<Config> -> React.ComponentType<Config>
+          // React$ComponentType<Config> -> React.ComponentType<Config>
+
+          case 'React.ComponentType':
+          case 'React$ComponentType':
+            {
+              return {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'TSQualifiedName',
+                  loc: DUMMY_LOC,
+                  left: getReactIdentifier(hasReactImport),
+                  right: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: 'ComponentType'
+                  }
+                },
+                typeParameters: {
+                  type: 'TSTypeParameterInstantiation',
+                  loc: DUMMY_LOC,
+                  params: assertHasExactlyNTypeParameters(1)
+                }
+              };
+            }
+          // React.AbstractComponent<Config> -> React.ComponentType<Config>
+          // React$AbstractComponent<Config> -> React.ComponentType<Config>
+          // React.AbstractComponent<Config, Instance> -> React.ComponentType<Config & React.RefAttributes<Instance>>
+          // React$AbstractComponent<Config, Instance> -> React.ComponentType<Config & React.RefAttributes<Instance>>
+
+          case 'React.AbstractComponent':
+          case 'React$AbstractComponent':
+            {
+              const typeParameters = node.typeParameters;
+
+              if (typeParameters == null || typeParameters.params.length === 0) {
+                throw translationError(node, `Expected at least 1 type parameter with \`${fullTypeName}\``);
+              }
+
+              const params = typeParameters.params;
+
+              if (params.length > 3) {
+                throw translationError(node, `Expected at no more than 3 type parameters with \`${fullTypeName}\``);
+              }
+
+              const newParams = (() => {
+                if (params.length === 1) {
+                  return assertHasExactlyNTypeParameters(1);
+                }
+
+                const props = transformTypeAnnotationType(params[0]);
+                const ref = transformTypeAnnotationType(params[1]);
+                return [{
+                  type: 'TSIntersectionType',
+                  loc: DUMMY_LOC,
+                  types: [props, {
+                    type: 'TSTypeReference',
+                    loc: DUMMY_LOC,
+                    typeName: {
+                      type: 'TSQualifiedName',
+                      loc: DUMMY_LOC,
+                      left: {
+                        type: 'Identifier',
+                        loc: DUMMY_LOC,
+                        name: 'React'
+                      },
+                      right: {
+                        type: 'Identifier',
+                        loc: DUMMY_LOC,
+                        name: 'RefAttributes'
+                      }
+                    },
+                    typeParameters: {
+                      type: 'TSTypeParameterInstantiation',
+                      loc: DUMMY_LOC,
+                      params: [ref]
+                    }
+                  }]
+                }];
+              })();
+
+              return {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'TSQualifiedName',
+                  loc: DUMMY_LOC,
+                  left: getReactIdentifier(hasReactImport),
+                  right: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: 'ComponentType'
+                  }
+                },
+                typeParameters: {
+                  type: 'TSTypeParameterInstantiation',
+                  loc: DUMMY_LOC,
+                  params: newParams
+                }
+              };
+            }
+          // React.ElementProps<A> -> React.ComponentProps<A>
+          // React$ElementProps<A> -> React.ComponentProps<A>
+
+          case 'React.ElementProps':
+          case 'React$ElementProps':
+            {
+              return {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'TSQualifiedName',
+                  loc: DUMMY_LOC,
+                  left: getReactIdentifier(hasReactImport),
+                  right: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: 'ComponentProps'
+                  }
+                },
+                typeParameters: {
+                  type: 'TSTypeParameterInstantiation',
+                  loc: DUMMY_LOC,
+                  params: assertHasExactlyNTypeParameters(1)
+                }
+              };
+            }
+          // React.ElementConfig<A> ->  React.JSX.LibraryManagedAttributes<A, React.ComponentProps<A>>
+          // React$ElementConfig<A> ->  React.JSX.LibraryManagedAttributes<A, React.ComponentProps<A>>
+
+          case 'React.ElementConfig':
+          case 'React$ElementConfig':
+            {
+              const [param] = assertHasExactlyNTypeParameters(1);
+              return {
+                type: 'TSTypeReference',
+                loc: DUMMY_LOC,
+                typeName: {
+                  type: 'TSQualifiedName',
+                  loc: DUMMY_LOC,
+                  left: {
+                    type: 'TSQualifiedName',
+                    loc: DUMMY_LOC,
+                    left: {
+                      type: 'Identifier',
+                      loc: DUMMY_LOC,
+                      name: 'React'
+                    },
+                    right: {
+                      type: 'Identifier',
+                      loc: DUMMY_LOC,
+                      name: 'JSX'
+                    }
+                  },
+                  right: {
+                    type: 'Identifier',
+                    loc: DUMMY_LOC,
+                    name: 'LibraryManagedAttributes'
+                  }
+                },
+                typeParameters: {
+                  type: 'TSTypeParameterInstantiation',
+                  loc: DUMMY_LOC,
+                  params: [param, {
+                    type: 'TSTypeReference',
+                    loc: DUMMY_LOC,
+                    typeName: {
+                      type: 'TSQualifiedName',
+                      loc: DUMMY_LOC,
+                      left: getReactIdentifier(hasReactImport),
+                      right: {
+                        type: 'Identifier',
+                        loc: DUMMY_LOC,
+                        name: `ComponentProps`
+                      }
+                    },
+                    typeParameters: {
+                      type: 'TSTypeParameterInstantiation',
+                      loc: DUMMY_LOC,
+                      params: [param]
+                    }
+                  }]
+                }
+              };
+            }
+          // React.RefSetter<C> -> React.Ref<C>
+          // React$RefSetter<C> -> React.Ref<C>
+
+          case 'React.RefSetter':
+          case 'React$RefSetter':
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'TSQualifiedName',
+                loc: DUMMY_LOC,
+                left: getReactIdentifier(hasReactImport),
+                right: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: 'Ref'
+                }
+              },
+              typeParameters: {
+                type: 'TSTypeParameterInstantiation',
+                loc: DUMMY_LOC,
+                params: assertHasExactlyNTypeParameters(1)
+              }
+            };
+
+          default:
+            return unsupportedAnnotation(node, fullTypeName);
+        }
+      }
+
+      return {
+        type: 'TSTypeReference',
+        loc: DUMMY_LOC,
+        typeName: node.id.type === 'Identifier' ? transform.Identifier(node.id, false) : transform.QualifiedTypeIdentifier(node.id),
+        typeParameters: transform.TypeParameterInstantiation(node.typeParameters)
+      };
+    },
+
+    Identifier(node, includeTypeAnnotation = true) {
+      return {
+        type: 'Identifier',
+        loc: DUMMY_LOC,
+        name: node.name,
+        ...(includeTypeAnnotation && node.typeAnnotation != null ? {
+          typeAnnotation: transform.TypeAnnotation(node.typeAnnotation)
+        } : {})
+      };
+    },
+
+    IndexedAccessType(node) {
+      return {
+        type: 'TSIndexedAccessType',
+        loc: DUMMY_LOC,
+        objectType: transformTypeAnnotationType(node.objectType),
+        indexType: transformTypeAnnotationType(node.indexType)
+      };
+    },
+
+    InterfaceDeclaration(node) {
+      return transform.DeclareInterface(node);
+    },
+
+    ImportAttribute(node) {
+      return {
+        type: 'ImportAttribute',
+        loc: DUMMY_LOC,
+        key: node.key.type === 'Identifier' ? transform.Identifier(node.key) : transform.Literal(node.key),
+        value: transform.Literal(node.value)
+      };
+    },
+
+    ImportDeclaration(node) {
+      const importKind = node.importKind;
+      const specifiers = [];
+      const unsupportedSpecifiers = [];
+      node.specifiers.forEach(spec => {
+        let id = (() => {
+          if (node.importKind === 'typeof' || spec.importKind === 'typeof') {
+            const id = {
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: getPlaceholderNameForTypeofImport()
+            };
+            unsupportedSpecifiers.push({
+              type: 'TSTypeAliasDeclaration',
+              loc: DUMMY_LOC,
+              id: transform.Identifier(spec.local, false),
+              typeAnnotation: {
+                type: 'TSTypeQuery',
+                loc: DUMMY_LOC,
+                exprName: id
+              }
+            });
+            return id;
+          }
+
+          return transform.Identifier(spec.local, false);
+        })();
+
+        switch (spec.type) {
+          case 'ImportDefaultSpecifier':
+            specifiers.push({
+              type: 'ImportDefaultSpecifier',
+              loc: DUMMY_LOC,
+              local: id
+            });
+            return;
+
+          case 'ImportNamespaceSpecifier':
+            specifiers.push({
+              type: 'ImportNamespaceSpecifier',
+              loc: DUMMY_LOC,
+              local: id
+            });
+            return;
+
+          case 'ImportSpecifier':
+            specifiers.push({
+              type: 'ImportSpecifier',
+              loc: DUMMY_LOC,
+              importKind: spec.importKind === 'typeof' || spec.importKind === 'type' ? 'type' : null,
+              imported: transform.Identifier(spec.imported, false),
+              local: id
+            });
+            return;
+        }
+      });
+      const out = specifiers.length ? [{
+        type: 'ImportDeclaration',
+        loc: DUMMY_LOC,
+        assertions: node.assertions.map(transform.ImportAttribute),
+        importKind: importKind === 'typeof' ? 'type' : importKind != null ? importKind : 'value',
+        source: transform.StringLiteral(node.source),
+        specifiers
+      }] : [];
+      return [...out, ...unsupportedSpecifiers];
+    },
+
+    InterfaceExtends(node) {
+      return {
+        type: 'TSInterfaceHeritage',
+        loc: DUMMY_LOC,
+        expression: node.id.type === 'QualifiedTypeIdentifier' ? transform.QualifiedTypeIdentifier(node.id) : transform.Identifier(node.id, false),
+        typeParameters: transform.TypeParameterInstantiation(node.typeParameters)
+      };
+    },
+
+    InterfaceTypeAnnotation(node) {
+      if (node.extends) {
+        // type T = interface extends U, V { ... }
+        // to
+        // type T = U & V & { ... }
+        return {
+          type: 'TSIntersectionType',
+          loc: DUMMY_LOC,
+          types: [...node.extends.map(ex => ({
+            type: 'TSTypeReference',
+            loc: DUMMY_LOC,
+            // Bug: ex.id can be qualified
+            typeName: transform.Identifier(ex.id, false),
+            typeParameters: transform.TypeParameterInstantiation(ex.typeParameters)
+          })), transform.ObjectTypeAnnotation(node.body)]
+        };
+      }
+
+      return transform.ObjectTypeAnnotation(node.body);
+    },
+
+    IntersectionTypeAnnotation(node) {
+      return {
+        type: 'TSIntersectionType',
+        loc: DUMMY_LOC,
+        types: node.types.map(transformTypeAnnotationType)
+      };
+    },
+
+    Literal(node) {
+      switch (node.literalType) {
+        case 'bigint':
+          return transform.BigIntLiteral(node);
+
+        case 'boolean':
+          return transform.BooleanLiteral(node);
+
+        case 'null':
+          return transform.NullLiteral(node);
+
+        case 'numeric':
+          return transform.NumericLiteral(node);
+
+        case 'regexp':
+          return transform.RegExpLiteral(node);
+
+        case 'string':
+          return transform.StringLiteral(node);
+      }
+    },
+
+    MixedTypeAnnotation(_node) {
+      return {
+        type: 'TSUnknownKeyword',
+        loc: DUMMY_LOC
+      };
+    },
+
+    NullLiteral(_node) {
+      return {
+        type: 'Literal',
+        loc: DUMMY_LOC,
+        raw: 'null',
+        value: null
+      };
+    },
+
+    NullLiteralTypeAnnotation(_node) {
+      return {
+        type: 'TSNullKeyword',
+        loc: DUMMY_LOC
+      };
+    },
+
+    NullableTypeAnnotation(node) {
+      // TS doesn't support the maybe type, so have to explicitly union in `null | undefined`
+      // `?T` becomes `null | undefined | T`
+      return {
+        type: 'TSUnionType',
+        loc: DUMMY_LOC,
+        types: [{
+          type: 'TSNullKeyword',
+          loc: DUMMY_LOC
+        }, {
+          type: 'TSUndefinedKeyword',
+          loc: DUMMY_LOC
+        }, transformTypeAnnotationType(node.typeAnnotation)]
+      };
+    },
+
+    NumberLiteralTypeAnnotation(node) {
+      return {
+        type: 'TSLiteralType',
+        loc: DUMMY_LOC,
+        literal: {
+          type: 'Literal',
+          loc: DUMMY_LOC,
+          value: node.value,
+          raw: node.raw
+        }
+      };
+    },
+
+    NumberTypeAnnotation(_node) {
+      return {
+        type: 'TSNumberKeyword',
+        loc: DUMMY_LOC
+      };
+    },
+
+    NumericLiteral(node) {
+      return {
+        type: 'Literal',
+        loc: DUMMY_LOC,
+        raw: node.raw,
+        value: node.value
+      };
+    },
+
+    ObjectTypeAnnotation(node) {
+      if (node.properties.length === 1 && node.properties[0].type === 'ObjectTypeMappedTypeProperty') {
+        var _prop$variance;
+
+        // Mapped Object Object types must not have other object properties.
+        const prop = node.properties[0];
+        const tsProp = {
+          type: 'TSMappedType',
+          loc: DUMMY_LOC,
+          typeParameter: {
+            type: 'TSTypeParameter',
+            loc: DUMMY_LOC,
+            name: {
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: prop.keyTparam.name
+            },
+            constraint: transformTypeAnnotationType(prop.sourceType),
+            in: false,
+            out: false
+          },
+          readonly: ((_prop$variance = prop.variance) == null ? void 0 : _prop$variance.kind) === 'plus',
+          optional: prop.optional === 'Optional',
+          typeAnnotation: transformTypeAnnotationType(prop.propType),
+          nameType: null
+        };
+        return tsProp;
+      } // we want to preserve the source order of the members
+      // unfortunately flow has unordered properties storing things
+      // so store all elements with their start index and sort the
+      // list afterward
+
+
+      const members = [];
+
+      for (const callProp of node.callProperties) {
+        members.push({
+          start: callProp.range[0],
+          node: transform.ObjectTypeCallProperty(callProp)
+        });
+      }
+
+      for (const indexer of node.indexers) {
+        members.push({
+          start: indexer.range[0],
+          node: transform.ObjectTypeIndexer(indexer)
+        });
+      }
+      /*
+      TODO - internalSlots
+      I don't think there's anything analogous in TS.
+      They're really rarely used (if ever) - so let's just ignore them for now
+      */
+
+
+      if (node.internalSlots.length > 0) {
+        return unsupportedAnnotation(node.internalSlots[0], 'internal slots');
+      }
+
+      if (!node.properties.find(FlowESTree.isObjectTypeSpreadProperty)) {
+        for (const property of node.properties) {
+          if (property.type === 'ObjectTypeSpreadProperty') {
+            // this is imposible due to the above find condition
+            // this check is purely to satisfy flow
+            throw unexpectedTranslationError(property, 'Impossible state');
+          }
+
+          if (property.type === 'ObjectTypeMappedTypeProperty') {
+            return unsupportedAnnotation(property, 'object type with mapped type property along with other properties');
+          }
+
+          members.push({
+            start: property.range[0],
+            node: transform.ObjectTypeProperty(property)
+          });
+        }
+
+        const tsBody = members.sort((a, b) => a.start - b.start).map(({
+          node
+        }) => node);
+        return {
+          type: 'TSTypeLiteral',
+          loc: DUMMY_LOC,
+          members: tsBody
+        };
+      } else {
+        /*
+        spreads are a complicate thing for us to handle, sadly.
+        in flow type spreads are modelled after object spreads; meaning that for
+        { ...A, ...B } - all properties in B will explicitly replace any properties
+        in A of the same name.
+        ```
+        type T1 = { a: string };
+        type T2 = { a: number };
+        type T3 = { ...T1, ...T2 };
+        type A = T3['a'] // === number
+        ```
+         however in TS there are no object type spreads - you can only merge
+        objects either via the intersection operator or via interface extends.
+         For an interface extends - `interface B extends A { ... }` - TS enforces
+        that the properties of B are all covariantly related to the same named
+        properties in A.
+        So we can't use an interface extends.
+         For a type intersection - `type T = A & B;` - TS will (essentially) merge
+        the types by intersecting each same named property in each type to calculate
+        the resulting type. This has the effect of enforcing the same constraint
+        as the interface case, however instead of an error it causes properties to
+        become `never`:
+        ```
+        type T1 = { a: string };
+        type T2 = { a: number };
+        type T3 = T1 & T2;
+        type A = T3['a'] // === string & number === never
+        ```
+         So in order for us to model flow's spreads we have to explicitly omit the keys
+        from the proceeding type that might clash. We can do this pretty easily using
+        TS's utility types:
+        ```
+        type T1 = { a: string };
+        type T2 = { a: number };
+        type T3 = Omit<T1, keyof T2> & T2;
+        type A = T3['a'] // === number
+        ```
+         Unfortunately because we need to solve for the general case object type usage,
+        it's going to be a bit ugly and complicated, sadly.
+         If we had access to type information we would be able to skip some ugliness by
+        checking to see if there is any overlap and skipping the omit step if there isn't.
+        But alas - we're working purely syntactically.
+         ```
+        type T = { ...T1, b: string  };
+        // becomes
+        type T = Omit<T1, keyof { b: string }> & { b: string };
+        ```
+        ```
+        type T = { ...T1, ...T2, ...T3, b: string  };
+        // becomes
+        type T =
+          & Omit<T1, keyof T2 | keyof T3 | keyof { b: string }>
+          & Omit<T2, keyof T3 | keyof { b: string }>
+          & Omit<T3, keyof { b: string }>
+          & { b: string };
+        ```
+         Note that because it's going to be super ugly and complicated - for now we're going to disallow:
+        - spreads in the middle
+        - spreads at the end
+        - spreads of things that aren't "Identifiers"
+        */
+        if (members.length > 0) {
+          return unsupportedAnnotation(node, 'object types with spreads, indexers and/or call properties at the same time');
+        }
+
+        const typesToIntersect = [];
+
+        for (const property of node.properties) {
+          if (property.type === 'ObjectTypeSpreadProperty') {
+            if (members.length > 0) {
+              return unsupportedAnnotation(property, 'object types with spreads in the middle or at the end');
+            }
+
+            const spreadType = transformTypeAnnotationType(property.argument);
+
+            if (spreadType.type !== 'TSTypeReference' && spreadType.type !== 'TSTypeQuery') {
+              return unsupportedAnnotation(property, 'object types with complex spreads');
+            }
+
+            typesToIntersect.push(spreadType);
+          } else if (property.type === 'ObjectTypeMappedTypeProperty') {
+            // TODO - Support mapped types
+            return unsupportedAnnotation(property, 'object type with mapped type property');
+          } else {
+            members.push({
+              start: property.range[0],
+              node: transform.ObjectTypeProperty(property)
+            });
+          }
+        }
+
+        const tsBody = members.sort((a, b) => a.start - b.start).map(({
+          node
+        }) => node);
+        const objectType = {
+          type: 'TSTypeLiteral',
+          loc: DUMMY_LOC,
+          members: tsBody
+        };
+        const intersectionMembers = [];
+
+        for (let i = 0; i < typesToIntersect.length; i += 1) {
+          const currentType = typesToIntersect[i];
+          const remainingTypes = typesToIntersect.slice(i + 1);
+          intersectionMembers.push({
+            type: 'TSTypeReference',
+            loc: DUMMY_LOC,
+            typeName: {
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: 'Omit'
+            },
+            typeParameters: {
+              type: 'TSTypeParameterInstantiation',
+              loc: DUMMY_LOC,
+              params: [currentType, {
+                type: 'TSUnionType',
+                loc: DUMMY_LOC,
+                types: [...remainingTypes.map(t => ({
+                  type: 'TSTypeOperator',
+                  loc: DUMMY_LOC,
+                  operator: 'keyof',
+                  typeAnnotation: t
+                })), {
+                  type: 'TSTypeOperator',
+                  loc: DUMMY_LOC,
+                  operator: 'keyof',
+                  typeAnnotation: objectType
+                }]
+              }]
+            }
+          });
+        }
+
+        intersectionMembers.push(objectType);
+        return {
+          type: 'TSIntersectionType',
+          loc: DUMMY_LOC,
+          types: intersectionMembers
+        };
+      }
+    },
+
+    ObjectTypeCallProperty(node) {
+      // the info is stored on the "value"
+      const func = transform.FunctionTypeAnnotation(node.value);
+      return {
+        type: 'TSCallSignatureDeclaration',
+        loc: DUMMY_LOC,
+        params: func.params,
+        returnType: func.returnType,
+        typeParameters: func.typeParameters
+      };
+    },
+
+    ObjectTypeIndexer(node) {
+      var _node$variance2;
+
+      if (node.key.type === 'GenericTypeAnnotation') {
+        var _node$variance;
+
+        const ident = node.key.id.type === 'Identifier' ? node.key.id : node.key.id.id;
+        return {
+          type: 'TSPropertySignature',
+          computed: true,
+          loc: DUMMY_LOC,
+          key: {
+            type: 'BinaryExpression',
+            operator: 'in',
+            loc: DUMMY_LOC,
+            left: {
+              type: 'Identifier',
+              name: node.id == null ? '$$Key$$' : node.id.name,
+              loc: DUMMY_LOC
+            },
+            right: {
+              type: 'Identifier',
+              name: ident.name,
+              loc: DUMMY_LOC
+            }
+          },
+          readonly: ((_node$variance = node.variance) == null ? void 0 : _node$variance.kind) === 'plus',
+          static: node.static,
+          typeAnnotation: {
+            type: 'TSTypeAnnotation',
+            loc: DUMMY_LOC,
+            typeAnnotation: transformTypeAnnotationType(node.value)
+          }
+        };
+      }
+
+      return {
+        type: 'TSIndexSignature',
+        loc: DUMMY_LOC,
+        parameters: [{
+          type: 'Identifier',
+          loc: DUMMY_LOC,
+          name: node.id == null ? '$$Key$$' : node.id.name,
+          typeAnnotation: {
+            type: 'TSTypeAnnotation',
+            loc: DUMMY_LOC,
+            typeAnnotation: transformTypeAnnotationType(node.key)
+          }
+        }],
+        readonly: ((_node$variance2 = node.variance) == null ? void 0 : _node$variance2.kind) === 'plus',
+        static: node.static,
+        typeAnnotation: {
+          type: 'TSTypeAnnotation',
+          loc: DUMMY_LOC,
+          typeAnnotation: transformTypeAnnotationType(node.value)
+        }
+      };
+    },
+
+    ObjectTypeProperty(node) {
+      var _node$variance3;
+
+      const key = node.key.type === 'Identifier' ? transform.Identifier(node.key) : transform.StringLiteral(node.key);
+
+      if (node.method === true) {
+        // flow has just one node for all object properties and relies upon the method flag
+        // TS has separate nodes for methods and properties
+        const func = transform.FunctionTypeAnnotation(node.value);
+        return {
+          type: 'TSMethodSignature',
+          loc: DUMMY_LOC,
+          computed: false,
+          key,
+          kind: node.kind === 'init' ? 'method' : node.kind,
+          optional: node.optional,
+          params: func.params,
+          returnType: func.returnType,
+          static: node.static,
+          typeParameters: func.typeParameters
+        };
+      }
+
+      if (node.kind === 'get' || node.kind === 'set') {
+        // flow treats getters/setters as true property signatures (method === false)
+        // TS treats them as method signatures
+        const func = transform.FunctionTypeAnnotation(node.value);
+        return {
+          type: 'TSMethodSignature',
+          loc: DUMMY_LOC,
+          computed: false,
+          key,
+          kind: node.kind,
+          optional: false,
+          params: func.params,
+          // TS setters must not have a return type
+          returnType: node.kind === 'set' ? undefined : func.returnType,
+          static: node.static,
+          // TS accessors cannot have type parameters
+          typeParameters: undefined
+        };
+      }
+
+      return {
+        type: 'TSPropertySignature',
+        loc: DUMMY_LOC,
+        computed: false,
+        key,
+        optional: node.optional,
+        readonly: ((_node$variance3 = node.variance) == null ? void 0 : _node$variance3.kind) === 'plus',
+        static: node.static,
+        typeAnnotation: {
+          type: 'TSTypeAnnotation',
+          loc: DUMMY_LOC,
+          typeAnnotation: transformTypeAnnotationType(node.value)
+        }
+      };
+    },
+
+    OpaqueType(node) {
+      return transform.DeclareOpaqueType(node);
+    },
+
+    OptionalIndexedAccessType(node) {
+      // Foo?.[A][B]
+      // ^^^^^^^^    optional = true
+      // ^^^^^^^^^^^ optional = false
+      if (node.optional === false) {
+        return transform.IndexedAccessType(node);
+      } // TS doesn't support optional index access so we have to wrap the object:
+      // `T?.[K]` becomes `NonNullable<T>[K]`
+
+
+      return {
+        type: 'TSIndexedAccessType',
+        loc: DUMMY_LOC,
+        objectType: {
+          type: 'TSTypeReference',
+          loc: DUMMY_LOC,
+          typeName: {
+            type: 'Identifier',
+            loc: DUMMY_LOC,
+            name: 'NonNullable'
+          },
+          typeParameters: {
+            type: 'TSTypeParameterInstantiation',
+            loc: DUMMY_LOC,
+            params: [transformTypeAnnotationType(node.objectType)]
+          }
+        },
+        indexType: transformTypeAnnotationType(node.indexType)
+      };
+    },
+
+    QualifiedTypeIdentifier(node) {
+      const qual = node.qualification;
+      return {
+        type: 'TSQualifiedName',
+        loc: DUMMY_LOC,
+        left: qual.type === 'Identifier' ? transform.Identifier(qual, false) : transform.QualifiedTypeIdentifier(qual),
+        right: transform.Identifier(node.id, false)
+      };
+    },
+
+    QualifiedTypeofIdentifier(node) {
+      const qual = node.qualification;
+      return {
+        type: 'TSQualifiedName',
+        loc: DUMMY_LOC,
+        left: qual.type === 'Identifier' ? transform.Identifier(qual, false) : transform.QualifiedTypeofIdentifier(qual),
+        right: transform.Identifier(node.id, false)
+      };
+    },
+
+    RegExpLiteral(node) {
+      return {
+        type: 'Literal',
+        loc: DUMMY_LOC,
+        raw: node.raw,
+        regex: {
+          pattern: node.regex.pattern,
+          flags: node.regex.pattern
+        },
+        value: node.value
+      };
+    },
+
+    StringLiteral(node) {
+      return {
+        type: 'Literal',
+        loc: DUMMY_LOC,
+        raw: node.raw,
+        value: node.value
+      };
+    },
+
+    StringLiteralTypeAnnotation(node) {
+      return {
+        type: 'TSLiteralType',
+        loc: DUMMY_LOC,
+        literal: {
+          type: 'Literal',
+          loc: DUMMY_LOC,
+          value: node.value,
+          raw: node.raw
+        }
+      };
+    },
+
+    StringTypeAnnotation(_node) {
+      return {
+        type: 'TSStringKeyword',
+        loc: DUMMY_LOC
+      };
+    },
+
+    SymbolTypeAnnotation(_node) {
+      return {
+        type: 'TSSymbolKeyword',
+        loc: DUMMY_LOC
+      };
+    },
+
+    ThisTypeAnnotation(_node) {
+      return {
+        type: 'TSThisType',
+        loc: DUMMY_LOC
+      };
+    },
+
+    TupleTypeAnnotation(node) {
+      const allReadOnly = node.types.length > 0 && node.types.every(element => element.type === 'TupleTypeLabeledElement' && element.variance != null && element.variance.kind === 'plus');
+      const elems = node.types.map(element => {
+        switch (element.type) {
+          case 'TupleTypeLabeledElement':
+            if (!allReadOnly && element.variance != null) {
+              return unsupportedAnnotation(element, 'tuple type element variance annotations');
+            }
+
+            return {
+              type: 'TSNamedTupleMember',
+              loc: DUMMY_LOC,
+              label: transform.Identifier(element.label),
+              optional: element.optional,
+              elementType: transformTypeAnnotationType(element.elementType)
+            };
+
+          case 'TupleTypeSpreadElement':
+            {
+              const annot = transformTypeAnnotationType(element.typeAnnotation);
+              return {
+                type: 'TSRestType',
+                loc: DUMMY_LOC,
+                typeAnnotation: element.label != null ? {
+                  type: 'TSNamedTupleMember',
+                  loc: DUMMY_LOC,
+                  label: transform.Identifier(element.label),
+                  optional: false,
+                  elementType: annot
+                } : annot
+              };
+            }
+
+          default:
+            return transformTypeAnnotationType(element);
+        }
+      });
+      const elementTypes = node.inexact ? [...elems, {
+        type: 'TSRestType',
+        loc: DUMMY_LOC,
+        typeAnnotation: {
+          type: 'TSArrayType',
+          loc: DUMMY_LOC,
+          elementType: {
+            type: 'TSUnknownKeyword',
+            loc: DUMMY_LOC
+          }
+        }
+      }] : elems;
+      const tupleAnnot = {
+        type: 'TSTupleType',
+        loc: DUMMY_LOC,
+        elementTypes
+      };
+      return allReadOnly ? {
+        type: 'TSTypeOperator',
+        loc: DUMMY_LOC,
+        operator: 'readonly',
+        typeAnnotation: tupleAnnot
+      } : tupleAnnot;
+    },
+
+    TypeAlias(node) {
+      return transform.DeclareTypeAlias(node);
+    },
+
+    TypeAnnotation(node) {
+      return {
+        type: 'TSTypeAnnotation',
+        loc: DUMMY_LOC,
+        typeAnnotation: transformTypeAnnotationType(node.typeAnnotation)
+      };
+    },
+
+    TypeofTypeAnnotation(node) {
+      switch (node.argument.type) {
+        case 'Identifier':
+          return {
+            type: 'TSTypeQuery',
+            loc: DUMMY_LOC,
+            exprName: transform.Identifier(node.argument),
+            typeParameters: undefined
+          };
+
+        case 'QualifiedTypeofIdentifier':
+          return {
+            type: 'TSTypeQuery',
+            loc: DUMMY_LOC,
+            exprName: transform.QualifiedTypeofIdentifier(node.argument),
+            typeParameters: undefined
+          };
+      }
+    },
+
+    TypeParameter(node) {
+      /*
+      TODO - flow models variance as explicit syntax, but but TS resolves it automatically
+      TS does have syntax for explicit variance, but you can introduce a TS error if the
+      marked parameter isn't used in the location that TS expects them to be in.
+       To make it easier for now let's just rely on TS's auto-resolution.
+       ```
+      const variance =
+        new Set(
+          node.variance == null
+            ? // by default flow generics act invariantly
+              ['in', 'out']
+            : node.variance.kind === 'plus'
+            ? // covariant
+              ['out']
+            : // contravariant
+              ['in'],
+        );
+      ```
+      */
+      return {
+        type: 'TSTypeParameter',
+        loc: DUMMY_LOC,
+        name: {
+          type: 'Identifier',
+          loc: DUMMY_LOC,
+          name: node.name
+        },
+        constraint: node.bound == null ? undefined : transformTypeAnnotationType(node.bound.typeAnnotation),
+        default: node.default == null ? undefined : transformTypeAnnotationType(node.default),
+        in: false,
+        out: false // in: variance.has('in'),
+        // out: variance.has('out'),
+
+      };
+    },
+
+    TypeParameterDeclaration(node) {
+      return {
+        type: 'TSTypeParameterDeclaration',
+        loc: DUMMY_LOC,
+        params: node.params.map(transform.TypeParameter)
+      };
+    },
+
+    TypeParameterInstantiation(node) {
+      // Empty parameters in Flow are valid, but TS requires at least one parameter.
+      // This ensures empty type parameters are not created in TS
+      if (node == null || node.params.length === 0) {
+        return undefined;
+      }
+
+      return {
+        type: 'TSTypeParameterInstantiation',
+        loc: DUMMY_LOC,
+        params: node.params.map(transformTypeAnnotationType)
+      };
+    },
+
+    UnionTypeAnnotation(node) {
+      return {
+        type: 'TSUnionType',
+        loc: DUMMY_LOC,
+        types: node.types.map(transformTypeAnnotationType)
+      };
+    },
+
+    VoidTypeAnnotation(_node) {
+      return {
+        type: 'TSVoidKeyword',
+        loc: DUMMY_LOC
+      };
+    },
+
+    ConditionalTypeAnnotation(node) {
+      return {
+        type: 'TSConditionalType',
+        loc: DUMMY_LOC,
+        checkType: transformTypeAnnotationType(node.checkType),
+        extendsType: transformTypeAnnotationType(node.extendsType),
+        trueType: transformTypeAnnotationType(node.trueType),
+        falseType: transformTypeAnnotationType(node.falseType)
+      };
+    },
+
+    TypePredicateAnnotation(node) {
+      return {
+        type: 'TSTypePredicate',
+        loc: DUMMY_LOC,
+        asserts: node.kind != null && node.kind === 'asserts',
+        parameterName: transform.Identifier(node.parameterName, false),
+        typeAnnotation: node.typeAnnotation && {
+          type: 'TSTypeAnnotation',
+          loc: DUMMY_LOC,
+          typeAnnotation: transformTypeAnnotationType(node.typeAnnotation)
+        }
+      };
+    },
+
+    InferTypeAnnotation(node) {
+      return {
+        type: 'TSInferType',
+        loc: DUMMY_LOC,
+        typeParameter: transform.TypeParameter(node.typeParameter)
+      };
+    },
+
+    KeyofTypeAnnotation(node) {
+      return {
+        type: 'TSTypeOperator',
+        loc: DUMMY_LOC,
+        operator: 'keyof',
+        typeAnnotation: transformTypeAnnotationType(node.argument)
+      };
+    },
+
+    TypeOperator(node) {
+      switch (node.operator) {
+        case 'renders':
+        case 'renders?':
+        case 'renders*':
+          {
+            const hasReactImport = isReactImport(node, 'React');
+            return {
+              type: 'TSTypeReference',
+              loc: DUMMY_LOC,
+              typeName: {
+                type: 'TSQualifiedName',
+                loc: DUMMY_LOC,
+                left: getReactIdentifier(hasReactImport),
+                right: {
+                  type: 'Identifier',
+                  loc: DUMMY_LOC,
+                  name: `ReactNode`
+                }
+              },
+              typeParameters: undefined
+            };
+          }
+      }
+    },
+
+    ComponentTypeAnnotation(node) {
+      const typeParameters = node.typeParameters == null ? undefined : transform.TypeParameterDeclaration(node.typeParameters);
+      const params = transform.ComponentTypeParameters(node.params, node.rest); // TS cannot support `renderType` so we always use ReactNode as the return type.
+
+      const hasReactImport = isReactImport(node, 'React');
+      const returnType = {
+        type: 'TSTypeAnnotation',
+        loc: DUMMY_LOC,
+        // If no rendersType we assume its ReactNode type.
+        typeAnnotation: {
+          type: 'TSTypeReference',
+          loc: DUMMY_LOC,
+          typeName: {
+            type: 'TSQualifiedName',
+            loc: DUMMY_LOC,
+            left: getReactIdentifier(hasReactImport),
+            right: {
+              type: 'Identifier',
+              loc: DUMMY_LOC,
+              name: `ReactNode`
+            }
+          },
+          typeParameters: undefined
+        }
+      };
+      return {
+        type: 'TSFunctionType',
+        loc: DUMMY_LOC,
+        typeParameters,
+        params,
+        returnType
+      };
+    }
+
+  }; // wrap each transform so that we automatically preserve jsdoc comments
+  // this just saves us manually wiring up every single case
+
+  for (const key of Object.keys(transform)) {
+    const originalFn = transform[key]; // $FlowExpectedError[cannot-write]
+    // $FlowExpectedError[missing-local-annot]
+
+    transform[key] = (node, ...args) => {
+      const result = originalFn(node, ...args);
+
+      if (node != null && result != null) {
+        if (Array.isArray(result)) {
+          cloneJSDocCommentsToNewNode(node, result[0]);
+        } else {
+          cloneJSDocCommentsToNewNode(node, result);
+        }
+      }
+
+      return result;
+    };
+  }
+
+  return [transform, code];
+};