accessibility-widgets 2.0.12 → 2.0.14

package/README.md

@@ -2,34 +2,37 @@
 
 [![npm version](https://badge.fury.io/js/accessibility-widgets.svg)](https://www.npmjs.com/package/accessibility-widgets)
 [![License: GPL](https://img.shields.io/badge/License-GPL-blue.svg)](https://opensource.org/licenses/GPL-3.0)
-[![CDN](https://img.shields.io/badge/CDN-unpkg-orange.svg)](https://unpkg.com/accessibility-widgets)
+[![](https://data.jsdelivr.com/v1/package/npm/accessibility-widgets/badge)](https://www.jsdelivr.com/package/npm/accessibility-widgets)
 
 <a href="https://github.com/sponsors/sinanisler">
 <img src="https://img.shields.io/badge/Consider_Supporting_My_Projects_❤-GitHub-d46" width="300" height="auto" />
 </a>
 <br><br>
 
-A comprehensive, zero-dependency accessibility widget that enhances web accessibility for all users. This lightweight, single-file JavaScript solution provides 14+ accessibility features to make your website instantly more inclusive and compliant with WCAG 2.1 AA, Section 508, and EN 301 549 standards.
+A comprehensive, zero-dependency accessibility widget that enhances web accessibility for all users. This lightweight, single-file JavaScript solution provides 16+ accessibility features to make your website instantly more inclusive and compliant with WCAG 2.1 AA, Section 508, and EN 301 549 standards.
 <br><br>
 
 > **Note**: This widget helps meet accessibility criteria but does not guarantee full compliance. Complete WCAG/Section 508 compliance requires proper HTML semantics, ARIA attributes, manual testing, and user validation.
 <br><br>
 
 
-<img width="1793" height="auto" alt="image" src="https://github.com/user-attachments/assets/610138f5-e60d-4297-b5e3-ea040f361209" />
 
-## Supported Language List
+## ⚡ Quick Easy Install
 
-English, Deutsch, Español, Italiano, Français, Русский, Türkçe, العربية, हिन्दी, 简体中文, 日本語, Português, বাংলা, 한국어, Tiếng Việt, Bahasa Indonesia, ไทย, Polski, Nederlands, Ελληνικά, Svenska, Norsk, Dansk, Suomi, Čeština, Magyar, Română, עברית, فارسی, اردو, ਪੰਜਾਬੀ, मराठी, తెలుగు, தமிழ், Bahasa Melayu, Filipino
+Add widget script close to the ```</body>``` - That's it!
 
+```html
 
+<script src="https://cdn.jsdelivr.net/npm/accessibility-widgets@latest/widget.js"></script>
+```
 
-## ⚡ Quick Start
 
-```html
-<!-- Include the widget - That's it! -->
-<script src="https://unpkg.com/accessibility-widgets@latest/widget.js"></script>
-```
+<img width="1793" height="auto" alt="image" src="https://github.com/user-attachments/assets/610138f5-e60d-4297-b5e3-ea040f361209" />
+
+## Supported Language List
+
+English, Deutsch, Español, Italiano, Français, Русский, Türkçe, العربية, हिन्दी, 简体中文, 日本語, Português, বাংলা, 한국어, Tiếng Việt, Bahasa Indonesia, ไทย, Polski, Nederlands, Ελληνικά, Svenska, Norsk, Dansk, Suomi, Čeština, Magyar, Română, עברית, فارسی, اردو, ਪੰਜਾਬੀ, मराठी, తెలుగు, தமிழ், Bahasa Melayu, Filipino
+
 
 Or install via NPM:
 
@@ -50,39 +53,41 @@ require('accessibility-widgets');
 - **High Contrast Mode** - 3 levels (Medium 1.3x, High 1.5x, Ultra 2.0x) for improved visibility
 - **Text Size Control** - 4 size options (Default, Medium 20px, Large 24px, X-Large 28px)
 - **Line Height Adjustment** - 3 spacing levels (2em, 3em, 4em) for better readability
-- **Text Spacing** - Enhanced letter (0.2em) and word spacing (0.3em)
+- **Text Spacing** - 3 levels (Light 0.1em/0.5em, Medium 0.15em/1em, Heavy 0.25em/2em letter/word spacing)
 - **Text Alignment** - Left, Center, or Right alignment options
-- **Bigger Cursor** - High-contrast 48x72px cursor with SVG rendering
+- **Bigger Cursor** - High-contrast ~29×44px SVG cursor for better visibility
 - **Hide Images** - Text-only mode for focused reading or bandwidth saving
+- **Saturation Control** - 3 levels (Low 0.5x, High 10x, None/grayscale) for color intensity adjustment
 
 ### 🧠 Cognitive Support
 - **Dyslexia-Friendly Font** - Comic Sans MS and other dyslexia-optimized fonts
 - **Font Selection** - Choose between Arial, Times New Roman, or Verdana
-- **Animation Control** - Pause all animations and transitions
-- **Reduced Motion** - Motion sensitivity support for vestibular disorders
+- **Animation Control** - Pause all animations, transitions, and reduced motion (bundled feature for vestibular disorders)
 
 ### ♿ Assistive Technology
 - **Screen Reader** - Built-in text-to-speech using Web Speech API
-- **Voice Control** - Hands-free navigation with 15+ voice commands
+- **Voice Control** - Hands-free navigation with 16 voice commands
 - **Color Blindness Filters** - Protanopia, Deuteranopia, Tritanopia, and Grayscale modes
 - **Keyboard Navigation** - Full Tab/Arrow key support with proper focus indicators
 
 ## 📊 Compliance & Standards
 
-### WCAG 2.1 AA Coverage
+### WCAG 2.1 AA & AAA Coverage
+
+*Note: Some criteria below are AAA-level (1.4.6, 1.4.8, 2.3.3, 2.5.5). The core widget targets AA conformance.*
 
 | Feature | WCAG Criteria | EU EN 301 549 | US Section 508 |
 |---------|---------------|---------------|----------------|
-| High Contrast Mode | ✅ 1.4.3, 1.4.6 | ✅ | ✅ |
+| High Contrast Mode | ✅ 1.4.3, 1.4.6 (AAA) | ✅ | ✅ |
 | Text Size Adjustment | ✅ 1.4.4 | ✅ | ✅ |
 | Text Spacing | ✅ 1.4.12 | ✅ | ✅ |
 | Line Height Adjustment | ✅ 1.4.12 | ✅ | ✅ |
-| Text Alignment | ✅ 1.4.8 | ✅ | ✅ |
-| Cursor Enhancement | ✅ 2.5.5 | ✅ | ✅ |
-| Pause Animations | ✅ 2.2.2, 2.3.3 | ✅ | ✅ |
-| Reduced Motion | ✅ 2.3.3 | ✅ | ✅ |
+| Text Alignment | ✅ 1.4.8 (AAA) | ✅ | ✅ |
+| Cursor Enhancement | ✅ 2.5.5 (AAA) | ✅ | ✅ |
+| Pause Animations | ✅ 2.2.2, 2.3.3 (AAA) | ✅ | ✅ |
+| Saturation Control | ✅ 1.4.1 | ✅ | ✅ |
 | Hide Images | ✅ 1.1.1 | ✅ | ✅ |
-| Dyslexia-Friendly Font | ✅ 1.4.8 | ✅ | ✅ |
+| Dyslexia-Friendly Font | ✅ 1.4.8 (AAA) | ✅ | ✅ |
 | Screen Reader | ✅ 4.1.3 | ✅ | ✅ |
 | Voice Control | ⚠️ Browser API | ⚠️ | ⚠️ |
 | Color Filters | ✅ 1.4.1 | ✅ | ✅ |
@@ -95,11 +100,9 @@ require('accessibility-widgets');
 
 ### CDN (Fastest)
 ```html
-<!-- unpkg CDN -->
-<script src="https://unpkg.com/accessibility-widgets@latest/widget.js"></script>
-
 <!-- jsdelivr CDN -->
 <script src="https://cdn.jsdelivr.net/npm/accessibility-widgets@latest/widget.js"></script>
+
 ```
 
 ### NPM
@@ -128,7 +131,7 @@ require('accessibility-widgets/widget.js');
 The widget works out of the box with zero configuration:
 
 ```html
-<script src="https://unpkg.com/accessibility-widgets@latest/widget.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/accessibility-widgets@latest/widget.js"></script>
 ```
 
 ### Custom Configuration
@@ -156,7 +159,7 @@ window.ACCESSIBILITY_WIDGET_CONFIG = {
   }
 };
 </script>
-<script src="https://unpkg.com/accessibility-widgets@latest/widget.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/accessibility-widgets@latest/widget.js"></script>
 ```
 
 ### Full Configuration Options
@@ -312,14 +315,16 @@ window.ACCESSIBILITY_WIDGET_CONFIG = {
     resetAllSettings: 'Restablecer Todo'
   },
   voiceCommands: {
-    showMenu: ['mostrar menú', 'abrir menú'],
-    highContrast: ['alto contraste'],
-    biggerText: ['texto grande', 'texto más grande'],
-    resetAll: ['reiniciar todo']
+    es: {
+      showMenu: ['mostrar menú', 'abrir menú'],
+      highContrast: ['alto contraste'],
+      biggerText: ['texto grande', 'texto más grande'],
+      resetAll: ['reiniciar todo']
+    }
   }
 };
 </script>
-<script src="https://unpkg.com/accessibility-widgets@latest/widget.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/accessibility-widgets@latest/widget.js"></script>
 ```
 
 ## 🎤 Voice Commands
@@ -337,7 +342,12 @@ When voice control is enabled (Chrome/Edge only), use these commands:
 | "dyslexia font" | Activates dyslexia-friendly font |
 | "bigger cursor" | Enlarges cursor |
 | "line height" | Adjusts line spacing |
+| "text align" | Cycles text alignment (left/center/right) |
+| "saturation" | Cycles saturation (low/high/none) |
+| "font selection" / "change font" | Cycles font family |
+| "color filter" | Cycles color blindness filters |
 | "screen reader" | Activates text-to-speech |
+| "voice command" / "voice control" | Toggles voice control on/off |
 | "reset all" | Resets all settings |
 
 *All commands are fully customizable via `voiceCommands` configuration*## 📚 Feature Details
@@ -352,13 +362,16 @@ Three contrast enhancement levels:
 Four size options (Default, Medium 20px, Large 24px, X-Large 28px) with smart widget exclusion to maintain UI consistency.
 
 ### Text Spacing
-Enhanced letter spacing (0.2em) and word spacing (0.3em) for improved readability, especially helpful for dyslexia.
+Three spacing levels for improved readability, especially helpful for dyslexia:
+- **Light**: letter-spacing 0.1em, word-spacing 0.5em
+- **Medium**: letter-spacing 0.15em, word-spacing 1em
+- **Heavy**: letter-spacing 0.25em, word-spacing 2em
 
 ### Line Height Adjustment
 Three spacing levels (2em, 3em, 4em) to reduce visual crowding and improve reading flow.
 
 ### Animation Control
-Completely disables CSS animations and transitions - critical for users with vestibular disorders or ADHD.
+Completely disables CSS animations and transitions (including `::before`/`::after` pseudo-elements). Also provides reduced motion support — critical for users with vestibular disorders or ADHD.
 
 ### Image Hiding
 Text-only mode with smart caching (5-second intervals) to catch dynamically loaded images.
@@ -367,17 +380,23 @@ Text-only mode with smart caching (5-second intervals) to catch dynamically load
 Uses Comic Sans MS and fallback fonts optimized for dyslexia (Chalkboard SE, Bradley Hand, Brush Script MT).
 
 ### Cursor Enhancement
-Custom 48x72px SVG cursor with high-contrast black fill and white stroke for better visibility.
+Custom ~29×44px SVG cursor with high-contrast black fill and white stroke for better visibility.
 
 ### Screen Reader (Text-to-Speech)
 Built-in TTS using Web Speech API - reads focused element text, alt attributes, and titles.
 
 ### Voice Control
-Hands-free operation with Web Speech Recognition API. Supports 15+ customizable commands.
+Hands-free operation with Web Speech Recognition API. Supports 16 customizable commands.
 
 ### Color Blindness Filters
 SVG-based filters for Protanopia (red-blind), Deuteranopia (green-blind), Tritanopia (blue-blind), and Grayscale modes.
 
+### Saturation Control
+Three saturation levels for color intensity adjustment:
+- **Low**: 0.5x saturation for reduced color intensity
+- **High**: 10x saturation for boosted color vibrancy
+- **None**: Full grayscale (desaturated) display
+
 ### Font Selection
 Cycle through Arial (modern sans-serif), Times New Roman (traditional serif), and Verdana (screen-optimized).
 
@@ -422,7 +441,7 @@ Cycle through Arial (modern sans-serif), Times New Roman (traditional serif), an
     <p>This site is fully accessible.</p>
     
     <!-- Add widget - automatically initializes -->
-    <script src="https://unpkg.com/accessibility-widgets@latest/widget.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/accessibility-widgets@latest/widget.js"></script>
 </body>
 </html>
 ```
@@ -454,7 +473,7 @@ Cycle through Arial (modern sans-serif), Times New Roman (traditional serif), an
       }
     };
     </script>
-    <script src="https://unpkg.com/accessibility-widgets@latest/widget.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/accessibility-widgets@latest/widget.js"></script>
 </body>
 </html>
 ```

package/package.json

@@ -1,6 +1,6 @@
 { 
   "name": "accessibility-widgets",
-  "version": "2.0.12",
+  "version": "2.0.14",
   "description": "A comprehensive, lightweight accessibility widget that enhances web accessibility for all users. Provides multiple accessibility features including screen reader support, voice control, high contrast mode, and more.",
   "main": "widget.js",
   "scripts": {

package/widget.js

@@ -1133,7 +1133,20 @@ function setLanguage(lang) {
 }
 
 function getTranslation(key) {
-  return TRANSLATIONS[currentLanguage][key] || TRANSLATIONS['en'][key] || key;
+  // Check current language translations first
+  if (TRANSLATIONS[currentLanguage] && TRANSLATIONS[currentLanguage][key]) {
+    return TRANSLATIONS[currentLanguage][key];
+  }
+  // Fallback to user-configured lang overrides
+  if (WIDGET_CONFIG.lang && WIDGET_CONFIG.lang[key]) {
+    return WIDGET_CONFIG.lang[key];
+  }
+  // Fallback to English translations
+  if (TRANSLATIONS['en'] && TRANSLATIONS['en'][key]) {
+    return TRANSLATIONS['en'][key];
+  }
+  // Last resort: return the key itself
+  return key;
 }
 
 // Initialize language from localStorage or detect from browser
@@ -2211,6 +2224,19 @@ const widgetStyles = `
     word-spacing: 2px !important;
     text-align: left;
   }
+  
+  /* Screen-reader-only utility for live announcements */
+  .snn-sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border-width: 0;
+  }
 `;
 
 // Page accessibility styles (will go in main document - these affect the page, NOT the widget)
@@ -2470,6 +2496,14 @@ function createShadowContainer() {
   styleElement.textContent = widgetStyles;
   shadowRoot.appendChild(styleElement);
 
+  // Create aria-live region for screen reader announcements
+  const liveRegion = document.createElement('div');
+  liveRegion.id = 'snn-live-region';
+  liveRegion.setAttribute('aria-live', 'polite');
+  liveRegion.setAttribute('aria-atomic', 'true');
+  liveRegion.classList.add('snn-sr-only');
+  shadowRoot.appendChild(liveRegion);
+
   return shadowRoot;
 }
 
@@ -2477,6 +2511,19 @@ function createShadowContainer() {
 // CORE UTILITY FUNCTIONS
 // ===========================================
 
+// Announce a change to screen reader users via the live region
+function announceChange(message) {
+  if (!shadowRoot) return;
+  const liveRegion = shadowRoot.getElementById('snn-live-region');
+  if (!liveRegion) return;
+  // Clear then set to ensure announcement even for repeated messages
+  liveRegion.textContent = '';
+  // Use requestAnimationFrame to ensure DOM update before setting new text
+  requestAnimationFrame(() => {
+    liveRegion.textContent = message;
+  });
+}
+
 // Cache for DOM elements to improve performance
 const domCache = {
   get body() {
@@ -2800,6 +2847,9 @@ function resetAccessibilitySettings() {
     const steps = button.querySelectorAll('.snn-option-step');
     steps.forEach(step => step.classList.remove('active'));
   });
+
+  // Announce reset to screen reader users
+  announceChange(getTranslation('resetAllSettings'));
 }
 
 // Create toggle buttons for accessibility options
@@ -2877,6 +2927,9 @@ function createToggleButton(
         targetElement.classList.remove(className);
       }
     }
+
+    // Announce change to screen reader users
+    announceChange(buttonText);
   }
 
   return button;
@@ -2916,6 +2969,7 @@ function createActionButton(buttonText, actionFunction, iconSVG, optionsConfig =
     const result = actionFunction();
     if (result) {
       updateActionButtonStatus(button, optionId, optionsConfig);
+      announceChange(buttonText + ': ' + result);
     }
   });
 
@@ -2925,6 +2979,7 @@ function createActionButton(buttonText, actionFunction, iconSVG, optionsConfig =
       const result = actionFunction();
       if (result) {
         updateActionButtonStatus(button, optionId, optionsConfig);
+        announceChange(buttonText + ': ' + result);
       }
     }
   });
@@ -3383,6 +3438,11 @@ const voiceControl = {
     }
 
     try {
+      // Abort any existing recognition instance before creating a new one
+      if (voiceControl.recognition) {
+        try { voiceControl.recognition.abort(); } catch (e) { /* ignore */ }
+        voiceControl.recognition = null;
+      }
       const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
       voiceControl.recognition = new SpeechRecognition();
       voiceControl.recognition.interimResults = false;