mihrab-methods 1.2.1 → 1.3.0

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 {

package/dist/cjs/data/generated/turkiyeTakvimiCities.d.ts

@@ -0,0 +1,8 @@
+declare const data: {
+    id: number;
+    name: string;
+    lat: number;
+    lon: number;
+    temkin: number;
+}[];
+export default data;

package/dist/cjs/data/generated/turkiyeTakvimiCities.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Generated by scripts/embed.mjs — do not edit; edit the JSON under data/ instead.
+const data = [{ "id": 16702, "name": "Adana", "lat": 36.9995, "lon": 35.316075, "temkin": 10.0151 }, { "id": 16703, "name": "Adapazarı", "lat": 40.7833, "lon": 30.399875, "temkin": 10.7698 }, { "id": 16704, "name": "Adıyaman", "lat": 37.7667, "lon": 38.2828, "temkin": 10.1563 }, { "id": 16705, "name": "Afyonkarahisar", "lat": 38.750167, "lon": 30.549625, "temkin": 10.3374 }, { "id": 16706, "name": "Ağrı", "lat": 39.7162, "lon": 43.0495, "temkin": 10.5387 }, { "id": 16707, "name": "Aksaray", "lat": 38.3667, "lon": 34.0328, "temkin": 10.2665 }, { "id": 16708, "name": "Amasya", "lat": 40.65, "lon": 35.8333, "temkin": 10.7413 }, { "id": 16709, "name": "Ankara", "lat": 39.9333, "lon": 32.849063, "temkin": 10.5818 }, { "id": 16710, "name": "Antakya", "lat": 36.1833, "lon": 36.166263, "temkin": 9.8655 }, { "id": 16711, "name": "Antalya", "lat": 36.8838, "lon": 30.6995, "temkin": 9.9937 }, { "id": 16712, "name": "Ardahan", "lat": 41.1167, "lon": 42.7, "temkin": 10.8344 }, { "id": 16713, "name": "Artvin", "lat": 41.1833, "lon": 41.816575, "temkin": 10.8446 }, { "id": 16714, "name": "Aydın", "lat": 37.849833, "lon": 27.849625, "temkin": 10.1726 }, { "id": 16715, "name": "Balıkesir", "lat": 39.65, "lon": 27.882362, "temkin": 10.5209 }, { "id": 16716, "name": "Bartın", "lat": 41.633133, "lon": 32.333175, "temkin": 10.9118 }, { "id": 16717, "name": "Batman", "lat": 37.8662, "lon": 41.116325, "temkin": 10.1742 }, { "id": 16718, "name": "Bayburt", "lat": 40.2505, "lon": 40.232175, "temkin": 10.6513 }, { "id": 16719, "name": "Bilecik", "lat": 40.149833, "lon": 29.9828, "temkin": 10.6312 }, { "id": 16720, "name": "Bingöl", "lat": 38.883133, "lon": 40.48305, "temkin": 10.3613 }, { "id": 16721, "name": "Bitlis", "lat": 38.3828, "lon": 42.099375, "temkin": 10.2697 }, { "id": 16722, "name": "Bolu", "lat": 40.733133, "lon": 31.61645, "temkin": 10.7573 }, { "id": 16723, "name": "Burdur", "lat": 37.7162, "lon": 30.283425, "temkin": 10.149 }, { "id": 16724, "name": "Bursa", "lat": 40.200333, "lon": 29.066325, "temkin": 10.6428 }, { "id": 16725, "name": "Çanakkale", "lat": 40.15, "lon": 26.416012, "temkin": 10.6307 }, { "id": 16726, "name": "Çankırı", "lat": 40.6, "lon": 33.6167, "temkin": 10.7299 }, { "id": 16727, "name": "Çorum", "lat": 40.55, "lon": 34.949625, "temkin": 10.7186 }, { "id": 16728, "name": "Denizli", "lat": 37.7833, "lon": 29.083175, "temkin": 10.1605 }, { "id": 16729, "name": "Diyarbakır", "lat": 37.9167, "lon": 40.232675, "temkin": 10.1822 }, { "id": 16730, "name": "Edirne", "lat": 41.666367, "lon": 26.566575, "temkin": 10.9169 }, { "id": 16731, "name": "Elazığ", "lat": 38.683467, "lon": 39.23305, "temkin": 10.3245 }, { "id": 16732, "name": "Erzincan", "lat": 39.75, "lon": 39.499875, "temkin": 10.5473 }, { "id": 16733, "name": "Erzurum", "lat": 39.916533, "lon": 41.266325, "temkin": 10.5817 }, { "id": 16734, "name": "Eskişehir", "lat": 39.782133, "lon": 30.51595, "temkin": 10.553 }, { "id": 16735, "name": "Gaziantep", "lat": 37.066367, "lon": 37.38305, "temkin": 10.0276 }, { "id": 16736, "name": "Giresun", "lat": 40.916367, "lon": 38.399875, "temkin": 10.7996 }, { "id": 16737, "name": "Gümüşhane", "lat": 40.449, "lon": 39.482925, "temkin": 10.696 }, { "id": 16738, "name": "Hakkâri", "lat": 37.5833, "lon": 43.733238, "temkin": 10.1245 }, { "id": 16739, "name": "Iğdır", "lat": 39.916533, "lon": 44.032987, "temkin": 10.5817 }, { "id": 16740, "name": "Isparta", "lat": 37.767033, "lon": 30.549625, "temkin": 10.1573 }, { "id": 16741, "name": "İstanbul", "lat": 41.000167, "lon": 28.999625, "temkin": 10.815 }, { "id": 16742, "name": "İzmir", "lat": 38.416367, "lon": 27.132987, "temkin": 10.2768 }, { "id": 16743, "name": "Kahramanmaraş", "lat": 37.5833, "lon": 36.932925, "temkin": 10.1225 }, { "id": 16744, "name": "Karabük", "lat": 41.199833, "lon": 32.632425, "temkin": 10.8451 }, { "id": 16745, "name": "Karaman", "lat": 37.183633, "lon": 33.21595, "temkin": 10.0491 }, { "id": 16746, "name": "Kars", "lat": 40.5995, "lon": 43.083175, "temkin": 10.7284 }, { "id": 16747, "name": "Kastamonu", "lat": 41.366533, "lon": 33.78305, "temkin": 10.8723 }, { "id": 16748, "name": "Kayseri", "lat": 38.732967, "lon": 35.48305, "temkin": 10.3331 }, { "id": 16749, "name": "Kilis", "lat": 36.716867, "lon": 37.116325, "temkin": 9.9638 }, { "id": 16750, "name": "Kırıkkale", "lat": 39.8495, "lon": 33.499625, "temkin": 10.5663 }, { "id": 16751, "name": "Kırklareli", "lat": 41.733467, "lon": 27.216575, "temkin": 10.9278 }, { "id": 16752, "name": "Kırşehir", "lat": 39.149167, "lon": 34.166075, "temkin": 10.4142 }, { "id": 16753, "name": "Konya", "lat": 37.866033, "lon": 32.48305, "temkin": 10.1762 }, { "id": 16754, "name": "Kütahya", "lat": 39.4167, "lon": 29.982675, "temkin": 10.4721 }, { "id": 16755, "name": "Malatya", "lat": 38.349667, "lon": 38.315575, "temkin": 10.2622 }, { "id": 16756, "name": "Manisa", "lat": 38.599833, "lon": 27.4328, "temkin": 10.3105 }, { "id": 16757, "name": "Mardin", "lat": 37.3, "lon": 40.7333, "temkin": 10.0723 }, { "id": 16758, "name": "Mersin", "lat": 36.800167, "lon": 34.633237, "temkin": 9.9795 }, { "id": 16759, "name": "Muğla", "lat": 37.2167, "lon": 28.36645, "temkin": 10.0572 }, { "id": 16760, "name": "Muş", "lat": 38.733633, "lon": 41.4995, "temkin": 10.3326 }, { "id": 16761, "name": "Nevşehir", "lat": 38.632967, "lon": 34.716575, "temkin": 10.3156 }, { "id": 16762, "name": "Niğde", "lat": 37.9667, "lon": 34.6828, "temkin": 10.1917 }, { "id": 16763, "name": "Ordu", "lat": 40.982967, "lon": 37.8828, "temkin": 10.8126 }, { "id": 16764, "name": "Osmaniye", "lat": 37.066033, "lon": 36.249375, "temkin": 10.0281 }, { "id": 16765, "name": "Rize", "lat": 41.032967, "lon": 40.516575, "temkin": 10.8218 }, { "id": 16766, "name": "Samsun", "lat": 41.2833, "lon": 36.33305, "temkin": 10.8589 }, { "id": 16767, "name": "Siirt", "lat": 37.9328, "lon": 41.94975, "temkin": 10.1869 }, { "id": 16768, "name": "Sinop", "lat": 42.033133, "lon": 35.14975, "temkin": 10.9773 }, { "id": 16769, "name": "Sivas", "lat": 39.7495, "lon": 37.01645, "temkin": 10.5443 }, { "id": 16770, "name": "Şanlıurfa", "lat": 37.1505, "lon": 38.7995, "temkin": 10.0431 }, { "id": 16771, "name": "Şırnak", "lat": 37.5167, "lon": 42.466825, "temkin": 10.1122 }, { "id": 16772, "name": "Tekirdağ", "lat": 40.9833, "lon": 27.51645, "temkin": 10.8131 }, { "id": 16773, "name": "Tokat", "lat": 40.316367, "lon": 36.549625, "temkin": 10.6687 }, { "id": 16774, "name": "Trabzon", "lat": 41, "lon": 39.7162, "temkin": 10.815 }, { "id": 16775, "name": "Tunceli", "lat": 39.116533, "lon": 39.532925, "temkin": 10.4079 }, { "id": 18138, "name": "Uşak", "lat": 38.682467, "lon": 29.399875, "temkin": 10.3235 }, { "id": 18159, "name": "Van", "lat": 38.498833, "lon": 43.3828, "temkin": 10.2907 }, { "id": 18161, "name": "Yalova", "lat": 40.65, "lon": 29.266075, "temkin": 10.7413 }, { "id": 18180, "name": "Yozgat", "lat": 39.816867, "lon": 34.7995, "temkin": 10.5606 }, { "id": 18196, "name": "Zonguldak", "lat": 41.450167, "lon": 31.799563, "temkin": 10.8828 }, { "id": 18197, "name": "Düzce", "lat": 40.849667, "lon": 31.149875, "temkin": 10.7827 }, { "id": 62353, "name": "İzmit", "lat": 40.766533, "lon": 29.949625, "temkin": 10.766 }];
+exports.default = data;

package/dist/cjs/data/generated/turkiyetakvimiCertification.d.ts

@@ -0,0 +1,3 @@
+import type { Certification } from '../../core/types.js';
+declare const data: Certification | null;
+export default data;

package/dist/cjs/data/generated/turkiyetakvimiCertification.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const data = { "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 };
+exports.default = data;

package/dist/cjs/data/generated/turkiyetakvimiCorrections.d.ts

@@ -0,0 +1,3 @@
+import type { CorrectionsFile } from '../../core/types.js';
+declare const data: CorrectionsFile;
+export default data;

package/dist/cjs/data/generated/turkiyetakvimiCorrections.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const data = { "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"] } };
+exports.default = data;

