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

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

@@ -1,68 +0,0 @@
-import { useMemo } from "react";
-import { snapDescriptorToIndex } from "../../../animation/snap-to";
-import { useOptimisticFocusedIndex } from "../../../hooks/navigation/use-optimistic-focused-index";
-import {
-	type StackDescriptor,
-	type StackScene,
-	useStack,
-} from "../../../hooks/navigation/use-stack";
-import { useDescriptors } from "../../../providers/screen/descriptors";
-import type { OverlayScreenState } from "../../../types/overlay.types";
-import { isScreenOverlayVisible } from "../../../utils/overlay/visibility";
-import { OverlayHost } from "./overlay-host";
-
-/**
- * Screen overlay component that renders per-screen.
- * Gets current descriptor from keys context.
- *
- * @deprecated Screen overlays are deprecated. For per-screen overlays, render an
- * absolute-positioned view directly in your screen component and use `useScreenAnimation()`
- * to access animation values. This component will be removed in a future version.
- */
-export function ScreenOverlay() {
-	const { current } = useDescriptors<StackDescriptor>();
-	const { flags, routes, optimisticFocusedIndex, routeKeys } = useStack();
-	const focusedIndex = useOptimisticFocusedIndex(
-		optimisticFocusedIndex,
-		routeKeys.length,
-	);
-
-	const options = current.options;
-
-	const scene = useMemo<StackScene>(
-		() => ({
-			descriptor: current,
-			route: current.route,
-		}),
-		[current],
-	);
-
-	const overlayScreenState = useMemo<
-		OverlayScreenState<StackDescriptor["navigation"]>
-	>(
-		() => ({
-			index: routeKeys.indexOf(current.route.key),
-			options: current.options,
-			routes,
-			focusedRoute: routes[focusedIndex] ?? current.route,
-			focusedIndex,
-			meta: current.options?.meta,
-			navigation: current.navigation,
-			snapTo: (index: number) => {
-				snapDescriptorToIndex(current, index);
-			},
-		}),
-		[current, routeKeys, routes, focusedIndex],
-	);
-
-	// Skip screens without enableTransitions (native-stack only)
-	if (!flags.TRANSITIONS_ALWAYS_ON && !options.enableTransitions) {
-		return null;
-	}
-
-	if (!isScreenOverlayVisible(options)) {
-		return null;
-	}
-
-	return <OverlayHost scene={scene} overlayScreenState={overlayScreenState} />;
-}

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

@@ -1,39 +0,0 @@
-import type { ReactNode } from "react";
-import { useMemo } from "react";
-import { type ScaledSize, useWindowDimensions } from "react-native";
-import {
-	type EdgeInsets,
-	useSafeAreaInsets,
-} from "react-native-safe-area-context";
-import createProvider from "../utils/create-provider";
-
-export interface ViewportContextValue {
-	dimensions: ScaledSize;
-	insets: EdgeInsets;
-}
-
-interface ViewportProviderProps {
-	children: ReactNode;
-}
-
-const { ViewportProvider, useViewportContext } = createProvider("Viewport", {
-	guarded: true,
-})<ViewportProviderProps, ViewportContextValue>(({ children }) => {
-	const dimensions = useWindowDimensions();
-	const insets = useSafeAreaInsets();
-
-	const value = useMemo(
-		() => ({
-			dimensions,
-			insets,
-		}),
-		[dimensions, insets],
-	);
-
-	return {
-		value,
-		children,
-	};
-});
-
-export { ViewportProvider, useViewportContext };

package/src/shared/utils/bounds/helpers/math.ts

