@types/react 19.2.17 → 19.3.0

react/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for react (https://react.dev/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react.
 
 ### Additional Details
- * Last updated: Fri, 05 Jun 2026 20:10:10 GMT
+ * Last updated: Wed, 09 Sep 2026 18:05:03 GMT
  * Dependencies: [csstype](https://npmjs.com/package/csstype)
 
 # Credits

react/canary.d.ts

@@ -30,100 +30,6 @@ export {};
 declare const UNDEFINED_VOID_ONLY: unique symbol;
 type VoidOrUndefinedOnly = void | { [UNDEFINED_VOID_ONLY]: never };
 
-type NativeSubmitEvent = SubmitEvent;
-
 declare module "." {
     export function unstable_useCacheRefresh(): () => void;
-
-    // @enableViewTransition
-    export interface ViewTransitionInstance {
-        /**
-         * The {@link ViewTransitionProps name} that was used in the corresponding {@link ViewTransition} component or `"auto"` if the `name` prop was omitted.
-         */
-        name: string;
-    }
-
-    export type ViewTransitionClassPerType = Record<"default" | (string & {}), "none" | "auto" | (string & {})>;
-    export type ViewTransitionClass = ViewTransitionClassPerType | ViewTransitionClassPerType[string];
-
-    export interface ViewTransitionProps {
-        children?: ReactNode | undefined;
-        /**
-         * Assigns the {@link https://developer.chrome.com/blog/view-transitions-update-io24#view-transition-class `view-transition-class`} class to the underlying DOM node.
-         */
-        default?: ViewTransitionClass | undefined;
-        /**
-         * Combined with {@link className} if this `<ViewTransition>` or its parent Component is mounted and there's no other with the same name being deleted.
-         * `"none"` is a special value that deactivates the view transition name under that condition.
-         */
-        enter?: ViewTransitionClass | undefined;
-        /**
-         * Combined with {@link className} if this `<ViewTransition>` or its parent Component is unmounted and there's no other with the same name being deleted.
-         * `"none"` is a special value that deactivates the view transition name under that condition.
-         */
-        exit?: ViewTransitionClass | undefined;
-        /**
-         * "auto" will automatically assign a view-transition-name to the inner DOM node.
-         * That way you can add a View Transition to a Component without controlling its DOM nodes styling otherwise.
-         *
-         * A difference between this and the browser's built-in view-transition-name: auto is that switching the DOM nodes within the `<ViewTransition>` component preserves the same name so this example cross-fades between the DOM nodes instead of causing an exit and enter.
-         * @default "auto"
-         */
-        name?: "auto" | (string & {}) | undefined;
-        /**
-         * The `<ViewTransition>` or its parent Component is mounted and there's no other `<ViewTransition>` with the same name being deleted.
-         */
-        onEnter?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
-        /**
-         * The `<ViewTransition>` or its parent Component is unmounted and there's no other `<ViewTransition>` with the same name being deleted.
-         */
-        onExit?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
-        /**
-         * This `<ViewTransition>` is being mounted and another `<ViewTransition>` instance with the same name is being unmounted elsewhere.
-         */
-        onShare?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
-        /**
-         * The content of `<ViewTransition>` has changed either due to DOM mutations or because an inner child `<ViewTransition>` has resized.
-         */
-        onUpdate?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
-        ref?: Ref<ViewTransitionInstance> | undefined;
-        /**
-         * Combined with {@link className} if this `<ViewTransition>` is being mounted and another instance with the same name is being unmounted elsewhere.
-         * `"none"` is a special value that deactivates the view transition name under that condition.
-         */
-        share?: ViewTransitionClass | undefined;
-        /**
-         * Combined with {@link className} if the content of this `<ViewTransition>` has changed either due to DOM mutations or because an inner child has resized.
-         * `"none"` is a special value that deactivates the view transition name under that condition.
-         */
-        update?: ViewTransitionClass | undefined;
-    }
-
-    /**
-     * Opt-in for using {@link https://developer.mozilla.org/en-US/docs/Web/API/View_Transition_API View Transitions} in React.
-     * View Transitions only trigger for async updates like {@link startTransition}, {@link useDeferredValue}, Actions or <{@link Suspense}> revealing from fallback to content.
-     * Synchronous updates provide an opt-out but also guarantee that they commit immediately which View Transitions can't.
-     *
-     * @see {@link https://react.dev/reference/react/ViewTransition `<ViewTransition>` reference documentation}
-     */
-    export const ViewTransition: ExoticComponent<ViewTransitionProps>;
-
-    /**
-     * @see {@link https://react.dev/reference/react/addTransitionType `addTransitionType` reference documentation}
-     */
-    export function addTransitionType(type: string): void;
-
-    // @enableFragmentRefs
-    export interface FragmentInstance {}
-
-    export interface FragmentProps {
-        ref?: Ref<FragmentInstance> | undefined;
-    }
-
-    interface SubmitEvent<T = Element> extends SyntheticEvent<T, NativeSubmitEvent> {
-        /**
-         * Only available in react@canary
-         */
-        submitter: HTMLElement | null;
-    }
 }

react/index.d.ts

@@ -732,8 +732,15 @@ declare namespace React {
         toArray(children: ReactNode | ReactNode[]): Array<Exclude<ReactNode, boolean | null | undefined>>;
     };
 
+    /**
+     * The value of a ref on a `<Fragment>`.
+     * Empty by default; renderers (e.g. `react-dom`) augment this interface via `declare module "react"`.
+     */
+    export interface FragmentInstance {}
+
     export interface FragmentProps {
         children?: React.ReactNode;
+        ref?: Ref<FragmentInstance> | undefined;
     }
     /**
      * Lets you group elements without a wrapper node.
@@ -1959,7 +1966,16 @@ declare namespace React {
         | FulfilledReactPromise<T>
         | RejectedReactPromise<T>;
 
-    export type Usable<T> = ReactPromise<T> | Context<T>;
+    /**
+     * A registry of renderer-specific {@link Usable} types.
+     *
+     * Renderers (e.g. `react-dom`) augment this interface via `declare module "react"`,
+     * adding an entry keyed by a renderer-specific string whose type becomes a valid
+     * argument to {@link use}. Only renderers should augment this interface.
+     */
+    export interface RendererUsable<T> {}
+
+    export type Usable<T> = ReactPromise<T> | Context<T> | RendererUsable<T>[keyof RendererUsable<T>];
 
     export function use<T>(usable: Usable<T>): T;
 
@@ -2005,6 +2021,85 @@ declare namespace React {
      */
     export const Activity: ExoticComponent<ActivityProps>;
 
+    export interface ViewTransitionInstance {
+        /**
+         * The {@link ViewTransitionProps name} that was used in the corresponding {@link ViewTransition} component or `"auto"` if the `name` prop was omitted.
+         */
+        name: string;
+    }
+
+    export type ViewTransitionClassPerType = Record<"default" | (string & {}), "none" | "auto" | (string & {})>;
+    export type ViewTransitionClass = ViewTransitionClassPerType | ViewTransitionClassPerType[string];
+
+    export interface ViewTransitionProps {
+        children?: ReactNode | undefined;
+        /**
+         * Assigns the {@link https://developer.chrome.com/blog/view-transitions-update-io24#view-transition-class `view-transition-class`} class to the underlying DOM node.
+         */
+        default?: ViewTransitionClass | undefined;
+        /**
+         * Combined with {@link className} if this `<ViewTransition>` or its parent Component is mounted and there's no other with the same name being deleted.
+         * `"none"` is a special value that deactivates the view transition name under that condition.
+         */
+        enter?: ViewTransitionClass | undefined;
+        /**
+         * Combined with {@link className} if this `<ViewTransition>` or its parent Component is unmounted and there's no other with the same name being deleted.
+         * `"none"` is a special value that deactivates the view transition name under that condition.
+         */
+        exit?: ViewTransitionClass | undefined;
+        /**
+         * "auto" will automatically assign a view-transition-name to the inner DOM node.
+         * That way you can add a View Transition to a Component without controlling its DOM nodes styling otherwise.
+         *
+         * A difference between this and the browser's built-in view-transition-name: auto is that switching the DOM nodes within the `<ViewTransition>` component preserves the same name so this example cross-fades between the DOM nodes instead of causing an exit and enter.
+         * @default "auto"
+         */
+        name?: "auto" | (string & {}) | undefined;
+        /**
+         * The `<ViewTransition>` or its parent Component is mounted and there's no other `<ViewTransition>` with the same name being deleted.
+         */
+        onEnter?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
+        /**
+         * The `<ViewTransition>` or its parent Component is unmounted and there's no other with the same name being deleted.
+         */
+        onExit?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
+        /**
+         * This `<ViewTransition>` is being mounted and another `<ViewTransition>` instance with the same name is being unmounted elsewhere.
+         */
+        onShare?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
+        /**
+         * The content of `<ViewTransition>` has changed either due to DOM mutations or because an inner child `<ViewTransition>` has resized.
+         */
+        onUpdate?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
+        ref?: Ref<ViewTransitionInstance> | undefined;
+        /**
+         * Combined with {@link className} if this `<ViewTransition>` is being mounted and another instance with the same name is being unmounted elsewhere.
+         * `"none"` is a special value that deactivates the view transition name under that condition.
+         */
+        share?: ViewTransitionClass | undefined;
+        /**
+         * Combined with {@link className} if the content of this `<ViewTransition>` has changed either due to DOM mutations or because an inner child has resized.
+         * `"none"` is a special value that deactivates the view transition name under that condition.
+         */
+        update?: ViewTransitionClass | undefined;
+    }
+
+    /**
+     * Opt-in for using {@link https://developer.mozilla.org/en-US/docs/Web/API/View_Transition_API View Transitions} in React.
+     * View Transitions only trigger for async updates like {@link startTransition}, {@link useDeferredValue}, Actions or <{@link Suspense}> revealing from fallback to content.
+     * Synchronous updates provide an opt-out but also guarantee that they commit immediately which View Transitions can't.
+     *
+     * @see {@link https://react.dev/reference/react/ViewTransition `<ViewTransition>` reference documentation}
+     * @version 19.3.0
+     */
+    export const ViewTransition: ExoticComponent<ViewTransitionProps>;
+
+    /**
+     * @see {@link https://react.dev/reference/react/addTransitionType `addTransitionType` reference documentation}
+     * @version 19.3.0
+     */
+    export function addTransitionType(type: string): void;
+
     /**
      * Warning: Only available in development builds.
      *
@@ -2166,8 +2261,7 @@ declare namespace React {
     }
 
     interface SubmitEvent<T = Element> extends SyntheticEvent<T, NativeSubmitEvent> {
-        // `submitter` is available in react@canary
-        // submitter: HTMLElement | null;
+        submitter: HTMLElement | null;
         // SubmitEvents are always targetted at HTMLFormElements.
         target: EventTarget & HTMLFormElement;
     }

react/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react",
-    "version": "19.2.17",
+    "version": "19.3.0",
     "description": "TypeScript definitions for react",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react",
     "license": "MIT",
@@ -205,6 +205,6 @@
         "csstype": "^3.2.2"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "f6d087e89b6a483b6ea2519d4f16498227ceb3260f6a6414fed750badc869721",
-    "typeScriptVersion": "5.3"
+    "typesPublisherContentHash": "86ea5f223efc88fcaa71962f0f031a623142285e331499ee981e201dc8d2a77e",
+    "typeScriptVersion": "5.6"
 }

react/ts5.0/canary.d.ts

@@ -30,100 +30,6 @@ export {};
 declare const UNDEFINED_VOID_ONLY: unique symbol;
 type VoidOrUndefinedOnly = void | { [UNDEFINED_VOID_ONLY]: never };
 
-type NativeSubmitEvent = SubmitEvent;
-
 declare module "." {
     export function unstable_useCacheRefresh(): () => void;
-
-    // @enableViewTransition
-    export interface ViewTransitionInstance {
-        /**
-         * The {@link ViewTransitionProps name} that was used in the corresponding {@link ViewTransition} component or `"auto"` if the `name` prop was omitted.
-         */
-        name: string;
-    }
-
-    export type ViewTransitionClassPerType = Record<"default" | (string & {}), "none" | "auto" | (string & {})>;
-    export type ViewTransitionClass = ViewTransitionClassPerType | ViewTransitionClassPerType[string];
-
-    export interface ViewTransitionProps {
-        children?: ReactNode | undefined;
-        /**
-         * Assigns the {@link https://developer.chrome.com/blog/view-transitions-update-io24#view-transition-class `view-transition-class`} class to the underlying DOM node.
-         */
-        default?: ViewTransitionClass | undefined;
-        /**
-         * Combined with {@link className} if this `<ViewTransition>` or its parent Component is mounted and there's no other with the same name being deleted.
-         * `"none"` is a special value that deactivates the view transition name under that condition.
-         */
-        enter?: ViewTransitionClass | undefined;
-        /**
-         * Combined with {@link className} if this `<ViewTransition>` or its parent Component is unmounted and there's no other with the same name being deleted.
-         * `"none"` is a special value that deactivates the view transition name under that condition.
-         */
-        exit?: ViewTransitionClass | undefined;
-        /**
-         * "auto" will automatically assign a view-transition-name to the inner DOM node.
-         * That way you can add a View Transition to a Component without controlling its DOM nodes styling otherwise.
-         *
-         * A difference between this and the browser's built-in view-transition-name: auto is that switching the DOM nodes within the `<ViewTransition>` component preserves the same name so this example cross-fades between the DOM nodes instead of causing an exit and enter.
-         * @default "auto"
-         */
-        name?: "auto" | (string & {}) | undefined;
-        /**
-         * The `<ViewTransition>` or its parent Component is mounted and there's no other `<ViewTransition>` with the same name being deleted.
-         */
-        onEnter?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
-        /**
-         * The `<ViewTransition>` or its parent Component is unmounted and there's no other `<ViewTransition>` with the same name being deleted.
-         */
-        onExit?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
-        /**
-         * This `<ViewTransition>` is being mounted and another `<ViewTransition>` instance with the same name is being unmounted elsewhere.
-         */
-        onShare?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
-        /**
-         * The content of `<ViewTransition>` has changed either due to DOM mutations or because an inner child `<ViewTransition>` has resized.
-         */
-        onUpdate?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
-        ref?: Ref<ViewTransitionInstance> | undefined;
-        /**
-         * Combined with {@link className} if this `<ViewTransition>` is being mounted and another instance with the same name is being unmounted elsewhere.
-         * `"none"` is a special value that deactivates the view transition name under that condition.
-         */
-        share?: ViewTransitionClass | undefined;
-        /**
-         * Combined with {@link className} if the content of this `<ViewTransition>` has changed either due to DOM mutations or because an inner child has resized.
-         * `"none"` is a special value that deactivates the view transition name under that condition.
-         */
-        update?: ViewTransitionClass | undefined;
-    }
-
-    /**
-     * Opt-in for using {@link https://developer.mozilla.org/en-US/docs/Web/API/View_Transition_API View Transitions} in React.
-     * View Transitions only trigger for async updates like {@link startTransition}, {@link useDeferredValue}, Actions or <{@link Suspense}> revealing from fallback to content.
-     * Synchronous updates provide an opt-out but also guarantee that they commit immediately which View Transitions can't.
-     *
-     * @see {@link https://react.dev/reference/react/ViewTransition `<ViewTransition>` reference documentation}
-     */
-    export const ViewTransition: ExoticComponent<ViewTransitionProps>;
-
-    /**
-     * @see {@link https://react.dev/reference/react/addTransitionType `addTransitionType` reference documentation}
-     */
-    export function addTransitionType(type: string): void;
-
-    // @enableFragmentRefs
-    export interface FragmentInstance {}
-
-    export interface FragmentProps {
-        ref?: Ref<FragmentInstance> | undefined;
-    }
-
-    interface SubmitEvent<T = Element> extends SyntheticEvent<T, NativeSubmitEvent> {
-        /**
-         * Only available in react@canary
-         */
-        submitter: HTMLElement | null;
-    }
 }

react/ts5.0/index.d.ts

@@ -733,8 +733,15 @@ declare namespace React {
         toArray(children: ReactNode | ReactNode[]): Array<Exclude<ReactNode, boolean | null | undefined>>;
     };
 
+    /**
+     * The value of a ref on a `<Fragment>`.
+     * Empty by default; renderers (e.g. `react-dom`) augment this interface via `declare module "react"`.
+     */
+    export interface FragmentInstance {}
+
     export interface FragmentProps {
         children?: React.ReactNode;
+        ref?: Ref<FragmentInstance> | undefined;
     }
     /**
      * Lets you group elements without a wrapper node.
@@ -1958,7 +1965,16 @@ declare namespace React {
         | FulfilledReactPromise<T>
         | RejectedReactPromise<T>;
 
-    export type Usable<T> = ReactPromise<T> | Context<T>;
+    /**
+     * A registry of renderer-specific {@link Usable} types.
+     *
+     * Renderers (e.g. `react-dom`) augment this interface via `declare module "react"`,
+     * adding an entry keyed by a renderer-specific string whose type becomes a valid
+     * argument to {@link use}. Only renderers should augment this interface.
+     */
+    export interface RendererUsable<T> {}
+
+    export type Usable<T> = ReactPromise<T> | Context<T> | RendererUsable<T>[keyof RendererUsable<T>];
 
     export function use<T>(usable: Usable<T>): T;
 
@@ -2004,6 +2020,85 @@ declare namespace React {
      */
     export const Activity: ExoticComponent<ActivityProps>;
 
+    export interface ViewTransitionInstance {
+        /**
+         * The {@link ViewTransitionProps name} that was used in the corresponding {@link ViewTransition} component or `"auto"` if the `name` prop was omitted.
+         */
+        name: string;
+    }
+
+    export type ViewTransitionClassPerType = Record<"default" | (string & {}), "none" | "auto" | (string & {})>;
+    export type ViewTransitionClass = ViewTransitionClassPerType | ViewTransitionClassPerType[string];
+
+    export interface ViewTransitionProps {
+        children?: ReactNode | undefined;
+        /**
+         * Assigns the {@link https://developer.chrome.com/blog/view-transitions-update-io24#view-transition-class `view-transition-class`} class to the underlying DOM node.
+         */
+        default?: ViewTransitionClass | undefined;
+        /**
+         * Combined with {@link className} if this `<ViewTransition>` or its parent Component is mounted and there's no other with the same name being deleted.
+         * `"none"` is a special value that deactivates the view transition name under that condition.
+         */
+        enter?: ViewTransitionClass | undefined;
+        /**
+         * Combined with {@link className} if this `<ViewTransition>` or its parent Component is unmounted and there's no other with the same name being deleted.
+         * `"none"` is a special value that deactivates the view transition name under that condition.
+         */
+        exit?: ViewTransitionClass | undefined;
+        /**
+         * "auto" will automatically assign a view-transition-name to the inner DOM node.
+         * That way you can add a View Transition to a Component without controlling its DOM nodes styling otherwise.
+         *
+         * A difference between this and the browser's built-in view-transition-name: auto is that switching the DOM nodes within the `<ViewTransition>` component preserves the same name so this example cross-fades between the DOM nodes instead of causing an exit and enter.
+         * @default "auto"
+         */
+        name?: "auto" | (string & {}) | undefined;
+        /**
+         * The `<ViewTransition>` or its parent Component is mounted and there's no other `<ViewTransition>` with the same name being deleted.
+         */
+        onEnter?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
+        /**
+         * The `<ViewTransition>` or its parent Component is unmounted and there's no other with the same name being deleted.
+         */
+        onExit?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
+        /**
+         * This `<ViewTransition>` is being mounted and another `<ViewTransition>` instance with the same name is being unmounted elsewhere.
+         */
+        onShare?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
+        /**
+         * The content of `<ViewTransition>` has changed either due to DOM mutations or because an inner child `<ViewTransition>` has resized.
+         */
+        onUpdate?: (instance: ViewTransitionInstance, types: Array<string>) => void | (() => void);
+        ref?: Ref<ViewTransitionInstance> | undefined;
+        /**
+         * Combined with {@link className} if this `<ViewTransition>` is being mounted and another instance with the same name is being unmounted elsewhere.
+         * `"none"` is a special value that deactivates the view transition name under that condition.
+         */
+        share?: ViewTransitionClass | undefined;
+        /**
+         * Combined with {@link className} if the content of this `<ViewTransition>` has changed either due to DOM mutations or because an inner child has resized.
+         * `"none"` is a special value that deactivates the view transition name under that condition.
+         */
+        update?: ViewTransitionClass | undefined;
+    }
+
+    /**
+     * Opt-in for using {@link https://developer.mozilla.org/en-US/docs/Web/API/View_Transition_API View Transitions} in React.
+     * View Transitions only trigger for async updates like {@link startTransition}, {@link useDeferredValue}, Actions or <{@link Suspense}> revealing from fallback to content.
+     * Synchronous updates provide an opt-out but also guarantee that they commit immediately which View Transitions can't.
+     *
+     * @see {@link https://react.dev/reference/react/ViewTransition `<ViewTransition>` reference documentation}
+     * @version 19.3.0
+     */
+    export const ViewTransition: ExoticComponent<ViewTransitionProps>;
+
+    /**
+     * @see {@link https://react.dev/reference/react/addTransitionType `addTransitionType` reference documentation}
+     * @version 19.3.0
+     */
+    export function addTransitionType(type: string): void;
+
     /**
      * Warning: Only available in development builds.
      *
@@ -2165,8 +2260,7 @@ declare namespace React {
     }
 
     interface SubmitEvent<T = Element> extends SyntheticEvent<T, NativeSubmitEvent> {
-        // `submitter` is available in react@canary
-        // submitter: HTMLElement | null;
+        submitter: HTMLElement | null;
         // SubmitEvents are always targetted at HTMLFormElements.
         target: EventTarget & HTMLFormElement;
     }