@hebcal/core 3.41.4 → 3.42.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/*! @hebcal/core v3.41.3 */
+/*! @hebcal/core v3.42.0 */
 /*
  * More minimal greg routines
  */
@@ -627,8 +627,8 @@ Locale.useLocale('en');
 /*
  * More minimal HDate
  */
-const NISAN$3 = 1;
-const IYYAR$1 = 2; // const SIVAN = 3;
+const NISAN$4 = 1;
+const IYYAR$2 = 2; // const SIVAN = 3;
 
 const TAMUZ$1 = 4; // const AV = 5;
 
@@ -717,7 +717,7 @@ function hebrew2abs(year, month, day) {
       tempabs += daysInMonth(m, year);
     }
 
-    for (let m = NISAN$3; m < month; m++) {
+    for (let m = NISAN$4; m < month; m++) {
       tempabs += daysInMonth(m, year);
     }
   } else {
@@ -802,7 +802,7 @@ function monthsInYear(year) {
 
 function daysInMonth(month, year) {
   switch (month) {
-    case IYYAR$1:
+    case IYYAR$2:
     case TAMUZ$1:
     case ELUL$2:
     case TEVET$2:
@@ -4492,7 +4492,7 @@ const SHAVUOT = 'Shavuot'; // 33
  * @return {number[]}
  */
 
-function range(start, stop) {
+function range$1(start, stop) {
   return Array.from({
     length: stop - start + 1
   }, (v, k) => k + start);
@@ -4510,78 +4510,78 @@ const types = {
   /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and
      * Kislev each have 29 days), and has Passover start on Tuesday. */
   // e.g. 5753
-  '020': [51, 52].concat(EOY, range(0, 20), D(21), 23, 24, PESACH, 25, D(26), D(28), 30, D(31), range(33, 40), D(41), range(43, 49), D(50)),
+  '020': [51, 52].concat(EOY, range$1(0, 20), D(21), 23, 24, PESACH, 25, D(26), D(28), 30, D(31), range$1(33, 40), D(41), range$1(43, 49), D(50)),
 
   /* Hebrew year that starts on Monday, is `complete' (Heshvan and
      * Kislev each have 30 days), and has Passover start on Thursday. */
   // e.g. 5756
-  '0220': [51, 52].concat(EOY, range(0, 20), D(21), 23, 24, PESACH, 25, D(26), D(28), 30, D(31), 33, SHAVUOT, range(34, 37), D(38), 40, D(41), range(43, 49), D(50)),
+  '0220': [51, 52].concat(EOY, range$1(0, 20), D(21), 23, 24, PESACH, 25, D(26), D(28), 30, D(31), 33, SHAVUOT, range$1(34, 37), D(38), 40, D(41), range$1(43, 49), D(50)),
 
   /* Hebrew year that starts on Thursday, is `regular' (Heshvan has 29
      * days and Kislev has 30 days), and has Passover start on Saturday. */
   // e.g. 5701
-  '0510': [52].concat(YK, EOY, range(0, 20), D(21), 23, 24, PESACH1, PESACH8, 25, D(26), D(28), 30, D(31), range(33, 40), D(41), range(43, 50)),
+  '0510': [52].concat(YK, EOY, range$1(0, 20), D(21), 23, 24, PESACH1, PESACH8, 25, D(26), D(28), 30, D(31), range$1(33, 40), D(41), range$1(43, 50)),
 
   /* Hebrew year that starts on Thursday, is `regular' (Heshvan has 29
      * days and Kislev has 30 days), and has Passover start on Saturday. */
   // e.g. 5745
-  '0511': [52].concat(YK, EOY, range(0, 20), D(21), 23, 24, PESACH, 25, D(26), D(28), range(30, 40), D(41), range(43, 50)),
+  '0511': [52].concat(YK, EOY, range$1(0, 20), D(21), 23, 24, PESACH, 25, D(26), D(28), range$1(30, 40), D(41), range$1(43, 50)),
 
   /* Hebrew year that starts on Thursday, is `complete' (Heshvan and
      * Kislev each have 30 days), and has Passover start on Sunday. */
   // e.g. 5754
-  '052': [52].concat(YK, CHMSUKOT, range(0, 24), PESACH7, 25, D(26), D(28), 30, D(31), range(33, 40), D(41), range(43, 50)),
+  '052': [52].concat(YK, CHMSUKOT, range$1(0, 24), PESACH7, 25, D(26), D(28), 30, D(31), range$1(33, 40), D(41), range$1(43, 50)),
 
   /* Hebrew year that starts on Saturday, is `incomplete' (Heshvan and Kislev
      * each have 29 days), and has Passover start on Sunday. */
   // e.g. 5761
-  '070': [].concat(RH, 52, SUKKOT, SHMINI, range(0, 20), D(21), 23, 24, PESACH7, 25, D(26), D(28), 30, D(31), range(33, 40), D(41), range(43, 50)),
+  '070': [].concat(RH, 52, SUKKOT, SHMINI, range$1(0, 20), D(21), 23, 24, PESACH7, 25, D(26), D(28), 30, D(31), range$1(33, 40), D(41), range$1(43, 50)),
 
   /* Hebrew year that starts on Saturday, is `complete' (Heshvan and
      * Kislev each have 30 days), and has Passover start on Tuesday. */
   // e.g. 5716
-  '072': [].concat(RH, 52, SUKKOT, SHMINI, range(0, 20), D(21), 23, 24, CHMPESACH, 25, D(26), D(28), 30, D(31), range(33, 40), D(41), range(43, 49), D(50)),
+  '072': [].concat(RH, 52, SUKKOT, SHMINI, range$1(0, 20), D(21), 23, 24, CHMPESACH, 25, D(26), D(28), 30, D(31), range$1(33, 40), D(41), range$1(43, 49), D(50)),
 
   /* --  The leap year types (keviot) -- */
 
   /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and
      * Kislev each have 29 days), and has Passover start on Thursday. */
   // e.g. 5746
-  '1200': [51, 52].concat(CHMSUKOT, range(0, 27), CHMPESACH, range(28, 33), SHAVUOT, range(34, 37), D(38), 40, D(41), range(43, 49), D(50)),
+  '1200': [51, 52].concat(CHMSUKOT, range$1(0, 27), CHMPESACH, range$1(28, 33), SHAVUOT, range$1(34, 37), D(38), 40, D(41), range$1(43, 49), D(50)),
 
   /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and
      * Kislev each have 29 days), and has Passover start on Thursday. */
   // e.g. 5746
-  '1201': [51, 52].concat(CHMSUKOT, range(0, 27), CHMPESACH, range(28, 40), D(41), range(43, 49), D(50)),
+  '1201': [51, 52].concat(CHMSUKOT, range$1(0, 27), CHMPESACH, range$1(28, 40), D(41), range$1(43, 49), D(50)),
 
   /* Hebrew year that starts on Monday, is `complete' (Heshvan and
      * Kislev each have 30 days), and has Passover start on Saturday. */
   // e.g.5752
-  '1220': [51, 52].concat(CHMSUKOT, range(0, 27), PESACH1, PESACH8, range(28, 40), D(41), range(43, 50)),
+  '1220': [51, 52].concat(CHMSUKOT, range$1(0, 27), PESACH1, PESACH8, range$1(28, 40), D(41), range$1(43, 50)),
 
   /* Hebrew year that starts on Monday, is `complete' (Heshvan and
      * Kislev each have 30 days), and has Passover start on Saturday. */
   // e.g.5752
-  '1221': [51, 52].concat(CHMSUKOT, range(0, 27), PESACH, range(28, 50)),
+  '1221': [51, 52].concat(CHMSUKOT, range$1(0, 27), PESACH, range$1(28, 50)),
 
   /* Hebrew year that starts on Thursday, is `incomplete' (Heshvan and
      * Kislev both have 29 days), and has Passover start on Sunday. */
   // e.g. 5768
-  '150': [52].concat(YK, CHMSUKOT, range(0, 28), PESACH7, range(29, 50)),
+  '150': [52].concat(YK, CHMSUKOT, range$1(0, 28), PESACH7, range$1(29, 50)),
 
   /* Hebrew year that starts on Thursday, is `complete' (Heshvan and
      * Kislev both have 30 days), and has Passover start on Tuesday. */
   // eg. 5771
-  '152': [52].concat(YK, CHMSUKOT, range(0, 28), CHMPESACH, range(29, 49), D(50)),
+  '152': [52].concat(YK, CHMSUKOT, range$1(0, 28), CHMPESACH, range$1(29, 49), D(50)),
 
   /* Hebrew year that starts on Saturday, is `incomplete' (Heshvan and
      * Kislev each have 29 days), and has Passover start on Tuesday. */
   // e.g.5757
-  '170': [].concat(RH, 52, SUKKOT, SHMINI, range(0, 27), CHMPESACH, range(28, 40), D(41), range(43, 49), D(50)),
+  '170': [].concat(RH, 52, SUKKOT, SHMINI, range$1(0, 27), CHMPESACH, range$1(28, 40), D(41), range$1(43, 49), D(50)),
 
   /* Hebrew year that starts on Saturday, is `complete' (Heshvan and
      * Kislev each have 30 days), and has Passover start on Thursday. */
-  '1720': [].concat(RH, 52, SUKKOT, SHMINI, range(0, 27), CHMPESACH, range(28, 33), SHAVUOT, range(34, 37), D(38), 40, D(41), range(43, 49), D(50))
+  '1720': [].concat(RH, 52, SUKKOT, SHMINI, range$1(0, 27), CHMPESACH, range$1(28, 33), SHAVUOT, range$1(34, 37), D(38), 40, D(41), range$1(43, 49), D(50))
 };
 /* Hebrew year that starts on Monday, is `complete' (Heshvan and
  * Kislev each have 30 days), and has Passover start on Thursday. */
@@ -4683,6 +4683,70 @@ class ParshaEvent extends Event {
 
 }
 
+const SUN$1 = 0;
+const TUE$1 = 2;
+const FRI$2 = 5;
+const SAT$2 = 6;
+const NISAN$3 = months.NISAN;
+const IYYAR$1 = months.IYYAR;
+/**
+ * Yom HaShoah first observed in 1951.
+ * When the actual date of Yom Hashoah falls on a Friday, the
+ * state of Israel observes Yom Hashoah on the preceding
+ * Thursday. When it falls on a Sunday, Yom Hashoah is observed
+ * on the following Monday.
+ * http://www.ushmm.org/remembrance/dor/calendar/
+ * @private
+ * @param {number} year
+ * @return {HDate|null}
+ */
+
+function dateYomHaShoah(year) {
+  if (year < 5711) {
+    return null;
+  }
+
+  let nisan27dt = new HDate(27, NISAN$3, year);
+
+  if (nisan27dt.getDay() === FRI$2) {
+    nisan27dt = new HDate(26, NISAN$3, year);
+  } else if (nisan27dt.getDay() === SUN$1) {
+    nisan27dt = new HDate(28, NISAN$3, year);
+  }
+
+  return nisan27dt;
+}
+/**
+ * Yom HaAtzma'ut only celebrated after 1948
+ * @private
+ * @param {number} year
+ * @return {HDate|null}
+ */
+
+function dateYomHaZikaron(year) {
+  if (year < 5708) {
+    return null;
+  }
+
+  let day;
+  const pesach = new HDate(15, NISAN$3, year);
+  const pdow = pesach.getDay();
+
+  if (pdow === SUN$1) {
+    day = 2;
+  } else if (pdow === SAT$2) {
+    day = 3;
+  } else if (year < 5764) {
+    day = 4;
+  } else if (pdow === TUE$1) {
+    day = 5;
+  } else {
+    day = 4;
+  }
+
+  return new HDate(day, IYYAR$1, year);
+}
+
 /*
     Hebcal - A Jewish Calendar Generator
     Copyright (c) 1994-2020 Danny Sadinoff
@@ -5230,42 +5294,16 @@ function getHolidaysForYear_(year) {
     }));
   }
 
-  if (year >= 5711) {
-    // Yom HaShoah first observed in 1951
-    let nisan27dt = new HDate(27, NISAN$2, year);
-    /* When the actual date of Yom Hashoah falls on a Friday, the
-       * state of Israel observes Yom Hashoah on the preceding
-       * Thursday. When it falls on a Sunday, Yom Hashoah is observed
-       * on the following Monday.
-       * http://www.ushmm.org/remembrance/dor/calendar/
-       */
-
-    if (nisan27dt.getDay() == FRI$1) {
-      nisan27dt = new HDate(26, NISAN$2, year);
-    } else if (nisan27dt.getDay() == SUN) {
-      nisan27dt = new HDate(28, NISAN$2, year);
-    }
+  const nisan27dt = dateYomHaShoah(year);
 
+  if (nisan27dt) {
     add(new HolidayEvent(nisan27dt, 'Yom HaShoah', MODERN_HOLIDAY$1));
   }
 
-  if (year >= 5708) {
-    // Yom HaAtzma'ut only celebrated after 1948
-    let day;
+  const yomHaZikaronDt = dateYomHaZikaron(year);
 
-    if (pesach.getDay() == SUN) {
-      day = 2;
-    } else if (pesach.getDay() == SAT$1) {
-      day = 3;
-    } else if (year < 5764) {
-      day = 4;
-    } else if (pesach.getDay() == TUE) {
-      day = 5;
-    } else {
-      day = 4;
-    }
-
-    add(new HolidayEvent(new HDate(day, IYYAR, year), 'Yom HaZikaron', MODERN_HOLIDAY$1, emojiIsraelFlag), new HolidayEvent(new HDate(day + 1, IYYAR, year), 'Yom HaAtzma\'ut', MODERN_HOLIDAY$1, emojiIsraelFlag));
+  if (yomHaZikaronDt) {
+    add(new HolidayEvent(yomHaZikaronDt, 'Yom HaZikaron', MODERN_HOLIDAY$1, emojiIsraelFlag), new HolidayEvent(yomHaZikaronDt.next(), 'Yom HaAtzma\'ut', MODERN_HOLIDAY$1, emojiIsraelFlag));
   }
 
   if (year >= 5727) {
@@ -5609,7 +5647,7 @@ function getBirthdayOrAnniversary_(hyear, gdate) {
   return new HDate(day, month, hyear);
 }
 
-const version="3.41.3";
+const version="3.42.0";
 
 const headers$1={"plural-forms":"nplurals=2; plural=(n > 1);",language:"en_CA@ashkenazi"};const contexts$1={"":{Berachot:["Berachos"],Shabbat:["Shabbos"],Taanit:["Taanis"],Yevamot:["Yevamos"],Ketubot:["Kesubos"],"Baba Batra":["Baba Basra"],Makkot:["Makkos"],Shevuot:["Shevuos"],Horayot:["Horayos"],Menachot:["Menachos"],Bechorot:["Bechoros"],Keritot:["Kerisos"],Midot:["Midos"],"Achrei Mot":["Achrei Mos"],Bechukotai:["Bechukosai"],"Beha'alotcha":["Beha'aloscha"],Bereshit:["Bereshis"],Chukat:["Chukas"],"Erev Shavuot":["Erev Shavuos"],"Erev Sukkot":["Erev Sukkos"],"Ki Tavo":["Ki Savo"],"Ki Teitzei":["Ki Seitzei"],"Ki Tisa":["Ki Sisa"],Matot:["Matos"],"Purim Katan":["Purim Koton"],Tazria:["Sazria"],"Shabbat Chazon":["Shabbos Chazon"],"Shabbat HaChodesh":["Shabbos HaChodesh"],"Shabbat HaGadol":["Shabbos HaGadol"],"Shabbat Nachamu":["Shabbos Nachamu"],"Shabbat Parah":["Shabbos Parah"],"Shabbat Shekalim":["Shabbos Shekalim"],"Shabbat Shuva":["Shabbos Shuvah"],"Shabbat Zachor":["Shabbos Zachor"],Shavuot:["Shavuos"],"Shavuot I":["Shavuos I"],"Shavuot II":["Shavuos II"],Shemot:["Shemos"],"Shmini Atzeret":["Shmini Atzeres"],"Simchat Torah":["Simchas Torah"],Sukkot:["Sukkos"],"Sukkot I":["Sukkos I"],"Sukkot II":["Sukkos II"],"Sukkot II (CH''M)":["Sukkos II (CH''M)"],"Sukkot III (CH''M)":["Sukkos III (CH''M)"],"Sukkot IV (CH''M)":["Sukkos IV (CH''M)"],"Sukkot V (CH''M)":["Sukkos V (CH''M)"],"Sukkot VI (CH''M)":["Sukkos VI (CH''M)"],"Sukkot VII (Hoshana Raba)":["Sukkos VII (Hoshana Raba)"],"Ta'anit Bechorot":["Ta'anis Bechoros"],"Ta'anit Esther":["Ta'anis Esther"],Toldot:["Toldos"],Vaetchanan:["Vaeschanan"],Yitro:["Yisro"],"Vezot Haberakhah":["Vezos Haberakhah"],Parashat:["Parshas"],"Leil Selichot":["Leil Selichos"],"Shabbat Mevarchim Chodesh":["Shabbos Mevorchim Chodesh"],"Shabbat Shirah":["Shabbos Shirah"],Tevet:["Teves"],"Asara B'Tevet":["Asara B'Teves"],Berakhot:["Berakhos"],Sheviit:["Sheviis"],Terumot:["Terumos"],Maasrot:["Maasros"],Eduyot:["Eduyos"],Avot:["Avos"],Bekhorot:["Bekhoros"],Middot:["Middos"],Oholot:["Oholos"],Tahorot:["Tahoros"],Mikvaot:["Mikvaos"],"Alot HaShachar":["Alos HaShachar"],Misheyakir:["Misheyakir"],"Kriat Shema, sof zeman":["Krias Shema, sof zman"],"Tefilah, sof zeman":["Tefilah, sof zman"],"Chatzot hayom":["Chatzos"],"Tzait HaKochavim":["Tzeis HaKochavim"]}};var poAshkenazi = {headers:headers$1,contexts:contexts$1};
 
@@ -5633,6 +5671,186 @@ const poHeNoNikud = {
 };
 Locale.addLocale('he-x-NoNikud', poHeNoNikud);
 
+const NONE$1 = 0;
+const HALF = 1;
+const WHOLE = 2;
+/**
+ * @private
+ * @param {Event[]} events
+ * @param {HDate} hdate
+ * @return {number}
+ */
+
+function hallel_(events, hdate) {
+  const whole = events.filter(ev => {
+    /** @type {string} */
+    const desc = ev.getDesc();
+    /** @type {HDate} */
+
+    const hd = ev.getDate();
+    const month = hd.getMonth();
+    const mday = hd.getDate();
+    return desc.startsWith('Chanukah') || desc.startsWith('Shavuot') || desc.startsWith('Sukkot') || month === months.NISAN && (mday === 15 || mday === 16) && ev.getFlags() & flags.CHAG || // Pesach
+    desc === 'Yom HaAtzma\'ut' || desc === 'Yom Yerushalayim';
+  }).map(ev => {
+    return ev.getDate().abs();
+  });
+  const abs = hdate.abs();
+
+  if (whole.includes(abs)) {
+    return WHOLE;
+  }
+
+  const half = events.filter(ev => {
+    const desc = ev.getDesc();
+    return ev.getFlags() & flags.ROSH_CHODESH || desc.startsWith('Pesach') && desc !== 'Pesach I' && desc !== 'Pesach II';
+  }).map(ev => {
+    return ev.getDate().abs();
+  });
+
+  if (half.includes(abs)) {
+    return HALF;
+  }
+
+  return NONE$1;
+}
+
+/**
+ * @private
+ * @param {number} start
+ * @param {number} end
+ * @return {number[]}
+ */
+
+function range(start, end) {
+  const arr = [];
+
+  for (let i = start; i <= end; i++) {
+    arr.push(i);
+  }
+
+  return arr;
+}
+
+const cache = Object.create(null);
+const NONE = {
+  shacharit: false,
+  mincha: false,
+  allCongs: false
+};
+/**
+ * @private
+ * @param {HDate} hdate
+ * @param {boolean} il
+ * @return {TachanunResult}
+ */
+
+function tachanun_(hdate, il) {
+  return tachanun0(hdate, il, true);
+}
+/**
+ * @private
+ * @param {HDate} hdate
+ * @param {boolean} il
+ * @param {boolean} checkNext
+ * @return {TachanunResult}
+ */
+
+function tachanun0(hdate, il, checkNext) {
+  const year = hdate.getFullYear();
+  const key = `${year}-${il ? 1 : 0}`;
+  const dates = cache[key] = cache[key] || tachanunYear(year, il);
+  const abs = hdate.abs();
+
+  if (dates.none.indexOf(abs) > -1) {
+    return NONE;
+  }
+
+  const dow = hdate.getDay();
+  const ret = {
+    shacharit: false,
+    mincha: false,
+    allCongs: false
+  };
+
+  if (dates.some.indexOf(abs) === -1) {
+    ret.allCongs = true;
+  }
+
+  if (dow !== 6) {
+    ret.shacharit = true;
+  }
+
+  const tomorrow = abs + 1;
+
+  if (checkNext && dates.yesPrev.indexOf(tomorrow) === -1) {
+    const tmp = tachanun0(new HDate(tomorrow), il, false);
+    ret.mincha = tmp.shacharit;
+  } else {
+    ret.mincha = dow !== 5;
+  }
+
+  if (ret.allCongs && !ret.mincha && !ret.shacharit) {
+    return NONE;
+  }
+
+  return ret;
+}
+/**
+ * @private
+ * @param {number} year
+ * @param {boolean} il
+ * @return {*}
+ */
+
+
+function tachanunYear(year, il) {
+  const leap = HDate.isLeapYear(year);
+  const monthsInYear = 12 + leap;
+  let av9dt = new HDate(9, months.AV, year);
+
+  if (av9dt.getDay() === 6) {
+    av9dt = av9dt.next();
+  }
+
+  let shushPurim = new HDate(15, months.ADAR_II, year);
+
+  if (shushPurim.getDay() === 6) {
+    shushPurim = shushPurim.next();
+  }
+
+  const none = [].concat( // Rosh Chodesh - 1st of every month. Also includes RH day 1 (1 Tishrei)
+  range(1, monthsInYear).map(month => new HDate(1, month, year)), // Rosh Chodesh - 30th of months that have one
+  range(1, monthsInYear).filter(month => HDate.daysInMonth(month, year) === 30).map(month => new HDate(30, month, year)), new HDate(2, months.TISHREI, year), // Rosh Hashana II
+  // entire month of Nisan
+  range(1, HDate.daysInMonth(months.NISAN, year)).map(mday => new HDate(mday, months.NISAN, year)), new HDate(18, months.IYYAR, year), // Lag BaOmer
+  // Rosh Chodesh Sivan thru Isru Chag
+  range(1, 8 - (il ? 1 : 0)).map(mday => new HDate(mday, months.SIVAN, year)), av9dt, // Tisha B'Av
+  new HDate(15, months.AV, year), // Tu B'Av
+  new HDate(29, months.ELUL, year), // Erev Rosh Hashanah
+  // Erev Yom Kippur thru Isru Chag
+  range(9, 24 - (il ? 1 : 0)).map(mday => new HDate(mday, months.TISHREI, year)), // Chanukah
+  range(25, 33).map(mday => new HDate(mday, months.KISLEV, year)), new HDate(15, months.SHVAT, year), // Tu BiShvat
+  new HDate(14, months.ADAR_II, year), // Purim
+  shushPurim, leap ? new HDate(14, months.ADAR_I, year) : [] // Purim Katan
+  );
+  const some = [].concat( // Until 14 Sivan
+  range(1, 13).map(mday => new HDate(mday, months.SIVAN, year)), // Until after Rosh Chodesh Cheshvan
+  range(20, 31).map(mday => new HDate(mday, months.TISHREI, year)), new HDate(14, months.IYYAR, year), // Pesach Sheini
+  // Yom HaAtzma'ut, which changes based on day of week
+  year >= 5708 ? dateYomHaZikaron(year).next() : [], // Yom Yerushalayim
+  year >= 5727 ? new HDate(28, months.IYYAR, year) : []);
+  const yesPrev = [].concat(new HDate(29, months.ELUL, year - 1), // Erev Rosh Hashanah
+  new HDate(9, months.TISHREI, year), // Erev Yom Kippur
+  new HDate(14, months.IYYAR, year) // Pesach Sheini
+  );
+  return {
+    none: none.map(hd => hd.abs()).sort(),
+    some: some.map(hd => hd.abs()).sort(),
+    yesPrev: yesPrev.map(hd => hd.abs()).sort()
+  };
+}
+
 /*
     Hebcal - A Jewish Calendar Generator
     Copyright (c) 1994-2020 Danny Sadinoff
@@ -5827,6 +6045,13 @@ function checkCandleOptions(options) {
  *      Possible values are `true` and `false`; the default is locale dependent.
  */
 
+/**
+ * @typedef {Object} TachanunResult
+ * @property {boolean} shacharit Tachanun is said at Shacharit
+ * @property {boolean} mincha Tachanun is said at Mincha
+ * @property {boolean} allCongs All congregations say Tachanun on the day
+ */
+
 /**
  * Gets the R.D. days for a number, Date, or HDate
  * @private
@@ -6040,6 +6265,8 @@ function observedInIsrael(ev) {
 function observedInDiaspora(ev) {
   return ev.observedInDiaspora();
 }
+
+const yearArrayCache = Object.create(null);
 /**
  * HebrewCalendar is the main interface to the `@hebcal/core` library.
  * This namespace is used to calculate holidays, rosh chodesh, candle lighting & havdalah times,
@@ -6047,7 +6274,6 @@ function observedInDiaspora(ev) {
  * Event names can be rendered in several languges using the `locale` option.
  */
 
-
 class HebrewCalendar {
   /**
    * Calculates holidays and other Hebrew calendar events based on {@link CalOptions}.
@@ -6383,10 +6609,17 @@ class HebrewCalendar {
 
 
   static getHolidaysForYearArray(year, il) {
+    const cacheKey = `${year}-${il ? 1 : 0}`;
+    let events = yearArrayCache[cacheKey];
+
+    if (events) {
+      return events;
+    }
+
     const yearMap = getHolidaysForYear_(year);
     const startAbs = HDate.hebrew2abs(year, TISHREI, 1);
     const endAbs = HDate.hebrew2abs(year + 1, TISHREI, 1) - 1;
-    let events = [];
+    events = [];
     const myFilter = il ? observedInIsrael : observedInDiaspora;
 
     for (let absDt = startAbs; absDt <= endAbs; absDt++) {
@@ -6399,6 +6632,7 @@ class HebrewCalendar {
       }
     }
 
+    yearArrayCache[cacheKey] = events;
     return events;
   }
   /**
@@ -6476,6 +6710,54 @@ class HebrewCalendar {
   static getSedra(hyear, il) {
     return getSedra_(hyear, il);
   }
+  /**
+   * Return a number containing information on what Hallel is said on that day.
+   *
+   * Whole Hallel is said on Chanukah, the first Yom Tov of Pesach, Shavuot, Sukkot,
+   * Yom Ha'atzmaut, and Yom Yerushalayim.
+   *
+   * Half Hallel is said on Rosh Chodesh (not Rosh Hashanah), and the last 6 days of Pesach.
+   *
+   * The number is one of the following values:
+   *
+   * 0 - No Hallel
+   * 1 - Half Hallel
+   * 2 - Whole Hallel
+   *
+   * @param {HDate} hdate
+   * @param {boolean} il
+   * @return {number}
+   */
+
+
+  static hallel(hdate, il) {
+    const events = HebrewCalendar.getHolidaysForYearArray(hdate.getFullYear(), il);
+    return hallel_(events, hdate);
+  }
+  /**
+   * Return details on what Tachanun (or Tzidchatcha on Shabbat) is said on `hdate`.
+   *
+   * Tachanun is not said on Rosh Chodesh, the month of Nisan, Lag Baomer,
+   * Rosh Chodesh Sivan until Isru Chag, Tisha B'av, 15 Av, Erev Rosh Hashanah,
+   * Rosh Hashanah, Erev Yom Kippur until after Simchat Torah, Chanukah,
+   * Tu B'shvat, Purim and Shushan Purim, and Purim and Shushan Purim Katan.
+   *
+   * In some congregations Tachanun is not said until from Rosh Chodesh Sivan
+   * until 14th Sivan, Sukkot until after Rosh Chodesh Cheshvan, Pesach Sheini,
+   * Yom Ha'atzmaut, and Yom Yerushalayim.
+   *
+   * Tachanun is not said at Mincha on days before it is not said at Shacharit.
+   *
+   * Tachanun is not said at Shacharit on Shabbat, but is at Mincha, usually.
+   * @param {HDate} hdate
+   * @param {boolean} il
+   * @return {TachanunResult}
+   */
+
+
+  static tachanun(hdate, il) {
+    return tachanun_(hdate, il);
+  }
 
 }
 /**

package/hebcal.d.ts

@@ -604,6 +604,15 @@ declare module '@hebcal/core' {
         hour12?: boolean;
     };
 
+    export type TachanunResult = {
+        /** Tachanun is said at Shacharit */
+        shacharit: boolean;
+        /** Tachanun is said at Mincha */
+        mincha: boolean;
+        /** All congregations say Tachanun on the day */
+        allCongs: boolean;
+    };
+
     /**
      * HebrewCalendar is the main interface to the `@hebcal/core` library.
      * This class is used to calculate holidays, rosh chodesh, candle lighting & havdalah times,
@@ -713,6 +722,40 @@ declare module '@hebcal/core' {
          * created and cached instance.
          */
         static getSedra(hyear: number, il: boolean): Sedra;
+
+        /**
+         * Return a number containing information on what Hallel is said on that day.
+         *
+         * Whole Hallel is said on Chanukah, the first Yom Tov of Pesach, Shavuot, Sukkot,
+         * Yom Ha'atzmaut, and Yom Yerushalayim.
+         *
+         * Half Hallel is said on Rosh Chodesh (not Rosh Hashanah), and the last 6 days of Pesach.
+         *
+         * The number is one of the following values:
+         *
+         * 0 - No Hallel
+         * 1 - Half Hallel
+         * 2 - Whole Hallel
+         */
+        static hallel(hdate: HDate, il: boolean): number;
+
+        /**
+         * Return details on what Tachanun (or Tzidchatcha on Shabbat) is said on `hdate`.
+         *
+         * Tachanun is not said on Rosh Chodesh, the month of Nisan, Lag Baomer,
+         * Rosh Chodesh Sivan until Isru Chag, Tisha B'av, 15 Av, Erev Rosh Hashanah,
+         * Rosh Hashanah, Erev Yom Kippur until after Simchat Torah, Chanukah,
+         * Tu B'shvat, Purim and Shushan Purim, and Purim and Shushan Purim Katan.
+         *
+         * In some congregations Tachanun is not said until from Rosh Chodesh Sivan
+         * until 14th Sivan, Sukkot until after Rosh Chodesh Cheshvan, Pesach Sheini,
+         * Yom Ha'atzmaut, and Yom Yerushalayim.
+         *
+         * Tachanun is not said at Mincha on days before it is not said at Shacharit.
+         *
+         * Tachanun is not said at Shacharit on Shabbat, but is at Mincha, usually.
+         */
+        static tachanun(hdate: HDate, il: boolean): TachanunResult;
     }
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hebcal/core",
-  "version": "3.41.4",
+  "version": "3.42.0",
   "author": "Michael J. Radwin (https://github.com/mjradwin)",
   "contributors": [
     "Eyal Schachter (https://github.com/Scimonster)",