mihrab-methods 0.0.0-stage → 1.0.1

package/dist/esm/data/generated/swedenCorrections.js

@@ -0,0 +1,2 @@
+const data = { "from": "2024-01-01", "to": "2027-12-31", "points": { "55.376,13.159": ["2027-01-27 maghrib +1"], "55.417,12.844": ["2025-05-04 sunrise -1", "2026-06-14 isha -1", "2027-02-04 sunrise +1"], "55.430,13.136": ["2024-04-26 sunrise -1"], "55.483,13.507": ["2027-12-26 asr -1"], "55.513,13.234": ["2024-08-30 maghrib +1", "2025-08-18 maghrib +1", "2027-11-10 asr +1"], "55.535,14.325": ["2026-12-22 maghrib -1", "2027-04-12 isha +1", "2027-04-15 isha +1", "2027-04-16 isha +1", "2027-04-17 isha +1", "2027-04-20 isha +1", "2027-04-21 isha +1", "2027-04-25 isha +1", "2027-04-30 isha +1"], "55.556,14.337": ["2024-03-20 sunrise +1", "2024-05-14 maghrib +1"], "55.673,13.074": ["2024-07-25 isha +1", "2026-06-24 isha -1", "2027-01-10 asr -1", "2027-01-25 asr +1", "2027-11-17 sunrise -1"], "55.713,13.186": ["2024-02-15 isha +1"], "55.718,13.021": ["2025-04-22 fajr +1", "2025-05-05 fajr +1", "2027-09-20 fajr -1"], "55.777,13.087": ["2026-10-27 maghrib +1"], "55.800,13.661": ["2027-02-09 sunrise -1"], "55.837,13.296": ["2026-05-02 fajr +1"], "55.878,12.832": ["2024-12-29 sunrise +1", "2025-04-30 sunrise -1"], "55.931,13.541": ["2025-07-31 fajr +1"], "56.030,14.158": ["2025-01-01 fajr +1"], "56.048,14.576": ["2025-07-22 sunrise -1", "2025-12-10 asr +1"], "56.156,13.762": ["2024-08-14 maghrib +1", "2025-06-18 fajr +1"], "56.175,15.587": ["2024-11-04 maghrib +1", "2026-08-16 asr +1"], "56.199,12.549": ["2026-07-25 sunrise -1"], "56.206,15.279": ["2027-03-21 isha -1", "2027-05-02 fajr -1"], "56.244,12.872": ["2024-06-06 maghrib +1"], "56.520,13.044": ["2025-03-28 asr -1", "2025-07-20 isha -1"], "56.668,16.353": ["2024-01-06 sunrise +1"], "56.750,15.260": ["2025-06-09 isha -1"], "56.750,15.894": ["2025-08-11 asr +1", "2026-11-20 isha +1", "2027-05-10 sunrise -1"], "56.835,13.939": ["2025-05-13 isha -1", "2025-06-02 fajr +1"], "56.884,14.803": ["2027-12-10 isha +1"], "57.033,16.444": ["2027-09-07 maghrib +1"], "57.106,12.254": ["2024-06-12 fajr +1", "2024-07-31 fajr +1", "2025-12-07 asr -1"], "57.167,16.027": ["2026-11-13 asr +1", "2026-12-26 sunrise +1"], "57.180,14.052": ["2026-09-11 isha +1"], "57.264,16.456": ["2025-12-23 maghrib -1"], "57.301,13.525": ["2024-07-12 fajr +1"], "57.345,12.133": ["2026-10-10 maghrib +1"], "57.368,13.726": ["2024-04-07 fajr +1", "2024-04-13 fajr +1", "2024-04-19 fajr +1", "2024-04-25 fajr +1", "2025-08-15 maghrib +1"], "57.401,14.668": ["2024-07-20 fajr +1"], "57.426,15.079": ["2024-06-28 isha -1", "2027-06-04 sunrise -1"], "57.488,13.360": ["2024-01-16 sunrise -1", "2025-07-28 maghrib +1", "2027-04-07 maghrib -1"], "57.493,12.652": ["2025-01-16 fajr +1", "2025-11-18 maghrib +1", "2026-08-15 asr +1", "2027-08-15 maghrib +1"], "57.500,15.844": ["2027-03-25 isha -1", "2027-08-03 isha +1"], "57.501,12.093": ["2026-08-09 fajr -1"], "57.635,18.292": ["2026-08-08 asr +1", "2026-11-21 maghrib +1"], "57.650,12.009": ["2025-04-28 sunrise -1", "2026-05-17 maghrib +1", "2026-05-18 maghrib +1", "2026-07-20 fajr -1"], "57.667,15.844": ["2024-03-22 fajr +1", "2025-08-18 sunrise -1", "2027-09-04 sunrise -1"], "57.678,12.609": ["2024-10-31 isha +1"], "57.689,12.225": ["2026-08-11 fajr -1", "2026-11-25 sunrise -1"], "57.695,11.652": ["2026-08-18 fajr -1", "2026-08-31 fajr -1", "2027-04-06 isha -1"], "57.720,11.994": ["2026-08-08 fajr -1", "2027-08-07 maghrib +1"], "57.733,12.110": ["2025-02-16 fajr -1"], "57.760,16.630": ["2025-06-20 asr -1"], "57.767,12.280": ["2024-11-01 maghrib +1", "2025-04-14 fajr +1", "2026-05-19 fajr -1"], "57.796,13.415": ["2025-05-03 maghrib +1", "2025-09-26 sunrise -1", "2027-04-18 sunrise +1"], "57.801,12.309": ["2024-12-31 maghrib -1", "2027-06-29 isha -1"], "58.071,11.830": ["2024-03-10 asr -1", "2024-06-22 fajr +1", "2024-08-25 isha -1"], "58.180,13.544": ["2025-10-29 asr +1", "2027-02-12 maghrib +1"], "58.322,15.136": ["2026-05-03 isha +1", "2026-09-04 sunrise -1", "2027-06-19 sunrise -1"], "58.352,11.936": ["2025-08-20 maghrib +1"], "58.369,12.329": ["2024-09-11 isha +1", "2027-12-31 sunrise +1"], "58.385,13.842": ["2024-05-15 asr +1", "2027-05-24 maghrib +1"], "58.467,11.689": ["2026-06-17 fajr -1"], "58.500,13.159": ["2024-07-28 asr +1", "2024-08-20 maghrib +1", "2024-08-31 isha +1", "2025-07-04 maghrib -1", "2027-09-10 isha +1"], "58.500,15.621": ["2026-12-02 maghrib +1", "2027-06-08 fajr +1"], "58.538,15.043": ["2026-08-08 asr +1", "2027-01-09 sunrise +1"], "58.592,16.174": ["2025-10-27 sunrise +1"], "58.675,17.130": ["2024-11-11 maghrib +1", "2025-05-13 maghrib +1", "2025-08-03 asr +1", "2026-08-12 sunrise -1", "2027-08-10 sunrise -1"], "58.700,12.461": ["2027-07-30 asr +1"], "58.711,13.827": ["2025-06-09 sunrise -1"], "58.718,15.774": ["2024-03-29 isha -1", "2025-08-21 fajr -1", "2025-09-03 fajr -1"], "58.752,17.013": ["2024-02-10 asr +1", "2025-05-11 isha +1"], "58.908,17.949": ["2025-07-29 sunrise -1", "2027-01-07 sunrise +1", "2027-05-04 fajr +1"], "58.943,11.170": ["2026-01-30 isha -1", "2026-05-30 sunrise -1", "2027-06-24 fajr +1"], "58.991,16.202": ["2026-03-06 isha -1", "2026-07-31 maghrib +1"], "59.034,12.222": ["2024-08-06 fajr -1"], "59.058,16.589": ["2026-05-22 sunrise -1"], "59.095,17.559": ["2025-06-05 fajr -1"], "59.191,17.630": ["2024-05-07 maghrib +1", "2026-10-08 maghrib +1", "2027-05-15 isha -1"], "59.268,18.191": ["2027-07-13 fajr +1", "2027-11-29 maghrib +1"], "59.277,15.211": ["2024-05-27 fajr -1", "2027-04-08 sunrise +1"], "59.317,14.115": ["2024-08-09 maghrib +1"], "59.319,18.459": ["2027-05-20 sunrise -1"], "59.330,18.034": ["2024-07-18 maghrib +1", "2024-08-05 isha +1"], "59.333,14.502": ["2024-03-24 asr -1", "2024-12-11 isha +1"], "59.375,17.018": ["2025-06-20 maghrib -1"], "59.377,17.948": ["2025-08-17 isha +1", "2026-08-13 asr +1", "2027-12-13 maghrib -1"], "59.417,17.827": ["2025-04-21 fajr -1", "2025-06-30 maghrib -1", "2026-11-29 maghrib +1", "2027-08-02 sunrise -1"], "59.514,15.989": ["2024-06-21 asr +1", "2027-08-24 sunrise -1"], "59.542,18.073": ["2026-06-05 sunrise -1", "2027-05-23 asr +1", "2027-07-26 maghrib +1"], "59.584,17.494": ["2025-08-06 isha +1"], "59.601,15.230": ["2026-03-05 fajr -1", "2027-08-12 maghrib +1"], "59.619,17.851": ["2024-05-29 fajr -1"], "59.620,16.544": ["2024-09-23 maghrib +1", "2025-08-24 maghrib +1", "2026-09-16 fajr -1"], "59.717,14.161": ["2024-07-20 isha +1"], "59.862,17.636": ["2024-07-23 isha +1", "2024-08-17 isha +1", "2024-08-18 fajr -1", "2024-09-14 maghrib +1", "2026-06-24 isha -1"], "59.926,16.589": ["2026-04-30 fajr +1", "2026-09-04 maghrib +1", "2027-07-13 sunrise -1"], "59.990,15.804": ["2027-03-13 isha -1"], "60.133,12.994": ["2026-06-07 isha +1", "2026-06-16 isha +1", "2026-06-21 isha +1", "2026-06-22 isha +1", "2026-06-23 isha +1", "2026-06-24 isha +1", "2026-06-25 isha +1", "2026-06-26 isha +1", "2026-06-27 isha +1", "2026-11-16 fajr -1"], "60.139,15.184": ["2024-04-09 sunrise +1", "2026-02-19 maghrib +1"], "60.154,16.175": ["2024-12-14 fajr +1", "2026-10-23 isha +1"], "60.609,15.628": ["2027-05-01 fajr -1", "2027-08-01 fajr -1"], "60.618,16.771": ["2026-07-23 sunrise -1"], "60.680,17.116": ["2024-12-16 sunrise +1", "2026-08-02 sunrise -1"], "61.010,14.550": ["2027-10-14 maghrib +1"], "61.349,16.390": ["2025-07-24 sunrise -1", "2027-01-06 sunrise +1"], "61.735,17.104": ["2024-07-26 maghrib +1", "2024-08-11 fajr -1", "2025-01-01 sunrise +1", "2026-08-27 fajr -1", "2026-09-02 fajr -1", "2026-09-08 fajr -1", "2026-09-14 fajr -1"], "61.833,16.091": ["2025-09-19 sunrise -1"], "62.037,14.370": ["2027-01-09 maghrib -1", "2027-08-11 isha +1"], "62.401,17.323": ["2025-11-16 sunrise -1", "2027-07-27 sunrise -1"], "62.930,17.785": ["2024-07-27 sunrise -1", "2025-08-01 fajr -1", "2025-08-30 fajr -1", "2025-09-12 fajr -1", "2026-11-23 sunrise -1"], "63.179,14.644": ["2025-04-27 isha +1", "2027-09-13 isha +1"], "63.291,18.710": ["2024-07-21 maghrib +1"], "63.834,20.238": ["2024-01-18 maghrib +1", "2026-05-02 fajr -1"], "64.751,20.945": ["2025-05-04 asr +1", "2026-08-07 fajr -1"], "65.313,21.513": ["2027-05-26 isha +1"], "65.600,22.157": ["2025-04-11 maghrib -1", "2025-09-05 maghrib +1"], "65.827,21.700": ["2024-05-03 isha +1", "2024-08-24 maghrib +1", "2025-04-26 isha +1"], "66.599,19.841": ["2024-04-21 maghrib -1", "2026-11-08 sunrise -1", "2027-05-07 isha +1"], "67.138,20.659": ["2025-08-04 maghrib +1", "2025-08-28 sunrise -1", "2026-04-25 isha +1", "2026-09-10 isha +1", "2026-09-19 isha +1", "2026-09-28 isha +1"], "67.206,23.397": ["2024-03-22 asr -1", "2025-02-14 sunrise -1"], "67.859,20.226": ["2024-08-06 isha -1", "2025-08-07 isha -1", "2025-08-18 sunrise -1", "2026-08-07 isha -1", "2027-01-30 fajr -1", "2027-09-23 maghrib +1"] } };
+export default data;

