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

package/src/types/animation.types.ts

@@ -29,6 +29,7 @@ export type ScreenTransitionOptions = Pick<
 	| "gestureSnapVelocityImpact"
 	| "gestureReleaseVelocityScale"
 	| "gestureSnapLocked"
+	| "sheetSnapBehavior"
 	| "sheetScrollGestureBehavior"
 	| "backdropBehavior"
 >;
@@ -344,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. */
@@ -376,8 +375,6 @@ export type TransitionInterpolatedStyle = {
 	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/index.ts

@@ -61,6 +61,7 @@ export type {
 	ScreenKey,
 	ScreenLayerComponentProps,
 	ScreenTransitionConfig,
+	SheetSnapBehavior,
 	TransitionAwareProps,
 } from "./screen.types";
 export type {

package/src/types/screen.types.ts

@@ -41,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";
 
 /**
@@ -343,6 +353,17 @@ export type ScreenTransitionConfig = {
 	 */
 	sheetScrollGestureBehavior?: SheetScrollGestureBehavior;
 
+	/**
+	 * 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.
+	 *
+	 * @default "continuous"
+	 */
+	sheetSnapBehavior?: SheetSnapBehavior;
+
 	/**
 	 * Locks gesture-based snap movement to the current snap point.
 	 *