react-native-screen-transitions 3.5.2 → 3.6.0-alpha.1

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

@@ -1,20 +0,0 @@
-import type { SnapPoint } from "../../types/screen.types";
-/**
- * Filters snap points to only valid, finite numeric values.
- * Excludes zero (dismiss) when canDismiss is false.
- */
-export declare function sanitizeSnapPoints(snapPoints: SnapPoint[], canDismiss: boolean): number[];
-export interface EffectiveSnapPointsResult {
-    hasSnapPoints: boolean;
-    hasAutoSnapPoint: boolean;
-    snapPoints: number[];
-    minSnapPoint: number;
-    maxSnapPoint: number;
-}
-interface ValidateSnapPointsOptions {
-    snapPoints?: SnapPoint[];
-    canDismiss?: boolean;
-}
-export declare const validateSnapPoints: ({ snapPoints, canDismiss, }: ValidateSnapPointsOptions) => EffectiveSnapPointsResult;
-export {};
-//# sourceMappingURL=validate-snap-points.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"validate-snap-points.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/validate-snap-points.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,OAAO,GACjB,MAAM,EAAE,CASV;AAED,MAAM,WAAW,yBAAyB;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,yBAAyB;IAClC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,kBAAkB,GAAI,6BAGhC,yBAAyB,KAAG,yBAqC9B,CAAC"}

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

@@ -1,40 +0,0 @@
-import { useAnimatedReaction } from "react-native-reanimated";
-import { getGroupActiveId } from "../../../stores/bounds/internals/groups";
-import type { BoundaryId, MeasureParams } from "../types";
-
-export const useCaptureSourceBoundary = (params: {
-	enabled: boolean;
-	sharedBoundTag: string;
-	id: BoundaryId;
-	group?: string;
-	nextScreenKey?: string;
-	measureBoundary: (options: MeasureParams) => void;
-}) => {
-	const { enabled, id, group, nextScreenKey, measureBoundary } = params;
-
-	useAnimatedReaction(
-		() => {
-			"worklet";
-			if (!enabled || !nextScreenKey) {
-				return 0;
-			}
-
-			return nextScreenKey;
-		},
-		(captureSignal, previousCaptureSignal) => {
-			"worklet";
-			if (!enabled) return;
-			if (!nextScreenKey) return;
-			if (!captureSignal || captureSignal === previousCaptureSignal) return;
-
-			const currentGroupActiveId = group ? getGroupActiveId(group) : null;
-
-			if (group && currentGroupActiveId !== String(id)) {
-				return;
-			}
-
-			measureBoundary({ intent: "capture-source" });
-		},
-		[enabled, id, group, nextScreenKey, measureBoundary],
-	);
-};

package/src/shared/hooks/gestures/resolve-screen-gesture-target.ts

@@ -1,66 +0,0 @@
-import type { GestureContextType } from "../../providers/gestures";
-import type { ScreenGestureTarget } from "./types";
-
-type ScreenGestureRef = GestureContextType["panGestureRef"] | null;
-
-type Params = {
-	target: ScreenGestureTarget | undefined;
-	self: GestureContextType | null | undefined;
-};
-
-const isAncestorTarget = (
-	target: ScreenGestureTarget,
-): target is { ancestor: number } => {
-	return typeof target === "object" && target !== null && "ancestor" in target;
-};
-
-function getGestureAncestors(self: GestureContextType): GestureContextType[] {
-	const ancestors: GestureContextType[] = [];
-	const startIsolated = self.isIsolated;
-	let current = self.ancestorContext;
-
-	while (current) {
-		if (current.isIsolated !== startIsolated) {
-			break;
-		}
-
-		ancestors.push(current);
-		current = current.ancestorContext;
-	}
-
-	return ancestors;
-}
-
-export function resolveScreenGestureTarget({
-	target,
-	self,
-}: Params): ScreenGestureRef {
-	if (!self) {
-		return null;
-	}
-
-	if (!target || target === "self") {
-		return self.panGestureRef ?? null;
-	}
-
-	const ancestors = getGestureAncestors(self);
-
-	if (target === "parent") {
-		return ancestors[0]?.panGestureRef ?? null;
-	}
-
-	if (target === "root") {
-		return ancestors[ancestors.length - 1]?.panGestureRef ?? null;
-	}
-
-	if (!isAncestorTarget(target)) {
-		return null;
-	}
-
-	const depth = target.ancestor;
-	if (!Number.isInteger(depth) || depth < 1) {
-		return null;
-	}
-
-	return ancestors[depth - 1]?.panGestureRef ?? null;
-}