package/dist/esm/data/generated/swedenPlaces.d.ts

@@ -0,0 +1,5 @@
+declare const data: Record<string, {
+    lat: number;
+    lng: number;
+}>;
+export default data;

package/dist/esm/data/generated/swedenPlaces.js

@@ -0,0 +1,3 @@
+// Generated by scripts/embed.mjs — do not edit; edit the JSON under data/ instead.
+const data = { "Stockholm": { "lat": 59.33, "lng": 18.034 }, "Alingsås": { "lat": 57.932, "lng": 12.538 }, "Avesta": { "lat": 60.154, "lng": 16.175 }, "Bengtsfors": { "lat": 59.034, "lng": 12.222 }, "Boden": { "lat": 65.827, "lng": 21.7 }, "Bollnäs": { "lat": 61.349, "lng": 16.39 }, "Borlänge": { "lat": 60.484, "lng": 15.439 }, "Borås": { "lat": 57.723, "lng": 12.94 }, "Eksjö": { "lat": 57.667, "lng": 14.964 }, "Enköping": { "lat": 59.645, "lng": 17.084 }, "Eskilstuna": { "lat": 59.372, "lng": 16.513 }, "Eslöv": { "lat": 55.837, "lng": 13.296 }, "Fagersta": { "lat": 59.99, "lng": 15.804 }, "Falkenberg": { "lat": 56.896, "lng": 12.503 }, "Falköping": { "lat": 58.18, "lng": 13.544 }, "Flen": { "lat": 59.058, "lng": 16.589 }, "Filipstad": { "lat": 59.717, "lng": 14.161 }, "Gislaved": { "lat": 57.301, "lng": 13.525 }, "Gnosjö": { "lat": 57.368, "lng": 13.726 }, "Gällivare": { "lat": 67.138, "lng": 20.659 }, "Gävle": { "lat": 60.68, "lng": 17.116 }, "Göteborg": { "lat": 57.72, "lng": 11.994 }, "Halmstad": { "lat": 56.666, "lng": 12.859 }, "Haparanda": { "lat": 65.848, "lng": 24.144 }, "Helsingborg": { "lat": 56.045, "lng": 12.697 }, "Hudiksvall": { "lat": 61.735, "lng": 17.104 }, "Hultsfred": { "lat": 57.5, "lng": 15.844 }, "Härnösand": { "lat": 62.638, "lng": 17.929 }, "Hässleholm": { "lat": 56.156, "lng": 13.762 }, "Högsby": { "lat": 57.167, "lng": 16.027 }, "Hörby": { "lat": 55.8, "lng": 13.661 }, "Jokkmokk": { "lat": 66.599, "lng": 19.841 }, "Jönköping": { "lat": 57.784, "lng": 14.163 }, "Kalmar": { "lat": 56.668, "lng": 16.353 }, "Karlskoga": { "lat": 59.333, "lng": 14.502 }, "Karlskrona": { "lat": 56.175, "lng": 15.587 }, "Karlstad": { "lat": 59.378, "lng": 13.498 }, "Katrineholm": { "lat": 58.991, "lng": 16.202 }, "Kiruna": { "lat": 67.859, "lng": 20.226 }, "Kristianstad": { "lat": 56.03, "lng": 14.158 }, "Kristinehamn": { "lat": 59.317, "lng": 14.115 }, "Köping": { "lat": 59.514, "lng": 15.989 }, "Laholm": { "lat": 56.52, "lng": 13.044 }, "Landskrona": { "lat": 55.878, "lng": 12.832 }, "Lessebo": { "lat": 56.75, "lng": 15.26 }, "Lidköping": { "lat": 58.5, "lng": 13.159 }, "Linköping": { "lat": 58.5, "lng": 15.621 }, "Ludvika": { "lat": 60.139, "lng": 15.184 }, "Luleå": { "lat": 65.6, "lng": 22.157 }, "Lund": { "lat": 55.713, "lng": 13.186 }, "Lysekil": { "lat": 58.275, "lng": 11.44 }, "Malmö": { "lat": 55.6, "lng": 13.004 }, "Mariestad": { "lat": 58.711, "lng": 13.827 }, "Mellerud": { "lat": 58.7, "lng": 12.461 }, "Mjölby": { "lat": 58.322, "lng": 15.136 }, "Mora": { "lat": 61.01, "lng": 14.55 }, "Munkedal": { "lat": 58.467, "lng": 11.689 }, "Mönsterås": { "lat": 57.033, "lng": 16.444 }, "Märsta": { "lat": 59.619, "lng": 17.851 }, "Norrköping": { "lat": 58.592, "lng": 16.174 }, "Norrtälje": { "lat": 59.761, "lng": 18.701 }, "Nybro": { "lat": 56.75, "lng": 15.894 }, "Nyköping": { "lat": 58.752, "lng": 17.013 }, "Nynäshamn": { "lat": 58.908, "lng": 17.949 }, "Nässjö": { "lat": 57.661, "lng": 14.704 }, "Oskarshamn": { "lat": 57.264, "lng": 16.456 }, "Oxelösund": { "lat": 58.675, "lng": 17.13 }, "Pajala": { "lat": 67.206, "lng": 23.397 }, "Piteå": { "lat": 65.313, "lng": 21.513 }, "Ronneby": { "lat": 56.206, "lng": 15.279 }, "Sala": { "lat": 59.926, "lng": 16.589 }, "Simrishamn": { "lat": 55.556, "lng": 14.337 }, "Skara": { "lat": 58.387, "lng": 13.432 }, "Skellefteå": { "lat": 64.751, "lng": 20.945 }, "Skövde": { "lat": 58.385, "lng": 13.842 }, "Sollefteå": { "lat": 63.183, "lng": 17.26 }, "Strängnäs": { "lat": 59.375, "lng": 17.018 }, "Sundsvall": { "lat": 62.401, "lng": 17.323 }, "Säffle": { "lat": 59.133, "lng": 12.924 }, "Sävsjö": { "lat": 57.401, "lng": 14.668 }, "Söderhamn": { "lat": 61.314, "lng": 17.076 }, "Södertälje": { "lat": 59.191, "lng": 17.63 }, "Sölvesborg": { "lat": 56.048, "lng": 14.576 }, "Tierp": { "lat": 60.343, "lng": 17.509 }, "Torsby": { "lat": 60.133, "lng": 12.994 }, "Tranemo": { "lat": 57.488, "lng": 13.36 }, "Tranås": { "lat": 58.037, "lng": 14.971 }, "Trelleborg": { "lat": 55.376, "lng": 13.159 }, "Trollhättan": { "lat": 58.284, "lng": 12.308 }, "Uddevalla": { "lat": 58.352, "lng": 11.936 }, "Ulricehamn": { "lat": 57.796, "lng": 13.415 }, "Umeå": { "lat": 63.834, "lng": 20.238 }, "Uppsala": { "lat": 59.862, "lng": 17.636 }, "Varberg": { "lat": 57.106, "lng": 12.254 }, "Vetlanda": { "lat": 57.426, "lng": 15.079 }, "Vimmerby": { "lat": 57.667, "lng": 15.844 }, "Visby": { "lat": 57.635, "lng": 18.292 }, "Vänersborg": { "lat": 58.369, "lng": 12.329 }, "Värnamo": { "lat": 57.18, "lng": 14.052 }, "Västervik": { "lat": 57.76, "lng": 16.63 }, "Västerås": { "lat": 59.62, "lng": 16.544 }, "Växjö": { "lat": 56.884, "lng": 14.803 }, "Ystad": { "lat": 55.43, "lng": 13.136 }, "Åmål": { "lat": 59.05, "lng": 12.694 }, "Ängelholm": { "lat": 56.244, "lng": 12.872 }, "Örebro": { "lat": 59.277, "lng": 15.211 }, "Örnsköldsvik": { "lat": 63.291, "lng": 18.71 }, "Östersund": { "lat": 63.179, "lng": 14.644 } };
+export default data;

