mihrab-methods 1.4.0 → 1.5.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-->75,458,222<!--/fig--> times off the printed minute. Free for any app, site or
+<!--fig:total.times-->76,010,102<!--/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)
@@ -44,8 +44,9 @@ The full API, the HTTP server and the per-authority imports are in
 | **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 | 821 | 1,812,768 | **0** | 99.952 % | 860 | 31 Dec 2025 → 2 Jan 2027 |
+| **Kazakhstan** | the Spiritual Administration’s times | 84 | 551,880 | **0** | 100.000 % | 0 | 1 Jan 2025 → 31 Dec 2027 |
 
-6 of 6 methods certified; 0 of 75,458,222 times off the printed minute. Last checked 9 November 2026. Generated from [`certification.json`](certification.json) by `scripts/readme.mjs`.
+7 of 7 methods certified; 0 of 76,010,102 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

@@ -150,5 +150,28 @@
       "sha256": "edf5bd37ccd06dbcb87300a6c943353adb624a545ff6ea416a8f89715713d7bd"
     },
     "revision": 1
+  },
+  "kazakhstan": {
+    "certified": true,
+    "checkedAt": "2026-11-11",
+    "places": 84,
+    "checks": [
+      {
+        "tables": "Kazakhstan — the Spiritual Administration’s times",
+        "places": 84,
+        "times": 551880,
+        "off": 0,
+        "offWithoutCorrections": 0,
+        "from": "2025-01-01",
+        "to": "2027-12-31"
+      }
+    ],
+    "corrections": {
+      "from": "2025-01-01",
+      "to": "2027-12-31",
+      "entries": 0,
+      "sha256": "e3d60e566ca082f74ce9904886087b29e65d2871c5bcc02f46349d82c8994d88"
+    },
+    "revision": 1
   }
 }

package/data/corrections/kazakhstan.json

@@ -0,0 +1,5 @@
+{
+ "from": "2025-01-01",
+ "to": "2027-12-31",
+ "points": {}
+}

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

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

package/dist/cjs/authorities/kazakhstan.js

@@ -0,0 +1,49 @@
+"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.kazakhstan = void 0;
+/**
+ * Kazakhstan — the Spiritual Administration of Muslims of Kazakhstan: its
+ * cities, each at the coordinates the Administration computes it at.
+ */
+const kazakhstanCities_js_1 = __importDefault(require("../data/generated/kazakhstanCities.js"));
+const kazakhstanCorrections_js_1 = __importDefault(require("../data/generated/kazakhstanCorrections.js"));
+const kazakhstanCertification_js_1 = __importDefault(require("../data/generated/kazakhstanCertification.js"));
+const revisions_js_1 = require("../methods/revisions.js");
+const registry_js_1 = require("../core/registry.js");
+const AUTHORITY = 'kazakhstan';
+/** The whole country keeps UTC+5 (since 1 March 2024), and the Administration prints every place on it. */
+const TZ = 'Asia/Almaty';
+function buildPlaces() {
+    return kazakhstanCities_js_1.default.map(c => {
+        const key = String(c.id);
+        return { authority: AUTHORITY, id: `${AUTHORITY}:${key}`, key, name: c.name, country: 'KZ', lat: c.lat, lon: c.lon, tz: TZ };
+    });
+}
+exports.kazakhstan = (0, registry_js_1.registerAuthority)({
+    authority: AUTHORITY,
+    revision: revisions_js_1.METHOD_REVISION.kazakhstan,
+    places: buildPlaces(),
+    corrections: kazakhstanCorrections_js_1.default,
+    certification: kazakhstanCertification_js_1.default,
+    description: {
+        name: 'Kazakhstan — Spiritual Administration of Muslims of Kazakhstan',
+        method: 'A short series for the sun, each time computed once from a fixed first guess of its hour; Fajr and Isha at 15°, capped at a quarter of the night from sunrise and sunset; sunrise and sunset at −0.833°; Asr at two shadow lengths (Hanafi); a margin of 3 minutes (5 from 48° N) before sunrise, after the transit, on Asr and on Maghrib after sunset; every time rounded to the nearest minute.',
+        countries: ['KZ'],
+        parameters: {
+            fajrAngle: 15,
+            ishaAngle: 15,
+            sunriseAltitude: -0.833,
+            asrShadow: 2,
+            highLatitude: 'a quarter of the night, where the angle is further or not reached',
+            marginMinutes: '3; 5 from 48° N — sunrise earlier, Dhuhr, Asr and Maghrib later',
+            rounding: 'to the nearest minute',
+            sun: 'low-precision series (mean elements linear in time, two terms of the equation of the centre), not iterated',
+        },
+        sources: [{ title: 'Spiritual Administration of Muslims of Kazakhstan — намаз уақыттары', url: 'https://namaz.muftyat.kz/' }],
+        spec: 'docs/methods.md#kazakhstan',
+    },
+});
+exports.places = exports.kazakhstan.places;

package/dist/cjs/core/compute.js

