react-native-screen-transitions 3.6.0-alpha.2 → 3.6.0-alpha.4

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

@@ -3,6 +3,7 @@ import { NAVIGATION_MASK_CONTAINER_STYLE_ID, NAVIGATION_MASK_ELEMENT_STYLE_ID }
 import type { MeasuredEntry } from "../stores/bounds";
 import type { BoundId, BoundsOptions, BoundsOptionsResult } from "../utils/bounds/types/options";
 import type { ScreenInterpolationProps, TransitionInterpolatedStyle, TransitionSlotStyle } from "./animation.types";
+import type { GestureProgressMode } from "./gesture.types";
 /**
  * Target style computation.
  * - "transform": translates and scales (scaleX/scaleY), no width/height size
@@ -141,10 +142,77 @@ export type BoundsNavigationZoomStyle = TransitionInterpolatedStyle & {
     [NAVIGATION_MASK_CONTAINER_STYLE_ID]?: TransitionSlotStyle;
     [NAVIGATION_MASK_ELEMENT_STYLE_ID]?: TransitionSlotStyle;
 };
+export type BoundsNavigationRevealOptions = {
+    /**
+     * Destination mask border radius.
+     *
+     * Reveal interpolates from the measured source border radius to this value.
+     *
+     * @default Platform-specific reveal radius
+     */
+    borderRadius?: number;
+    /**
+     * Whether the reveal mask should use React Native's continuous border curve.
+     *
+     * @default true
+     */
+    borderContinuous?: boolean;
+    /**
+     * Maximum dynamic gesture sensitivity applied by reveal.
+     *
+     * Reveal lowers gesture sensitivity as the drag gets deeper so the masked
+     * container can keep its source-to-destination handoff stable. This value
+     * controls the starting/highest sensitivity in that curve.
+     *
+     * @default 0.8
+     */
+    maxSensitivity?: number;
+    /**
+     * Velocity-driven depth applied to the dismiss scale handoff.
+     *
+     * Higher values make fast releases orbit farther around the final source
+     * scale. Set to `0` to remove the velocity depth effect.
+     *
+     * @default 0.5
+     */
+    velocityDepth?: number;
+    /**
+     * Whether gesture displacement should drive transition progress or remain as
+     * freeform gesture values. Reveal defaults to `"freeform"` so drag can move
+     * the masked container without owning the whole screen progress.
+     *
+     * @default "freeform"
+     */
+    gestureProgressMode?: GestureProgressMode;
+    /**
+     * Temporarily blocks pointer-event pass-through on the inactive content until
+     * the source element transition handoff reaches progress `0.25`.
+     *
+     * This is intentional and most users cannot react fast enough to swipe during
+     * that brief handoff. If it becomes an issue, set this to `false` to disable
+     * the guard and keep the default behavior that allows pointer events to pass
+     * through.
+     *
+     * @default true
+     */
+    disablePointerEventsTillElementTransition?: boolean;
+    /**
+     * How reveal should resize the navigation mask element.
+     *
+     * `"auto"` uses the platform default. Android defaults to transform-based
+     * resizing to avoid masked-size animation cost, while other platforms animate
+     * width and height. Transform-based resizing can make large border radii look
+     * less natural on Android; use `"size"` to force width/height animation when
+     * radius quality is more important than that optimization.
+     *
+     * @default "auto"
+     */
+    maskSizingMode?: "auto" | "transform" | "size";
+};
 export type BoundsNavigationRevealStyle = BoundsNavigationZoomStyle;
 export type BoundsNavigationAccessor = {
     zoom: (options?: BoundsNavigationZoomOptions) => BoundsNavigationZoomStyle;
-    reveal: () => BoundsNavigationRevealStyle;
+    reveal: (options?: BoundsNavigationRevealOptions) => BoundsNavigationRevealStyle;
 };
 type BoundsBoundNavigationAccessor = {
     navigation: BoundsNavigationAccessor;

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

@@ -1 +1 @@
-{"version":3,"file":"bounds.types.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/bounds.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bounds.types.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/bounds.types.ts"],"names":[],"mappings":"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"}

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