package/dist/esm/diyanet.d.ts

@@ -0,0 +1,4 @@
+/** mihrab-methods/diyanet — the diyanet method with its places and correction list, and nothing else's. */
+import './authorities/diyanet.js';
+export * from './core/index.js';
+export { places } from './authorities/diyanet.js';

package/dist/esm/diyanet.js

@@ -0,0 +1,4 @@
+/** mihrab-methods/diyanet — the diyanet method with its places and correction list, and nothing else's. */
+import './authorities/diyanet.js';
+export * from './core/index.js';
+export { places } from './authorities/diyanet.js';

package/dist/esm/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * mihrab-methods — the prayer-time authorities' own methods, each
+ * reproducing its published timetable to the minute: Sweden (Diyanet's
+ * method, as Islamiska Förbundet prints it), Diyanet worldwide, Morocco
+ * (Habous), Algeria (the Ministry of Religious Affairs) and Indonesia
+ * (Kemenag). This entry loads all five; `mihrab-methods/<authority>` loads
+ * one, with only its data.
+ *
+ *   import { placesOf, nearestPlace, timesFor } from 'mihrab-methods';
+ *   const { place } = nearestPlace('algeria', 36.75, 3.06)!;
+ *   timesFor(place, '2026-10-15');
+ */
+import './authorities/sweden.js';
+import './authorities/diyanet.js';
+import './authorities/morocco.js';
+import './authorities/algeria.js';
+import './authorities/indonesia.js';
+export * from './core/index.js';
+export { diyanetCountry } from './authorities/diyanet.js';

