toastify-pro 1.4.0 → 1.6.0

package/dist/toastify-pro.esm.js

@@ -9,17 +9,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
  */
@@ -35,6 +39,12 @@ class ToastifyPro {
    * @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
@@ -49,7 +59,16 @@ class ToastifyPro {
       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'];
@@ -82,6 +101,46 @@ class ToastifyPro {
 
     // 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);
+            }
+          }
+        });
+      }
+    });
   }
 
   /**
@@ -476,6 +535,7 @@ class ToastifyPro {
       transition: all 0.2s ease;
       flex-shrink: 0;
       width: 32px;
+      border: none;
       height: 32px;
       display: flex;
       align-items: center;
@@ -707,6 +767,9 @@ class ToastifyPro {
     }
 
     .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);
@@ -745,17 +808,20 @@ class ToastifyPro {
     
     .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 {
@@ -793,6 +859,169 @@ class ToastifyPro {
         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) {
@@ -809,6 +1038,9 @@ class ToastifyPro {
    * @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
@@ -838,10 +1070,30 @@ class ToastifyPro {
     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`);
@@ -850,6 +1102,7 @@ class ToastifyPro {
       // 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);
 
@@ -871,20 +1124,50 @@ class ToastifyPro {
         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(() => {
@@ -896,16 +1179,90 @@ class ToastifyPro {
         }
       }, 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
@@ -918,6 +1275,16 @@ class ToastifyPro {
     }
 
     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
@@ -960,6 +1327,33 @@ class ToastifyPro {
       }
     }
   }
+  
+  /**
+   * 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
@@ -1034,6 +1428,220 @@ class ToastifyPro {
     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
@@ -1161,6 +1769,34 @@ class ToastifyPro {
     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
@@ -1190,6 +1826,7 @@ class ToastifyPro {
     const closeConfirmation = () => {
       if (toastElement && toastElement.parentNode) {
         globalActiveConfirmation = null;
+        removeOverlay(); // Remove the overlay when closing
         this.removeToast(toastElement);
       }
     };
@@ -1277,6 +1914,9 @@ class ToastifyPro {
     };
 
     try {
+      // Create overlay first
+      createOverlay();
+      
       // Create confirmation toast element
       const toast = document.createElement("div");
       toast.className = `toastify-pro confirmation ${confirmOptions.theme}`;
@@ -1306,9 +1946,10 @@ class ToastifyPro {
       }
 
       // 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) {
@@ -1324,6 +1965,7 @@ class ToastifyPro {
       // 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;
@@ -1344,8 +1986,9 @@ class ToastifyPro {
       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) {
@@ -1363,6 +2006,7 @@ class ToastifyPro {
       // 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) {
@@ -1384,18 +2028,25 @@ class ToastifyPro {
       // 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);
@@ -1446,6 +2097,53 @@ class ToastifyPro {
         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");
@@ -1453,6 +2151,11 @@ class ToastifyPro {
         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