react-native-screen-transitions 3.3.0 → 3.4.0-alpha.1

package/src/shared/stores/bounds.store.ts

@@ -1,257 +0,0 @@
-import {
-	type MeasuredDimensions,
-	makeMutable,
-	type StyleProps,
-} from "react-native-reanimated";
-
-type TagID = string;
-type ScreenKey = string;
-
-export type Snapshot = {
-	bounds: MeasuredDimensions;
-	styles: StyleProps;
-};
-
-type ScreenIdentifier = {
-	screenKey: ScreenKey;
-	ancestorKeys?: ScreenKey[];
-};
-
-type TagLink = {
-	source: ScreenIdentifier & Snapshot;
-	destination: (ScreenIdentifier & Snapshot) | null;
-};
-
-type TagState = {
-	snapshots: Record<ScreenKey, Snapshot & { ancestorKeys?: ScreenKey[] }>;
-	linkStack: TagLink[];
-};
-
-const registry = makeMutable<Record<TagID, TagState>>({});
-
-function registerSnapshot(
-	tag: TagID,
-	screenKey: ScreenKey,
-	bounds: MeasuredDimensions,
-	styles: StyleProps = {},
-	ancestorKeys?: ScreenKey[],
-) {
-	"worklet";
-	registry.modify((state: any) => {
-		"worklet";
-		if (!state[tag]) {
-			state[tag] = { snapshots: {}, linkStack: [] };
-		}
-		state[tag].snapshots[screenKey] = { bounds, styles, ancestorKeys };
-		return state;
-	});
-}
-
-function setLinkSource(
-	tag: TagID,
-	screenKey: ScreenKey,
-	bounds: MeasuredDimensions,
-	styles: StyleProps = {},
-	ancestorKeys?: ScreenKey[],
-) {
-	"worklet";
-	registry.modify((state: any) => {
-		"worklet";
-		if (!state[tag]) state[tag] = { snapshots: {}, linkStack: [] };
-
-		state[tag].linkStack.push({
-			source: { screenKey, ancestorKeys, bounds, styles },
-			destination: null,
-		});
-		return state;
-	});
-}
-
-function updateLinkSource(
-	tag: TagID,
-	screenKey: ScreenKey,
-	bounds: MeasuredDimensions,
-	styles: StyleProps = {},
-	ancestorKeys?: ScreenKey[],
-) {
-	"worklet";
-	registry.modify((state: any) => {
-		"worklet";
-		const stack = state[tag]?.linkStack;
-		if (!stack || stack.length === 0) return state;
-
-		let targetIndex = -1;
-
-		// Prefer the most recent completed link first.
-		// NOTE: matchesScreenKey is inlined here to avoid a Reanimated
-		// workletization crash caused by nested worklet function calls
-		// inside registry.modify callbacks.
-		for (let i = stack.length - 1; i >= 0; i--) {
-			const link = stack[i];
-			const src = link.source;
-			const srcMatches =
-				src &&
-				(src.screenKey === screenKey ||
-					(src.ancestorKeys?.includes(screenKey) ?? false));
-			if (link.destination && srcMatches) {
-				targetIndex = i;
-				break;
-			}
-		}
-
-		// Fallback to pending links when no completed link matches.
-		if (targetIndex === -1) {
-			for (let i = stack.length - 1; i >= 0; i--) {
-				const src = stack[i].source;
-				if (
-					src &&
-					(src.screenKey === screenKey ||
-						(src.ancestorKeys?.includes(screenKey) ?? false))
-				) {
-					targetIndex = i;
-					break;
-				}
-			}
-		}
-
-		if (targetIndex !== -1) {
-			stack[targetIndex].source = { screenKey, ancestorKeys, bounds, styles };
-		}
-
-		return state;
-	});
-}
-
-function setLinkDestination(
-	tag: TagID,
-	screenKey: ScreenKey,
-	bounds: MeasuredDimensions,
-	styles: StyleProps = {},
-	ancestorKeys?: ScreenKey[],
-) {
-	"worklet";
-	registry.modify((state: any) => {
-		"worklet";
-		const stack = state[tag]?.linkStack;
-		if (!stack || stack.length === 0) return state;
-
-		// Find the topmost link without a destination
-		for (let i = stack.length - 1; i >= 0; i--) {
-			if (stack[i].destination === null) {
-				stack[i].destination = { screenKey, ancestorKeys, bounds, styles };
-				break;
-			}
-		}
-		return state;
-	});
-}
-
-/**
- * Helper to check if a screen identifier matches a given key.
- * Checks both direct screenKey match and ancestor chain.
- */
-function matchesScreenKey(
-	identifier: ScreenIdentifier | null | undefined,
-	key: ScreenKey,
-): boolean {
-	"worklet";
-	if (!identifier) return false;
-
-	// Direct match
-	if (identifier.screenKey === key) return true;
-
-	// Check ancestor chain
-	return identifier.ancestorKeys?.includes(key) ?? false;
-}
-
-/**
- * Get snapshot by tag and optional key.
- * If key is provided, supports ancestor matching - if the key matches any ancestor
- * of a stored snapshot, that snapshot will be returned.
- * If key is omitted, returns the most recently registered snapshot.
- */
-function getSnapshot(tag: TagID, key: ScreenKey): Snapshot | null {
-	"worklet";
-	const tagState = registry.value[tag];
-	if (!tagState) return null;
-
-	// Direct match in occurrences
-	if (tagState.snapshots[key]) {
-		const snap = tagState.snapshots[key];
-		return { bounds: snap.bounds, styles: snap.styles };
-	}
-
-	// Ancestor match
-	for (const screenKey in tagState.snapshots) {
-		const snap = tagState.snapshots[screenKey];
-		if (snap.ancestorKeys?.includes(key)) {
-			return { bounds: snap.bounds, styles: snap.styles };
-		}
-	}
-
-	return null;
-}
-
-function getActiveLink(tag: TagID, screenKey?: ScreenKey): TagLink | null {
-	"worklet";
-	const stack = registry.value[tag]?.linkStack;
-
-	if (!stack || stack.length === 0) {
-		return null;
-	}
-
-	// If screenKey provided, find link involving that screen
-	if (screenKey) {
-		for (let i = stack.length - 1; i >= 0; i--) {
-			const link = stack[i];
-			if (!link.destination) continue;
-
-			const isSource = matchesScreenKey(link.source, screenKey);
-			const isDestination = matchesScreenKey(link.destination, screenKey);
-
-			if (isSource || isDestination) {
-				// If I match the source, I'm closing (going back to where I came from)
-				return link;
-			}
-		}
-		return null;
-	}
-
-	const lastLink = stack[stack.length - 1];
-	return lastLink ? lastLink : null;
-}
-
-/**
- * Clear all snapshots and links for a screen across all tags.
- * Called when a screen unmounts.
- */
-function clear(screenKey: ScreenKey) {
-	"worklet";
-	registry.modify((state: any) => {
-		"worklet";
-		for (const tag in state) {
-			// Remove snapshot
-			if (state[tag].snapshots[screenKey]) {
-				delete state[tag].snapshots[screenKey];
-			}
-
-			// Remove links involving this screen
-			state[tag].linkStack = state[tag].linkStack.filter((link: TagLink) => {
-				const sourceMatches = matchesScreenKey(link.source, screenKey);
-				const destMatches = matchesScreenKey(link.destination, screenKey);
-				return !sourceMatches && !destMatches;
-			});
-		}
-		return state;
-	});
-}
-
-export const BoundStore = {
-	registerSnapshot,
-	setLinkSource,
-	setLinkDestination,
-	updateLinkSource,
-	getActiveLink,
-	getSnapshot,
-	clear,
-};

