Release v6.0.0 - Major feature expansion with slideshows and enhanced video support

- Complete slideshow system with navigation, thumbnails, auto-advance, keyboard nav, and touch support
- Enhanced video support for HTML5 and iframe videos with responsive containers
- Interactive documentation with modals for themes, animations, sizes, and button themes
- Improved mobile/tablet support with responsive button sizing
- 379 total tests (220 unit + 159 E2E) all passing
- Comprehensive memory management and event cleanup improvements

BREAKING CHANGES:
- Media modals (images, videos, slideshows) now default to size: 'auto' instead of 'md'
- Invalid themes return 'default' instead of false
- Media modals default to noPadContent: true (no padding around content)
- New slideshow and video API structure
- See UPGRADE_GUIDE_V5_to_V6.md for migration details

Author: HTMLGuyLLC

cursorrules renamed to .cursorrules

@@ -3,10 +3,15 @@
 ## Project Overview
 jAlert is a jQuery plugin for creating modals, popups, lightboxes, and alerts. It's built with ES6+ and transpiled to ES5 for maximum browser compatibility.
 
+
+## Chat responses
+Start each of your responses with: Yes, sir.
+
 ## Build & Test Commands
-- Build: `npm run build`
+- Build: `npm run build` - only need to run this when changes are made to jAlert.js or jAlert.css
 - Test: `npm test`
 - E2E Tests: `npm run test:e2e`
+- Unit Tests: `npm run test:unit`
 - All Tests: `npm run test:all`
 
 ## Required Checks for Every Change
@@ -17,18 +22,27 @@ jAlert is a jQuery plugin for creating modals, popups, lightboxes, and alerts. I
 - Ensure all new features have proper test coverage
 
 ### 2. Documentation Requirements
-- Update index.html to maintain demos for each option
-- Document every setting and its default value
+- Update index.html to maintain documentation about features/options
+- Document every setting and its default value with the version where it was first introduced
+- Document discovered gotchas that would impact users
 - Update README.md for any development or release flow changes
 
 ### 3. Release Process
 - Rebuild the project before any release
-- Update CHANGELOG.md with new version details
-- Update README.md and index.html to reflect latest version
+- Rerun `test:all` and fix any issues
+- Add the new version to the changelog with any user-facing changes
+- Modify README.md as needed to reflect the latest - at a minimum, the npm button
+- Update index.html to reflect any changes to the options/features and the latest version content if it exists.
+- Bump the version in package.json
+- Commit
+- Push
+- Create tag
+- Create release on Github
+- NPM Publish
 
 ### 4. Compatibility & Quality
 - Maintain backwards compatibility with older versions
-- Ensure feature parity across versions
+- Ensure feature parody across versions
 
 ### 5. Accessibility & Mobile
 - Consider accessibility in all changes (ARIA attributes, keyboard navigation)
@@ -39,6 +53,9 @@ jAlert is a jQuery plugin for creating modals, popups, lightboxes, and alerts. I
 - Follow best practices and DRY principles
 - Make code extendable and extensible
 - Use consistent coding standards
+- Avoid hacks, arbitrary protections, and arbitrary values
+- Be concise and simple. Find the easiest path to a solution that will perform well
+- Optimize for performance when possible as long as the impact to maintainability isn't too high
 
 ### 7. User Experience
 - Provide all options for user control
@@ -50,15 +67,20 @@ jAlert is a jQuery plugin for creating modals, popups, lightboxes, and alerts. I
 - Main CSS: dist/jAlert.min.css
 - Source: src/jAlert.js, src/jAlert.css
 - Tests: tests/unit/, tests/e2e/, tests/visual/
+- Comprehensive demo: demo.html - used by tests
 
 ## Dependencies
 - jQuery >= 3.7.0 (peer dependency)
 - Node >= 14.0.0
 - NPM >= 6.0.0
 
 ## Browser Support
-- IE11+ (ES5 compatible)
-- Chrome 60+
-- Firefox 55+
-- Safari 12+
-- Edge 79+ 
+Minimum browser versions that should fully support this plugin:
+- Chrome: 30+
+- Firefox: 28+
+- Safari: 7+
+- Edge: 12+
+- Opera: 17+
+- Internet Explorer: 11 (with jQuery polyfills, but MutationObserver support is limited)
+Note:
+- IE10 and below are not fully supported due to missing ES5 features and MutationObserver.

CHANGELOG.md

@@ -2,6 +2,84 @@
 
 All notable changes to jAlert will be documented in this file.
 
