react-native-screen-transitions 4.0.0-alpha.8 → 4.0.0

package/lib/typescript/types/screen.types.d.ts

@@ -30,6 +30,15 @@ export type ScreenLayouts = {
 };
 export type ScreenKey = string;
 export type SheetScrollGestureBehavior = "expand-and-collapse" | "collapse-only";
+/**
+ * Controls how a drag moves between configured {@linkcode ScreenTransitionConfig.snapPoints}.
+ *
+ * - `"continuous"` maps physical movement directly to global screen progress.
+ * - `"step"` maps each drag across one adjacent snap interval.
+ *
+ * @see {@linkcode ScreenTransitionConfig.sheetSnapBehavior}
+ */
+export type SheetSnapBehavior = "continuous" | "step";
 export type GestureTracking = "auto" | "never" | "always";
 /**
  * A single snap point value. Either a fraction of screen height (0–1) or
@@ -71,6 +80,16 @@ export type ScreenContentComponentProps = ScreenLayerComponentProps & {
      */
     children: ReactNode;
 };
+/**
+ * Props passed to {@linkcode ScreenTransitionConfig.surfaceComponent} when it
+ * is provided as a render-style component.
+ */
+export type ScreenSurfaceComponentProps = ScreenLayerComponentProps & {
+    /**
+     * The screen subtree rendered inside the visual surface layer.
+     */
+    children: ReactNode;
+};
 /**
  * Custom renderer for the backdrop layer.
  *
@@ -91,6 +110,17 @@ export type ScreenBackdropComponent = ComponentType<any> | ComponentType<ScreenB
  * @see {@linkcode ScreenTransitionConfig.contentComponent}
  */
 export type ScreenContentComponent = ComponentType<any> | ComponentType<ScreenContentComponentProps>;
+/**
+ * Custom renderer for the screen's visual surface layer.
+ *
+ * The surface is nested inside the content layer and does not contain the
+ * shared-element fallback host. Use it for visual effects such as filters,
+ * clipping, backgrounds, and corner treatments without changing navigation
+ * geometry.
+ *
+ * @see {@linkcode ScreenTransitionConfig.surfaceComponent}
+ */
+export type ScreenSurfaceComponent = ComponentType<any> | ComponentType<ScreenSurfaceComponentProps>;
 /**
  * Controls how an inactive screen is retained after it is no longer active.
  *
@@ -298,6 +328,16 @@ export type ScreenTransitionConfig = {
      * @default "expand-and-collapse"
      */
     sheetScrollGestureBehavior?: SheetScrollGestureBehavior;
+    /**
+     * Controls how gesture movement maps between adjacent snap points.
+     *
+     * `"continuous"` preserves direct global progress and permits one gesture to
+     * cross multiple snap points. `"step"` gives every adjacent interval a full
+     * normalized drag range and limits the gesture to one snap-point step.
+     *
+     * @default "continuous"
+     */
+    sheetSnapBehavior?: SheetSnapBehavior;
     /**
      * Locks gesture-based snap movement to the current snap point.
      *
@@ -372,5 +412,15 @@ export type ScreenTransitionConfig = {
      * @default undefined
      */
     contentComponent?: ScreenContentComponent;
+    /**
+     * Custom component to render as the screen's visual surface layer.
+     *
+     * The component receives the `surface` slot's animated styles and props. It
+     * is nested inside the content layer while shared-element fallback content
+     * remains outside it.
+     *
+     * @default undefined
+     */
+    surfaceComponent?: ScreenSurfaceComponent;
 };
 //# sourceMappingURL=screen.types.d.ts.map