package/dist/cjs/index.d.ts

@@ -15,5 +15,6 @@ import './authorities/diyanet.js';
 import './authorities/morocco.js';
 import './authorities/algeria.js';
 import './authorities/indonesia.js';
+import './authorities/turkiyeTakvimi.js';
 export * from './core/index.js';
 export { diyanetCountry } from './authorities/diyanet.js';

package/dist/cjs/index.js

@@ -32,6 +32,7 @@ require("./authorities/diyanet.js");
 require("./authorities/morocco.js");
 require("./authorities/algeria.js");
 require("./authorities/indonesia.js");
+require("./authorities/turkiyeTakvimi.js");
 __exportStar(require("./core/index.js"), exports);
 var diyanet_js_1 = require("./authorities/diyanet.js");
 Object.defineProperty(exports, "diyanetCountry", { enumerable: true, get: function () { return diyanet_js_1.diyanetCountry; } });

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

@@ -12,4 +12,5 @@ export declare const METHOD_REVISION: {
     readonly morocco: 2;
     readonly algeria: 1;
     readonly indonesia: 2;
+    readonly turkiyetakvimi: 1;
 };

package/dist/cjs/methods/revisions.js

@@ -15,4 +15,5 @@ exports.METHOD_REVISION = {
     morocco: 2,
     algeria: 1,
     indonesia: 2,
+    turkiyetakvimi: 1,
 };

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