+## [6.0.0] - 2025-07-03
+
+### 🚀 Major Release - Complete Feature Overhaul
+
+jAlert 6.0.0 represents a massive expansion with a complete slideshow system, enhanced video support, and comprehensive media handling capabilities. This release introduces significant new features while maintaining backward compatibility where possible.
+
+### ✨ New Features
+
+- **🎠 Complete Slideshow System**: Revolutionary slideshow functionality with advanced features
+  - **Image Navigation**: Next/previous arrows, dot navigation, and number counters
+  - **Video Support**: HTML5 videos and YouTube/Vimeo iframes within slideshows
+  - **Thumbnail Navigation**: Drag-scrollable thumbnails with top/bottom positioning
+  - **Auto-advance**: Configurable intervals with pause-on-hover functionality
+  - **Keyboard Navigation**: Arrow key support with proper event cleanup
+  - **Responsive Sizing**: Contain and cover modes for optimal image display
+  - **Advanced Callbacks**: `onSlideChange`, `onBeforeSlideChange`, `onSlideshowEnd`, `onSlideshowLoop`, `onContentLoad`
+  - **Loop Control**: Configurable looping with end-of-slideshow detection
+  - **Preloading**: Background image preloading for faster navigation
+  - **Touch Support**: Swipe gestures and touch-friendly controls for mobile devices
+
+- **🎥 Enhanced Video Support**: Comprehensive HTML5 video and iframe handling
+  - **HTML5 Video**: Full support for all video attributes (controls, autoplay, loop, mute, etc.)
+  - **Responsive Containers**: Proper aspect ratio handling with fallback defaults
+  - **Video Configuration**: Direct video object properties for complete video configuration
+  - **Error Handling**: Robust loading and error states with graceful fallbacks
+  - **Utility Functions**: `createHTML5Video()`, `createVideoContainer()`, `setupVideoEventHandlers()`
+  - **YouTube/Vimeo**: Enhanced iframe support with responsive containers
+
+- **🖼️ Improved Media Handling**: Enhanced image and iframe support
+  - **Auto-sizing**: Intelligent sizing for images, videos, and slideshows
+  - **Responsive Design**: Better mobile and tablet support
+  - **Error States**: Improved error handling and user feedback
+  - **Loader Positioning**: Better loading indicators and positioning
+
+### 🔧 Technical Improvements
+
+- **Performance**: Optimized slideshow rendering and video loading
+- **Memory Management**: Comprehensive event cleanup and timer management
+- **Error Handling**: Robust validation and fallback mechanisms
+- **Accessibility**: Enhanced ARIA attributes and keyboard navigation
+- **Mobile Support**: Touch-friendly controls and responsive layouts
+
+### 🐛 Bug Fixes
+
+- **Button Alias**: Fixed missing `buttons` alias for `btns` option - now both `buttons` and `btns` work identically
+  - Added proper alias handling so `buttons: [...]` gets converted to `btns: [...]` internally
+  - Updated unit tests to verify alias functionality works correctly
+- **Responsive Video**: Fixed extreme aspect ratio issues (450% padding-bottom)
+- **Event Cleanup**: Proper cleanup of slideshow timers and event handlers
+- **Theme Validation**: Invalid themes now return 'default' instead of false
+- **Size Defaults**: Media modals now default to 'auto' size for better UX
+- **Memory Leaks**: Comprehensive cleanup of MutationObserver and event listeners
+- **Button Sizing**: Enlarged buttons on all screen sizes for better touch interaction (8px 14px padding on desktop, 8px 10px on mobile)
+
+### 📚 Documentation
+
+- **Comprehensive API Documentation**: Complete slideshow and video API reference
+- **Interactive Demos**: 16 comprehensive demo sections with 200+ examples
+- **Test Coverage**: 205 unit tests, 153 E2E tests, and visual regression tests
+- **Migration Guide**: Detailed upgrade instructions for existing users
+
+### 🔄 Breaking Changes
+
+- **Default Size Behavior**: Media modals (images, videos, slideshows) now default to `size: 'auto'`
+- **Theme Validation**: Invalid themes now return `'default'` instead of `false`
+- **Slideshow API**: New slideshow system with different options structure
+- **Video API**: Direct video object properties for HTML5 video configuration
+- **Default Padding Behavior**: All modals now default to `noPadContent: true` (no padding around content)
+
+### Added
+- Video modals and slideshows now support an optional `embedType` property (`'iframe'` for YouTube/Vimeo, `'html5'` for direct video files). If not set, jAlert will auto-detect based on the video URL. If you set the wrong type, it will use what you specify.
+
+### ✨ New Features
+
+- **New Orange and Dark Orange Themes**: Added `orange` (bright, readable on light backgrounds) and `dark_orange` (deep orange, white text) themes for alerts and buttons. The `warningAlert` shortcut now uses the orange theme by default. If you want the old yellow warning, use `theme: 'yellow'`.
+
+---
+
 ## [5.0.5] - 2025-06-27
 
 ### 🛡️ Bug Fixes & Stability Improvements