package/dist/esm/index.js

@@ -0,0 +1,19 @@
+/**
+ * mihrab-methods — the prayer-time authorities' own methods, each
+ * reproducing its published timetable to the minute: Sweden (Diyanet's
+ * method, as Islamiska Förbundet prints it), Diyanet worldwide, Morocco
+ * (Habous), Algeria (the Ministry of Religious Affairs) and Indonesia
+ * (Kemenag). This entry loads all five; `mihrab-methods/<authority>` loads
+ * one, with only its data.
+ *
+ *   import { placesOf, nearestPlace, timesFor } from 'mihrab-methods';
+ *   const { place } = nearestPlace('algeria', 36.75, 3.06)!;
+ *   timesFor(place, '2026-10-15');
+ */
+import './authorities/sweden.js';
+import './authorities/diyanet.js';
+import './authorities/morocco.js';
+import './authorities/algeria.js';
+import './authorities/indonesia.js';
+export * from './core/index.js';
+export { diyanetCountry } from './authorities/diyanet.js';

package/dist/esm/indonesia.d.ts

@@ -0,0 +1,4 @@
+/** mihrab-methods/indonesia — the indonesia method with its places and correction list, and nothing else's. */
+import './authorities/indonesia.js';
+export * from './core/index.js';
+export { places } from './authorities/indonesia.js';

package/dist/esm/indonesia.js

@@ -0,0 +1,4 @@
+/** mihrab-methods/indonesia — the indonesia method with its places and correction list, and nothing else's. */
+import './authorities/indonesia.js';
+export * from './core/index.js';
+export { places } from './authorities/indonesia.js';

package/dist/esm/locate.d.ts

@@ -0,0 +1,21 @@
+import type { Authority } from './core/types.js';
+/** Offshore, or a coast the outline cut: the nearest country this close. */
+export declare const COASTAL_REACH_KM = 25;
+/**
+ * The country at a point (ISO 3166-1 alpha-2), among those with a method
+ * here and their neighbours; null elsewhere. Western Sahara answers 'MA' and
+ * Northern Cyprus 'TR', with the authorities that serve them. A point on no
+ * land — offshore, or on a coast the simplification shaved — is given to
+ * the nearest country within 25 km.
+ */
+export declare function countryAt(latitude: number, longitude: number): string | null;
+/**
+ * The authority whose table a point's community prays by: Sweden's inside
+ * Sweden, Morocco's in Morocco (with Western Sahara, and Ceuta and Melilla,
+ * which the ministry lists — when `mihrab-methods/morocco` is loaded, so
+ * its cities can be consulted), Algeria's, Indonesia's, and Diyanet's in
+ * Türkiye and Northern Cyprus. Null elsewhere: Diyanet publishes tables
+ * for places in 197 other countries, but it is not those countries' own
+ * authority, so an app offers it there as a choice, not as the default.
+ */
+export declare function defaultAuthorityFor(latitude: number, longitude: number): Authority | null;

