react-native-screen-transitions 3.12.0 → 3.13.0-beta.0

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

@@ -1,51 +0,0 @@
-import { useAnimatedReaction, useSharedValue } from "react-native-reanimated";
-import { useDescriptorsStore } from "../../../../providers/screen/descriptors";
-import { getPairKeyForSource } from "../../../../stores/bounds/internals/links";
-import { pairs } from "../../../../stores/bounds/internals/state";
-import type { BoundTag } from "../../../../stores/bounds/types";
-import type { MeasureBoundary } from "../../types";
-import { getInitialSourceCaptureSignal } from "../../utils/source-signals";
-
-export const useInitialSourceMeasurement = (params: {
-	enabled: boolean;
-	measureBoundary: MeasureBoundary;
-	boundTag: BoundTag;
-}) => {
-	const { enabled, measureBoundary, boundTag } = params;
-	const currentScreenKey = useDescriptorsStore(
-		(s) => s.derivations.currentScreenKey,
-	);
-	const lastSourceCaptureSignal = useSharedValue<string | null>(null);
-
-	useAnimatedReaction(
-		() => {
-			"worklet";
-			const sourcePairKey =
-				getPairKeyForSource(boundTag.tag, currentScreenKey) ?? undefined;
-			return getInitialSourceCaptureSignal({
-				enabled,
-				sourcePairKey,
-				linkId: boundTag.linkKey,
-				group: boundTag.group,
-				linkState: sourcePairKey ? pairs.get() : undefined,
-			});
-		},
-		(captureSignal) => {
-			"worklet";
-			if (!enabled || !captureSignal) {
-				lastSourceCaptureSignal.set(null);
-				return;
-			}
-
-			if (lastSourceCaptureSignal.get() === captureSignal.signal) {
-				return;
-			}
-
-			lastSourceCaptureSignal.set(captureSignal.signal);
-			measureBoundary({
-				type: "source",
-				pairKey: captureSignal.pairKey,
-			});
-		},
-	);
-};

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

@@ -1,90 +0,0 @@
-import { useAnimatedReaction } from "react-native-reanimated";
-import { useDescriptorsStore } from "../../../../providers/screen/descriptors";
-import { AnimationStore } from "../../../../stores/animation.store";
-import {
-	getPairKeyForDestination,
-	getPairKeyForSource,
-} from "../../../../stores/bounds/internals/links";
-import { pairs } from "../../../../stores/bounds/internals/state";
-import type { BoundTag } from "../../../../stores/bounds/types";
-import type { MeasureBoundary } from "../../types";
-import { getRefreshBoundarySignal } from "../../utils/refresh-signals";
-
-interface UseRefreshBoundaryParams {
-	enabled: boolean;
-	boundTag: BoundTag;
-	measureBoundary: MeasureBoundary;
-}
-
-export const useRefreshBoundary = ({
-	enabled,
-	boundTag,
-	measureBoundary,
-}: UseRefreshBoundaryParams) => {
-	const { linkKey, group } = boundTag;
-	const currentScreenKey = useDescriptorsStore(
-		(s) => s.derivations.currentScreenKey,
-	);
-	const nextScreenKey = useDescriptorsStore((s) => s.derivations.nextScreenKey);
-	// Source-side boundaries refresh from the next screen's lifecycle pulse.
-	// Destination-side boundaries have no next screen, so they refresh from self.
-	const refreshScreenKey = nextScreenKey ?? currentScreenKey;
-	const refreshWillAnimate = AnimationStore.getValue(
-		refreshScreenKey,
-		"willAnimate",
-	);
-	const refreshSettled = AnimationStore.getValue(
-		refreshScreenKey,
-		"progressSettled",
-	);
-	const refreshClosing = AnimationStore.getValue(refreshScreenKey, "closing");
-
-	useAnimatedReaction(
-		() => {
-			"worklet";
-
-			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 =
-				getPairKeyForSource(boundTag.tag, currentScreenKey) ?? undefined;
-			const destinationPairKey =
-				getPairKeyForDestination(boundTag.tag, currentScreenKey) ?? undefined;
-
-			return getRefreshBoundarySignal({
-				enabled,
-				currentScreenKey,
-				sourcePairKey,
-				destinationPairKey,
-				linkId: linkKey,
-				group,
-				shouldRefresh,
-				settled,
-				closing: !!refreshClosing.get(),
-				linkState: pairs.get(),
-			});
-		},
-		(refreshSignal, prevRefreshSignal) => {
-			"worklet";
-
-			if (
-				!refreshSignal ||
-				refreshSignal.signal === prevRefreshSignal?.signal
-			) {
-				return;
-			}
-
-			measureBoundary({
-				type: refreshSignal.type,
-				pairKey: refreshSignal.pairKey,
-			});
-		},
-	);
-};

