mihrab-methods 1.0.2 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/README.md +23 -6
  2. package/certification.json +23 -23
  3. package/data/corrections/indonesia.json +528 -132
  4. package/data/corrections/morocco.json +201 -914
  5. package/dist/cjs/authorities/indonesia.js +4 -4
  6. package/dist/cjs/authorities/morocco.js +7 -6
  7. package/dist/cjs/core/compute.js +1 -1
  8. package/dist/cjs/data/generated/algeriaCertification.js +1 -1
  9. package/dist/cjs/data/generated/diyanetCertification.js +1 -1
  10. package/dist/cjs/data/generated/diyanetWorldPoints.js +1 -1
  11. package/dist/cjs/data/generated/indonesiaCertification.js +1 -1
  12. package/dist/cjs/data/generated/indonesiaCorrections.js +1 -1
  13. package/dist/cjs/data/generated/kemenagMethodPoints.js +1 -1
  14. package/dist/cjs/data/generated/moroccoCertification.js +1 -1
  15. package/dist/cjs/data/generated/moroccoCorrections.js +1 -1
  16. package/dist/cjs/data/generated/moroccoMethodPoints.js +1 -1
  17. package/dist/cjs/data/generated/swedenCertification.js +1 -1
  18. package/dist/cjs/methods/indonesia.d.ts +2 -2
  19. package/dist/cjs/methods/indonesia.js +16 -9
  20. package/dist/cjs/methods/morocco.d.ts +43 -20
  21. package/dist/cjs/methods/morocco.js +59 -25
  22. package/dist/cjs/methods/revisions.d.ts +2 -2
  23. package/dist/cjs/methods/revisions.js +2 -2
  24. package/dist/cjs/server.d.ts +12 -0
  25. package/dist/cjs/server.js +132 -0
  26. package/dist/cjs/sun/preciseSun.d.ts +6 -1
  27. package/dist/cjs/sun/preciseSun.js +7 -2
  28. package/dist/esm/authorities/indonesia.js +4 -4
  29. package/dist/esm/authorities/morocco.js +7 -6
  30. package/dist/esm/core/compute.js +1 -1
  31. package/dist/esm/data/generated/algeriaCertification.js +1 -1
  32. package/dist/esm/data/generated/diyanetCertification.js +1 -1
  33. package/dist/esm/data/generated/diyanetWorldPoints.js +1 -1
  34. package/dist/esm/data/generated/indonesiaCertification.js +1 -1
  35. package/dist/esm/data/generated/indonesiaCorrections.js +1 -1
  36. package/dist/esm/data/generated/kemenagMethodPoints.js +1 -1
  37. package/dist/esm/data/generated/moroccoCertification.js +1 -1
  38. package/dist/esm/data/generated/moroccoCorrections.js +1 -1
  39. package/dist/esm/data/generated/moroccoMethodPoints.js +1 -1
  40. package/dist/esm/data/generated/swedenCertification.js +1 -1
  41. package/dist/esm/methods/indonesia.d.ts +2 -2
  42. package/dist/esm/methods/indonesia.js +16 -9
  43. package/dist/esm/methods/morocco.d.ts +43 -20
  44. package/dist/esm/methods/morocco.js +54 -24
  45. package/dist/esm/methods/revisions.d.ts +2 -2
  46. package/dist/esm/methods/revisions.js +2 -2
  47. package/dist/esm/server.d.ts +12 -0
  48. package/dist/esm/server.js +126 -0
  49. package/dist/esm/sun/preciseSun.d.ts +6 -1
  50. package/dist/esm/sun/preciseSun.js +7 -2
  51. package/docs/methods.md +34 -10
  52. package/package.json +11 -2
  53. package/dist/cjs/methods/scratch-congress.d.ts +0 -87
  54. package/dist/cjs/methods/scratch-congress.js +0 -539
  55. package/dist/esm/methods/scratch-congress.d.ts +0 -87
  56. package/dist/esm/methods/scratch-congress.js +0 -534
@@ -3,29 +3,47 @@
3
3
  * Morocco — the Ministry of Habous and Islamic Affairs's method, as its
