Upload 8 files

astronomy_events_registry.json

@@ -14,7 +14,14 @@
     "dismiss_behavior": "current_trigger_only",
     "completion_tracking": false,
     "max_popup_per_event_phase": 1,
-    "image_fallback": "assets/astronomy/default_space.webp"
+    "image_fallback": "assets/astronomy/default_space.webp",
+    "eclipse_scan": {
+      "note": "حدود بحث الكسوف والخسوف في worship_event_engine. لا قيم افتراضية داخل الكود.",
+      "max_occurrences": 8,
+      "lookback_days": 1,
+      "cache_limit": 4,
+      "epsilon_ms": 1000
+    }
   },
   "source_strategy": {
     "primary_engine": {
@@ -67,7 +74,8 @@
             "peak",
             "end"
           ],
-          "match": "any"
+          "match": "any",
+          "altitude_reference": "geometric_center"
         },
         "fiqh_note": "نافذة الصلاة وحكم وقتها (ومنه علاقتها بأوقات النهي) تُقرأ من fiqh_time_registry/worship_fiqh_registry لا من هذا الملف"
       },
@@ -150,7 +158,8 @@
             "peak",
             "end"
           ],
-          "match": "any"
+          "match": "any",
+          "altitude_reference": "geometric_center"
         },
         "fiqh_note": "نافذة الصلاة وحكم وقتها تُقرأ من fiqh_time_registry/worship_fiqh_registry لا من هذا الملف"
       },
@@ -314,15 +323,16 @@
       "triggers": [
         {
           "id": "sunset_check",
-          "when": "event_day",
-          "timing_authority": "engine",
-          "hijri_day_in": [
-            29,
-            30
-          ],
-          "at": {
+          "when": "anchor",
+          "anchor": {
             "event": "maghrib",
             "offset_minutes": 0
+          },
+          "condition": {
+            "hijri_day_in": [
+              29,
+              30
+            ]
           }
         }
       ],
@@ -586,8 +596,7 @@
     "v1_1: توحيد last_quarter مع محرك المحاكاة (كان third_quarter)",
     "v1_1: category_controls: الكسوف والخسوف دائمًا فعّالان، وبقية الفئات يستطيع المستخدم إيقافها",
     "v1_1: إضافة crescent_visibility وmoonrise_moonset",
-    "v1_2: تصحيح مشغّل crescent_visibility إلى مفردات المشغّلات القائمة (event_day) مع شرط هجري",
-    "v1_2: engine_limits: أرقام البحث عن الكسوف والخسوف انتقلت من worship_event_engine.js"
+    "v1_2: defaults.eclipse_scan (كانت أرقام داخل المحرك)، وتوحيد مرجع الارتفاع geometric_center مع Astronomy.SearchAltitude"
   ],
   "category_controls": {
     "note": "الكسوف والخسوف دائمًا فعّالان لارتباطهما بعبادة. الفئات الأخرى معلومات يستطيع المستخدم إيقافها.",
@@ -606,13 +615,5 @@
     "planetary": {
       "user_can_disable": true
     }
-  },
-  "engine_limits": {
-    "eclipse_lookback_days": 1,
-    "eclipse_peak_lookahead_days": 1,
-    "eclipse_max_occurrences": 8,
-    "eclipse_cache_entries": 4,
-    "visibility_epsilon_ms": 1000,
-    "default_visibility_min_altitude_deg": 0
   }
 }

fiqh_time_registry.json

