flutter_awesome_context_menu 0.1.1

A Flutter package that provides a browser-like right-click context menu.

0.1.1

• *Fixed Build Issue

0.1.0

• Fixed Double Context Menu Issue:

  • Custom Gesture Recognizer Implementation:

    • Added RightClickGestureRecognizer that properly participates in Flutter's gesture arena
    • Created SuperRightClickDetector widget using RawGestureDetector for gesture handling
    • Resolved double menu issues in nested context menu areas
    • Fixed context menu conflicts with TextField and other interactive widgets

  • Gesture Arena Integration:

    • Custom recognizer calls resolve(GestureDisposition.accepted) to claim gesture ownership
    • Prevents TextField's built-in context menu from interfering with custom menus
    • Enables proper nesting of AwesomeContextMenuArea widgets
    • Improved gesture competition handling within Flutter's gesture system

  • Architecture Improvements:

    • Replaced event interception approaches with proper gesture recognition
    • Integrated SuperRightClickDetector into AwesomeContextMenuArea widget
    • Maintains backward compatibility while resolving gesture conflicts
    • Better separation between left-click, right-click, and long-press gesture handling

  • Stability Enhancements:

    • Increased minimum menu interval from 50ms to 100ms for improved debouncing
    • Enhanced event cleanup with proper timing and resource management
    • Added comprehensive gesture lifecycle management
    • Improved reliability across all platforms and widget combinations

  • Developer Experience:

    • No breaking changes - existing code continues to work unchanged
    • Nested context menus now work correctly without special configuration
    • Enhanced debugging with improved gesture recognition logging
    • Simplified usage - developers can nest context menus without additional considerations

0.0.9

• Major Stability and Performance Improvements:

  • Memory Leak Fixes:

    • Replaced global static overlay entries with instance-level management to prevent memory leaks
    • Added proper resource cleanup in dispose methods for all stateful widgets
    • Implemented automatic cleanup timers with proper cancellation
    • Fixed animation controller lifecycle management with race condition prevention

  • Race Condition Elimination:

    • Replaced global event flags with pointer ID-based event tracking to prevent interference between multiple context menu areas
    • Added concurrent operation prevention in AwesomeContextMenu.show() with operation-in-progress flag
    • Implemented timestamp-based event throttling to prevent duplicate event handling
    • Enhanced event cleanup with proper timing and resource management

  • Performance Optimizations:

    • Added position calculation caching for submenus to reduce computational overhead
    • Implemented more granular state management to minimize unnecessary widget rebuilds
    • Optimized LRU cache management with time-based expiration (1-hour TTL)
    • Enhanced menu item and icon caching with configurable size limits
    • Added efficient submenu lookup using hash maps instead of linear searches

  • Error Handling and Robustness:

    • Added comprehensive error handling in AwesomeLinkHandler with proper URL validation
    • Implemented graceful fallbacks for network operations and clipboard access
    • Added null safety improvements for render box operations with retry mechanisms
    • Enhanced error reporting with debugPrint for better debugging experience

  • Accessibility Enhancements:

    • Added Semantics widgets throughout the menu system for screen reader support
    • Implemented proper accessibility labels and hints for menu items and submenus
    • Added keyboard navigation improvements with focus management
    • Enhanced menu item descriptions for assistive technologies

  • Platform Detection Improvements:

    • Enhanced mobile browser detection with comprehensive user agent analysis
    • Added touch support detection as additional mobile platform indicator
    • Improved platform reporting for better debugging (e.g., "web (Android)", "web (iOS)")
    • Fixed edge cases in platform-specific behavior handling

  • Architecture Improvements:

    • Refactored global state management to use instance-based tracking
    • Improved separation of concerns between overlay management and menu rendering
    • Enhanced cache management with automatic cleanup and memory pressure handling
    • Added proper lifecycle management for all background processes and timers

• Developer Experience:

  • All changes maintain backward compatibility with existing APIs
  • Improved debugging information and error messages
  • Enhanced code documentation with implementation details
  • Better performance characteristics under heavy usage scenarios

• Testing:

  • All existing tests continue to pass
  • Enhanced test coverage for new error handling paths
  • Added stress testing scenarios for memory leak detection
  • Improved test reliability with better resource cleanup

0.0.8

• Fixed long-press context menu functionality on mobile web browsers:
  • Enhanced platform detection to recognize mobile browsers (Android Chrome, Safari on iOS, etc.)
  • Updated AwesomePlatformUtils.isMobile() to return true for mobile web browsers
  • Added user agent detection in web platform implementation
  • Implemented long-press gesture support for web applications running on mobile devices
  • Fixed missing onLongPress handler in AwesomeContextMenuArea widget
  • Added proper context menu positioning for long-press events on mobile browsers
  • Improved platform reporting to show "web (Android)" or "web (iOS)" for better debugging

0.0.7

• Enhanced test suite:

  • Added comprehensive widget tests for AwesomeContextMenuArea rendering and behavior
  • Implemented unit tests for AwesomeContextMenuItem construction and properties
  • Added tests for AwesomeLinkHandler URL validation
  • Improved test coverage for AwesomeMenuItemCache functionality and LRU behavior
  • Added tests for hierarchical menu structures and SubMenuInteractionMode
  • Implemented mouse event handler tests for hover, click, and pointer events
  • Added tests for custom styling, positioning, and builder configurations
  • Included tests for keyboard shortcuts and persistent menu items

• Documentation improvements:

  • Added detailed example project README.md
  • Updated project demo website references
  • Improved API documentation with more code examples
  • Enhanced readability of implementation docs
  • Fixed typos and formatting issues in existing documentation

0.0.6

• Fixed context menu flickering issue:
  • Resolved issue where menus would rapidly show, hide, then show again on right-click
  • Implemented timestamp-based event throttling to prevent duplicate events
  • Removed duplicate event handling by consolidating into a single event handler
  • Added delayed show/hide sequence to improve menu transition experience
  • Extended event handling timeout for better stability
  • Fixed minor documentation inconsistencies

0.0.5

• Documentation improvements:
  • Fixed README.md errors

0.0.4

• Added comprehensive project documentation:
  • Detailed project analysis in ANALYSIS.md
  • In-depth implementation details in IMPLEMENTATION.md
  • Updated README.md with AI-assisted development information
  • Fixed class name references throughout documentation for consistency
  • Ensured all code examples use correct class names with proper prefixes
  • Aligned documentation with actual implementation interfaces

0.0.3

• Web platform compatibility improvements:
  • Refactored platform detection code to avoid direct dart:io imports on web
  • Implemented conditional imports for platform-specific code
  • Added separate implementations for web and native platforms
  • Fixed pub.dev platform compatibility issues
  • Full web platform support without compromising native platform features

0.0.2

• Setup pub.dev Github Actions publishing

0.0.1

• Initial public release of Flutter Awesome Context Menu package
• Core features:
  • Right-click context menu support for desktop and web platforms
  • Long-press support for mobile platforms
  • Link handling with options like "Open in new tab" and "Copy link address"
  • Custom context menu items with icons and keyboard shortcut hints
  • Hierarchical/nested submenus with platform-adaptive interaction modes
  • Persistent menus that stay open after selection
  • Dynamic menu item generation and caching for performance
  • Comprehensive mouse event handling
  • CTRL+Click support for opening links in new tabs
  • Fully customizable menu styling and animation control
  • Proper positioning relative to viewport edges
  • Programmatic control to show/hide/update menus
• Platform support: Windows, macOS, Linux, Web, Android, and iOS
• Comprehensive example app with 20+ use cases demonstrating all features