@@ -0,0 +1,42 @@
+export type TakvimInstants = {
+    fajr: Date;
+    sunrise: Date;
+    dhuhr: Date;
+    asr: Date;
+    maghrib: Date;
+    isha: Date;
+};
+/**
+ * The calendar's temkin by its formula, minutes: the time the sun takes on
+ * the summer solstice at this latitude to go from the level horizon to the
+ * city's own. A listed place carries its own (`Place.temkin`), which strays
+ * from this by a few hundredths of a minute.
+ */
+export declare function takvimTemkin(latitude: number, heightM?: number): number;
+/** The day whose night times stand for this one: itself, or the last before it whose night reached 19°. */
+export declare function heldNight(latitude: number, longitude: number, key: number): number;
+/**
+ * The calendar's times before rounding, minutes past 00:00 UT of the date
+ * (month 0-based): the six the library gives, and İmsâk. A held night's
+ * times are that night's time of day, on this date.
+ */
+export declare function takvimRawMinutes(latitude: number, longitude: number, year: number, month: number, day: number, temkin?: number, asrShadow?: number): {
+    imsak: number;
+    fajr: number;
+    sunrise: number;
+    dhuhr: number;
+    asr: number;
+    maghrib: number;
+    isha: number;
+};
+/**
+ * The calendar's İmsâk for the date, on the minute (rounded down), or null
+ * where it does not form. Not one of the six times the library certifies.
+ */
+export declare function takvimImsak(latitude: number, longitude: number, year: number, month: number, day: number, temkin?: number): Date | null;
+/**
+ * Türkiye Takvimi's times for the civil date (month 0-based) at the point,
+ * each on the minute the calendar prints; Fajr is its Sabâh. Null where a
+ * time does not form.
+ */
+export declare function takvimTimes(latitude: number, longitude: number, year: number, month: number, day: number, temkin?: number, asrShadow?: number): TakvimInstants | null;

package/dist/cjs/methods/turkiyeTakvimi.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.takvimTemkin = takvimTemkin;
+exports.heldNight = heldNight;
+exports.takvimRawMinutes = takvimRawMinutes;
+exports.takvimImsak = takvimImsak;
+exports.takvimTimes = takvimTimes;
+/**
+ * Türkiye Takvimi — the calendar's method, as the year it publishes for a
+ * city is computed (namazvakti.com).
+ *
+ * Read off the calendar's own years (cities from 42°S to 60°N):
+ *
+ *   • the precise apparent sun, taken at each event's own moment (iterated);
+ *   • a temkin T per city, in minutes with its fraction: the time the sun
+ *     takes on the summer solstice (declination 23.38°) to go from the
+ *     level horizon down to the city's own, which depends on the height the
+ *     calendar gives the city (250 m or 500 m). A place carries the T its
+ *     table shows (`Place.temkin`); `takvimTemkin` is the formula;
+ *   • İmsâk the sun 19° below the horizon, less T, rounded DOWN;
+ *   • Sabâh — the time the calendar prints for the Fajr prayer — the sun at
+ *     18°, with no temkin;
+ *   • sunrise the sun's centre on the level horizon (0°, no refraction),
+ *     less T and two minutes;
+ *   • Dhuhr the transit plus T; Asr and Isha (17°) plus T;
+ *   • Asr's shadow the object's length plus the noon shadow at the
+ *     declination of local noon, the hour angle from the sun at Asr itself;
+ *   • Maghrib the sun's centre on the level horizon, plus T and two minutes;
+ *   • everything but İmsâk rounded UP to the minute.
+ *
+ * Where the sun no longer gets 19° below the horizon (north of about 47.5°
+ * in summer) the calendar holds İmsâk, Sabâh and Isha at the times of the
+ * last night it did; `heldNight` is that rule. No place of the certified
+ * list is that far north, so the list does not hold the rule to a table.
+ *
+ * The calendar's files give a city's point to the whole arc-minute and the
+ * calendar computes at a finer one; each place is at the point its year
+ * shows (data/places/turkiyeTakvimiCities.json).
+ */
+const preciseSun_js_1 = require("../sun/preciseSun.js");
+const RAD = Math.PI / 180;
+const DAY_MS = 86_400_000;
+/** The declination the temkin's solstice is taken at, degrees. */
+const SOLSTICE_DECLINATION = 23.38;
+/** Minutes on sunrise and Maghrib beyond the temkin. */
+const HORIZON_MARGIN = 2;
+/** Days to look back for a night that reached 19°. */
+const HOLD_SEARCH_DAYS = 200;
+/** The depression of a city's horizon below the level one, degrees, for the calendar's height of the city. */
+function horizonDepth(heightM) {
+    return 0.8416 + 0.03924 * Math.sqrt(Math.max(0, heightM));
+}
+/**
+ * The calendar's temkin by its formula, minutes: the time the sun takes on
+ * the summer solstice at this latitude to go from the level horizon to the
+ * city's own. A listed place carries its own (`Place.temkin`), which strays
+ * from this by a few hundredths of a minute.
+ */
+function takvimTemkin(latitude, heightM = 250) {
+    const phi = Math.min(Math.abs(latitude), 62) * RAD;
+    const dec = SOLSTICE_DECLINATION * RAD;
+    const hourAngle = (alt) => Math.acos(Math.max(-1, Math.min(1, (Math.sin(alt * RAD) - Math.sin(phi) * Math.sin(dec)) / (Math.cos(phi) * Math.cos(dec)))));
+    return ((hourAngle(-horizonDepth(heightM)) - hourAngle(0)) / RAD) * 4;
+}
+/** Whole days since 1970-01-01 of a civil date (month 0-based). */
+const dayKeyOf = (year, month, day) => Math.round(Date.UTC(year, month, day) / DAY_MS);
+/** Days from J2000.0 (noon) of a day's 00:00 UT. */
+const d0Of = (key) => key - 10957 - 0.5;
+/** The sun's events of a day at a point, minutes past the day's 00:00 UT; NaN where one does not happen. */
+function events(latitude, longitude, key) {
+    const d0 = d0Of(key);
+    const at = (t) => (0, preciseSun_js_1.preciseApparentSun)(d0 + t / 1440);
+    let noon = 720 - 4 * longitude;
+    for (let i = 0; i < 3; i++)
+        noon = 720 - 4 * longitude - at(noon).eot;
+    const noonDec = at(noon).dec;
+    const sp = Math.sin(latitude * RAD);
+    const cp = Math.cos(latitude * RAD);
+    const event = (alt, sign, start) => {
+        let t = start;
+        for (let i = 0; i < 3; i++) {
+            const { dec, eot } = at(t);
+            const c = (Math.sin(alt * RAD) - sp * Math.sin(dec)) / (cp * Math.cos(dec));
+            if (!(Math.abs(c) <= 1))
+                return NaN;
+            t = 720 - 4 * longitude - eot + (sign * 4 * Math.acos(c)) / RAD;
+        }
+        return t;
+    };
+    return {
+        noon,
+        at19: () => event(-19, -1, noon - 420),
+        at18: () => event(-18, -1, noon - 420),
+        sunrise: () => event(0, -1, noon - 360),
+        asr: (shadow) => event(Math.atan(1 / (shadow + Math.tan(Math.abs(latitude * RAD - noonDec)))) / RAD, 1, noon + 200),
+        sunset: () => event(0, 1, noon + 360),
+        at17: () => event(-17, 1, noon + 420),
+    };
+}
+/**
+ * Does the sun get 19° below the horizon in the night that ends on the
+ * morning of the day? The calendar counts it as reaching when its lowest
+ * point does at the declination of either of two moments: the local solar
+ * midnight that begins the day, or 12:00 UT of the day.
+ */
+function reaches19(latitude, longitude, key) {
+    const d0 = d0Of(key);
+    const lowest = (d) => Math.abs(latitude + (0, preciseSun_js_1.preciseApparentSun)(d).dec / RAD) - 90;
+    return Math.min(lowest(d0 - longitude / 360), lowest(d0 + 0.5)) <= -19;
+}
+/** The day whose night times stand for this one: itself, or the last before it whose night reached 19°. */
+function heldNight(latitude, longitude, key) {
+    for (let i = 0; i <= HOLD_SEARCH_DAYS; i++)
+        if (reaches19(latitude, longitude, key - i))
+            return key - i;
+    return key;
+}
+/**
+ * The calendar's times before rounding, minutes past 00:00 UT of the date
+ * (month 0-based): the six the library gives, and İmsâk. A held night's
+ * times are that night's time of day, on this date.
+ */
+function takvimRawMinutes(latitude, longitude, year, month, day, temkin = takvimTemkin(latitude), asrShadow = 1) {
+    const key = dayKeyOf(year, month, day);
+    const today = events(latitude, longitude, key);
+    const night = heldNight(latitude, longitude, key);
+    const nightSun = night === key ? today : events(latitude, longitude, night);
+    // Isha belongs to the night that begins this evening: it is tomorrow's night that decides,
+    // and a held Isha is that of the evening before the last night that reached 19°.
+    const ishaNight = heldNight(latitude, longitude, key + 1);
+    const ishaDay = ishaNight === key + 1 ? key : ishaNight - 1;
+    const ishaSun = ishaDay === key ? today : events(latitude, longitude, ishaDay);
+    return {
+        imsak: nightSun.at19() - temkin,
+        fajr: nightSun.at18(),
+        sunrise: today.sunrise() - temkin - HORIZON_MARGIN,
+        dhuhr: today.noon + temkin,
+        asr: today.asr(asrShadow) + temkin,
+        maghrib: today.sunset() + temkin + HORIZON_MARGIN,
+        isha: ishaSun.at17() + temkin,
+    };
+}
+/** Up to the minute, as the calendar rounds everything but İmsâk. */
+const up = (m) => Math.ceil(m - 1e-9);
+/**
+ * The calendar's İmsâk for the date, on the minute (rounded down), or null
+ * where it does not form. Not one of the six times the library certifies.
+ */
+function takvimImsak(latitude, longitude, year, month, day, temkin) {
+    const m = takvimRawMinutes(latitude, longitude, year, month, day, temkin).imsak;
+    return Number.isFinite(m) ? new Date(Date.UTC(year, month, day) + Math.floor(m + 1e-9) * 60_000) : null;
+}
+/**
+ * Türkiye Takvimi's times for the civil date (month 0-based) at the point,
+ * each on the minute the calendar prints; Fajr is its Sabâh. Null where a
+ * time does not form.
+ */
+function takvimTimes(latitude, longitude, year, month, day, temkin, asrShadow = 1) {
+    const r = takvimRawMinutes(latitude, longitude, year, month, day, temkin, asrShadow);
+    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 + up(m) * 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) };
+}

