@types/react-dom 19.1.10 → 19.2.0

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, 01 Oct 2025 17:02:25 GMT
+ * Last updated: Wed, 01 Oct 2025 22:02:19 GMT
  * Dependencies: none
  * Peer dependencies: [@types/react](https://npmjs.com/package/@types/react)
 

react-dom/canary.d.ts

@@ -32,73 +32,3 @@ import React = require("react");
 import ReactDOM = require(".");
 
 export {};
-
-declare module "react" {
-    // eslint-disable-next-line @typescript-eslint/no-empty-interface
-    interface CacheSignal extends AbortSignal {}
-}
-
-declare const POSTPONED_STATE_SIGIL: unique symbol;
-declare module "react-dom/static" {
-    /**
-     * 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`}.
-     */
-    interface PostponedState {
-        [POSTPONED_STATE_SIGIL]: never;
-    }
-
-    interface ResumeOptions {
-        nonce?: string;
-        signal?: AbortSignal;
-        onError?: (error: unknown) => string | undefined | void;
-    }
-
-    interface PrerenderResult {
-        postponed: null | PostponedState;
-    }
-    /**
-     * @see {@link https://react.dev/reference/react-dom/static/resumeAndPrerender `resumeAndPrerender` reference documentation}
-     * @version 19.2
-     */
-    function resumeAndPrerender(
-        children: React.ReactNode,
-        postponedState: PostponedState,
-        options?: Omit<ResumeOptions, "nonce">,
-    ): Promise<PrerenderResult>;
-
-    interface PrerenderToNodeStreamResult {
-        postponed: null | PostponedState;
-    }
-    /**
-     * @see {@link https://react.dev/reference/react-dom/static/resumeAndPrerenderToNodeStream `resumeAndPrerenderToNodeStream`` reference documentation}
-     * @version 19.2
-     */
-    function resumeAndPrerenderToNodeStream(
-        children: React.ReactNode,
-        postponedState: PostponedState,
-        options?: Omit<ResumeOptions, "nonce">,
-    ): Promise<PrerenderToNodeStreamResult>;
-}
-
-import { PostponedState, ResumeOptions } from "react-dom/static";
-declare module "react-dom/server" {
-    /**
-     * @see {@link https://react.dev/reference/react-dom/server/resume `resume`` reference documentation}
-     * @version 19.2
-     */
-    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
-     */
-    function resumeToPipeableStream(
-        children: React.ReactNode,
-        postponedState: PostponedState,
-        options?: ResumeOptions,
-    ): Promise<PipeableStream>;
-}

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,

react-dom/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react-dom",
-    "version": "19.1.10",
+    "version": "19.2.0",
     "description": "TypeScript definitions for react-dom",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom",
     "license": "MIT",
@@ -121,8 +121,8 @@
     "scripts": {},
     "dependencies": {},
     "peerDependencies": {
-        "@types/react": "^19.0.0"
+        "@types/react": "^19.2.0"
     },
-    "typesPublisherContentHash": "5dee0b9e44666864c50b2581f281f3fbf396f9059b30dca24ba1fdc1d19ca2e0",
+    "typesPublisherContentHash": "4a296bd89e24edb236357aa2daf5e5f23648fa3270267dfef1e71cafb2822417",
     "typeScriptVersion": "5.2"
 }

react-dom/server.d.ts

@@ -23,12 +23,41 @@ declare global {
 
 import { ReactNode } from "react";
 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,7 +66,15 @@ 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;
@@ -86,14 +123,22 @@ 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;
 }
 
@@ -111,6 +156,28 @@ export function renderToReadableStream(
     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

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

react-dom/server.node.d.ts

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

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

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

react-dom/static.node.d.ts

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