|
| 1 | +# ZyroxCSS v2.1.1 - Bug Fixes & Enhancement Release |
| 2 | + |
| 3 | +**Release Date**: March 7, 2026 |
| 4 | +**Status**: Stable & Production Ready |
| 5 | +**Type**: Patch Release |
| 6 | + |
| 7 | +--- |
| 8 | + |
| 9 | +## 🐛 Bug Fixes |
| 10 | + |
| 11 | +### JavaScript Components |
| 12 | +- **Memory Leak Fix**: Fixed carousel infinite loop memory leak by properly managing and clearing autoplay intervals |
| 13 | +- **Modal Scroll Lock**: Improved body scroll locking with proper padding compensation for scrollbar width |
| 14 | +- **Dropdown Detection**: Enhanced outside click detection for more reliable dropdown closing |
| 15 | +- **Modal Backdrop**: Fixed backdrop click detection to prevent closing when clicking on modal content |
| 16 | +- **Tooltip Management**: Improved tooltip visibility toggling with centralized hide function |
| 17 | + |
| 18 | +### Accessibility Improvements |
| 19 | +- Added proper ARIA attributes to interactive elements |
| 20 | +- Improved focus management for keyboard navigation |
| 21 | +- Better focus visibility on carousel indicators and controls |
| 22 | +- Enhanced screen reader announcements for toast notifications |
| 23 | + |
| 24 | +--- |
| 25 | + |
| 26 | +## ✨ New Features |
| 27 | + |
| 28 | +### JavaScript Enhancements |
| 29 | + |
| 30 | +#### Carousel Improvements |
| 31 | +- **Carousel Indicators**: Fully functional carousel indicators/pagination system |
| 32 | +- **Touch/Swipe Support**: Added swipe gesture support for mobile devices |
| 33 | +- **Indicator Linking**: Click carousel indicators to jump to specific slides |
| 34 | +- **Autoplay Control**: Carousel pauses on hover and resumes on mouse leave |
| 35 | +- **Custom Events**: Carousel emits `carousel:change` event on slide transitions |
| 36 | + |
| 37 | +#### Dropdown Enhancements |
| 38 | +- **Keyboard Navigation**: Arrow keys (Up/Down) to navigate dropdown items |
| 39 | +- **Enter/Space Support**: Press Enter or Space to select dropdown items |
| 40 | +- **Focus Management**: Auto-focus first item when dropdown opens |
| 41 | +- **State Management**: Better active dropdown tracking |
| 42 | + |
| 43 | +#### Tab Improvements |
| 44 | +- **Keyboard Navigation**: Use Arrow keys (Up/Down/Left/Right) to switch between tabs |
| 45 | +- **Smooth Scrolling**: Tab content smoothly scrolls into view when activated |
| 46 | +- **Custom Events**: Tabs emit `tabs:change` event on tab switching |
| 47 | + |
| 48 | +#### Modal Enhancements |
| 49 | +- **Scroll Position Restoration**: Remembers and restores scroll position when modal closes |
| 50 | +- **Custom Events**: Modal emits `modal:open` and `modal:close` events |
| 51 | +- **Focus Trapping**: Better focus management within modals |
| 52 | + |
| 53 | +#### Toast Improvements |
| 54 | +- **ARIA Attributes**: Proper accessibility attributes for toast notifications |
| 55 | +- **Custom Events**: Emit `toast:open` and `toast:close` events |
| 56 | +- **Faster Animations**: Improved animation timing for better UX |
| 57 | + |
| 58 | +#### Alert Enhancements |
| 59 | +- **Smooth Dismissal**: Enhanced alert close animation with slide-out effect |
| 60 | +- **Custom Events**: Emit `alert:close` event on dismissal |
| 61 | + |
| 62 | +### API Improvements |
| 63 | +```javascript |
| 64 | +// Instance is now available globally |
| 65 | +window.zyroxCSS // Access the initialized ZyroxCSS instance |
| 66 | + |
| 67 | +// New destroy method for cleanup |
| 68 | +zyroxCSS.destroy() |
| 69 | + |
| 70 | +// Close all dropdowns programmatically |
| 71 | +zyroxCSS.closeAllDropdowns() |
| 72 | + |
| 73 | +// Hide all tooltips programmatically |
| 74 | +zyroxCSS.hideAllTooltips() |
| 75 | +``` |
| 76 | + |
| 77 | +--- |
| 78 | + |
| 79 | +## 🎨 UI/Visual Improvements |
| 80 | + |
| 81 | +### Modal Styling |
| 82 | +- Enhanced backdrop blur effect (2px blur filter) |
| 83 | +- Improved animation timing with cubic-bezier curves |
| 84 | +- Better shadow system for depth perception |
| 85 | + |
| 86 | +### Dropdown Styling |
| 87 | +- Smoother transition animations (200ms) |
| 88 | +- Improved focus visible states with outline styling |
| 89 | +- Enhanced hover effects with smoother padding transitions |
| 90 | + |
| 91 | +### Carousel Controls |
| 92 | +- Better button states and transitions |
| 93 | +- Improved indicator styling with active state transformation |
| 94 | +- Enhanced indicator width change on active states (8px → 28px with border-radius) |
| 95 | + |
| 96 | +### General Improvements |
| 97 | +- Consistent transition timing across all components |
| 98 | +- Better visual feedback for all interactive elements |
| 99 | +- Enhanced focus states for keyboard navigation |
| 100 | + |
| 101 | +--- |
| 102 | + |
| 103 | +## 🔧 Technical Improvements |
| 104 | + |
| 105 | +### State Management |
| 106 | +- Introduced proper component state tracking |
| 107 | +- Better memory management with interval cleanup |
| 108 | +- Added instance variables for managing active elements |
| 109 | + |
| 110 | +### Event System |
| 111 | +- Custom events emitted for component interactions |
| 112 | +- Better event delegation and handling |
| 113 | +- Improved event listener cleanup |
| 114 | + |
| 115 | +### Performance |
| 116 | +- Reduced redraws and reflows in carousel operations |
| 117 | +- Optimized dropdown state management |
| 118 | +- Better use of CSS transitions instead of JS animations |
| 119 | + |
| 120 | +--- |
| 121 | + |
| 122 | +## 📝 Documentation Updates |
| 123 | + |
| 124 | +- Updated API documentation with new keyboard navigation features |
| 125 | +- Added custom events reference |
| 126 | +- Enhanced component examples with keyboard interactions |
| 127 | + |
| 128 | +--- |
| 129 | + |
| 130 | +## 🔄 Migration Guide |
| 131 | + |
| 132 | +**No breaking changes from v2.1.0**. All improvements are backward compatible. |
| 133 | + |
| 134 | +### Recommended Updates |
| 135 | +1. Test keyboard navigation in your applications (now supported in dropdowns and tabs) |
| 136 | +2. Consider using new custom events for better integration |
| 137 | +3. Test touch/swipe functionality on mobile devices with carousels |
| 138 | + |
| 139 | +--- |
| 140 | + |
| 141 | +## 📊 Changes Summary |
| 142 | + |
| 143 | +- **Files Changed**: 4 (zyroxcss.js, _modal.scss, _dropdown.scss, _carousel.scss) |
| 144 | +- **Bug Fixes**: 7 |
| 145 | +- **New Features**: 12+ |
| 146 | +- **Performance**: 3 improvements |
| 147 | +- **Accessibility**: 6 enhancements |
| 148 | + |
| 149 | +--- |
| 150 | + |
| 151 | +## 🙏 Notes |
| 152 | + |
| 153 | +This patch release focuses on improving robustness, accessibility, and user experience. All components now have better keyboard support, improved state management, and enhanced animations. |
0 commit comments