react-native-screen-transitions 3.8.0-alpha.0 → 3.8.0-beta.1

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

@@ -5,16 +5,32 @@ export type GestureDirection = PanGestureDirection | PinchGestureDirection;
 export type ActiveGesture = ResolvedPanGestureDirection | PinchGestureDirection;
 export type GestureProgressMode = "progress-driven" | "freeform";
 export type SnapPanAxis = "horizontal" | "vertical";
+/**
+ * Axis reported by a transition-aware scrollable.
+ */
 export type ScrollGestureAxis = "vertical" | "horizontal";
+/**
+ * Scroll geometry for one axis of a transition-aware scrollable.
+ */
 export type ScrollGestureAxisState = {
     offset: number;
     contentSize: number;
     layoutSize: number;
+    isTouched: boolean;
+};
+/**
+ * Scroll metadata exposed through screen transition layouts.
+ */
+export type ScrollMetadataState = {
+    vertical: ScrollGestureAxisState | null;
+    horizontal: ScrollGestureAxisState | null;
 };
+/**
+ * Scroll geometry used by gesture coordination.
+ */
 export type ScrollGestureState = {
     vertical: ScrollGestureAxisState;
     horizontal: ScrollGestureAxisState;
-    isTouched: boolean;
 };
 export type SnapPanAxisConfig = {
     collapse: ResolvedPanGestureDirection;
@@ -78,6 +94,35 @@ export type RawGestureValues = {
     normScale: number;
     rotation: number;
 };
+/**
+ * Gesture values used when a release hands off into a dismiss animation.
+ *
+ * These match live gesture values while a screen is not dismissing, then read
+ * from the release snapshot while dismissal is in flight.
+ */
+export type GestureHandoffValues = {
+    x: number;
+    y: number;
+    normX: number;
+    normY: number;
+    velocity: number;
+    scale: number;
+    normScale: number;
+    focalX: number;
+    focalY: number;
+    rotation: number;
+    raw: RawGestureValues;
+    /**
+     * 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 = {
     /**
      * The live horizontal translation of the gesture.
@@ -98,9 +143,6 @@ export type GestureValues = {
     /**
      * A 0-1 scalar derived from the pan velocity magnitude, normalized against
      * a screen-relative full-flick threshold.
-     *
-     * This is live while dragging, frozen at release during dismiss animations,
-     * and reset to 0 while idle or settling from a cancelled gesture.
      */
     velocity: number;
     /**
@@ -127,6 +169,24 @@ export type GestureValues = {
      * Physical gesture values before `gestureSensitivity` is applied.
      */
     raw: RawGestureValues;
+    /**
+     * The gesture that is currently active.
+     */
+    active: ActiveGesture | null;
+    /**
+     * 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.
+     *
+     * While dragging, these values match the live gesture values. During a
+     * dismissing release, they read from the release snapshot so live gesture
+     * values can reset without breaking handoff animations.
+     */
+    handoff: GestureHandoffValues;
     /**
      * A flag indicating if the screen is in the process of dismissing (0 or 1).
      */
@@ -139,16 +199,6 @@ export type GestureValues = {
      * A flag indicating if released gesture values are animating back to neutral.
      */
     settling: number;
-    /**
-     * The gesture that is currently active.
-     */
-    active: ActiveGesture | null;
-    /**
-     * The initial pan direction that activated the gesture.
-     *
-     * @deprecated Use `active` instead.
-     */
-    direction: ResolvedPanGestureDirection | null;
     /** @deprecated Use `normX` instead. */
     normalizedX: number;
     /** @deprecated Use `normY` instead. */

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

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

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

@@ -1,7 +1,7 @@
 export { FALSE, TRUE } from "../constants";
 export type { AnimatedViewStyle, AnimationConfig, ScreenInterpolationProps, ScreenStyleInterpolator, ScreenTransitionAccessor, ScreenTransitionDepthTarget, ScreenTransitionOptions, ScreenTransitionState, ScreenTransitionTarget, TransitionInterpolatedStyle, TransitionInterpolatorOptions, TransitionSlotStyle, TransitionSpec, } from "./animation.types";
 export type { BoundsAccessor, BoundsMethod, BoundsNavigationAccessor, BoundsNavigationRevealOptions, BoundsNavigationRevealStyle, BoundsNavigationZoomOpacityRange, BoundsNavigationZoomOpacityRanges, BoundsNavigationZoomOptions, BoundsNavigationZoomStyle, } from "./bounds.types";
-export type { ActivationArea, GestureActivationArea, GestureDirection, GestureDirectionActivationArea, GestureDirectionConfig, GestureDirectionEntry, GestureDirectionOption, GestureValues, PanGestureDirection, PinchGestureDirection, SideActivation, } from "./gesture.types";
+export type { ActivationArea, GestureActivationArea, GestureDirection, GestureDirectionActivationArea, GestureDirectionConfig, GestureDirectionEntry, GestureDirectionOption, GestureHandoffValues, GestureValues, PanGestureDirection, PinchGestureDirection, RawGestureValues, ScrollGestureAxis, ScrollGestureAxisState, ScrollGestureState, ScrollMetadataState, SideActivation, } from "./gesture.types";
 export type { OverlayProps } from "./overlay.types";
 export type { GestureTracking, InactiveBehavior, Layout, ScreenKey, ScreenTransitionConfig, TransitionAwareProps, } from "./screen.types";
 export type { BaseStackDescriptor, BaseStackNavigation, BaseStackRoute, BaseStackScene, BaseStackState, DescriptorMap, StackDescriptorSource, StackSceneActivity, } from "./stack.types";

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,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,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,8BAA8B,EAC9B,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EACX,eAAe,EACf,gBAAgB,EAChB,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,EACb,qBAAqB,EACrB,kBAAkB,GAClB,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,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,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,8BAA8B,EAC9B,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EACX,eAAe,EACf,gBAAgB,EAChB,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,EACb,qBAAqB,EACrB,kBAAkB,GAClB,MAAM,eAAe,CAAC"}

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

@@ -1,6 +1,6 @@
 import type { AnimatedProps } from "react-native-reanimated";
 import type { ScreenStyleInterpolator, TransitionSpec } from "./animation.types";
-import type { GestureActivationArea, GestureDirectionOption, GestureProgressMode } from "./gesture.types";
+import type { GestureActivationArea, GestureDirectionOption, GestureProgressMode, ScrollMetadataState } from "./gesture.types";
 import type { OverlayProps } from "./overlay.types";
 export type Layout = {
     width: number;
@@ -18,6 +18,13 @@ export type ScreenLayouts = {
      * auto snap-point sizing. It is undefined until a real measurement exists.
      */
     content?: Layout;
+    /**
+     * Scroll metadata from the primary transition-aware scrollable on this screen.
+     *
+     * For nested same-axis scrollables, the outermost scrollable owns that axis.
+     * Cross-axis nested scrollables can each publish their own axis.
+     */
+    scroll?: ScrollMetadataState;
 };
 export type ScreenKey = string;
 export type SheetScrollGestureBehavior = "expand-and-collapse" | "collapse-only";
@@ -185,11 +192,11 @@ export type ScreenTransitionConfig = {
      */
     gestureSnapVelocityImpact?: number;
     /**
-     * Multiplies gesture release velocity used for spring animation energy.
+     * Multiplies gesture release velocity used for gesture reset/handoff energy.
      *
      * This does NOT affect dismissal threshold decisions (`gestureVelocityImpact`)
-     * or snap target selection (`snapVelocityImpact`). It only changes how fast
-     * the post-release animation feels.
+     * or snap target selection (`snapVelocityImpact`). It changes the release
+     * impulse used by gesture values and interpolator handoff values.
      *
      * @default 1
      */
@@ -204,18 +211,35 @@ export type ScreenTransitionConfig = {
      */
     gestureReleaseVelocityMax?: number;
     /**
-     * Distance threshold for gesture recognition throughout the screen.
+     * 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;
     /**
-     * Controls whether live gesture displacement drives transition progress or
-     * stays available as freeform gesture values for custom interpolators.
+     * 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;
     /**
-     * Whether the gesture drives the progress.
+     * 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 `gestureProgressMode` instead.
+     * @deprecated Use `transitionProgress` from interpolation state instead.
      */
     gestureDrivesProgress?: boolean;
     /**

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/animation/spring/spring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../../../../../../src/shared/utils/animation/spring/spring.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA2FpD,KAAK,cAAc,GAAG,CACrB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,YAAY,EACzB,QAAQ,CAAC,EAAE,sBAAsB,KAC7B,MAAM,CAAC;AAEZ;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,EA6Nd,cAAc,CAAC"}
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../../../../../../src/shared/utils/animation/spring/spring.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA2FpD,KAAK,cAAc,GAAG,CACrB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,YAAY,EACzB,QAAQ,CAAC,EAAE,sBAAsB,KAC7B,MAAM,CAAC;AAEZ;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,EAiOd,cAAc,CAAC"}

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":"AAmCA,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,CAgbnD"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../../../../src/shared/utils/bounds/navigation/reveal/build.ts"],"names":[],"mappings":"AAmCA,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,CA4anD"}

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../../../../src/shared/utils/bounds/navigation/zoom/build.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAgC5E,wBAAgB,eAAe,CAAC,EAC/B,GAAG,EACH,WAAW,EACX,KAAK,GACL,EAAE,qBAAqB,GAAG,qBAAqB,CA8Z/C"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../../../../src/shared/utils/bounds/navigation/zoom/build.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA6B5E,wBAAgB,eAAe,CAAC,EAC/B,GAAG,EACH,WAAW,EACX,KAAK,GACL,EAAE,qBAAqB,GAAG,qBAAqB,CAua/C"}

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

@@ -87,6 +87,14 @@ export type BoundsOptions = {
         x?: number;
         y?: number;
     };
+    /**
+     * Progress value used to drive the bounds interpolation.
+     *
+     * Defaults to the interpolator frame's combined visual progress. Pass
+     * `transitionProgress` when bounds geometry should ignore live gesture
+     * progress and layer gesture movement separately.
+     */
+    progress?: number;
     /**
      * The x/y offsets to apply to the bounds.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../../../src/shared/utils/bounds/types/options.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../../../src/shared/utils/bounds/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtC,MAAM,MAAM,YAAY,GACrB,YAAY,GACZ,KAAK,GACL,aAAa,GACb,SAAS,GACT,QAAQ,GACR,UAAU,GACV,eAAe,GACf,QAAQ,GACR,gBAAgB,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3D,KAAK,YAAY,GAAG,OAAO,GAAG,YAAY,GAAG,kBAAkB,CAAC;AAEhE,KAAK,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3C,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,0BAA0B,GAAG;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,0BAA0B,GAAG;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAGF,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,GAC7E,CAAC,CAAC,QAAQ,CAAC,SAAS,MAAM,GACzB,CAAC,CAAC,OAAO,CAAC,SAAS,UAAU,GAC5B,qBAAqB,GACrB,qBAAqB,GACtB,CAAC,CAAC,QAAQ,CAAC,SAAS,SAAS,GAC5B,gBAAgB,GAChB,CAAC,CAAC,OAAO,CAAC,SAAS,UAAU,GAC5B,0BAA0B,GAC1B,0BAA0B,GAC7B,UAAU,CAAC;AAEd,MAAM,MAAM,aAAa,GAAG;IAC3B;;;OAGG;IACH,EAAE,EAAE,OAAO,CAAC;IAEZ;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEpC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEtC;;;OAGG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "react-native-screen-transitions",
-	"version": "3.8.0-alpha.0",
+	"version": "3.8.0-beta.1",
 	"description": "Easy screen transitions for React Native and Expo",
 	"author": "Ed",
 	"license": "MIT",

package/src/shared/animation/snap-to.ts

@@ -52,7 +52,7 @@ export function snapDescriptorToIndex(
 
 	runOnUI(() => {
 		"worklet";
-		const currentProgress = animations.progress.get();
+		const currentProgress = animations.transitionProgress.get();
 
 		animateToProgress({
 			target: targetProgress,

package/src/shared/components/activity/variants/activity-screen.tsx

@@ -59,7 +59,7 @@ export const ActivityScreen = memo(function ActivityScreen({
 			return false;
 		}
 
-		return paintDriverAnimations.progress.get() >= 1;
+		return paintDriverAnimations.transitionProgress.get() >= 1;
 	});
 
 	const isPaintDriverSettledOnJS = useSharedValueState(isPaintDriverSettled);
@@ -127,8 +127,14 @@ export const ActivityScreen = memo(function ActivityScreen({
 	);
 });
 
+const HIDDEN_SCREEN_OFFSET = 10_000;
 const styles = StyleSheet.create({
 	hidden: {
-		display: "none",
+		// NOTE:
+		// When setting a screen to display:"none", the gesture detector will not recognize anymore. Since I believe
+		// rngh is attaching itself to its nearest native view, this of course would kill the detector.
+		// To avoid this, we use a transform to move the screen off-screen instead of display: "none". This isn't my favorite approach,
+		// but i'm hoping react 19's activity could mitigate this better and avoid dependence on rns.
+		transform: [{ translateY: HIDDEN_SCREEN_OFFSET }],
 	},
 });

package/src/shared/components/create-boundary-component/hooks/use-initial-destination-measurement.ts

@@ -34,7 +34,10 @@ export const useInitialDestinationMeasurement = ({
 	ancestorScreenKeys,
 	measureBoundary,
 }: UseInitialDestinationMeasurementParams) => {
-	const progress = AnimationStore.getValue(currentScreenKey, "progress");
+	const transitionProgress = AnimationStore.getValue(
+		currentScreenKey,
+		"transitionProgress",
+	);
 	const system = SystemStore.getBag(currentScreenKey);
 	const { pendingLifecycleRequestKind } = system;
 	const { blockLifecycleStart, unblockLifecycleStart } = system.actions;
@@ -83,7 +86,7 @@ export const useInitialDestinationMeasurement = ({
 				pendingLifecycleRequestKind.get() ===
 				LifecycleTransitionRequestKind.Open;
 
-			const isWaitingForOpenToStart = progress.get() <= 0;
+			const isWaitingForOpenToStart = transitionProgress.get() <= 0;
 
 			if (!hasPendingOpenRequest || !isWaitingForOpenToStart) {
 				return [0, retryTick] as const;

package/src/shared/components/create-boundary-component/hooks/use-measurer.ts

@@ -39,7 +39,7 @@ export const useMeasurer = ({
 	const { width: viewportWidth, height: viewportHeight } =
 		useWindowDimensions();
 
-	const scrollState = ScrollStore.getValue(currentScreenKey, "state");
+	const scrollState = ScrollStore.getValue(currentScreenKey, "coordination");
 	const pendingLifecycleStartBlockCount = SystemStore.getValue(
 		currentScreenKey,
 		"pendingLifecycleStartBlockCount",

package/src/shared/components/create-boundary-component/hooks/use-refresh-boundary.ts

@@ -38,7 +38,10 @@ export const useRefreshBoundary = ({
 		refreshScreenKey,
 		"progressAnimating",
 	);
-	const refreshProgress = AnimationStore.getValue(refreshScreenKey, "progress");
+	const refreshProgress = AnimationStore.getValue(
+		refreshScreenKey,
+		"transitionProgress",
+	);
 
 	useAnimatedReaction(
 		() => {

package/src/shared/components/create-transition-aware-component.tsx

@@ -12,7 +12,10 @@ import Animated, {
 } from "react-native-reanimated";
 import { NO_PROPS, NO_STYLES } from "../constants";
 import { RegisterBoundsProvider } from "../providers/register-bounds.provider";
-import { useScrollGestureCoordination } from "../providers/screen/gestures/scroll-coordination";
+import {
+	ScrollMetadataOwnerProvider,
+	useScrollGestureCoordination,
+} from "../providers/screen/gestures/scroll-coordination";
 import { useScreenStyles } from "../providers/screen/styles";
 import type { TransitionAwareProps } from "../types/screen.types";
 
@@ -55,6 +58,7 @@ export function createTransitionAwareComponent<P extends object>(
 			onContentSizeChange,
 			onLayout,
 			nativeGesture,
+			metadataOwnerProviderValue,
 		} = useScrollGestureCoordination({
 			onContentSizeChange: scrollableProps.onContentSizeChange,
 			onLayout: scrollableProps.onLayout,
@@ -89,14 +93,18 @@ export function createTransitionAwareComponent<P extends object>(
 			/>
 		);
 
-		if (!nativeGesture) {
-			return scrollableComponent;
-		}
-
-		return (
+		const coordinatedScrollableComponent = nativeGesture ? (
 			<GestureDetector gesture={nativeGesture}>
 				{scrollableComponent}
 			</GestureDetector>
+		) : (
+			scrollableComponent
+		);
+
+		return (
+			<ScrollMetadataOwnerProvider value={metadataOwnerProviderValue}>
+				{coordinatedScrollableComponent}
+			</ScrollMetadataOwnerProvider>
 		);
 	});
 

package/src/shared/components/overlay/variations/float-overlay.tsx

@@ -4,6 +4,7 @@ import { useStack } from "../../../hooks/navigation/use-stack";
 import { ScreenAnimationProvider } from "../../../providers/screen/animation";
 import type { BaseDescriptor } from "../../../providers/screen/descriptors";
 import { DescriptorsProvider } from "../../../providers/screen/descriptors";
+import { ScreenOptionsProvider } from "../../../providers/screen/options";
 import { ScreenStylesProvider } from "../../../providers/screen/styles";
 import type { OverlayScreenState } from "../../../types/overlay.types";
 
@@ -64,11 +65,16 @@ export function FloatOverlay() {
 
 	return (
 		<DescriptorsProvider current={current} previous={previous} next={next}>
-			<ScreenAnimationProvider>
-				<ScreenStylesProvider isFloatingOverlay>
-					<OverlayHost scene={scene} overlayScreenState={overlayScreenState} />
-				</ScreenStylesProvider>
-			</ScreenAnimationProvider>
+			<ScreenOptionsProvider>
+				<ScreenAnimationProvider>
+					<ScreenStylesProvider isFloatingOverlay>
+						<OverlayHost
+							scene={scene}
+							overlayScreenState={overlayScreenState}
+						/>
+					</ScreenStylesProvider>
+				</ScreenAnimationProvider>
+			</ScreenOptionsProvider>
 		</DescriptorsProvider>
 	);
 }

package/src/shared/components/screen-container/hooks/use-content-layout.ts

@@ -45,7 +45,7 @@ export function useContentLayout() {
 
 				if (
 					!isFirstMeasurement ||
-					animations.progress.get() !== 0 ||
+					animations.transitionProgress.get() !== 0 ||
 					animations.progressAnimating.get() !== 0
 				) {
 					return;
@@ -53,7 +53,7 @@ export function useContentLayout() {
 
 				if (isFirstKey && !experimental_animateOnInitialMount) {
 					targetProgress.set(nextFraction);
-					animations.progress.set(nextFraction);
+					animations.transitionProgress.set(nextFraction);
 					return;
 				}
 

package/src/shared/components/screen-container/layers/backdrop.tsx

@@ -76,7 +76,7 @@ export const BackdropLayer = memo(function BackdropLayer({
 				}
 
 				const { target, shouldDismiss } = findCollapseTarget(
-					animations.progress.get(),
+					animations.transitionProgress.get(),
 					resolvedSnaps,
 					canDismiss,
 				);

package/src/shared/components/screen-lifecycle/hooks/use-open-transition-intent.ts

@@ -60,11 +60,11 @@ export function useOpenTransitionIntent(
 		if (isFirstKey && !experimental_animateOnInitialMount) {
 			if (initialProgress === "auto") {
 				system.targetProgress.set(0);
-				animations.progress.set(0);
+				animations.transitionProgress.set(0);
 			} else {
 				const target = initialProgress ?? 1;
 				system.targetProgress.set(target);
-				animations.progress.set(target);
+				animations.transitionProgress.set(target);
 			}
 			animations.progressAnimating.set(0);
 			animations.closing.set(0);

package/src/shared/configs/presets.ts

@@ -246,7 +246,6 @@ export const SharedIGImage = ({
 		gestureEnabled: true,
 		gestureDirection: ["vertical", "horizontal"],
 		enableTransitions: true,
-		gestureProgressMode: "freeform",
 		screenStyleInterpolator: ({
 			current,
 			layouts: {
@@ -259,8 +258,8 @@ export const SharedIGImage = ({
 		}) => {
 			"worklet";
 
-			const normX = active.gesture.normX;
-			const normY = active.gesture.normY;
+			const normX = active.gesture.handoff.normX;
+			const normY = active.gesture.handoff.normY;
 
 			const dragX = interpolate(
 				normX,
@@ -394,7 +393,6 @@ export const SharedAppleMusic = ({
 		enableTransitions: true,
 		gestureEnabled: true,
 		gestureDirection: ["vertical", "horizontal"],
-		gestureProgressMode: "freeform",
 		screenStyleInterpolator: ({
 			bounds,
 			focused,
@@ -405,9 +403,10 @@ export const SharedAppleMusic = ({
 		}) => {
 			"worklet";
 
-			const normX = active.gesture.normX;
-			const normY = active.gesture.normY;
-			const initialGesture = active.gesture.active ?? active.gesture.direction;
+			const normX = active.gesture.handoff.normX;
+			const normY = active.gesture.handoff.normY;
+			const initialGesture =
+				active.gesture.handoff.active ?? active.gesture.handoff.direction;
 
 			/**
 			 * ===============================
@@ -608,7 +607,6 @@ export const SharedXImage = ({
 		enableTransitions: true,
 		gestureEnabled: true,
 		gestureDirection: ["vertical", "vertical-inverted"],
-		gestureProgressMode: "freeform",
 		screenStyleInterpolator: ({
 			focused,
 			bounds,

package/src/shared/constants.ts

@@ -5,10 +5,7 @@ import type {
 	ScreenTransitionOptions,
 	ScreenTransitionState,
 } from "./types/animation.types";
-import type {
-	ActivationArea,
-	GestureProgressMode,
-} from "./types/gesture.types";
+import type { ActivationArea } from "./types/gesture.types";
 import type {
 	GestureTracking,
 	Layout,
@@ -57,6 +54,15 @@ const DEFAULT_GESTURE_VALUES = {
 	focalX: 0,
 	focalY: 0,
 	raw: DEFAULT_RAW_GESTURE_VALUES,
+	handoff: {
+		...DEFAULT_RAW_GESTURE_VALUES,
+		velocity: 0,
+		focalX: 0,
+		focalY: 0,
+		raw: DEFAULT_RAW_GESTURE_VALUES,
+		active: null,
+		direction: null,
+	},
 	dismissing: 0,
 	dragging: 0,
 	settling: 0,
@@ -73,6 +79,10 @@ const DEFAULT_GESTURE_VALUES = {
 const createDefaultGestureValues = () => ({
 	...DEFAULT_GESTURE_VALUES,
 	raw: { ...DEFAULT_RAW_GESTURE_VALUES },
+	handoff: {
+		...DEFAULT_GESTURE_VALUES.handoff,
+		raw: { ...DEFAULT_RAW_GESTURE_VALUES },
+	},
 });
 
 export const DEFAULT_SCREEN_TRANSITION_OPTIONS: ScreenTransitionOptions =
@@ -87,6 +97,7 @@ export const createScreenTransitionState = (
 	options: ScreenTransitionOptions = DEFAULT_SCREEN_TRANSITION_OPTIONS,
 ): ScreenTransitionState => ({
 	progress: 0,
+	transitionProgress: 0,
 	closing: 0,
 	animating: 0,
 	willAnimate: 0,
@@ -113,6 +124,7 @@ export const createScreenTransitionState = (
 export const DEFAULT_SCREEN_TRANSITION_STATE: ScreenTransitionState =
 	Object.freeze({
 		progress: 0,
+		transitionProgress: 0,
 		closing: 0,
 		animating: 0,
 		willAnimate: 0,
@@ -167,8 +179,6 @@ 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;
 export const DEFAULT_GESTURE_ACTIVATION_AREA: ActivationArea = "screen";
 export const DEFAULT_SHEET_SCROLL_GESTURE_BEHAVIOR: SheetScrollGestureBehavior =

package/src/shared/index.ts

@@ -57,14 +57,20 @@ export type {
 	BoundsNavigationZoomOpacityRanges,
 	BoundsNavigationZoomOptions,
 	BoundsNavigationZoomStyle,
+	GestureHandoffValues,
 	InactiveBehavior,
 	OverlayProps,
+	RawGestureValues,
 	ScreenInterpolationProps,
 	ScreenStyleInterpolator,
 	ScreenTransitionAccessor,
 	ScreenTransitionConfig,
 	ScreenTransitionDepthTarget,
 	ScreenTransitionTarget,
+	ScrollGestureAxis,
+	ScrollGestureAxisState,
+	ScrollGestureState,
+	ScrollMetadataState,
 	TransitionInterpolatedStyle,
 	TransitionSlotStyle,
 	TransitionSpec,