react-native-screen-transitions 3.7.1 → 3.8.0-beta.0

package/src/shared/providers/stack/{helpers/managed-stack-state/managed-stack-controller.ts → blank-stack-state/blank-stack-controller.ts}

@@ -1,42 +1,42 @@
 import { StackActions } from "@react-navigation/native";
-import type { ManagedStackProps } from "../../../../types/providers/managed-stack.types";
+import type { BlankStackProviderProps } from "../../../types/providers/blank-stack-provider.types";
 import type {
 	BaseStackDescriptor,
 	BaseStackNavigation,
 	BaseStackRoute,
-} from "../../../../types/stack.types";
-import { buildManagedStackState } from "./helpers/build-managed-stack-state";
-import { deriveManagedStackState } from "./helpers/derive-managed-stack-state";
+} from "../../../types/stack.types";
+import { buildBlankStackState } from "./helpers/build-blank-stack-state";
+import { deriveBlankStackState } from "./helpers/derive-blank-stack-state";
 import type {
-	ManagedDescriptorSources,
-	ManagedStackControllerSnapshot,
-	ManagedStackController as ManagedStackControllerType,
+	BlankStackControllerSnapshot,
+	BlankStackController as BlankStackControllerType,
+	BlankStackDescriptorSources,
 } from "./helpers/types";
 
-export type { ManagedStackController } from "./helpers/types";
+export type { BlankStackController } from "./helpers/types";
 
 /**
- * Maintains the stack-local route snapshot used while managed transitions run.
+ * Maintains the stack-local route snapshot used while blank stack transitions run.
  *
  * React Navigation remains the source of truth for settled routes, but it can
  * remove descriptors before our close animation has finished. This controller
  * keeps those closing routes locally until their lifecycle reports completion.
  */
