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

package/src/shared/components/create-boundary-component/hooks/helpers/measurement-rules.ts

@@ -1,90 +0,0 @@
-import type { MeasureIntent } from "../../types";
-
-export type MeasureIntentFlags = {
-	captureSource: boolean;
-	completeDestination: boolean;
-	refreshSource: boolean;
-	refreshDestination: boolean;
-};
-
-export type MeasureWritePlan = {
-	captureSource: boolean;
-	completeDestination: boolean;
-	refreshSource: boolean;
-	refreshDestination: boolean;
-	writesAny: boolean;
-	wantsDestinationWrite: boolean;
-};
-
-export const getMeasureIntentFlags = (
-	intent?: MeasureIntent | readonly MeasureIntent[],
-): MeasureIntentFlags => {
-	"worklet";
-	const flags: MeasureIntentFlags = {
-		captureSource: false,
-		completeDestination: false,
-		refreshSource: false,
-		refreshDestination: false,
-	};
-
-	if (!intent) {
-		return flags;
-	}
-
-	const intents = Array.isArray(intent) ? intent : [intent];
-
-	for (let i = 0; i < intents.length; i++) {
-		switch (intents[i]) {
-			case "capture-source":
-				flags.captureSource = true;
-				break;
-			case "complete-destination":
-				flags.completeDestination = true;
-				break;
-			case "refresh-source":
-				flags.refreshSource = true;
-				break;
-			case "refresh-destination":
-				flags.refreshDestination = true;
-				break;
-		}
-	}
-
-	return flags;
-};
-
-export const buildMeasurementWritePlan = (params: {
-	intents: MeasureIntentFlags;
-	hasPendingLink: boolean;
-	hasSourceLink: boolean;
-	hasDestinationLink: boolean;
-	hasAttachableSourceLink: boolean;
-}): MeasureWritePlan => {
-	"worklet";
-	const {
-		intents,
-		hasPendingLink,
-		hasSourceLink,
-		hasDestinationLink,
-		hasAttachableSourceLink,
-	} = params;
-
-	const captureSource = intents.captureSource;
-	const completeDestination =
-		intents.completeDestination && (hasPendingLink || hasAttachableSourceLink);
-	const refreshSource = intents.refreshSource && hasSourceLink;
-	const refreshDestination =
-		intents.refreshDestination &&
-		(hasDestinationLink || hasPendingLink || hasAttachableSourceLink);
-	const writesAny =
-		captureSource || completeDestination || refreshSource || refreshDestination;
-
-	return {
-		captureSource,
-		completeDestination,
-		refreshSource,
-		refreshDestination,
-		writesAny,
-		wantsDestinationWrite: completeDestination || refreshDestination,
-	};
-};

package/src/shared/components/create-boundary-component/hooks/helpers/measurement.ts

@@ -1,25 +0,0 @@
-import type { MeasuredDimensions } from "react-native-reanimated";
-
-export const isMeasurementInViewport = (
-	measured: MeasuredDimensions,
-	viewportWidth: number,
-	viewportHeight: number,
-): boolean => {
-	"worklet";
-
-	if (measured.width <= 0 || measured.height <= 0) {
-		return false;
-	}
-
-	const toleranceX = viewportWidth * 0.15;
-	const toleranceY = viewportHeight * 0.15;
-	const centerX = measured.pageX + measured.width / 2;
-	const centerY = measured.pageY + measured.height / 2;
-
-	return (
-		centerX >= -toleranceX &&
-		centerX <= viewportWidth + toleranceX &&
-		centerY >= -toleranceY &&
-		centerY <= viewportHeight + toleranceY
-	);
-};

package/src/shared/components/create-boundary-component/utils/build-boundary-match-key.ts

@@ -1,14 +0,0 @@
-import type { BoundaryId } from "../types";
-
-type BuildBoundaryMatchKeyParams = {
-	group?: string;
-	id: BoundaryId;
-};
-
-export function buildBoundaryMatchKey(
-	params: BuildBoundaryMatchKeyParams,
-): string {
-	"worklet";
-	const { group, id } = params;
-	return group ? `${group}:${id}` : String(id);
-}

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

@@ -1,53 +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.set(withDelay(delayMs, withTiming(token.get() + 1, { duration: 0 })));
-	};
-
-	const cancel = () => {
-		"worklet";
-		cancelAnimation(token);
-	};
-
-	useAnimatedReaction(
-		() => token.get(),
-		(nextToken, previousToken) => {
-			"worklet";
-			if (nextToken === 0 || nextToken === previousToken) {
-				return;
-			}
-
-			onDebounced();
-		},
-		[delayMs, onDebounced],
-	);
-
-	return { trigger, cancel };
-}

