Upload 9 files

alert_actions.js

@@ -0,0 +1,178 @@
+/*
+ ساعة المسلم — إجراءات التنبيه: اختيار النغمة، وفتح الإذاعة عند دخول وقت الصلاة (الأذان).
+ البيانات في alert_tones_registry.json، والتخزين محلي على الجهاز فقط.
+*/
+(function () {
+  'use strict';
+  const base = new URL('.', document.currentScript.src);
+  let cfg = null, configPromise, ctx = null;
+  const node = (tag, text, cls) => { const n = document.createElement(tag); if (text != null) n.textContent = text; if (cls) n.className = cls; return n; };
+  const button = (text, action) => { const b = node('button', text); b.type = 'button'; b.addEventListener('click', action); return b; };
+  const fmt = (s, v) => String(s).replace(/\{(\w+)\}/g, (_, k) => String(v[k] ?? ''));
+
+  function config() {
+    if (!configPromise) configPromise = (async () => {
+      const ctl = new AbortController(), t = setTimeout(() => ctl.abort(), 15000);
+      try {
+        const r = await fetch(new URL('alert_tones_registry.json', base), { cache: 'no-store', signal: ctl.signal });
+        if (!r.ok) throw Error('alert_tones_registry.json HTTP ' + r.status);
+        const c = await r.json();
+        if (c.version !== 1 || !c.storage_key || !c.defaults || !c.ui || !Array.isArray(c.tones)) throw Error('Invalid alert registry');
+        cfg = c; return c;
+      } finally { clearTimeout(t); }
+    })().catch(e => { configPromise = null; throw e; });
+    return configPromise;
+  }
+  const tonesList = () => (cfg?.tones || []).filter(t => t.kind !== 'file' || (t.url && String(t.url).trim()));
+  const clamp = (v, a, b) => Math.min(b, Math.max(a, Number.isFinite(v) ? v : a));
+  function read() {
+    const d = cfg?.defaults || { general: {}, adhan: {} };
+    let saved = null; try { saved = JSON.parse(localStorage.getItem(cfg?.storage_key)); } catch { /* ignore */ }
+    return {
+      general: { ...d.general, ...(saved?.general || {}) },
+      adhan: { ...d.adhan, ...(saved?.adhan || {}), prayers: { ...(d.adhan?.prayers || {}), ...(saved?.adhan?.prayers || {}) } }
+    };
+  }
+  function write(state) { try { localStorage.setItem(cfg.storage_key, JSON.stringify(state)); return true; } catch { return false; } }
+
+  // ---- tones ----
+  function audioContext() {
+    const AC = window.AudioContext || window.webkitAudioContext; if (!AC) return null;
+    if (!ctx) ctx = new AC();
+    return ctx;
+  }
+  document.addEventListener('pointerdown', () => { try { audioContext()?.resume(); } catch { /* ignore */ } }, { passive: true });
+  async function playToneById(id, volume) {
+    await config().catch(() => null);
+    const tone = (cfg?.tones || []).find(t => t.id === id);
+    if (!tone || tone.kind === 'legacy') return false;
+    const vol = clamp(Number(volume), 0.05, 1);
+    if (tone.kind === 'file') {
+      try { const a = new Audio(new URL(tone.url, base).href); a.volume = vol; await a.play(); return true; } catch { return false; }
+    }
+    try {
+      const c = audioContext(); if (!c) return false;
+      if (c.state !== 'running') await c.resume();
+      if (c.state !== 'running') return false;
+      const now = c.currentTime;
+      for (const n of tone.notes || []) {
+        const o = c.createOscillator(), g = c.createGain(), at = now + (n.t || 0), peak = Math.max(0.001, (n.g || 0.4) * vol);
+        o.type = 'sine'; o.frequency.value = n.f;
+        g.gain.setValueAtTime(0.0001, at); g.gain.exponentialRampToValueAtTime(peak, at + 0.03);
+        g.gain.exponentialRampToValueAtTime(0.0001, at + (n.d || 0.8));
+        o.connect(g); g.connect(c.destination); o.start(at); o.stop(at + (n.d || 0.8) + 0.05);
+      }
+      return true;
+    } catch { return false; }
+  }
+  const playTone = async kind => { await config().catch(() => null); const s = read(); const x = kind === 'adhan' ? s.adhan : s.general; return playToneById(x.tone, x.volume); };
+  // True only when the person picked something other than the original beep.
+  const hasCustomTone = kind => { if (!cfg) return false; const x = read()[kind === 'adhan' ? 'adhan' : 'general']; const t = cfg.tones.find(t => t.id === x.tone); return Boolean(t && t.kind !== 'legacy'); };
+
+  // ---- adhan ----
+  const adhanEnabled = () => Boolean(cfg && read().adhan.enabled);
+  const shouldFire = id => read().adhan.prayers[id] !== false;
+  const getAdhanStation = () => read().adhan.station || '';
+  function setAdhanStation(id) { const s = read(); s.adhan.station = id; return write(s); }
+  const panelClosed = () => { const p = document.getElementById('adaptivePopup'); return !p || p.hidden; };
+
+  async function fire(info, { test = false } = {}) {
+    await config().catch(() => null); if (!cfg) return;
+    const ui = cfg.ui, s = read().adhan, text = fmt(ui.due_text, { name: info.title, time: info.time || '' });
+    let radioResult = null;
+    if (s.action === 'radio') {
+      if (!window.MuslimClockRadio) radioResult = { ok: false, reason: 'unavailable' };
+      else radioResult = await window.MuslimClockRadio.play(s.station, { stopAfterMin: clamp(Number(s.stop_after_minutes), 0, cfg.limits?.stop_after_max_minutes || 180) });
+    } else if (s.action === 'tone') await playToneById(s.tone, s.volume);
+    try { RegistryApp.notifySystem?.(info.title, text, { kind: 'worship' }); } catch { /* optional */ }
+    if (document.hidden || (!panelClosed() && !test)) return;
+    const needsHelp = radioResult && !radioResult.ok;
+    RegistryApp.openPanel('worship', { title: info.title, text, compact: true }, () => {
+      const body = document.getElementById('adaptivePopupBody'), actions = document.getElementById('adaptivePopupActions');
+      if (s.action === 'radio') {
+        const note = node('p', null); note.setAttribute('role', 'status');
+        if (needsHelp) {
+          note.textContent = radioResult.reason === 'no_stream' ? ui.radio_external : radioResult.reason === 'blocked' ? ui.radio_blocked : ui.radio_failed;
+          body.append(note);
+          if (radioResult.reason === 'no_stream' && radioResult.station?.officialUrl) {
+            const a = node('a', ui.open_radio_site); a.href = radioResult.station.officialUrl; a.target = '_blank'; a.rel = 'noopener noreferrer'; body.append(a);
+          } else actions.append(button(ui.start_radio, () => window.MuslimClockRadio?.play(s.station, { stopAfterMin: Number(s.stop_after_minutes) })));
+        } else if (radioResult?.ok) { note.textContent = radioResult.station.name; body.append(note); actions.append(button(ui.stop_radio, () => window.MuslimClockRadio.stop())); }
+        actions.append(button(ui.open_radio, () => window.MuslimClockRadio?.open({})));
+      }
+    });
+  }
+
+  // ---- settings panel ----
+  async function openSettings({ back } = {}) {
+    let c; try { c = await config(); } catch (e) { return; }
+    const ui = c.ui, state = read(), root = node('div', null, 'alert-settings');
+    const status = node('p'); status.setAttribute('role', 'status'); status.setAttribute('aria-live', 'polite'); status.tabIndex = -1;
+    const field = (label, input, host = root) => { const l = node('label', label); l.append(input); host.append(l); return l; };
+    const select = (options, value) => { const s = node('select'); for (const [v, t] of options) { const o = node('option', t); o.value = v; s.append(o); } s.value = value; return s; };
+    const toneOptions = () => tonesList().map(t => [t.id, t.name]);
+
+    root.append(node('p', ui.scope, 'quran-meta'), node('h3', ui.adhan_heading));
+    const enable = node('input'); enable.type = 'checkbox'; enable.checked = state.adhan.enabled === true;
+    const enableLabel = node('label', ui.adhan_enable); enableLabel.prepend(enable); root.append(enableLabel);
+    const action = select([['popup', ui.action_popup], ['tone', ui.action_tone], ['radio', ui.action_radio]], state.adhan.action);
+    field(ui.adhan_action, action);
+    const adhanTone = select(toneOptions().filter(([id]) => id !== 'classic_beep'), state.adhan.tone); const toneLabel = field(ui.tone, adhanTone);
+    const adhanVolume = node('input'); adhanVolume.type = 'range'; adhanVolume.min = 0.1; adhanVolume.max = 1; adhanVolume.step = 0.05; adhanVolume.value = state.adhan.volume;
+    const volLabel = field(ui.volume, adhanVolume);
+    const stationSelect = select([['', ui.pick_station]], state.adhan.station || ''); const stationLabel = field(ui.station, stationSelect);
+    const stopAfter = node('input'); stopAfter.type = 'number'; stopAfter.min = 0; stopAfter.max = c.limits?.stop_after_max_minutes || 180; stopAfter.step = 1; stopAfter.inputMode = 'numeric'; stopAfter.value = state.adhan.stop_after_minutes;
+    const stopLabel = field(ui.stop_after, stopAfter);
+    window.MuslimClockRadio?.stations().then(list => {
+      for (const s of list) { const o = node('option', s.name + (s.streamUrl ? '' : ui.no_stream_tag)); o.value = s.id; stationSelect.append(o); }
+      stationSelect.value = state.adhan.station || '';
+    }).catch(() => {});
+    const group = node('fieldset'), legend = node('legend', ui.prayers); group.append(legend);
+    const prayerBoxes = (RegistryApp.adhanPrayers?.() || []).map(p => {
+      const box = node('input'); box.type = 'checkbox'; box.checked = state.adhan.prayers[p.id] !== false;
+      const l = node('label', p.title); l.prepend(box); group.append(l); return { id: p.id, box };
+    });
+    root.append(group);
+    const sync = () => { toneLabel.hidden = volLabel.hidden = action.value !== 'tone'; stationLabel.hidden = stopLabel.hidden = action.value !== 'radio'; };
+    action.addEventListener('change', () => { sync(); status.textContent = ''; }); sync();
+
+    root.append(node('h3', ui.general_heading));
+    const generalTone = select(toneOptions(), state.general.tone); field(ui.general_tone, generalTone);
+    const generalVolume = node('input'); generalVolume.type = 'range'; generalVolume.min = 0.1; generalVolume.max = 1; generalVolume.step = 0.05; generalVolume.value = state.general.volume; field(ui.volume, generalVolume);
+
+    const collect = () => {
+      const prayers = {}; prayerBoxes.forEach(p => { prayers[p.id] = p.box.checked; });
+      return {
+        general: { tone: generalTone.value, volume: Number(generalVolume.value) },
+        adhan: { enabled: enable.checked, action: action.value, tone: adhanTone.value, station: stationSelect.value, volume: Number(adhanVolume.value),
+          stop_after_minutes: clamp(Math.round(Number(stopAfter.value)), 0, c.limits?.stop_after_max_minutes || 180), prayers }
+      };
+    };
+    const say = text => { status.textContent = ''; setTimeout(() => { status.textContent = text; }, 40); };
+    root.append(
+      button(ui.test + ' — ' + ui.adhan_heading, async () => {
+        const draft = collect().adhan;
+        if (draft.action === 'tone') { say((await playToneById(draft.tone, draft.volume)) ? ui.test_done : ui.test_failed); return; }
+        if (draft.action === 'radio') {
+          const r = await window.MuslimClockRadio?.play(draft.station, { stopAfterMin: draft.stop_after_minutes });
+          say(!r ? ui.radio_unavailable : r.ok ? ui.test_done : r.reason === 'no_stream' ? ui.radio_external : r.reason === 'blocked' ? ui.radio_blocked : ui.radio_failed); return;
+        }
+        say(ui.test_done);
+      }),
+      button(ui.test + ' — ' + ui.general_heading, async () => { say((await playToneById(generalTone.value, generalVolume.value)) ? ui.test_done : ui.test_failed); }),
+      button(ui.save, () => { say(write(collect()) ? ui.saved : ui.storage_error); }),
+      status);
+    RegistryApp.openPanel('worship', { title: ui.title, compact: true }, () => {
+      document.getElementById('adaptivePopupBody').append(root);
+      if (back) document.getElementById('adaptivePopupActions').append(button(ui.back, back));
+    });
+    document.getElementById('adaptivePopupCard').dataset.size = 'long';
+  }
+  async function mountSettingsEntry(parent, back) {
+    const entry = button('…', () => {}); entry.disabled = true; parent.append(entry);
+    try { const c = await config(); if (!entry.isConnected) return; entry.textContent = c.ui.open; entry.disabled = false; entry.onclick = () => openSettings({ back }); }
+    catch (e) { if (entry.isConnected) { entry.textContent = 'alert_tones_registry.json: ' + e.message; entry.disabled = false; entry.onclick = () => { entry.remove(); mountSettingsEntry(parent, back); }; } }
+  }
+  config().catch(() => null);
+  window.MuslimClockAlerts = Object.freeze({ playTone, hasCustomTone, adhanEnabled, shouldFire, fire, getAdhanStation, setAdhanStation, openSettings, mountSettingsEntry, tones: () => tonesList() });
+})();