package/src/shared/components/boundary/utils/destination-signals.ts

@@ -1,75 +0,0 @@
-import {
-	getActiveGroupId,
-	getLinkKeyFromTag,
-} from "../../../stores/bounds/helpers/link-pairs.helpers";
-import type {
-	LinkPairsState,
-	ScreenPairKey,
-} from "../../../stores/bounds/types";
-
-export type InitialDestinationMeasurementAction =
-	| "wait"
-	| "release"
-	| "measure"
-	| "complete";
-
-export type InitialDestinationMeasurementSignal = {
-	pairKey: ScreenPairKey | null;
-	action: InitialDestinationMeasurementAction;
-};
-
-export const getInitialDestinationMeasurementSignal = (params: {
-	enabled: boolean;
-	pairKey?: ScreenPairKey;
-	linkId: string;
-	group?: string;
-	destinationPresent: boolean;
-	sourcePresent: boolean;
-	linkState?: LinkPairsState;
-}): InitialDestinationMeasurementSignal | null => {
-	"worklet";
-	const {
-		enabled,
-		pairKey,
-		linkId,
-		group,
-		destinationPresent,
-		sourcePresent,
-		linkState,
-	} = params;
-	if (!enabled) {
-		return null;
-	}
-
-	if (!pairKey) {
-		return { pairKey: null, action: "wait" };
-	}
-
-	if (!destinationPresent) {
-		return { pairKey, action: "wait" };
-	}
-
-	if (!sourcePresent) {
-		return { pairKey, action: "release" };
-	}
-
-	const linkKey = getLinkKeyFromTag(linkId);
-	const activeGroupId =
-		group && linkState ? getActiveGroupId(linkState, pairKey, group) : null;
-
-	if (activeGroupId && activeGroupId !== linkKey) {
-		return { pairKey, action: "release" };
-	}
-
-	const link = linkState?.[pairKey]?.links?.[linkKey];
-
-	if (!link?.destination) {
-		return { pairKey, action: "measure" };
-	}
-
-	if (!link.source) {
-		return { pairKey, action: "wait" };
-	}
-
-	return { pairKey, action: "complete" };
-};

package/src/shared/components/boundary/utils/refresh-signals.ts

