react-native-screen-transitions 4.0.0-alpha.7 → 4.0.0-alpha.9

package/src/types/animation.types.ts

@@ -28,11 +28,8 @@ export type ScreenTransitionOptions = Pick<
 	| "gestureVelocityImpact"
 	| "gestureSnapVelocityImpact"
 	| "gestureReleaseVelocityScale"
-	| "gestureResponseDistance"
-	| "gestureProgressMode"
-	| "gestureDrivesProgress"
-	| "gestureActivationArea"
 	| "gestureSnapLocked"
+	| "sheetSnapBehavior"
 	| "sheetScrollGestureBehavior"
 	| "backdropBehavior"
 >;
@@ -105,13 +102,6 @@ export type ScreenTransitionState = {
 	 */
 	settled: number;
 
-	/**
-	 * Deprecated alias for `settled`.
-	 *
-	 * @deprecated Use `settled` instead.
-	 */
-	logicallySettled: number;
-
 	/**
 	 * Live gesture values for this screen.
 	 * Contains translation (x, y), normalized values (-1 to 1),
@@ -242,15 +232,6 @@ export interface ScreenInterpolationProps {
 	 */
 	stackProgress: number;
 
-	/**
-	 * Whether the active transition is visually close enough to its target to be
-	 * treated as complete, even if the animation is still physically settling.
-	 *
-	 * @deprecated Use `active.settled` instead. Screen settlement state
-	 * belongs on the screen state object.
-	 */
-	logicallySettled: number;
-
 	/**
 	 * Function that provides access to bounds helpers for shared screen transitions.
 	 */
@@ -364,8 +345,6 @@ export type NormalizedTransitionInterpolatedStyle = {
 	content?: NormalizedTransitionSlotStyle;
 	/** Animated style and props for the backdrop layer between screens. */
 	backdrop?: NormalizedTransitionSlotStyle;
-	/** Animated style and props for the surface component layer within the screen. */
-	surface?: NormalizedTransitionSlotStyle;
 	/** Animated style and props for the navigation mask container layer. */
 	[NAVIGATION_MASK_CONTAINER_STYLE_ID]?: NormalizedTransitionSlotStyle;
 	/** Animated style and props for the navigation mask element layer. */
@@ -384,12 +363,18 @@ export type TransitionInterpolatedStyle = {
 	 * This reserved key is stripped before style slot normalization.
 	 */
 	options?: TransitionInterpolatorOptions;
+	/**
+	 * Animated style and props for the route-owned floating overlay.
+	 *
+	 * Visible overlays form their own adjacency chain. A route that returns this
+	 * slot controls the previous visible overlay and, when it owns an overlay,
+	 * its entering overlay.
+	 */
+	overlay?: TransitionSlotStyle;
 	/** Animated style and props for the main screen content view. */
 	content?: TransitionSlotStyle;
 	/** Animated style and props for the backdrop layer between screens. */
 	backdrop?: TransitionSlotStyle;
-	/** Animated style and props for the surface component layer within the screen. */
-	surface?: TransitionSlotStyle;
 	/** Animated style and props for the navigation mask container layer. */
 	[NAVIGATION_MASK_CONTAINER_STYLE_ID]?: TransitionSlotStyle;
 	/** Animated style and props for the navigation mask element layer. */

package/src/types/blank-stack.types.ts

@@ -60,24 +60,6 @@ export type BlankStackNavigationHelpers = NavigationHelpers<
  * they are also supported as top-level keys in static navigator config.
  */
 export interface BlankStackFactoryOptions {
-	/**
-	 * Controls whether blank-stack screens are rendered with react-native-screens.
-	 *
-	 * When enabled, inactive presentation state is backed by
-	 * `ScreenContainer`/`Screen.activityState`. Set this to `false` to render
-	 * screens as regular React Native views.
-	 *
-	 * @default true
-	 */
-	nativeScreens?: boolean;
-
-	/**
-	 * Enables react-native-screens for blank-stack screen retention.
-	 *
-	 * @deprecated Use `nativeScreens` instead.
-	 */
-	enableNativeScreens?: boolean;
-
 	/**
 	 * Creates an isolated navigation tree for embedded flows.
 	 *
@@ -96,8 +78,14 @@ export interface BlankStackFactoryOptions {
  * Props passed to overlay components in blank-stack.
  * Uses the shared OverlayProps type with blank-stack's navigation type.
  */
-export type BlankStackOverlayProps = OverlayProps<
-	BlankStackNavigationProp<ParamListBase>
+export type BlankStackOverlayProps<
+	ParamList extends ParamListBase = ParamListBase,
+	RouteName extends keyof ParamList = keyof ParamList,
+	NavigatorID extends string | undefined = undefined,
+> = OverlayProps<
+	BlankStackNavigationProp<ParamList, RouteName, NavigatorID>,
+	ParamList,
+	RouteName
 >;
 
 export type BlankStackNavigationOptions = ScreenTransitionConfig & {

package/src/types/bounds.types.ts

@@ -18,7 +18,6 @@ import type {
 	TransitionInterpolatedStyle,
 	TransitionSlotStyle,
 } from "./animation.types";
-import type { GestureProgressMode } from "./gesture.types";
 
 export type { BoundsLink, BoundsLinkStatus } from "../stores/bounds/types";
 
@@ -65,28 +64,6 @@ export type BoundsNavigationZoomDragOptions = {
 	scale?: BoundsNavigationZoomAxisResponse;
 };
 
-/**
- * Legacy zoom opacity interpolation tuple.
- *
- * @deprecated Zoom opacity ownership now follows the native preset.
- */
-export type BoundsNavigationZoomOpacityRange = readonly [
-	inputStart: number,
-	inputEnd: number,
-	outputStart?: number,
-	outputEnd?: number,
-];
-
-/**
- * Legacy opening and closing zoom opacity ranges.
- *
- * @deprecated Zoom opacity ownership now follows the native preset.
- */
-export type BoundsNavigationZoomOpacityRanges = {
-	open?: BoundsNavigationZoomOpacityRange;
-	close?: BoundsNavigationZoomOpacityRange;
-};
-
 export type BoundsNavigationZoomOptions = {
 	/**
 	 * Geometry that the zoomed content should resolve against.
@@ -139,67 +116,6 @@ export type BoundsNavigationZoomOptions = {
 	 * Native drag-response intensity controls.
 	 */
 	drag?: BoundsNavigationZoomDragOptions;
-	/**
-	 * @deprecated Ignored. Zoom no longer exposes a transition-specific debug
-	 * overlay.
-	 */
-	debug?: boolean;
-	/**
-	 * @deprecated Ignored. Zoom opacity ownership now follows the native preset.
-	 */
-	focusedElementOpacity?: BoundsNavigationZoomOpacityRanges;
-	/**
-	 * @deprecated Ignored. Zoom opacity ownership now follows the native preset.
-	 */
-	unfocusedElementOpacity?: BoundsNavigationZoomOpacityRanges;
-	/**
-	 * @deprecated Ignored. Zoom now owns its gesture sensitivity curve.
-	 */
-	maxSensitivity?: number;
-	/**
-	 * @deprecated Ignored. Zoom now owns its velocity-depth behavior.
-	 */
-	velocityDepth?: number;
-	/**
-	 * @deprecated Ignored. Gesture movement always contributes to `progress`.
-	 */
-	gestureProgressMode?: GestureProgressMode;
-	/**
-	 * @deprecated Ignored. Use `drag.scale.horizontal` to adjust response
-	 * intensity without replacing the native curve.
-	 */
-	horizontalDragScale?: readonly [
-		shrinkMin: number,
-		growMax: number,
-		exponent?: number,
-	];
-	/**
-	 * @deprecated Ignored. Use `drag.scale.vertical` to adjust response intensity
-	 * without replacing the native curve.
-	 */
-	verticalDragScale?: readonly [
-		shrinkMin: number,
-		growMax: number,
-		exponent?: number,
-	];
-	/**
-	 * @deprecated Ignored. Use `drag.translation.horizontal` to adjust response
-	 * intensity without replacing the native curve.
-	 */
-	horizontalDragTranslation?: readonly [
-		negativeMax: number,
-		positiveMax: number,
-		exponent?: number,
-	];
-	/**
-	 * @deprecated Ignored. Use `drag.translation.vertical` to adjust response
-	 * intensity without replacing the native curve.
-	 */
-	verticalDragTranslation?: readonly [
-		negativeMax: number,
-		positiveMax: number,
-		exponent?: number,
-	];
 };
 
 export type BoundsNavigationZoomStyle = TransitionInterpolatedStyle & {
@@ -242,16 +158,6 @@ export type BoundsNavigationRevealOptions = {
 	 * @default 0.5
 	 */
 	velocityDepth?: number;
-	/**
-	 * Deprecated compatibility option.
-	 *
-	 * Gesture movement now always contributes to `progress`; use `transitionProgress`
-	 * when a recipe needs transition progress without live gesture contribution.
-	 * The reveal helper no longer reads this option.
-	 *
-	 * @deprecated Use `transitionProgress` from interpolation state instead.
-	 */
-	gestureProgressMode?: GestureProgressMode;
 	/**
 	 * Scale applied to the unfocused background content while the reveal runs
 	 * above it.
@@ -316,12 +222,6 @@ export type BoundsScopedAccessor = BoundsBoundNavigationAccessor & {
 	values: <T extends BoundsComputeOptions = BoundsComputeOptions>(
 		options?: T,
 	) => BoundsValuesResult<T>;
-	/**
-	 * @deprecated Use {@linkcode values}.
-	 */
-	math: <T extends BoundsComputeOptions = BoundsComputeOptions>(
-		options?: T,
-	) => BoundsValuesResult<T>;
 	link: (id?: BoundsIdentityInput) => BoundsLink | null;
 };
 

package/src/types/gesture.types.ts

@@ -16,8 +16,6 @@ export type GestureDirection = PanGestureDirection | PinchGestureDirection;
 
 export type ActiveGesture = ResolvedPanGestureDirection | PinchGestureDirection;
 
-export type GestureProgressMode = "progress-driven" | "freeform";
-
 export type SnapPanAxis = "horizontal" | "vertical";
 
 /**
@@ -158,12 +156,6 @@ export type GestureHandoffValues = {
 	 * The gesture associated with the handoff values.
 	 */
 	active: ActiveGesture | null;
-	/**
-	 * The pan direction associated with the handoff values.
-	 *
-	 * @deprecated Use `active` instead.
-	 */
-	direction: ResolvedPanGestureDirection | null;
 };
 
 export type GestureValues = {
@@ -220,22 +212,10 @@ export type GestureValues = {
 	 * Physical gesture values before `gestureSensitivity` is applied.
 	 */
 	raw: RawGestureValues;
-	/**
-	 * The gesture that is currently active.
-	 *
-	 * @deprecated Use `initiator` for the accepted activation identity.
-	 */
-	active: ActiveGesture | null;
 	/**
 	 * The accepted activation identity for the current gesture attempt.
 	 */
 	initiator: ActiveGesture | "none";
-	/**
-	 * The initial pan direction that activated the gesture.
-	 *
-	 * @deprecated Use `active` instead.
-	 */
-	direction: ResolvedPanGestureDirection | null;
 	/**
 	 * Gesture values latched at the release boundary for animation handoff.
 	 *
@@ -245,10 +225,10 @@ export type GestureValues = {
 	 */
 	handoff: GestureHandoffValues;
 	/**
-	 * A flag indicating if the screen is in the process of dismissing (0 or 1).
+	 * Whether a released gesture is completing a dismissal (0 or 1).
 	 *
-	 * @deprecated Use `closing` for public screen lifecycle state. Release handoff
-	 * details do not have a public replacement.
+	 * Use `closing` for screen lifecycle state. This value specifically describes
+	 * the gesture release handoff.
 	 */
 	dismissing: number;
 	/**
@@ -256,17 +236,7 @@ export type GestureValues = {
 	 */
 	dragging: number;
 	/**
-	 * A flag indicating if released gesture values are animating back to neutral.
-	 *
-	 * @deprecated Use `animating` or `settled` for public motion state.
+	 * Whether released gesture values are animating back to neutral (0 or 1).
 	 */
 	settling: number;
-	/** @deprecated Use `normX` instead. */
-	normalizedX: number;
-	/** @deprecated Use `normY` instead. */
-	normalizedY: number;
-	/** @deprecated Use `dismissing` instead. */
-	isDismissing: number;
-	/** @deprecated Use `dragging` instead. */
-	isDragging: number;
 };

package/src/types/index.ts

@@ -27,8 +27,6 @@ export type {
 	BoundsNavigationRevealStyle,
 	BoundsNavigationZoomAxisResponse,
 	BoundsNavigationZoomDragOptions,
-	BoundsNavigationZoomOpacityRange,
-	BoundsNavigationZoomOpacityRanges,
 	BoundsNavigationZoomOptions,
 	BoundsNavigationZoomStyle,
 } from "./bounds.types";
@@ -51,7 +49,7 @@ export type {
 	ScrollMetadataState,
 	SideActivation,
 } from "./gesture.types";
-export type { OverlayProps } from "./overlay.types";
+export type { OverlayComponent, OverlayProps } from "./overlay.types";
 export type {
 	GestureTracking,
 	InactiveBehavior,
@@ -63,6 +61,7 @@ export type {
 	ScreenKey,
 	ScreenLayerComponentProps,
 	ScreenTransitionConfig,
+	SheetSnapBehavior,
 	TransitionAwareProps,
 } from "./screen.types";
 export type {
@@ -71,7 +70,6 @@ export type {
 	BaseStackRoute,
 	BaseStackScene,
 	BaseStackState,
-	DescriptorMap,
-	StackDescriptorSource,
 	StackSceneActivity,
+	StackTransitionOptions,
 } from "./stack.types";

package/src/types/overlay.types.ts

@@ -1,28 +1,44 @@
-import type { Route } from "@react-navigation/native";
+import type {
+	ParamListBase,
+	ParamListRoute,
+	RouteProp,
+} from "@react-navigation/native";
+import type { ReactNode } from "react";
 import type { DerivedValue } from "react-native-reanimated";
 import type { ScreenTransitionConfig } from "./screen.types";
 
 /**
- * Props passed to overlay components.
- * Generic over the navigation type since different stacks have different navigation props.
+ * Overlay state without the animated progress value.
  */
+export type OverlayScreenState<
+	TNavigation = unknown,
+	TParamList extends ParamListBase = ParamListBase,
+	TOwnerRouteName extends keyof TParamList = keyof TParamList,
+> = Omit<OverlayProps<TNavigation, TParamList, TOwnerRouteName>, "progress"> & {
+	snapTo: (index: number) => void;
+};
+
 /**
- * Overlay screen state passed to overlay host for rendering.
- * Generic over navigation type — defaults to `unknown` for flexibility.
+ * Props passed to a floating overlay component.
+ *
+ * `route` and `index` identify the screen that owns the overlay. Focused
+ * values may describe a later screen while that overlay remains visible.
  */
-export type OverlayScreenState<TNavigation = unknown> = Omit<
-	OverlayProps<TNavigation>,
-	"progress"
-> & {
+export type OverlayProps<
+	TNavigation = unknown,
+	TParamList extends ParamListBase = ParamListBase,
+	TOwnerRouteName extends keyof TParamList = keyof TParamList,
+> = {
+	/** Route that declared this overlay. */
+	route: RouteProp<TParamList, TOwnerRouteName>;
+
+	/** Index of the route that declared this overlay. */
 	index: number;
-	snapTo: (index: number) => void;
-};
 
-export type OverlayProps<TNavigation = unknown> = {
 	/**
 	 * Route of the currently focused screen in the stack.
 	 */
-	focusedRoute: Route<string>;
+	focusedRoute: ParamListRoute<TParamList>;
 
 	/**
 	 * Index of the focused route in the stack.
@@ -32,7 +48,7 @@ export type OverlayProps<TNavigation = unknown> = {
 	/**
 	 * All routes currently in the stack.
 	 */
-	routes: Route<string>[];
+	routes: ParamListRoute<TParamList>[];
 
 	/**
 	 * Custom metadata from the focused screen's options.
@@ -55,3 +71,14 @@ export type OverlayProps<TNavigation = unknown> = {
 	 */
 	progress: DerivedValue<number>;
 };
+
+/**
+ * Component rendered for a floating screen overlay.
+ *
+ * The callback is bivariant because React Navigation stores overlay components
+ * in navigator-wide screen options while applications annotate them for one
+ * specific route.
+ */
+export type OverlayComponent = {
+	bivarianceHack(props: OverlayProps): ReactNode;
+}["bivarianceHack"];

package/src/types/providers/blank-stack-provider.types.ts

@@ -1,43 +1,33 @@
+import type {
+	BlankStackDescriptor,
+	BlankStackNavigationHelpers,
+} from "../blank-stack.types";
 import type {
 	BaseStackDescriptor,
-	BaseStackNavigation,
 	BaseStackRoute,
 	BaseStackScene,
 	BaseStackState,
-	StackDescriptorSource,
 } from "../stack.types";
 
-/**
- * Props for blank stack - generic over descriptor and navigation types.
- * Defaults to the shared base types.
- */
-export interface BlankStackProviderProps<
-	TDescriptor extends BaseStackDescriptor = BaseStackDescriptor,
-	TNavigation extends BaseStackNavigation = BaseStackNavigation,
-> {
-	state: BaseStackState<TDescriptor["route"]>;
-	navigation: TNavigation;
-	descriptors: Record<string, StackDescriptorSource<TDescriptor>>;
+export interface BlankStackProviderProps {
+	state: BaseStackState<BlankStackDescriptor["route"]>;
+	navigation: BlankStackNavigationHelpers;
+	descriptors: Record<string, BlankStackDescriptor>;
 	describe: (
-		route: TDescriptor["route"],
+		route: BlankStackDescriptor["route"],
 		placeholder: boolean,
-	) => StackDescriptorSource<TDescriptor>;
+	) => BlankStackDescriptor;
 }
 
-/**
- * Context value for blank stack — only fields unique to blank stack lifecycle.
- * Shared fields (routes, scenes, etc.) live in StackContext.
- */
-export interface BlankStackStoreValue<
-	TDescriptor extends BaseStackDescriptor = BaseStackDescriptor,
-> {
+export interface BlankStackStoreValue {
 	navigatorKey: string;
 	routeKeys: string[];
-	routes: TDescriptor["route"][];
-	scenes: BaseStackScene<TDescriptor>[];
-	scenesByKey: Record<string, BaseStackScene<TDescriptor>>;
+	routes: BaseStackRoute[];
+	scenes: BaseStackScene<BaseStackDescriptor>[];
+	scenesByKey: Record<string, BaseStackScene<BaseStackDescriptor>>;
+	paintDriverRouteKeyByRouteKey: ReadonlyMap<string, string>;
 	focusedIndex: number;
-	requestDismiss: (payload: { route: BaseStackRoute }) => boolean;
+	requestDismiss?: (payload: { route: BaseStackRoute }) => boolean;
 	shouldShowFloatOverlay: boolean;
-	handleCloseRoute: (payload: { route: BaseStackRoute }) => void;
+	handleCloseRoute?: (payload: { route: BaseStackRoute }) => void;
 }

package/src/types/screen.types.ts

@@ -6,12 +6,10 @@ import type {
 	TransitionSpec,
 } from "./animation.types";
 import type {
-	GestureActivationArea,
 	GestureDirectionOption,
-	GestureProgressMode,
 	ScrollMetadataState,
 } from "./gesture.types";
-import type { OverlayProps } from "./overlay.types";
+import type { OverlayComponent } from "./overlay.types";
 
 export type Layout = {
 	width: number;
@@ -43,6 +41,16 @@ export type ScreenKey = string;
 export type SheetScrollGestureBehavior =
 	| "expand-and-collapse"
 	| "collapse-only";
+
+/**
+ * Controls how a drag moves between configured {@linkcode ScreenTransitionConfig.snapPoints}.
+ *
+ * - `"continuous"` maps physical movement directly to global screen progress.
+ * - `"step"` maps each drag across one adjacent snap interval.
+ *
+ * @see {@linkcode ScreenTransitionConfig.sheetSnapBehavior}
+ */
+export type SheetSnapBehavior = "continuous" | "step";
 export type GestureTracking = "auto" | "never" | "always";
 
 /**
@@ -245,15 +253,6 @@ export type ScreenTransitionConfig = {
 	 */
 	gestureVelocityImpact?: number;
 
-	/**
-	 * How much velocity affects snap point targeting. Lower values make snapping
-	 * feel more deliberate (iOS-like), higher values make it more responsive to flicks.
-	 *
-	 * @deprecated Use `gestureSnapVelocityImpact` instead.
-	 * @default 0.1
-	 */
-	snapVelocityImpact?: number;
-
 	/**
 	 * How much velocity affects snap point targeting. Lower values make snapping
 	 * feel more deliberate (iOS-like), higher values make it more responsive to flicks.
@@ -266,65 +265,13 @@ export type ScreenTransitionConfig = {
 	 * Multiplies gesture release velocity used for gesture reset/handoff energy.
 	 *
 	 * This does NOT affect dismissal threshold decisions (`gestureVelocityImpact`)
-	 * or snap target selection (`snapVelocityImpact`). It changes the release
+	 * or snap target selection (`gestureSnapVelocityImpact`). It changes the release
 	 * impulse used by gesture values and interpolator handoff values.
 	 *
 	 * @default 1
 	 */
 	gestureReleaseVelocityScale?: number;
 
-	/**
-	 * Deprecated compatibility option.
-	 *
-	 * This option is no longer read by the runtime transition options. Use
-	 * `gestureReleaseVelocityScale` to tune post-release spring energy.
-	 *
-	 * @deprecated v3 compatibility only.
-	 */
-	gestureReleaseVelocityMax?: number;
-
-	/**
-	 * Deprecated compatibility option.
-	 *
-	 * Overrides the default edge-start distance when `gestureDirection` uses
-	 * `area: "edge"`. Prefer a numeric `area` on each `gestureDirection` entry.
-	 *
-	 * @example
-	 * gestureDirection: { gesture: "horizontal", area: 24 }
-	 *
-	 * @deprecated Use numeric `gestureDirection` entry `area` instead.
-	 */
-	gestureResponseDistance?: number;
-
-	/**
-	 * Deprecated compatibility option.
-	 *
-	 * Gesture movement now always contributes to `progress`. Use `transitionProgress`
-	 * in interpolators when you need transition progress without live gesture
-	 * contribution.
-	 *
-	 * @deprecated Use `transitionProgress` from interpolation state instead.
-	 */
-	gestureProgressMode?: GestureProgressMode;
-
-	/**
-	 * Deprecated compatibility alias for `gestureProgressMode`.
-	 *
-	 * Gesture movement now always contributes to `progress`. Use `transitionProgress`
-	 * in interpolators when you need transition progress without live gesture
-	 * contribution.
-	 *
-	 * @deprecated Use `transitionProgress` from interpolation state instead.
-	 */
-	gestureDrivesProgress?: boolean;
-
-	/**
-	 * The area of the screen where the gesture is activated.
-	 *
-	 * @deprecated Use `gestureDirection` entries with per-direction `area`.
-	 */
-	gestureActivationArea?: GestureActivationArea;
-
 	/**
 	 * Custom metadata passed through to animation props.
 	 *
@@ -336,7 +283,7 @@ export type ScreenTransitionConfig = {
 	/**
 	 * Function that returns a React Element to display as an overlay.
 	 */
-	overlay?: (props: OverlayProps) => React.ReactNode;
+	overlay?: OverlayComponent;
 
 	/**
 	 * Whether to show the overlay. The overlay is shown by default when `overlay` is provided.
@@ -407,13 +354,15 @@ export type ScreenTransitionConfig = {
 	sheetScrollGestureBehavior?: SheetScrollGestureBehavior;
 
 	/**
-	 * @deprecated Use `sheetScrollGestureBehavior` instead.
+	 * Controls how gesture movement maps between adjacent snap points.
+	 *
+	 * `"continuous"` preserves direct global progress and permits one gesture to
+	 * cross multiple snap points. `"step"` gives every adjacent interval a full
+	 * normalized drag range and limits the gesture to one snap-point step.
 	 *
-	 * Mapping:
-	 * - `true` -> `"expand-and-collapse"`
-	 * - `false` -> `"collapse-only"`
+	 * @default "continuous"
 	 */
-	expandViaScrollView?: boolean;
+	sheetSnapBehavior?: SheetSnapBehavior;
 
 	/**
 	 * Locks gesture-based snap movement to the current snap point.
@@ -478,8 +427,6 @@ export type ScreenTransitionConfig = {
 	 * a function component can receive `{ styles, props, pointerEvents, children }`
 	 * and decide how to render the layer.
 	 *
-	 * `contentComponent` replaces `surfaceComponent` for custom screen shells.
-	 *
 	 * @example
 	 * contentComponent: ({ styles, props, pointerEvents, children }) => (
 	 *   <AnimatedSquircleView
@@ -494,30 +441,4 @@ export type ScreenTransitionConfig = {
 	 * @default undefined
 	 */
 	contentComponent?: ScreenContentComponent;
-
-	/**
-	 * Custom component to render as the screen's surface layer.
-	 *
-	 * Renders inside the content animation scope (moves with the screen) as an
-	 * absolutely-positioned layer behind the screen's children.
-	 *
-	 * The library wraps this component with `Animated.createAnimatedComponent` internally.
-	 * Animated styles and props are driven by the `surface` slot in the interpolator return value.
-	 *
-	 * @example
-	 * surfaceComponent: SquircleView,
-	 * screenStyleInterpolator: ({ progress }) => {
-	 *   "worklet";
-	 *   return {
-	 *     surface: {
-	 *       style: { opacity: interpolate(progress, [0, 1], [0, 1]) },
-	 *       props: { cornerRadius: 24, cornerSmoothing: 0.7 },
-	 *     },
-	 *   };
-	 * }
-	 *
-	 * @default undefined
-	 * @deprecated Use `contentComponent` instead.
-	 */
-	surfaceComponent?: React.ComponentType<any>;
 };