adecksibility-widget 2.5.5 → 2.5.8

package/README.md

@@ -11,7 +11,7 @@ Premium standalone accessibility widget bundle for WordPress and non-WordPress s
     platform: "standalone"
   };
 </script>
-<script src="https://cdn.jsdelivr.net/npm/adecksibility-widget@2.5.5/dist/adecksibility-widget-pro.umd.js" defer></script>
+<script src="https://cdn.jsdelivr.net/npm/adecksibility-widget@2.5.8/dist/adecksibility-widget-pro.umd.js" defer></script>
 ```
 
 ## Notes

package/dist/adecksibility-widget-pro.umd.js

@@ -883,8 +883,19 @@ var DEFAULT_STORAGE_KEYS = {
     hiddenSession: 'adeck_hidden_session'
 };
 
-function buildStorageKeys(storageKeys) {
-    return Object.assign({}, DEFAULT_STORAGE_KEYS, storageKeys || {});
+function buildStorageKeys(storageKeys, storageNamespace) {
+    var resolvedKeys = Object.assign({}, DEFAULT_STORAGE_KEYS, storageKeys || {});
+    var namespace = typeof storageNamespace === 'string' ? storageNamespace.trim() : '';
+
+    if (!namespace) {
+        return resolvedKeys;
+    }
+
+    Object.keys(resolvedKeys).forEach(function (key) {
+        resolvedKeys[key] = namespace + ':' + resolvedKeys[key];
+    });
+
+    return resolvedKeys;
 }
 
 function createStorageAdapter(storageArea) {
@@ -978,6 +989,11 @@ var ALLOWED_FEATURE_CLASSES;
 var activeFeatures;
 var editionMeta;
 var featureFlags;
+var darkModeEnhancementObserver;
+var mediaObserver;
+var hideImagesObserver;
+var typographyObserver;
+var typographyObserverTimeout;
 
 function isFeatureEnabled(featureName) {
     return !featureFlags || featureFlags[featureName] !== false;
@@ -986,7 +1002,7 @@ function isFeatureEnabled(featureName) {
 function init(options) {
     options = options || {};
 
-    storageKeys = buildStorageKeys(options.storageKeys);
+    storageKeys = buildStorageKeys(options.storageKeys, options.storageNamespace);
     storage = createStorageAdapter(options.storage || global.localStorage);
     sessionStore = createStorageAdapter(options.sessionStorage || global.sessionStorage);
     i18n = options.i18n || getDefaultMessages();
@@ -1056,7 +1072,48 @@ function init(options) {
     DARK_MODE_HOVER_BG_IMAGE_ATTR = 'data-adeck-dark-hover-bg-image';
     DARK_MODE_HOVER_BG_IMAGE_PRIORITY_ATTR = 'data-adeck-dark-hover-bg-image-priority';
     HIDE_IMG_BG_CLASS = 'adeck-hide-bg-image';
-    ALLOWED_FEATURE_CLASSES = Object.keys(classMap).map(function(key) { return classMap[key]; });
+    ALLOWED_FEATURE_CLASSES = Object.keys(classMap).map(function(key) { return classMap[key]; });
+
+    function isDarkModeActive() {
+        return document.documentElement.classList.contains(DARK_MODE_CLASS);
+    }
+
+    function ensureDarkModeEnhancementObserver() {
+        if (darkModeEnhancementObserver || typeof MutationObserver === 'undefined' || !document.body) return;
+
+        darkModeEnhancementObserver = new MutationObserver(function(mutations) {
+            if (!isDarkModeActive()) return;
+
+            for (var index = 0; index < mutations.length; index++) {
+                var mutation = mutations[index];
+
+                if (mutation.type === 'childList') {
+                    mutation.addedNodes.forEach(function(node) {
+                        if (node.nodeType === 1) refreshDarkModeEnhancements(node);
+                    });
+                    continue;
+                }
+
+                if (mutation.target && mutation.target.nodeType === 1) {
+                    if (mutation.target.hasAttribute(DARK_MODE_AUTO_SURFACE_ATTR) || mutation.target.hasAttribute(DARK_MODE_AUTO_TEXT_ATTR)) continue;
+                    refreshDarkModeEnhancements(mutation.target);
+                }
+            }
+        });
+
+        darkModeEnhancementObserver.observe(document.body, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+            attributeFilter: ['class', 'style']
+        });
+    }
+
+    function disconnectDarkModeEnhancementObserver() {
+        if (!darkModeEnhancementObserver) return;
+        darkModeEnhancementObserver.disconnect();
+        darkModeEnhancementObserver = null;
+    }
     /* ============================================================
        Visual Filter Overlay
     ============================================================ */
@@ -1069,42 +1126,16 @@ function init(options) {
         var wrapperEl = document.querySelector('.adeck-wrapper');
         document.body.insertBefore(overlay, wrapperEl || null);
     }
-    injectFilterOverlay();
-    registerVisualFilterTargets();
-    window.addEventListener('load', registerVisualFilterTargets);
-    window.addEventListener('load', function() {
-        rebuildDarkModeEnhancements();
-        window.setTimeout(rebuildDarkModeEnhancements, 250);
-    });
-
-    if (typeof MutationObserver !== 'undefined') {
-        var darkModeEnhancementObserver = new MutationObserver(function(mutations) {
-            if (!document.documentElement.classList.contains(DARK_MODE_CLASS)) return;
-
-            for (var index = 0; index < mutations.length; index++) {
-                var mutation = mutations[index];
-
-                if (mutation.type === 'childList') {
-                    mutation.addedNodes.forEach(function(node) {
-                        if (node.nodeType === 1) refreshDarkModeEnhancements(node);
-                    });
-                    continue;
-                }
-
-                if (mutation.target && mutation.target.nodeType === 1) {
-                    if (mutation.target.hasAttribute(DARK_MODE_AUTO_SURFACE_ATTR) || mutation.target.hasAttribute(DARK_MODE_AUTO_TEXT_ATTR)) continue;
-                    refreshDarkModeEnhancements(mutation.target);
-                }
-            }
-        });
-
-        darkModeEnhancementObserver.observe(document.body, {
-            childList: true,
-            subtree: true,
-            attributes: true,
-            attributeFilter: ['class', 'style']
-        });
-    }
+    injectFilterOverlay();
+    registerVisualFilterTargets();
+    window.addEventListener('load', registerVisualFilterTargets);
+    window.addEventListener('load', function() {
+        if (!isDarkModeActive()) return;
+        rebuildDarkModeEnhancements();
+        window.setTimeout(function() {
+            if (isDarkModeActive()) rebuildDarkModeEnhancements();
+        }, 250);
+    });
 
     activeFeatures = [];
     try { activeFeatures = JSON.parse(storage.getItem(storageKeys.features)) || []; }
@@ -1230,55 +1261,79 @@ function init(options) {
         if (d) d.textContent = fontScale + '%';
         document.querySelectorAll(FONT_SELECTOR).forEach(function(el){ snapshotEl(el); scaleEl(el); });
     }
-    function resetFontScale() {
-        fontScale = 100;
-        var d = document.getElementById('adeck-font-val');
-        if (d) d.textContent = '100%';
-        document.querySelectorAll('[' + ORIG_ATTR + ']').forEach(function(el){
-            el.style.removeProperty('font-size'); el.removeAttribute(ORIG_ATTR);
-        });
-        document.body.style.removeProperty('font-size');
-        storage.removeItem(storageKeys.fontScale);
-    }
-    function saveAndApplyFont() {
-        if (fontScale < 70) fontScale = 70;
-        if (fontScale > 200) fontScale = 200;
-        storage.setItem(storageKeys.fontScale, fontScale);
-        applyFontScale();
-        announce(fontScale + '%');
-    }
-
-    var mediaObserver = new MutationObserver(function(mutations) {
-        if (!document.documentElement.classList.contains('adeck-mute-media')) return;
-        mutations.forEach(function(m) {
-            m.addedNodes.forEach(function(node) {
-                if (node.nodeType !== 1 || (node.closest && node.closest('.adeck-wrapper'))) return;
-                if (node.matches && node.matches('audio, video')) setMediaMutedState(node, true);
-                if (node.querySelectorAll) {
-                    node.querySelectorAll('audio, video').forEach(function(mediaEl) {
-                        setMediaMutedState(mediaEl, true);
-                    });
-                }
-            });
-        });
-    });
-    mediaObserver.observe(document.body, { childList: true, subtree: true });
-
-    var hideImagesObserver = new MutationObserver(function(mutations) {
-        if (!document.documentElement.classList.contains('adeck-hide-images')) return;
-        mutations.forEach(function(m) {
-            m.addedNodes.forEach(function(node) {
-                if (node.nodeType !== 1 || (node.closest && node.closest('.adeck-wrapper'))) return;
-                if (shouldTrackBackgroundImage(node)) node.classList.add(HIDE_IMG_BG_CLASS);
-                if (node.querySelectorAll) {
-                    node.querySelectorAll('*').forEach(function(el) {
-                        if (shouldTrackBackgroundImage(el)) el.classList.add(HIDE_IMG_BG_CLASS);
-                    });
-                }
-            });
-        });
-    });
-    hideImagesObserver.observe(document.body, { childList: true, subtree: true });
+    function resetFontScale() {
+        fontScale = 100;
+        var d = document.getElementById('adeck-font-val');
+        if (d) d.textContent = '100%';
+        document.querySelectorAll('[' + ORIG_ATTR + ']').forEach(function(el){
+            el.style.removeProperty('font-size'); el.removeAttribute(ORIG_ATTR);
+        });
+        document.body.style.removeProperty('font-size');
+        storage.removeItem(storageKeys.fontScale);
+        syncRuntimeObservers();
+    }
+    function saveAndApplyFont() {
+        if (fontScale < 70) fontScale = 70;
+        if (fontScale > 200) fontScale = 200;
+        storage.setItem(storageKeys.fontScale, fontScale);
+        applyFontScale();
+        syncRuntimeObservers();
+        announce(fontScale + '%');
+    }
+
+    function ensureMediaObserver() {
+        if (mediaObserver || typeof MutationObserver === 'undefined' || !document.body) return;
+
+        mediaObserver = new MutationObserver(function(mutations) {
+            if (!document.documentElement.classList.contains('adeck-mute-media')) return;
+            mutations.forEach(function(m) {
+                m.addedNodes.forEach(function(node) {
+                    if (node.nodeType !== 1 || (node.closest && node.closest('.adeck-wrapper'))) return;
+                    if (node.matches && node.matches('audio, video')) setMediaMutedState(node, true);
+                    if (node.querySelectorAll) {
+                        node.querySelectorAll('audio, video').forEach(function(mediaEl) {
+                            setMediaMutedState(mediaEl, true);
+                        });
+                    }
+                });
+            });
+        });
+
+        mediaObserver.observe(document.body, { childList: true, subtree: true });
+    }
+
+    function disconnectMediaObserver() {
+        if (!mediaObserver) return;
+        mediaObserver.disconnect();
+        mediaObserver = null;
+    }
+
+    function ensureHideImagesObserver() {
+        if (hideImagesObserver || typeof MutationObserver === 'undefined' || !document.body) return;
+
+        hideImagesObserver = new MutationObserver(function(mutations) {
+            if (!document.documentElement.classList.contains('adeck-hide-images')) return;
+            mutations.forEach(function(m) {
+                m.addedNodes.forEach(function(node) {
+                    if (node.nodeType !== 1 || (node.closest && node.closest('.adeck-wrapper'))) return;
+                    if (shouldTrackBackgroundImage(node)) node.classList.add(HIDE_IMG_BG_CLASS);
+                    if (node.querySelectorAll) {
+                        node.querySelectorAll('*').forEach(function(el) {
+                            if (shouldTrackBackgroundImage(el)) el.classList.add(HIDE_IMG_BG_CLASS);
+                        });
+                    }
+                });
+            });
+        });
+
+        hideImagesObserver.observe(document.body, { childList: true, subtree: true });
+    }
+
+    function disconnectHideImagesObserver() {
+        if (!hideImagesObserver) return;
+        hideImagesObserver.disconnect();
+        hideImagesObserver = null;
+    }
 
     /* ============================================================
        LINE HEIGHT & TEXT SPACING SLIDER
@@ -1306,15 +1361,16 @@ function init(options) {
         if (d) d.textContent = lhScale + '%';
         document.querySelectorAll(LH_SELECTOR).forEach(function(el){ snapshotLhEl(el); scaleLhEl(el); });
     }
-    function resetLineHeight() {
-        lhScale = 100;
-        var d = document.getElementById('adeck-lh-val');
-        if (d) d.textContent = '100%';
-        document.querySelectorAll('[' + LH_ORIG_ATTR + ']').forEach(function(el){
-            el.style.removeProperty('line-height'); el.removeAttribute(LH_ORIG_ATTR);
-        });
-        storage.removeItem(storageKeys.lineHeight);
-    }
+    function resetLineHeight() {
+        lhScale = 100;
+        var d = document.getElementById('adeck-lh-val');
+        if (d) d.textContent = '100%';
+        document.querySelectorAll('[' + LH_ORIG_ATTR + ']').forEach(function(el){
+            el.style.removeProperty('line-height'); el.removeAttribute(LH_ORIG_ATTR);
+        });
+        storage.removeItem(storageKeys.lineHeight);
+        syncRuntimeObservers();
+    }
 
     var TS_LS_ATTR = 'data-adeck-orig-ls', TS_WS_ATTR = 'data-adeck-orig-ws';
     var TS_STEP = 10, TS_MIN = 100, TS_MAX = 200;
@@ -1344,23 +1400,24 @@ function init(options) {
         if (d) d.textContent = tsScale + '%';
         document.querySelectorAll(TS_SELECTOR).forEach(function(el){ snapshotTsEl(el); scaleTsEl(el); });
     }
-    function resetTextSpacing() {
-        tsScale = 100;
-        var d = document.getElementById('adeck-ts-val');
-        if (d) d.textContent = '100%';
-        document.querySelectorAll('[' + TS_LS_ATTR + ']').forEach(function(el){
-            el.style.removeProperty('letter-spacing'); el.style.removeProperty('word-spacing');
-            el.removeAttribute(TS_LS_ATTR); el.removeAttribute(TS_WS_ATTR);
-        });
-        storage.removeItem(storageKeys.textSpacing);
-    }
+    function resetTextSpacing() {
+        tsScale = 100;
+        var d = document.getElementById('adeck-ts-val');
+        if (d) d.textContent = '100%';
+        document.querySelectorAll('[' + TS_LS_ATTR + ']').forEach(function(el){
+            el.style.removeProperty('letter-spacing'); el.style.removeProperty('word-spacing');
+            el.removeAttribute(TS_LS_ATTR); el.removeAttribute(TS_WS_ATTR);
+        });
+        storage.removeItem(storageKeys.textSpacing);
+        syncRuntimeObservers();
+    }
 
     function hasActiveTypographyAdjustments() {
         return fontScale !== 100 || lhScale !== 100 || tsScale !== 100;
     }
 
-    function applyTypographyToSubtree(root) {
-        if (!root || root.nodeType !== 1 || (root.closest && root.closest('.adeck-wrapper'))) return;
+    function applyTypographyToSubtree(root) {
+        if (!root || root.nodeType !== 1 || (root.closest && root.closest('.adeck-wrapper'))) return;
 
         if (fontScale !== 100) {
             if (root.matches && root.matches(FONT_SELECTOR)) { snapshotEl(root); scaleEl(root); }
@@ -1372,26 +1429,51 @@ function init(options) {
             if (root.querySelectorAll) root.querySelectorAll(LH_SELECTOR).forEach(function(el){ snapshotLhEl(el); scaleLhEl(el); });
         }
 
-        if (tsScale !== 100) {
-            if (root.matches && root.matches(TS_SELECTOR)) { snapshotTsEl(root); scaleTsEl(root); }
-            if (root.querySelectorAll) root.querySelectorAll(TS_SELECTOR).forEach(function(el){ snapshotTsEl(el); scaleTsEl(el); });
-        }
-    }
-
-    var typographyObserverTimeout;
-    var typographyObserver = new MutationObserver(function(mutations) {
-        if (!hasActiveTypographyAdjustments()) return;
-        clearTimeout(typographyObserverTimeout);
-        typographyObserverTimeout = setTimeout(function() {
-            mutations.forEach(function(m) {
-                m.addedNodes.forEach(function(node) {
-                    applyTypographyToSubtree(node);
-                });
-            });
-        }, 250);
-    });
-    typographyObserver.observe(document.body, { childList: true, subtree: true });
-
+        if (tsScale !== 100) {
+            if (root.matches && root.matches(TS_SELECTOR)) { snapshotTsEl(root); scaleTsEl(root); }
+            if (root.querySelectorAll) root.querySelectorAll(TS_SELECTOR).forEach(function(el){ snapshotTsEl(el); scaleTsEl(el); });
+        }
+    }
+
+    function ensureTypographyObserver() {
+        if (typographyObserver || typeof MutationObserver === 'undefined' || !document.body) return;
+
+        typographyObserver = new MutationObserver(function(mutations) {
+            if (!hasActiveTypographyAdjustments()) return;
+            clearTimeout(typographyObserverTimeout);
+            typographyObserverTimeout = setTimeout(function() {
+                mutations.forEach(function(m) {
+                    m.addedNodes.forEach(function(node) {
+                        applyTypographyToSubtree(node);
+                    });
+                });
+            }, 250);
+        });
+
+        typographyObserver.observe(document.body, { childList: true, subtree: true });
+    }
+
+    function disconnectTypographyObserver() {
+        if (!typographyObserver) return;
+        typographyObserver.disconnect();
+        typographyObserver = null;
+        clearTimeout(typographyObserverTimeout);
+    }
+
+    function syncRuntimeObservers() {
+        if (isDarkModeActive()) ensureDarkModeEnhancementObserver();
+        else disconnectDarkModeEnhancementObserver();
+
+        if (document.documentElement.classList.contains('adeck-mute-media')) ensureMediaObserver();
+        else disconnectMediaObserver();
+
+        if (document.documentElement.classList.contains('adeck-hide-images')) ensureHideImagesObserver();
+        else disconnectHideImagesObserver();
+
+        if (hasActiveTypographyAdjustments()) ensureTypographyObserver();
+        else disconnectTypographyObserver();
+    }
+
     /* ============================================================
        Utilities and Reset State
     ============================================================ */
@@ -1504,13 +1586,14 @@ function init(options) {
         });
     }
 
-    function clearPersistedFeatureState() {
-        activeFeatures.forEach(function(cls){ document.documentElement.classList.remove(cls); });
-        activeFeatures = [];
-        storage.removeItem(storageKeys.features);
-        setDarkModeState(false, { clearTheme: true, skipTransition: true });
-        clearActiveFeatureButtons();
-    }
+    function clearPersistedFeatureState() {
+        activeFeatures.forEach(function(cls){ document.documentElement.classList.remove(cls); });
+        activeFeatures = [];
+        storage.removeItem(storageKeys.features);
+        setDarkModeState(false, { clearTheme: true, skipTransition: true });
+        clearActiveFeatureButtons();
+        syncRuntimeObservers();
+    }
 
     function resetFeatureAdjustments() {
         resetFontScale();
@@ -1592,11 +1675,12 @@ function init(options) {
         if (preset.fontScale !== null) { fontScale = preset.fontScale; storage.setItem(storageKeys.fontScale, fontScale); applyFontScale(); }
         if (isFeatureEnabled('lineHeight') && preset.lhScale !== null) { lhScale = preset.lhScale; storage.setItem(storageKeys.lineHeight, lhScale); applyLineHeight(); }
         if (isFeatureEnabled('textSpacing') && preset.tsScale !== null) { tsScale = preset.tsScale; storage.setItem(storageKeys.textSpacing, tsScale); applyTextSpacing(); }
-
-        saveActiveFeatures();
-        syncHideImagesState();
-        updateDynamicLabels();
-    }
+
+        saveActiveFeatures();
+        syncRuntimeObservers();
+        syncHideImagesState();
+        updateDynamicLabels();
+    }
 
     function setActiveProfile(profileKey) {
         activeProfile = profileKey;
@@ -1719,30 +1803,34 @@ function init(options) {
         if (!isTicking) { window.requestAnimationFrame(function(){ updateGuide(e.touches[0].clientY); isTicking=false; }); isTicking=true; }
     }, {passive:true});
 
-    document.addEventListener('mouseover', function(e) {
-        var candidate = getDarkHoverSurfaceCandidate(e.target);
-        if (!candidate) return;
-        syncDarkHoverSurface(candidate);
-    }, true);
-
-    document.addEventListener('mouseout', function(e) {
-        var candidate = getDarkHoverSurfaceCandidate(e.target);
-        if (!candidate) return;
-        if (e.relatedTarget && candidate.contains(e.relatedTarget)) return;
-        unlockDarkHoverSurface(candidate);
-    }, true);
-
-    document.addEventListener('focusin', function(e) {
-        var candidate = getDarkHoverSurfaceCandidate(e.target);
-        if (!candidate) return;
-        syncDarkHoverSurface(candidate);
-    });
-
-    document.addEventListener('focusout', function(e) {
-        var candidate = getDarkHoverSurfaceCandidate(e.target);
-        if (!candidate) return;
-        if (e.relatedTarget && candidate.contains(e.relatedTarget)) return;
-        unlockDarkHoverSurface(candidate);
+    document.addEventListener('mouseover', function(e) {
+        if (!isDarkModeActive()) return;
+        var candidate = getDarkHoverSurfaceCandidate(e.target);
+        if (!candidate) return;
+        syncDarkHoverSurface(candidate);
+    }, true);
+
+    document.addEventListener('mouseout', function(e) {
+        if (!isDarkModeActive()) return;
+        var candidate = getDarkHoverSurfaceCandidate(e.target);
+        if (!candidate) return;
+        if (e.relatedTarget && candidate.contains(e.relatedTarget)) return;
+        unlockDarkHoverSurface(candidate);
+    }, true);
+
+    document.addEventListener('focusin', function(e) {
+        if (!isDarkModeActive()) return;
+        var candidate = getDarkHoverSurfaceCandidate(e.target);
+        if (!candidate) return;
+        syncDarkHoverSurface(candidate);
+    });
+
+    document.addEventListener('focusout', function(e) {
+        if (!isDarkModeActive()) return;
+        var candidate = getDarkHoverSurfaceCandidate(e.target);
+        if (!candidate) return;
+        if (e.relatedTarget && candidate.contains(e.relatedTarget)) return;
+        unlockDarkHoverSurface(candidate);
     });
 
     /* ============================================================
@@ -1947,10 +2035,12 @@ function init(options) {
     /* ============================================================
        Restore Saved State
     ============================================================ */
-    activeFeatures.forEach(function(cls){ setFeatureVisualState(cls, true); });
-    setDarkModeState(getStoredTheme() === 'dark', { skipTransition: true });
-
-    applyLanguage(currentLang); updateDynamicLabels(); syncHideImagesState(); toggleMuteMedia(); checkHideStatus();
+    activeFeatures.forEach(function(cls){ setFeatureVisualState(cls, true); });
+    setDarkModeState(getStoredTheme() === 'dark', { skipTransition: true });
+    syncRuntimeObservers();
+    applyLanguage(currentLang); updateDynamicLabels(); checkHideStatus();
+    if (document.documentElement.classList.contains('adeck-hide-images')) syncHideImagesState();
+    if (document.documentElement.classList.contains('adeck-mute-media')) toggleMuteMedia();
 
     if (fontScale !== 100) applyFontScale(); else { var df2 = document.getElementById('adeck-font-val'); if (df2) df2.textContent = '100%'; }
     if (lhScale !== 100) applyLineHeight(); else { var dl2 = document.getElementById('adeck-lh-val'); if (dl2) dl2.textContent = '100%'; }
@@ -2047,13 +2137,14 @@ function init(options) {
             setFeatureVisualState(cls, isNow);
         }
 
-        if (!isNow && cls === 'adeck-read-aloud') {
-            window.speechSynthesis.cancel();
-            cleanHighlights();
-        }
-
-        saveActiveFeatures();
-        updateDynamicLabels();
+        if (!isNow && cls === 'adeck-read-aloud') {
+            window.speechSynthesis.cancel();
+            cleanHighlights();
+        }
+
+        saveActiveFeatures();
+        syncRuntimeObservers();
+        updateDynamicLabels();
 
         var fname = (i18n[currentLang] && i18n[currentLang][labelKeys[btn.id]]) || btn.id;
         var statusText = (isNow ? (i18n[currentLang]['status_enable'] || 'Enabled') : (i18n[currentLang]['status_disable'] || 'Disabled')) + ': ' + fname;
@@ -2119,10 +2210,10 @@ function init(options) {
 
         if (e.target.closest('#adeck-font-plus')) { fontScale += 10; saveAndApplyFont(); return; }
         if (e.target.closest('#adeck-font-min'))  { fontScale -= 10; saveAndApplyFont(); return; }
-        if (isFeatureEnabled('lineHeight') && e.target.closest('#adeck-lh-plus')) { lhScale = Math.min(LH_MAX, lhScale + LH_STEP); storage.setItem(storageKeys.lineHeight, lhScale); applyLineHeight(); announce(lhScale+'%'); return; }
-        if (isFeatureEnabled('lineHeight') && e.target.closest('#adeck-lh-min')) { lhScale = Math.max(LH_MIN, lhScale - LH_STEP); if (lhScale === LH_MIN) resetLineHeight(); else { storage.setItem(storageKeys.lineHeight, lhScale); applyLineHeight(); announce(lhScale+'%'); } return; }
-        if (isFeatureEnabled('textSpacing') && e.target.closest('#adeck-ts-plus')) { tsScale = Math.min(TS_MAX, tsScale + TS_STEP); storage.setItem(storageKeys.textSpacing, tsScale); applyTextSpacing(); announce(tsScale+'%'); return; }
-        if (isFeatureEnabled('textSpacing') && e.target.closest('#adeck-ts-min')) { tsScale = Math.max(TS_MIN, tsScale - TS_STEP); if (tsScale === TS_MIN) resetTextSpacing(); else { storage.setItem(storageKeys.textSpacing, tsScale); applyTextSpacing(); announce(tsScale+'%'); } return; }
+        if (isFeatureEnabled('lineHeight') && e.target.closest('#adeck-lh-plus')) { lhScale = Math.min(LH_MAX, lhScale + LH_STEP); storage.setItem(storageKeys.lineHeight, lhScale); applyLineHeight(); syncRuntimeObservers(); announce(lhScale+'%'); return; }
+        if (isFeatureEnabled('lineHeight') && e.target.closest('#adeck-lh-min')) { lhScale = Math.max(LH_MIN, lhScale - LH_STEP); if (lhScale === LH_MIN) resetLineHeight(); else { storage.setItem(storageKeys.lineHeight, lhScale); applyLineHeight(); syncRuntimeObservers(); announce(lhScale+'%'); } return; }
+        if (isFeatureEnabled('textSpacing') && e.target.closest('#adeck-ts-plus')) { tsScale = Math.min(TS_MAX, tsScale + TS_STEP); storage.setItem(storageKeys.textSpacing, tsScale); applyTextSpacing(); syncRuntimeObservers(); announce(tsScale+'%'); return; }
+        if (isFeatureEnabled('textSpacing') && e.target.closest('#adeck-ts-min')) { tsScale = Math.max(TS_MIN, tsScale - TS_STEP); if (tsScale === TS_MIN) resetTextSpacing(); else { storage.setItem(storageKeys.textSpacing, tsScale); applyTextSpacing(); syncRuntimeObservers(); announce(tsScale+'%'); } return; }
         if (e.target.closest('#adeck-reset-typography')) { resetTypographyControls(); return; }
 
         if (e.target.closest('#btn-reset')) { handleResetButton(); return; }
@@ -2537,7 +2628,21 @@ global.ADecksibility.initWhenReady = initWhenReady;
         }
 
         if (!merged.storageNamespace || merged.storageNamespace === DEFAULT_CONFIG.storageNamespace) {
-            merged.storageNamespace = 'adecksibility:' + String(merged.tenant.slug || merged.tenant.id || 'default');
+            var namespaceSeed = '';
+
+            if (typeof merged.host === 'string' && merged.host && merged.host !== 'standalone' && merged.host !== 'generic') {
+                namespaceSeed = merged.host;
+            } else if (merged.tenant && typeof merged.tenant.slug === 'string' && merged.tenant.slug && merged.tenant.slug !== 'default') {
+                namespaceSeed = merged.tenant.slug;
+            } else if (merged.tenant && typeof merged.tenant.id === 'string' && merged.tenant.id && merged.tenant.id !== 'default') {
+                namespaceSeed = merged.tenant.id;
+            } else if (global.location && global.location.host) {
+                namespaceSeed = global.location.host;
+            } else {
+                namespaceSeed = 'default';
+            }
+
+            merged.storageNamespace = 'adecksibility:' + String(namespaceSeed).toLowerCase();
         }
 
         if (typeof merged.statementHtml === 'string' && merged.statementHtml.trim()) {
@@ -2662,9 +2767,11 @@ global.ADecksibility.initWhenReady = initWhenReady;
 
     function ensureDarkModeBootstrap(config) {
         var themeStorageKey = ((config.storageKeys || {}).theme) || 'adeck_theme';
+        var storageNamespace = (config && typeof config.storageNamespace === 'string') ? config.storageNamespace.trim() : '';
+        var resolvedThemeStorageKey = storageNamespace ? (storageNamespace + ':' + themeStorageKey) : themeStorageKey;
         var script = document.getElementById('adeck-dark-mode-bootstrap');
         var contents = "(function(){try{var storedTheme=window.localStorage.getItem(" +
-            JSON.stringify(themeStorageKey) +
+            JSON.stringify(resolvedThemeStorageKey) +
             ");if(storedTheme==='dark'){document.documentElement.setAttribute('data-adeck-theme','dark');document.documentElement.classList.add('adeck-dark-mode','adeck-dark-mode-preload');}}catch(error){}}());";
 
         if (!script) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adecksibility-widget",
-  "version": "2.5.5",
+  "version": "2.5.8",
   "description": "Premium standalone accessibility widget bundle for WordPress and non-WordPress sites.",
   "main": "dist/adecksibility-widget-pro.umd.js",
   "files": [