mihrab-methods 0.0.0-stage → 1.0.1

package/dist/cjs/methods/scratch-congress.js

@@ -0,0 +1,539 @@
+"use strict";
+/**
+ * The International Prayer Times Congress method (Istanbul, 2021 — the
+ * Diyanet and the European Council for Fatwa and Research) as Diyanet's
+ * tables realise it. Islamiska Förbundet's Swedish tables are those
+ * tables, row for row, so this is Sweden's method (id 24).
+ *
+ * The published rules (awqatsalah.com, "Tespit Kriterleri"):
+ *  - Dhuhr five minutes after transit; Asr one shadow (Dhuhr when the
+ *    shadow never forms), four minutes late; sunrise seven early,
+ *    Maghrib seven late ("temkin").
+ *  - Neither the day nor the night is shorter than five hours.
+ *  - True Fajr at 18°, true Isha at 16°. Where the 18° dawn no longer
+ *    forms, the share of the night the sharia night's third took on the
+ *    last day it did is carried: Isha that share of the night after
+ *    Maghrib, Fajr the same share scaled by 18/16 before sunrise.
+ *  - The move from true times to the carried ones is gradual, starting
+ *    twenty minutes before (Isha) or after (Fajr) the takdir.
+ *
+ * What the tables turn out to do with them, read off Diyanet's own tables
+ * for all 160 Swedish places, 2024–2027 (99.98 % of times on the printed
+ * minute, the rest a fraction of a second from the rounding point):
+ *  - The sun is taken once a day, at 0h UT less 45 s: Meeus's mean
+ *    elements and equation of the centre, the TRUE (geometric) longitude,
+ *    the apparent obliquity (mean plus nutation), the equation of time as
+ *    the mean longitude less the right ascension, 0.106 s later; and
+ *    two small waves by the mean longitude the formula leaves out: a few
+ *    hundredths of a second on the transit, a tenth of an arc-second on
+ *    the declination.
+ *  - Coordinates are kept to three decimals of a degree.
+ *  - Asr that never forms is printed at Dhuhr's time.
+ *  - The night a share is taken of is the day's own: 24 h less the
+ *    printed day, sunrise to Maghrib.
+ *  - The five-hour floors hold each end separately, 150 minutes from the
+ *    printed Dhuhr or from the midnight after it. Where midsummer's
+ *    night is floored at both ends (to within a minute), that night
+ *    anchors the season, and the floored times never step back: before
+ *    midsummer no sunrise earlier than midsummer's and a floored Maghrib
+ *    no earlier than the day before; after it no sunrise earlier nor
+ *    Maghrib later than on any day since midsummer — and Fajr and Isha
+ *    carried the same way.
+ *  - The gradual transition is a straight line across the days next to
+ *    the gap on which the true time lies within twenty minutes of the
+ *    takdir at the gap's edge: twenty minutes away at the far end, the
+ *    takdir at the edge.
+ *
+ * Beyond Sweden the same code gives Diyanet's tables worldwide, read off
+ * them for places on six continents:
+ *  - Where the dawn forms all summer but midsummer's true Isha (at 16°)
+ *    falls later than the share carried from that night, midsummer is the
+ *    takdir's day — a gap of one day, with its ramps (from about 44.4°
+ *    north: Austria, central France, northern Bosnia).
+ *  - Isha is printed at 16° in some countries and 17° in others; the
+ *    high-latitude rules are worked at 16° either way (`ishaDeg`).
+ *
+ * Times are minutes past 0h UT of the date, a frame the clock changes
+ * cannot bend; `congressTimes` turns them into instants.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DIYANET_ISHA_DEG = exports.CONGRESS_ISHA_DEG = void 0;
+exports.congressTimes = congressTimes;
+exports.congressYearInfo = congressYearInfo;
+const RAD = Math.PI / 180;
+const DAY_MS = 86_400_000;
+const RISE_SET = -0.833;
+const FAJR_ANGLE = -18;
+/**
+ * Isha's depression: the Congress's 16° (Diyanet's in much of Europe,
+ * Russia, Central Asia, China and North America), or Diyanet's own 17°
+ * (elsewhere). The high-latitude rules are the Congress's at 16° either way;
+ * the angle sets only the true Isha printed.
+ */
+exports.CONGRESS_ISHA_DEG = 16;
+exports.DIYANET_ISHA_DEG = 17;
+const TEMKIN = { sunrise: -7, dhuhr: 5, asr: 4, maghrib: 7 };
+/** Minutes: the day and the night are never shorter. */
+const FLOOR = 300;
+/** Minutes: the gradual transition's reach. */
+const BAND = 20;
+/** Minutes: a midsummer night this close to the five-hour floor counts as floored. */
+const ANCHOR_SLACK = 1;
+/** Days to look for a dawn or a transition before giving up. */
+const SEARCH_DAYS = 200;
+const dayKeyOf = (y, m, d) => Date.UTC(y, m, d) / DAY_MS;
+const yearOf = (k) => new Date(k * DAY_MS).getUTCFullYear();
+const midsummerOf = (k) => dayKeyOf(yearOf(k), 5, 21);
+/** Seconds before 0h UT at which Diyanet takes the day's sun. */
+const SUN_INSTANT_S = Number(process.env.SUNS ?? -45);
+/** Minutes Diyanet's equation of time runs ahead of the formula below. */
+const EOT_ADD_MIN = 0.00176;
+/**
+ * Seconds Diyanet's transit runs later than the formula below, by the sun's
+ * mean longitude: an annual wave of a few hundredths of a second, read off
+ * every Dhuhr of Diyanet's Swedish tables 2024–2027 (the largest margin that
+ * leaves none of them off; the two halves of the span give the same wave).
+ */
+function eotResidualS(L) {
+    return (0.033377 * Math.sin(L) + 0.007721 * Math.cos(L) -
+        0.000229 * Math.sin(2 * L) + 0.004198 * Math.cos(2 * L) -
+        0.02346 * Math.sin(3 * L) - 0.026434 * Math.cos(3 * L));
+}
+/**
+ * Degrees Diyanet's declination runs above the formula below: a wave of a
+ * tenth of an arc-second by the sun's mean longitude, read off the times of
+ * Diyanet's Swedish tables 2024–2027 that sit at a minute's edge (fitted on
+ * either two years, it holds on the other two).
+ */
+function decResidualDeg(L) {
+    return -1.1539e-5 - 3.6174e-5 * Math.sin(L) - 2.1101e-5 * Math.cos(L) + 2.0235e-5 * Math.sin(2 * L) - 2.2534e-5 * Math.cos(2 * L);
+}
+/**
+ * Declination (radians) and equation of time (minutes), as Diyanet's tables
+ * take them: Meeus's mean elements, the true longitude, the apparent obliquity.
+ */
+function sunAt(utcMs) {
+    const T = (utcMs / DAY_MS - 10957.5) / 36525; // Julian centuries since J2000.0
+    const L0 = (((280.46646 + T * (36000.76983 + 0.0003032 * T)) % 360) + 360) % 360;
+    const M = (357.52911 + T * (35999.05029 - 0.0001537 * T)) * RAD;
+    const C = (1.914602 - T * (0.004817 + 0.000014 * T)) * Math.sin(M) +
+        (0.019993 - 0.000101 * T) * Math.sin(2 * M) +
+        0.000289 * Math.sin(3 * M);
+    const om = (125.04 - 1934.136 * T) * RAD;
+    const Ls = (280.4665 + 36000.7698 * T) * RAD;
+    const Lm = (218.3165 + 481267.8813 * T) * RAD;
+    const eps = 23 +
+        (26 + (21.448 - T * (46.815 + T * (0.00059 - T * 0.001813))) / 60) / 60 +
+        (9.2 * Math.cos(om) + 0.57 * Math.cos(2 * Ls) + 0.1 * Math.cos(2 * Lm) - 0.09 * Math.cos(2 * om)) / 3600;
+    const lam = (L0 + C) * RAD;
+    const ra = ((((Math.atan2(Math.cos(eps * RAD) * Math.sin(lam), Math.cos(lam)) / RAD) % 360) + 360) % 360);
+    const dec = Math.asin(Math.sin(eps * RAD) * Math.sin(lam)) + decResidualDeg(L0 * RAD) * RAD;
+    const eot = (((((L0 - ra + 180) % 360) + 360) % 360) - 180) * 4 + EOT_ADD_MIN - eotResidualS(L0 * RAD) / 60;
+    return { dec, eot };
+}
+/** One day's sun: transit and the crossings, minutes past the day's 0h UT. */
+class Solar {
+    day;
+    lat;
+    lon;
+    dec;
+    transit;
+    constructor(day, lat, lon) {
+        this.day = day;
+        this.lat = lat;
+        this.lon = lon;
+        const { dec, eot } = sunAt(day * DAY_MS + SUN_INSTANT_S * 1000);
+        this.dec = dec;
+        this.transit = 720 - 4 * lon - eot;
+    }
+    hourAngle(alt) {
+        const c = (Math.sin(alt * RAD) - Math.sin(this.lat * RAD) * Math.sin(this.dec)) /
+            (Math.cos(this.lat * RAD) * Math.cos(this.dec));
+        if (c < -1 || c > 1)
+            return null;
+        return (Math.acos(c) / RAD) * 4;
+    }
+    rising(alt) {
+        const h = this.hourAngle(alt);
+        return h === null ? null : this.transit - h;
+    }
+    setting(alt) {
+        const h = this.hourAngle(alt);
+        return h === null ? null : this.transit + h;
+    }
+    /** Asr: the shadow of a thing is its noon shadow plus `shadow` lengths. */
+    asr(shadow) {
+        const noonAlt = 90 - Math.abs(this.lat - this.dec / RAD);
+        if (noonAlt <= 0)
+            return null;
+        const alt = Math.atan(1 / (shadow + Math.tan((90 - noonAlt) * RAD))) / RAD;
+        return this.setting(alt);
+    }
+}
+/** The method for one place and one year; everything it needs of the year is worked out once. */
+class CongressYear {
+    lat;
+    lon;
+    year;
+    solars = new Map();
+    riseSets = new Map();
+    ratioValue;
+    gap;
+    floors;
+    ramps = new Map();
+    extremes = new Map();
+    carriedCache = new Map();
+    ishaAngle;
+    constructor(lat, lon, year, ishaDeg = exports.CONGRESS_ISHA_DEG) {
+        this.lat = lat;
+        this.lon = lon;
+        this.year = year;
+        this.ishaAngle = -ishaDeg;
+    }
+    solar(day) {
+        let s = this.solars.get(day);
+        if (!s) {
+            s = new Solar(day, this.lat, this.lon);
+            this.solars.set(day, s);
+        }
+        return s;
+    }
+    /** Printed (temkin) sunrise and Maghrib with the five-hour floors. */
+    riseSet(day) {
+        const cached = this.riseSets.get(day);
+        if (cached)
+            return cached;
+        const s = this.solar(day);
+        const dhuhr = s.transit + TEMKIN.dhuhr;
+        const half = FLOOR / 2;
+        const rawSr = s.rising(RISE_SET);
+        const rawSs = s.setting(RISE_SET);
+        // the night no shorter than five hours, 2.5 h either side of the midnight after the printed
+        // Dhuhr — or, where midsummer's night is floored at both ends, of the season's anchoring
+        // Dhuhr (dhuhrExtremes): the floored times never step back
+        let nsr;
+        let nss;
+        if (this.midsummerFloors(day)) {
+            const [hi, lo] = this.dhuhrExtremes(day);
+            nsr = hi - 720 + half;
+            nss = lo + 720 - half;
+        }
+        else {
+            nsr = dhuhr - 720 + half;
+            nss = dhuhr + 720 - half;
+        }
+        let sr;
+        let ss;
+        if (rawSr === null || rawSs === null) {
+            // the sun neither rises nor sets: midnight sun (up at noon) or polar night
+            const noonUp = 90 - Math.abs(this.lat - s.dec / RAD) > RISE_SET;
+            [sr, ss] = noonUp ? [nsr, nss] : [dhuhr - half, dhuhr + half];
+        }
+        else {
+            sr = rawSr + TEMKIN.sunrise;
+            ss = rawSs + TEMKIN.maghrib;
+        }
+        // the day no shorter than five hours about the printed Dhuhr, each end on its own; then the night
+        sr = Math.max(Math.min(sr, dhuhr - half), nsr);
+        ss = Math.min(Math.max(ss, dhuhr + half), nss);
+        // where midsummer anchors the season, Maghrib is held at the latest since midsummer until it
+        // falls of itself (Torsby, whose midsummer night is just over five hours: its sunset still
+        // gets later for a few days after the solstice, and the table holds midsummer's Maghrib)
+        let held;
+        if (this.midsummerFloors(day)) {
+            const mid = midsummerOf(day);
+            if (day === mid)
+                held = true;
+            else if (day > mid) {
+                const prev = this.riseSet(day - 1);
+                if (prev.held && ss > prev.ss) {
+                    ss = prev.ss;
+                    held = true;
+                }
+            }
+        }
+        const rs = { sr, ss, held };
+        this.riseSets.set(day, rs);
+        return rs;
+    }
+    dhuhrOf(day) {
+        return this.solar(day).transit + TEMKIN.dhuhr;
+    }
+    /** Does the day's Maghrib fall on the night's floor (or the sun not set at all)? */
+    maghribFloored(day) {
+        const s = this.solar(day);
+        const st = s.setting(RISE_SET);
+        return st === null || st + TEMKIN.maghrib > s.transit + TEMKIN.dhuhr + 720 - FLOOR / 2;
+    }
+    /**
+     * The Dhuhrs the anchored night floors go by: [latest, earliest]. Before
+     * midsummer, sunrise is held against midsummer's Dhuhr and a floored
+     * Maghrib against the latest Dhuhr since its floor began; after it, every
+     * Dhuhr from midsummer on — so the floored times never step back.
+     */
+    dhuhrExtremes(day) {
+        const cached = this.extremes.get(day);
+        if (cached)
+            return cached;
+        const mid = midsummerOf(day);
+        let out;
+        if (day <= mid) {
+            let maxRun = this.dhuhrOf(day);
+            if (this.maghribFloored(day)) {
+                for (let d = day - 1; d > day - 120 && this.maghribFloored(d); d -= 1)
+                    maxRun = Math.max(maxRun, this.dhuhrOf(d));
+            }
+            out = [Math.max(this.dhuhrOf(day), this.dhuhrOf(mid)), Math.min(maxRun, this.dhuhrOf(mid))];
+        }
+        else {
+            let hi = -Infinity;
+            let lo = Infinity;
+            for (let d = mid; d <= day; d += 1) {
+                const v = this.dhuhrOf(d);
+                hi = Math.max(hi, v);
+                lo = Math.min(lo, v);
+            }
+            out = [hi, lo];
+        }
+        this.extremes.set(day, out);
+        return out;
+    }
+    /**
+     * Is midsummer's night floored at both ends — the day's own floors
+     * leaving it five hours, or within a minute of five (Torsby's 300.5 is
+     * anchored, Fagersta's 302 is not)? Then that night anchors the season.
+     */
+    midsummerFloors(day) {
+        if (this.floors === undefined) {
+            const s = this.solar(midsummerOf(day));
+            const sr = s.rising(RISE_SET);
+            const ss = s.setting(RISE_SET);
+            const dhuhr = s.transit + TEMKIN.dhuhr;
+            const half = FLOOR / 2;
+            if (sr === null || ss === null)
+                this.floors = true;
+            else {
+                const psr = Math.max(sr + TEMKIN.sunrise, dhuhr - 720 + half);
+                const pss = Math.min(ss + TEMKIN.maghrib, dhuhr + 720 - half);
+                this.floors = 1440 - (pss - psr) <= FLOOR + ANCHOR_SLACK;
+            }
+        }
+        return this.floors;
+    }
+    /** The day's night: 24 h less the printed day. */
+    night(day) {
+        const { sr, ss } = this.riseSet(day);
+        return 1440 - (ss - sr);
+    }
+    fajr18(day) {
+        return this.solar(day).rising(FAJR_ANGLE);
+    }
+    isha16(day) {
+        return this.solar(day).setting(this.ishaAngle);
+    }
+    trueTime(key, day) {
+        return key === 'fajr' ? this.fajr18(day) : this.isha16(day);
+    }
+    /** First and last day on which the 18° dawn does not form, or null when it forms all year. */
+    gapDays() {
+        if (this.gap !== undefined)
+            return this.gap;
+        const mid = dayKeyOf(this.year, 5, 21);
+        if (this.fajr18(mid) !== null) {
+            // The dawn forms all summer, but where midsummer's true Isha falls
+            // later than the share carried from that night would put it, Diyanet
+            // takes midsummer as the takdir's day and ramps to it as at a gap's
+            // edge (Austria, central France, northern Bosnia — from about 44.4°).
+            // The rule is the northern summer's; south of the equator the true
+            // times stand.
+            // (at the Congress's 16°, whatever Isha's printed angle)
+            const isha = this.solar(mid).setting(-exports.CONGRESS_ISHA_DEG);
+            this.gap = this.lat > 0 && isha !== null && this.carriedRaw(mid)[1] < isha ? [mid, mid] : null;
+            return this.gap;
+        }
+        let a = mid;
+        while (this.fajr18(a - 1) === null && mid - a < SEARCH_DAYS)
+            a -= 1;
+        let b = mid;
+        while (this.fajr18(b + 1) === null && b - mid < SEARCH_DAYS)
+            b += 1;
+        this.gap = [a, b];
+        return this.gap;
+    }
+    /**
+     * The carried ratio: a third of the sharia night (this day's Maghrib to
+     * the next dawn — the last one, a day on) over the day's night, on the
+     * last day before midsummer on which the 18° dawn forms.
+     */
+    ratio() {
+        if (this.ratioValue !== undefined)
+            return this.ratioValue;
+        let d = dayKeyOf(this.year, 5, 21);
+        let f = this.fajr18(d);
+        let steps = 0;
+        while (f === null && steps < SEARCH_DAYS) {
+            d -= 1;
+            f = this.fajr18(d);
+            steps += 1;
+        }
+        if (f === null) {
+            this.ratioValue = null;
+            return null;
+        }
+        const { ss } = this.riseSet(d);
+        const S = f + 1440 - ss;
+        this.ratioValue = S / 3 / this.night(d);
+        return this.ratioValue;
+    }
+    /** Fajr and Isha from the carried ratio, with midsummer's as the bound where its floors are in force. */
+    /** Fajr and Isha from the carried share, before any season rule. */
+    carriedRaw(day) {
+        const r = this.ratio() ?? 0;
+        const { sr, ss } = this.riseSet(day);
+        const n = this.night(day);
+        return [sr - r * (FAJR_ANGLE / -exports.CONGRESS_ISHA_DEG) * n, ss + r * n];
+    }
+    /**
+     * Fajr and Isha from the carried share. Where midsummer's night anchors
+     * the season: before midsummer never an earlier Fajr nor a later Isha than
+     * midsummer's; after it, than on any day since — as the floored sunrise.
+     */
+    carried(day) {
+        const cached = this.carriedCache.get(day);
+        if (cached)
+            return cached;
+        const mid = midsummerOf(day);
+        let out;
+        if (!this.midsummerFloors(day) || day === mid)
+            out = this.carriedRaw(day);
+        else if (day < mid) {
+            const [f, i] = this.carriedRaw(day);
+            const [mf, mi] = this.carried(mid);
+            out = [Math.max(f, mf), Math.min(i, mi)];
+        }
+        else {
+            // walk forward from midsummer so the running bound needs no deep recursion
+            let prev = this.carried(mid);
+            for (let d = mid + 1; d < day; d += 1) {
+                let c = this.carriedCache.get(d);
+                if (!c) {
+                    const [f, i] = this.carriedRaw(d);
+                    c = [Math.max(f, prev[0]), Math.min(i, prev[1])];
+                    this.carriedCache.set(d, c);
+                }
+                prev = c;
+            }
+            const [f, i] = this.carriedRaw(day);
+            out = [Math.max(f, prev[0]), Math.min(i, prev[1])];
+        }
+        this.carriedCache.set(day, out);
+        return out;
+    }
+    /** The gradual transition between the true time and the takdir. */
+    ramp(day, side, key) {
+        const gap = this.gapDays();
+        if (!gap)
+            return this.trueTime(key, day);
+        const [d1, d2] = gap;
+        const idx = key === 'fajr' ? 0 : 1;
+        const cacheKey = side + key;
+        let ramp = this.ramps.get(cacheKey);
+        if (!ramp) {
+            const edge = side === 'in' ? d1 : d2;
+            const T = this.carried(edge)[idx];
+            const step = side === 'in' ? -1 : 1;
+            let far = null;
+            // walking away from the gap the true time starts far beyond T, enters the
+            // band and leaves it again; the far end is the last day of that run
+            for (let d = edge + step; Math.abs(d - edge) < SEARCH_DAYS; d += step) {
+                const t = this.trueTime(key, d);
+                if (t !== null && Math.abs(t - T) <= BAND)
+                    far = d;
+                else if (far !== null)
+                    break;
+            }
+            ramp = { edge, T, far };
+            this.ramps.set(cacheKey, ramp);
+        }
+        const { edge, T, far } = ramp;
+        if (far === null)
+            return this.trueTime(key, day);
+        const inside = side === 'in' ? far <= day && day < edge : edge < day && day <= far;
+        if (!inside)
+            return this.trueTime(key, day);
+        const sign = key === 'fajr' ? 1 : -1; // Fajr sits later than the takdir, Isha earlier
+        return T + (sign * BAND * Math.abs(day - edge)) / Math.abs(far - edge);
+    }
+    /** The day's six times, minutes past its 0h UT. */
+    times(day, asrShadow) {
+        const s = this.solar(day);
+        const { sr, ss } = this.riseSet(day);
+        const dhuhr = s.transit + TEMKIN.dhuhr;
+        const rawAsr = s.asr(asrShadow);
+        // an Asr that never forms is printed at Dhuhr's time (the published rule)
+        let asr = rawAsr === null ? dhuhr : rawAsr + TEMKIN.asr;
+        asr = Math.max(dhuhr, Math.min(asr, ss));
+        let fajr = this.fajr18(day);
+        let isha = this.isha16(day);
+        const gap = this.gapDays();
+        if (gap) {
+            const [d1, d2] = gap;
+            if (d1 <= day && day <= d2)
+                [fajr, isha] = this.carried(day);
+            else if (day < d1) {
+                fajr = this.ramp(day, 'in', 'fajr');
+                isha = this.ramp(day, 'in', 'isha');
+            }
+            else {
+                fajr = this.ramp(day, 'out', 'fajr');
+                isha = this.ramp(day, 'out', 'isha');
+            }
+        }
+        return {
+            fajr: fajr ?? sr - 60,
+            sunrise: sr,
+            dhuhr,
+            asr,
+            maghrib: ss,
+            isha: isha ?? ss + 60,
+        };
+    }
+}
+const years = new Map();
+const MAX_CACHED_YEARS = 12;
+function yearFor(lat, lon, year, ishaDeg = exports.CONGRESS_ISHA_DEG) {
+    const key = `${lat.toFixed(5)},${lon.toFixed(5)},${year},${ishaDeg}`;
+    let cy = years.get(key);
+    if (!cy) {
+        if (years.size >= MAX_CACHED_YEARS)
+            years.delete(years.keys().next().value);
+        cy = new CongressYear(lat, lon, year, ishaDeg);
+        years.set(key, cy);
+    }
+    return cy;
+}
+/**
+ * The Congress method's times for a calendar date (year, month 0–11, day),
+ * as instants, unrounded. `asrShadow` is 1 for the standard Asr, 2 for the
+ * Hanafi one; the tables print the standard. `ishaDeg` is Isha's depression:
+ * 16° (the Congress's, Diyanet's in Europe and North America) or 17°
+ * (Diyanet's everywhere else).
+ */
+function congressTimes(latitude, longitude, year, month, day, asrShadow = 1, ishaDeg = exports.CONGRESS_ISHA_DEG) {
+    const key = dayKeyOf(year, month, day);
+    const t = yearFor(latitude, longitude, year, ishaDeg).times(key, asrShadow);
+    const start = key * DAY_MS;
+    const at = (m) => new Date(start + m * 60_000);
+    return { fajr: at(t.fajr), sunrise: at(t.sunrise), dhuhr: at(t.dhuhr), asr: at(t.asr), maghrib: at(t.maghrib), isha: at(t.isha) };
+}
+/** For tests and the verification tool: the year's structure as the method sees it. */
+function congressYearInfo(latitude, longitude, year) {
+    const cy = yearFor(latitude, longitude, year);
+    const iso = (k) => new Date(k * DAY_MS).toISOString().slice(0, 10);
+    const gap = cy.gapDays();
+    return {
+        gap: gap ? [iso(gap[0]), iso(gap[1])] : null,
+        ratio: cy.ratio(),
+        midsummerFloors: cy.midsummerFloors(dayKeyOf(year, 5, 21)),
+    };
+}

