mihrab-methods 1.2.1 → 1.3.1

package/README.md

@@ -9,7 +9,7 @@
 **Prayer times that match the published timetable to the printed minute.**
 Each national authority's own calculation method, worked out again from its
 published times and checked day by day against its timetables: <!--fig:total.off-->0<!--/fig--> of
-<!--fig:total.times-->73,645,454<!--/fig--> times off the printed minute. Free for any app, site or
+<!--fig:total.times-->73,824,302<!--/fig--> times off the printed minute. Free for any app, site or
 mosque to use.
 
 [![Usage, a day: npm downloads and API requests](docs/stats.svg)](#usage)
@@ -43,8 +43,9 @@ The full API, the HTTP server and the per-authority imports are in
 | **Morocco** | Habous | 164 | 94,350 | **0** | 99.879 % | 114 | 27 Aug 2026 → 30 Nov 2026 |
 | **Algeria** | Ministry of Religious Affairs | 68 | 101,184 | **0** | 99.365 % | 642 | 1 Oct 2026 → 5 Jun 2027 |
 | **Indonesia** | Kemenag | 517 | 362,934 | **0** | 99.935 % | 234 | 7 Oct 2026 → 31 Jan 2027 |
+| **Türkiye Takvimi** | its cities’ years | 81 | 178,848 | **0** | 99.970 % | 52 | 31 Dec 2025 → 2 Jan 2027 |
 
-5 of 5 methods certified; 0 of 73,645,454 times off the printed minute. Last checked 9 November 2026. Generated from [`certification.json`](certification.json) by `scripts/readme.mjs`.
+6 of 6 methods certified; 0 of 73,824,302 times off the printed minute. Last checked 9 November 2026. Generated from [`certification.json`](certification.json) by `scripts/readme.mjs`.
 <!-- certification-table:end -->
 
 "By the method alone" is the formula without its correction list. The list

package/certification.json

@@ -127,5 +127,28 @@
       "sha256": "a3f1c30576ddddbfda6cadabe442e1bcf3fb476b018b269d7d4783edd4e39d03"
     },
     "revision": 2
+  },
+  "turkiyetakvimi": {
+    "certified": true,
+    "checkedAt": "2026-11-11",
+    "places": 81,
+    "checks": [
+      {
+        "tables": "Türkiye Takvimi — its cities’ years",
+        "places": 81,
+        "times": 178848,
+        "off": 0,
+        "offWithoutCorrections": 52,
+        "from": "2025-12-31",
+        "to": "2027-01-02"
+      }
+    ],
+    "corrections": {
+      "from": "2025-12-31",
+      "to": "2027-01-02",
+      "entries": 52,
+      "sha256": "a3059fd5aae0b0f8ddee10a2aaaf93e982ded12e652f6aa21d0a3d347a082b41"
+    },
+    "revision": 1
   }
 }

package/data/corrections/turkiyetakvimi.json

