@hebcal/core 6.4.0 → 6.5.0

package/README.md

@@ -42,6 +42,39 @@ for (const ev of events) {
 }
 ```
 
+## Displaying the current Shabbat
+
+`ParshaEvent` is designed for regular weekly parsha readings. On Shabbatot
+with holiday readings, such as Shabbat Chol HaMoed, use holiday events or the
+`@hebcal/leyning` package instead.
+
+For a lightweight holiday title from `@hebcal/core`:
+
+```javascript
+import {HDate, getHolidaysOnDate, getSedra, ParshaEvent} from '@hebcal/core';
+
+const hdate = new HDate(new Date(2025, 9, 11));
+const sedra = getSedra(hdate.getFullYear(), true).lookup(hdate);
+const event = sedra.chag
+  ? getHolidaysOnDate(hdate, true)[0]
+  : new ParshaEvent(sedra);
+
+console.log(event.render('he'));
+```
+
+For full Torah reading metadata and Shabbat/holiday leyning titles:
+
+```javascript
+import {HDate} from '@hebcal/hdate';
+import {getLeyningOnDate} from '@hebcal/leyning';
+
+const hdate = new HDate(new Date(2025, 9, 11));
+const reading = getLeyningOnDate(hdate, true, false, 'he');
+
+console.log(reading.name.he);
+console.log(reading.summary);
+```
+
 ## Usage
 
 This package exports two categories of output:

package/dist/bundle.js

@@ -1,9 +1,9 @@
-/*! @hebcal/core v6.4.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.5.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 var hebcal = (function (exports) {
 'use strict';
 
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-const version = '6.4.0';
+const version = '6.5.0';
 
 /*! @hebcal/hdate v0.22.2, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 /** @private */
@@ -175,11 +175,11 @@ function hebrewStripNikkud(str) {
 /*
  * More minimal HDate
  */
-const NISAN$4 = 1;
+const NISAN$5 = 1;
 const IYYAR$1 = 2;
-const SIVAN$1 = 3;
-const TAMUZ$1 = 4;
-const AV$1 = 5;
+const SIVAN$2 = 3;
+const TAMUZ$2 = 4;
+const AV$2 = 5;
 const ELUL$1 = 6;
 const TISHREI$2 = 7;
 const CHESHVAN$1 = 8;
@@ -195,15 +195,15 @@ const ADAR_II$2 = 13;
  */
 const months = {
     /** Nissan / ניסן */
-    NISAN: NISAN$4,
+    NISAN: NISAN$5,
     /** Iyyar / אייר */
     IYYAR: IYYAR$1,
     /** Sivan / סיון */
-    SIVAN: SIVAN$1,
+    SIVAN: SIVAN$2,
     /** Tamuz (sometimes Tammuz) / תמוז */
-    TAMUZ: TAMUZ$1,
+    TAMUZ: TAMUZ$2,
     /** Av / אב */
-    AV: AV$1,
+    AV: AV$2,
     /** Elul / אלול */
     ELUL: ELUL$1,
     /** Tishrei / תִּשְׁרֵי */
@@ -280,7 +280,7 @@ function hebrew2abs(year, month, day) {
         for (let m = TISHREI$2; m <= endMonth; m++) {
             tempabs += daysInMonth(m, year);
         }
-        for (let m = NISAN$4; m < month; m++) {
+        for (let m = NISAN$5; m < month; m++) {
             tempabs += daysInMonth(m, year);
         }
     }
@@ -482,7 +482,7 @@ function monthFromName(monthName) {
             if (c[1] === 'o') {
                 break; /* this catches "november" */
             }
-            return NISAN$4;
+            return NISAN$5;
         case 'i':
             return IYYAR$1;
         case 'e':
@@ -496,7 +496,7 @@ function monthFromName(monthName) {
         case 's':
             switch (c[1]) {
                 case 'i':
-                    return SIVAN$1;
+                    return SIVAN$2;
                 case 'h':
                     return SHVAT$1;
             }
@@ -504,7 +504,7 @@ function monthFromName(monthName) {
         case 't':
             switch (c[1]) {
                 case 'a':
-                    return TAMUZ$1;
+                    return TAMUZ$2;
                 case 'i':
                     return TISHREI$2;
                 case 'e':
@@ -514,7 +514,7 @@ function monthFromName(monthName) {
         case 'a':
             switch (c[1]) {
                 case 'v':
-                    return AV$1;
+                    return AV$2;
                 case 'd':
                     if (/(1|[^i]i|a|א)$/i.test(c)) {
                         return ADAR_I$2;
@@ -523,7 +523,7 @@ function monthFromName(monthName) {
             }
             break;
         case 'ס':
-            return SIVAN$1;
+            return SIVAN$2;
         case 'ט':
             return TEVET$2;
         case 'ש':
@@ -531,7 +531,7 @@ function monthFromName(monthName) {
         case 'א':
             switch (c[1]) {
                 case 'ב':
-                    return AV$1;
+                    return AV$2;
                 case 'ד':
                     if (/(1|[^i]i|a|א)$/i.test(c)) {
                         return ADAR_I$2;
@@ -546,7 +546,7 @@ function monthFromName(monthName) {
         case 'ת':
             switch (c[1]) {
                 case 'מ':
-                    return TAMUZ$1;
+                    return TAMUZ$2;
                 case 'ש':
                     return TISHREI$2;
             }
@@ -557,7 +557,7 @@ function monthFromName(monthName) {
 
 /*! @hebcal/hdate v0.22.2, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 
-const NISAN$3 = months.NISAN;
+const NISAN$4 = months.NISAN;
 const CHESHVAN = months.CHESHVAN;
 const KISLEV$1 = months.KISLEV;
 const TEVET$1 = months.TEVET;
@@ -663,7 +663,7 @@ function getBirthdayHD(hyear, date) {
         day === 30 &&
         isOrigLeap &&
         !isLeapYear(hyear)) {
-        month = NISAN$3;
+        month = NISAN$4;
         day = 1;
     }
     return { yy: hyear, mm: month, dd: day };
@@ -1919,7 +1919,7 @@ const flags = {
 };
 const flagToCategory = [
     [flags.MAJOR_FAST, 'holiday', 'major', 'fast'],
-    [flags.CHANUKAH_CANDLES, 'holiday', 'major'],
+    [flags.CHANUKAH_CANDLES, 'holiday', 'minor'],
     [flags.HEBREW_DATE, 'hebdate'],
     [flags.MINOR_FAST, 'holiday', 'fast'],
     [flags.MINOR_HOLIDAY, 'holiday', 'minor'],
@@ -9298,8 +9298,8 @@ class QuickLRU extends Map {
 const SUN$1 = 0;
 const TUE$1 = 2;
 const FRI$2 = 5;
-const SAT$2 = 6;
-const NISAN$2 = months.NISAN;
+const SAT$3 = 6;
+const NISAN$3 = months.NISAN;
 const IYYAR = months.IYYAR;
 /**
  * Yom HaShoah first observed in 1951.
@@ -9315,12 +9315,12 @@ function dateYomHaShoah(year) {
     if (year < 5711) {
         return null;
     }
-    let nisan27dt = new HDate(27, NISAN$2, year);
+    let nisan27dt = new HDate(27, NISAN$3, year);
     if (nisan27dt.getDay() === FRI$2) {
-        nisan27dt = new HDate(26, NISAN$2, year);
+        nisan27dt = new HDate(26, NISAN$3, year);
     }
     else if (nisan27dt.getDay() === SUN$1) {
-        nisan27dt = new HDate(28, NISAN$2, year);
+        nisan27dt = new HDate(28, NISAN$3, year);
     }
     return nisan27dt;
 }
@@ -9334,12 +9334,12 @@ function dateYomHaZikaron(year) {
         return null;
     }
     let day;
-    const pesach = new HDate(15, NISAN$2, year);
+    const pesach = new HDate(15, NISAN$3, year);
     const pdow = pesach.getDay();
     if (pdow === SUN$1) {
         day = 2;
     }
-    else if (pdow === SAT$2) {
+    else if (pdow === SAT$3) {
         day = 3;
     }
     else if (year < 5764) {
@@ -9848,7 +9848,7 @@ const IL_ONLY$2 = flags.IL_ONLY;
 const LIGHT_CANDLES_TZEIS$3 = flags.LIGHT_CANDLES_TZEIS;
 const MAJOR_FAST$2 = flags.MAJOR_FAST;
 const MINOR_HOLIDAY$2 = flags.MINOR_HOLIDAY;
-const EREV$2 = flags.EREV;
+const EREV$3 = flags.EREV;
 const CHOL_HAMOED$1 = flags.CHOL_HAMOED;
 const emojiPesach = '🫓';
 const emojiSukkot = '🌿🍋';
@@ -10084,7 +10084,7 @@ const staticHolidays = [
         flags: CHAG$1 | YOM_TOV_ENDS$1,
         emoji: '🍏🍯',
     },
-    { mm: Tishrei, dd: 9, desc: EREV_YOM_KIPPUR, flags: EREV$2 | LIGHT_CANDLES$3 },
+    { mm: Tishrei, dd: 9, desc: EREV_YOM_KIPPUR, flags: EREV$3 | LIGHT_CANDLES$3 },
     {
         mm: Tishrei,
         dd: 10,
@@ -10095,7 +10095,7 @@ const staticHolidays = [
         mm: Tishrei,
         dd: 14,
         desc: EREV_SUKKOT,
-        flags: CHUL_ONLY$1 | EREV$2 | LIGHT_CANDLES$3,
+        flags: CHUL_ONLY$1 | EREV$3 | LIGHT_CANDLES$3,
         emoji: emojiSukkot,
     },
     {
@@ -10160,7 +10160,7 @@ const staticHolidays = [
         mm: Tishrei,
         dd: 14,
         desc: EREV_SUKKOT,
-        flags: IL_ONLY$2 | EREV$2 | LIGHT_CANDLES$3,
+        flags: IL_ONLY$2 | EREV$3 | LIGHT_CANDLES$3,
         emoji: emojiSukkot,
     },
     {
@@ -10229,7 +10229,7 @@ const staticHolidays = [
         mm: Adar2,
         dd: 13,
         desc: EREV_PURIM,
-        flags: EREV$2 | MINOR_HOLIDAY$2,
+        flags: EREV$3 | MINOR_HOLIDAY$2,
         emoji: '🎭️📜',
     },
     { mm: Adar2, dd: 14, desc: PURIM, flags: MINOR_HOLIDAY$2, emoji: '🎭️📜' },
@@ -10245,7 +10245,7 @@ const staticHolidays = [
         mm: Nisan,
         dd: 14,
         desc: EREV_PESACH,
-        flags: IL_ONLY$2 | EREV$2 | LIGHT_CANDLES$3,
+        flags: IL_ONLY$2 | EREV$3 | LIGHT_CANDLES$3,
         emoji: '🫓🍷',
     },
     {
@@ -10307,7 +10307,7 @@ const staticHolidays = [
         mm: Nisan,
         dd: 14,
         desc: EREV_PESACH,
-        flags: CHUL_ONLY$1 | EREV$2 | LIGHT_CANDLES$3,
+        flags: CHUL_ONLY$1 | EREV$3 | LIGHT_CANDLES$3,
         emoji: '🫓🍷',
     },
     {
@@ -10376,7 +10376,7 @@ const staticHolidays = [
         mm: Sivan,
         dd: 5,
         desc: EREV_SHAVUOT,
-        flags: EREV$2 | LIGHT_CANDLES$3,
+        flags: EREV$3 | LIGHT_CANDLES$3,
         emoji: '⛰️🌸',
     },
     {
@@ -10412,7 +10412,7 @@ const staticHolidays = [
         mm: Elul,
         dd: 29,
         desc: EREV_ROSH_HASHANA,
-        flags: EREV$2 | LIGHT_CANDLES$3,
+        flags: EREV$3 | LIGHT_CANDLES$3,
         emoji: '🍏🍯',
     },
 ];
@@ -10733,15 +10733,15 @@ const SPECIAL_SHABBAT$1 = flags.SPECIAL_SHABBAT;
 const MODERN_HOLIDAY$1 = flags.MODERN_HOLIDAY;
 const MAJOR_FAST$1 = flags.MAJOR_FAST;
 const MINOR_HOLIDAY$1 = flags.MINOR_HOLIDAY;
-const EREV$1 = flags.EREV;
+const EREV$2 = flags.EREV;
 const SUN = 0;
 const TUE = 2;
 const THU = 4;
 const FRI$1 = 5;
-const SAT$1 = 6;
-const NISAN$1 = months.NISAN;
-const TAMUZ = months.TAMUZ;
-const AV = months.AV;
+const SAT$2 = 6;
+const NISAN$2 = months.NISAN;
+const TAMUZ$1 = months.TAMUZ;
+const AV$1 = months.AV;
 const TISHREI$1 = months.TISHREI;
 const KISLEV = months.KISLEV;
 const TEVET = months.TEVET;
@@ -10767,14 +10767,14 @@ function getHolidaysForYear_(year) {
         return cached;
     }
     const RH = new HDate(1, TISHREI$1, year);
-    const pesach = new HDate(15, NISAN$1, year);
+    const pesach = new HDate(15, NISAN$2, year);
     const map = new Map();
     function add(...events) {
         for (const ev of events) {
             const key = ev.date.toString();
             const arr = map.get(key);
             if (typeof arr === 'object') {
-                if (arr[0].getFlags() & EREV$1) {
+                if (arr[0].getFlags() & EREV$2) {
                     arr.unshift(ev);
                 }
                 else {
@@ -10801,12 +10801,12 @@ function getHolidaysForYear_(year) {
     const tzomGedaliahDay = RH.getDay() === THU ? 4 : 3;
     add(new HolidayEvent(new HDate(tzomGedaliahDay, TISHREI$1, year), holidayDesc.TZOM_GEDALIAH, MINOR_FAST$1));
     // first SAT after RH
-    add(new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$1, 7 + RH.abs())), holidayDesc.SHABBAT_SHUVA, SPECIAL_SHABBAT$1));
+    add(new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$2, 7 + RH.abs())), holidayDesc.SHABBAT_SHUVA, SPECIAL_SHABBAT$1));
     const rchTevet = HDate.shortKislev(year)
         ? new HDate(1, TEVET, year)
         : new HDate(30, KISLEV, year);
     add(new HolidayEvent(rchTevet, holidayDesc.CHAG_HABANOT, MINOR_HOLIDAY$1));
-    add(new ChanukahEvent(new HDate(24, KISLEV, year), holidayDesc.CHANUKAH_1_CANDLE, EREV$1 | MINOR_HOLIDAY$1 | CHANUKAH_CANDLES$1, undefined));
+    add(new ChanukahEvent(new HDate(24, KISLEV, year), holidayDesc.CHANUKAH_1_CANDLE, EREV$2 | MINOR_HOLIDAY$1 | CHANUKAH_CANDLES$1, undefined));
     // yes, we know Kislev 30-32 are wrong
     // HDate() corrects the month automatically
     for (let candles = 2; candles <= 8; candles++) {
@@ -10816,14 +10816,14 @@ function getHolidaysForYear_(year) {
     add(new ChanukahEvent(new HDate(32, KISLEV, year), holidayDesc.CHANUKAH_8TH_DAY, MINOR_HOLIDAY$1, 8));
     add(new AsaraBTevetEvent(new HDate(10, TEVET, year), holidayDesc.ASARA_BTEVET, MINOR_FAST$1));
     const pesachAbs = pesach.abs();
-    add(new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$1, pesachAbs - 43)), holidayDesc.SHABBAT_SHEKALIM, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$1, pesachAbs - 30)), holidayDesc.SHABBAT_ZACHOR, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(pesachAbs - (pesach.getDay() === TUE ? 33 : 31)), holidayDesc.TAANIT_ESTHER, MINOR_FAST$1));
-    const haChodeshAbs = HDate.dayOnOrBefore(SAT$1, pesachAbs - 14);
-    add(new HolidayEvent(new HDate(haChodeshAbs - 7), holidayDesc.SHABBAT_PARAH, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(haChodeshAbs), holidayDesc.SHABBAT_HACHODESH, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$1, pesachAbs - 1)), holidayDesc.SHABBAT_HAGADOL, SPECIAL_SHABBAT$1), new HolidayEvent(
+    add(new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$2, pesachAbs - 43)), holidayDesc.SHABBAT_SHEKALIM, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$2, pesachAbs - 30)), holidayDesc.SHABBAT_ZACHOR, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(pesachAbs - (pesach.getDay() === TUE ? 33 : 31)), holidayDesc.TAANIT_ESTHER, MINOR_FAST$1));
+    const haChodeshAbs = HDate.dayOnOrBefore(SAT$2, pesachAbs - 14);
+    add(new HolidayEvent(new HDate(haChodeshAbs - 7), holidayDesc.SHABBAT_PARAH, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(haChodeshAbs), holidayDesc.SHABBAT_HACHODESH, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$2, pesachAbs - 1)), holidayDesc.SHABBAT_HAGADOL, SPECIAL_SHABBAT$1), new HolidayEvent(
     // if the fast falls on Shabbat, move to Thursday
-    pesach.prev().getDay() === SAT$1
+    pesach.prev().getDay() === SAT$2
         ? pesach.onOrBefore(THU)
-        : new HDate(14, NISAN$1, year), holidayDesc.TAANIT_BECHOROT, MINOR_FAST$1));
-    add(new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$1, new HDate(1, TISHREI$1, year + 1).abs() - 4)), holidayDesc.LEIL_SELICHOT, MINOR_HOLIDAY$1, { emoji: '🕍' }));
+        : new HDate(14, NISAN$2, year), holidayDesc.TAANIT_BECHOROT, MINOR_FAST$1));
+    add(new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$2, new HDate(1, TISHREI$1, year + 1).abs() - 4)), holidayDesc.LEIL_SELICHOT, MINOR_HOLIDAY$1, { emoji: '🕍' }));
     if (pesach.getDay() === SUN) {
         add(new HolidayEvent(new HDate(16, ADAR_II, year), holidayDesc.PURIM_MESHULASH, MINOR_HOLIDAY$1));
     }
@@ -10843,13 +10843,13 @@ function getHolidaysForYear_(year) {
         if (year >= h.firstYear) {
             let hd = new HDate(h.dd, h.mm, year);
             const dow = hd.getDay();
-            if (h.friSatMovetoThu && (dow === FRI$1 || dow === SAT$1)) {
+            if (h.friSatMovetoThu && (dow === FRI$1 || dow === SAT$2)) {
                 hd = hd.onOrBefore(THU);
             }
             else if (h.friPostponeToSun && dow === FRI$1) {
                 hd = new HDate(hd.abs() + 2);
             }
-            else if (h.satPostponeToSun && dow === SAT$1) {
+            else if (h.satPostponeToSun && dow === SAT$2) {
                 hd = hd.next();
             }
             const mask = h.chul ? MODERN_HOLIDAY$1 : MODERN_HOLIDAY$1 | IL_ONLY$1;
@@ -10860,27 +10860,27 @@ function getHolidaysForYear_(year) {
             add(ev);
         }
     }
-    let tamuz17 = new HDate(17, TAMUZ, year);
+    let tamuz17 = new HDate(17, TAMUZ$1, year);
     let tamuz17attrs;
-    if (tamuz17.getDay() === SAT$1) {
-        tamuz17 = new HDate(18, TAMUZ, year);
+    if (tamuz17.getDay() === SAT$2) {
+        tamuz17 = new HDate(18, TAMUZ$1, year);
         tamuz17attrs = { observed: true };
     }
     add(new HolidayEvent(tamuz17, holidayDesc.TZOM_TAMMUZ, MINOR_FAST$1, tamuz17attrs));
-    let av9dt = new HDate(9, AV, year);
+    let av9dt = new HDate(9, AV$1, year);
     let av9title = holidayDesc.TISHA_BAV;
     let av9attrs;
-    if (av9dt.getDay() === SAT$1) {
+    if (av9dt.getDay() === SAT$2) {
         av9dt = av9dt.next();
         av9attrs = { observed: true };
         av9title += ' (observed)';
     }
     const av9abs = av9dt.abs();
-    add(new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$1, av9abs)), holidayDesc.SHABBAT_CHAZON, SPECIAL_SHABBAT$1), new HolidayEvent(av9dt.prev(), holidayDesc.EREV_TISHA_BAV, EREV$1 | MAJOR_FAST$1, av9attrs), new HolidayEvent(av9dt, av9title, MAJOR_FAST$1, av9attrs), new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$1, av9abs + 7)), holidayDesc.SHABBAT_NACHAMU, SPECIAL_SHABBAT$1));
+    add(new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$2, av9abs)), holidayDesc.SHABBAT_CHAZON, SPECIAL_SHABBAT$1), new HolidayEvent(av9dt.prev(), holidayDesc.EREV_TISHA_BAV, EREV$2 | MAJOR_FAST$1, av9attrs), new HolidayEvent(av9dt, av9title, MAJOR_FAST$1, av9attrs), new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$2, av9abs + 7)), holidayDesc.SHABBAT_NACHAMU, SPECIAL_SHABBAT$1));
     const monthsInYear = HDate.monthsInYear(year);
     for (let month = 1; month <= monthsInYear; month++) {
         const monthName = HDate.getMonthName(month, year);
-        if ((month === NISAN$1
+        if ((month === NISAN$2
             ? HDate.daysInMonth(HDate.monthsInYear(year - 1), year - 1)
             : HDate.daysInMonth(month - 1, year)) === 30) {
             add(new RoshChodeshEvent(new HDate(1, month, year), monthName));
@@ -10904,7 +10904,7 @@ function getHolidaysForYear_(year) {
         }
         let ykk = new HDate(29, month, year);
         const dow = ykk.getDay();
-        if (dow === FRI$1 || dow === SAT$1) {
+        if (dow === FRI$1 || dow === SAT$2) {
             ykk = ykk.onOrBefore(THU);
         }
         const nextMonthName = HDate.getMonthName(nextMonth, year);
@@ -10935,7 +10935,7 @@ function getHolidaysForYear_(year) {
  */
 function getBirkatHaChama(year) {
     const leap = HDate.isLeapYear(year);
-    const startMonth = leap ? ADAR_II : NISAN$1;
+    const startMonth = leap ? ADAR_II : NISAN$2;
     const startDay = leap ? 20 : 1;
     const baseRd = HDate.hebrew2abs(year, startMonth, startDay);
     for (let day = 0; day <= 40; day++) {
@@ -11027,6 +11027,61 @@ function isAssurBemlacha(currentTime, location, useElevation) {
     return false;
 }
 
+const NISAN$1 = months.NISAN;
+const SIVAN$1 = months.SIVAN;
+const TAMUZ = months.TAMUZ;
+const AV = months.AV;
+const SAT$1 = 6;
+function getHDate(date) {
+    return HDate.isHDate(date) ? date : new HDate(date);
+}
+function isSefiratHaOmer(hd) {
+    const hyear = hd.getFullYear();
+    const beginOmer = new HDate(16, NISAN$1, hyear).abs();
+    const endOmer = new HDate(5, SIVAN$1, hyear).abs();
+    const abs = hd.abs();
+    return abs >= beginOmer && abs <= endOmer;
+}
+function isBeinHaMetzarim(hd) {
+    const hyear = hd.getFullYear();
+    const begin = new HDate(17, TAMUZ, hyear).abs();
+    const tishaBav = new HDate(9, AV, hyear);
+    const end = tishaBav.getDay() === SAT$1 ? new HDate(10, AV, hyear).abs() : tishaBav.abs();
+    const abs = hd.abs();
+    return abs >= begin && abs <= end;
+}
+/**
+ * Utility method to determine if the given date is during a mourning period.
+ *
+ * This broad helper returns `true` during Sefirat HaOmer and Bein HaMetzarim.
+ * It does not attempt to model minhag-specific exceptions within those periods.
+ *
+ * @param date Hebrew Date, Gregorian date, or absolute R.D. day number
+ * @return `true` if the date is during a mourning period
+ */
+function isAveilut(date) {
+    const hd = getHDate(date);
+    return isSefiratHaOmer(hd) || isBeinHaMetzarim(hd);
+}
+
+const FAST_DAY = flags.MAJOR_FAST | flags.MINOR_FAST;
+const EREV$1 = flags.EREV;
+/**
+ * Utility method to determine if the given date is a fast day.
+ *
+ * @param date Hebrew Date, Gregorian date, or absolute R.D. day number
+ * @param il use the Israeli schedule for holidays
+ * @return `true` if the date is a major or minor fast day
+ */
+function isFastDay(date, il) {
+    const events = getHolidaysOnDate(date, il) || [];
+    const fastDay = events.find(ev => {
+        const mask = ev.getFlags();
+        return mask & FAST_DAY && !(mask & EREV$1);
+    });
+    return Boolean(fastDay);
+}
+
 const HAVDALAH = holidayDesc.HAVDALAH;
 const CANDLE_LIGHTING = holidayDesc.CANDLE_LIGHTING;
 /** An event that has an `eventTime` and `eventTimeStr` */
@@ -11645,7 +11700,12 @@ function renderParshaName(parsha, locale) {
 }
 
 /**
- * Represents one of 54 weekly Torah portions, always on a Saturday
+ * Represents one of 54 weekly Torah portions, always on a Saturday.
+ *
+ * `ParshaEvent` is for regular Parashat HaShavua readings. For Shabbatot
+ * with holiday readings such as Shabbat Chol ha-Moed, use
+ * `getHolidaysOnDate()` from `@hebcal/core`, or `getLeyningOnDate()` from
+ * `@hebcal/leyning` when the display title and exact Torah readings are needed.
  */
 class ParshaEvent extends Event {
     constructor(parsha) {
@@ -13126,6 +13186,8 @@ exports.getMoladAsDate = getMoladAsDate;
 exports.getSedra = getSedra;
 exports.holidayDesc = holidayDesc;
 exports.isAssurBemlacha = isAssurBemlacha;
+exports.isAveilut = isAveilut;
+exports.isFastDay = isFastDay;
 exports.months = months;
 exports.parshaYear = parshaYear;
 exports.parshiot = parshiot;