package/lib/typescript/types/screen.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen.types.d.ts","sourceRoot":"","sources":["../../../src/types/screen.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"screen.types.d.ts","sourceRoot":"","sources":["../../../src/types/screen.types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/utils/create-provider.d.ts

@@ -43,6 +43,7 @@ type ResolvedOptionalProviderStoreHook<ContextValue, Global extends boolean> = O
 type ProviderFactoryResult<ContextValue, Global extends boolean> = {
     value: ContextValue;
     children?: ReactNode;
+    unregisterOnCleanup?: boolean;
 } & (Global extends true ? {
     key: string;
 } : {
@@ -52,9 +53,11 @@ export default function createProvider<ProviderName extends string, Global exten
     global?: Global;
 }): <ProviderProps extends object, ContextValue>(factory: (props: ProviderProps) => ProviderFactoryResult<ContextValue, Global>) => {
     StoreProvider: {
-        ({ children, storeKey, value, }: {
+        ({ children, registerGlobally, storeKey, unregisterOnCleanup, value, }: {
             children?: ReactNode;
+            registerGlobally?: boolean;
             storeKey?: string;
+            unregisterOnCleanup?: boolean;
             value: ContextValue;
         }): import("react").JSX.Element;
         displayName: string;

package/lib/typescript/utils/create-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-provider.d.ts","sourceRoot":"","sources":["../../../src/utils/create-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAEN,KAAK,SAAS,EAMd,MAAM,OAAO,CAAC;AAEf,KAAK,iBAAiB,CAAC,YAAY,IAAI;IACtC,IAAI,YAAY,CAAC;IACjB,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,QAAQ,GAAG,QAAQ,CAAC;CAClE,CAAC;AAEF,KAAK,uBAAuB,CAAC,YAAY,IAAI;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,CAAC,QAAQ,EACR,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,QAAQ,GACzC,QAAQ,CAAC;CACZ,CAAC;AAEF,KAAK,yBAAyB,CAAC,YAAY,IAAI;IAC9C,IAAI,YAAY,GAAG,IAAI,CAAC;IACxB,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,KAAK,QAAQ,GAAG,QAAQ,CAAC;CACzE,CAAC;AAEF,KAAK,+BAA+B,CAAC,YAAY,IAAI;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAAC;IAC1C,CAAC,QAAQ,EACR,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,QAAQ,GACzC,QAAQ,GAAG,IAAI,CAAC;CACnB,CAAC;AAEF,KAAK,yBAAyB,CAC7B,YAAY,EACZ,MAAM,SAAS,OAAO,IACnB,iBAAiB,CAAC,YAAY,CAAC,GAClC,CAAC,MAAM,SAAS,IAAI,GAAG,uBAAuB,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,CAAC;AAEzE,KAAK,iCAAiC,CACrC,YAAY,EACZ,MAAM,SAAS,OAAO,IACnB,yBAAyB,CAAC,YAAY,CAAC,GAC1C,CAAC,MAAM,SAAS,IAAI,GACjB,+BAA+B,CAAC,YAAY,CAAC,GAC7C,OAAO,CAAC,CAAC;AAEb,KAAK,qBAAqB,CAAC,YAAY,EAAE,MAAM,SAAS,OAAO,IAAI;IAClE,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB,GAAG,CAAC,MAAM,SAAS,IAAI,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAgI9D,MAAM,CAAC,OAAO,UAAU,cAAc,CACrC,YAAY,SAAS,MAAM,EAC3B,MAAM,SAAS,OAAO,GAAG,KAAK,EAC7B,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,IAC1C,aAAa,SAAS,MAAM,EAAE,YAAY,EACjD,SAAS,CACR,KAAK,EAAE,aAAa,KAChB,qBAAqB,CAAC,YAAY,EAAE,MAAM,CAAC,KAmL3C;IAAE,aAAa;yCAlEjB;YACF,QAAQ,CAAC,EAAE,SAAS,CAAC;YACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,YAAY,CAAC;SACpB;;MA8DyC;CAAE,GAAG,GAC7C,CAAC,IAAI,YAAY,IAAI,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,GAC9D,GAAG,GACF,CAAC,IAAI,YAAY,IAAI,cAAc,CAAC,OAAO,GAAG,iCAAiC,CAC/E,YAAY,EACZ,MAAM,CACN,GACD,GAAG,GACF,CAAC,IAAI,YAAY,IAAI,MAAM,CAAC,OAAO,GAAG,yBAAyB,CAC/D,YAAY,EACZ,MAAM,CACN,GACD,CAEF"}
+{"version":3,"file":"create-provider.d.ts","sourceRoot":"","sources":["../../../src/utils/create-provider.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "react-native-screen-transitions",
-	"version": "4.0.0-alpha.8",
+	"version": "4.0.0",
 	"description": "Easy screen transitions for React Native and Expo",
 	"author": "Ed",
 	"license": "MIT",
@@ -70,20 +70,15 @@
 	"peerDependencies": {
 		"@react-navigation/native": ">=7.3.0",
 		"@types/react": "*",
-		"@types/react-native": "*",
-		"expo-router": ">=56.2.10",
 		"react": ">=19.2.0",
 		"react-native": "*",
 		"react-native-gesture-handler": ">=2.16.1",
 		"react-native-reanimated": ">=4.0.0",
 		"react-native-safe-area-context": "*",
-		"react-native-teleport": ">=1.1.0 <1.1.11",
-		"react-native-worklets": "0.8.x"
+		"react-native-teleport": ">=1.2.0",
+		"react-native-worklets": ">=0.8.0"
 	},
 	"peerDependenciesMeta": {
-		"expo-router": {
-			"optional": true
-		},
 		"react-native-teleport": {
 			"optional": true
 		}

package/src/components/boundary/create-boundary-component.tsx

@@ -10,7 +10,10 @@ import {
 	BOUNDARY_TARGET_ACTIVE_PROP,
 	BoundaryTarget,
 } from "./components/boundary-target";
-import { BoundaryContentPortalHost } from "./portal/components/boundary-content-portal";
+import {
+	BoundaryContentPortal,
+	BoundaryContentPortalHost,
+} from "./portal/components/boundary-content-portal";
 import { BoundaryPortal } from "./portal/components/boundary-portal";
 import { BoundaryRootProvider } from "./providers/boundary-root.provider";
 import type { BoundaryComponentProps } from "./types";
@@ -91,7 +94,12 @@ export function createBoundaryComponent<P extends object>(
 								enabled={root.shouldRenderHandoffHost}
 								screenKey={root.currentScreenKey}
 							>
-								{targetResolution.children}
+								<BoundaryContentPortal
+									boundaryId={root.boundTag.tag}
+									enabled={root.shouldRenderHandoffHost}
+								>
+									{targetResolution.children}
+								</BoundaryContentPortal>
 							</BoundaryContentPortalHost>
 						</AnimatedComponent>
 					</BoundaryPortal>

package/src/components/boundary/portal/components/boundary-content-portal/helpers/active-handoff-receiver.ts

@@ -1,3 +1,6 @@
+import type { ScreenPairKey } from "../../../../../../stores/bounds/types";
+import type { BoundaryHandoffTarget } from "../../../../../../types/animation.types";
+
 type ReceiverRoute = {
 	key: string;
 };
@@ -57,6 +60,7 @@ export const resolveHandoffAttachmentCandidate = ({
 	interpolatorReady,
 	pairChangedDuringClose = false,
 	pairDestinationScreenKey,
+	pairHasBoundaryLink,
 	previousReceiverScreenKey,
 }: {
 	activeReceiverClosing: boolean;
@@ -66,9 +70,20 @@ export const resolveHandoffAttachmentCandidate = ({
 	interpolatorReady: boolean;
 	pairChangedDuringClose?: boolean;
 	pairDestinationScreenKey: string | null;
+	pairHasBoundaryLink?: boolean;
 	previousReceiverScreenKey: string | null;
 }) => {
 	"worklet";
+	const currentPairHasBoundaryLink =
+		pairHasBoundaryLink ?? pairDestinationScreenKey !== null;
+
+	if (
+		activeReceiverClosing &&
+		attachedReceiverScreenKey !== activeReceiverScreenKey &&
+		!currentPairHasBoundaryLink
+	) {
+		return attachedReceiverScreenKey;
+	}
 
 	if (
 		activeReceiverClosing &&
@@ -79,6 +94,16 @@ export const resolveHandoffAttachmentCandidate = ({
 		return pairDestinationScreenKey;
 	}
 
+	if (
+		activeReceiverClosing &&
+		pairChangedDuringClose &&
+		!currentPairHasBoundaryLink
+	) {
+		return hasActiveCloseFinished
+			? previousReceiverScreenKey
+			: attachedReceiverScreenKey;
+	}
+
 	if (
 		hasActiveCloseFinished &&
 		attachedReceiverScreenKey === activeReceiverScreenKey
@@ -101,3 +126,67 @@ export const resolveHandoffAttachmentCandidate = ({
 
 	return activeReceiverScreenKey;
 };
+
+export const resolveRequestedHandoffReceiver = ({
+	automaticScreenKey,
+	destinationReady = true,
+	destinationScreenKey,
+	handoffTarget,
+	sourceScreenKey,
+}: {
+	automaticScreenKey: string | null;
+	destinationReady?: boolean;
+	destinationScreenKey: string | null;
+	handoffTarget: BoundaryHandoffTarget | undefined;
+	sourceScreenKey: string | null;
+}) => {
+	"worklet";
+
+	if (handoffTarget === "source") {
+		return sourceScreenKey;
+	}
+
+	if (handoffTarget === "destination") {
+		return destinationReady ? destinationScreenKey : automaticScreenKey;
+	}
+
+	return automaticScreenKey;
+};
+
+export const resolveRequestedHandoffPairKey = ({
+	destinationPairHasCompleteLink,
+	destinationPairKey,
+	handoffTarget,
+	retainedSourcePairHasCompleteLink,
+	retainedSourcePairKey,
+	sourcePairHasCompleteLink,
+	sourcePairKey,
+}: {
+	destinationPairHasCompleteLink: boolean;
+	destinationPairKey: ScreenPairKey | undefined;
+	handoffTarget: BoundaryHandoffTarget | undefined;
+	retainedSourcePairHasCompleteLink: boolean;
+	retainedSourcePairKey: ScreenPairKey | undefined;
+	sourcePairHasCompleteLink: boolean;
+	sourcePairKey: ScreenPairKey | undefined;
+}) => {
+	"worklet";
+
+	if (handoffTarget === "source" || handoffTarget === "destination") {
+		if (sourcePairHasCompleteLink) {
+			return sourcePairKey;
+		}
+
+		if (destinationPairHasCompleteLink) {
+			return destinationPairKey;
+		}
+
+		if (retainedSourcePairHasCompleteLink) {
+			return retainedSourcePairKey;
+		}
+
+		return sourcePairKey ?? destinationPairKey ?? retainedSourcePairKey;
+	}
+
+	return sourcePairKey;
+};

package/src/components/boundary/portal/components/boundary-content-portal/hooks/use-boundary-content-portal-attachment.ts

@@ -9,14 +9,23 @@ import { useBlankStackStore } from "../../../../../../providers/stack/blank-stac
 import { AnimationStore } from "../../../../../../stores/animation.store";
 import { getLinkKeyFromTag } from "../../../../../../stores/bounds/helpers/link-pairs.helpers";
 import { getEntry } from "../../../../../../stores/bounds/internals/entries";
+import {
+	getPairKeyForDestination,
+	getPairKeyForSource,
+} from "../../../../../../stores/bounds/internals/links";
 import { pairs } from "../../../../../../stores/bounds/internals/state";
+import type {
+	LinkPairState,
+	TagLink,
+} from "../../../../../../stores/bounds/types";
 import { SystemStore } from "../../../../../../stores/system.store";
 import { PORTAL_HOST_NAME_RESET_VALUE } from "../../../utils/naming";
-import { isTeleportEnabled } from "../../../utils/teleport-control";
 import {
 	resolveActiveHandoffReceiver,
 	resolveHandoffAttachmentCandidate,
 	resolvePreviousHandoffReceiver,
+	resolveRequestedHandoffPairKey,
+	resolveRequestedHandoffReceiver,
 } from "../helpers/active-handoff-receiver";
 import { createBoundaryContentPortalHostName } from "../helpers/host-name";
 
@@ -24,6 +33,19 @@ interface UseBoundaryContentPortalAttachmentParams {
 	boundaryId: string;
 }
 
+const isCompleteActiveLink = (
+	pair: LinkPairState | null | undefined,
+	link: TagLink | undefined,
+	boundaryLinkKey: string,
+) => {
+	"worklet";
+
+	return (
+		link?.status === "complete" &&
+		(!link.group || pair?.groups[link.group]?.activeId === boundaryLinkKey)
+	);
+};
+
 export const useBoundaryContentPortalAttachment = ({
 	boundaryId,
 }: UseBoundaryContentPortalAttachmentParams) => {
@@ -34,6 +56,9 @@ export const useBoundaryContentPortalAttachment = ({
 	);
 	const nextScreenKey = useDescriptorsStore((s) => s.derivations.nextScreenKey);
 	const sourcePairKey = useDescriptorsStore((s) => s.derivations.sourcePairKey);
+	const destinationPairKey = useDescriptorsStore(
+		(s) => s.derivations.destinationPairKey,
+	);
 	const destinationSlots = useOptionalScreenSlotStore(
 		nextScreenKey ?? currentScreenKey,
 	);
@@ -67,11 +92,9 @@ export const useBoundaryContentPortalAttachment = ({
 		const slot = slotsMap.get()[boundaryId];
 		const {
 			pointerEvents: _pointerEvents,
-			teleport,
+			handoffTarget,
 			...slotProps
 		} = slot?.props ?? {};
-
-		const shouldTeleport = isTeleportEnabled(teleport);
 		const closing = activeReceiverClosing.get();
 		const animationProgress = activeReceiverAnimationProgress.get();
 
@@ -89,20 +112,65 @@ export const useBoundaryContentPortalAttachment = ({
 			animationProgress,
 		});
 
-		const pair = sourcePairKey ? pairs.get()[sourcePairKey] : null;
-		const link = pair?.links[getLinkKeyFromTag(boundaryId)];
+		const automaticPair = sourcePairKey ? pairs.get()[sourcePairKey] : null;
+		const boundaryLinkKey = getLinkKeyFromTag(boundaryId);
+		const automaticLink = automaticPair?.links[boundaryLinkKey];
+		const requestedSourcePairKey =
+			getPairKeyForSource(boundaryId, currentScreenKey) ?? sourcePairKey;
+		const requestedSourcePair = requestedSourcePairKey
+			? pairs.get()[requestedSourcePairKey]
+			: null;
+		const requestedSourceLink = requestedSourcePair?.links[boundaryLinkKey];
 
 		const pairDestination =
-			link?.status === "complete" &&
-			(!link.group ||
-				pair?.groups[link.group]?.activeId === getLinkKeyFromTag(boundaryId))
-				? link.destination.screenKey
+			automaticLink?.status === "complete" &&
+			(!automaticLink.group ||
+				automaticPair?.groups[automaticLink.group]?.activeId ===
+					boundaryLinkKey)
+				? automaticLink.destination.screenKey
 				: null;
+		const requestedDestinationPairKey =
+			getPairKeyForDestination(boundaryId, currentScreenKey) ??
+			destinationPairKey;
+		const destinationPair = requestedDestinationPairKey
+			? pairs.get()[requestedDestinationPairKey]
+			: null;
+		const destinationLink = destinationPair?.links[boundaryLinkKey];
+		const retainedSourcePairKey = sourcePairBeforeClose.get() ?? undefined;
+		const retainedSourcePair = retainedSourcePairKey
+			? pairs.get()[retainedSourcePairKey]
+			: null;
+		const retainedSourceLink = retainedSourcePair?.links[boundaryLinkKey];
+		const requestedPairKey = resolveRequestedHandoffPairKey({
+			destinationPairHasCompleteLink: isCompleteActiveLink(
+				destinationPair,
+				destinationLink,
+				boundaryLinkKey,
+			),
+			destinationPairKey: requestedDestinationPairKey,
+			handoffTarget,
+			retainedSourcePairHasCompleteLink: isCompleteActiveLink(
+				retainedSourcePair,
+				retainedSourceLink,
+				boundaryLinkKey,
+			),
+			retainedSourcePairKey,
+			sourcePairHasCompleteLink: isCompleteActiveLink(
+				requestedSourcePair,
+				requestedSourceLink,
+				boundaryLinkKey,
+			),
+			sourcePairKey: requestedSourcePairKey,
+		});
+		const requestedPair = requestedPairKey
+			? pairs.get()[requestedPairKey]
+			: null;
+		const requestedLink = requestedPair?.links[boundaryLinkKey];
 
 		const isInterpolatorReady = interpolatorReady.get();
 		const attachedScreenKey = attachedReceiverScreenKey.get();
 
-		const nextReceiverScreenKey = resolveHandoffAttachmentCandidate({
+		const automaticReceiverScreenKey = resolveHandoffAttachmentCandidate({
 			activeReceiverClosing: !!closing,
 			activeReceiverScreenKey,
 			attachedReceiverScreenKey: attachedScreenKey,
@@ -110,8 +178,25 @@ export const useBoundaryContentPortalAttachment = ({
 			interpolatorReady: !!isInterpolatorReady,
 			pairChangedDuringClose,
 			pairDestinationScreenKey: pairDestination,
+			pairHasBoundaryLink: automaticLink !== undefined,
 			previousReceiverScreenKey,
 		});
+		const requestedDestinationScreenKey =
+			requestedLink?.status === "complete"
+				? requestedLink.destination.screenKey
+				: null;
+		const nextReceiverScreenKey = resolveRequestedHandoffReceiver({
+			automaticScreenKey: automaticReceiverScreenKey,
+			destinationReady:
+				requestedDestinationScreenKey === activeReceiverScreenKey ||
+				!!isInterpolatorReady,
+			destinationScreenKey: requestedDestinationScreenKey,
+			handoffTarget,
+			sourceScreenKey:
+				requestedLink?.status === "complete"
+					? requestedLink.source.screenKey
+					: null,
+		});
 
 		const receiverEntry = nextReceiverScreenKey
 			? getEntry(boundaryId, nextReceiverScreenKey)
@@ -136,9 +221,7 @@ export const useBoundaryContentPortalAttachment = ({
 			attachedReceiverScreenKey.set(nextReceiverScreenKey);
 		}
 
-		const targetScreenKey = shouldTeleport
-			? attachedReceiverScreenKey.get()
-			: null;
+		const targetScreenKey = attachedReceiverScreenKey.get();
 
 		const targetHostName = targetScreenKey
 			? createBoundaryContentPortalHostName(targetScreenKey, boundaryId)

package/src/components/boundary/portal/components/boundary-portal/hooks/use-boundary-portal-attachment.ts

@@ -3,7 +3,6 @@ import { useDescriptorsStore } from "../../../../../../providers/screen/descript
 import { useScreenSlotStore } from "../../../../../../providers/screen/styles";
 import { useBoundaryRootStore } from "../../../../providers/boundary-root.provider";
 import { PORTAL_HOST_NAME_RESET_VALUE } from "../../../utils/naming";
-import { isTeleportEnabled } from "../../../utils/teleport-control";
 import { useActiveHostKey } from "../stores/host-registry.store";
 import { useActivePortalBoundaryHost } from "./use-active-portal-boundary-host";
 
@@ -45,14 +44,11 @@ export const useBoundaryPortalAttachment = ({
 		const slot = slotsMap.get()[boundaryId];
 		const {
 			pointerEvents: _pointerEvents,
-			teleport,
+			handoffTarget: _handoffTarget,
 			...slotProps
 		} = slot?.props ?? {};
 
-		const shouldAttach =
-			slot !== undefined &&
-			isTeleportEnabled(teleport) &&
-			portalHostReady.get();
+		const shouldAttach = slot !== undefined && portalHostReady.get();
 
 		const hostName = shouldAttach
 			? portalHostName.get()

package/src/components/boundary/portal/teleport.ts

@@ -1,4 +1,4 @@
-import { type ComponentType, createElement, type ReactNode } from "react";
+import type { ComponentType, ReactNode } from "react";
 
 /**
  * `react-native-teleport` is an optional peer dependency. The require sits in a
@@ -9,33 +9,12 @@ import { type ComponentType, createElement, type ReactNode } from "react";
  * inline rendering; everything else keeps working.
  */
 let mod: any = null;
-let managerMod: any = null;
-let providerViewMod: any = null;
 try {
 	mod = require("react-native-teleport");
-	managerMod = require("react-native-teleport/lib/module/contexts/PortalManager");
-	providerViewMod = require("react-native-teleport/lib/module/views/PortalProvider");
 } catch {}
 
-const NativePortalProviderView: ComponentType<{ children: ReactNode }> | null =
-	providerViewMod?.default ?? null;
-const PortalManagerProvider: ComponentType<{ children: ReactNode }> | null =
-	managerMod?.PortalManagerProvider ?? null;
-
 const SafeNativePortalProvider: ComponentType<{ children: ReactNode }> | null =
-	PortalManagerProvider
-		? ({ children }: { children: ReactNode }) => {
-				const managedChildren = createElement(
-					PortalManagerProvider,
-					null,
-					children,
-				);
-
-				return NativePortalProviderView
-					? createElement(NativePortalProviderView, null, managedChildren)
-					: managedChildren;
-			}
-		: null;
+	mod?.PortalProvider ?? null;
 
 export const isTeleportAvailable =
 	mod !== null && SafeNativePortalProvider !== null;

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

@@ -1,3 +1,4 @@
+import { getLinkKeyFromTag } from "../../../stores/bounds/helpers/link-pairs.helpers";
 import type {
 	LinkPairsState,
 	ScreenPairKey,
@@ -25,8 +26,9 @@ export const getInitialSourceCaptureSignal = (params: {
 	}
 
 	const pair = linkState?.[sourcePairKey];
-	const link = pair?.links?.[linkId];
-	const hasSourceRequest = pair?.sourceRequests?.[linkId];
+	const linkKey = getLinkKeyFromTag(linkId);
+	const link = pair?.links?.[linkKey];
+	const hasSourceRequest = pair?.sourceRequests?.[linkKey];
 
 	if ((!link?.destination && !hasSourceRequest) || link?.source) {
 		return null;
@@ -37,12 +39,12 @@ export const getInitialSourceCaptureSignal = (params: {
 
 		// 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) {
+		if (activeId && activeId !== linkKey) {
 			return null;
 		}
 	}
 
-	const signalParts = group ? [group, linkId] : [linkId];
+	const signalParts = group ? [group, linkKey] : [linkKey];
 
 	return {
 		pairKey: sourcePairKey,

package/src/components/overlay/helpers/get-active-overlay.ts

@@ -4,52 +4,24 @@ type StackScene = BaseStackScene;
 
 import { isOverlayVisible } from "../../../utils/overlay/visibility";
 
-export type FloatOverlayActivity = "active" | "inert" | "inactive" | "closing";
-
 export type FloatOverlayEntry = {
 	scene: StackScene;
 	overlayIndex: number;
-	activity: FloatOverlayActivity;
 };
 
 export type FloatOverlayTransitionEntry = FloatOverlayEntry & {
 	driverScene: StackScene;
 };
 
-type OverlayCandidate = Omit<FloatOverlayEntry, "activity">;
-
-const resolveOverlayActivity = (
-	scene: StackScene,
-	distanceFromTop: number,
-): FloatOverlayActivity => {
-	if (distanceFromTop === 0 && scene.activity === "closing") {
-		return "closing";
-	}
-
-	if (distanceFromTop === 0) {
-		return "active";
-	}
-
-	if (distanceFromTop === 1) {
-		return "inert";
-	}
-
-	return "inactive";
-};
-
 /**
- * Finds every visible floating-overlay checkpoint in stack order.
- *
- * The newest checkpoint owns the active overlay. Its immediate predecessor
- * remains visible and inert; all older checkpoints are retained but inactive.
- * This mirrors the screen activity window without making plain screens create
- * a new overlay checkpoint.
+ * Overlay ordering and transition coordination are library-owned. Visibility,
+ * interaction, and presentation are user-owned.
  */
 export function getFloatOverlayStack(
 	scenes: StackScene[],
 	transitionsAlwaysOn: boolean,
 ): FloatOverlayEntry[] {
-	const candidates: OverlayCandidate[] = [];
+	const candidates: FloatOverlayEntry[] = [];
 
 	for (let index = 0; index < scenes.length; index += 1) {
 		const scene = scenes[index];
@@ -64,11 +36,7 @@ export function getFloatOverlayStack(
 		}
 	}
 
-	const topIndex = candidates.length - 1;
-	return candidates.map((candidate, index) => ({
-		...candidate,
-		activity: resolveOverlayActivity(candidate.scene, topIndex - index),
-	}));
+	return candidates;
 }
 
 export function getFloatOverlayTransitions(