🚀 New Major Features #

Right-Click Context Menu System (Web Only)

• NEW: Native-like right-click context menu for images with browser-style actions
• NEW: enableContextMenu parameter to enable/disable context menu functionality
• NEW: customContextMenuItems for adding custom menu items with icons and callbacks
• NEW: Built-in context menu actions:
  • Copy image - Copies image to system clipboard for Ctrl+V pasting
  • Save image as... - Shows browser save dialog with File System Access API
  • Open image in new tab - Opens image URL in new browser tab
  • Copy image address - Copies image URL to clipboard

Advanced Context Menu Customization

• NEW: ContextMenuItem class for defining custom menu items with icons and actions
• NEW: ContextMenuAction enum for built-in and custom actions
• NEW: Context menu styling options:
  • contextMenuBackgroundColor - Custom background color
  • contextMenuTextColor - Custom text color
  • contextMenuElevation - Shadow elevation
  • contextMenuBorderRadius - Corner radius
  • contextMenuPadding - Internal padding
• NEW: onContextMenuAction callback for handling menu item selections

Smart Context Menu Behavior

• NEW: Automatic browser context menu prevention only when hovering over images
• NEW: Smart positioning to keep menu on screen (auto-adjusts near edges)
• NEW: Overlay-based rendering for proper z-index and click-outside dismissal
• NEW: Works across all image loading states (loading, loaded, error, HTML fallback)

Enhanced Download & Save Experience

• NEW: File System Access API integration for proper save dialogs with location picker
• NEW: Traditional blob download fallback for browser compatibility
• NEW: Success/failure toast notifications with color-coded feedback
• NEW: Proper file permissions and visibility in file system
• NEW: Enhanced error handling with detailed logging for debugging

🎨 Usage Examples #

Basic Context Menu

CustomNetworkImage(
  url: 'https://example.com/image.jpg',
  width: 300,
  height: 200,
  
  // ✅ NEW: Enable right-click context menu
  enableContextMenu: true,
  
  // ✅ NEW: Handle context menu actions
  onContextMenuAction: (action) {
    print('Context menu action: $action');
  },
)

Custom Context Menu Items

CustomNetworkImage(
  url: 'https://example.com/image.jpg',
  enableContextMenu: true,
  
  // ✅ NEW: Custom menu items with icons
  customContextMenuItems: [
    ContextMenuItem(
      title: 'Download Image',
      icon: Icons.download,
      action: ContextMenuAction.saveImage,
    ),
    ContextMenuItem(
      title: 'Copy to Clipboard',
      icon: Icons.copy,
      action: ContextMenuAction.copyImage,
    ),
    ContextMenuItem(
      title: 'Custom Action',
      icon: Icons.star,
      action: ContextMenuAction.custom,
      onTap: () {
        // Custom action handler
        print('Custom action executed!');
      },
    ),
  ],
  
  // ✅ NEW: Custom styling
  contextMenuBackgroundColor: Colors.grey[800],
  contextMenuTextColor: Colors.white,
  contextMenuElevation: 8.0,
  contextMenuBorderRadius: BorderRadius.circular(12),
)

Context Menu with Toast Notifications

CustomNetworkImage(
  url: 'https://example.com/image.jpg',
  enableContextMenu: true,
  onContextMenuAction: (action) {
    // Toast notifications automatically shown for:
    // ✅ Image saved successfully!
    // ❌ Failed to save image
    // Image copied to clipboard
    // Image URL copied to clipboard
    // Opening image in new tab
  },
)

🛠️ Technical Implementation #

New Classes & Enums

// Context menu item definition
class ContextMenuItem {
  final String title;
  final IconData? icon;
  final ContextMenuAction action;
  final VoidCallback? onTap;
}

// Available context menu actions
enum ContextMenuAction {
  copyImage,           // Copy image to clipboard
  saveImage,           // Save image with file picker
  openImageInNewTab,   // Open in new browser tab
  copyImageUrl,        // Copy URL to clipboard
  custom,              // Custom action with onTap callback
}

Context Menu Parameters

CustomNetworkImage(
  // Context menu control
  enableContextMenu: true,                    // Enable/disable context menu
  customContextMenuItems: [...],              // Custom menu items
  onContextMenuAction: (action) => {...},     // Action callback
  
  // Styling options
  contextMenuBackgroundColor: Colors.white,   // Background color
  contextMenuTextColor: Colors.black,         // Text color
  contextMenuElevation: 8.0,                  // Shadow elevation
  contextMenuBorderRadius: BorderRadius.circular(8), // Corner radius
  contextMenuPadding: EdgeInsets.all(8),      // Internal padding
)