@@ -0,0 +1,120 @@
+{
+ "from": "2025-12-31",
+ "to": "2027-01-02",
+ "points": {
+  "36.999,35.316": [
+   "2026-01-07 fajr -1"
+  ],
+  "37.184,33.216": [
+   "2026-01-20 fajr -1",
+   "2026-01-27 fajr -1"
+  ],
+  "37.217,28.366": [
+   "2026-11-18 sunrise +1"
+  ],
+  "37.767,30.550": [
+   "2026-05-26 isha -1"
+  ],
+  "37.850,27.850": [
+   "2026-03-06 dhuhr -1"
+  ],
+  "37.866,32.483": [
+   "2026-06-08 maghrib +1"
+  ],
+  "37.917,40.233": [
+   "2026-11-16 dhuhr +1"
+  ],
+  "38.367,34.033": [
+   "2026-04-16 isha -1"
+  ],
+  "38.383,42.099": [
+   "2026-03-26 maghrib -1"
+  ],
+  "38.633,34.717": [
+   "2026-05-31 asr +1",
+   "2026-07-02 asr +1"
+  ],
+  "38.733,35.483": [
+   "2026-05-04 isha +1"
+  ],
+  "38.883,40.483": [
+   "2026-03-25 sunrise -1"
+  ],
+  "39.716,43.050": [
+   "2026-02-01 isha -1",
+   "2026-02-20 fajr -1",
+   "2026-03-04 maghrib -1"
+  ],
+  "39.750,39.500": [
+   "2026-01-17 isha -1",
+   "2026-02-22 dhuhr -1"
+  ],
+  "39.933,32.849": [
+   "2026-02-22 isha -1"
+  ],
+  "40.316,36.550": [
+   "2026-02-01 dhuhr -1"
+  ],
+  "40.599,43.083": [
+   "2026-05-06 dhuhr +1"
+  ],
+  "40.650,29.266": [
+   "2026-01-26 asr -1"
+  ],
+  "40.650,35.833": [
+   "2026-10-03 fajr +1"
+  ],
+  "40.733,31.616": [
+   "2026-03-24 maghrib +1",
+   "2026-09-08 dhuhr +1"
+  ],
+  "40.767,29.950": [
+   "2026-03-05 maghrib -1",
+   "2026-04-14 sunrise -1"
+  ],
+  "40.850,31.150": [
+   "2026-07-19 sunrise -1"
+  ],
+  "40.983,27.516": [
+   "2026-07-03 dhuhr +1",
+   "2026-11-26 dhuhr +1",
+   "2026-12-23 asr +1"
+  ],
+  "41.000,29.000": [
+   "2026-03-31 sunrise -1",
+   "2026-12-15 maghrib -1",
+   "2026-12-16 maghrib -1",
+   "2026-12-17 maghrib -1",
+   "2026-12-17 sunrise -1",
+   "2026-12-18 maghrib -1",
+   "2026-12-21 maghrib -1",
+   "2026-12-24 sunrise -1",
+   "2026-12-27 sunrise -1",
+   "2026-12-31 sunrise -1"
+  ],
+  "41.033,40.517": [
+   "2026-04-19 maghrib +1"
+  ],
+  "41.200,32.632": [
+   "2026-02-20 dhuhr -1",
+   "2026-03-21 fajr -1"
+  ],
+  "41.367,33.783": [
+   "2026-04-05 asr -1"
+  ],
+  "41.450,31.800": [
+   "2026-05-22 sunrise -1",
+   "2026-08-09 asr +1"
+  ],
+  "41.666,26.567": [
+   "2026-04-23 isha +1"
+  ],
+  "41.733,27.217": [
+   "2026-06-28 fajr +1",
+   "2026-09-19 isha -1"
+  ],
+  "42.033,35.150": [
+   "2026-10-11 maghrib +1"
+  ]
+ }
+}

package/dist/cjs/authorities/turkiyeTakvimi.d.ts

@@ -0,0 +1,3 @@
+import type { Place } from '../core/types.js';
+export declare const turkiyeTakvimi: import("../core/registry.js").AuthorityData;
+export declare const places: readonly Place[];

package/dist/cjs/authorities/turkiyeTakvimi.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.places = exports.turkiyeTakvimi = void 0;
+/**
+ * Türkiye Takvimi — the calendar's cities, each at the point and with the
+ * temkin its published year is computed with. The first list is Türkiye's
+ * 81 province centres.
+ */
+const turkiyeTakvimiCities_js_1 = __importDefault(require("../data/generated/turkiyeTakvimiCities.js"));
+const turkiyetakvimiCorrections_js_1 = __importDefault(require("../data/generated/turkiyetakvimiCorrections.js"));
+const turkiyetakvimiCertification_js_1 = __importDefault(require("../data/generated/turkiyetakvimiCertification.js"));
+const revisions_js_1 = require("../methods/revisions.js");
+const registry_js_1 = require("../core/registry.js");
+const AUTHORITY = 'turkiyetakvimi';
+function buildPlaces() {
+    return turkiyeTakvimiCities_js_1.default.map(c => {
+        const key = String(c.id);
+        return {
+            authority: AUTHORITY,
+            id: `${AUTHORITY}:${key}`,
+            key,
+            name: c.name,
+            country: 'TR',
+            lat: c.lat,
+            lon: c.lon,
+            tz: 'Europe/Istanbul',
+            temkin: c.temkin,
+        };
+    });
+}
+exports.turkiyeTakvimi = (0, registry_js_1.registerAuthority)({
+    authority: AUTHORITY,
+    revision: revisions_js_1.METHOD_REVISION.turkiyetakvimi,
+    places: buildPlaces(),
+    corrections: turkiyetakvimiCorrections_js_1.default,
+    certification: turkiyetakvimiCertification_js_1.default,
+    description: {
+        name: 'Türkiye Takvimi',
+        method: 'The precise apparent sun at each event’s own moment, and a temkin T per city (the time the sun takes on the summer solstice from the level horizon to the city’s own). Fajr is the calendar’s Sabâh, the sun 18° below the horizon with no temkin; sunrise the sun’s centre on the level horizon less T and two minutes; Dhuhr the transit plus T; Asr (the noon shadow taken at the declination of local noon) and Isha (17°) plus T; Maghrib the level horizon plus T and two minutes; every time rounded up to the minute.',
+        countries: ['TR'],
+        parameters: {
+            fajrAngle: 18,
+            ishaAngle: 17,
+            sunriseAltitude: 0,
+            asrShadow: 1,
+            asrNoonShadow: 'tan|φ − δ| at the declination of local noon',
+            temkin: 'per city, minutes: on Dhuhr, Asr, Maghrib and Isha, and before sunrise',
+            horizonMarginMinutes: 2,
+            rounding: 'up to the minute',
+            sun: 'precise apparent sun (VSOP87, IAU 2006 precession, IAU 2000B nutation), iterated at each event',
+        },
+        sources: [{ title: 'Türkiye Takvimi — namaz vakitleri', url: 'https://www.namazvakti.com/' }],
+        spec: 'docs/methods.md#türkiye-takvimi',
+    },
+});
+exports.places = exports.turkiyeTakvimi.places;

