@hebcal/leyning 8.2.5 → 8.2.7

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/*! @hebcal/leyning v8.2.5 */
+/*! @hebcal/leyning v8.2.7 */
 import { flags, months, HDate, HebrewCalendar, Locale, ParshaEvent, HolidayEvent, Event } from '@hebcal/core';
 
 var numverses = {
@@ -53,7 +53,14 @@ var numverses = {
  * Names of the books of the Torah. BOOK[1] === 'Genesis'
  * @readonly
  */
-const BOOK = ['', 'Genesis', 'Exodus', 'Leviticus', 'Numbers', 'Deuteronomy'];
+const BOOK = [
+    '',
+    'Genesis',
+    'Exodus',
+    'Leviticus',
+    'Numbers',
+    'Deuteronomy',
+];
 /**
  * Formats parsha as a string
  * @param parsha untranslated name like 'Pinchas' or ['Pinchas'] or ['Matot','Masei']
@@ -62,7 +69,9 @@ function parshaToString(parsha) {
     if (typeof parsha === 'string') {
         return parsha;
     }
-    else if (!Array.isArray(parsha) || parsha.length === 0 || parsha.length > 2) {
+    else if (!Array.isArray(parsha) ||
+        parsha.length === 0 ||
+        parsha.length > 2) {
         throw new TypeError(`Bad parsha argument: ${parsha}`);
     }
     let s = parsha[0];
@@ -129,16 +138,16 @@ function formatAliyahShort(aliyah, showBook) {
  * @private
  */
 function isChapVerseBefore(a, b) {
-    const cv1 = a.split(':').map((x) => +x);
-    const cv2 = b.split(':').map((x) => +x);
-    return (cv1[0] * 100 + cv1[1]) < (cv2[0] * 100 + cv2[1]);
+    const cv1 = a.split(':').map(x => +x);
+    const cv2 = b.split(':').map(x => +x);
+    return cv1[0] * 100 + cv1[1] < cv2[0] * 100 + cv2[1];
 }
 /**
  * Summarizes an `AliyotMap` by collapsing all adjacent aliyot.
  * Finds any non-overlapping parts (e.g. special 7th aliyah or maftir)
  */
 function makeLeyningParts(aliyot) {
-    const nums = Object.keys(aliyot).filter((x) => {
+    const nums = Object.keys(aliyot).filter(x => {
         if (x.length === 1) {
             return true;
         }
@@ -151,15 +160,17 @@ function makeLeyningParts(aliyot) {
     for (let i = 0; i < nums.length; i++) {
         const num = nums[i];
         const aliyah = aliyot[num];
-        if ((i === nums.length - 1) && (aliyah.k === end.k) && (aliyah.e === end.e)) {
+        if (i === nums.length - 1 && aliyah.k === end.k && aliyah.e === end.e) {
             // short-circuit when final aliyah is within the previous (e.g. M inside of 7)
             continue;
         }
-        const prevEndChap = +(end.e.split(':')[0]);
-        const curStartChap = +(aliyah.b.split(':')[0]);
+        const prevEndChap = +end.e.split(':')[0];
+        const curStartChap = +aliyah.b.split(':')[0];
         const sameOrNextChap = curStartChap === prevEndChap || curStartChap === prevEndChap + 1;
-        if ((i !== 0) &&
-            (aliyah.k !== start.k || isChapVerseBefore(aliyah.b, start.e) || !sameOrNextChap)) {
+        if (i !== 0 &&
+            (aliyah.k !== start.k ||
+                isChapVerseBefore(aliyah.b, start.e) ||
+                !sameOrNextChap)) {
             parts.push({ k: start.k, b: start.b, e: end.e });
             start = aliyah;
         }
@@ -225,7 +236,9 @@ function cloneHaftara(haft) {
  * Returns the total number of verses in an array of Aliyah (or haftarah) objects
  */
 function sumVerses(aliyot) {
-    return Array.isArray(aliyot) ? aliyot.reduce((prev, cur) => prev + cur.v, 0) : aliyot.v;
+    return Array.isArray(aliyot)
+        ? aliyot.reduce((prev, cur) => prev + cur.v, 0)
+        : aliyot.v;
 }
 
 var festivals0 = { "Pesach I": {
@@ -880,9 +893,15 @@ function lookupFestival(holiday) {
     return result;
 }
 
-const HOLIDAY_IGNORE_MASK = flags.DAF_YOMI | flags.OMER_COUNT | flags.SHABBAT_MEVARCHIM |
-    flags.MOLAD | flags.USER_EVENT | flags.HEBREW_DATE | flags.MISHNA_YOMI |
-    flags.MODERN_HOLIDAY | flags.YERUSHALMI_YOMI;
+const HOLIDAY_IGNORE_MASK = flags.DAF_YOMI |
+    flags.OMER_COUNT |
+    flags.SHABBAT_MEVARCHIM |
+    flags.MOLAD |
+    flags.USER_EVENT |
+    flags.HEBREW_DATE |
+    flags.MISHNA_YOMI |
+    flags.MODERN_HOLIDAY |
+    flags.YERUSHALMI_YOMI;
 /**
  * Based on the event date, type and title, finds the relevant leyning key
  * @param ev event
@@ -906,13 +925,15 @@ function getLeyningKeyForEvent(ev, il = false) {
     const day = hd.getDate();
     const dow = hd.abs() % 7;
     const month = hd.getMonth();
-    const isShabbat = (dow == 6);
-    const isRoshChodesh = (day == 1 || day == 30);
+    const isShabbat = dow == 6;
+    const isRoshChodesh = day == 1 || day == 30;
     const holiday = ev.basename();
     const isPesach = holiday === 'Pesach';
     if (il && isPesach) {
         if (isShabbat) {
-            return day === 15 || day === 21 ? desc + ' (on Shabbat)' : 'Pesach Shabbat Chol ha-Moed';
+            return day === 15 || day === 21
+                ? desc + ' (on Shabbat)'
+                : 'Pesach Shabbat Chol ha-Moed';
         }
         return desc;
     }
@@ -929,10 +950,10 @@ function getLeyningKeyForEvent(ev, il = false) {
             return 'Sukkot Final Day (Hoshana Raba)';
         }
         if (isPesach && cholHaMoedDay) {
-            if (dow === 0 && desc === 'Pesach IV (CH\'\'M)') {
+            if (dow === 0 && desc === "Pesach IV (CH''M)") {
                 return 'Pesach Chol ha-Moed Day 2 on Sunday';
             }
-            else if (dow === 1 && desc === 'Pesach V (CH\'\'M)') {
+            else if (dow === 1 && desc === "Pesach V (CH''M)") {
                 return 'Pesach Chol ha-Moed Day 3 on Monday';
             }
         }
@@ -944,7 +965,7 @@ function getLeyningKeyForEvent(ev, il = false) {
             return 'Shabbat Rosh Chodesh Chanukah';
         }
         else if (isRoshChodesh && chanukahDay == 7) {
-            return `Chanukah Day 7 (on Rosh Chodesh)`;
+            return 'Chanukah Day 7 (on Rosh Chodesh)';
         }
         else if (isShabbat) {
             return `Chanukah Day ${chanukahDay} (on Shabbat)`;
@@ -953,7 +974,8 @@ function getLeyningKeyForEvent(ev, il = false) {
             return `Chanukah Day ${chanukahDay}`;
         }
     }
-    if (isRoshChodesh && (desc == 'Shabbat HaChodesh' || desc == 'Shabbat Shekalim')) {
+    if (isRoshChodesh &&
+        (desc == 'Shabbat HaChodesh' || desc == 'Shabbat Shekalim')) {
         return desc + ' (on Rosh Chodesh)';
     }
     if (il && desc == 'Shmini Atzeret') {
@@ -1000,8 +1022,8 @@ function getLeyningKeyForEvent(ev, il = false) {
     if (isRoshChodesh) {
         return desc;
     }
-    if (desc === 'Tish\'a B\'Av (observed)') {
-        return 'Tish\'a B\'Av';
+    if (desc === "Tish'a B'Av (observed)") {
+        return "Tish'a B'Av";
     }
     return undefined;
 }
@@ -1078,7 +1100,7 @@ function specialReadings2(parsha, hd, il, aliyot) {
     }
     const parshaName = parshaToString(parsha);
     const events0 = HebrewCalendar.getHolidaysOnDate(hd, il) || [];
-    const events = events0.filter((ev) => !(ev.getFlags() & flags.ROSH_CHODESH));
+    const events = events0.filter(ev => !(ev.getFlags() & flags.ROSH_CHODESH));
     for (const ev of events) {
         if (ev.getDesc() === 'Shabbat Shuva') {
             handleSpecial(`Shabbat Shuva (with ${parshaName})`);
@@ -1098,9 +1120,9 @@ function specialReadings2(parsha, hd, il, aliyot) {
             handleSpecial('Pinchas occurring after 17 Tammuz');
         }
         else if (day === 30 || day === 1) {
-            const key = (parshaName === 'Masei' || parshaName === 'Matot-Masei') ?
-                `${parshaName} on Shabbat Rosh Chodesh` :
-                'Shabbat Rosh Chodesh';
+            const key = parshaName === 'Masei' || parshaName === 'Matot-Masei'
+                ? `${parshaName} on Shabbat Rosh Chodesh`
+                : 'Shabbat Rosh Chodesh';
             handleSpecial(key);
         }
         else if (parshaName === 'Ki Teitzei' && day === 14) {
@@ -1112,7 +1134,8 @@ function specialReadings2(parsha, hd, il, aliyot) {
             // Source: Luaḥ Hashanah, Rabbi Miles B. Cohen and Leslie Rubin
             handleSpecial('Ki Teitzei with 3rd Haftarah of Consolation');
         }
-        else if (parshaName === 'Kedoshim' && (day === 26 || day === 28 || day === 6)) {
+        else if (parshaName === 'Kedoshim' &&
+            (day === 26 || day === 28 || day === 6)) {
             // Kedoshim is read separately from Achrei Mot in ~37% of years.
             // When this happens, it is will be read on
             // 26th or 28th of Nisan (Achrei Mot was Shabbat HaGadol, ~10%),
@@ -1152,7 +1175,9 @@ function getLeyningForHolidayKey(key, cholHaMoedDay, il) {
         return undefined;
     }
     const israelOnly = src.il;
-    if (typeof israelOnly === 'boolean' && typeof il === 'boolean' && il !== israelOnly) {
+    if (typeof israelOnly === 'boolean' &&
+        typeof il === 'boolean' &&
+        il !== israelOnly) {
         return undefined;
     }
     const leyning = {
@@ -1176,15 +1201,15 @@ function getLeyningForHolidayKey(key, cholHaMoedDay, il) {
                 leyning.summaryParts = parts;
             }
         }
-        Object.values(leyning.fullkriyah).map((aliyah) => calculateNumVerses(aliyah));
+        Object.values(leyning.fullkriyah).map(aliyah => calculateNumVerses(aliyah));
     }
     if (src.haft) {
-        const haft = leyning.haft = cloneHaftara(src.haft);
+        const haft = (leyning.haft = cloneHaftara(src.haft));
         leyning.haftara = makeSummaryFromParts(haft);
         leyning.haftaraNumV = sumVerses(haft);
     }
     if (src.seph) {
-        const seph = leyning.seph = cloneHaftara(src.seph);
+        const seph = (leyning.seph = cloneHaftara(src.seph));
         leyning.sephardic = makeSummaryFromParts(seph);
         leyning.sephardicNumV = sumVerses(seph);
     }
@@ -2540,7 +2565,7 @@ function makeLeyningNames(parsha) {
     const name = parshaToString(parsha);
     return {
         en: name,
-        he: parsha.map((s) => Locale.lookupTranslation(s, 'he')).join('־'),
+        he: parsha.map(s => Locale.lookupTranslation(s, 'he')).join('־'),
     };
 }
 /**
@@ -2577,13 +2602,13 @@ function getLeyningForParshaShabbatOnly(parsha) {
     const hkey = getHaftaraKey(parshaNameArray);
     const haft0 = parshiyotObj[hkey].haft;
     if (haft0) {
-        const haft = result.haft = cloneHaftara(haft0);
+        const haft = (result.haft = cloneHaftara(haft0));
         result.haftara = makeSummaryFromParts(haft);
         result.haftaraNumV = sumVerses(haft);
     }
     const seph0 = parshiyotObj[hkey].seph;
     if (seph0) {
-        const seph = result.seph = cloneHaftara(seph0);
+        const seph = (result.seph = cloneHaftara(seph0));
         result.sephardic = makeSummaryFromParts(seph);
         result.sephardicNumV = sumVerses(seph);
     }
@@ -2642,11 +2667,11 @@ function getLeyningForParshaHaShavua(ev, il = false) {
     const special = specialReadings2(parsha, hd, il, result.fullkriyah);
     const reason = special.reason;
     if (special.haft) {
-        const haft = result.haft = cloneHaftara(special.haft);
+        const haft = (result.haft = cloneHaftara(special.haft));
         result.haftara = makeSummaryFromParts(haft);
         result.haftaraNumV = sumVerses(haft);
         if (special.seph) {
-            const seph = result.seph = cloneHaftara(special.seph);
+            const seph = (result.seph = cloneHaftara(special.seph));
             result.sephardic = makeSummaryFromParts(seph);
             result.sephardicNumV = sumVerses(seph);
         }
@@ -2787,6 +2812,9 @@ function getLeyningOnDate(hdate, il, wantarray = false) {
         }
         const reading = getLeyningForHoliday(ev, il);
         if (reading) {
+            // Skip duplicate readings from overlapping events (eg, Rosh Chodesh + Chanukah)
+            if (arr.some(r => r.name.en === reading.name.en))
+                continue;
             const fk = reading.fullkriyah;
             if (fk) {
                 hasFullKriyah = true;
@@ -2842,14 +2870,16 @@ function getMincha(ev, il) {
 }
 
 const fmt = new Intl.DateTimeFormat('en-US', {
-    year: 'numeric', month: 'short', day: '2-digit',
+    year: 'numeric',
+    month: 'short',
+    day: '2-digit',
 });
 function fmtDate(dt) {
     const s = fmt.format(dt).split(' ');
     return s[1].substring(0, 2) + '-' + s[0] + '-' + s[2];
 }
 function getParshaDates(events) {
-    const parshaEvents = events.filter((ev) => ev.getFlags() === flags.PARSHA_HASHAVUA);
+    const parshaEvents = events.filter(ev => ev.getFlags() === flags.PARSHA_HASHAVUA);
     const emptyMap = {};
     const parshaDates = parshaEvents.reduce((set, ev) => {
         set[ev.getDate().toString()] = true;
@@ -2868,7 +2898,8 @@ function writeFullKriyahCsv(stream, hyear, il) {
     const parshaDates = getParshaDates(events);
     stream.write('"Date","Parashah","Aliyah","Reading","Verses"\r\n');
     for (const ev of events) {
-        if (ev.getFlags() === flags.PARSHA_HASHAVUA || !parshaDates[ev.getDate().toString()]) {
+        if (ev.getFlags() === flags.PARSHA_HASHAVUA ||
+            !parshaDates[ev.getDate().toString()]) {
             writeFullKriyahEvent(stream, ev, il);
         }
     }
@@ -2889,7 +2920,9 @@ function writeFullKriyahEvent(stream, ev, il) {
     }
     const mask = ev.getFlags();
     const isParsha = mask === flags.PARSHA_HASHAVUA;
-    const reading = isParsha ? getLeyningForParshaHaShavua(ev, il) : getLeyningForHoliday(ev, il);
+    const reading = isParsha
+        ? getLeyningForParshaHaShavua(ev, il)
+        : getLeyningForHoliday(ev, il);
     if (reading) {
         writeCsvLines(stream, ev, reading, il, isParsha);
         if (!isParsha) {
@@ -2918,7 +2951,9 @@ function writeHolidayMincha(stream, ev, il) {
  * Formats reading for CSV
  */
 function writeCsvLines(stream, ev, reading, il, isParsha) {
-    const parsha = isParsha ? ev.basename() : getLeyningKeyForEvent(ev, il) || ev.render();
+    const parsha = isParsha
+        ? ev.basename()
+        : getLeyningKeyForEvent(ev, il) || ev.render();
     const date = fmtDate(ev.getDate().greg());
     const lines = getFullKriyahLines(reading);
     for (const s of lines) {
@@ -2958,7 +2993,11 @@ function getFullKriyahLines(reading) {
         if ((_c = reading.reason) === null || _c === void 0 ? void 0 : _c.sephardic) {
             sephardic += ' | ' + reading.reason.sephardic;
         }
-        lines.push(['Haftara for Sephardim', sephardic, reading.sephardicNumV || '']);
+        lines.push([
+            'Haftara for Sephardim',
+            sephardic,
+            reading.sephardicNumV || '',
+        ]);
     }
     if (reading.triHaftara) {
         const haftara = reading.triHaftara.replace(/,/g, ';');

package/dist/module.d.ts

@@ -0,0 +1,316 @@
+import { Event, HDate, HolidayEvent } from '@hebcal/core';
+import { WriteStream } from 'node:fs';
+
+/**
+ * Represents an aliyah
+ */
+type Aliyah = {
+    /** Book (e.g. "Numbers") */
+    k: string;
+    /** beginning verse (e.g. "28:9") */
+    b: string;
+    /** ending verse (e.g. "28:15") */
+    e: string;
+    /** number of verses */
+    v?: number;
+    /** parsha number (1=Bereshit, 54=Vezot HaBracha) */
+    p?: number;
+    reason?: string;
+};
+type StringMap = {
+    [key: string]: string;
+};
+type AliyotMap = {
+    [key: string]: Aliyah;
+};
+/** Name of the parsha hashavua or holiday */
+type LeyningNames = {
+    /** English */
+    en: string;
+    /** Hebrew (with nikud) */
+    he: string;
+};
+/**
+ * Parsha metadata (underlying JSON object)
+ */
+type ParshaMeta = {
+    /** 1 for Bereshit, 2 for Noach, etc. `undefined` for holiday readings */
+    num: number | number[];
+    /** parsha name in Hebrew with niqud */
+    hebrew: string;
+    /** 1 for Genesis, 2 for Exodus, 5 for Deuteronomy */
+    book: number;
+    /** Haftarah object(s) */
+    haft: Aliyah | Aliyah[];
+    /** Haftarah object(s) for Sephardim */
+    seph?: Aliyah | Aliyah[];
+    /** Map of Shabbat aliyot `1` through `7` plus `M` for maftir */
+    fullkriyah: {
+        [key: string]: string[];
+    };
+    /**
+     * Map of weekday Torah Readings
+     *  aliyot `1` through `3` for Monday and Thursday
+     */
+    weekday?: {
+        [key: string]: string[];
+    };
+    combined?: boolean;
+    p1?: string;
+    p2?: string;
+    num1?: number;
+    num2?: number;
+};
+type SpecialReading = {
+    /** Map of aliyot `1` through `7` plus `M` for maftir */
+    aliyot: AliyotMap;
+    /**
+     * Explanations for special readings,
+     *  keyed by aliyah number, `M` for maftir or `haftara` for Haftarah
+     */
+    reason: StringMap;
+    /** Haftarah object(s) */
+    haft?: Aliyah | Aliyah[];
+    /** Haftarah object(s) for Sephardim */
+    seph?: Aliyah | Aliyah[];
+};
+/**
+ * Leyning base - weekday, parsha hashavua or holiday
+ */
+type LeyningBase = {
+    /** Name of the parsha hashavua or holiday */
+    name: LeyningNames;
+    /** Such as `Genesis 1:1 - 6:8` */
+    summary: string;
+    summaryParts?: Aliyah[];
+    note?: string;
+};
+/**
+ * Parashat haShavua - weekday or Shabbat
+ */
+type LeyningParshaHaShavua = LeyningBase & {
+    /** An array of either 1 (regular) or 2 (doubled parsha). `undefined` for holiday readings */
+    parsha?: string[];
+    /** 1 for Bereshit, 2 for Noach, etc. `undefined` for holiday readings */
+    parshaNum?: number | number[];
+};
+/**
+ * Parashat haShavua - weekday
+ */
+type LeyningWeekday = LeyningParshaHaShavua & {
+    /** Optional map of weekday Torah Readings aliyot `1` through `3` for Monday and Thursday */
+    weekday?: AliyotMap;
+};
+type HaftarahProps = {
+    /** Haftarah object */
+    haft: Aliyah | Aliyah[];
+    /** Haftarah, such as `Isaiah 42:5 – 43:11` */
+    haftara: string;
+    /** Number of verses in the Haftarah */
+    haftaraNumV?: number;
+};
+/**
+ * Shabbat and holiday leyning always has full kriyah and haftarah
+ */
+type LeyningShabbatHoliday = LeyningBase & HaftarahProps & {
+    /** Map of aliyot `1` through `7` plus `M` for maftir */
+    fullkriyah: AliyotMap;
+    /** Haftarah object for Sephardim */
+    seph?: Aliyah | Aliyah[];
+    /** Haftarah for Sephardim, such as `Isaiah 42:5 - 42:21` */
+    sephardic?: string;
+    /** Number of verses in the Haftarah for Sephardim */
+    sephardicNumV?: number;
+    /** Explanations for special readings, keyed by aliyah number, `M` for maftir or `haftara` for Haftarah */
+    reason?: StringMap;
+    /** Song of Songs is read on the sabbath of Passover week, the Book of Ruth on Shavuot, Lamentations on Tisha be-Av, Ecclesiastes on the sabbath of the week of Sukkoth, and the Book of Esther on Purim */
+    megillah?: AliyotMap;
+    /** Triennial alternate Haftara */
+    triHaftara?: string;
+    /** Triennial alternate Haftara number of verses */
+    triHaftaraNumV?: number;
+};
+type Leyning = LeyningBase & LeyningParshaHaShavua & LeyningShabbatHoliday & LeyningWeekday;
+
+/**
+ * Names of the books of the Torah. BOOK[1] === 'Genesis'
+ * @readonly
+ */
+declare const BOOK: string[];
+/**
+ * Formats parsha as a string
+ * @param parsha untranslated name like 'Pinchas' or ['Pinchas'] or ['Matot','Masei']
+ */
+declare function parshaToString(parsha: string | string[]): string;
+/**
+ * Calculates the number of verses in an aliyah or haftara based on
+ * the `b` (begin verse), `e` (end verse) and `k` (book).
+ * Modifies `aliyah` by setting the `v` field.
+ */
+declare function calculateNumVerses(aliyah: Aliyah): number;
+/**
+ * Formats an aliyah object like "Numbers 28:9-28:15"
+ */
+declare function formatAliyahWithBook(a: Aliyah): string;
+/**
+ * Formats an aliyah object like "Numbers 28:9-15"
+ */
+declare function formatAliyahShort(aliyah: Aliyah, showBook: boolean): string;
+
+/**
+ * Summarizes an `AliyotMap` by collapsing all adjacent aliyot.
+ * Finds any non-overlapping parts (e.g. special 7th aliyah or maftir)
+ */
+declare function makeLeyningParts(aliyot: AliyotMap): Aliyah[];
+/**
+ * Returns a string representation of the leyning parts.
+ * Separate verse ranges read from the same book are separated
+ * by commas, e.g. `Isaiah 6:1-7:6, 9:5-6`.
+ * Verse ranges from different books are separated by semicolons,
+ * e.g. `Genesis 21:1-34; Numbers 29:1-6`.
+ */
+declare function makeSummaryFromParts(parts: Aliyah | Aliyah[]): string;
+/**
+ * Makes a summary of the leyning, like "Genesis 6:9-11:32"
+ */
+declare function makeLeyningSummary(aliyot: AliyotMap): string;
+
+type JsonFestivalAliyah = {
+    k: number | string;
+    b: string;
+    e: string;
+    v?: number;
+    p?: number;
+};
+type JsonFestivalAliyotMap = {
+    [key: string]: JsonFestivalAliyah;
+};
+type JsonFestivalLeyning = {
+    haft?: JsonFestivalAliyah | JsonFestivalAliyah[];
+    seph?: JsonFestivalAliyah | JsonFestivalAliyah[];
+    fullkriyah?: JsonFestivalAliyotMap;
+    megillah?: string;
+    alias?: boolean;
+    key?: string;
+    note?: string;
+    il?: boolean;
+};
+
+/**
+ * Is there a special festival Torah Reading for `holiday`?
+ */
+declare function hasFestival(holiday: string): boolean;
+/**
+ * Returns the raw metadata for festival reading for `holiday`
+ */
+declare function lookupFestival(holiday: string): JsonFestivalLeyning | undefined;
+
+/**
+ * Based on the event date, type and title, finds the relevant leyning key
+ * @param ev event
+ * @param [il] true if Israel holiday scheme
+ * @returns key to look up in holiday-reading.json
+ */
+declare function getLeyningKeyForEvent(ev: Event, il?: boolean): string | undefined;
+
+/**
+ * Determines if the regular parashat haShavua coincides with an event that requires
+ * a special maftir or Haftara (for example Shabbat HaGadol, Shabbat Chanukah, Rosh
+ * Chodesh or Machar Chodesh, etc.).
+ *
+ * This function does not modify `aliyot`. Instead, it returns a deep copy
+ * with `aliyot['M']` replaced and sets `reason.M`
+ * (and in some cases the 6th and 7th aliyah, setting `reason['7']`).
+ *
+ * If a special Haftarah applies, the result will have a `haft` property
+ * pointing to Haftarah object and sets `reason.haftara`.
+ */
+declare function specialReadings2(parsha: string[], hd: HDate, il: boolean, aliyot: AliyotMap): SpecialReading;
+
+/**
+ * Looks up leyning for a given holiday key. Key should be an
+ * (untranslated) string used in holiday-readings.json. Returns some
+ * of full kriyah aliyot, special Maftir, special Haftarah
+ * @param key name from `holiday-readings.json` to find
+ */
+declare function getLeyningForHolidayKey(key?: string, cholHaMoedDay?: number, il?: boolean): Leyning | undefined;
+/**
+ * Looks up leyning for a given holiday. Returns some
+ * of full kriyah aliyot, special Maftir, special Haftarah
+ * @param ev the Hebcal event associated with this leyning
+ * @param [il] true if Israel holiday scheme
+ * @returns map of aliyot
+ */
+declare function getLeyningForHoliday(ev: Event, il?: boolean): Leyning | undefined;
+
+/**
+ * Transliterated English and Hebrew names of this parsha
+ * @param parsha untranslated name like ['Pinchas'] or ['Matot','Masei']
+ */
+declare function makeLeyningNames(parsha: string[]): LeyningNames;
+/**
+ * Looks up Monday/Thursday aliyot for a regular parsha
+ * @param parsha untranslated name like 'Pinchas' or ['Pinchas'] or ['Matot','Masei']
+ */
+declare function getWeekdayReading(parsha: string | string[]): AliyotMap;
+/**
+ * Looks up regular leyning for a weekly parsha with no special readings
+ * @param parsha untranslated name like 'Pinchas' or ['Pinchas'] or ['Matot','Masei']
+ */
+declare function getLeyningForParsha(parsha: string | string[]): Leyning;
+/**
+ * Looks up leyning for a regular Shabbat parsha, including any special
+ * maftir or Haftara.
+ * @param ev the Hebcal event associated with this leyning
+ * @param [il] in Israel
+ * @returns map of aliyot
+ */
+declare function getLeyningForParshaHaShavua(ev: Event, il?: boolean): Leyning;
+/**
+ * Returns the parsha metadata
+ * @param parsha untranslated name like 'Pinchas' or ['Pinchas'] or ['Matot','Masei']
+ */
+declare function lookupParsha(parsha: string | string[]): ParshaMeta;
+
+/**
+ * Looks up leyning for a regular Shabbat, Monday/Thursday weekday or holiday.
+ *
+ * If `hdate` coincides with a holiday that has Torah reading, returns the
+ * reading for that day (see {@link getLeyningForHoliday})
+ *
+ * Otherwise, if `hdate` is a Saturday, returns {@link getLeyningForParshaHaShavua}
+ *
+ * Otherwise, if `hdate` is a Monday or Thursday, returns {@link Leyning} for the
+ * Parashat haShavua, containing only the `weekday` aliyot (no `fullkriyah`).
+ *
+ * Otherwise, returns `undefined`.
+ *
+ * @param {HDate} hdate Hebrew Date
+ * @param {boolean} il in Israel
+ * @param {boolean} [wantarray] to return an array of 0 or more readings
+ */
+declare function getLeyningOnDate(hdate: HDate, il: boolean, wantarray?: boolean): (Leyning | LeyningWeekday) | (Leyning | LeyningWeekday)[] | undefined;
+
+interface StringToBoolMap {
+    [key: string]: boolean;
+}
+declare function getParshaDates(events: Event[]): StringToBoolMap;
+declare function writeFullKriyahCsv(stream: WriteStream, hyear: number, il: boolean): void;
+declare function writeHolidayMincha(stream: WriteStream, ev: HolidayEvent, il: boolean): void;
+/**
+ * Formats reading for CSV
+ */
+declare function writeCsvLines(stream: WriteStream, ev: Event, reading: Leyning, il: boolean, isParsha: boolean): void;
+
+/**
+ * Makes a deep copy of the src object using JSON stringify and parse
+ */
+declare function clone(src: any): any;
+type Haftarah = Aliyah | Aliyah[] | JsonFestivalAliyah | JsonFestivalAliyah[];
+declare function cloneHaftara(haft: Haftarah): Aliyah | Aliyah[];
+/**
+ * Returns the total number of verses in an array of Aliyah (or haftarah) objects
+ */
+declare function sumVerses(aliyot: Haftarah): number;
+
+export { type Aliyah, type AliyotMap, BOOK, type Haftarah, type HaftarahProps, type Leyning, type LeyningBase, type LeyningNames, type LeyningParshaHaShavua, type LeyningShabbatHoliday, type LeyningWeekday, type ParshaMeta, type SpecialReading, type StringMap, type StringToBoolMap, calculateNumVerses, clone, cloneHaftara, formatAliyahShort, formatAliyahWithBook, getLeyningForHoliday, getLeyningForHolidayKey, getLeyningForParsha, getLeyningForParshaHaShavua, getLeyningKeyForEvent, getLeyningOnDate, getParshaDates, getWeekdayReading, hasFestival, lookupFestival, lookupParsha, makeLeyningNames, makeLeyningParts, makeLeyningSummary, makeSummaryFromParts, parshaToString, specialReadings2, sumVerses, writeCsvLines, writeFullKriyahCsv, writeHolidayMincha };