@@ -12,6 +12,7 @@ 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 kazakhstan_js_1 = require("../methods/kazakhstan.js");
 const registry_js_1 = require("./registry.js");
 const clock_js_1 = require("./clock.js");
 /**
@@ -35,14 +36,17 @@ function candidateInstants(place, year, month, day, asrShadow = 1, opts = {}) {
         case 'morocco':
         case 'algeria':
         case 'indonesia':
-        case 'turkiyetakvimi': {
+        case 'turkiyetakvimi':
+        case 'kazakhstan': {
             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)
-                    : 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 });
+                    : place.authority === 'kazakhstan'
+                        ? (0, kazakhstan_js_1.kazakhstanTimes)(place.lat, place.lon, year, month, day)
+                        : 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' | 'turkiyetakvimi';
+export type Authority = 'sweden' | 'diyanet' | 'morocco' | 'algeria' | 'indonesia' | 'turkiyetakvimi' | 'kazakhstan';
 export declare const AUTHORITIES: readonly Authority[];
 export type PrayerKey = 'fajr' | 'sunrise' | 'dhuhr' | 'asr' | 'maghrib' | 'isha';
 export declare const PRAYER_KEYS: readonly PrayerKey[];

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', 'turkiyetakvimi'];
+exports.AUTHORITIES = ['sweden', 'diyanet', 'morocco', 'algeria', 'indonesia', 'turkiyetakvimi', 'kazakhstan'];
 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/kazakhstanCertification.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/kazakhstanCertification.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const data = { "certified": true, "checkedAt": "2026-11-11", "places": 84, "checks": [{ "tables": "Kazakhstan — the Spiritual Administration’s times", "places": 84, "times": 551880, "off": 0, "offWithoutCorrections": 0, "from": "2025-01-01", "to": "2027-12-31" }], "corrections": { "from": "2025-01-01", "to": "2027-12-31", "entries": 0, "sha256": "e3d60e566ca082f74ce9904886087b29e65d2871c5bcc02f46349d82c8994d88" }, "revision": 1 };
+exports.default = data;

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

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

package/dist/cjs/data/generated/kazakhstanCities.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": 2, "name": "Қонаев", "lat": 43.883333, "lon": 77.083333 }, { "id": 3, "name": "Астана", "lat": 51.133333, "lon": 71.433333 }, { "id": 7, "name": "Орал", "lat": 51.204019, "lon": 51.370537 }, { "id": 17, "name": "Көкшетау", "lat": 53.291667, "lon": 69.391667 }, { "id": 18, "name": "Атырау", "lat": 47.116667, "lon": 51.883333 }, { "id": 20, "name": "Ақтөбе", "lat": 50.300377, "lon": 57.154555 }, { "id": 21, "name": "Степногорск", "lat": 52.346944, "lon": 71.881667 }, { "id": 22, "name": "Үшарал", "lat": 46.169722, "lon": 80.939444 }, { "id": 23, "name": "Атбасар", "lat": 51.815761, "lon": 68.358335 }, { "id": 24, "name": "Қандыағаш", "lat": 49.474444, "lon": 57.423333 }, { "id": 25, "name": "Хромтау", "lat": 50.250278, "lon": 58.434722 }, { "id": 26, "name": "Шалқар", "lat": 47.831392, "lon": 59.61929 }, { "id": 27, "name": "Құлсары", "lat": 46.983333, "lon": 54.016667 }, { "id": 29, "name": "Аягөз", "lat": 47.966667, "lon": 80.433333 }, { "id": 30, "name": "Өскемен", "lat": 49.948325, "lon": 82.627848 }, { "id": 31, "name": "Риддер", "lat": 50.33886, "lon": 83.506329 }, { "id": 32, "name": "Семей", "lat": 50.404976, "lon": 80.249235 }, { "id": 33, "name": "Жаңатас", "lat": 43.55465, "lon": 69.722525 }, { "id": 34, "name": "Қаратау", "lat": 43.166667, "lon": 70.466667 }, { "id": 35, "name": "Тараз", "lat": 42.883333, "lon": 71.366667 }, { "id": 36, "name": "Балқаш", "lat": 46.843721, "lon": 74.977301 }, { "id": 38, "name": "Жезқазған", "lat": 47.799711, "lon": 67.71409 }, { "id": 39, "name": "Қарағанды", "lat": 49.806406, "lon": 73.085485 }, { "id": 40, "name": "Сәтпаев", "lat": 47.907455, "lon": 67.528112 }, { "id": 41, "name": "Арқалық", "lat": 50.248611, "lon": 66.911389 }, { "id": 42, "name": "Қостанай", "lat": 53.219333, "lon": 63.634194 }, { "id": 43, "name": "Рудный", "lat": 52.966667, "lon": 63.116667 }, { "id": 46, "name": "Қызылорда", "lat": 44.842544, "lon": 65.502563 }, { "id": 47, "name": "Ақтау", "lat": 43.635379, "lon": 51.169135 }, { "id": 49, "name": "Форт-Шевченко", "lat": 44.507463, "lon": 50.262833 }, { "id": 50, "name": "Жаңаөзен", "lat": 43.343266, "lon": 52.865792 }, { "id": 51, "name": "Петропавл", "lat": 54.862222, "lon": 69.140833 }, { "id": 52, "name": "Екібастұз", "lat": 51.729778, "lon": 75.326583 }, { "id": 53, "name": "Павлодар", "lat": 52.315556, "lon": 76.956389 }, { "id": 54, "name": "Жетісай", "lat": 40.775278, "lon": 68.327222 }, { "id": 55, "name": "Сарыағаш", "lat": 41.466667, "lon": 69.166667 }, { "id": 56, "name": "Шардара", "lat": 41.254722, "lon": 67.969167 }, { "id": 57, "name": "Шымкент", "lat": 42.368009, "lon": 69.612769 }, { "id": 58, "name": "Түркістан", "lat": 43.302025, "lon": 68.268979 }, { "id": 59, "name": "Ақсай", "lat": 51.164945, "lon": 53.020868 }, { "id": 69, "name": "Лисаков", "lat": 52.544079, "lon": 62.492641 }, { "id": 70, "name": "Жаркент", "lat": 44.169365, "lon": 80.003842 }, { "id": 71, "name": "Арал", "lat": 46.797738, "lon": 61.660792 }, { "id": 72, "name": "Алматы", "lat": 43.238293, "lon": 76.945465 }, { "id": 73, "name": "Талғар", "lat": 43.302813, "lon": 77.23969 }, { "id": 75, "name": "Қаскелең", "lat": 43.202449, "lon": 76.622278 }, { "id": 77, "name": "Шу", "lat": 43.611782, "lon": 73.760237 }, { "id": 79, "name": "Қаражал", "lat": 48.001042, "lon": 70.785762 }, { "id": 82, "name": "Ленгер", "lat": 42.182051, "lon": 69.88212 }, { "id": 93, "name": "Ембі", "lat": 48.823344, "lon": 58.148397 }, { "id": 95, "name": "Зайсан", "lat": 47.453008, "lon": 84.969846 }, { "id": 100, "name": "Кентау", "lat": 43.518131, "lon": 68.504652 }, { "id": 103, "name": "Тайынша", "lat": 53.852738, "lon": 69.782631 }, { "id": 109, "name": "Теміртау", "lat": 50.058756, "lon": 72.953424 }, { "id": 112, "name": "Алға", "lat": 49.89673, "lon": 57.328586 }, { "id": 113, "name": "Ақсу", "lat": 52.03789, "lon": 76.920582 }, { "id": 128, "name": "Курчатов", "lat": 50.7549, "lon": 78.544826 }, { "id": 134, "name": "Арыс", "lat": 42.432744, "lon": 68.813798 }, { "id": 137, "name": "Қосшы", "lat": 50.970262, "lon": 71.355366 }, { "id": 143, "name": "Текелі", "lat": 44.863094, "lon": 78.764266 }, { "id": 146, "name": "Қарқаралы", "lat": 49.41224, "lon": 75.470095 }, { "id": 149, "name": "Шар", "lat": 49.584964, "lon": 81.047173 }, { "id": 150, "name": "Ақкөл", "lat": 51.995855, "lon": 70.952948 }, { "id": 151, "name": "Державинск", "lat": 51.098685, "lon": 66.314712 }, { "id": 152, "name": "Ерейментау", "lat": 51.619626, "lon": 73.102598 }, { "id": 153, "name": "Есіл", "lat": 51.958004, "lon": 66.406215 }, { "id": 154, "name": "Макинск", "lat": 52.63281, "lon": 70.417677 }, { "id": 155, "name": "Степняк", "lat": 52.832, "lon": 70.783427 }, { "id": 157, "name": "Жем", "lat": 48.774532, "lon": 58.072436 }, { "id": 158, "name": "Темір", "lat": 49.143142, "lon": 57.12633 }, { "id": 159, "name": "Алатау", "lat": 43.681261, "lon": 77.116046 }, { "id": 161, "name": "Сарқан", "lat": 45.413666, "lon": 79.916894 }, { "id": 162, "name": "Талдықорған", "lat": 45.017837, "lon": 78.382123 }, { "id": 163, "name": "Үштөбе", "lat": 45.251221, "lon": 77.980827 }, { "id": 165, "name": "Приозёрск", "lat": 46.028969, "lon": 73.708027 }, { "id": 166, "name": "Саран", "lat": 49.801993, "lon": 72.828387 }, { "id": 167, "name": "Шахтинск", "lat": 49.705868, "lon": 72.594637 }, { "id": 170, "name": "Қазалы", "lat": 45.760633, "lon": 62.105836 }, { "id": 171, "name": "Булаев", "lat": 54.896056, "lon": 70.448157 }, { "id": 172, "name": "Мамлют", "lat": 54.94112, "lon": 68.546199 }, { "id": 173, "name": "Сергеев", "lat": 53.888542, "lon": 67.416271 }, { "id": 174, "name": "Алтай", "lat": 49.725218, "lon": 84.273562 }, { "id": 175, "name": "Серебрянск", "lat": 49.679277, "lon": 83.300651 }, { "id": 176, "name": "Шемонаиха", "lat": 50.627624, "lon": 81.916697 }];
+exports.default = data;

package/dist/cjs/data/generated/kazakhstanCorrections.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/kazakhstanCorrections.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const data = { "from": "2025-01-01", "to": "2027-12-31", "points": {} };
+exports.default = data;

package/dist/cjs/index.d.ts

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

package/dist/cjs/index.js

@@ -33,6 +33,7 @@ require("./authorities/morocco.js");
 require("./authorities/algeria.js");
 require("./authorities/indonesia.js");
 require("./authorities/turkiyeTakvimi.js");
+require("./authorities/kazakhstan.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/kazakhstan.d.ts

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

package/dist/cjs/kazakhstan.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/kazakhstan — the Kazakhstan method with its places and correction list, and nothing else's. */
+require("./authorities/kazakhstan.js");
+__exportStar(require("./core/index.js"), exports);
+var kazakhstan_js_1 = require("./authorities/kazakhstan.js");
+Object.defineProperty(exports, "places", { enumerable: true, get: function () { return kazakhstan_js_1.places; } });

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