-export const createManagedStackController = <
+export const createBlankStackController = <
 	TDescriptor extends BaseStackDescriptor,
 	TNavigation extends BaseStackNavigation,
 >(
-	initialProps: ManagedStackProps<TDescriptor, TNavigation>,
-): ManagedStackControllerType<TDescriptor, TNavigation> => {
+	initialProps: BlankStackProviderProps<TDescriptor, TNavigation>,
+): BlankStackControllerType<TDescriptor, TNavigation> => {
 	const closingRouteKeys = new Set<string>();
 	let props = initialProps;
 	let previousRoutesSnapshot = initialProps.state.routes;
-	let snapshot: ManagedStackControllerSnapshot<TDescriptor> = {
-		state: buildManagedStackState({
+	let snapshot: BlankStackControllerSnapshot<TDescriptor> = {
+		state: buildBlankStackState({
 			props,
 			routes: initialProps.state.routes,
 			descriptors:
-				initialProps.descriptors as ManagedDescriptorSources<TDescriptor>,
+				initialProps.descriptors as BlankStackDescriptorSources<TDescriptor>,
 			closingRouteKeys,
 		}),
 	};
@@ -55,15 +55,17 @@ export const createManagedStackController = <
 		};
 	};
 
-	const getSnapshot = (): ManagedStackControllerSnapshot<TDescriptor> => {
+	const getSnapshot = (): BlankStackControllerSnapshot<TDescriptor> => {
 		return snapshot;
 	};
 
-	const update = (nextProps: ManagedStackProps<TDescriptor, TNavigation>) => {
+	const update = (
+		nextProps: BlankStackProviderProps<TDescriptor, TNavigation>,
+	) => {
 		const lastRoutesSnapshot = previousRoutesSnapshot;
 		props = nextProps;
 
-		const nextState = deriveManagedStackState({
+		const nextState = deriveBlankStackState({
 			props,
 			current: snapshot.state,
 			previousRoutesSnapshot: lastRoutesSnapshot,
@@ -111,7 +113,7 @@ export const createManagedStackController = <
 		delete nextDescriptors[route.key];
 
 		snapshot = {
-			state: buildManagedStackState({
+			state: buildBlankStackState({
 				props,
 				routes: nextRoutes,
 				descriptors: nextDescriptors,
@@ -138,7 +140,7 @@ export const createManagedStackController = <
 
 		closingRouteKeys.add(route.key);
 		snapshot = {
-			state: buildManagedStackState({
+			state: buildBlankStackState({
 				props,
 				routes: current.routes,
 				descriptors: current.sourceDescriptors,

package/src/shared/providers/stack/{helpers/managed-stack-state/helpers/build-managed-stack-state.ts → blank-stack-state/helpers/build-blank-stack-state.ts}

@@ -1,13 +1,13 @@
-import type { ManagedStackProps } from "../../../../../types/providers/managed-stack.types";
+import type { BlankStackProviderProps } from "../../../../types/providers/blank-stack-provider.types";
 import type {
 	BaseStackDescriptor,
 	BaseStackNavigation,
 	BaseStackScene,
 	StackDescriptorSource,
 	StackSceneActivity,
-} from "../../../../../types/stack.types";
-import { resolveSceneNeighbors } from "../../../../../utils/navigation/resolve-scene-neighbors";
-import { isOverlayVisible } from "../../../../../utils/overlay/visibility";
+} from "../../../../types/stack.types";
+import { isOverlayVisible } from "../../../../utils/overlay/visibility";
+import { resolveSceneNeighbors } from "./navigation/resolve-scene-neighbors";
 import {
 	areDescriptorSourcesEquivalent,
 	areDescriptorsEqual,
@@ -15,22 +15,22 @@ import {
 	getRouteChildState,
 	routeKeyListsAreEqual,
 	setsAreEqual,
-} from "./helpers";
+} from "./state-equality";
 import type {
+	BlankStackDescriptorSources,
+	BlankStackDescriptors,
+	BlankStackRoutes,
 	LocalRoutesState,
-	ManagedDescriptorSources,
-	ManagedDescriptors,
-	ManagedRoutes,
 	SceneActivityWindow,
 } from "./types";
 
-type BuildManagedStackStateParams<
+type BuildBlankStackStateParams<
 	TDescriptor extends BaseStackDescriptor,
 	TNavigation extends BaseStackNavigation,
 > = {
-	props: ManagedStackProps<TDescriptor, TNavigation>;
-	routes: ManagedRoutes<TDescriptor>;
-	descriptors: ManagedDescriptorSources<TDescriptor>;
+	props: BlankStackProviderProps<TDescriptor, TNavigation>;
+	routes: BlankStackRoutes<TDescriptor>;
+	descriptors: BlankStackDescriptorSources<TDescriptor>;
 	closingRouteKeys: ReadonlySet<string>;
 	previousState?: LocalRoutesState<TDescriptor>;
 };
@@ -83,7 +83,7 @@ const getSceneActivity = ({
 };
 
 const getNonClosingSceneIndices = <TDescriptor extends BaseStackDescriptor>(
-	routes: ManagedRoutes<TDescriptor>,
+	routes: BlankStackRoutes<TDescriptor>,
 	closingRouteKeys: ReadonlySet<string>,
 ) => {
 	const indices: number[] = [];
@@ -105,7 +105,7 @@ const getSceneActivityWindow = <
 	props,
 	routes,
 	closingRouteKeys,
-}: BuildManagedStackStateParams<
+}: BuildBlankStackStateParams<
 	TDescriptor,
 	TNavigation
 >): SceneActivityWindow => {
@@ -161,14 +161,14 @@ const buildBaseScenes = <
 	closingRouteKeys,
 	previousState,
 	activityWindow,
-}: BuildManagedStackStateParams<TDescriptor, TNavigation> & {
+}: BuildBlankStackStateParams<TDescriptor, TNavigation> & {
 	activityWindow: SceneActivityWindow;
 }) => {
 	const routeKeys: string[] = [];
 	const scenes: BaseStackScene<TDescriptor>[] = [];
 	const routeChildStates: Record<string, unknown> = {};
-	const sourceDescriptors = {} as ManagedDescriptorSources<TDescriptor>;
-	const managedDescriptors = {} as ManagedDescriptors<TDescriptor>;
+	const sourceDescriptors = {} as BlankStackDescriptorSources<TDescriptor>;
+	const blankStackDescriptors = {} as BlankStackDescriptors<TDescriptor>;
 	let shouldShowFloatOverlay = false;
 
 	for (let sceneIndex = 0; sceneIndex < routes.length; sceneIndex++) {
@@ -215,7 +215,7 @@ const buildBaseScenes = <
 		routeKeys.push(route.key);
 		routeChildStates[route.key] = routeChildState;
 		sourceDescriptors[route.key] = sourceDescriptor;
-		managedDescriptors[route.key] = descriptor;
+		blankStackDescriptors[route.key] = descriptor;
 
 		if (!shouldShowFloatOverlay) {
 			shouldShowFloatOverlay = isOverlayVisible(sourceDescriptor?.options);
@@ -231,7 +231,7 @@ const buildBaseScenes = <
 		scenes,
 		routeChildStates,
 		sourceDescriptors,
-		descriptors: managedDescriptors,
+		descriptors: blankStackDescriptors,
 		routeKeys,
 		shouldShowFloatOverlay,
 	};
@@ -244,7 +244,7 @@ const withSceneRelationships = <TDescriptor extends BaseStackDescriptor>({
 	previousState,
 }: {
 	scenes: BaseStackScene<TDescriptor>[];
-	sourceDescriptors: ManagedDescriptorSources<TDescriptor>;
+	sourceDescriptors: BlankStackDescriptorSources<TDescriptor>;
 	closingRouteKeys: ReadonlySet<string>;
 	previousState?: LocalRoutesState<TDescriptor>;
 }): BaseStackScene<TDescriptor>[] => {
@@ -308,11 +308,11 @@ const withSceneRelationships = <TDescriptor extends BaseStackDescriptor>({
 	return nextScenes;
 };
 
-export const buildManagedStackState = <
+export const buildBlankStackState = <
 	TDescriptor extends BaseStackDescriptor,
 	TNavigation extends BaseStackNavigation,
 >(
-	params: BuildManagedStackStateParams<TDescriptor, TNavigation>,
+	params: BuildBlankStackStateParams<TDescriptor, TNavigation>,
 ): LocalRoutesState<TDescriptor> => {
 	const activityWindow = getSceneActivityWindow(params);
 	const focusedRouteKey =
@@ -322,7 +322,7 @@ export const buildManagedStackState = <
 		scenes: baseScenes,
 		routeChildStates,
 		sourceDescriptors,
-		descriptors: managedDescriptors,
+		descriptors: blankStackDescriptors,
 		routeKeys,
 		shouldShowFloatOverlay,
 	} = buildBaseScenes({
@@ -343,9 +343,12 @@ export const buildManagedStackState = <
 		routes: params.routes,
 		descriptors:
 			params.previousState &&
-			areDescriptorsEqual(params.previousState.descriptors, managedDescriptors)
+			areDescriptorsEqual(
+				params.previousState.descriptors,
+				blankStackDescriptors,
+			)
 				? params.previousState.descriptors
-				: managedDescriptors,
+				: blankStackDescriptors,
 		sourceDescriptors:
 			params.previousState &&
 			areDescriptorsEqual(

package/src/shared/providers/stack/{helpers/managed-stack-state/helpers/derive-managed-stack-state.ts → blank-stack-state/helpers/derive-blank-stack-state.ts}

@@ -1,10 +1,11 @@
-import type { ManagedStackProps } from "../../../../../types/providers/managed-stack.types";
+import type { BlankStackProviderProps } from "../../../../types/providers/blank-stack-provider.types";
 import type {
 	BaseStackDescriptor,
 	BaseStackNavigation,
 	RouteWithKey,
-} from "../../../../../types/stack.types";
-import { buildManagedStackState } from "./build-managed-stack-state";
+} from "../../../../types/stack.types";
+import { buildBlankStackState } from "./build-blank-stack-state";
+import { reconcileBlankStackRoutes } from "./reconcile-blank-stack-routes";
 import {
 	areDescriptorSourceMapsEquivalent,
 	areDescriptorsEqual,
@@ -12,17 +13,16 @@ import {
 	getRouteChildStateMap,
 	routesHaveSameKeys,
 	setsAreEqual,
-} from "./helpers";
-import { reconcileManagedRoutes } from "./reconcile-managed-routes";
-import type { LocalRoutesState, ManagedRoutes } from "./types";
+} from "./state-equality";
+import type { BlankStackRoutes, LocalRoutesState } from "./types";
 
-type DeriveManagedStackStateParams<
+type DeriveBlankStackStateParams<
 	TDescriptor extends BaseStackDescriptor,
 	TNavigation extends BaseStackNavigation,
 > = {
-	props: ManagedStackProps<TDescriptor, TNavigation>;
+	props: BlankStackProviderProps<TDescriptor, TNavigation>;
 	current: LocalRoutesState<TDescriptor>;
-	previousRoutesSnapshot: ManagedRoutes<TDescriptor>;
+	previousRoutesSnapshot: BlankStackRoutes<TDescriptor>;
 	closingRouteKeys: Set<string>;
 };
 
@@ -36,7 +36,7 @@ const routesAreIdentical = <Route extends RouteWithKey>(
 	return a.every((route, index) => route === b[index]);
 };
 
-export const deriveManagedStackState = <
+export const deriveBlankStackState = <
 	TDescriptor extends BaseStackDescriptor,
 	TNavigation extends BaseStackNavigation,
 >({
@@ -44,7 +44,7 @@ export const deriveManagedStackState = <
 	current,
 	previousRoutesSnapshot,
 	closingRouteKeys,
-}: DeriveManagedStackStateParams<
+}: DeriveBlankStackStateParams<
 	TDescriptor,
 	TNavigation
 >): LocalRoutesState<TDescriptor> => {
@@ -87,7 +87,7 @@ export const deriveManagedStackState = <
 		return current;
 	}
 
-	const result = reconcileManagedRoutes({
+	const result = reconcileBlankStackRoutes({
 		current,
 		previousRoutesSnapshot,
 		nextRoutesSnapshot,
@@ -109,7 +109,7 @@ export const deriveManagedStackState = <
 		return current;
 	}
 
-	return buildManagedStackState({
+	return buildBlankStackState({
 		props,
 		routes: routesChanged ? result.routes : current.routes,
 		descriptors: descriptorsChanged

package/src/shared/{utils → providers/stack/blank-stack-state/helpers}/navigation/compose-descriptors.ts

@@ -1,4 +1,4 @@
-import type { RouteWithKey } from "../../types/stack.types";
+import type { RouteWithKey } from "../../../../../types/stack.types";
 
 export const composeDescriptors = <
 	Route extends RouteWithKey,

package/src/shared/{utils → providers/stack/blank-stack-state/helpers}/navigation/sync-routes-with-removed.ts

@@ -1,9 +1,6 @@
-import type { useClosingRouteKeys } from "../../hooks/navigation/use-closing-route-keys";
-import type { RouteWithKey } from "../../types/stack.types";
+import type { RouteWithKey } from "../../../../../types/stack.types";
 import { composeDescriptors } from "./compose-descriptors";
 
-type ClosingRouteKeys = Set<string> | ReturnType<typeof useClosingRouteKeys>;
-
 type SyncRoutesWithRemovedParams<
 	Route extends RouteWithKey,
 	DescriptorMap extends Record<string, unknown>,
@@ -12,36 +9,7 @@ type SyncRoutesWithRemovedParams<
 	prevDescriptors: DescriptorMap;
 	nextRoutes: Route[];
 	nextDescriptors: DescriptorMap;
-	closingRouteKeys: ClosingRouteKeys;
-};
-
-const addClosingRouteKey = (
-	closingRouteKeys: ClosingRouteKeys,
-	key: string,
-) => {
-	closingRouteKeys.add(key);
-};
-
-const deleteClosingRouteKey = (
-	closingRouteKeys: ClosingRouteKeys,
-	key: string,
-) => {
-	if (closingRouteKeys instanceof Set) {
-		closingRouteKeys.delete(key);
-		return;
-	}
-
-	closingRouteKeys.remove(key);
-};
-
-const getClosingRouteKeyValues = (
-	closingRouteKeys: ClosingRouteKeys,
-): Iterable<string> => {
-	if (closingRouteKeys instanceof Set) {
-		return closingRouteKeys;
-	}
-
-	return closingRouteKeys.ref.current;
+	closingRouteKeys: Set<string>;
 };
 
 /**
@@ -91,16 +59,16 @@ export const syncRoutesWithRemoved = <
 
 		if (nextRouteWasPresent && !previousRouteStillPresent) {
 			// Previous route was removed, mark as closing
-			addClosingRouteKey(closingRouteKeys, previousFocusedRoute.key);
+			closingRouteKeys.add(previousFocusedRoute.key);
 
 			derivedRoutes.push(previousFocusedRoute);
 		} else {
 			// Next route is now active, not closing
-			deleteClosingRouteKey(closingRouteKeys, nextFocusedRoute.key);
+			closingRouteKeys.delete(nextFocusedRoute.key);
 
 			if (!previousRouteStillPresent) {
 				// Previous route needs to be inserted for transition
-				deleteClosingRouteKey(closingRouteKeys, previousFocusedRoute.key);
+				closingRouteKeys.delete(previousFocusedRoute.key);
 
 				const insertIndex = Math.max(derivedRoutes.length - 1, 0);
 				derivedRoutes.splice(insertIndex, 0, previousFocusedRoute);
@@ -108,14 +76,14 @@ export const syncRoutesWithRemoved = <
 		}
 	} else if (nextFocusedRoute) {
 		// Same focused route, ensure it's not marked as closing
-		deleteClosingRouteKey(closingRouteKeys, nextFocusedRoute.key);
+		closingRouteKeys.delete(nextFocusedRoute.key);
 	}
 
 	// Clean up closing keys that are no longer in the route list
 	const activeKeys = new Set(derivedRoutes.map((route) => route.key));
-	for (const key of Array.from(getClosingRouteKeyValues(closingRouteKeys))) {
+	for (const key of Array.from(closingRouteKeys)) {
 		if (!activeKeys.has(key)) {
-			deleteClosingRouteKey(closingRouteKeys, key);
+			closingRouteKeys.delete(key);
 		}
 	}
 

package/src/shared/providers/stack/{helpers/managed-stack-state/helpers/reconcile-managed-routes.ts → blank-stack-state/helpers/reconcile-blank-stack-routes.ts}

@@ -1,24 +1,25 @@
 import type {
 	BaseStackDescriptor,
 	RouteWithKey,
-} from "../../../../../types/stack.types";
-import { composeDescriptors } from "../../../../../utils/navigation/compose-descriptors";
-import { syncRoutesWithRemoved } from "../../../../../utils/navigation/sync-routes-with-removed";
-import { routesHaveSameKeys } from "./helpers";
+} from "../../../../types/stack.types";
+import { composeDescriptors } from "./navigation/compose-descriptors";
+import { syncRoutesWithRemoved } from "./navigation/sync-routes-with-removed";
+import { routesHaveSameKeys } from "./state-equality";
 import type {
+	BlankStackDescriptorSources,
+	BlankStackRoutes,
 	LocalRoutesState,
-	ManagedDescriptorSources,
-	ManagedRoutes,
 	ReconciledRoutes,
 } from "./types";
 
-type ReconcileManagedRoutesParams<TDescriptor extends BaseStackDescriptor> = {
-	current: LocalRoutesState<TDescriptor>;
-	previousRoutesSnapshot: ManagedRoutes<TDescriptor>;
-	nextRoutesSnapshot: ManagedRoutes<TDescriptor>;
-	nextDescriptors: ManagedDescriptorSources<TDescriptor>;
-	closingRouteKeys: Set<string>;
-};
+type ReconcileBlankStackRoutesParams<TDescriptor extends BaseStackDescriptor> =
+	{
+		current: LocalRoutesState<TDescriptor>;
+		previousRoutesSnapshot: BlankStackRoutes<TDescriptor>;
+		nextRoutesSnapshot: BlankStackRoutes<TDescriptor>;
+		nextDescriptors: BlankStackDescriptorSources<TDescriptor>;
+		closingRouteKeys: Set<string>;
+	};
 
 const alignRoutesWithLatest = <
 	Route extends RouteWithKey,
@@ -80,7 +81,7 @@ const acceptAlreadyClosingRouteRemovals = <
 	nextRoutesSnapshot,
 	nextDescriptors,
 	closingRouteKeys,
-}: ReconcileManagedRoutesParams<TDescriptor>): ReconciledRoutes<TDescriptor> | null => {
+}: ReconcileBlankStackRoutesParams<TDescriptor>): ReconciledRoutes<TDescriptor> | null => {
 	const nextRouteKeys = new Set(nextRoutesSnapshot.map((route) => route.key));
 	const acceptedRemovedKeys = new Set<string>();
 
@@ -116,10 +117,10 @@ const acceptAlreadyClosingRouteRemovals = <
 	const routes = [
 		...nextRoutesSnapshot,
 		...remainingClosingRoutes,
-	] as ManagedRoutes<TDescriptor>;
+	] as BlankStackRoutes<TDescriptor>;
 	const descriptors = {
 		...nextDescriptors,
-	} as ManagedDescriptorSources<TDescriptor>;
+	} as BlankStackDescriptorSources<TDescriptor>;
 
 	for (const route of remainingClosingRoutes) {
 		const descriptor = current.sourceDescriptors[route.key];
@@ -134,8 +135,10 @@ const acceptAlreadyClosingRouteRemovals = <
 	};
 };
 
-export const reconcileManagedRoutes = <TDescriptor extends BaseStackDescriptor>(
-	params: ReconcileManagedRoutesParams<TDescriptor>,
+export const reconcileBlankStackRoutes = <
+	TDescriptor extends BaseStackDescriptor,
+>(
+	params: ReconcileBlankStackRoutesParams<TDescriptor>,
 ): ReconciledRoutes<TDescriptor> => {
 	const {
 		current,
@@ -159,8 +162,9 @@ export const reconcileManagedRoutes = <TDescriptor extends BaseStackDescriptor>(
 		);
 
 		return {
-			routes: result.routes as ManagedRoutes<TDescriptor>,
-			descriptors: result.descriptors as ManagedDescriptorSources<TDescriptor>,
+			routes: result.routes as BlankStackRoutes<TDescriptor>,
+			descriptors:
+				result.descriptors as BlankStackDescriptorSources<TDescriptor>,
 		};
 	}
 
@@ -182,7 +186,7 @@ export const reconcileManagedRoutes = <TDescriptor extends BaseStackDescriptor>(
 	});
 
 	return {
-		routes: result.routes as ManagedRoutes<TDescriptor>,
-		descriptors: result.descriptors as ManagedDescriptorSources<TDescriptor>,
+		routes: result.routes as BlankStackRoutes<TDescriptor>,
+		descriptors: result.descriptors as BlankStackDescriptorSources<TDescriptor>,
 	};
 };

package/src/shared/providers/stack/{helpers/managed-stack-state/helpers/helpers.ts → blank-stack-state/helpers/state-equality.ts}

@@ -2,8 +2,8 @@ import type {
 	BaseStackDescriptor,
 	RouteWithKey,
 	StackDescriptorSource,
-} from "../../../../../types/stack.types";
-import type { ManagedDescriptorSources } from "./types";
+} from "../../../../types/stack.types";
+import type { BlankStackDescriptorSources } from "./types";
 
 export const areDescriptorsEqual = <
 	DescriptorMap extends Record<string, unknown>,
@@ -135,8 +135,8 @@ export const areDescriptorSourcesEquivalent = <
 export const areDescriptorSourceMapsEquivalent = <
 	TDescriptor extends BaseStackDescriptor,
 >(
-	previous: ManagedDescriptorSources<TDescriptor>,
-	next: ManagedDescriptorSources<TDescriptor>,
+	previous: BlankStackDescriptorSources<TDescriptor>,
+	next: BlankStackDescriptorSources<TDescriptor>,
 ): boolean => {
 	if (previous === next) return true;
 

package/src/shared/providers/stack/{helpers/managed-stack-state → blank-stack-state}/helpers/types.ts

@@ -1,25 +1,26 @@
-import type { ManagedStackProps } from "../../../../../types/providers/managed-stack.types";
+import type { BlankStackProviderProps } from "../../../../types/providers/blank-stack-provider.types";
 import type {
 	BaseStackDescriptor,
 	BaseStackNavigation,
 	BaseStackRoute,
 	BaseStackScene,
 	StackDescriptorSource,
-} from "../../../../../types/stack.types";
+} from "../../../../types/stack.types";
 
-export type ManagedRoutes<TDescriptor extends BaseStackDescriptor> =
+export type BlankStackRoutes<TDescriptor extends BaseStackDescriptor> =
 	TDescriptor["route"][];
 
-export type ManagedDescriptors<TDescriptor extends BaseStackDescriptor> =
+export type BlankStackDescriptors<TDescriptor extends BaseStackDescriptor> =
 	Record<string, TDescriptor>;
 
-export type ManagedDescriptorSources<TDescriptor extends BaseStackDescriptor> =
-	Record<string, StackDescriptorSource<TDescriptor>>;
+export type BlankStackDescriptorSources<
+	TDescriptor extends BaseStackDescriptor,
+> = Record<string, StackDescriptorSource<TDescriptor>>;
 
 export type LocalRoutesState<TDescriptor extends BaseStackDescriptor> = {
-	routes: ManagedRoutes<TDescriptor>;
-	descriptors: ManagedDescriptors<TDescriptor>;
-	sourceDescriptors: ManagedDescriptorSources<TDescriptor>;
+	routes: BlankStackRoutes<TDescriptor>;
+	descriptors: BlankStackDescriptors<TDescriptor>;
+	sourceDescriptors: BlankStackDescriptorSources<TDescriptor>;
 	focusedRouteKey?: string;
 	routeChildStates: Record<string, unknown>;
 	scenes: BaseStackScene<TDescriptor>[];
@@ -28,26 +29,26 @@ export type LocalRoutesState<TDescriptor extends BaseStackDescriptor> = {
 	closingRouteKeys: ReadonlySet<string>;
 };
 
-export type ManagedStackControllerSnapshot<
+export type BlankStackControllerSnapshot<
 	TDescriptor extends BaseStackDescriptor,
 > = {
 	state: LocalRoutesState<TDescriptor>;
 };
 
-export type ManagedStackController<
+export type BlankStackController<
 	TDescriptor extends BaseStackDescriptor,
 	TNavigation extends BaseStackNavigation,
 > = {
 	subscribe: (listener: () => void) => () => void;
-	getSnapshot: () => ManagedStackControllerSnapshot<TDescriptor>;
-	update: (props: ManagedStackProps<TDescriptor, TNavigation>) => void;
+	getSnapshot: () => BlankStackControllerSnapshot<TDescriptor>;
+	update: (props: BlankStackProviderProps<TDescriptor, TNavigation>) => void;
 	handleCloseRoute: (payload: { route: BaseStackRoute }) => void;
 	requestDismiss: (payload: { route: BaseStackRoute }) => boolean;
 };
 
 export type ReconciledRoutes<TDescriptor extends BaseStackDescriptor> = {
-	routes: ManagedRoutes<TDescriptor>;
-	descriptors: ManagedDescriptorSources<TDescriptor>;
+	routes: BlankStackRoutes<TDescriptor>;
+	descriptors: BlankStackDescriptorSources<TDescriptor>;
 };
 
 export type SceneActivityWindow = {

package/src/shared/providers/stack/{helpers/managed-stack-state → blank-stack-state}/index.ts

@@ -1,26 +1,26 @@
 import { useRef, useSyncExternalStore } from "react";
-import type { ManagedStackProps } from "../../../../types/providers/managed-stack.types";
+import type { BlankStackProviderProps } from "../../../types/providers/blank-stack-provider.types";
 import type {
 	BaseStackDescriptor,
 	BaseStackNavigation,
-} from "../../../../types/stack.types";
+} from "../../../types/stack.types";
 import {
-	createManagedStackController,
-	type ManagedStackController,
-} from "./managed-stack-controller";
+	type BlankStackController,
+	createBlankStackController,
+} from "./blank-stack-controller";
 
-export const useManagedStackState = <
+export const useBlankStackState = <
 	TDescriptor extends BaseStackDescriptor,
 	TNavigation extends BaseStackNavigation,
 >(
-	props: ManagedStackProps<TDescriptor, TNavigation>,
+	props: BlankStackProviderProps<TDescriptor, TNavigation>,
 ) => {
 	const controllerRef = useRef<
-		ManagedStackController<TDescriptor, TNavigation> | undefined
+		BlankStackController<TDescriptor, TNavigation> | undefined
 	>(undefined);
 
 	if (!controllerRef.current) {
-		controllerRef.current = createManagedStackController(props);
+		controllerRef.current = createBlankStackController(props);
 	}
 
 	const controller = controllerRef.current;