react-native-screen-transitions 3.3.0-rc.2 → 3.3.0

package/lib/typescript/shared/stores/bounds.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounds.store.d.ts","sourceRoot":"","sources":["../../../../src/shared/stores/bounds.store.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EACf,MAAM,yBAAyB,CAAC;AAEjC,KAAK,KAAK,GAAG,MAAM,CAAC;AACpB,KAAK,SAAS,GAAG,MAAM,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG;IACtB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;CAC3B,CAAC;AAEF,KAAK,OAAO,GAAG;IACd,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CAAC;IACpC,WAAW,EAAE,CAAC,gBAAgB,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;CAClD,CAAC;AASF,iBAAS,gBAAgB,CACxB,GAAG,EAAE,KAAK,EACV,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,GAAE,UAAe,EACvB,YAAY,CAAC,EAAE,SAAS,EAAE,QAW1B;AAED,iBAAS,aAAa,CACrB,GAAG,EAAE,KAAK,EACV,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,GAAE,UAAe,EACvB,YAAY,CAAC,EAAE,SAAS,EAAE,QAa1B;AAED,iBAAS,kBAAkB,CAC1B,GAAG,EAAE,KAAK,EACV,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,GAAE,UAAe,EACvB,YAAY,CAAC,EAAE,SAAS,EAAE,QAiB1B;AAoBD;;;;;GAKG;AACH,iBAAS,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAoBhE;AAED,iBAAS,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI,CA2BxE;AAED;;;GAGG;AACH,iBAAS,KAAK,CAAC,SAAS,EAAE,SAAS,QAmBlC;AAED,eAAO,MAAM,UAAU;;;;;;;CAOtB,CAAC"}
+{"version":3,"file":"bounds.store.d.ts","sourceRoot":"","sources":["../../../../src/shared/stores/bounds.store.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,kBAAkB,EAEvB,KAAK,UAAU,EACf,MAAM,yBAAyB,CAAC;AAEjC,KAAK,KAAK,GAAG,MAAM,CAAC;AACpB,KAAK,SAAS,GAAG,MAAM,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG;IACtB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;CAC3B,CAAC;AAEF,KAAK,OAAO,GAAG;IACd,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CAAC;IACpC,WAAW,EAAE,CAAC,gBAAgB,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;CAClD,CAAC;AASF,iBAAS,gBAAgB,CACxB,GAAG,EAAE,KAAK,EACV,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,GAAE,UAAe,EACvB,YAAY,CAAC,EAAE,SAAS,EAAE,QAW1B;AAED,iBAAS,aAAa,CACrB,GAAG,EAAE,KAAK,EACV,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,GAAE,UAAe,EACvB,YAAY,CAAC,EAAE,SAAS,EAAE,QAa1B;AAED,iBAAS,gBAAgB,CACxB,GAAG,EAAE,KAAK,EACV,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,GAAE,UAAe,EACvB,YAAY,CAAC,EAAE,SAAS,EAAE,QAgD1B;AAED,iBAAS,kBAAkB,CAC1B,GAAG,EAAE,KAAK,EACV,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,GAAE,UAAe,EACvB,YAAY,CAAC,EAAE,SAAS,EAAE,QAiB1B;AAoBD;;;;;GAKG;AACH,iBAAS,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAoBhE;AAED,iBAAS,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI,CA2BxE;AAED;;;GAGG;AACH,iBAAS,KAAK,CAAC,SAAS,EAAE,SAAS,QAmBlC;AAED,eAAO,MAAM,UAAU;;;;;;;;CAQtB,CAAC"}

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

@@ -45,6 +45,16 @@ export type TransitionAwareProps<T extends object> = AnimatedProps<T> & {
      * </Transition.View>
      */
     sharedBoundTag?: string;
+    /**
+     * Re-measures this component when the screen regains focus and updates
+     * any matching shared-bound source link in place.
+     *
+     * Useful when layout can change while unfocused (for example, programmatic
+     * ScrollView/FlatList scrolling triggered from another screen).
+     *
+     * @default false
+     */
+    remeasureOnFocus?: boolean;
 };
 export type ScreenTransitionConfig = {
     /**
@@ -56,7 +66,10 @@ export type ScreenTransitionConfig = {
      */
     transitionSpec?: TransitionSpec;
     /**
-     * Whether the gesture is enabled.
+     * Controls whether swipe-to-dismiss is enabled.
+     *
+     * For screens with `snapPoints`, gesture-driven snapping between non-dismiss
+     * snap points remains available even when this is `false`.
      */
     gestureEnabled?: boolean;
     /**
@@ -152,6 +165,16 @@ export type ScreenTransitionConfig = {
      * @default true
      */
     expandViaScrollView?: boolean;
+    /**
+     * Locks gesture-based snap movement to the current snap point.
+     *
+     * When enabled, users cannot gesture between snap points. If dismiss gestures
+     * are allowed (`gestureEnabled !== false`), swipe-to-dismiss still works.
+     * Programmatic `snapTo()` calls are not affected.
+     *
+     * @default false
+     */
+    gestureSnapLocked?: boolean;
     /**
      * Controls how touches interact with the backdrop area (outside the screen content).
      *
@@ -163,5 +186,17 @@ export type ScreenTransitionConfig = {
      * @default 'block' (or 'passthrough' for component stacks)
      */
     backdropBehavior?: "block" | "passthrough" | "dismiss" | "collapse";
+    /**
+     * Custom component to render as the backdrop layer.
+     * When provided, replaces the default backdrop entirely — including press handling.
+     *
+     * Use `useScreenAnimation()` inside the component to access animation values.
+     * Use your navigation method of choice (e.g. `router.back()`) to handle dismissal.
+     *
+     * `backdropBehavior` still controls container-level pointer events when this is set.
+     *
+     * @default undefined
+     */
+    backdropComponent?: React.FC;
 };
 //# 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;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;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;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;CACpE,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;IAExB;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACpC;;OAEG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElD;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;IAEzD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;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;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;IAEpE;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;CAC7B,CAAC"}

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":"AASA,OAAO,KAAK,EACX,wBAAwB,EAExB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AAkK3E,eAAO,MAAM,YAAY,GACxB,OAAO,IAAI,CAAC,wBAAwB,EAAE,QAAQ,CAAC,KAC7C,cAyGF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/bounds/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACX,wBAAwB,EAExB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AAoK3E,eAAO,MAAM,YAAY,GACxB,OAAO,IAAI,CAAC,wBAAwB,EAAE,QAAQ,CAAC,KAC7C,cAyGF,CAAC"}

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

@@ -1 +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;;;;OAIG;IACH,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,cAAoB,EACpB,UAAiB,GACjB,EAAE,wBAAwB,GAAG,yBAAyB,CA0CtD"}
+{"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;;;;OAIG;IACH,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,cAAoB,EACpB,UAAiB,GACjB,EAAE,wBAAwB,GAAG,yBAAyB,CAqDtD"}

package/lib/typescript/shared/utils/gesture/find-collapse-target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-collapse-target.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/find-collapse-target.ts"],"names":[],"mappings":"AAEA,UAAU,wBAAwB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,OAAO,GACjB,wBAAwB,CAoB1B"}
+{"version":3,"file":"find-collapse-target.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/find-collapse-target.ts"],"names":[],"mappings":"AAEA,UAAU,wBAAwB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,OAAO,GACjB,wBAAwB,CA8B1B"}

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

