============================================================================

1. NEURON CORE (Service Locator + Navigation)

   Global service locator and navigation manager for Neuron.

The Neuron class serves two primary purposes:

1. Service Locator: Manages the lifecycle of NeuronController instances, ensuring they are created once and disposed properly.
2. Context-less Navigation: Provides navigation methods that don't require a BuildContext, making navigation cleaner and more testable.

Service Locator Usage

The most common pattern is to use ensure with a static getter in your controller:

class MyController extends NeuronController {
  static MyController get init => Neuron.ensure<MyController>(() => MyController());
}

Then in your UI:

final controller = MyController.init; // Returns existing or creates new

Navigation Usage

All navigation methods work without a BuildContext:

Neuron.to(DetailPage());           // Push page
Neuron.off(HomePage());            // Replace page
Neuron.back();                     // Pop page
Neuron.toNamed('/settings');       // Named route

See also:

• install - Register a controller manually
• use - Get an already registered controller
• ensure - Get or create a controller
• uninstall - Dispose and remove a controller