@types/react-dom 16.0.8 → 16.8.0

react-dom/README.md

@@ -2,15 +2,15 @@
 > `npm install --save @types/react-dom`
 
 # Summary
-This package contains type definitions for React (react-dom) (http://facebook.github.io/react/).
+This package contains type definitions for React (react-dom) ( http://facebook.github.io/react/ ).
 
 # Details
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom
 
 Additional Details
- * Last updated: Thu, 27 Sep 2018 12:34:24 GMT
- * Dependencies: react, node
+ * Last updated: Wed, 06 Feb 2019 12:44:09 GMT
+ * Dependencies: @types/react
  * Global values: ReactDOM, ReactDOMNodeStream, ReactDOMServer
 
 # Credits
-These definitions were written by Asana <https://asana.com>, AssureSign <http://www.assuresign.com>, Microsoft <https://microsoft.com>, MartynasZilinskas <https://github.com/MartynasZilinskas>, Josh Rutherford <https://github.com/theruther4d>, JounQin <https://github.com/JounQin>.
+These definitions were written by Asana <https://asana.com>, AssureSign <http://www.assuresign.com>, Microsoft <https://microsoft.com>, MartynasZilinskas <https://github.com/MartynasZilinskas>, Josh Rutherford <https://github.com/theruther4d>, Jessica Franco <https://github.com/Jessidhia>.

react-dom/index.d.ts

@@ -1,101 +1,101 @@
-// Type definitions for React (react-dom) 16.0
-// Project: http://facebook.github.io/react/
-// Definitions by: Asana <https://asana.com>
-//                 AssureSign <http://www.assuresign.com>
-//                 Microsoft <https://microsoft.com>
-//                 MartynasZilinskas <https://github.com/MartynasZilinskas>
-//                 Josh Rutherford <https://github.com/theruther4d>
-//                 JounQin <https://github.com/JounQin>
-// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// TypeScript Version: 2.8
-
-export as namespace ReactDOM;
-
-import {
-    ReactInstance, Component, ComponentState,
-    ReactElement, SFCElement, CElement,
-    DOMAttributes, DOMElement, ReactNode, ReactPortal
-} from 'react';
-
-export function findDOMNode(instance: ReactInstance): Element | string | null;
-export function unmountComponentAtNode(container: Element): boolean;
-
-export function createPortal(children: ReactNode, container: Element, key?: null | string): ReactPortal;
-
-export const version: string;
-export const render: Renderer;
-export const hydrate: Renderer;
-
-export function unstable_batchedUpdates<A, B>(callback: (a: A, b: B) => any, a: A, b: B): void;
-export function unstable_batchedUpdates<A>(callback: (a: A) => any, a: A): void;
-export function unstable_batchedUpdates(callback: () => any): void;
-
-export function unstable_renderSubtreeIntoContainer<T extends Element>(
-    parentComponent: Component<any>,
-    element: DOMElement<DOMAttributes<T>, T>,
-    container: Element,
-    callback?: (element: T) => any): T;
-export function unstable_renderSubtreeIntoContainer<P, T extends Component<P, ComponentState>>(
-    parentComponent: Component<any>,
-    element: CElement<P, T>,
-    container: Element,
-    callback?: (component: T) => any): T;
-export function unstable_renderSubtreeIntoContainer<P>(
-    parentComponent: Component<any>,
-    element: ReactElement<P>,
-    container: Element,
-    callback?: (component?: Component<P, ComponentState> | Element) => any): Component<P, ComponentState> | Element | void;
-
-export interface Renderer {
-    // Deprecated(render): The return value is deprecated.
-    // In future releases the render function's return type will be void.
-
-    <T extends Element>(
-        element: DOMElement<DOMAttributes<T>, T>,
-        container: Element | null,
-        callback?: () => void
-    ): T;
-
-    (
-        element: Array<DOMElement<DOMAttributes<any>, any>>,
-        container: Element | null,
-        callback?: () => void
-    ): Element;
-
-    (
-        element: SFCElement<any> | Array<SFCElement<any>>,
-        container: Element | null,
-        callback?: () => void
-    ): void;
-
-    <P, T extends Component<P, ComponentState>>(
-        element: CElement<P, T>,
-        container: Element | null,
-        callback?: () => void
-    ): T;
-
-    (
-        element: Array<CElement<any, Component<any, ComponentState>>>,
-        container: Element | null,
-        callback?: () => void
-    ): Component<any, ComponentState>;
-
-    <P>(
-        element: ReactElement<P>,
-        container: Element | null,
-        callback?: () => void
-    ): Component<P, ComponentState> | Element | void;
-
-    (
-        element: Array<ReactElement<any>>,
-        container: Element | null,
-        callback?: () => void
-    ): Component<any, ComponentState> | Element | void;
-
-    (
-        parentComponent: Component<any> | Array<Component<any>>,
-        element: SFCElement<any>,
-        container: Element,
-        callback?: () => void
-    ): void;
-}
+// Type definitions for React (react-dom) 16.8
+// Project: http://facebook.github.io/react/
+// Definitions by: Asana <https://asana.com>
+//                 AssureSign <http://www.assuresign.com>
+//                 Microsoft <https://microsoft.com>
+//                 MartynasZilinskas <https://github.com/MartynasZilinskas>
+//                 Josh Rutherford <https://github.com/theruther4d>
+//                 Jessica Franco <https://github.com/Jessidhia>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.8
+
+export as namespace ReactDOM;
+
+import {
+    ReactInstance, Component, ComponentState,
+    ReactElement, SFCElement, CElement,
+    DOMAttributes, DOMElement, ReactNode, ReactPortal
+} from 'react';
+
+export function findDOMNode(instance: ReactInstance): Element | null | Text;
+export function unmountComponentAtNode(container: Element): boolean;
+
+export function createPortal(children: ReactNode, container: Element, key?: null | string): ReactPortal;
+
+export const version: string;
+export const render: Renderer;
+export const hydrate: Renderer;
+
+export function unstable_batchedUpdates<A, B>(callback: (a: A, b: B) => any, a: A, b: B): void;
+export function unstable_batchedUpdates<A>(callback: (a: A) => any, a: A): void;
+export function unstable_batchedUpdates(callback: () => any): void;
+
+export function unstable_renderSubtreeIntoContainer<T extends Element>(
+    parentComponent: Component<any>,
+    element: DOMElement<DOMAttributes<T>, T>,
+    container: Element,
+    callback?: (element: T) => any): T;
+export function unstable_renderSubtreeIntoContainer<P, T extends Component<P, ComponentState>>(
+    parentComponent: Component<any>,
+    element: CElement<P, T>,
+    container: Element,
+    callback?: (component: T) => any): T;
+export function unstable_renderSubtreeIntoContainer<P>(
+    parentComponent: Component<any>,
+    element: ReactElement<P>,
+    container: Element,
+    callback?: (component?: Component<P, ComponentState> | Element) => any): Component<P, ComponentState> | Element | void;
+
+export interface Renderer {
+    // Deprecated(render): The return value is deprecated.
+    // In future releases the render function's return type will be void.
+
+    <T extends Element>(
+        element: DOMElement<DOMAttributes<T>, T>,
+        container: Element | null,
+        callback?: () => void
+    ): T;
+
+    (
+        element: Array<DOMElement<DOMAttributes<any>, any>>,
+        container: Element | null,
+        callback?: () => void
+    ): Element;
+
+    (
+        element: SFCElement<any> | Array<SFCElement<any>>,
+        container: Element | null,
+        callback?: () => void
+    ): void;
+
+    <P, T extends Component<P, ComponentState>>(
+        element: CElement<P, T>,
+        container: Element | null,
+        callback?: () => void
+    ): T;
+
+    (
+        element: Array<CElement<any, Component<any, ComponentState>>>,
+        container: Element | null,
+        callback?: () => void
+    ): Component<any, ComponentState>;
+
+    <P>(
+        element: ReactElement<P>,
+        container: Element | null,
+        callback?: () => void
+    ): Component<P, ComponentState> | Element | void;
+
+    (
+        element: Array<ReactElement<any>>,
+        container: Element | null,
+        callback?: () => void
+    ): Component<any, ComponentState> | Element | void;
+
+    (
+        parentComponent: Component<any> | Array<Component<any>>,
+        element: SFCElement<any>,
+        container: Element,
+        callback?: () => void
+    ): void;
+}

react-dom/node-stream/index.d.ts

@@ -1,18 +1,18 @@
-import { ReactElement } from 'react';
-
-/**
- * Render a ReactElement to its initial HTML. This should only be used on the
- * server.
- * See https://facebook.github.io/react/docs/react-dom-stream.html#rendertostream
- */
-export function renderToStream(element: ReactElement<any>): any;
-
-/**
- * Similar to renderToStream, except this doesn't create extra DOM attributes
- * such as data-react-id that React uses internally.
- * See https://facebook.github.io/react/docs/react-dom-stream.html#rendertostaticstream
- */
-export function renderToStaticStream(element: ReactElement<any>): any;
-export const version: string;
-
-export as namespace ReactDOMNodeStream;
+import { ReactElement } from 'react';
+
+/**
+ * Render a ReactElement to its initial HTML. This should only be used on the
+ * server.
+ * See https://facebook.github.io/react/docs/react-dom-stream.html#rendertostream
+ */
+export function renderToStream(element: ReactElement<any>): any;
+
+/**
+ * Similar to renderToStream, except this doesn't create extra DOM attributes
+ * such as data-react-id that React uses internally.
+ * See https://facebook.github.io/react/docs/react-dom-stream.html#rendertostaticstream
+ */
+export function renderToStaticStream(element: ReactElement<any>): any;
+export const version: string;
+
+export as namespace ReactDOMNodeStream;

react-dom/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react-dom",
-    "version": "16.0.8",
+    "version": "16.8.0",
     "description": "TypeScript definitions for React (react-dom)",
     "license": "MIT",
     "contributors": [
@@ -27,21 +27,21 @@
             "githubUsername": "theruther4d"
         },
         {
-            "name": "JounQin",
-            "url": "https://github.com/JounQin",
-            "githubUsername": "JounQin"
+            "name": "Jessica Franco",
+            "url": "https://github.com/Jessidhia",
+            "githubUsername": "Jessidhia"
         }
     ],
     "main": "",
+    "types": "index",
     "repository": {
         "type": "git",
         "url": "https://github.com/DefinitelyTyped/DefinitelyTyped.git"
     },
     "scripts": {},
     "dependencies": {
-        "@types/react": "*",
-        "@types/node": "*"
+        "@types/react": "*"
     },
-    "typesPublisherContentHash": "3acfd1c0fb518725f930263c862b2bcfa39236c3dd341111477e7cc26ee28bca",
+    "typesPublisherContentHash": "b994ac5eaa6eee18cef16c10c5734b4831ad0c2a141f32fa1bbffef28edd6bc0",
     "typeScriptVersion": "2.8"
 }