@@ -1 +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"}
+{"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,wBAkC9B,CAAC"}

package/lib/typescript/shared/utils/overlay/visibility.d.ts

@@ -0,0 +1,11 @@
+import type { OverlayMode } from "../../types/overlay.types";
+type OverlayOptionsLike = {
+    overlay?: unknown;
+    overlayMode?: OverlayMode;
+    overlayShown?: boolean;
+};
+export declare const isOverlayVisible: (options?: OverlayOptionsLike) => boolean;
+export declare const isFloatOverlayVisible: (options?: OverlayOptionsLike) => boolean;
+export declare const isScreenOverlayVisible: (options?: OverlayOptionsLike) => boolean;
+export {};
+//# sourceMappingURL=visibility.d.ts.map

package/lib/typescript/shared/utils/overlay/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/overlay/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,KAAK,kBAAkB,GAAG;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,UAAU,kBAAkB,KAAG,OAE/D,CAAC;AAEF,eAAO,MAAM,qBAAqB,GACjC,UAAU,kBAAkB,KAC1B,OAEF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAClC,UAAU,kBAAkB,KAC1B,OAEF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "react-native-screen-transitions",
-	"version": "3.3.0-rc.2",
+	"version": "3.3.0",
 	"description": "Easy screen transitions for React Native and Expo",
 	"author": "Ed",
 	"license": "MIT",