package/dist/esm/locate.js

@@ -0,0 +1,196 @@
+/**
+ * mihrab-methods/locate — which authority a point belongs to.
+ *
+ * `countryAt(lat, lon)` answers the country at a point among those with a
+ * method here and their neighbours, from Natural Earth's 1:10m outlines
+ * (public domain) simplified to a few hundred metres — so a border town, a
+ * strait or a split island is answered by the side it is on (Haparanda and
+ * Tornio, two kilometres apart; Ceuta on Morocco's coast; Sebatik, split
+ * between Indonesia and Malaysia). `defaultAuthorityFor(lat, lon)` turns
+ * that into the authority whose table the point's community prays by, or
+ * null where none of the five applies.
+ *
+ * Its own entry point because the outlines are 470 KB an app that already
+ * knows its country does not need.
+ */
+import outlines from './data/generated/countryOutlines.js';
+import { isLoaded } from './core/registry.js';
+import { nearestPlace } from './core/api.js';
+/** Offshore, or a coast the outline cut: the nearest country this close. */
+export const COASTAL_REACH_KM = 25;
+function ring(flat, scale) {
+    const n = flat.length / 2;
+    const xs = new Float64Array(n);
+    const ys = new Float64Array(n);
+    let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+    for (let i = 0; i < n; i++) {
+        const x = flat[2 * i] / scale;
+        const y = flat[2 * i + 1] / scale;
+        xs[i] = x;
+        ys[i] = y;
+        if (x < minX)
+            minX = x;
+        if (x > maxX)
+            maxX = x;
+        if (y < minY)
+            minY = y;
+        if (y > maxY)
+            maxY = y;
+    }
+    return { xs, ys, minX, minY, maxX, maxY };
+}
+let countries = null;
+function load() {
+    if (countries)
+        return countries;
+    return (countries = Object.entries(outlines.countries).map(([code, polys]) => {
+        const ps = polys.map(rings => ({ outer: ring(rings[0], outlines.scale), holes: rings.slice(1).map(r => ring(r, outlines.scale)) }));
+        return {
+            code,
+            polys: ps,
+            minX: Math.min(...ps.map(p => p.outer.minX)),
+            minY: Math.min(...ps.map(p => p.outer.minY)),
+            maxX: Math.max(...ps.map(p => p.outer.maxX)),
+            maxY: Math.max(...ps.map(p => p.outer.maxY)),
+        };
+    }));
+}
+function inRing(r, x, y) {
+    if (x < r.minX || x > r.maxX || y < r.minY || y > r.maxY)
+        return false;
+    let hit = false;
+    const { xs, ys } = r;
+    for (let i = 0, j = xs.length - 1; i < xs.length; j = i++) {
+        if (ys[i] > y !== ys[j] > y && x < ((xs[j] - xs[i]) * (y - ys[i])) / (ys[j] - ys[i]) + xs[i])
+            hit = !hit;
+    }
+    return hit;
+}
+/** Distance (km) from a point to a ring's edge, on a local flat projection. */
+function edgeKm(r, x, y) {
+    const kx = 111.32 * Math.cos((y * Math.PI) / 180);
+    const ky = 110.57;
+    let best = Infinity;
+    const { xs, ys } = r;
+    for (let i = 0, j = xs.length - 1; i < xs.length; j = i++) {
+        const ax = (xs[j] - x) * kx, ay = (ys[j] - y) * ky;
+        const bx = (xs[i] - x) * kx, by = (ys[i] - y) * ky;
+        const dx = bx - ax, dy = by - ay;
+        const len = dx * dx + dy * dy;
+        const t = len > 0 ? Math.max(0, Math.min(1, -(ax * dx + ay * dy) / len)) : 0;
+        const px = ax + t * dx, py = ay + t * dy;
+        const d = px * px + py * py;
+        if (d < best)
+            best = d;
+    }
+    return Math.sqrt(best);
+}
+/**
+ * Where the 1:10m outline itself is wrong by more than a town, or a town is
+ * closer to a border than the outlines can tell: [lat, lon, radius km,
+ * country]. Its Torne runs half a kilometre east of the real one, so Tornio
+ * was Swedish; its fell border puts Riksgränsen, the Swedish station, in
+ * Norway; and it has no Kastellorizo, two kilometres off Kaş.
+ */
+const FIXES = [
+    [65.85, 24.17, 1.3, 'FI'], // Tornio's centre (Haparanda is across the river, 2 km west)
+    [68.4256, 18.1265, 1.5, 'SE'], // Riksgränsen
+    [36.1497, 29.5947, 3, 'GR'], // Kastellorizo
+    [59.3797, 28.1791, 1, 'EE'], // Narva (Ivangorod, Russia, across the river)
+    [38.4562, 48.875, 1.2, 'AZ'], // Astara (Astara, Iran, across the river)
+    [29.5577, 34.9519, 2, 'IL'], // Eilat (Aqaba 5 km east, Taba 7 km south)
+];
+function fixAt(latitude, longitude) {
+    for (const [lat, lon, km, code] of FIXES) {
+        const dy = (latitude - lat) * 110.57;
+        const dx = (longitude - lon) * 111.32 * Math.cos((lat * Math.PI) / 180);
+        if (dx * dx + dy * dy <= km * km)
+            return code;
+    }
+    return null;
+}
+function nearestWithin(all, x, y, reachKm) {
+    const reachY = reachKm / 110;
+    const reachX = reachKm / (111.32 * Math.max(0.05, Math.cos((y * Math.PI) / 180)));
+    let best = reachKm;
+    let code = null;
+    for (const c of all) {
+        if (x < c.minX - reachX || x > c.maxX + reachX || y < c.minY - reachY || y > c.maxY + reachY)
+            continue;
+        for (const p of c.polys) {
+            const r = p.outer;
+            if (x < r.minX - reachX || x > r.maxX + reachX || y < r.minY - reachY || y > r.maxY + reachY)
+                continue;
+            const d = edgeKm(r, x, y);
+            if (d < best) {
+                best = d;
+                code = c.code;
+            }
+        }
+    }
+    return code;
+}
+/**
+ * The country at a point (ISO 3166-1 alpha-2), among those with a method
+ * here and their neighbours; null elsewhere. Western Sahara answers 'MA' and
+ * Northern Cyprus 'TR', with the authorities that serve them. A point on no
+ * land — offshore, or on a coast the simplification shaved — is given to
+ * the nearest country within 25 km.
+ */
+export function countryAt(latitude, longitude) {
+    if (!Number.isFinite(latitude) || !Number.isFinite(longitude))
+        return null;
+    const fixed = fixAt(latitude, longitude);
+    if (fixed)
+        return fixed;
+    const x = longitude, y = latitude;
+    const all = load();
+    for (const c of all) {
+        if (x < c.minX || x > c.maxX || y < c.minY || y > c.maxY)
+            continue;
+        if (c.polys.some(p => inRing(p.outer, x, y) && !p.holes.some(h => inRing(h, x, y))))
+            return c.code;
+    }
+    return nearestWithin(all, x, y, COASTAL_REACH_KM);
+}
+/** Ceuta and Melilla, which the ministry publishes, are covered to their edges. */
+const EXCLAVE_KM = 8;
+/** A listed Moroccan town the outline's border runs through (Ahfir, Lagouira). */
+const LISTED_TOWN_KM = 5;
+/**
+ * The authority whose table a point's community prays by: Sweden's inside
+ * Sweden, Morocco's in Morocco (with Western Sahara, and Ceuta and Melilla,
+ * which the ministry lists — when `mihrab-methods/morocco` is loaded, so
+ * its cities can be consulted), Algeria's, Indonesia's, and Diyanet's in
+ * Türkiye and Northern Cyprus. Null elsewhere: Diyanet publishes tables
+ * for places in 197 other countries, but it is not those countries' own
+ * authority, so an app offers it there as a choice, not as the default.
+ */
+export function defaultAuthorityFor(latitude, longitude) {
+    const code = countryAt(latitude, longitude);
+    switch (code) {
+        case 'SE':
+            return 'sweden';
+        case 'MA':
+            return 'morocco';
+        case 'DZ':
+            return 'algeria';
+        case 'ID':
+            return 'indonesia';
+        case 'TR':
+            return 'diyanet';
+        case 'ES':
+        case 'MR': {
+            if (!isLoaded('morocco'))
+                return null;
+            const near = nearestPlace('morocco', latitude, longitude);
+            if (!near)
+                return null;
+            const within = near.distanceKm <= (code === 'ES' ? EXCLAVE_KM : LISTED_TOWN_KM);
+            // Spain's cities the ministry lists are its two on the African coast.
+            return within && (code !== 'ES' || latitude < 35.95) ? 'morocco' : null;
+        }
+        default:
+            return null;
+    }
+}

