@types/react-dom 19.1.9 → 19.1.11

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, 28 Aug 2025 12:02:46 GMT
+ * Last updated: Wed, 01 Oct 2025 17:34:27 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.
  *
@@ -35,3 +37,68 @@ 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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react-dom",
-    "version": "19.1.9",
+    "version": "19.1.11",
     "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.0.0"
     },
-    "typesPublisherContentHash": "7dbb3f6967ec6ea50b0b724a9bb3c8d7c7b80b27e0134b57296d46f7b9291d18",
+    "typesPublisherContentHash": "df97d62b7c8884b591468a10b2188d6a5a1f7767ccab6c0a7248e2cfdbe534e6",
     "typeScriptVersion": "5.2"
 }

react-dom/server.d.ts

@@ -24,11 +24,39 @@ declare global {
 import { ReactNode } from "react";
 import { ErrorInfo, ReactFormState } from "./client";
 
-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 +65,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 +122,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;
 }
 

react-dom/static.d.ts

@@ -27,19 +27,55 @@ declare global {
 import { ReactNode } from "react";
 import { ErrorInfo } from "./client";
 
-export type BootstrapScriptDescriptor = {
+/**
+ * @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?: ImportMap | undefined;
     namespaceURI?: string;
     onError?: (error: unknown, errorInfo: ErrorInfo) => string | void;
+    onHeaders?: (headers: Headers) => void | undefined;
     progressiveChunkSize?: number;
     signal?: AbortSignal;
 }