Modelling UI state: AsyncValue, a status enum, a sealed union

// ══ 1. AsyncValue: sadə "yüklə və göstər" ══
@riverpod
class OrderList extends _$OrderList {
  @override
  Future<List<Order>> build() =>
      ref.watch(orderRepositoryProvider).fetchMine();
}

// View: AsyncValue sealed-dir, switch tam yoxlanılır.
final state = ref.watch(orderListProvider);
return switch (state) {
  AsyncData(:final value) when value.isEmpty => const EmptyOrders(),
  AsyncData(:final value) => OrderListView(orders: value),
  AsyncError(:final error) => ErrorView(error: error),
  _ => const LoadingView(),
};


// ══ 2. Status enum: vəziyyətlər üst-üstə düşür ══
// (siyahı göstərilir VƏ eyni anda yenilənir VƏ filtr seçilib)
enum OrderListStatus { initial, loading, refreshing, success, failure }

@freezed
abstract class OrderListState with _$OrderListState {
  const factory OrderListState({
    @Default(OrderListStatus.initial) OrderListStatus status,
    @Default([]) List<Order> orders,       // yenilənərkən köhnə siyahı qalır
    @Default(OrderFilter.all) OrderFilter filter,
    Failure? failure,
    @Default(false) bool hasMore,          // səhifələmə
  }) = _OrderListState;
}


// ══ 3. Sealed union: vəziyyətlər bir-birini istisna edir ══
// (form: ya redaktə olunur, ya göndərilir, ya bitib)
@freezed
sealed class CheckoutState with _$CheckoutState {
  const factory CheckoutState.editing({
    required CheckoutForm form,
    @Default({}) Map<String, String> fieldErrors,
  }) = CheckoutEditing;

  const factory CheckoutState.submitting({
    required CheckoutForm form,
  }) = CheckoutSubmitting;

  const factory CheckoutState.submitted({
    required Order order,
  }) = CheckoutSubmitted;

  const factory CheckoutState.failed({
    required CheckoutForm form,
    required Failure failure,
  }) = CheckoutFailed;
}

// View: hər vəziyyət ayrı widget, mümkün olmayan hal YOXDUR.
return switch (ref.watch(checkoutNotifierProvider)) {
  CheckoutEditing(:final form, :final fieldErrors) =>
    CheckoutForm(form: form, errors: fieldErrors),
  CheckoutSubmitting() => const CheckoutFormDisabled(),
  CheckoutSubmitted(:final order) => OrderSuccess(order: order),
  CheckoutFailed(:final form, :final failure) =>
    CheckoutForm(form: form, banner: failure),
};