feature-settings

Feature: Settings

Purpose: Provides two persisted boolean settings (haptic feedback, wakelock/prevent-sleep) and three ready-made settings row widgets that integrate with Riverpod state. There is no domain or data layer — settings use the core CacheBoolStateNotifier and ThemeStateNotifier patterns directly.

---

Layer Map

lib/src/features/settings/
└── presentation/
    ├── notifiers/
    │   ├── haptic_feedback_state_notifier.dart  # HapticFeedbackStateNotifier
    │   └── wakelock_state_notifier.dart          # WakelockStateNotifier
    └── widgets/
        ├── switch_row_widget.dart               # SwitchRowWidget (generic toggle row)
        ├── cache_bool_row_widget.dart           # CacheBoolRowWidget (wires to StateNotifier)
        └── theme_row_widget.dart                # ThemeRowWidget (dark/light mode toggle)

---

Notifiers

HapticFeedbackStateNotifier

File: lib/src/features/settings/presentation/notifiers/haptic_feedback_state_notifier.dart

Extends CacheBoolStateNotifier. Persists haptic feedback preference to SharedPreferences.

const _key = 'hapticFeedback';
const kDefaultHapticFeedback = true; // enabled by default

// Key is debug-aware:
String hapticFeedbackKey() => kDebugMode ? '${_key}Debug' : _key;

// Provider — NOT autoDispose (global app setting):
final hapticFeedbackStateNotifierProvider =
    StateNotifierProvider<HapticFeedbackStateNotifier, bool>(...);

Usage in other widgets: LabelRowWidget.copyToClipboard and LabelRowWidget.openLink both read hapticFeedbackStateNotifierProvider via ProviderScope.containerOf(context) to trigger HapticFeedback.lightImpact() before the action. Haptic feedback is therefore automatic across all list rows.

WakelockStateNotifier

File: lib/src/features/settings/presentation/notifiers/wakelock_state_notifier.dart

Extends CacheBoolStateNotifier. Persists wakelock (prevent screen sleep) preference and applies it immediately via WakelockPlus.toggle(enable: state) on initialization.