package/dist/cjs/turkiyetakvimi.d.ts

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

package/dist/cjs/turkiyetakvimi.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.places = void 0;
+/** mihrab-methods/turkiyetakvimi — the Türkiye Takvimi method with its places and correction list, and nothing else's. */
+require("./authorities/turkiyeTakvimi.js");
+__exportStar(require("./core/index.js"), exports);
+var turkiyeTakvimi_js_1 = require("./authorities/turkiyeTakvimi.js");
+Object.defineProperty(exports, "places", { enumerable: true, get: function () { return turkiyeTakvimi_js_1.places; } });

package/dist/esm/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/esm/authorities/turkiyeTakvimi.js

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+import cities from '../data/generated/turkiyeTakvimiCities.js';
+import corrections from '../data/generated/turkiyetakvimiCorrections.js';
+import certification from '../data/generated/turkiyetakvimiCertification.js';
+import { METHOD_REVISION } from '../methods/revisions.js';
+import { registerAuthority } from '../core/registry.js';
+const AUTHORITY = 'turkiyetakvimi';
+function buildPlaces() {
+    return cities.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,
+        };
+    });
+}
+export const turkiyeTakvimi = registerAuthority({
+    authority: AUTHORITY,
+    revision: METHOD_REVISION.turkiyetakvimi,
+    places: buildPlaces(),
+    corrections,
+    certification,
+    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',
+    },
+});
+export const places = turkiyeTakvimi.places;

package/dist/esm/core/compute.js

@@ -8,6 +8,7 @@ import { congressTimes } from '../methods/sweden.js';
 import { moroccoTimes } from '../methods/morocco.js';
 import { algeriaTimes } from '../methods/algeria.js';
 import { kemenagTimes } from '../methods/indonesia.js';
+import { takvimTimes } from '../methods/turkiyeTakvimi.js';
 import { authorityData } from './registry.js';
 import { placeClockAt } from './clock.js';
 /**
@@ -30,12 +31,15 @@ export function candidateInstants(place, year, month, day, asrShadow = 1, opts =
         }
         case 'morocco':
         case 'algeria':
-        case 'indonesia': {
+        case 'indonesia':
+        case 'turkiyetakvimi': {
             const t = place.authority === 'morocco'
                 ? moroccoTimes(place.lat, place.lon, year, month, day, place.dipDeg, asrShadow, place.dipMaghribDeg)
                 : place.authority === 'algeria'
                     ? algeriaTimes(place.lat, place.lon, year, month, day, asrShadow)
-                    : kemenagTimes(place.lat, place.lon, year, month, day, { highland: place.highland, twilightDip: place.twilightDip, asrShadow, afternoon: place.afternoon });
+                    : place.authority === 'turkiyetakvimi'
+                        ? takvimTimes(place.lat, place.lon, year, month, day, place.temkin, asrShadow)
+                        : 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/esm/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/esm/core/types.js

@@ -1,7 +1,7 @@
 /**
  * The shapes the library speaks in. Nothing here computes anything.
  */
