toastify-pro 1.4.0 → 1.6.0

package/dist/toastify-pro.umd.js

@@ -14,17 +14,21 @@
    * - Position-aware car swipe exit animations  
    * - Description support for enhanced messaging
    * - Six theme variants (success, error, info, warning, dark, light)
+   * - Custom color toasts with gradient support (custom method)
    * - Progress bar with shimmer effects
    * - Responsive design for mobile devices
    * - Framework agnostic (works with React, Vue, Angular, etc.)
    * - Confirmation dialogs with customizable buttons and callbacks
+   * - Confirmation overlay with blur effect for focus
    * - Center position support for enhanced focus
    * - Independent positioning for confirmations
-   * - Loading states for async operations
-   * - Custom gradient colors with primaryColor/secondaryColor
-   * - Single instance mode with shake animation
+   * - Action buttons in toasts with customizable callbacks
+   * - Pause on hover functionality
+   * - Queue management (maxToasts, newestOnTop)
+   * - Full accessibility support (ARIA, keyboard navigation, reduced motion)
+   * - Focus management for confirmation dialogs
    * 
-   * @version 1.4.0
+   * @version 1.6.0
    * @author ToastifyPro Team
    * @license MIT
    */
@@ -40,6 +44,12 @@
      * @param {number} options.timeout - Auto-dismiss timeout in milliseconds (0 to disable)
      * @param {boolean} options.allowClose - Whether to show close button
      * @param {number} options.maxLength - Maximum message length
+     * @param {string} options.primaryColor - Primary color for custom() method
+     * @param {string} options.secondaryColor - Secondary color for gradient in custom() method
+     * @param {boolean} options.pauseOnHover - Pause timeout when hovering over toast (default: true)
+     * @param {number} options.maxToasts - Maximum number of visible toasts (0 for unlimited)
+     * @param {boolean} options.newestOnTop - Show newest toasts on top (default: true)
+     * @param {boolean} options.ariaLive - ARIA live region setting: 'polite' or 'assertive' (default: 'polite')
      */
     constructor(options = {}) {
       // Validate options parameter
@@ -54,7 +64,16 @@
         timeout: options.timeout || 3000,
         allowClose: options.allowClose !== false, // default true
         maxLength: options.maxLength || 100,
+        primaryColor: options.primaryColor || null, // Custom primary color for custom() method
+        secondaryColor: options.secondaryColor || null, // Custom secondary color for gradient
+        pauseOnHover: options.pauseOnHover !== false, // default true - pause timeout on hover
+        maxToasts: options.maxToasts || 0, // 0 = unlimited
+        newestOnTop: options.newestOnTop !== false, // default true
+        ariaLive: options.ariaLive || 'polite', // 'polite' or 'assertive'
       };
+      
+      // Track active toasts for queue management
+      this.activeToasts = [];
 
       // Validate position
       const validPositions = ['top-left', 'top-right', 'bottom-left', 'bottom-right', 'top-center', 'bottom-center', 'center'];
@@ -87,6 +106,46 @@
 
       // Inject styles once
       this.injectStyles();
