🎨 Transições

O Modugo oferece 8 tipos de transição de página prontos para uso, integrados ao GoRouter via CustomTransitionPage.

---

🔹 Tipos Disponíveis

Tipo	Descrição	Widget Interno
TypeTransition.fade	Cross-fade (padrão)	FadeTransition
TypeTransition.scale	Zoom in	ScaleTransition
TypeTransition.slideUp	Entra de baixo para cima	SlideTransition
TypeTransition.slideDown	Entra de cima para baixo	SlideTransition
TypeTransition.slideLeft	Entra da direita para esquerda	SlideTransition
TypeTransition.slideRight	Entra da esquerda para direita	SlideTransition
TypeTransition.rotation	Rotação	RotationTransition
TypeTransition.native	Página nativa da plataforma	CupertinoPage (iOS) / MaterialPage (demais)

TypeTransition.native tem prioridade máxima na seleção de página — ignora iosGestureEnabled e usa sempre a página nativa da plataforma. No iOS isso garante o swipe-back nativo via CupertinoPage.

---

🔹 Aplicando em Rotas

Por rota individual

route(
  '/details',
  child: (_, _) => const DetailsPage(),
  transition: TypeTransition.slideLeft,
);

Ou com a sintaxe tradicional:

ChildRoute(
  path: '/details',
  child: (_, _) => const DetailsPage(),
  transition: TypeTransition.slideLeft,
);

Transição padrão global

Defina a transição padrão para todas as rotas via Modugo.configure():

await Modugo.configure(
  module: AppModule(),
  pageTransition: TypeTransition.slideLeft,
);

Se uma rota não define transition, a transição global é usada. O padrão global é TypeTransition.fade.

---

🔹 Usando Transition.builder Diretamente

Para cenários avançados, você pode usar o builder diretamente:

final transitionBuilder = Transition.builder(
  type: TypeTransition.slideUp,
  config: () => debugPrint('Aplicando transição'),
);

O config é um callback executado antes de construir a animação, útil para logging ou side-effects.