-export const AUTHORITIES = ['sweden', 'diyanet', 'morocco', 'algeria', 'indonesia'];
+export const AUTHORITIES = ['sweden', 'diyanet', 'morocco', 'algeria', 'indonesia', 'turkiyetakvimi'];
 export const 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). */
 export class UncertifiedMethodError extends Error {

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

@@ -0,0 +1,8 @@
+declare const data: {
+    id: number;
+    name: string;
+    lat: number;
+    lon: number;
+    temkin: number;
+}[];
+export default data;

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

@@ -0,0 +1,3 @@
+// Generated by scripts/embed.mjs — do not edit; edit the JSON under data/ instead.
+const data = [{ "id": 16702, "name": "Adana", "lat": 36.9995, "lon": 35.316075, "temkin": 10.0151 }, { "id": 16703, "name": "Adapazarı", "lat": 40.7833, "lon": 30.399875, "temkin": 10.7698 }, { "id": 16704, "name": "Adıyaman", "lat": 37.7667, "lon": 38.2828, "temkin": 10.1563 }, { "id": 16705, "name": "Afyonkarahisar", "lat": 38.750167, "lon": 30.549625, "temkin": 10.3374 }, { "id": 16706, "name": "Ağrı", "lat": 39.7162, "lon": 43.0495, "temkin": 10.5387 }, { "id": 16707, "name": "Aksaray", "lat": 38.3667, "lon": 34.0328, "temkin": 10.2665 }, { "id": 16708, "name": "Amasya", "lat": 40.65, "lon": 35.8333, "temkin": 10.7413 }, { "id": 16709, "name": "Ankara", "lat": 39.9333, "lon": 32.849063, "temkin": 10.5818 }, { "id": 16710, "name": "Antakya", "lat": 36.1833, "lon": 36.166263, "temkin": 9.8655 }, { "id": 16711, "name": "Antalya", "lat": 36.8838, "lon": 30.6995, "temkin": 9.9937 }, { "id": 16712, "name": "Ardahan", "lat": 41.1167, "lon": 42.7, "temkin": 10.8344 }, { "id": 16713, "name": "Artvin", "lat": 41.1833, "lon": 41.816575, "temkin": 10.8446 }, { "id": 16714, "name": "Aydın", "lat": 37.849833, "lon": 27.849625, "temkin": 10.1726 }, { "id": 16715, "name": "Balıkesir", "lat": 39.65, "lon": 27.882362, "temkin": 10.5209 }, { "id": 16716, "name": "Bartın", "lat": 41.633133, "lon": 32.333175, "temkin": 10.9118 }, { "id": 16717, "name": "Batman", "lat": 37.8662, "lon": 41.116325, "temkin": 10.1742 }, { "id": 16718, "name": "Bayburt", "lat": 40.2505, "lon": 40.232175, "temkin": 10.6513 }, { "id": 16719, "name": "Bilecik", "lat": 40.149833, "lon": 29.9828, "temkin": 10.6312 }, { "id": 16720, "name": "Bingöl", "lat": 38.883133, "lon": 40.48305, "temkin": 10.3613 }, { "id": 16721, "name": "Bitlis", "lat": 38.3828, "lon": 42.099375, "temkin": 10.2697 }, { "id": 16722, "name": "Bolu", "lat": 40.733133, "lon": 31.61645, "temkin": 10.7573 }, { "id": 16723, "name": "Burdur", "lat": 37.7162, "lon": 30.283425, "temkin": 10.149 }, { "id": 16724, "name": "Bursa", "lat": 40.200333, "lon": 29.066325, "temkin": 10.6428 }, { "id": 16725, "name": "Çanakkale", "lat": 40.15, "lon": 26.416012, "temkin": 10.6307 }, { "id": 16726, "name": "Çankırı", "lat": 40.6, "lon": 33.6167, "temkin": 10.7299 }, { "id": 16727, "name": "Çorum", "lat": 40.55, "lon": 34.949625, "temkin": 10.7186 }, { "id": 16728, "name": "Denizli", "lat": 37.7833, "lon": 29.083175, "temkin": 10.1605 }, { "id": 16729, "name": "Diyarbakır", "lat": 37.9167, "lon": 40.232675, "temkin": 10.1822 }, { "id": 16730, "name": "Edirne", "lat": 41.666367, "lon": 26.566575, "temkin": 10.9169 }, { "id": 16731, "name": "Elazığ", "lat": 38.683467, "lon": 39.23305, "temkin": 10.3245 }, { "id": 16732, "name": "Erzincan", "lat": 39.75, "lon": 39.499875, "temkin": 10.5473 }, { "id": 16733, "name": "Erzurum", "lat": 39.916533, "lon": 41.266325, "temkin": 10.5817 }, { "id": 16734, "name": "Eskişehir", "lat": 39.782133, "lon": 30.51595, "temkin": 10.553 }, { "id": 16735, "name": "Gaziantep", "lat": 37.066367, "lon": 37.38305, "temkin": 10.0276 }, { "id": 16736, "name": "Giresun", "lat": 40.916367, "lon": 38.399875, "temkin": 10.7996 }, { "id": 16737, "name": "Gümüşhane", "lat": 40.449, "lon": 39.482925, "temkin": 10.696 }, { "id": 16738, "name": "Hakkâri", "lat": 37.5833, "lon": 43.733238, "temkin": 10.1245 }, { "id": 16739, "name": "Iğdır", "lat": 39.916533, "lon": 44.032987, "temkin": 10.5817 }, { "id": 16740, "name": "Isparta", "lat": 37.767033, "lon": 30.549625, "temkin": 10.1573 }, { "id": 16741, "name": "İstanbul", "lat": 41.000167, "lon": 28.999625, "temkin": 10.815 }, { "id": 16742, "name": "İzmir", "lat": 38.416367, "lon": 27.132987, "temkin": 10.2768 }, { "id": 16743, "name": "Kahramanmaraş", "lat": 37.5833, "lon": 36.932925, "temkin": 10.1225 }, { "id": 16744, "name": "Karabük", "lat": 41.199833, "lon": 32.632425, "temkin": 10.8451 }, { "id": 16745, "name": "Karaman", "lat": 37.183633, "lon": 33.21595, "temkin": 10.0491 }, { "id": 16746, "name": "Kars", "lat": 40.5995, "lon": 43.083175, "temkin": 10.7284 }, { "id": 16747, "name": "Kastamonu", "lat": 41.366533, "lon": 33.78305, "temkin": 10.8723 }, { "id": 16748, "name": "Kayseri", "lat": 38.732967, "lon": 35.48305, "temkin": 10.3331 }, { "id": 16749, "name": "Kilis", "lat": 36.716867, "lon": 37.116325, "temkin": 9.9638 }, { "id": 16750, "name": "Kırıkkale", "lat": 39.8495, "lon": 33.499625, "temkin": 10.5663 }, { "id": 16751, "name": "Kırklareli", "lat": 41.733467, "lon": 27.216575, "temkin": 10.9278 }, { "id": 16752, "name": "Kırşehir", "lat": 39.149167, "lon": 34.166075, "temkin": 10.4142 }, { "id": 16753, "name": "Konya", "lat": 37.866033, "lon": 32.48305, "temkin": 10.1762 }, { "id": 16754, "name": "Kütahya", "lat": 39.4167, "lon": 29.982675, "temkin": 10.4721 }, { "id": 16755, "name": "Malatya", "lat": 38.349667, "lon": 38.315575, "temkin": 10.2622 }, { "id": 16756, "name": "Manisa", "lat": 38.599833, "lon": 27.4328, "temkin": 10.3105 }, { "id": 16757, "name": "Mardin", "lat": 37.3, "lon": 40.7333, "temkin": 10.0723 }, { "id": 16758, "name": "Mersin", "lat": 36.800167, "lon": 34.633237, "temkin": 9.9795 }, { "id": 16759, "name": "Muğla", "lat": 37.2167, "lon": 28.36645, "temkin": 10.0572 }, { "id": 16760, "name": "Muş", "lat": 38.733633, "lon": 41.4995, "temkin": 10.3326 }, { "id": 16761, "name": "Nevşehir", "lat": 38.632967, "lon": 34.716575, "temkin": 10.3156 }, { "id": 16762, "name": "Niğde", "lat": 37.9667, "lon": 34.6828, "temkin": 10.1917 }, { "id": 16763, "name": "Ordu", "lat": 40.982967, "lon": 37.8828, "temkin": 10.8126 }, { "id": 16764, "name": "Osmaniye", "lat": 37.066033, "lon": 36.249375, "temkin": 10.0281 }, { "id": 16765, "name": "Rize", "lat": 41.032967, "lon": 40.516575, "temkin": 10.8218 }, { "id": 16766, "name": "Samsun", "lat": 41.2833, "lon": 36.33305, "temkin": 10.8589 }, { "id": 16767, "name": "Siirt", "lat": 37.9328, "lon": 41.94975, "temkin": 10.1869 }, { "id": 16768, "name": "Sinop", "lat": 42.033133, "lon": 35.14975, "temkin": 10.9773 }, { "id": 16769, "name": "Sivas", "lat": 39.7495, "lon": 37.01645, "temkin": 10.5443 }, { "id": 16770, "name": "Şanlıurfa", "lat": 37.1505, "lon": 38.7995, "temkin": 10.0431 }, { "id": 16771, "name": "Şırnak", "lat": 37.5167, "lon": 42.466825, "temkin": 10.1122 }, { "id": 16772, "name": "Tekirdağ", "lat": 40.9833, "lon": 27.51645, "temkin": 10.8131 }, { "id": 16773, "name": "Tokat", "lat": 40.316367, "lon": 36.549625, "temkin": 10.6687 }, { "id": 16774, "name": "Trabzon", "lat": 41, "lon": 39.7162, "temkin": 10.815 }, { "id": 16775, "name": "Tunceli", "lat": 39.116533, "lon": 39.532925, "temkin": 10.4079 }, { "id": 18138, "name": "Uşak", "lat": 38.682467, "lon": 29.399875, "temkin": 10.3235 }, { "id": 18159, "name": "Van", "lat": 38.498833, "lon": 43.3828, "temkin": 10.2907 }, { "id": 18161, "name": "Yalova", "lat": 40.65, "lon": 29.266075, "temkin": 10.7413 }, { "id": 18180, "name": "Yozgat", "lat": 39.816867, "lon": 34.7995, "temkin": 10.5606 }, { "id": 18196, "name": "Zonguldak", "lat": 41.450167, "lon": 31.799563, "temkin": 10.8828 }, { "id": 18197, "name": "Düzce", "lat": 40.849667, "lon": 31.149875, "temkin": 10.7827 }, { "id": 62353, "name": "İzmit", "lat": 40.766533, "lon": 29.949625, "temkin": 10.766 }];
+export default data;

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

@@ -0,0 +1,3 @@
+import type { Certification } from '../../core/types.js';
+declare const data: Certification | null;
+export default data;

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

@@ -0,0 +1,2 @@
+const data = { "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 };
+export default data;

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

@@ -0,0 +1,3 @@
+import type { CorrectionsFile } from '../../core/types.js';
+declare const data: CorrectionsFile;
+export default data;

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

@@ -0,0 +1,2 @@
+const data = { "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"] } };
+export default data;