4
4
  * timetable is computed (issue #10).
5
5
  *
6
- * Read off 77 days of the ministry's tables for its 164 located cities:
6
+ * Read off the ministry's tables: 96 days of 2026 for its 164 located
7
+ * cities, and — through the Internet Archive — its pages of 2014–2025 for
8
+ * Rabat, Figuig, Tangier, Casablanca, Laayoune and a dozen more, every
9
+ * month of the year. The ministry's program changed between 2019 and
10
+ * 2023; this is the one it has used since (2023–2026), and what it does:
7
11
  *
8
12
  * • a precise Sun — Meeus's apparent Sun with the full nutation and his
9
13
  * chapter-28 equation of time; a JPL ephemeris fits no better, NOAA's
10
14
  * and the Almanac's series far worse — taken at each prayer's own
11
15
  * moment (iterated), declination and equation of time alike;
12
- * • Fajr 19°, Isha 17°, Asr one shadow length (Shafi'i);
16
+ * • Fajr 19° and Isha 17°, true altitudes;
13
17
  * • Dhuhr five minutes after the transit;
14
- * • sunrise 2.85 minutes before, and Maghrib 3.7 after, the Sun's upper
15
- * limb on the horizon — refraction 34′ and the Sun's semi-diameter for
16
- * its distance that day — less the city's own horizon dip;
18
+ * • Asr on the APPARENT Sun, by the classical rule: a gnomon's shadow at
19
+ * noon (the noon declination, the noon altitude raised by refraction)
20
+ * plus one length (Shafi'i), and the moment the apparent Sun casts it
21
+ * — refraction by Sæmundsson's formula from the true altitude at noon,
22
+ * Bennett's from the apparent at Asr (Meeus 16.4 and 16.3);
23
+ * • sunrise one minute before, and Maghrib 1.8 minutes after, the Sun
24
+ * on an altitude −(34′ + s) − dip: refraction, the semi-diameter for
25
+ * its distance that day, and the city's own allowance for its horizon;
17
26
  * • Fajr rounded down to the minute, the rest to the nearest.
18
27
  *
19
- * The dip is the ministry's own per city and per side — the horizon east
20
- * at sunrise, west at Maghrib, which mountains or the sea make different —
21
- * fitted from its tables with the city's point (`data/moroccoMethodPoints.json`,
22
- * about 0.02° per √metre of height); elsewhere 0.02°·√height, 0.86 of it at
23
- * Maghrib. On 77 days of the ministry's tables for its 164 located cities
24
- * this is its printed minute for 99.12 % of times, and never further than
25
- * one; `data/corrections/morocco.json` holds the rest.
28
+ * The horizon allowance ("dip") is the ministry's own per city and per
29
+ * side — east at sunrise, west at Maghrib — fitted from its tables with
30
+ * the city's point (`data/moroccoMethodPoints.json`); it follows the
31
+ * city's height closely (about 0.32° + 0.025°·√metres east, 0.37° +
32
+ * 0.021°·√metres west; 92 % correlation), which is what a city off the
33
+ * list gets. It is an angle, not minutes: the allowance in minutes grows
34
+ * towards the solstices, as the ministry's does, and the fixed minute
35
+ * margins are the small rest. Fitted on the autumn alone (the first
36
+ * version of this method) the two could not be told apart, and the method
37
+ * drifted a tenth of a minute by late November.
38
+ *
39
+ * On the 2026 tables this is the ministry's printed minute for 99.88 % of
40
+ * times (114 of 94,350 off, each within a second or two of a minute's
41
+ * edge: the ministry's Sun and this one differ by that much), and never
42
+ * further than one; `data/corrections/morocco.json` holds the rest. On
43
+ * the archive's 2023–2026 pages, every month of the year, 99.3 %.
26
44
  */
27
45
  Object.defineProperty(exports, "__esModule", { value: true });
28
- exports.MOROCCO_DIP_PER_SQRT_M = exports.MOROCCO_MAGHRIB_DIP_SHARE = exports.MOROCCO_MAGHRIB_MARGIN = exports.MOROCCO_SUNRISE_MARGIN = void 0;
46
+ exports.refractionFromApparent = exports.refractionFromTrue = exports.moroccoDipWest = exports.moroccoDipEast = exports.MOROCCO_MAGHRIB_MARGIN = exports.MOROCCO_SUNRISE_MARGIN = void 0;
29
47
  exports.meeusApparentSun = meeusApparentSun;
30
48
  exports.moroccoRawMinutes = moroccoRawMinutes;
31
49
  exports.moroccoTimes = moroccoTimes;
@@ -55,16 +73,25 @@ function meeusApparentSun(d) {
55
73
  }
56
74
  const ITERATIONS = 3;
57
75
  /** Minutes before the horizon crossing that the ministry prints sunrise, and after it Maghrib. */
58
- exports.MOROCCO_SUNRISE_MARGIN = -2.85;
59
- exports.MOROCCO_MAGHRIB_MARGIN = 3.7;
60
- /** The share of the horizon dip Maghrib takes, against sunrise's whole, where a city's own is not known. */
61
- exports.MOROCCO_MAGHRIB_DIP_SHARE = 0.86;
62
- /** Degrees of dip per √metre where the ministry's own value is not known. */
63
- exports.MOROCCO_DIP_PER_SQRT_M = 0.02;
76
+ exports.MOROCCO_SUNRISE_MARGIN = -1.0;
77
+ exports.MOROCCO_MAGHRIB_MARGIN = 1.8;
78
+ /** The horizon allowance of a city whose own is not known: degrees, from its height in metres, east (sunrise) and west (Maghrib). */
79
+ const moroccoDipEast = (heightM) => 0.32 + 0.025 * Math.sqrt(Math.max(heightM, 0));
80
+ exports.moroccoDipEast = moroccoDipEast;
81
+ const moroccoDipWest = (heightM) => 0.37 + 0.021 * Math.sqrt(Math.max(heightM, 0));
82
+ exports.moroccoDipWest = moroccoDipWest;
83
+ /** Refraction (degrees) that lifts a TRUE altitude h (degrees) to its apparent one — Sæmundsson, Meeus 16.4. */
84
+ const refractionFromTrue = (h) => (1.02 / Math.tan((h + 10.3 / (h + 5.11)) * RAD)) / 60;
85
+ exports.refractionFromTrue = refractionFromTrue;
86
+ /** Refraction (degrees) under an APPARENT altitude h (degrees) — Bennett, Meeus 16.3. */
87
+ const refractionFromApparent = (h) => (1 / Math.tan((h + 7.31 / (h + 4.4)) * RAD)) / 60;
88
+ exports.refractionFromApparent = refractionFromApparent;
64
89
  /** Exact times, minutes past 00:00 UT of the civil date, margins applied, before rounding. NaN where one does not form. */
65
- function moroccoRawMinutes(latitude, longitude, year, month, day, dipDeg = 0, asrShadow = 1,
66
- /** The horizon's dip westward, at Maghrib; MOROCCO_MAGHRIB_DIP_SHARE of `dipDeg` when not known. */
67
- dipMaghribDeg = exports.MOROCCO_MAGHRIB_DIP_SHARE * dipDeg) {
90
+ function moroccoRawMinutes(latitude, longitude, year, month, day,
91
+ /** The horizon allowance eastward, at sunrise, degrees: the city's own, else `moroccoDipEast(height)`. */
92
+ dipDeg = (0, exports.moroccoDipEast)(0), asrShadow = 1,
93
+ /** The horizon allowance westward, at Maghrib; `moroccoDipWest(0)` offset by the east's excess when not known. */
94
+ dipMaghribDeg = dipDeg + ((0, exports.moroccoDipWest)(0) - (0, exports.moroccoDipEast)(0))) {
68
95
  const d0 = (Date.UTC(year, month, day) - Date.UTC(2000, 0, 1)) / DAY_MS - 0.5;
69
96
  const at = (t) => meeusApparentSun(d0 + t / 1440);
70
97
  let noon = 720 - 4 * longitude;
@@ -88,12 +115,19 @@ dipMaghribDeg = exports.MOROCCO_MAGHRIB_DIP_SHARE * dipDeg) {
88
115
  return t;
89
116
  };
90
117
  const fixed = (a) => () => a;
91
- const asrAltitude = (dec) => Math.atan(1 / (asrShadow + Math.tan(Math.abs(latitude - dec / RAD) * RAD))) / RAD;
118
+ // Asr on the apparent Sun: the noon shadow of a gnomon from the apparent noon altitude (the noon
119
+ // declination), plus `asrShadow` lengths; the Sun's apparent altitude that casts it; the true
120
+ // altitude under it is what the hour angle is solved for, with the declination at the event.
121
+ const noonDec = at(noon).dec;
122
+ const noonTrue = 90 - Math.abs(latitude - noonDec / RAD);
123
+ const noonApparent = noonTrue + (0, exports.refractionFromTrue)(noonTrue);
124
+ const asrApparent = Math.atan(1 / (asrShadow + 1 / Math.tan(noonApparent * RAD))) / RAD;
125
+ const asrTrue = asrApparent - (0, exports.refractionFromApparent)(asrApparent);
92
126
  return {
93
127
  fajr: event(fixed(-19), -1, noon - 420) - 0.5,
94
128
  sunrise: event(fixed(horizon - dipDeg), -1, noon - 360) + exports.MOROCCO_SUNRISE_MARGIN,
95
129
  dhuhr: noon + 5,
96
- asr: event(asrAltitude, 1, noon + 200),
130
+ asr: event(fixed(asrTrue), 1, noon + 200),
97
131
  maghrib: event(fixed(horizon - dipMaghribDeg), 1, noon + 360) + exports.MOROCCO_MAGHRIB_MARGIN,
98
132
  isha: event(fixed(-17), 1, noon + 420),
99
133
  };
@@ -102,7 +136,7 @@ dipMaghribDeg = exports.MOROCCO_MAGHRIB_DIP_SHARE * dipDeg) {
102
136
  * The ministry's times for a point and civil date (month 0-based), on the
103
137
  * minute. Null when a time does not form there.
104
138
  */
105
- function moroccoTimes(latitude, longitude, year, month, day, dipDeg = 0, asrShadow = 1, dipMaghribDeg) {
139
+ function moroccoTimes(latitude, longitude, year, month, day, dipDeg, asrShadow = 1, dipMaghribDeg) {
106
140
  const r = moroccoRawMinutes(latitude, longitude, year, month, day, dipDeg, asrShadow, dipMaghribDeg);
107
141
  const all = [r.fajr, r.sunrise, r.dhuhr, r.asr, r.maghrib, r.isha];
108
142
  if (!all.every(Number.isFinite))
@@ -9,7 +9,7 @@
9
9
  export declare const METHOD_REVISION: {
10
10
  readonly sweden: 1;
11
11
  readonly diyanet: 1;
12
- readonly morocco: 1;
12
+ readonly morocco: 2;
13
13
  readonly algeria: 1;
14
- readonly indonesia: 1;
14
+ readonly indonesia: 2;
15
15
  };
@@ -12,7 +12,7 @@ exports.METHOD_REVISION = void 0;
12
12
  exports.METHOD_REVISION = {
13
13
  sweden: 1,
14
14
  diyanet: 1,
15
- morocco: 1,
15
+ morocco: 2,
16
16
  algeria: 1,
17
- indonesia: 1,
17
+ indonesia: 2,
18
18
  };
@@ -0,0 +1,12 @@
1
+ export declare class HttpError extends Error {
2
+ readonly status: number;
3
+ constructor(status: number, message: string);
4
+ }
5
+ /** The answer to a request path and query. Throws HttpError, UncertifiedMethodError, RangeError or TypeError. */
6
+ export declare function handle(url: URL): unknown;
7
+ /** Status, body and headers for a request, errors included — what both servers send. */
8
+ export declare function respond(url: URL): {
9
+ status: number;
10
+ body: string;
11
+ headers: Record<string, string>;
12
+ };
@@ -0,0 +1,132 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.HttpError = void 0;
4
+ exports.handle = handle;
5
+ exports.respond = respond;
6
+ /**
7
+ * The HTTP API over the library — one handler, served two ways: by
8
+ * `tools/serve.ts` on Node (`npm run serve`) and by `api/worker.ts` at the
9
+ * edge (the public API). Nothing is logged or stored; every answer is JSON.
10
+ *
11
+ * GET / the routes, the methods' certification
12
+ * GET /v1/methods every method, as methodInfo gives it
13
+ * GET /v1/places?authority=algeria the authority's places (id, name, country, lat, lon, tz)
14
+ * GET /v1/nearest?authority=algeria&lat=36.75&lng=3.06
15
+ * GET /v1/times?place=algeria:27&date=2026-10-15 one day, as timesFor gives it
16
+ * GET /v1/times?authority=algeria&lat=36.75&lng=3.06&date=2026-10-15
17
+ * GET /v1/times?place=algeria:27&from=2026-10-01&to=2026-10-31
18
+ * GET /v1/authority?lat=36.75&lng=3.06 defaultAuthorityFor, with the country
19
+ *
20
+ * Options on /v1/times: asr=2 for the Hanafi Asr; strict=1 to refuse a date
21
+ * outside the certified span (HTTP 422) instead of answering 'method-only'.
22
+ */
23
+ const index_js_1 = require("./index.js");
24
+ const locate_js_1 = require("./locate.js");
25
+ class HttpError extends Error {
26
+ status;
27
+ constructor(status, message) {
28
+ super(message);
29
+ this.status = status;
30
+ }
31
+ }
32
+ exports.HttpError = HttpError;
33
+ const isAuthority = (x) => !!x && index_js_1.AUTHORITIES.includes(x);
34
+ const num = (q, k) => {
35
+ const v = Number(q.get(k));
36
+ if (q.get(k) === null || !Number.isFinite(v))
37
+ throw new HttpError(400, `${k}: a number is needed`);
38
+ return v;
39
+ };
40
+ const authorityOf = (q) => {
41
+ const a = q.get('authority');
42
+ if (!isAuthority(a))
43
+ throw new HttpError(400, `authority: one of ${index_js_1.AUTHORITIES.join(', ')}`);
44
+ return a;
45
+ };
46
+ const placeOf = (q) => {
47
+ const id = q.get('place');
48
+ if (id) {
49
+ const p = (0, index_js_1.placeById)(id);
50
+ if (!p)
51
+ throw new HttpError(404, `no place ${id}`);
52
+ return p;
53
+ }
54
+ const near = (0, index_js_1.nearestPlace)(authorityOf(q), num(q, 'lat'), num(q, 'lng'));
55
+ if (!near)
56
+ throw new HttpError(404, 'no place near there');
57
+ return near.place;
58
+ };
59
+ const brief = (p) => ({ id: p.id, name: p.name, country: p.country, lat: p.lat, lon: p.lon, tz: p.tz });
60
+ const ROUTES = [
61
+ '/v1/methods',
62
+ '/v1/places?authority=<authority>',
63
+ '/v1/nearest?authority=<authority>&lat=<lat>&lng=<lng>',
64
+ '/v1/times?place=<authority:id>&date=<YYYY-MM-DD>[&asr=2][&strict=1]',
65
+ '/v1/times?authority=<authority>&lat=<lat>&lng=<lng>&date=<YYYY-MM-DD>',
66
+ '/v1/times?place=<authority:id>&from=<YYYY-MM-DD>&to=<YYYY-MM-DD>',
67
+ '/v1/authority?lat=<lat>&lng=<lng>',
68
+ ];
69
+ /** The answer to a request path and query. Throws HttpError, UncertifiedMethodError, RangeError or TypeError. */
70
+ function handle(url) {
71
+ const q = url.searchParams;
72
+ switch (url.pathname.replace(/\/+$/, '') || '/') {
73
+ case '/':
74
+ return {
75
+ name: 'mihrab-methods',
76
+ description: 'The prayer-time authorities’ own calculation methods, each reproducing its published timetable to the minute.',
77
+ docs: 'https://github.com/MihrabHQ/mihrab-methods#readme',
78
+ routes: ROUTES,
79
+ authorities: index_js_1.AUTHORITIES,
80
+ // each method's record, as the library carries it (the feed on main may be newer: methodInfo says the date)
81
+ methods: index_js_1.AUTHORITIES.map(a => {
82
+ const m = (0, index_js_1.methodInfo)(a);
83
+ return { authority: a, name: m.name, revision: m.revision, certified: m.certified, checkedAt: m.certification?.checkedAt ?? null, places: m.places };
84
+ }),
85
+ };
86
+ case '/v1/methods':
87
+ return index_js_1.AUTHORITIES.map(index_js_1.methodInfo);
88
+ case '/v1/places':
89
+ return (0, index_js_1.placesOf)(authorityOf(q)).map(brief);
90
+ case '/v1/nearest': {
91
+ const near = (0, index_js_1.nearestPlace)(authorityOf(q), num(q, 'lat'), num(q, 'lng'));
92
+ return near && { place: brief(near.place), distanceKm: Math.round(near.distanceKm * 10) / 10 };
93
+ }
94
+ case '/v1/authority': {
95
+ const lat = num(q, 'lat'), lng = num(q, 'lng');
96
+ return { country: (0, locate_js_1.countryAt)(lat, lng), authority: (0, locate_js_1.defaultAuthorityFor)(lat, lng) };
97
+ }
98
+ case '/v1/times': {
99
+ const place = placeOf(q);
100
+ const opts = { asrShadow: q.get('asr') === '2' ? 2 : 1, strict: q.get('strict') === '1' };
101
+ const from = q.get('from'), to = q.get('to');
102
+ if (from && to)
103
+ return { place: brief(place), days: (0, index_js_1.timesForRange)(place, from, to, opts) };
104
+ return { place: brief(place), ...(0, index_js_1.timesFor)(place, q.get('date') ?? new Date().toISOString().slice(0, 10), opts) };
105
+ }
106
+ default:
107
+ throw new HttpError(404, `no such route; the routes are ${ROUTES.join(' · ')}`);
108
+ }
109
+ }
110
+ /** Status, body and headers for a request, errors included — what both servers send. */
111
+ function respond(url) {
112
+ let status = 200;
113
+ let body;
114
+ try {
115
+ body = handle(url);
116
+ }
117
+ catch (e) {
118
+ status = e instanceof HttpError ? e.status : e instanceof index_js_1.UncertifiedMethodError ? 422 : e instanceof RangeError || e instanceof TypeError ? 400 : 500;
119
+ body = { error: e.message };
120
+ }
121
+ return {
122
+ status,
123
+ body: JSON.stringify(body),
124
+ headers: {
125
+ 'content-type': 'application/json; charset=utf-8',
126
+ 'access-control-allow-origin': '*',
127
+ 'access-control-allow-methods': 'GET, OPTIONS',
128
+ // A day's times never change between releases: let browsers and the edge keep an answer for an hour.
129
+ 'cache-control': status === 200 ? 'public, max-age=3600' : 'no-store',
130
+ },
131
+ };
132
+ }
@@ -12,8 +12,13 @@ export declare function deltaT(ut: number): number;
12
12
  * The apparent Sun at `d` days from J2000.0 (UT): declination (rad) and
13
13
  * equation of time (minutes), such that the transit at longitude λ (east) is
14
14
  * 720 − 4λ − eot minutes UT. Same contract as `meeusApparentSun`.
15
+ *
16
+ * `deltaTSeconds` is what is added to UT for the ephemeris' own time (TT):
17
+ * ΔT as it is (about 70 s in the 2020s) unless given. A program that takes
18
+ * its clock time for the ephemeris' time is 0 here — the Sun 70 seconds
19
+ * behind where it is, a fifth of a second on every time of the day.
15
20
  */
16
- export declare function preciseApparentSun(d: number): {
21
+ export declare function preciseApparentSun(d: number, deltaTSeconds?: number): {
17
22
  dec: number;
18
23
  eot: number;
19
24
  };
@@ -162,9 +162,14 @@ function nutate(v, oblm, oblt, psi) {
162
162
  * The apparent Sun at `d` days from J2000.0 (UT): declination (rad) and
163
163
  * equation of time (minutes), such that the transit at longitude λ (east) is
164
164
  * 720 − 4λ − eot minutes UT. Same contract as `meeusApparentSun`.
165
+ *
166
+ * `deltaTSeconds` is what is added to UT for the ephemeris' own time (TT):
167
+ * ΔT as it is (about 70 s in the 2020s) unless given. A program that takes
168
+ * its clock time for the ephemeris' time is 0 here — the Sun 70 seconds
169
+ * behind where it is, a fifth of a second on every time of the day.
165
170
  */
166
- function preciseApparentSun(d) {
167
- const tt = d + deltaT(d) / 86400;
171
+ function preciseApparentSun(d, deltaTSeconds = deltaT(d)) {
172
+ const tt = d + deltaTSeconds / 86400;
168
173
  const e = earthJ2000(tt - 1 / C_AUDAY);
169
174
  const nut = nutation(tt);
170
175
  const mobl = meanObliquity(tt);
@@ -1,6 +1,6 @@
1
1
  /**
2
- * Indonesia — Kemenag: every regency and city, at the point its table is
3
- * computed at, in the zone it is printed in.
2
+ * Indonesia — Kemenag: every regency and city, at the coordinates the
3
+ * ministry gives for it, in the zone it is printed in.
4
4
  */
5
5
  import regencies from '../data/generated/kemenagPlaces.js';
6
6
  import points from '../data/generated/kemenagMethodPoints.js';
@@ -51,7 +51,7 @@ export const indonesia = registerAuthority({
51
51
  certification,
52
52
  description: {
53
53
  name: 'Indonesia — Kemenag (Ministry of Religious Affairs)',
54
- method: 'The precise apparent sun (VSOP87, as JPL’s to a tenth of a second) taken at each prayer’s own moment; Fajr 20°, Isha 18°; sunrise and Maghrib at −1° (−2° in the highland class); Asr when the shadow is its length plus the noon shadow, the noon shadow from the declination at 00:00 UT; every time rounded up after a margin of two minutes (three for Dhuhr, minus three for sunrise).',
54
+ method: 'The precise apparent sun (VSOP87, as JPL’s to a tenth of a second) taken at each prayer’s own moment, without ΔT; each regency at the ministry’s own coordinates; Fajr 20°, Isha 18°; sunrise and Maghrib at −1° (−2° in the highland class); Asr when the shadow is its length plus the noon shadow, the noon shadow from the declination at 00:00 UT; every time rounded up after a margin of two minutes (three for Dhuhr, minus three for sunrise).',
55
55
  countries: ['ID'],
56
56
  parameters: {
57
57
  fajrAngle: 20,
@@ -66,7 +66,7 @@ export const indonesia = registerAuthority({
66
66
  'margin.maghrib': 2,
67
67
  'margin.isha': 2,
68
68
  rounding: 'up to the minute, after the margin',
69
- sun: 'VSOP87 apparent sun (src/sun/preciseSun.ts), iterated at each prayer',
69
+ sun: 'VSOP87 apparent sun (src/sun/preciseSun.ts), iterated at each prayer, Universal Time taken for the ephemeris’ time (no ΔT)',
70
70
  },
71
71
  sources: [{ title: 'Kemenag — Jadwal Shalat', url: 'https://bimasislam.kemenag.go.id/jadwalshalat' }],
72
72
  spec: 'docs/methods.md#indonesia',
@@ -7,6 +7,7 @@ import points from '../data/generated/moroccoMethodPoints.js';
7
7
  import corrections from '../data/generated/moroccoCorrections.js';
8
8
  import certification from '../data/generated/moroccoCertification.js';
9
9
  import { METHOD_REVISION } from '../methods/revisions.js';
10
+ import { moroccoDipEast, moroccoDipWest } from '../methods/morocco.js';
10
11
  import { registerAuthority } from '../core/registry.js';
11
12
  const AUTHORITY = 'morocco';
12
13
  /**
@@ -16,7 +17,6 @@ const AUTHORITY = 'morocco';
16
17
  const MOROCCO_TZ = 'Etc/GMT';
17
18
  /** The ministry's clock: GMT+1, then GMT — its tables print GMT from 17 September 2026, three days before the clocks moved. */
18
19
  export const MOROCCO_CLOCK = [['2020-01-01', 60], ['2026-09-17', 0]];
19
- const MOROCCO_DIP_PER_SQRT_M = 0.02;
20
20
  function buildPlaces() {
21
21
  return cities
22
22
  .filter(c => typeof c.lat === 'number' && typeof c.lng === 'number')
@@ -26,7 +26,7 @@ function buildPlaces() {
26
26
  const p = points[key];
27
27
  return p
28
28
  ? { ...base, lat: p[0], lon: p[1], dipDeg: p[2], ...(p.length > 3 ? { dipMaghribDeg: p[3] } : {}) }
29
- : { ...base, lat: c.lat, lon: c.lng, dipDeg: MOROCCO_DIP_PER_SQRT_M * Math.sqrt(c.heightM ?? 0) };
29
+ : { ...base, lat: c.lat, lon: c.lng, dipDeg: moroccoDipEast(c.heightM ?? 0), dipMaghribDeg: moroccoDipWest(c.heightM ?? 0) };
30
30
  });
31
31
  }
32
32
  export const morocco = registerAuthority({
@@ -37,18 +37,19 @@ export const morocco = registerAuthority({
37
37
  certification,
38
38
  description: {
39
39
  name: 'Morocco — Ministry of Habous and Islamic Affairs',
40
- method: 'Meeus’s apparent sun taken at each prayer’s own moment; Fajr 19°, Isha 17°, Asr one shadow; Dhuhr five minutes after transit; sunrise 2.85 minutes before and Maghrib 3.7 minutes after the upper limb on the horizon, less each city’s own horizon dip east and west; Fajr rounded down, the rest to the nearest minute; printed on the ministry’s clock (GMT+1 until 17 September 2026, then GMT).',
40
+ method: 'Meeus’s apparent sun taken at each prayer’s own moment; Fajr 19°, Isha 17°; Asr on the apparent sun — the gnomon’s shadow at noon plus one length, refraction on both altitudes; Dhuhr five minutes after transit; sunrise one minute before and Maghrib 1.8 minutes after the sun on −(34′ + s) less each city’s own horizon allowance east and west (an angle, about 0.32°–0.37° + 0.02°·√height); Fajr rounded down, the rest to the nearest minute; printed on the ministry’s clock (GMT+1 until 17 September 2026, then GMT).',
41
41
  countries: ['MA'],
42
42
  parameters: {
43
43
  fajrAngle: 19,
44
44
  ishaAngle: 17,
45
45
  asrShadow: 1,
46
46
  dhuhrAfterTransitMinutes: 5,
47
- sunriseMarginMinutes: -2.85,
48
- maghribMarginMinutes: 3.7,
47
+ sunriseMarginMinutes: -1.0,
48
+ maghribMarginMinutes: 1.8,
49
49
  refractionArcmin: 34,
50
+ asrRefraction: 'Sæmundsson from the true altitude at noon, Bennett under the apparent altitude at Asr (Meeus 16.4, 16.3)',
50
51
  sunSemidiameter: 'by the sun’s distance that day',
51
- horizonDip: 'per city and per side, fitted (Place.dipDeg, Place.dipMaghribDeg); else 0.02°·√height, 0.86 of it at Maghrib',
52
+ horizonDip: 'per city and per side, fitted (Place.dipDeg, Place.dipMaghribDeg); else 0.32° + 0.025°·√height east, 0.37° + 0.021°·√height west',
52
53
  rounding: 'Fajr down to the minute, the rest to the nearest',
53
54
  sun: 'Meeus, apparent, with the full nutation; chapter-28 equation of time; iterated at each prayer',
54
55
  },
@@ -32,7 +32,7 @@ export function candidateInstants(place, year, month, day, asrShadow = 1, opts =
32
32
  case 'algeria':
33
33
  case 'indonesia': {
34
34
  const t = place.authority === 'morocco'
35
- ? moroccoTimes(place.lat, place.lon, year, month, day, place.dipDeg ?? 0, asrShadow, place.dipMaghribDeg)
35
+ ? moroccoTimes(place.lat, place.lon, year, month, day, place.dipDeg, asrShadow, place.dipMaghribDeg)
36
36
  : place.authority === 'algeria'
37
37
  ? algeriaTimes(place.lat, place.lon, year, month, day, asrShadow)
38
38
  : kemenagTimes(place.lat, place.lon, year, month, day, { highland: place.highland, twilightDip: place.twilightDip, asrShadow, afternoon: place.afternoon });
@@ -1,2 +1,2 @@
1
- const data = { "certified": true, "checkedAt": "2026-10-18", "places": 68, "checks": [{ "tables": "Algeria — Ministry of Religious Affairs", "places": 68, "times": 101184, "off": 0, "offWithoutCorrections": 642, "from": "2026-10-01", "to": "2027-06-05" }], "corrections": { "from": "2026-10-01", "to": "2027-06-05", "entries": 642, "sha256": "f8d227cdd88aabe5bcd1775ec0324abfdae07a8a3986fdd19816337c2d4ab3ca" }, "revision": 1 };
1
+ const data = { "certified": true, "checkedAt": "2026-11-09", "places": 68, "checks": [{ "tables": "Algeria — Ministry of Religious Affairs", "places": 68, "times": 101184, "off": 0, "offWithoutCorrections": 642, "from": "2026-10-01", "to": "2027-06-05" }], "corrections": { "from": "2026-10-01", "to": "2027-06-05", "entries": 642, "sha256": "f8d227cdd88aabe5bcd1775ec0324abfdae07a8a3986fdd19816337c2d4ab3ca" }, "revision": 1 };
2
2
  export default data;
@@ -1,2 +1,2 @@
1
- const data = { "certified": true, "checkedAt": "2026-10-18", "places": 8132, "checks": [{ "tables": "Diyanet — its tables worldwide", "places": 8132, "times": 69999603, "off": 0, "offWithoutCorrections": 9129, "from": "2024-01-01", "to": "2027-12-31" }], "corrections": { "from": "2024-01-01", "to": "2027-12-31", "entries": 9118, "sha256": "47997767e178ce48babd80f0e4a53460c5d379eb098bff1e7ebbba1e6afdf605" }, "revision": 1 };
1
+ const data = { "certified": true, "checkedAt": "2026-11-09", "places": 8132, "checks": [{ "tables": "Diyanet — its tables worldwide", "places": 8132, "times": 69999603, "off": 0, "offWithoutCorrections": 9129, "from": "2024-01-01", "to": "2027-12-31" }], "corrections": { "from": "2024-01-01", "to": "2027-12-31", "entries": 9118, "sha256": "47997767e178ce48babd80f0e4a53460c5d379eb098bff1e7ebbba1e6afdf605" }, "revision": 1 };
2
2
  export default data;