react-native-screen-transitions 3.2.1 → 3.3.0-beta.0

package/lib/typescript/shared/types/animation.types.d.ts

@@ -151,7 +151,17 @@ export type TransitionInterpolatedStyle = {
      */
     contentStyle?: StyleProps;
     /**
-     * Animated style for a semi-transparent overlay. Styles are only applied when Transition.View is present.
+     * Animated style for the semi-transparent backdrop layer behind screen content.
+     *
+     * @example
+     * backdropStyle: {
+     *   backgroundColor: "black",
+     *   opacity: interpolate(progress, [0, 1], [0, 0.5]),
+     * }
+     */
+    backdropStyle?: StyleProps;
+    /**
+     * @deprecated Use `backdropStyle` instead. Will be removed in next major version.
      */
     overlayStyle?: StyleProps;
     /**
@@ -164,10 +174,26 @@ export type TransitionInterpolatedStyle = {
  */
 export type AnimationConfig = WithSpringConfig | WithTimingConfig;
 /**
- * Defines separate animation configurations for opening and closing a screen.
+ * Defines separate animation configurations for screen transitions and snap point changes.
  */
 export interface TransitionSpec {
+    /**
+     * Animation config for opening/entering a screen.
+     */
     open?: AnimationConfig;
+    /**
+     * Animation config for closing/exiting a screen.
+     */
     close?: AnimationConfig;
+    /**
+     * Animation config for expanding to a higher snap point.
+     * Uses lower intensity than `open` to match smaller movement distances.
+     */
+    expand?: AnimationConfig;
+    /**
+     * Animation config for collapsing to a lower snap point.
+     * Uses lower intensity than `close` to match smaller movement distances.
+     */
+    collapse?: AnimationConfig;
 }
 //# sourceMappingURL=animation.types.d.ts.map

package/lib/typescript/shared/types/animation.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation.types.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/animation.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,yBAAyB;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACR;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;IACF,MAAM,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC;;;;;;;OAOG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,OAAO,EAAE,aAAa,CAAC;IAEvB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACxC;;OAEG;IACH,QAAQ,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAE5C;;OAEG;IACH,OAAO,EAAE,qBAAqB,CAAC;IAE/B;;OAEG;IACH,IAAI,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAExC;;OAEG;IACH,OAAO,EAAE;QACR;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,qBAAqB,CAAC;IAE9B;;;OAGG;IACH,QAAQ,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAE5C;;;OAGG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,uBAAuB,GAAG,CACrC,KAAK,EAAE,wBAAwB,KAC3B,2BAA2B,CAAC;AAEjC,MAAM,MAAM,2BAA2B,GAAG;IACzC;;OAEG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,eAAe,CAAC;CACxB"}
+{"version":3,"file":"animation.types.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/animation.types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/shared/types/screen.types.d.ts

@@ -116,5 +116,31 @@ export type ScreenTransitionConfig = {
      * @default false
      */
     experimental_enableHighRefreshRate?: boolean;
+    /**
+     * Describes heights where a screen can rest, as fractions of screen height.
+     * Pass an array of ascending values from 0 to 1.
+     *
+     * @example
+     * snapPoints={[0.5, 1.0]} // 50% and 100% of screen height
+     *
+     * @default [1.0]
+     */
+    snapPoints?: number[];
+    /**
+     * The initial snap point index when the screen opens.
+     *
+     * @default 0
+     */
+    initialSnapIndex?: number;
+    /**
+     * Controls how touches interact with the backdrop area (outside the screen content).
+     *
+     * - `'block'`: Backdrop catches all touches (default for most screens)
+     * - `'passthrough'`: Touches pass through to content behind (default for component stacks)
+     * - `'dismiss'`: Tapping backdrop dismisses the screen
+     *
+     * @default 'block' (or 'passthrough' for component stacks)
+     */
+    backdropBehavior?: "block" | "passthrough" | "dismiss";
 };
 //# sourceMappingURL=screen.types.d.ts.map

package/lib/typescript/shared/types/screen.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen.types.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/screen.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EACX,uBAAuB,EACvB,cAAc,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IACvE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACpC;;OAEG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElD;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;IAEzD;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAE9C;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;IAEnD;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;OASG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;CAC7C,CAAC"}
+{"version":3,"file":"screen.types.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/screen.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EACX,uBAAuB,EACvB,cAAc,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IACvE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACpC;;OAEG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElD;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;IAEzD;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAE9C;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;IAEnD;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;OASG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAE7C;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAAC;CACvD,CAAC"}

package/lib/typescript/shared/utils/animation/animate-to-progress.d.ts

@@ -0,0 +1,19 @@
+import type { AnimationStoreMap } from "../../stores/animation.store";
+import type { TransitionSpec } from "../../types/animation.types";
+interface AnimateToProgressProps {
+    /**
+     * Target for the animation:
+     * - "open" = animate to progress 1
+     * - "close" = animate to progress 0
+     * - number = animate to specific progress value (e.g., 0.5 for snap point)
+     */
+    target: "open" | "close" | number;
+    spec?: TransitionSpec;
+    onAnimationFinish?: (finished: boolean) => void;
+    animations: AnimationStoreMap;
+    /** Optional initial velocity for spring-based progress (units: progress/sec). */
+    initialVelocity?: number;
+}
+export declare const animateToProgress: ({ target, spec, onAnimationFinish, animations, initialVelocity, }: AnimateToProgressProps) => void;
+export {};
+//# sourceMappingURL=animate-to-progress.d.ts.map

package/lib/typescript/shared/utils/animation/animate-to-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate-to-progress.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/animation/animate-to-progress.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,UAAU,sBAAsB;IAC/B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,UAAU,EAAE,iBAAiB,CAAC;IAC9B,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,iBAAiB,GAAI,mEAM/B,sBAAsB,SAmDxB,CAAC"}

package/lib/typescript/shared/utils/gesture/check-gesture-activation.d.ts

@@ -82,5 +82,29 @@ export declare function shouldActivateOrFail(params: ShouldActivateOrFailProps):
  * Since we're using onTouchesMove to activate our pan, faillOffset and activateOffset don't actually work. In that case we'll create this function to use in onTouchesMove which acts simarly to the original functionality.
  */
 export declare const applyOffsetRules: ({ initialTouch, touch, directions, manager, gestureOffsetState, activationArea, dimensions, responseDistance, }: CheckGestureActivationProps) => ReturnValues;
+interface ScrollAwareActivationParams {
+    swipeInfo: {
+        isSwipingDown: boolean;
+        isSwipingUp: boolean;
+        isSwipingRight: boolean;
+        isSwipingLeft: boolean;
+    };
+    directions: Directions;
+    scrollX: number;
+    scrollY: number;
+    maxScrollX: number;
+    maxScrollY: number;
+    hasSnapPoints?: boolean;
+    canExpandMore?: boolean;
+}
+type GestureDirection = "vertical" | "vertical-inverted" | "horizontal" | "horizontal-inverted";
+/**
+ * Checks if a gesture should activate based on scroll position.
+ * Returns the direction to activate for, or null if activation should not occur.
+ */
+export declare function checkScrollAwareActivation({ swipeInfo, directions, scrollX, scrollY, maxScrollX, maxScrollY, hasSnapPoints, canExpandMore, }: ScrollAwareActivationParams): {
+    shouldActivate: boolean;
+    direction: GestureDirection | null;
+};
 export {};
 //# sourceMappingURL=check-gesture-activation.d.ts.map

package/lib/typescript/shared/utils/gesture/check-gesture-activation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-gesture-activation.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/check-gesture-activation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mFAAmF,CAAC;AACjI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,kBAAkB,EAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,KAAK,UAAU,GAAG;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,UAAU,2BAA2B;IACpC,YAAY,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,kBAAkB,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACpD,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,KAAK,eAAe,GAAG;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF,UAAU,yBAAyB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,YAAY;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CACvB;AAaD,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,eAAe,CAc5E;AAED,wBAAgB,sBAAsB,CACrC,YAAY,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACtC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,eAAe,EACtB,gBAAgB,CAAC,EAAE,MAAM;;;;;EAczB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;EAmBhE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,yBAAyB;;;EAyFrE;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,iHAS9B,2BAA2B,KAAG,YA2EhC,CAAC"}
+{"version":3,"file":"check-gesture-activation.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/check-gesture-activation.ts"],"names":[],"mappings":"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"}

package/lib/typescript/shared/utils/gesture/determine-snap-target.d.ts

@@ -0,0 +1,26 @@
+interface DetermineSnapTargetProps {
+    currentProgress: number;
+    snapPoints: number[];
+    /** Velocity along the snap axis (positive = toward dismiss) */
+    velocity: number;
+    /** Screen dimension along the snap axis (width or height) */
+    dimension: number;
+    /** How much velocity affects the snap decision (0-1). Default 0.15 */
+    velocityFactor?: number;
+    /** Whether dismiss (progress=0) is allowed. Default true */
+    canDismiss?: boolean;
+}
+interface DetermineSnapTargetResult {
+    targetProgress: number;
+    shouldDismiss: boolean;
+}
+/**
+ * Determines which snap point to animate to based on current progress and velocity.
+ *
+ * Logic: Snap to whichever point is closest, factoring in velocity.
+ * The "zones" between snap points are split at midpoints.
+ * Velocity can push you into the next zone.
+ */
+export declare function determineSnapTarget({ currentProgress, snapPoints, velocity, dimension, velocityFactor, canDismiss, }: DetermineSnapTargetProps): DetermineSnapTargetResult;
+export {};
+//# sourceMappingURL=determine-snap-target.d.ts.map

package/lib/typescript/shared/utils/gesture/determine-snap-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"determine-snap-target.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/determine-snap-target.ts"],"names":[],"mappings":"AAAA,UAAU,wBAAwB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,yBAAyB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EACnC,eAAe,EACf,UAAU,EACV,QAAQ,EACR,SAAS,EACT,cAAqB,EACrB,UAAiB,GACjB,EAAE,wBAAwB,GAAG,yBAAyB,CA0CtD"}