package/dist/esm/index.d.ts

@@ -15,5 +15,6 @@ import './authorities/diyanet.js';
 import './authorities/morocco.js';
 import './authorities/algeria.js';
 import './authorities/indonesia.js';
+import './authorities/turkiyeTakvimi.js';
 export * from './core/index.js';
 export { diyanetCountry } from './authorities/diyanet.js';

package/dist/esm/index.js

@@ -15,5 +15,6 @@ import './authorities/diyanet.js';
 import './authorities/morocco.js';
 import './authorities/algeria.js';
 import './authorities/indonesia.js';
+import './authorities/turkiyeTakvimi.js';
 export * from './core/index.js';
 export { diyanetCountry } from './authorities/diyanet.js';

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

@@ -12,4 +12,5 @@ export declare const METHOD_REVISION: {
     readonly morocco: 2;
     readonly algeria: 1;
     readonly indonesia: 2;
+    readonly turkiyetakvimi: 1;
 };

package/dist/esm/methods/revisions.js

@@ -12,4 +12,5 @@ export const METHOD_REVISION = {
     morocco: 2,
     algeria: 1,
     indonesia: 2,
+    turkiyetakvimi: 1,
 };

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

@@ -0,0 +1,42 @@
+export type TakvimInstants = {
+    fajr: Date;
+    sunrise: Date;
+    dhuhr: Date;
+    asr: Date;
+    maghrib: Date;
+    isha: Date;
+};
+/**
+ * The calendar's temkin by its formula, minutes: the time the sun takes on
+ * the summer solstice at this latitude to go from the level horizon to the
+ * city's own. A listed place carries its own (`Place.temkin`), which strays
+ * from this by a few hundredths of a minute.
+ */
+export declare function takvimTemkin(latitude: number, heightM?: number): number;
+/** The day whose night times stand for this one: itself, or the last before it whose night reached 19°. */
+export declare function heldNight(latitude: number, longitude: number, key: number): number;
+/**
+ * The calendar's times before rounding, minutes past 00:00 UT of the date
+ * (month 0-based): the six the library gives, and İmsâk. A held night's
+ * times are that night's time of day, on this date.
+ */
+export declare function takvimRawMinutes(latitude: number, longitude: number, year: number, month: number, day: number, temkin?: number, asrShadow?: number): {
+    imsak: number;
+    fajr: number;
+    sunrise: number;
+    dhuhr: number;
+    asr: number;
+    maghrib: number;
+    isha: number;
+};
+/**
+ * The calendar's İmsâk for the date, on the minute (rounded down), or null
+ * where it does not form. Not one of the six times the library certifies.
+ */
+export declare function takvimImsak(latitude: number, longitude: number, year: number, month: number, day: number, temkin?: number): Date | null;
+/**
+ * Türkiye Takvimi's times for the civil date (month 0-based) at the point,
+ * each on the minute the calendar prints; Fajr is its Sabâh. Null where a
+ * time does not form.
+ */
+export declare function takvimTimes(latitude: number, longitude: number, year: number, month: number, day: number, temkin?: number, asrShadow?: number): TakvimInstants | null;

package/dist/esm/methods/turkiyeTakvimi.js