package/dist/esm/methods/algeria.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Algeria — the Ministry of Religious Affairs and Wakfs's method, as its
+ * timetable is computed (issue #70).
+ *
+ * Read off the Ministry's own 1448 AH table (68 cities, 248 days each):
+ *
+ *   • the Sun from NOAA's formulas (the solar-calculator series for the
+ *     equation of time; its declination). They fit the table far better
+ *     than a precise ephemeris (JPL DE421) or Meeus's chapter-25 Sun, so
+ *     this is what the Ministry's program uses, not an approximation of it;
+ *   • Dhuhr at the Sun's transit, the equation of time taken there;
+ *   • every other time the transit plus or minus the hour angle, with the
+ *     declination taken at that prayer's own moment (iterated) and the
+ *     equation of time kept at noon's value;
+ *   • Fajr 18°, Isha 17°, sunrise and sunset at −0.833°;
+ *   • Asr from the noon shadow tan(φ − δ) WITH its sign, so where the Sun
+ *     culminates north of the zenith (In Guezzam, Bordj Badji Mokhtar,
+ *     Tamanrasset around June) Asr comes earlier, up to thirteen minutes;
+ *   • Maghrib three minutes after sunset;
+ *   • every time rounded UP to the minute.
+ *
+ * At each city's own point this gives the Ministry's minute for 99.4% of
+ * the published times; every other one is a single minute, where the
+ * exact time falls within about a second of a minute's edge (see
+ * `tools/verify-methods/README.md`).
+ */
+export type AlgeriaInstants = {
+    fajr: Date;
+    sunrise: Date;
+    dhuhr: Date;
+    asr: Date;
+    maghrib: Date;
+    isha: Date;
+};
+/** NOAA's Sun at `d` days from J2000.0 (UT): declination (rad), equation of time (minutes). */
+export declare function noaaSun(d: number): {
+    dec: number;
+    eot: number;
+};
+/**
+ * The day's exact times, minutes past 00:00 UT of the civil date, before
+ * rounding. NaN where the Sun never reaches the angle (not in Algeria).
+ */
+export declare function algeriaRawMinutes(latitude: number, longitude: number, year: number, month: number, day: number, asrShadow?: number): {
+    fajr: number;
+    sunrise: number;
+    dhuhr: number;
+    asr: number;
+    sunset: number;
+    isha: number;
+};
+/**
+ * The Ministry's times for a point and civil date (month 0-based), as
+ * instants on the minute. Null when a time does not form at that point.
+ */
+export declare function algeriaTimes(latitude: number, longitude: number, year: number, month: number, day: number, asrShadow?: number): AlgeriaInstants | null;

package/dist/esm/methods/algeria.js