@@ -0,0 +1,58 @@
+/**
+ * Kazakhstan — the Spiritual Administration of Muslims of Kazakhstan's
+ * method, as the times it publishes for a place are computed.
+ *
+ * Read off its published year for places from 40.8° to 54.9° N:
+ *
+ *   • a short series for the sun: mean anomaly g and mean longitude q linear
+ *     in the days D from J2000.0, the ecliptic longitude
+ *     L = q + 1.915° sin g + 0.020° sin 2g, the obliquity 23.439° − 0.00000036° D,
+ *     and from them the declination and the equation of time;
+ *   • the day counted from 0h of the civil date at the place's own meridian
+ *     (the Julian day of the date less longitude/360);
+ *   • each time computed once, with the sun taken at a fixed first guess of
+ *     its hour (Fajr 5h, sunrise 6h, Dhuhr 12h, Asr 13h, sunset and Isha
+ *     18h), not iterated;
+ *   • Fajr and Isha at 15°; sunrise and sunset at −0.833°; Asr at two shadow
+ *     lengths beyond the noon shadow (Hanafi);
+ *   • where Fajr would fall more than a quarter of the night before sunrise,
+ *     or Isha more than a quarter of the night after sunset — or the sun does
+ *     not reach 15° — the quarter of the night is taken (the night from
+ *     sunset to sunrise);
+ *   • a margin of 3 minutes, 5 minutes from 48° N: sunrise that much
+ *     earlier, Dhuhr and Asr that much later, Maghrib that much after
+ *     sunset; none on Fajr or Isha;
+ *   • every time rounded to the nearest minute.
+ *
+ * With that the method gives every published time of the places read, with
+ * no correction list.
+ */
+export type KazakhstanInstants = {
+    fajr: Date;
+    sunrise: Date;
+    dhuhr: Date;
+    asr: Date;
+    maghrib: Date;
+    isha: Date;
+};
+/** The margin at a latitude, minutes. */
+export declare function kazakhstanMargin(latitude: number): number;
+/**
+ * The times before rounding, minutes past 00:00 UT of the civil date (month
+ * 0-based), and the sunset the method prints beside Maghrib.
+ */
+export declare function kazakhstanRawMinutes(latitude: number, longitude: number, year: number, month: number, day: number): {
+    fajr: number;
+    sunrise: number;
+    dhuhr: number;
+    asr: number;
+    sunset: number;
+    maghrib: number;
+    isha: number;
+};
+/**
+ * The Administration's times for the civil date (month 0-based) at the
+ * point, each on the minute it prints (rounded to the nearest); Asr is the
+ * Hanafi one its table carries. Null where a time does not form.
+ */
+export declare function kazakhstanTimes(latitude: number, longitude: number, year: number, month: number, day: number): KazakhstanInstants | null;