react-dom/server/index.d.ts

@@ -1,41 +1,47 @@
-/// <reference types="node" />
-
-import { ReactElement } from 'react';
-
-/**
- * Render a React element to its initial HTML. This should only be used on the server.
- * React will return an HTML string. You can use this method to generate HTML on the server
- * and send the markup down on the initial request for faster page loads and to allow search
- * engines to crawl your pages for SEO purposes.
- *
- * If you call `ReactDOM.render()` on a node that already has this server-rendered markup,
- * React will preserve it and only attach event handlers, allowing you
- * to have a very performant first-load experience.
- */
-export function renderToString(element: ReactElement<any>): string;
-
-/**
- * Render a React element to its initial HTML. Returns a Readable stream that outputs
- * an HTML string. The HTML output by this stream is exactly equal to what
- * `ReactDOMServer.renderToString()` would return.
- */
-export function renderToNodeStream(element: ReactElement<any>): NodeJS.ReadableStream;
-
-/**
- * Similar to `renderToString`, except this doesn't create extra DOM attributes
- * such as `data-reactid`, that React uses internally. This is useful if you want
- * to use React as a simple static page generator, as stripping away the extra
- * attributes can save lots of bytes.
- */
-export function renderToStaticMarkup(element: ReactElement<any>): string;
-
-/**
- * Similar to `renderToNodeStream`, except this doesn't create extra DOM attributes
- * such as `data-reactid`, that React uses internally. The HTML output by this stream
- * is exactly equal to what `ReactDOMServer.renderToStaticMarkup()` would return.
- */
-export function renderToStaticNodeStream(element: ReactElement<any>): NodeJS.ReadableStream;
-
-export const version: string;
-
-export as namespace ReactDOMServer;
+// forward declarations
+declare global {
+    namespace NodeJS {
+        // tslint:disable-next-line:no-empty-interface
+        interface ReadableStream {}
+    }
+}
+
+import { ReactElement } from 'react';
+
+/**
+ * Render a React element to its initial HTML. This should only be used on the server.
+ * React will return an HTML string. You can use this method to generate HTML on the server
+ * and send the markup down on the initial request for faster page loads and to allow search
+ * engines to crawl your pages for SEO purposes.
+ *
+ * If you call `ReactDOM.render()` on a node that already has this server-rendered markup,
+ * React will preserve it and only attach event handlers, allowing you
+ * to have a very performant first-load experience.
+ */
+export function renderToString(element: ReactElement<any>): string;
+
+/**
+ * Render a React element to its initial HTML. Returns a Readable stream that outputs
+ * an HTML string. The HTML output by this stream is exactly equal to what
+ * `ReactDOMServer.renderToString()` would return.
+ */
+export function renderToNodeStream(element: ReactElement<any>): NodeJS.ReadableStream;
+
+/**
+ * Similar to `renderToString`, except this doesn't create extra DOM attributes
+ * such as `data-reactid`, that React uses internally. This is useful if you want
+ * to use React as a simple static page generator, as stripping away the extra
+ * attributes can save lots of bytes.
+ */
+export function renderToStaticMarkup(element: ReactElement<any>): string;
+
+/**
+ * Similar to `renderToNodeStream`, except this doesn't create extra DOM attributes
+ * such as `data-reactid`, that React uses internally. The HTML output by this stream
+ * is exactly equal to what `ReactDOMServer.renderToStaticMarkup()` would return.
+ */
+export function renderToStaticNodeStream(element: ReactElement<any>): NodeJS.ReadableStream;
+
+export const version: string;
+
+export as namespace ReactDOMServer;

