@types/react-dom 19.1.2 → 19.2.3

react-dom/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for react-dom (https://react.dev/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom.
 
 ### Additional Details
- * Last updated: Wed, 09 Apr 2025 07:33:26 GMT
+ * Last updated: Wed, 12 Nov 2025 04:37:38 GMT
  * Dependencies: none
  * Peer dependencies: [@types/react](https://npmjs.com/package/@types/react)
 

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,3 +32,40 @@ import React = require("react");
 import ReactDOM = require(".");
 
 export {};
+
+declare module "react" {
+    // @enableViewTransition
+    interface ViewTransitionPseudoElement extends Animatable {
+        getComputedStyle: () => CSSStyleDeclaration;
+    }
+
+    interface ViewTransitionInstance {
+        group: ViewTransitionPseudoElement;
+        imagePair: ViewTransitionPseudoElement;
+        old: ViewTransitionPseudoElement;
+        new: ViewTransitionPseudoElement;
+    }
+
+    // @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;
+        dispatchEvent(event: Event): boolean;
+        scrollIntoView(alignToTop?: boolean): void;
+    }
+}

react-dom/client.d.ts

@@ -96,7 +96,7 @@ export function createRoot(container: Container, options?: RootOptions): Root;
  * hydrateRoot(document.querySelector('#root'), <App />)
  * ```
  *
- * @see https://reactjs.org/docs/react-dom-client.html#hydrateroot
+ * @see https://react.dev/reference/react-dom/client/hydrateRoot
  */
 export function hydrateRoot(
     container: Element | Document,

react-dom/experimental.d.ts

@@ -32,42 +32,23 @@ 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;
+declare module "./client" {
+    type TransitionIndicatorCleanup = () => VoidOrUndefinedOnly;
+    interface RootOptions {
+        onDefaultTransitionIndicator?: (() => void | TransitionIndicatorCleanup) | undefined;
+    }
+    interface HydrationOptions {
+        onDefaultTransitionIndicator?: (() => void | TransitionIndicatorCleanup) | undefined;
     }
 }

react-dom/index.d.ts

@@ -6,6 +6,11 @@ export as namespace ReactDOM;
 
 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,
@@ -84,6 +89,7 @@ export interface PreloadOptions {
     type?: string | undefined;
     nonce?: string | undefined;
     referrerPolicy?: ReferrerPolicy | undefined;
+    media?: string | undefined;
 }
 export function preload(href: string, options?: PreloadOptions): void;
 

react-dom/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react-dom",
-    "version": "19.1.2",
+    "version": "19.2.3",
     "description": "TypeScript definitions for react-dom",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom",
     "license": "MIT",
@@ -61,11 +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"
@@ -86,8 +121,8 @@
     "scripts": {},
     "dependencies": {},
     "peerDependencies": {
-        "@types/react": "^19.0.0"
+        "@types/react": "^19.2.0"
     },
-    "typesPublisherContentHash": "7ab9792afe2f21119a96d1a27254c2d4ebc080cb8dab8cd4e76a23cf2a0910c5",
-    "typeScriptVersion": "5.1"
+    "typesPublisherContentHash": "6f16aac4f50b7ebe3201fdac53a58874d2899d6108894538ade2d61fbb99f8c5",
+    "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";

react-dom/server.d.ts

@@ -22,13 +22,42 @@ declare global {
 }
 
 import { ReactNode } from "react";
-import { ErrorInfo } from "./client";
+import { ErrorInfo, ReactFormState } from "./client";
+import { PostponedState, ResumeOptions } from "./static";
 
-export type BootstrapScriptDescriptor = {
+export interface BootstrapScriptDescriptor {
     src: string;
     integrity?: string | undefined;
     crossOrigin?: string | undefined;
-};
+}
+
+/**
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap Import maps}
+ */
+// TODO: Ideally TypeScripts standard library would include this type.
+// Until then we keep the prefixed one for future compatibility.
+export interface ReactImportMap {
+    /**
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap#imports `imports` reference}
+     */
+    imports?: {
+        [specifier: string]: string;
+    } | undefined;
+    /**
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap#integrity `integrity` reference}
+     */
+    integrity?: {
+        [moduleURL: string]: string;
+    } | undefined;
+    /**
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap#scopes `scopes` reference}
+     */
+    scopes?: {
+        [scope: string]: {
+            [specifier: string]: string;
+        };
+    } | undefined;
+}
 
 export interface RenderToPipeableStreamOptions {
     identifierPrefix?: string;
@@ -37,11 +66,20 @@ export interface RenderToPipeableStreamOptions {
     bootstrapScriptContent?: string;
     bootstrapScripts?: Array<string | BootstrapScriptDescriptor>;
     bootstrapModules?: Array<string | BootstrapScriptDescriptor>;
+    /**
+     * Maximum length of the header content in unicode code units i.e. string.length.
+     * Must be a positive integer if specified.
+     * @default 2000
+     */
+    headersLengthHint?: number | undefined;
+    importMap?: ReactImportMap | undefined;
     progressiveChunkSize?: number;
+    onHeaders?: ((headers: Headers) => void) | undefined;
     onShellReady?: () => void;
     onShellError?: (error: unknown) => void;
     onAllReady?: () => void;
     onError?: (error: unknown, errorInfo: ErrorInfo) => string | void;
+    formState?: ReactFormState | null;
 }
 
 export interface PipeableStream {
@@ -56,7 +94,7 @@ export interface ServerOptions {
 /**
  * Only available in the environments with [Node.js Streams](https://nodejs.dev/learn/nodejs-streams).
  *
- * @see [API](https://reactjs.org/docs/react-dom-server.html#rendertopipeablestream)
+ * @see [API](https://react.dev/reference/react-dom/server/renderToPipeableStream)
  *
  * @param children
  * @param options
@@ -85,14 +123,23 @@ export function renderToStaticMarkup(element: ReactNode, options?: ServerOptions
 
 export interface RenderToReadableStreamOptions {
     identifierPrefix?: string;
+    importMap?: ReactImportMap | undefined;
     namespaceURI?: string;
     nonce?: string;
     bootstrapScriptContent?: string;
     bootstrapScripts?: Array<string | BootstrapScriptDescriptor>;
     bootstrapModules?: Array<string | BootstrapScriptDescriptor>;
+    /**
+     * Maximum length of the header content in unicode code units i.e. string.length.
+     * Must be a positive integer if specified.
+     * @default 2000
+     */
+    headersLengthHint?: number | undefined;
     progressiveChunkSize?: number;
     signal?: AbortSignal;
     onError?: (error: unknown, errorInfo: ErrorInfo) => string | void;
+    onHeaders?: ((headers: Headers) => void) | undefined;
+    formState?: ReactFormState | null;
 }
 
 export interface ReactDOMServerReadableStream extends ReadableStream {
@@ -102,13 +149,35 @@ export interface ReactDOMServerReadableStream extends ReadableStream {
 /**
  * Only available in the environments with [Web Streams](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) (this includes browsers, Deno, and some modern edge runtimes).
  *
- * @see [API](https://reactjs.org/docs/react-dom-server.html#rendertoreadablestream)
+ * @see [API](https://react.dev/reference/react-dom/server/renderToReadableStream)
  */
 export function renderToReadableStream(
     children: ReactNode,
     options?: RenderToReadableStreamOptions,
 ): Promise<ReactDOMServerReadableStream>;
 
+export { ResumeOptions };
+
+/**
+ * @see {@link https://react.dev/reference/react-dom/server/resume `resume`` reference documentation}
+ * @version 19.2
+ */
+export function resume(
+    children: React.ReactNode,
+    postponedState: PostponedState,
+    options?: ResumeOptions,
+): Promise<ReactDOMServerReadableStream>;
+
+/**
+ * @see {@link https://react.dev/reference/react-dom/server/resumeToPipeableStream `resumeToPipeableStream`` reference documentation}
+ * @version 19.2
+ */
+export function resumeToPipeableStream(
+    children: React.ReactNode,
+    postponedState: PostponedState,
+    options?: ResumeOptions,
+): Promise<PipeableStream>;
+
 export const version: string;
 
 export as namespace ReactDOMServer;