🌐 Platform Support & Behavior #

Web Platform (Primary Target)

• ✅ Full context menu functionality with native-like behavior
• ✅ File System Access API for proper save dialogs with location picker
• ✅ Clipboard API integration for image and URL copying
• ✅ Browser context menu prevention only when hovering over images
• ✅ Toast notifications for user feedback

Mobile/Desktop Platforms

• ⚠️ Limited support - Context menus are primarily a web/desktop concept
• ✅ Hover icons remain available as alternative for touch interfaces
• ✅ Manual download/copy buttons continue to work normally

🎯 Smart Context Menu Features #

Intelligent Positioning

• Auto-adjustment: Menu automatically repositions to stay on screen
• Edge detection: Prevents menu from going off screen edges
• Responsive sizing: Adapts to different screen sizes and orientations

State-Aware Behavior

• Loading state: Context menu available during image loading
• Loaded state: Full functionality with image data access
• Error state: Context menu still works with URL-based actions
• HTML fallback: Context menu overlays HTML img elements

Browser Integration

• Selective prevention: Only prevents browser context menu when over images
• Normal browsing: Browser context menu works normally on text, links, etc.
• Download integration: Uses browser's download system for familiar UX

🔧 Enhanced Download System #

File System Access API (Modern Browsers)

• Save dialog: Shows native file picker for choosing save location
• File permissions: Proper file permissions for visibility in file managers
• Progress feedback: Toast notifications for save success/failure
• User control: Full control over save location and filename

Fallback Download Methods

• Blob download: Traditional browser download to Downloads folder
• Direct download: URL-based download as last resort
• Error handling: Graceful degradation with detailed error logging

📱 Example Integration #

Complete Context Menu Demo

class ContextMenuDemo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return CustomNetworkImage(
      url: 'https://picsum.photos/300/200',
      width: 300,
      height: 200,
      
      // Enable context menu with default items
      enableContextMenu: true,
      
      // Custom styling
      contextMenuBackgroundColor: Colors.grey[800],
      contextMenuTextColor: Colors.white,
      contextMenuElevation: 12.0,
      contextMenuBorderRadius: BorderRadius.circular(8),
      
      // Handle actions
      onContextMenuAction: (action) {
        switch (action) {
          case ContextMenuAction.copyImage:
            // Image copied to clipboard automatically
            break;
          case ContextMenuAction.saveImage:
            // Save dialog shown automatically
            break;
          case ContextMenuAction.openImageInNewTab:
            // Image opened in new tab automatically
            break;
          case ContextMenuAction.copyImageUrl:
            // URL copied to clipboard automatically
            break;
        }
      },
    );
  }
}

🔄 Backward Compatibility #

• 100% backward compatible - existing code continues to work unchanged
• Optional feature - context menu is opt-in via enableContextMenu parameter
• No conflicts - works alongside existing hover icons and callbacks
• Progressive enhancement - add context menu to existing implementations gradually

🧪 Comprehensive Testing #

• Cross-browser testing on Chrome, Firefox, Safari, Edge
• File System Access API testing with save dialog functionality
• Clipboard integration testing with copy/paste operations
• Context menu positioning testing near screen edges
• Toast notification testing for user feedback
• Error handling testing for various failure scenarios

---

🚀 New Major Features #

External Controller System

• NEW: CustomNetworkImageController for external image management and control
• NEW: controller parameter in CustomNetworkImage for linking external controller
• NEW: External methods for image operations:
  • controller.reload() - Reload image from URL
  • controller.downloadImage() - Download image to device
  • controller.copyImageToClipboard() - Copy image to system clipboard
  • controller.getCurrentImageData() - Get current image data
  • controller.waitForLoad() - Wait for image loading with timeout

Real-time State Management

• NEW: Live state monitoring with ChangeNotifier integration:
  • controller.isLoading - Check if image is currently loading
  • controller.isLoaded - Check if image loaded successfully
  • controller.isFailed - Check if image failed to load
  • controller.hasImageData - Check if image data is available
  • controller.loadingProgress - Get current loading progress
  • controller.errorMessage - Get current error message

Multiple Controller Support

