Scaffolding for requestFormReset API

packages/react-dom-bindings/src/client/ReactFiberConfigDOM.js

@@ -102,6 +102,7 @@ import {listenToAllSupportedEvents} from '../events/DOMPluginEventSystem';
 import {validateLinkPropsForStyleResource} from '../shared/ReactDOMResourceValidation';
 import escapeSelectorAttributeValueInsideDoubleQuotes from './escapeSelectorAttributeValueInsideDoubleQuotes';
 import {flushSyncWork as flushSyncWorkOnAllRoots} from 'react-reconciler/src/ReactFiberWorkLoop';
+import {requestFormReset as requestFormResetOnFiber} from 'react-reconciler/src/ReactFiberHooks';
 
 import ReactDOMSharedInternals from 'shared/ReactDOMSharedInternals';
 
@@ -1928,6 +1929,7 @@ ReactDOMSharedInternals.d /* ReactDOMCurrentDispatcher */ = {
   f /* flushSyncWork */: disableLegacyMode
     ? flushSyncWork
     : previousDispatcher.f /* flushSyncWork */,
+  r: requestFormReset,
   D /* prefetchDNS */: prefetchDNS,
   C /* preconnect */: preconnect,
   L /* preload */: preload,
@@ -1951,6 +1953,23 @@ function flushSyncWork() {
   }
 }
 
+function requestFormReset(form: HTMLFormElement) {
+  const formInst = getInstanceFromNodeDOMTree(form);
+  if (
+    formInst !== null &&
+    formInst.tag === HostComponent &&
+    formInst.type === 'form'
+  ) {
+    requestFormResetOnFiber(formInst);
+  } else {
+    // This form was either not rendered by this React renderer (or it's an
+    // invalid type). Try the next one.
+    //
+    // The last implementation in the sequence will throw an error.
+    previousDispatcher.r(/* requestFormReset */ form);
+  }
+}
+
 // We expect this to get inlined. It is a function mostly to communicate the special nature of
 // how we resolve the HoistableRoot for ReactDOM.pre*() methods. Because we support calling
 // these methods outside of render there is no way to know which Document or ShadowRoot is 'scoped'

packages/react-dom-bindings/src/server/ReactDOMFlightServerHostDispatcher.js

