buzz/mobile/lib/shared/widgets/playing_avatar_image.dart

import 'package:flutter/material.dart';

import '../animated_avatar.dart';
import 'avatar_image.dart';
import 'progressive_animated_avatar.dart';

/// A circular avatar that opts into playback for animated profile descriptors.
class PlayingAvatarImage extends StatelessWidget {
  /// Creates an avatar that plays animation when the profile URL describes it.
  const PlayingAvatarImage({
    super.key,
    required this.imageUrl,
    required this.radius,
    required this.fallback,
    this.backgroundColor,
  });

  /// The still-image URL or encoded animated-avatar descriptor.
  final String? imageUrl;

  /// The radius of the circular avatar.
  final double radius;

  /// Optional background shown behind still-image content.
  final Color? backgroundColor;

  /// Content shown while media is unavailable or still loading.
  final Widget fallback;

  @override
  Widget build(BuildContext context) {
    final descriptor = parseAnimatedAvatarUrl(imageUrl);
    if (descriptor == null || MediaQuery.disableAnimationsOf(context)) {
      return AvatarImage(
        imageUrl: descriptor?.posterUrl ?? imageUrl,
        radius: radius,
        backgroundColor: backgroundColor,
        fallback: fallback,
      );
    }

    return CircleAvatar(
      radius: radius,
      backgroundColor: Colors.transparent,
      child: ClipOval(
        child: SizedBox.square(
          dimension: radius * 2,
          child: ProgressiveAnimatedAvatar(
            descriptor: descriptor,
            fallback: fallback,
          ),
        ),
      ),
    );
  }
}