react-native-screen-transitions 3.11.2 → 3.12.0

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

@@ -1,23 +1,28 @@
-import type { Route } from "@react-navigation/native";
+import type { ParamListBase, ParamListRoute, RouteProp } from "@react-navigation/native";
+import type { ReactNode } from "react";
 import type { DerivedValue } from "react-native-reanimated";
 import type { ScreenTransitionConfig } from "./screen.types";
 /**
- * Props passed to overlay components.
- * Generic over the navigation type since different stacks have different navigation props.
+ * Overlay state without the animated progress value.
  */
+export type OverlayScreenState<TNavigation = unknown, TParamList extends ParamListBase = ParamListBase, TOwnerRouteName extends keyof TParamList = keyof TParamList> = Omit<OverlayProps<TNavigation, TParamList, TOwnerRouteName>, "progress"> & {
+    snapTo: (index: number) => void;
+};
 /**
- * Overlay screen state passed to overlay host for rendering.
- * Generic over navigation type — defaults to `unknown` for flexibility.
+ * Props passed to a floating overlay component.
+ *
+ * `route` and `index` identify the screen that owns the overlay. Focused
+ * values may describe a later screen while that overlay remains visible.
  */
-export type OverlayScreenState<TNavigation = unknown> = Omit<OverlayProps<TNavigation>, "progress"> & {
+export type OverlayProps<TNavigation = unknown, TParamList extends ParamListBase = ParamListBase, TOwnerRouteName extends keyof TParamList = keyof TParamList> = {
+    /** Route that declared this overlay. */
+    route: RouteProp<TParamList, TOwnerRouteName>;
+    /** Index of the route that declared this overlay. */
     index: number;
-    snapTo: (index: number) => void;
-};
-export type OverlayProps<TNavigation = unknown> = {
     /**
      * Route of the currently focused screen in the stack.
      */
-    focusedRoute: Route<string>;
+    focusedRoute: ParamListRoute<TParamList>;
     /**
      * Index of the focused route in the stack.
      */
@@ -25,7 +30,7 @@ export type OverlayProps<TNavigation = unknown> = {
     /**
      * All routes currently in the stack.
      */
-    routes: Route<string>[];
+    routes: ParamListRoute<TParamList>[];
     /**
      * Custom metadata from the focused screen's options.
      */
@@ -44,4 +49,14 @@ export type OverlayProps<TNavigation = unknown> = {
      */
     progress: DerivedValue<number>;
 };
+/**
+ * Component rendered for a floating screen overlay.
+ *
+ * The callback is bivariant because React Navigation stores overlay components
+ * in navigator-wide screen options while applications annotate them for one
+ * specific route.
+ */
+export type OverlayComponent = {
+    bivarianceHack(props: OverlayProps): ReactNode;
+}["bivarianceHack"];
 //# sourceMappingURL=overlay.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"overlay.types.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/overlay.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;GAGG;AACH;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,WAAW,GAAG,OAAO,IAAI,IAAI,CAC3D,YAAY,CAAC,WAAW,CAAC,EACzB,UAAU,CACV,GAAG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,WAAW,GAAG,OAAO,IAAI;IACjD;;OAEG;IACH,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE5B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,UAAU,EAAE,WAAW,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,sBAAsB,CAAC;IAEhC;;;OAGG;IACH,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;CAC/B,CAAC"}
+{"version":3,"file":"overlay.types.d.ts","sourceRoot":"","sources":["../../../../src/shared/types/overlay.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,cAAc,EACd,SAAS,EACT,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAC7B,WAAW,GAAG,OAAO,EACrB,UAAU,SAAS,aAAa,GAAG,aAAa,EAChD,eAAe,SAAS,MAAM,UAAU,GAAG,MAAM,UAAU,IACxD,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,UAAU,CAAC,GAAG;IAC9E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CACvB,WAAW,GAAG,OAAO,EACrB,UAAU,SAAS,aAAa,GAAG,aAAa,EAChD,eAAe,SAAS,MAAM,UAAU,GAAG,MAAM,UAAU,IACxD;IACH,wCAAwC;IACxC,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAE9C,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAEzC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;IAErC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,UAAU,EAAE,WAAW,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,sBAAsB,CAAC;IAEhC;;;OAGG;IACH,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;CAC/C,CAAC,gBAAgB,CAAC,CAAC"}

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

@@ -3,7 +3,7 @@ import type { ViewProps } from "react-native";
 import type { AnimatedProps } from "react-native-reanimated";
 import type { ScreenStyleInterpolator, TransitionSpec } from "./animation.types";
 import type { GestureActivationArea, GestureDirectionOption, GestureProgressMode, ScrollMetadataState } from "./gesture.types";
-import type { OverlayProps } from "./overlay.types";
+import type { OverlayComponent } from "./overlay.types";
 export type Layout = {
     width: number;
     height: number;
@@ -290,7 +290,7 @@ export type ScreenTransitionConfig = {
     /**
      * Function that returns a React Element to display as an overlay.
      */
-    overlay?: (props: OverlayProps) => React.ReactNode;
+    overlay?: OverlayComponent;
     /**
      * Whether to show the overlay. The overlay is shown by default when `overlay` is provided.
      * Setting this to `false` hides the overlay.

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/animate-to-progress.d.ts

@@ -1,4 +1,4 @@
-import { type SharedValue } from "react-native-reanimated";
+import type { SharedValue } from "react-native-reanimated";
 import { type AnimationStoreMap } from "../../stores/animation.store";
 import type { TransitionSpec } from "../../types/animation.types";
 interface AnimateToProgressProps {
@@ -10,7 +10,6 @@ interface AnimateToProgressProps {
      */
     target: "open" | "close" | number;
     spec?: TransitionSpec;
-    onAnimationFinish?: (finished: boolean) => void;
     animations: AnimationStoreMap;
     targetProgress: SharedValue<number>;
     animationProgress: SharedValue<number>;
@@ -24,6 +23,6 @@ export declare const resolveAnimationProgressRange: (currentProgress: number, ta
     from: number;
     to: number;
 };
-export declare const animateToProgress: ({ target, spec, onAnimationFinish, animations, targetProgress, animationProgress, emitWillAnimate, markEntering, initialVelocity, isDragging, }: AnimateToProgressProps) => void;
+export declare const animateToProgress: ({ target, spec, animations, targetProgress, animationProgress, emitWillAnimate, markEntering, initialVelocity, isDragging, }: AnimateToProgressProps) => void;
 export {};
 //# sourceMappingURL=animate-to-progress.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"animate-to-progress.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/animation/animate-to-progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EACN,KAAK,iBAAiB,EAEtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,UAAU,sBAAsB;IAC/B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACjC;AAsBD,eAAO,MAAM,6BAA6B,GACzC,iBAAiB,MAAM,EACvB,gBAAgB,MAAM;;;CAOtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,iJAW/B,sBAAsB,SAoHxB,CAAC"}
+{"version":3,"file":"animate-to-progress.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/animation/animate-to-progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EACN,KAAK,iBAAiB,EAEtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,UAAU,sBAAsB;IAC/B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACjC;AAsBD,eAAO,MAAM,6BAA6B,GACzC,iBAAiB,MAAM,EACvB,gBAAgB,MAAM;;;CAOtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,8HAU/B,sBAAsB,SAiGxB,CAAC"}

package/lib/typescript/shared/utils/create-provider.d.ts

@@ -14,6 +14,10 @@
  * - `children`: passed-through children keep their identity across
  *   provider-local renders. Factories that wrap children should use a
  *   module-level memoized component for the wrapper.
+ *
+ * Providers created with `global: true` return a `key` from their factory.
+ * Their generated store hook accepts that key to subscribe to the original
+ * provider store from outside its React context.
  */
 import { type ReactNode } from "react";
 type ProviderSnapshot<ContextValue, Guarded extends boolean> = Guarded extends true ? ContextValue : ContextValue | null;
@@ -22,6 +26,20 @@ type ProviderStoreHook<ContextValue, Guarded extends boolean> = {
     (): ProviderSnapshot<ContextValue, Guarded>;
     <Selected>(selector: ProviderSelector<ContextValue, Guarded, Selected>): Selected;
 };
+type GlobalProviderStoreHook<ContextValue> = {
+    (key: string): ContextValue | null;
+    <Selected>(key: string, selector: (value: ContextValue) => Selected): Selected | null;
+};
+type ResolvedProviderStoreHook<ContextValue, Guarded extends boolean, Global extends boolean> = ProviderStoreHook<ContextValue, Guarded> & (Global extends true ? GlobalProviderStoreHook<ContextValue> : unknown);
+type ProviderFactoryResult<ContextValue, Global extends boolean> = {
+    value?: ContextValue;
+    enabled?: boolean;
+    children?: ReactNode;
+} & (Global extends true ? {
+    key: string;
+} : {
+    key?: never;
+});
 export type ProviderFactoryInternals<ContextValue> = {
     useParentStore: ProviderStoreHook<ContextValue, false>;
 };
@@ -29,12 +47,9 @@ export interface ProviderStoreApi<ContextValue> {
     getSnapshot: () => ContextValue | null;
     subscribe: (listener: () => void) => () => void;
 }
-export default function createProvider<ProviderName extends string, Guarded extends boolean = true>(name: ProviderName, options?: {
+export default function createProvider<ProviderName extends string, Guarded extends boolean = true, Global extends boolean = false>(name: ProviderName, options?: {
     guarded?: Guarded;
-}): <ProviderProps extends object, ContextValue>(factory: (props: ProviderProps, internals: ProviderFactoryInternals<ContextValue>) => {
-    value?: ContextValue;
-    enabled?: boolean;
-    children?: ReactNode;
-}) => { [P in ProviderName as `${P}Provider`]: React.FC<ProviderProps>; } & { [P in ProviderName as `use${P}Store`]: ProviderStoreHook<ContextValue, Guarded>; };
+    global?: Global;
+}): <ProviderProps extends object, ContextValue>(factory: (props: ProviderProps, internals: ProviderFactoryInternals<ContextValue>) => ProviderFactoryResult<ContextValue, Global>) => { [P in ProviderName as `${P}Provider`]: React.FC<ProviderProps>; } & { [P in ProviderName as `use${P}Store`]: ResolvedProviderStoreHook<ContextValue, Guarded, Global>; };
 export {};
 //# sourceMappingURL=create-provider.d.ts.map

package/lib/typescript/shared/utils/create-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-provider.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/create-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAEN,KAAK,SAAS,EAMd,MAAM,OAAO,CAAC;AAEf,KAAK,gBAAgB,CACpB,YAAY,EACZ,OAAO,SAAS,OAAO,IACpB,OAAO,SAAS,IAAI,GAAG,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC;AAE9D,KAAK,gBAAgB,CAAC,YAAY,EAAE,OAAO,SAAS,OAAO,EAAE,QAAQ,IAAI,CACxE,KAAK,EAAE,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,KAC1C,QAAQ,CAAC;AAEd,KAAK,iBAAiB,CAAC,YAAY,EAAE,OAAO,SAAS,OAAO,IAAI;IAC/D,IAAI,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC,QAAQ,EACR,QAAQ,EAAE,gBAAgB,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,GACzD,QAAQ,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,YAAY,IAAI;IACpD,cAAc,EAAE,iBAAiB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,WAAW,gBAAgB,CAAC,YAAY;IAC7C,WAAW,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;IACvC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAChD;AA+ED,MAAM,CAAC,OAAO,UAAU,cAAc,CACrC,YAAY,SAAS,MAAM,EAC3B,OAAO,SAAS,OAAO,GAAG,IAAI,EAC7B,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,IAC5C,aAAa,SAAS,MAAM,EAAE,YAAY,EACjD,SAAS,CACR,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,wBAAwB,CAAC,YAAY,CAAC,KAC7C;IACJ,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB,KAmGI,GACH,CAAC,IAAI,YAAY,IAAI,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,GAC9D,GAAG,GACF,CAAC,IAAI,YAAY,IAAI,MAAM,CAAC,OAAO,GAAG,iBAAiB,CACvD,YAAY,EACZ,OAAO,CACP,GACD,CAEF"}
+{"version":3,"file":"create-provider.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/create-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAEN,KAAK,SAAS,EAMd,MAAM,OAAO,CAAC;AAEf,KAAK,gBAAgB,CACpB,YAAY,EACZ,OAAO,SAAS,OAAO,IACpB,OAAO,SAAS,IAAI,GAAG,YAAY,GAAG,YAAY,GAAG,IAAI,CAAC;AAE9D,KAAK,gBAAgB,CAAC,YAAY,EAAE,OAAO,SAAS,OAAO,EAAE,QAAQ,IAAI,CACxE,KAAK,EAAE,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,KAC1C,QAAQ,CAAC;AAEd,KAAK,iBAAiB,CAAC,YAAY,EAAE,OAAO,SAAS,OAAO,IAAI;IAC/D,IAAI,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC,QAAQ,EACR,QAAQ,EAAE,gBAAgB,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,GACzD,QAAQ,CAAC;CACZ,CAAC;AAEF,KAAK,uBAAuB,CAAC,YAAY,IAAI;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IACnC,CAAC,QAAQ,EACR,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,QAAQ,GACzC,QAAQ,GAAG,IAAI,CAAC;CACnB,CAAC;AAEF,KAAK,yBAAyB,CAC7B,YAAY,EACZ,OAAO,SAAS,OAAO,EACvB,MAAM,SAAS,OAAO,IACnB,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,GAC3C,CAAC,MAAM,SAAS,IAAI,GAAG,uBAAuB,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,CAAC;AAEzE,KAAK,qBAAqB,CAAC,YAAY,EAAE,MAAM,SAAS,OAAO,IAAI;IAClE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB,GAAG,CAAC,MAAM,SAAS,IAAI,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAE9D,MAAM,MAAM,wBAAwB,CAAC,YAAY,IAAI;IACpD,cAAc,EAAE,iBAAiB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,WAAW,gBAAgB,CAAC,YAAY;IAC7C,WAAW,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;IACvC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAChD;AAuJD,MAAM,CAAC,OAAO,UAAU,cAAc,CACrC,YAAY,SAAS,MAAM,EAC3B,OAAO,SAAS,OAAO,GAAG,IAAI,EAC9B,MAAM,SAAS,OAAO,GAAG,KAAK,EAC7B,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,IAC7D,aAAa,SAAS,MAAM,EAAE,YAAY,EACjD,SAAS,CACR,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,wBAAwB,CAAC,YAAY,CAAC,KAC7C,qBAAqB,CAAC,YAAY,EAAE,MAAM,CAAC,KA8M3C,GACH,CAAC,IAAI,YAAY,IAAI,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,GAC9D,GAAG,GACF,CAAC,IAAI,YAAY,IAAI,MAAM,CAAC,OAAO,GAAG,yBAAyB,CAC/D,YAAY,EACZ,OAAO,EACP,MAAM,CACN,GACD,CAEF"}

package/lib/typescript/shared/utils/navigation/close-action-replay.d.ts

@@ -0,0 +1,4 @@
+export declare const isCloseActionReplay: (action: unknown) => boolean;
+/** Carries the terminal-removal bypass through React Navigation's action clones. */
+export declare const dispatchCloseAction: <TAction extends object>(action: TAction, dispatch: (action: TAction) => void) => void;
+//# sourceMappingURL=close-action-replay.d.ts.map

package/lib/typescript/shared/utils/navigation/close-action-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-action-replay.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/navigation/close-action-replay.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB,GAAI,QAAQ,OAAO,KAAG,OAGM,CAAC;AAE7D,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,GAAI,OAAO,SAAS,MAAM,EACzD,QAAQ,OAAO,EACf,UAAU,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,SAUnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "react-native-screen-transitions",
-	"version": "3.11.2",
+	"version": "3.12.0",
 	"description": "Easy screen transitions for React Native and Expo",
 	"author": "Ed",
 	"license": "MIT",

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

@@ -80,13 +80,10 @@ const StackViewContent = memo(function StackViewContent() {
 	const routeKeys = useBlankStackStore(
 		(store) => store?.routeKeys ?? EMPTY_ROUTE_KEYS,
 	);
-	const shouldShowFloatOverlay = useBlankStackStore(
-		(store) => store?.shouldShowFloatOverlay ?? false,
-	);
 
 	return (
 		<PortalProvider>
-			{shouldShowFloatOverlay ? <Overlay.Float /> : null}
+			<Overlay.Float />
 
 			<ActivityContainer>
 				{routeKeys.map((routeKey) => (

package/src/blank-stack/types.ts

@@ -98,8 +98,14 @@ export interface BlankStackFactoryOptions {
  * Props passed to overlay components in blank-stack.
  * Uses the shared OverlayProps type with blank-stack's navigation type.
  */
-export type BlankStackOverlayProps = OverlayProps<
-	BlankStackNavigationProp<ParamListBase>
+export type BlankStackOverlayProps<
+	ParamList extends ParamListBase = ParamListBase,
+	RouteName extends keyof ParamList = keyof ParamList,
+	NavigatorID extends string | undefined = undefined,
+> = OverlayProps<
+	BlankStackNavigationProp<ParamList, RouteName, NavigatorID>,
+	ParamList,
+	RouteName
 >;
 
 export type BlankStackNavigationOptions = ScreenTransitionConfig & {

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

@@ -54,13 +54,10 @@ const StackViewContent = memo(function StackViewContent() {
 	const routeKeys = useBlankStackStore(
 		(store) => store?.routeKeys ?? EMPTY_ROUTE_KEYS,
 	);
-	const shouldShowFloatOverlay = useBlankStackStore(
-		(store) => store?.shouldShowFloatOverlay ?? false,
-	);
 
 	return (
 		<Fragment>
-			{shouldShowFloatOverlay ? <Overlay.Float /> : null}
+			<Overlay.Float />
 
 			{routeKeys.map((routeKey) => (
 				<ComponentSceneRow key={routeKey} routeKey={routeKey} />

package/src/component-stack/types.ts

@@ -74,8 +74,14 @@ type ComponentStackNavigationConfig = {};
  *
  * @deprecated Component stack is deprecated. Use blank stack instead.
  */
-export type ComponentStackOverlayProps = OverlayProps<
-	ComponentStackNavigationProp<ParamListBase>
+export type ComponentStackOverlayProps<
+	ParamList extends ParamListBase = ParamListBase,
+	RouteName extends keyof ParamList = keyof ParamList,
+	NavigatorID extends string | undefined = undefined,
+> = OverlayProps<
+	ComponentStackNavigationProp<ParamList, RouteName, NavigatorID>,
+	ParamList,
+	RouteName
 >;
 
 type ComponentStackScreenTransitionConfig = ScreenTransitionConfig & {

package/src/native-stack/types.ts

@@ -154,8 +154,14 @@ export type NativeStackHeaderLeftProps = NativeStackHeaderRightProps & {
  * Props passed to overlay components in native-stack.
  * Uses the shared OverlayProps type with native-stack's navigation type.
  */
-export type NativeStackOverlayProps = OverlayProps<
-	NativeStackNavigationProp<ParamListBase>
+export type NativeStackOverlayProps<
+	ParamList extends ParamListBase = ParamListBase,
+	RouteName extends keyof ParamList = keyof ParamList,
+	NavigatorID extends string | undefined = undefined,
+> = OverlayProps<
+	NativeStackNavigationProp<ParamList, RouteName, NavigatorID>,
+	ParamList,
+	RouteName
 >;
 
 /**

package/src/native-stack/views/NativeStackView.native.tsx

@@ -309,7 +309,9 @@ const SceneView = ({
 							? // This prop enables handling of system back gestures on Android
 								// Since we handle them in JS side, we disable this
 								false
-							: nativeGestureEnabled
+							: enableTransitions
+								? false
+								: nativeGestureEnabled
 					}
 					homeIndicatorHidden={autoHideHomeIndicator}
 					hideKeyboardOnSwipe={keyboardHandlingEnabled}
@@ -480,14 +482,8 @@ const SceneView = ({
 };
 
 function NativeStackViewContent() {
-	const {
-		state,
-		navigation,
-		descriptors,
-		scenes,
-		focusedIndex,
-		shouldShowFloatOverlay,
-	} = useDirectStackStore();
+	const { state, navigation, descriptors, scenes, focusedIndex } =
+		useDirectStackStore();
 	const { setNextDismissedKey } = useDismissedRouteError(state);
 
 	useInvalidPreventRemoveError(descriptors);
@@ -496,7 +492,7 @@ function NativeStackViewContent() {
 
 	return (
 		<>
-			{shouldShowFloatOverlay ? <Overlay.Float /> : null}
+			<Overlay.Float />
 			<ScreenStack style={styles.container}>
 				{scenes.map((scene, index) => {
 					const { route, descriptor, isPreloaded } = scene;

package/src/shared/adapters/with-screen-transitions/stack-layout.tsx

@@ -182,7 +182,7 @@ function ScreenTransitionsStackContent({
 	return (
 		<ScreenTransitionsAdapterProvider value={adapterContextValue}>
 			<StackProvider value={stackContextValue}>
-				{transitionState.shouldShowFloatOverlay ? <Overlay.Float /> : null}
+				<Overlay.Float />
 				{children}
 			</StackProvider>
 		</ScreenTransitionsAdapterProvider>

package/src/shared/components/boundary/components/boundary-lifecycle.tsx

@@ -0,0 +1,53 @@
+import { memo } from "react";
+import type { View } from "react-native";
+import type { AnimatedRef } from "react-native-reanimated";
+import { useDescriptorsStore } from "../../../providers/screen/descriptors";
+import type { BoundTag } from "../../../stores/bounds/types";
+import { useBoundaryMeasurement } from "../hooks/use-boundary-measurement";
+import type {
+	BoundaryConfigProps,
+	BoundaryLocalMeasurementValue,
+} from "../types";
+
+interface BoundaryLifecycleProps {
+	boundTag: BoundTag;
+	config: BoundaryConfigProps;
+	currentScreenKey: string;
+	enabled: boolean;
+	escapeClipping: boolean;
+	handoff: boolean;
+	localMeasurement: BoundaryLocalMeasurementValue;
+	measuredRef: AnimatedRef<View>;
+	style?: unknown;
+}
+
+export const BoundaryLifecycle = memo(function BoundaryLifecycle({
+	boundTag,
+	config,
+	currentScreenKey,
+	enabled,
+	escapeClipping,
+	handoff,
+	localMeasurement,
+	measuredRef,
+	style,
+}: BoundaryLifecycleProps) {
+	const hasConfiguredInterpolator = useDescriptorsStore(
+		(s) => s.derivations.hasConfiguredInterpolator,
+	);
+
+	useBoundaryMeasurement({
+		boundTag,
+		enabled,
+		runtimeEnabled: enabled && hasConfiguredInterpolator,
+		currentScreenKey,
+		measuredRef,
+		style,
+		handoff,
+		escapeClipping,
+		localMeasurement,
+		config,
+	});
+
+	return null;
+});

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

@@ -39,14 +39,12 @@ const MAX_HANDSHAKE_RETRIES = 20;
 interface UseInitialDestinationMeasurementParams {
 	boundTag: BoundTag;
 	enabled: boolean;
-	escapeClipping: boolean;
 	measureBoundary: MeasureBoundary;
 }
 
 export const useInitialDestinationMeasurement = ({
 	boundTag,
 	enabled,
-	escapeClipping,
 	measureBoundary,
 }: UseInitialDestinationMeasurementParams) => {
 	const { tag, linkKey, group } = boundTag;
@@ -142,18 +140,12 @@ export const useInitialDestinationMeasurement = ({
 		runOnUI(claimLifecycleStartBlock)();
 
 		return () => {
-			if (escapeClipping) {
-				// The portal host owns the release after this boundary hands off.
-				return;
-			}
-
 			// This is an abandonment fallback, not a second release. Run it on the UI
 			// runtime so it serializes with the handshake's guarded release.
 			runOnUI(releaseLifecycleStartBlock)();
 		};
 	}, [
 		claimLifecycleStartBlock,
-		escapeClipping,
 		canReceiveDestination,
 		releaseLifecycleStartBlock,
 	]);
@@ -247,12 +239,6 @@ export const useInitialDestinationMeasurement = ({
 				cancelAnimation(retryToken);
 				handshakeRetries.set(0);
 				hasFinishedInitialMeasurement.set(1);
-				if (escapeClipping) {
-					// Screen-level escape has a second readiness phase after destination
-					// matching: the host must commit before the transition starts, or
-					// the payload can disappear for a frame.
-					return;
-				}
 				releaseLifecycleStartBlock();
 				return;
 			}

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

@@ -33,14 +33,24 @@ export const useRefreshBoundary = ({
 		refreshScreenKey,
 		"willAnimate",
 	);
+	const refreshSettled = AnimationStore.getValue(
+		refreshScreenKey,
+		"progressSettled",
+	);
 	const refreshClosing = AnimationStore.getValue(refreshScreenKey, "closing");
 
 	useAnimatedReaction(
 		() => {
 			"worklet";
 
-			const shouldRefresh = enabled && !!refreshWillAnimate.get();
-			if (!shouldRefresh) {
+			if (!enabled) return null;
+
+			const shouldRefresh = !!refreshWillAnimate.get();
+			const settled = !!refreshSettled.get();
+			// A group's active member can change while the transition is settled
+			// (for example, paging a destination gallery). Let that member publish
+			// fresh bounds even though there is no willAnimate lifecycle pulse yet.
+			if (!shouldRefresh && (!group || !settled)) {
 				return null;
 			}
 			const sourcePairKey =
@@ -56,6 +66,7 @@ export const useRefreshBoundary = ({
 				linkId: linkKey,
 				group,
 				shouldRefresh,
+				settled,
 				closing: !!refreshClosing.get(),
 				linkState: pairs.get(),
 			});

package/src/shared/components/boundary/hooks/use-boundary-measurement.ts

@@ -3,7 +3,10 @@ import type { View } from "react-native";
 import type { AnimatedRef } from "react-native-reanimated";
 import type { BoundTag } from "../../../stores/bounds/types";
 import { prepareStyleForBounds } from "../../../utils/bounds/helpers/styles/styles";
-import type { BoundaryConfigProps } from "../types";
+import type {
+	BoundaryConfigProps,
+	BoundaryLocalMeasurementValue,
+} from "../types";
 import { useBoundaryPresence } from "./lifecycles/use-boundary-presence";
 import { useInitialDestinationMeasurement } from "./lifecycles/use-initial-destination-measurement";
 import { useInitialSourceMeasurement } from "./lifecycles/use-initial-source-measurement";
@@ -23,6 +26,7 @@ interface UseBoundaryMeasurementParams {
 	style?: unknown;
 	handoff: boolean;
 	escapeClipping: boolean;
+	localMeasurement: BoundaryLocalMeasurementValue;
 	config: BoundaryConfigProps;
 }
 
@@ -40,6 +44,7 @@ export const useBoundaryMeasurement = ({
 	style,
 	handoff,
 	escapeClipping,
+	localMeasurement,
 	config,
 }: UseBoundaryMeasurementParams) => {
 	const { anchor, scaleMode, target, method } = config;
@@ -58,6 +63,7 @@ export const useBoundaryMeasurement = ({
 		measuredAnimatedRef: measuredRef,
 		handoff,
 		escapeClipping,
+		localMeasurement,
 	});
 
 	// Presence and source capture must not depend on this screen owning an
@@ -81,7 +87,6 @@ export const useBoundaryMeasurement = ({
 	useInitialDestinationMeasurement({
 		boundTag,
 		enabled: runtimeEnabled,
-		escapeClipping,
 		measureBoundary,
 	});
 

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

@@ -8,7 +8,7 @@ import type { BoundTag } from "../../../stores/bounds/types";
 import { ScrollStore } from "../../../stores/scroll.store";
 import { SystemStore } from "../../../stores/system.store";
 import { getVisibilityBlockOffset } from "../../../utils/visibility-block-offset";
-import type { MeasureBoundary } from "../types";
+import type { BoundaryLocalMeasurementValue, MeasureBoundary } from "../types";
 import {
 	attachScrollSnapshotToMeasuredBounds,
 	correctMeasuredBoundsForVisibilityGate,
@@ -24,6 +24,7 @@ interface UseMeasurerParams {
 	measuredAnimatedRef: AnimatedRef<View>;
 	handoff: boolean;
 	escapeClipping: boolean;
+	localMeasurement: BoundaryLocalMeasurementValue;
 }
 
 export const useMeasurer = ({
@@ -34,6 +35,7 @@ export const useMeasurer = ({
 	measuredAnimatedRef,
 	handoff,
 	escapeClipping,
+	localMeasurement,
 }: UseMeasurerParams): MeasureBoundary => {
 	const { width: viewportWidth, height: viewportHeight } =
 		useWindowDimensions();
@@ -66,6 +68,13 @@ export const useMeasurer = ({
 				viewportHeight,
 			});
 
+			if (escapeClipping && target.type === "source") {
+				localMeasurement.set({
+					bounds: measured,
+					pairKey: target.pairKey,
+				});
+			}
+
 			/**
 			 * - Destination Pass -
 			 * Be strict while lifecycle start is blocked for destination capture.
@@ -112,6 +121,7 @@ export const useMeasurer = ({
 			measuredAnimatedRef,
 			handoff,
 			escapeClipping,
+			localMeasurement,
 			viewportWidth,
 			viewportHeight,
 			scrollState,

package/src/shared/components/boundary/portal/components/boundary-content-portal/hooks/use-boundary-content-portal-attachment.ts

@@ -24,12 +24,17 @@ interface UseBoundaryContentPortalAttachmentParams {
 export const useBoundaryContentPortalAttachment = ({
 	boundaryId,
 }: UseBoundaryContentPortalAttachmentParams) => {
-	const { nextInterpolatorReady, slotsMap } = useScreenSlots();
+	const { slotsMap } = useScreenSlots();
 
 	const currentScreenKey = useDescriptorsStore(
 		(s) => s.derivations.currentScreenKey,
 	);
+	const nextScreenKey = useDescriptorsStore((s) => s.derivations.nextScreenKey);
 	const sourcePairKey = useDescriptorsStore((s) => s.derivations.sourcePairKey);
+	const destinationSlots = useScreenSlots(nextScreenKey ?? currentScreenKey);
+	const unavailableInterpolatorReady = useSharedValue(0);
+	const interpolatorReady =
+		destinationSlots?.interpolatorReady ?? unavailableInterpolatorReady;
 
 	const activeReceiverScreenKey = useStack(resolveActiveHandoffReceiver);
 	const previousReceiverScreenKey = useStack(resolvePreviousHandoffReceiver);
@@ -85,7 +90,7 @@ export const useBoundaryContentPortalAttachment = ({
 				? link.destination.screenKey
 				: null;
 
-		const interpolatorReady = nextInterpolatorReady.get();
+		const isInterpolatorReady = interpolatorReady.get();
 		const attachedScreenKey = attachedReceiverScreenKey.get();
 
 		const nextReceiverScreenKey = resolveHandoffAttachmentCandidate({
@@ -93,7 +98,7 @@ export const useBoundaryContentPortalAttachment = ({
 			activeReceiverScreenKey,
 			attachedReceiverScreenKey: attachedScreenKey,
 			hasActiveCloseFinished,
-			interpolatorReady: !!interpolatorReady,
+			interpolatorReady: !!isInterpolatorReady,
 			pairChangedDuringClose,
 			pairDestinationScreenKey: pairDestination,
 			previousReceiverScreenKey,
@@ -110,7 +115,7 @@ export const useBoundaryContentPortalAttachment = ({
 
 		const activatingPairDestination =
 			!!pairDestination &&
-			!!interpolatorReady &&
+			!!isInterpolatorReady &&
 			nextReceiverScreenKey === pairDestination;
 
 		const canActivateReceiver =