• NEW: Use separate controllers for different images in same widget tree
• NEW: Independent state management for each image instance
• NEW: External control of multiple images simultaneously

🏗️ Architecture Improvements #

Code Refactoring & Separation

• NEW: lib/src/types.dart - Shared types and enums for better organization
• NEW: lib/src/custom_network_image_controller.dart - Dedicated controller implementation
• IMPROVED: Removed duplicate type definitions across files
• IMPROVED: Better import structure and dependency management
• IMPROVED: Cleaner codebase with separated concerns

Enhanced Library Exports

• NEW: Export controller and types for external usage
• NEW: Public API access to CustomNetworkImageController
• NEW: Access to ImageLoadingState, CustomImageProgress, ImageDataInfo
• NEW: Public access to ImageClipboardHelper for manual operations

🎮 Usage Examples #

Basic Controller Usage

final controller = CustomNetworkImageController();

// Listen to state changes
controller.addListener(() {
  print('Loading state: ${controller.loadingState}');
  if (controller.isLoaded) {
    print('Image ready: ${controller.imageData?.width}x${controller.imageData?.height}');
  }
});

// Use with widget
CustomNetworkImage(
  url: 'https://example.com/image.jpg',
  controller: controller,
  downloadIcon: Icon(Icons.download),
  copyIcon: Icon(Icons.copy),
)

// External control
await controller.downloadImage();
await controller.copyImageToClipboard();
controller.reload();

Multiple Controllers

class MultiImageWidget extends StatefulWidget {
  @override
  _MultiImageWidgetState createState() => _MultiImageWidgetState();
}

class _MultiImageWidgetState extends State<MultiImageWidget> {
  late CustomNetworkImageController controller1;
  late CustomNetworkImageController controller2;
  
  @override
  void initState() {
    super.initState();
    controller1 = CustomNetworkImageController();
    controller2 = CustomNetworkImageController();
  }
  
  @override
  Widget build(BuildContext context) {
    return Row(
      children: [
        Expanded(
          child: Column(
            children: [
              CustomNetworkImage(
                url: 'https://example.com/image1.jpg',
                controller: controller1,
              ),
              ElevatedButton(
                onPressed: () => controller1.reload(),
                child: Text('Reload Image 1'),
              ),
            ],
          ),
        ),
        Expanded(
          child: Column(
            children: [
              CustomNetworkImage(
                url: 'https://example.com/image2.jpg',
                controller: controller2,
              ),
              ElevatedButton(
                onPressed: () => controller2.downloadImage(),
                child: Text('Download Image 2'),
              ),
            ],
          ),
        ),
      ],
    );
  }
  
  @override
  void dispose() {
    controller1.dispose();
    controller2.dispose();
    super.dispose();
  }
}

🔧 Technical Implementation #

Controller State Management

class CustomNetworkImageController extends ChangeNotifier {
  // State properties
  ImageLoadingState get loadingState;
  CustomImageProgress? get loadingProgress;
  ImageDataInfo? get imageData;
  String? get errorMessage;
  
  // Convenience getters
  bool get isLoading;
  bool get isLoaded;
  bool get isFailed;
  bool get hasImageData;
  
  // Control methods
  void reload();
  Future<bool> downloadImage();
  Future<bool> copyImageToClipboard();
  Future<ImageDataInfo> waitForLoad({Duration timeout});
}

Integration with Existing Features

• Full Compatibility: Controller works alongside all existing hover icons and callbacks
• State Sync: Widget state automatically syncs with controller state
• Error Handling: Controller captures and exposes all error states
• Progress Tracking: Real-time loading progress available through controller

📱 Enhanced Example App #

• NEW: Comprehensive controller demonstration in example/simple_usage_example.dart
• NEW: Live status panel showing controller state in real-time
• NEW: External action buttons for controller methods
• NEW: Multiple controller examples with independent control
• NEW: Status tracking and error handling demonstrations

🔄 Backward Compatibility #

• 100% Backward Compatible: All existing code continues to work unchanged
• Optional Enhancement: Controller is optional - existing callback/hover icon patterns still work
• Progressive Adoption: Add controller gradually to existing implementations
• No Breaking Changes: All existing parameters and functionality preserved

🛠️ Developer Experience #

• Type Safety: Full TypeScript-like type safety with controller state
• IntelliSense: Rich IDE support for controller methods and properties
• Documentation: Comprehensive inline documentation for all new features
• Examples: Multiple usage patterns and best practices demonstrated