+      
+      // Setup global keyboard event listener for accessibility
+      this.setupKeyboardNavigation();
+    }
+    
+    /**
+     * Sets up keyboard navigation for accessibility
+     * - Escape key dismisses the most recent toast or confirmation
+     * - Tab key cycles through focusable elements in confirmations
+     */
+    setupKeyboardNavigation() {
+      // Only setup once globally
+      if (window._toastifyProKeyboardSetup) return;
+      window._toastifyProKeyboardSetup = true;
+      
+      document.addEventListener('keydown', (e) => {
+        // Escape key - dismiss toast or confirmation
+        if (e.key === 'Escape') {
+          // First check for active confirmation
+          if (globalActiveConfirmation && globalActiveConfirmation.element) {
+            const loadingBtn = globalActiveConfirmation.element.querySelector('.toast-btn-confirm.loading');
+            if (!loadingBtn) {
+              globalActiveConfirmation.close();
+            }
+            return;
+          }
+          
+          // Otherwise dismiss the most recent toast
+          const containers = document.querySelectorAll('.toastify-pro-container');
+          containers.forEach(container => {
+            const toasts = container.querySelectorAll('.toastify-pro:not(.confirmation)');
+            if (toasts.length > 0) {
+              const lastToast = toasts[toasts.length - 1];
+              if (lastToast && lastToast._toastInstance) {
+                lastToast._toastInstance.removeToast(lastToast);
+              }
+            }
+          });
+        }
+      });
     }
 
     /**
@@ -481,6 +540,7 @@
       transition: all 0.2s ease;
       flex-shrink: 0;
       width: 32px;
+      border: none;
       height: 32px;
       display: flex;
       align-items: center;
@@ -712,6 +772,9 @@
     }
 
     .toast-btn-confirm {
+      display: flex;
+      align-items: center;
+      justify-content: center;
       color: white;
       font-weight: 700;
       border: 2px solid rgba(255, 255, 255, 0.4);
@@ -750,17 +813,20 @@
     
     .toast-btn-confirm .btn-spinner {
       display: none;
-      width: 16px;
-      height: 16px;
-      border: 2px solid rgba(255, 255, 255, 0.3);
-      border-top-color: white;
-      border-radius: 50%;
-      animation: spin 0.6s linear infinite;
-      margin-right: 8px;
+      align-items: center;
+      justify-content: center;
+      margin-left: 8px;
+    }
+    
+    .toast-btn-confirm .btn-spinner svg {
+      width: 25px;
+      height: 25px;
+      animation: spin 1s linear infinite;
+      color: currentColor;
     }
     
     .toast-btn-confirm.loading .btn-spinner {
-      display: inline-block;
+      display: inline-flex;
     }
     
     .toast-btn-confirm.loading .btn-text {
@@ -798,6 +864,169 @@
         max-width: calc(100vw - 32px);
       }
     }
+    
+    /* Custom toast type */
+    .toastify-pro.custom {
+      border-color: rgba(255, 255, 255, 0.2);
+    }
+    
+    .toastify-pro.custom.light-text {
+      color: #1e293b;
+    }
+    
+    .toastify-pro.custom.light-text .toast-icon {
+      background: rgba(15, 23, 42, 0.1);
+    }
+    
+    .toastify-pro.custom.light-text .close-btn {
+      background: rgba(15, 23, 42, 0.08);
+    }
+    
+    .toastify-pro.custom.light-text .close-btn:hover {
+      background: rgba(15, 23, 42, 0.15);
+    }
+    
+    .toastify-pro.custom.light-text::before {
+      background: linear-gradient(90deg, 
+        rgba(30, 41, 59, 0.8) 0%,
+        rgba(30, 41, 59, 0.4) 50%,
+        rgba(30, 41, 59, 0.8) 100%);
+    }
+    
+    .toastify-pro.custom.light-text::after {
+      background: rgba(30, 41, 59, 0.6);
+    }
+    
+    /* Confirmation Overlay */
+    .toastify-pro-overlay {
+      position: fixed;
+      top: 0;
+      left: 0;
+      right: 0;
+      bottom: 0;
+      background: rgba(0, 0, 0, 0.5);
+      backdrop-filter: blur(8px);
+      -webkit-backdrop-filter: blur(8px);
+      z-index: 9998;
+      opacity: 0;
+      transition: opacity 0.3s ease;
+      pointer-events: auto;
+    }
+    
+    .toastify-pro-overlay.show {
+      opacity: 1;
+    }
+    
+    /* Action Button Styles */
+    .toastify-pro .toast-action {
+      display: inline-flex;
+      align-items: center;
+      gap: 6px;
+      padding: 6px 12px;
+      margin-top: 8px;
+      border: none;
+      border-radius: 8px;
+      font-weight: 600;
+      font-size: 13px;
+      cursor: pointer;
+      transition: all 0.2s ease;
+      background: rgba(255, 255, 255, 0.2);
+      color: inherit;
+      backdrop-filter: blur(10px);
+    }
+    
+    .toastify-pro .toast-action:hover {
+      background: rgba(255, 255, 255, 0.3);
+      transform: translateY(-1px);
+    }
+    
+    .toastify-pro .toast-action:active {
+      transform: translateY(0);
+    }
+    
+    .toastify-pro.light .toast-action {
+      background: rgba(15, 23, 42, 0.1);
+    }
+    
+    .toastify-pro.light .toast-action:hover {
+      background: rgba(15, 23, 42, 0.15);
+    }
+    
+    /* Paused state - pause progress bar */
+    .toastify-pro.paused::after {
+      animation-play-state: paused;
+    }
+    
+    /* Focus styles for accessibility */
+    .toastify-pro .close-btn:focus,
+    .toastify-pro .toast-action:focus,
+    .toast-btn:focus {
+      outline: 1px solid rgba(255, 255, 255, 0.8);
+    }
+    
+    .toastify-pro.light .close-btn:focus,
+    .toastify-pro.light .toast-action:focus {
+      outline-color: 1px solid rgba(15, 23, 42, 0.5);
+    }
+    
+    /* Screen reader only class */
+    .sr-only {
+      position: absolute;
+      width: 1px;
+      height: 1px;
+      padding: 0;
+      margin: -1px;
+      overflow: hidden;
+      clip: rect(0, 0, 0, 0);
+      white-space: nowrap;
+      border: 0;
+    }
+    
+    /* Reduced motion support */
+    @media (prefers-reduced-motion: reduce) {
+      .toastify-pro {
+        transition: opacity 0.3s ease;
+        transform: none !important;
+      }
+      
+      .toastify-pro.show {
+        animation: none !important;
+        opacity: 1;
+        transform: none !important;
+      }
+      
+      .toastify-pro .toast-icon {
+        animation: none !important;
+      }
+      
+      .toastify-pro::before {
+        animation: none !important;
+      }
+      
+      .toastify-pro::after {
+        animation: progress var(--duration, 5s) linear !important;
+      }
+      
+      .toastify-pro-overlay {
+        transition: opacity 0.2s ease;
+      }
+      
+      .toast-btn::after {
+        display: none;
+      }
+      
+      .toast-btn:hover {
+        transform: none;
+      }
+      
+      .toastify-pro.confirmation .conf-close-btn:hover {
+        transform: scale(1.05);
+      }
+      
+      .btn-spinner svg {
+        animation: spin 1.5s linear infinite !important;
+      }
+    }
   `;
         document.head.appendChild(style);
       } catch (error) {
@@ -814,6 +1043,9 @@
      * @param {number} opts.timeout - Override default timeout
      * @param {boolean} opts.allowClose - Override close button setting
      * @param {number} opts.maxLength - Override max message length
+     * @param {Object} opts.action - Action button configuration { label, onClick }
+     * @param {boolean} opts.pauseOnHover - Pause timeout on hover
+     * @param {string} opts.ariaLive - ARIA live region type ('polite' or 'assertive')
      */
     show(message, type = "dark", opts = {}) {
       // Input validation
@@ -843,10 +1075,30 @@
       const options = { ...this.defaultOptions, ...opts };
 
       try {
+        // Queue management - remove oldest toasts if limit exceeded
+        if (options.maxToasts > 0 && this.activeToasts.length >= options.maxToasts) {
+          const toastsToRemove = this.activeToasts.length - options.maxToasts + 1;
+          for (let i = 0; i < toastsToRemove; i++) {
+            const oldestToast = this.activeToasts.shift();
+            if (oldestToast && oldestToast.element) {
+              this.removeToast(oldestToast.element);
+            }
+          }
+        }
+        
         // Create toast element
         const toast = document.createElement("div");
         toast.className = `toastify-pro ${type}`;
         
+        // Store reference to this instance for keyboard navigation
+        toast._toastInstance = this;
+        
+        // ARIA accessibility attributes
+        const ariaLive = type === 'error' || type === 'warning' ? 'assertive' : (options.ariaLive || 'polite');
+        toast.setAttribute('role', type === 'error' ? 'alert' : 'status');
+        toast.setAttribute('aria-live', ariaLive);
+        toast.setAttribute('aria-atomic', 'true');
+        
         // Set duration for progress bar animation
         if (options.timeout > 0) {
           toast.style.setProperty('--duration', `${options.timeout}ms`);
@@ -855,6 +1107,7 @@
         // Create icon wrapper
         const iconWrapper = document.createElement("div");
         iconWrapper.className = "toast-icon";
+        iconWrapper.setAttribute('aria-hidden', 'true');
         iconWrapper.innerHTML = this.getIconSVG(type);
         toast.appendChild(iconWrapper);
 
@@ -876,20 +1129,50 @@
           contentWrapper.appendChild(descriptionElement);
         }
         
+        // Action button support
+        if (options.action && typeof options.action === 'object') {
+          const actionBtn = document.createElement("button");
+          actionBtn.className = "toast-action";
+          actionBtn.textContent = options.action.label || 'Action';
+          actionBtn.setAttribute('type', 'button');
+          if (typeof options.action.onClick === 'function') {
+            actionBtn.onclick = (e) => {
+              e.stopPropagation();
+              options.action.onClick({ close: () => this.removeToast(toast), event: e });
+            };
+          }
+          contentWrapper.appendChild(actionBtn);
+        }
+        
         toast.appendChild(contentWrapper);
 
         // Add close button if enabled
         if (options.allowClose) {
-          const closeBtn = document.createElement("span");
+          const closeBtn = document.createElement("button");
           closeBtn.className = "close-btn";
           closeBtn.innerHTML = "&times;";
+          closeBtn.setAttribute('type', 'button');
           closeBtn.setAttribute('aria-label', 'Close notification');
           closeBtn.onclick = () => this.removeToast(toast);
           toast.appendChild(closeBtn);
         }
 
-        // Add toast to container
-        this.container.appendChild(toast);
+        // Add toast to container (respect newestOnTop setting)
+        if (options.newestOnTop && this.container.firstChild) {
+          this.container.insertBefore(toast, this.container.firstChild);
+        } else {
+          this.container.appendChild(toast);
+        }
+        
+        // Track toast for queue management
+        const toastData = {
+          element: toast,
+          timeout: null,
+          remainingTime: options.timeout,
+          startTime: null,
+          isPaused: false
+        };
+        this.activeToasts.push(toastData);
 
         // Apple AirDrop-style entrance animation
         setTimeout(() => {
@@ -901,16 +1184,90 @@
           }
         }, 10);
 
+        // Pause on hover functionality
+        if (options.pauseOnHover && options.timeout > 0) {
+          toast.addEventListener('mouseenter', () => {
+            if (toastData.timeout) {
+              clearTimeout(toastData.timeout);
+              toastData.isPaused = true;
+              toastData.remainingTime -= (Date.now() - toastData.startTime);
+              toast.classList.add('paused');
+            }
+          });
+          
+          toast.addEventListener('mouseleave', () => {
+            if (toastData.isPaused && toastData.remainingTime > 0) {
+              toastData.isPaused = false;
+              toastData.startTime = Date.now();
+              toast.classList.remove('paused');
+              // Update CSS variable for remaining progress
+              toast.style.setProperty('--duration', `${toastData.remainingTime}ms`);
+              // Restart the progress animation
+              const afterElement = toast.querySelector('::after');
+              toast.style.animation = 'none';
+              void toast.offsetHeight; // Force reflow
+              toast.style.animation = '';
+              
+              toastData.timeout = setTimeout(() => this.removeToast(toast), toastData.remainingTime);
+            }
+          });
+        }
+
         // Auto-remove after timeout
         if (options.timeout > 0) {
-          setTimeout(() => this.removeToast(toast), options.timeout);
+          toastData.startTime = Date.now();
+          toastData.timeout = setTimeout(() => this.removeToast(toast), options.timeout);
         }
 
-        return toast; // Return element for potential future manipulation
+        // Return toast control object
+        return {
+          element: toast,
+          dismiss: () => this.removeToast(toast),
+          update: (newMessage, newOpts) => this.updateToast(toast, newMessage, newOpts)
+        };
       } catch (error) {
         console.error('ToastifyPro: Failed to create toast:', error);
       }
     }
+    
+    /**
+     * Updates an existing toast's content
+     * @param {HTMLElement} toast - Toast element to update
+     * @param {string} message - New message text
+     * @param {Object} opts - Options to update
+     */
+    updateToast(toast, message, opts = {}) {
+      if (!toast || !toast.parentNode) return;
+      
+      const messageEl = toast.querySelector('.toast-message');
+      const descEl = toast.querySelector('.toast-description');
+      
+      if (message && messageEl) {
+        messageEl.textContent = message;
+      }
+      
+      if (opts.description && descEl) {
+        descEl.textContent = opts.description;
+      } else if (opts.description) {
+        const descriptionElement = document.createElement("div");
+        descriptionElement.className = "toast-description";
+        descriptionElement.textContent = opts.description;
+        toast.querySelector('.toast-content')?.appendChild(descriptionElement);
+      }
+      
+      // Update type/style if provided
+      if (opts.type) {
+        const validTypes = ['success', 'error', 'info', 'warning', 'dark', 'light'];
+        if (validTypes.includes(opts.type)) {
+          validTypes.forEach(t => toast.classList.remove(t));
+          toast.classList.add(opts.type);
+          const iconWrapper = toast.querySelector('.toast-icon');
+          if (iconWrapper) {
+            iconWrapper.innerHTML = this.getIconSVG(opts.type);
+          }
+        }
+      }
+    }
 
     /**
      * Removes a toast with position-aware car swipe animation
@@ -923,6 +1280,16 @@
       }
 
       try {
+        // Remove from active toasts tracking
+        const toastIndex = this.activeToasts.findIndex(t => t.element === toast);
+        if (toastIndex > -1) {
+          const toastData = this.activeToasts[toastIndex];
+          if (toastData.timeout) {
+            clearTimeout(toastData.timeout);
+          }
+          this.activeToasts.splice(toastIndex, 1);
+        }
+        
         // Detect position to choose the right swipe direction
         const container = toast.parentNode;
         const position = container.className.split(' ')[1]; // get position class
@@ -965,6 +1332,33 @@
         }
       }
     }
+    
+    /**
+     * Dismisses all active toasts
+     * @param {string} type - Optional: only dismiss toasts of this type
+     */
+    dismissAll(type = null) {
+      const toastsCopy = [...this.activeToasts];
+      toastsCopy.forEach(toastData => {
+        if (toastData.element) {
+          if (type) {
+            if (toastData.element.classList.contains(type)) {
+              this.removeToast(toastData.element);
+            }
+          } else {
+            this.removeToast(toastData.element);
+          }
+        }
+      });
+    }
+    
+    /**
+     * Gets the count of active toasts
+     * @returns {number} Number of active toasts
+     */
+    getActiveCount() {
+      return this.activeToasts.length;
+    }
 
     /**
      * Shows a success toast notification
@@ -1039,6 +1433,220 @@
       this.show(msg, "light", opts);
     }
 
+    /**
+     * Shows a custom-colored toast notification with gradient support
+     * @param {string} msg - Main message
+     * @param {string|Object} opts - Description string or options object
+     * @param {string} opts.primaryColor - Primary color for the toast
+     * @param {string} opts.secondaryColor - Secondary color for gradient (optional)
+     */
+    custom(msg, opts) {
+      if (typeof opts === 'string') {
+        opts = { description: opts };
+      }
+      
+      opts = opts || {};
+      
+      // Get colors from options or use default options
+      const primaryColor = opts.primaryColor || this.defaultOptions.primaryColor;
+      const secondaryColor = opts.secondaryColor || this.defaultOptions.secondaryColor;
+      
+      // If no custom colors provided, fallback to success style
+      if (!primaryColor) {
+        return this.success(msg, opts);
+      }
+      
+      // Helper function to determine if a color is light
+      const isLightColor = (color) => {
+        if (!color) return false;
+        const hex = color.replace('#', '');
+        const r = parseInt(hex.substr(0, 2), 16);
+        const g = parseInt(hex.substr(2, 2), 16);
+        const b = parseInt(hex.substr(4, 2), 16);
+        const brightness = ((r * 299) + (g * 587) + (b * 114)) / 1000;
+        return brightness > 155;
+      };
+      
+      // Helper function to lighten or darken a color
+      const adjustColor = (color, percent) => {
+        const hex = color.replace('#', '');
+        const r = parseInt(hex.substr(0, 2), 16);
+        const g = parseInt(hex.substr(2, 2), 16);
+        const b = parseInt(hex.substr(4, 2), 16);
+        
+        const adjust = (c) => {
+          const adjusted = Math.round(c + (percent / 100) * (percent > 0 ? (255 - c) : c));
+          return Math.max(0, Math.min(255, adjusted));
+        };
+        
+        const newR = adjust(r).toString(16).padStart(2, '0');
+        const newG = adjust(g).toString(16).padStart(2, '0');
+        const newB = adjust(b).toString(16).padStart(2, '0');
+        
+        return `#${newR}${newG}${newB}`;
+      };
+      
+      // Determine gradient colors
+      let gradientStart = primaryColor;
+      let gradientEnd;
+      
+      if (secondaryColor) {
+        // Both colors provided
+        gradientEnd = secondaryColor;
+      } else {
+        // Only primary color - create gradient with lighter/darker shade
+        const isLight = isLightColor(primaryColor);
+        gradientEnd = isLight ? adjustColor(primaryColor, -25) : adjustColor(primaryColor, 25);
+      }
+      
+      // Determine text color
+      const needsLightText = isLightColor(primaryColor);
+      
+      // Create custom options
+      const customOpts = {
+        ...opts,
+        customGradient: `linear-gradient(135deg, ${gradientStart} 0%, ${gradientEnd} 100%)`,
+        customTextLight: needsLightText
+      };
+      
+      this.showCustom(msg, customOpts);
+    }
+
+    /**
+     * Internal method to show a custom-styled toast
+     * @param {string} message - Main message text
+     * @param {Object} opts - Options including customGradient and customTextLight
+     */
+    showCustom(message, opts = {}) {
+      if (typeof message !== 'string') {
+        message = String(message);
+      }
+
+      if (!message.trim()) {
+        console.warn('ToastifyPro: Empty message provided.');
+        return;
+      }
+
+      const options = { ...this.defaultOptions, ...opts };
+
+      try {
+        const toast = document.createElement("div");
+        toast.className = `toastify-pro custom${options.customTextLight ? ' light-text' : ''}`;
+        
+        // Store reference to this instance
+        toast._toastInstance = this;
+        
+        // ARIA accessibility attributes
+        toast.setAttribute('role', 'status');
+        toast.setAttribute('aria-live', options.ariaLive || 'polite');
+        toast.setAttribute('aria-atomic', 'true');
+        
+        // Apply custom gradient
+        if (options.customGradient) {
+          toast.style.background = options.customGradient;
+        }
+        
+        if (options.timeout > 0) {
+          toast.style.setProperty('--duration', `${options.timeout}ms`);
+        }
+
+        // Create icon wrapper
+        const iconWrapper = document.createElement("div");
+        iconWrapper.className = "toast-icon";
+        iconWrapper.setAttribute('aria-hidden', 'true');
+        iconWrapper.innerHTML = this.getIconSVG('success'); // Use success icon for custom
+        toast.appendChild(iconWrapper);
+
+        // Create content wrapper
+        const contentWrapper = document.createElement("div");
+        contentWrapper.className = "toast-content";
+        
+        const messageElement = document.createElement("div");
+        messageElement.className = "toast-message";
+        messageElement.textContent = message.substring(0, options.maxLength);
+        contentWrapper.appendChild(messageElement);
+        
+        if (options.description && typeof options.description === 'string') {
+          const descriptionElement = document.createElement("div");
+          descriptionElement.className = "toast-description";
+          descriptionElement.textContent = options.description.substring(0, options.maxLength * 2);
+          contentWrapper.appendChild(descriptionElement);
+        }
+        
+        toast.appendChild(contentWrapper);
+
+        if (options.allowClose) {
+          const closeBtn = document.createElement("button");
+          closeBtn.className = "close-btn";
+          closeBtn.innerHTML = "&times;";
+          closeBtn.setAttribute('type', 'button');
+          closeBtn.setAttribute('aria-label', 'Close notification');
+          closeBtn.onclick = () => this.removeToast(toast);
+          toast.appendChild(closeBtn);
+        }
+
+        // Add toast to container (respect newestOnTop setting)
+        if (options.newestOnTop && this.container.firstChild) {
+          this.container.insertBefore(toast, this.container.firstChild);
+        } else {
+          this.container.appendChild(toast);
+        }
+        
+        // Track toast for queue management
+        const toastData = {
+          element: toast,
+          timeout: null,
+          remainingTime: options.timeout,
+          startTime: null,
+          isPaused: false
+        };
+        this.activeToasts.push(toastData);
+
+        // Pause on hover functionality
+        if (options.pauseOnHover && options.timeout > 0) {
+          toast.addEventListener('mouseenter', () => {
+            if (toastData.timeout) {
+              clearTimeout(toastData.timeout);
+              toastData.isPaused = true;
+              toastData.remainingTime -= (Date.now() - toastData.startTime);
+              toast.classList.add('paused');
+            }
+          });
+          
+          toast.addEventListener('mouseleave', () => {
+            if (toastData.isPaused && toastData.remainingTime > 0) {
+              toastData.isPaused = false;
+              toastData.startTime = Date.now();
+              toast.classList.remove('paused');
+              toast.style.setProperty('--duration', `${toastData.remainingTime}ms`);
+              toastData.timeout = setTimeout(() => this.removeToast(toast), toastData.remainingTime);
+            }
+          });
+        }
+
+        setTimeout(() => {
+          toast.classList.add("show");
+          const icon = toast.querySelector('.toast-icon');
+          if (icon) {
+            icon.style.animation = 'iconBounce 0.8s cubic-bezier(0.175, 0.885, 0.32, 1.275)';
+          }
+        }, 10);
+
+        if (options.timeout > 0) {
+          toastData.startTime = Date.now();
+          toastData.timeout = setTimeout(() => this.removeToast(toast), options.timeout);
+        }
+
+        return {
+          element: toast,
+          dismiss: () => this.removeToast(toast),
+          update: (newMessage, newOpts) => this.updateToast(toast, newMessage, newOpts)
+        };
+      } catch (error) {
+        console.error('ToastifyPro: Failed to create custom toast:', error);
+      }
+    }
+
     /**
      * Shows a confirmation toast with confirm/cancel buttons
      * @param {string} message - Main confirmation question
@@ -1166,6 +1774,34 @@
       let isLoading = false;
       let useLoading = false; // Track if user wants loading behavior
       let toastElement = null; // Reference to toast element
+      let overlayElement = null; // Reference to overlay element
+      
+      // Create overlay for confirmation
+      const createOverlay = () => {
+        overlayElement = document.createElement("div");
+        overlayElement.className = "toastify-pro-overlay";
+        document.body.appendChild(overlayElement);
+        
+        // Trigger show animation
+        setTimeout(() => {
+          overlayElement.classList.add("show");
+        }, 10);
+        
+        return overlayElement;
+      };
+      
+      // Remove overlay
+      const removeOverlay = () => {
+        if (overlayElement && overlayElement.parentNode) {
+          overlayElement.classList.remove("show");
+          setTimeout(() => {
+            if (overlayElement && overlayElement.parentNode) {
+              overlayElement.remove();
+            }
+            overlayElement = null;
+          }, 300);
+        }
+      };
       
       const setLoading = (loading) => {
         useLoading = true; // User is manually controlling loading
@@ -1195,6 +1831,7 @@
       const closeConfirmation = () => {
         if (toastElement && toastElement.parentNode) {
           globalActiveConfirmation = null;
+          removeOverlay(); // Remove the overlay when closing
           this.removeToast(toastElement);
         }
       };
@@ -1282,6 +1919,9 @@
       };
 
       try {
+        // Create overlay first
+        createOverlay();
+        
         // Create confirmation toast element
         const toast = document.createElement("div");
         toast.className = `toastify-pro confirmation ${confirmOptions.theme}`;
@@ -1311,9 +1951,10 @@
         }
 
         // Create close button for confirmation
-        const closeBtn = document.createElement("span");
+        const closeBtn = document.createElement("button");
         closeBtn.className = "conf-close-btn";
         closeBtn.innerHTML = "&times;";
+        closeBtn.setAttribute('type', 'button');
         closeBtn.setAttribute('aria-label', 'Cancel confirmation');
         closeBtn.onclick = () => {
           if (!isLoading) {
@@ -1329,6 +1970,7 @@
         // Create icon wrapper
         const iconWrapper = document.createElement("div");
         iconWrapper.className = "toast-icon";
+        iconWrapper.setAttribute('aria-hidden', 'true');
         iconWrapper.innerHTML = this.getIconSVG('info'); // Default to info icon
         if (confirmOptions.primaryColor) {
           iconWrapper.style.color = textColor;
@@ -1349,8 +1991,9 @@
         contentWrapper.appendChild(messageElement);
         
         // Optional description
+        let descriptionElement = null;
         if (description) {
-          const descriptionElement = document.createElement("div");
+          descriptionElement = document.createElement("div");
           descriptionElement.className = "toast-description";
           descriptionElement.textContent = description.substring(0, this.defaultOptions.maxLength * 2);
           if (confirmOptions.primaryColor) {
@@ -1368,6 +2011,7 @@
         // Cancel button
         const cancelBtn = document.createElement("button");
         cancelBtn.className = "toast-btn toast-btn-cancel";
+        cancelBtn.setAttribute('type', 'button');
         cancelBtn.textContent = confirmOptions.cancelText;
         cancelBtn.onclick = () => {
           if (!isLoading) {
@@ -1389,18 +2033,25 @@
         // Confirm button
         const confirmBtn = document.createElement("button");
         confirmBtn.className = `toast-btn toast-btn-confirm`;
-        
-        // Create spinner element
-        const spinner = document.createElement("span");
-        spinner.className = "btn-spinner";
-        confirmBtn.appendChild(spinner);
-        
+        confirmBtn.setAttribute('type', 'button');
+
         // Create text wrapper
         const textWrapper = document.createElement("span");
         textWrapper.className = "btn-text";
         textWrapper.textContent = confirmOptions.confirmText;
         confirmBtn.appendChild(textWrapper);
         
+        // Create spinner element with custom SVG
+        const spinner = document.createElement("span");
+        spinner.className = "btn-spinner";
+        spinner.innerHTML = `
+        <svg width="25" height="25" viewBox="0 0 19 19" fill="none" xmlns="http://www.w3.org/2000/svg">
+          <path d="M9.5 2.9375V5.5625M9.5 13.4375V16.0625M2.9375 9.5H5.5625M13.4375 9.5H16.0625" stroke="currentColor" stroke-width="1.875" stroke-linecap="round" />
+          <path d="M4.86011 4.85961L6.71627 6.71577M12.2847 12.2842L14.1409 14.1404M4.86011 14.1404L6.71627 12.2842M12.2847 6.71577L14.1409 4.85961" stroke="currentColor" stroke-width="1.875" stroke-linecap="round" />
+        </svg>
+      `;
+        confirmBtn.appendChild(spinner);
+        
         confirmBtn.onclick = () => {
           if (!isLoading) {
             handleConfirmation(true);
@@ -1451,6 +2102,53 @@
           setLoading(true);
         }
 
+        // ARIA accessibility for confirmation dialog
+        toast.setAttribute('role', 'alertdialog');
+        toast.setAttribute('aria-modal', 'true');
+        toast.setAttribute('aria-labelledby', 'toast-conf-title');
+        if (description) {
+          toast.setAttribute('aria-describedby', 'toast-conf-desc');
+        }
+        messageElement.id = 'toast-conf-title';
+        if (description && descriptionElement) {
+          descriptionElement.id = 'toast-conf-desc';
+        }
+        
+        // Store previously focused element for restoration
+        const previouslyFocused = document.activeElement;
+        
+        // Focus trap for confirmation dialog
+        const focusableElements = [cancelBtn, confirmBtn, closeBtn].filter(Boolean);
+        let currentFocusIndex = 0;
+        
+        const handleTabKey = (e) => {
+          if (e.key === 'Tab' && toastElement && toastElement.parentNode) {
+            e.preventDefault();
+            if (e.shiftKey) {
+              currentFocusIndex = (currentFocusIndex - 1 + focusableElements.length) % focusableElements.length;
+            } else {
+              currentFocusIndex = (currentFocusIndex + 1) % focusableElements.length;
+            }
+            focusableElements[currentFocusIndex]?.focus();
+          }
+        };
+        
+        document.addEventListener('keydown', handleTabKey);
+        
+        // Store cleanup function
+        const originalClose = closeConfirmation;
+        const cleanupAndClose = () => {
+          document.removeEventListener('keydown', handleTabKey);
+          // Restore focus to previously focused element
+          if (previouslyFocused && typeof previouslyFocused.focus === 'function') {
+            setTimeout(() => previouslyFocused.focus(), 100);
+          }
+          originalClose();
+        };
+        
+        // Update control object with enhanced close
+        controlObject.close = cleanupAndClose;
+
         // Entrance animation
         setTimeout(() => {
           toast.classList.add("show");
@@ -1458,6 +2156,11 @@
           if (icon) {
             icon.style.animation = 'iconBounce 0.8s cubic-bezier(0.175, 0.885, 0.32, 1.275)';
           }
+          
+          // Focus the confirm button after animation
+          setTimeout(() => {
+            confirmBtn.focus();
+          }, 100);
         }, 10);
 
         // Return control object with toast element and control functions