react-dom/server.edge.d.ts

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

react-dom/server.node.d.ts

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

react-dom/static.browser.d.ts

@@ -0,0 +1 @@
+export { prerender, version } from "./static";

react-dom/static.d.ts

@@ -26,25 +26,73 @@ declare global {
 
 import { ReactNode } from "react";
 import { ErrorInfo } from "./client";
+export {};
 
-export type BootstrapScriptDescriptor = {
+declare const POSTPONED_STATE_SIGIL: unique symbol;
+
+/**
+ * This is an opaque type i.e. users should not make any assumptions about its structure.
+ * It is JSON-serializeable to be a able to store it and retrvieve later for use with {@link https://react.dev/reference/react-dom/server/resume `resume`}.
+ */
+export interface PostponedState {
+    [POSTPONED_STATE_SIGIL]: never;
+}
+
+/**
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap Import maps}
+ */
+// TODO: Ideally TypeScripts standard library would include this type.
+// Until then we keep the prefixed one for future compatibility.
+export interface ReactImportMap {
+    /**
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap#imports `imports` reference}
+     */
+    imports?: {
+        [specifier: string]: string;
+    } | undefined;
+    /**
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap#integrity `integrity` reference}
+     */
+    integrity?: {
+        [moduleURL: string]: string;
+    } | undefined;
+    /**
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap#scopes `scopes` reference}
+     */
+    scopes?: {
+        [scope: string]: {
+            [specifier: string]: string;
+        };
+    } | undefined;
+}
+
+export interface BootstrapScriptDescriptor {
     src: string;
     integrity?: string | undefined;
     crossOrigin?: string | undefined;
-};
+}
 
 export interface PrerenderOptions {
     bootstrapScriptContent?: string;
     bootstrapScripts?: Array<string | BootstrapScriptDescriptor>;
     bootstrapModules?: Array<string | BootstrapScriptDescriptor>;
+    /**
+     * Maximum length of the header content in unicode code units i.e. string.length.
+     * Must be a positive integer if specified.
+     * @default 2000
+     */
+    headersLengthHint?: number | undefined;
     identifierPrefix?: string;
+    importMap?: ReactImportMap | undefined;
     namespaceURI?: string;
     onError?: (error: unknown, errorInfo: ErrorInfo) => string | void;
+    onHeaders?: (headers: Headers) => void | undefined;
     progressiveChunkSize?: number;
     signal?: AbortSignal;
 }
 
 export interface PrerenderResult {
+    postponed: null | PostponedState;
     prelude: ReadableStream<Uint8Array>;
 }
 
@@ -60,6 +108,7 @@ export function prerender(
 
 export interface PrerenderToNodeStreamResult {
     prelude: NodeJS.ReadableStream;
+    postponed: null | PostponedState;
 }
 
 /**
@@ -75,4 +124,30 @@ export function prerenderToNodeStream(
     options?: PrerenderOptions,
 ): Promise<PrerenderToNodeStreamResult>;
 
+export interface ResumeOptions {
+    nonce?: string;
+    signal?: AbortSignal;
+    onError?: (error: unknown) => string | undefined | void;
+}
+
+/**
+ * @see {@link https://react.dev/reference/react-dom/static/resumeAndPrerender `resumeAndPrerender` reference documentation}
+ * @version 19.2
+ */
+export function resumeAndPrerender(
+    children: React.ReactNode,
+    postponedState: null | PostponedState,
+    options?: Omit<ResumeOptions, "nonce">,
+): Promise<PrerenderResult>;
+
+/**
+ * @see {@link https://react.dev/reference/react-dom/static/resumeAndPrerenderToNodeStream `resumeAndPrerenderToNodeStream`` reference documentation}
+ * @version 19.2
+ */
+export function resumeAndPrerenderToNodeStream(
+    children: React.ReactNode,
+    postponedState: null | PostponedState,
+    options?: Omit<ResumeOptions, "nonce">,
+): Promise<PrerenderToNodeStreamResult>;
+
 export const version: string;

react-dom/static.edge.d.ts

@@ -0,0 +1 @@
+export { prerender, resumeAndPrerender, version } from "./static";

react-dom/static.node.d.ts

@@ -0,0 +1,7 @@
+export {
+    prerender,
+    prerenderToNodeStream,
+    resumeAndPrerender,
+    resumeAndPrerenderToNodeStream,
+    version,
+} from "./static";