@@ -1,725 +1,717 @@
 {
-  "schema_name": "islamic_clock_fiqh_time_registry",
-  "schema_version": "1.6.0",
-  "registry_id": "fiqh_time_registry",
-  "project": "الساعة الإسلامية / الخط الزمني الروحي",
-  "language": "ar",
-  "rtl": true,
-  "status": "time_boundaries_registry",
-  "purpose": "تعريف محطات وحدود الزمن التي تعتمد عليها المسطرة. لا يحتوي هذا الملف على ألوان أو أحكام عبادات أو محتوى.",
-  "separation_contract": {
-    "this_registry_owns": [
-      "أسماء الحدود الزمنية",
-      "ترتيب الحدود في الدورة اليومية",
-      "نوع مصدر كل حد: فلكي أو محرك صلاة أو مشتق",
-      "علاقات البداية والنهاية بين الحدود"
-    ],
-    "this_registry_does_not_own": [
-      "ألوان المسطرة",
-      "حكم النهي أو الاستحباب",
-      "محتوى العبادات",
-      "النوافذ المنبثقة",
-      "تسجيل إنجاز العبادات"
-    ]
-  },
-  "clock_display": {
-    "format": "12_hour",
-    "arabic_dayparts": true,
-    "examples": [
-      "6:00 صباحًا",
-      "12:00 ظهرًا",
-      "4:00 مساءً",
-      "12:00 منتصف الليل"
-    ],
-    "forbid_24_hour_labels_in_ui": true
-  },
-  "daily_cycle": {
-    "anchor": "false_dawn",
-    "continues_into_next_day": true,
-    "end_boundary": "next_false_dawn",
-    "ui_model": "continuous_horizontal_ruler",
-    "note": "الدورة الزمنية متصلة؛ الوصول إلى نهاية الدورة يدخل مباشرة في دورة اليوم التالي."
-  },
-  "authorities": {
-    "astronomy_engine": {
-      "role": "حساب موضع الشمس والحدود الفلكية والرصدية",
-      "hardcoded_clock_minutes_for_solar_boundaries": false
-    },
-    "prayer_engine": {
-      "role": "إعطاء أوقات الصلاة المعتمدة حسب إعدادات التطبيق"
-    },
-    "derived_time_engine": {
-      "role": "اشتقاق الحدود الزمنية المركبة من حدود محسوبة أخرى"
-    },
-    "fiqh_profile": {
-      "role": "اختيار الحد الفقهي عندما توجد أكثر من طريقة معتبرة لتفسير حد زمني",
-      "note": "هذا الملف يعرّف الزمن فقط؛ الحكم التعبدي يوضع في Registry مستقل."
-    }
+ "schema_name": "islamic_clock_fiqh_time_registry",
+ "schema_version": "1.6.0",
+ "registry_id": "fiqh_time_registry",
+ "project": "الساعة الإسلامية / الخط الزمني الروحي",
+ "language": "ar",
+ "rtl": true,
+ "status": "time_boundaries_registry",
+ "purpose": "تعريف محطات وحدود الزمن التي تعتمد عليها المسطرة. لا يحتوي هذا الملف على ألوان أو أحكام عبادات أو محتوى.",
+ "separation_contract": {
+  "this_registry_owns": [
+   "أسماء الحدود الزمنية",
+   "ترتيب الحدود في الدورة اليومية",
+   "نوع مصدر كل حد: فلكي أو محرك صلاة أو مشتق",
+   "علاقات البداية والنهاية بين الحدود"
+  ],
+  "this_registry_does_not_own": [
+   "ألوان المسطرة",
+   "حكم النهي أو الاستحباب",
+   "محتوى العبادات",
+   "النوافذ المنبثقة",
+   "تسجيل إنجاز العبادات"
+  ]
+ },
+ "clock_display": {
+  "format": "12_hour",
+  "arabic_dayparts": true,
+  "examples": [
+   "6:00 صباحًا",
+   "12:00 ظهرًا",
+   "4:00 مساءً",
+   "12:00 منتصف الليل"
+  ],
+  "forbid_24_hour_labels_in_ui": true
+ },
+ "daily_cycle": {
+  "anchor": "false_dawn",
+  "continues_into_next_day": true,
+  "end_boundary": "next_false_dawn",
+  "ui_model": "continuous_horizontal_ruler",
+  "note": "الدورة الزمنية متصلة؛ الوصول إلى نهاية الدورة يدخل مباشرة في دورة اليوم التالي."
+ },
+ "authorities": {
+  "astronomy_engine": {
+   "role": "حساب موضع الشمس والحدود الفلكية والرصدية",
+   "hardcoded_clock_minutes_for_solar_boundaries": false
   },
-  "boundaries": [
-    {
-      "id": "false_dawn",
-      "label": "الفجر الكاذب",
-      "source": "astronomy_engine",
-      "kind": "observational_estimate",
-      "fixed_minutes": false,
-      "note": "حد رصدي/فلكي تقديري مستقل عن الفجر الصادق."
-    },
-    {
-      "id": "true_dawn",
-      "label": "الفجر الصادق",
-      "source": "prayer_engine",
-      "kind": "prayer_boundary",
-      "fixed_minutes": false
-    },
-    {
-      "id": "sunrise",
-      "label": "الشروق",
-      "source": "astronomy_engine",
-      "kind": "solar_boundary",
-      "fixed_minutes": false
-    },
-    {
-      "id": "sunrise_clear",
-      "label": "ارتفاع الشمس بعد الشروق",
-      "source": "astronomy_engine",
-      "kind": "solar_boundary",
-      "fixed_minutes": false,
-      "note": "يحسب من حركة الشمس؛ لا يُختزل في عدد دقائق ثابت بعد الشروق."
-    },
-    {
-      "id": "solar_noon",
-      "label": "الاستواء الشمسي",
-      "source": "astronomy_engine",
-      "kind": "solar_boundary",
-      "fixed_minutes": false
-    },
-    {
-      "id": "zawal",
-      "label": "الزوال",
-      "source": "astronomy_engine",
-      "kind": "solar_transition",
-      "fixed_minutes": false,
-      "relation": "بعد الاستواء عندما تبدأ الشمس بالميل عن أعلى ارتفاع",
-      "practical_equivalence": "يتطابق عمليًا مع الاستواء ضمن دقة الحل العددي (نحو ثانية). النافذة المنهيّ فيها قبيل الزوال سياسة عرض في worship_fiqh_registry ولا تُشتق من هذا الحد."
-    },
-    {
-      "id": "dhuhr",
-      "label": "الظهر",
-      "source": "prayer_engine",
-      "kind": "prayer_boundary",
-      "fixed_minutes": false
-    },
-    {
-      "id": "asr_shadow_1",
-      "label": "حد الظل: المثل",
-      "source": "astronomy_engine",
-      "kind": "shadow_factor_boundary",
-      "shadow_factor": 1,
-      "exclude_noon_shadow": true,
-      "fixed_minutes": false,
-      "note": "يحسب من طول الظل بعد استبعاد فيء الزوال؛ يستخدمه ملف الفقه لبدء العصر عند الجمهور وبعض الأقوال الحنفية."
-    },
-    {
-      "id": "asr_shadow_2",
-      "label": "حد الظل: المثلان",
-      "source": "astronomy_engine",
-      "kind": "shadow_factor_boundary",
-      "shadow_factor": 2,
-      "exclude_noon_shadow": true,
-      "fixed_minutes": false,
-      "note": "يحسب من طول الظل بعد استبعاد فيء الزوال؛ يستخدمه ملف الفقه لقول أبي حنيفة المشهور في بدء العصر."
-    },
-    {
-      "id": "asr",
-      "label": "العصر",
-      "source": "prayer_engine",
-      "kind": "prayer_boundary",
-      "fixed_minutes": false
-    },
-    {
-      "id": "sunset_approach",
-      "label": "اقتراب الغروب",
-      "source": "astronomy_engine",
-      "kind": "solar_boundary",
-      "fixed_minutes": false,
-      "note": "لا يساوي وقت العصر ولا يُحدد برقم ساعة ثابت."
-    },
-    {
-      "id": "sunset",
-      "label": "الغروب",
-      "source": "astronomy_engine",
-      "kind": "solar_boundary",
-      "fixed_minutes": false
-    },
-    {
-      "id": "maghrib",
-      "label": "المغرب",
-      "source": "prayer_engine",
-      "kind": "prayer_boundary",
-      "fixed_minutes": false
-    },
-    {
-      "id": "red_twilight_end",
-      "label": "نهاية الشفق الأحمر",
-      "source": "astronomy_engine",
-      "kind": "observational_estimate",
-      "fixed_minutes": false,
-      "note": "حد رصدي تقديري مستقل عن حد دخول العشاء الفقهي."
-    },
-    {
-      "id": "white_twilight_end",
-      "label": "نهاية الشفق الأبيض",
-      "source": "astronomy_engine",
-      "kind": "observational_estimate",
-      "fixed_minutes": false,
-      "note": "حد رصدي تقديري مستقل عن حد دخول العشاء الفقهي."
-    },
-    {
-      "id": "isha",
-      "label": "العشاء",
-      "source": "prayer_engine",
-      "kind": "prayer_boundary",
-      "fixed_minutes": false
-    },
-    {
-      "id": "first_third_of_night",
-      "label": "نهاية الثلث الأول من الليل",
-      "source": "derived_time_engine",
-      "kind": "derived_boundary",
-      "formula": "sunset + (1/3 * duration(sunset, next_true_dawn))",
-      "fixed_minutes": false,
-      "note": "حد حسابي فقط تستخدمه طبقة الفقه عند تمييز فترات العشاء."
-    },
-    {
-      "id": "islamic_midnight",
-      "label": "منتصف الليل الشرعي",
-      "source": "derived_time_engine",
-      "kind": "derived_boundary",
-      "formula": "midpoint(sunset, next_true_dawn)",
-      "fixed_minutes": false
-    },
-    {
-      "id": "last_third_start",
-      "label": "بداية الثلث الأخير من الليل",
-      "source": "derived_time_engine",
-      "kind": "derived_boundary",
-      "formula": "sunset + (2/3 * duration(sunset, next_true_dawn))",
-      "fixed_minutes": false
-    },
-    {
-      "id": "next_false_dawn",
-      "label": "الفجر الكاذب لليوم التالي",
-      "source": "astronomy_engine",
-      "kind": "observational_estimate",
-      "fixed_minutes": false,
-      "cycle_link": "false_dawn"
-    },
-    {
-      "id": "next_true_dawn",
-      "label": "الفجر الصادق لليوم التالي",
-      "source": "prayer_engine",
-      "kind": "prayer_boundary",
-      "fixed_minutes": false,
-      "cycle_link": "true_dawn"
-    }
+  "prayer_engine": {
+   "role": "إعطاء أوقات الصلاة المعتمدة حسب إعدادات التطبيق"
+  },
+  "derived_time_engine": {
+   "role": "اشتقاق الحدود الزمنية المركبة من حدود محسوبة أخرى"
+  },
+  "fiqh_profile": {
+   "role": "اختيار الحد الفقهي عندما توجد أكثر من طريقة معتبرة لتفسير حد زمني",
+   "note": "هذا الملف يعرّف الزمن فقط؛ الحكم التعبدي يوضع في Registry مستقل."
+  }
+ },
+ "boundaries": [
+  {
+   "id": "false_dawn",
+   "label": "الفجر الكاذب",
+   "source": "astronomy_engine",
+   "kind": "observational_estimate",
+   "fixed_minutes": false,
+   "note": "حد رصدي/فلكي تقديري مستقل عن الفجر الصادق."
+  },
+  {
+   "id": "true_dawn",
+   "label": "الفجر الصادق",
+   "source": "prayer_engine",
+   "kind": "prayer_boundary",
+   "fixed_minutes": false
+  },
+  {
+   "id": "sunrise",
+   "label": "الشروق",
+   "source": "astronomy_engine",
+   "kind": "solar_boundary",
+   "fixed_minutes": false
+  },
+  {
+   "id": "sunrise_clear",
+   "label": "ارتفاع الشمس بعد الشروق",
+   "source": "astronomy_engine",
+   "kind": "solar_boundary",
+   "fixed_minutes": false,
+   "note": "يحسب من حركة الشمس؛ لا يُختزل في عدد دقائق ثابت بعد الشروق."
+  },
+  {
+   "id": "solar_noon",
+   "label": "الاستواء الشمسي",
+   "source": "astronomy_engine",
+   "kind": "solar_boundary",
+   "fixed_minutes": false
+  },
+  {
+   "id": "zawal",
+   "label": "الزوال",
+   "source": "astronomy_engine",
+   "kind": "solar_transition",
+   "fixed_minutes": false,
+   "relation": "بعد الاستواء عندما تبدأ الشمس بالميل عن أعلى ارتفاع"
+  },
+  {
+   "id": "dhuhr",
+   "label": "الظهر",
+   "source": "prayer_engine",
+   "kind": "prayer_boundary",
+   "fixed_minutes": false
+  },
+  {
+   "id": "asr_shadow_1",
+   "label": "حد الظل: المثل",
+   "source": "astronomy_engine",
+   "kind": "shadow_factor_boundary",
+   "shadow_factor": 1,
+   "exclude_noon_shadow": true,
+   "fixed_minutes": false,
+   "note": "يحسب من طول الظل بعد استبعاد فيء الزوال؛ يستخدمه ملف الفقه لبدء العصر عند الجمهور وبعض الأقوال الحنفية."
+  },
+  {
+   "id": "asr_shadow_2",
+   "label": "حد الظل: المثلان",
+   "source": "astronomy_engine",
+   "kind": "shadow_factor_boundary",
+   "shadow_factor": 2,
+   "exclude_noon_shadow": true,
+   "fixed_minutes": false,
+   "note": "يحسب من طول الظل بعد استبعاد فيء الزوال؛ يستخدمه ملف الفقه لقول أبي حنيفة المشهور في بدء العصر."
+  },
+  {
+   "id": "asr",
+   "label": "العصر",
+   "source": "prayer_engine",
+   "kind": "prayer_boundary",
+   "fixed_minutes": false
+  },
+  {
+   "id": "last_daylight_hour_start",
+   "label": "بداية آخر جزء من النهار",
+   "source": "derived_time_engine",
+   "kind": "derived_boundary",
+   "formula": "sunrise + (11/12 * duration(sunrise, sunset))",
+   "fixed_minutes": false,
+   "note": "النهار اثنا عشر جزءًا متساويًا بين الشروق والغروب؛ الحد حسابي فقط وتستخدمه طبقة الفقه لعرض ساعة الإجابة."
+  },
+  {
+   "id": "sunset_approach",
+   "label": "اقتراب الغروب",
+   "source": "astronomy_engine",
+   "kind": "solar_boundary",
+   "fixed_minutes": false,
+   "note": "لا يساوي وقت العصر ولا يُحدد برقم ساعة ثابت."
+  },
+  {
+   "id": "sunset",
+   "label": "الغروب",
+   "source": "astronomy_engine",
+   "kind": "solar_boundary",
+   "fixed_minutes": false
+  },
+  {
+   "id": "maghrib",
+   "label": "المغرب",
+   "source": "prayer_engine",
+   "kind": "prayer_boundary",
+   "fixed_minutes": false
+  },
+  {
+   "id": "red_twilight_end",
+   "label": "نهاية الشفق الأحمر",
+   "source": "astronomy_engine",
+   "kind": "observational_estimate",
+   "fixed_minutes": false,
+   "note": "حد رصدي تقديري مستقل عن حد دخول العشاء الفقهي."
+  },
+  {
+   "id": "white_twilight_end",
+   "label": "نهاية الشفق الأبيض",
+   "source": "astronomy_engine",
+   "kind": "observational_estimate",
+   "fixed_minutes": false,
+   "note": "حد رصدي تقديري مستقل عن حد دخول العشاء الفقهي."
+  },
+  {
+   "id": "isha",
+   "label": "العشاء",
+   "source": "prayer_engine",
+   "kind": "prayer_boundary",
+   "fixed_minutes": false
+  },
+  {
+   "id": "first_third_of_night",
+   "label": "نهاية الثلث الأول من الليل",
+   "source": "derived_time_engine",
+   "kind": "derived_boundary",
+   "formula": "sunset + (1/3 * duration(sunset, next_true_dawn))",
+   "fixed_minutes": false,
+   "note": "حد حسابي فقط تستخدمه طبقة الفقه عند تمييز فترات العشاء."
+  },
+  {
+   "id": "islamic_midnight",
+   "label": "منتصف الليل الشرعي",
+   "source": "derived_time_engine",
+   "kind": "derived_boundary",
+   "formula": "midpoint(sunset, next_true_dawn)",
+   "fixed_minutes": false
+  },
+  {
+   "id": "last_third_start",
+   "label": "بداية الثلث الأخير من الليل",
+   "source": "derived_time_engine",
+   "kind": "derived_boundary",
+   "formula": "sunset + (2/3 * duration(sunset, next_true_dawn))",
+   "fixed_minutes": false
+  },
+  {
+   "id": "next_false_dawn",
+   "label": "الفجر الكاذب لليوم التالي",
+   "source": "astronomy_engine",
+   "kind": "observational_estimate",
+   "fixed_minutes": false,
+   "cycle_link": "false_dawn"
+  },
+  {
+   "id": "next_true_dawn",
+   "label": "الفجر الصادق لليوم التالي",
+   "source": "prayer_engine",
+   "kind": "prayer_boundary",
+   "fixed_minutes": false,
+   "cycle_link": "true_dawn"
+  }
+ ],
+ "aliases": {
+  "note": "أسماء بديلة تُحسب في calculation_profile.boundaries وتحيل إلى حد معرّف، وتُستعمل في worship_fiqh_registry ومشغلات التنبيه.",
+  "fajr": {
+   "alias_of": "true_dawn",
+   "label": "الفجر"
+  },
+  "isha_entry_hanafi": {
+   "alias_of": "white_twilight_end",
+   "label": "دخول العشاء عند الحنفية (الشفق الأبيض)"
+  }
+ },
+ "derived_windows": [
+  {
+   "id": "post_sunrise_to_sunrise_clear",
+   "start": "sunrise",
+   "end": "sunrise_clear",
+   "semantic": "فترة زمنية فقط؛ الحكم واللون يحددان في ملفات مستقلة"
+  },
+  {
+   "id": "duha_time_geometry",
+   "start": "sunrise_clear",
+   "end": "solar_noon",
+   "semantic": "نافذة زمنية هندسية فقط؛ لا تحمل حكمًا أو لونًا هنا"
+  },
+  {
+   "id": "solar_noon_to_zawal",
+   "start": "solar_noon",
+   "end": "zawal",
+   "semantic": "انتقال الاستواء إلى الزوال؛ الحكم واللون خارج هذا الملف"
+  },
+  {
+   "id": "sunset_approach_to_sunset",
+   "start": "sunset_approach",
+   "end": "sunset",
+   "semantic": "فترة اقتراب الغروب فقط؛ لا تحمل حكمًا فقهيًا هنا"
+  },
+  {
+   "id": "night",
+   "start": "sunset",
+   "end": "next_true_dawn",
+   "semantic": "الفترة الليلية المستخدمة للاشتقاقات الزمنية"
+  },
+  {
+   "id": "first_third_of_night_window",
+   "start": "sunset",
+   "end": "first_third_of_night",
+   "semantic": "نافذة حسابية فقط؛ الحكم الفقهي خارج هذا الملف."
+  },
+  {
+   "id": "last_third_of_night_window",
+   "start": "last_third_start",
+   "end": "next_true_dawn",
+   "semantic": "نافذة حسابية فقط؛ الحكم والعبادة خارج هذا الملف."
+  }
+ ],
+ "ordering": [
+  "false_dawn",
+  "true_dawn",
+  "sunrise",
+  "sunrise_clear",
+  "solar_noon",
+  "zawal",
+  "dhuhr",
+  "asr_shadow_1",
+  "asr_shadow_2",
+  "asr",
+  "last_daylight_hour_start",
+  "sunset_approach",
+  "sunset",
+  "maghrib",
+  "red_twilight_end",
+  "white_twilight_end",
+  "isha",
+  "first_third_of_night",
+  "islamic_midnight",
+  "last_third_start",
+  "next_false_dawn",
+  "next_true_dawn"
+ ],
+ "validation": {
+  "no_colors": true,
+  "no_worship_rulings": true,
+  "no_fixed_solar_minute_offsets": true,
+  "continuous_cycle": true,
+  "implementation_ready": true,
+  "supports_madhhab_worship_registry": true,
+  "shadow_factor_boundaries_present": true,
+  "night_fraction_boundaries_present": true,
+  "aliases_resolve": true,
+  "solver_constants_in_registry": true
+ },
+ "integration_contract": {
+  "worship_fiqh_registry": "worship_fiqh_registry.json",
+  "role_ar": "هذا الملف يحسب الحدود فقط، وملف worship_fiqh_registry.json يختار أي حد تستخدمه العبادة بحسب المذهب.",
+  "madhhab_sensitive_outputs": [
+   "asr_shadow_1",
+   "asr_shadow_2",
+   "first_third_of_night",
+   "red_twilight_end",
+   "white_twilight_end"
   ],
-  "derived_windows": [
-    {
-      "id": "post_sunrise_to_sunrise_clear",
-      "start": "sunrise",
-      "end": "sunrise_clear",
-      "semantic": "فترة زمنية فقط؛ الحكم واللون يحددان في ملفات مستقلة"
-    },
-    {
-      "id": "duha_time_geometry",
-      "start": "sunrise_clear",
-      "end": "solar_noon",
-      "semantic": "نافذة زمنية هندسية فقط؛ لا تحمل حكمًا أو لونًا هنا"
-    },
-    {
-      "id": "solar_noon_to_zawal",
-      "start": "solar_noon",
-      "end": "zawal",
-      "semantic": "انتقال الاستواء إلى الزوال؛ الحكم واللون خارج هذا الملف"
-    },
-    {
-      "id": "sunset_approach_to_sunset",
-      "start": "sunset_approach",
-      "end": "sunset",
-      "semantic": "فترة اقترا�� الغروب فقط؛ لا تحمل حكمًا فقهيًا هنا"
-    },
-    {
-      "id": "night",
-      "start": "sunset",
-      "end": "next_true_dawn",
-      "semantic": "الفترة الليلية المستخدمة للاشتقاقات الزمنية"
-    },
-    {
-      "id": "first_third_of_night_window",
-      "start": "sunset",
-      "end": "first_third_of_night",
-      "semantic": "نافذة حسابية فقط؛ الحكم الفقهي خارج هذا الملف."
-    },
-    {
-      "id": "last_third_of_night_window",
-      "start": "last_third_start",
-      "end": "next_true_dawn",
-      "semantic": "نافذة حسابية فقط؛ الحكم والعبادة خارج هذا الملف."
-    }
+  "hijri_calendar_registry": "hijri_calendar_registry.json",
+  "cross_registry_validator": "validate_registries.js"
+ },
+ "calculation_profile": {
+  "id": "inherited_solar_estimates_v1",
+  "label_ar": "إعدادات شمسية تقديرية من النسخة القديمة",
+  "note_ar": "حساب شمسي تقديري يتغير بالموقع والتاريخ. ارتفاع الشمس 4.5° والشفق 15°/18° إعدادات تقديرية موروثة تحتاج اعتمادًا. الاستواء والزوال حدّا انتقال اتجاه حركة الشمس، دون افتراض فترة بالدقائق؛ هذه ليست مواقيت أذان رسمية.",
+  "provenance": {
+   "solar_geometry": "index-8.html: sunPosition / solarAltitudeAt",
+   "sunrise_clear": "index-8.html: solarFiqhBoundaries, 4.5 degrees",
+   "zawal": "fiqh_time_registry_solar_v1_1.json: post_transit_transition / after_upper_solar_transit؛ حل عددي لتغير اتجاه الارتفاع بعد القمة، دون مساواة alias أو عتبة انخفاض مخترعة.",
+   "sunset_approach": "index-8.html: estimateSunsetStart, -0.30 degrees",
+   "twilight": "spiritual_timeline_v3_fiqh_timers_FINAL.zip: fiqh_time_registry.json, red 15 and white 18 degrees",
+   "true_dawn": "index-8.html: FAJR_ANGLE = 18"
+  },
+  "default_madhhab": "shafii",
+  "locations": [
+   {
+    "id": "amman",
+    "name": "عمّان",
+    "lat": 31.9454,
+    "lng": 35.9284,
+    "height": 0,
+    "timezone": "Asia/Amman",
+    "note": "height يستهلكه solar_engine. timezone للمستهلك: حد اليوم يحتاج منطقة المدينة لا الجهاز عند اختلافهما."
+   }
   ],
-  "ordering": [
-    "false_dawn",
-    "true_dawn",
-    "sunrise",
-    "sunrise_clear",
-    "solar_noon",
-    "zawal",
-    "dhuhr",
-    "asr_shadow_1",
-    "asr_shadow_2",
-    "asr",
-    "sunset_approach",
-    "sunset",
-    "maghrib",
-    "red_twilight_end",
-    "white_twilight_end",
-    "isha",
-    "first_third_of_night",
-    "islamic_midnight",
+  "observational_limits": {
+   "false_dawn": null,
+   "next_false_dawn": null
+  },
+  "boundaries": {
+   "solar_noon": {
+    "op": "maximum"
+   },
+   "true_dawn": {
+    "op": "altitude",
+    "degrees": -18,
+    "direction": "ascending"
+   },
+   "sunrise": {
+    "op": "altitude",
+    "degrees": -0.833,
+    "direction": "ascending"
+   },
+   "sunrise_clear": {
+    "op": "altitude",
+    "degrees": 4.5,
+    "direction": "ascending",
+    "approximate": true
+   },
+   "zawal": {
+    "op": "post_transit_transition",
+    "boundary": "solar_noon",
+    "direction": "descending",
+    "transition_only": true,
+    "note_ar": "الزوال محسوب من بدء انخفاض ارتفاع الشمس بعد الاستواء. يعرض كحد شمسي؛ لا يستنتج الحساب منه فترة نهي ممتدة بالدقائق."
+   },
+   "sunset_approach": {
+    "op": "altitude",
+    "degrees": -0.3,
+    "direction": "descending",
+    "approximate": true
+   },
+   "sunset": {
+    "op": "altitude",
+    "degrees": -0.833,
+    "direction": "descending"
+   },
+   "red_twilight_end": {
+    "op": "altitude",
+    "degrees": -15,
+    "direction": "descending",
+    "approximate": true
+   },
+   "white_twilight_end": {
+    "op": "altitude",
+    "degrees": -18,
+    "direction": "descending",
+    "approximate": true
+   },
+   "asr_shadow_1": {
+    "op": "shadow",
+    "factor": 1
+   },
+   "asr_shadow_2": {
+    "op": "shadow",
+    "factor": 2
+   },
+   "fajr": {
+    "op": "alias",
+    "boundary": "true_dawn"
+   },
+   "dhuhr": {
+    "op": "alias",
+    "boundary": "zawal"
+   },
+   "maghrib": {
+    "op": "alias",
+    "boundary": "sunset"
+   },
+   "asr": {
+    "op": "rule_start",
+    "rule_id": "asr"
+   },
+   "isha": {
+    "op": "rule_start",
+    "rule_id": "isha_entry"
+   },
+   "isha_entry_hanafi": {
+    "op": "alias",
+    "boundary": "white_twilight_end"
+   },
+   "next_true_dawn": {
+    "op": "next_day",
+    "boundary": "true_dawn"
+   },
+   "first_third_of_night": {
+    "op": "fraction",
+    "from": "sunset",
+    "to": "next_true_dawn",
+    "fraction": 0.3333333333333333
+   },
+   "islamic_midnight": {
+    "op": "fraction",
+    "from": "sunset",
+    "to": "next_true_dawn",
+    "fraction": 0.5
+   },
+   "last_third_start": {
+    "op": "fraction",
+    "from": "sunset",
+    "to": "next_true_dawn",
+    "fraction": 0.6666666666666666
+   },
+   "last_daylight_hour_start": {
+    "op": "fraction",
+    "from": "sunrise",
+    "to": "sunset",
+    "fraction": 0.9166666666666666
+   }
+  },
+  "relation_bindings": {
+   "after_isha": "isha",
+   "last_third_start_to_next_true_dawn": [
     "last_third_start",
-    "next_false_dawn",
     "next_true_dawn"
-  ],
-  "validation": {
-    "no_colors": true,
-    "no_worship_rulings": true,
-    "no_fixed_solar_minute_offsets": true,
-    "continuous_cycle": true,
-    "implementation_ready": true,
-    "supports_madhhab_worship_registry": true,
-    "shadow_factor_boundaries_present": true,
-    "night_fraction_boundaries_present": true,
-    "false_dawn_boundary_defined": true,
-    "solver_numbers_in_registry": true
-  },
-  "integration_contract": {
-    "worship_fiqh_registry": "worship_fiqh_registry.json",
-    "role_ar": "هذا الملف يحسب الحدود فقط، وملف worship_fiqh_registry.json يختار أي حد تستخدمه العبادة بحسب المذهب.",
-    "madhhab_sensitive_outputs": [
-      "asr_shadow_1",
-      "asr_shadow_2",
-      "first_third_of_night",
-      "red_twilight_end",
-      "white_twilight_end"
-    ]
-  },
-  "calculation_profile": {
-    "id": "inherited_solar_estimates_v1",
-    "label_ar": "إعدادات شمسية تقديرية من النسخة القديمة",
-    "note_ar": "حساب شمسي تقديري يتغير بالموقع والتاريخ. ارتفاع الشمس 4.5° والشفق 15°/18° إعدادات تقديرية موروثة تحتاج اعتمادًا. الاستواء والزوال حدّا انتقال اتجاه حركة الشمس، دون افتراض فترة بالدقائق؛ هذه ليست مواقيت أذان رسمية.",
-    "provenance": {
-      "solar_geometry": "index-8.html: sunPosition / solarAltitudeAt",
-      "sunrise_clear": "index-8.html: solarFiqhBoundaries, 4.5 degrees",
-      "zawal": "fiqh_time_registry_solar_v1_1.json: post_transit_transition / after_upper_solar_transit؛ حل عددي لتغير اتجاه الارتفاع بعد القمة، دون مساواة alias أو عتبة انخفاض مخترعة.",
-      "sunset_approach": "index-8.html: estimateSunsetStart, -0.30 degrees",
-      "twilight": "spiritual_timeline_v3_fiqh_timers_FINAL.zip: fiqh_time_registry.json, red 15 and white 18 degrees",
-      "true_dawn": "index-8.html: FAJR_ANGLE = 18"
-    },
-    "default_madhhab": "shafii",
-    "locations": [
-      {
-        "name": "عمّان",
-        "lat": 31.9454,
-        "lng": 35.9284,
-        "timezone": "Asia/Amman",
-        "height": 0
-      }
-    ],
-    "observational_limits": {
-      "false_dawn": null,
-      "next_false_dawn": null
-    },
-    "boundaries": {
-      "false_dawn": {
-        "op": "altitude",
-        "degrees": -20,
-        "direction": "ascending",
-        "approximate": true,
-        "provisional": true,
-        "note_ar": "قيمة مؤقتة لتفعيل مرساة الدورة اليومية فقط، وهي رصدية تقديرية. تحتاج اعتماد المرجع الفلكي قبل الاعتماد النهائي، ولا تدخل في حساب أي عبادة."
-      },
-      "solar_noon": {
-        "op": "maximum"
-      },
-      "true_dawn": {
-        "op": "altitude",
-        "degrees": -18,
-        "direction": "ascending"
-      },
-      "sunrise": {
-        "op": "altitude",
-        "degrees": -0.833,
-        "direction": "ascending"
-      },
-      "sunrise_clear": {
-        "op": "altitude",
-        "degrees": 4.5,
-        "direction": "ascending",
-        "approximate": true
-      },
-      "zawal": {
-        "op": "post_transit_transition",
-        "boundary": "solar_noon",
-        "direction": "descending",
-        "transition_only": true,
-        "note_ar": "الزوال محسوب من بدء انخفاض ارتفاع الشمس بعد الاستواء. يعرض كحد شمسي؛ لا يستنتج الحساب منه فترة نهي ممتدة بالدقائق."
-      },
-      "sunset_approach": {
-        "op": "altitude",
-        "degrees": -0.3,
-        "direction": "descending",
-        "approximate": true
-      },
-      "sunset": {
-        "op": "altitude",
-        "degrees": -0.833,
-        "direction": "descending"
-      },
-      "red_twilight_end": {
-        "op": "altitude",
-        "degrees": -15,
-        "direction": "descending",
-        "approximate": true
-      },
-      "white_twilight_end": {
-        "op": "altitude",
-        "degrees": -18,
-        "direction": "descending",
-        "approximate": true
-      },
-      "asr_shadow_1": {
-        "op": "shadow",
-        "factor": 1
-      },
-      "asr_shadow_2": {
-        "op": "shadow",
-        "factor": 2
-      },
-      "fajr": {
-        "op": "alias",
-        "boundary": "true_dawn"
-      },
-      "dhuhr": {
-        "op": "alias",
-        "boundary": "zawal"
-      },
-      "maghrib": {
-        "op": "alias",
-        "boundary": "sunset"
-      },
-      "asr": {
-        "op": "rule_start",
-        "rule_id": "asr"
-      },
-      "isha": {
-        "op": "rule_start",
-        "rule_id": "isha_entry"
-      },
-      "isha_entry_hanafi": {
-        "op": "alias",
-        "boundary": "white_twilight_end"
-      },
-      "next_true_dawn": {
-        "op": "next_day",
-        "boundary": "true_dawn"
-      },
-      "first_third_of_night": {
-        "op": "fraction",
-        "from": "sunset",
-        "to": "next_true_dawn",
-        "fraction": 0.3333333333333333
-      },
-      "islamic_midnight": {
-        "op": "fraction",
-        "from": "sunset",
-        "to": "next_true_dawn",
-        "fraction": 0.5
-      },
-      "last_third_start": {
-        "op": "fraction",
-        "from": "sunset",
-        "to": "next_true_dawn",
-        "fraction": 0.6666666666666666
-      },
-      "next_false_dawn": {
-        "op": "next_day",
-        "boundary": "false_dawn"
-      }
+   ]
+  },
+  "rule_time_bindings": {
+   "isha_entry": {
+    "end": "next_true_dawn"
+   },
+   "isha_periods": {
+    "start": "isha"
+   }
+  },
+  "notice_runtime": {
+   "due_window_seconds": 90,
+   "trigger_bindings": {
+    "day_start": {
+     "boundary": "true_dawn"
     },
-    "relation_bindings": {
-      "after_isha": "isha",
-      "last_third_start_to_next_true_dawn": [
-        "last_third_start",
-        "next_true_dawn"
-      ]
+    "after_fajr": {
+     "boundary": "fajr"
     },
-    "rule_time_bindings": {
-      "isha_entry": {
-        "end": "next_true_dawn"
-      },
-      "isha_periods": {
-        "start": "isha"
-      }
+    "after_dhuhr": {
+     "boundary": "dhuhr"
     },
-    "notice_runtime": {
-      "due_window_seconds": 90,
-      "trigger_bindings": {
-        "day_start": {
-          "boundary": "true_dawn"
-        },
-        "after_fajr": {
-          "boundary": "fajr"
-        },
-        "after_dhuhr": {
-          "boundary": "dhuhr"
-        },
-        "after_asr": {
-          "boundary": "asr"
-        },
-        "after_maghrib": {
-          "boundary": "maghrib"
-        },
-        "after_isha": {
-          "boundary": "isha"
-        },
-        "before_fajr": {
-          "boundary": "fajr",
-          "offset_sign": -1
-        },
-        "before_jumuah": {
-          "boundary": "dhuhr",
-          "offset_sign": -1
-        },
-        "duha_start": {
-          "boundary": "sunrise_clear"
-        },
-        "last_third_start": {
-          "boundary": "last_third_start"
-        },
-        "previous_evening": {
-          "boundary": "sunset",
-          "day_shift": -1
-        },
-        "sunday_evening": {
-          "boundary": "sunset",
-          "day_shift": -1
-        },
-        "wednesday_evening": {
-          "boundary": "sunset",
-          "day_shift": -1
-        }
-      },
-      "note_ar": "نافذة استدراك التنبيه سياسة تطبيق فقط. حدود أوقات النهي لا تستخدم هذه الإزاحات. التنبيهات تعمل أثناء فتح الصفحة، ويحدّد سجل الحدث عدد مرات ظهوره."
+    "after_asr": {
+     "boundary": "asr"
     },
-    "solar_solver": {
-      "time_tolerance_ms": 1000,
-      "derivative_sample_ms": 1000,
-      "note_ar": "دقة عددية للبحث عن انقلاب اتجاه الارتفاع؛ ليست مدة نهي أو إزاحة زمنية للزوال. جميع القيم العددية للمحرك تأتي من هنا ولا شيء منها مكتوب في solar_engine.js.",
-      "scan_step_ms": 300000,
-      "bisect_iterations": 36,
-      "maximum_iterations": 60,
-      "transition_iterations": 80,
-      "noon_search_half_window_ms": 21600000,
-      "crossing_window_ms": 43200000,
-      "alias_passes": 5,
-      "use_astronomy_search_functions": true
+    "after_maghrib": {
+     "boundary": "maghrib"
     },
-    "solar_motion": {
-      "engine": "local_solar_geometry",
-      "algorithm_reference": "Jean Meeus, Astronomical Algorithms",
-      "indicator_position_source": "device_clock_on_continuous_timeline",
-      "day_night_source": "computed_sunrise_and_sunset",
-      "apparent_horizon_degrees": -0.833,
-      "uses_prayer_time_provider": false,
-      "note_ar": "حركة المؤشر تتبع وقت الجهاز على الخط المتصل، وحالة الشمس/القمر تتبع ارتفاع الشمس المحسوب للموقع. حد الشروق والغروب الظاهري −0.833°؛ وقد يختلف الرصد الفعلي قليلًا بسبب الغلاف الجوي والأفق المحلي."
-    }
-  },
-  "prayer_calculation": {
-    "default_method": "JordanAwqaf",
-    "storage_key": "clock_calculation_method_v1",
-    "legacy_option": {
-      "id": "registry",
-      "label": "الحدود الشمسية والسجل الفقهي الحالي"
+    "after_isha": {
+     "boundary": "isha"
     },
-    "engine": {
-      "url": "https://unpkg.com/adhan@4.4.6/lib/bundles/adhan.umd.min.js",
-      "version": "4.4.6",
-      "timeout_ms": 12000,
-      "source": "Adhan JS 4.4.6؛ الحسابات الفلكية مبنية على Astronomical Algorithms لِـ Jean Meeus",
-      "fallback_url": "vendor/adhan.umd.min.js",
-      "offline_note_ar": "يُحمَّل من الرابط أولًا ثم من النسخة المحلية عند فشله؛ ضع الملف بجوار index.html وأضفه إلى ملفات sw.js المخزنة مؤقتًا ليعمل التطبيق دون إنترنت."
+    "before_fajr": {
+     "boundary": "fajr",
+     "offset_sign": -1
     },
-    "methods": [
-      {
-        "id": "JordanAwqaf",
-        "label": "الأردن — وزارة الأوقاف",
-        "engine_mode": "custom_angles",
-        "fajr_angle": 18,
-        "isha_angle": 18,
-        "adjustments": {
-          "maghrib": 5
-        },
-        "provider_method_id": 23,
-        "solar_sunset_is_independent": true,
-        "authority_name": "وزارة الأوقاف والشؤون والمقدسات الإسلامية — الأردن",
-        "method_reference_url": "https://api.aladhan.com/v1/methods",
-        "daily_reference_url": "https://www.aliftaa.jo/Default",
-        "note_ar": "تطبيق محلي لمعاملات طريقة الأردن المنشورة: الفجر 18°، العشاء 18°، والمغرب بعد الغروب بخمس دقائق. تبقى مواقيت دائرة الإفتاء اليومية مرجع المقارنة الرسمي لمدينة عمّان."
-      },
-      {
-        "id": "MuslimWorldLeague",
-        "label": "رابطة العالم الإسلامي"
-      },
-      {
-        "id": "UmmAlQura",
-        "label": "أم القرى - مكة"
-      },
-      {
-        "id": "Egyptian",
-        "label": "الهيئة المصرية للمساحة"
-      },
-      {
-        "id": "Karachi",
-        "label": "كراتشي"
-      },
-      {
-        "id": "Dubai",
-        "label": "دبي"
-      },
-      {
-        "id": "Qatar",
-        "label": "قطر"
-      },
-      {
-        "id": "Kuwait",
-        "label": "الكويت"
-      },
-      {
-        "id": "MoonsightingCommittee",
-        "label": "لجنة تحري الهلال"
-      },
-      {
-        "id": "Singapore",
-        "label": "سنغافورة / ماليزيا / إندونيسيا"
-      },
-      {
-        "id": "Turkey",
-        "label": "تركيا"
-      },
-      {
-        "id": "Tehran",
-        "label": "طهران"
-      },
-      {
-        "id": "NorthAmerica",
-        "label": "ISNA - أمريكا الشمالية"
-      }
-    ],
-    "shadow_factor_to_madhab": {
-      "1": "Shafi",
-      "2": "Hanafi"
+    "before_jumuah": {
+     "boundary": "dhuhr",
+     "offset_sign": -1
     },
-    "madhhab_engine_bindings": {
-      "hanafi": {
-        "asr_shadow_factor": 2,
-        "adhan_madhab": "Hanafi",
-        "moonsighting_shafaq": "Abyad"
-      },
-      "maliki": {
-        "asr_shadow_factor": 1,
-        "adhan_madhab": "Shafi",
-        "moonsighting_shafaq": "Ahmer"
-      },
-      "shafii": {
-        "asr_shadow_factor": 1,
-        "adhan_madhab": "Shafi",
-        "moonsighting_shafaq": "Ahmer"
-      },
-      "hanbali": {
-        "asr_shadow_factor": 1,
-        "adhan_madhab": "Shafi",
-        "moonsighting_shafaq": "Ahmer"
-      }
+    "duha_start": {
+     "boundary": "sunrise_clear"
     },
-    "output_bindings": {
-      "fajr": "fajr",
-      "dhuhr": "dhuhr",
-      "asr": "asr",
-      "maghrib": "maghrib",
-      "isha": "isha"
+    "last_third_start": {
+     "boundary": "last_third_start"
     },
-    "period_bindings": {
-      "fajr": {
-        "start": "fajr",
-        "end": "sunrise"
-      },
-      "dhuhr": {
-        "start": "dhuhr",
-        "end": "asr"
-      },
-      "asr": {
-        "start": "asr",
-        "end": "maghrib"
-      },
-      "maghrib": {
-        "start": "maghrib",
-        "end": "isha"
-      },
-      "isha_entry": {
-        "start": "isha",
-        "end": "next_true_dawn"
-      }
+    "previous_evening": {
+     "boundary": "sunset",
+     "day_shift": -1
     },
-    "ramadan_interval": {
-      "method": "UmmAlQura",
-      "minutes": 120,
-      "storage_key": "clock_ummalqura_ramadan_v1"
+    "sunday_evening": {
+     "boundary": "sunset",
+     "day_shift": -1
     },
-    "note_ar": "طريقة الأردن هي الافتراضية، وتستخدم معاملات وزارة الأوقاف المنشورة مع إبقاء صفحة دائرة الإفتاء مرجع المقارنة اليومي. فرق خمس دقائق يخص موعد المغرب في هذه الطريقة ولا يغيّر حد الغروب الشمسي المحسوب. تشمل القائمة جميع الطرق المسماة التي يوفرها Adhan JS 4.4.6 إضافة إلى طريقة الأردن المخصصة. مواقيت الصلاة لا تستبدل الحدود الشمسية المستقلة التي تحرك مؤشر الشمس. المذهب الحنفي يأخذ المثلين للعصر، والمذاهب الثلاثة تأخذ المثل؛ وتضبط طريقة لجنة تحري الهلال نوع الشفق كذلك. خيار رمضان لأم القرى يؤكد يدويًا ولا يستنتج من تقويم تقريبي.",
-    "high_latitude": {
-      "default": "recommended",
-      "storage_key": "clock_high_latitude_rule_v1",
-      "options": [
-        {
-          "id": "recommended",
-          "label_ar": "الموصى به حسب خط العرض",
-          "adhan": "HighLatitudeRule.recommended"
-        },
-        {
-          "id": "MiddleOfTheNight",
-          "label_ar": "منتصف الليل",
-          "adhan": "HighLatitudeRule.MiddleOfTheNight"
-        },
-        {
-          "id": "SeventhOfTheNight",
-          "label_ar": "سُبع الليل",
-          "adhan": "HighLatitudeRule.SeventhOfTheNight"
-        },
-        {
-          "id": "TwilightAngle",
-          "label_ar": "زاوية الشفق",
-          "adhan": "HighLatitudeRule.TwilightAngle"
-        }
-      ],
-      "note_ar": "في المناطق التي لا يغيب فيها الشفق أو لا تغرب فيها الشمس يخفق حساب الزاوية، فتُستخدم هذه القاعدة. يتحقق المطوّر من وجود recommended في إصدار Adhan المثبت. الحدود الشمسية المستقلة تعرض سبب التعذر في unavailable بدل قيمة وهمية."
+    "wednesday_evening": {
+     "boundary": "sunset",
+     "day_shift": -1
     }
+   },
+   "note_ar": "نافذة استدراك التنبيه سياسة تطبيق فقط. حدود أوقات النهي لا تستخدم هذه الإزاحات. التنبيهات تعمل أثناء فتح الصفحة، ويحدّد سجل الحدث عدد مرات ظهوره."
   },
-  "changelog": [
-    "1.6.0: تعريف حد الفجر الكاذب والتالي له (كانا مرساة الدورة ولا حساب لهما) بقيمة مؤقتة تحتاج اعتماد المرجع",
-    "1.6.0: نقل كل أرقام الحل العددي من solar_engine.js إلى solar_solver",
-    "1.6.0: سياسة خطوط العرض العليا (high_latitude) لمحرك الصلاة",
-    "1.6.0: مسار محلي احتياطي لمكتبة Adhan، وخط زمني ومنطقة زمنية للموقع",
-    "1.6.0: توضيح تطابق الزوال مع الاستواء عمليًا"
-  ]
+  "solar_solver": {
+   "time_tolerance_ms": 1000,
+   "derivative_sample_ms": 1000,
+   "note_ar": "دقة عددية وحدود بحث فقط؛ ليست مدة نهي أو إزاحة زمنية للزوال. scan_step_ms خطوة مسح العبور، وbisect_iterations تكرارات التنصيف، وnoon_bracket_hours نصف نافذة البحث حول الاستواء، وhalf_day_hours نصف اليوم لنوافذ البحث، وdependency_passes أقصى عمق لاعتماد الحدود بعضها على بعض.",
+   "scan_step_ms": 300000,
+   "bisect_iterations": 36,
+   "maximum_iterations": 60,
+   "transit_iterations": 80,
+   "noon_bracket_hours": 6,
+   "half_day_hours": 12,
+   "dependency_passes": 5,
+   "longitude_degrees_per_hour": 15
+  },
+  "solar_motion": {
+   "engine": "local_solar_geometry",
+   "algorithm_reference": "Jean Meeus, Astronomical Algorithms",
+   "indicator_position_source": "device_clock_on_continuous_timeline",
+   "day_night_source": "computed_sunrise_and_sunset",
+   "apparent_horizon_degrees": -0.833,
+   "uses_prayer_time_provider": false,
+   "note_ar": "حركة المؤشر تتبع وقت الجهاز على الخط المتصل، وحالة الشمس/القمر تتبع ارتفاع الشمس المحسوب للموقع. حد الشروق والغروب الظاهري −0.833°؛ وقد يختلف الرصد الفعلي قليلًا بسبب الغلاف الجوي والأفق المحلي."
+  }
+ },
+ "prayer_calculation": {
+  "default_method": "JordanAwqaf",
+  "storage_key": "clock_calculation_method_v1",
+  "legacy_option": {
+   "id": "registry",
+   "label": "الحدود الشمسية والسجل الفقهي الحالي"
+  },
+  "engine": {
+   "url": "https://unpkg.com/adhan@4.4.6/lib/bundles/adhan.umd.min.js",
+   "version": "4.4.6",
+   "timeout_ms": 12000,
+   "source": "Adhan JS 4.4.6؛ الحسابات الفلكية مبنية على Astronomical Algorithms لِـ Jean Meeus",
+   "local_path": null,
+   "offline_note_ar": "يعتمد الرابط الحالي على الإنترنت. ضع نسخة adhan.umd.min.js (الإصدار 4.4.6) بجانب index.html وسمّها هنا في local_path ليعمل الحساب دون اتصال."
+  },
+  "methods": [
+   {
+    "id": "JordanAwqaf",
+    "label": "الأردن — وزارة الأوقاف",
+    "engine_mode": "custom_angles",
+    "fajr_angle": 18,
+    "isha_angle": 18,
+    "adjustments": {
+     "maghrib": 5
+    },
+    "provider_method_id": 23,
+    "solar_sunset_is_independent": true,
+    "authority_name": "وزارة ��لأوقاف والشؤون والمقدسات الإسلامية — الأردن",
+    "method_reference_url": "https://api.aladhan.com/v1/methods",
+    "daily_reference_url": "https://www.aliftaa.jo/Default",
+    "note_ar": "تطبيق محلي لمعاملات طريقة الأردن المنشورة: الفجر 18°، العشاء 18°، والمغرب بعد الغروب بخمس دقائق. تبقى مواقيت دائرة الإفتاء اليومية مرجع المقارنة الرسمي لمدينة عمّان."
+   },
+   {
+    "id": "MuslimWorldLeague",
+    "label": "رابطة العالم الإسلامي"
+   },
+   {
+    "id": "UmmAlQura",
+    "label": "أم القرى - مكة"
+   },
+   {
+    "id": "Egyptian",
+    "label": "الهيئة المصرية للمساحة"
+   },
+   {
+    "id": "Karachi",
+    "label": "كراتشي"
+   },
+   {
+    "id": "Dubai",
+    "label": "دبي"
+   },
+   {
+    "id": "Qatar",
+    "label": "قطر"
+   },
+   {
+    "id": "Kuwait",
+    "label": "الكويت"
+   },
+   {
+    "id": "MoonsightingCommittee",
+    "label": "لجنة تحري الهلال"
+   },
+   {
+    "id": "Singapore",
+    "label": "سنغافورة / ماليزيا / إندونيسيا"
+   },
+   {
+    "id": "Turkey",
+    "label": "تركيا"
+   },
+   {
+    "id": "Tehran",
+    "label": "طهران"
+   },
+   {
+    "id": "NorthAmerica",
+    "label": "ISNA - أمريكا الشمالية"
+   }
+  ],
+  "shadow_factor_to_madhab": {
+   "1": "Shafi",
+   "2": "Hanafi"
+  },
+  "madhhab_engine_bindings": {
+   "hanafi": {
+    "asr_shadow_factor": 2,
+    "adhan_madhab": "Hanafi",
+    "moonsighting_shafaq": "Abyad"
+   },
+   "maliki": {
+    "asr_shadow_factor": 1,
+    "adhan_madhab": "Shafi",
+    "moonsighting_shafaq": "Ahmer"
+   },
+   "shafii": {
+    "asr_shadow_factor": 1,
+    "adhan_madhab": "Shafi",
+    "moonsighting_shafaq": "Ahmer"
+   },
+   "hanbali": {
+    "asr_shadow_factor": 1,
+    "adhan_madhab": "Shafi",
+    "moonsighting_shafaq": "Ahmer"
+   }
+  },
+  "output_bindings": {
+   "fajr": "fajr",
+   "dhuhr": "dhuhr",
+   "asr": "asr",
+   "maghrib": "maghrib",
+   "isha": "isha"
+  },
+  "period_bindings": {
+   "fajr": {
+    "start": "fajr",
+    "end": "sunrise"
+   },
+   "dhuhr": {
+    "start": "dhuhr",
+    "end": "asr"
+   },
+   "asr": {
+    "start": "asr",
+    "end": "maghrib"
+   },
+   "maghrib": {
+    "start": "maghrib",
+    "end": "isha"
+   },
+   "isha_entry": {
+    "start": "isha",
+    "end": "next_true_dawn"
+   }
+  },
+  "ramadan_interval": {
+   "method": "UmmAlQura",
+   "minutes": 120,
+   "storage_key": "clock_ummalqura_ramadan_v1"
+  },
+  "note_ar": "طريقة الأردن هي الافتراضية، وتستخدم معاملات وزارة الأوقاف المنشورة مع إبقاء صفحة دائرة الإفتاء مرجع المقارنة اليومي. فرق خمس دقائق يخص موعد المغرب في هذه الطريقة ولا يغيّر حد الغروب الشمسي المحسوب. تشمل القائمة جميع الطرق المسماة التي يوفرها Adhan JS 4.4.6 إضافة إلى طريقة الأردن المخصصة. مواقيت الصلاة لا تستبدل الحدود الشمسية المستقلة التي تحرك مؤشر الشمس. المذهب الحنفي يأخذ المثلين للعصر، والمذاهب الثلاثة تأخذ المثل؛ وتضبط طريقة لجنة تحري الهلال نوع الشفق كذلك. خيار رمضان لأم القرى يؤكد يدويًا ولا يستنتج من تقويم تقريبي."
+ },
+ "changelog": [
+  "1.6.0: aliases رسمية للحدود المستخدمة في الفقه والمحرك (fajr, isha_entry_hanafi) كانت مفقودة من boundaries",
+  "1.6.0: كل ثوابت الحل العددي (خطوة المسح، التكرارات، نافذة البحث) انتقلت من solar_engine.js إلى solar_solver",
+  "1.6.0: إضافة height وtimezone لموقع عمّان (height يستهلكه المحرك، وtimezone للمستهلك المستقبلي)",
+  "1.6.0: حقل local_path لمحرك Adhan حتى لا يعتمد التطبيق على CDN وحده",
+  "1.6.0: المدقق validate_registries.js يفحص الاتساق بين هذا الملف وworship_fiqh_registry",
+  "1.6.0: حد last_daylight_hour_start (11/12 من النهار) لعرض ساعة الإجابة يوم الجمعة"
+ ]
 }

hijri_calendar_engine.js

@@ -1,86 +1,76 @@
 'use strict';
 
 // Pure Hijri-calendar matching. UI preferences and Registry access stay in RegistryApp.
-// Calendar facts (months per year, month lengths) are structural; every user/app choice is a parameter.
+// Calendar id, month lengths and scan limits come from hijri_calendar_registry.json via configure().
 globalThis.HijriCalendarEngine = (() => {
- const MS_DAY=86400000;
- const FACTS=Object.freeze({months_per_year:12,month_lengths:Object.freeze([29,30]),max_lunar_year_days:355});
- const SEARCH_HORIZON_DAYS=FACTS.max_lunar_year_days*2;
- const WEEKDAYS=Object.freeze(['sunday','monday','tuesday','wednesday','thursday','friday','saturday']);
- const formatters=new Map();
- let defaults={calendarId:'islamic'};
-
- // RegistryApp may set the calendar from the registry once: configure({calendarId:'islamic-umalqura'}).
- function configure(options={}){defaults={...defaults,...options};return {...defaults};}
- function formatter(calendarId){
-  let f=formatters.get(calendarId);
-  if(!f){f=new Intl.DateTimeFormat('en-US',{calendar:calendarId,year:'numeric',month:'numeric',day:'numeric'});formatters.set(calendarId,f);}
-  return f;
- }
- function validConfirmation(value){
-  if(!value||!Number.isInteger(value.year)||value.year<1||!Number.isInteger(value.month)||value.month<1||value.month>FACTS.months_per_year||!FACTS.month_lengths.includes(value.length)||!/^\d{4}-\d{2}-\d{2}$/.test(value.start||''))return false;
-  const date=new Date(value.start+'T00:00:00Z');return Number.isFinite(date.getTime())&&date.toISOString().slice(0,10)===value.start;
- }
- function parts(ms,{calendarId=defaults.calendarId,offsetDays=0,maxOffsetDays=0,confirmations=[]}={}){
-  try{
-   const actual=new Date(ms),civilStamp=Date.UTC(actual.getFullYear(),actual.getMonth(),actual.getDate());
-   for(const month of confirmations){
-    if(!validConfirmation(month))continue;
-    const elapsed=Math.round((civilStamp-Date.parse(month.start+'T00:00:00Z'))/MS_DAY);
-    if(elapsed>=0&&elapsed<month.length)return {year:month.year,month:month.month,day:elapsed+1,confirmed:true};
+ // Used only when configure() was never called (older callers); the registry always wins.
+ const LEGACY=Object.freeze({calendar_id:'islamic',month_lengths:[29,30],months_per_year:12,max_scan_days:400});
+ let config=null;
+ const cfg=()=>config||LEGACY;
+ const DAY=86400000;
+ const api={
+  configure(registry){
+   const next={calendar_id:registry?.calendar?.calendar_id,month_lengths:registry?.month_lengths,months_per_year:registry?.months_per_year,max_scan_days:registry?.max_scan_days};
+   const valid=typeof next.calendar_id==='string'&&Array.isArray(next.month_lengths)&&next.month_lengths.every(Number.isInteger)&&Number.isInteger(next.months_per_year)&&next.months_per_year>0&&Number.isInteger(next.max_scan_days)&&next.max_scan_days>0;
+   if(!valid)throw new Error('hijri_calendar_registry is incomplete (calendar_id, month_lengths, months_per_year, max_scan_days).');
+   config=Object.freeze(next);return api;
+  },
+  parts(ms,{calendarId=cfg().calendar_id,offsetDays=0,maxOffsetDays=0,confirmations=[]}={}){
+   try{
+    const actual=new Date(ms),civilStamp=Date.UTC(actual.getFullYear(),actual.getMonth(),actual.getDate());
+    for(const month of confirmations){
+     if(!api.validConfirmation(month))continue;
+     const elapsed=Math.round((civilStamp-Date.parse(month.start+'T00:00:00Z'))/DAY);
+     if(elapsed>=0&&elapsed<month.length)return {year:month.year,month:month.month,day:elapsed+1,confirmed:true};
+    }
+    const date=new Date(ms),offset=Number(offsetDays),limit=Number(maxOffsetDays);
+    if(Number.isInteger(offset)&&Number.isFinite(limit)&&Math.abs(offset)<=limit)date.setDate(date.getDate()+offset);
+    const formatted=new Intl.DateTimeFormat('en-US',{calendar:calendarId,year:'numeric',month:'numeric',day:'numeric'}).formatToParts(date);
+    const value=type=>Number(formatted.find(part=>part.type===type)?.value);
+    const result={year:value('year'),month:value('month'),day:value('day')};
+    return Object.values(result).every(Number.isFinite)?result:null;
+   }catch{return null;}
+  },
+  // The Hijri day begins at sunset: from sunsetMs onward the date is the next civil day's Hijri date.
+  // sunsetMs comes from the solar engine; this module stays free of solar geometry.
+  partsAtSunset(ms,sunsetMs,options={}){
+   if(!Number.isFinite(sunsetMs)||ms<sunsetMs)return api.parts(ms,options);
+   const next=new Date(ms);next.setDate(next.getDate()+1);
+   return api.parts(next.getTime(),options);
+  },
+  matches(event,ms,{parts,forBlocking=false}={}){
+   const calendar=event?.calendar_rule||{};
+   if(calendar.type==='daily')return true;
+   if(calendar.type==='weekly'){
+    const weekday=new Intl.DateTimeFormat('en-US',{weekday:'long'}).format(new Date(ms)).toLowerCase();
+    return calendar.weekday===weekday;
    }
-   const date=new Date(ms),offset=Number(offsetDays),limit=Number(maxOffsetDays);
-   if(Number.isInteger(offset)&&Number.isFinite(limit)&&Math.abs(offset)<=limit)date.setDate(date.getDate()+offset);
-   const formatted=formatter(calendarId).formatToParts(date);
-   const value=type=>Number(formatted.find(part=>part.type===type)?.value);
-   const result={year:value('year'),month:value('month'),day:value('day')};
-   return Object.values(result).every(Number.isFinite)?result:null;
-  }catch{return null;}
- }
- // The Hijri day begins at sunset: from sunsetMs onward the date belongs to the next civil day.
- function partsAtSunset(ms,sunsetMs,options={}){
-  if(!Number.isFinite(sunsetMs)||ms<sunsetMs)return parts(ms,options);
-  const next=new Date(ms);next.setDate(next.getDate()+1);
-  return parts(next.getTime(),options);
- }
- const civilNoon=(ms,shiftDays=0)=>{const d=new Date(ms);return new Date(d.getFullYear(),d.getMonth(),d.getDate()+shiftDays,12).getTime();};
- // Month containing ms: {year,month,day,length,startMs,endMs} with civil-noon stamps for the first and last day.
- function monthInfo(ms,options={}){
-  const here=parts(ms,options);if(!here)return null;
-  const startMs=civilNoon(ms,-(here.day-1));
-  let length=here.day;
-  for(let i=1;i<=FACTS.month_lengths[FACTS.month_lengths.length-1]+1;i++){
-   const next=parts(civilNoon(ms,i),options);
-   if(!next||next.month!==here.month)break;
-   length=next.day;
-  }
-  return {year:here.year,month:here.month,day:here.day,length,startMs,endMs:civilNoon(startMs,length-1)};
- }
- // First civil day (noon stamp) from fromMs on whose Hijri date is {month,day}. month: number|null (any),
- // day: number|'last'. Returns {ms,hijri} or null (e.g. day 30 in a 29-day month is skipped).
- function nextOccurrence({month=null,day},fromMs,options={}){
-  for(let i=0;i<=SEARCH_HORIZON_DAYS;i++){
-   const stamp=civilNoon(fromMs,i),h=parts(stamp,options);
-   if(!h||(month!=null&&h.month!==Number(month)))continue;
-   if(day==='last'){const tomorrow=parts(civilNoon(stamp,1),options);if(tomorrow&&tomorrow.month!==h.month)return {ms:stamp,hijri:h};}
-   else if(h.day===Number(day))return {ms:stamp,hijri:h};
+   if(calendar.calendar!=='hijri')return !calendar.type;
+   const hijri=typeof parts==='function'?parts(ms):null;if(!hijri)return false;
+   if(calendar.requires_month_confirmation&&!forBlocking&&hijri.confirmed!==true)return false;
+   if(calendar.month!=='every'&&calendar.month!=null&&Number(calendar.month)!==hijri.month)return false;
+   if(Array.isArray(calendar.days)&&!calendar.days.map(Number).includes(hijri.day))return false;
+   if(calendar.day!=null&&Number(calendar.day)!==hijri.day)return false;
+   if(Array.isArray(calendar.day_range)&&(hijri.day<Number(calendar.day_range[0])||hijri.day>Number(calendar.day_range[1])))return false;
+   if(Array.isArray(calendar.night_range)&&(hijri.day<Number(calendar.night_range[0])||hijri.day>Number(calendar.night_range[1])))return false;
+   if(Array.isArray(calendar.odd_nights)&&!calendar.odd_nights.map(Number).includes(hijri.day))return false;
+   return true;
+  },
+  // For rules that carry a bare calendar_rule (worship_fiqh_registry): same semantics as matches().
+  ruleActive(calendarRule,ms,context={}){return api.matches({calendar_rule:calendarRule},ms,context);},
+  // First civil day (local noon) at or after fromMs on which the event matches, scanning at most max_scan_days.
+  nextOccurrence(event,fromMs,{parts,forBlocking=false}={}){
+   const start=new Date(fromMs);start.setHours(12,0,0,0);
+   for(let i=0;i<cfg().max_scan_days;i++){
+    const day=new Date(start);day.setDate(start.getDate()+i);
+    if(api.matches(event,day.getTime(),{parts,forBlocking}))return day.getTime();
+   }
+   return null;
+  },
+  validConfirmation(value){
+   if(!value||!Number.isInteger(value.year)||value.year<1||!Number.isInteger(value.month)||value.month<1||value.month>cfg().months_per_year||!cfg().month_lengths.includes(value.length)||!/^\d{4}-\d{2}-\d{2}$/.test(value.start||''))return false;
+   const date=new Date(value.start+'T00:00:00Z');return Number.isFinite(date.getTime())&&date.toISOString().slice(0,10)===value.start;
   }
-  return null;
- }
- function matches(event,ms,{parts:resolveParts,forBlocking=false}={}){
-  const calendar=event?.calendar_rule||{};
-  if(calendar.type==='daily')return true;
-  if(calendar.type==='weekly')return calendar.weekday===WEEKDAYS[new Date(ms).getDay()];
-  if(calendar.calendar!=='hijri')return !calendar.type;
-  const hijri=typeof resolveParts==='function'?resolveParts(ms):null;if(!hijri)return false;
-  if(calendar.requires_month_confirmation&&!forBlocking&&hijri.confirmed!==true)return false;
-  if(calendar.month!=='every'&&calendar.month!=null&&Number(calendar.month)!==hijri.month)return false;
-  if(Array.isArray(calendar.days)&&!calendar.days.map(Number).includes(hijri.day))return false;
-  if(calendar.day!=null&&Number(calendar.day)!==hijri.day)return false;
-  if(Array.isArray(calendar.day_range)&&(hijri.day<Number(calendar.day_range[0])||hijri.day>Number(calendar.day_range[1])))return false;
-  if(Array.isArray(calendar.night_range)&&(hijri.day<Number(calendar.night_range[0])||hijri.day>Number(calendar.night_range[1])))return false;
-  if(Array.isArray(calendar.odd_nights)&&!calendar.odd_nights.map(Number).includes(hijri.day))return false;
-  return true;
- }
- return Object.freeze({version:'2.0.0',FACTS,configure,parts,partsAtSunset,monthInfo,nextOccurrence,matches,validConfirmation});
+ };
+ return Object.freeze(api);
 })();

hijri_calendar_registry.json

@@ -0,0 +1,21 @@
+{
+ "schema_name": "islamic_clock_hijri_calendar_registry",
+ "schema_version": "1.0.0",
+ "registry_id": "hijri_calendar",
+ "purpose": "إعدادات محرك التقويم الهجري. لا يحتوي أحكامًا ولا مناسبات.",
+ "calendar": {
+  "calendar_id": "islamic",
+  "alternatives": [
+   { "id": "islamic-umalqura", "label": "أم القرى" },
+   { "id": "islamic-civil", "label": "الجدولي المدني" },
+   { "id": "islamic-tbla", "label": "الجدولي الفلكي" },
+   { "id": "islamic-rgsa", "label": "الرؤية السعودية (تقريبي)" }
+  ],
+  "note_ar": "التقويم المحسوب تقدير. ثبوت بداية الشهر يكون بالرؤية أو إعلان الجهة المعتمدة، وتُدخَل نتيجته عبر confirmations في المحرك فتتقدم على الحساب."
+ },
+ "day_starts_at": "maghrib",
+ "month_lengths": [29, 30],
+ "months_per_year": 12,
+ "max_scan_days": 400,
+ "validation": { "no_rulings": true, "no_events": true }
+}

solar_engine.js

@@ -1,26 +1,19 @@
-// Astronomy Engine API adapter. UTC is used internally.
-// Every threshold and every numeric solver setting is read from fiqh_time_registry.json
-// (calculation_profile.solar_solver). Only unit conversions live in this file.
+// Astronomy Engine 2.1.19 API adapter. UTC is used internally.
+// All display/ruling thresholds are read from fiqh_time_registry.json.
 globalThis.SolarEngine = (() => {
- const H=3600000, D=24*H, MIN=60000, TURN=360, rad=Math.PI/(TURN/2);
- const REQUIRED_SOLVER=['time_tolerance_ms','derivative_sample_ms','scan_step_ms','bisect_iterations','maximum_iterations',
-  'transition_iterations','noon_search_half_window_ms','crossing_window_ms','alias_passes'];
- let solverCfg=null;
+ // Unit conversions only. Every tolerance, step and iteration count comes from
+ // profile.solar_solver in fiqh_time_registry.json (see configure()).
+ const H=3600000, D=24*H, rad=Math.PI/180, MIN=60000;
+ const WEEKDAYS=['sunday','monday','tuesday','wednesday','thursday','friday','saturday'];
+ let solver=null,api=null;
+ const need=key=>{const v=Number(solver?.[key]);if(!(v>0))throw new Error('solar_solver.'+key+' is missing in fiqh_time_registry.json (SolarEngine.configure(profile.solar_solver))');return v;};
+ const configure=config=>{solver=config||null;return api;};
  const ready=()=>Boolean(globalThis.Astronomy?.Equator&&globalThis.Astronomy?.Horizon);
- function readSolver(solver){
-  if(!solver)return null;
-  return REQUIRED_SOLVER.every(key=>Number(solver[key])>0)?solver:null;
- }
- // Call once with profile.solar_solver; day() also does this automatically.
- function configure(solver){solverCfg=readSolver(solver);return Boolean(solverCfg);}
- const noonGuess=(day,loc)=>day+D/2-loc.lng/TURN*D;
- const observerFor=loc=>new globalThis.Astronomy.Observer(loc.lat,loc.lng,loc.height||0);
-
  function position(ms,loc){
   if(!ready())return null;
-  const A=globalThis.Astronomy,date=new Date(ms),observer=observerFor(loc);
+  const A=globalThis.Astronomy,date=new Date(ms),observer=new A.Observer(loc.lat,loc.lng,loc.height||0);
   const equator=A.Equator(A.Body.Sun,date,observer,true,true);
-  // No extra refraction here: the registry's sunrise/sunset altitude already
+  // No extra refraction here: the registry's -0.833 degree horizon already
   // incorporates the standard apparent limb/refraction allowance.
   const horizon=A.Horizon(date,observer,equator.ra,equator.dec,null);
   return {decl:equator.dec,ra:equator.ra,altitude:horizon.altitude,azimuth:horizon.azimuth};
@@ -28,87 +21,68 @@ globalThis.SolarEngine = (() => {
  function altitude(ms,loc){
   return position(ms,loc)?.altitude??null;
  }
- function maximum(day,loc,cfg=solverCfg){
-  if(!cfg)return null;
-  const guess=noonGuess(day,loc);let lo=guess-cfg.noon_search_half_window_ms,hi=guess+cfg.noon_search_half_window_ms;
-  for(let i=0;i<cfg.maximum_iterations;i++){const a=lo+(hi-lo)/3,b=hi-(hi-lo)/3;if(altitude(a,loc)<altitude(b,loc))lo=a;else hi=b;}
+ function maximum(day,loc){
+  const half=need('half_day_hours')*H,bracket=need('noon_bracket_hours')*H;
+  const guess=day+half-loc.lng/need('longitude_degrees_per_hour')*H;let lo=guess-bracket,hi=guess+bracket;
+  for(let i=0;i<need('maximum_iterations');i++){const a=lo+(hi-lo)/3,b=hi-(hi-lo)/3;if(altitude(a,loc)<altitude(b,loc))lo=a;else hi=b;}
   return (lo+hi)/2;
  }
  // Resolve the sign change of the solar altitude rate. The bracket width is
  // numerical uncertainty, never a religious duration or an offset after noon.
- function transitTransition(day,loc,solver=solverCfg){
-  const cfg=readSolver(solver);if(!cfg)return null;
-  const tolerance=cfg.time_tolerance_ms,sample=cfg.derivative_sample_ms;
-  const guess=noonGuess(day,loc);
+ function transitTransition(day,loc,config){
+  if(config)configure(config);
+  const tolerance=Number(solver?.time_tolerance_ms),sample=Number(solver?.derivative_sample_ms);
+  if(!(tolerance>0&&sample>0))return null;
+  const half=need('half_day_hours')*H,bracket=need('noon_bracket_hours')*H;
+  const guess=day+half-loc.lng/need('longitude_degrees_per_hour')*H;
   const rate=t=>altitude(t+sample/2,loc)-altitude(t-sample/2,loc);
-  let lo=guess-cfg.noon_search_half_window_ms,hi=guess+cfg.noon_search_half_window_ms;
+  let lo=guess-bracket,hi=guess+bracket;
   if(!(rate(lo)>0&&rate(hi)<0))return null;
-  for(let i=0;i<cfg.transition_iterations&&hi-lo>tolerance;i++){
+  for(let i=0;i<need('transit_iterations')&&hi-lo>tolerance;i++){
    const mid=(lo+hi)/2;if(rate(mid)<0)hi=mid;else lo=mid;
   }
   if(!(rate(hi)<0))return null;
   return {at:(lo+hi)/2,after:hi,before:lo,uncertainty_ms:hi-lo};
  }
- // Fast exact search through Astronomy.SearchAltitude (geometric altitude, same
- // convention as position()); the sampled scan below remains the reference path.
- function searchAltitude(lo,hi,target,direction,loc){
-  const A=globalThis.Astronomy;
-  try{
-   const hit=A.SearchAltitude(A.Body.Sun,observerFor(loc),direction==='ascending'?1:-1,new Date(lo),(hi-lo)/D,target);
-   const at=hit?hit.date.getTime():null;
-   return {ok:true,at:at!=null&&at>=lo&&at<=hi?at:null};
-  }catch{return {ok:false,at:null};}
- }
- function crossing(lo,hi,target,direction,loc,cfg=solverCfg){
-  if(!cfg)return null;
-  if(cfg.use_astronomy_search_functions&&typeof globalThis.Astronomy?.SearchAltitude==='function'){
-   const fast=searchAltitude(lo,hi,target,direction,loc);
-   if(fast.ok)return fast.at;
-  }
-  const step=cfg.scan_step_ms,rising=direction==='ascending';let prev=lo,pv=altitude(lo,loc)-target;
+ function crossing(lo,hi,target,direction,loc){
+  const step=need('scan_step_ms'),iterations=need('bisect_iterations');
+  const rising=direction==='ascending';let prev=lo,pv=altitude(lo,loc)-target;
+  // hi+1: one millisecond of numerical slack so the final bracket end is tested.
   for(let t=lo+step;t<=hi+1;t=Math.min(t+step,hi)){
    const val=altitude(t,loc)-target;
    if(rising?pv<=0&&val>=0:pv>=0&&val<=0){
-    let a=prev,b=t;for(let j=0;j<cfg.bisect_iterations;j++){const m=(a+b)/2,v=altitude(m,loc)-target;if(rising?v<0:v>0)a=m;else b=m;}return(a+b)/2;
+    let a=prev,b=t;for(let j=0;j<iterations;j++){const m=(a+b)/2,v=altitude(m,loc)-target;if(rising?v<0:v>0)a=m;else b=m;}return(a+b)/2;
    }
    if(t===hi)break;prev=t;pv=val;
   }
   return null;
  }
- // normal | always_up | always_down, from the registry's sunrise altitude. Lets the UI
- // explain why twilight/sunrise boundaries are unavailable instead of showing nothing.
- function polarState(noon,loc,profile){
-  const horizon=profile?.boundaries?.sunrise?.degrees;
-  if(!Number.isFinite(horizon)||!Number.isFinite(noon))return null;
-  const top=altitude(noon,loc),bottom=altitude(noon+D/2,loc);
-  if(top==null||bottom==null)return null;
-  return bottom>horizon?'always_up':top<horizon?'always_down':'normal';
- }
  function day(day,loc,profile,worship,madhhab){
-  if(!ready())return {day,boundaries:{},engineUnavailable:true,reason:'astronomy_engine_missing'};
-  const cfg=readSolver(profile.solar_solver);
-  if(!cfg)return {day,boundaries:{},engineUnavailable:true,reason:'solver_config_missing'};
-  solverCfg=cfg;
-  const transition=transitTransition(day,loc,cfg);
-  const noon=transition?.at??maximum(day,loc,cfg), out={}, defs=profile.boundaries, win=cfg.crossing_window_ms;
+  if(!ready())return {day,boundaries:{},engineUnavailable:true};
+  configure(profile.solar_solver);
+  if(!worship?.madhhabs?.[madhhab])throw new Error('Unknown madhhab: '+madhhab);
+  const half=need('half_day_hours')*H;
+  const transition=transitTransition(day,loc,profile.solar_solver);
+  const noon=transition?.at??maximum(day,loc), out={}, defs=profile.boundaries, warnings=[];
+  if(!transition)warnings.push('transit_unresolved');
   const basic=(id,def)=>{
    if(def.op==='maximum')return noon;
    if(def.op==='post_transit_transition')return transition?.after??null;
-   if(def.op==='altitude')return crossing(def.direction==='ascending'?noon-win:noon,def.direction==='ascending'?noon:noon+win,def.degrees,def.direction,loc,cfg);
-   if(def.op==='altitude_drop')return crossing(noon,noon+win,altitude(noon,loc)-def.degrees,'descending',loc,cfg);
+   if(def.op==='altitude')return crossing(def.direction==='ascending'?noon-half:noon,def.direction==='ascending'?noon:noon+half,def.degrees,def.direction,loc);
+   if(def.op==='altitude_drop')return crossing(noon,noon+half,altitude(noon,loc)-def.degrees,'descending',loc);
    if(def.op==='shadow'){
     const peak=altitude(noon,loc);if(peak<=0)return null;
     const target=Math.atan(1/(def.factor+1/Math.tan(peak*rad)))/rad;
-    return crossing(noon,noon+win,target,'descending',loc,cfg);
+    return crossing(noon,noon+half,target,'descending',loc);
    }
    return null;
   };
   Object.entries(defs).forEach(([id,def])=>{out[id]=basic(id,def)});
-  const nextNoon=maximum(day+D,loc,cfg);
-  for(let pass=0;pass<cfg.alias_passes;pass++)Object.entries(defs).forEach(([id,def])=>{
+  const nextNoon=maximum(day+D,loc);
+  for(let pass=0;pass<need('dependency_passes');pass++)Object.entries(defs).forEach(([id,def])=>{
    if(def.op==='alias')out[id]=out[def.boundary]??null;
    if(def.op==='next_day'){
-    const target=defs[def.boundary];out[id]=target?.op==='altitude'?crossing(nextNoon-win,nextNoon,target.degrees,target.direction,loc,cfg):null;
+    const target=defs[def.boundary];out[id]=target?.op==='altitude'?crossing(nextNoon-half,nextNoon,target.degrees,target.direction,loc):null;
    }
    if(def.op==='rule_start'){
     const rule=worship.rules.find(r=>r.id===def.rule_id),choice=rule?.madhhab?.[madhhab];
@@ -116,34 +90,34 @@ globalThis.SolarEngine = (() => {
    }
    if(def.op==='fraction')out[id]=out[def.from]!=null&&out[def.to]!=null?out[def.from]+def.fraction*(out[def.to]-out[def.from]):null;
   });
-  const unavailable={};
-  Object.entries(defs).forEach(([id,def])=>{if(out[id]==null)unavailable[id]=def.op==='altitude'||def.op==='shadow'||def.op==='next_day'||def.op==='altitude_drop'?'no_crossing':'dependency_missing';});
-  return {day,boundaries:out,solar_transition:transition,polar:polarState(noon,loc,profile),unavailable};
+  // Boundaries that could not be solved (for example twilight at high latitude) are reported, never invented.
+  const unresolved=Object.keys(defs).filter(id=>out[id]==null);
+  return {day,boundaries:out,solar_transition:transition,unresolved,warnings};
  }
- // options.display_estimate_overrides: {[estimateId]:{before_minutes,after_minutes}} (user choice; honoured
- // only for values listed in the estimate's user_choices_before_minutes).
- // options.isRuleActive(rule,dayStamp): lets the calendar layer hide rules that apply only on certain dates.
+ // options.ruleActive(rule, dayStamp): decides rules with a Hijri calendar_rule (the engine itself
+ // resolves weekly/daily rules). options.displayOverrides: {estimateId:{before_minutes}} accepted only
+ // when the value is listed in that estimate's allowed_before_minutes.
  function periods(days,profile,worship,madhhab,styles,scheduleBindings=null,options={}){
-  const out=[];
-  const resolveEstimate=(id,rule)=>{
-   if(!id)return null;
-   const table={...(worship.display_estimates||{}),...(rule.window_display_estimates||{})};
-   let key=id,estimate=table[key];
-   if(estimate?.deprecated_alias_of){key=estimate.deprecated_alias_of;estimate=table[key];}
-   if(!estimate)return null;
-   const override=options.display_estimate_overrides?.[key];
-   if(override&&(!estimate.user_choices_before_minutes||estimate.user_choices_before_minutes.includes(Number(override.before_minutes))))return {...estimate,...override,id:key};
-   return {...estimate,id:key};
+  const {ruleActive=null,displayOverrides=null}=options||{};
+  const lookup=(id,rule)=>id?(worship.display_estimates?.[id]||rule.window_display_estimates?.[id]||null):null;
+  const beforeMinutes=(id,estimate)=>{
+   const want=displayOverrides?.[id]?.before_minutes,allowed=estimate.allowed_before_minutes;
+   return Number.isFinite(want)&&Array.isArray(allowed)&&allowed.includes(want)?want:Number(estimate.before_minutes||0);
   };
+  const out=[];
   for(const d of days){const b=d.boundaries;
    for(const rule of worship.rules){
     const state=styles.category_states[rule.category];if(!state)continue;
-    if(options.isRuleActive&&!options.isRuleActive(rule,d.day))continue;
+    const calendar=rule.calendar_rule;
+    if(calendar){
+     if(calendar.type==='weekly'){if(calendar.weekday!==WEEKDAYS[new Date(d.day).getUTCDay()])continue;}
+     else if(calendar.type!=='daily'&&!(typeof ruleActive==='function'&&ruleActive(rule,d.day)))continue;
+    }
     const choice=rule.madhhab?.[madhhab];const common={...rule.common,...(typeof choice==='object'?choice:{}),...profile.rule_time_bindings?.[rule.id]};
     if(scheduleBindings&&d.methodUnavailable&&state!==styles.category_states.solar_prayer_restriction)continue;
     const scheduled=scheduleBindings?.[rule.id];const windows=scheduled?[scheduled]:(typeof choice==='object'&&choice.windows)||rule.windows||[common];
     for(const w of windows){
-     const weekday=['sunday','monday','tuesday','wednesday','thursday','friday','saturday'][new Date(d.day).getUTCDay()];
+     const weekday=WEEKDAYS[new Date(d.day).getUTCDay()];
      if((w.exclude_weekdays||common.exclude_weekdays||[]).includes(weekday))continue;
      const requires=w.requires||common.requires||rule.trigger?.requires;
      const activation=w.activation||common.activation||(requires?'after_prayer':'boundary');
@@ -151,10 +125,10 @@ globalThis.SolarEngine = (() => {
      // Preserve the chosen school's outer limit, not a fabricated universal end.
      const endId=w.end||common.end||w.outer_end||common.outer_end||w.necessity_end||common.necessity_end||rule.trigger?.end;
      let start=b[startId],end=b[endId];
-     const estimate=resolveEstimate(w.display_estimate_id,rule);
-     if(estimate){const center=b[estimate.boundary];if(center!=null){start=center-Number(estimate.before_minutes||0)*MIN;end=center+Number(estimate.after_minutes||0)*MIN;}}
-     const endEstimate=resolveEstimate(w.display_end_estimate_id||common.display_end_estimate_id,rule);
-     if(endEstimate){const center=b[endEstimate.boundary];if(center!=null)end=center-Number(endEstimate.before_minutes||0)*MIN;}
+     const estimateId=w.display_estimate_id,estimate=lookup(estimateId,rule);
+     if(estimate){const center=b[estimate.boundary];if(center!=null){start=center-beforeMinutes(estimateId,estimate)*MIN;end=center+Number(estimate.after_minutes||0)*MIN;}}
+     const endEstimateId=w.display_end_estimate_id||common.display_end_estimate_id,endEstimate=lookup(endEstimateId,rule);
+     if(endEstimate){const center=b[endEstimate.boundary];if(center!=null)end=center-beforeMinutes(endEstimateId,endEstimate)*MIN;}
      if(start!=null&&end!=null&&end>=start){
       const row={id:rule.id,start,end,point:!estimate&&!endEstimate&&(end===start||Boolean(profile.boundaries[endId]?.transition_only)),startId,endId,state,rule,day:d.day,calculationMethod:scheduled?d.calculationMethod:null,conditional:rule.category==='prayer_restriction'||activation==='after_prayer'||Boolean(requires),requires,activation,displayEstimate:estimate||null,displayEndEstimate:endEstimate||null};out.push(row);
       for(const binding of styles.preference_bindings||[]){
@@ -170,5 +144,6 @@ globalThis.SolarEngine = (() => {
   }
   return out;
  }
- return {version:'2.0.0',ready,configure,position,altitude,maximum,transitTransition,crossing,polarState,day,periods};
+ api=Object.freeze({ready,configure,position,altitude,maximum,transitTransition,crossing,day,periods});
+ return api;
 })();

validate_registries.js

@@ -1,87 +1,71 @@
 #!/usr/bin/env node
-/* فحص الإحالات المتقاطعة بين fiqh_time_registry وworship_fiqh_registry وsky_simulation_registry.
-   الاستخدام: node validate_registries.js [مجلد السجلات]   (يخرج برمز 1 عند وجود أخطاء) */
-const fs = require("fs"), path = require("path");
-const dir = process.argv[2] || ".";
-const read = (name) => JSON.parse(fs.readFileSync(path.join(dir, name), "utf8"));
-const time = read("fiqh_time_registry.json"), worship = read("worship_fiqh_registry.json"), sky = read("sky_simulation_registry.json");
+'use strict';
+/* مدقّق اتساق بين fiqh_time_registry و worship_fiqh_registry (ومحاكاة قرارات solar_engine.js).
+   الاستعمال:  node validate_registries.js [المجلد]   — يُرجع رمز خروج 1 عند وجود أخطاء. */
+const fs = require('fs'), path = require('path');
+const dir = process.argv[2] || '.';
+const load = (name) => JSON.parse(fs.readFileSync(path.join(dir, name), 'utf8'));
 const errors = [], warnings = [];
 const err = (m) => errors.push(m), warn = (m) => warnings.push(m);
 
+const time = load('fiqh_time_registry.json');
+const worship = load('worship_fiqh_registry.json');
 const profile = time.calculation_profile;
-const docIds = new Set(time.boundaries.map((b) => b.id));
-const opIds = new Set(Object.keys(profile.boundaries));
-const known = new Set([...docIds, ...opIds]);
-const relationIds = new Set(Object.keys(profile.relation_bindings || {}));
-const dup = (list, label) => { const s = new Set(); list.forEach((x) => { if (s.has(x)) err(`${label}: معرّف مكرر ${x}`); s.add(x); }); };
+const boundaryIds = new Set(time.boundaries.map((b) => b.id));
+const aliasIds = new Set(Object.keys(time.aliases || {}));
+const known = (id) => boundaryIds.has(id) || aliasIds.has(id);
 
-dup(time.boundaries.map((b) => b.id), "fiqh_time.boundaries");
-dup(worship.rules.map((r) => r.id), "worship.rules");
-
-/* fiqh_time: الترتيب والنوافذ المشتقة */
-time.ordering.forEach((id) => { if (!docIds.has(id)) err(`ordering: ${id} غير معرّف في boundaries`); });
-time.boundaries.forEach((b) => { if (!time.ordering.includes(b.id)) warn(`boundaries: ${b.id} غير موجود في ordering`); });
-time.derived_windows.forEach((w) => [w.start, w.end].forEach((id) => { if (!docIds.has(id)) err(`derived_windows ${w.id}: ${id} غير معرّف`); }));
-time.boundaries.forEach((b) => { if (b.source === "astronomy_engine" && !opIds.has(b.id) && !(time.calculation_profile.observational_limits && b.id in time.calculation_profile.observational_limits)) warn(`${b.id}: مصدره astronomy_engine بلا op في calculation_profile.boundaries (سيبقى null دائمًا)`); });
-Object.entries(profile.boundaries).forEach(([id, def]) => {
-  if (def.op === "alias" && !known.has(def.boundary)) err(`op alias ${id}: الهدف ${def.boundary} غير معرّف`);
-  if (def.op === "next_day" && !opIds.has(def.boundary)) err(`op next_day ${id}: الهدف ${def.boundary} بلا op`);
-  if (def.op === "fraction") [def.from, def.to].forEach((x) => { if (!opIds.has(x)) err(`op fraction ${id}: ${x} بلا op`); });
-  if (def.op === "rule_start" && !worship.rules.some((r) => r.id === def.rule_id)) err(`op rule_start ${id}: القاعدة ${def.rule_id} غير موجودة`);
-  if (def.op === "shadow" && !Number.isFinite(def.factor)) err(`op shadow ${id}: factor مفقود`);
-  if (def.op === "altitude" && !(Number.isFinite(def.degrees) && ["ascending", "descending"].includes(def.direction))) err(`op altitude ${id}: degrees/direction غير صالحة`);
-});
-Object.entries(profile.relation_bindings || {}).forEach(([k, v]) => [].concat(v).forEach((id) => { if (!known.has(id)) err(`relation_bindings.${k}: ${id} غير معرّف`); }));
-Object.entries(profile.notice_runtime.trigger_bindings).forEach(([k, v]) => { if (!known.has(v.boundary)) err(`trigger_bindings.${k}: ${v.boundary} غير معرّف`); });
-Object.entries(profile.rule_time_bindings || {}).forEach(([k]) => { if (!worship.rules.some((r) => r.id === k)) warn(`rule_time_bindings.${k}: لا توجد قاعدة بهذا المعرّف`); });
-if (!opIds.has(time.daily_cycle.anchor)) {
-  const fb = time.daily_cycle.anchor_fallback;
-  if (fb && opIds.has(fb)) { /* مغطّى بالاحتياط */ }
-  else warn(`daily_cycle.anchor = ${time.daily_cycle.anchor} لا يملك op ولا anchor_fallback صالحًا، فقيمته null دائمًا`);
+/* ---- fiqh_time_registry ---- */
+const seen = new Set();
+for (const b of time.boundaries) { if (seen.has(b.id)) err(`time: معرّف حد مكرر ${b.id}`); seen.add(b.id); }
+for (const id of time.ordering) if (!known(id)) err(`time.ordering: ${id} غير معرّف`);
+for (const b of time.boundaries) if (!time.ordering.includes(b.id)) warn(`time.ordering: الحد ${b.id} غير مرتّب`);
+for (const [id, def] of Object.entries(profile.boundaries)) {
+  if (!known(id)) err(`profile.boundaries: ${id} غير موجود في boundaries أو aliases`);
+  for (const key of ['boundary', 'from', 'to']) if (def[key] && !known(def[key]) && !profile.boundaries[def[key]]) err(`profile.boundaries.${id}.${key}: ${def[key]} غير معرّف`);
+  if (def.op === 'rule_start' && !worship.rules.some((r) => r.id === def.rule_id)) err(`profile.boundaries.${id}: القاعدة ${def.rule_id} غير موجودة في worship`);
 }
+for (const [k, v] of Object.entries(profile.relation_bindings || {})) for (const id of [].concat(v)) if (!known(id) && !profile.boundaries[id]) err(`relation_bindings.${k}: ${id} غير معرّف`);
+for (const rid of Object.keys(profile.rule_time_bindings || {})) if (!worship.rules.some((r) => r.id === rid)) err(`rule_time_bindings: القاعدة ${rid} غير موجودة`);
+for (const key of ['time_tolerance_ms', 'derivative_sample_ms', 'scan_step_ms', 'bisect_iterations', 'maximum_iterations', 'transit_iterations', 'noon_bracket_hours', 'half_day_hours', 'dependency_passes', 'longitude_degrees_per_hour'])
+  if (!(Number(profile.solar_solver?.[key]) > 0)) err(`solar_solver.${key} مفقود أو غير موجب`);
 
-/* worship: كل حدّ مُشار إليه */
-const FIELDS = ["start", "end", "outer_end", "preferred_end", "allowed_to", "necessity_end", "display_start"];
-const estimates = new Set();
-const checkBoundary = (id, where) => { if (id && !known.has(id)) err(`${where}: ${id} غير معرّف`); };
-const checkObj = (o, where) => {
-  if (!o || typeof o !== "object") return;
-  FIELDS.forEach((f) => checkBoundary(o[f], `${where}.${f}`));
-  [o.start_relation, o.end_relation].forEach((r) => { if (r && !relationIds.has(r) && !documentedDescriptive) warn(`${where}: العلاقة ${r} ليست في relation_bindings (علاقة وصفية فقط؟)`); });
-  (o.windows || []).forEach((w, i) => { checkObj(w, `${where}.windows[${i}]`); if (w.display_estimate_id) estimates.add(w.display_estimate_id); });
-};
-let documentedDescriptive = false;
-worship.rules.forEach((r) => {
-  documentedDescriptive = Boolean(r.engine_note_ar);
-  checkObj(r.common, `${r.id}.common`);
-  Object.entries(r.madhhab || {}).forEach(([m, c]) => {
-    if (!worship.madhhabs[m]) err(`${r.id}: مذهب ${m} غير معرّف في madhhabs`);
-    checkObj(c, `${r.id}.${m}`);
-  });
-  Object.keys(worship.madhhabs).forEach((m) => { if (r.madhhab && !r.madhhab[m]) warn(`${r.id}: لا توجد قيمة للمذهب ${m}`); });
-  (r.sources || []).forEach((s) => { if (!worship.sources[s]) err(`${r.id}: المصدر ${s} غير موجود`); });
-  if (r.window_display_estimates) Object.entries(r.window_display_estimates).forEach(([id, e]) => { checkBoundary(e.boundary, `estimate ${id}`); if (e.source_id && !worship.sources[e.source_id]) err(`estimate ${id}: المصدر ${e.source_id} غير موجود`); });
-});
-estimates.forEach((id) => { if (!worship.rules.some((r) => r.window_display_estimates && r.window_display_estimates[id]) && !(worship.display_estimates || {})[id]) err(`display_estimate_id ${id} بلا تعريف`); });
-(worship.required_time_engine_outputs || []).forEach((o) => { if (!opIds.has(o.id)) err(`required_time_engine_outputs: ${o.id} بلا op`); else if (o.factor !== profile.boundaries[o.id].factor) err(`required_time_engine_outputs ${o.id}: العامل لا يطابق op`); });
-Object.values(profile.madhhab_engine_bindings || time.prayer_calculation.madhhab_engine_bindings).forEach(() => {});
-Object.keys(worship.madhhabs).forEach((m) => { if (!time.prayer_calculation.madhhab_engine_bindings[m]) err(`madhhab_engine_bindings: لا يوجد ربط للمذهب ${m}`); });
-Object.keys(time.prayer_calculation.madhhab_engine_bindings).forEach((m) => { if (!worship.madhhabs[m] && !(worship.madhhab_variants || {})[m]) warn(`madhhab_engine_bindings.${m}: ليس مذهبًا ولا نسخة في worship`); });
-Object.entries(worship.madhhab_variants || {}).forEach(([v, def]) => {
-  if (!worship.madhhabs[def.base]) err(`madhhab_variants.${v}: الأساس ${def.base} غير معرّف`);
-  Object.entries(def.overrides || {}).forEach(([rid, o]) => { if (!worship.rules.some((r) => r.id === rid)) err(`madhhab_variants.${v}: القاعدة ${rid} غير موجودة`); checkObj(o, `variant ${v}.${rid}`); });
-  if (!time.prayer_calculation.madhhab_engine_bindings[v]) err(`madhhab_variants.${v}: لا يوجد ربط في madhhab_engine_bindings`);
-});
-/* منع التناقض بين علَم التحقق والواقع */
-const fixedMinutes = JSON.stringify(worship).match(/"(before|after)_minutes"\s*:\s*[1-9]/);
-if (worship.validation.no_fixed_solar_minute_offsets === true && fixedMinutes && !(worship.validation.display_only_estimates || []).length) warn("validation.no_fixed_solar_minute_offsets=true لكن توجد دقائق ثابتة في display_estimates ولم تُعلَن display_only_estimates");
-
-/* sky */
-["sky_color_model", "objects"].forEach((k) => { if (!sky[k]) err(`sky: المفتاح ${k} مفقود`); });
-const stops = (sky.sky_color_model || {}).gradient_stops || [];
-stops.forEach((s, i) => { if (i && !(s.at > stops[i - 1].at)) err(`sky.gradient_stops: الترتيب غير تصاعدي عند ${s.at}`); if (!/^#[0-9a-fA-F]{6}$/.test(s.color)) err(`sky.gradient_stops: لون غير صالح ${s.color}`); });
+/* ---- worship_fiqh_registry ---- */
+const ruleIds = new Set();
+for (const r of worship.rules) { if (ruleIds.has(r.id)) err(`worship: قاعدة مكررة ${r.id}`); ruleIds.add(r.id); }
+const estimateIds = new Set(Object.keys(worship.display_estimates || {}));
+for (const r of worship.rules) for (const id of Object.keys(r.window_display_estimates || {})) estimateIds.add(id);
+const refKeys = ['start', 'end', 'display_start', 'outer_end', 'necessity_end', 'preferred_end', 'allowed_to'];
+const checkRef = (where, id) => { if (id && !known(id) && !profile.boundaries[id]) err(`${where}: الحد ${id} غير معرّف في fiqh_time_registry`); };
+for (const rule of worship.rules) {
+  for (const sid of rule.sources || []) if (!worship.sources[sid]) err(`rule ${rule.id}: المصدر ${sid} غير معرّف`);
+  const scan = (where, o) => { if (!o || typeof o !== 'object') return; for (const k of refKeys) checkRef(`${where}.${k}`, o[k]); for (const k of ['display_estimate_id', 'display_end_estimate_id']) if (o[k] && !estimateIds.has(o[k])) err(`${where}.${k}: التقدير ${o[k]} غير معرّف`); };
+  scan(`rule ${rule.id}.common`, rule.common);
+  for (const [m, choice] of Object.entries(rule.madhhab || {})) {
+    if (!worship.madhhabs[m]) err(`rule ${rule.id}: مذهب غير معرّف ${m}`);
+    scan(`rule ${rule.id}.${m}`, choice);
+    for (const w of (typeof choice === 'object' && choice.windows) || []) scan(`rule ${rule.id}.${m}.window`, w);
+  }
+  /* محاكاة قرار solar_engine.periods() لكل مذهب: هل ينتج صفًا؟ */
+  const needsCalendar = Boolean(rule.calendar_rule);
+  for (const m of Object.keys(worship.madhhabs)) {
+    const choice = rule.madhhab?.[m];
+    const common = { ...rule.common, ...(typeof choice === 'object' ? choice : {}), ...(profile.rule_time_bindings?.[rule.id] || {}) };
+    const windows = (typeof choice === 'object' && choice.windows) || rule.windows || [common];
+    for (const w of windows) {
+      const startId = w.display_start || common.display_start || w.start || common.start || rule.trigger?.start || profile.relation_bindings?.[w.start_relation || common.start_relation];
+      const endId = w.end || common.end || w.outer_end || common.outer_end || w.necessity_end || common.necessity_end || rule.trigger?.end;
+      const estimate = estimateIds.has(w.display_estimate_id);
+      if (!estimate && (!startId || !endId)) err(`rule ${rule.id} [${m}]: لن يُنتج صفًا (بداية=${startId || '∅'} ، نهاية=${endId || '∅'})${needsCalendar ? ' — قاعدة تقويمية' : ''}`);
+    }
+  }
+}
+for (const out of worship.required_time_engine_outputs || []) if (!profile.boundaries[out.id] && !known(out.id)) err(`required_time_engine_outputs: ${out.id} غير معرّف`);
+const used = new Set();
+for (const rule of worship.rules) JSON.stringify(rule, (k, v) => { if (refKeys.includes(k) && typeof v === 'string') used.add(v); return v; });
+for (const id of used) if (known(id) && !(worship.required_time_engine_outputs || []).some((o) => o.id === id) && !profile.boundaries[id] && !aliasIds.has(id) && !time.boundaries.some((b) => b.id === id && b.source !== 'astronomy_engine')) warn(`الحد ${id} مستخدم ولا يظهر في required_time_engine_outputs`);
 
-console.log(`أخطاء: ${errors.length} | تحذيرات: ${warnings.length}`);
-errors.forEach((e) => console.log("خطأ    ", e));
-warnings.forEach((w) => console.log("تحذير  ", w));
+console.log(`أخطاء: ${errors.length}  |  تحذيرات: ${warnings.length}`);
+errors.forEach((e) => console.log('  ✗ ' + e));
+warnings.forEach((w) => console.log('  ! ' + w));
 process.exit(errors.length ? 1 : 0);

worship_event_engine.js

@@ -1,9 +1,6 @@
 'use strict';
 
 // Pure registry scheduler. Solar geometry and religious rules remain in their owners.
-// v2: eclipse search is cached on a day-aligned window (the old key changed every call), the cache is
-//     per event, only real eclipse types are searched, penumbral/excluded subtypes are skipped, and the
-//     visibility altitude comes from the registry's visibility_rule.
 globalThis.WorshipEventEngine = (() => {
  const DAY=86400000,MINUTE=60000;
  const civil=stamp=>{const d=new Date(stamp);return new Date(d.getUTCFullYear(),d.getUTCMonth(),d.getUTCDate(),12);};
@@ -62,42 +59,46 @@ globalThis.WorshipEventEngine = (() => {
   return notices.sort((a,b)=>a.at-b.at||b.priority-a.priority);
  }
  const eclipseCache=new Map();
- const ECLIPSE_FUNCTIONS=['SearchLocalSolarEclipse','SearchLunarEclipse'],ECLIPSE_TYPES=['solar_eclipse','lunar_eclipse'];
- const isEclipseType=type=>ECLIPSE_FUNCTIONS.includes(type.engine_call?.function)||ECLIPSE_TYPES.includes(type.id);
- function visibleInterval(A,body,observer,start,end,minAltitude=0){
-  const altitude=t=>{const d=new Date(t),eq=A.Equator(body,d,observer,true,true);return A.Horizon(d,observer,eq.ra,eq.dec,'normal').altitude;};
+ // Geometric centre altitude: the same convention as Astronomy.SearchAltitude, so the horizon test
+ // and the rise/set search agree (the previous version mixed refracted and geometric altitudes).
+ function visibleInterval(A,body,observer,start,end,minAltitude,epsilon){
+  const altitude=t=>{const d=new Date(t),eq=A.Equator(body,d,observer,true,true);return A.Horizon(d,observer,eq.ra,eq.dec,null).altitude;};
   let first=start;
-  // Conservative center-above-threshold visibility, solved by the same engine.
   if(altitude(first)<=minAltitude){const rise=A.SearchAltitude(body,observer,1,new Date(start),(end-start)/DAY,minAltitude);if(!rise)return null;first=rise.date.getTime();}
-  const set=A.SearchAltitude(body,observer,-1,new Date(first+1000),(end-first)/DAY,minAltitude);
+  const set=A.SearchAltitude(body,observer,-1,new Date(first+epsilon),(end-first)/DAY,minAltitude);
   const last=set?Math.min(end,set.date.getTime()):end;
   return last>first?{start:first,end:last}:null;
  }
+ // Scan limits come from astronomy.defaults.eclipse_scan; the visibility threshold and the excluded
+ // eclipse kinds come from each event type's religious_relation. Missing data means no notice, never a guess.
  function eclipses({astronomy,event,location,start,end,A=globalThis.Astronomy}){
-  if(!A||!location||!event||event.enabled===false||astronomy.enabled===false)return [];
-  // Day-aligned window so repeated (e.g. per-minute) calls reuse the same computation.
-  const from=Math.floor(start/DAY)*DAY-DAY,to=Math.ceil(end/DAY)*DAY+DAY;
-  const cacheKey=JSON.stringify([event.id,location.lat,location.lng,location.height||0,from,to]);let occurrences=eclipseCache.get(cacheKey);
+  const scan=astronomy?.defaults?.eclipse_scan;
+  const complete=scan&&['max_occurrences','lookback_days','cache_limit','epsilon_ms'].every(key=>Number(scan[key])>0);
+  if(!A||!location||!event||event.enabled===false||astronomy.enabled===false||!complete)return [];
+  // Snap to whole days so the cache survives the per-minute calls of the notice loop.
+  const from=Math.floor(start/DAY)*DAY,to=Math.ceil(end/DAY)*DAY;
+  const cacheKey=JSON.stringify([location,from,to]);let occurrences=eclipseCache.get(cacheKey);
   if(!occurrences){
    occurrences=[];const observer=new A.Observer(location.lat,location.lng,location.height||0);
-   for(const type of astronomy.event_types.filter(t=>t.religious_relation?.practice_id===event.id&&t.enabled!==false&&isEclipseType(t))){
+   for(const type of astronomy.event_types.filter(t=>t.religious_relation?.practice_id===event.id&&t.enabled!==false)){
+    const relation=type.religious_relation,rule=relation.visibility_rule;
+    if(!rule||!Number.isFinite(rule.min_altitude_deg))continue;
+    const excluded=(relation.excluded_subtypes||[]).map(kind=>String(kind).toLowerCase());
     try{
-     const solar=type.id==='solar_eclipse',excluded=type.religious_relation?.excluded_subtypes||[];
-     const minAltitude=Number(type.religious_relation?.visibility_rule?.min_altitude_deg??0);
-     let found=solar?A.SearchLocalSolarEclipse(new Date(from),observer):A.SearchLunarEclipse(new Date(from));
-     for(let i=0;i<8;i++){
-      const peak=(solar?found.peak.time:found.peak).date.getTime();if(peak>to)break;
-      const kind=String(found.kind||'').toLowerCase();
-      if(!excluded.includes(kind)){
+     const solar=type.id==='solar_eclipse',origin=new Date(from-scan.lookback_days*DAY);
+     let found=solar?A.SearchLocalSolarEclipse(origin,observer):A.SearchLunarEclipse(origin);
+     for(let i=0;i<scan.max_occurrences;i++){
+      const peak=(solar?found.peak.time:found.peak).date.getTime();if(peak>to+DAY)break;
+      if(!excluded.includes(String(found.kind).toLowerCase())){
        const begin=solar?found.partial_begin.time.date.getTime():peak-found.sd_partial*MINUTE;
        const finish=solar?found.partial_end.time.date.getTime():peak+found.sd_partial*MINUTE;
-       if(finish>=from&&finish>begin){const visible=visibleInterval(A,solar?'Sun':'Moon',observer,begin,finish,minAltitude);if(visible)occurrences.push({typeId:type.id,peak,...visible});}
+       if(finish>=from&&finish>begin){const visible=visibleInterval(A,solar?'Sun':'Moon',observer,begin,finish,rule.min_altitude_deg,scan.epsilon_ms);if(visible)occurrences.push({typeId:type.id,kind:String(found.kind).toLowerCase(),peak,...visible});}
       }
       found=solar?A.NextLocalSolarEclipse(found.peak.time,observer):A.NextLunarEclipse(found.peak);
      }
     }catch{/* No invented eclipse when ephemeris calculation fails. */}
    }
-   eclipseCache.set(cacheKey,occurrences);if(eclipseCache.size>8)eclipseCache.delete(eclipseCache.keys().next().value);
+   eclipseCache.set(cacheKey,occurrences);if(eclipseCache.size>scan.cache_limit)eclipseCache.delete(eclipseCache.keys().next().value);
   }
   const notices=[];
   for(const occurrence of occurrences){

worship_fiqh_registry.json

@@ -1,618 +1,651 @@
 {
-  "schema_name": "islamic_clock_worship_fiqh_registry",
-  "schema_version": "1.3.0",
-  "registry_id": "worship_fiqh",
-  "project": "ساعة المسلم / الخط الزمني الروحي",
-  "language": "ar",
-  "direction": "rtl",
-  "status": "researched_v2_madhhab_restriction_windows",
-  "scope_ar": "أحكام العبادات المرتبطة بالزمن فقط مع الخلاف بين المذاهب الأربعة. لا يملك الحساب الفلكي أو الألوان أو الأيقونات أو منبهات المستخدم.",
-  "architecture_contract": {
-    "time_geometry_owner": "fiqh_time_registry.json",
-    "worship_event_owner": "islamic_events_registry.json",
-    "visual_owner": "visual_states_registry.json",
-    "user_alarm_owner": "user_time_markers_registry.json",
-    "knowledge_owner": "contextual_knowledge_registry.json",
-    "no_fixed_solar_minutes": true
-  },
-  "madhhabs": {
-    "hanafi": "الحنفي",
-    "maliki": "المالكي",
-    "shafii": "الشافعي",
-    "hanbali": "الحنبلي"
-  },
-  "rules": [
-    {
-      "id": "fajr",
-      "category": "obligatory_prayer",
-      "common": {
-        "start": "true_dawn",
-        "end": "sunrise"
-      },
-      "note": "أصل النافذة مشترك؛ درجات الفضيلة والاختيار تفصيل مذهبي."
-    },
-    {
-      "id": "dhuhr",
-      "category": "obligatory_prayer",
-      "common": {
-        "start": "zawal"
-      },
-      "madhhab": {
-        "hanafi": {
-          "end": "asr_shadow_2",
-          "variant": "أبو يوسف ومحمد ورواية عن أبي حنيفة: asr_shadow_1"
-        },
-        "maliki": {
-          "end": "asr_shadow_1"
-        },
-        "shafii": {
-          "end": "asr_shadow_1"
-        },
-        "hanbali": {
-          "end": "asr_shadow_1"
-        }
-      },
-      "sources": [
-        "hanafi_asr",
-        "asr_comparison"
-      ]
-    },
-    {
-      "id": "asr",
-      "category": "obligatory_prayer",
-      "common": {
-        "end": "sunset"
-      },
-      "madhhab": {
-        "hanafi": {
-          "start": "asr_shadow_2",
-          "variant": "أبو يوسف ومحمد ورواية عن أبي حنيفة: asr_shadow_1",
-          "late": "يكره التأخير إلى تغير/اصفرار الشمس بلا عذر"
-        },
-        "maliki": {
-          "start": "asr_shadow_1",
-          "note": "يفصل بين الاختياري والضروري"
-        },
-        "shafii": {
-          "start": "asr_shadow_1",
-          "note": "توجد مراتب للوقت"
-        },
-        "hanbali": {
-          "start": "asr_shadow_1",
-          "note": "وقت اختيار ثم ضرورة إلى الغروب"
-        }
-      },
-      "sources": [
-        "hanafi_asr",
-        "asr_comparison"
-      ]
-    },
-    {
-      "id": "maghrib",
-      "category": "obligatory_prayer",
-      "common": {
-        "start": "sunset"
-      },
-      "madhhab": {
-        "hanafi": {
-          "end": "isha_entry_hanafi"
-        },
-        "maliki": {
-          "end": "red_twilight_end"
-        },
-        "shafii": {
-          "end": "red_twilight_end",
-          "note": "يوجد تفصيل قديم/جديد في المذهب؛ تحفظ الروايات ولا تختزل"
-        },
-        "hanbali": {
-          "end": "red_twilight_end"
-        }
-      },
-      "sources": [
-        "maghrib_shafii",
-        "isha_twilight"
-      ]
-    },
-    {
-      "id": "isha_entry",
-      "category": "obligatory_prayer",
-      "madhhab": {
-        "hanafi": {
-          "start": "white_twilight_end",
-          "variant": "أبو يوسف ومحمد ورواية عن أبي حنيفة: red_twilight_end"
-        },
-        "maliki": {
-          "start": "red_twilight_end"
-        },
-        "shafii": {
-          "start": "red_twilight_end"
-        },
-        "hanbali": {
-          "start": "red_twilight_end"
-        }
-      },
-      "sources": [
-        "isha_twilight"
-      ]
-    },
-    {
-      "id": "isha_periods",
-      "category": "obligatory_prayer",
-      "madhhab": {
-        "hanafi": {
-          "outer_end": "next_true_dawn",
-          "note": "داخل المذهب مراتب فضيلة قبل ذلك"
-        },
-        "maliki": {
-          "preferred_end": "first_third_of_night",
-          "outer_end": "next_true_dawn",
-          "note": "تفصيل الاختياري/الضروري يحفظ في profile المذهب"
-        },
-        "shafii": {
-          "preferred_end": "first_third_of_night",
-          "outer_end": "next_true_dawn"
-        },
-        "hanbali": {
-          "preferred_end": "first_third_of_night",
-          "allowed_to": "islamic_midnight",
-          "necessity_end": "next_true_dawn"
-        }
-      },
-      "sources": [
-        "isha_end",
-        "isha_end_detail"
-      ]
-    },
-    {
-      "id": "duha",
-      "category": "voluntary_prayer",
-      "common": {
-        "start": "sunrise_clear",
-        "end": "solar_noon",
-        "ruling": "recommended",
-        "best_time": "when_sun_is_high_and_heat_has_increased"
-      },
-      "madhhab": {
-        "hanafi": "recommended",
-        "maliki": "recommended",
-        "shafii": "emphasized_sunnah",
-        "hanbali": "recommended"
-      },
-      "implementation": "لا +15 دقيقة بعد الشروق ولا -5 قبل الزوال؛ الحدود من الهندسة الشمسية.",
-      "sources": [
-        "duha"
-      ]
-    },
-    {
-      "id": "witr",
-      "category": "night_prayer",
-      "common": {
-        "start_relation": "after_isha",
-        "end": "next_true_dawn",
-        "preferred": "آخر الليل لمن يثق بالاستيقاظ",
-        "early_option": "قبل النوم لمن يخشى ألا يستيقظ"
-      },
-      "sources": [
-        "witr"
-      ]
-    },
-    {
-      "id": "qiyam",
-      "category": "night_prayer",
-      "common": {
-        "start_relation": "after_isha",
-        "end": "next_true_dawn",
-        "preferred_window": "last_third_start_to_next_true_dawn"
-      },
-      "sources": [
-        "witr",
-        "last_third"
-      ]
-    },
-    {
-      "id": "jumuah",
-      "category": "obligatory_prayer",
-      "madhhab": {
-        "hanafi": {
-          "start": "zawal",
-          "end_relation": "dhuhr_end"
-        },
-        "maliki": {
-          "start": "zawal",
-          "end_relation": "dhuhr_end_with_detail"
-        },
-        "shafii": {
-          "start": "zawal",
-          "end_relation": "dhuhr_end"
-        },
-        "hanbali": {
-          "start_variant": "before_zawal_allowed",
-          "preferred_display": "after_zawal",
-          "end_relation": "asr_entry"
-        }
-      },
-      "sources": [
-        "jumuah"
-      ]
-    },
-    {
-      "id": "after_fajr_nafl_restriction",
-      "category": "prayer_restriction",
-      "scope": "general_voluntary_prayer",
-      "display_policy": "show_without_worship_tracking",
-      "madhhab": {
-        "hanafi": {
-          "activation": "boundary",
-          "start": "true_dawn",
-          "end": "sunrise",
-          "exception": "fajr_sunnah_before_obligatory_prayer"
-        },
-        "maliki": {
-          "activation": "boundary",
-          "start": "true_dawn",
-          "end": "sunrise",
-          "exception": "fajr_sunnah_before_obligatory_prayer"
-        },
-        "shafii": {
-          "activation": "after_prayer",
-          "requires": "fajr_prayer_performed",
-          "display_start": "fajr",
-          "end": "sunrise"
-        },
-        "hanbali": {
-          "activation": "boundary",
-          "start": "true_dawn",
-          "end": "sunrise",
-          "exception": "fajr_sunnah_before_obligatory_prayer",
-          "variant": "رواية: يتعلق النهي بأداء صلاة الفجر"
-        }
-      },
-      "critical": "يختلف بدء النهي: عند الحنفية والمالكية والمشهور عند الحنابلة من طلوع الفجر، وعند الشافعية بعد أداء صلاة الفجر. العرض البرتقالي لا يسجل أداء العبادة.",
-      "note": "تنتهي هذه الطبقة عند الشروق، ثم تبدأ طبقة النهي الشمسي الأحمر إلى ارتفاع الشمس. الاستثناءات المتعلقة بنوع الصلاة تعرض في تفاصيل الحكم ولا تغيّر الحد الزمني العام بلا دليل خاص.",
-      "sources": [
-        "post_prayer_prohibition",
-        "prohibition_comparative",
-        "prohibition_trigger_comparative"
-      ]
-    },
-    {
-      "id": "after_asr_nafl_restriction",
-      "category": "prayer_restriction",
-      "scope": "general_voluntary_prayer",
-      "display_policy": "conditional_window_without_worship_tracking",
-      "common": {
-        "activation": "after_prayer",
-        "requires": "asr_prayer_performed",
-        "display_start": "asr",
-        "end": "sunset_approach"
-      },
-      "madhhab": {
-        "hanafi": {
-          "activation": "after_prayer",
-          "requires": "asr_prayer_performed"
-        },
-        "maliki": {
-          "activation": "after_prayer",
-          "requires": "asr_prayer_performed"
-        },
-        "shafii": {
-          "activation": "after_prayer",
-          "requires": "asr_prayer_performed"
-        },
-        "hanbali": {
-          "activation": "after_prayer",
-          "requires": "asr_prayer_performed"
-        }
-      },
-      "critical": "لا يبدأ الحكم بمجرد دخول وقت العصر، بل بعد أداء صلاة العصر. ولأن التطبيق لا يتتبع أداء الصلاة، تعرض المسطرة نافذة برتقالية مشروطة من دخول العصر، لا حكمًا محققًا على المستخدم.",
-      "note": "تنتهي الطبقة المشروطة عند اقتراب الغروب، ثم تظهر طبقة النهي الشمسي الأحمر حتى الغروب. الاستثناءات وذوات الأسباب تختلف بين المذاهب وتبقى في تفاصيل الحكم.",
-      "sources": [
-        "post_prayer_prohibition",
-        "prohibition_comparative"
-      ]
-    },
-    {
-      "id": "absolute_solar_restrictions",
-      "category": "solar_prayer_restriction",
-      "scope": "absolute_solar_windows",
-      "window_display_estimates": {
-        "zawal_display_window": {
-          "boundary": "solar_noon",
-          "before_minutes": 10,
-          "after_minutes": 0,
-          "user_choices_before_minutes": [
-            10,
-            15
-          ],
-          "settings_key": "zawal_before_minutes",
-          "label_ar": "نافذة عرض قبيل الزوال",
-          "note_ar": "نافذة عرض فقط قبل الزوال: تبدأ قبل الاستواء بالمقدار المختار وتنتهي عند الاستواء. بعد الزوال يدخل وقت الظهر فلا تمتد النافذة بعده. القيمتان 10 و15 خيارا عرض، وليستا حدًّا فلكيًا ولا تحديدًا شرعيًا للمدة؛ الأبحاث المذكورة تقدّر المنطقة القريبة من الزوال عادةً بنحو 5–10 دقائق.",
-          "source_id": "zawal_duration_research"
-        },
-        "zawal_20_minutes": {
-          "deprecated_alias_of": "zawal_display_window"
-        }
-      },
-      "madhhab": {
-        "hanafi": {
-          "windows": [
-            {
-              "start": "sunrise",
-              "end": "sunrise_clear"
-            },
-            {
-              "start": "solar_noon",
-              "end": "zawal",
-              "display_estimate_id": "zawal_display_window"
-            },
-            {
-              "start": "sunset_approach",
-              "end": "sunset"
-            }
-          ],
-          "variant": "رُوي عن أبي يوسف الترخيص في الاستواء يوم الجمعة، وليس هو العرض الافتراضي للمذهب هنا."
-        },
-        "maliki": {
-          "windows": [
-            {
-              "start": "sunrise",
-              "end": "sunrise_clear"
-            },
-            {
-              "start": "sunset_approach",
-              "end": "sunset"
-            }
-          ],
-          "note": "لا تعرض نافذة الاستواء إلى الزوال في الاختيار المالكي."
-        },
-        "shafii": {
-          "windows": [
-            {
-              "start": "sunrise",
-              "end": "sunrise_clear"
-            },
-            {
-              "start": "solar_noon",
-              "end": "zawal",
-              "exclude_weekdays": [
-                "friday"
-              ],
-              "display_estimate_id": "zawal_display_window"
-            },
-            {
-              "start": "sunset_approach",
-              "end": "sunset"
-            }
-          ],
-          "note": "يستثنى الاستواء يوم الجمعة من العرض وفق المعتمد المسجل في المصدر المقارن."
-        },
-        "hanbali": {
-          "windows": [
-            {
-              "start": "sunrise",
-              "end": "sunrise_clear"
-            },
-            {
-              "start": "solar_noon",
-              "end": "zawal",
-              "display_estimate_id": "zawal_display_window"
-            },
-            {
-              "start": "sunset_approach",
-              "end": "sunset"
-            }
-          ]
-        }
-      },
-      "implementation": "الحدود هندسة شمسية بلا دقائق ثابتة؛ نافذة قبيل الزوال سياسة عرض قبل الاستواء فقط وليست بديلًا عن الحد الفلكي، ويمكن للمستخدم اختيار 10 أو 15 دقيقة.",
-      "note": "اختيار النوافذ نفسها مذهبي. تعرض نافذة الزوال بمدة عرض احتياطية قبل الزوال فقط (10 افتراضيًا و15 خيار المستخدم)، مع بيان أن الأبحاث المذكورة تقدر المنطقة الأقرب للزوال عادةً بنحو 5–10 دقائق. أما استثناءات أنواع الصلوات كذوات الأسباب والقضاء والجنازة والطواف فلا تختزل في لون زمني عام، وتعرض في تفاصيل الحكم.",
-      "sources": [
-        "prohibition_comparative",
-        "solar_prohibition",
-        "zawal_duration_research"
-      ]
-    },
-    {
-      "id": "ramadan_fast",
-      "category": "obligatory_fasting",
-      "common": {
-        "start": "true_dawn",
-        "end": "sunset"
-      },
-      "note": "ثبوت بداية الشهر من سلطة التقويم/الرؤية المعتمدة، لا من هذا الملف.",
-      "sources": [
-        "quran_2_187"
-      ]
-    },
-    {
-      "id": "monday_thursday_fast",
-      "category": "recommended_fasting",
-      "common": {
-        "start": "true_dawn",
-        "end": "sunset"
-      },
-      "note": "اختيار اليوم وجدولته من islamic_events_registry.json."
+ "schema_name": "islamic_clock_worship_fiqh_registry",
+ "schema_version": "1.3.0",
+ "registry_id": "worship_fiqh",
+ "project": "ساعة المسلم / الخط الزمني الروحي",
+ "language": "ar",
+ "direction": "rtl",
+ "status": "researched_v2_madhhab_restriction_windows",
+ "scope_ar": "أحكام العبادات المرتبطة بالزمن فقط مع الخلاف بين المذاهب الأربعة. لا يملك الحساب الفلكي أو الألوان أو الأيقونات أو منبهات المستخدم.",
+ "architecture_contract": {
+  "time_geometry_owner": "fiqh_time_registry.json",
+  "worship_event_owner": "islamic_events_registry.json",
+  "visual_owner": "visual_states_registry.json",
+  "user_alarm_owner": "user_time_markers_registry.json",
+  "knowledge_owner": "contextual_knowledge_registry.json",
+  "no_fixed_solar_minutes": true
+ },
+ "madhhabs": {
+  "hanafi": "الحنفي",
+  "maliki": "المالكي",
+  "shafii": "الشافعي",
+  "hanbali": "الحنبلي"
+ },
+ "rules": [
+  {
+   "id": "fajr",
+   "category": "obligatory_prayer",
+   "common": {
+    "start": "true_dawn",
+    "end": "sunrise"
+   },
+   "note": "أصل النافذة مشترك؛ درجات الفضيلة والاختيار تفصيل مذهبي."
+  },
+  {
+   "id": "dhuhr",
+   "category": "obligatory_prayer",
+   "common": {
+    "start": "zawal"
+   },
+   "madhhab": {
+    "hanafi": {
+     "end": "asr_shadow_2",
+     "variant": "أبو يوسف ومحمد ورواية عن أبي حنيفة: asr_shadow_1"
+    },
+    "maliki": {
+     "end": "asr_shadow_1"
+    },
+    "shafii": {
+     "end": "asr_shadow_1"
+    },
+    "hanbali": {
+     "end": "asr_shadow_1"
     }
-  ],
-  "required_time_engine_outputs": [
-    {
-      "id": "asr_shadow_1",
-      "type": "shadow_factor",
-      "factor": 1,
-      "exclude_noon_shadow": true
-    },
-    {
-      "id": "asr_shadow_2",
-      "type": "shadow_factor",
-      "factor": 2,
-      "exclude_noon_shadow": true
-    },
-    {
-      "id": "first_third_of_night",
-      "type": "derived_night_fraction",
-      "fraction": "1/3",
-      "from": "sunset",
-      "to": "next_true_dawn"
+   },
+   "sources": [
+    "hanafi_asr",
+    "asr_comparison"
+   ]
+  },
+  {
+   "id": "asr",
+   "category": "obligatory_prayer",
+   "common": {
+    "end": "sunset"
+   },
+   "madhhab": {
+    "hanafi": {
+     "start": "asr_shadow_2",
+     "variant": "أبو يوسف ومحمد ورواية عن أبي حنيفة: asr_shadow_1",
+     "late": "يكره التأخير إلى تغير/اصفرار الشمس بلا عذر"
+    },
+    "maliki": {
+     "start": "asr_shadow_1",
+     "note": "يفصل بين الاختياري والضروري"
+    },
+    "shafii": {
+     "start": "asr_shadow_1",
+     "note": "توجد مراتب للوقت"
+    },
+    "hanbali": {
+     "start": "asr_shadow_1",
+     "note": "وقت اختيار ثم ضرورة إلى الغروب"
     }
-  ],
-  "sources": {
-    "hanafi_asr": {
-      "title": "نقول حنفية في المثل والمثلين",
-      "url": "https://islamqa.org/hanafi/darul-iftaa-chicago/271053/"
-    },
-    "asr_comparison": {
-      "title": "الفرق بين الحنفية والجمهور في أول العصر",
-      "url": "https://islamqa.info/ar/answers/220820"
-    },
-    "maghrib_shafii": {
-      "title": "دائرة الإفتاء الأردنية — وقت المغرب",
-      "url": "https://aliftaa.jo/fatwa/3399/CatQuestion.aspx?Id=133"
-    },
-    "isha_twilight": {
-      "title": "الموسوعة الفقهية — الشفق ووقت العشاء",
-      "url": "https://dorar.net/feqhia/846/"
-    },
-    "isha_end": {
-      "title": "وقت خروج العشاء في المذاهب الأربعة",
-      "url": "https://www.islamweb.org/ar/fatwa/71957/"
-    },
-    "isha_end_detail": {
-      "title": "تفصيل آخر وقت العشاء",
-      "url": "https://www.alqayim.org/ar/fatwa/1971"
-    },
-    "duha": {
-      "title": "الموسوعة الفقهية — صلاة الضحى",
-      "url": "https://dorar.net/feqhia/1261/"
-    },
-    "witr": {
-      "title": "الموسوعة الفقهية — أفضل وقت للوتر",
-      "url": "https://dorar.net/feqhia/1241/"
-    },
-    "last_third": {
-      "title": "صحيح البخاري 1145",
-      "url": "https://sunnah.com/bukhari:1145"
-    },
-    "jumuah": {
-      "title": "مذاهب العلماء في وقت الجمعة",
-      "url": "https://islamweb.net/ar/fatwa/23917/"
-    },
-    "post_prayer_prohibition": {
-      "title": "صحيح مسلم 827",
-      "url": "https://sunnah.com/muslim:827"
-    },
-    "prohibition_comparative": {
-      "title": "بحث مقارن في أوقات النهي",
-      "url": "https://islamport.com/l/msl/3529/9.htm"
-    },
-    "prohibition_trigger_comparative": {
-      "title": "بحث مقارن في تعلق نهي الفجر بطلوعه أو بأداء الصلاة",
-      "url": "https://islamport.com/l/msl/3529/17.htm"
-    },
-    "solar_prohibition": {
-      "title": "صحيح مسلم 831",
-      "url": "https://sunnah.com/muslim:831"
-    },
-    "zawal_duration_research": {
-      "title": "تقدير المدة القريبة من الزوال وبيان أنها غير ثابتة بعشرين دقيقة",
-      "url": "https://saadalkhathlan.com/scientific-series/lessons/32181"
-    },
-    "quran_2_187": {
-      "title": "البقرة 187",
-      "reference": "Quran 2:187"
+   },
+   "sources": [
+    "hanafi_asr",
+    "asr_comparison"
+   ]
+  },
+  {
+   "id": "maghrib",
+   "category": "obligatory_prayer",
+   "common": {
+    "start": "sunset"
+   },
+   "madhhab": {
+    "hanafi": {
+     "end": "isha_entry_hanafi"
+    },
+    "maliki": {
+     "end": "red_twilight_end"
+    },
+    "shafii": {
+     "end": "red_twilight_end",
+     "note": "يوجد تفصيل قديم/جديد في المذهب؛ تحفظ الروايات ولا تختزل"
+    },
+    "hanbali": {
+     "end": "red_twilight_end"
     }
+   },
+   "sources": [
+    "maghrib_shafii",
+    "isha_twilight"
+   ]
   },
-  "validation": {
-    "worship_only": true,
-    "no_colors": true,
-    "no_emoji": true,
-    "no_user_alarms": true,
-    "no_completion_tracking": true,
-    "no_fixed_solar_minute_offsets": true,
-    "preserve_madhhab_variants": true,
-    "proposed_rules_not_consumed_by_periods": true
-  },
-  "research_note": "هذه طبقة بيانات للتطبيق وليست فتوى شخصية. حيث لم تكف المصادر لإغلاق تفصيل مذهبي دقيق، أبقي التفصيل معلّقًا بدل اختراع قيمة.",
-  "changelog": [
-    "1.3.0: تصحيح نافذة الزوال: كانت ±10 دقائق حول الاستواء وتشمل عشر دقائق بعد دخول وقت الظهر؛ أصبحت قبل الزوال فقط (10 افتراضيًا، 15 خيار المستخدم)",
-    "1.3.0: معرّف النافذة zawal_display_window وبقاء الاسم القديم كمرادف مهجور",
-    "1.3.0: أحكام مقترحة غير مفعّلة في proposed_rules حتى توثيق المصادر وربط التفعيل بسجل الأحداث"
-  ],
-  "proposed_rules": [
-    {
-      "id": "eid_prayer",
-      "category": "festival_prayer",
-      "status": "proposed_not_consumed",
-      "activation": {
-        "owner": "islamic_events_registry.json",
-        "note_ar": "تُفعَّل في يومي العيد فقط من سجل الأحداث، ولا تُعرض يوميًا."
-      },
-      "common": {
-        "start": "sunrise_clear",
-        "end": "zawal"
+  {
+   "id": "isha_entry",
+   "category": "obligatory_prayer",
+   "madhhab": {
+    "hanafi": {
+     "start": "white_twilight_end",
+     "variant": "أبو يوسف ومحمد ورواية عن أبي حنيفة: red_twilight_end"
+    },
+    "maliki": {
+     "start": "red_twilight_end"
+    },
+    "shafii": {
+     "start": "red_twilight_end"
+    },
+    "hanbali": {
+     "start": "red_twilight_end"
+    }
+   },
+   "sources": [
+    "isha_twilight"
+   ]
+  },
+  {
+   "id": "isha_periods",
+   "category": "obligatory_prayer",
+   "madhhab": {
+    "hanafi": {
+     "outer_end": "next_true_dawn",
+     "note": "داخل المذهب مراتب فضيلة قبل ذلك"
+    },
+    "maliki": {
+     "preferred_end": "first_third_of_night",
+     "outer_end": "next_true_dawn",
+     "note": "تفصيل الاختياري/الضروري يحفظ في profile المذهب"
+    },
+    "shafii": {
+     "preferred_end": "first_third_of_night",
+     "outer_end": "next_true_dawn"
+    },
+    "hanbali": {
+     "preferred_end": "first_third_of_night",
+     "allowed_to": "islamic_midnight",
+     "necessity_end": "next_true_dawn"
+    }
+   },
+   "sources": [
+    "isha_end",
+    "isha_end_detail"
+   ]
+  },
+  {
+   "id": "duha",
+   "category": "voluntary_prayer",
+   "common": {
+    "start": "sunrise_clear",
+    "end": "solar_noon",
+    "ruling": "recommended",
+    "best_time": "when_sun_is_high_and_heat_has_increased"
+   },
+   "madhhab": {
+    "hanafi": "recommended",
+    "maliki": "recommended",
+    "shafii": "emphasized_sunnah",
+    "hanbali": "recommended"
+   },
+   "implementation": "لا +15 دقيقة بعد الشروق ولا -5 قبل الزوال؛ الحدود من الهندسة الشمسية.",
+   "sources": [
+    "duha"
+   ],
+   "display_option_note": "يستطيع المحرك إنهاء الضحى قبيل الزوال بإضافة display_end_estimate_id = zawal_pre_noon لمن يقول بالنهي وقت الاستواء (الحنفية والشافعية والحنابلة)، ولا يناسب المالكية. يُترك لقرار شرعي."
+  },
+  {
+   "id": "witr",
+   "category": "night_prayer",
+   "common": {
+    "start_relation": "after_isha",
+    "end": "next_true_dawn",
+    "preferred": "آخر الليل لمن يثق بالاستيقاظ",
+    "early_option": "قبل النوم لمن يخشى ألا يستيقظ"
+   },
+   "sources": [
+    "witr"
+   ]
+  },
+  {
+   "id": "qiyam",
+   "category": "night_prayer",
+   "common": {
+    "start_relation": "after_isha",
+    "end": "next_true_dawn",
+    "preferred_window": "last_third_start_to_next_true_dawn"
+   },
+   "sources": [
+    "witr",
+    "last_third"
+   ]
+  },
+  {
+   "id": "jumuah",
+   "category": "obligatory_prayer",
+   "madhhab": {
+    "hanafi": {
+     "start": "zawal",
+     "end_relation": "dhuhr_end",
+     "end": "asr"
+    },
+    "maliki": {
+     "start": "zawal",
+     "end_relation": "dhuhr_end_with_detail",
+     "end": "asr"
+    },
+    "shafii": {
+     "start": "zawal",
+     "end_relation": "dhuhr_end",
+     "end": "asr"
+    },
+    "hanbali": {
+     "start_variant": "before_zawal_allowed",
+     "preferred_display": "after_zawal",
+     "end_relation": "asr_entry",
+     "start": "zawal",
+     "end": "asr"
+    }
+   },
+   "sources": [
+    "jumuah"
+   ],
+   "calendar_rule": {
+    "type": "weekly",
+    "weekday": "friday"
+   },
+   "implementation_note": "end_relation الأصلية تبقى للتوثيق؛ end صريح لأن asr يُحل حسب المذهب (rule_start). عند الحنابلة start=zawal هو العرض المفضَّل، ويبقى start_variant للتجويز قبل الزوال."
+  },
+  {
+   "id": "after_fajr_nafl_restriction",
+   "category": "prayer_restriction",
+   "scope": "general_voluntary_prayer",
+   "display_policy": "show_without_worship_tracking",
+   "madhhab": {
+    "hanafi": {
+     "activation": "boundary",
+     "start": "true_dawn",
+     "end": "sunrise",
+     "exception": "fajr_sunnah_before_obligatory_prayer"
+    },
+    "maliki": {
+     "activation": "boundary",
+     "start": "true_dawn",
+     "end": "sunrise",
+     "exception": "fajr_sunnah_before_obligatory_prayer"
+    },
+    "shafii": {
+     "activation": "after_prayer",
+     "requires": "fajr_prayer_performed",
+     "display_start": "fajr",
+     "end": "sunrise"
+    },
+    "hanbali": {
+     "activation": "boundary",
+     "start": "true_dawn",
+     "end": "sunrise",
+     "exception": "fajr_sunnah_before_obligatory_prayer",
+     "variant": "رواية: يتعلق النهي بأداء صلاة الفجر"
+    }
+   },
+   "critical": "يختلف بدء النهي: عند الحنفية والمالكية والمشهور عند الحنابلة من طلوع الفجر، وعند الشافعية بعد أداء صلاة الفجر. العرض البرتقالي لا يسجل أداء العبادة.",
+   "note": "تنتهي هذه الطبقة عند الشروق، ثم تبدأ طبقة النهي الشمسي الأحمر إلى ارتفاع الشمس. الاستثناءات المتعلقة بنوع الصلاة تعرض في تفاصيل الحكم ولا تغيّر الحد الزمني العام بلا دليل خاص.",
+   "sources": [
+    "post_prayer_prohibition",
+    "prohibition_comparative",
+    "prohibition_trigger_comparative"
+   ]
+  },
+  {
+   "id": "after_asr_nafl_restriction",
+   "category": "prayer_restriction",
+   "scope": "general_voluntary_prayer",
+   "display_policy": "conditional_window_without_worship_tracking",
+   "common": {
+    "activation": "after_prayer",
+    "requires": "asr_prayer_performed",
+    "display_start": "asr",
+    "end": "sunset_approach"
+   },
+   "madhhab": {
+    "hanafi": {
+     "activation": "after_prayer",
+     "requires": "asr_prayer_performed"
+    },
+    "maliki": {
+     "activation": "after_prayer",
+     "requires": "asr_prayer_performed"
+    },
+    "shafii": {
+     "activation": "after_prayer",
+     "requires": "asr_prayer_performed"
+    },
+    "hanbali": {
+     "activation": "after_prayer",
+     "requires": "asr_prayer_performed"
+    }
+   },
+   "critical": "لا يبدأ الحكم بمجرد دخول وقت العصر، بل بعد أداء صلاة العصر. ولأن التطبيق لا يتتبع أداء الصلاة، تعرض المسطرة نافذة برتقالية مشروطة من دخول العصر، لا حكمًا محققًا على المستخدم.",
+   "note": "تنتهي الطبقة المشروطة عند اقتراب الغروب، ثم تظهر طبقة النهي الشمسي الأحمر حتى الغروب. الاستثناءات وذوات الأسباب تختلف بين المذاهب وتبقى في تفاصيل الحكم.",
+   "sources": [
+    "post_prayer_prohibition",
+    "prohibition_comparative"
+   ]
+  },
+  {
+   "id": "absolute_solar_restrictions",
+   "category": "solar_prayer_restriction",
+   "scope": "absolute_solar_windows",
+   "madhhab": {
+    "hanafi": {
+     "windows": [
+      {
+       "start": "sunrise",
+       "end": "sunrise_clear"
       },
-      "madhhab": {
-        "hanafi": {
-          "ruling": "wajib"
-        },
-        "maliki": {
-          "ruling": "sunnah_muakkadah"
-        },
-        "shafii": {
-          "ruling": "sunnah_muakkadah"
-        },
-        "hanbali": {
-          "ruling": "fard_kifayah"
-        }
+      {
+       "start": "solar_noon",
+       "end": "zawal",
+       "display_estimate_id": "zawal_pre_noon"
       },
-      "research_status": "needs_sources",
-      "needs_visual_state": "festival_prayer",
-      "note": "الحد المشترك: من ارتفاع الشمس إلى الزوال. التفاصيل المذهبية تحتاج توثيق مصادر قبل التفعيل."
-    },
-    {
-      "id": "suhoor",
-      "category": "recommended_fasting_meal",
-      "status": "proposed_not_consumed",
-      "activation": {
-        "owner": "islamic_events_registry.json",
-        "note_ar": "أيام الصيام فقط."
+      {
+       "start": "sunset_approach",
+       "end": "sunset"
+      }
+     ],
+     "variant": "رُوي عن أبي يوسف الترخيص في الاستواء يوم الجمعة، وليس هو العرض الافتراضي للمذهب هنا."
+    },
+    "maliki": {
+     "windows": [
+      {
+       "start": "sunrise",
+       "end": "sunrise_clear"
       },
-      "common": {
-        "preferred": "آخر الليل",
-        "end": "true_dawn"
+      {
+       "start": "sunset_approach",
+       "end": "sunset"
+      }
+     ],
+     "note": "لا تعرض نافذة الاستواء إلى الزوال في الاختيار المالكي."
+    },
+    "shafii": {
+     "windows": [
+      {
+       "start": "sunrise",
+       "end": "sunrise_clear"
       },
-      "sources": [
-        "quran_2_187"
-      ],
-      "research_status": "needs_sources",
-      "note": "الأكل والشرب مباحان حتى يتبين الفجر الصادق (البقرة 187). تُوثَّق سنية السحور من مصدر حديثي قبل التفعيل."
-    },
-    {
-      "id": "iftar",
-      "category": "recommended_fasting_meal",
-      "status": "proposed_not_consumed",
-      "activation": {
-        "owner": "islamic_events_registry.json",
-        "note_ar": "أيام الصيام فقط."
+      {
+       "start": "solar_noon",
+       "end": "zawal",
+       "exclude_weekdays": [
+        "friday"
+       ],
+       "display_estimate_id": "zawal_pre_noon"
       },
-      "common": {
-        "start": "sunset"
+      {
+       "start": "sunset_approach",
+       "end": "sunset"
+      }
+     ],
+     "note": "يستثنى الاستواء يوم الجمعة من العرض وفق المعتمد المسجل في المصدر المقارن."
+    },
+    "hanbali": {
+     "windows": [
+      {
+       "start": "sunrise",
+       "end": "sunrise_clear"
       },
-      "research_status": "needs_sources",
-      "note": "يدخل وقت الإفطار بغروب الشمس. حد الغروب الشمسي المحسوب مستقل عن تأخير موعد المغرب في طريقة الأردن."
-    },
-    {
-      "id": "eclipse_prayer",
-      "category": "occasional_prayer",
-      "status": "proposed_not_consumed",
-      "time_source": {
-        "owner": "astronomy_events_registry.json",
-        "practice_id": "eclipse_prayer",
-        "note_ar": "وقتها من محرك الكسوف والخسوف المحلي (الجزء المرئي فقط) ولا يُحسب من هذا الملف."
+      {
+       "start": "solar_noon",
+       "end": "zawal",
+       "display_estimate_id": "zawal_pre_noon"
       },
-      "restriction_relation": {
-        "status": "pending_scholar_review",
-        "note_ar": "علاقتها بأوقات النهي مذهبية؛ لا تُدرج قيمة قبل توثيق المصادر."
+      {
+       "start": "sunset_approach",
+       "end": "sunset"
       }
+     ]
     }
-  ]
+   },
+   "implementation": "الحدود هندسة شمسية بلا دقائق ثابتة؛ نافذة النهي قبيل الزوال (zawal_pre_noon) سياسة عرض تقديرية تُقرأ من display_estimates وليست بديلًا عن الحد الفلكي.",
+   "note": "اختيار النوافذ نفسها مذهبي. تعرض نافذة الزوال قبل الزوال فقط (10 دقائق افتراضيًا، والخيار 15) لأن ما بعد الزوال وقت جواز الصلاة، مع بيان أن الأبحاث المذكورة تقدر المنطقة الأقرب للزوال عادةً بنحو 5–10 دقائق. أما استثناءات أنواع الصلوات كذوات الأسباب والقضاء والجنازة والطواف فلا تختزل في لون زمني عام، وتعرض في تفاصيل الحكم.",
+   "sources": [
+    "prohibition_comparative",
+    "solar_prohibition",
+    "zawal_duration_research"
+   ]
+  },
+  {
+   "id": "eid_fitr_prayer",
+   "category": "occasional_prayer",
+   "calendar_rule": {
+    "calendar": "hijri",
+    "month": 10,
+    "day": 1,
+    "requires_month_confirmation": true
+   },
+   "common": {
+    "start": "sunrise_clear",
+    "end": "solar_noon"
+   },
+   "note": "من ارتفاع الشمس قدر رمح إلى قبيل الزوال. عند الشافعية يدخل وقتها من طلوع الشمس والأفضل بعد ارتفاعها. الحد الأعلى هو الزوال، وsolar_noon يقابله هنا بلا هامش.",
+   "research_status": "added_pending_scholar_review",
+   "sources": []
+  },
+  {
+   "id": "eid_adha_prayer",
+   "category": "occasional_prayer",
+   "calendar_rule": {
+    "calendar": "hijri",
+    "month": 12,
+    "day": 10,
+    "requires_month_confirmation": true
+   },
+   "common": {
+    "start": "sunrise_clear",
+    "end": "solar_noon"
+   },
+   "note": "يُستحب تعجيلها في الأضحى. نفس حدود صلاة عيد الفطر مع بقاء الاختلاف في الأفضلية.",
+   "research_status": "added_pending_scholar_review",
+   "sources": []
+  },
+  {
+   "id": "friday_response_hour",
+   "category": "recommended_time",
+   "calendar_rule": {
+    "type": "weekly",
+    "weekday": "friday"
+   },
+   "display_policy": "information_only_without_worship_tracking",
+   "common": {
+    "start": "last_daylight_hour_start",
+    "end": "sunset"
+   },
+   "note": "يُعرض آخر جزء من نهار الجمعة (اثنا عشر جزءًا للنهار من الشروق إلى الغروب). ويرى كثير من العلماء أنها تمتد من العصر إلى الغروب، وقيل: من جلوس الإمام إلى انقضاء الصلاة. الخلاف يبقى في تفاصيل الحكم، والنافذة معلومة لا ادعاء.",
+   "research_status": "added_pending_scholar_review",
+   "sources": []
+  },
+  {
+   "id": "ramadan_fast",
+   "category": "obligatory_fasting",
+   "common": {
+    "start": "true_dawn",
+    "end": "sunset"
+   },
+   "note": "ثبوت بداية الشهر من سلطة التقويم/الرؤية المعتمدة، لا من هذا الملف.",
+   "sources": [
+    "quran_2_187"
+   ]
+  },
+  {
+   "id": "monday_thursday_fast",
+   "category": "recommended_fasting",
+   "common": {
+    "start": "true_dawn",
+    "end": "sunset"
+   },
+   "note": "اختيار اليوم وجدولته من islamic_events_registry.json."
+  }
+ ],
+ "required_time_engine_outputs": [
+  {
+   "id": "asr_shadow_1",
+   "type": "shadow_factor",
+   "factor": 1,
+   "exclude_noon_shadow": true
+  },
+  {
+   "id": "asr_shadow_2",
+   "type": "shadow_factor",
+   "factor": 2,
+   "exclude_noon_shadow": true
+  },
+  {
+   "id": "first_third_of_night",
+   "type": "derived_night_fraction",
+   "fraction": "1/3",
+   "from": "sunset",
+   "to": "next_true_dawn"
+  },
+  {
+   "id": "red_twilight_end",
+   "type": "solar_altitude"
+  },
+  {
+   "id": "white_twilight_end",
+   "type": "solar_altitude"
+  },
+  {
+   "id": "islamic_midnight",
+   "type": "derived_night_fraction",
+   "fraction": "1/2",
+   "from": "sunset",
+   "to": "next_true_dawn"
+  },
+  {
+   "id": "last_third_start",
+   "type": "derived_night_fraction",
+   "fraction": "2/3",
+   "from": "sunset",
+   "to": "next_true_dawn"
+  },
+  {
+   "id": "sunrise_clear",
+   "type": "solar_altitude"
+  },
+  {
+   "id": "sunset_approach",
+   "type": "solar_altitude"
+  },
+  {
+   "id": "solar_noon",
+   "type": "solar_transit"
+  },
+  {
+   "id": "zawal",
+   "type": "solar_transition"
+  },
+  {
+   "id": "last_daylight_hour_start",
+   "type": "derived_day_fraction",
+   "fraction": "11/12",
+   "from": "sunrise",
+   "to": "sunset"
+  }
+ ],
+ "sources": {
+  "hanafi_asr": {
+   "title": "نقول حنفية في المثل والمثلين",
+   "url": "https://islamqa.org/hanafi/darul-iftaa-chicago/271053/"
+  },
+  "asr_comparison": {
+   "title": "الفرق بين الحنفية والجمهور في أول العصر",
+   "url": "https://islamqa.info/ar/answers/220820"
+  },
+  "maghrib_shafii": {
+   "title": "دائرة الإفتاء الأردنية — وقت المغرب",
+   "url": "https://aliftaa.jo/fatwa/3399/CatQuestion.aspx?Id=133"
+  },
+  "isha_twilight": {
+   "title": "الموسوعة الفقهية — الشفق ووقت العشاء",
+   "url": "https://dorar.net/feqhia/846/"
+  },
+  "isha_end": {
+   "title": "وقت خروج العشاء في المذاهب الأربعة",
+   "url": "https://www.islamweb.org/ar/fatwa/71957/"
+  },
+  "isha_end_detail": {
+   "title": "تفصيل آخر وقت العشاء",
+   "url": "https://www.alqayim.org/ar/fatwa/1971"
+  },
+  "duha": {
+   "title": "الموسوعة الفقهية — صلاة الضحى",
+   "url": "https://dorar.net/feqhia/1261/"
+  },
+  "witr": {
+   "title": "الموسوعة الفقهية — أفضل وقت للوتر",
+   "url": "https://dorar.net/feqhia/1241/"
+  },
+  "last_third": {
+   "title": "صحيح البخاري 1145",
+   "url": "https://sunnah.com/bukhari:1145"
+  },
+  "jumuah": {
+   "title": "مذاهب العلماء في وقت الجمعة",
+   "url": "https://islamweb.net/ar/fatwa/23917/"
+  },
+  "post_prayer_prohibition": {
+   "title": "صحيح مسلم 827",
+   "url": "https://sunnah.com/muslim:827"
+  },
+  "prohibition_comparative": {
+   "title": "بحث مقارن في أوقات النهي",
+   "url": "https://islamport.com/l/msl/3529/9.htm"
+  },
+  "prohibition_trigger_comparative": {
+   "title": "بحث مقارن في تعلق نهي الفجر بطلوعه أو بأداء الصلاة",
+   "url": "https://islamport.com/l/msl/3529/17.htm"
+  },
+  "solar_prohibition": {
+   "title": "صحيح مسلم 831",
+   "url": "https://sunnah.com/muslim:831"
+  },
+  "zawal_duration_research": {
+   "title": "تقدير المدة القريبة من الزوال وبيان أنها غير ثابتة بعشرين دقيقة",
+   "url": "https://saadalkhathlan.com/scientific-series/lessons/32181"
+  },
+  "quran_2_187": {
+   "title": "البقرة 187",
+   "reference": "Quran 2:187"
+  }
+ },
+ "validation": {
+  "worship_only": true,
+  "no_colors": true,
+  "no_emoji": true,
+  "no_user_alarms": true,
+  "no_completion_tracking": true,
+  "no_fixed_solar_minute_offsets": true,
+  "preserve_madhhab_variants": true,
+  "calendar_rules_supported": true,
+  "categories_requiring_visual_state": [
+   "occasional_prayer",
+   "recommended_time"
+  ],
+  "visual_note": "الفئتان occasional_prayer وrecommended_time تحتاجان حالة في visual_states_registry.category_states وإلا تُتجاوز القاعدتان بصمت."
+ },
+ "research_note": "هذه طبقة بيانات للتطبيق وليست فتوى شخصية. حيث لم تكف المصادر لإغلاق تفصيل مذهبي دقيق، أبقي التفصيل معلّقًا بدل اختراع قيمة.",
+ "changelog": [
+  "1.3.0: إصلاح jumuah: لم يكن ينتج أي نافذة (نهاية غير محلولة، وبداية الحنبلي مفقودة)؛ أُضيفت start/end وقاعدة تقويم weekly:friday",
+  "1.3.0: نافذة الزوال: من مركزة ±10 دقائق حول الاستواء إلى قبيل الزوال فقط (10 دقائق، والخيار 15)، لأن ما بعد الزوال وقت جواز الصلاة",
+  "1.3.0: انتقال التقديرات إلى display_estimates العليا ليصل إليها كل من start وend (كانت duha لا ترى إلا العليا)",
+  "1.3.0: إضافة صلاة العيدين وساعة الإجابة بعد العصر يوم الجمعة (قيد المراجعة الشرعية)",
+  "1.3.0: اكتمال required_time_engine_outputs"
+ ],
+ "display_estimates": {
+  "note_ar": "تقديرات عرض احتياطية تُقرأ من محرك الفترات. before_minutes قبل الحد وafter_minutes بعده. allowed_before_minutes هي القيم التي يقبلها خيار المستخدم.",
+  "zawal_pre_noon": {
+   "boundary": "solar_noon",
+   "before_minutes": 10,
+   "after_minutes": 0,
+   "allowed_before_minutes": [
+    10,
+    15
+   ],
+   "label_ar": "نافذة عرض النهي قبيل الزوال",
+   "note_ar": "النهي عن الصلاة وقت قيام الظهيرة حتى تزول الشمس، فالنافذة قبل الزوال فقط، وما بعده وقت الظهر. المدة تقديرية للعرض: الأبحاث المذكورة تقدّر المنطقة القريبة من الزوال بنحو 5–10 دقائق، وخيار 15 للتحوّط. الحد الفلكي المحسوب يبقى محفوظًا مستقلًا.",
+   "source_id": "zawal_duration_research",
+   "replaces": "zawal_20_minutes"
+  }
+ }
 }