@@ -1,161 +0,0 @@
-type CombinedScaleMode = "multiply" | "average" | "max" | "min";
-
-export const clamp = (value: number, min: number, max: number): number => {
-	"worklet";
-	const lower = min < max ? min : max;
-	const upper = max > min ? max : min;
-
-	if (value < lower) return lower;
-	if (value > upper) return upper;
-
-	return value;
-};
-
-export const clamp01 = (value: number): number => {
-	"worklet";
-	return clamp(value, 0, 1);
-};
-
-export const lerp = (from: number, to: number, t: number): number => {
-	"worklet";
-	return from + (to - from) * t;
-};
-
-export const safeDivide = (
-	numerator: number,
-	denominator: number,
-	fallback = 0,
-): number => {
-	"worklet";
-	if (denominator === 0) return fallback;
-	return numerator / denominator;
-};
-
-export const inverseLerp = (
-	value: number,
-	inMin: number,
-	inMax: number,
-): number => {
-	"worklet";
-	return safeDivide(value - inMin, inMax - inMin, 0);
-};
-
-export const mapRangeClamped = (
-	value: number,
-	inMin: number,
-	inMax: number,
-	outMin: number,
-	outMax: number,
-): number => {
-	"worklet";
-	const t = clamp01(inverseLerp(value, inMin, inMax));
-	return lerp(outMin, outMax, t);
-};
-
-export const applyPowerCurve = (value: number, exponent: number): number => {
-	"worklet";
-	const safeExponent = exponent > 0 ? exponent : 1;
-	const magnitude = Math.abs(value) ** safeExponent;
-	return value < 0 ? -magnitude : magnitude;
-};
-
-export const normalizedToTranslation = ({
-	normalized,
-	dimension,
-	resistance,
-}: {
-	normalized: number;
-	dimension: number;
-	resistance: number;
-}): number => {
-	"worklet";
-	const distance = Math.max(0, dimension) * resistance;
-	return mapRangeClamped(normalized, -1, 1, -distance, distance);
-};
-
-export const normalizedToScale = ({
-	normalized,
-	outputRange,
-	exponent = 1,
-	positiveOnly = true,
-}: {
-	normalized: number;
-	outputRange: readonly [number, number];
-	exponent?: number;
-	positiveOnly?: boolean;
-}): number => {
-	"worklet";
-	const [outputStart, outputEnd] = outputRange;
-	const raw = positiveOnly
-		? mapRangeClamped(normalized, 0, 1, outputStart, outputEnd)
-		: mapRangeClamped(normalized, -1, 1, outputStart, outputEnd);
-
-	return applyPowerCurve(raw, exponent);
-};
-
-export const combineScales = (
-	scaleX: number,
-	scaleY: number,
-	mode: CombinedScaleMode = "multiply",
-): number => {
-	"worklet";
-
-	switch (mode) {
-		case "average":
-			return (scaleX + scaleY) / 2;
-		case "max":
-			return Math.max(scaleX, scaleY);
-		case "min":
-			return Math.min(scaleX, scaleY);
-		default:
-			return scaleX * scaleY;
-	}
-};
-
-export const computeCenterScaleShift = ({
-	center,
-	containerCenter,
-	scale,
-}: {
-	center: number;
-	containerCenter: number;
-	scale: number;
-}): number => {
-	"worklet";
-	return (center - containerCenter) * (scale - 1);
-};
-
-export const compensateTranslationForParentScale = ({
-	translation,
-	parentScale,
-	epsilon,
-}: {
-	translation: number;
-	parentScale: number;
-	epsilon: number;
-}): number => {
-	"worklet";
-	const safeParentScale = Math.max(parentScale, epsilon);
-	return safeDivide(translation, safeParentScale, translation);
-};
-
-export const composeCompensatedTranslation = ({
-	gesture,
-	parentScale,
-	centerShift = 0,
-	epsilon,
-}: {
-	gesture: number;
-	parentScale: number;
-	centerShift?: number;
-	epsilon: number;
-}): number => {
-	"worklet";
-	return (
-		compensateTranslationForParentScale({
-			translation: gesture,
-			parentScale,
-			epsilon,
-		}) + centerShift
-	);
-};

package/src/shared/utils/bounds/helpers/navigation-accessor.ts

@@ -1,61 +0,0 @@
-import type { ScreenInterpolationProps } from "../../../types/animation.types";
-import type { BoundsNavigationOptions } from "../../../types/bounds.types";
-import { buildNavigationStyles } from "../sugar/navigation";
-import type { BoundsOptions } from "../types/options";
-import type { ResolveBoundTagParams } from "./resolve-bound-tag";
-
-type NavigationAccessorParams = {
-	id?: string;
-	group?: string;
-	getProps: () => Omit<ScreenInterpolationProps, "bounds">;
-	resolveBoundTag: (params: ResolveBoundTagParams) => string | undefined;
-	computeRaw: (
-		overrides?: Partial<BoundsOptions>,
-		frameProps?: Omit<ScreenInterpolationProps, "bounds">,
-	) => Record<string, unknown>;
-	zoomBaseOptions?: Pick<BoundsOptions, "anchor" | "scaleMode" | "target">;
-};
-
-export const createNavigationAccessor = ({
-	id,
-	group,
-	getProps,
-	resolveBoundTag,
-	computeRaw,
-	zoomBaseOptions,
-}: NavigationAccessorParams) => {
-	"worklet";
-
-	const resolvedId = id ?? "";
-
-	const computeNavigationPresetStyles = (
-		preset: "zoom",
-		navigationOptions?: BoundsNavigationOptions,
-	) => {
-		"worklet";
-		const frameProps = getProps();
-		return buildNavigationStyles({
-			id: resolvedId,
-			group,
-			preset,
-			navigationOptions,
-			props: frameProps,
-			resolveTag: resolveBoundTag,
-			computeRaw: (overrides) =>
-				computeRaw(
-					{
-						...(overrides ?? {}),
-						raw: true,
-					},
-					frameProps,
-				),
-		});
-	};
-
-	return {
-		zoom: () => {
-			"worklet";
-			return computeNavigationPresetStyles("zoom", zoomBaseOptions);
-		},
-	};
-};

