@types/react-dom 17.0.5 → 17.0.9

react-dom/README.md

@@ -8,7 +8,7 @@ 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: Thu, 13 May 2021 07:31:26 GMT
+ * Last updated: Wed, 07 Jul 2021 17:33:41 GMT
  * Dependencies: [@types/react](https://npmjs.com/package/@types/react)
  * Global values: `ReactDOM`, `ReactDOMNodeStream`, `ReactDOMServer`
 

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

@@ -10,6 +10,10 @@
 // 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.

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 | undefined;
+        /**
+         * @deprecated Use `hydrateRoot(container, hydrateOptions)` instead
+         */
+        hydrationOptions?: HydrationOptions | undefined;
+    }
+
+    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.5",
+    "version": "17.0.9",
     "description": "TypeScript definitions for React (react-dom)",
+    "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom",
     "license": "MIT",
     "contributors": [
         {
@@ -48,6 +49,6 @@
     "dependencies": {
         "@types/react": "*"
     },
-    "typesPublisherContentHash": "efcabc29f4b12c5b1112d528883bab336df851747e5a829ebb92aa30b1895336",
-    "typeScriptVersion": "3.5"
+    "typesPublisherContentHash": "e186af0c24782790d3143b55e1b197a3d699d977458e37175756b95d0aaa4750",
+    "typeScriptVersion": "3.6"
 }

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

@@ -10,52 +10,52 @@ import * as ReactTestUtils from ".";
 export {};
 
 export interface OptionalEventProperties {
-    bubbles?: boolean;
-    cancelable?: boolean;
-    currentTarget?: EventTarget;
-    defaultPrevented?: boolean;
-    eventPhase?: number;
-    isTrusted?: boolean;
-    nativeEvent?: Event;
+    bubbles?: boolean | undefined;
+    cancelable?: boolean | undefined;
+    currentTarget?: EventTarget | undefined;
+    defaultPrevented?: boolean | undefined;
+    eventPhase?: number | undefined;
+    isTrusted?: boolean | undefined;
+    nativeEvent?: Event | undefined;
     preventDefault?(): void;
     stopPropagation?(): void;
-    target?: EventTarget;
-    timeStamp?: Date;
-    type?: string;
+    target?: EventTarget | undefined;
+    timeStamp?: Date | undefined;
+    type?: string | undefined;
 }
 
 export interface SyntheticEventData extends OptionalEventProperties {
-    altKey?: boolean;
-    button?: number;
-    buttons?: number;
-    clientX?: number;
-    clientY?: number;
-    changedTouches?: TouchList;
-    charCode?: number;
-    clipboardData?: DataTransfer;
-    ctrlKey?: boolean;
-    deltaMode?: number;
-    deltaX?: number;
-    deltaY?: number;
-    deltaZ?: number;
-    detail?: number;
+    altKey?: boolean | undefined;
+    button?: number | undefined;
+    buttons?: number | undefined;
+    clientX?: number | undefined;
+    clientY?: number | undefined;
+    changedTouches?: TouchList | undefined;
+    charCode?: number | undefined;
+    clipboardData?: DataTransfer | undefined;
+    ctrlKey?: boolean | undefined;
+    deltaMode?: number | undefined;
+    deltaX?: number | undefined;
+    deltaY?: number | undefined;
+    deltaZ?: number | undefined;
+    detail?: number | undefined;
     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;
+    key?: string | undefined;
+    keyCode?: number | undefined;
+    locale?: string | undefined;
+    location?: number | undefined;
+    metaKey?: boolean | undefined;
+    pageX?: number | undefined;
+    pageY?: number | undefined;
+    relatedTarget?: EventTarget | undefined;
+    repeat?: boolean | undefined;
+    screenX?: number | undefined;
+    screenY?: number | undefined;
+    shiftKey?: boolean | undefined;
+    targetTouches?: TouchList | undefined;
+    touches?: TouchList | undefined;
+    view?: AbstractView | undefined;
+    which?: number | undefined;
 }
 
 export type EventSimulator = (element: Element | Component<any>, eventData?: SyntheticEventData) => void;