package/src/shared/utils/gesture/determine-dismissal.ts

@@ -1,80 +0,0 @@
-interface GetAxisThresholdProps {
-	translation: number;
-	velocity: number;
-	screenSize: number;
-	gestureVelocityImpact: number;
-}
-
-interface DetermineDismissalProps {
-	event: {
-		translationX: number;
-		translationY: number;
-		velocityX: number;
-		velocityY: number;
-	};
-	directions: {
-		vertical: boolean;
-		verticalInverted: boolean;
-		horizontal: boolean;
-		horizontalInverted: boolean;
-	};
-	dimensions: { width: number; height: number };
-	gestureVelocityImpact: number;
-}
-
-import { velocity as V } from "./velocity";
-
-const getAxisThreshold = ({
-	translation,
-	velocity,
-	screenSize,
-	gestureVelocityImpact,
-}: GetAxisThresholdProps) => {
-	"worklet";
-	return V.shouldPassDismissalThreshold(
-		translation,
-		velocity,
-		screenSize,
-		gestureVelocityImpact,
-	);
-};
-
-export const determineDismissal = ({
-	event,
-	directions,
-	dimensions,
-	gestureVelocityImpact,
-}: DetermineDismissalProps) => {
-	"worklet";
-
-	let shouldDismiss: boolean = false;
-
-	if (
-		(directions.vertical && event.translationY > 0) ||
-		(directions.verticalInverted && event.translationY < 0)
-	) {
-		const dismiss = getAxisThreshold({
-			translation: event.translationY,
-			velocity: event.velocityY,
-			screenSize: dimensions.height,
-			gestureVelocityImpact,
-		});
-		if (dismiss) shouldDismiss = true;
-	}
-
-	if (
-		(directions.horizontal && event.translationX > 0) ||
-		(directions.horizontalInverted && event.translationX < 0)
-	) {
-		const dismiss = getAxisThreshold({
-			translation: event.translationX,
-			velocity: event.velocityX,
-			screenSize: dimensions.width,
-			gestureVelocityImpact,
-		});
-
-		if (dismiss) shouldDismiss = true;
-	}
-
-	return { shouldDismiss };
-};

