@types/react 16.9.52 → 16.9.56

react/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for React (http://facebook.github.io/reac
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react.
 
 ### Additional Details
- * Last updated: Sun, 11 Oct 2020 14:24:44 GMT
+ * Last updated: Fri, 06 Nov 2020 08:32:07 GMT
  * Dependencies: [@types/csstype](https://npmjs.com/package/@types/csstype), [@types/prop-types](https://npmjs.com/package/@types/prop-types)
  * Global values: `React`
 

react/experimental.d.ts

@@ -39,6 +39,15 @@ import React = require('.');
 export {};
 
 declare module '.' {
+    export interface SuspenseProps {
+        /**
+         * The presence of this prop indicates that the content is computationally expensive to render.
+         * In other words, the tree is CPU bound and not I/O bound (e.g. due to fetching data).
+         * @see {@link https://github.com/facebook/react/pull/19936}
+         */
+        unstable_expectedLoadTime?: number;
+    }
+
     export type SuspenseListRevealOrder = 'forwards' | 'backwards' | 'together';
     export type SuspenseListTailMode = 'collapsed' | 'hidden';
 
@@ -94,7 +103,7 @@ declare module '.' {
      */
     export const unstable_SuspenseList: ExoticComponent<SuspenseListProps>;
 
-    export interface SuspenseConfig extends TimeoutConfig {
+    export interface SuspenseConfig {
         busyDelayMs?: number;
         busyMinDurationMs?: number;
     }
@@ -105,17 +114,6 @@ declare module '.' {
         config: SuspenseConfig | null | undefined,
     ): void;
 
-    export interface TimeoutConfig {
-        /**
-         * This timeout (in milliseconds) tells React how long to wait before showing the next state.
-         *
-         * React will always try to use a shorter lag when network and device allows it.
-         *
-         * **NOTE: We recommend that you share Suspense Config between different modules.**
-         */
-        timeoutMs: number;
-    }
-
     // must be synchronous
     export type TransitionFunction = () => void | undefined;
     // strange definition to allow vscode to show documentation on the invocation
@@ -139,11 +137,10 @@ declare module '.' {
      * A good example of this is a text input.
      *
      * @param value The value that is going to be deferred
-     * @param config An optional object with `timeoutMs`
      *
      * @see https://reactjs.org/docs/concurrent-mode-reference.html#usedeferredvalue
      */
-    export function unstable_useDeferredValue<T>(value: T, config?: TimeoutConfig | null): T;
+    export function unstable_useDeferredValue<T>(value: T): T;
 
     /**
      * Allows components to avoid undesirable loading states by waiting for content to load
@@ -164,9 +161,6 @@ declare module '.' {
      */
     export function unstable_useTransition(config?: SuspenseConfig | null): [TransitionStartFunction, boolean];
 
-    /**
-     * @private
-     */
     const opaqueIdentifierBranding: unique symbol;
     /**
      * WARNING: Don't use this as a `string`.
@@ -185,4 +179,11 @@ declare module '.' {
     };
 
     export function unstable_useOpaqueIdentifier(): OpaqueIdentifier;
+
+    /**
+     * Similar to `useTransition` but allows uses where hooks are not available.
+     *
+     * @param callback A _synchronous_ function which causes state updates that can be deferred.
+     */
+    export function unstable_startTransition(scope: TransitionFunction): void;
 }

react/index.d.ts

@@ -176,7 +176,6 @@ declare namespace React {
     }
 
     // ReactHTML for ReactHTMLElement
-    // tslint:disable-next-line:no-empty-interface
     interface ReactHTMLElement<T extends HTMLElement> extends DetailedReactHTMLElement<AllHTMLAttributes<T>, T> { }
 
     interface DetailedReactHTMLElement<P extends HTMLAttributes<T>, T extends HTMLElement> extends DOMElement<P, T> {
@@ -215,7 +214,6 @@ declare namespace React {
     type DOMFactory<P extends DOMAttributes<T>, T extends Element> =
         (props?: ClassAttributes<T> & P | null, ...children: ReactNode[]) => DOMElement<P, T>;
 
-    // tslint:disable-next-line:no-empty-interface
     interface HTMLFactory<T extends HTMLElement> extends DetailedHTMLFactory<AllHTMLAttributes<T>, T> {}
 
     interface DetailedHTMLFactory<P extends HTMLAttributes<T>, T extends HTMLElement> extends DOMFactory<P, T> {
@@ -431,7 +429,6 @@ declare namespace React {
     type ReactInstance = Component<any> | Element;
 
     // Base component for plain JS classes
-    // tslint:disable-next-line:no-empty-interface
     interface Component<P = {}, S = {}, SS = any> extends ComponentLifecycle<P, S, SS> { }
     class Component<P, S> {
         // tslint won't let me format the sample code in a way that vscode likes it :(
@@ -561,8 +558,10 @@ declare namespace React {
         displayName?: string;
     }
 
+    type ForwardedRef<T> = ((instance: T | null) => void) | MutableRefObject<T | null> | null;
+
     interface ForwardRefRenderFunction<T, P = {}> {
-        (props: PropsWithChildren<P>, ref: ((instance: T | null) => void) | MutableRefObject<T | null> | null): ReactElement | null;
+        (props: PropsWithChildren<P>, ref: ForwardedRef<T>): ReactElement | null;
         displayName?: string;
         // explicit rejected with `never` required due to
         // https://github.com/microsoft/TypeScript/issues/36826
@@ -1196,7 +1195,6 @@ declare namespace React {
         target: EventTarget & T;
     }
 
-    // tslint:disable-next-line:no-empty-interface
     interface FormEvent<T = Element> extends SyntheticEvent<T> {
     }
 
@@ -1921,6 +1919,17 @@ declare namespace React {
         wrap?: string;
     }
 
+    type HTMLAttributeReferrerPolicy =
+        | ''
+        | 'no-referrer'
+        | 'no-referrer-when-downgrade'
+        | 'origin'
+        | 'origin-when-cross-origin'
+        | 'same-origin'
+        | 'strict-origin'
+        | 'strict-origin-when-cross-origin'
+        | 'unsafe-url';
+
     interface AnchorHTMLAttributes<T> extends HTMLAttributes<T> {
         download?: any;
         href?: string;
@@ -1930,10 +1939,9 @@ declare namespace React {
         rel?: string;
         target?: string;
         type?: string;
-        referrerPolicy?: string;
+        referrerPolicy?: HTMLAttributeReferrerPolicy;
     }
 
-    // tslint:disable-next-line:no-empty-interface
     interface AudioHTMLAttributes<T> extends MediaHTMLAttributes<T> {}
 
     interface AreaHTMLAttributes<T> extends HTMLAttributes<T> {
@@ -1943,6 +1951,7 @@ declare namespace React {
         href?: string;
         hrefLang?: string;
         media?: string;
+        referrerPolicy?: HTMLAttributeReferrerPolicy;
         rel?: string;
         shape?: string;
         target?: string;
@@ -2044,7 +2053,7 @@ declare namespace React {
         /** @deprecated */
         marginWidth?: number;
         name?: string;
-        referrerPolicy?: string;
+        referrerPolicy?: HTMLAttributeReferrerPolicy;
         sandbox?: string;
         /** @deprecated */
         scrolling?: string;
@@ -2060,7 +2069,7 @@ declare namespace React {
         decoding?: "async" | "auto" | "sync";
         height?: number | string;
         loading?: "eager" | "lazy";
-        referrerPolicy?: "no-referrer" | "origin" | "unsafe-url";
+        referrerPolicy?: HTMLAttributeReferrerPolicy;
         sizes?: string;
         src?: string;
         srcSet?: string;
@@ -2136,6 +2145,7 @@ declare namespace React {
         hrefLang?: string;
         integrity?: string;
         media?: string;
+        referrerPolicy?: HTMLAttributeReferrerPolicy;
         rel?: string;
         sizes?: string;
         type?: string;
@@ -2243,6 +2253,7 @@ declare namespace React {
         integrity?: string;
         noModule?: boolean;
         nonce?: string;
+        referrerPolicy?: HTMLAttributeReferrerPolicy;
         src?: string;
         type?: string;
     }
@@ -2955,7 +2966,6 @@ type ReactManagedAttributes<C, P> = C extends { propTypes: infer T; defaultProps
 
 declare global {
     namespace JSX {
-        // tslint:disable-next-line:no-empty-interface
         interface Element extends React.ReactElement<any, any> { }
         interface ElementClass extends React.Component<any> {
             render(): React.ReactNode;
@@ -2971,9 +2981,7 @@ declare global {
                 : ReactManagedAttributes<T, P>
             : ReactManagedAttributes<C, P>;
 
-        // tslint:disable-next-line:no-empty-interface
         interface IntrinsicAttributes extends React.Attributes { }
-        // tslint:disable-next-line:no-empty-interface
         interface IntrinsicClassAttributes<T> extends React.ClassAttributes<T> { }
 
         interface IntrinsicElements {

react/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react",
-    "version": "16.9.52",
+    "version": "16.9.56",
     "description": "TypeScript definitions for React",
     "license": "MIT",
     "contributors": [
@@ -144,6 +144,6 @@
         "@types/prop-types": "*",
         "csstype": "^3.0.2"
     },
-    "typesPublisherContentHash": "acb1626297b65b77b9885569664e62712c915d5a42deb31b61d62a065d2940cf",
+    "typesPublisherContentHash": "798794c43c5b79f66e0591a278096a90cfd06e875df950c18d74b907d73d7c62",
     "typeScriptVersion": "3.2"
 }