@zemendev/calendar 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,179 @@
1
- # Temporary Holding Version
1
+ <p align="center">
2
+ <img src="https://zemen-universal-ethiopian-gregorian.vercel.app/icon-192.png" width="96" height="96" alt="Zemen Calendar Logo" />
3
+ </p>
2
4
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
5
+ # @zemendev/calendar
6
+
7
+ Liturgical computus engine implementing ancient Bahire Hasab (ባሕረ ሃሳብ), Orthodox Tewahedo fasting seasons, 365-day Synaxarium (ስንክሳር) daily saints commemorations, and Ethiopian Islamic holiday calculations.
8
+
9
+ [![npm version](https://img.shields.io/npm/v/@zemendev/calendar.svg)](https://www.npmjs.com/package/@zemendev/calendar)
10
+ [![bundle size](https://img.shields.io/bundlephobia/minzip/@zemendev/calendar.svg)](https://bundlephobia.com/package/@zemendev/calendar)
11
+
12
+ Official Documentation & Interactive Computus Inspector:
13
+ https://zemen-universal-ethiopian-gregorian.vercel.app/docs/liturgical
14
+
15
+ ---
16
+
17
+ ## Technical Overview
18
+
19
+ The Ethiopian Orthodox Tewahedo Church computus system, known as **Bahire Hasab** (literally *"Sea of Computus"*), was formulated by Demetrius, 12th Patriarch of Alexandria. It determines the movable Christian feasts across centuries based on:
20
+
21
+ 1. **Amete Alem (ዓመተ ዓለም)**: Solar years elapsed from the Annus Mundi creation epoch (5500 BC + Ethiopian year).
22
+ 2. **The 19-Year Metonic Lunar Cycle**: Reconciling the 365.25-day solar year with 29.53-day lunar synodic months via *Wenber* (Golden Number), *Abektie* (lunar epact), and *Metqi* (Paschal full moon day).
23
+ 3. **The 28-Year Solar Cycle**: Determining the weekday of Ethiopian New Year (1 Meskerem) and ruling Evangelist (0 = John, 1 = Matthew, 2 = Mark, 3 = Luke).
24
+ 4. **The Nineveh Anchor**: All 11 movable feasts are mathematically derived as continuous day offsets from the Fast of Nineveh (*Tsome Nenewe*).
25
+
26
+ `@zemendev/calendar` provides a tested TypeScript implementation of these ancient astronomical algorithms, alongside full fasting rules and Synaxarium datasets.
27
+
28
+ ---
29
+
30
+ ## Installation
31
+
32
+ ```bash
33
+ npm install @zemendev/calendar @zemendev/core
34
+ ```
35
+
36
+ ---
37
+
38
+ ## API Reference & Usage Examples
39
+
40
+ ### 1. Bahire Hasab Computus Calculation
41
+
42
+ Computes astronomical constants, ruling evangelist, and all 11 movable feasts for any Ethiopian calendar year:
43
+
44
+ ```typescript
45
+ import { calculateBahireHasab } from '@zemendev/calendar';
46
+
47
+ const bh = calculateBahireHasab(2017);
48
+
49
+ // Astronomical & Calendar Markers
50
+ console.log('Amete Alem:', bh.ameteAlem); // 7517
51
+ console.log('Ruling Evangelist:', bh.evangelist); // { index: 1, name: { amharic: 'ማቴዎስ', english: 'Matthew' } }
52
+ console.log('New Year Day:', bh.newYearDay); // { index: 3, name: { amharic: 'ረቡዕ', english: 'Wednesday' } }
53
+ console.log('Wenber (Golden Number):', bh.wenber); // 16
54
+ console.log('Abektie (Moon Age):', bh.abektie); // 18
55
+ console.log('Metqi (Paschal Moon):', bh.metqi); // 12
56
+ console.log('Nineveh Anchor Date:', bh.nineveh); // { year: 2017, month: 6, day: 3 } (Yekatit 3, 2017 EC)
57
+
58
+ // Accessing the 11 Movable Feasts
59
+ console.log(bh.feasts.abiyTsome.ethiopian); // { year: 2017, month: 6, day: 17 } (Great Lent)
60
+ console.log(bh.feasts.debreZeit.ethiopian); // { year: 2017, month: 7, day: 14 } (Mount of Olives)
61
+ console.log(bh.feasts.hosanna.ethiopian); // { year: 2017, month: 8, day: 5 } (Palm Sunday)
62
+ console.log(bh.feasts.siklet.ethiopian); // { year: 2017, month: 8, day: 10 } (Good Friday)
63
+ console.log(bh.feasts.fasika.ethiopian); // { year: 2017, month: 8, day: 12 } (Easter Sunday)
64
+ console.log(bh.feasts.erget.ethiopian); // { year: 2017, month: 9, day: 21 } (Ascension)
65
+ console.log(bh.feasts.paraclete.ethiopian); // { year: 2017, month: 10, day: 2 } (Pentecost)
66
+ ```
67
+
68
+ ### Movable Feasts Offset Map
69
+
70
+ All movable feasts are anchored to the Monday of the Fast of Nineveh (`offset = 0`):
71
+
72
+ | Feast Key | Offset | Amharic Name | English Name | Feast Category |
73
+ | :--- | :---: | :--- | :--- | :--- |
74
+ | `nineveh` | `+0` | ጾመ ነነዌ | Fast of Nineveh | Obligatory Fasting (3 Days) |
75
+ | `abiyTsome` | `+14` | ዓቢይ ጾም (ሁዳዴ) | Great Lent | Obligatory Fasting (55 Days) |
76
+ | `debreZeit` | `+41` | ደብረ ዘይት | Mount of Olives | Mid-Lent Sunday |
77
+ | `hosanna` | `+62` | ሆሣዕና | Palm Sunday | Major Feast |
78
+ | `siklet` | `+67` | ስቅለት | Good Friday | Fasting & Public Holiday |
79
+ | `fasika` | `+69` | ትንሣኤ (ፋሲካ) | Easter Sunday | Major Public Holiday |
80
+ | `rikbeKahnat` | `+93` | ርክበ ካህናት | Synod of Priests | Liturgical Wednesday |
81
+ | `erget` | `+108` | ዕርገት | Ascension of Christ | Liturgical Thursday (40 days post-Easter) |
82
+ | `paraclete` | `+118` | ጰራቅሊጦስ | Pentecost | Liturgical Sunday (50 days post-Easter) |
83
+ | `tsomeHawaryat` | `+119` | ጾመ ሐዋርያት | Apostles Fast | Fasting Season (begins post-Pentecost) |
84
+ | `tsomeDihenet` | `+121` | ጾመ ድኅነት | Salvation Fast | Wednesday & Friday Obligatory Fasts |
85
+
86
+ *(Both `debreZeit` / `debrefeyit` and `paraclete` / `paraklitos` aliases are supported).*
87
+
88
+ ---
89
+
90
+ ### 2. Fasting Seasons Detection
91
+
92
+ Evaluates whether any given Ethiopian date is an obligatory or voluntary fasting day:
93
+
94
+ ```typescript
95
+ import { isFastingDay, getActiveFastingPeriod, getFastingPeriod } from '@zemendev/calendar';
96
+
97
+ const testDate = { year: 2017, month: 7, day: 10 }; // Megabit 10, 2017 EC (During Great Lent)
98
+
99
+ const status = isFastingDay(testDate);
100
+ console.log(status.isFasting); // true
101
+ console.log(status.reason); // "ዓቢይ ጾም (ሁዳዴ) - Great Lent"
102
+
103
+ const activePeriod = getActiveFastingPeriod(testDate);
104
+ console.log(activePeriod?.name.english); // "Great Lent"
105
+ console.log(activePeriod?.totalDays); // 55
106
+ console.log(activePeriod?.start); // { year: 2017, month: 6, day: 17 }
107
+ console.log(activePeriod?.end); // { year: 2017, month: 8, day: 11 }
108
+ ```
109
+
110
+ ### 3. Daily Synaxarium Saints Commemorations
111
+
112
+ Provides the Ethiopian Orthodox Church calendar of daily commemorations across the 30-day monthly cycle, with major annual feast (*Negs*) verification:
113
+
114
+ ```typescript
115
+ import { getDailySaints, isMajorAnnualFeast } from '@zemendev/calendar';
116
+
117
+ // Get saints commemorated on the 21st day of every Ethiopian month (St. Mary / ድንግል ማርያም)
118
+ const daySaints = getDailySaints(21);
119
+ console.log(daySaints.map(s => s.name.amharic));
120
+ // ["እግዝእትነ ማርያም", ...]
121
+
122
+ // Check if a specific date is celebrated as a major annual feast (Negs)
123
+ // Hidar 21 is the major annual feast of Saint Mary (ጽዮን ማርያም)
124
+ const hidar21 = { year: 2017, month: 3, day: 21 };
125
+ console.log(isMajorAnnualFeast(hidar21)); // true
126
+ ```
127
+
128
+ ### 4. Ethiopian National Islamic Holidays
129
+
130
+ Calculates approximate dates for the major national Islamic holidays recognized as official Ethiopian public holidays:
131
+
132
+ ```typescript
133
+ import { getIslamicHolidaysForYear } from '@zemendev/calendar';
134
+
135
+ const islamicHolidays = getIslamicHolidaysForYear(2017);
136
+ console.log(islamicHolidays);
137
+ // [
138
+ // { key: 'eid_al_fitr', name: { amharic: 'ዒድ አል ፈጥር', english: 'Eid al-Fitr' }, ethiopian: { year: 2017, month: 7, day: 22 } },
139
+ // { key: 'eid_al_adha', name: { amharic: 'ዒድ አል አድሃ (አረፋ)', english: 'Eid al-Adha (Arefa)' }, ethiopian: { year: 2017, month: 10, day: 29 } },
140
+ // { key: 'mawlid', name: { amharic: 'መውሊድ', english: 'Mawlid al-Nabi' }, ethiopian: { year: 2017, month: 1, day: 5 } }
141
+ // ]
142
+ ```
143
+
144
+ ---
145
+
146
+ ## TypeScript Definitions
147
+
148
+ ```typescript
149
+ export interface LiturgicalHoliday {
150
+ key: string;
151
+ name: { amharic: string; english: string };
152
+ ethiopian: EthiopianDate;
153
+ gregorian: GregorianDate;
154
+ movable: boolean;
155
+ tags: string[];
156
+ }
157
+
158
+ export interface SaintCommemoration {
159
+ id: string;
160
+ name: { amharic: string; english: string };
161
+ description: { amharic: string; english: string };
162
+ major: boolean;
163
+ negs: number[]; // Months in which celebrated as major annual feast
164
+ }
165
+ ```
166
+
167
+ ---
168
+
169
+ ## Upstream Foundations & Acknowledgements
170
+
171
+ The computus formulas and liturgical algorithms implemented in this package are founded on:
172
+
173
+ - **[kenat (ቀናት)](https://github.com/MelakuDemeke/kenat)** by Melaku Demeke: Foundational Bahire Hasab computus formulas and liturgical date arithmetic.
174
+
175
+ ---
176
+
177
+ ## License
178
+
179
+ Copyright (c) 2026 Besufkad Mekonnen. All rights reserved. Private and proprietary.
@@ -0,0 +1,80 @@
1
+ import type { EthiopianDate, GregorianDate } from "@zemendev/core";
2
+ /**
3
+ * Represents a liturgical holiday or movable feast in the Ethiopian Orthodox calendar.
4
+ */
5
+ export interface LiturgicalHoliday {
6
+ /** Unique identifying slug (e.g. 'nineveh', 'fasika', 'siklet') */
7
+ key: string;
8
+ /** Bilingual name in Amharic and English */
9
+ name: {
10
+ amharic: string;
11
+ english: string;
12
+ };
13
+ /** Computed date in the Ethiopian calendar */
14
+ ethiopian: EthiopianDate;
15
+ /** Converted date in the Gregorian calendar */
16
+ gregorian: GregorianDate;
17
+ /** Whether this is a movable feast calculated via computus */
18
+ movable: boolean;
19
+ /** Categorization tags (e.g. ['religious', 'christian', 'fasting']) */
20
+ tags: string[];
21
+ }
22
+ /**
23
+ * Complete computus result containing all 11 movable feasts, evangelist, and astronomical markers
24
+ * calculated via Bahire Hasab (ባሕረ ሃሳብ) for an Ethiopian year.
25
+ */
26
+ export interface BahireHasabResult {
27
+ /** The input Ethiopian calendar year */
28
+ year: number;
29
+ /** Amete Alem (ዓመተ ዓለም): Solar years from Creation (5500 + EC year) */
30
+ ameteAlem: number;
31
+ /** Metene Rabiet (መጠነ ራብዒት): Leap year multiplier */
32
+ meteneRabiet: number;
33
+ /** The ruling Evangelist of the year (0 = John, 1 = Matthew, 2 = Mark, 3 = Luke) */
34
+ evangelist: {
35
+ index: number;
36
+ name: {
37
+ amharic: string;
38
+ english: string;
39
+ };
40
+ };
41
+ /** Weekday of Ethiopian New Year (1 Meskerem) */
42
+ newYearDay: {
43
+ index: number;
44
+ name: {
45
+ amharic: string;
46
+ english: string;
47
+ };
48
+ };
49
+ /** Metonic 19-year lunar cycle remainder */
50
+ medeb: number;
51
+ /** Wenber (ወንበር): Golden number within the Metonic cycle */
52
+ wenber: number;
53
+ /** Abektie (አበቅቴ): Age of the moon on Meskerem 1 */
54
+ abektie: number;
55
+ /** Metqi (መጥቅዕ): Day of the Paschal new moon */
56
+ metqi: number;
57
+ /** Beale Metqi feast anchor date */
58
+ bealeMetqi: EthiopianDate;
59
+ /** Nineveh Fast anchor date (all other movable feasts are offsets of this date) */
60
+ nineveh: EthiopianDate;
61
+ /** Map of all 11 calculated movable feasts and fasts of the liturgical year */
62
+ feasts: Record<string, LiturgicalHoliday>;
63
+ }
64
+ /**
65
+ * Calculates Bahire Hasab (ባሕረ ሃሳብ) liturgical calculations for a given Ethiopian year.
66
+ * Computes all 11 movable feasts, lunar parameters, evangelist, and fasting seasons.
67
+ *
68
+ * @param ethiopianYear The Ethiopian calendar year (e.g. 2017)
69
+ * @returns Complete BahireHasabResult object
70
+ * @example
71
+ * ```ts
72
+ * import { calculateBahireHasab } from '@zemendev/calendar';
73
+ *
74
+ * const computus = calculateBahireHasab(2017);
75
+ * console.log(computus.evangelist.name.english); // Luke
76
+ * console.log(computus.feasts.fasika.ethiopian); // Easter date
77
+ * ```
78
+ */
79
+ export declare function calculateBahireHasab(ethiopianYear: number): BahireHasabResult;
80
+ //# sourceMappingURL=bahireHasab.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bahireHasab.d.ts","sourceRoot":"","sources":["../src/bahireHasab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGnE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,8CAA8C;IAC9C,SAAS,EAAE,aAAa,CAAC;IACzB,+CAA+C;IAC/C,SAAS,EAAE,aAAa,CAAC;IACzB,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC1E,iDAAiD;IACjD,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC1E,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,UAAU,EAAE,aAAa,CAAC;IAC1B,mFAAmF;IACnF,OAAO,EAAE,aAAa,CAAC;IACvB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC3C;AAqGD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,CA2E7E"}
@@ -0,0 +1,175 @@
1
+ import { addDays, toGregorian, getEthiopianWeekday } from "@zemendev/core";
2
+ const EVANGELISTS = [
3
+ { amharic: "ዮሐንስ", english: "John" },
4
+ { amharic: "ማቴዎስ", english: "Matthew" },
5
+ { amharic: "ማርቆስ", english: "Mark" },
6
+ { amharic: "ሉቃስ", english: "Luke" },
7
+ ];
8
+ const WEEKDAY_NAMES = [
9
+ { amharic: "እሁድ", english: "Sunday" },
10
+ { amharic: "ሰኞ", english: "Monday" },
11
+ { amharic: "ማክሰኞ", english: "Tuesday" },
12
+ { amharic: "ረቡዕ", english: "Wednesday" },
13
+ { amharic: "ሐሙስ", english: "Thursday" },
14
+ { amharic: "ዓርብ", english: "Friday" },
15
+ { amharic: "ቅዳሜ", english: "Saturday" },
16
+ ];
17
+ // Weekday offset for Beale Metqi (Sunday = 7 .. Saturday = 8)
18
+ const TEWSAK_MAP = {
19
+ 0: 7, // Sun
20
+ 1: 6, // Mon
21
+ 2: 5, // Tue
22
+ 3: 4, // Wed
23
+ 4: 3, // Thu
24
+ 5: 2, // Fri
25
+ 6: 8, // Sat
26
+ };
27
+ const MOVABLE_FEAST_OFFSETS = {
28
+ nineveh: {
29
+ offset: 0,
30
+ name: { amharic: "ጾመ ነነዌ", english: "Fast of Nineveh" },
31
+ tags: ["religious", "christian", "fasting"],
32
+ },
33
+ abiyTsome: {
34
+ offset: 14,
35
+ name: { amharic: "ዓቢይ ጾም", english: "Great Lent (Abiy Tsome)" },
36
+ tags: ["religious", "christian", "fasting"],
37
+ },
38
+ debrefeyit: {
39
+ offset: 41,
40
+ name: { amharic: "ደብረ ዘይት", english: "Mount of Olives" },
41
+ tags: ["religious", "christian"],
42
+ },
43
+ debreZeit: {
44
+ offset: 41,
45
+ name: { amharic: "ደብረ ዘይት", english: "Mount of Olives" },
46
+ tags: ["religious", "christian"],
47
+ },
48
+ hosanna: {
49
+ offset: 62,
50
+ name: { amharic: "ሆሣዕና", english: "Palm Sunday (Hosanna)" },
51
+ tags: ["religious", "christian"],
52
+ },
53
+ siklet: {
54
+ offset: 67,
55
+ name: { amharic: "ስቅለት", english: "Good Friday (Siklet)" },
56
+ tags: ["religious", "christian", "public"],
57
+ },
58
+ fasika: {
59
+ offset: 69,
60
+ name: { amharic: "ትንሣኤ (ፋሲካ)", english: "Easter (Fasika)" },
61
+ tags: ["religious", "christian", "public"],
62
+ },
63
+ rikbeKahnat: {
64
+ offset: 93,
65
+ name: { amharic: "ርክበ ካህናት", english: "Synod of Priests" },
66
+ tags: ["religious", "christian"],
67
+ },
68
+ erget: {
69
+ offset: 108,
70
+ name: { amharic: "ዕርገት", english: "Ascension (Erget)" },
71
+ tags: ["religious", "christian"],
72
+ },
73
+ paraclete: {
74
+ offset: 118,
75
+ name: { amharic: "ጰራቅሊጦስ", english: "Pentecost (Paraclete / Paraklitos)" },
76
+ tags: ["religious", "christian"],
77
+ },
78
+ paraklitos: {
79
+ offset: 118,
80
+ name: { amharic: "ጰራቅሊጦስ", english: "Pentecost (Paraclete / Paraklitos)" },
81
+ tags: ["religious", "christian"],
82
+ },
83
+ tsomeHawaryat: {
84
+ offset: 119,
85
+ name: { amharic: "ጾመ ሐዋርያት", english: "Apostles Fast" },
86
+ tags: ["religious", "christian", "fasting"],
87
+ },
88
+ tsomeDihenet: {
89
+ offset: 121,
90
+ name: { amharic: "ጾመ ድኅነት", english: "Salvation Fast" },
91
+ tags: ["religious", "christian", "fasting"],
92
+ },
93
+ };
94
+ /**
95
+ * Calculates Bahire Hasab (ባሕረ ሃሳብ) liturgical calculations for a given Ethiopian year.
96
+ * Computes all 11 movable feasts, lunar parameters, evangelist, and fasting seasons.
97
+ *
98
+ * @param ethiopianYear The Ethiopian calendar year (e.g. 2017)
99
+ * @returns Complete BahireHasabResult object
100
+ * @example
101
+ * ```ts
102
+ * import { calculateBahireHasab } from '@zemendev/calendar';
103
+ *
104
+ * const computus = calculateBahireHasab(2017);
105
+ * console.log(computus.evangelist.name.english); // Luke
106
+ * console.log(computus.feasts.fasika.ethiopian); // Easter date
107
+ * ```
108
+ */
109
+ export function calculateBahireHasab(ethiopianYear) {
110
+ const ameteAlem = 5500 + ethiopianYear;
111
+ const meteneRabiet = Math.floor(ameteAlem / 4);
112
+ const evangelistIndex = ameteAlem % 4;
113
+ const evangelist = {
114
+ index: evangelistIndex,
115
+ name: EVANGELISTS[evangelistIndex],
116
+ };
117
+ const tinteQemer = (ameteAlem + meteneRabiet) % 7;
118
+ const newYearWeekdayIndex = (tinteQemer + 1) % 7;
119
+ const newYearDay = {
120
+ index: newYearWeekdayIndex,
121
+ name: WEEKDAY_NAMES[newYearWeekdayIndex],
122
+ };
123
+ const medeb = ameteAlem % 19;
124
+ const wenber = medeb === 0 ? 18 : medeb - 1;
125
+ const abektie = (wenber * 11) % 30;
126
+ const rawMetqi = (wenber * 19) % 30;
127
+ // Edge-case fix: when rawMetqi is 0, it wraps to 30 (e.g. 2006 EC)
128
+ const metqi = rawMetqi === 0 ? 30 : rawMetqi;
129
+ const bealeMetqiMonth = metqi > 14 ? 1 : 2;
130
+ const bealeMetqiDay = metqi;
131
+ const bealeMetqi = {
132
+ year: ethiopianYear,
133
+ month: bealeMetqiMonth,
134
+ day: bealeMetqiDay,
135
+ };
136
+ const bealeMetqiWeekday = getEthiopianWeekday(bealeMetqi);
137
+ const tewsak = TEWSAK_MAP[bealeMetqiWeekday];
138
+ const mebajaHamerSum = bealeMetqiDay + tewsak;
139
+ const mebajaHamer = mebajaHamerSum > 30 ? mebajaHamerSum % 30 : mebajaHamerSum;
140
+ let ninevehMonth = metqi > 14 ? 5 : 6;
141
+ if (mebajaHamerSum > 30)
142
+ ninevehMonth++;
143
+ const nineveh = {
144
+ year: ethiopianYear,
145
+ month: ninevehMonth,
146
+ day: mebajaHamer,
147
+ };
148
+ const feasts = {};
149
+ for (const [key, info] of Object.entries(MOVABLE_FEAST_OFFSETS)) {
150
+ const feastDate = addDays(nineveh, info.offset);
151
+ feasts[key] = {
152
+ key,
153
+ name: info.name,
154
+ ethiopian: feastDate,
155
+ gregorian: toGregorian(feastDate),
156
+ movable: true,
157
+ tags: info.tags,
158
+ };
159
+ }
160
+ return {
161
+ year: ethiopianYear,
162
+ ameteAlem,
163
+ meteneRabiet,
164
+ evangelist,
165
+ newYearDay,
166
+ medeb,
167
+ wenber,
168
+ abektie,
169
+ metqi,
170
+ bealeMetqi,
171
+ nineveh,
172
+ feasts,
173
+ };
174
+ }
175
+ //# sourceMappingURL=bahireHasab.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bahireHasab.js","sourceRoot":"","sources":["../src/bahireHasab.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ import type { EthiopianDate } from "@zemendev/core";
2
+ export type FastingKey = "ABIY_TSOME" | "TSOME_HAWARYAT" | "TSOME_NEBIYAT" | "NINEVEH" | "FILSETA" | "TSOME_DIHENET" | "TSOME_TSIGE" | "GAHAD_GENNA" | "GAHAD_TIMKAT";
3
+ export interface FastingPeriod {
4
+ key: FastingKey;
5
+ name: {
6
+ amharic: string;
7
+ english: string;
8
+ };
9
+ start: EthiopianDate;
10
+ end: EthiopianDate;
11
+ totalDays: number;
12
+ isCanonical: boolean;
13
+ isVoluntary?: boolean;
14
+ }
15
+ export declare const FASTING_NAMES: Record<FastingKey, {
16
+ amharic: string;
17
+ english: string;
18
+ }>;
19
+ /**
20
+ * Returns the date boundaries of a specific fasting period for a given Ethiopian year.
21
+ */
22
+ export declare function getFastingPeriod(fastKey: FastingKey, year: number): FastingPeriod | null;
23
+ export interface FastingCheckResult {
24
+ isFasting: boolean;
25
+ reason?: string;
26
+ key?: FastingKey;
27
+ isCanonical?: boolean;
28
+ isVoluntary?: boolean;
29
+ }
30
+ /**
31
+ * Checks if a specific Ethiopian date is a fasting day in the Orthodox calendar.
32
+ * Includes canonical fasts + voluntary fasts (Tsome Tsige) + weekly Wednesday & Friday fasts
33
+ * (with Dominical Feast and Pentecost 50 exemptions).
34
+ */
35
+ export declare function isFastingDay(date: EthiopianDate, options?: {
36
+ includeVoluntary?: boolean;
37
+ }): FastingCheckResult;
38
+ export declare function getActiveFastingPeriod(date: EthiopianDate, options?: {
39
+ includeVoluntary?: boolean;
40
+ }): FastingPeriod | null;
41
+ //# sourceMappingURL=fasting.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fasting.d.ts","sourceRoot":"","sources":["../src/fasting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAUpD,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,SAAS,GACT,SAAS,GACT,eAAe,GACf,aAAa,GACb,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,UAAU,CAAC;IAChB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,aAAa,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAChC,UAAU,EACV;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA0BrC,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,MAAM,GACX,aAAa,GAAG,IAAI,CAoHtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,kBAAkB,CA4IpB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,aAAa,GAAG,IAAI,CAwBtB"}