🛠 Bug fixes & Quality Improvements #

• 🐛 Fixed layout overflow in nested submenus when used inside constrained parents (e.g., Row/Column) by improving parent-data checks and enforcing proper Flexible placement.
• 🧩 Resolved animation stutter caused by simultaneous childController / menuController conflicts — added improved sequencing and cancellation logic.
• ✅ Guarded navigation pops with extra mounted checks to prevent exceptions when widget tree is being disposed.
• 🔒 Stabilized internal state updates to avoid duplicate callbacks on fast successive taps.

✨ New Features #

• 🔀 New parameter: menuAlignment
  • Adds flexible control over menu alignment and opening direction (e.g., left, right, center, start, end).
  • Works with screen-edge detection to flip direction automatically when needed.
  • Example: ContextMenuAndroid(menuAlignment: MenuAlignment.right) to force right alignment.

🚀 UX & Animation #

• 🎞 Improved close animation timing to better match opening velocity (smoother reverse transitions).
• ↔️ Enhanced submenu slide transitions to better respect menuAlignment and RTL layouts.
• ✨ Slightly increased backdrop blur radius with adaptive opacity for clearer readability in bright/dark backgrounds.

🧭 API & Developer Experience #

• 🎯 Updated minimum Dart SDK requirement to ^3.10.1 for improved performance, language features, and compatibility.

• 🧰 Added MenuAlignment enum to public API with clear docs and examples.

• 🧾 Updated example app showing menuAlignment usage and RTL support example.

• 🧪 Added additional unit tests around submenu stack restoration and alignment flipping.

🧹 Code Maintenance #

• 🔁 Refactored getResponsiveSize() to centralize min/max clamps for consistent behavior across versions.
• 🧼 Removed deprecated internal helpers and improved doc comments (Arabic + English).
• 📦 Minor dependency bumps and lint fixes.

🚀 Major Improvements #

🧩 Animation & Performance Enhancements

• ⚙️ Optimized animation lifecycle — old AnimationController instances are now properly disposed to prevent memory leaks.
• 🕒 Adjusted animation duration dynamically (min(600, 80 * length)) for smoother scaling on long action lists.
• 🔁 Added reverse closing animation when dismissing the menu for a more natural experience.
• 🧠 Improved animation sequencing between childController and menuController for iOS-like smooth transitions.

🧭 Submenu UX Improvements

• ➕ Added visual arrow indicator (chevron_right) for items that contain submenus.
• 🔙 Enhanced back-navigation with animated slide transitions and proper stack restoration.

🎨 UI / Layout Refinements

• 🪟 Added SafeArea to protect against notch and gesture areas.
• 🧱 Wrapped long menus in SingleChildScrollView with Flexible to prevent overflow on small devices.
• 💡 Improved background blur with a subtle dark overlay (Colors.black.withOpacity(0.15)) for better contrast.
• ⚖️ Refined menu width and padding using responsive scaling.

🧮 Responsive Design Enhancements

• 📏 Improved getResponsiveSize() — now clamps width between 320.0 and 600.0 for better tablet support.
• 📱 Ensures consistent sizing across all devices, maintaining proportional text and padding.

🧰 Codebase Cleanup & Reliability

• ✅ Added defensive checks for mounted state before popping navigation.
• 🧼 Refactored logic to make the widget production-stable for large projects.
• 📄 Preserved all inline documentation and bilingual comments for clarity.

🆕 Features #

🍔 SubMenu Support

• ✅ Added support for nested subMenu items in context menu.
• 📱 Submenus open with iOS-style sliding animation.
• 🔙 Includes automatic "Back" button and navigation stack handling.
• 🎯 Fully animated using AnimatedSwitcher with slide transitions.
• 📦 Seamless integration with existing ContextMenuAndroid actions.

🎯 Enhancements #

📏 Responsive Sizing Added

• ✅ New textSize and iconSize properties allow for per-device scaling.
• ✅ Sizes are automatically adjusted using getResponsiveSize() to match screen width for consistent appearance across devices.

🧠 Smarter Style Composition

• ✨ Introduced getTextStyle() helper to merge user-defined textStyle with fallback logic and responsive sizing.
• ✨ Introduced getIconColor() for consistent icon coloring logic (including automatic detection of delete actions).

🧾 Internal Improvements

• 💬 Added inline documentation and bilingual comments (Arabic + English) for better clarity and future maintenance.
• 📦 Padding is now responsive by default using getResponsiveSize() (e.g., horizontal padding 16 → getResponsiveSize(16)).

✅ Fixes & Improvements #

• 🧼 API Refactor: iOSStyleContextMenu is now a stateless functional widget for cleaner syntax.
• 🔁 Smooth Transitions: Replaced StatefulWidget with AnimatedScale for animation.
• ⚙️ Action Builder Optimization: Utilized List.generate() to streamline context menu actions.
• 🎨 Customization Enhancements:
  • backgroundColor
  • dividerColor
  • iconColor
  • textStyle
  • contentPadding
• 🗑 Smart Delete Detection: Automatically highlights delete actions with red, bold text.
• 🧪 Testing: Added unit tests using flutter_test.
• 📚 Documentation: Improved inline comments and updated the example app to reflect new features.

🎉 Initial release of ContextMenuAndroid — an iOS-style context menu for Android built using Flutter.

✨ Features #

• iOS-style blurred context menu.
• Customizable actions with icons, labels, and colors.
• Smart delete detection.
• Dark mode support.
• Smooth and responsive UI animations.
• Easily embeddable in any widget.

🛠 Technical Improvements #

• ✅ Enabled full null safety.
• ✅ Optimized with const constructors for performance.
• ✅ Enforced strong linter rules via analysis_options.yaml.
• ✅ Refactored code for readability and reusability.
• ✅ Included preview image hosted on GitHub for pub.flutter-io.cn display.

• 🧪 First draft release of ContextMenuAndroid package.
• 🎨 Basic iOS-style blurred context menu implementation.
• 🧩 Supports customizable icons, labels, and actions.
• 🎬 Initial animation, shadow, and structure setup.