sky_simulation_registry.json

{
  "schema_name": "islamic_clock_celestial_simulation_registry",
  "schema_version": "2.0.0",
  "registry_id": "celestial_simulation_registry",
  "project": "ساعة المسلم / الخط الزمني الروحي",
  "purpose": "إعدادات العرض البصري لمحاكاة السماء والقبلة. لا يحتوي على أحكام فقهية أو مواقيت صلاة.",
  "ownership": {
    "owns": [
      "ألوان السماء حسب ارتفاع الشمس",
      "حساسية محاكاة القبلة البصرية",
      "أحجام رموز الشمس والقمر والكعبة في العرض",
      "نطاقات ظهور العناصر على الشاشة",
      "إعدادات ونصوص إتاحة توجيه القبلة والنطق والاهتزاز",
      "ثوابت نموذج القمر الاحتياطي وأسماء الأطوار وألوان رسمه",
      "إحداثيات الكعبة",
      "إسقاط الأجرام على الشاشة وعتبات مراحل السماء",
      "نصوص المحاكاة العربية"
    ],
    "does_not_own": [
      "حساب مواقيت الصلاة",
      "الأحكام الفقهية",
      "حدود النهي والاستحباب",
      "محتوى الأذكار أو العبادات"
    ]
  },
  "sky_color_model": {
    "driver": "solar_altitude_deg",
    "continuous_interpolation": true,
    "description": "لون السماء ينتقل تدريجيًا مع ارتفاع الشمس، ولا يقفز بين الليل والنهار.",
    "gradient_stops": [
      {
        "at": -18,
        "label": "ليل فلكي",
        "color": "#071326"
      },
      {
        "at": -12,
        "label": "فجر/شفق عميق",
        "color": "#15284b"
      },
      {
        "at": -6,
        "label": "شفق مدني",
        "color": "#4b5f91"
      },
      {
        "at": -1,
        "label": "قرب الأفق",
        "color": "#e08a5b"
      },
      {
        "at": 4,
        "label": "شروق/غروب",
        "color": "#f4b46a"
      },
      {
        "at": 15,
        "label": "صباح",
        "color": "#84c8f5"
      },
      {
        "at": 45,
        "label": "نهار",
        "color": "#55b7ef"
      },
      {
        "at": 75,
        "label": "شمس مرتفعة",
        "color": "#3fa7e5"
      }
    ]
  },
  "objects": {
    "sun": {
      "visible_below_horizon_deg": -3,
      "size_min_px": 26,
      "size_max_px": 48
    },
    "moon": {
      "visible_below_horizon_deg": -5,
      "size_min_px": 22,
      "size_max_px": 40,
      "show_phase": true
    },
    "kaaba": {
      "alignment_threshold_deg": 4,
      "near_alignment_threshold_deg": 12,
      "visible_when_compass_enabled": true
    },
    "shadow": {
      "object_height_unit": 1,
      "show_one_shadow": true,
      "show_two_shadows": true
    }
  },
  "validation": {
    "no_prayer_rulings": true,
    "no_fixed_solar_minute_offsets": true,
    "visual_only": true,
    "merged_core_registry": true
  },
  "qibla_accessibility": {
    "storage_key": "muslim_clock_qibla_accessibility_v1",
    "defaults": {
      "screen_reader": true,
      "vibration": true
    },
    "alignment": {
      "stable_ms": 1000,
      "exit_threshold_deg": 8,
      "direction_stable_ms": 700,
      "direction_interval_ms": 3500,
      "sensor_timeout_ms": 8000,
      "max_tilt_deg": 35,
      "max_reported_accuracy_deg": 20
    },
    "vibration_pattern_ms": [
      120,
      80,
      120
    ],
    "ui": {
      "settings": "تهيئة القبلة والموقع",
      "scene": "محاكاة الشمس والقمر والقبلة",
      "locate": "تفعيل موقع القبلة",
      "start": "بدء توجيه القبلة",
      "stop": "إيقاف توجيه القبلة",
      "retry": "إعادة المحاولة",
      "screen_reader": "إعلان الاتجاه عبر قارئ الشاشة",
      "vibration": "اهتزاز عند التوجه للقبلة",
      "help": "وجّه أعلى الهاتف للأمام، وأمسكه بشكل مسطح وبعيدًا عن المعادن والمغناطيس. افتح قارئ الشاشة لسماع التوجيه. دقة الاتجاه تعتمد على حساس الهاتف.",
      "aligned": "القبلة أمامك",
      "right": "اتجه قليلًا لليمين",
      "left": "اتجه قليلًا لليسار",
      "right_far": "اتجه لليمين نحو القبلة",
      "left_far": "اتجه لليسار نحو القبلة",
      "loading": "جارٍ تحميل المحاكاة…",
      "load_error": "تعذر تحميل المحاكاة أو سجلها. تحقق من وجود celestial_simulation.js وsky_simulation_registry.json بجانب index.html، ثم أعد المحاولة.",
      "updating_error": "تعذر تحديث المحاكاة. أعد المحاولة.",
      "locating": "جارٍ تحديد موقع القبلة…",
      "location_failed": "تعذر تحديد الموقع أو لم يُمنح الإذن. يمكنك إعادة المحاولة أو اختيار الموقع من إعدادات مواقيت الصلاة.",
      "location_unavailable": "تحديد الموقع غير متاح في هذا المتصفح.",
      "location_required": "فعّل موقع القبلة أولًا، أو اختر موقعك من إعدادات مواقيت الصلاة.",
      "location_device": "موقع القبلة: موقع الجهاز",
      "location_saved": "موقع القبلة: الموقع المحفوظ",
      "location_app": "موقع القبلة: الموقع المختار في التطبيق",
      "location_default": "عرض المحاكاة الافتراضي: عمّان. يلزم تحديد موقعك لبدء توجيه القبلة.",
      "location_ready": "تم تحديد الموقع. اضغط بدء توجيه القبلة.",
      "waiting": "بانتظار قراءة بوصلة الهاتف…",
      "stopped": "تم إيقاف توجيه القبلة.",
      "sensor_unavailable": "حساس الاتجاه غير متاح. افتح التطبيق مباشرة عبر HTTPS على هاتف يدعم البوصلة.",
      "permission_denied": "لم يُمنح إذن حساس الاتجاه. يمكنك إعادة المحاولة.",
      "sensor_timeout": "لم تصل قراءة بوصلة موثوقة أو انقطعت. أعد تشغيل التوجيه؛ وإذا كان التطبيق داخل إطار فافتحه مباشرة.",
      "flat_phone": "أمسك الهاتف بشكل مسطح وثابت لتحديد الاتجاه.",
      "calibrate": "قراءة البوصلة غير دقيقة. أبعد الهاتف عن المعادن وحرّكه برفق على شكل الرقم ثمانية ثم أعد توجيهه.",
      "vibration_unavailable": "الاهتزاز غير متاح في هذا المتصفح؛ يبقى التوجيه عبر قارئ الشاشة متاحًا.",
      "save_failed": "تعذر حفظ الخيارات محليًا؛ ستبقى فعالة خلال هذه الجلسة.",
      "settings_missing": "إعدادات القبلة غير مكتملة. أعد رفع سجل المحاكاة المحدّث."
    }
  },
  "changelog": [
    "2.0.0: دمج celestial_core_registry في هذا الملف (مصدر واحد للمحاكاة)",
    "2.0.0: عوامل ظل المثل والمثلين تُقرأ من fiqh_time_registry (asr_shadow_*) ولا تتكرر هنا",
    "2.0.0: رسائل البوصلة والمهلة والميل الأقصى من qibla_accessibility الموجودة"
  ],
  "required_registries": [
    "fiqh_time_registry.json"
  ],
  "qibla": {
    "kaaba": {
      "lat": 21.422487,
      "lng": 39.826206
    }
  },
  "astronomy": {
    "refraction_model": "normal"
  },
  "sun": {
    "horizon_altitude_deg": -0.833,
    "crossing_scan_step_minutes": 5,
    "crossing_bisect_iterations": 28
  },
  "moon_model": {
    "note": "للحساب الاحتياطي فقط عند غياب Astronomy Engine",
    "synodic_month_days": 29.530588853,
    "reference_new_moon_utc": "2000-01-06T18:14:00Z",
    "new_moon_search_back_days": 35
  },
  "moon_bands": [
    {
      "until": 0.03,
      "key": "new_moon",
      "name_ar": "محاق"
    },
    {
      "until": 0.22,
      "key": "waxing_crescent",
      "name_ar": "هلال متزايد"
    },
    {
      "until": 0.28,
      "key": "first_quarter",
      "name_ar": "تربيع أول"
    },
    {
      "until": 0.47,
      "key": "waxing_gibbous",
      "name_ar": "أحدب متزايد"
    },
    {
      "until": 0.53,
      "key": "full_moon",
      "name_ar": "بدر"
    },
    {
      "until": 0.72,
      "key": "waning_gibbous",
      "name_ar": "أحدب متناقص"
    },
    {
      "until": 0.78,
      "key": "last_quarter",
      "name_ar": "تربيع أخير"
    },
    {
      "until": 0.97,
      "key": "waning_crescent",
      "name_ar": "هلال متناقص"
    },
    {
      "until": 1,
      "key": "new_moon",
      "name_ar": "محاق"
    }
  ],
  "moon_render": {
    "light_color": "#f7f4d8",
    "dark_color": "#1b2340",
    "glow": "0 0 18px rgba(255,255,255,.38)",
    "border_radius": "50%",
    "new_moon_below": 0.03,
    "full_moon_above": 0.97
  },
  "projection": {
    "x_center_percent": 50,
    "x_half_range_deg": 180,
    "x_scale_percent": 50,
    "x_max_percent": 100,
    "y_horizon_percent": 82,
    "altitude_offset_deg": 10,
    "altitude_span_deg": 100,
    "y_scale_percent": 72,
    "y_min_percent": 6,
    "y_max_percent": 92
  },
  "sky_phase_thresholds_deg": {
    "night_below": -12,
    "twilight_below": -1,
    "horizon_below": 8
  },
  "sky_render": {
    "angle_deg": 180,
    "mid_mix": 0.55,
    "mid_stop_percent": 58
  },
  "horizon_color_model": {
    "cool_color": "#18345c",
    "warm_color": "#f1a05c",
    "peak_altitude_deg": 2,
    "falloff_deg": 18
  },
  "qibla_render": {
    "opacity_visible": "1",
    "opacity_dim": ".35"
  },
  "precision": {
    "altitude_digits": 1,
    "percent_digits": 0,
    "degree_digits": 0,
    "ratio_digits": 2
  },
  "shadow": {
    "cache_limit": 8,
    "render": {
      "px_per_ratio": 38,
      "min_px": 6,
      "max_px": 220,
      "opacity_visible": ".42",
      "opacity_hidden": "0"
    }
  },
  "defaults": {
    "update_interval_ms": 60000,
    "observer_elevation_m": 0,
    "size_altitude_offset_deg": 5,
    "size_altitude_span_deg": 70
  },
  "texts_ar": {
    "moon_title": "{phase} - إضاءة {percent}%",
    "qibla_bearing": "القبلة {degrees}° من الشمال",
    "shadow_length": "طول الظل {ratio} من طول الجسم",
    "sun_below_horizon": "الشمس تحت الأفق",
    "info_sun": "الشمس {altitude}°",
    "info_moon": "القمر {phase} {percent}%",
    "info_qibla_bearing": "القبلة {degrees}°",
    "info_qibla_aligned": "القبلة أمامك",
    "info_qibla_delta": "فرق القبلة {degrees}°",
    "info_separator": " | "
  }
}