---

🐛 Bug Fixes #

• Fixed Clipboard Copying Issue: Resolved critical bug where clipboard copying failed with "DataError: Failed to read or decode ClipboardItemData for type image/png"
  • Root Cause: Complex JavaScript object manipulation wasn't reliable across browsers
  • Solution: Implemented simplified JavaScript approach using direct script injection
  • New Method: Created _simpleClipboardCopy() with cleaner function definition in global scope
  • Better Error Handling: Added proper cleanup and graceful fallback to alternative methods
  • Multi-Method Fallback: Now tries 3 different approaches if one fails

🔧 Technical Changes #

• Simplified Clipboard API: More reliable ClipboardItem creation using direct JavaScript functions
• Enhanced Fallback System: Canvas-based approach as secondary method, legacy fallback as tertiary
• Improved Error Logging: Better debugging information to identify which copy method succeeds
• Resource Management: Proper cleanup of created script elements to prevent memory leaks

🧪 Validation #

• ✅ Copy icon click now successfully copies images to clipboard
• ✅ Ctrl+V pasting works correctly in external applications
• ✅ Multiple fallback methods ensure compatibility across different browsers
• ✅ Proper error messages and graceful degradation when clipboard access is restricted

---

🚀 New Major Features #

Image Data Callback System

• NEW: onImageLoaded callback provides immediate access to image data when loading completes
• NEW: ImageDataInfo class contains image bytes, dimensions, and URL for copy/download operations
• Feature: No waiting required - image data available instantly after load for clipboard/download functionality

Hover Icons with Smart Positioning

• NEW: downloadIcon and copyIcon parameters for custom action icons that appear on hover
• NEW: 6 positioning options via HoverIconPosition enum:
  • topLeft, topRight, bottomLeft, bottomRight, topCenter, bottomCenter
• NEW: 3 layout modes via HoverIconLayout enum:
  • auto - Smart layout based on position
  • row - Always horizontal arrangement
  • column - Always vertical arrangement
• NEW: Customizable spacing (hoverIconSpacing) and padding (hoverIconPadding)
• NEW: enableHoverIcons toggle for full control

Advanced Clipboard & Download System

• NEW: Separate downloadImage() and copyImageToClipboard() methods with distinct behaviors:
  • Download: Saves PNG file to computer (web: Downloads folder, mobile: temp directory)
  • Copy: Copies image to system clipboard for pasting with Ctrl+V
• NEW: Cross-platform clipboard support using modern Clipboard API on web
• NEW: Custom action callbacks: onDownloadTap and onCopyTap for overriding default behaviors

Enhanced User Experience

• NEW: Smart hover detection with smooth icon transitions (web/desktop only)
• NEW: Material design click feedback with InkWell integration
• NEW: Comprehensive example app showcasing all features with live controls
• NEW: Real-time customization via control panel (position, layout, spacing, padding)

🎨 Usage Examples #

Basic Hover Icons

CustomNetworkImage(
  url: 'https://example.com/image.jpg',
  
  // ✅ NEW: Hover icons for quick actions
  downloadIcon: Icon(Icons.download, color: Colors.white, size: 20),
  copyIcon: Icon(Icons.copy, color: Colors.white, size: 20),
  hoverIconPosition: HoverIconPosition.topRight,
  
  // ✅ NEW: Get image data when loaded
  onImageLoaded: (ImageDataInfo imageData) {
    print('Image ready! Size: ${imageData.width}x${imageData.height}');
    // imageData.imageBytes contains raw PNG data for copying/saving
  },
)

Advanced Styled Icons

CustomNetworkImage(
  url: imageUrl,
  downloadIcon: Container(
    decoration: BoxDecoration(
      gradient: LinearGradient(colors: [Colors.blue, Colors.blueAccent]),
      borderRadius: BorderRadius.circular(8),
      boxShadow: [BoxShadow(color: Colors.black26, blurRadius: 4)],
    ),
    padding: EdgeInsets.symmetric(horizontal: 12, vertical: 8),
    child: Row(
      mainAxisSize: MainAxisSize.min,
      children: [
        Icon(Icons.download, color: Colors.white, size: 16),
        SizedBox(width: 4),
        Text('Download', style: TextStyle(color: Colors.white)),
      ],
    ),
  ),
  hoverIconPosition: HoverIconPosition.bottomRight,
  hoverIconLayout: HoverIconLayout.row,
  
  // ✅ Custom action callbacks
  onDownloadTap: () => customDownloadHandler(),
  onCopyTap: () => customCopyHandler(),
)

