Enables Basic View Transition support for React Native Fabric renderer (#35764)

## Summary

Enables Basic View Transition support for React Native Fabric renderer.

**Implemented:**
- Added FabricUIManager bindings for view transition methods:
`applyViewTransitionName`, `startViewTransition`
- Implemented `startViewTransition` with proper callback orchestration
(mutation → layout → afterMutation → spawnedWork → passive)
- Added fallback behavior that flushes work synchronously when Fabric's
`startViewTransition` returns null (e.g., when the ViewTransition
ReactNativeFeatureFlag is not enabled)
- Added Flow type declarations for new FabricUIManager methods
- Stubbed with `__DEV__` warnings for all the other view transition
config functions that are not yet implemented

This allows React Native apps using Fabric to leverage the View
Transition API for coordinated animations during state transitions, with
graceful degradation when the native side doesn't support it.

Below are diagrams of proposed architecture in fabric, and observation
of what/when config functions get called during a basic shared
transition example

<img width="2290" height="1529" alt="Untitled-2026-03-19-1240"
src="https://github.com/user-attachments/assets/192c9169-bc25-449c-a33b-dfec67179e7f"
/>

## How did you test this change?

- [x] `yarn flow fabric` - Flow type checks pass
- [x] `yarn lint` - Lint checks pass
- [x] Manually tested in Android catalyst app with
`enableViewTransition` and `enableViewTransitionForPersistenceMode `in
`ReactFeatureFlags.test-renderer.native-fb.js` and View Transition
enabled via ReactNativeFeatureFlag
- [x] Verified in the minified `ReactFabric-dev.fb.js` that the 'shim'
config functions are not included
- [x] Verified fallback behavior logs warning in `__DEV__` and flushes
work synchronously when ViewTransition flag isn't enabled in Fabric

packages/react-native-renderer/src/ReactFiberConfigFabric.js

@@ -166,6 +166,7 @@ export * from 'react-reconciler/src/ReactFiberConfigWithNoScopes';
 export * from 'react-reconciler/src/ReactFiberConfigWithNoTestSelectors';
 export * from 'react-reconciler/src/ReactFiberConfigWithNoResources';
 export * from 'react-reconciler/src/ReactFiberConfigWithNoSingletons';
+export * from './ReactFiberConfigFabricWithViewTransition';
 
 export function appendInitialChild(
   parentInstance: Instance,

packages/react-native-renderer/src/ReactFiberConfigFabricWithViewTransition.js

@@ -0,0 +1,261 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow
+ */
+
+import type {TransitionTypes} from 'react/src/ReactTransitionType';
+import type {
+  Instance,
+  Props,
+  Container,
+  SuspendedState,
+  GestureTimeline,
+} from './ReactFiberConfigFabric';
+
+const {
+  applyViewTransitionName: fabricApplyViewTransitionName,
+  startViewTransition: fabricStartViewTransition,
+} = nativeFabricUIManager;
+
+export type InstanceMeasurement = {
+  rect: {x: number, y: number, width: number, height: number},
+  abs: boolean,
+  clip: boolean,
+  view: boolean,
+};
+
+export type RunningViewTransition = {
+  finished: Promise<void>,
+  ready: Promise<void>,
+  ...
+};
+
+interface ViewTransitionPseudoElementType extends mixin$Animatable {
+  _pseudo: string;
+  _name: string;
+}
+
+function ViewTransitionPseudoElement(
+  this: ViewTransitionPseudoElementType,
+  pseudo: string,
+  name: string,
+) {
+  // TODO: Get the owner document from the root container.
+  this._pseudo = pseudo;
+  this._name = name;
+}
+
+export type ViewTransitionInstance = null | {
+  name: string,
+  old: mixin$Animatable,
+  new: mixin$Animatable,
+  ...
+};
+
+export function restoreViewTransitionName(
+  instance: Instance,
+  props: Props,
+): void {
+  if (__DEV__) {
+    console.warn('restoreViewTransitionName is not implemented');
+  }
+}
+
+// Cancel the old and new snapshots of viewTransitionName
+export function cancelViewTransitionName(
+  instance: Instance,
+  oldName: string,
+  props: Props,
+): void {
+  if (__DEV__) {
+    console.warn('cancelViewTransitionName is not implemented');
+  }
+}
+
+export function cancelRootViewTransitionName(rootContainer: Container): void {
+  // No-op
+}
+
+export function restoreRootViewTransitionName(rootContainer: Container): void {
+  // No-op
+}
+
+export function cloneRootViewTransitionContainer(
+  rootContainer: Container,
+): Instance {
+  if (__DEV__) {
+    console.warn('cloneRootViewTransitionContainer is not implemented');
+  }
+  // $FlowFixMe[incompatible-return] Return empty stub
+  return null;
+}
+
+export function removeRootViewTransitionClone(
+  rootContainer: Container,
+  clone: Instance,
+): void {
+  if (__DEV__) {
+    console.warn('removeRootViewTransitionClone is not implemented');
+  }
+}
+
+export function measureInstance(instance: Instance): InstanceMeasurement {
+  if (__DEV__) {
+    console.warn('measureInstance is not implemented');
+  }
+  return {
+    rect: {
+      x: 0,
+      y: 0,
+      width: 0,
+      height: 0,
+    },
+    abs: false,
+    clip: false,
+    // TODO: properly calculate whether instance is in viewport
+    view: true,
+  };
+}
+
+export function measureClonedInstance(instance: Instance): InstanceMeasurement {
+  if (__DEV__) {
+    console.warn('measureClonedInstance is not implemented');
+  }
+  return {
+    rect: {x: 0, y: 0, width: 0, height: 0},
+    abs: false,
+    clip: false,
+    view: true,
+  };
+}
+
+export function wasInstanceInViewport(
+  measurement: InstanceMeasurement,
+): boolean {
+  return measurement.view;
+}
+
+export function hasInstanceChanged(
+  oldMeasurement: InstanceMeasurement,
+  newMeasurement: InstanceMeasurement,
+): boolean {
+  if (__DEV__) {
+    console.warn('hasInstanceChanged is not implemented');
+  }
+  return false;
+}
+
+export function hasInstanceAffectedParent(
+  oldMeasurement: InstanceMeasurement,
+  newMeasurement: InstanceMeasurement,
+): boolean {
+  if (__DEV__) {
+    console.warn('hasInstanceAffectedParent is not implemented');
+  }
+  return false;
+}
+
+export function startGestureTransition(
+  suspendedState: null | SuspendedState,
+  rootContainer: Container,
+  timeline: GestureTimeline,
+  rangeStart: number,
+  rangeEnd: number,
+  transitionTypes: null | TransitionTypes,
+  mutationCallback: () => void,
+  animateCallback: () => void,
+  errorCallback: (error: mixed) => void,
+  finishedAnimation: () => void,
+): RunningViewTransition {
+  if (__DEV__) {
+    console.warn('startGestureTransition is not implemented');
+  }
+  return {
+    finished: Promise.resolve(),
+    ready: Promise.resolve(),
+  };
+}
+
+export function stopViewTransition(transition: RunningViewTransition): void {
+  if (__DEV__) {
+    console.warn('stopViewTransition is not implemented');
+  }
+}
+
+export function addViewTransitionFinishedListener(
+  transition: RunningViewTransition,
+  callback: () => void,
+): void {
+  transition.finished.finally(callback);
+}
+
+export function createViewTransitionInstance(
+  name: string,
+): ViewTransitionInstance {
+  return {
+    name,
+    old: new (ViewTransitionPseudoElement: any)('old', name),
+    new: new (ViewTransitionPseudoElement: any)('new', name),
+  };
+}
+
+export function applyViewTransitionName(
+  instance: Instance,
+  name: string,
+  className: ?string,
+): void {
+  // add view-transition-name to things that might animate for browser
+  fabricApplyViewTransitionName(instance.node, name, className);
+}
+
+export function startViewTransition(
+  suspendedState: null | SuspendedState,
+  rootContainer: Container,
+  transitionTypes: null | TransitionTypes,
+  mutationCallback: () => void,
+  layoutCallback: () => void,
+  afterMutationCallback: () => void,
+  spawnedWorkCallback: () => void,
+  passiveCallback: () => mixed,
+  errorCallback: (error: mixed) => void,
+  blockedCallback: (name: string) => void,
+  finishedAnimation: () => void,
+): null | RunningViewTransition {
+  const transition = fabricStartViewTransition(
+    // mutation
+    () => {
+      mutationCallback(); // completeRoot should run here
+      layoutCallback();
+      afterMutationCallback();
+    },
+  );
+
+  if (transition == null) {
+    if (__DEV__) {
+      console.warn(
+        "startViewTransition didn't kick off transition in Fabric, the ViewTransition ReactNativeFeatureFlag might not be enabled.",
+      );
+    }
+    // Flush remaining work synchronously.
+    mutationCallback();
+    layoutCallback();
+    // Skip afterMutationCallback(). We don't need it since we're not animating.
+    spawnedWorkCallback();
+    // Skip passiveCallback(). Spawned work will schedule a task.
+    return null;
+  }
+
+  transition.ready.then(() => {
+    spawnedWorkCallback();
+  });
+
+  transition.finished.finally(() => {
+    passiveCallback();
+  });
+
+  return transition;
+}

packages/react-noop-renderer/src/createReactNoop.js

@@ -25,6 +25,7 @@ import type {EventPriority} from 'react-reconciler/src/ReactEventPriorities';
 import type {TransitionTypes} from 'react/src/ReactTransitionType';
 import typeof * as HostConfig from 'react-reconciler/src/ReactFiberConfig';
 import typeof * as ReactFiberConfigWithNoMutation from 'react-reconciler/src/ReactFiberConfigWithNoMutation';
+import typeof * as ReactFiberConfigWithNoViewTransition from 'react-reconciler/src/ReactFiberConfigWithNoViewTransition';
 import typeof * as ReactFiberConfigWithNoPersistence from 'react-reconciler/src/ReactFiberConfigWithNoPersistence';
 
 import typeof * as ReconcilerAPI from 'react-reconciler/src/ReactFiberReconciler';
@@ -709,7 +710,8 @@ function createReactNoop(
 
   const mutationHostConfig: Pick<
     HostConfig,
-    $Keys<ReactFiberConfigWithNoMutation>,
+    | $Keys<ReactFiberConfigWithNoMutation>
+    | $Keys<ReactFiberConfigWithNoViewTransition>,
   > = {
     supportsMutation: true,
 

packages/react-reconciler/src/ReactFiberCommitViewTransitions.js

@@ -46,6 +46,7 @@ import {trackAnimatingTask} from './ReactProfilerTimer';
 import {
   enableComponentPerformanceTrack,
   enableProfilerTimer,
+  enableViewTransitionForPersistenceMode,
 } from 'shared/ReactFeatureFlags';
 
 export let shouldStartViewTransition: boolean = false;
@@ -140,7 +141,46 @@ function applyViewTransitionToHostInstancesRecursive(
   stopAtNestedViewTransitions: boolean,
 ): boolean {
   if (!supportsMutation) {
-    return false;
+    if (enableViewTransitionForPersistenceMode) {
+      while (child !== null) {
+        if (child.tag === HostComponent) {
+          const instance: Instance = child.stateNode;
+          // TODO: calculate whether component is in viewport
+          shouldStartViewTransition = true;
+          applyViewTransitionName(
+            instance,
+            viewTransitionHostInstanceIdx === 0
+              ? name
+              : name + '_' + viewTransitionHostInstanceIdx,
+            className,
+          );
+          viewTransitionHostInstanceIdx++;
+        } else if (
+          child.tag === OffscreenComponent &&
+          child.memoizedState !== null
+        ) {
+          // Skip any hidden subtrees. They were or are effectively not there.
+        } else if (
+          child.tag === ViewTransitionComponent &&
+          stopAtNestedViewTransitions
+        ) {
+          // Skip any nested view transitions for updates since in that case the
+          // inner most one is the one that handles the update.
+        } else {
+          applyViewTransitionToHostInstancesRecursive(
+            child.child,
+            name,
+            className,
+            collectMeasurements,
+            stopAtNestedViewTransitions,
+          );
+        }
+        child = child.sibling;
+      }
+      return true;
+    } else {
+      return false;
+    }
   }
   let inViewport = false;
   while (child !== null) {
@@ -649,7 +689,60 @@ function measureViewTransitionHostInstancesRecursive(
   stopAtNestedViewTransitions: boolean,
 ): boolean {
   if (!supportsMutation) {
-    return true;
+    if (enableViewTransitionForPersistenceMode) {
+      while (child !== null) {
+        if (child.tag === HostComponent) {
+          const instance: Instance = child.stateNode;
+          if (
+            previousMeasurements == null ||
+            viewTransitionHostInstanceIdx >= previousMeasurements.length
+          ) {
+            // If there was an insertion of extra nodes, we have to assume they affected the parent.
+            // It should have already been marked as an Update due to the mutation.
+            parentViewTransition.flags |= AffectedParentLayout;
+          }
+          // TODO: check if instance is out of viewport
+          if ((parentViewTransition.flags & Update) !== NoFlags) {
+            applyViewTransitionName(
+              instance,
+              viewTransitionHostInstanceIdx === 0
+                ? newName
+                : newName + '_' + viewTransitionHostInstanceIdx,
+              className,
+            );
+          }
+          // TODO: cancel transition by pushing into viewTransitionCancelableChildren
+          viewTransitionHostInstanceIdx++;
+        } else if (
+          child.tag === OffscreenComponent &&
+          child.memoizedState !== null
+        ) {
+          // Skip any hidden subtrees. They were or are effectively not there.
+        } else if (
+          child.tag === ViewTransitionComponent &&
+          stopAtNestedViewTransitions
+        ) {
+          // Skip any nested view transitions for updates since in that case the
+          // inner most one is the one that handles the update.
+          // If this inner boundary resized we need to bubble that information up.
+          parentViewTransition.flags |= child.flags & AffectedParentLayout;
+        } else {
+          measureViewTransitionHostInstancesRecursive(
+            parentViewTransition,
+            child.child,
+            newName,
+            oldName,
+            className,
+            previousMeasurements,
+            stopAtNestedViewTransitions,
+          );
+        }
+        child = child.sibling;
+      }
+      return true;
+    } else {
+      return false;
+    }
   }
   let inViewport = false;
   while (child !== null) {

packages/react-reconciler/src/ReactFiberConfigWithNoMutation.js

@@ -37,25 +37,5 @@ export const hideTextInstance = shim;
 export const unhideInstance = shim;
 export const unhideTextInstance = shim;
 export const clearContainer = shim;
-export const applyViewTransitionName = shim;
-export const restoreViewTransitionName = shim;
-export const cancelViewTransitionName = shim;
-export const cancelRootViewTransitionName = shim;
-export const restoreRootViewTransitionName = shim;
-export const cloneRootViewTransitionContainer = shim;
-export const removeRootViewTransitionClone = shim;
-export type InstanceMeasurement = null;
-export const measureInstance = shim;
-export const measureClonedInstance = shim;
-export const wasInstanceInViewport = shim;
-export const hasInstanceChanged = shim;
-export const hasInstanceAffectedParent = shim;
-export const startViewTransition = shim;
-export type RunningViewTransition = null;
-export const startGestureTransition = shim;
-export const stopViewTransition = shim;
-export const addViewTransitionFinishedListener = shim;
-export type ViewTransitionInstance = null | {name: string, ...};
-export const createViewTransitionInstance = shim;
 export type GestureTimeline = any;
 export const getCurrentGestureOffset = shim;

packages/react-reconciler/src/ReactFiberConfigWithNoViewTransition.js

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow
+ */
+
+// Renderers that don't support view transitions
+// can re-export everything from this module.
+
+function shim(...args: any): empty {
+  throw new Error(
+    'The current renderer does not support view transitions. ' +
+      'This error is likely caused by a bug in React. ' +
+      'Please file an issue.',
+  );
+}
+
+// View Transitions (when unsupported)
+export const applyViewTransitionName = shim;
+export const restoreViewTransitionName = shim;
+export const cancelViewTransitionName = shim;
+export const cancelRootViewTransitionName = shim;
+export const restoreRootViewTransitionName = shim;
+export const cloneRootViewTransitionContainer = shim;
+export const removeRootViewTransitionClone = shim;
+export type InstanceMeasurement = any;
+export const measureInstance = shim;
+export const measureClonedInstance = shim;
+export const wasInstanceInViewport = shim;
+export const hasInstanceChanged = shim;
+export const hasInstanceAffectedParent = shim;
+export const startViewTransition = shim;
+export type RunningViewTransition = any;
+export const startGestureTransition = shim;
+export const stopViewTransition = shim;
+export const addViewTransitionFinishedListener = shim;
+export type ViewTransitionInstance = any;
+export const createViewTransitionInstance = shim;

packages/shared/ReactFeatureFlags.js

@@ -80,6 +80,8 @@ export const enableTaint = __EXPERIMENTAL__;
 
 export const enableViewTransition: boolean = true;
 
+export const enableViewTransitionForPersistenceMode: boolean = false;
+
 export const enableGestureTransition = __EXPERIMENTAL__;
 
 export const enableScrollEndPolyfill = __EXPERIMENTAL__;

packages/shared/forks/ReactFeatureFlags.native-fb-dynamic.js

@@ -26,3 +26,4 @@ export const enableFragmentRefsScrollIntoView = __VARIANT__;
 export const enableFragmentRefsInstanceHandles = __VARIANT__;
 export const enableEffectEventMutationPhase = __VARIANT__;
 export const enableFragmentRefsTextNodes = __VARIANT__;
+export const enableViewTransitionForPersistenceMode = __VARIANT__;

packages/shared/forks/ReactFeatureFlags.native-fb.js

@@ -28,6 +28,7 @@ export const {
   enableFragmentRefsScrollIntoView,
   enableFragmentRefsInstanceHandles,
   enableFragmentRefsTextNodes,
+  enableViewTransitionForPersistenceMode,
 } = dynamicFlags;
 
 // The rest of the flags are static for better dead code elimination.

packages/shared/forks/ReactFeatureFlags.native-oss.js

@@ -59,6 +59,7 @@ export const enableYieldingBeforePassive: boolean = false;
 
 export const enableThrottledScheduling: boolean = false;
 export const enableViewTransition: boolean = true;
+export const enableViewTransitionForPersistenceMode: boolean = false;
 export const enableGestureTransition: boolean = false;
 export const enableScrollEndPolyfill: boolean = true;
 export const enableSuspenseyImages: boolean = false;

packages/shared/forks/ReactFeatureFlags.test-renderer.js

@@ -60,6 +60,7 @@ export const enableYieldingBeforePassive: boolean = true;
 
 export const enableThrottledScheduling: boolean = false;
 export const enableViewTransition: boolean = true;
+export const enableViewTransitionForPersistenceMode: boolean = false;
 export const enableGestureTransition: boolean = false;
 export const enableScrollEndPolyfill: boolean = true;
 export const enableSuspenseyImages: boolean = false;

packages/shared/forks/ReactFeatureFlags.test-renderer.native-fb.js

@@ -55,6 +55,7 @@ export const transitionLaneExpirationMs = 5000;
 export const enableYieldingBeforePassive = false;
 export const enableThrottledScheduling = false;
 export const enableViewTransition = true;
+export const enableViewTransitionForPersistenceMode = false;
 export const enableGestureTransition = false;
 export const enableScrollEndPolyfill = true;
 export const enableSuspenseyImages = false;

packages/shared/forks/ReactFeatureFlags.test-renderer.www.js

@@ -66,6 +66,7 @@ export const enableYieldingBeforePassive: boolean = false;
 
 export const enableThrottledScheduling: boolean = false;
 export const enableViewTransition: boolean = true;
+export const enableViewTransitionForPersistenceMode: boolean = false;
 export const enableGestureTransition: boolean = false;
 export const enableScrollEndPolyfill: boolean = true;
 export const enableSuspenseyImages: boolean = false;

packages/shared/forks/ReactFeatureFlags.www.js

@@ -98,6 +98,8 @@ export const disableLegacyMode: boolean = true;
 
 export const enableEagerAlternateStateNodeCleanup: boolean = true;
 
+export const enableViewTransitionForPersistenceMode: boolean = false;
+
 export const enableGestureTransition: boolean = false;
 
 export const enableSuspenseyImages: boolean = false;

scripts/error-codes/codes.json

@@ -567,5 +567,6 @@
   "579": "Invalid data for bytes stream.",
   "580": "Server Function has too many bound arguments. Received %s but the limit is %s.",
   "581": "BigInt is too large. Received %s digits but the limit is %s.",
-  "582": "Referenced Blob is not a Blob."
+  "582": "Referenced Blob is not a Blob.",
+  "583": "The current renderer does not support view transitions. This error is likely caused by a bug in React. Please file an issue."
 }

scripts/flow/react-native-host-hooks.js

@@ -301,5 +301,14 @@ declare const nativeFabricUIManager: {
   unstable_ContinuousEventPriority: number,
   unstable_IdleEventPriority: number,
   unstable_getCurrentEventPriority: () => number,
+  applyViewTransitionName: (
+    node: Object,
+    name: string,
+    className: ?string,
+  ) => void,
+  startViewTransition: (mutationCallback: () => void) => {
+    finished: Promise<void>,
+    ready: Promise<void>,
+  },
   ...
 };