Disable popup controls when schedule is active (#90)

Author: Brian-S-Poon

CHANGELOG.md

@@ -7,6 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+- Disabled popup global controls when scheduling is active and added inline guidance
+  so users know adjustments are driven by their schedule.
+
 ## [1.6.0] - 2025-11-16
 
 ### Added

_locales/en/messages.json

@@ -73,6 +73,9 @@
   "popupGlobalStatusOff": {
     "message": "Dimmer is off."
   },
+  "popupScheduleLockNotice": {
+    "message": "Scheduling is on. Global controls follow your schedule and can't be adjusted here."
+  },
   "popupSiteLockedStatus": {
     "message": "Locked at $PERCENT$%.",
     "placeholders": {

_locales/es/messages.json

@@ -73,6 +73,9 @@
   "popupGlobalStatusOff": {
     "message": "El atenuador está desactivado."
   },
+  "popupScheduleLockNotice": {
+    "message": "La programación está activada. Los controles globales siguen tu horario y no se pueden ajustar aquí."
+  },
   "popupSiteLockedStatus": {
     "message": "Bloqueado al $PERCENT$%.",
     "placeholders": {

_locales/fr/messages.json

@@ -73,6 +73,9 @@
   "popupGlobalStatusOff": {
     "message": "L'atténuateur est désactivé."
   },
+  "popupScheduleLockNotice": {
+    "message": "La planification est activée. Les commandes globales suivent votre programme et ne peuvent pas être ajustées ici."
+  },
   "popupSiteLockedStatus": {
     "message": "Verrouillé à $PERCENT$ %.",
     "placeholders": {

_locales/pt_BR/messages.json

@@ -73,6 +73,9 @@
   "popupGlobalStatusOff": {
     "message": "Escurecedor desligado."
   },
+  "popupScheduleLockNotice": {
+    "message": "O agendamento está ativado. Os controles globais seguem sua programação e não podem ser ajustados aqui."
+  },
   "popupSiteLockedStatus": {
     "message": "Bloqueado em $PERCENT$%.",
     "placeholders": {

src/popup/index.html

@@ -32,6 +32,7 @@ <h2 id="global-controls-heading" class="section-heading" data-i18n="popupGlobalH
         </div>
         <input id="level" type="range" min="0" max="1" step="0.01" value="0.25">
       </div>
+      <p id="schedule-notice" class="muted small-text" hidden data-i18n="popupScheduleLockNotice"></p>
       <p id="global-status" class="muted small-text" role="status" aria-live="polite" data-i18n="popupGlobalStatusOff"></p>
       <button id="toggle" type="button" data-i18n="popupToggleOn"></button>
     </section>

src/popup/popup.css

@@ -143,6 +143,14 @@ body.manager-open .site-manager-content {
   margin-bottom: 0;
 }
 
+.controls-section.global-controls.schedule-locked {
+  opacity: 0.6;
+}
+
+.controls-section.global-controls.schedule-locked button:not(.settings-button) {
+  cursor: not-allowed;
+}
+
 .section-heading {
   margin: 0 0 8px;
   font-size: 12px;

src/popup/popup.js

@@ -23,6 +23,7 @@
   let currentSiteLevel = null;
   let managerVisible = false;
   let blockedHost = null;
+  let scheduleLocked = false;
 
   function openOptionsPage() {
     if (!global.chrome || !chrome.runtime) {
@@ -59,6 +60,11 @@
     });
   }
 
+  function applyScheduleLock(enabled) {
+    scheduleLocked = Boolean(enabled);
+    ui.setScheduleLock(scheduleLocked);
+  }
+
   function updateSiteUI(message) {
     let finalMessage = message;
     if (!finalMessage && blockedHost) {
@@ -85,18 +91,21 @@
   }
 
   function handleLevelInput(event) {
+    if (scheduleLocked) return;
     const value = clamp01(event.target.value);
     applyLevel(value);
     scheduleGlobalWrite(value);
   }
 
   function handleLevelChange(event) {
+    if (scheduleLocked) return;
     const value = clamp01(event.target.value);
     applyLevel(value);
     scheduleGlobalWrite(value);
   }
 
   async function handleToggleClick() {
+    if (scheduleLocked) return;
     const nextLevel = lastLevel > 0 ? 0 : DEFAULT_LEVEL;
     applyLevel(nextLevel);
     try {
@@ -246,6 +255,7 @@
       blockedHost = initial.blockedHost || null;
       siteStorage.setCache(initial.siteLevels || {});
       currentSiteLevel = siteStorage.getLevel(currentHost);
+      applyScheduleLock(initial.scheduleEnabled);
       applyLevel(lastLevel);
       updateSiteUI();
       syncManagerUI('');

src/popup/state.js

@@ -77,14 +77,20 @@
     const currentSiteLevel = host && typeof siteLevels[host] === 'number'
       ? clamp01(siteLevels[host])
       : null;
+    const scheduleEnabled = Boolean(
+      Object.prototype.hasOwnProperty.call(levelState, 'scheduleEnabled')
+        ? levelState.scheduleEnabled
+        : levelState.schedule && levelState.schedule.enabled
+    );
 
     return {
       host,
       blockedHost,
       siteLevels,
       globalLevel: normalizedGlobal,
       currentSiteLevel,
-      schedule: levelState.schedule
+      schedule: levelState.schedule,
+      scheduleEnabled
     };
   }
 

src/popup/ui.js

@@ -17,6 +17,7 @@
   const toggleBtn = document.querySelector('#toggle');
   const globalStatus = document.querySelector('#global-status');
   const globalControls = document.querySelector('.global-controls');
+  const scheduleNotice = document.querySelector('#schedule-notice');
   const siteControls = document.querySelector('#site-controls');
   const siteHostLabel = document.querySelector('#site-host');
   const siteStatus = document.querySelector('#site-status');
@@ -121,6 +122,46 @@
     }
   }
 
+  function setScheduleLock(enabled) {
+    const isLocked = Boolean(enabled);
+    const ariaValue = String(isLocked);
+    const noticeId = scheduleNotice && scheduleNotice.id ? scheduleNotice.id : null;
+
+    if (slider) {
+      slider.disabled = isLocked;
+      slider.setAttribute('aria-disabled', ariaValue);
+      if (isLocked && noticeId) {
+        slider.setAttribute('aria-describedby', noticeId);
+      } else {
+        slider.removeAttribute('aria-describedby');
+      }
+    }
+
+    if (toggleBtn) {
+      toggleBtn.disabled = isLocked;
+      toggleBtn.setAttribute('aria-disabled', ariaValue);
+      if (isLocked && noticeId) {
+        toggleBtn.setAttribute('aria-describedby', noticeId);
+      } else {
+        toggleBtn.removeAttribute('aria-describedby');
+      }
+    }
+
+    if (globalControls) {
+      globalControls.classList.toggle('schedule-locked', isLocked);
+    }
+
+    if (scheduleNotice) {
+      if (isLocked) {
+        scheduleNotice.hidden = false;
+        scheduleNotice.textContent = getMessage('popupScheduleLockNotice');
+      } else {
+        scheduleNotice.hidden = true;
+        scheduleNotice.textContent = '';
+      }
+    }
+  }
+
   function updateManageSummary(levels) {
     if (!manageBtn) return;
     const entries = levels && typeof levels === 'object'
@@ -321,6 +362,7 @@
     updateGlobal,
     renderSite,
     setSiteToggleDisabled,
+    setScheduleLock,
     updateManageSummary,
     renderManager,
     setManagerVisible,