Using Image Data for Copy Operations

ImageDataInfo? _imageData;

CustomNetworkImage(
  url: imageUrl,
  onImageLoaded: (imageData) {
    setState(() => _imageData = imageData);
  },
)

// Later, copy to clipboard
ElevatedButton(
  onPressed: () async {
    if (_imageData != null) {
      final success = await ImageClipboardHelper.copyImageToClipboard(_imageData!);
      // Image is now in clipboard, ready for Ctrl+V pasting!
    }
  },
  child: Text('Copy Image'),
)

🛠️ Technical Implementation #

New Classes & Enums

// Image data container
class ImageDataInfo {
  final Uint8List imageBytes;  // Raw PNG data
  final int width, height;     // Dimensions
  final String url;           // Original URL
}

// Icon positioning
enum HoverIconPosition {
  topLeft, topRight, bottomLeft, bottomRight, topCenter, bottomCenter
}

// Layout direction
enum HoverIconLayout {
  auto, row, column
}

New Helper Methods

// Clipboard & Download
ImageClipboardHelper.copyImageToClipboard(imageData)  // Clipboard copy
ImageClipboardHelper.downloadImage(imageData)         // File download

// Platform-specific implementations
copyImageToClipboardWeb(imageData)  // Web Clipboard API
downloadImageWeb(imageData)          // Web file download

🔧 Platform Support #

• Web: Full clipboard copying + file downloads using modern Clipboard API and blob downloads
• Mobile: Temp file saving + basic clipboard support (extensible with plugins)
• Desktop: File path copying + temp file saving

📱 Responsive Design #

• Hover icons: Auto-enabled on web/desktop, disabled on mobile (no hover support)
• Touch support: Icons work with touch on platforms that support hover simulation
• Adaptive layouts: Smart icon positioning based on screen real estate

🧪 Comprehensive Testing #

• Interactive example app with live controls for all parameters
• Position examples grid showing all 6 positions
• Layout comparison demonstrating row vs column vs auto layouts
• Real-time customization via sliders and toggles

🔄 Backward Compatibility #

• 100% backward compatible - existing code continues to work unchanged
• Optional features - all new parameters have sensible defaults
• Progressive enhancement - add hover icons gradually to existing implementations

---

🐛 Bug Fixes #

• Alternative to Buggy Flutter loadingBuilder: Implemented custom loading state management to replace Flutter's problematic loadingBuilder
  • Replaced loadingBuilder parameter with customLoadingBuilder that uses CustomImageProgress
  • Added reliable progress tracking via ImageStream and ImageStreamListener
  • Fixed memory leaks and inconsistent progress reporting issues
  • Added proper resource cleanup with _cleanupImageStream() method

🚀 New Features #

• Custom Loading Progress Tracking: New CustomImageProgress class provides reliable loading progress information
• Enhanced Loading State Management: Added ImageLoadingState enum for better loading state control
• Improved Resource Management: Automatic cleanup of image streams and listeners to prevent memory leaks

🔄 Migration Guide #

// OLD (buggy Flutter loadingBuilder)
CustomNetworkImage(
  url: imageUrl,
  loadingBuilder: (context, child, loadingProgress) {
    if (loadingProgress == null) return child;
    return CircularProgressIndicator(
      value: loadingProgress.cumulativeBytesLoaded / 
             loadingProgress.expectedTotalBytes!,
    );
  },
)

// NEW (reliable customLoadingBuilder)
CustomNetworkImage(
  url: imageUrl,
  customLoadingBuilder: (context, child, progress) {
    if (progress == null) return child;
    return Column(
      mainAxisSize: MainAxisSize.min,
      children: [
        CircularProgressIndicator(value: progress.progress),
        if (progress.progress != null)
          Text('${(progress.progress! * 100).toInt()}%'),
      ],
    );
  },
)

🛠️ Technical Changes #

• Manual image loading progress tracking via onChunk callback
• Proper state management for loading, loaded, and failed states
• Enhanced error handling integration with existing fallback mechanisms
• Backward compatibility maintained for existing error handling features

🚀 New Features #

• Widget-based Error Handling: Introduced new widget parameters for more flexible error UI customization:
  • errorWidget - Custom widget to show when image fails to load
  • reloadWidget - Custom widget for retry functionality
  • openUrlWidget - Custom widget for opening image URL in new tab