@@ -45,7 +45,12 @@
 		"typecheck": "tsc --noEmit",
 		"prepublishOnly": "bun run build",
 		"release": "release-it",
-		"release:beta": "release-it --preRelease=beta"
+		"release:stable": "release-it",
+		"release:beta": "release-it --preRelease=beta",
+		"release:rc": "release-it --preRelease=rc",
+		"release:dry-run": "release-it --dry-run",
+		"release:beta:dry-run": "release-it --preRelease=beta --dry-run",
+		"release:rc:dry-run": "release-it --preRelease=rc --dry-run"
 	},
 	"keywords": [
 		"react-native",
@@ -112,6 +117,7 @@
 		},
 		"plugins": {
 			"@release-it/conventional-changelog": {
+				"infile": "CHANGELOG.md",
 				"preset": {
 					"name": "angular"
 				},

package/src/blank-stack/components/stack-view.native.tsx

@@ -10,6 +10,7 @@ import { Overlay } from "../../shared/components/overlay";
 import { ScreenComposer } from "../../shared/providers/screen/screen-composer";
 import { withStackCore } from "../../shared/providers/stack/core.provider";
 import { withManagedStack } from "../../shared/providers/stack/managed.provider";
+import { isScreenOverlayVisible } from "../../shared/utils/overlay/visibility";
 import type {
 	BlankStackDescriptor,
 	BlankStackNavigationHelpers,
@@ -31,7 +32,7 @@ const SceneView = React.memo(function SceneView({
 	return (
 		<NavigationContext.Provider value={navigation}>
 			<NavigationRouteContext.Provider value={route}>
-				{descriptor.options.overlayMode === "screen" && <Overlay.Screen />}
+				{isScreenOverlayVisible(descriptor.options) && <Overlay.Screen />}
 				{render()}
 			</NavigationRouteContext.Provider>
 		</NavigationContext.Provider>

package/src/blank-stack/components/stack-view.tsx

@@ -10,6 +10,7 @@ import { Overlay } from "../../shared/components/overlay";
 import { ScreenComposer } from "../../shared/providers/screen/screen-composer";
 import { withStackCore } from "../../shared/providers/stack/core.provider";
 import { withManagedStack } from "../../shared/providers/stack/managed.provider";
+import { isScreenOverlayVisible } from "../../shared/utils/overlay/visibility";
 import type {
 	BlankStackDescriptor,
 	BlankStackNavigationHelpers,
@@ -31,7 +32,7 @@ const SceneView = React.memo(function SceneView({
 	return (
 		<NavigationContext.Provider value={navigation}>
 			<NavigationRouteContext.Provider value={route}>
-				{descriptor.options.overlayMode === "screen" && <Overlay.Screen />}
+				{isScreenOverlayVisible(descriptor.options) && <Overlay.Screen />}
 				{render()}
 			</NavigationRouteContext.Provider>
 		</NavigationContext.Provider>

package/src/component-stack/components/stack-view.tsx

@@ -9,6 +9,7 @@ import { ScreenComposer } from "../../shared/providers/screen/screen-composer";
 import { withStackCore } from "../../shared/providers/stack/core.provider";
 import { withManagedStack } from "../../shared/providers/stack/managed.provider";
 import { StackType } from "../../shared/types/stack.types";
+import { isScreenOverlayVisible } from "../../shared/utils/overlay/visibility";
 import type {
 	ComponentStackDescriptor,
 	ComponentStackNavigationHelpers,
@@ -27,7 +28,7 @@ const SceneView = React.memo(function SceneView({
 	return (
 		<NavigationContext.Provider value={navigation}>
 			<NavigationRouteContext.Provider value={route}>
-				{descriptor.options.overlayMode === "screen" && <Overlay.Screen />}
+				{isScreenOverlayVisible(descriptor.options) && <Overlay.Screen />}
 				{render()}
 			</NavigationRouteContext.Provider>
 		</NavigationContext.Provider>

package/src/shared/animation/resolve-snap-target.ts

@@ -0,0 +1,53 @@
+import { type HistoryEntry, HistoryStore } from "../stores/history.store";
+
+const hasSnapPoints = (entry: HistoryEntry): boolean => {
+	const snapPoints = entry.descriptor.options?.snapPoints;
+	return Boolean(snapPoints && snapPoints.length > 0);
+};
+
+const getNavigatorLineage = (entry: HistoryEntry): string[] => {
+	const keys: string[] = [];
+	const visited = new Set<string>();
+
+	let nav: any = entry.descriptor.navigation;
+	while (nav) {
+		const key = nav.getState?.()?.key;
+		if (typeof key === "string" && key.length > 0 && !visited.has(key)) {
+			keys.push(key);
+			visited.add(key);
+		}
+
+		if (typeof nav.getParent !== "function") {
+			break;
+		}
+
+		nav = nav.getParent();
+	}
+
+	if (!visited.has(entry.navigatorKey)) {
+		keys.push(entry.navigatorKey);
+	}
+
+	return keys;
+};
+
+export function resolveSnapTargetEntry(): HistoryEntry | undefined {
+	const anchor = HistoryStore.getMostRecent();
+	if (!anchor) return undefined;
+
+	const lineageKeys = getNavigatorLineage(anchor);
+
+	for (const navigatorKey of lineageKeys) {
+		const match = HistoryStore.getByNavigator(navigatorKey).find(hasSnapPoints);
+		if (match) return match;
+	}
+
+	const all = HistoryStore.toArray();
+	for (let i = all.length - 1; i >= 0; i--) {
+		if (hasSnapPoints(all[i])) {
+			return all[i];
+		}
+	}
+
+	return undefined;
+}

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

@@ -1,54 +1,34 @@
-/** biome-ignore-all lint/style/noNonNullAssertion: <Options always exist> */
 import { runOnUI } from "react-native-reanimated";
 import { DefaultSnapSpec } from "../configs/specs";
 import { AnimationStore } from "../stores/animation.store";
-import { HistoryStore } from "../stores/history.store";
+import type { HistoryEntry } from "../stores/history.store";
 import { animateToProgress } from "../utils/animation/animate-to-progress";
 import { logger } from "../utils/logger";
+import { resolveSnapTargetEntry } from "./resolve-snap-target";
 
-/**
- * Programmatically snap the currently focused screen to a specific snap point.
- *
- * @param index - The index of the snap point to snap to (0-based, sorted ascending)
- *
- * @example
- * ```tsx
- * import { snapTo } from 'react-native-screen-transitions';
- *
- * // Snap to the first (smallest) snap point
- * snapTo(0);
- *
- * // Snap to the last (largest) snap point
- * snapTo(2); // if there are 3 snap points
- * ```
- */
-export function snapTo(index: number): void {
-	// Find the most recent screen that has snapPoints defined.
-	// This handles cases where parent screens (e.g., expo-router) register after
-	// ComponentStack screens, but the ComponentStack is what we want to snap.
-	const allHistory = HistoryStore.toArray();
-	const screenWithSnapPoints = allHistory
-		.filter((entry) => {
-			const sp = entry.descriptor.options?.snapPoints;
-			return sp && sp.length > 0;
-		})
-		.pop(); // Last item is most recent (toArray returns oldest-first)
+const getSortedSnapPoints = (
+	descriptor: HistoryEntry["descriptor"],
+): number[] | null => {
+	const snapPoints = descriptor.options?.snapPoints;
+	if (!snapPoints || snapPoints.length === 0) return null;
+	return [...snapPoints].sort((a, b) => a - b);
+};
 
-	if (!screenWithSnapPoints) {
-		logger.warn("snapTo: No screens with snapPoints in history");
-		return;
+export function snapDescriptorToIndex(
+	descriptor: HistoryEntry["descriptor"],
+	index: number,
+): boolean {
+	const sorted = getSortedSnapPoints(descriptor);
+	if (!sorted) {
+		logger.warn("snapTo: target screen has no snapPoints");
+		return false;
 	}
 
-	const { descriptor } = screenWithSnapPoints;
-	const snapPoints = descriptor.options!.snapPoints!;
-
-	const sorted = [...snapPoints].sort((a, b) => a - b);
-
 	if (index < 0 || index >= sorted.length) {
 		logger.warn(
 			`snapTo: index ${index} out of bounds (0-${sorted.length - 1})`,
 		);
-		return;
+		return false;
 	}
 
 	const targetProgress = sorted[index];
@@ -65,4 +45,33 @@ export function snapTo(index: number): void {
 			},
 		});
 	})();
+
+	return true;
+}
+
+/**
+ * Programmatically snap the currently focused screen to a specific snap point.
+ *
+ * @param index - The index of the snap point to snap to (0-based, sorted ascending)
+ *
+ * @example
+ * ```tsx
+ * import { snapTo } from 'react-native-screen-transitions';
+ *
+ * // Snap to the first (smallest) snap point
+ * snapTo(0);
+ *
+ * // Snap to the last (largest) snap point
+ * snapTo(2); // if there are 3 snap points
+ * ```
+ */
+export function snapTo(index: number): void {
+	const screenWithSnapPoints = resolveSnapTargetEntry();
+
+	if (!screenWithSnapPoints) {
+		logger.warn("snapTo: No screens with snapPoints in history");
+		return;
+	}
+
+	snapDescriptorToIndex(screenWithSnapPoints.descriptor, index);
 }

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

@@ -3,7 +3,11 @@ import type React from "react";
 import { type ComponentType, forwardRef, memo } from "react";
 import type { View } from "react-native";
 import { GestureDetector } from "react-native-gesture-handler";
-import Animated, { runOnUI, useAnimatedRef } from "react-native-reanimated";
+import Animated, {
+	runOnUI,
+	useAnimatedRef,
+	useComposedEventHandler,
+} from "react-native-reanimated";
 import { useAssociatedStyles } from "../hooks/animation/use-associated-style";
 import { useScrollRegistry } from "../hooks/gestures/use-scroll-registry";
 import { RegisterBoundsProvider } from "../providers/register-bounds.provider";
@@ -25,26 +29,38 @@ export function createTransitionAwareComponent<P extends object>(
 		React.ComponentRef<typeof Wrapped>,
 		TransitionAwareProps<P>
 	>((props: any, ref) => {
+		const {
+			remeasureOnFocus: _remeasureOnFocus,
+			onScroll: userOnScroll,
+			...scrollableProps
+		} = props;
+
 		// Determine scroll direction from the horizontal prop (standard ScrollView API)
-		const scrollDirection = props.horizontal ? "horizontal" : "vertical";
+		const scrollDirection = scrollableProps.horizontal
+			? "horizontal"
+			: "vertical";
 
 		// Get scroll handlers and the gesture owner's nativeGesture for this axis
 		const { scrollHandler, onContentSizeChange, onLayout, nativeGesture } =
 			useScrollRegistry({
-				onScroll: props.onScroll,
-				onContentSizeChange: props.onContentSizeChange,
-				onLayout: props.onLayout,
+				onContentSizeChange: scrollableProps.onContentSizeChange,
+				onLayout: scrollableProps.onLayout,
 				direction: scrollDirection,
 			});
 
+		const composedScrollHandler = useComposedEventHandler([
+			scrollHandler,
+			userOnScroll ?? null,
+		]);
+
 		const scrollableComponent = (
 			<AnimatedComponent
-				{...(props as any)}
+				{...(scrollableProps as any)}
 				ref={ref}
-				onScroll={scrollHandler}
+				onScroll={composedScrollHandler}
 				onContentSizeChange={onContentSizeChange}
 				onLayout={onLayout}
-				scrollEventThrottle={props.scrollEventThrottle || 16}
+				scrollEventThrottle={scrollableProps.scrollEventThrottle || 16}
 			/>
 		);
 
@@ -64,8 +80,15 @@ export function createTransitionAwareComponent<P extends object>(
 		React.ComponentRef<typeof AnimatedComponent>,
 		TransitionAwareProps<P>
 	>((props, _) => {
-		const { children, style, sharedBoundTag, styleId, onPress, ...rest } =
-			props as any;
+		const {
+			children,
+			style,
+			sharedBoundTag,
+			styleId,
+			onPress,
+			remeasureOnFocus,
+			...rest
+		} = props as any;
 
 		const animatedRef = useAnimatedRef<View>();
 
@@ -80,6 +103,7 @@ export function createTransitionAwareComponent<P extends object>(
 				style={style}
 				onPress={onPress}
 				sharedBoundTag={sharedBoundTag}
+				remeasureOnFocus={remeasureOnFocus}
 			>
 				{({ captureActiveOnPress, handleInitialLayout }) => (
 					<AnimatedComponent

package/src/shared/components/overlay/helpers/get-active-overlay.ts

@@ -1,9 +1,10 @@
 import type { StackScene } from "../../../hooks/navigation/use-stack";
+import { isFloatOverlayVisible } from "../../../utils/overlay/visibility";
 
 /**
  * Find the active float overlay from scenes.
  * Scans from the top of the stack downward to find the first screen
- * with overlayMode="float" and overlayShown=true.
+ * with a visible overlay that isn't explicitly set to legacy screen mode.
  */
 export function getActiveFloatOverlay(
 	scenes: StackScene[],
@@ -29,7 +30,7 @@ export function getActiveFloatOverlay(
 			continue;
 		}
 
-		if (options?.overlayMode === "float" && options?.overlayShown) {
+		if (isFloatOverlayVisible(options)) {
 			return { scene, overlayIndex: i };
 		}
 	}

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

@@ -1,16 +1,33 @@
 import { useMemo } from "react";
+import { snapDescriptorToIndex } from "../../../animation/snap-to";
+import { useOptimisticFocusedIndex } from "../../../hooks/navigation/use-optimistic-focused-index";
 import { useStack } from "../../../hooks/navigation/use-stack";
+import type { BaseDescriptor } from "../../../providers/screen/keys.provider";
 import { KeysProvider } from "../../../providers/screen/keys.provider";
 import { ScreenStylesProvider } from "../../../providers/screen/styles.provider";
+import type { OverlayProps } from "../../../types/overlay.types";
 import { getActiveFloatOverlay } from "../helpers/get-active-overlay";
 import { OverlayHost } from "./overlay-host";
 
+type OverlayScreenState = Omit<
+	OverlayProps<BaseDescriptor["navigation"]>,
+	"progress" | "overlayAnimation" | "screenAnimation"
+> & {
+	index: number;
+	snapTo: (index: number) => void;
+};
+
 /**
  * Float overlay component that renders above all screens.
  * Gets routes and descriptors from stack context.
  */
 export function FloatOverlay() {
-	const { scenes, focusedIndex, flags } = useStack();
+	const { scenes, optimisticFocusedIndex, flags, routes, routeKeys } =
+		useStack();
+	const focusedIndex = useOptimisticFocusedIndex(
+		optimisticFocusedIndex,
+		routeKeys.length,
+	);
 
 	const activeOverlay = useMemo(
 		() =>
@@ -18,20 +35,48 @@ export function FloatOverlay() {
 		[scenes, focusedIndex, flags.TRANSITIONS_ALWAYS_ON],
 	);
 
-	if (!activeOverlay) {
+	const overlayData = useMemo(() => {
+		if (!activeOverlay) return null;
+
+		const { scene, overlayIndex } = activeOverlay;
+		const previous = scenes[overlayIndex - 1]?.descriptor;
+		const current = scene.descriptor;
+		const next = scenes[overlayIndex + 1]?.descriptor;
+		const focusedScene = scenes[focusedIndex] ?? scenes[scenes.length - 1];
+		const focusedDescriptor = focusedScene?.descriptor;
+
+		const overlayScreenState: OverlayScreenState = {
+			index: routeKeys.indexOf(current.route.key),
+			options: focusedDescriptor?.options ?? {},
+			routes,
+			focusedRoute: focusedScene?.route ?? current.route,
+			focusedIndex,
+			meta: focusedDescriptor?.options?.meta,
+			navigation: current.navigation,
+			snapTo: (index: number) => {
+				snapDescriptorToIndex(current, index);
+			},
+		};
+
+		return {
+			scene,
+			previous,
+			current,
+			next,
+			overlayScreenState,
+		};
+	}, [activeOverlay, scenes, focusedIndex, routeKeys, routes]);
+
+	if (!overlayData) {
 		return null;
 	}
 
-	const { scene, overlayIndex } = activeOverlay;
-
-	const previous = scenes[overlayIndex - 1]?.descriptor;
-	const current = scene.descriptor;
-	const next = scenes[overlayIndex + 1]?.descriptor;
+	const { scene, previous, current, next, overlayScreenState } = overlayData;
 
 	return (
 		<KeysProvider current={current} previous={previous} next={next}>
 			<ScreenStylesProvider>
-				<OverlayHost scene={scene} />
+				<OverlayHost scene={scene} overlayScreenState={overlayScreenState} />
 			</ScreenStylesProvider>
 		</KeysProvider>
 	);

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

@@ -7,25 +7,33 @@ import { Animated, StyleSheet, useWindowDimensions, View } from "react-native";
 import { useDerivedValue } from "react-native-reanimated";
 import { useSafeAreaInsets } from "react-native-safe-area-context";
 import { useScreenAnimation } from "../../../hooks/animation/use-screen-animation";
-import { useScreenState } from "../../../hooks/navigation/use-screen-state";
 import type { StackScene } from "../../../hooks/navigation/use-stack";
 import type { BaseDescriptor } from "../../../providers/screen/keys.provider";
 import type { OverlayInterpolationProps } from "../../../types/animation.types";
 import type { OverlayProps } from "../../../types/overlay.types";
 
+type OverlayScreenState = Omit<
+	OverlayProps<BaseDescriptor["navigation"]>,
+	"progress" | "overlayAnimation" | "screenAnimation"
+> & {
+	index: number;
+	snapTo: (index: number) => void;
+};
+
 type OverlayHostProps = {
 	scene: StackScene;
+	overlayScreenState: OverlayScreenState;
 };
 
 export const OverlayHost = memo(function OverlayHost({
 	scene,
+	overlayScreenState,
 }: OverlayHostProps) {
 	const OverlayComponent = scene.descriptor.options.overlay;
 	const screen = useWindowDimensions();
 	const insets = useSafeAreaInsets();
 
 	const screenAnimation = useScreenAnimation();
-	const screenState = useScreenState();
 	const relativeProgress = useDerivedValue(() => {
 		"worklet";
 		return screenAnimation.value.stackProgress;
@@ -39,12 +47,14 @@ export const OverlayHost = memo(function OverlayHost({
 
 	const overlayProps: OverlayProps<BaseDescriptor["navigation"]> = useMemo(
 		() => ({
-			...screenState,
+			...overlayScreenState,
 			progress: relativeProgress,
-			overlayAnimation, //Deprecated
-			screenAnimation, //Deprecated
+			/**@deprecated */
+			overlayAnimation,
+			/**@deprecated */
+			screenAnimation,
 		}),
-		[relativeProgress, overlayAnimation, screenAnimation, screenState],
+		[relativeProgress, overlayAnimation, screenAnimation, overlayScreenState],
 	);
 
 	if (!OverlayComponent) {