@@ -0,0 +1,114 @@
+/**
+ * Algeria — the Ministry of Religious Affairs and Wakfs's method, as its
+ * timetable is computed (issue #70).
+ *
+ * Read off the Ministry's own 1448 AH table (68 cities, 248 days each):
+ *
+ *   • the Sun from NOAA's formulas (the solar-calculator series for the
+ *     equation of time; its declination). They fit the table far better
+ *     than a precise ephemeris (JPL DE421) or Meeus's chapter-25 Sun, so
+ *     this is what the Ministry's program uses, not an approximation of it;
+ *   • Dhuhr at the Sun's transit, the equation of time taken there;
+ *   • every other time the transit plus or minus the hour angle, with the
+ *     declination taken at that prayer's own moment (iterated) and the
+ *     equation of time kept at noon's value;
+ *   • Fajr 18°, Isha 17°, sunrise and sunset at −0.833°;
+ *   • Asr from the noon shadow tan(φ − δ) WITH its sign, so where the Sun
+ *     culminates north of the zenith (In Guezzam, Bordj Badji Mokhtar,
+ *     Tamanrasset around June) Asr comes earlier, up to thirteen minutes;
+ *   • Maghrib three minutes after sunset;
+ *   • every time rounded UP to the minute.
+ *
+ * At each city's own point this gives the Ministry's minute for 99.4% of
+ * the published times; every other one is a single minute, where the
+ * exact time falls within about a second of a minute's edge (see
+ * `tools/verify-methods/README.md`).
+ */
+const RAD = Math.PI / 180;
+const DAY_MS = 86_400_000;
+/** NOAA's Sun at `d` days from J2000.0 (UT): declination (rad), equation of time (minutes). */
+export function noaaSun(d) {
+    const T = d / 36525;
+    const L0 = (((280.46646 + T * (36000.76983 + 0.0003032 * T)) % 360) + 360) % 360;
+    const M = 357.52911 + T * (35999.05029 - 0.0001537 * T);
+    const ecc = 0.016708634 - T * (0.000042037 + 0.0000001267 * T);
+    const Mr = M * RAD;
+    const C = (1.914602 - T * (0.004817 + 0.000014 * T)) * Math.sin(Mr) +
+        (0.019993 - 0.000101 * T) * Math.sin(2 * Mr) +
+        0.000289 * Math.sin(3 * Mr);
+    const om = (125.04 - 1934.136 * T) * RAD;
+    const lambda = L0 + C - 0.00569 - 0.00478 * Math.sin(om);
+    const eps0 = 23 + (26 + (21.448 - T * (46.815 + T * (0.00059 - T * 0.001813))) / 60) / 60;
+    const eps = eps0 + 0.00256 * Math.cos(om);
+    const dec = Math.asin(Math.sin(eps * RAD) * Math.sin(lambda * RAD));
+    const y = Math.tan((eps0 * RAD) / 2) ** 2;
+    const L0r = L0 * RAD;
+    const eot = (4 / RAD) *
+        (y * Math.sin(2 * L0r) -
+            2 * ecc * Math.sin(Mr) +
+            4 * ecc * y * Math.sin(Mr) * Math.cos(2 * L0r) -
+            0.5 * y * y * Math.sin(4 * L0r) -
+            1.25 * ecc * ecc * Math.sin(2 * Mr));
+    return { dec, eot };
+}
+const ITERATIONS = 3;
+/**
+ * The day's exact times, minutes past 00:00 UT of the civil date, before
+ * rounding. NaN where the Sun never reaches the angle (not in Algeria).
+ */
+export function algeriaRawMinutes(latitude, longitude, year, month, day, asrShadow = 1) {
+    const d0 = (Date.UTC(year, month, day) - Date.UTC(2000, 0, 1)) / DAY_MS - 0.5;
+    const at = (t) => noaaSun(d0 + t / 1440);
+    let noon = 720 - 4 * longitude;
+    for (let i = 0; i < ITERATIONS; i++)
+        noon = 720 - 4 * longitude - at(noon).eot;
+    const transit = 720 - 4 * longitude - at(noon).eot;
+    const sp = Math.sin(latitude * RAD);
+    const cp = Math.cos(latitude * RAD);
+    const event = (altitudeOf, sign, start) => {
+        let t = start;
+        for (let i = 0; i < ITERATIONS; i++) {
+            const { dec } = at(t);
+            const c = (Math.sin(altitudeOf(dec) * RAD) - sp * Math.sin(dec)) / (cp * Math.cos(dec));
+            if (!(Math.abs(c) <= 1))
+                return NaN;
+            t = transit + (sign * 4 * Math.acos(c)) / RAD;
+        }
+        return t;
+    };
+    const fixed = (a) => () => a;
+    const asrAltitude = (dec) => Math.atan(1 / (asrShadow + Math.tan((latitude - dec / RAD) * RAD))) / RAD;
+    return {
+        fajr: event(fixed(-18), -1, noon - 420),
+        sunrise: event(fixed(-0.833), -1, noon - 360),
+        dhuhr: noon,
+        asr: event(asrAltitude, 1, noon + 200),
+        sunset: event(fixed(-0.833), 1, noon + 360),
+        isha: event(fixed(-17), 1, noon + 420),
+    };
+}
+const MAGHRIB_AFTER_SUNSET_MIN = 3;
+/** Rounded up to the minute, as the Ministry prints. */
+function up(m) {
+    return Math.ceil(m - 1e-9);
+}
+/**
+ * The Ministry's times for a point and civil date (month 0-based), as
+ * instants on the minute. Null when a time does not form at that point.
+ */
+export function algeriaTimes(latitude, longitude, year, month, day, asrShadow = 1) {
+    const r = algeriaRawMinutes(latitude, longitude, year, month, day, asrShadow);
+    const all = [r.fajr, r.sunrise, r.dhuhr, r.asr, r.sunset, r.isha];
+    if (!all.every(Number.isFinite))
+        return null;
+    const start = Date.UTC(year, month, day);
+    const at = (m) => new Date(start + up(m) * 60_000);
+    return {
+        fajr: at(r.fajr),
+        sunrise: at(r.sunrise),
+        dhuhr: at(r.dhuhr),
+        asr: at(r.asr),
+        maghrib: at(r.sunset + MAGHRIB_AFTER_SUNSET_MIN),
+        isha: at(r.isha),
+    };
+}

package/dist/esm/methods/indonesia.d.ts