package/src/shared/hooks/gestures/types.ts

@@ -1,5 +0,0 @@
-export type ScreenGestureTarget =
-	| "self"
-	| "parent"
-	| "root"
-	| { ancestor: number };

package/src/shared/hooks/gestures/use-screen-gesture.ts

@@ -1,26 +0,0 @@
-import { useGestureContext } from "../../providers/gestures";
-import { resolveScreenGestureTarget } from "./resolve-screen-gesture-target";
-import type { ScreenGestureTarget } from "./types";
-
-export type { ScreenGestureTarget } from "./types";
-
-/**
- * Returns a ref to a screen navigation pan gesture.
- * Use this to coordinate child gestures with the navigation gesture.
- *
- * @example
- * ```tsx
- * const screenGesture = useScreenGesture();
- *
- * const myPanGesture = Gesture.Pan()
- *   .waitFor(screenGesture) // Wait for navigation gesture to fail first
- *   .onUpdate(...);
- * ```
- */
-export const useScreenGesture = (target?: ScreenGestureTarget) => {
-	const ctx = useGestureContext();
-	return resolveScreenGestureTarget({
-		target,
-		self: ctx,
-	});
-};

package/src/shared/hooks/gestures/use-scroll-registry.ts

@@ -1,265 +0,0 @@
-/**
- * Connects ScrollViews to the gesture ownership system.
- *
- * Per the spec, ownership is per-direction (not per-axis):
- * - `vertical` and `vertical-inverted` are independent
- * - `horizontal` and `horizontal-inverted` are independent
- *
- * This means a ScrollView on a vertical axis may need to coordinate with
- * multiple gesture owners: one for `vertical` and another for `vertical-inverted`.
- *
- * Example: Settings screen claims `vertical-inverted`, parent workout layout claims `vertical`.
- * The ScrollView should yield to settings for swipe-up at bottom, and to workout for swipe-down at top.
- */
-
-import { useMemo } from "react";
-import type { LayoutChangeEvent } from "react-native";
-import { Gesture, type GestureType } from "react-native-gesture-handler";
-import type { SharedValue } from "react-native-reanimated";
-import { useAnimatedScrollHandler } from "react-native-reanimated";
-import {
-	type GestureContextType,
-	type ScrollConfig,
-	useGestureContext,
-} from "../../providers/gestures";
-import type { Direction } from "../../types/ownership.types";
-import useStableCallback from "../use-stable-callback";
-
-/** Walks up context tree to find the screen that owns a specific direction. */
-function findGestureOwnerForDirection(
-	context: GestureContextType | null | undefined,
-	direction: Direction,
-): GestureContextType | null {
-	let current = context;
-	const startIsolated = context?.isIsolated;
-
-	while (current) {
-		if (startIsolated !== undefined && current.isIsolated !== startIsolated) {
-			break;
-		}
-
-		if (current.claimedDirections?.[direction]) {
-			return current;
-		}
-
-		current = current.ancestorContext;
-	}
-
-	return null;
-}
-
-/**
- * Finds all gesture owners for a scroll axis (both directions).
- * Returns deduplicated list of owners - a snap-point sheet claiming both
- * directions will only appear once.
- */
-function findGestureOwnersForAxis(
-	context: GestureContextType | null | undefined,
-	axis: "vertical" | "horizontal",
-): GestureContextType[] {
-	const directions: [Direction, Direction] =
-		axis === "vertical"
-			? ["vertical", "vertical-inverted"]
-			: ["horizontal", "horizontal-inverted"];
-
-	const owners: GestureContextType[] = [];
-
-	for (const dir of directions) {
-		const owner = findGestureOwnerForDirection(context, dir);
-		if (owner && !owners.includes(owner)) {
-			owners.push(owner);
-		}
-	}
-
-	return owners;
-}
-
-interface ScrollProgressHookProps {
-	onContentSizeChange?: (width: number, height: number) => void;
-	onLayout?: (event: LayoutChangeEvent) => void;
-	direction?: "vertical" | "horizontal";
-}
-
-/**
- * Returns scroll handlers and a native gesture for ScrollView coordination.
- *
- * Finds ALL gesture owners for the scroll axis (both directions) and coordinates
- * with each of them. This ensures that:
- * - A screen claiming `vertical-inverted` can handle swipe-up at bottom boundary
- * - An ancestor claiming `vertical` can handle swipe-down at top boundary
- * - Both work correctly with the same ScrollView
- */
-export const useScrollRegistry = (props: ScrollProgressHookProps) => {
-	const context = useGestureContext();
-	const scrollDirection = props.direction ?? "vertical";
-
-	// Find all owners for both directions on this axis
-	const owners = useMemo(
-		() => findGestureOwnersForAxis(context, scrollDirection),
-		[context, scrollDirection],
-	);
-
-	// Extract scrollConfigs and panGestures from owners
-	const scrollConfigs = useMemo(
-		() =>
-			owners
-				.map((o) => o.scrollConfig)
-				.filter((c): c is SharedValue<ScrollConfig | null> => c !== null),
-		[owners],
-	);
-
-	const panGestures = useMemo(
-		() =>
-			owners
-				.map((o) => o.panGesture)
-				.filter((g): g is GestureType => g !== null),
-		[owners],
-	);
-
-	const nativeGesture = useMemo(() => {
-		if (panGestures.length === 0 || scrollConfigs.length === 0) return null;
-
-		// Update isTouched on ALL registered scrollConfigs
-		const setIsTouched = () => {
-			"worklet";
-			for (const scrollConfig of scrollConfigs) {
-				scrollConfig.modify((v) => {
-					"worklet";
-					if (v) v.isTouched = true;
-					return v;
-				});
-			}
-		};
-
-		const clearIsTouched = () => {
-			"worklet";
-			for (const scrollConfig of scrollConfigs) {
-				scrollConfig.modify((v) => {
-					"worklet";
-					if (v) v.isTouched = false;
-					return v;
-				});
-			}
-		};
-
-		// Native gesture must require ALL pan gestures to fail
-		// This allows any direction owner to take control at the appropriate boundary
-		let gesture = Gesture.Native()
-			.onTouchesDown(setIsTouched)
-			.onTouchesUp(clearIsTouched)
-			.onTouchesCancelled(clearIsTouched);
-
-		for (const panGesture of panGestures) {
-			gesture = gesture.requireExternalGestureToFail(panGesture);
-		}
-
-		return gesture;
-	}, [panGestures, scrollConfigs]);
-
-	const isHorizontal = scrollDirection === "horizontal";
-
-	const scrollHandler = useAnimatedScrollHandler({
-		onScroll: (event) => {
-			if (scrollConfigs.length === 0) return;
-
-			const update = (v: any) => {
-				"worklet";
-				if (v === null) {
-					return {
-						x: isHorizontal ? event.contentOffset.x : 0,
-						y: isHorizontal ? 0 : event.contentOffset.y,
-						contentHeight: 0,
-						contentWidth: 0,
-						layoutHeight: 0,
-						layoutWidth: 0,
-						isTouched: true,
-					};
-				}
-				if (isHorizontal) {
-					v.x = event.contentOffset.x;
-				} else {
-					v.y = event.contentOffset.y;
-				}
-				return v;
-			};
-
-			// Update ALL registered scrollConfigs
-			for (const scrollConfig of scrollConfigs) {
-				scrollConfig.modify(update);
-			}
-		},
-	});
-
-	const onContentSizeChange = useStableCallback(
-		(width: number, height: number) => {
-			props.onContentSizeChange?.(width, height);
-			if (scrollConfigs.length === 0) return;
-
-			const update = (v: any) => {
-				"worklet";
-				if (v === null) {
-					return {
-						x: 0,
-						y: 0,
-						layoutHeight: 0,
-						layoutWidth: 0,
-						contentWidth: isHorizontal ? width : 0,
-						contentHeight: isHorizontal ? 0 : height,
-						isTouched: false,
-					};
-				}
-				if (isHorizontal) {
-					v.contentWidth = width;
-				} else {
-					v.contentHeight = height;
-				}
-				return v;
-			};
-
-			// Update ALL registered scrollConfigs
-			for (const scrollConfig of scrollConfigs) {
-				scrollConfig.modify(update);
-			}
-		},
-	);
-
-	const onLayout = useStableCallback((event: LayoutChangeEvent) => {
-		props.onLayout?.(event);
-		if (scrollConfigs.length === 0) return;
-
-		const { width, height } = event.nativeEvent.layout;
-
-		const update = (v: any) => {
-			"worklet";
-			if (v === null) {
-				return {
-					x: 0,
-					y: 0,
-					contentHeight: 0,
-					contentWidth: 0,
-					layoutHeight: isHorizontal ? 0 : height,
-					layoutWidth: isHorizontal ? width : 0,
-					isTouched: false,
-				};
-			}
-			if (isHorizontal) {
-				v.layoutWidth = width;
-			} else {
-				v.layoutHeight = height;
-			}
-			return v;
-		};
-
-		// Update ALL registered scrollConfigs
-		for (const scrollConfig of scrollConfigs) {
-			scrollConfig.modify(update);
-		}
-	});
-
-	return {
-		scrollHandler,
-		onContentSizeChange,
-		onLayout,
-		nativeGesture,
-	};
-};