alert_tones_registry.json

@@ -0,0 +1,210 @@
+{
+  "version": 1,
+  "storage_key": "muslim_clock_alert_actions_v1",
+  "note": "لإضافة نغمة من ملف: ضع ملف mp3/ogg داخل مجلد tones/ ثم اكتب مسارها في url لأحد عناصر kind=file (مثال: tones/adhan1.mp3). النغمات ذات url فارغ لا تظهر للمستخدم.",
+  "defaults": {
+    "general": {
+      "tone": "classic_beep",
+      "volume": 0.8
+    },
+    "adhan": {
+      "enabled": false,
+      "action": "popup",
+      "tone": "soft_bell",
+      "station": "",
+      "stop_after_minutes": 0,
+      "volume": 0.9,
+      "prayers": {}
+    }
+  },
+  "limits": {
+    "stop_after_max_minutes": 180,
+    "adhan_due_window_seconds": 90
+  },
+  "tones": [
+    {
+      "id": "classic_beep",
+      "name": "النغمة الأساسية (الافتراضية)",
+      "kind": "legacy"
+    },
+    {
+      "id": "soft_bell",
+      "name": "جرس هادئ",
+      "kind": "synth",
+      "notes": [
+        {
+          "f": 880,
+          "t": 0,
+          "d": 1.6,
+          "g": 0.5
+        },
+        {
+          "f": 1318.5,
+          "t": 0,
+          "d": 1.1,
+          "g": 0.22
+        }
+      ]
+    },
+    {
+      "id": "double_chime",
+      "name": "رنين مزدوج",
+      "kind": "synth",
+      "notes": [
+        {
+          "f": 659.25,
+          "t": 0,
+          "d": 0.7,
+          "g": 0.5
+        },
+        {
+          "f": 880,
+          "t": 0.4,
+          "d": 1.0,
+          "g": 0.5
+        }
+      ]
+    },
+    {
+      "id": "rising_three",
+      "name": "ثلاث نغمات صاعدة",
+      "kind": "synth",
+      "notes": [
+        {
+          "f": 523.25,
+          "t": 0,
+          "d": 0.7,
+          "g": 0.45
+        },
+        {
+          "f": 659.25,
+          "t": 0.35,
+          "d": 0.7,
+          "g": 0.45
+        },
+        {
+          "f": 783.99,
+          "t": 0.7,
+          "d": 1.1,
+          "g": 0.45
+        }
+      ]
+    },
+    {
+      "id": "calm_low",
+      "name": "نغمة منخفضة هادئة",
+      "kind": "synth",
+      "notes": [
+        {
+          "f": 392,
+          "t": 0,
+          "d": 1.8,
+          "g": 0.55
+        },
+        {
+          "f": 523.25,
+          "t": 0.6,
+          "d": 1.8,
+          "g": 0.4
+        }
+      ]
+    },
+    {
+      "id": "soft_pulse",
+      "name": "نبضات خفيفة",
+      "kind": "synth",
+      "notes": [
+        {
+          "f": 740,
+          "t": 0,
+          "d": 0.3,
+          "g": 0.4
+        },
+        {
+          "f": 740,
+          "t": 0.45,
+          "d": 0.3,
+          "g": 0.4
+        },
+        {
+          "f": 740,
+          "t": 0.9,
+          "d": 0.3,
+          "g": 0.4
+        },
+        {
+          "f": 988,
+          "t": 1.35,
+          "d": 0.6,
+          "g": 0.4
+        }
+      ]
+    },
+    {
+      "id": "file_1",
+      "name": "نغمة من ملف ١",
+      "kind": "file",
+      "url": ""
+    },
+    {
+      "id": "file_2",
+      "name": "نغمة من ملف ٢",
+      "kind": "file",
+      "url": ""
+    },
+    {
+      "id": "file_3",
+      "name": "نغمة من ملف ٣",
+      "kind": "file",
+      "url": ""
+    },
+    {
+      "id": "file_4",
+      "name": "نغمة من ملف ٤",
+      "kind": "file",
+      "url": ""
+    },
+    {
+      "id": "file_5",
+      "name": "نغمة من ملف ٥",
+      "kind": "file",
+      "url": ""
+    }
+  ],
+  "ui": {
+    "title": "التنبيهات: النغمات والإذاعة والأذان",
+    "open": "🔔 النغمات وفتح الإذاعة عند الأذان",
+    "back": "رجوع",
+    "save": "حفظ الإعدادات",
+    "saved": "حُفظت الإعدادات.",
+    "storage_error": "تعذّر الحفظ على هذا الجهاز.",
+    "adhan_heading": "تنبيه دخول وقت الصلاة (الأذان)",
+    "adhan_enable": "تفعيل التنبيه عند دخول وقت الصلاة",
+    "adhan_action": "ماذا يحدث عند دخول الوقت؟",
+    "action_popup": "إشعار فقط (بدون صوت)",
+    "action_tone": "تشغيل نغمة",
+    "action_radio": "فتح الإذاعة التي اخترتها",
+    "tone": "النغمة",
+    "station": "الإذاعة",
+    "stop_after": "إيقاف الإذاعة تلقائيًا بعد (بالدقائق، 0 = لا تتوقف)",
+    "volume": "مستوى صوت النغمة",
+    "prayers": "الصلوات التي يعمل لها التنبيه",
+    "no_stream_tag": " (بدون بث مباشر: يفتح موقعها فقط)",
+    "pick_station": "اختر إذاعة",
+    "general_heading": "نغمة التذكيرات والمناسبات العامة",
+    "general_tone": "نغمة التذكيرات",
+    "test": "تجربة الآن",
+    "test_done": "جرى تنفيذ التجربة.",
+    "test_failed": "تعذّر تشغيل الصوت. اضغط تجربة مرة أخرى أو تحقق من الصوت.",
+    "radio_unavailable": "وحدة الإذاعة غير متاحة.",
+    "due_text": "حان وقت {name} ({time}).",
+    "radio_blocked": "المتصفح يحتاج ضغطة منك لبدء الإذاعة.",
+    "radio_failed": "تعذّر تشغيل الإذاعة المختارة.",
+    "radio_external": "هذه الإذاعة لا تملك بثًا مباشرًا مضمونًا؛ افتح موقعها.",
+    "start_radio": "تشغيل الإذاعة الآن",
+    "open_radio_site": "فتح موقع الإذاعة ↗",
+    "stop_radio": "إيقاف الإذاعة",
+    "open_radio": "فتح ركن الإذاعات",
+    "scope": "الأذان يُحسب من موقعك والصفحة يجب أن تبقى مفتوحة. المتصفح لا يضمن تشغيل الصوت بعد إغلاقه أو عند إطفاء الشاشة."
+  }
+}

