SolPanViewModel

Main state management ViewModel for SolPan.

Combines multiple reactive streams (location, orientation, magnetic declination, preferences) to produce a unified uiState that the UI observes. All state updates are reactive and observable via StateFlow, ensuring the UI always reflects the current system state.

Reactive Architecture

The ViewModel follows a reactive architecture pattern:

• Location updates are debounced (300ms) to avoid excessive recomputation

• Magnetic declination is computed lazily from location changes

• Solar calculations are recomputed when tilt mode or location changes

• Realtime mode ticks every 30 seconds to update sun position

• UI state combines all streams with WhileSubscribed(5000) to auto-cleanup when UI is backgrounded

Key Flows

• optimalPanelParameters: Combines location, declination, mode, and realtime ticks

• uiState: Master state object combining all UI-relevant data

• showTutorial: Combines user preferences with manual tutorial overrides

Thread Safety

All state flows are thread-safe and backed by coroutines. Updates from sensors/location providers are marshalled through the viewModelScope dispatcher.

Parameters