package/lib/typescript/shared/utils/gesture/validate-snap-points.d.ts

@@ -0,0 +1,13 @@
+interface ValidateSnapPointsResult {
+    hasSnapPoints: boolean;
+    snapPoints: number[];
+    minSnapPoint: number;
+    maxSnapPoint: number;
+}
+interface ValidateSnapPointsOptions {
+    snapPoints?: number[];
+    canDismiss?: boolean;
+}
+export declare const validateSnapPoints: ({ snapPoints, canDismiss, }: ValidateSnapPointsOptions) => ValidateSnapPointsResult;
+export {};
+//# sourceMappingURL=validate-snap-points.d.ts.map

package/lib/typescript/shared/utils/gesture/validate-snap-points.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-snap-points.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/validate-snap-points.ts"],"names":[],"mappings":"AAAA,UAAU,wBAAwB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,yBAAyB;IAClC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,kBAAkB,GAAI,6BAGhC,yBAAyB,KAAG,wBAqB9B,CAAC"}

package/lib/typescript/shared/utils/gesture/velocity.d.ts

@@ -17,6 +17,7 @@ interface CalculateProgressProps {
 }
 export declare const velocity: {
     normalize: (velocityPixelsPerSecond: number, screenSize: number) => number;
+    normalizeTranslation: (translation: number, dimension: number) => number;
     calculateRestoreVelocity: (currentValueNormalized: number, baseVelocityNormalized: number) => number;
     calculateProgressVelocity: ({ animations, shouldDismiss, event, dimensions, directions, }: CalculateProgressProps) => number;
     shouldPassDismissalThreshold: (translationPixels: number, velocityPixelsPerSecond: number, screenSize: number, velocityWeight: number) => boolean;

package/lib/typescript/shared/utils/gesture/velocity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"velocity.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/velocity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EACvB,6BAA6B,EAC7B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,UAAU,sBAAsB;IAC/B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,uBAAuB,CAAC,6BAA6B,CAAC,CAAC;IAC9D,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,UAAU,EAAE;QACX,UAAU,EAAE,OAAO,CAAC;QACpB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC;QAClB,gBAAgB,EAAE,OAAO,CAAC;KAC1B,CAAC;CACF;AAuHD,eAAO,MAAM,QAAQ;yCA9GuB,MAAM,cAAc,MAAM;uDAc7C,MAAM,0BACN,MAAM;+FAkB5B,sBAAsB;sDAyDL,MAAM,2BACA,MAAM,cACnB,MAAM,kBACF,MAAM;CAsBtB,CAAC"}
+{"version":3,"file":"velocity.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/velocity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EACvB,6BAA6B,EAC7B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,UAAU,sBAAsB;IAC/B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,uBAAuB,CAAC,6BAA6B,CAAC,CAAC;IAC9D,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,UAAU,EAAE;QACX,UAAU,EAAE,OAAO,CAAC;QACpB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC;QAClB,gBAAgB,EAAE,OAAO,CAAC;KAC1B,CAAC;CACF;AAgID,eAAO,MAAM,QAAQ;yCAvHuB,MAAM,cAAc,MAAM;wCAa3B,MAAM,aAAa,MAAM;uDAU3C,MAAM,0BACN,MAAM;+FAkB5B,sBAAsB;sDAyDL,MAAM,2BACA,MAAM,cACnB,MAAM,kBACF,MAAM;CAuBtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-screen-transitions",
-  "version": "3.2.1",
+  "version": "3.3.0-beta.0",
   "description": "Easy screen transitions for React Native and Expo",
   "author": "Ed",
   "license": "MIT",
@@ -44,7 +44,8 @@
     "lint": "biome check ./src",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "bun run build",
-    "release": "release-it"
+    "release": "release-it",
+    "release:beta": "release-it --preRelease=beta"
   },
   "keywords": [
     "react-native",

package/src/shared/__tests__/determine-snap-target.test.ts

@@ -0,0 +1,268 @@
+import { describe, expect, it } from "bun:test";
+import { determineSnapTarget } from "../utils/gesture/determine-snap-target";
+
+describe("determineSnapTarget", () => {
+	const dimension = 800; // screen height
+	const snapPoints = [0.3, 0.6, 1]; // 3 snap points
+
+	describe("basic snapping without velocity", () => {
+		it("snaps to nearest snap point when exactly at a snap point", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.6,
+				snapPoints,
+				velocity: 0,
+				dimension,
+			});
+			expect(result.targetProgress).toBe(0.6);
+			expect(result.shouldDismiss).toBe(false);
+		});
+
+		it("snaps to lower snap point when below midpoint", () => {
+			// Midpoint between 0.3 and 0.6 is 0.45
+			const result = determineSnapTarget({
+				currentProgress: 0.4,
+				snapPoints,
+				velocity: 0,
+				dimension,
+			});
+			expect(result.targetProgress).toBe(0.3);
+		});
+
+		it("snaps to higher snap point when above midpoint", () => {
+			// Midpoint between 0.3 and 0.6 is 0.45
+			const result = determineSnapTarget({
+				currentProgress: 0.5,
+				snapPoints,
+				velocity: 0,
+				dimension,
+			});
+			expect(result.targetProgress).toBe(0.6);
+		});
+
+		it("snaps to highest point when above all snap points", () => {
+			const result = determineSnapTarget({
+				currentProgress: 1.2,
+				snapPoints,
+				velocity: 0,
+				dimension,
+			});
+			expect(result.targetProgress).toBe(1);
+		});
+	});
+
+	describe("velocity influence", () => {
+		it("velocity toward dismiss pushes toward lower snap point", () => {
+			// At 0.5 (above midpoint 0.45), normally would snap to 0.6
+			// But positive velocity (toward dismiss) should push toward 0.3
+			const result = determineSnapTarget({
+				currentProgress: 0.5,
+				snapPoints,
+				velocity: 800, // Strong velocity toward dismiss
+				dimension,
+				velocityFactor: 0.15,
+			});
+			expect(result.targetProgress).toBe(0.3);
+		});
+
+		it("velocity toward expand pushes toward higher snap point", () => {
+			// At 0.4 (below midpoint 0.45), normally would snap to 0.3
+			// But negative velocity (toward expand) should push toward 0.6
+			const result = determineSnapTarget({
+				currentProgress: 0.4,
+				snapPoints,
+				velocity: -800, // Strong velocity toward expand
+				dimension,
+				velocityFactor: 0.15,
+			});
+			expect(result.targetProgress).toBe(0.6);
+		});
+
+		it("weak velocity does not override position", () => {
+			// At 0.55 (above midpoint), weak velocity shouldn't change target
+			const result = determineSnapTarget({
+				currentProgress: 0.55,
+				snapPoints,
+				velocity: 100, // Weak velocity
+				dimension,
+				velocityFactor: 0.15,
+			});
+			expect(result.targetProgress).toBe(0.6);
+		});
+
+		it("respects custom velocityFactor", () => {
+			// Higher velocityFactor = velocity has more influence
+			const result = determineSnapTarget({
+				currentProgress: 0.5,
+				snapPoints,
+				velocity: 400,
+				dimension,
+				velocityFactor: 0.5, // High factor
+			});
+			expect(result.targetProgress).toBe(0.3);
+		});
+	});
+
+	describe("dismiss behavior", () => {
+		it("allows dismiss when canDismiss is true and near 0", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.1,
+				snapPoints,
+				velocity: 500,
+				dimension,
+				canDismiss: true,
+			});
+			expect(result.targetProgress).toBe(0);
+			expect(result.shouldDismiss).toBe(true);
+		});
+
+		it("prevents dismiss when canDismiss is false", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.1,
+				snapPoints,
+				velocity: 1000, // Strong dismiss velocity
+				dimension,
+				canDismiss: false,
+			});
+			expect(result.targetProgress).toBe(0.3); // First snap point
+			expect(result.shouldDismiss).toBe(false);
+		});
+
+		it("defaults canDismiss to true", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.1,
+				snapPoints,
+				velocity: 500,
+				dimension,
+			});
+			expect(result.shouldDismiss).toBe(true);
+		});
+
+		it("shouldDismiss is false when snapping to any snap point", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.5,
+				snapPoints,
+				velocity: 0,
+				dimension,
+			});
+			expect(result.shouldDismiss).toBe(false);
+		});
+	});
+
+	describe("edge cases", () => {
+		it("handles single snap point", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.3,
+				snapPoints: [0.5],
+				velocity: 0,
+				dimension,
+			});
+			expect(result.targetProgress).toBe(0.5);
+		});
+
+		it("handles unsorted snap points", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.5,
+				snapPoints: [1, 0.3, 0.6], // Unsorted
+				velocity: 0,
+				dimension,
+			});
+			// After sorting: [0.3, 0.6, 1], midpoint 0.3-0.6 is 0.45
+			expect(result.targetProgress).toBe(0.6);
+		});
+
+		it("handles progress at exactly 0", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0,
+				snapPoints,
+				velocity: 0,
+				dimension,
+				canDismiss: true,
+			});
+			expect(result.targetProgress).toBe(0);
+			expect(result.shouldDismiss).toBe(true);
+		});
+
+		it("handles negative progress", () => {
+			const result = determineSnapTarget({
+				currentProgress: -0.1,
+				snapPoints,
+				velocity: 0,
+				dimension,
+				canDismiss: true,
+			});
+			expect(result.targetProgress).toBe(0);
+		});
+
+		it("handles very high velocity", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.9,
+				snapPoints,
+				velocity: 5000, // Very high velocity
+				dimension,
+				canDismiss: true,
+			});
+			expect(result.targetProgress).toBe(0);
+			expect(result.shouldDismiss).toBe(true);
+		});
+
+		it("handles snap points not starting at typical values", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.7,
+				snapPoints: [0.5, 0.75, 1],
+				velocity: 0,
+				dimension,
+			});
+			// Midpoint between 0.5 and 0.75 is 0.625
+			// 0.7 is above 0.625, so should snap to 0.75
+			expect(result.targetProgress).toBe(0.75);
+		});
+
+		it("handles two snap points", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.4,
+				snapPoints: [0.3, 1],
+				velocity: 0,
+				dimension,
+			});
+			// Midpoint is 0.65, 0.4 is below, so snap to 0.3
+			expect(result.targetProgress).toBe(0.3);
+		});
+	});
+
+	describe("zone boundaries", () => {
+		it("snaps to higher at exact midpoint (uses < not <=)", () => {
+			// Midpoint between 0 and 0.3 is 0.15
+			// The algorithm uses `<` so at exact midpoint, it snaps to higher
+			const result = determineSnapTarget({
+				currentProgress: 0.15,
+				snapPoints,
+				velocity: 0,
+				dimension,
+				canDismiss: true,
+			});
+			expect(result.targetProgress).toBe(0.3);
+		});
+
+		it("snaps to lower just below midpoint", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.149,
+				snapPoints,
+				velocity: 0,
+				dimension,
+				canDismiss: true,
+			});
+			expect(result.targetProgress).toBe(0);
+		});
+
+		it("snaps to higher just above midpoint", () => {
+			const result = determineSnapTarget({
+				currentProgress: 0.151,
+				snapPoints,
+				velocity: 0,
+				dimension,
+				canDismiss: true,
+			});
+			expect(result.targetProgress).toBe(0.3);
+		});
+	});
+});