islamic_radio.css

@@ -1,6 +1,28 @@
+/* ركن الإذاعات + إعدادات النغمات والأذان — يعتمد على متغيرات الواجهة (--cell-surface, --cell-border) */
 .islamic-radio-section{display:block;width:100%}
-.islamic-radio-tabs{display:flex;gap:.5rem;overflow-x:auto;padding:.5rem 0}
-.islamic-radio-station{display:grid;grid-template-columns:1fr auto auto;gap:.6rem;align-items:center;padding:.8rem;border-radius:14px;margin-bottom:.5rem}
-.islamic-radio-station.is-playing{outline:2px solid currentColor}
-.islamic-radio-favorite{border:0;background:transparent;font-size:1.25rem;cursor:pointer}
-.islamic-radio-player{position:sticky;bottom:0;z-index:20;display:grid;grid-template-columns:1fr auto auto;gap:.6rem;align-items:center;padding:.7rem;backdrop-filter:blur(12px)}
+#adaptivePopupBody .islamic-radio-list{list-style:none;margin:10px 0;padding:0}
+#adaptivePopupBody .islamic-radio-station{display:grid;grid-template-columns:1fr auto;gap:6px;align-items:stretch;margin:0 0 8px;padding:6px;border:1px solid var(--cell-border,#888);border-radius:14px;background:var(--cell-surface,transparent)}
+#adaptivePopupBody .islamic-radio-station.is-playing{outline:2px solid currentColor;outline-offset:1px}
+#adaptivePopupBody .islamic-radio-station button{width:auto;margin:0;min-height:48px}
+#adaptivePopupBody .islamic-radio-play{display:flex;flex-direction:column;align-items:flex-start;text-align:start;gap:2px;overflow-wrap:anywhere}
+#adaptivePopupBody .islamic-radio-name{font-weight:bold}
+#adaptivePopupBody .islamic-radio-meta{font-size:.82rem;opacity:.8}
+#adaptivePopupBody .islamic-radio-favorite{min-width:48px;font-size:1.3rem;text-align:center;background:transparent}
+#adaptivePopupBody .islamic-radio-alert{grid-column:1/-1;font-size:.9rem;text-align:center}
+#adaptivePopupBody .islamic-radio-alert[aria-pressed="true"]{font-weight:bold;outline:2px solid currentColor;outline-offset:-3px}
+#adaptivePopupBody .islamic-radio-player{position:sticky;top:0;z-index:5;display:grid;grid-template-columns:1fr;gap:6px;padding:10px;margin:8px 0;border:2px solid currentColor;border-radius:14px;background:var(--cell-surface,#222);backdrop-filter:blur(12px)}
+#adaptivePopupBody .islamic-radio-player[hidden]{display:none}
+#adaptivePopupBody .islamic-radio-player p{margin:0}
+#adaptivePopupBody .islamic-radio-status:empty{display:none}
+#adaptivePopupBody .alert-settings h3{margin:18px 0 6px;font-size:1.05rem}
+#adaptivePopupBody .alert-settings fieldset{border:1px solid var(--cell-border,#888);border-radius:12px;margin:10px 0;padding:8px}
+#adaptivePopupBody .alert-settings legend{padding:0 6px}
+#adaptivePopupBody .alert-settings input[type="range"]{width:100%;padding:0;min-height:44px}
+#adaptivePopupBody .alert-settings input[type="checkbox"]{width:auto;display:inline-block;margin-inline-start:12px}
+#adaptivePopupBody .alert-settings button,
+#adaptivePopupBody .alert-settings select,
+#adaptivePopupBody .alert-settings input{min-height:44px}
+#adaptivePopupBody .alert-settings [hidden]{display:none!important}
+#adaptivePopupBody .alert-settings p[tabindex="-1"]:focus{outline:2px solid currentColor;outline-offset:3px}
+#adaptivePopupBody .islamic-radio-section :focus-visible,
+#adaptivePopupBody .alert-settings :focus-visible{outline:2px solid currentColor;outline-offset:2px}

islamic_radio.js

