@types/react-dom 19.2.4 → 19.2.6

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: Thu, 30 Jul 2026 21:50:54 GMT
+ * Last updated: Thu, 03 Sep 2026 09:37:09 GMT
  * Dependencies: none
  * Peer dependencies: [@types/react](https://npmjs.com/package/@types/react)
 

react-dom/canary.d.ts

@@ -40,7 +40,14 @@ export interface BrowserUsable {
 }
 
 declare module "." {
-    function browser(): BrowserUsable;
+    /**
+     * Creates an opaque Usable that opts a subtree into browser-only rendering.
+     * `reason` is diagnostic metadata: an SSR renderer uses it as the `cause` of
+     * the recoverable error it reports when deferring the subtree to the browser.
+     * A function is called lazily by that renderer; in the browser the reason is
+     * never observed.
+     */
+    function browser(reason?: string | (() => unknown)): BrowserUsable;
 }
 
 declare module "react" {

react-dom/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react-dom",
-    "version": "19.2.4",
+    "version": "19.2.6",
     "description": "TypeScript definitions for react-dom",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react-dom",
     "license": "MIT",
@@ -123,6 +123,6 @@
     "peerDependencies": {
         "@types/react": "^19.2.0"
     },
-    "typesPublisherContentHash": "bc57236d5897342b3461d50419a2115be1390c6f9bba71ee3d8acde858a4e48e",
+    "typesPublisherContentHash": "155fba39b5e2df2cbeb1a49946eade19d0fc20831bea88465f902a543badc8dd",
     "typeScriptVersion": "5.6"
 }

react-dom/server.browser.d.ts

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

react-dom/server.bun.d.ts

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

react-dom/server.d.ts

@@ -31,6 +31,25 @@ export interface BootstrapScriptDescriptor {
     crossOrigin?: string | undefined;
 }
 
+/**
+ * The header content passed to `onHeaders` by `renderToPipeableStream`.
+ * Other server rendering APIs pass a `Headers` instance instead.
+ * React passes an empty object when there are no resource hints to send.
+ */
+export interface HeadersDescriptor {
+    Link?: string;
+}
+
+/**
+ * A nonce string, or an object with separate nonces for scripts and styles.
+ */
+export type NonceOption =
+    | string
+    | {
+        script?: string | undefined;
+        style?: string | undefined;
+    };
+
 /**
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script/type/importmap Import maps}
  */
@@ -62,7 +81,7 @@ export interface ReactImportMap {
 export interface RenderToPipeableStreamOptions {
     identifierPrefix?: string;
     namespaceURI?: string;
-    nonce?: string;
+    nonce?: NonceOption | undefined;
     bootstrapScriptContent?: string;
     bootstrapScripts?: Array<string | BootstrapScriptDescriptor>;
     bootstrapModules?: Array<string | BootstrapScriptDescriptor>;
@@ -71,10 +90,10 @@ export interface RenderToPipeableStreamOptions {
      * Must be a positive integer if specified.
      * @default 2000
      */
-    headersLengthHint?: number | undefined;
+    maxHeadersLength?: number | undefined;
     importMap?: ReactImportMap | undefined;
     progressiveChunkSize?: number;
-    onHeaders?: ((headers: Headers) => void) | undefined;
+    onHeaders?: ((headers: HeadersDescriptor) => void) | undefined;
     onShellReady?: () => void;
     onShellError?: (error: unknown) => void;
     onAllReady?: () => void;
@@ -125,7 +144,7 @@ export interface RenderToReadableStreamOptions {
     identifierPrefix?: string;
     importMap?: ReactImportMap | undefined;
     namespaceURI?: string;
-    nonce?: string;
+    nonce?: NonceOption | undefined;
     bootstrapScriptContent?: string;
     bootstrapScripts?: Array<string | BootstrapScriptDescriptor>;
     bootstrapModules?: Array<string | BootstrapScriptDescriptor>;
@@ -134,7 +153,7 @@ export interface RenderToReadableStreamOptions {
      * Must be a positive integer if specified.
      * @default 2000
      */
-    headersLengthHint?: number | undefined;
+    maxHeadersLength?: number | undefined;
     progressiveChunkSize?: number;
     signal?: AbortSignal;
     onError?: (error: unknown, errorInfo: ErrorInfo) => string | void;
@@ -158,6 +177,14 @@ export function renderToReadableStream(
 
 export { ResumeOptions };
 
+export interface ResumeToPipeableStreamOptions {
+    nonce?: NonceOption | undefined;
+    onShellReady?: (() => void) | undefined;
+    onShellError?: ((error: unknown) => void) | undefined;
+    onAllReady?: (() => void) | undefined;
+    onError?: ((error: unknown, errorInfo: ErrorInfo) => string | void) | undefined;
+}
+
 /**
  * @see {@link https://react.dev/reference/react-dom/server/resume `resume`` reference documentation}
  * @version 19.2
@@ -175,7 +202,7 @@ export function resume(
 export function resumeToPipeableStream(
     children: React.ReactNode,
     postponedState: PostponedState,
-    options?: ResumeOptions,
+    options?: ResumeToPipeableStreamOptions,
 ): Promise<PipeableStream>;
 
 export const version: string;

react-dom/server.edge.d.ts

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

react-dom/server.node.d.ts

@@ -5,4 +5,5 @@ export {
     renderToString,
     resume,
     resumeToPipeableStream,
+    version,
 } from "./server";

react-dom/static.browser.d.ts

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

react-dom/static.d.ts

@@ -72,6 +72,16 @@ export interface BootstrapScriptDescriptor {
     crossOrigin?: string | undefined;
 }
 
+/**
+ * A nonce string, or an object with separate nonces for scripts and styles.
+ */
+export type NonceOption =
+    | string
+    | {
+        script?: string | undefined;
+        style?: string | undefined;
+    };
+
 export interface PrerenderOptions {
     bootstrapScriptContent?: string;
     bootstrapScripts?: Array<string | BootstrapScriptDescriptor>;
@@ -81,12 +91,12 @@ export interface PrerenderOptions {
      * Must be a positive integer if specified.
      * @default 2000
      */
-    headersLengthHint?: number | undefined;
+    maxHeadersLength?: number | undefined;
     identifierPrefix?: string;
     importMap?: ReactImportMap | undefined;
     namespaceURI?: string;
     onError?: (error: unknown, errorInfo: ErrorInfo) => string | void;
-    onHeaders?: (headers: Headers) => void | undefined;
+    onHeaders?: ((headers: Headers) => void) | undefined;
     progressiveChunkSize?: number;
     signal?: AbortSignal;
 }
@@ -125,7 +135,7 @@ export function prerenderToNodeStream(
 ): Promise<PrerenderToNodeStreamResult>;
 
 export interface ResumeOptions {
-    nonce?: string;
+    nonce?: NonceOption | undefined;
     signal?: AbortSignal;
     onError?: (error: unknown) => string | undefined | void;
 }