@rakeyshgidwani/roger-ui-bank-theme-jeremy 0.5.3

package/dist/themes/screen-reader.esm.js

@@ -0,0 +1,544 @@
+// Screen reader optimization utilities
+export class ScreenReaderOptimizer {
+    constructor() {
+        this.liveRegions = new Map();
+        this.announcementQueue = [];
+        this.isProcessingQueue = false;
+        this.initializeLiveRegions();
+    }
+    // Initialize live regions for different priorities
+    initializeLiveRegions() {
+        const priorities = Object.values(ScreenReaderOptimizer.PRIORITIES);
+        priorities.forEach(priority => {
+            const region = document.createElement('div');
+            region.setAttribute('aria-live', this.getLiveRegionType(priority));
+            region.setAttribute('aria-atomic', 'true');
+            region.setAttribute('aria-relevant', 'additions text');
+            region.style.position = 'absolute';
+            region.style.left = '-10000px';
+            region.style.width = '1px';
+            region.style.height = '1px';
+            region.style.overflow = 'hidden';
+            region.setAttribute('data-screen-reader-priority', priority);
+            document.body.appendChild(region);
+            this.liveRegions.set(priority, region);
+        });
+    }
+    // Get appropriate live region type for priority
+    getLiveRegionType(priority) {
+        switch (priority) {
+            case ScreenReaderOptimizer.PRIORITIES.URGENT:
+                return ScreenReaderOptimizer.LIVE_REGIONS.ASSERTIVE;
+            case ScreenReaderOptimizer.PRIORITIES.HIGH:
+                return ScreenReaderOptimizer.LIVE_REGIONS.ASSERTIVE;
+            case ScreenReaderOptimizer.PRIORITIES.NORMAL:
+                return ScreenReaderOptimizer.LIVE_REGIONS.POLITE;
+            case ScreenReaderOptimizer.PRIORITIES.LOW:
+                return ScreenReaderOptimizer.LIVE_REGIONS.POLITE;
+            default:
+                return ScreenReaderOptimizer.LIVE_REGIONS.POLITE;
+        }
+    }
+    // Announce message to screen readers
+    announce(message, priority = ScreenReaderOptimizer.PRIORITIES.NORMAL) {
+        if (!message || typeof message !== 'string')
+            return;
+        const timestamp = Date.now();
+        this.announcementQueue.push({ message, priority, timestamp });
+        if (!this.isProcessingQueue) {
+            this.processAnnouncementQueue();
+        }
+    }
+    // Process announcement queue
+    async processAnnouncementQueue() {
+        if (this.isProcessingQueue || this.announcementQueue.length === 0)
+            return;
+        this.isProcessingQueue = true;
+        while (this.announcementQueue.length > 0) {
+            const announcement = this.announcementQueue.shift();
+            if (!announcement)
+                continue;
+            await this.makeAnnouncement(announcement.message, announcement.priority);
+            // Small delay between announcements to prevent overlap
+            await this.delay(100);
+        }
+        this.isProcessingQueue = false;
+    }
+    // Make individual announcement
+    async makeAnnouncement(message, priority) {
+        const region = this.liveRegions.get(priority);
+        if (!region)
+            return;
+        // Clear previous content
+        region.textContent = '';
+        // Add new message
+        region.textContent = message;
+        // Force screen reader to announce
+        region.setAttribute('aria-hidden', 'true');
+        await this.delay(10);
+        region.setAttribute('aria-hidden', 'false');
+        // Clear content after announcement
+        setTimeout(() => {
+            region.textContent = '';
+        }, 1000);
+    }
+    // Utility delay function
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    // Announce page title change
+    announcePageTitle(title) {
+        this.announce(`Page title changed to: ${title}`, ScreenReaderOptimizer.PRIORITIES.HIGH);
+    }
+    // Announce navigation change
+    announceNavigation(destination) {
+        this.announce(`Navigated to: ${destination}`, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce form submission
+    announceFormSubmission(formName, success) {
+        const message = success
+            ? `Form ${formName} submitted successfully`
+            : `Form ${formName} submission failed`;
+        this.announce(message, success ? ScreenReaderOptimizer.PRIORITIES.NORMAL : ScreenReaderOptimizer.PRIORITIES.HIGH);
+    }
+    // Announce loading state
+    announceLoading(component, isLoading) {
+        const message = isLoading ? `${component} is loading` : `${component} finished loading`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.LOW);
+    }
+    // Announce error
+    announceError(error) {
+        this.announce(`Error: ${error}`, ScreenReaderOptimizer.PRIORITIES.URGENT);
+    }
+    // Announce success
+    announceSuccess(message) {
+        this.announce(`Success: ${message}`, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce warning
+    announceWarning(message) {
+        this.announce(`Warning: ${message}`, ScreenReaderOptimizer.PRIORITIES.HIGH);
+    }
+    // Announce information
+    announceInfo(message) {
+        this.announce(`Information: ${message}`, ScreenReaderOptimizer.PRIORITIES.LOW);
+    }
+    // Announce count changes
+    announceCountChange(itemType, count, total) {
+        let message = `${itemType} count: ${count}`;
+        if (total !== undefined) {
+            message += ` of ${total}`;
+        }
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.LOW);
+    }
+    // Announce selection changes
+    announceSelectionChange(itemType, selected, total) {
+        const message = `${selected} of ${total} ${itemType} selected`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce progress updates
+    announceProgress(current, total, percentage) {
+        const message = `Progress: ${current} of ${total} (${percentage}%)`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.LOW);
+    }
+    // Announce search results
+    announceSearchResults(query, count) {
+        const message = `Found ${count} results for "${query}"`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce filter changes
+    announceFilterChange(filterName, value) {
+        const message = `Filter ${filterName} changed to: ${value}`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce sort changes
+    announceSortChange(column, direction) {
+        const message = `Sorted by ${column} in ${direction} order`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce modal open/close
+    announceModalChange(modalName, isOpen) {
+        const message = isOpen ? `${modalName} modal opened` : `${modalName} modal closed`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.HIGH);
+    }
+    // Announce tab changes
+    announceTabChange(tabName) {
+        this.announce(`Switched to ${tabName} tab`, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce accordion changes
+    announceAccordionChange(sectionName, isExpanded) {
+        const message = isExpanded ? `${sectionName} section expanded` : `${sectionName} section collapsed`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce tree changes
+    announceTreeChange(nodeName, action) {
+        const message = `${nodeName} node ${action}`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce list changes
+    announceListChange(listName, action, itemName) {
+        const message = `${itemName} ${action} from ${listName} list`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce table changes
+    announceTableChange(tableName, action) {
+        const message = `${tableName} table: ${action}`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce form field changes
+    announceFormFieldChange(fieldName, value, isValid) {
+        let message = `${fieldName} field changed to: ${value}`;
+        if (!isValid) {
+            message += '. Field has validation errors';
+        }
+        this.announce(message, isValid ? ScreenReaderOptimizer.PRIORITIES.LOW : ScreenReaderOptimizer.PRIORITIES.HIGH);
+    }
+    // Announce validation errors
+    announceValidationErrors(fieldName, errors) {
+        const errorList = errors.join(', ');
+        const message = `${fieldName} validation errors: ${errorList}`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.HIGH);
+    }
+    // Announce focus changes
+    announceFocusChange(elementName, context) {
+        let message = `Focused on: ${elementName}`;
+        if (context) {
+            message += ` in ${context}`;
+        }
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.LOW);
+    }
+    // Announce keyboard shortcuts
+    announceKeyboardShortcut(action, shortcut) {
+        const message = `${action}: ${shortcut}`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.LOW);
+    }
+    // Announce time-sensitive information
+    announceTimeSensitive(message, urgency) {
+        const priority = urgency === 'high' ? ScreenReaderOptimizer.PRIORITIES.URGENT :
+            urgency === 'medium' ? ScreenReaderOptimizer.PRIORITIES.HIGH :
+                ScreenReaderOptimizer.PRIORITIES.NORMAL;
+        this.announce(message, priority);
+    }
+    // Announce status changes
+    announceStatusChange(component, oldStatus, newStatus) {
+        const message = `${component} status changed from ${oldStatus} to ${newStatus}`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce data updates
+    announceDataUpdate(dataType, action) {
+        const message = `${dataType} ${action}`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce connection status
+    announceConnectionStatus(isConnected) {
+        const message = isConnected ? 'Connection restored' : 'Connection lost';
+        this.announce(message, isConnected ? ScreenReaderOptimizer.PRIORITIES.NORMAL : ScreenReaderOptimizer.PRIORITIES.URGENT);
+    }
+    // Announce accessibility features
+    announceAccessibilityFeature(feature, enabled) {
+        const message = `${feature} accessibility feature ${enabled ? 'enabled' : 'disabled'}`;
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.LOW);
+    }
+    // Announce theme changes
+    announceThemeChange(themeName) {
+        this.announce(`Theme changed to: ${themeName}`, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce language changes
+    announceLanguageChange(language) {
+        this.announce(`Language changed to: ${language}`, ScreenReaderOptimizer.PRIORITIES.HIGH);
+    }
+    // Announce font size changes
+    announceFontSizeChange(size) {
+        this.announce(`Font size changed to: ${size}`, ScreenReaderOptimizer.PRIORITIES.LOW);
+    }
+    // Announce contrast changes
+    announceContrastChange(isHighContrast) {
+        const message = isHighContrast ? 'High contrast mode enabled' : 'High contrast mode disabled';
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.NORMAL);
+    }
+    // Announce motion changes
+    announceMotionChange(isReducedMotion) {
+        const message = isReducedMotion ? 'Reduced motion enabled' : 'Reduced motion disabled';
+        this.announce(message, ScreenReaderOptimizer.PRIORITIES.LOW);
+    }
+    // Get announcement queue status
+    getQueueStatus() {
+        return {
+            length: this.announcementQueue.length,
+            isProcessing: this.isProcessingQueue
+        };
+    }
+    // Clear announcement queue
+    clearQueue() {
+        this.announcementQueue = [];
+    }
+    // Destroy live regions
+    destroy() {
+        this.liveRegions.forEach(region => {
+            if (region.parentNode) {
+                region.parentNode.removeChild(region);
+            }
+        });
+        this.liveRegions.clear();
+        this.clearQueue();
+    }
+}
+// Live region types for dynamic content
+ScreenReaderOptimizer.LIVE_REGIONS = {
+    POLITE: 'polite',
+    ASSERTIVE: 'assertive',
+    OFF: 'off'
+};
+// Announcement priorities
+ScreenReaderOptimizer.PRIORITIES = {
+    LOW: 'low',
+    NORMAL: 'normal',
+    HIGH: 'high',
+    URGENT: 'urgent'
+};
+// Screen reader navigation utilities
+export class ScreenReaderNavigation {
+    // Create skip link for main content
+    static createSkipLink(targetId, text = 'Skip to main content') {
+        const skipLink = document.createElement('a');
+        skipLink.href = `#${targetId}`;
+        skipLink.textContent = text;
+        skipLink.className = 'sr-only sr-only-focusable';
+        skipLink.style.cssText = `
+      position: absolute;
+      top: -40px;
+      left: 6px;
+      z-index: 1000;
+      padding: 8px 16px;
+      background: #000;
+      color: #fff;
+      text-decoration: none;
+      border-radius: 4px;
+      font-size: 14px;
+      line-height: 1.2;
+    `;
+        skipLink.addEventListener('focus', () => {
+            skipLink.style.top = '6px';
+        });
+        skipLink.addEventListener('blur', () => {
+            skipLink.style.top = '-40px';
+        });
+        return skipLink;
+    }
+    // Create landmark navigation
+    static createLandmarkNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Landmark navigation');
+        nav.className = 'sr-only';
+        const landmarks = [
+            { role: 'banner', label: 'Header' },
+            { role: 'main', label: 'Main content' },
+            { role: 'complementary', label: 'Sidebar' },
+            { role: 'contentinfo', label: 'Footer' }
+        ];
+        landmarks.forEach(landmark => {
+            const link = document.createElement('a');
+            link.href = `[role="${landmark.role}"]`;
+            link.textContent = `Skip to ${landmark.label}`;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create heading navigation
+    static createHeadingNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Heading navigation');
+        nav.className = 'sr-only';
+        const headings = document.querySelectorAll('h1, h2, h3, h4, h5, h6');
+        headings.forEach((heading, index) => {
+            const link = document.createElement('a');
+            link.href = `#${heading.id || `heading-${index}`}`;
+            link.textContent = `${heading.tagName.toLowerCase()} ${heading.textContent}`;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create form navigation
+    static createFormNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Form navigation');
+        nav.className = 'sr-only';
+        const forms = document.querySelectorAll('form');
+        forms.forEach((form, index) => {
+            const link = document.createElement('a');
+            link.href = `#${form.id || `form-${index}`}`;
+            link.textContent = `Form ${index + 1}`;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create table navigation
+    static createTableNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Table navigation');
+        nav.className = 'sr-only';
+        const tables = document.querySelectorAll('table');
+        tables.forEach((table, index) => {
+            const link = document.createElement('a');
+            link.href = `#${table.id || `table-${index}`}`;
+            link.textContent = `Table ${index + 1}`;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create list navigation
+    static createListNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'List navigation');
+        nav.className = 'sr-only';
+        const lists = document.querySelectorAll('ul, ol');
+        lists.forEach((list, index) => {
+            const link = document.createElement('a');
+            link.href = `#${list.id || `list-${index}`}`;
+            link.textContent = `${list.tagName.toLowerCase()} with ${list.children.length} items`;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create link navigation
+    static createLinkNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Link navigation');
+        nav.className = 'sr-only';
+        const links = document.querySelectorAll('a[href]:not([href="#"])');
+        links.forEach((link, index) => {
+            const navLink = document.createElement('a');
+            navLink.href = link.href;
+            navLink.textContent = link.textContent || `Link ${index + 1}`;
+            navLink.className = 'sr-only-focusable';
+            nav.appendChild(navLink);
+        });
+        return nav;
+    }
+    // Create button navigation
+    static createButtonNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Button navigation');
+        nav.className = 'sr-only';
+        const buttons = document.querySelectorAll('button, [role="button"]');
+        buttons.forEach((button, index) => {
+            const link = document.createElement('a');
+            link.href = `#${button.id || `button-${index}`}`;
+            link.textContent = button.textContent || `Button ${index + 1}`;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create input navigation
+    static createInputNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Input navigation');
+        nav.className = 'sr-only';
+        const inputs = document.querySelectorAll('input, textarea, select');
+        inputs.forEach((input, index) => {
+            const link = document.createElement('a');
+            link.href = `#${input.id || `input-${index}`}`;
+            const label = input.getAttribute('aria-label') ||
+                input.getAttribute('placeholder') ||
+                input.getAttribute('name') ||
+                `Input ${index + 1}`;
+            link.textContent = label;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create image navigation
+    static createImageNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Image navigation');
+        nav.className = 'sr-only';
+        const images = document.querySelectorAll('img');
+        images.forEach((img, index) => {
+            const link = document.createElement('a');
+            link.href = `#${img.id || `image-${index}`}`;
+            const alt = img.alt || `Image ${index + 1}`;
+            link.textContent = alt;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create media navigation
+    static createMediaNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Media navigation');
+        nav.className = 'sr-only';
+        const media = document.querySelectorAll('video, audio');
+        media.forEach((element, index) => {
+            const link = document.createElement('a');
+            link.href = `#${element.id || `${element.tagName.toLowerCase()}-${index}`}`;
+            link.textContent = `${element.tagName} ${index + 1}`;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create section navigation
+    static createSectionNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Section navigation');
+        nav.className = 'sr-only';
+        const sections = document.querySelectorAll('section, article, aside');
+        sections.forEach((section, index) => {
+            const link = document.createElement('a');
+            link.href = `#${section.id || `${section.tagName.toLowerCase()}-${index}`}`;
+            const title = section.getAttribute('aria-label') ||
+                section.querySelector('h1, h2, h3, h4, h5, h6')?.textContent ||
+                `${section.tagName} ${index + 1}`;
+            link.textContent = title;
+            link.className = 'sr-only-focusable';
+            nav.appendChild(link);
+        });
+        return nav;
+    }
+    // Create comprehensive navigation
+    static createComprehensiveNavigation() {
+        const nav = document.createElement('div');
+        nav.setAttribute('role', 'navigation');
+        nav.setAttribute('aria-label', 'Comprehensive navigation');
+        nav.className = 'sr-only';
+        // Add all navigation types
+        nav.appendChild(ScreenReaderNavigation.createLandmarkNavigation());
+        nav.appendChild(ScreenReaderNavigation.createHeadingNavigation());
+        nav.appendChild(ScreenReaderNavigation.createFormNavigation());
+        nav.appendChild(ScreenReaderNavigation.createTableNavigation());
+        nav.appendChild(ScreenReaderNavigation.createListNavigation());
+        nav.appendChild(ScreenReaderNavigation.createLinkNavigation());
+        nav.appendChild(ScreenReaderNavigation.createButtonNavigation());
+        nav.appendChild(ScreenReaderNavigation.createInputNavigation());
+        nav.appendChild(ScreenReaderNavigation.createImageNavigation());
+        nav.appendChild(ScreenReaderNavigation.createMediaNavigation());
+        nav.appendChild(ScreenReaderNavigation.createSectionNavigation());
+        return nav;
+    }
+}
+// Export default instances
+export const screenReaderOptimizer = new ScreenReaderOptimizer();
+// Export default
+export default {
+    ScreenReaderOptimizer,
+    ScreenReaderNavigation,
+    screenReaderOptimizer
+};