package/dist/cjs/methods/sweden.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The International Prayer Times Congress method (Istanbul, 2021 — the
+ * Diyanet and the European Council for Fatwa and Research) as Diyanet's
+ * tables realise it. Islamiska Förbundet's Swedish tables are those
+ * tables, row for row, so this is Sweden's method (id 24).
+ *
+ * The published rules (awqatsalah.com, "Tespit Kriterleri"):
+ *  - Dhuhr five minutes after transit; Asr one shadow (Dhuhr when the
+ *    shadow never forms), four minutes late; sunrise seven early,
+ *    Maghrib seven late ("temkin").
+ *  - Neither the day nor the night is shorter than five hours.
+ *  - True Fajr at 18°, true Isha at 16°. Where the 18° dawn no longer
+ *    forms, the share of the night the sharia night's third took on the
+ *    last day it did is carried: Isha that share of the night after
+ *    Maghrib, Fajr the same share scaled by 18/16 before sunrise.
+ *  - The move from true times to the carried ones is gradual, starting
+ *    twenty minutes before (Isha) or after (Fajr) the takdir.
+ *
+ * What the tables turn out to do with them, read off Diyanet's own tables
+ * for all 160 Swedish places, 2024–2027 (99.98 % of times on the printed
+ * minute, the rest a fraction of a second from the rounding point):
+ *  - The sun is taken once a day, at 0h UT less 45 s: Meeus's mean
+ *    elements and equation of the centre, the TRUE (geometric) longitude,
+ *    the apparent obliquity (mean plus nutation), the equation of time as
+ *    the mean longitude less the right ascension, 0.106 s later; and
+ *    two small waves by the mean longitude the formula leaves out: a few
+ *    hundredths of a second on the transit, a tenth of an arc-second on
+ *    the declination.
+ *  - Coordinates are kept to three decimals of a degree.
+ *  - Asr that never forms is printed at Dhuhr's time.
+ *  - The night a share is taken of is the day's own: 24 h less the
+ *    printed day, sunrise to Maghrib.
+ *  - The five-hour floors hold each end separately, 150 minutes from the
+ *    printed Dhuhr or from the midnight after it. Where midsummer's
+ *    night is floored at both ends (to within a minute), that night
+ *    anchors the season, and the floored times never step back: before
+ *    midsummer no sunrise earlier than midsummer's and a floored Maghrib
+ *    no earlier than the day before; after it no sunrise earlier nor
+ *    Maghrib later than on any day since midsummer — and Fajr and Isha
+ *    carried the same way.
+ *  - The gradual transition is a straight line across the days next to
+ *    the gap on which the true time lies within twenty minutes of the
+ *    takdir at the gap's edge: twenty minutes away at the far end, the
+ *    takdir at the edge.
+ *
+ * Beyond Sweden the same code gives Diyanet's tables worldwide, read off
+ * them for places on six continents:
+ *  - Where the dawn forms all summer but midsummer's true Isha (at 16°)
+ *    falls later than the share carried from that night, midsummer is the
+ *    takdir's day — a gap of one day, with its ramps (from about 44.4°
+ *    north: Austria, central France, northern Bosnia).
+ *  - Isha is printed at 16° in some countries and 17° in others; the
+ *    high-latitude rules are worked at 16° either way (`ishaDeg`).
+ *
+ * Times are minutes past 0h UT of the date, a frame the clock changes
+ * cannot bend; `congressTimes` turns them into instants.
+ */
+/**
+ * Isha's depression: the Congress's 16° (Diyanet's in much of Europe,
+ * Russia, Central Asia, China and North America), or Diyanet's own 17°
+ * (elsewhere). The high-latitude rules are the Congress's at 16° either way;
+ * the angle sets only the true Isha printed.
+ */
+export declare const CONGRESS_ISHA_DEG = 16;
+export declare const DIYANET_ISHA_DEG = 17;
+export type CongressInstants = {
+    fajr: Date;
+    sunrise: Date;
+    dhuhr: Date;
+    asr: Date;
+    maghrib: Date;
+    isha: Date;
+};
+/**
+ * The Congress method's times for a calendar date (year, month 0–11, day),
+ * as instants, unrounded. `asrShadow` is 1 for the standard Asr, 2 for the
+ * Hanafi one; the tables print the standard. `ishaDeg` is Isha's depression:
+ * 16° (the Congress's, Diyanet's in Europe and North America) or 17°
+ * (Diyanet's everywhere else). `clockOffset` is the table's clock, minutes
+ * east of UTC (its standard time), where known — see CongressYear.
+ */
+export declare function congressTimes(latitude: number, longitude: number, year: number, month: number, day: number, asrShadow?: number, ishaDeg?: number, clockOffset?: number): CongressInstants;
+/** For tests and the verification tool: the year's structure as the method sees it. */
+export declare function congressYearInfo(latitude: number, longitude: number, year: number): {
+    gap: [string, string] | null;
+    ratio: number | null;
+    midsummerFloors: boolean;
+};