@@ -0,0 +1,159 @@
+/**
+ * Türkiye Takvimi — the calendar's method, as the year it publishes for a
+ * city is computed (namazvakti.com).
+ *
+ * Read off the calendar's own years (cities from 42°S to 60°N):
+ *
+ *   • the precise apparent sun, taken at each event's own moment (iterated);
+ *   • a temkin T per city, in minutes with its fraction: the time the sun
+ *     takes on the summer solstice (declination 23.38°) to go from the
+ *     level horizon down to the city's own, which depends on the height the
+ *     calendar gives the city (250 m or 500 m). A place carries the T its
+ *     table shows (`Place.temkin`); `takvimTemkin` is the formula;
+ *   • İmsâk the sun 19° below the horizon, less T, rounded DOWN;
+ *   • Sabâh — the time the calendar prints for the Fajr prayer — the sun at
+ *     18°, with no temkin;
+ *   • sunrise the sun's centre on the level horizon (0°, no refraction),
+ *     less T and two minutes;
+ *   • Dhuhr the transit plus T; Asr and Isha (17°) plus T;
+ *   • Asr's shadow the object's length plus the noon shadow at the
+ *     declination of local noon, the hour angle from the sun at Asr itself;
+ *   • Maghrib the sun's centre on the level horizon, plus T and two minutes;
+ *   • everything but İmsâk rounded UP to the minute.
+ *
+ * Where the sun no longer gets 19° below the horizon (north of about 47.5°
+ * in summer) the calendar holds İmsâk, Sabâh and Isha at the times of the
+ * last night it did; `heldNight` is that rule. No place of the certified
+ * list is that far north, so the list does not hold the rule to a table.
+ *
+ * The calendar's files give a city's point to the whole arc-minute and the
+ * calendar computes at a finer one; each place is at the point its year
+ * shows (data/places/turkiyeTakvimiCities.json).
+ */
+import { preciseApparentSun } from '../sun/preciseSun.js';
+const RAD = Math.PI / 180;
+const DAY_MS = 86_400_000;
+/** The declination the temkin's solstice is taken at, degrees. */
+const SOLSTICE_DECLINATION = 23.38;
+/** Minutes on sunrise and Maghrib beyond the temkin. */
+const HORIZON_MARGIN = 2;
+/** Days to look back for a night that reached 19°. */
+const HOLD_SEARCH_DAYS = 200;
+/** The depression of a city's horizon below the level one, degrees, for the calendar's height of the city. */
+function horizonDepth(heightM) {
+    return 0.8416 + 0.03924 * Math.sqrt(Math.max(0, heightM));
+}
+/**
+ * The calendar's temkin by its formula, minutes: the time the sun takes on
+ * the summer solstice at this latitude to go from the level horizon to the
+ * city's own. A listed place carries its own (`Place.temkin`), which strays
+ * from this by a few hundredths of a minute.
+ */
+export function takvimTemkin(latitude, heightM = 250) {
+    const phi = Math.min(Math.abs(latitude), 62) * RAD;
+    const dec = SOLSTICE_DECLINATION * RAD;
+    const hourAngle = (alt) => Math.acos(Math.max(-1, Math.min(1, (Math.sin(alt * RAD) - Math.sin(phi) * Math.sin(dec)) / (Math.cos(phi) * Math.cos(dec)))));
+    return ((hourAngle(-horizonDepth(heightM)) - hourAngle(0)) / RAD) * 4;
+}
+/** Whole days since 1970-01-01 of a civil date (month 0-based). */
+const dayKeyOf = (year, month, day) => Math.round(Date.UTC(year, month, day) / DAY_MS);
+/** Days from J2000.0 (noon) of a day's 00:00 UT. */
+const d0Of = (key) => key - 10957 - 0.5;
+/** The sun's events of a day at a point, minutes past the day's 00:00 UT; NaN where one does not happen. */
+function events(latitude, longitude, key) {
+    const d0 = d0Of(key);
+    const at = (t) => preciseApparentSun(d0 + t / 1440);
+    let noon = 720 - 4 * longitude;
+    for (let i = 0; i < 3; i++)
+        noon = 720 - 4 * longitude - at(noon).eot;
+    const noonDec = at(noon).dec;
+    const sp = Math.sin(latitude * RAD);
+    const cp = Math.cos(latitude * RAD);
+    const event = (alt, sign, start) => {
+        let t = start;
+        for (let i = 0; i < 3; i++) {
+            const { dec, eot } = at(t);
+            const c = (Math.sin(alt * RAD) - sp * Math.sin(dec)) / (cp * Math.cos(dec));
+            if (!(Math.abs(c) <= 1))
+                return NaN;
+            t = 720 - 4 * longitude - eot + (sign * 4 * Math.acos(c)) / RAD;
+        }
+        return t;
+    };
+    return {
+        noon,
+        at19: () => event(-19, -1, noon - 420),
+        at18: () => event(-18, -1, noon - 420),
+        sunrise: () => event(0, -1, noon - 360),
+        asr: (shadow) => event(Math.atan(1 / (shadow + Math.tan(Math.abs(latitude * RAD - noonDec)))) / RAD, 1, noon + 200),
+        sunset: () => event(0, 1, noon + 360),
+        at17: () => event(-17, 1, noon + 420),
+    };
+}
+/**
+ * Does the sun get 19° below the horizon in the night that ends on the
+ * morning of the day? The calendar counts it as reaching when its lowest
+ * point does at the declination of either of two moments: the local solar
+ * midnight that begins the day, or 12:00 UT of the day.
+ */
+function reaches19(latitude, longitude, key) {
+    const d0 = d0Of(key);
+    const lowest = (d) => Math.abs(latitude + preciseApparentSun(d).dec / RAD) - 90;
+    return Math.min(lowest(d0 - longitude / 360), lowest(d0 + 0.5)) <= -19;
+}
+/** The day whose night times stand for this one: itself, or the last before it whose night reached 19°. */
+export function heldNight(latitude, longitude, key) {
+    for (let i = 0; i <= HOLD_SEARCH_DAYS; i++)
+        if (reaches19(latitude, longitude, key - i))
+            return key - i;
+    return key;
+}
+/**
+ * The calendar's times before rounding, minutes past 00:00 UT of the date
+ * (month 0-based): the six the library gives, and İmsâk. A held night's
+ * times are that night's time of day, on this date.
+ */
+export function takvimRawMinutes(latitude, longitude, year, month, day, temkin = takvimTemkin(latitude), asrShadow = 1) {
+    const key = dayKeyOf(year, month, day);
+    const today = events(latitude, longitude, key);
+    const night = heldNight(latitude, longitude, key);
+    const nightSun = night === key ? today : events(latitude, longitude, night);
+    // Isha belongs to the night that begins this evening: it is tomorrow's night that decides,
+    // and a held Isha is that of the evening before the last night that reached 19°.
+    const ishaNight = heldNight(latitude, longitude, key + 1);
+    const ishaDay = ishaNight === key + 1 ? key : ishaNight - 1;
+    const ishaSun = ishaDay === key ? today : events(latitude, longitude, ishaDay);
+    return {
+        imsak: nightSun.at19() - temkin,
+        fajr: nightSun.at18(),
+        sunrise: today.sunrise() - temkin - HORIZON_MARGIN,
+        dhuhr: today.noon + temkin,
+        asr: today.asr(asrShadow) + temkin,
+        maghrib: today.sunset() + temkin + HORIZON_MARGIN,
+        isha: ishaSun.at17() + temkin,
+    };
+}
+/** Up to the minute, as the calendar rounds everything but İmsâk. */
+const up = (m) => Math.ceil(m - 1e-9);
+/**
+ * The calendar's İmsâk for the date, on the minute (rounded down), or null
+ * where it does not form. Not one of the six times the library certifies.
+ */
+export function takvimImsak(latitude, longitude, year, month, day, temkin) {
+    const m = takvimRawMinutes(latitude, longitude, year, month, day, temkin).imsak;
+    return Number.isFinite(m) ? new Date(Date.UTC(year, month, day) + Math.floor(m + 1e-9) * 60_000) : null;
+}
+/**
+ * Türkiye Takvimi's times for the civil date (month 0-based) at the point,
+ * each on the minute the calendar prints; Fajr is its Sabâh. Null where a
+ * time does not form.
+ */
+export function takvimTimes(latitude, longitude, year, month, day, temkin, asrShadow = 1) {
+    const r = takvimRawMinutes(latitude, longitude, year, month, day, temkin, asrShadow);
+    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 + up(m) * 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) };
+}

