react-native-screen-transitions 3.9.0 → 3.11.0

package/src/shared/providers/screen/styles/hooks/use-interpolated-style-maps.tsx

@@ -1,5 +1,10 @@
 import { useMemo } from "react";
-import { useDerivedValue, useSharedValue } from "react-native-reanimated";
+import {
+	type SharedValue,
+	useAnimatedReaction,
+	useDerivedValue,
+	useSharedValue,
+} from "react-native-reanimated";
 import { NO_STYLES } from "../../../../constants";
 import { AnimationStore } from "../../../../stores/animation.store";
 import {
@@ -12,7 +17,7 @@ import type {
 	TransitionInterpolatedStyle,
 } from "../../../../types/animation.types";
 import { logger } from "../../../../utils/logger";
-import { useScreenAnimationContext } from "../../animation";
+import { useScreenAnimationStore } from "../../animation";
 import { useBuildBoundsAccessor } from "../../animation/helpers/accessors/use-build-bounds-accessor";
 import { useBuildTransitionAccessor } from "../../animation/helpers/accessors/use-build-transition-accessor";
 import type { ScreenInterpolatorFrame } from "../../animation/helpers/pipeline";
@@ -21,13 +26,22 @@ import { syncSelectedInterpolatorOptions } from "../../animation/helpers/selecte
 import { useDescriptorsStore } from "../../descriptors";
 import {
 	syncScreenOptionsOverrides,
-	useScreenOptionsContext,
+	useScreenOptionsStore,
 } from "../../options";
 import { collectInterpolatorSharedValues } from "../helpers/collect-interpolator-shared-values";
 import { normalizeSlots } from "../helpers/normalize-slots";
-import { isOpeningBeforeStart } from "../helpers/opening-phase";
+import { resolveInterpolatorStyleHandoff } from "../helpers/resolve-interpolator-style-handoff";
 import type { LocalStyleLayers } from "../helpers/resolve-slot-styles";
+import {
+	type SelectedInterpolatorFrame,
+	selectInterpolatorFrame,
+} from "../helpers/select-interpolator-frame";
 import { stripInterpolatorOptions } from "../helpers/strip-interpolator-options";
+import {
+	hasCloseTransitionFinished,
+	isOpenTransitionBlocked,
+} from "../helpers/transition-visual-state";
+import { resolveInitialDestinationStyleGate } from "../helpers/visibility-gate";
 
 const NO_STYLE_LAYERS: LocalStyleLayers = [];
 
@@ -39,8 +53,7 @@ type InterpolatorResult = {
 type RunInterpolatorParams = {
 	interpolator: ScreenStyleInterpolator | undefined;
 	props: ScreenInterpolatorFrame;
-	progress: ScreenInterpolatorFrame["progress"];
-	next: ScreenInterpolatorFrame["next"];
+	selectedFrame: SelectedInterpolatorFrame;
 	bounds: Parameters<ScreenStyleInterpolator>[0]["bounds"];
 	transition: Parameters<ScreenStyleInterpolator>[0]["transition"];
 };
@@ -62,8 +75,7 @@ const normalizeRawStyleMap = (
 const runInterpolator = ({
 	interpolator,
 	props,
-	progress,
-	next,
+	selectedFrame,
 	bounds,
 	transition,
 }: RunInterpolatorParams): InterpolatorResult | undefined => {
@@ -76,8 +88,7 @@ const runInterpolator = ({
 	try {
 		const raw = interpolator({
 			...props,
-			progress,
-			next,
+			...selectedFrame,
 			bounds,
 			transition,
 		});
@@ -98,17 +109,6 @@ const runInterpolator = ({
 	}
 };
 
-const appendLayer = (
-	layers: LocalStyleLayers,
-	result: InterpolatorResult | undefined,
-) => {
-	"worklet";
-
-	if (result) {
-		layers.push(result.stylesMap);
-	}
-};
-
 /**
  * Builds the raw interpolated style layers for the current screen pass.
  *
@@ -125,16 +125,26 @@ const appendLayer = (
  * normal interpolator selection once the gesture-driven close is no longer in
  * play.
  *
- * The result is ordered from lowest to highest priority. Resolution happens
- * downstream, where slot ids determine whether slots inherit from ancestors and
- * where higher owner layers override lower owner layers per key.
+ * At an ownership handoff, the last current-owner styles are frozen. The next
+ * owner replaces matching scalar keys and composes its live transforms after
+ * the frozen transforms. The previous interpolator is not evaluated again until
+ * it regains ownership.
  */
-export const useInterpolatedStylesMap = () => {
+export const useInterpolatedStylesMap = ({
+	enabled,
+	visibilityBlocked,
+}: {
+	enabled: boolean;
+	visibilityBlocked: SharedValue<boolean>;
+}) => {
 	const currentScreenKey = useDescriptorsStore(
 		(s) => s.derivations.currentScreenKey,
 	);
 	const nextScreenKey = useDescriptorsStore((s) => s.derivations.nextScreenKey);
-	const screenOptions = useScreenOptionsContext();
+	const destinationPairKey = useDescriptorsStore(
+		(s) => s.derivations.destinationPairKey,
+	);
+	const screenOptions = useScreenOptionsStore();
 	const {
 		screenInterpolatorProps,
 		screenInterpolatorPropsRevision,
@@ -143,7 +153,7 @@ export const useInterpolatedStylesMap = () => {
 		currentInterpolator,
 		ancestorScreenAnimationSources,
 		descendantScreenAnimationSources,
-	} = useScreenAnimationContext();
+	} = useScreenAnimationStore();
 	const boundsAccessor = useBuildBoundsAccessor();
 	const transition = useBuildTransitionAccessor();
 	const nextInterpolatorReady = useSharedValue(0);
@@ -157,14 +167,39 @@ export const useInterpolatedStylesMap = () => {
 	);
 
 	const activeScreenKey = nextScreenKey ?? currentScreenKey;
+	const { closing: activeClosing, entering: activeEntering } =
+		AnimationStore.getBag(activeScreenKey);
 	const {
-		entering: activeEntering,
-		transitionProgress: activeTransitionProgress,
-	} = AnimationStore.getBag(activeScreenKey);
-	const { pendingLifecycleRequestKind: activePendingLifecycleRequestKind } =
-		SystemStore.getBag(activeScreenKey);
+		animationProgress: activeAnimationProgress,
+		pendingLifecycleRequestKind: activePendingLifecycleRequestKind,
+		pendingLifecycleStartBlockCount: activePendingLifecycleStartBlockCount,
+	} = SystemStore.getBag(activeScreenKey);
 
 	const isGesturingDuringCloseAnimation = useSharedValue(false);
+	const initialDestinationStylesReady = useSharedValue(0);
+	const frozenCurrentStylesMap =
+		useSharedValue<NormalizedTransitionInterpolatedStyle>(NO_STYLES);
+	const shouldPrepareInitialDestinationStyles =
+		enabled && !!destinationPairKey && !nextScreenKey && !!currentInterpolator;
+
+	useAnimatedReaction(
+		() => {
+			"worklet";
+			return visibilityBlocked.get();
+		},
+		(isVisibilityBlocked) => {
+			"worklet";
+			const styleGate = resolveInitialDestinationStyleGate({
+				shouldPrepareStyles: shouldPrepareInitialDestinationStyles,
+				isVisibilityBlocked,
+				stylesReady: !!initialDestinationStylesReady.get(),
+			});
+
+			if (styleGate.shouldMarkStylesReady) {
+				initialDestinationStylesReady.set(1);
+			}
+		},
+	);
 
 	const localStylesMaps = useDerivedValue<LocalStyleLayers>(() => {
 		"worklet";
@@ -176,7 +211,7 @@ export const useInterpolatedStylesMap = () => {
 		);
 		const props = screenInterpolatorProps.get();
 
-		const { current, next, progress } = props;
+		const { current, next } = props;
 		const isDragging = current.gesture.dragging;
 		const isNextClosing = !!next?.closing;
 
@@ -194,44 +229,60 @@ export const useInterpolatedStylesMap = () => {
 		const isInGestureMode =
 			!!isDragging || isGesturingDuringCloseAnimation.get();
 
-		// The current screen keeps interpolator ownership until the next screen is
-		// genuinely live: never during a gesture-driven close, never before a next
-		// interpolator exists, and never in the next screen's pre-start window
-		// (entering, but no transformed frame yet). Only then does "next" take over.
+		// Interpolator ownership changes only at visual boundaries on the UI thread:
+		// the next screen attaches after its blockers clear and progress starts, then
+		// detaches once its closing progress has committed at zero. The downstream
+		// resolver sees the owner disappear in this same graph and resets its styles
+		// without waiting for React to remove the screen.
 		const isPendingOpen =
 			activePendingLifecycleRequestKind.get() ===
 			LifecycleTransitionRequestKind.Open;
 		const activeOpening = isPendingOpen || !!activeEntering.get();
+		const isOpeningBlocked = isOpenTransitionBlocked({
+			opening: activeOpening,
+			pendingLifecycleStartBlockCount:
+				activePendingLifecycleStartBlockCount.get(),
+			animationProgress: activeAnimationProgress.get(),
+		});
+		const hasCloseFinished = hasCloseTransitionFinished({
+			closing: activeClosing.get(),
+			animationProgress: activeAnimationProgress.get(),
+		});
 		const currentOwnsInterpolator =
 			isInGestureMode ||
 			!nextInterpolator ||
-			isOpeningBeforeStart(
-				activeOpening ? 1 : 0,
-				activeTransitionProgress.get(),
-			);
-		nextInterpolatorReady.set(currentOwnsInterpolator ? 0 : 1);
+			isOpeningBlocked ||
+			hasCloseFinished;
+		const nextReady = currentOwnsInterpolator ? 0 : 1;
+
+		nextInterpolatorReady.set(nextReady);
 
 		const interpolatorOptionsOwner = currentOwnsInterpolator
 			? "current"
 			: "next";
 
-		let selectedProgress = progress;
-		let selectedNext = next;
+		const selectedFrame = selectInterpolatorFrame(props, isInGestureMode);
+
+		const currentResult = currentOwnsInterpolator
+			? runInterpolator({
+					interpolator: currentInterpolator,
+					props,
+					selectedFrame,
+					bounds: boundsAccessor,
+					transition,
+				})
+			: undefined;
+
+		const initialDestinationStyleGate = resolveInitialDestinationStyleGate({
+			shouldPrepareStyles: shouldPrepareInitialDestinationStyles,
+			isVisibilityBlocked: visibilityBlocked.get(),
+			stylesReady: !!initialDestinationStylesReady.get(),
+		});
 
-		if (isInGestureMode) {
-			selectedProgress = current.progress;
-			selectedNext = undefined;
+		if (initialDestinationStyleGate.shouldWithholdStyles) {
+			return NO_STYLE_LAYERS;
 		}
 
-		const currentResult = runInterpolator({
-			interpolator: currentInterpolator,
-			props,
-			progress: selectedProgress,
-			next: selectedNext,
-			bounds: boundsAccessor,
-			transition,
-		});
-
 		if (interpolatorOptionsOwner === "current") {
 			syncSelectedInterpolatorOptions(
 				selectedInterpolatorOptions,
@@ -240,18 +291,26 @@ export const useInterpolatedStylesMap = () => {
 			);
 			syncScreenOptionsOverrides(currentResult?.rawStyleMap, screenOptions);
 
-			if (!currentResult) {
-				return NO_STYLE_LAYERS;
+			const handoff = resolveInterpolatorStyleHandoff({
+				currentOwnsInterpolator: true,
+				currentStylesMap: currentResult?.stylesMap,
+				nextStylesMap: undefined,
+				frozenCurrentStylesMap: frozenCurrentStylesMap.get(),
+			});
+
+			if (handoff.nextFrozenCurrentStylesMap !== frozenCurrentStylesMap.get()) {
+				frozenCurrentStylesMap.set(handoff.nextFrozenCurrentStylesMap);
 			}
 
-			return [currentResult.stylesMap];
+			return handoff.localStylesMaps.length
+				? handoff.localStylesMaps
+				: NO_STYLE_LAYERS;
 		}
 
 		const nextResult = runInterpolator({
 			interpolator: nextInterpolator,
 			props,
-			progress: selectedProgress,
-			next: selectedNext,
+			selectedFrame,
 			bounds: boundsAccessor,
 			transition,
 		});
@@ -263,16 +322,16 @@ export const useInterpolatedStylesMap = () => {
 		);
 		syncScreenOptionsOverrides(undefined, screenOptions);
 
-		const layers: LocalStyleLayers = [];
-
-		appendLayer(layers, currentResult);
-		appendLayer(layers, nextResult);
-
-		if (layers.length === 0) {
-			return NO_STYLE_LAYERS;
-		}
+		const handoff = resolveInterpolatorStyleHandoff({
+			currentOwnsInterpolator: false,
+			currentStylesMap: currentResult?.stylesMap,
+			nextStylesMap: nextResult?.stylesMap,
+			frozenCurrentStylesMap: frozenCurrentStylesMap.get(),
+		});
 
-		return layers;
+		return handoff.localStylesMaps.length
+			? handoff.localStylesMaps
+			: NO_STYLE_LAYERS;
 	});
 
 	return {

package/src/shared/providers/screen/styles/hooks/use-maybe-block-visibility.tsx

@@ -8,16 +8,21 @@ import {
 import { AnimationStore } from "../../../../stores/animation.store";
 import { SystemStore } from "../../../../stores/system.store";
 import { getVisibilityBlockOffset } from "../../../../utils/visibility-block-offset";
-import { useDescriptorDerivations } from "../../descriptors";
+import { useDescriptorsStore } from "../../descriptors";
+import { hasCloseTransitionFinished } from "../helpers/transition-visual-state";
 import { resolveScreenVisibilityGate } from "../helpers/visibility-gate";
 
 export const useMaybeBlockVisibility = (isFloatingOverlay?: boolean) => {
 	const { height } = useWindowDimensions();
-	const { currentScreenKey } = useDescriptorDerivations();
-	const { closing, entering, progressAnimating, transitionProgress } =
-		AnimationStore.getBag(currentScreenKey);
-	const { pendingLifecycleStartBlockCount, pendingLifecycleRequestKind } =
-		SystemStore.getBag(currentScreenKey);
+	const currentScreenKey = useDescriptorsStore(
+		(store) => store.derivations.currentScreenKey,
+	);
+	const { closing, entering } = AnimationStore.getBag(currentScreenKey);
+	const {
+		animationProgress,
+		pendingLifecycleStartBlockCount,
+		pendingLifecycleRequestKind,
+	} = SystemStore.getBag(currentScreenKey);
 
 	const hasVisibilityGateOpened = useSharedValue(false);
 	const shouldBlockVisibility = useSharedValue(!isFloatingOverlay);
@@ -31,7 +36,7 @@ export const useMaybeBlockVisibility = (isFloatingOverlay?: boolean) => {
 				hasVisibilityGateOpened: hasVisibilityGateOpened.get(),
 				pendingLifecycleStartBlockCount: pendingLifecycleStartBlockCount.get(),
 				pendingLifecycleRequestKind: pendingLifecycleRequestKind.get(),
-				progress: transitionProgress.get(),
+				animationProgress: animationProgress.get(),
 				entering: entering.get(),
 			});
 		},
@@ -49,14 +54,12 @@ export const useMaybeBlockVisibility = (isFloatingOverlay?: boolean) => {
 	const animatedStyle = useAnimatedStyle(() => {
 		"worklet";
 		const offset = getVisibilityBlockOffset(height);
-		// Keep opacity out of normal rendering so effects such as Liquid Glass
-		// retain native compositing. Once closing has fully finished, hiding the
-		// outgoing screen lets the handoff settle before React removes its host.
-		const shouldHideClosedScreen =
-			closing.get() === 1 &&
-			transitionProgress.get() <= 0 &&
-			progressAnimating.get() === 0;
-
+		// Hide the outgoing screen after its visual close while React removes its
+		// host asynchronously.
+		const shouldHideClosedScreen = hasCloseTransitionFinished({
+			closing: closing.get(),
+			animationProgress: animationProgress.get(),
+		});
 		if (shouldHideClosedScreen) {
 			return {
 				opacity: 0,

package/src/shared/providers/screen/styles/index.tsx

@@ -7,7 +7,6 @@ export {
 } from "./hooks/slot-resolvers";
 
 export {
-	ScreenSlotContext,
 	type ScreenSlotName,
 	ScreenSlotProvider,
 	useScreenSlots,

package/src/shared/providers/screen/styles/slot.provider.tsx

@@ -1,4 +1,4 @@
-import { type ReactNode, useContext, useLayoutEffect, useMemo } from "react";
+import { type ReactNode, useLayoutEffect, useMemo } from "react";
 import { StyleSheet } from "react-native";
 import Animated, { type SharedValue } from "react-native-reanimated";
 import type {
@@ -37,58 +37,72 @@ export type ScreenSlotContextValue = {
 	visibilityBlocked: SharedValue<boolean>;
 };
 
-export const {
-	ScreenSlotProvider,
-	ScreenSlotContext,
-	useScreenSlotContext: useScreenSlots,
-} = createProvider("ScreenSlot", {
-	guarded: true,
-})<Props, ScreenSlotContextValue>(({ children, isFloatingOverlay }) => {
-	const parentContext = useContext(ScreenSlotContext);
-	const currentScreenKey = useDescriptorsStore(
-		(s) => s.derivations.currentScreenKey,
-	);
+export const { ScreenSlotProvider, useScreenSlotStore: useScreenSlots } =
+	createProvider("ScreenSlot", {
+		guarded: true,
+	})<Props, ScreenSlotContextValue>(
+		({ children, isFloatingOverlay }, { useParentStore }) => {
+			const parentContext = useParentStore();
+			const currentScreenKey = useDescriptorsStore(
+				(s) => s.derivations.currentScreenKey,
+			);
 
-	const { localStylesMaps, nextInterpolatorReady } = useInterpolatedStylesMap();
+			const { animatedStyle, animatedProps, shouldBlockVisibility } =
+				useMaybeBlockVisibility(isFloatingOverlay);
 
-	const slotsMap = useResolvedStylesMap({
-		localStylesMaps,
-		ancestorStylesMap: parentContext?.slotsMap,
-	});
-	const { animatedStyle, animatedProps, shouldBlockVisibility } =
-		useMaybeBlockVisibility(isFloatingOverlay);
-	const value = useMemo(
-		() => ({
-			localStylesMaps,
-			nextInterpolatorReady,
-			slotsMap,
-			visibilityBlocked: shouldBlockVisibility,
-		}),
-		[localStylesMaps, nextInterpolatorReady, shouldBlockVisibility, slotsMap],
-	);
+			const { localStylesMaps, nextInterpolatorReady } =
+				useInterpolatedStylesMap({
+					enabled: !isFloatingOverlay,
+					visibilityBlocked: shouldBlockVisibility,
+				});
 
-	useLayoutEffect(() => {
-		registerScreenSlots(currentScreenKey, value);
+			const slotsMap = useResolvedStylesMap({
+				localStylesMaps,
+				ancestorStylesMap: parentContext?.slotsMap,
+			});
+			const value = useMemo(
+				() => ({
+					localStylesMaps,
+					nextInterpolatorReady,
+					slotsMap,
+					visibilityBlocked: shouldBlockVisibility,
+				}),
+				[
+					localStylesMaps,
+					nextInterpolatorReady,
+					shouldBlockVisibility,
+					slotsMap,
+				],
+			);
 
-		return () => {
-			unregisterScreenSlots(currentScreenKey, value);
-		};
-	}, [currentScreenKey, value]);
+			useLayoutEffect(() => {
+				registerScreenSlots(currentScreenKey, value);
 
-	return {
-		value,
-		children: (
-			<FloatingOverlayLayer enabled={isFloatingOverlay}>
-				<Animated.View
-					style={[styles.container, animatedStyle]}
-					animatedProps={animatedProps}
-				>
-					{children}
-				</Animated.View>
-			</FloatingOverlayLayer>
-		),
-	};
-});
+				return () => {
+					unregisterScreenSlots(currentScreenKey, value);
+				};
+			}, [currentScreenKey, value]);
+
+			const content = useMemo(
+				() => (
+					<FloatingOverlayLayer enabled={isFloatingOverlay}>
+						<Animated.View
+							style={[styles.container, animatedStyle]}
+							animatedProps={animatedProps}
+						>
+							{children}
+						</Animated.View>
+					</FloatingOverlayLayer>
+				),
+				[children, animatedStyle, isFloatingOverlay, animatedProps],
+			);
+
+			return {
+				value,
+				children: content,
+			};
+		},
+	);
 
 const styles = StyleSheet.create({
 	container: { flex: 1 },

package/src/shared/providers/stack/blank-stack-state/helpers/build-blank-stack-state.ts

@@ -138,20 +138,6 @@ const getSceneActivityWindow = <
 	};
 };
 
-const withDescriptorActivityState = <TDescriptor extends BaseStackDescriptor>(
-	descriptor: StackDescriptorSource<TDescriptor>,
-	activity: StackSceneActivity,
-): TDescriptor => {
-	if (descriptor.activity === activity) {
-		return descriptor as TDescriptor;
-	}
-
-	return {
-		...descriptor,
-		activity,
-	} as TDescriptor;
-};
-
 const buildBaseScenes = <
 	TDescriptor extends BaseStackDescriptor,
 	TNavigation extends BaseStackNavigation,
@@ -207,10 +193,9 @@ const buildBaseScenes = <
 			childStateUnchanged &&
 			previousDescriptor.route === sourceDescriptor.route &&
 			previousDescriptor.navigation === sourceDescriptor.navigation &&
-			previousDescriptor.options === sourceDescriptor.options &&
-			previousDescriptor.activity === activity
+			previousDescriptor.options === sourceDescriptor.options
 				? previousDescriptor
-				: withDescriptorActivityState(sourceDescriptor, activity);
+				: (sourceDescriptor as TDescriptor);
 
 		routeKeys.push(route.key);
 		routeChildStates[route.key] = routeChildState;
@@ -222,6 +207,7 @@ const buildBaseScenes = <
 		}
 
 		scenes.push({
+			activity,
 			route: descriptor.route,
 			descriptor,
 		});
@@ -289,6 +275,7 @@ const withSceneRelationships = <TDescriptor extends BaseStackDescriptor>({
 
 		if (
 			previousScene &&
+			previousScene.activity === nextScene.activity &&
 			previousScene.route === nextScene.route &&
 			previousScene.descriptor === nextScene.descriptor &&
 			previousScene.previousDescriptor === nextScene.previousDescriptor &&