import 'package:flutter/foundation.dart';

/// 会话纪元：每次显式登录 / 登出成功后自增（见 AuthNotifier.login/logout）。
///
/// main.dart 以其为 ProviderScope 的 key —— 纪元变化即整棵 Riverpod 状态树销毁重建，
/// 所有业务 provider（含 notifier 实例字段里的分页 / 筛选 / _cache 兜底缓存）随账号
/// 切换彻底清零，杜绝跨账号内存残留（如订单列表显示上一账号数据的泄漏）。
///
/// 必须在 Riverpod 体系外（scope 重建时它自身要存活），故用裸 ValueNotifier。
/// 只在 login()/logout() 主动 bump；启动恢复持久化会话（restore()）不 bump，
/// 否则「重建 → restore → 又 bump」死循环。
final ValueNotifier<int> sessionEpoch = ValueNotifier(0);