@@ -0,0 +1,222 @@
+/*
+ ساعة المسلم — ركن الإذاعات الإسلامية (نسخة تعمل كسكربت عادي، بدون export).
+ - مشغل واحد فقط: الإذاعة توقف القرآن والعكس (حدث muslim-clock-audio-start).
+ - الصوت يبقى شغالًا بعد إغلاق النافذة لأن عنصر الصوت خارجها.
+ - الأذان/التنبيهات تستدعي MuslimClockRadio.play(id) من alert_actions.js.
+*/
+(function () {
+  'use strict';
+  const base = new URL('.', document.currentScript.src);
+  let configPromise, audio = null, current = null, state = 'idle', loadTimer = null, stopTimer = null;
+  const listeners = new Set();
+  const node = (tag, text, cls) => { const n = document.createElement(tag); if (text != null) n.textContent = text; if (cls) n.className = cls; return n; };
+  const button = (text, action) => { const b = node('button', text); b.type = 'button'; b.addEventListener('click', action); return b; };
+  const fmt = (s, v) => String(s).replace(/\{(\w+)\}/g, (_, k) => String(v[k] ?? ''));
+
+  async function config() {
+    if (!configPromise) configPromise = (async () => {
+      const ctl = new AbortController(), t = setTimeout(() => ctl.abort(), 15000);
+      try {
+        const r = await fetch(new URL('islamic_radio_registry.json', base), { cache: 'no-store', signal: ctl.signal });
+        if (!r.ok) throw Error('islamic_radio_registry.json HTTP ' + r.status);
+        const c = await r.json();
+        if (c.version !== 1 || !c.ui || !Array.isArray(c.stations) || !c.stations.length) throw Error('Invalid radio registry');
+        for (const s of c.stations) if (!s.id || !s.name || !s.category) throw Error('Invalid station');
+        return c;
+      } finally { clearTimeout(t); }
+    })().catch(e => { configPromise = null; throw e; });
+    return configPromise;
+  }
+  const readFavs = key => { try { return new Set(JSON.parse(localStorage.getItem(key) || '[]')); } catch { return new Set(); } };
+  const writeFavs = (key, set) => { try { localStorage.setItem(key, JSON.stringify([...set])); return true; } catch { return false; } };
+  const emit = () => { for (const fn of [...listeners]) { try { fn(snapshot()); } catch { /* listener error */ } } };
+  const snapshot = () => ({ station: current, state });
+  const clearTimers = () => { clearTimeout(loadTimer); loadTimer = null; };
+
+  function ensureAudio() {
+    if (audio) return audio;
+    audio = document.createElement('audio');
+    audio.preload = 'none'; audio.setAttribute('playsinline', ''); audio.hidden = true;
+    // No crossOrigin: most radio streams send no CORS headers and would fail with it.
+    document.body.appendChild(audio);
+    const on = (name, fn) => audio.addEventListener(name, () => { if (current) fn(); });
+    on('playing', () => { clearTimers(); state = 'playing'; emit(); });
+    on('waiting', () => { if (state !== 'paused') { state = 'loading'; emit(); } });
+    on('pause', () => { if (state === 'playing' || state === 'loading') { state = 'paused'; emit(); } });
+    on('error', () => { clearTimers(); state = 'error'; emit(); });
+    return audio;
+  }
+  function releaseAudio() {
+    clearTimers(); clearTimeout(stopTimer); stopTimer = null;
+    current = null;
+    if (audio) { try { audio.pause(); } catch { /* ignore */ } audio.removeAttribute('src'); try { audio.load(); } catch { /* ignore */ } }
+  }
+  function mediaSession(c, station) {
+    if (!('mediaSession' in navigator) || typeof MediaMetadata === 'undefined') return;
+    try { navigator.mediaSession.metadata = new MediaMetadata({ title: station.name, artist: c.ui.media_artist, album: c.ui.media_album }); } catch { /* ignore */ }
+    for (const [name, fn] of [['play', () => resume()], ['pause', () => pause()], ['stop', () => stop()]]) {
+      try { navigator.mediaSession.setActionHandler(name, fn); } catch { /* unsupported action */ }
+    }
+  }
+  function streamOf(station) {
+    try { const u = new URL(station.streamUrl); return u.protocol === 'https:' ? u.href : null; } catch { return null; }
+  }
+  // opts.stopAfterMin: stop automatically (used by the adhan alert).
+  async function play(id, opts = {}) {
+    const c = await config();
+    const station = c.stations.find(s => s.id === id);
+    if (!station) return { ok: false, reason: 'missing' };
+    const url = station.streamUrl && streamOf(station);
+    if (!url) return { ok: false, reason: 'no_stream', station };
+    window.dispatchEvent(new CustomEvent('muslim-clock-audio-start', { detail: { source: 'radio' } }));
+    releaseAudio();
+    const a = ensureAudio();
+    current = station; state = 'loading'; a.src = url; mediaSession(c, station); emit();
+    loadTimer = setTimeout(() => { if (state === 'loading') { state = 'timeout'; emit(); } }, c.limits?.load_timeout_ms || 20000);
+    try {
+      await a.play();
+      const minutes = Number(opts.stopAfterMin);
+      if (minutes > 0) stopTimer = setTimeout(() => stop(), minutes * 60000);
+      return { ok: true, station };
+    } catch (error) {
+      clearTimers();
+      state = error?.name === 'NotAllowedError' ? 'blocked' : 'error'; emit();
+      return { ok: false, reason: state, station };
+    }
+  }
+  function stop() { const had = Boolean(current); releaseAudio(); state = had ? 'stopped' : 'idle'; emit(); }
+  function pause() { if (audio && current) { audio.pause(); state = 'paused'; emit(); } }
+  async function resume() {
+    if (!audio || !current) return false;
+    try { await audio.play(); return true; } catch { state = 'blocked'; emit(); return false; }
+  }
+  window.addEventListener('muslim-clock-audio-start', e => { if (e.detail?.source !== 'radio' && current) stop(); });
+
+  function panel(title, root, back, ui) {
+    RegistryApp.openPanel('worship', { title, compact: true }, () => {
+      document.getElementById('adaptivePopupBody').append(root);
+      if (back) document.getElementById('adaptivePopupActions').append(button(ui.back, back));
+    });
+    document.getElementById('adaptivePopupCard').dataset.size = 'long';
+  }
+
+  async function open(options = {}) {
+    let c;
+    try { c = await config(); }
+    catch (error) {
+      const root = node('div', 'islamic_radio_registry.json: ' + error.message);
+      root.append(button('↻', () => open(options)));
+      panel('islamic_radio_registry.json', root, options.back, { back: '←' });
+      return;
+    }
+    const ui = c.ui, root = node('div', null, 'islamic-radio-section');
+    const status = node('p', null, 'islamic-radio-status'); status.setAttribute('role', 'status'); status.setAttribute('aria-live', 'polite');
+    const nowBox = node('section', null, 'islamic-radio-player'); nowBox.setAttribute('aria-label', ui.title);
+    const nowText = node('p', null, 'islamic-radio-now');
+    const toggle = button(ui.pause, () => { state === 'paused' || state === 'blocked' ? resume() : pause(); });
+    const stopBtn = button(ui.stop, () => stop());
+    nowBox.append(nowText, toggle, stopBtn);
+    const categoryLabel = node('label', ui.category), category = node('select');
+    for (const [value, text] of [['', ui.all], ...Object.entries(c.categories || {})]) { const o = node('option', text); o.value = value; category.append(o); }
+    categoryLabel.append(category);
+    const listHost = node('ul', null, 'islamic-radio-list'); listHost.setAttribute('aria-label', ui.list_label);
+    const alertsApi = window.MuslimClockAlerts;
+    const favKey = c.storage?.favorites_key || 'muslim_clock_radio_favorites_v1';
+    let favs = readFavs(favKey);
+
+    function stateText() {
+      const name = current?.name || '';
+      switch (state) {
+        case 'loading': return ui.state_loading;
+        case 'playing': return fmt(ui.state_playing, { name });
+        case 'paused': return ui.state_paused;
+        case 'stopped': return ui.state_stopped;
+        case 'blocked': return ui.state_blocked;
+        case 'error': return ui.state_error;
+        case 'timeout': return ui.state_timeout;
+        default: return ui.idle;
+      }
+    }
+    function refresh() {
+      const text = stateText();
+      if (nowText.textContent !== text) { nowText.textContent = text; status.textContent = text; }
+      const active = Boolean(current) && state !== 'stopped';
+      nowBox.hidden = !active; toggle.hidden = stopBtn.hidden = !active;
+      toggle.textContent = ['paused', 'blocked'].includes(state) ? ui.resume : ui.pause;
+      for (const row of listHost.querySelectorAll('li')) {
+        const on = active && current.id === row.dataset.id && ['playing', 'loading'].includes(state);
+        row.classList.toggle('is-playing', on);
+        const b = row.querySelector('.islamic-radio-play');
+        if (b && !b.dataset.external) b.setAttribute('aria-label', (on ? ui.playing_row + ' — ' : ui.play + ' ') + row.dataset.name);
+      }
+    }
+    function paintList(focusId) {
+      favs = readFavs(favKey);
+      const chosen = alertsApi?.getAdhanStation?.();
+      const rows = c.stations.filter(s => !category.value || s.category === category.value)
+        .sort((a, b) => Number(favs.has(b.id)) - Number(favs.has(a.id)));
+      listHost.replaceChildren();
+      for (const s of rows) {
+        const li = node('li', null, 'islamic-radio-station'); li.dataset.id = s.id; li.dataset.name = s.name;
+        const hasStream = Boolean(s.streamUrl && streamOf(s));
+        const play = node('button', null, 'islamic-radio-play'); play.type = 'button';
+        play.append(node('span', s.name, 'islamic-radio-name'));
+        if (hasStream) {
+          play.append(node('span', c.categories?.[s.category] || '', 'islamic-radio-meta'));
+          play.setAttribute('aria-label', ui.play + ' ' + s.name);
+          play.addEventListener('click', async () => { const r = await play_(s.id); if (!r.ok && r.reason === 'no_stream') window.open(s.officialUrl, '_blank', 'noopener'); });
+        } else {
+          play.append(node('span', ui.no_stream_hint, 'islamic-radio-meta'));
+          play.dataset.external = '1'; play.setAttribute('aria-label', ui.external + ' — ' + s.name + ' — ' + ui.no_stream_hint);
+          play.addEventListener('click', () => { if (s.officialUrl) window.open(s.officialUrl, '_blank', 'noopener'); });
+        }
+        const pin = node('button', favs.has(s.id) ? '⭐' : '☆', 'islamic-radio-favorite'); pin.type = 'button'; pin.id = 'radio-pin-' + s.id;
+        pin.setAttribute('aria-pressed', String(favs.has(s.id)));
+        pin.setAttribute('aria-label', fmt(favs.has(s.id) ? ui.unpin : ui.pin, { name: s.name }));
+        pin.addEventListener('click', () => {
+          const set = readFavs(favKey), was = set.has(s.id); was ? set.delete(s.id) : set.add(s.id);
+          if (!writeFavs(favKey, set)) { status.textContent = ui.storage_error; return; }
+          paintList(s.id); status.textContent = fmt(was ? ui.unpinned : ui.pinned, { name: s.name });
+        });
+        li.append(play, pin);
+        if (alertsApi?.setAdhanStation) {
+          const isChosen = chosen === s.id;
+          const mark = node('button', isChosen ? ui.alert_station_selected : ui.alert_station, 'islamic-radio-alert'); mark.type = 'button';
+          mark.setAttribute('aria-pressed', String(isChosen)); mark.setAttribute('aria-label', ui.alert_station + ' — ' + s.name + (isChosen ? ' — ✓' : ''));
+          mark.addEventListener('click', () => { alertsApi.setAdhanStation(s.id); paintList(s.id); status.textContent = fmt(ui.alert_station_set, { name: s.name }); });
+          li.append(mark);
+        }
+        listHost.append(li);
+      }
+      refresh();
+      if (focusId) document.getElementById('radio-pin-' + focusId)?.focus();
+    }
+    const play_ = id => play(id);
+    category.addEventListener('change', () => paintList());
+    root.append(node('p', ui.pinned_note, 'quran-meta'), node('p', ui.single_note, 'quran-meta'), status, nowBox, categoryLabel, listHost, node('p', ui.background_note, 'quran-meta'));
+    if (alertsApi?.openSettings) root.append(button(ui.alert_settings, () => alertsApi.openSettings({ back: () => open(options) })));
+    panel(ui.title, root, options.back, ui);
+    const off = fn => { listeners.delete(fn); };
+    const listener = () => { if (!root.isConnected) { off(listener); return; } refresh(); };
+    listeners.add(listener);
+    window.addEventListener('muslim-clock-popup-leave', () => off(listener), { once: true });
+    paintList();
+  }
+
+  async function mountEntry(parent, back) {
+    const entry = button('…', () => {}); entry.disabled = true; entry.dataset.radioEntry = '1'; parent.append(entry);
+    try {
+      const c = await config(); if (!entry.isConnected) return;
+      entry.textContent = c.ui.open; entry.disabled = false; entry.onclick = () => open({ back });
+    } catch (error) {
+      if (!entry.isConnected) return;
+      entry.textContent = 'islamic_radio_registry.json: ' + error.message; entry.disabled = false;
+      entry.onclick = () => { entry.remove(); mountEntry(parent, back); };
+    }
+  }
+  window.MuslimClockRadio = Object.freeze({
+    open, mountEntry, play, stop, pause, resume, snapshot,
+    stations: async () => (await config()).stations,
+    onChange: fn => { listeners.add(fn); return () => listeners.delete(fn); }
+  });
+})();