package/src/shared/hooks/reanimated/use-animated-debounce.ts

@@ -1,56 +0,0 @@
-import {
-	cancelAnimation,
-	useAnimatedReaction,
-	useSharedValue,
-	withDelay,
-	withTiming,
-} from "react-native-reanimated";
-
-const SCROLL_SETTLE_DELAY_MS = 25;
-
-interface AnimatedDebounceControls {
-	trigger: () => void;
-	cancel: () => void;
-}
-
-/**
- * Debounces a UI-thread callback using Reanimated timing primitives.
- *
- * Call `trigger()` from a worklet to reset the debounce window. When no new
- * trigger arrives within `delayMs`, `onDebounced` fires once on the UI thread.
- */
-export function useAnimatedDebounce(
-	onDebounced: () => void,
-	delayMs: number = SCROLL_SETTLE_DELAY_MS,
-): AnimatedDebounceControls {
-	const token = useSharedValue(0);
-
-	const trigger = () => {
-		"worklet";
-		cancelAnimation(token);
-		token.value = withDelay(
-			delayMs,
-			withTiming(token.value + 1, { duration: 0 }),
-		);
-	};
-
-	const cancel = () => {
-		"worklet";
-		cancelAnimation(token);
-	};
-
-	useAnimatedReaction(
-		() => token.value,
-		(nextToken, previousToken) => {
-			"worklet";
-			if (nextToken === 0 || nextToken === previousToken) {
-				return;
-			}
-
-			onDebounced();
-		},
-		[delayMs, onDebounced],
-	);
-
-	return { trigger, cancel };
-}