@@ -0,0 +1,31 @@
+export type KemenagInstants = {
+    fajr: Date;
+    sunrise: Date;
+    dhuhr: Date;
+    asr: Date;
+    maghrib: Date;
+    isha: Date;
+};
+export type KemenagPlaceOptions = {
+    /** The ministry's highland class: sunrise and Maghrib at −2° rather than −1°. */
+    highland?: boolean;
+    /** The highland degree on Fajr and Isha as well (six regencies of Papua). */
+    twilightDip?: boolean;
+    asrShadow?: number;
+    /**
+     * Where the ministry computes the regency's Asr, Maghrib and Isha, when not
+     * at its point (Karawang's afternoon is computed about 2 km north-east).
+     */
+    afternoon?: readonly [number, number];
+};
+/** Exact times with the margins, minutes past 00:00 UT of the civil date, before rounding. */
+export declare function kemenagRawMinutes(latitude: number, longitude: number, year: number, month: number, day: number, opts?: KemenagPlaceOptions): {
+    fajr: number;
+    sunrise: number;
+    dhuhr: number;
+    asr: number;
+    maghrib: number;
+    isha: number;
+};
+/** The ministry's times for a point and civil date (month 0-based), on the minute; null where one does not form. */
+export declare function kemenagTimes(latitude: number, longitude: number, year: number, month: number, day: number, opts?: KemenagPlaceOptions): KemenagInstants | null;

package/dist/esm/methods/indonesia.js

@@ -0,0 +1,90 @@
+/**
+ * Indonesia — the Ministry of Religious Affairs' (Kemenag) method, as its
+ * timetable is computed.
+ *
+ * Read off its table for all 517 regencies and cities (October–December
+ * 2026):
+ *
+ *   • the precise apparent Sun (`preciseApparentSun`, as JPL's to a tenth
+ *     of a second), taken at each prayer's own moment, iterated — Meeus's
+ *     shorter series drifts by a second and left a minute in two hundred
+ *     off;
+ *   • Fajr 20°, Isha 18°; sunrise and Maghrib at −1°, and at −2° in the
+ *     regencies the ministry classes as highland — in six highland
+ *     regencies of Papua the degree is taken off Fajr and Isha too;
+ *   • Asr when the shadow is its length plus the noon shadow, the noon
+ *     shadow from the Sun's declination at 00:00 UT of the day (as an
+ *     almanac's daily entry gives it), the hour angle from the Sun at Asr;
+ *   • every time rounded up, after a margin of two minutes (three for
+ *     Dhuhr, minus three for sunrise).
+ *
+ * At each regency's own point (fitted to the table; Karawang's afternoon
+ * at a second one) this gives the ministry's minute for 99.969 % of its
+ * times, and never a minute further; the rest are within about a second
+ * of a minute's edge, with no pattern a model could take
+ * (`data/corrections/indonesia.json` has them).
+ */
+import { preciseApparentSun } from '../sun/preciseSun.js';
+const RAD = Math.PI / 180;
+const DAY_MS = 86_400_000;
+const ITERATIONS = 3;
+const MARGIN = { fajr: 2, sunrise: -3, dhuhr: 3, asr: 2, maghrib: 2, isha: 2 };
+const ASR_ITERATIONS = 4;
+/** Exact times with the margins, minutes past 00:00 UT of the civil date, before rounding. */
+export function kemenagRawMinutes(latitude, longitude, year, month, day, opts = {}) {
+    const d0 = (Date.UTC(year, month, day) - Date.UTC(2000, 0, 1)) / DAY_MS - 0.5;
+    const at = (t) => preciseApparentSun(d0 + t / 1440);
+    let noon = 720 - 4 * longitude;
+    for (let i = 0; i < ITERATIONS; i++)
+        noon = 720 - 4 * longitude - at(noon).eot;
+    const sp = Math.sin(latitude * RAD);
+    const cp = Math.cos(latitude * RAD);
+    const hourAngle = (alt, dec) => {
+        const c = (Math.sin(alt * RAD) - sp * Math.sin(dec)) / (cp * Math.cos(dec));
+        return Math.abs(c) <= 1 ? (4 * Math.acos(c)) / RAD : NaN;
+    };
+    const event = (alt, sign, start) => {
+        let t = start;
+        for (let i = 0; i < ITERATIONS; i++) {
+            const { dec, eot } = at(t);
+            t = 720 - 4 * longitude - eot + sign * hourAngle(alt, dec);
+            if (!Number.isFinite(t))
+                return NaN;
+        }
+        return t;
+    };
+    const twilight = opts.twilightDip ? 1 : 0;
+    const horizon = opts.highland ? -2 : -1;
+    // The noon shadow from the declination at 00:00 UT; the hour angle from the Sun at Asr, iterated.
+    const shadowDec = at(0).dec;
+    const asrAlt = Math.atan(1 / ((opts.asrShadow ?? 1) + Math.tan(Math.abs(latitude * RAD - shadowDec)))) / RAD;
+    let asr = noon + 200;
+    for (let i = 0; i < ASR_ITERATIONS; i++) {
+        const { dec, eot } = at(asr);
+        asr = 720 - 4 * longitude - eot + hourAngle(asrAlt, dec);
+    }
+    return {
+        fajr: event(-20 - twilight, -1, noon - 420) + MARGIN.fajr,
+        sunrise: event(horizon, -1, noon - 360) + MARGIN.sunrise,
+        dhuhr: noon + MARGIN.dhuhr,
+        asr: asr + MARGIN.asr,
+        maghrib: event(horizon, 1, noon + 360) + MARGIN.maghrib,
+        isha: event(-18 - twilight, 1, noon + 420) + MARGIN.isha,
+    };
+}
+/** The ministry's times for a point and civil date (month 0-based), on the minute; null where one does not form. */
+export function kemenagTimes(latitude, longitude, year, month, day, opts = {}) {
+    const r = kemenagRawMinutes(latitude, longitude, year, month, day, opts);
+    if (opts.afternoon) {
+        const pm = kemenagRawMinutes(opts.afternoon[0], opts.afternoon[1], year, month, day, opts);
+        r.asr = pm.asr;
+        r.maghrib = pm.maghrib;
+        r.isha = pm.isha;
+    }
+    const all = [r.fajr, r.sunrise, r.dhuhr, r.asr, r.maghrib, r.isha];
+    if (!all.every(Number.isFinite))
+        return null;
+    const start = Date.UTC(year, month, day);
+    const at = (m) => new Date(start + Math.ceil(m - 1e-9) * 60_000);
+    return { fajr: at(r.fajr), sunrise: at(r.sunrise), dhuhr: at(r.dhuhr), asr: at(r.asr), maghrib: at(r.maghrib), isha: at(r.isha) };
+}