ArcaneAppState class

The state class for ArcaneApp, managing app-level state including theme and navigation.

This class handles initialization, theme updates, and the build process for the app's root widget tree. It provides global access via Arcane.$app and ensures efficient rebuilds by caching the ArcaneTheme and using Pylon for provider-like theme distribution. Integrates with ShadcnApp for rendering, applying theme extensions to ThemeData and handling both standard Navigator and Router modes. Emphasizes performance through minimal state changes and lazy route factories, making it the core for scalable Arcane UIs with components like BottomNavigationBar and Sidebar.

Key features:

• Theme management with setTheme for dynamic updates without full restarts.
• Route factory caching to avoid regeneration on rebuilds.
• Integration with global services (Serviced) and events (ArcaneShadEvents).
• Announcement logging for key lifecycle events, aiding debugging.

Usage: Automatically created by ArcaneApp; access via Arcane.$app for theme or update calls. It propagates ArcaneTheme to descendants, ensuring consistent styling and scroll behavior.

Parameters: Inherited from ArcaneApp; manages internal _theme and routeFactory.

Returns: Widgets via build, including ShadcnApp wrapped with theme provider.

Integrations: Uses Pylon<ArcaneTheme> for context provision, PopoverOverlayHandler for overlays, and BouncingScrollPhysics defaults for smooth interactions. Optimizes for low overhead by inlining simple getters and avoiding unnecessary async in non-await methods.