package/dist/esm/turkiyetakvimi.d.ts

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

package/dist/esm/turkiyetakvimi.js

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

package/docs/methods.md

@@ -201,6 +201,45 @@ cities.
   its table is computed.
 - Each regency is printed in its province's zone (WIB, WITA or WIT).
 
+## Türkiye Takvimi
+
+`src/methods/turkiyeTakvimi.ts`. The calendar's own years for its cities
+(namazvakti.com), read off cities from 42°S to 60°N.
+
+- The **precise apparent sun** of Indonesia's method — here with ΔT added
+  to Universal Time, as the ephemeris asks — taken at each event's own
+  moment: three iterations from the transit, itself iterated
+  three times.
+- A **temkin `T`** per city, in minutes with its fraction: the time the sun
+  takes on the summer solstice (declination 23.38°) at the city's latitude
+  `φ` to go from the level horizon to the city's own, `d` below it,
+  `T = 4 [ H(−d) − H(0) ]` with `cos H(a) = (sin a − sin φ sin 23.38°) / (cos φ cos 23.38°)`
+  and `d = 0.8416° + 0.03924° √h` for the height `h` the calendar gives the
+  city (250 m: 1.462°; 500 m: 1.719°). A listed place carries the `T` its
+  table shows (`Place.temkin`), which strays from the formula by a few
+  hundredths of a minute.
+- **Fajr** is the calendar's Sabâh: the sun 18° below the horizon, with no
+  temkin. (Its İmsâk, which the library does not give among the six, is the
+  sun at 19° less `T`, rounded down.)
+- **Sunrise**: the sun's centre on the level horizon (altitude 0°, no
+  refraction), less `T` and two minutes.
+- **Dhuhr**: the transit plus `T`.
+- **Asr**: the altitude `arccot(s + tan|φ − δ|)` with `δ` the declination
+  of local noon (the hour angle from the sun at Asr itself), plus `T`.
+- **Maghrib**: the sun's centre on the level horizon, plus `T` and two
+  minutes.
+- **Isha**: the sun 17° below the horizon, plus `T`.
+- Every time rounded **up** to the minute.
+- **Where the sun does not get 19° below the horizon** (north of about
+  47.5° in summer), İmsâk, Fajr and Isha are held at the times of the last
+  night it did. A night counts as reaching 19° when the sun's lowest point,
+  `|φ + δ| − 90°`, does at the declination of either the local solar
+  midnight that begins the day or 12:00 UT of the day. The certified list
+  has no place that far north; the rule is as the calendar's northern
+  cities show it, and no table here holds it.
+- The calendar's files give a city's point to the whole arc-minute and it
+  computes at a finer one; each place is at the point its year shows.
+
 ## Checking a port
 
 1. Take `test/vectors.json`. For each case, compute the six times at the

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mihrab-methods",
-  "version": "1.2.1",
-  "description": "The prayer-time authorities' own calculation methods, each reproducing its published timetable to the minute: Sweden (Diyanet, as Islamiska Förbundet prints it), Diyanet worldwide, Morocco (Habous), Algeria (Ministry of Religious Affairs), Indonesia (Kemenag).",
+  "version": "1.3.0",
+  "description": "The prayer-time authorities' own calculation methods, each reproducing its published timetable to the minute: Sweden (Diyanet, as Islamiska Förbundet prints it), Diyanet worldwide, Morocco (Habous), Algeria (Ministry of Religious Affairs), Indonesia (Kemenag), Türkiye Takvimi.",
   "license": "MPL-2.0",
   "author": "Hassan El Ghamri",
   "repository": {
@@ -28,6 +28,7 @@
     "./dist/*/morocco.js",
     "./dist/*/algeria.js",
     "./dist/*/indonesia.js",
+    "./dist/*/turkiyetakvimi.js",
     "./dist/*/authorities/*.js",
     "./src/index.ts",
     "./src/sweden.ts",
@@ -35,6 +36,7 @@
     "./src/morocco.ts",
     "./src/algeria.ts",
     "./src/indonesia.ts",
+    "./src/turkiyetakvimi.ts",
     "./src/authorities/*.ts"
   ],
   "engines": {
@@ -121,6 +123,16 @@
         "default": "./dist/cjs/indonesia.js"
       }
     },
+    "./turkiyetakvimi": {
+      "import": {
+        "types": "./dist/esm/turkiyetakvimi.d.ts",
+        "default": "./dist/esm/turkiyetakvimi.js"
+      },
+      "require": {
+        "types": "./dist/cjs/turkiyetakvimi.d.ts",
+        "default": "./dist/cjs/turkiyetakvimi.js"
+      }
+    },
     "./locate": {
       "import": {
         "types": "./dist/esm/locate.d.ts",
@@ -156,6 +168,9 @@
       "indonesia": [
         "./dist/cjs/indonesia.d.ts"
       ],
+      "turkiyetakvimi": [
+        "./dist/cjs/turkiyetakvimi.d.ts"
+      ],
       "locate": [
         "./dist/cjs/locate.d.ts"
       ]

package/schemas/certification.schema.json

@@ -10,7 +10,8 @@
       "diyanet",
       "morocco",
       "algeria",
-      "indonesia"
+      "indonesia",
+      "turkiyetakvimi"
     ]
   },
   "additionalProperties": {