islamic_radio_registry.json

@@ -64,5 +64,58 @@
       "officialUrl": "https://radioyaqeen.com/en",
       "streamUrl": ""
     }
-  ]
+  ],
+  "limits": {
+    "load_timeout_ms": 20000
+  },
+  "ui": {
+    "title": "الإذاعات الإسلامية",
+    "open": "📻 الإذاعات الإسلامية",
+    "loading": "جارٍ تحميل الإذاعات…",
+    "load_error": "تعذّر تحميل قائمة الإذاعات.",
+    "retry": "إعادة المحاولة",
+    "back": "رجوع",
+    "category": "التصنيف",
+    "all": "كل الإذاعات",
+    "list_label": "قائمة الإذاعات",
+    "pinned_note": "الإذاعات المثبتة ⭐ تظهر أولًا. التثبيت محفوظ على هذا الجهاز فقط.",
+    "single_note": "تشغيل الإذاعة يوقف التلاوة القرآنية، وتشغيل التلاوة يوقف الإذاعة.",
+    "background_note": "قد يتوقف الصوت عند إطفاء الشاشة أو إغلاق المتصفح؛ هذا يعتمد على المتصفح أو التطبيق.",
+    "play": "تشغيل",
+    "pause": "إيقاف مؤقت",
+    "resume": "استكمال",
+    "stop": "إيقاف الإذاعة",
+    "playing_row": "يعمل الآن",
+    "external": "فتح موقع الإذاعة ↗",
+    "no_stream_hint": "لا يتوفر بث مباشر مضمون؛ يفتح الموقع الرسمي",
+    "now_playing": "الإذاعة الحالية: {name}",
+    "idle": "لا توجد إذاعة قيد التشغيل.",
+    "state_loading": "جارٍ الاتصال بالإذاعة…",
+    "state_playing": "تُبثّ الآن: {name}",
+    "state_paused": "الإذاعة متوقفة مؤقتًا.",
+    "state_stopped": "توقفت الإذاعة.",
+    "state_blocked": "اضغط تشغيل لبدء الصوت؛ المتصفح يحتاج ضغطة منك.",
+    "state_error": "تعذّر تشغيل البث. جرّب إذاعة أخرى أو افتح موقع الإذاعة.",
+    "state_timeout": "تأخر الاتصال بالإذاعة. جرّب إذاعة أخرى أو افتح موقع الإذاعة.",
+    "pin": "تثبيت {name}",
+    "unpin": "إلغاء تثبيت {name}",
+    "pinned": "ثُبّتت {name}.",
+    "unpinned": "أُلغي تثبيت {name}.",
+    "alert_station": "اجعلها إذاعة الأذان",
+    "alert_station_selected": "إذاعة الأذان ✓",
+    "alert_station_set": "أصبحت {name} إذاعة تنبيه الأذان.",
+    "alert_settings": "إعدادات التنبيه: النغمات وفتح الإذاعة وقت الأذان",
+    "storage_error": "تعذّر الحفظ على هذا الجهاز.",
+    "media_artist": "ساعة المسلم",
+    "media_album": "الإذاعات الإسلامية"
+  },
+  "categories": {
+    "quran": "القرآن الكريم",
+    "seerah_history": "السيرة والتاريخ",
+    "faith_hadith_history": "الحديث والمحتوى الإيماني",
+    "other": "أخرى"
+  },
+  "storage": {
+    "favorites_key": "muslim_clock_radio_favorites_v1"
+  }
 }