package/src/shared/providers/layout-anchor.provider.tsx

@@ -1,112 +0,0 @@
-import { type ReactNode, useCallback, useMemo } from "react";
-import { useWindowDimensions, type View } from "react-native";
-import {
-	type AnimatedRef,
-	type MeasuredDimensions,
-	measure,
-} from "react-native-reanimated";
-import createProvider from "../utils/create-provider";
-
-interface LayoutAnchorProviderProps {
-	anchorRef: AnimatedRef<View>;
-	children: ReactNode;
-}
-
-interface LayoutAnchorContextValue {
-	/**
-	 * Corrects measured dimensions for parent transforms (translation and scale).
-	 * The anchor should be at (0, 0) with full screen dimensions - any difference
-	 * is from parent transforms. This function reverses those transforms to yield
-	 * the true layout position and dimensions.
-	 */
-	correctMeasurement: (measured: MeasuredDimensions) => MeasuredDimensions;
-	/**
-	 * Returns true when the corrected measurement is plausibly inside viewport space.
-	 * This helps reject transient off-page measurements from paged containers.
-	 */
-	isMeasurementInViewport: (measured: MeasuredDimensions) => boolean;
-}
-
-/**
- * Provides a reference point for correcting bounds measurements.
- *
- * When a parent view has transforms applied (e.g., during screen transitions),
- * `measure()` returns visual positions that include those transforms. This provider
- * establishes an anchor point (typically the screen container at 0,0) and exposes
- * a `correctMeasurement` function that reverses translation and scale transforms
- * to yield the true layout position and dimensions.
- *
- * ## How it works
- *
- * 1. **Translation**: Subtract anchor's pageX/pageY offset
- * 2. **Scale**: Compare anchor's measured size to expected (screen) size to compute
- *    scale factor, then divide positions and dimensions by that factor
- */
-const { LayoutAnchorProvider, useLayoutAnchorContext } = createProvider(
-	"LayoutAnchor",
-	{ guarded: false },
-)<LayoutAnchorProviderProps, LayoutAnchorContextValue>(
-	({ anchorRef, children }) => {
-		const { width: screenWidth, height: screenHeight } = useWindowDimensions();
-
-		const correctMeasurement = useCallback(
-			(measured: MeasuredDimensions): MeasuredDimensions => {
-				"worklet";
-				const anchor = measure(anchorRef);
-				if (!anchor) return measured;
-
-				// Compute scale factor by comparing anchor size to expected screen size.
-				// Anchor should be full-screen (absoluteFill), so any difference is from scale.
-				const scaleX = anchor.width > 0 ? anchor.width / screenWidth : 1;
-				const scaleY = anchor.height > 0 ? anchor.height / screenHeight : 1;
-
-				// Get element position relative to anchor (removes translation)
-				const relativeX = measured.pageX - anchor.pageX;
-				const relativeY = measured.pageY - anchor.pageY;
-
-				// Reverse scale: divide relative position and dimensions by scale factor
-				return {
-					x: measured.x,
-					y: measured.y,
-					width: scaleX !== 1 ? measured.width / scaleX : measured.width,
-					height: scaleY !== 1 ? measured.height / scaleY : measured.height,
-					pageX: scaleX !== 1 ? relativeX / scaleX : relativeX,
-					pageY: scaleY !== 1 ? relativeY / scaleY : relativeY,
-				};
-			},
-			[anchorRef, screenWidth, screenHeight],
-		);
-
-		const isMeasurementInViewport = useCallback(
-			(measured: MeasuredDimensions): boolean => {
-				"worklet";
-				if (measured.width <= 0 || measured.height <= 0) return false;
-
-				const toleranceX = screenWidth * 0.15;
-				const toleranceY = screenHeight * 0.15;
-				const centerX = measured.pageX + measured.width / 2;
-				const centerY = measured.pageY + measured.height / 2;
-
-				return (
-					centerX >= -toleranceX &&
-					centerX <= screenWidth + toleranceX &&
-					centerY >= -toleranceY &&
-					centerY <= screenHeight + toleranceY
-				);
-			},
-			[screenWidth, screenHeight],
-		);
-
-		const value = useMemo(
-			() => ({ correctMeasurement, isMeasurementInViewport }),
-			[correctMeasurement, isMeasurementInViewport],
-		);
-
-		return {
-			value,
-			children,
-		};
-	},
-);
-
-export { LayoutAnchorProvider, useLayoutAnchorContext };

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

