@types/react-dom 17.0.4 → 17.0.8

react-dom/README.md

@@ -8,9 +8,9 @@ This package contains type definitions for React (react-dom) (https://reactjs.or
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom.
 
 ### Additional Details
- * Last updated: Mon, 10 May 2021 22:31:25 GMT
+ * Last updated: Fri, 18 Jun 2021 06:01:13 GMT
  * Dependencies: [@types/react](https://npmjs.com/package/@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), and [Jessica Franco](https://github.com/Jessidhia).
+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), and [Sebastian Silbermann](https://github.com/eps1lon).

react-dom/experimental.d.ts

@@ -29,36 +29,11 @@
 // flagged experimental or not. Experimental APIs will be tagged with `__EXPERIMENTAL__`.
 
 import React = require('react');
-import ReactDOM = require('.');
+import ReactDOM = require('./next');
 
 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 Concurrent Mode.
-     *
-     * @see https://reactjs.org/docs/concurrent-mode-reference.html#createroot
-     */
-    function unstable_createRoot(container: Element | Document | DocumentFragment | Comment, options?: RootOptions): Root;
-
     function unstable_flushControlled(callback: () => void): void;
 
     // enableSelectiveHydration feature

react-dom/index.d.ts

@@ -6,9 +6,14 @@
 //                 MartynasZilinskas <https://github.com/MartynasZilinskas>
 //                 Josh Rutherford <https://github.com/theruther4d>
 //                 Jessica Franco <https://github.com/Jessidhia>
+//                 Sebastian Silbermann <https://github.com/eps1lon>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.8
 
+// NOTE: Users of the upcoming React 18 release should add a reference
+// to 'react-dom/next' in their project. See next.d.ts's top comment
+// for reference and documentation on how exactly to do it.
+
 // 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.
@@ -53,49 +58,51 @@ export function unstable_renderSubtreeIntoContainer<P>(
     container: Element,
     callback?: (component?: Component<P, ComponentState> | Element) => any): Component<P, ComponentState> | Element | void;
 
+export type Container = Element | Document | DocumentFragment;
+
 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 | DocumentFragment | null,
+        container: Container| null,
         callback?: () => void
     ): T;
 
     (
         element: Array<DOMElement<DOMAttributes<any>, any>>,
-        container: Element | DocumentFragment | null,
+        container: Container| null,
         callback?: () => void
     ): Element;
 
     (
         element: SFCElement<any> | Array<SFCElement<any>>,
-        container: Element | DocumentFragment | null,
+        container: Container| null,
         callback?: () => void
     ): void;
 
     <P, T extends Component<P, ComponentState>>(
         element: CElement<P, T>,
-        container: Element | DocumentFragment | null,
+        container: Container| null,
         callback?: () => void
     ): T;
 
     (
         element: Array<CElement<any, Component<any, ComponentState>>>,
-        container: Element | DocumentFragment | null,
+        container: Container| null,
         callback?: () => void
     ): Component<any, ComponentState>;
 
     <P>(
         element: ReactElement<P>,
-        container: Element | DocumentFragment | null,
+        container: Container| null,
         callback?: () => void
     ): Component<P, ComponentState> | Element | void;
 
     (
         element: ReactElement[],
-        container: Element | DocumentFragment | null,
+        container: Container| null,
         callback?: () => void
     ): Component<any, ComponentState> | Element | void;
 }

react-dom/next.d.ts

@@ -0,0 +1,63 @@
+/**
+ * These are types for things that are present in the upcoming React 18 release.
+ *
+ * Once React 18 is released 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/next"` 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/next'
+ * ```
+ *
+ * It is also possible to include it through a triple-slash reference:
+ *
+ * ```ts
+ * /// <reference types="react-dom/next" />
+ * ```
+ *
+ * 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,
+
+import React = require('react');
+import ReactDOM = require('.');
+
+export {};
+
+declare module '.' {
+    interface HydrationOptions {
+        onHydrated?(suspenseInstance: Comment): void;
+        onDeleted?(suspenseInstance: Comment): void;
+    }
+
+    interface RootOptions {
+        /**
+         * @deprecated Use `hydrateRoot(container)` instead
+         */
+        hydrate?: boolean;
+        /**
+         * @deprecated Use `hydrateRoot(container, hydrateOptions)` instead
+         */
+        hydrationOptions?: HydrationOptions;
+    }
+
+    interface Root {
+        render(children: React.ReactChild | React.ReactNodeArray): void;
+        unmount(): void;
+    }
+
+    /**
+     * 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 hydrateRoot(container: Element | Document | DocumentFragment | Comment, options?: HydrationOptions): Root;
+}

react-dom/package.json

@@ -1,7 +1,8 @@
 {
     "name": "@types/react-dom",
-    "version": "17.0.4",
+    "version": "17.0.8",
     "description": "TypeScript definitions for React (react-dom)",
+    "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom",
     "license": "MIT",
     "contributors": [
         {
@@ -30,6 +31,11 @@
             "name": "Jessica Franco",
             "url": "https://github.com/Jessidhia",
             "githubUsername": "Jessidhia"
+        },
+        {
+            "name": "Sebastian Silbermann",
+            "url": "https://github.com/eps1lon",
+            "githubUsername": "eps1lon"
         }
     ],
     "main": "",
@@ -43,6 +49,6 @@
     "dependencies": {
         "@types/react": "*"
     },
-    "typesPublisherContentHash": "f6ef2f5cdf9e3adf7cc9fe9efc08259a2712408862af5d62dbfe1ac1dad2162d",
-    "typeScriptVersion": "3.5"
+    "typesPublisherContentHash": "4cc8842db00c8a8ee4a599dde279d26456cf4f53e7c086e2b7ce575e9286f620",
+    "typeScriptVersion": "3.6"
 }