package/dist/cjs/core/compute.js

@@ -11,6 +11,7 @@ const sweden_js_1 = require("../methods/sweden.js");
 const morocco_js_1 = require("../methods/morocco.js");
 const algeria_js_1 = require("../methods/algeria.js");
 const indonesia_js_1 = require("../methods/indonesia.js");
+const turkiyeTakvimi_js_1 = require("../methods/turkiyeTakvimi.js");
 const registry_js_1 = require("./registry.js");
 const clock_js_1 = require("./clock.js");
 /**
@@ -33,12 +34,15 @@ function candidateInstants(place, year, month, day, asrShadow = 1, opts = {}) {
         }
         case 'morocco':
         case 'algeria':
-        case 'indonesia': {
+        case 'indonesia':
+        case 'turkiyetakvimi': {
             const t = place.authority === 'morocco'
                 ? (0, morocco_js_1.moroccoTimes)(place.lat, place.lon, year, month, day, place.dipDeg, asrShadow, place.dipMaghribDeg)
                 : place.authority === 'algeria'
                     ? (0, algeria_js_1.algeriaTimes)(place.lat, place.lon, year, month, day, asrShadow)
-                    : (0, indonesia_js_1.kemenagTimes)(place.lat, place.lon, year, month, day, { highland: place.highland, twilightDip: place.twilightDip, asrShadow, afternoon: place.afternoon });
+                    : place.authority === 'turkiyetakvimi'
+                        ? (0, turkiyeTakvimi_js_1.takvimTimes)(place.lat, place.lon, year, month, day, place.temkin, asrShadow)
+                        : (0, indonesia_js_1.kemenagTimes)(place.lat, place.lon, year, month, day, { highland: place.highland, twilightDip: place.twilightDip, asrShadow, afternoon: place.afternoon });
             // the correction list: the authority's few times on the other side of a minute (the standard Asr only)
             const c = !t || !fix ? undefined : fix.correction(place.lat, place.lon, year, month, day);
             if (!t || !c)

package/dist/cjs/core/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * The shapes the library speaks in. Nothing here computes anything.
  */
-export type Authority = 'sweden' | 'diyanet' | 'morocco' | 'algeria' | 'indonesia';
+export type Authority = 'sweden' | 'diyanet' | 'morocco' | 'algeria' | 'indonesia' | 'turkiyetakvimi';
 export declare const AUTHORITIES: readonly Authority[];
 export type PrayerKey = 'fajr' | 'sunrise' | 'dhuhr' | 'asr' | 'maghrib' | 'isha';
 export declare const PRAYER_KEYS: readonly PrayerKey[];
@@ -34,6 +34,8 @@ export type Place = {
     twilightDip?: boolean;
     /** Indonesia: where the ministry computes the regency's Asr, Maghrib and Isha, when not at its point. */
     afternoon?: readonly [number, number];
+    /** Türkiye Takvimi: the city's temkin as its table shows it, minutes with their fraction. */
+    temkin?: number;
     /** Diyanet: Isha's depression, 16° or 17° by country. */
     ishaDeg?: number;
     /**

package/dist/cjs/core/types.js

@@ -4,7 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UncertifiedMethodError = exports.PRAYER_KEYS = exports.AUTHORITIES = void 0;
-exports.AUTHORITIES = ['sweden', 'diyanet', 'morocco', 'algeria', 'indonesia'];
+exports.AUTHORITIES = ['sweden', 'diyanet', 'morocco', 'algeria', 'indonesia', 'turkiyetakvimi'];
 exports.PRAYER_KEYS = ['fajr', 'sunrise', 'dhuhr', 'asr', 'maghrib', 'isha'];
 /** The method has not reproduced its authority's tables to the minute (or not for this date). */
 class UncertifiedMethodError extends Error {