@@ -1,335 +0,0 @@
-import type { SharedValue } from "react-native-reanimated";
-import {
-	ANIMATION_SNAP_THRESHOLD,
-	EPSILON,
-	FALSE,
-	TRUE,
-} from "../../../../constants";
-import type { GestureStoreMap } from "../../../../stores/gesture.store";
-import type {
-	ScreenTransitionOptions,
-	ScreenTransitionState,
-} from "../../../../types/animation.types";
-import type { Layout } from "../../../../types/screen.types";
-import type { BaseStackRoute } from "../../../../types/stack.types";
-
-type BuiltState = {
-	progress: SharedValue<number>;
-	willAnimate: SharedValue<number>;
-	closing: SharedValue<number>;
-	animating: SharedValue<number>;
-	entering: SharedValue<number>;
-	settled: SharedValue<number>;
-	logicallySettled: SharedValue<number>;
-	gesture: GestureStoreMap;
-	route: BaseStackRoute;
-	meta?: Record<string, unknown>;
-	options: ScreenTransitionOptions;
-	navigationMaskEnabled: boolean;
-	targetProgress: SharedValue<number>;
-	resolvedAutoSnapPoint: SharedValue<number>;
-	measuredContentLayout: SharedValue<Layout | null>;
-	contentLayoutSlot: Layout;
-	hasAutoSnapPoint: boolean;
-	sortedNumericSnapPoints: number[];
-	unwrapped: ScreenTransitionState;
-};
-
-interface ComputeLogicallySettledParams {
-	progress: number;
-	targetProgress: number;
-	settled: number;
-	gestureActive: number;
-}
-
-const computeSettled = (
-	animating: number,
-	dismissing: number,
-	closing: number,
-) => {
-	"worklet";
-	return animating || dismissing || closing ? FALSE : TRUE;
-};
-
-const getResolvedSnapPointCount = (
-	snapPoints: number[],
-	resolvedAutoSnap: number | null,
-) => {
-	"worklet";
-	return snapPoints.length + (resolvedAutoSnap !== null ? 1 : 0);
-};
-
-const getAutoSnapPointIndex = (
-	snapPoints: number[],
-	resolvedAutoSnap: number,
-) => {
-	"worklet";
-	let index = 0;
-
-	while (index < snapPoints.length && snapPoints[index] <= resolvedAutoSnap) {
-		index++;
-	}
-
-	return index;
-};
-
-const getResolvedSnapPointAt = (
-	snapPoints: number[],
-	resolvedAutoSnap: number | null,
-	autoSnapPointIndex: number,
-	index: number,
-) => {
-	"worklet";
-	if (resolvedAutoSnap === null) {
-		return snapPoints[index];
-	}
-
-	if (index < autoSnapPointIndex) {
-		return snapPoints[index];
-	}
-
-	if (index === autoSnapPointIndex) {
-		return resolvedAutoSnap;
-	}
-
-	return snapPoints[index - 1];
-};
-
-const computeAnimatedSnapIndex = (
-	progress: number,
-	snapPoints: number[],
-	resolvedAutoSnap: number | null,
-): number => {
-	"worklet";
-	const snapPointCount = getResolvedSnapPointCount(
-		snapPoints,
-		resolvedAutoSnap,
-	);
-
-	if (snapPointCount === 0) return -1;
-
-	const autoSnapPointIndex =
-		resolvedAutoSnap === null
-			? -1
-			: getAutoSnapPointIndex(snapPoints, resolvedAutoSnap);
-	const firstSnapPoint = getResolvedSnapPointAt(
-		snapPoints,
-		resolvedAutoSnap,
-		autoSnapPointIndex,
-		0,
-	);
-	const lastSnapPoint = getResolvedSnapPointAt(
-		snapPoints,
-		resolvedAutoSnap,
-		autoSnapPointIndex,
-		snapPointCount - 1,
-	);
-
-	if (progress <= firstSnapPoint) return 0;
-	if (progress >= lastSnapPoint) return snapPointCount - 1;
-
-	for (let i = 0; i < snapPointCount - 1; i++) {
-		const currentSnapPoint = getResolvedSnapPointAt(
-			snapPoints,
-			resolvedAutoSnap,
-			autoSnapPointIndex,
-			i,
-		);
-		const nextSnapPoint = getResolvedSnapPointAt(
-			snapPoints,
-			resolvedAutoSnap,
-			autoSnapPointIndex,
-			i + 1,
-		);
-
-		if (progress <= nextSnapPoint) {
-			const t =
-				(progress - currentSnapPoint) / (nextSnapPoint - currentSnapPoint);
-			return i + t;
-		}
-	}
-	return snapPointCount - 1;
-};
-
-const computeTargetSnapIndex = (
-	targetProgress: number,
-	snapPoints: number[],
-	resolvedAutoSnap: number | null,
-): number => {
-	"worklet";
-	const snapPointCount = getResolvedSnapPointCount(
-		snapPoints,
-		resolvedAutoSnap,
-	);
-
-	if (snapPointCount === 0) return -1;
-
-	const autoSnapPointIndex =
-		resolvedAutoSnap === null
-			? -1
-			: getAutoSnapPointIndex(snapPoints, resolvedAutoSnap);
-	const firstSnapPoint = getResolvedSnapPointAt(
-		snapPoints,
-		resolvedAutoSnap,
-		autoSnapPointIndex,
-		0,
-	);
-
-	if (targetProgress <= 0 && Math.abs(firstSnapPoint) > EPSILON) {
-		return -1;
-	}
-
-	let nearestIndex = 0;
-	let smallestDistance = Math.abs(targetProgress - firstSnapPoint);
-
-	for (let i = 1; i < snapPointCount; i++) {
-		const snapPoint = getResolvedSnapPointAt(
-			snapPoints,
-			resolvedAutoSnap,
-			autoSnapPointIndex,
-			i,
-		);
-		const distance = Math.abs(targetProgress - snapPoint);
-
-		if (distance < smallestDistance) {
-			smallestDistance = distance;
-			nearestIndex = i;
-		}
-	}
-
-	return nearestIndex;
-};
-
-const computeLogicallySettledValue = (
-	progress: number,
-	targetProgress: number,
-	settled: number,
-	gestureActive: number,
-) => {
-	"worklet";
-
-	if (settled) {
-		return TRUE;
-	}
-
-	if (gestureActive) {
-		return FALSE;
-	}
-
-	return Math.abs(progress - targetProgress) <= ANIMATION_SNAP_THRESHOLD
-		? TRUE
-		: FALSE;
-};
-
-export const computeLogicallySettled = (
-	params: ComputeLogicallySettledParams,
-) => {
-	"worklet";
-	return computeLogicallySettledValue(
-		params.progress,
-		params.targetProgress,
-		params.settled,
-		params.gestureActive,
-	);
-};
-
-export const hydrateTransitionState = (
-	s: BuiltState,
-	dimensions: Layout,
-): ScreenTransitionState => {
-	"worklet";
-	const out = s.unwrapped;
-	out.progress = s.progress.get();
-	out.willAnimate = s.willAnimate.get();
-	out.closing = s.closing.get();
-	out.entering = s.entering.get();
-	out.gesture.x = s.gesture.x.get();
-	out.gesture.y = s.gesture.y.get();
-	out.gesture.normX = s.gesture.normX.get();
-	out.gesture.normY = s.gesture.normY.get();
-	out.gesture.scale = s.gesture.scale.get();
-	out.gesture.normScale = s.gesture.normScale.get();
-	out.gesture.focalX = s.gesture.focalX.get();
-	out.gesture.focalY = s.gesture.focalY.get();
-	out.gesture.raw.x = s.gesture.raw.x.get();
-	out.gesture.raw.y = s.gesture.raw.y.get();
-	out.gesture.raw.normX = s.gesture.raw.normX.get();
-	out.gesture.raw.normY = s.gesture.raw.normY.get();
-	out.gesture.raw.scale = s.gesture.raw.scale.get();
-	out.gesture.raw.normScale = s.gesture.raw.normScale.get();
-	out.gesture.dismissing = s.gesture.dismissing.get();
-	out.gesture.dragging = s.gesture.dragging.get();
-	out.gesture.settling = s.gesture.settling.get();
-	out.gesture.active = s.gesture.active.get();
-	out.gesture.direction = s.gesture.direction.get();
-
-	const isGestureSettling =
-		Math.abs(out.gesture.normX) > EPSILON ||
-		Math.abs(out.gesture.normY) > EPSILON ||
-		Math.abs(out.gesture.normScale) > EPSILON;
-	const isGestureActive =
-		out.gesture.dragging || out.gesture.settling || isGestureSettling
-			? TRUE
-			: FALSE;
-
-	out.animating = s.animating.get() || isGestureActive ? 1 : 0;
-
-	out.gesture.normalizedX = out.gesture.normX;
-	out.gesture.normalizedY = out.gesture.normY;
-	out.gesture.isDismissing = out.gesture.dismissing;
-	out.gesture.isDragging = out.gesture.dragging;
-
-	out.settled = computeSettled(
-		out.animating,
-		out.gesture.dismissing,
-		out.closing,
-	);
-	const targetProgress = s.targetProgress.get();
-	out.logicallySettled = computeLogicallySettledValue(
-		out.progress,
-		targetProgress,
-		out.settled,
-		isGestureActive,
-	);
-
-	if (s.settled.get() !== out.settled) {
-		s.settled.set(out.settled);
-	}
-
-	if (s.logicallySettled.get() !== out.logicallySettled) {
-		s.logicallySettled.set(out.logicallySettled);
-	}
-
-	out.meta = s.meta;
-	out.options = s.options;
-	out.route = s.route;
-	out.layouts.screen.width = dimensions.width;
-	out.layouts.screen.height = dimensions.height;
-	out.layouts.navigationMaskEnabled = s.navigationMaskEnabled;
-
-	const content = s.measuredContentLayout.get();
-	if (content) {
-		s.contentLayoutSlot.width = content.width;
-		s.contentLayoutSlot.height = content.height;
-		out.layouts.content = s.contentLayoutSlot;
-	} else {
-		out.layouts.content = undefined;
-	}
-
-	const autoSnapPoint = s.resolvedAutoSnapPoint.get();
-	const resolvedAutoSnap =
-		s.hasAutoSnapPoint && autoSnapPoint > 0 ? autoSnapPoint : null;
-
-	out.animatedSnapIndex = computeAnimatedSnapIndex(
-		out.progress,
-		s.sortedNumericSnapPoints,
-		resolvedAutoSnap,
-	);
-	out.snapIndex = computeTargetSnapIndex(
-		targetProgress,
-		s.sortedNumericSnapPoints,
-		resolvedAutoSnap,
-	);
-
-	return out;
-};

