ZenRoute class

Route-scoped dependency injection widget

ZenRoute creates a new ZenScope, initializes a ZenModule with its dependencies, and provides the scope to its child widget tree via InheritedWidget.

Architecture:

• Automatic parent scope discovery via widget tree (InheritedWidget)
• Module-based dependency registration with dependency chaining
• Automatic lifecycle management (init → onInit → dispose → onDispose)
• Clean disposal when widget is removed from tree

Features:

• Widget tree-based hierarchy: No global state, uses InheritedWidget for parent discovery
• Module composition: Modules can declare dependencies on other modules
• Async initialization: Supports async onInit() for setup tasks
• Error handling: Shows error UI with retry button
• Loading state: Displays loading UI during initialization

Example:

ZenRoute(
  moduleBuilder: () => FeatureModule(),
  page: FeaturePage(),
  scopeName: 'FeatureScope', // Optional name for debugging
)

The scope is automatically disposed when this widget is removed from the tree.