@@ -1,8 +1,8 @@
 export { FALSE, TRUE } from "../constants";
 export type { AnimatedViewStyle, AnimationConfig, ScreenInterpolationProps, ScreenStyleInterpolator, ScreenTransitionOptions, ScreenTransitionState, TransitionInterpolatedStyle, TransitionInterpolatorOptions, TransitionSlotStyle, TransitionSpec, } from "./animation.types";
-export type { BoundsAccessor, BoundsMethod, BoundsNavigationAccessor, BoundsNavigationRevealStyle, BoundsNavigationZoomOpacityRange, BoundsNavigationZoomOpacityRanges, BoundsNavigationZoomOptions, BoundsNavigationZoomStyle, } from "./bounds.types";
+export type { BoundsAccessor, BoundsMethod, BoundsNavigationAccessor, BoundsNavigationRevealOptions, BoundsNavigationRevealStyle, BoundsNavigationZoomOpacityRange, BoundsNavigationZoomOpacityRanges, BoundsNavigationZoomOptions, BoundsNavigationZoomStyle, } from "./bounds.types";
 export type { ActivationArea, GestureActivationArea, GestureDirection, GestureValues, PanGestureDirection, PinchGestureDirection, SideActivation, } from "./gesture.types";
 export type { OverlayProps } from "./overlay.types";
-export type { Layout, ScreenKey, ScreenTransitionConfig, TransitionAwareProps, } from "./screen.types";
+export type { GestureTracking, Layout, ScreenKey, ScreenTransitionConfig, TransitionAwareProps, } from "./screen.types";
 export type { BaseStackDescriptor, BaseStackNavigation, BaseStackRoute, BaseStackScene, BaseStackState, DescriptorMap, } from "./stack.types";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EACX,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,mBAAmB,EACnB,cAAc,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACX,cAAc,EACd,YAAY,EACZ,wBAAwB,EACxB,2BAA2B,EAC3B,gCAAgC,EAChC,iCAAiC,EACjC,2BAA2B,EAC3B,yBAAyB,GACzB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACX,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EACX,MAAM,EACN,SAAS,EACT,sBAAsB,EACtB,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,GACb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EACX,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,mBAAmB,EACnB,cAAc,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACX,cAAc,EACd,YAAY,EACZ,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAChC,iCAAiC,EACjC,2BAA2B,EAC3B,yBAAyB,GACzB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACX,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EACX,eAAe,EACf,MAAM,EACN,SAAS,EACT,sBAAsB,EACtB,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,GACb,MAAM,eAAe,CAAC"}

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

@@ -18,16 +18,10 @@ export type ScreenLayouts = {
      * auto snap-point sizing. It is undefined until a real measurement exists.
      */
     content?: Layout;
-    /**
-     * Whether navigation bounds masking is enabled for this screen.
-     *
-     * When enabled, navigation zoom helpers target the masked container path
-     * instead of the plain content slot.
-     */
-    navigationMaskEnabled: boolean;
 };
 export type ScreenKey = string;
 export type SheetScrollGestureBehavior = "expand-and-collapse" | "collapse-only";
+export type GestureTracking = "auto" | "never" | "always";
 /**
  * A single snap point value. Either a fraction of screen height (0–1) or
  * `'auto'` to snap to the intrinsic height of the screen content.
@@ -115,21 +109,17 @@ export type ScreenTransitionConfig = {
      */
     gestureEnabled?: boolean;
     /**
-     * Allows screens with `gestureEnabled={false}` to still activate gestures for
-     * live gesture values while preventing gesture dismissal.
-     *
-     * This is a v3 compatibility bridge for the next gesture behavior. Direction
-     * ownership/claims participate while this is enabled so nested screens can
-     * intentionally shadow parent gestures for resistance-style animations.
+     * Controls whether the screen tracks live gesture values.
      *
-     * Screens with `snapPoints` already keep gesture tracking when
-     * `gestureEnabled={false}`; this flag mainly affects disabled non-snap
-     * gestures.
+     * - `"auto"` tracks gestures when dismissal is enabled, or when snap points
+     *   can move without dismissal.
+     * - `"never"` disables gesture tracking for the screen.
+     * - `"always"` keeps tracking live gesture values even when
+     *   `gestureEnabled` is `false`, without allowing dismiss.
      *
-     * @experimental This API may change in future versions.
-     * @default false
+     * @default "auto"
      */