package/src/shared/providers/screen/animation/helpers/resolve-screen-animation-target.ts

@@ -1,42 +0,0 @@
-import type { ScreenAnimationTarget } from "../types";
-
-type Params<T> = {
-	target: ScreenAnimationTarget | undefined;
-	self: T;
-	ancestors: T[];
-};
-
-const isAncestorTarget = (
-	target: ScreenAnimationTarget,
-): target is { ancestor: number } => {
-	return typeof target === "object" && target !== null && "ancestor" in target;
-};
-
-export function resolveScreenAnimationTarget<T>({
-	target,
-	self,
-	ancestors,
-}: Params<T>): T {
-	if (!target || target === "self") {
-		return self;
-	}
-
-	if (target === "parent") {
-		return ancestors[0] ?? self;
-	}
-
-	if (target === "root") {
-		return ancestors[ancestors.length - 1] ?? self;
-	}
-
-	if (!isAncestorTarget(target)) {
-		return self;
-	}
-
-	const depth = target.ancestor;
-	if (!Number.isInteger(depth) || depth < 1) {
-		return self;
-	}
-
-	return ancestors[depth - 1] ?? self;
-}

package/src/shared/providers/screen/descriptors/helpers/get-ancestor-navigator-keys.ts

@@ -1,29 +0,0 @@
-import type { BaseStackDescriptor } from "../../../../types/stack.types";
-
-/**
- * Builds the parent navigator key chain for nested navigators.
- * Returns keys from immediate parent navigator to root navigator.
- */
-export function getAncestorNavigatorKeys(
-	current: BaseStackDescriptor,
-): string[] {
-	const ancestors: string[] = [];
-	const nav = current.navigation as any;
-
-	if (typeof nav?.getParent !== "function") {
-		return ancestors;
-	}
-
-	let parent = nav.getParent();
-
-	while (parent) {
-		const state = parent.getState?.();
-		const key = state?.key;
-		if (typeof key === "string") {
-			ancestors.push(key);
-		}
-		parent = parent.getParent?.();
-	}
-
-	return ancestors;
-}