@@ -1,164 +0,0 @@
-import type {
-	LinkPairsState,
-	ScreenPairKey,
-} from "../../../stores/bounds/types";
-import type { MeasureTarget } from "../types";
-
-const SOURCE_SIGNAL_PREFIX = "source|";
-const DESTINATION_SIGNAL_PREFIX = "destination|";
-
-type RefreshBoundarySignal = MeasureTarget & {
-	signal: string;
-};
-
-const buildRefreshSignal = (
-	type: MeasureTarget["type"],
-	pairKey: ScreenPairKey,
-	key: string,
-): RefreshBoundarySignal => {
-	"worklet";
-	const prefix =
-		type === "source" ? SOURCE_SIGNAL_PREFIX : DESTINATION_SIGNAL_PREFIX;
-	return {
-		type,
-		pairKey,
-		signal: `${prefix}${pairKey}|${key}`,
-	};
-};
-
-export const getRefreshBoundarySignal = (params: {
-	enabled: boolean;
-	currentScreenKey: string;
-	sourcePairKey?: ScreenPairKey;
-	destinationPairKey?: ScreenPairKey;
-	linkId: string;
-	group?: string;
-	shouldRefresh: boolean;
-	settled?: boolean;
-	closing: boolean;
-	linkState?: LinkPairsState;
-}): RefreshBoundarySignal | null => {
-	"worklet";
-	const {
-		enabled,
-		currentScreenKey,
-		sourcePairKey,
-		destinationPairKey,
-		linkId,
-		group,
-		shouldRefresh,
-		settled = false,
-		closing,
-		linkState,
-	} = params;
-
-	if (!enabled) return null;
-
-	if (!shouldRefresh && (!group || !settled)) {
-		return null;
-	}
-
-	// A source may move while its destination is active, so refresh whichever
-	// side of the pair this boundary currently represents.
-	if (!group) {
-		if (sourcePairKey) {
-			const sourcePair = linkState?.[sourcePairKey];
-			const participates =
-				!!sourcePair?.links?.[linkId] || !!sourcePair?.sourceRequests?.[linkId];
-
-			if (!participates) {
-				return null;
-			}
-
-			return buildRefreshSignal(
-				"source",
-				sourcePairKey,
-				[currentScreenKey, closing ? "closing" : "settled"].join("|"),
-			);
-		}
-
-		const refreshDestinationPairKey = destinationPairKey;
-
-		if (!refreshDestinationPairKey) {
-			return null;
-		}
-
-		if (!linkState?.[refreshDestinationPairKey]?.links?.[linkId]) {
-			return null;
-		}
-
-		return buildRefreshSignal(
-			"destination",
-			refreshDestinationPairKey,
-			[currentScreenKey, closing ? "closing" : "settled"].join("|"),
-		);
-	}
-
-	// Source side:
-	// When the activeId changes, trigger a refresh to ensure the source bounds are captured.
-	if (sourcePairKey) {
-		const pair = linkState?.[sourcePairKey];
-		const groupState = pair?.groups?.[group];
-		const activeId = groupState?.activeId;
-
-		if (activeId !== linkId) {
-			return null;
-		}
-
-		// The opening member is captured by the initial handshake. A settled
-		// refresh is only needed after selection moves to another member.
-		if (
-			!shouldRefresh &&
-			(groupState?.initialId === undefined ||
-				activeId === groupState.initialId ||
-				!!pair?.links?.[linkId]?.source)
-		) {
-			return null;
-		}
-
-		return buildRefreshSignal(
-			"source",
-			sourcePairKey,
-			[
-				group,
-				linkId,
-				shouldRefresh ? (closing ? "closing" : "settled") : "retarget",
-			].join("|"),
-		);
-	}
-
-	const refreshDestinationPairKey = destinationPairKey;
-
-	if (!refreshDestinationPairKey) return null;
-
-	// Destination side:
-	// When the activeId changes, trigger a refresh to ensure the destination bounds are captured.
-	const pair = linkState?.[refreshDestinationPairKey];
-	const groupState = pair?.groups?.[group];
-	const activeId = groupState?.activeId;
-
-	// Destination retargeting should only measure a concrete member that already
-	// participates in the pair. Missing members fall back to initialId at resolve.
-	if (activeId !== linkId) {
-		return null;
-	}
-
-	if (
-		!shouldRefresh &&
-		(groupState?.initialId === undefined ||
-			activeId === groupState.initialId ||
-			!!pair?.links?.[linkId]?.destination)
-	) {
-		return null;
-	}
-
-	return buildRefreshSignal(
-		"destination",
-		refreshDestinationPairKey,
-		[
-			group,
-			linkId,
-			shouldRefresh ? (closing ? "closing" : "settled") : "retarget",
-		].join("|"),
-	);
-};

package/src/shared/components/boundary/utils/source-signals.ts

@@ -1,51 +0,0 @@
-import type {
-	LinkPairsState,
-	ScreenPairKey,
-} from "../../../stores/bounds/types";
-
-const SOURCE_SIGNAL_PREFIX = "source|";
-
-type SourceCaptureSignal = {
-	pairKey: ScreenPairKey;
-	signal: string;
-};
-
-export const getInitialSourceCaptureSignal = (params: {
-	enabled: boolean;
-	sourcePairKey?: ScreenPairKey;
-	linkId: string;
-	group?: string;
-	linkState?: LinkPairsState;
-}): SourceCaptureSignal | null => {
-	"worklet";
-	const { enabled, sourcePairKey, linkId, group, linkState } = params;
-
-	if (!enabled || !sourcePairKey) {
-		return null;
-	}
-
-	const pair = linkState?.[sourcePairKey];
-	const link = pair?.links?.[linkId];
-	const hasSourceRequest = pair?.sourceRequests?.[linkId];
-
-	if ((!link?.destination && !hasSourceRequest) || link?.source) {
-		return null;
-	}
-
-	if (group) {
-		const activeId = linkState?.[sourcePairKey]?.groups?.[group]?.activeId;
-
-		// Passive grouped sources should not measure every mounted item. Once a
-		// group has an active id, only that concrete member can auto-capture.
-		if (activeId && activeId !== linkId) {
-			return null;
-		}
-	}
-
-	const signalParts = group ? [group, linkId] : [linkId];
-
-	return {
-		pairKey: sourcePairKey,
-		signal: `${SOURCE_SIGNAL_PREFIX}${sourcePairKey}|${signalParts.join("|")}`,
-	};
-};

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

@@ -1,28 +0,0 @@
-import type { BaseStackDescriptor } from "../../../../types/stack.types";
-
-/**
- * Builds nested navigator ancestor keys from immediate parent to root.
- */
-export function getAncestorKeys(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();
-		if (state?.routes && state.index !== undefined) {
-			const focusedRoute = state.routes[state.index];
-			if (focusedRoute?.key) {
-				ancestors.push(focusedRoute.key);
-			}
-		}
-		parent = parent.getParent();
-	}
-
-	return ancestors;
-}