NavEaseController

class NavEaseController(backStack: NavBackStack<NavKey>, showExitDialog: () -> Unit = {}, defaultTransition: NavTransition = NavTransition.Push)

Orchestrates navigation across the back stack.

One instance is created per io.github.alimsrepo.navease.runtime.presentation.NavEaseNavGraph call and is never shared between independent nav graphs — this prevents back-stack or result cross-contamination in nested / multi-window setups.

backStack

showExitDialog

Called when back is invoked at the root (back-stack size == 1).

defaultTransition

The app-level fallback transition used when navigate is called without an explicit NavTransition override. Supplied by io.github.alimsrepo.navease.runtime.presentation.NavEaseNavGraph from the navTransition parameter of NavEaseHost.

Constructors

constructor(backStack: NavBackStack<NavKey>, showExitDialog: () -> Unit = {}, defaultTransition: NavTransition = NavTransition.Push)

fun back()

Pops the current screen. If the back stack contains only the root screen, showExitDialog is invoked instead.

Posts result back to the previous screen and immediately pops the current screen.

Returns a snapshot of the current back stack, oldest entry first.

fun navigate(navKey: NavKey, finish: Boolean = false, singleTop: Boolean = false, navTransition: NavTransition? = null)

Pushes navKey onto the back stack.

Pops the back stack down to index (0 = root). All entries above index are removed. Use getHistory to determine the target index before calling this.

fun popUpTo(key: NavKey, inclusive: Boolean = false)

Pops the back stack until key's screen is reached.

Inline reified convenience overload of resultOf.

Observes the result of type T returned by a child screen via backWithResult.