quran_audio.js

@@ -12,6 +12,32 @@
     const node = element('button', label); node.type = 'button'; node.addEventListener('click', action); return node;
   };
   const interpolate = (text, values) => text.replace(/\{(\w+)\}/g, (_, key) => String(values[key] ?? ''));
+  // Optional: add reciters published in EveryAyah's catalog. Never blocks or breaks the built-in list.
+  async function mergeCatalog(c) {
+    const key = c.storage_key + '_catalog', ttl = (c.source.catalog_ttl_hours || 168) * 3600000;
+    let rows = null;
+    try {const cached = JSON.parse(localStorage.getItem(key)); if (cached && Date.now() - cached.at < ttl && Array.isArray(cached.rows)) rows = cached.rows;} catch { /* optional */ }
+    if (!rows && c.source.catalog_url) {
+      const controller = new AbortController(), timer = setTimeout(() => controller.abort(), 6000);
+      try {
+        const response = await fetch(c.source.catalog_url, {signal:controller.signal});
+        if (response.ok) {
+          const raw = JSON.parse(await response.text());
+          rows = Object.values(raw).filter(v => v && typeof v === 'object' && typeof v.subfolder === 'string' && /^[A-Za-z0-9_.\/-]+$/.test(v.subfolder))
+            .map(v => ({name: String(v.name || v.subfolder), folder: v.subfolder}));
+          try {localStorage.setItem(key, JSON.stringify({at: Date.now(), rows}));} catch { /* optional */ }
+        }
+      } catch { /* offline or blocked by CORS: keep the built-in list */ }
+      finally {clearTimeout(timer);}
+    }
+    if (!rows) return;
+    const known = new Set(c.reciters.map(r => r.folder));
+    for (const row of rows) {
+      if (known.has(row.folder)) continue;
+      known.add(row.folder);
+      c.reciters.push({id: 'ea_' + row.folder.replace(/[^A-Za-z0-9]/g, '_'), name: row.name + ' ' + (c.ui.catalog_added || ''), folder: row.folder});
+    }
+  }
   async function configuration() {
     if (!configPromise) configPromise = (async () => {
       const controller = new AbortController(), timer = setTimeout(() => controller.abort(), 15000);
@@ -21,8 +47,9 @@
         const c = await response.json();
         if (c.schema_version !== 1 || !Array.isArray(c.reciters) || !c.reciters.length || !c.ui || !c.defaults ||
           !Array.isArray(c.rates) || !c.repeat_options?.length || !c.limits?.loading_timeout_ms) throw Error('Invalid audio registry');
-        for (const r of c.reciters) if (!r.id || !r.name || !/^[A-Za-z0-9_.-]+$/.test(r.folder)) throw Error('Invalid reciter');
+        for (const r of c.reciters) if (!r.id || !r.name || !/^[A-Za-z0-9_.\/-]+$/.test(r.folder)) throw Error('Invalid reciter');
         if (!c.reciters.some(r => r.id === c.defaults.reciter)) throw Error('Missing default reciter');
+        await mergeCatalog(c);
         for (const key of ['title','options','reciter','rate','repeat','advance','play','pause','resume','stop','previous','next','seek',
           'current','idle','loading','playing','paused','stopped','ended','error','blocked','storage_error','source','play_continuous']) {
           if (typeof c.ui[key] !== 'string') throw Error('Missing audio UI: ' + key);
@@ -76,6 +103,8 @@
       if (disposed) return;
       const activeMedia = media, request = ++playRequest;
       wantsPlay = true; phase = 'loading'; watchLoading(); emit();
+      // One audio source at a time: tell the radio to stop.
+      try {window.dispatchEvent(new CustomEvent('muslim-clock-audio-start', {detail:{source:'quran'}}));} catch { /* ignore */ }
       try { await activeMedia.play(); }
       catch (error) {
         if (!disposed && activeMedia === media && request === playRequest && wantsPlay) fail(error.name === 'NotAllowedError' ? 'blocked' : 'error');
@@ -131,6 +160,8 @@
       });
       try {activeMedia.src = urlFor(verses[index]); startMedia();} catch {fail();}
     }
+    const onOtherSource = event => {if (event.detail?.source !== 'quran' && (wantsPlay || pending)) pause();};
+    window.addEventListener('muslim-clock-audio-start', onOtherSource);
     function select(id) {
       if (disposed || !byId.has(id) || verses[index].id === id) return;
       detach(); index = byId.get(id); phase = 'idle'; currentTime = 0; duration = 0; emit();
@@ -174,7 +205,7 @@
       playContinuous: () => {configure({advance:true,repeat:1});playAt(verses[index].id);},
       previous: () => {if (index > 0) playAt(verses[index - 1].id);},
       next: () => {if (index < lastIndex) playAt(verses[index + 1].id);},
-      dispose: () => {disposed = true;detach(true);}};
+      dispose: () => {disposed = true;window.removeEventListener('muslim-clock-audio-start', onOtherSource);detach(true);}};
   }
   async function mount(host, {verses, surahs, initialId, endId, onState, isActive = () => host.isConnected}) {
     const c = await configuration();

quran_audio_registry.json

@@ -8,7 +8,9 @@
     "url_pattern": "https://everyayah.com/data/{folder}/{surah3}{ayah3}.mp3",
     "checked_on": "2026-09-29",
     "delivery": "remote_stream_on_user_play",
-    "note": "Verse filenames use three digits for the surah and three for the ayah. Recordings are linked, not redistributed or licensed as part of AL-Khatma."
+    "note": "Verse filenames use three digits for the surah and three for the ayah. Recordings are linked, not redistributed or licensed as part of AL-Khatma.",
+    "catalog_ttl_hours": 168,
+    "catalog_note": "القائمة مأخوذة من فهرس EveryAyah. شغّل tools/verify_reciters.py للتحقق من وجود كل مجلد وحذف ما لا يعمل."
   },
   "reciters": [
     {
@@ -16,20 +18,85 @@
       "name": "محمود خليل الحصري",
       "folder": "Husary_128kbps"
     },
+    {
+      "id": "husary_mujawwad",
+      "name": "محمود خليل الحصري — مجوّد",
+      "folder": "Husary_Mujawwad_128kbps"
+    },
+    {
+      "id": "husary_muallim",
+      "name": "محمود خليل الحصري — المعلّم",
+      "folder": "Husary_Muallim_128kbps"
+    },
     {
       "id": "minshawy",
-      "name": "محمد صديق المنشاوي",
+      "name": "محمد صديق المنشاوي — مرتل",
       "folder": "Minshawy_Murattal_128kbps"
     },
+    {
+      "id": "minshawy_mujawwad",
+      "name": "محمد صديق المنشاوي — مجوّد",
+      "folder": "Minshawy_Mujawwad_192kbps"
+    },
+    {
+      "id": "minshawy_teacher",
+      "name": "محمد صديق المنشاوي — المعلّم",
+      "folder": "Minshawy_Teacher_128kbps"
+    },
     {
       "id": "abdulbasit",
       "name": "عبد الباسط عبد الصمد — مرتل",
       "folder": "Abdul_Basit_Murattal_192kbps"
     },
     {
-      "id": "sudais",
-      "name": "عبد الرحمن السديس",
-      "folder": "Abdurrahmaan_As-Sudais_192kbps"
+      "id": "abdulbasit_mujawwad",
+      "name": "عبد الباسط عبد الصمد — مجوّد",
+      "folder": "Abdul_Basit_Mujawwad_128kbps"
+    },
+    {
+      "id": "shatri",
+      "name": "أبو بكر الشاطري",
+      "folder": "Abu_Bakr_Ash-Shaatree_128kbps"
+    },
+    {
+      "id": "ajamy",
+      "name": "أحمد بن علي العجمي",
+      "folder": "Ahmed_ibn_Ali_al-Ajamy_128kbps_ketaballah.net"
+    },
+    {
+      "id": "ahmed_neana_128kbps",
+      "name": "أحمد نعينع",
+      "folder": "Ahmed_Neana_128kbps"
+    },
+    {
+      "id": "sowaid",
+      "name": "أيمن سويد",
+      "folder": "Ayman_Sowaid_64kbps"
+    },
+    {
+      "id": "akhdar",
+      "name": "إبراهيم الأخضر",
+      "folder": "Ibrahim_Akhdar_32kbps"
+    },
+    {
+      "id": "warsh_dosary",
+      "name": "إبراهيم الدوسري — رواية ورش",
+      "folder": "warsh/warsh_ibrahim_aldosary_128kbps"
+    },
+    {
+      "id": "khaalid_abdullaah_al_qahtaanee_192kbps",
+      "name": "خالد عبد الله القحطاني",
+      "folder": "Khaalid_Abdullaah_al-Qahtaanee_192kbps"
+    },
+    {
+      "id": "tunaiji",
+      "name": "خليفة الطنيجي",
+      "folder": "Khalefa_Al_Tunaiji_64kbps"
+    },
+    {
+      "id": "ghamadi",
+      "name": "سعد الغامدي",
+      "folder": "Ghamadi_40kbps"
     },
     {
       "id": "shuraym",
@@ -37,19 +104,134 @@
       "folder": "Saood_ash-Shuraym_128kbps"
     },
     {
-      "id": "maher",
-      "name": "ماهر المعيقلي",
-      "folder": "MaherAlMuaiqly128kbps"
+      "id": "sahl",
+      "name": "سهل ياسين",
+      "folder": "Sahl_Yassin_128kbps"
+    },
+    {
+      "id": "budair",
+      "name": "صلاح البدير",
+      "folder": "Salah_Al_Budair_128kbps"
+    },
+    {
+      "id": "bukhatir",
+      "name": "صلاح بوخاطر",
+      "folder": "Salaah_AbdulRahman_Bukhatir_128kbps"
+    },
+    {
+      "id": "sudais",
+      "name": "عبد الرحمن السديس",
+      "folder": "Abdurrahmaan_As-Sudais_192kbps"
+    },
+    {
+      "id": "basfar",
+      "name": "عبد الله بصفر",
+      "folder": "Abdullah_Basfar_192kbps"
+    },
+    {
+      "id": "juhany",
+      "name": "عبد الله عواد الجهني",
+      "folder": "Abdullaah_3awwaad_Al-Juhaynee_128kbps"
+    },
+    {
+      "id": "matroud",
+      "name": "عبد الله مطرود",
+      "folder": "Abdullah_Matroud_128kbps"
     },
     {
       "id": "hudhaify",
       "name": "علي الحذيفي",
       "folder": "Hudhaify_128kbps"
     },
+    {
+      "id": "ali_jaber",
+      "name": "علي جابر",
+      "folder": "Ali_Jaber_64kbps"
+    },
+    {
+      "id": "hajjaj",
+      "name": "علي حجاج السويسي",
+      "folder": "Ali_Hajjaj_AlSuesy_128kbps"
+    },
+    {
+      "id": "fares",
+      "name": "فارس عباد",
+      "folder": "Fares_Abbad_64kbps"
+    },
+    {
+      "id": "karim_mansoori_40kbps",
+      "name": "كريم منصوري",
+      "folder": "Karim_Mansoori_40kbps"
+    },
+    {
+      "id": "maher",
+      "name": "ماهر المعيقلي",
+      "folder": "MaherAlMuaiqly128kbps"
+    },
+    {
+      "id": "qasim",
+      "name": "محسن القاسم",
+      "folder": "Muhsin_Al_Qasim_192kbps"
+    },
+    {
+      "id": "ayyoub",
+      "name": "محمد أيوب",
+      "folder": "Muhammad_Ayyoub_128kbps"
+    },
+    {
+      "id": "tablawi",
+      "name": "محمد الطبلاوي",
+      "folder": "Mohammad_al_Tablaway_128kbps"
+    },
+    {
+      "id": "jibreel",
+      "name": "محمد جبريل",
+      "folder": "Muhammad_Jibreel_128kbps"
+    },
+    {
+      "id": "muhammad_abdulkareem_128kbps",
+      "name": "محمد عبد الكريم",
+      "folder": "Muhammad_AbdulKareem_128kbps"
+    },
+    {
+      "id": "alafasy",
+      "name": "مشاري العفاسي",
+      "folder": "Alafasy_128kbps"
+    },
+    {
+      "id": "mustafa_ismail",
+      "name": "مصطفى إسماعيل",
+      "folder": "Mustafa_Ismail_48kbps"
+    },
+    {
+      "id": "qatami",
+      "name": "ناصر القطامي",
+      "folder": "Nasser_Alqatami_128kbps"
+    },
+    {
+      "id": "nabil",
+      "name": "نبيل الرفاعي",
+      "folder": "Nabil_Rifa3i_48kbps"
+    },
+    {
+      "id": "rifai",
+      "name": "هاني الرفاعي",
+      "folder": "Hani_Rifai_192kbps"
+    },
     {
       "id": "dussary",
       "name": "ياسر الدوسري",
       "folder": "Yasser_Ad-Dussary_128kbps"
+    },
+    {
+      "id": "yaser_salamah_128kbps",
+      "name": "ياسر سلامة",
+      "folder": "Yaser_Salamah_128kbps"
+    },
+    {
+      "id": "warsh_yassin",
+      "name": "ياسين الجزائري — رواية ورش",
+      "folder": "warsh/warsh_yassin_al_jazaery_64kbps"
     }
   ],
   "defaults": {
@@ -117,7 +299,9 @@
     "blocked": "اضغط تشغيل لاستكمال التلاوة؛ المتصفح يحتاج ضغطة منك.",
     "storage_error": "تعذّر حفظ تفضيلات الصوت على هذا الجهاز.",
     "source": "مصدر التلاوة: EveryAyah",
-    "gap": "الفاصل بين الآيات"
+    "gap": "الفاصل بين الآيات",
+    "catalog_added": "(من فهرس EveryAyah)",
+    "reciter_missing": "تعذّر تشغيل هذا القارئ لهذه الآية؛ جرّب قارئًا آخر."
   },
   "gap_options": [
     {

quran_reader_registry.json

@@ -116,8 +116,38 @@
   },
   "tafsirs": [
     {
-      "id": "quran_com_tafsir",
-      "name": "التفسير (Quran.com) — يفتح على هذه الآية",
+      "id": "tabari",
+      "name": "تفسير الطبري (جامع البيان)",
+      "url": "https://quran.com/{surah}:{ayah}/tafsirs/ar-tafsir-al-tabari"
+    },
+    {
+      "id": "ibn_kathir",
+      "name": "تفسير ابن كثير",
+      "url": "https://quran.com/{surah}:{ayah}/tafsirs/ar-tafsir-ibn-kathir"
+    },
+    {
+      "id": "saadi",
+      "name": "تفسير السعدي (تيسير الكريم الرحمن)",
+      "url": "https://quran.com/{surah}:{ayah}/tafsirs/ar-tafseer-al-saddi"
+    },
+    {
+      "id": "muyassar",
+      "name": "التفسير الميسر",
+      "url": "https://quran.com/{surah}:{ayah}/tafsirs/ar-tafsir-muyassar"
+    },
+    {
+      "id": "qurtubi",
+      "name": "تفسير القرطبي",
+      "url": "https://quran.com/{surah}:{ayah}/tafsirs/ar-tafseer-al-qurtubi"
+    },
+    {
+      "id": "baghawi",
+      "name": "تفسير البغوي (معالم التنزيل)",
+      "url": "https://quran.com/{surah}:{ayah}/tafsirs/ar-tafsir-al-baghawi"
+    },
+    {
+      "id": "all",
+      "name": "كل التفاسير لهذه الآية (Quran.com)",
       "url": "https://quran.com/{surah}:{ayah}/tafsirs"
     }
   ],

registry_app.js

@@ -50,7 +50,11 @@ const RegistryApp = (() => {
  function close(){ window.dispatchEvent(new Event('muslim-clock-popup-leave')); $('adaptivePopup').hidden=true;document.body.style.overflow='';lastFocus?.focus(); }
  function back(fn){$('adaptivePopupActions').appendChild(button(ui.back,fn));}
  function home(kind){show(kind,{title:screen(kind).title,text:ui.catalogue},()=>{
-  screen(kind).groups.forEach(group=>$('adaptivePopupBody').appendChild(button(ui.groupTitles[group],()=>list(kind,group))));
+  screen(kind).groups.forEach(group=>{
+   $('adaptivePopupBody').appendChild(button(ui.groupTitles[group],()=>list(kind,group)));
+   // Radio corner sits right after the Quran corner, opened the same way.
+   if(group==='quran'&&window.MuslimClockRadio)window.MuslimClockRadio.mountEntry($('adaptivePopupBody'),()=>home(kind));
+  });
  });}
  function records(group){
   switch(group){
@@ -522,7 +526,7 @@ const RegistryApp = (() => {
  function tickSolar(){
   if(lastSolarDay!==dateKey(Date.now())){recalculate();return;}
   const now=Date.now();updateCurrentMarker(now);
-  tickNotices(now);
+  tickNotices(now);tickAdhan(now);
   const status=$('solarStatus');
   if(!observer){status.textContent=ui.chooseLocation;return;}
   if(!profile()){status.textContent=ui.missingSolar;return;}
@@ -559,6 +563,18 @@ const RegistryApp = (() => {
   timedNotices.sort((a,b)=>a.at-b.at||b.priority-a.priority);
   for(const [key,pending] of pendingTimedNotices)if(!timedNotices.some(n=>n.key===key&&n.at===pending.at))pendingTimedNotices.delete(key);
  }
+ // Prayer-time (adhan) alert: tone or the user's chosen radio station. Settings live in alert_actions.js.
+ function tickAdhan(now){
+  const A=window.MuslimClockAlerts;if(!A||!A.adhanEnabled())return;
+  const ledger=getSaved('clock_adhan_fired_v1',{});let changed=false;
+  for(const p of prayerEntries()){
+   if(now<p.start||now-p.start>90000||!A.shouldFire(p.id))continue;
+   const key=p.id+':'+p.start;if(ledger[key])continue;
+   ledger[key]=now;changed=true;A.fire({id:p.id,title:ruleTitle(p.rule),time:timeText(p.start)});
+  }
+  if(changed){for(const k of Object.keys(ledger))if(now-ledger[k]>86400000)delete ledger[k];save('clock_adhan_fired_v1',ledger);}
+ }
+ function adhanPrayers(){const ids=visual?.runtime_styles?.prayer_entry_markers?.rule_ids||[];return ids.map(id=>({id,title:ruleTitle(rule(id)||{id})}));}
  function tickNotices(now){
   const runtime=profile()?.notice_runtime;if(!runtime)return;
   const ledger=getSaved('clock_popup_impressions_v1',{});
@@ -581,7 +597,7 @@ const RegistryApp = (() => {
 
  let personal=null,personalReady=false,reminderAudio=null,notificationRegistration=null,personalNoticeKeys=new Set();
  async function enableReminderSound(){try{const Audio=window.AudioContext||window.webkitAudioContext;if(!Audio)return false;if(!reminderAudio)reminderAudio=new Audio();await reminderAudio.resume();return reminderAudio.state==='running';}catch{return false;}}
- async function playReminderSound(){if(!reminderAudio||!visual.reminder_audio)return false;try{if(reminderAudio.state!=='running')await reminderAudio.resume();if(reminderAudio.state!=='running')return false;const a=visual.reminder_audio,o=reminderAudio.createOscillator(),g=reminderAudio.createGain();o.frequency.value=a.frequency_hz;g.gain.value=a.gain;o.connect(g);g.connect(reminderAudio.destination);o.start();g.gain.exponentialRampToValueAtTime(0.001,reminderAudio.currentTime+a.duration_seconds);o.stop(reminderAudio.currentTime+a.duration_seconds);return true;}catch{return false;}}
+ async function playReminderSound(){try{if(window.MuslimClockAlerts?.hasCustomTone('general')&&await window.MuslimClockAlerts.playTone('general'))return true;}catch{}if(!reminderAudio||!visual.reminder_audio)return false;try{if(reminderAudio.state!=='running')await reminderAudio.resume();if(reminderAudio.state!=='running')return false;const a=visual.reminder_audio,o=reminderAudio.createOscillator(),g=reminderAudio.createGain();o.frequency.value=a.frequency_hz;g.gain.value=a.gain;o.connect(g);g.connect(reminderAudio.destination);o.start();g.gain.exponentialRampToValueAtTime(0.001,reminderAudio.currentTime+a.duration_seconds);o.stop(reminderAudio.currentTime+a.duration_seconds);return true;}catch{return false;}}
  async function initNotifications(){
   if(window.isSecureContext!==true||!('serviceWorker' in navigator))return null;
   try{notificationRegistration=await navigator.serviceWorker.register('./sw.js');navigator.serviceWorker.addEventListener('message',e=>openNotificationData(e.data));return notificationRegistration;}catch{return null;}
@@ -691,6 +707,7 @@ const RegistryApp = (() => {
  }
  function reminderSettings(){const s=reminderAction(()=>personal.read());if(!s)return;show('worship',{title:ru().settings,text:ru().scope},()=>{
   window.MuslimClockQuran?.mountSettingsEntry($('adaptivePopupBody'),reminderSettings);
+  window.MuslimClockAlerts?.mountSettingsEntry($('adaptivePopupBody'),reminderSettings);
   const sound=reminderField(ru().sound,'checkbox','');sound.checked=s.settings.sound_enabled===true;
   $('adaptivePopupBody').appendChild(button(ru().enableAlerts,async()=>{const result=await requestAlertPermission();if(result.permission==='denied')para(ru().notificationDenied);else if(result.sound&&result.permission==='granted')para(ru().alertsReady);else if(result.permission==='unsupported')para(ru().notificationUnavailable);else para(ru().alertsPartlyReady);}));
   $('adaptivePopupBody').appendChild(button(ru().testSound,async()=>{if(await enableReminderSound())playReminderSound();else para(ru().soundUnavailable);}));para(ru().closedBrowserNote);
@@ -806,7 +823,7 @@ const RegistryApp = (() => {
    }
   });
  }
- return {openPanel:show,start,home,close,qiblaSettings,celestialRegistry:()=>registry('sky_simulation'),records,detail,boundaryInfo,ruleText,remindersHome,reminderChoose,reminderForm,reminderDetail,reminderSettings,prayerEntries,indicatorState,twelveHourLabel,hourDetails,hourSettings,periodDetails,recalculate,configureLocation,tickPersonal,calendarText,applyPrayerMethod,solarState:()=>({observer,madhhab,solarDays,solarPeriods}),resolveLegacy(id){return registry('religious_content').legacy_rule_map.find(x=>x.legacy_id===id);}};
+ return {openPanel:show,start,home,close,notifySystem,adhanPrayers,ruleTitle,qiblaSettings,celestialRegistry:()=>registry('sky_simulation'),records,detail,boundaryInfo,ruleText,remindersHome,reminderChoose,reminderForm,reminderDetail,reminderSettings,prayerEntries,indicatorState,twelveHourLabel,hourDetails,hourSettings,periodDetails,recalculate,configureLocation,tickPersonal,calendarText,applyPrayerMethod,solarState:()=>({observer,madhhab,solarDays,solarPeriods}),resolveLegacy(id){return registry('religious_content').legacy_rule_map.find(x=>x.legacy_id===id);}};
 })();
 window.PopupManager={open:(kind)=>RegistryApp.home(kind),close:()=>RegistryApp.close()};
 window.registryReady=RegistryApp.start();