• Flutter-based Error UI: HTML errors now callback to Flutter for consistent error handling across platforms
• Enhanced Error Flow: When HTML image loading fails, errors are now handled in Flutter using the new widget parameters

⚠️ Breaking Changes #

• HTML Error Handling: HTML errors no longer show HTML-based error UI. Instead, they trigger Flutter callbacks for consistent widget-based error handling.
• Deprecated Parameters: The following string-based parameters are now deprecated and will be removed in v1.0.0:
  • errorText → Use errorWidget instead
  • reloadText → Use reloadWidget instead
  • openUrlText → Use openUrlWidget instead

🔄 Migration Guide #

// OLD (deprecated but still works)
CustomNetworkImage(
  url: imageUrl,
  errorText: 'Image failed to load',
  reloadText: 'Reload Image',
  openUrlText: 'Open in New Tab',
)

// NEW (recommended)
CustomNetworkImage(
  url: imageUrl,
  errorWidget: Row(
    mainAxisSize: MainAxisSize.min,
    children: [
      Icon(Icons.error, color: Colors.red),
      SizedBox(width: 8),
      Text('Image failed to load'),
    ],
  ),
  reloadWidget: Row(
    mainAxisSize: MainAxisSize.min,
    children: [
      Icon(Icons.refresh),
      SizedBox(width: 8),
      Text('Reload Image'),
    ],
  ),
  openUrlWidget: Row(
    mainAxisSize: MainAxisSize.min,
    children: [
      Icon(Icons.open_in_new),
      SizedBox(width: 8),
      Text('Open in New Tab'),
    ],
  ),
)

🛠️ Technical Changes #

• Added HTML error callback mechanism for Flutter integration
• Removed HTML-based error UI generation from web_image_loader.dart
• Enhanced CustomNetworkImage state management for error handling
• Improved backward compatibility with automatic fallback from deprecated parameters

📚 Documentation #

• Updated examples to demonstrate new widget-based error handling
• Added migration guide in example app
• Updated README with v0.2.0 usage patterns

• Fixed: Resolved issue where error placeholder was not being displayed correctly
• Fixed: Resolved issue where error placeholder was not being displayed correctly

• Fixed: Resolved issue where error placeholder was not being displayed correctly
• Fixed: Resolved issue where error placeholder was not being displayed correctly

• Added: Internationalization support for error handling - supports custom text for error messages and buttons
• Enhanced: Error placeholder now includes reload and "open in new tab" functionality when HTML image loading fails
• Added: errorText, reloadText, and openUrlText parameters to CustomNetworkImage for multilingual support
• Improved: Error UI can show only icons when no text is provided (icon-only mode for universal understanding)
• Added: Reload button to retry failed images without page refresh
• Added: "Open in new tab" button to view the problematic image URL directly

• Fixed: Resolved tap event conflicts in ListViews with mixed HTML fallback and normal images
• Update README.md

• Fixed: Resolved tap event conflicts in ListViews with mixed HTML fallback and normal images
• Added: Per-image tap callback tracking to prevent event confusion
• Added: uniqueId parameter to CustomNetworkImage for better control in lists
• Improved: Event propagation handling with stopPropagation() to isolate tap events
• Added: Proper cleanup of resources when widgets are disposed

• Fixed: Dramatically improved smoothness of panning/dragging in InteractiveViewer with HTML fallback images
• Added: Animation controller for continuous transformation updates during gestures
• Improved: Full matrix transformation for more accurate CSS transforms
• Fixed: Pointer events handling for smoother gesture recognition

• Fixed: InteractiveViewer zoom functionality now works with HTML fallback images
• Added: TransformationController support for CustomNetworkImage
• Improved: Object-fit set to 'contain' for better zooming behavior
• Fixed: Proper transformation handling for HTML elements

• Fixed: GestureDetector tap events now work correctly with problematic images using HTML fallback
• Added: onTap callback property to CustomNetworkImage for easier tap handling
• Improved: Visual feedback with cursor pointer on HTML fallback images

• Updated intl dependency to support a wider range of versions (>=0.19.0 <0.21.0)
• Improved compatibility with projects that depend on intl 0.19.0

• Initial release with image loading solution:
  • CustomNetworkImage: Uses HTML img tag as fallback
• Support for all standard Image.network parameters
• Full web platform support for problematic images
• Example app showing how to use the approach