README.md

@@ -1,35 +1,43 @@
 [![Join the chat at https://gitter.im/jAlert/Lobby](https://badges.gitter.im/jAlert/Lobby.svg)](https://gitter.im/jAlert/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 ![License](https://img.shields.io/badge/License-MIT-blue.svg)
 ![Build](https://img.shields.io/badge/Build-Passing-green.svg)
-[![npm](https://img.shields.io/badge/NPM-v5.0.5-blue.svg)](https://npmjs.com/package/jAlert)
+[![npm](https://img.shields.io/badge/NPM-v6.0.0-blue.svg)](https://npmjs.com/package/jAlert)
 
 # jAlert - The Ultimate jQuery Modal & Lightbox Plugin
 
-**🚀 Version 5.0.5 - Enhanced Stability!** A powerful, lightweight jQuery plugin for creating stunning modals, popups, lightboxes, and image slideshows. Perfect for modern web applications that need beautiful, accessible, and responsive dialogs.
-
 ## ✨ Why Choose jAlert?
 
 **🎯 Perfect for jQuery Sites** - If you're already using jQuery, jAlert integrates seamlessly without adding bulky dependencies. No need to learn new frameworks or rewrite existing code.
 
-**⚡ Lightning Fast** - Lightweight and optimized for performance. No bloat, just pure functionality.
+**⚡ Zero Config** - Include JS/CSS and add a modal immediately, no complicated setup.
 
 **🎨 Beautiful by Default** - 12 built-in themes with smooth animations. Your modals will look professional out of the box.
 
 **📱 Responsive Design** - Works perfectly on desktop, tablet, and mobile with touch-friendly controls and swipe gestures.
 
 **♿ Basic Accessibility** - Keyboard navigation, screen reader support, and ARIA attributes for better usability.
 
-**🔄 Backward Compatible** - Upgrading from older versions? Your existing code will work without changes.
-
 ## 🎯 When to Use jAlert
 
 - **Simple Modal Needs** - Quick alerts, confirmations, or information dialogs
-- **Image Galleries** - Lightbox slideshows with navigation controls
+- **Image & Video Galleries** - Lightbox slideshows with navigation controls
 - **Content Previews** - Show videos, iframes, or AJAX content in modals
 - **Form Dialogs** - Login forms, contact forms, or any interactive content
 - **jQuery Projects** - Perfect addition to existing jQuery-based websites
 - **Quick Prototypes** - Get beautiful modals running in minutes, not hours
 
+## Browser Compatibility
+
+Minimum browser versions that should fully support this plugin:
+- Chrome: 30+
+- Firefox: 28+
+- Safari: 7+
+- Edge: 12+
+- Opera: 17+
+- Internet Explorer: 11 (with jQuery polyfills, but MutationObserver support is limited)
+
+**Note:** IE10 and below are not fully supported due to missing ES5 features and MutationObserver.
+
 ## 🚀 Quick Start
 
 ### Installation
@@ -58,7 +66,11 @@ $.jAlert({
 // Image lightbox
 $.jAlert({
     image: 'path/to/image.jpg',
-    title: 'Beautiful Image'
+});
+
+// Video lightbox
+$.jAlert({
+    video: 'https://embed.youtube.com/my-video',
 });
 
 // Slideshow gallery
@@ -87,7 +99,7 @@ $.jAlert({
 - **AJAX** - Load dynamic content
 
 ### 🎭 **Beautiful Themes**
-12 built-in themes: `default`, `green`, `red`, `blue`, `yellow`, `brown`, `gray`, `black`, and dark variants.
+14 built-in themes: `default`, `green`, `red`, `blue`, `yellow`, `orange`, `brown`, `gray`, `black`, and dark variants (`dark_green`, `dark_red`, `dark_blue`, `dark_gray`, `dark_orange`).
 
 ### ⌨️ **Keyboard & Accessibility**
 - Full keyboard navigation (ESC, arrow keys)
@@ -114,7 +126,7 @@ $.jAlert({
 ## 🔧 Requirements
 
 - **jQuery 3.7.0+** (peer dependency)
-- **Modern browsers** (Chrome 60+, Firefox 55+, Safari 12+, Edge 79+, IE11+)
+- **Modern browsers** (see browser compatibility below)
 
 ## 🛠️ Development