/// 静态资源路径常量，统一维护，避免路径字符串散落在业务代码中。
///
/// 所有路径须与 pubspec.yaml 的 flutter.assets 声明保持一致。
/// 新增资源：① 文件放入 assets/ ② pubspec.yaml 声明 ③ 此处加常量。
///
/// 渲染逻辑（缓存、占位、错误态）由 core/ui/components/ 下的组件负责，不在此处封装。
///
/// ## 使用
/// ```dart
/// Image.asset(AppAssets.logo)
/// Image.asset(AppAssets.logo, width: 80, fit: BoxFit.cover)
/// ```
abstract final class AppAssets {
  AppAssets._();

  // ── 品牌 ──────────────────────────────────────────────────
  static const logo = 'assets/images/logo.png';
  static const logoLight = 'assets/images/logo_light.png';

  // ── 占位图 ────────────────────────────────────────────────
  static const avatarPlaceholder = 'assets/images/avatar_placeholder.png';

  // ── 空状态插图（SVG，引入 flutter_svg 后启用） ─────────────
  // static const emptyChat        = 'assets/svg/empty_chat.svg';
  // static const emptyContact     = 'assets/svg/empty_contact.svg';
  // static const emptySearch      = 'assets/svg/empty_search.svg';

  // ── 动画 ──────────────────────────────────────────────────
  // static const loading          = 'assets/gif/loading.gif';
}