package/dist/cjs/methods/kazakhstan.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Kazakhstan — the Spiritual Administration of Muslims of Kazakhstan's
+ * method, as the times it publishes for a place are computed.
+ *
+ * Read off its published year for places from 40.8° to 54.9° N:
+ *
+ *   • a short series for the sun: mean anomaly g and mean longitude q linear
+ *     in the days D from J2000.0, the ecliptic longitude
+ *     L = q + 1.915° sin g + 0.020° sin 2g, the obliquity 23.439° − 0.00000036° D,
+ *     and from them the declination and the equation of time;
+ *   • the day counted from 0h of the civil date at the place's own meridian
+ *     (the Julian day of the date less longitude/360);
+ *   • each time computed once, with the sun taken at a fixed first guess of
+ *     its hour (Fajr 5h, sunrise 6h, Dhuhr 12h, Asr 13h, sunset and Isha
+ *     18h), not iterated;
+ *   • Fajr and Isha at 15°; sunrise and sunset at −0.833°; Asr at two shadow
+ *     lengths beyond the noon shadow (Hanafi);
+ *   • where Fajr would fall more than a quarter of the night before sunrise,
+ *     or Isha more than a quarter of the night after sunset — or the sun does
+ *     not reach 15° — the quarter of the night is taken (the night from
+ *     sunset to sunrise);
+ *   • a margin of 3 minutes, 5 minutes from 48° N: sunrise that much
+ *     earlier, Dhuhr and Asr that much later, Maghrib that much after
+ *     sunset; none on Fajr or Isha;
+ *   • every time rounded to the nearest minute.
+ *
+ * With that the method gives every published time of the places read, with
+ * no correction list.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kazakhstanMargin = kazakhstanMargin;
+exports.kazakhstanRawMinutes = kazakhstanRawMinutes;
+exports.kazakhstanTimes = kazakhstanTimes;
+const RAD = Math.PI / 180;
+const sin = (d) => Math.sin(d * RAD);
+const cos = (d) => Math.cos(d * RAD);
+const tan = (d) => Math.tan(d * RAD);
+/** a − b·⌊a/b⌋: into [0, b). */
+const fix = (a, b) => a - b * Math.floor(a / b);
+/** Fajr's and Isha's depression, degrees. */
+const TWILIGHT = 15;
+const HORIZON = 0.833;
+/** Shadow lengths beyond the noon shadow at Asr. */
+const ASR_SHADOW = 2;
+/** The latitude from which the margin is five minutes, not three. */
+const NORTH = 48;
+/** The first guess of each time's hour, at which its sun is taken. */
+const GUESS = { fajr: 5, sunrise: 6, dhuhr: 12, asr: 13, sunset: 18, isha: 18 };
+/** The Julian day of 0h UT of a civil date (month 1-based). */
+function julian(year, month, day) {
+    if (month <= 2) {
+        year -= 1;
+        month += 12;
+    }
+    const a = Math.floor(year / 100);
+    const b = 2 - a + Math.floor(a / 4);
+    return Math.floor(365.25 * (year + 4716)) + Math.floor(30.6001 * (month + 1)) + day + b - 1524.5;
+}
+/** The method's sun at a Julian day: declination (degrees), equation of time (hours). */
+function sunAt(jd) {
+    const D = jd - 2451545.0;
+    const g = fix(357.529 + 0.98560028 * D, 360);
+    const q = fix(280.459 + 0.98564736 * D, 360);
+    const L = fix(q + 1.915 * sin(g) + 0.02 * sin(2 * g), 360);
+    const e = 23.439 - 0.00000036 * D;
+    const ra = Math.atan2(cos(e) * sin(L), cos(L)) / RAD / 15;
+    return { decl: Math.asin(sin(e) * sin(L)) / RAD, eqt: q / 15 - fix(ra, 24) };
+}
+/** The margin at a latitude, minutes. */
+function kazakhstanMargin(latitude) {
+    return latitude >= NORTH ? 5 : 3;
+}
+/**
+ * The times before rounding, minutes past 00:00 UT of the civil date (month
+ * 0-based), and the sunset the method prints beside Maghrib.
+ */
+function kazakhstanRawMinutes(latitude, longitude, year, month, day) {
+    const jd = julian(year, month + 1, day) - longitude / 360;
+    const midday = (t) => fix(12 - sunAt(jd + t).eqt, 24);
+    /** Hours (local mean time) at which the sun is `angle` degrees below the horizon; NaN where it is not. */
+    const at = (angle, t, before) => {
+        const { decl } = sunAt(jd + t);
+        const x = (-sin(angle) - sin(decl) * sin(latitude)) / (cos(decl) * cos(latitude));
+        if (!(Math.abs(x) <= 1))
+            return NaN;
+        const h = Math.acos(x) / RAD / 15;
+        return midday(t) + (before ? -h : h);
+    };
+    const asrAngle = (t) => -Math.atan(1 / (ASR_SHADOW + tan(Math.abs(latitude - sunAt(jd + t).decl)))) / RAD;
+    let fajr = at(TWILIGHT, GUESS.fajr / 24, true);
+    const sunrise = at(HORIZON, GUESS.sunrise / 24, true);
+    const dhuhr = midday(GUESS.dhuhr / 24);
+    const asr = at(asrAngle(GUESS.asr / 24), GUESS.asr / 24, false);
+    const sunset = at(HORIZON, GUESS.sunset / 24, false);
+    let isha = at(TWILIGHT, GUESS.isha / 24, false);
+    // the quarter of the night, where the angle is further than that or is not reached
+    const portion = (TWILIGHT / 60) * fix(sunrise - sunset, 24);
+    if (!Number.isFinite(fajr) || fix(sunrise - fajr, 24) > portion)
+        fajr = sunrise - portion;
+    if (!Number.isFinite(isha) || fix(isha - sunset, 24) > portion)
+        isha = sunset + portion;
+    const margin = kazakhstanMargin(latitude);
+    // local mean time (hours) to minutes past 00:00 UT of the date
+    const ut = (h) => (h - longitude / 15) * 60;
+    return {
+        fajr: ut(fajr),
+        sunrise: ut(sunrise) - margin,
+        dhuhr: ut(dhuhr) + margin,
+        asr: ut(asr) + margin,
+        sunset: ut(sunset),
+        maghrib: ut(sunset) + margin,
+        isha: ut(isha),
+    };
+}
+/**
+ * The Administration's times for the civil date (month 0-based) at the
+ * point, each on the minute it prints (rounded to the nearest); Asr is the
+ * Hanafi one its table carries. Null where a time does not form.
+ */
+function kazakhstanTimes(latitude, longitude, year, month, day) {
+    const r = kazakhstanRawMinutes(latitude, longitude, year, month, day);
+    const all = [r.fajr, r.sunrise, r.dhuhr, r.asr, r.maghrib, r.isha];
+    if (!all.every(Number.isFinite))
+        return null;
+    const start = Date.UTC(year, month, day);
+    const at = (m) => new Date(start + Math.floor(m + 0.5) * 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/methods/revisions.d.ts

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

package/dist/cjs/methods/revisions.js

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

package/dist/esm/authorities/kazakhstan.d.ts

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

package/dist/esm/authorities/kazakhstan.js

@@ -0,0 +1,43 @@
+/**
+ * Kazakhstan — the Spiritual Administration of Muslims of Kazakhstan: its
+ * cities, each at the coordinates the Administration computes it at.
+ */
+import cities from '../data/generated/kazakhstanCities.js';
+import corrections from '../data/generated/kazakhstanCorrections.js';
+import certification from '../data/generated/kazakhstanCertification.js';
+import { METHOD_REVISION } from '../methods/revisions.js';
+import { registerAuthority } from '../core/registry.js';
+const AUTHORITY = 'kazakhstan';
+/** The whole country keeps UTC+5 (since 1 March 2024), and the Administration prints every place on it. */
+const TZ = 'Asia/Almaty';
+function buildPlaces() {
+    return cities.map(c => {
+        const key = String(c.id);
+        return { authority: AUTHORITY, id: `${AUTHORITY}:${key}`, key, name: c.name, country: 'KZ', lat: c.lat, lon: c.lon, tz: TZ };
+    });
+}
+export const kazakhstan = registerAuthority({
+    authority: AUTHORITY,
+    revision: METHOD_REVISION.kazakhstan,
+    places: buildPlaces(),
+    corrections,
+    certification,
+    description: {
+        name: 'Kazakhstan — Spiritual Administration of Muslims of Kazakhstan',
+        method: 'A short series for the sun, each time computed once from a fixed first guess of its hour; Fajr and Isha at 15°, capped at a quarter of the night from sunrise and sunset; sunrise and sunset at −0.833°; Asr at two shadow lengths (Hanafi); a margin of 3 minutes (5 from 48° N) before sunrise, after the transit, on Asr and on Maghrib after sunset; every time rounded to the nearest minute.',
+        countries: ['KZ'],
+        parameters: {
+            fajrAngle: 15,
+            ishaAngle: 15,
+            sunriseAltitude: -0.833,
+            asrShadow: 2,
+            highLatitude: 'a quarter of the night, where the angle is further or not reached',
+            marginMinutes: '3; 5 from 48° N — sunrise earlier, Dhuhr, Asr and Maghrib later',
+            rounding: 'to the nearest minute',
+            sun: 'low-precision series (mean elements linear in time, two terms of the equation of the centre), not iterated',
+        },
+        sources: [{ title: 'Spiritual Administration of Muslims of Kazakhstan — намаз уақыттары', url: 'https://namaz.muftyat.kz/' }],
+        spec: 'docs/methods.md#kazakhstan',
+    },
+});
+export const places = kazakhstan.places;

package/dist/esm/core/compute.js

@@ -9,6 +9,7 @@ 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 { kazakhstanTimes } from '../methods/kazakhstan.js';
 import { authorityData } from './registry.js';
 import { placeClockAt } from './clock.js';
 /**
@@ -32,14 +33,17 @@ export function candidateInstants(place, year, month, day, asrShadow = 1, opts =
         case 'morocco':
         case 'algeria':
         case 'indonesia':
-        case 'turkiyetakvimi': {
+        case 'turkiyetakvimi':
+        case 'kazakhstan': {
             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)
-                    : 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 });
+                    : place.authority === 'kazakhstan'
+                        ? kazakhstanTimes(place.lat, place.lon, year, month, day)
+                        : 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' | 'turkiyetakvimi';
+export type Authority = 'sweden' | 'diyanet' | 'morocco' | 'algeria' | 'indonesia' | 'turkiyetakvimi' | 'kazakhstan';
 export declare const AUTHORITIES: readonly Authority[];
 export type PrayerKey = 'fajr' | 'sunrise' | 'dhuhr' | 'asr' | 'maghrib' | 'isha';
 export declare const PRAYER_KEYS: readonly PrayerKey[];

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', 'turkiyetakvimi'];
+export const AUTHORITIES = ['sweden', 'diyanet', 'morocco', 'algeria', 'indonesia', 'turkiyetakvimi', 'kazakhstan'];
 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/kazakhstanCertification.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/kazakhstanCertification.js

@@ -0,0 +1,2 @@
+const data = { "certified": true, "checkedAt": "2026-11-11", "places": 84, "checks": [{ "tables": "Kazakhstan — the Spiritual Administration’s times", "places": 84, "times": 551880, "off": 0, "offWithoutCorrections": 0, "from": "2025-01-01", "to": "2027-12-31" }], "corrections": { "from": "2025-01-01", "to": "2027-12-31", "entries": 0, "sha256": "e3d60e566ca082f74ce9904886087b29e65d2871c5bcc02f46349d82c8994d88" }, "revision": 1 };
+export default data;

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

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

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

@@ -0,0 +1,3 @@
+// Generated by scripts/embed.mjs — do not edit; edit the JSON under data/ instead.
+const data = [{ "id": 2, "name": "Қонаев", "lat": 43.883333, "lon": 77.083333 }, { "id": 3, "name": "Астана", "lat": 51.133333, "lon": 71.433333 }, { "id": 7, "name": "Орал", "lat": 51.204019, "lon": 51.370537 }, { "id": 17, "name": "Көкшетау", "lat": 53.291667, "lon": 69.391667 }, { "id": 18, "name": "Атырау", "lat": 47.116667, "lon": 51.883333 }, { "id": 20, "name": "Ақтөбе", "lat": 50.300377, "lon": 57.154555 }, { "id": 21, "name": "Степногорск", "lat": 52.346944, "lon": 71.881667 }, { "id": 22, "name": "Үшарал", "lat": 46.169722, "lon": 80.939444 }, { "id": 23, "name": "Атбасар", "lat": 51.815761, "lon": 68.358335 }, { "id": 24, "name": "Қандыағаш", "lat": 49.474444, "lon": 57.423333 }, { "id": 25, "name": "Хромтау", "lat": 50.250278, "lon": 58.434722 }, { "id": 26, "name": "Шалқар", "lat": 47.831392, "lon": 59.61929 }, { "id": 27, "name": "Құлсары", "lat": 46.983333, "lon": 54.016667 }, { "id": 29, "name": "Аягөз", "lat": 47.966667, "lon": 80.433333 }, { "id": 30, "name": "Өскемен", "lat": 49.948325, "lon": 82.627848 }, { "id": 31, "name": "Риддер", "lat": 50.33886, "lon": 83.506329 }, { "id": 32, "name": "Семей", "lat": 50.404976, "lon": 80.249235 }, { "id": 33, "name": "Жаңатас", "lat": 43.55465, "lon": 69.722525 }, { "id": 34, "name": "Қаратау", "lat": 43.166667, "lon": 70.466667 }, { "id": 35, "name": "Тараз", "lat": 42.883333, "lon": 71.366667 }, { "id": 36, "name": "Балқаш", "lat": 46.843721, "lon": 74.977301 }, { "id": 38, "name": "Жезқазған", "lat": 47.799711, "lon": 67.71409 }, { "id": 39, "name": "Қарағанды", "lat": 49.806406, "lon": 73.085485 }, { "id": 40, "name": "Сәтпаев", "lat": 47.907455, "lon": 67.528112 }, { "id": 41, "name": "Арқалық", "lat": 50.248611, "lon": 66.911389 }, { "id": 42, "name": "Қостанай", "lat": 53.219333, "lon": 63.634194 }, { "id": 43, "name": "Рудный", "lat": 52.966667, "lon": 63.116667 }, { "id": 46, "name": "Қызылорда", "lat": 44.842544, "lon": 65.502563 }, { "id": 47, "name": "Ақтау", "lat": 43.635379, "lon": 51.169135 }, { "id": 49, "name": "Форт-Шевченко", "lat": 44.507463, "lon": 50.262833 }, { "id": 50, "name": "Жаңаөзен", "lat": 43.343266, "lon": 52.865792 }, { "id": 51, "name": "Петропавл", "lat": 54.862222, "lon": 69.140833 }, { "id": 52, "name": "Екібастұз", "lat": 51.729778, "lon": 75.326583 }, { "id": 53, "name": "Павлодар", "lat": 52.315556, "lon": 76.956389 }, { "id": 54, "name": "Жетісай", "lat": 40.775278, "lon": 68.327222 }, { "id": 55, "name": "Сарыағаш", "lat": 41.466667, "lon": 69.166667 }, { "id": 56, "name": "Шардара", "lat": 41.254722, "lon": 67.969167 }, { "id": 57, "name": "Шымкент", "lat": 42.368009, "lon": 69.612769 }, { "id": 58, "name": "Түркістан", "lat": 43.302025, "lon": 68.268979 }, { "id": 59, "name": "Ақсай", "lat": 51.164945, "lon": 53.020868 }, { "id": 69, "name": "Лисаков", "lat": 52.544079, "lon": 62.492641 }, { "id": 70, "name": "Жаркент", "lat": 44.169365, "lon": 80.003842 }, { "id": 71, "name": "Арал", "lat": 46.797738, "lon": 61.660792 }, { "id": 72, "name": "Алматы", "lat": 43.238293, "lon": 76.945465 }, { "id": 73, "name": "Талғар", "lat": 43.302813, "lon": 77.23969 }, { "id": 75, "name": "Қаскелең", "lat": 43.202449, "lon": 76.622278 }, { "id": 77, "name": "Шу", "lat": 43.611782, "lon": 73.760237 }, { "id": 79, "name": "Қаражал", "lat": 48.001042, "lon": 70.785762 }, { "id": 82, "name": "Ленгер", "lat": 42.182051, "lon": 69.88212 }, { "id": 93, "name": "Ембі", "lat": 48.823344, "lon": 58.148397 }, { "id": 95, "name": "Зайсан", "lat": 47.453008, "lon": 84.969846 }, { "id": 100, "name": "Кентау", "lat": 43.518131, "lon": 68.504652 }, { "id": 103, "name": "Тайынша", "lat": 53.852738, "lon": 69.782631 }, { "id": 109, "name": "Теміртау", "lat": 50.058756, "lon": 72.953424 }, { "id": 112, "name": "Алға", "lat": 49.89673, "lon": 57.328586 }, { "id": 113, "name": "Ақсу", "lat": 52.03789, "lon": 76.920582 }, { "id": 128, "name": "Курчатов", "lat": 50.7549, "lon": 78.544826 }, { "id": 134, "name": "Арыс", "lat": 42.432744, "lon": 68.813798 }, { "id": 137, "name": "Қосшы", "lat": 50.970262, "lon": 71.355366 }, { "id": 143, "name": "Текелі", "lat": 44.863094, "lon": 78.764266 }, { "id": 146, "name": "Қарқаралы", "lat": 49.41224, "lon": 75.470095 }, { "id": 149, "name": "Шар", "lat": 49.584964, "lon": 81.047173 }, { "id": 150, "name": "Ақкөл", "lat": 51.995855, "lon": 70.952948 }, { "id": 151, "name": "Державинск", "lat": 51.098685, "lon": 66.314712 }, { "id": 152, "name": "Ерейментау", "lat": 51.619626, "lon": 73.102598 }, { "id": 153, "name": "Есіл", "lat": 51.958004, "lon": 66.406215 }, { "id": 154, "name": "Макинск", "lat": 52.63281, "lon": 70.417677 }, { "id": 155, "name": "Степняк", "lat": 52.832, "lon": 70.783427 }, { "id": 157, "name": "Жем", "lat": 48.774532, "lon": 58.072436 }, { "id": 158, "name": "Темір", "lat": 49.143142, "lon": 57.12633 }, { "id": 159, "name": "Алатау", "lat": 43.681261, "lon": 77.116046 }, { "id": 161, "name": "Сарқан", "lat": 45.413666, "lon": 79.916894 }, { "id": 162, "name": "Талдықорған", "lat": 45.017837, "lon": 78.382123 }, { "id": 163, "name": "Үштөбе", "lat": 45.251221, "lon": 77.980827 }, { "id": 165, "name": "Приозёрск", "lat": 46.028969, "lon": 73.708027 }, { "id": 166, "name": "Саран", "lat": 49.801993, "lon": 72.828387 }, { "id": 167, "name": "Шахтинск", "lat": 49.705868, "lon": 72.594637 }, { "id": 170, "name": "Қазалы", "lat": 45.760633, "lon": 62.105836 }, { "id": 171, "name": "Булаев", "lat": 54.896056, "lon": 70.448157 }, { "id": 172, "name": "Мамлют", "lat": 54.94112, "lon": 68.546199 }, { "id": 173, "name": "Сергеев", "lat": 53.888542, "lon": 67.416271 }, { "id": 174, "name": "Алтай", "lat": 49.725218, "lon": 84.273562 }, { "id": 175, "name": "Серебрянск", "lat": 49.679277, "lon": 83.300651 }, { "id": 176, "name": "Шемонаиха", "lat": 50.627624, "lon": 81.916697 }];
+export default data;

package/dist/esm/data/generated/kazakhstanCorrections.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/kazakhstanCorrections.js

@@ -0,0 +1,2 @@
+const data = { "from": "2025-01-01", "to": "2027-12-31", "points": {} };
+export default data;

package/dist/esm/index.d.ts

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

package/dist/esm/index.js

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

package/dist/esm/kazakhstan.d.ts

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

package/dist/esm/kazakhstan.js

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

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

@@ -0,0 +1,58 @@
+/**
+ * Kazakhstan — the Spiritual Administration of Muslims of Kazakhstan's
+ * method, as the times it publishes for a place are computed.
+ *
+ * Read off its published year for places from 40.8° to 54.9° N:
+ *
+ *   • a short series for the sun: mean anomaly g and mean longitude q linear
+ *     in the days D from J2000.0, the ecliptic longitude
+ *     L = q + 1.915° sin g + 0.020° sin 2g, the obliquity 23.439° − 0.00000036° D,
+ *     and from them the declination and the equation of time;
+ *   • the day counted from 0h of the civil date at the place's own meridian
+ *     (the Julian day of the date less longitude/360);
+ *   • each time computed once, with the sun taken at a fixed first guess of
+ *     its hour (Fajr 5h, sunrise 6h, Dhuhr 12h, Asr 13h, sunset and Isha
+ *     18h), not iterated;
+ *   • Fajr and Isha at 15°; sunrise and sunset at −0.833°; Asr at two shadow
+ *     lengths beyond the noon shadow (Hanafi);
+ *   • where Fajr would fall more than a quarter of the night before sunrise,
+ *     or Isha more than a quarter of the night after sunset — or the sun does
+ *     not reach 15° — the quarter of the night is taken (the night from
+ *     sunset to sunrise);
+ *   • a margin of 3 minutes, 5 minutes from 48° N: sunrise that much
+ *     earlier, Dhuhr and Asr that much later, Maghrib that much after
+ *     sunset; none on Fajr or Isha;
+ *   • every time rounded to the nearest minute.
+ *
+ * With that the method gives every published time of the places read, with
+ * no correction list.
+ */
+export type KazakhstanInstants = {
+    fajr: Date;
+    sunrise: Date;
+    dhuhr: Date;
+    asr: Date;
+    maghrib: Date;
+    isha: Date;
+};
+/** The margin at a latitude, minutes. */
+export declare function kazakhstanMargin(latitude: number): number;
+/**
+ * The times before rounding, minutes past 00:00 UT of the civil date (month
+ * 0-based), and the sunset the method prints beside Maghrib.
+ */
+export declare function kazakhstanRawMinutes(latitude: number, longitude: number, year: number, month: number, day: number): {
+    fajr: number;
+    sunrise: number;
+    dhuhr: number;
+    asr: number;
+    sunset: number;
+    maghrib: number;
+    isha: number;
+};
+/**
+ * The Administration's times for the civil date (month 0-based) at the
+ * point, each on the minute it prints (rounded to the nearest); Asr is the
+ * Hanafi one its table carries. Null where a time does not form.
+ */
+export declare function kazakhstanTimes(latitude: number, longitude: number, year: number, month: number, day: number): KazakhstanInstants | null;

package/dist/esm/methods/kazakhstan.js

@@ -0,0 +1,124 @@
+/**
+ * Kazakhstan — the Spiritual Administration of Muslims of Kazakhstan's
+ * method, as the times it publishes for a place are computed.
+ *
+ * Read off its published year for places from 40.8° to 54.9° N:
+ *
+ *   • a short series for the sun: mean anomaly g and mean longitude q linear
+ *     in the days D from J2000.0, the ecliptic longitude
+ *     L = q + 1.915° sin g + 0.020° sin 2g, the obliquity 23.439° − 0.00000036° D,
+ *     and from them the declination and the equation of time;
+ *   • the day counted from 0h of the civil date at the place's own meridian
+ *     (the Julian day of the date less longitude/360);
+ *   • each time computed once, with the sun taken at a fixed first guess of
+ *     its hour (Fajr 5h, sunrise 6h, Dhuhr 12h, Asr 13h, sunset and Isha
+ *     18h), not iterated;
+ *   • Fajr and Isha at 15°; sunrise and sunset at −0.833°; Asr at two shadow
+ *     lengths beyond the noon shadow (Hanafi);
+ *   • where Fajr would fall more than a quarter of the night before sunrise,
+ *     or Isha more than a quarter of the night after sunset — or the sun does
+ *     not reach 15° — the quarter of the night is taken (the night from
+ *     sunset to sunrise);
+ *   • a margin of 3 minutes, 5 minutes from 48° N: sunrise that much
+ *     earlier, Dhuhr and Asr that much later, Maghrib that much after
+ *     sunset; none on Fajr or Isha;
+ *   • every time rounded to the nearest minute.
+ *
+ * With that the method gives every published time of the places read, with
+ * no correction list.
+ */
+const RAD = Math.PI / 180;
+const sin = (d) => Math.sin(d * RAD);
+const cos = (d) => Math.cos(d * RAD);
+const tan = (d) => Math.tan(d * RAD);
+/** a − b·⌊a/b⌋: into [0, b). */
+const fix = (a, b) => a - b * Math.floor(a / b);
+/** Fajr's and Isha's depression, degrees. */
+const TWILIGHT = 15;
+const HORIZON = 0.833;
+/** Shadow lengths beyond the noon shadow at Asr. */
+const ASR_SHADOW = 2;
+/** The latitude from which the margin is five minutes, not three. */
+const NORTH = 48;
+/** The first guess of each time's hour, at which its sun is taken. */
+const GUESS = { fajr: 5, sunrise: 6, dhuhr: 12, asr: 13, sunset: 18, isha: 18 };
+/** The Julian day of 0h UT of a civil date (month 1-based). */
+function julian(year, month, day) {
+    if (month <= 2) {
+        year -= 1;
+        month += 12;
+    }
+    const a = Math.floor(year / 100);
+    const b = 2 - a + Math.floor(a / 4);
+    return Math.floor(365.25 * (year + 4716)) + Math.floor(30.6001 * (month + 1)) + day + b - 1524.5;
+}
+/** The method's sun at a Julian day: declination (degrees), equation of time (hours). */
+function sunAt(jd) {
+    const D = jd - 2451545.0;
+    const g = fix(357.529 + 0.98560028 * D, 360);
+    const q = fix(280.459 + 0.98564736 * D, 360);
+    const L = fix(q + 1.915 * sin(g) + 0.02 * sin(2 * g), 360);
+    const e = 23.439 - 0.00000036 * D;
+    const ra = Math.atan2(cos(e) * sin(L), cos(L)) / RAD / 15;
+    return { decl: Math.asin(sin(e) * sin(L)) / RAD, eqt: q / 15 - fix(ra, 24) };
+}
+/** The margin at a latitude, minutes. */
+export function kazakhstanMargin(latitude) {
+    return latitude >= NORTH ? 5 : 3;
+}
+/**
+ * The times before rounding, minutes past 00:00 UT of the civil date (month
+ * 0-based), and the sunset the method prints beside Maghrib.
+ */
+export function kazakhstanRawMinutes(latitude, longitude, year, month, day) {
+    const jd = julian(year, month + 1, day) - longitude / 360;
+    const midday = (t) => fix(12 - sunAt(jd + t).eqt, 24);
+    /** Hours (local mean time) at which the sun is `angle` degrees below the horizon; NaN where it is not. */
+    const at = (angle, t, before) => {
+        const { decl } = sunAt(jd + t);
+        const x = (-sin(angle) - sin(decl) * sin(latitude)) / (cos(decl) * cos(latitude));
+        if (!(Math.abs(x) <= 1))
+            return NaN;
+        const h = Math.acos(x) / RAD / 15;
+        return midday(t) + (before ? -h : h);
+    };
+    const asrAngle = (t) => -Math.atan(1 / (ASR_SHADOW + tan(Math.abs(latitude - sunAt(jd + t).decl)))) / RAD;
+    let fajr = at(TWILIGHT, GUESS.fajr / 24, true);
+    const sunrise = at(HORIZON, GUESS.sunrise / 24, true);
+    const dhuhr = midday(GUESS.dhuhr / 24);
+    const asr = at(asrAngle(GUESS.asr / 24), GUESS.asr / 24, false);
+    const sunset = at(HORIZON, GUESS.sunset / 24, false);
+    let isha = at(TWILIGHT, GUESS.isha / 24, false);
+    // the quarter of the night, where the angle is further than that or is not reached
+    const portion = (TWILIGHT / 60) * fix(sunrise - sunset, 24);
+    if (!Number.isFinite(fajr) || fix(sunrise - fajr, 24) > portion)
+        fajr = sunrise - portion;
+    if (!Number.isFinite(isha) || fix(isha - sunset, 24) > portion)
+        isha = sunset + portion;
+    const margin = kazakhstanMargin(latitude);
+    // local mean time (hours) to minutes past 00:00 UT of the date
+    const ut = (h) => (h - longitude / 15) * 60;
+    return {
+        fajr: ut(fajr),
+        sunrise: ut(sunrise) - margin,
+        dhuhr: ut(dhuhr) + margin,
+        asr: ut(asr) + margin,
+        sunset: ut(sunset),
+        maghrib: ut(sunset) + margin,
+        isha: ut(isha),
+    };
+}
+/**
+ * The Administration's times for the civil date (month 0-based) at the
+ * point, each on the minute it prints (rounded to the nearest); Asr is the
+ * Hanafi one its table carries. Null where a time does not form.
+ */
+export function kazakhstanTimes(latitude, longitude, year, month, day) {
+    const r = kazakhstanRawMinutes(latitude, longitude, year, month, day);
+    const all = [r.fajr, r.sunrise, r.dhuhr, r.asr, r.maghrib, r.isha];
+    if (!all.every(Number.isFinite))
+        return null;
+    const start = Date.UTC(year, month, day);
+    const at = (m) => new Date(start + Math.floor(m + 0.5) * 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/methods/revisions.d.ts

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

package/dist/esm/methods/revisions.js

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

package/docs/methods.md

@@ -240,6 +240,35 @@ cities.
 - 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.
 
+## Kazakhstan
+
+`src/methods/kazakhstan.ts`. The Spiritual Administration of Muslims of
+Kazakhstan's times, read off its cities from 40.8° to 54.9° N.
+
+- A **short series for the sun**: the mean anomaly `g = 357.529° + 0.98560028° D`
+  and the mean longitude `q = 280.459° + 0.98564736° D`, with `D` the days
+  from J2000.0; the ecliptic longitude `L = q + 1.915° sin g + 0.020° sin 2g`;
+  the obliquity `23.439° − 0.00000036° D`; the declination and the equation
+  of time from those.
+- The day is counted from **0h of the civil date at the place's own
+  meridian**: the Julian day of the date less `longitude / 360`.
+- Each time is computed **once**, with the sun taken at a fixed first guess
+  of its hour — Fajr 5h, sunrise 6h, Dhuhr 12h, Asr 13h, sunset and Isha
+  18h — and not iterated.
+- **Fajr** and **Isha**: the sun 15° below the horizon.
+- **Sunrise** and sunset: the sun 0.833° below the horizon.
+- **Asr**: two shadow lengths beyond the noon shadow (Hanafi), the one Asr
+  the Administration prints.
+- **Where Fajr would fall more than a quarter of the night before sunrise,
+  or Isha more than a quarter of the night after sunset** — or the sun does
+  not reach 15° — the quarter of the night is taken, the night being from
+  sunset to sunrise.
+- A **margin** of 3 minutes, 5 minutes from 48° N: sunrise that much
+  earlier, Dhuhr and Asr that much later, Maghrib that much after sunset.
+  None on Fajr or Isha.
+- Every time rounded to the **nearest** minute.
+- The whole country is on UTC+5, and every place is printed on it.
+
 ## 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.4.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.",
+  "version": "1.5.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, Kazakhstan (Spiritual Administration).",
   "license": "MPL-2.0",
   "author": "Hassan El Ghamri",
   "repository": {
@@ -29,6 +29,7 @@
     "./dist/*/algeria.js",
     "./dist/*/indonesia.js",
     "./dist/*/turkiyetakvimi.js",
+    "./dist/*/kazakhstan.js",
     "./dist/*/authorities/*.js",
     "./src/index.ts",
     "./src/sweden.ts",
@@ -37,6 +38,7 @@
     "./src/algeria.ts",
     "./src/indonesia.ts",
     "./src/turkiyetakvimi.ts",
+    "./src/kazakhstan.ts",
     "./src/authorities/*.ts"
   ],
   "engines": {
@@ -133,6 +135,16 @@
         "default": "./dist/cjs/turkiyetakvimi.js"
       }
     },
+    "./kazakhstan": {
+      "import": {
+        "types": "./dist/esm/kazakhstan.d.ts",
+        "default": "./dist/esm/kazakhstan.js"
+      },
+      "require": {
+        "types": "./dist/cjs/kazakhstan.d.ts",
+        "default": "./dist/cjs/kazakhstan.js"
+      }
+    },
     "./locate": {
       "import": {
         "types": "./dist/esm/locate.d.ts",
@@ -171,6 +183,9 @@
       "turkiyetakvimi": [
         "./dist/cjs/turkiyetakvimi.d.ts"
       ],
+      "kazakhstan": [
+        "./dist/cjs/kazakhstan.d.ts"
+      ],
       "locate": [
         "./dist/cjs/locate.d.ts"
       ]

package/schemas/certification.schema.json

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