@types/react-dom 18.3.0 → 19.2.0

react-dom/README.md

@@ -2,14 +2,15 @@
 > `npm install --save @types/react-dom`
 
 # Summary
-This package contains type definitions for react-dom (https://reactjs.org).
+This package contains type definitions for react-dom (https://react.dev/).
 
 # Details
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom.
 
 ### Additional Details
- * Last updated: Thu, 25 Apr 2024 20:07:03 GMT
- * Dependencies: [@types/react](https://npmjs.com/package/@types/react)
+ * Last updated: Wed, 01 Oct 2025 22:02:19 GMT
+ * Dependencies: none
+ * Peer dependencies: [@types/react](https://npmjs.com/package/@types/react)
 
 # 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), [Jessica Franco](https://github.com/Jessidhia), and [Sebastian Silbermann](https://github.com/eps1lon).

react-dom/canary.d.ts

@@ -1,3 +1,5 @@
+/* eslint-disable @definitelytyped/no-self-import -- self-imports in module augmentations aren't self-imports */
+/* eslint-disable @definitelytyped/no-declare-current-package -- The module augmentations are optional */
 /**
  * These are types for things that are present in the upcoming React 18 release.
  *
@@ -30,155 +32,3 @@ import React = require("react");
 import ReactDOM = require(".");
 
 export {};
-
-declare const REACT_FORM_STATE_SIGIL: unique symbol;
-
-declare module "." {
-    function prefetchDNS(href: string): void;
-
-    interface PreconnectOptions {
-        // Don't create a helper type.
-        // It would have to be in module scope to be inlined in TS tooltips.
-        // But then it becomes part of the public API.
-        // TODO: Upstream to microsoft/TypeScript-DOM-lib-generator -> w3c/webref
-        // since the spec has a notion of a dedicated type: https://html.spec.whatwg.org/multipage/urls-and-fetching.html#cors-settings-attribute
-        crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
-    }
-    function preconnect(href: string, options?: PreconnectOptions): void;
-
-    type PreloadAs =
-        | "audio"
-        | "document"
-        | "embed"
-        | "fetch"
-        | "font"
-        | "image"
-        | "object"
-        | "track"
-        | "script"
-        | "style"
-        | "video"
-        | "worker";
-    interface PreloadOptions {
-        as: PreloadAs;
-        crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
-        fetchPriority?: "high" | "low" | "auto" | undefined;
-        // TODO: These should only be allowed with `as: 'image'` but it's not trivial to write tests against the full TS support matrix.
-        imageSizes?: string | undefined;
-        imageSrcSet?: string | undefined;
-        integrity?: string | undefined;
-        type?: string | undefined;
-        nonce?: string | undefined;
-        referrerPolicy?: ReferrerPolicy | undefined;
-    }
-    function preload(href: string, options?: PreloadOptions): void;
-
-    // https://html.spec.whatwg.org/multipage/links.html#link-type-modulepreload
-    type PreloadModuleAs = RequestDestination;
-    interface PreloadModuleOptions {
-        /**
-         * @default "script"
-         */
-        as: PreloadModuleAs;
-        crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
-        integrity?: string | undefined;
-        nonce?: string | undefined;
-    }
-    function preloadModule(href: string, options?: PreloadModuleOptions): void;
-
-    type PreinitAs = "script" | "style";
-    interface PreinitOptions {
-        as: PreinitAs;
-        crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
-        fetchPriority?: "high" | "low" | "auto" | undefined;
-        precedence?: string | undefined;
-        integrity?: string | undefined;
-        nonce?: string | undefined;
-    }
-    function preinit(href: string, options?: PreinitOptions): void;
-
-    // Will be expanded to include all of https://github.com/tc39/proposal-import-attributes
-    type PreinitModuleAs = "script";
-    interface PreinitModuleOptions {
-        /**
-         * @default "script"
-         */
-        as?: PreinitModuleAs;
-        crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
-        integrity?: string | undefined;
-        nonce?: string | undefined;
-    }
-    function preinitModule(href: string, options?: PreinitModuleOptions): void;
-
-    interface FormStatusNotPending {
-        pending: false;
-        data: null;
-        method: null;
-        action: null;
-    }
-
-    interface FormStatusPending {
-        pending: true;
-        data: FormData;
-        method: string;
-        action: string | ((formData: FormData) => void | Promise<void>);
-    }
-
-    type FormStatus = FormStatusPending | FormStatusNotPending;
-
-    function useFormStatus(): FormStatus;
-
-    function useFormState<State>(
-        action: (state: Awaited<State>) => State | Promise<State>,
-        initialState: Awaited<State>,
-        permalink?: string,
-    ): [state: Awaited<State>, dispatch: () => void, isPending: boolean];
-    function useFormState<State, Payload>(
-        action: (state: Awaited<State>, payload: Payload) => State | Promise<State>,
-        initialState: Awaited<State>,
-        permalink?: string,
-    ): [state: Awaited<State>, dispatch: (payload: Payload) => void, isPending: boolean];
-
-    function requestFormReset(form: HTMLFormElement): void;
-}
-
-declare module "./client" {
-    interface ReactFormState {
-        [REACT_FORM_STATE_SIGIL]: never;
-    }
-
-    interface RootOptions {
-        onUncaughtError?:
-            | ((error: unknown, errorInfo: { componentStack?: string | undefined }) => void)
-            | undefined;
-        onCaughtError?:
-            | ((
-                error: unknown,
-                errorInfo: {
-                    componentStack?: string | undefined;
-                    errorBoundary?: React.Component<unknown> | undefined;
-                },
-            ) => void)
-            | undefined;
-    }
-
-    interface HydrationOptions {
-        formState?: ReactFormState | null;
-        onUncaughtError?:
-            | ((error: unknown, errorInfo: { componentStack?: string | undefined }) => void)
-            | undefined;
-        onCaughtError?:
-            | ((
-                error: unknown,
-                errorInfo: {
-                    componentStack?: string | undefined;
-                    errorBoundary?: React.Component<unknown> | undefined;
-                },
-            ) => void)
-            | undefined;
-    }
-
-    interface DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_CREATE_ROOT_CONTAINERS {
-        document: Document;
-    }
-}

react-dom/client.d.ts

@@ -5,12 +5,33 @@
 // See https://github.com/facebook/react/blob/main/packages/react-dom/client.js to see how the exports are declared,
 
 import React = require("react");
+
+export {};
+
+declare const REACT_FORM_STATE_SIGIL: unique symbol;
+export interface ReactFormState {
+    [REACT_FORM_STATE_SIGIL]: never;
+}
+
 export interface HydrationOptions {
+    formState?: ReactFormState | null;
     /**
      * Prefix for `useId`.
      */
     identifierPrefix?: string;
+    onUncaughtError?:
+        | ((error: unknown, errorInfo: { componentStack?: string | undefined }) => void)
+        | undefined;
     onRecoverableError?: (error: unknown, errorInfo: ErrorInfo) => void;
+    onCaughtError?:
+        | ((
+            error: unknown,
+            errorInfo: {
+                componentStack?: string | undefined;
+                errorBoundary?: React.Component<unknown> | undefined;
+            },
+        ) => void)
+        | undefined;
 }
 
 export interface RootOptions {
@@ -18,11 +39,22 @@ export interface RootOptions {
      * Prefix for `useId`.
      */
     identifierPrefix?: string;
+    onUncaughtError?:
+        | ((error: unknown, errorInfo: { componentStack?: string | undefined }) => void)
+        | undefined;
     onRecoverableError?: (error: unknown, errorInfo: ErrorInfo) => void;
+    onCaughtError?:
+        | ((
+            error: unknown,
+            errorInfo: {
+                componentStack?: string | undefined;
+                errorBoundary?: React.Component<unknown> | undefined;
+            },
+        ) => void)
+        | undefined;
 }
 
 export interface ErrorInfo {
-    digest?: string;
     componentStack?: string;
 }
 
@@ -41,6 +73,7 @@ export interface DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_CREATE_ROOT_CONTAI
 export type Container =
     | Element
     | DocumentFragment
+    | Document
     | DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_CREATE_ROOT_CONTAINERS[
         keyof DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_CREATE_ROOT_CONTAINERS
     ];

react-dom/experimental.d.ts

@@ -32,5 +32,56 @@ import ReactDOM = require("./canary");
 
 export {};
 
+declare const UNDEFINED_VOID_ONLY: unique symbol;
+type VoidOrUndefinedOnly = void | { [UNDEFINED_VOID_ONLY]: never };
+
 declare module "." {
 }
+
+declare module "react" {
+    interface ViewTransitionPseudoElement extends Animatable {
+        getComputedStyle: () => CSSStyleDeclaration;
+    }
+
+    interface ViewTransitionInstance {
+        group: ViewTransitionPseudoElement;
+        imagePair: ViewTransitionPseudoElement;
+        old: ViewTransitionPseudoElement;
+        new: ViewTransitionPseudoElement;
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-empty-interface
+    interface GestureProvider extends AnimationTimeline {}
+
+    // @enableFragmentRefs
+    interface FragmentInstance {
+        blur: () => void;
+        focus: (focusOptions?: FocusOptions | undefined) => void;
+        focusLast: (focusOptions?: FocusOptions | undefined) => void;
+        observeUsing(observer: IntersectionObserver | ResizeObserver): void;
+        unobserveUsing(observer: IntersectionObserver | ResizeObserver): void;
+        getClientRects(): Array<DOMRect>;
+        getRootNode(getRootNodeOptions?: GetRootNodeOptions | undefined): Document | ShadowRoot | FragmentInstance;
+        addEventListener(
+            type: string,
+            listener: EventListener,
+            optionsOrUseCapture?: Parameters<Element["addEventListener"]>[2],
+        ): void;
+        removeEventListener(
+            type: string,
+            listener: EventListener,
+            optionsOrUseCapture?: Parameters<Element["removeEventListener"]>[2],
+        ): void;
+        experimental_scrollIntoView(alignToTop?: boolean): void;
+    }
+}
+
+declare module "./client" {
+    type TransitionIndicatorCleanup = () => VoidOrUndefinedOnly;
+    interface RootOptions {
+        onDefaultTransitionIndicator?: (() => void | TransitionIndicatorCleanup) | undefined;
+    }
+    interface HydrationOptions {
+        onDefaultTransitionIndicator?: (() => void | TransitionIndicatorCleanup) | undefined;
+    }
+}

react-dom/index.d.ts

@@ -4,146 +4,130 @@
 
 export as namespace ReactDOM;
 
-import {
-    CElement,
-    Component,
-    ComponentState,
-    DOMAttributes,
-    DOMElement,
-    FunctionComponentElement,
-    ReactElement,
-    ReactInstance,
-    ReactNode,
-    ReactPortal,
-} from "react";
-
-/**
- * @deprecated See https://react.dev/reference/react-dom/findDOMNode#alternatives
- */
-export function findDOMNode(instance: ReactInstance | null | undefined): Element | null | Text;
-/**
- * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
- */
-export function unmountComponentAtNode(container: Element | DocumentFragment): boolean;
+import { Key, ReactNode, ReactPortal } from "react";
+
+declare module "react" {
+    // eslint-disable-next-line @typescript-eslint/no-empty-interface
+    interface CacheSignal extends AbortSignal {}
+}
 
 export function createPortal(
     children: ReactNode,
     container: Element | DocumentFragment,
-    key?: null | string,
+    key?: Key | null,
 ): ReactPortal;
 
 export const version: string;
-/**
- * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
- */
-export const render: Renderer;
-/**
- * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
- */
-export const hydrate: Renderer;
 
 export function flushSync<R>(fn: () => R): R;
 
 export function unstable_batchedUpdates<A, R>(callback: (a: A) => R, a: A): R;
 export function unstable_batchedUpdates<R>(callback: () => R): R;
 
-/**
- * @deprecated
- */
-export function unstable_renderSubtreeIntoContainer<T extends Element>(
-    parentComponent: Component<any>,
-    element: DOMElement<DOMAttributes<T>, T>,
-    container: Element,
-    callback?: (element: T) => any,
-): T;
-/**
- * @deprecated
- */
-export function unstable_renderSubtreeIntoContainer<P, T extends Component<P, ComponentState>>(
-    parentComponent: Component<any>,
-    element: CElement<P, T>,
-    container: Element,
-    callback?: (component: T) => any,
-): T;
-/**
- * @deprecated
- */
-export function unstable_renderSubtreeIntoContainer<P>(
-    parentComponent: Component<any>,
-    element: ReactElement<P>,
-    container: Element,
-    callback?: (component?: Component<P, ComponentState> | Element) => any,
-    // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-): 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.
-
-    /**
-     * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
-     */
-    <T extends Element>(
-        element: DOMElement<DOMAttributes<T>, T>,
-        container: Container | null,
-        callback?: () => void,
-    ): T;
-
-    /**
-     * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
-     */
-    (
-        element: Array<DOMElement<DOMAttributes<any>, any>>,
-        container: Container | null,
-        callback?: () => void,
-    ): Element;
-
-    /**
-     * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
-     */
-    (
-        element: FunctionComponentElement<any> | Array<FunctionComponentElement<any>>,
-        container: Container | null,
-        callback?: () => void,
-    ): void;
+export interface FormStatusNotPending {
+    pending: false;
+    data: null;
+    method: null;
+    action: null;
+}
 
-    /**
-     * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
-     */
-    <P, T extends Component<P, ComponentState>>(
-        element: CElement<P, T>,
-        container: Container | null,
-        callback?: () => void,
-    ): T;
+export interface FormStatusPending {
+    pending: true;
+    data: FormData;
+    method: string;
+    action: string | ((formData: FormData) => void | Promise<void>);
+}
 
-    /**
-     * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
-     */
-    (
-        element: Array<CElement<any, Component<any, ComponentState>>>,
-        container: Container | null,
-        callback?: () => void,
-    ): Component<any, ComponentState>;
+export type FormStatus = FormStatusPending | FormStatusNotPending;
+
+export function useFormStatus(): FormStatus;
+
+export function useFormState<State>(
+    action: (state: Awaited<State>) => State | Promise<State>,
+    initialState: Awaited<State>,
+    permalink?: string,
+): [state: Awaited<State>, dispatch: () => void, isPending: boolean];
+export function useFormState<State, Payload>(
+    action: (state: Awaited<State>, payload: Payload) => State | Promise<State>,
+    initialState: Awaited<State>,
+    permalink?: string,
+): [state: Awaited<State>, dispatch: (payload: Payload) => void, isPending: boolean];
+
+export function prefetchDNS(href: string): void;
+
+export interface PreconnectOptions {
+    // Don't create a helper type.
+    // It would have to be in module scope to be inlined in TS tooltips.
+    // But then it becomes part of the public API.
+    // TODO: Upstream to microsoft/TypeScript-DOM-lib-generator -> w3c/webref
+    // since the spec has a notion of a dedicated type: https://html.spec.whatwg.org/multipage/urls-and-fetching.html#cors-settings-attribute
+    crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
+}
+export function preconnect(href: string, options?: PreconnectOptions): void;
+
+export type PreloadAs =
+    | "audio"
+    | "document"
+    | "embed"
+    | "fetch"
+    | "font"
+    | "image"
+    | "object"
+    | "track"
+    | "script"
+    | "style"
+    | "video"
+    | "worker";
+export interface PreloadOptions {
+    as: PreloadAs;
+    crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
+    fetchPriority?: "high" | "low" | "auto" | undefined;
+    // TODO: These should only be allowed with `as: 'image'` but it's not trivial to write tests against the full TS support matrix.
+    imageSizes?: string | undefined;
+    imageSrcSet?: string | undefined;
+    integrity?: string | undefined;
+    type?: string | undefined;
+    nonce?: string | undefined;
+    referrerPolicy?: ReferrerPolicy | undefined;
+    media?: string | undefined;
+}
+export function preload(href: string, options?: PreloadOptions): void;
 
+// https://html.spec.whatwg.org/multipage/links.html#link-type-modulepreload
+export type PreloadModuleAs = RequestDestination;
+export interface PreloadModuleOptions {
     /**
-     * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
+     * @default "script"
      */
-    <P>(
-        element: ReactElement<P>,
-        container: Container | null,
-        callback?: () => void,
-        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-    ): Component<P, ComponentState> | Element | void;
+    as: PreloadModuleAs;
+    crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
+    integrity?: string | undefined;
+    nonce?: string | undefined;
+}
+export function preloadModule(href: string, options?: PreloadModuleOptions): void;
+
+export type PreinitAs = "script" | "style";
+export interface PreinitOptions {
+    as: PreinitAs;
+    crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
+    fetchPriority?: "high" | "low" | "auto" | undefined;
+    precedence?: string | undefined;
+    integrity?: string | undefined;
+    nonce?: string | undefined;
+}
+export function preinit(href: string, options?: PreinitOptions): void;
 
+// Will be expanded to include all of https://github.com/tc39/proposal-import-attributes
+export type PreinitModuleAs = "script";
+export interface PreinitModuleOptions {
     /**
-     * @deprecated See https://react.dev/blog/2022/03/08/react-18-upgrade-guide#updates-to-client-rendering-apis
+     * @default "script"
      */
-    (
-        element: ReactElement[],
-        container: Container | null,
-        callback?: () => void,
-        // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
-    ): Component<any, ComponentState> | Element | void;
+    as?: PreinitModuleAs;
+    crossOrigin?: "anonymous" | "use-credentials" | "" | undefined;
+    integrity?: string | undefined;
+    nonce?: string | undefined;
 }
+export function preinitModule(href: string, options?: PreinitModuleOptions): void;
+
+export function requestFormReset(form: HTMLFormElement): void;

react-dom/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react-dom",
-    "version": "18.3.0",
+    "version": "19.2.0",
     "description": "TypeScript definitions for react-dom",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom",
     "license": "MIT",
@@ -61,6 +61,46 @@
                 "default": "./server.d.ts"
             }
         },
+        "./server.browser": {
+            "types": {
+                "default": "./server.browser.d.ts"
+            }
+        },
+        "./server.bun": {
+            "types": {
+                "default": "./server.bun.d.ts"
+            }
+        },
+        "./server.edge": {
+            "types": {
+                "default": "./server.edge.d.ts"
+            }
+        },
+        "./server.node": {
+            "types": {
+                "default": "./server.node.d.ts"
+            }
+        },
+        "./static": {
+            "types": {
+                "default": "./static.d.ts"
+            }
+        },
+        "./static.browser": {
+            "types": {
+                "default": "./static.browser.d.ts"
+            }
+        },
+        "./static.edge": {
+            "types": {
+                "default": "./static.edge.d.ts"
+            }
+        },
+        "./static.node": {
+            "types": {
+                "default": "./static.node.d.ts"
+            }
+        },
         "./experimental": {
             "types": {
                 "default": "./experimental.d.ts"
@@ -79,9 +119,10 @@
         "directory": "types/react-dom"
     },
     "scripts": {},
-    "dependencies": {
-        "@types/react": "*"
+    "dependencies": {},
+    "peerDependencies": {
+        "@types/react": "^19.2.0"
     },
-    "typesPublisherContentHash": "6e701783391e040466f55ff67d4efe35c3cbc5868b0a0937f1dfb8f63fce36fc",
-    "typeScriptVersion": "4.7"
+    "typesPublisherContentHash": "4a296bd89e24edb236357aa2daf5e5f23648fa3270267dfef1e71cafb2822417",
+    "typeScriptVersion": "5.2"
 }

react-dom/server.browser.d.ts

@@ -0,0 +1 @@
+export { renderToReadableStream, renderToStaticMarkup, renderToString } from "./server";

react-dom/server.bun.d.ts

@@ -0,0 +1 @@
+export { renderToReadableStream, renderToStaticMarkup, renderToString } from "./server";