-    experimental_allowDisabledGestureTracking?: boolean;
+    gestureTracking?: GestureTracking;
     /**
      * The direction(s) of the screen gesture used to dismiss the screen.
      *
@@ -177,15 +167,12 @@ export type ScreenTransitionConfig = {
      */
     gestureReleaseVelocityScale?: number;
     /**
-     * Caps the absolute post-scale release velocity used by spring animations.
+     * Deprecated compatibility option.
      *
-     * This does NOT affect dismissal threshold decisions (`gestureVelocityImpact`)
-     * or snap target selection (`snapVelocityImpact`). It only bounds release
-     * animation intensity after `gestureReleaseVelocityScale` is applied.
+     * This option is no longer read by the runtime transition options. Use
+     * `gestureReleaseVelocityScale` to tune post-release spring energy.
      *
-     * @deprecated v3 compatibility only. This option is removed in the next
-     * gesture runtime.
-     * @default 3.2
+     * @deprecated v3 compatibility only.
      */
     gestureReleaseVelocityMax?: number;
     /**

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":"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"}
+{"version":3,"file":"screen.types.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/screen.types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/shared/utils/bounds/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/bounds/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,wBAAwB,EAExB,MAAM,0BAA0B,CAAC;AAKlC,eAAO,MAAM,oBAAoB,GAChC,UAAU,MAAM,wBAAwB,KACtC,cA8BF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/bounds/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,wBAAwB,EAGxB,MAAM,0BAA0B,CAAC;AAKlC,eAAO,MAAM,oBAAoB,GAChC,UAAU,MAAM,wBAAwB,KACtC,cA+BF,CAAC"}

package/lib/typescript/shared/utils/bounds/navigation/reveal/build.d.ts

@@ -1,3 +1,3 @@
 import type { BuildRevealStylesParams, RevealInterpolatedStyle } from "./types";
-export declare function buildRevealStyles({ tag, props, }: BuildRevealStylesParams): RevealInterpolatedStyle;
+export declare function buildRevealStyles({ tag, props, revealOptions, }: BuildRevealStylesParams): RevealInterpolatedStyle;
 //# sourceMappingURL=build.d.ts.map

package/lib/typescript/shared/utils/bounds/navigation/reveal/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../../../../src/shared/utils/bounds/navigation/reveal/build.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAMhF,wBAAgB,iBAAiB,CAAC,EACjC,GAAG,EACH,KAAK,GACL,EAAE,uBAAuB,GAAG,uBAAuB,CAoZnD"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../../../../src/shared/utils/bounds/navigation/reveal/build.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAMhF,wBAAgB,iBAAiB,CAAC,EACjC,GAAG,EACH,KAAK,EACL,aAAa,GACb,EAAE,uBAAuB,GAAG,uBAAuB,CAibnD"}

package/lib/typescript/shared/utils/bounds/navigation/reveal/math.d.ts

@@ -11,15 +11,25 @@ export declare function resolveUniformScale({ sourceWidth, sourceHeight, destina
     destinationWidth: number;
     destinationHeight: number;
 }): number;
-export declare function resolveRevealGestureHandoff(rawDrag: number): {
+export declare function resolveRevealGestureHandoff({ rawDrag, maxSensitivity, }: {
+    rawDrag: number;
+    maxSensitivity: number;
+}): {
     gestureSensitivity: number;
     gestureReleaseVelocityScale: number;
 };
-export declare function resolveDismissScaleHandoff({ progress, releaseScale, targetScale, velocity, }: {
+export declare function resolveDismissScaleHandoff({ progress, releaseScale, targetScale, velocity, velocityDepth, }: {
     progress: number;
     releaseScale: number;
     targetScale: number;
     velocity: number;
+    velocityDepth: number;
+}): number;
+export declare function resolveAspectRatioMaskHeight({ maskWidth, maskHeight, targetWidth, targetHeight, }: {
+    maskWidth: number;
+    maskHeight: number;
+    targetWidth: number;
+    targetHeight: number;
 }): number;
 export declare function resolveRevealContentBaseTransform({ progress, sourceBounds, destinationBounds, screenLayout, }: {
     progress: number;

package/lib/typescript/shared/utils/bounds/navigation/reveal/math.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../../../../../src/shared/utils/bounds/navigation/reveal/math.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAc7D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAGjE;AAED,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,UAQjB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,UAG7C;AAED,eAAO,MAAM,0BAA0B,GACtC,aAAa,MAAM,EACnB,WAAW,MAAM,WAejB,CAAC;AAEF,wBAAgB,iCAAiC,CAChD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,UAajB;AAED,wBAAgB,mBAAmB,CAAC,EACnC,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GACjB,EAAE;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC1B,UAWA;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM;;;EAoB1D;AAED,wBAAgB,0BAA0B,CAAC,EAC1C,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,QAAQ,GACR,EAAE;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB,UAWA;AAYD,wBAAgB,iCAAiC,CAAC,EACjD,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACZ,EAAE;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,kBAAkB,CAAC;IACjC,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;CACrB;;;;EAgBA;AAED,wBAAgB,oCAAoC,CAAC,EACpD,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,GACZ,EAAE;IACF,YAAY,EAAE,kBAAkB,CAAC;IACjC,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACrB;;;;;EAuCA"}
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../../../../../src/shared/utils/bounds/navigation/reveal/math.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAa7D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAGjE;AAED,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,UAQjB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,UAG7C;AAED,eAAO,MAAM,0BAA0B,GACtC,aAAa,MAAM,EACnB,WAAW,MAAM,WAejB,CAAC;AAEF,wBAAgB,iCAAiC,CAChD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,UAajB;AAED,wBAAgB,mBAAmB,CAAC,EACnC,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GACjB,EAAE;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC1B,UAWA;AAED,wBAAgB,2BAA2B,CAAC,EAC3C,OAAO,EACP,cAAc,GACd,EAAE;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACvB;;;EAoBA;AAED,wBAAgB,0BAA0B,CAAC,EAC1C,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,aAAa,GACb,EAAE;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACtB,UAWA;AAED,wBAAgB,4BAA4B,CAAC,EAC5C,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,GACZ,EAAE;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACrB,UAWA;AAYD,wBAAgB,iCAAiC,CAAC,EACjD,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACZ,EAAE;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,kBAAkB,CAAC;IACjC,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;CACrB;;;;EAgBA;AAED,wBAAgB,oCAAoC,CAAC,EACpD,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,GACZ,EAAE;IACF,YAAY,EAAE,kBAAkB,CAAC;IACjC,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACrB;;;;;EAuCA"}

package/lib/typescript/shared/utils/bounds/navigation/reveal/types.d.ts

@@ -1,5 +1,5 @@
 import { NAVIGATION_MASK_CONTAINER_STYLE_ID, NAVIGATION_MASK_ELEMENT_STYLE_ID } from "../../../../constants";
-import type { BoundsInterpolationProps, BoundsNavigationRevealStyle } from "../../../../types/bounds.types";
+import type { BoundsInterpolationProps, BoundsNavigationRevealOptions, BoundsNavigationRevealStyle } from "../../../../types/bounds.types";
 export type RevealInterpolatedStyle = BoundsNavigationRevealStyle & {
     [NAVIGATION_MASK_CONTAINER_STYLE_ID]?: BoundsNavigationRevealStyle[typeof NAVIGATION_MASK_CONTAINER_STYLE_ID];
     [NAVIGATION_MASK_ELEMENT_STYLE_ID]?: BoundsNavigationRevealStyle[typeof NAVIGATION_MASK_ELEMENT_STYLE_ID];
@@ -7,5 +7,6 @@ export type RevealInterpolatedStyle = BoundsNavigationRevealStyle & {
 export type BuildRevealStylesParams = {
     tag?: string;
     props: BoundsInterpolationProps;
+    revealOptions?: BoundsNavigationRevealOptions;
 };
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/shared/utils/bounds/navigation/reveal/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/shared/utils/bounds/navigation/reveal/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,kCAAkC,EAClC,gCAAgC,EAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACX,wBAAwB,EACxB,2BAA2B,EAC3B,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,GAAG;IACnE,CAAC,kCAAkC,CAAC,CAAC,EAAE,2BAA2B,CAAC,OAAO,kCAAkC,CAAC,CAAC;IAC9G,CAAC,gCAAgC,CAAC,CAAC,EAAE,2BAA2B,CAAC,OAAO,gCAAgC,CAAC,CAAC;CAC1G,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,wBAAwB,CAAC;CAChC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/shared/utils/bounds/navigation/reveal/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,kCAAkC,EAClC,gCAAgC,EAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACX,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,GAAG;IACnE,CAAC,kCAAkC,CAAC,CAAC,EAAE,2BAA2B,CAAC,OAAO,kCAAkC,CAAC,CAAC;IAC9G,CAAC,gCAAgC,CAAC,CAAC,EAAE,2BAA2B,CAAC,OAAO,gCAAgC,CAAC,CAAC;CAC1G,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,wBAAwB,CAAC;IAChC,aAAa,CAAC,EAAE,6BAA6B,CAAC;CAC9C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "react-native-screen-transitions",
-	"version": "3.6.0-alpha.2",
+	"version": "3.6.0-alpha.4",
 	"description": "Easy screen transitions for React Native and Expo",
 	"author": "Ed",
 	"license": "MIT",
@@ -78,8 +78,9 @@
 	},
 	"devDependencies": {
 		"@testing-library/react-native": "13.3.3",
-		"@types/react": "~19.1.10",
-		"react-native-builder-bob": "0.39.0",
+		"@types/react": "~19.1.0",
+		"react-native-builder-bob": "0.41.0",
+		"react-test-renderer": "19.1.0",
 		"typescript": "catalog:"
 	},
 	"react-native-builder-bob": {

package/src/shared/constants.ts

@@ -9,7 +9,11 @@ import type {
 	ActivationArea,
 	GestureProgressMode,
 } from "./types/gesture.types";
-import type { Layout, SheetScrollGestureBehavior } from "./types/screen.types";
+import type {
+	GestureTracking,
+	Layout,
+	SheetScrollGestureBehavior,
+} from "./types/screen.types";
 import type { BaseStackRoute } from "./types/stack.types";
 
 /**
@@ -79,7 +83,6 @@ export const DEFAULT_SCREEN_TRANSITION_OPTIONS: ScreenTransitionOptions =
 export const createScreenTransitionState = (
 	route: BaseStackRoute,
 	meta?: Record<string, unknown>,
-	navigationMaskEnabled = false,
 	options: ScreenTransitionOptions = DEFAULT_SCREEN_TRANSITION_OPTIONS,
 ): ScreenTransitionState => ({
 	progress: 0,
@@ -98,7 +101,6 @@ export const createScreenTransitionState = (
 			width: 0,
 			height: 0,
 		},
-		navigationMaskEnabled,
 	},
 	animatedSnapIndex: -1,
 	snapIndex: -1,
@@ -124,7 +126,6 @@ export const DEFAULT_SCREEN_TRANSITION_STATE: ScreenTransitionState =
 				width: 0,
 				height: 0,
 			},
-			navigationMaskEnabled: false,
 		},
 		animatedSnapIndex: -1,
 		snapIndex: -1,
@@ -164,6 +165,7 @@ export const DEFAULT_GESTURE_SNAP_VELOCITY_IMPACT = 0.1;
 export const DEFAULT_GESTURE_SENSITIVITY = 1;
 export const DEFAULT_GESTURE_RELEASE_VELOCITY_SCALE = 1;
 export const DEFAULT_GESTURE_DIRECTION = "horizontal";
+export const DEFAULT_GESTURE_TRACKING: GestureTracking = "auto";
 export const DEFAULT_GESTURE_PROGRESS_MODE: GestureProgressMode =
 	"progress-driven";
 export const DEFAULT_GESTURE_SNAP_LOCKED = false;

package/src/shared/hooks/navigation/use-stack.tsx

@@ -30,7 +30,6 @@ export interface StackContextValue extends StackCoreContextValue {
 	routeKeys: string[];
 	routes: Route<string>[];
 	scenes: StackScene[];
-	stackProgress: DerivedValue<number>;
 	optimisticFocusedIndex: DerivedValue<number>;
 }
 

package/src/shared/providers/screen/animation/helpers/build-screen-transition-options.ts

@@ -38,9 +38,9 @@ export const buildScreenTransitionOptions = (
 		: undefined;
 
 	return {
+		navigationMaskEnabled: options.navigationMaskEnabled,
 		gestureEnabled: options.gestureEnabled,
-		experimental_allowDisabledGestureTracking:
-			options.experimental_allowDisabledGestureTracking,
+		gestureTracking: options.gestureTracking,
 		gestureDirection: cloneGestureDirection(options.gestureDirection),
 		gestureSensitivity: options.gestureSensitivity,
 		gestureVelocityImpact: options.gestureVelocityImpact,

package/src/shared/providers/screen/animation/helpers/hydrate-transition-state/index.ts

@@ -3,7 +3,10 @@ import {
 	LOGICAL_SETTLE_PROGRESS_THRESHOLD,
 	LOGICAL_SETTLE_REQUIRED_FRAMES,
 } from "../../../../../constants";
-import type { ScreenTransitionOptions } from "../../../../../types/animation.types";
+import type {
+	ScreenTransitionOptions,
+	TransitionInterpolatorOptions,
+} from "../../../../../types/animation.types";
 import type { Layout } from "../../../../../types/screen.types";
 import { resolveGestureDrivenProgress } from "./gesture-progress";
 import {
@@ -21,14 +24,59 @@ import type { BuiltState } from "./types";
 const LOGICAL_SETTLE_STICKY_PROGRESS_THRESHOLD =
 	LOGICAL_SETTLE_PROGRESS_THRESHOLD * 10;
 
+const mergeTransitionOptions = (
+	base: ScreenTransitionOptions,
+	effective: TransitionInterpolatorOptions | undefined,
+	slot: ScreenTransitionOptions,
+): ScreenTransitionOptions => {
+	"worklet";
+	if (!effective) {
+		return base;
+	}
+
+	slot.navigationMaskEnabled = base.navigationMaskEnabled;
+	slot.gestureEnabled = effective.gestureEnabled ?? base.gestureEnabled;
+	slot.gestureTracking = base.gestureTracking;
+	slot.gestureDirection = effective.gestureDirection ?? base.gestureDirection;
+	slot.gestureSensitivity =
+		effective.gestureSensitivity ?? base.gestureSensitivity;
+	slot.gestureVelocityImpact =
+		effective.gestureVelocityImpact ?? base.gestureVelocityImpact;
+	slot.gestureSnapVelocityImpact =
+		effective.gestureSnapVelocityImpact ?? base.gestureSnapVelocityImpact;
+	slot.gestureReleaseVelocityScale =
+		effective.gestureReleaseVelocityScale ?? base.gestureReleaseVelocityScale;
+	slot.gestureResponseDistance =
+		effective.gestureResponseDistance ?? base.gestureResponseDistance;
+	slot.gestureProgressMode =
+		effective.gestureProgressMode ?? base.gestureProgressMode;
+	slot.gestureDrivesProgress =
+		effective.gestureDrivesProgress ?? base.gestureDrivesProgress;
+	slot.gestureActivationArea =
+		effective.gestureActivationArea ?? base.gestureActivationArea;
+	slot.gestureSnapLocked =
+		effective.gestureSnapLocked ?? base.gestureSnapLocked;
+	slot.sheetScrollGestureBehavior =
+		effective.sheetScrollGestureBehavior ?? base.sheetScrollGestureBehavior;
+	slot.backdropBehavior = effective.backdropBehavior ?? base.backdropBehavior;
+
+	return slot;
+};
+
 export const hydrateTransitionState = (
 	s: BuiltState,
 	dimensions: Layout,
-	effectiveOptions?: ScreenTransitionOptions,
+	effectiveOptions?: TransitionInterpolatorOptions,
 ) => {
 	"worklet";
 	const out = s.unwrapped;
 	const baseProgress = s.progress.get();
+	const options = mergeTransitionOptions(
+		s.options,
+		effectiveOptions,
+		s.optionsSlot,
+	);
+	const canDismiss = options.gestureEnabled !== false;
 	out.willAnimate = s.willAnimate.get();
 	out.closing = s.closing.get();
 	out.entering = s.entering.get();
@@ -60,9 +108,16 @@ export const hydrateTransitionState = (
 		getResolvedSnapBounds(
 			s.sortedNumericSnapPoints,
 			s.hasAutoSnapPoint ? s.resolvedAutoSnapPoint.get() : null,
+			canDismiss,
 		),
 	);
 
+	// Unsure where else to place this if im being honest.
+	// I think for here is fine
+	if (s.effectiveProgress.get() !== out.progress) {
+		s.effectiveProgress.set(out.progress);
+	}
+
 	const hasResidualGestureValues =
 		Math.abs(out.gesture.normX) > EPSILON ||
 		Math.abs(out.gesture.normY) > EPSILON ||
@@ -123,11 +178,10 @@ export const hydrateTransitionState = (
 		computedLogicallySettled || shouldPreserveLogicalSettle ? 1 : 0;
 
 	out.meta = s.meta;
-	out.options = s.options;
+	out.options = options;
 	out.route = s.route;
 	out.layouts.screen.width = dimensions.width;
 	out.layouts.screen.height = dimensions.height;
-	out.layouts.navigationMaskEnabled = s.navigationMaskEnabled;
 
 	const content = s.measuredContentLayout.get();
 

package/src/shared/providers/screen/animation/helpers/hydrate-transition-state/snap-points.ts

@@ -48,6 +48,7 @@ const getResolvedSnapPointAt = (
 export const getResolvedSnapBounds = (
 	snapPoints: number[],
 	resolvedAutoSnap: number | null,
+	canDismiss = true,
 ): SnapBounds | null => {
 	"worklet";
 	const snapPointCount = getResolvedSnapPointCount(
@@ -77,7 +78,7 @@ export const getResolvedSnapBounds = (
 	);
 
 	return {
-		min: Math.min(0, firstSnapPoint),
+		min: canDismiss ? Math.min(0, firstSnapPoint) : firstSnapPoint,
 		max: lastSnapPoint,
 	};
 };

package/src/shared/providers/screen/animation/helpers/hydrate-transition-state/types.ts

@@ -9,6 +9,7 @@ import type { BaseStackRoute } from "../../../../../types/stack.types";
 
 export type BuiltState = {
 	progress: SharedValue<number>;
+	effectiveProgress: SharedValue<number>;
 	willAnimate: SharedValue<number>;
 	closing: SharedValue<number>;
 	progressAnimating: SharedValue<number>;
@@ -17,7 +18,7 @@ export type BuiltState = {
 	route: BaseStackRoute;
 	meta?: Record<string, unknown>;
 	options: ScreenTransitionOptions;
-	navigationMaskEnabled: boolean;
+	optionsSlot: ScreenTransitionOptions;
 	targetProgress: SharedValue<number>;
 	logicalSettleFrameCount: SharedValue<number>;
 	resolvedAutoSnapPoint: SharedValue<number>;

package/src/shared/providers/screen/animation/helpers/pipeline.ts

@@ -1,3 +1,4 @@
+import { useMemo } from "react";
 import { useWindowDimensions } from "react-native";
 import {
 	type DerivedValue,
@@ -8,6 +9,7 @@ import {
 import { useSafeAreaInsets } from "react-native-safe-area-context";
 import { DEFAULT_SCREEN_TRANSITION_STATE } from "../../../../constants";
 import { useStack } from "../../../../hooks/navigation/use-stack";
+import { AnimationStore } from "../../../../stores/animation.store";
 import type {
 	ScreenInterpolationProps,
 	ScreenStyleInterpolator,
@@ -18,6 +20,7 @@ import { updateDerivations } from "./derivations";
 import { hasTransitionsEnabled } from "./has-transitions-enabled";
 import { hydrateTransitionState } from "./hydrate-transition-state";
 import type { SelectedInterpolatorOptions } from "./selected-interpolator-options";
+import { deriveStackProgress } from "./stack-progress";
 import { useBuildTransitionState } from "./use-build-transition-state";
 
 export type ScreenInterpolatorFrame = Omit<ScreenInterpolationProps, "bounds">;
@@ -36,7 +39,7 @@ const createInitialBaseInterpolatorProps = (
 ): ScreenInterpolatorFrame => {
 	const current = {
 		...DEFAULT_SCREEN_TRANSITION_STATE,
-		layouts: { screen: dimensions, navigationMaskEnabled: false },
+		layouts: { screen: dimensions },
 	};
 
 	return {
@@ -55,7 +58,7 @@ const createInitialBaseInterpolatorProps = (
 };
 
 export function useScreenAnimationPipeline(): ScreenAnimationPipeline {
-	const { flags, stackProgress: rootStackProgress, routeKeys } = useStack();
+	const { flags, routeKeys } = useStack();
 	const dimensions = useWindowDimensions();
 	const insets = useSafeAreaInsets();
 	const transitionsAlwaysOn = flags.TRANSITIONS_ALWAYS_ON;
@@ -72,6 +75,11 @@ export function useScreenAnimationPipeline(): ScreenAnimationPipeline {
 
 	const currentRouteKey = currDescriptor?.route?.key;
 	const currentIndex = routeKeys.indexOf(currentRouteKey);
+	const effectiveProgressValues = useMemo(() => {
+		return routeKeys.map((routeKey) =>
+			AnimationStore.getValue(routeKey, "effectiveProgress"),
+		);
+	}, [routeKeys]);
 
 	const nextRouteKey = nextDescriptor?.route?.key;
 	const nextHasTransitions =
@@ -130,10 +138,16 @@ export function useScreenAnimationPipeline(): ScreenAnimationPipeline {
 
 			updateDerivations(frame);
 
-			frame.stackProgress =
-				currentIndex >= 0
-					? rootStackProgress.get() - currentIndex
-					: frame.progress;
+			frame.stackProgress = deriveStackProgress(
+				routeKeys,
+				effectiveProgressValues,
+				currentIndex,
+				frame.progress,
+				currentRouteKey,
+				frame.current.progress,
+				nextRouteKey,
+				frame.next?.progress,
+			);
 			frame.logicallySettled = frame.active.logicallySettled;
 
 			return frame;

package/src/shared/providers/screen/animation/helpers/selected-interpolator-options.ts

@@ -60,8 +60,6 @@ const areInterpolatorOptionsEqual = (
 
 	return (
 		left.gestureEnabled === right.gestureEnabled &&
-		left.experimental_allowDisabledGestureTracking ===
-			right.experimental_allowDisabledGestureTracking &&
 		areGestureDirectionsEqual(left.gestureDirection, right.gestureDirection) &&
 		left.gestureSensitivity === right.gestureSensitivity &&
 		left.gestureVelocityImpact === right.gestureVelocityImpact &&

package/src/shared/providers/screen/animation/helpers/stack-progress.ts

@@ -0,0 +1,29 @@
+import type { SharedValue } from "react-native-reanimated";
+
+export const deriveStackProgress = (
+	routeKeys: string[],
+	effectiveProgressValues: SharedValue<number>[],
+	currentIndex: number,
+	fallbackProgress: number,
+	currentRouteKey: string | undefined,
+	currentProgress: number,
+	nextRouteKey: string | undefined,
+	nextProgress: number | undefined,
+) => {
+	"worklet";
+	if (currentIndex < 0) return fallbackProgress;
+
+	let total = 0;
+	for (let i = currentIndex; i < effectiveProgressValues.length; i++) {
+		const routeKey = routeKeys[i];
+		if (routeKey === currentRouteKey) {
+			total += currentProgress;
+		} else if (routeKey === nextRouteKey && nextProgress !== undefined) {
+			total += nextProgress;
+		} else {
+			total += effectiveProgressValues[i].get();
+		}
+	}
+
+	return total;
+};