package/src/shared/providers/gestures/gestures.provider.tsx

@@ -1,127 +0,0 @@
-/**
- * Gesture System - Core Provider
- *
- * Each screen gets a GestureContext containing:
- * - panGesture: Pan gesture handler for dismiss/snap
- * - scrollConfig: Scroll state for boundary detection
- * - claimedDirections: Which directions this screen handles
- * - childDirectionClaims: Claims registered by descendant screens
- *
- * ScrollView coordination is handled by useScrollRegistry, which finds the
- * gesture owner for the scroll axis and creates appropriate Native gestures.
- */
-
-import { useMemo } from "react";
-import { useSharedValue } from "react-native-reanimated";
-import { StackType } from "../../types/stack.types";
-import createProvider from "../../utils/create-provider";
-import { computeClaimedDirections } from "../../utils/gesture/compute-claimed-directions";
-import { validateSnapPoints } from "../../utils/gesture/validate-snap-points";
-import {
-	useDescriptorDerivations,
-	useDescriptors,
-} from "../screen/descriptors";
-import { useStackCoreContext } from "../stack/core.provider";
-import { useRegisterDirectionClaims } from "./helpers/register-direction-claims";
-import {
-	type DirectionClaimMap,
-	type GestureContextType,
-	NO_CLAIMS,
-	type ScrollConfig,
-} from "./types";
-import { useBuildGestures } from "./use-build-gestures";
-
-interface ScreenGestureProviderProps {
-	children: React.ReactNode;
-}
-
-export const {
-	ScreenGestureProvider,
-	useScreenGestureContext: useGestureContext,
-} = createProvider("ScreenGesture", { guarded: false })<
-	ScreenGestureProviderProps,
-	GestureContextType
->(({ children }): { value: GestureContextType; children: React.ReactNode } => {
-	const { current } = useDescriptors();
-	const { isFirstKey, isTopMostScreen } = useDescriptorDerivations();
-	const { flags } = useStackCoreContext();
-
-	const ancestorContext: GestureContextType | null = useGestureContext();
-	const isIsolated = flags.STACK_TYPE === StackType.COMPONENT;
-	const routeKey = current.route.key;
-
-	const canDismiss = Boolean(
-		isFirstKey ? false : current.options.gestureEnabled,
-	);
-
-	const { hasSnapPoints } = useMemo(
-		() =>
-			validateSnapPoints({
-				snapPoints: current.options.snapPoints,
-				canDismiss,
-			}),
-		[current.options.snapPoints, canDismiss],
-	);
-
-	const gestureEnabled = canDismiss || hasSnapPoints;
-
-	const claimedDirections = useMemo(
-		() =>
-			computeClaimedDirections(
-				gestureEnabled,
-				current.options.gestureDirection,
-				hasSnapPoints,
-			),
-		[gestureEnabled, current.options.gestureDirection, hasSnapPoints],
-	);
-
-	const scrollConfig = useSharedValue<ScrollConfig | null>(null);
-	const childDirectionClaims = useSharedValue<DirectionClaimMap>(NO_CLAIMS);
-
-	useRegisterDirectionClaims(
-		ancestorContext,
-		claimedDirections,
-		routeKey,
-		isIsolated,
-		isTopMostScreen,
-	);
-
-	const { panGesture, panGestureRef, gestureAnimationValues } =
-		useBuildGestures({
-			scrollConfig,
-			ancestorContext,
-			claimedDirections,
-			childDirectionClaims,
-			isIsolated,
-		});
-
-	const value = useMemo<GestureContextType>(
-		() => ({
-			panGesture,
-			panGestureRef,
-			scrollConfig,
-			gestureAnimationValues,
-			ancestorContext,
-			gestureEnabled,
-			isIsolated,
-			claimedDirections,
-			childDirectionClaims,
-		}),
-		[
-			panGesture,
-			panGestureRef,
-			scrollConfig,
-			gestureAnimationValues,
-			ancestorContext,
-			gestureEnabled,
-			isIsolated,
-			claimedDirections,
-			childDirectionClaims,
-		],
-	);
-
-	return {
-		value,
-		children,
-	};
-});