@@ -28,6 +28,7 @@ const previousDispatcher =
   ReactDOMSharedInternals.d; /* ReactDOMCurrentDispatcher */
 ReactDOMSharedInternals.d /* ReactDOMCurrentDispatcher */ = {
   f /* flushSyncWork */: previousDispatcher.f /* flushSyncWork */,
+  r /* requestFormReset */: previousDispatcher.r /* requestFormReset */,
   D /* prefetchDNS */: prefetchDNS,
   C /* preconnect */: preconnect,
   L /* preload */: preload,

packages/react-dom-bindings/src/server/ReactFizzConfigDOM.js

@@ -88,6 +88,7 @@ const previousDispatcher =
   ReactDOMSharedInternals.d; /* ReactDOMCurrentDispatcher */
 ReactDOMSharedInternals.d /* ReactDOMCurrentDispatcher */ = {
   f /* flushSyncWork */: previousDispatcher.f /* flushSyncWork */,
+  r /* requestFormReset */: previousDispatcher.r /* requestFormReset */,
   D /* prefetchDNS */: prefetchDNS,
   C /* preconnect */: preconnect,
   L /* preload */: preload,

packages/react-dom-bindings/src/shared/ReactDOMFormActions.js

@@ -12,6 +12,7 @@ import type {Awaited} from 'shared/ReactTypes';
 
 import {enableAsyncActions} from 'shared/ReactFeatureFlags';
 import ReactSharedInternals from 'shared/ReactSharedInternals';
+import ReactDOMSharedInternals from 'shared/ReactDOMSharedInternals';
 
 type FormStatusNotPending = {|
   pending: false,
@@ -87,3 +88,8 @@ export function useFormState<S, P>(
     return dispatcher.useFormState(action, initialState, permalink);
   }
 }
+
+export function requestFormReset(form: HTMLFormElement) {
+  ReactDOMSharedInternals.d /* ReactDOMCurrentDispatcher */
+    .r(/* requestFormReset */ form);
+}

packages/react-dom/index.classic.fb.js

@@ -25,6 +25,7 @@ export {
   unstable_runWithPriority, // DO NOT USE: Temporarily exposed to migrate off of Scheduler.runWithPriority.
   useFormStatus,
   useFormState,
+  requestFormReset,
   prefetchDNS,
   preconnect,
   preload,

packages/react-dom/index.experimental.js

@@ -17,6 +17,7 @@ export {
   unstable_runWithPriority, // DO NOT USE: Temporarily exposed to migrate off of Scheduler.runWithPriority.
   useFormStatus,
   useFormState,
+  requestFormReset,
   prefetchDNS,
   preconnect,
   preload,

packages/react-dom/index.js

@@ -20,6 +20,7 @@ export {
   unstable_runWithPriority, // DO NOT USE: Temporarily exposed to migrate off of Scheduler.runWithPriority.
   useFormStatus,
   useFormState,
+  requestFormReset,
   prefetchDNS,
   preconnect,
   preload,

packages/react-dom/index.modern.fb.js

@@ -16,6 +16,7 @@ export {
   unstable_runWithPriority, // DO NOT USE: Temporarily exposed to migrate off of Scheduler.runWithPriority.
   useFormStatus,
   useFormState,
+  requestFormReset,
   prefetchDNS,
   preconnect,
   preload,

packages/react-dom/index.stable.js

@@ -16,6 +16,7 @@ export {
   unstable_batchedUpdates,
   useFormStatus,
   useFormState,
+  requestFormReset,
   prefetchDNS,
   preconnect,
   preload,

packages/react-dom/src/ReactDOMSharedInternals.js

@@ -29,8 +29,16 @@ export type ReactDOMInternalsDev = ReactDOMInternals & {
 
 function noop() {}
 
+function requestFormReset(element: HTMLFormElement) {
+  throw new Error(
+    'Invalid form element. requestFormReset must be passed a form that was ' +
+      'rendered by React.',
+  );
+}
+
 const DefaultDispatcher: HostDispatcher = {
   f /* flushSyncWork */: noop,
+  r /* requestFormReset */: requestFormReset,
   D /* prefetchDNS */: noop,
   C /* preconnect */: noop,
   L /* preload */: noop,

packages/react-dom/src/ReactDOMSharedInternalsFB.js

@@ -27,6 +27,7 @@ function noop() {}
 
 const DefaultDispatcher: HostDispatcher = {
   f /* flushSyncWork */: noop,
+  r /* requestFormReset */: noop,
   D /* prefetchDNS */: noop,
   C /* preconnect */: noop,
   L /* preload */: noop,

packages/react-dom/src/client/ReactDOM.js

@@ -48,6 +48,7 @@ export {
 export {
   useFormStatus,
   useFormState,
+  requestFormReset,
 } from 'react-dom-bindings/src/shared/ReactDOMFormActions';
 
 if (__DEV__) {

packages/react-dom/src/client/ReactDOMFB.js

@@ -48,6 +48,7 @@ export {
 export {
   useFormStatus,
   useFormState,
+  requestFormReset,
 } from 'react-dom-bindings/src/shared/ReactDOMFormActions';
 
 if (__DEV__) {

packages/react-dom/src/shared/ReactDOMTypes.js

@@ -83,6 +83,7 @@ export type PreinitModuleScriptOptions = {
 
 export type HostDispatcher = {
   f /* flushSyncWork */: () => boolean | void,
+  r /* requestFormReset */: (form: HTMLFormElement) => void,
   D /* prefetchDNS */: (href: string) => void,
   C /* preconnect */: (href: string, crossOrigin?: ?CrossOriginEnum) => void,
   L /* preload */: (

packages/react-reconciler/src/ReactFiberHooks.js

@@ -3008,13 +3008,18 @@ export function startHostTransition<F>(
     // once more of this function is implemented.
     () => {
       // Automatically reset the form when the action completes.
-      requestFormReset(formFiber);
+      requestFormResetImpl(formFiber);
       return callback(formData);
     },
   );
 }
 
-function requestFormReset(formFiber: Fiber) {
+export function requestFormReset(formFiber: Fiber) {
+  // TODO: Not yet implemented. Need to upgrade the fiber to be stateful
+  // before scheduling the form reset.
+}
+
+function requestFormResetImpl(formFiber: Fiber) {
   const transition = requestCurrentTransition();
 
   if (__DEV__) {

scripts/error-codes/codes.json

@@ -506,5 +506,6 @@
   "518": "Saw multiple hydration diff roots in a pass. This is a bug in React.",
   "519": "Hydration Mismatch Exception: This is not a real error, and should not leak into userspace. If you're seeing this, it's likely a bug in React.",
   "520": "There was an error during concurrent rendering but React was able to recover by instead synchronously rendering the entire root.",
-  "521": "flushSyncWork should not be called from builds that support legacy mode. This is a bug in React."
+  "521": "flushSyncWork should not be called from builds that support legacy mode. This is a bug in React.",
+  "522": "Invalid form element. requestFormReset must be passed a form that was rendered by React."
 }