package/src/shared/utils/bounds/sugar/navigation/helpers.ts

@@ -1,74 +0,0 @@
-import { BoundStore } from "../../../../stores/bounds";
-import type { BoundsNavigationOptions } from "../../../../types/bounds.types";
-import type { BoundsOptions } from "../../types/options";
-import type { ResolveTag } from "./types";
-
-export const toNumber = (value: unknown, fallback = 0): number => {
-	"worklet";
-	return typeof value === "number" ? value : fallback;
-};
-
-export const resolveNavigationConfig = ({
-	id,
-	group,
-	navigationOptions,
-	currentRouteKey,
-	resolveTag,
-	defaultAnchor,
-}: {
-	id: string;
-	group?: string;
-	navigationOptions?: BoundsNavigationOptions;
-	currentRouteKey?: string;
-	resolveTag: ResolveTag;
-	defaultAnchor: BoundsOptions["anchor"] | undefined;
-}): {
-	resolvedTag: string;
-	sharedOptions: Partial<BoundsOptions>;
-	explicitTarget: BoundsOptions["target"] | undefined;
-} | null => {
-	"worklet";
-	const resolvedTag = resolveTag({ id, group });
-	if (!resolvedTag) return null;
-
-	// Try direct boundary config for the current screen first.
-	const boundaryConfig = currentRouteKey
-		? BoundStore.getBoundaryConfig(resolvedTag, currentRouteKey)
-		: null;
-
-	// Fallback: when the current screen has no Boundary (e.g. a zoom detail
-	// screen without a destination element), inherit config from the link's
-	// source screen so that props like scaleMode propagate to both sides.
-	let effectiveConfig = boundaryConfig;
-	if (!effectiveConfig) {
-		// For no-destination navigation zoom, the focused route won't appear in
-		// a completed link yet. Fall back to the latest unscoped link so source
-		// boundary defaults (anchor/scaleMode/target) still propagate.
-		const scopedLink = currentRouteKey
-			? BoundStore.getActiveLink(resolvedTag, currentRouteKey)
-			: null;
-		const link = scopedLink ?? BoundStore.getActiveLink(resolvedTag);
-		if (link?.source) {
-			effectiveConfig = BoundStore.getBoundaryConfig(
-				resolvedTag,
-				link.source.screenKey,
-			);
-		}
-	}
-
-	const sharedOptions: Partial<BoundsOptions> = {
-		...(navigationOptions ?? {}),
-		anchor:
-			navigationOptions?.anchor ?? effectiveConfig?.anchor ?? defaultAnchor,
-		scaleMode:
-			navigationOptions?.scaleMode ?? effectiveConfig?.scaleMode ?? "uniform",
-	};
-
-	const explicitTarget = navigationOptions?.target ?? effectiveConfig?.target;
-
-	return {
-		resolvedTag,
-		sharedOptions,
-		explicitTarget,
-	};
-};

package/src/shared/utils/bounds/sugar/navigation/index.ts

@@ -1,14 +0,0 @@
-import { NO_STYLES } from "../../../../constants";
-import type { BuildNavigationStylesParams } from "./types";
-import { buildZoomNavigationStyles } from "./zoom";
-
-export const buildNavigationStyles = (params: BuildNavigationStylesParams) => {
-	"worklet";
-
-	switch (params.preset) {
-		case "zoom":
-			return buildZoomNavigationStyles(params);
-		default:
-			return NO_STYLES;
-	}
-};

package/src/shared/utils/bounds/sugar/navigation/types.ts

@@ -1,26 +0,0 @@
-import type { ScreenInterpolationProps } from "../../../../types/animation.types";
-import type {
-	BoundsNavigationOptions,
-	BoundsNavigationPreset,
-} from "../../../../types/bounds.types";
-import type { BoundsOptions } from "../../types/options";
-
-export type ResolveTag = (params: {
-	id?: string;
-	group?: string;
-}) => string | undefined;
-
-export type ComputeRaw = (
-	overrides: Partial<BoundsOptions>,
-	frameProps?: Omit<ScreenInterpolationProps, "bounds">,
-) => Record<string, unknown>;
-
-export type BuildNavigationStylesParams = {
-	id: string;
-	group?: string;
-	preset: BoundsNavigationPreset;
-	navigationOptions?: BoundsNavigationOptions;
-	props: Omit<ScreenInterpolationProps, "bounds">;
-	resolveTag: ResolveTag;
-	computeRaw: ComputeRaw;
-};