@types/react-dom 16.9.0 → 16.9.4

react-dom/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for React (react-dom) (http://facebook.gi
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom
 
 Additional Details
- * Last updated: Mon, 19 Aug 2019 20:08:04 GMT
+ * Last updated: Wed, 06 Nov 2019 16:25:05 GMT
  * Dependencies: @types/react
  * Global values: ReactDOM, ReactDOMNodeStream, ReactDOMServer
 

react-dom/experimental.d.ts

@@ -0,0 +1,102 @@
+/**
+ * These are types for things that are present in the `experimental` builds of React but not yet
+ * on a stable build.
+ *
+ * Once they are promoted to stable they can just be moved to the main index file.
+ *
+ * To load the types declared here in an actual project, there are three ways. The easiest one,
+ * if your `tsconfig.json` already has a `"types"` array in the `"compilerOptions"` section,
+ * is to add `"react-dom/experimental"` to the `"types"` array.
+ *
+ * Alternatively, a specific import syntax can to be used from a typescript file.
+ * This module does not exist in reality, which is why the {} is important:
+ *
+ * ```ts
+ * import {} from 'react-dom/experimental'
+ * ```
+ *
+ * It is also possible to include it through a triple-slash reference:
+ *
+ * ```ts
+ * /// <reference types="react-dom/experimental" />
+ * ```
+ *
+ * Either the import or the reference only needs to appear once, anywhere in the project.
+ */
+
+// See https://github.com/facebook/react/blob/master/packages/react-dom/src/client/ReactDOM.js to see how the exports are declared,
+// and https://github.com/facebook/react/blob/master/packages/shared/ReactFeatureFlags.js to verify which APIs are
+// flagged experimental or not. Experimental APIs will be tagged with `__EXPERIMENTAL__`.
+
+import React = require('react');
+import ReactDOM = require('.');
+
+export {};
+
+declare module '.' {
+    // enableSuspenseServerRenderer feature
+    interface HydrationOptions {
+        onHydrated?(suspenseInstance: Comment): void;
+        onDeleted?(suspenseInstance: Comment): void;
+    }
+
+    // exposeConcurrentModeAPIs features
+
+    interface RootOptions {
+        hydrate?: boolean;
+        hydrationOptions?: HydrationOptions;
+    }
+
+    interface Root {
+        render(children: React.ReactChild | React.ReactNodeArray, callback?: () => void): void;
+        unmount(callback?: () => void): void;
+    }
+
+    /**
+     * Replaces `ReactDOM.render` when the `.render` method is called and enables Blocking Mode.
+     *
+     * Opting into Concurrent Mode introduces semantic changes to how React works.
+     * This means that you can’t use Concurrent Mode in just a few components.
+     * Because of this, some apps may not be able to migrate directly to Concurrent Mode.
+     * Blocking Mode only contains a small subset of Concurrent Mode features and is intended
+     * as an intermediary migration step for apps that are unable to migrate directly.
+     *
+     * @see https://reactjs.org/docs/concurrent-mode-adoption.html#migration-step-blocking-mode
+     * @see https://reactjs.org/docs/concurrent-mode-reference.html#createblockingroot
+     */
+    function createBlockingRoot(
+        container: Element | Document | DocumentFragment | Comment,
+        options?: RootOptions,
+    ): Root;
+
+    /**
+     * Replaces `ReactDOM.render` when the `.render` method is called and enables Concurrent Mode.
+     *
+     * @see https://reactjs.org/docs/concurrent-mode-reference.html#createroot
+     */
+    function createRoot(container: Element | Document | DocumentFragment | Comment, options?: RootOptions): Root;
+
+    function unstable_discreteUpdates<R>(callback: () => R): R;
+
+    function unstable_discreteUpdates<R, A1>(callback: (a1: A1) => R, a1: A1): R;
+
+    function unstable_discreteUpdates<R, A1, A2>(callback: (a1: A1, a2: A2) => R, a1: A1, a2: A2): R;
+
+    function unstable_discreteUpdates<R, A1, A2, A3>(
+        callback: (a1: A1, a2: A2, a3: A3) => R,
+        a1: A1,
+        a2: A2,
+        a3: A3,
+    ): R;
+
+    function unstable_flushDiscreteUpdates(): void;
+
+    function unstable_flushControlled(callback: () => void): void;
+
+    // enableSelectiveHydration feature
+
+    /**
+     * @see https://github.com/facebook/react/commit/3a2b5f148d450c69aab67f055fc441d294c23518
+     */
+    function unstable_scheduleHydration(target: Element | Document | DocumentFragment | Comment): void;
+}

react-dom/index.d.ts

@@ -9,6 +9,10 @@
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.8
 
+// NOTE: Users of the `experimental` builds of React should add a reference
+// to 'react-dom/experimental' in their project. See experimental.d.ts's top comment
+// for reference and documentation on how exactly to do it.
+
 export as namespace ReactDOM;
 
 import {

react-dom/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react-dom",
-    "version": "16.9.0",
+    "version": "16.9.4",
     "description": "TypeScript definitions for React (react-dom)",
     "license": "MIT",
     "contributors": [
@@ -43,6 +43,6 @@
     "dependencies": {
         "@types/react": "*"
     },
-    "typesPublisherContentHash": "8dc4144e29251b4891bfa48d4945ccd931a8621fda922cb295595ea47a972501",
+    "typesPublisherContentHash": "3869812629e1187cb9fb43c30ddd1e1b1d9e6659cb2ac79d9d53533f6cce23ae",
     "typeScriptVersion": "2.8"
 }

react-dom/server/index.d.ts

@@ -14,7 +14,7 @@ import { ReactElement } from 'react';
  * 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,
+ * If you call `ReactDOM.hydrate()` 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.
  */

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

@@ -67,10 +67,6 @@ export interface ShallowRenderer {
      * After `shallowRenderer.render()` has been called, returns shallowly rendered output.
      */
     getRenderOutput<E extends ReactElement>(): E;
-    /**
-     * After `shallowRenderer.render()` has been called, returns shallowly rendered output.
-     */
-    getRenderOutput(): ReactElement;
     /**
      * Similar to `ReactDOM.render` but it doesn't require DOM and only renders a single level deep.
      */