MiniCardOptions class

Configuration options for the MiniCard widget.

Provides properties to customize the appearance of a small participant avatar/badge, displaying either an image or text initials with extensive styling options.

Core Display Properties:

• initials: Text fallback when no image provided (e.g., "JD" for "John Doe")
• fontSize: Text size for initials (default: 14)
• imageSource: Optional network image URL; if null/empty, displays initials
• roundedImage: If true, applies circular clipping (borderRadius=9999); default=true

Container Styling:

• customStyle: BoxDecoration for outer container (background, border, etc.)
• padding/margin/alignment: Positioning and spacing for outer container

Initials Styling:

• initialsDecoration: BoxDecoration for initials wrapper (background color, etc.)
• initialsPadding: Padding around initials text
• initialsTextStyle: TextStyle override (font, color, weight); default=black/600

Image Styling:

• imageStyle: BoxDecoration for image wrapper (border radius extracted for ClipRRect)
• imageContainerDecoration: BoxDecoration for image wrapper container
• imageContainerPadding/imageContainerMargin: Spacing for image wrapper
• imageFit: How image fills bounds (default: BoxFit.cover)
• imageAlignment: Image alignment within bounds (default: Alignment.center)

Builder Hooks (3):

• customBuilder: Full widget replacement; receives MiniCardOptions
• containerBuilder: Override outer Container; receives MiniCardContainerContext + default
• imageBuilder: Override image display; receives MiniCardImageContext + default
• initialsBuilder: Override initials display; receives MiniCardInitialsContext + default

Usage Patterns:

1. Default Initials Display:

   MiniCard(
     options: MiniCardOptions(
       initials: 'JD',
       customStyle: BoxDecoration(color: Colors.blue, shape: BoxShape.circle),
     ),
   )
   

2. Image Avatar:

   MiniCard(
     options: MiniCardOptions(
       initials: 'JD',
       imageSource: 'https://example.com/avatar.jpg',
       roundedImage: true,
     ),
   )
   

3. Custom Builder Hook:

   MiniCard(
     options: MiniCardOptions(
       initials: 'JD',
       containerBuilder: (context, defaultContainer) {
         return GestureDetector(
           onTap: () => print('Avatar tapped'),
           child: defaultContainer,
         );
       },
     ),
   )
   

Override Integration: Can be overridden via MediasfuUICustomOverrides using ComponentOverride<MiniCardOptions>:

overrides: MediasfuUICustomOverrides(
  miniCardOptions: ComponentOverride<MiniCardOptions>(
    builder: (existingOptions) => MiniCardOptions(
      initials: existingOptions.initials,
      imageSource: existingOptions.imageSource,
      customStyle: BoxDecoration(border: Border.all(color: Colors.gold, width: 2)),
    ),
  ),
),

Implementation Notes:

• Image loading failures automatically fallback to initials display
• Border radius extraction from imageStyle.borderRadius for ClipRRect compatibility
• Builder hooks receive both context and default widget for wrapping patterns