react-dom/test-utils/index.d.ts

@@ -1,276 +1,303 @@
-import {
-    AbstractView, Component, ComponentClass,
-    ReactElement, ReactInstance, ClassType,
-    DOMElement, SFCElement, CElement,
-    ReactHTMLElement, DOMAttributes, SFC
-} from 'react';
-
-import * as ReactTestUtils from ".";
-
-export interface OptionalEventProperties {
-    bubbles?: boolean;
-    cancelable?: boolean;
-    currentTarget?: EventTarget;
-    defaultPrevented?: boolean;
-    eventPhase?: number;
-    isTrusted?: boolean;
-    nativeEvent?: Event;
-    preventDefault?(): void;
-    stopPropagation?(): void;
-    target?: EventTarget;
-    timeStamp?: Date;
-    type?: string;
-}
-
-export interface SyntheticEventData extends OptionalEventProperties {
-    altKey?: boolean;
-    button?: number;
-    buttons?: number;
-    clientX?: number;
-    clientY?: number;
-    changedTouches?: TouchList;
-    charCode?: boolean;
-    clipboardData?: DataTransfer;
-    ctrlKey?: boolean;
-    deltaMode?: number;
-    deltaX?: number;
-    deltaY?: number;
-    deltaZ?: number;
-    detail?: number;
-    getModifierState?(key: string): boolean;
-    key?: string;
-    keyCode?: number;
-    locale?: string;
-    location?: number;
-    metaKey?: boolean;
-    pageX?: number;
-    pageY?: number;
-    relatedTarget?: EventTarget;
-    repeat?: boolean;
-    screenX?: number;
-    screenY?: number;
-    shiftKey?: boolean;
-    targetTouches?: TouchList;
-    touches?: TouchList;
-    view?: AbstractView;
-    which?: number;
-}
-
-export type EventSimulator = (element: Element | Component<any>, eventData?: SyntheticEventData) => void;
-
-export interface MockedComponentClass {
-    new (props: {}): any;
-}
-
-export interface ShallowRenderer {
-    /**
-     * After `shallowRenderer.render()` has been called, returns shallowly rendered output.
-     */
-    getRenderOutput<E extends ReactElement<any>>(): E;
-    /**
-     * After `shallowRenderer.render()` has been called, returns shallowly rendered output.
-     */
-    getRenderOutput(): ReactElement<any>;
-    /**
-     * Similar to `ReactDOM.render` but it doesn't require DOM and only renders a single level deep.
-     */
-    render(element: ReactElement<any>, context?: any): void;
-    unmount(): void;
-}
-
-/**
- * Simulate an event dispatch on a DOM node with optional `eventData` event data.
- * `Simulate` has a method for every event that React understands.
- */
-export namespace Simulate {
-    const abort: EventSimulator;
-    const animationEnd: EventSimulator;
-    const animationIteration: EventSimulator;
-    const animationStart: EventSimulator;
-    const blur: EventSimulator;
-    const canPlay: EventSimulator;
-    const canPlayThrough: EventSimulator;
-    const change: EventSimulator;
-    const click: EventSimulator;
-    const compositionEnd: EventSimulator;
-    const compositionStart: EventSimulator;
-    const compositionUpdate: EventSimulator;
-    const contextMenu: EventSimulator;
-    const copy: EventSimulator;
-    const cut: EventSimulator;
-    const doubleClick: EventSimulator;
-    const drag: EventSimulator;
-    const dragEnd: EventSimulator;
-    const dragEnter: EventSimulator;
-    const dragExit: EventSimulator;
-    const dragLeave: EventSimulator;
-    const dragOver: EventSimulator;
-    const dragStart: EventSimulator;
-    const drop: EventSimulator;
-    const durationChange: EventSimulator;
-    const emptied: EventSimulator;
-    const encrypted: EventSimulator;
-    const ended: EventSimulator;
-    const error: EventSimulator;
-    const focus: EventSimulator;
-    const input: EventSimulator;
-    const invalid: EventSimulator;
-    const keyDown: EventSimulator;
-    const keyPress: EventSimulator;
-    const keyUp: EventSimulator;
-    const load: EventSimulator;
-    const loadStart: EventSimulator;
-    const loadedData: EventSimulator;
-    const loadedMetadata: EventSimulator;
-    const mouseDown: EventSimulator;
-    const mouseEnter: EventSimulator;
-    const mouseLeave: EventSimulator;
-    const mouseMove: EventSimulator;
-    const mouseOut: EventSimulator;
-    const mouseOver: EventSimulator;
-    const mouseUp: EventSimulator;
-    const paste: EventSimulator;
-    const pause: EventSimulator;
-    const play: EventSimulator;
-    const playing: EventSimulator;
-    const progress: EventSimulator;
-    const rateChange: EventSimulator;
-    const scroll: EventSimulator;
-    const seeked: EventSimulator;
-    const seeking: EventSimulator;
-    const select: EventSimulator;
-    const stalled: EventSimulator;
-    const submit: EventSimulator;
-    const suspend: EventSimulator;
-    const timeUpdate: EventSimulator;
-    const touchCancel: EventSimulator;
-    const touchEnd: EventSimulator;
-    const touchMove: EventSimulator;
-    const touchStart: EventSimulator;
-    const transitionEnd: EventSimulator;
-    const volumeChange: EventSimulator;
-    const waiting: EventSimulator;
-    const wheel: EventSimulator;
-}
-
-/**
- * Render a React element into a detached DOM node in the document. __This function requires a DOM__.
- */
-export function renderIntoDocument<T extends Element>(
-    element: DOMElement<any, T>): T;
-export function renderIntoDocument(
-    element: SFCElement<any>): void;
-export function renderIntoDocument<T extends Component<any>>(
-    element: CElement<any, T>): T;
-export function renderIntoDocument<P>(
-    element: ReactElement<P>): Component<P> | Element | void;
-
-/**
- * Pass a mocked component module to this method to augment it with useful methods that allow it to
- * be used as a dummy React component. Instead of rendering as usual, the component will become
- * a simple `<div>` (or other tag if `mockTagName` is provided) containing any provided children.
- */
-export function mockComponent(
-    mocked: MockedComponentClass, mockTagName?: string): typeof ReactTestUtils;
-
-/**
- * Returns `true` if `element` is any React element.
- */
-export function isElement(element: any): boolean;
-
-/**
- * Returns `true` if `element` is a React element whose type is of a React `componentClass`.
- */
-export function isElementOfType<T extends HTMLElement>(
-    element: ReactElement<any>, type: string): element is ReactHTMLElement<T>;
-/**
- * Returns `true` if `element` is a React element whose type is of a React `componentClass`.
- */
-export function isElementOfType<P extends DOMAttributes<{}>, T extends Element>(
-    element: ReactElement<any>, type: string): element is DOMElement<P, T>;
-/**
- * Returns `true` if `element` is a React element whose type is of a React `componentClass`.
- */
-export function isElementOfType<P>(
-    element: ReactElement<any>, type: SFC<P>): element is SFCElement<P>;
-/**
- * Returns `true` if `element` is a React element whose type is of a React `componentClass`.
- */
-export function isElementOfType<P, T extends Component<P>, C extends ComponentClass<P>>(
-    element: ReactElement<any>, type: ClassType<P, T, C>): element is CElement<P, T>;
-
-/**
- * Returns `true` if `instance` is a DOM component (such as a `<div>` or `<span>`).
- */
-export function isDOMComponent(instance: ReactInstance): instance is Element;
-/**
- * Returns `true` if `instance` is a user-defined component, such as a class or a function.
- */
-export function isCompositeComponent(instance: ReactInstance): instance is Component<any>;
-/**
- * Returns `true` if `instance` is a component whose type is of a React `componentClass`.
- */
-export function isCompositeComponentWithType<T extends Component<any>, C extends ComponentClass<any>>(
-    instance: ReactInstance, type: ClassType<any, T, C>): boolean;
-
-/**
- * Traverse all components in `tree` and accumulate all components where
- * `test(component)` is `true`. This is not that useful on its own, but it's used
- * as a primitive for other test utils.
- */
-export function findAllInRenderedTree(
-    root: Component<any>,
-    fn: (i: ReactInstance) => boolean): ReactInstance[];
-
-/**
- * Finds all DOM elements of components in the rendered tree that are
- * DOM components with the class name matching `className`.
- */
-export function scryRenderedDOMComponentsWithClass(
-    root: Component<any>,
-    className: string): Element[];
-/**
- * Like `scryRenderedDOMComponentsWithClass()` but expects there to be one result,
- * and returns that one result, or throws exception if there is any other
- * number of matches besides one.
- */
-export function findRenderedDOMComponentWithClass(
-    root: Component<any>,
-    className: string): Element;
-
-/**
- * Finds all DOM elements of components in the rendered tree that are
- * DOM components with the tag name matching `tagName`.
- */
-export function scryRenderedDOMComponentsWithTag(
-    root: Component<any>,
-    tagName: string): Element[];
-/**
- * Like `scryRenderedDOMComponentsWithTag()` but expects there to be one result,
- * and returns that one result, or throws exception if there is any other
- * number of matches besides one.
- */
-export function findRenderedDOMComponentWithTag(
-    root: Component<any>,
-    tagName: string): Element;
-
-/**
- * Finds all instances of components with type equal to `componentClass`.
- */
-export function scryRenderedComponentsWithType<T extends Component, C extends ComponentClass>(
-    root: Component<any>,
-    type: ClassType<any, T, C>): T[];
-
-/**
- * Same as `scryRenderedComponentsWithType()` but expects there to be one result
- * and returns that one result, or throws exception if there is any other
- * number of matches besides one.
- */
-export function findRenderedComponentWithType<T extends Component, C extends ComponentClass>(
-    root: Component<any>,
-    type: ClassType<any, T, C>): T;
-
-/**
- * Call this in your tests to create a shallow renderer.
- */
-export function createRenderer(): ShallowRenderer;
+import {
+    AbstractView, Component, ComponentClass,
+    ReactElement, ReactInstance, ClassType,
+    DOMElement, SFCElement, CElement,
+    ReactHTMLElement, DOMAttributes, SFC
+} from 'react';
+
+import * as ReactTestUtils from ".";
+
+export interface OptionalEventProperties {
+    bubbles?: boolean;
+    cancelable?: boolean;
+    currentTarget?: EventTarget;
+    defaultPrevented?: boolean;
+    eventPhase?: number;
+    isTrusted?: boolean;
+    nativeEvent?: Event;
+    preventDefault?(): void;
+    stopPropagation?(): void;
+    target?: EventTarget;
+    timeStamp?: Date;
+    type?: string;
+}
+
+export interface SyntheticEventData extends OptionalEventProperties {
+    altKey?: boolean;
+    button?: number;
+    buttons?: number;
+    clientX?: number;
+    clientY?: number;
+    changedTouches?: TouchList;
+    charCode?: boolean;
+    clipboardData?: DataTransfer;
+    ctrlKey?: boolean;
+    deltaMode?: number;
+    deltaX?: number;
+    deltaY?: number;
+    deltaZ?: number;
+    detail?: number;
+    getModifierState?(key: string): boolean;
+    key?: string;
+    keyCode?: number;
+    locale?: string;
+    location?: number;
+    metaKey?: boolean;
+    pageX?: number;
+    pageY?: number;
+    relatedTarget?: EventTarget;
+    repeat?: boolean;
+    screenX?: number;
+    screenY?: number;
+    shiftKey?: boolean;
+    targetTouches?: TouchList;
+    touches?: TouchList;
+    view?: AbstractView;
+    which?: number;
+}
+
+export type EventSimulator = (element: Element | Component<any>, eventData?: SyntheticEventData) => void;
+
+export interface MockedComponentClass {
+    new (props: any): any;
+}
+
+export interface ShallowRenderer {
+    /**
+     * After `shallowRenderer.render()` has been called, returns shallowly rendered output.
+     */
+    getRenderOutput<E extends ReactElement<any>>(): E;
+    /**
+     * After `shallowRenderer.render()` has been called, returns shallowly rendered output.
+     */
+    getRenderOutput(): ReactElement<any>;
+    /**
+     * Similar to `ReactDOM.render` but it doesn't require DOM and only renders a single level deep.
+     */
+    render(element: ReactElement<any>, context?: any): void;
+    unmount(): void;
+}
+
+/**
+ * Simulate an event dispatch on a DOM node with optional `eventData` event data.
+ * `Simulate` has a method for every event that React understands.
+ */
+export namespace Simulate {
+    const abort: EventSimulator;
+    const animationEnd: EventSimulator;
+    const animationIteration: EventSimulator;
+    const animationStart: EventSimulator;
+    const blur: EventSimulator;
+    const canPlay: EventSimulator;
+    const canPlayThrough: EventSimulator;
+    const change: EventSimulator;
+    const click: EventSimulator;
+    const compositionEnd: EventSimulator;
+    const compositionStart: EventSimulator;
+    const compositionUpdate: EventSimulator;
+    const contextMenu: EventSimulator;
+    const copy: EventSimulator;
+    const cut: EventSimulator;
+    const doubleClick: EventSimulator;
+    const drag: EventSimulator;
+    const dragEnd: EventSimulator;
+    const dragEnter: EventSimulator;
+    const dragExit: EventSimulator;
+    const dragLeave: EventSimulator;
+    const dragOver: EventSimulator;
+    const dragStart: EventSimulator;
+    const drop: EventSimulator;
+    const durationChange: EventSimulator;
+    const emptied: EventSimulator;
+    const encrypted: EventSimulator;
+    const ended: EventSimulator;
+    const error: EventSimulator;
+    const focus: EventSimulator;
+    const input: EventSimulator;
+    const invalid: EventSimulator;
+    const keyDown: EventSimulator;
+    const keyPress: EventSimulator;
+    const keyUp: EventSimulator;
+    const load: EventSimulator;
+    const loadStart: EventSimulator;
+    const loadedData: EventSimulator;
+    const loadedMetadata: EventSimulator;
+    const mouseDown: EventSimulator;
+    const mouseEnter: EventSimulator;
+    const mouseLeave: EventSimulator;
+    const mouseMove: EventSimulator;
+    const mouseOut: EventSimulator;
+    const mouseOver: EventSimulator;
+    const mouseUp: EventSimulator;
+    const paste: EventSimulator;
+    const pause: EventSimulator;
+    const play: EventSimulator;
+    const playing: EventSimulator;
+    const progress: EventSimulator;
+    const rateChange: EventSimulator;
+    const scroll: EventSimulator;
+    const seeked: EventSimulator;
+    const seeking: EventSimulator;
+    const select: EventSimulator;
+    const stalled: EventSimulator;
+    const submit: EventSimulator;
+    const suspend: EventSimulator;
+    const timeUpdate: EventSimulator;
+    const touchCancel: EventSimulator;
+    const touchEnd: EventSimulator;
+    const touchMove: EventSimulator;
+    const touchStart: EventSimulator;
+    const transitionEnd: EventSimulator;
+    const volumeChange: EventSimulator;
+    const waiting: EventSimulator;
+    const wheel: EventSimulator;
+}
+
+/**
+ * Render a React element into a detached DOM node in the document. __This function requires a DOM__.
+ */
+export function renderIntoDocument<T extends Element>(
+    element: DOMElement<any, T>): T;
+export function renderIntoDocument(
+    element: SFCElement<any>): void;
+// If we replace `P` with `any` in this overload, then some tests fail because
+// calls to `renderIntoDocument` choose the last overload on the
+// subtype-relation pass and get an undesirably broad return type.  Using `P`
+// allows this overload to match on the subtype-relation pass.
+export function renderIntoDocument<P, T extends Component<P>>(
+    element: CElement<P, T>): T;
+export function renderIntoDocument<P>(
+    element: ReactElement<P>): Component<P> | Element | void;
+
+/**
+ * Pass a mocked component module to this method to augment it with useful methods that allow it to
+ * be used as a dummy React component. Instead of rendering as usual, the component will become
+ * a simple `<div>` (or other tag if `mockTagName` is provided) containing any provided children.
+ */
+export function mockComponent(
+    mocked: MockedComponentClass, mockTagName?: string): typeof ReactTestUtils;
+
+/**
+ * Returns `true` if `element` is any React element.
+ */
+export function isElement(element: any): boolean;
+
+/**
+ * Returns `true` if `element` is a React element whose type is of a React `componentClass`.
+ */
+export function isElementOfType<T extends HTMLElement>(
+    element: ReactElement<any>, type: string): element is ReactHTMLElement<T>;
+/**
+ * Returns `true` if `element` is a React element whose type is of a React `componentClass`.
+ */
+export function isElementOfType<P extends DOMAttributes<{}>, T extends Element>(
+    element: ReactElement<any>, type: string): element is DOMElement<P, T>;
+/**
+ * Returns `true` if `element` is a React element whose type is of a React `componentClass`.
+ */
+export function isElementOfType<P>(
+    element: ReactElement<any>, type: SFC<P>): element is SFCElement<P>;
+/**
+ * Returns `true` if `element` is a React element whose type is of a React `componentClass`.
+ */
+export function isElementOfType<P, T extends Component<P>, C extends ComponentClass<P>>(
+    element: ReactElement<any>, type: ClassType<P, T, C>): element is CElement<P, T>;
+
+/**
+ * Returns `true` if `instance` is a DOM component (such as a `<div>` or `<span>`).
+ */
+export function isDOMComponent(instance: ReactInstance): instance is Element;
+/**
+ * Returns `true` if `instance` is a user-defined component, such as a class or a function.
+ */
+export function isCompositeComponent(instance: ReactInstance): instance is Component<any>;
+/**
+ * Returns `true` if `instance` is a component whose type is of a React `componentClass`.
+ */
+export function isCompositeComponentWithType<T extends Component<any>, C extends ComponentClass<any>>(
+    instance: ReactInstance, type: ClassType<any, T, C>): boolean;
+
+/**
+ * Traverse all components in `tree` and accumulate all components where
+ * `test(component)` is `true`. This is not that useful on its own, but it's used
+ * as a primitive for other test utils.
+ */
+export function findAllInRenderedTree(
+    root: Component<any>,
+    fn: (i: ReactInstance) => boolean): ReactInstance[];
+
+/**
+ * Finds all DOM elements of components in the rendered tree that are
+ * DOM components with the class name matching `className`.
+ */
+export function scryRenderedDOMComponentsWithClass(
+    root: Component<any>,
+    className: string): Element[];
+/**
+ * Like `scryRenderedDOMComponentsWithClass()` but expects there to be one result,
+ * and returns that one result, or throws exception if there is any other
+ * number of matches besides one.
+ */
+export function findRenderedDOMComponentWithClass(
+    root: Component<any>,
+    className: string): Element;
+
+/**
+ * Finds all DOM elements of components in the rendered tree that are
+ * DOM components with the tag name matching `tagName`.
+ */
+export function scryRenderedDOMComponentsWithTag(
+    root: Component<any>,
+    tagName: string): Element[];
+/**
+ * Like `scryRenderedDOMComponentsWithTag()` but expects there to be one result,
+ * and returns that one result, or throws exception if there is any other
+ * number of matches besides one.
+ */
+export function findRenderedDOMComponentWithTag(
+    root: Component<any>,
+    tagName: string): Element;
+
+/**
+ * Finds all instances of components with type equal to `componentClass`.
+ */
+export function scryRenderedComponentsWithType<T extends Component<any>, C extends ComponentClass<any>>(
+    root: Component<any>,
+    type: ClassType<any, T, C>): T[];
+
+/**
+ * Same as `scryRenderedComponentsWithType()` but expects there to be one result
+ * and returns that one result, or throws exception if there is any other
+ * number of matches besides one.
+ */
+export function findRenderedComponentWithType<T extends Component<any>, C extends ComponentClass<any>>(
+    root: Component<any>,
+    type: ClassType<any, T, C>): T;
+
+/**
+ * Call this in your tests to create a shallow renderer.
+ */
+export function createRenderer(): ShallowRenderer;
+
+/**
+ * Wrap any code rendering and triggering updates to your components into `act()` calls.
+ *
+ * Ensures that the behavior in your tests matches what happens in the browser
+ * more closely by executing pending `useEffect`s before returning. This also
+ * reduces the amount of re-renders done.
+ *
+ * @param callback A synchronous, void callback that will execute as a single, complete React commit.
+ *
+ * @see https://reactjs.org/blog/2019/02/06/react-v16.8.0.html#testing-hooks
+ */
+// the "void | undefined" is here to forbid any sneaky "Promise" returns.
+// the actual return value is always a "DebugPromiseLike",
+// but having an "| {}" makes it harder to accidentally use.
+export function act(callback: () => void | undefined): DebugPromiseLike | {};
+
+// Intentionally doesn't extend PromiseLike<never>.
+// Ideally this should be as hard to accidentally use as possible.
+export interface DebugPromiseLike {
+    // the actual then() in here is 0-ary, but that doesn't count as a PromiseLike.
+    then(onfulfilled: (value: never) => never, onrejected: (reason: never) => never): never;
+}