package/src/shared/utils/gesture/map-gesture-to-progress.ts

@@ -1,11 +0,0 @@
-/**
- * Utility function to map raw gesture translation to a progress value.
- */
-export const mapGestureToProgress = (
-	translation: number,
-	dimension: number,
-) => {
-	"worklet";
-	const rawProgress = translation / dimension;
-	return Math.max(0, Math.min(1, rawProgress));
-};

package/src/shared/utils/gesture/reset-gesture-values.ts

@@ -1,67 +0,0 @@
-import type {
-	GestureStateChangeEvent,
-	PanGestureHandlerEventPayload,
-} from "react-native-gesture-handler";
-import type { GestureStoreMap } from "../../stores/gesture.store";
-import type { AnimationConfig } from "../../types/animation.types";
-import { animate } from "../animation/animate";
-import { velocity } from "./velocity";
-
-interface ResetGestureValuesProps {
-	spec?: AnimationConfig;
-	gestures: GestureStoreMap;
-	shouldDismiss: boolean;
-	event: GestureStateChangeEvent<PanGestureHandlerEventPayload>;
-	dimensions: { width: number; height: number };
-}
-
-export const resetGestureValues = ({
-	spec,
-	gestures,
-	shouldDismiss,
-	event,
-	dimensions,
-}: ResetGestureValuesProps) => {
-	"worklet";
-
-	const vxNorm = velocity.normalize(event.velocityX, dimensions.width);
-	const vyNorm = velocity.normalize(event.velocityY, dimensions.height);
-
-	// Ensure spring starts moving toward zero using normalized gesture values for direction.
-	const nx =
-		gestures.normalizedX.value ||
-		event.translationX / Math.max(1, dimensions.width);
-
-	const ny =
-		gestures.normalizedY.value ||
-		event.translationY / Math.max(1, dimensions.height);
-
-	const vxTowardZero = velocity.calculateRestoreVelocity(nx, vxNorm);
-	const vyTowardZero = velocity.calculateRestoreVelocity(ny, vyNorm);
-
-	let remainingAnimations = 4;
-
-	const onFinish = (finished: boolean | undefined) => {
-		"worklet";
-		if (!finished) return;
-		remainingAnimations -= 1;
-		if (remainingAnimations === 0) {
-			gestures.direction.value = null;
-		}
-	};
-
-	gestures.x.value = animate(0, { ...spec, velocity: vxTowardZero }, onFinish);
-	gestures.y.value = animate(0, { ...spec, velocity: vyTowardZero }, onFinish);
-	gestures.normalizedX.value = animate(
-		0,
-		{ ...spec, velocity: vxTowardZero },
-		onFinish,
-	);
-	gestures.normalizedY.value = animate(
-		0,
-		{ ...spec, velocity: vyTowardZero },
-		onFinish,
-	);
-	gestures.isDragging.value = 0;
-	gestures.isDismissing.value = Number(shouldDismiss);
-};

package/src/shared/utils/reset-stores-for-screen.ts

@@ -1,14 +0,0 @@
-import { AnimationStore } from "../stores/animation.store";
-import { BoundStore } from "../stores/bounds.store";
-import { GestureStore } from "../stores/gesture.store";
-import type { BaseStackDescriptor } from "../types/stack.types";
-
-/**
- * Reset all stores for a given screen.
- * Accepts any descriptor that has a route with a key.
- */
-export const resetStoresForScreen = (current: BaseStackDescriptor) => {
-	AnimationStore.clear(current.route.key);
-	GestureStore.clear(current.route.key);
-	BoundStore.clear(current.route.key);
-};