@hebcal/core 5.4.7 → 5.4.9

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/*! @hebcal/core v5.4.7 */
+/*! @hebcal/core v5.4.9 */
 /* eslint-disable @typescript-eslint/no-namespace, no-inner-declarations */
 /** @private */
 const lengths = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
@@ -37,107 +37,106 @@ function yearFromFixed(abs) {
 const ABS_14SEP1752 = 639797;
 const ABS_2SEP1752 = 639785;
 */
+/*
+ * Formerly in namespace, now top-level
+ */
 /**
- * Gregorian date helper functions.
+ * Returns true if the Gregorian year is a leap year
+ * @param year Gregorian year
  */
-var greg;
-(function (greg) {
-    /**
-     * Returns true if the Gregorian year is a leap year
-     * @param {number} year Gregorian year
-     * @return {boolean}
-     */
-    function isLeapYear(year) {
-        return !(year % 4) && (!!(year % 100) || !(year % 400));
+function isGregLeapYear(year) {
+    return !(year % 4) && (!!(year % 100) || !(year % 400));
+}
+/**
+ * Number of days in the Gregorian month for given year
+ * @param month Gregorian month (1=January, 12=December)
+ * @param year Gregorian year
+ */
+function daysInGregMonth(month, year) {
+    // 1 based months
+    return monthLengths[+isGregLeapYear(year)][month];
+}
+/**
+ * Returns true if the object is a Javascript Date
+ */
+function isDate(obj) {
+    // eslint-disable-next-line no-prototype-builtins
+    return typeof obj === 'object' && Date.prototype.isPrototypeOf(obj);
+}
+/**
+ * @private
+ * @param year
+ * @param month (1-12)
+ * @param day (1-31)
+ */
+function toFixed(year, month, day) {
+    const py = year - 1;
+    return (365 * py +
+        quotient(py, 4) -
+        quotient(py, 100) +
+        quotient(py, 400) +
+        quotient(367 * month - 362, 12) +
+        (month <= 2 ? 0 : isGregLeapYear(year) ? -1 : -2) +
+        day);
+}
+/**
+ * Converts Gregorian date to absolute R.D. (Rata Die) days
+ * @param date Gregorian date
+ */
+function greg2abs(date) {
+    if (!isDate(date)) {
+        throw new TypeError(`Argument not a Date: ${date}`);
     }
-    greg.isLeapYear = isLeapYear;
-    /**
-     * Number of days in the Gregorian month for given year
-     * @param {number} month Gregorian month (1=January, 12=December)
-     * @param {number} year Gregorian year
-     * @return {number}
-     */
-    function daysInMonth(month, year) {
-        // 1 based months
-        return monthLengths[+isLeapYear(year)][month];
+    const abs = toFixed(date.getFullYear(), date.getMonth() + 1, date.getDate());
+    /*
+      if (abs < ABS_14SEP1752 && abs > ABS_2SEP1752) {
+        throw new RangeError(`Invalid Date: ${date}`);
+      }
+      */
+    return abs;
+}
+/**
+ * Converts from Rata Die (R.D. number) to Gregorian date.
+ * See the footnote on page 384 of ``Calendrical Calculations, Part II:
+ * Three Historical Calendars'' by E. M. Reingold,  N. Dershowitz, and S. M.
+ * Clamen, Software--Practice and Experience, Volume 23, Number 4
+ * (April, 1993), pages 383-404 for an explanation.
+ * @param abs - R.D. number of days
+ */
+function abs2greg(abs) {
+    if (typeof abs !== 'number') {
+        throw new TypeError(`Argument not a Number: ${abs}`);
     }
-    greg.daysInMonth = daysInMonth;
-    /**
-     * Returns true if the object is a Javascript Date
-     * @param {Object} obj
-     * @return {boolean}
-     */
-    function isDate(obj) {
-        // eslint-disable-next-line no-prototype-builtins
-        return typeof obj === 'object' && Date.prototype.isPrototypeOf(obj);
+    abs = Math.trunc(abs);
+    /*
+      if (abs < ABS_14SEP1752 && abs > ABS_2SEP1752) {
+        throw new RangeError(`Invalid Date: ${abs}`);
+      }
+      */
+    const year = yearFromFixed(abs);
+    const priorDays = abs - toFixed(year, 1, 1);
+    const correction = abs < toFixed(year, 3, 1) ? 0 : isGregLeapYear(year) ? 1 : 2;
+    const month = quotient(12 * (priorDays + correction) + 373, 367);
+    const day = abs - toFixed(year, month, 1) + 1;
+    const dt = new Date(year, month - 1, day);
+    if (year < 100 && year >= 0) {
+        dt.setFullYear(year);
     }
-    greg.isDate = isDate;
-    /**
-     * @private
-     * @param year
-     * @param month (1-12)
-     * @param day (1-31)
-     */
-    function toFixed(year, month, day) {
-        const py = year - 1;
-        return (365 * py +
-            quotient(py, 4) -
-            quotient(py, 100) +
-            quotient(py, 400) +
-            quotient(367 * month - 362, 12) +
-            (month <= 2 ? 0 : isLeapYear(year) ? -1 : -2) +
-            day);
-    }
-    /**
-     * Converts Gregorian date to absolute R.D. (Rata Die) days
-     * @param {Date} date Gregorian date
-     * @return {number}
-     */
-    function greg2abs(date) {
-        if (!isDate(date)) {
-            throw new TypeError(`Argument not a Date: ${date}`);
-        }
-        const abs = toFixed(date.getFullYear(), date.getMonth() + 1, date.getDate());
-        /*
-        if (abs < ABS_14SEP1752 && abs > ABS_2SEP1752) {
-          throw new RangeError(`Invalid Date: ${date}`);
-        }
-        */
-        return abs;
-    }
-    greg.greg2abs = greg2abs;
-    /**
-     * Converts from Rata Die (R.D. number) to Gregorian date.
-     * See the footnote on page 384 of ``Calendrical Calculations, Part II:
-     * Three Historical Calendars'' by E. M. Reingold,  N. Dershowitz, and S. M.
-     * Clamen, Software--Practice and Experience, Volume 23, Number 4
-     * (April, 1993), pages 383-404 for an explanation.
-     * @param {number} abs - R.D. number of days
-     * @return {Date}
-     */
-    function abs2greg(abs) {
-        if (typeof abs !== 'number') {
-            throw new TypeError(`Argument not a Number: ${abs}`);
-        }
-        abs = Math.trunc(abs);
-        /*
-        if (abs < ABS_14SEP1752 && abs > ABS_2SEP1752) {
-          throw new RangeError(`Invalid Date: ${abs}`);
-        }
-        */
-        const year = yearFromFixed(abs);
-        const priorDays = abs - toFixed(year, 1, 1);
-        const correction = abs < toFixed(year, 3, 1) ? 0 : isLeapYear(year) ? 1 : 2;
-        const month = quotient(12 * (priorDays + correction) + 373, 367);
-        const day = abs - toFixed(year, month, 1) + 1;
-        const dt = new Date(year, month - 1, day);
-        if (year < 100 && year >= 0) {
-            dt.setFullYear(year);
-        }
-        return dt;
-    }
-    greg.abs2greg = abs2greg;
+    return dt;
+}
+
+/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-namespace */
+/**
+ * Gregorian date helper functions
+ */
+var greg;
+(function (greg) {
 })(greg || (greg = {}));
+greg.abs2greg = abs2greg;
+greg.daysInMonth = daysInGregMonth;
+greg.greg2abs = greg2abs;
+greg.isDate = isDate;
+greg.isLeapYear = isGregLeapYear;
 
 /*
  * More minimal HDate
@@ -227,10 +226,9 @@ function assertNumber(n, name) {
  * Converts Hebrew date to R.D. (Rata Die) fixed days.
  * R.D. 1 is the imaginary date Monday, January 1, 1 on the Gregorian
  * Calendar.
- * @param {number} year Hebrew year
- * @param {number} month Hebrew month
- * @param {number} day Hebrew date (1-30)
- * @return {number}
+ * @param year Hebrew year
+ * @param month Hebrew month
+ * @param day Hebrew date (1-30)
  */
 function hebrew2abs(year, month, day) {
     assertNumber(year, 'year');
@@ -263,8 +261,7 @@ function newYear(year) {
 }
 /**
  * Converts absolute R.D. days to Hebrew date
- * @param {number} abs absolute R.D. days
- * @return {SimpleHebrewDate}
+ * @param abs absolute R.D. days
  */
 function abs2hebrew(abs) {
     assertNumber(abs, 'abs');
@@ -287,25 +284,22 @@ function abs2hebrew(abs) {
 }
 /**
  * Returns true if Hebrew year is a leap year
- * @param {number} year Hebrew year
- * @return {boolean}
+ * @param year Hebrew year
  */
 function isLeapYear(year) {
     return (1 + year * 7) % 19 < 7;
 }
 /**
  * Number of months in this Hebrew year (either 12 or 13 depending on leap year)
- * @param {number} year Hebrew year
- * @return {number}
+ * @param year Hebrew year
  */
 function monthsInYear(year) {
     return 12 + +isLeapYear(year); // boolean is cast to 1 or 0
 }
 /**
  * Number of days in Hebrew month in a given year (29 or 30)
- * @param {number} month Hebrew month (e.g. months.TISHREI)
- * @param {number} year Hebrew year
- * @return {number}
+ * @param month Hebrew month (e.g. months.TISHREI)
+ * @param year Hebrew year
  */
 function daysInMonth(month, year) {
     switch (month) {
@@ -328,8 +322,8 @@ function daysInMonth(month, year) {
 /**
  * Returns a transliterated string name of Hebrew month in year,
  * for example 'Elul' or 'Cheshvan'.
- * @param {number} month Hebrew month (e.g. months.TISHREI)
- * @param {number} year Hebrew year
+ * @param month Hebrew month (e.g. months.TISHREI)
+ * @param year Hebrew year
  */
 function getMonthName(month, year) {
     assertNumber(month, 'month');
@@ -342,8 +336,7 @@ function getMonthName(month, year) {
 /**
  * Days from sunday prior to start of Hebrew calendar to mean
  * conjunction of Tishrei in Hebrew YEAR
- * @param {number} year Hebrew year
- * @return {number}
+ * @param year Hebrew year
  */
 function elapsedDays(year) {
     const n = edCache.get(year);
@@ -389,32 +382,28 @@ function elapsedDays0(year) {
  * Number of days in the hebrew YEAR.
  * A common Hebrew calendar year can have a length of 353, 354 or 355 days
  * A leap Hebrew calendar year can have a length of 383, 384 or 385 days
- * @param {number} year Hebrew year
- * @return {number}
+ * @param year Hebrew year
  */
 function daysInYear(year) {
     return elapsedDays(year + 1) - elapsedDays(year);
 }
 /**
  * true if Cheshvan is long in Hebrew year
- * @param {number} year Hebrew year
- * @return {boolean}
+ * @param year Hebrew year
  */
 function longCheshvan(year) {
     return daysInYear(year) % 10 === 5;
 }
 /**
  * true if Kislev is short in Hebrew year
- * @param {number} year Hebrew year
- * @return {boolean}
+ * @param year Hebrew year
  */
 function shortKislev(year) {
     return daysInYear(year) % 10 === 3;
 }
 /**
  * Converts Hebrew month string name to numeric
- * @param {string} monthName monthName
- * @return {number}
+ * @param monthName monthName
  */
 function monthFromName(monthName) {
     if (typeof monthName === 'number') {
@@ -539,7 +528,6 @@ const ADAR_II$1 = months.ADAR_II;
 /**
  * Returns true if the object is a SimpleHebrewDate
  * @private
- * @param {Object} obj
  */
 function isSimpleHebrewDate$1(obj) {
     return (typeof obj === 'object' &&
@@ -558,8 +546,8 @@ function toSimpleHebrewDate(obj) {
     else if (typeof obj === 'number') {
         return abs2hebrew(obj);
     }
-    else if (greg.isDate(obj)) {
-        const abs = greg.greg2abs(obj);
+    else if (isDate(obj)) {
+        const abs = greg2abs(obj);
         return abs2hebrew(abs);
     }
     else {
@@ -706,8 +694,6 @@ function num2digits(num) {
  * gematriya(60) // 'ס׳'
  * gematriya(3761) // 'ג׳תשס״א'
  * gematriya(1123) // 'א׳קכ״ג'
- * @param {number} num
- * @return {string}
  */
 function gematriya(num) {
     const num0 = num;
@@ -742,9 +728,6 @@ function gematriya(num) {
  * Only considers the value of Hebrew letters `א` through `ת`.
  * Ignores final Hebrew letters such as `ך` (kaf sofit) or `ם` (mem sofit)
  * and vowels (nekudot).
- *
- * @param {string} str
- * @return {number}
  */
 function gematriyaStrToNum(str) {
     let num = 0;
@@ -1024,8 +1007,6 @@ function molad(year, month) {
 const _formatters = new Map();
 /**
  * @private
- * @param {string} tzid
- * @return {Intl.DateTimeFormat}
  */
 function getFormatter$1(tzid) {
     const fmt = _formatters.get(tzid);
@@ -1049,9 +1030,6 @@ const dateFormatRegex = /^(\d+).(\d+).(\d+),?\s+(\d+).(\d+).(\d+)/;
  * Returns a string similar to `Date.toISOString()` but in the
  * timezone `tzid`. Contrary to the typical meaning of `Z` at the end
  * of the string, this is not actually a UTC date.
- * @param {string} tzid
- * @param {Date} date
- * @return {string}
  */
 function getPseudoISO(tzid, date) {
     const str = getFormatter$1(tzid).format(date);
@@ -1068,9 +1046,6 @@ function getPseudoISO(tzid, date) {
 }
 /**
  * Returns number of minutes `tzid` is offset from UTC on date `date`.
- * @param {string} tzid
- * @param {Date} date
- * @return {number}
  */
 function getTimezoneOffset(tzid, date) {
     const utcStr = getPseudoISO('UTC', date);
@@ -1083,8 +1058,6 @@ function getTimezoneOffset(tzid, date) {
  * Similar to `string.padStart(4, '0')` but will also format
  * negative numbers similar to how the JavaScript date formats
  * negative year numbers (e.g. `-37` is formatted as `-000037`).
- * @param {number} number
- * @return {string}
  */
 function pad4(number) {
     if (number < 0) {
@@ -1104,8 +1077,6 @@ function pad4(number) {
 /**
  * Formats a number with leading zeros so the resulting string is 2 digits long.
  * Similar to `string.padStart(2, '0')`.
- * @param {number} number
- * @return {string}
  */
 function pad2(number) {
     if (number < 10) {
@@ -1115,9 +1086,6 @@ function pad2(number) {
 }
 /**
  * Returns YYYY-MM-DD in the local timezone
- * @private
- * @param {Date} dt
- * @return {string}
  */
 function isoDateString(dt) {
     return (pad4(dt.getFullYear()) +
@@ -1136,9 +1104,9 @@ const noopLocale = {
     contexts: { '': {} },
 };
 const alias = {
-    'h': 'he',
-    'a': 'ashkenazi',
-    's': 'en',
+    h: 'he',
+    a: 'ashkenazi',
+    s: 'en',
     '': 'en',
 };
 /** @private */
@@ -1159,12 +1127,12 @@ class Locale {
     /**
      * Returns translation only if `locale` offers a non-empty translation for `id`.
      * Otherwise, returns `undefined`.
-     * @param {string} id Message ID to translate
-     * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
-     * @return {string}
+     * @param id Message ID to translate
+     * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
      */
     static lookupTranslation(id, locale) {
-        const loc = (typeof locale === 'string' && locales.get(locale.toLowerCase())) || activeLocale;
+        const loc = (typeof locale === 'string' && locales.get(locale.toLowerCase())) ||
+            activeLocale;
         const array = loc[id];
         if ((array === null || array === void 0 ? void 0 : array.length) && array[0].length) {
             return array[0];
@@ -1173,9 +1141,8 @@ class Locale {
     }
     /**
      * By default, if no translation was found, returns `id`.
-     * @param {string} id Message ID to translate
-     * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
-     * @return {string}
+     * @param id Message ID to translate
+     * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
      */
     static gettext(id, locale) {
         const text = this.lookupTranslation(id, locale);
@@ -1186,23 +1153,24 @@ class Locale {
     }
     /**
      * Register locale translations.
-     * @param {string} locale Locale name (i.e.: `'he'`, `'fr'`)
-     * @param {LocaleData} data parsed data from a `.po` file.
+     * @param locale Locale name (i.e.: `'he'`, `'fr'`)
+     * @param data parsed data from a `.po` file.
      */
     static addLocale(locale, data) {
         if (typeof locale !== 'string') {
             throw new TypeError(`Invalid locale name: ${locale}`);
         }
-        if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
+        if (typeof data.contexts !== 'object' ||
+            typeof data.contexts[''] !== 'object') {
             throw new TypeError(`Locale '${locale}' invalid compact format`);
         }
         locales.set(locale.toLowerCase(), data.contexts['']);
     }
     /**
      * Adds a translation to `locale`, replacing any previous translation.
-     * @param {string} locale Locale name (i.e: `'he'`, `'fr'`).
-     * @param {string} id Message ID to translate
-     * @param {string | string[]} translation Translation text
+     * @param locale Locale name (i.e: `'he'`, `'fr'`).
+     * @param id Message ID to translate
+     * @param translation Translation text
      */
     static addTranslation(locale, id, translation) {
         if (typeof locale !== 'string') {
@@ -1229,8 +1197,8 @@ class Locale {
     }
     /**
      * Adds multiple translations to `locale`, replacing any previous translations.
-     * @param {string} locale Locale name (i.e: `'he'`, `'fr'`).
-     * @param {LocaleData} data parsed data from a `.po` file.
+     * @param locale Locale name (i.e: `'he'`, `'fr'`).
+     * @param data parsed data from a `.po` file.
      */
     static addTranslations(locale, data) {
         if (typeof locale !== 'string') {
@@ -1240,7 +1208,8 @@ class Locale {
         if (!loc) {
             throw new TypeError(`Unknown locale: ${locale}`);
         }
-        if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
+        if (typeof data.contexts !== 'object' ||
+            typeof data.contexts[''] !== 'object') {
             throw new TypeError(`Locale '${locale}' invalid compact format`);
         }
         const ctx = data.contexts[''];
@@ -1250,7 +1219,7 @@ class Locale {
      * Activates a locale. Throws an error if the locale has not been previously added.
      * After setting the locale to be used, all strings marked for translations
      * will be represented by the corresponding translation in the specified locale.
-     * @param {string} locale Locale name (i.e: `'he'`, `'fr'`)
+     * @param locale Locale name (i.e: `'he'`, `'fr'`)
      */
     static useLocale(locale) {
         const locale0 = locale.toLowerCase();
@@ -1264,23 +1233,20 @@ class Locale {
     }
     /**
      * Returns the name of the active locale (i.e. 'he', 'ashkenazi', 'fr')
-     * @return {string}
      */
     static getLocaleName() {
         return activeName;
     }
     /**
      * Returns the names of registered locales
-     * @return {string[]}
      */
     static getLocaleNames() {
         const keys = Array.from(locales.keys());
         return keys.sort((a, b) => a.localeCompare(b));
     }
     /**
-     * @param {number} n
-     * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
-     * @return {string}
+     * Renders a number in ordinal, such as 1st, 2nd or 3rd
+     * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
      */
     static ordinal(n, locale) {
         const locale1 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
@@ -1307,11 +1273,6 @@ class Locale {
                 return n + '.';
         }
     }
-    /**
-     * @private
-     * @param {number} n
-     * @return {string}
-     */
     static getEnOrdinal(n) {
         const s = ['th', 'st', 'nd', 'rd'];
         const v = n % 100;
@@ -1319,8 +1280,6 @@ class Locale {
     }
     /**
      * Removes nekudot from Hebrew string
-     * @param {string} str
-     * @return {string}
      */
     static hebrewStripNikkud(str) {
         return str.replace(/[\u0590-\u05bd]/g, '').replace(/[\u05bf-\u05c7]/g, '');
@@ -1368,10 +1327,10 @@ Locale.addLocale('he-x-NoNikud', poHeNoNikud$1);
     You should have received a copy of the GNU General Public License
     along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
-// eslint-disable-next-line require-jsdoc
 function mod(x, y) {
     return x - y * Math.floor(x / y);
 }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function isSimpleHebrewDate(obj) {
     return obj.yy !== undefined;
 }
@@ -1379,7 +1338,24 @@ const UNITS_DAY = 'day';
 const UNITS_WEEK = 'week';
 const UNITS_MONTH = 'month';
 const UNITS_YEAR = 'year';
-/** Represents a Hebrew date */
+/**
+ * A `HDate` represents a Hebrew calendar date.
+ *
+ * An instance of this class encapsulates a date in the Hebrew calendar system.
+ * It consists of a year, month, and day, without any associated time or location data.
+ * The Hebrew calendar is a lunisolar calendar, meaning it is based on both lunar and solar cycles.
+ *
+ * A Hebrew date internally stores three numbers:
+ * - year: The Hebrew year (1-9999). Counted from the traditional Hebrew date of creation (3761 BCE in the Gregorian calendar)
+ * - month: The Hebrew month (1-13). Month 1 is Nisan, month 7 is Tishrei. There are 12 months in a regular year and 13 months in a leap year.
+ * - day: The day of the month (1-30)
+ *
+ * This class uses Rata Die to convert between the Hebrew and Gregorian calendars.
+ *
+ * To calculate times of day, use `Zmanim` class from `@hebcal/core`
+ * @see {@link https://en.wikipedia.org/wiki/Rata_Die | Rata Die}
+ * @see {@link https://hebcal.github.io/api/core/classes/Zmanim.html | Zmanim}
+ */
 class HDate {
     /**
      * Create a Hebrew date. There are 3 basic forms for the `HDate()` constructor.
@@ -1404,12 +1380,12 @@ class HDate {
      * const hd5 = new HDate(733359); // ==> 15 Cheshvan 5769
      * const monthName = 'אייר';
      * const hd6 = new HDate(5, monthName, 5773);
-     * @param {number|Date|HDate} [day] - Day of month (1-30) if a `number`.
+     * @param [day] - Day of month (1-30) if a `number`.
      *   If a `Date` is specified, represents the Hebrew date corresponding to the
      *   Gregorian date using local time.
      *   If an `HDate` is specified, clones a copy of the given Hebrew date.
-     * @param {number|string} [month] - Hebrew month of year (1=NISAN, 7=TISHREI)
-     * @param {number} [year] - Hebrew year
+     * @param [month] - Hebrew month of year (1=NISAN, 7=TISHREI)
+     * @param [year] - Hebrew year
      */
     constructor(day, month, year) {
         if (arguments.length === 2 || arguments.length > 3) {
@@ -1436,9 +1412,13 @@ class HDate {
                 day = new Date();
             }
             // 1 argument
-            const abs0 = (typeof day === 'number' && !isNaN(day)) ? day :
-                greg.isDate(day) ? greg.greg2abs(day) :
-                    isSimpleHebrewDate(day) ? day : null;
+            const abs0 = typeof day === 'number' && !isNaN(day)
+                ? day
+                : isDate(day)
+                    ? greg2abs(day)
+                    : isSimpleHebrewDate(day)
+                        ? day
+                        : null;
             if (abs0 === null) {
                 throw new TypeError(`HDate called with bad argument: ${day}`);
             }
@@ -1453,68 +1433,99 @@ class HDate {
         }
     }
     /**
-     * Gets the Hebrew year of this Hebrew date
-     * @return {number}
+     * Returns the Hebrew year of this Hebrew date
+     * @returns an integer >= 1
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.getFullYear(); // 5769
      */
     getFullYear() {
         return this.yy;
     }
     /**
-     * Tests if this date occurs during a leap year
-     * @return {boolean}
+     * Returns `true` if this Hebrew date occurs during a Hebrew leap year
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.isLeapYear(); // false
      */
     isLeapYear() {
         return isLeapYear(this.yy);
     }
     /**
-     * Gets the Hebrew month (1=NISAN, 7=TISHREI) of this Hebrew date
-     * @return {number}
+     * Returns the Hebrew month (1=NISAN, 7=TISHREI) of this Hebrew date
+     * @returns an integer 1-13
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.getMonth(); // 8
      */
     getMonth() {
         return this.mm;
     }
     /**
-     * The Tishrei-based month of the date. 1 is Tishrei, 7 is Nisan, 13 is Elul in a leap year
-     * @return {number}
+     * The Tishrei-based month of this Hebrew date. 1 is Tishrei, 7 is Nisan, 13 is Elul in a leap year
+     * @returns an integer 1-13
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.getMonth(); // 2
      */
     getTishreiMonth() {
         const nummonths = monthsInYear(this.getFullYear());
         return (this.getMonth() + nummonths - 6) % nummonths || nummonths;
     }
     /**
-     * Number of days in the month of this Hebrew date
-     * @return {number}
+     * Number of days in the month of this Hebrew date (29 or 30)
+     * @returns an integer 29-30
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.daysInMonth(); // 29
      */
     daysInMonth() {
         return daysInMonth(this.getMonth(), this.getFullYear());
     }
     /**
      * Gets the day within the month (1-30)
-     * @return {number}
+     * @returns an integer 1-30
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.getDate(); // 15
      */
     getDate() {
         return this.dd;
     }
     /**
-     * Gets the day of the week. 0=Sunday, 6=Saturday
-     * @return {number}
+     * Returns the day of the week for this Hebrew date,
+     * where 0 represents Sunday, 1 represents Monday, 6 represents Saturday.
+     *
+     * For the day of the month, see `getDate()`
+     * @returns an integer 0-6
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.getDate(); // 4
      */
     getDay() {
         return mod(this.abs(), 7);
     }
     /**
-     * Converts to Gregorian date
-     * @return {Date}
+     * Converts this Hebrew date to the corresponding Gregorian date.
+     * Note that this function returns the daytime portion of the date.
+     * For example, the 15th of Cheshvan 5769 began at sundown on
+     * 12 November 2008 and continues through 13 November 2008. This
+     * function would return only the date 13 November 2008.
+     * @example
+     * const hd = new HDate(15, 'Cheshvan', 5769);
+     * hd.greg(); // 13 November 2008
      */
     greg() {
-        return greg.abs2greg(this.abs());
+        return abs2greg(this.abs());
     }
     /**
-     * Returns R.D. (Rata Die) fixed days.
-     * R.D. 1 == Monday, January 1, 1 (Gregorian)
+     * Converts from Hebrew date representation to R.D. (Rata Die) fixed days.
+     * R.D. 1 is the imaginary date Monday, January 1, 1 (Gregorian).
      * Note also that R.D. = Julian Date − 1,721,424.5
-     * https://en.wikipedia.org/wiki/Rata_Die#Dershowitz_and_Reingold
-     * @return {number}
+     * @see {@link https://en.wikipedia.org/wiki/Rata_Die | Rata Die}
+     * @example
+     * const hd = new HDate(15, 'Cheshvan', 5769);
+     * hd.abs(); // 733359
      */
     abs() {
         if (typeof this.rd !== 'number') {
@@ -1526,17 +1537,21 @@ class HDate {
      * Converts Hebrew date to R.D. (Rata Die) fixed days.
      * R.D. 1 is the imaginary date Monday, January 1, 1 on the Gregorian
      * Calendar.
-     * @param {number} year Hebrew year
-     * @param {number} month Hebrew month
-     * @param {number} day Hebrew date (1-30)
-     * @return {number}
+     * @param year Hebrew year
+     * @param month Hebrew month (1=NISAN, 7=TISHREI)
+     * @param day Hebrew date (1-30)
+     * @example
+     * import {HDate, months} from '@hebcal/hdate';
+     * HDate.hebrew2abs(5769, months.CHESHVAN, 15); // 733359
      */
     static hebrew2abs(year, month, day) {
         return hebrew2abs(year, month, day);
     }
     /**
      * Returns a transliterated Hebrew month name, e.g. `'Elul'` or `'Cheshvan'`.
-     * @return {string}
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.getMonthName(); // 'Cheshvan'
      */
     getMonthName() {
         return getMonthName(this.getMonth(), this.getFullYear());
@@ -1550,9 +1565,11 @@ class HDate {
      * const hd = new HDate(15, months.CHESHVAN, 5769);
      * console.log(hd.render('en')); // '15th of Cheshvan, 5769'
      * console.log(hd.render('he')); // '15 חֶשְׁוָן, 5769'
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @param {boolean} [showYear=true] Display year (defaults to true).
-     * @return {string}
+     * console.log(hd.render('en', false)); // '15th of Cheshvan'
+     * console.log(hd.render('he', false)); // '15 חֶשְׁוָן'
+     * @param [locale] Optional locale name (defaults to active locale).
+     * @param [showYear=true] Display year (defaults to true).
+     * @see {@link Locale}
      */
     render(locale, showYear = true) {
         const locale0 = locale || Locale.getLocaleName();
@@ -1575,9 +1592,8 @@ class HDate {
      * @example
      * import {HDate, months} from '@hebcal/hdate';
      * const hd = new HDate(15, months.CHESHVAN, 5769);
-     * console.log(hd.renderGematriya()); // 'ט״ו חֶשְׁוָן תשס״ט'
-     * @param {boolean} [suppressNikud]
-     * @return {string}
+     * hd.renderGematriya(); // 'ט״ו חֶשְׁוָן תשס״ט'
+     * hd.renderGematriya(true); // 'ט״ו חשון תשס״ט'
      */
     renderGematriya(suppressNikud = false) {
         const d = this.getDate();
@@ -1587,77 +1603,76 @@ class HDate {
         return gematriya(d) + ' ' + m + ' ' + gematriya(y);
     }
     /**
-     * Returns an `HDate` representing the a dayNumber before the current date.
-     * Sunday=0, Saturday=6
+     * Returns an `HDate` corresponding to the specified day of week
+     * **before** this Hebrew date
      * @example
      * new HDate(new Date('Wednesday February 19, 2014')).before(6).greg() // Sat Feb 15 2014
-     * @param {number} dow day of week
-     * @return {HDate}
+     * @param dayOfWeek day of week: Sunday=0, Saturday=6
      */
-    before(dow) {
-        return onOrBefore(dow, this, -1);
+    before(dayOfWeek) {
+        return onOrBefore(dayOfWeek, this, -1);
     }
     /**
-     * Returns an `HDate` representing the a dayNumber on or before the current date.
-     * Sunday=0, Saturday=6
+     * Returns an `HDate` corresponding to the specified day of week
+     * **on or before** this Hebrew date
      * @example
      * new HDate(new Date('Wednesday February 19, 2014')).onOrBefore(6).greg() // Sat Feb 15 2014
      * new HDate(new Date('Saturday February 22, 2014')).onOrBefore(6).greg() // Sat Feb 22 2014
      * new HDate(new Date('Sunday February 23, 2014')).onOrBefore(6).greg() // Sat Feb 22 2014
-     * @param {number} dow day of week
-     * @return {HDate}
+     * @param dayOfWeek day of week: Sunday=0, Saturday=6
      */
-    onOrBefore(dow) {
-        return onOrBefore(dow, this, 0);
+    onOrBefore(dayOfWeek) {
+        return onOrBefore(dayOfWeek, this, 0);
     }
     /**
-     * Returns an `HDate` representing the nearest dayNumber to the current date
-     * Sunday=0, Saturday=6
+     * Returns an `HDate` corresponding to the specified day of week
+     * **nearest** to this Hebrew date
      * @example
      * new HDate(new Date('Wednesday February 19, 2014')).nearest(6).greg() // Sat Feb 22 2014
      * new HDate(new Date('Tuesday February 18, 2014')).nearest(6).greg() // Sat Feb 15 2014
-     * @param {number} dow day of week
-     * @return {HDate}
+     * @param dayOfWeek day of week: Sunday=0, Saturday=6
      */
-    nearest(dow) {
-        return onOrBefore(dow, this, 3);
+    nearest(dayOfWeek) {
+        return onOrBefore(dayOfWeek, this, 3);
     }
     /**
-     * Returns an `HDate` representing the a dayNumber on or after the current date.
-     * Sunday=0, Saturday=6
+     * Returns an `HDate` corresponding to the specified day of week
+     * **on or after** this Hebrew date
      * @example
      * new HDate(new Date('Wednesday February 19, 2014')).onOrAfter(6).greg() // Sat Feb 22 2014
      * new HDate(new Date('Saturday February 22, 2014')).onOrAfter(6).greg() // Sat Feb 22 2014
      * new HDate(new Date('Sunday February 23, 2014')).onOrAfter(6).greg() // Sat Mar 01 2014
-     * @param {number} dow day of week
-     * @return {HDate}
+     * @param dayOfWeek day of week: Sunday=0, Saturday=6
      */
-    onOrAfter(dow) {
-        return onOrBefore(dow, this, 6);
+    onOrAfter(dayOfWeek) {
+        return onOrBefore(dayOfWeek, this, 6);
     }
     /**
-     * Returns an `HDate` representing the a dayNumber after the current date.
-     * Sunday=0, Saturday=6
+     * Returns an `HDate` corresponding to the specified day of week
+     * **after** this Hebrew date
      * @example
      * new HDate(new Date('Wednesday February 19, 2014')).after(6).greg() // Sat Feb 22 2014
      * new HDate(new Date('Saturday February 22, 2014')).after(6).greg() // Sat Mar 01 2014
      * new HDate(new Date('Sunday February 23, 2014')).after(6).greg() // Sat Mar 01 2014
-     * @param {number} dow day of week
-     * @return {HDate}
+     * @param dayOfWeek day of week: Sunday=0, Saturday=6
      */
-    after(dow) {
-        return onOrBefore(dow, this, 7);
+    after(dayOfWeek) {
+        return onOrBefore(dayOfWeek, this, 7);
     }
     /**
      * Returns the next Hebrew date
-     * @return {HDate}
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.next(); // '16 Cheshvan 5769'
      */
     next() {
         return new HDate(this.abs() + 1);
     }
     /**
      * Returns the previous Hebrew date
-     * @return {HDate}
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.prev(); // '14 Cheshvan 5769'
      */
     prev() {
         return new HDate(this.abs() - 1);
@@ -1674,12 +1689,10 @@ class HDate {
      * | `week` | `w` | weeks |
      * | `month` | `M` | months |
      * | `year` | `y` | years |
-     * @param {number} amount
-     * @param {string} [units]
-     * @return {HDate}
      */
     add(amount, units = 'd') {
-        amount = typeof amount === 'string' ? parseInt(amount, 10) : amount;
+        amount =
+            typeof amount === 'string' ? parseInt(amount, 10) : amount;
         if (!amount) {
             return new HDate(this);
         }
@@ -1688,7 +1701,7 @@ class HDate {
             return new HDate(this.abs() + amount);
         }
         else if (units === UNITS_WEEK) {
-            return new HDate(this.abs() + (7 * amount));
+            return new HDate(this.abs() + 7 * amount);
         }
         else if (units === UNITS_YEAR) {
             return new HDate(this.getDate(), this.getMonth(), this.getFullYear() + amount);
@@ -1698,7 +1711,7 @@ class HDate {
             const sign = amount > 0 ? 1 : -1;
             amount = Math.abs(amount);
             for (let i = 0; i < amount; i++) {
-                hd = new HDate(hd.abs() + (sign * hd.daysInMonth()));
+                hd = new HDate(hd.abs() + sign * hd.daysInMonth());
             }
             return hd;
         }
@@ -1724,9 +1737,6 @@ class HDate {
      * const hd1 = new HDate(15, months.CHESHVAN, 5769);
      * const hd2 = hd1.add(1, 'weeks'); // 7 Kislev 5769
      * const hd3 = hd1.add(-3, 'M'); // 30 Av 5768
-     * @param {number} amount
-     * @param {string} [units]
-     * @return {HDate}
      */
     subtract(amount, units = 'd') {
         return this.add(amount * -1, units);
@@ -1745,8 +1755,7 @@ class HDate {
      * const hd1 = new HDate(25, months.KISLEV, 5770);
      * const hd2 = new HDate(15, months.CHESHVAN, 5769);
      * const days = hd1.deltaDays(hd2); // 394
-     * @param {HDate} other Hebrew date to compare
-     * @return {number}
+     * @param other Hebrew date to compare
      */
     deltaDays(other) {
         if (!HDate.isHDate(other)) {
@@ -1755,19 +1764,25 @@ class HDate {
         return this.abs() - other.abs();
     }
     /**
-     * Compares this date to another date, returning `true` if the dates match.
-     * @param {HDate} other Hebrew date to compare
-     * @return {boolean}
+     * Compares this Hebrew date to another date, returning `true` if the dates match.
+     * @param other Hebrew date to compare
+     * @example
+     * const hd1 = new HDate(new Date(2008, 10, 13));
+     * const hd2 = new HDate(15, 'Cheshvan', 5769);
+     * hd1.isSameDate(hd2); // true
      */
     isSameDate(other) {
         if (HDate.isHDate(other)) {
-            return this.yy === other.yy &&
-                this.mm === other.mm &&
-                this.dd === other.dd;
+            return (this.yy === other.yy && this.mm === other.mm && this.dd === other.dd);
         }
         return false;
     }
-    /** @return {string} */
+    /**
+     * Returns a string representation of this Hebrew date using English transliterations
+     * @example
+     * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
+     * hd.toString(); // '15 Cheshvan 5769'
+     */
     toString() {
         const day = this.getDate();
         const fullYear = this.getFullYear();
@@ -1776,25 +1791,31 @@ class HDate {
     }
     /**
      * Returns true if Hebrew year is a leap year
-     * @param {number} year Hebrew year
-     * @return {boolean}
+     * @param year Hebrew year
+     * @example
+     * HDate.isLeapYear(5783); // false
+     * HDate.isLeapYear(5784); // true
      */
     static isLeapYear(year) {
         return isLeapYear(year);
     }
     /**
      * Number of months in this Hebrew year (either 12 or 13 depending on leap year)
-     * @param {number} year Hebrew year
-     * @return {number}
+     * @param year Hebrew year
+     * @example
+     * HDate.monthsInYear(5783); // 12
+     * HDate.monthsInYear(5784); // 13
      */
     static monthsInYear(year) {
         return monthsInYear(year);
     }
     /**
      * Number of days in Hebrew month in a given year (29 or 30)
-     * @param {number} month Hebrew month (e.g. months.TISHREI)
-     * @param {number} year Hebrew year
-     * @return {number}
+     * @param month Hebrew month (e.g. months.TISHREI)
+     * @param year Hebrew year
+     * @example
+     * import {HDate, months} from '@hebcal/hdate';
+     * HDate.daysInMonth(months.CHESHVAN, 5769); // 29
      */
     static daysInMonth(month, year) {
         return daysInMonth(month, year);
@@ -1802,17 +1823,23 @@ class HDate {
     /**
      * Returns a transliterated string name of Hebrew month in year,
      * for example 'Elul' or 'Cheshvan'.
-     * @param {number} month Hebrew month (e.g. months.TISHREI)
-     * @param {number} year Hebrew year
-     * @return {string}
+     * @param month Hebrew month (e.g. months.TISHREI)
+     * @param year Hebrew year
+     * @example
+     * import {HDate, months} from '@hebcal/hdate';
+     * HDate.getMonthName(months.CHESHVAN, 5769); // 'Cheshvan'
      */
     static getMonthName(month, year) {
         return getMonthName(month, year);
     }
     /**
      * Returns the Hebrew month number (NISAN=1, TISHREI=7)
-     * @param {number|string} month A number, or Hebrew month name string
-     * @return {number}
+     * @param month A number, or Hebrew month name string
+     * @example
+     * import {HDate, months} from '@hebcal/hdate';
+     * HDate.monthNum(months.CHESHVAN); // 8
+     * HDate.monthNum('Cheshvan'); // 8
+     * HDate.monthNum('חשון'); // 8
      */
     static monthNum(month) {
         if (typeof month === 'number') {
@@ -1821,38 +1848,49 @@ class HDate {
             }
             return month;
         }
-        return month.charCodeAt(0) >= 48 && month.charCodeAt(0) <= 57 ? /* number */
-            parseInt(month, 10) :
-            HDate.monthFromName(month);
+        return month.charCodeAt(0) >= 48 && month.charCodeAt(0) <= 57 /* number */
+            ? parseInt(month, 10)
+            : HDate.monthFromName(month);
     }
     /**
-     * Number of days in the hebrew YEAR
-     * @param {number} year Hebrew year
-     * @return {number}
+     * Number of days in the Hebrew year.
+     * Regular years can have 353, 354, or 355 days.
+     * Leap years can have 383, 384, or 385 days.
+     * @param year Hebrew year
+     * @example
+     * HDate.daysInYear(5783); // 355
+     * HDate.daysInYear(5784); // 383
      */
     static daysInYear(year) {
         return daysInYear(year);
     }
     /**
      * true if Cheshvan is long in Hebrew year
-     * @param {number} year Hebrew year
-     * @return {boolean}
+     * @param year Hebrew year
+     * @example
+     * HDate.longCheshvan(5783); // true
+     * HDate.longCheshvan(5784); // false
      */
     static longCheshvan(year) {
         return longCheshvan(year);
     }
     /**
      * true if Kislev is short in Hebrew year
-     * @param {number} year Hebrew year
-     * @return {boolean}
+     * @param year Hebrew year
+     * @example
+     * HDate.shortKislev(5783); // false
+     * HDate.shortKislev(5784); // true
      */
     static shortKislev(year) {
         return shortKislev(year);
     }
     /**
      * Converts Hebrew month string name to numeric
-     * @param {string|number} monthName monthName
-     * @return {number}
+     * @example
+     * import {HDate, months} from '@hebcal/hdate';
+     * HDate.monthFromName(months.CHESHVAN); // 8
+     * HDate.monthFromName('Cheshvan'); // 8
+     * HDate.monthFromName('חשון'); // 8
      */
     static monthFromName(monthName) {
         if (typeof monthName === 'number') {
@@ -1865,42 +1903,45 @@ class HDate {
         return monthFromName(name);
     }
     /**
-     * Note: Applying this function to d+6 gives us the DAYNAME on or after an
-     * absolute day d. Similarly, applying it to d+3 gives the DAYNAME nearest to
-     * absolute date d, applying it to d-1 gives the DAYNAME previous to absolute
-     * date d, and applying it to d+7 gives the DAYNAME following absolute date d.
-     * @param {number} dayOfWeek
-     * @param {number} absdate
-     * @return {number}
+     * Convenience function for determining the R.D. date
+     * near a specified R.D. date, corresponding to the specified day of week.
+     *
+     * Note: Applying this function to d+6 gives us the `dayOfWeek` on or after an
+     * absolute day d. Similarly, applying it to d+3 gives the `dayOfWeek` nearest to
+     * absolute date d, applying it to d-1 gives the `dayOfWeek` previous to absolute
+     * date d, and applying it to d+7 gives the `dayOfWeek` following absolute date d.
+     * @param dayOfWeek day of week: Sunday=0, Saturday=6
      */
     static dayOnOrBefore(dayOfWeek, absdate) {
         return absdate - ((absdate - dayOfWeek) % 7);
     }
     /**
      * Tests if the object is an instance of `HDate`
-     * @param {any} obj
-     * @return {boolean}
+     * @example
+     * HDate.isHDate(new HDate()); // true
+     * HDate.isHDate(new Date()); // false
+     * HDate.isHDate(null); // false
+     * HDate.isHDate(12345); // false
+     * HDate.isHDate('15 Cheshvan 5769'); // false
      */
     static isHDate(obj) {
-        return obj !== null && typeof obj === 'object' &&
+        return (obj !== null &&
+            typeof obj === 'object' &&
             typeof obj.yy === 'number' &&
             typeof obj.mm === 'number' &&
             typeof obj.dd === 'number' &&
             typeof obj.greg === 'function' &&
-            typeof obj.abs === 'function';
+            typeof obj.abs === 'function');
     }
     /**
      * Construct a new instance of `HDate` from a Gematriya-formatted string
      * @example
-     *  HDate.fromGematriyaString('כ״ז בְּתַמּוּז תשפ״ג') // 27 Tamuz 5783
-     *  HDate.fromGematriyaString('כ׳ סיון תש״ד') // 20 Sivan 5704
-     *  HDate.fromGematriyaString('ה׳ אִיָיר תש״ח') // 5 Iyyar 5708
-     * @param {string} str
-     * @param {number} currentThousands
-     * @return {HDate}
+     * HDate.fromGematriyaString('כ״ז בְּתַמּוּז תשפ״ג') // 27 Tamuz 5783
+     * HDate.fromGematriyaString('כ׳ סיון תש״ד') // 20 Sivan 5704
+     * HDate.fromGematriyaString('ה׳ אִיָיר תש״ח') // 5 Iyyar 5708
      */
     static fromGematriyaString(str, currentThousands = 5000) {
-        const parts = str.split(' ').filter((x) => x.length !== 0);
+        const parts = str.split(' ').filter(x => x.length !== 0);
         const numParts = parts.length;
         if (numParts !== 3 && numParts !== 4) {
             throw new RangeError(`Unable to parse gematriya string: "${str}"`);
@@ -1918,12 +1959,18 @@ class HDate {
 }
 function standardizeUnits(units) {
     switch (units) {
-        case 'd': return UNITS_DAY;
-        case 'w': return UNITS_WEEK;
-        case 'M': return UNITS_MONTH;
-        case 'y': return UNITS_YEAR;
-    }
-    const str = String(units || '').toLowerCase().replace(/s$/, '');
+        case 'd':
+            return UNITS_DAY;
+        case 'w':
+            return UNITS_WEEK;
+        case 'M':
+            return UNITS_MONTH;
+        case 'y':
+            return UNITS_YEAR;
+    }
+    const str = String(units || '')
+        .toLowerCase()
+        .replace(/s$/, '');
     switch (str) {
         case UNITS_DAY:
         case UNITS_WEEK:
@@ -1953,8 +2000,7 @@ function getDayOfTranslation(locale) {
 /**
  * Sets the day of the month of the date. Returns the object it was called upon
  * @private
- * @param {number|string} month A number, or Hebrew month name string
- * @return {HDate}
+ * @param month A number, or Hebrew month name string
  */
 function setMonth(hd, month) {
     hd.mm = HDate.monthNum(month);
@@ -2036,7 +2082,8 @@ const poHeNoNikud = {
 Locale.addTranslations('he-x-NoNikud', poHeNoNikud);
 
 /**
- * Holiday flags for Event
+ * Holiday flags for Event. These flags are typically
+ * combined using bitwise arithmetic to form a mask.
  * @readonly
  * @enum {number}
  */
@@ -2111,14 +2158,22 @@ const flagToCategory = [
     [flags.SPECIAL_SHABBAT, 'holiday', 'shabbat'],
     [flags.USER_EVENT, 'user'],
 ];
-/** Represents an Event with a title, date, and flags */
+/**
+ * Represents an Event with a title, date, and flags.
+ *
+ * Events are used to represent holidays, candle-lighting times,
+ * Torah readings, and more.
+ *
+ * To get the title of the event a language other than English
+ * with Sephardic transliterations, use the `render()` method.
+ */
 class Event {
     /**
      * Constructs Event
-     * @param {HDate} date Hebrew date event occurs
-     * @param {string} desc Description (not translated)
-     * @param {number} [mask=0] optional bitmask of holiday flags (see {@link flags})
-     * @param {Object} [attrs={}] optional additional attributes (e.g. `eventTimeStr`, `cholHaMoedDay`)
+     * @param date Hebrew date event occurs
+     * @param desc Description (not translated)
+     * @param [mask=0] optional bitmask of holiday flags (see {@link flags})
+     * @param [attrs={}] optional additional attributes (e.g. `eventTimeStr`, `cholHaMoedDay`)
      */
     constructor(date, desc, mask = 0, attrs) {
         if (!HDate.isHDate(date)) {
@@ -2136,21 +2191,21 @@ class Event {
     }
     /**
      * Hebrew date of this event
-     * @return {HDate}
      */
     getDate() {
         return this.date;
     }
     /**
-     * Untranslated description of this event
-     * @return {string}
+     * Untranslated title of this event. Note that these description
+     * strings are always in English and will remain stable across releases.
+     * To get the title of the event in another language, use the
+     * `render()` method.
      */
     getDesc() {
         return this.desc;
     }
     /**
      * Bitmask of optional event flags. See {@link flags}
-     * @return {number}
      */
     getFlags() {
         return this.mask;
@@ -2162,8 +2217,7 @@ class Event {
      * ev.render('en'); // 'Shavuot'
      * ev.render('he'); // 'שָׁבוּעוֹת'
      * ev.render('ashkenazi'); // 'Shavuos'
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         return Locale.gettext(this.desc, locale);
@@ -2172,25 +2226,22 @@ class Event {
      * Returns a brief (translated) description of this event.
      * For most events, this is the same as render(). For some events, it procudes
      * a shorter text (e.g. without a time or added description).
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     renderBrief(locale) {
         return this.render(locale);
     }
     /**
      * Optional holiday-specific Emoji or `null`.
-     * @return {string | null}
      */
     getEmoji() {
         return this.emoji || null;
     }
     /**
      * Returns a simplified (untranslated) description for this event. For example,
-     * the {@link HolidayEvent} class supports
+     * the `HolidayEvent` class supports
      * "Erev Pesach" => "Pesach", and "Sukkot III (CH''M)" => "Sukkot".
      * For many holidays the basename and the event description are the same.
-     * @return {string}
      */
     basename() {
         return this.getDesc();
@@ -2198,7 +2249,6 @@ class Event {
     /**
      * Returns a URL to hebcal.com or sefaria.org for more detail on the event.
      * Returns `undefined` for events with no detail page.
-     * @return {string | undefined}
      */
     url() {
         return undefined;
@@ -2210,7 +2260,6 @@ class Event {
      * ev1.observedInIsrael(); // false
      * const ev2 = new Event(new HDate(26, 'Kislev', 5749), 'Chanukah: 3 Candles', 0);
      * ev2.observedInIsrael(); // true
-     * @return {boolean}
      */
     observedInIsrael() {
         return !(this.mask & flags.CHUL_ONLY);
@@ -2222,7 +2271,6 @@ class Event {
      * ev1.observedInDiaspora(); // true
      * const ev2 = new Event(new HDate(26, 'Kislev', 5749), 'Chanukah: 3 Candles', 0);
      * ev2.observedInDiaspora(); // true
-     * @return {boolean}
      */
     observedInDiaspora() {
         return !(this.mask & flags.IL_ONLY);
@@ -2236,19 +2284,18 @@ class Event {
      * const ev2 = new Event(new HDate(26, 'Kislev', 5749), 'Chanukah: 3 Candles', 0);
      * ev2.observedIn(false); // true
      * ev2.observedIn(true); // true
-     * @param {boolean} il
-     * @return {boolean}
+     * @param il
      */
     observedIn(il) {
         return il ? this.observedInIsrael() : this.observedInDiaspora();
     }
     /**
      * Makes a clone of this Event object
-     * @return {Event}
      */
     clone() {
         const ev = new Event(this.date, this.desc, this.mask);
         for (const property in this) {
+            // eslint-disable-next-line no-prototype-builtins
             if (this.hasOwnProperty(property)) {
                 Object.defineProperty(ev, property, { value: this[property] });
             }
@@ -2257,7 +2304,6 @@ class Event {
     }
     /**
      * Returns a list of event categories
-     * @return {string[]}
      */
     getCategories() {
         const mask = this.getFlags();
@@ -2274,13 +2320,13 @@ class Event {
 /** Daily Hebrew date ("11th of Sivan, 5780") */
 class HebrewDateEvent extends Event {
     /**
-     * @param {HDate} date
+     * @param date
      */
     constructor(date) {
         super(date, date.toString(), flags.HEBREW_DATE);
     }
     /**
-     * @param {string} [locale] Optional locale name (defaults to active locale).
+     * @param [locale] Optional locale name (defaults to active locale).
      * @example
      * import {HDate, HebrewDateEvent, months} from '@hebcal/core';
      *
@@ -2288,7 +2334,6 @@ class HebrewDateEvent extends Event {
      * const ev = new HebrewDateEvent(hd);
      * console.log(ev.render('en')); // '15th of Cheshvan, 5769'
      * console.log(ev.render('he')); // 'ט״ו חֶשְׁוָן תשס״ט'
-     * @return {string}
      */
     render(locale) {
         const locale1 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
@@ -2306,8 +2351,7 @@ class HebrewDateEvent extends Event {
     }
     /**
      * @private
-     * @param {string} locale
-     * @return {string}
+     * @param locale
      */
     renderBriefHebrew(locale) {
         const hd = this.getDate();
@@ -2316,7 +2360,7 @@ class HebrewDateEvent extends Event {
         return gematriya(dd) + ' ' + mm;
     }
     /**
-     * @param {string} [locale] Optional locale name (defaults to active locale).
+     * @param [locale] Optional locale name (defaults to active locale).
      * @example
      * import {HDate, HebrewDateEvent, months} from '@hebcal/core';
      *
@@ -2324,7 +2368,6 @@ class HebrewDateEvent extends Event {
      * const ev = new HebrewDateEvent(hd);
      * console.log(ev.renderBrief()); // '15th of Cheshvan'
      * console.log(ev.renderBrief('he')); // 'ט״ו חֶשְׁוָן'
-     * @return {string}
      */
     renderBrief(locale) {
         const locale1 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
@@ -7502,7 +7545,14 @@ const classicCities0 = [
     ['Bogota', 'CO', 4.60971, -74.08175, 'America/Bogota', 2582],
     ['Boston', 'US', 42.35843, -71.05977, 'America/New_York', 38],
     ['Budapest', 'HU', 47.49801, 19.03991, 'Europe/Budapest', 104],
-    ['Buenos Aires', 'AR', -34.61315, -58.37723, 'America/Argentina/Buenos_Aires', 31],
+    [
+        'Buenos Aires',
+        'AR',
+        -34.61315,
+        -58.37723,
+        'America/Argentina/Buenos_Aires',
+        31,
+    ],
     ['Buffalo', 'US', 42.88645, -78.87837, 'America/New_York', 191],
     ['Chicago', 'US', 41.85003, -87.65005, 'America/Chicago', 180],
     ['Cincinnati', 'US', 39.162, -84.45689, 'America/New_York', 267],
@@ -7599,14 +7649,14 @@ function getFormatter(tzid) {
 class Location extends GeoLocation {
     /**
      * Initialize a Location instance
-     * @param {number} latitude - Latitude as a decimal, valid range -90 thru +90 (e.g. 41.85003)
-     * @param {number} longitude - Longitude as a decimal, valid range -180 thru +180 (e.g. -87.65005)
-     * @param {boolean} il - in Israel (true) or Diaspora (false)
-     * @param {string} tzid - Olson timezone ID, e.g. "America/Chicago"
-     * @param {string} [cityName] - optional descriptive city name
-     * @param {string} [countryCode] - ISO 3166 alpha-2 country code (e.g. "FR")
-     * @param {string|number} [geoid] - optional string or numeric geographic ID
-     * @param {number} [elevation] - in meters (default `0`)
+     * @param latitude - Latitude as a decimal, valid range -90 thru +90 (e.g. 41.85003)
+     * @param longitude - Longitude as a decimal, valid range -180 thru +180 (e.g. -87.65005)
+     * @param il - in Israel (true) or Diaspora (false)
+     * @param tzid - Olson timezone ID, e.g. "America/Chicago"
+     * @param [cityName] - optional descriptive city name
+     * @param [countryCode] - ISO 3166 alpha-2 country code (e.g. "FR")
+     * @param [geoid] - optional string or numeric geographic ID
+     * @param [elevation] - in meters (default `0`)
      */
     constructor(latitude, longitude, il, tzid, cityName, countryCode, geoid, elevation) {
         const lat = typeof latitude === 'number' ? latitude : parseFloat(latitude);
@@ -7617,23 +7667,20 @@ class Location extends GeoLocation {
         if (isNaN(long) || long < -180 || long > 180) {
             throw new RangeError(`Longitude ${longitude} out of range [-180,180]`);
         }
-        const elev = (typeof elevation === 'number' && elevation > 0) ? elevation : 0;
+        const elev = typeof elevation === 'number' && elevation > 0 ? elevation : 0;
         super(cityName || null, lat, long, elev, tzid);
         this.il = Boolean(il);
         this.cc = countryCode;
         this.geoid = geoid;
     }
-    /** @return {boolean} */
     getIsrael() {
         return this.il;
     }
-    /** @return {string | null} */
     getName() {
         return this.getLocationName();
     }
     /**
      * Returns the location name, up to the first comma
-     * @return {string | null}
      */
     getShortName() {
         const name = this.getLocationName();
@@ -7652,22 +7699,18 @@ class Location extends GeoLocation {
         }
         return name.substring(0, comma);
     }
-    /** @return {string | undefined} */
     getCountryCode() {
         return this.cc;
     }
-    /** @return {string} */
     getTzid() {
         return this.getTimeZone();
     }
     /**
      * Gets a 24-hour time formatter (e.g. 07:41 or 20:03) for this location
-     * @return {Intl.DateTimeFormat}
      */
     getTimeFormatter() {
         return getFormatter(this.getTimeZone());
     }
-    /** @return {string | number | undefined} */
     getGeoId() {
         return this.geoid;
     }
@@ -7687,26 +7730,23 @@ class Location extends GeoLocation {
      * 'San Diego', 'San Francisco', 'Sao Paulo', 'Seattle', 'Sydney',
      * 'Tel Aviv', 'Tiberias', 'Toronto', 'Vancouver', 'White Plains',
      * 'Washington DC', 'Worcester'
-     * @param {string} name
-     * @return {Location|undefined}
+     * @param name
      */
     static lookup(name) {
         return classicCities.get(name.toLowerCase());
     }
-    /** @return {string} */
     toString() {
         return JSON.stringify(this);
     }
     /**
      * Converts legacy Hebcal timezone to a standard Olson tzid.
-     * @param {number} tz integer, GMT offset in hours
-     * @param {string} dst 'none', 'eu', 'usa', or 'israel'
-     * @return {string | undefined}
+     * @param tz integer, GMT offset in hours
+     * @param dst 'none', 'eu', 'usa', or 'israel'
      */
     static legacyTzToTzid(tz, dst) {
         tz = +tz;
-        if (dst == 'none') {
-            if (tz == 0) {
+        if (dst === 'none') {
+            if (tz === 0) {
                 return 'UTC';
             }
             else {
@@ -7714,19 +7754,24 @@ class Location extends GeoLocation {
                 return `Etc/GMT${plus}${tz}`;
             }
         }
-        else if (tz == 2 && dst == 'israel') {
+        else if (tz === 2 && dst === 'israel') {
             return 'Asia/Jerusalem';
         }
-        else if (dst == 'eu') {
+        else if (dst === 'eu') {
             switch (tz) {
-                case -2: return 'Atlantic/Cape_Verde';
-                case -1: return 'Atlantic/Azores';
-                case 0: return 'Europe/London';
-                case 1: return 'Europe/Paris';
-                case 2: return 'Europe/Athens';
+                case -2:
+                    return 'Atlantic/Cape_Verde';
+                case -1:
+                    return 'Atlantic/Azores';
+                case 0:
+                    return 'Europe/London';
+                case 1:
+                    return 'Europe/Paris';
+                case 2:
+                    return 'Europe/Athens';
             }
         }
-        else if (dst == 'usa') {
+        else if (dst === 'usa') {
             return ZIPCODES_TZ_MAP[String(tz * -1)];
         }
         return undefined;
@@ -7735,17 +7780,16 @@ class Location extends GeoLocation {
      * Converts timezone info from Zip-Codes.com to a standard Olson tzid.
      * @example
      * Location.getUsaTzid('AZ', 7, 'Y') // 'America/Denver'
-     * @param {string} state two-letter all-caps US state abbreviation like 'CA'
-     * @param {number} tz positive number, 5=America/New_York, 8=America/Los_Angeles
-     * @param {string} dst single char 'Y' or 'N'
-     * @return {string}
+     * @param state two-letter all-caps US state abbreviation like 'CA'
+     * @param tz positive number, 5=America/New_York, 8=America/Los_Angeles
+     * @param dst single char 'Y' or 'N'
      */
     static getUsaTzid(state, tz, dst) {
-        if (tz == 10 && state == 'AK') {
+        if (tz === 10 && state === 'AK') {
             return 'America/Adak';
         }
-        else if (tz == 7 && state == 'AZ') {
-            return dst == 'Y' ? 'America/Denver' : 'America/Phoenix';
+        else if (tz === 7 && state === 'AZ') {
+            return dst === 'Y' ? 'America/Denver' : 'America/Phoenix';
         }
         else {
             return ZIPCODES_TZ_MAP[tz];
@@ -7755,9 +7799,6 @@ class Location extends GeoLocation {
      * Adds a location name for `Location.lookup()` only if the name isn't
      * already being used. Returns `false` if the name is already taken
      * and `true` if successfully added.
-     * @param {string} cityName
-     * @param {Location} location
-     * @return {boolean}
      */
     static addLocation(cityName, location) {
         const name = cityName.toLowerCase();
@@ -7769,7 +7810,7 @@ class Location extends GeoLocation {
     }
 }
 for (const city of classicCities0) {
-    const location = new Location(city[2], city[3], city[1] == 'IL', city[4], city[0], city[1], undefined, city[5]);
+    const location = new Location(city[2], city[3], city[1] === 'IL', city[4], city[0], city[1], undefined, city[5]);
     Location.addLocation(city[0], location);
 }
 
@@ -7793,7 +7834,7 @@ function zdtToDate(zdt) {
     return res;
 }
 function getDate(date) {
-    if (greg.isDate(date))
+    if (isDate(date))
         return date;
     if (HDate.isHDate(date))
         return date.greg();
@@ -7828,10 +7869,10 @@ function getDate(date) {
 class Zmanim {
     /**
      * Initialize a Zmanim instance.
-     * @param {GeoLocation} gloc GeoLocation including latitude, longitude, and timezone
-     * @param {Date|HDate} date Regular or Hebrew Date. If `date` is a regular `Date`,
+     * @param gloc GeoLocation including latitude, longitude, and timezone
+     * @param date Regular or Hebrew Date. If `date` is a regular `Date`,
      *    hours, minutes, seconds and milliseconds are ignored.
-     * @param {boolean} useElevation use elevation for calculations (default `false`).
+     * @param useElevation use elevation for calculations (default `false`).
      *    If `true`, use elevation to affect the calculation of all sunrise/sunset based
      *    zmanim. Note: there are some zmanim such as degree-based zmanim that are driven
      *    by the amount of light in the sky and are not impacted by elevation.
@@ -7844,7 +7885,7 @@ class Zmanim {
         const plainDate = Temporal.PlainDate.from({
             year: dt.getFullYear(),
             month: dt.getMonth() + 1,
-            day: dt.getDate()
+            day: dt.getDate(),
         });
         this.noaa = new NOAACalculator(gloc, plainDate);
         this.useElevation = Boolean(useElevation);
@@ -7852,14 +7893,13 @@ class Zmanim {
     /**
      * Returns `true` if elevation adjustment is enabled
      * for zmanim support elevation adjustment
-     * @return {boolean}
      */
     getUseElevation() {
         return this.useElevation;
     }
     /**
      * Enables or disables elevation adjustment for zmanim support elevation adjustment
-     * @param {boolean} useElevation
+     * @param useElevation
      */
     setUseElevation(useElevation) {
         this.useElevation = useElevation;
@@ -7868,29 +7908,29 @@ class Zmanim {
      * Convenience function to get the time when sun is above or below the horizon
      * for a certain angle (in degrees).
      * This function does not support elevation adjustment.
-     * @param {number} angle
-     * @param {boolean} rising
-     * @return {Date}
+     * @param angle
+     * @param rising
      */
     timeAtAngle(angle, rising) {
         const offsetZenith = 90 + angle;
-        const zdt = rising ? this.noaa.getSunriseOffsetByDegrees(offsetZenith) :
-            this.noaa.getSunsetOffsetByDegrees(offsetZenith);
+        const zdt = rising
+            ? this.noaa.getSunriseOffsetByDegrees(offsetZenith)
+            : this.noaa.getSunsetOffsetByDegrees(offsetZenith);
         return zdtToDate(zdt);
     }
     /**
      * Upper edge of the Sun appears over the eastern horizon in the morning (0.833° above horizon)
      * If elevation is enabled, this function will include elevation in the calculation.
-     * @return {Date}
      */
     sunrise() {
-        const zdt = this.useElevation ? this.noaa.getSunrise() : this.noaa.getSeaLevelSunrise();
+        const zdt = this.useElevation
+            ? this.noaa.getSunrise()
+            : this.noaa.getSeaLevelSunrise();
         return zdtToDate(zdt);
     }
     /**
      * Upper edge of the Sun appears over the eastern horizon in the morning (0.833° above horizon).
      * This function does not support elevation adjustment.
-     * @return {Date}
      */
     seaLevelSunrise() {
         const zdt = this.noaa.getSeaLevelSunrise();
@@ -7899,16 +7939,16 @@ class Zmanim {
     /**
      * When the upper edge of the Sun disappears below the horizon (0.833° below horizon).
      * If elevation is enabled, this function will include elevation in the calculation.
-     * @return {Date}
      */
     sunset() {
-        const zdt = this.useElevation ? this.noaa.getSunset() : this.noaa.getSeaLevelSunset();
+        const zdt = this.useElevation
+            ? this.noaa.getSunset()
+            : this.noaa.getSeaLevelSunset();
         return zdtToDate(zdt);
     }
     /**
      * When the upper edge of the Sun disappears below the horizon (0.833° below horizon).
      * This function does not support elevation adjustment.
-     * @return {Date}
      */
     seaLevelSunset() {
         const zdt = this.noaa.getSeaLevelSunset();
@@ -7918,7 +7958,6 @@ class Zmanim {
      * Civil dawn; Sun is 6° below the horizon in the morning.
      * Because degree-based functions estimate the amount of light in the sky,
      * the result is not impacted by elevation.
-     * @return {Date}
      */
     dawn() {
         const zdt = this.noaa.getBeginCivilTwilight();
@@ -7928,7 +7967,6 @@ class Zmanim {
      * Civil dusk; Sun is 6° below the horizon in the evening.
      * Because degree-based functions estimate the amount of light in the sky,
      * the result is not impacted by elevation.
-     * @return {Date}
      */
     dusk() {
         const zdt = this.noaa.getEndCivilTwilight();
@@ -7937,7 +7975,6 @@ class Zmanim {
     /**
      * Returns sunset for the previous day.
      * If elevation is enabled, this function will include elevation in the calculation.
-     * @return {Date}
      */
     gregEve() {
         const prev = new Date(this.date);
@@ -7947,14 +7984,12 @@ class Zmanim {
     }
     /**
      * @private
-     * @return {number}
      */
     nightHour() {
         return (this.sunrise().getTime() - this.gregEve().getTime()) / 12; // ms in hour
     }
     /**
      * Midday – Chatzot; Sunrise plus 6 halachic hours
-     * @return {Date}
      */
     chatzot() {
         const startOfDay = this.noaa.getSeaLevelSunrise();
@@ -7965,16 +8000,14 @@ class Zmanim {
     /**
      * Midnight – Chatzot; Sunset plus 6 halachic hours.
      * If elevation is enabled, this function will include elevation in the calculation.
-     * @return {Date}
      */
     chatzotNight() {
-        return new Date(this.sunrise().getTime() - (this.nightHour() * 6));
+        return new Date(this.sunrise().getTime() - this.nightHour() * 6);
     }
     /**
      * Dawn – Alot haShachar; Sun is 16.1° below the horizon in the morning.
      * Because degree-based functions estimate the amount of light in the sky,
      * the result is not impacted by elevation.
-     * @return {Date}
      */
     alotHaShachar() {
         return this.timeAtAngle(16.1, true);
@@ -7983,7 +8016,6 @@ class Zmanim {
      * Earliest talis & tefillin – Misheyakir; Sun is 11.5° below the horizon in the morning.
      * Because degree-based functions estimate the amount of light in the sky,
      * the result is not impacted by elevation.
-     * @return {Date}
      */
     misheyakir() {
         return this.timeAtAngle(11.5, true);
@@ -7992,7 +8024,6 @@ class Zmanim {
      * Earliest talis & tefillin – Misheyakir Machmir; Sun is 10.2° below the horizon in the morning.
      * Because degree-based functions estimate the amount of light in the sky,
      * the result is not impacted by elevation.
-     * @return {Date}
      */
     misheyakirMachmir() {
         return this.timeAtAngle(10.2, true);
@@ -8000,12 +8031,15 @@ class Zmanim {
     /**
      * Utility method for using elevation-aware sunrise/sunset
      * @private
-     * @param {number} hours
-     * @return {Date}
+     * @param hours
      */
     getShaahZmanisBasedZman(hours) {
-        const startOfDay = this.useElevation ? this.noaa.getSunrise() : this.noaa.getSeaLevelSunrise();
-        const endOfDay = this.useElevation ? this.noaa.getSunset() : this.noaa.getSeaLevelSunset();
+        const startOfDay = this.useElevation
+            ? this.noaa.getSunrise()
+            : this.noaa.getSeaLevelSunrise();
+        const endOfDay = this.useElevation
+            ? this.noaa.getSunset()
+            : this.noaa.getSeaLevelSunset();
         const temporalHour = this.noaa.getTemporalHour(startOfDay, endOfDay);
         const offset = Math.round(temporalHour * hours);
         const zdt = NOAACalculator.getTimeOffset(startOfDay, offset);
@@ -8014,9 +8048,9 @@ class Zmanim {
     /**
      * Latest Shema (Gra); Sunrise plus 3 halachic hours, according to the Gra.
      * If elevation is enabled, this function will include elevation in the calculation.
-     * @return {Date}
      */
     sofZmanShma() {
+        // Gra
         return this.getShaahZmanisBasedZman(3);
     }
     /**
@@ -8028,9 +8062,9 @@ class Zmanim {
      * to the [GRA](https://en.wikipedia.org/wiki/Vilna_Gaon).
      *
      * If elevation is enabled, this function will include elevation in the calculation.
-     * @return {Date}
      */
     sofZmanTfilla() {
+        // Gra
         return this.getShaahZmanisBasedZman(4);
     }
     /**
@@ -8058,9 +8092,9 @@ class Zmanim {
      * Based on the opinion of the MGA that the day is calculated from
      * dawn being fixed 72 minutes before sea-level sunrise, and nightfall is fixed
      * 72 minutes after sea-level sunset.
-     * @return {Date}
      */
     sofZmanShmaMGA() {
+        // Magen Avraham
         const [alot72, temporalHour] = this.getTemporalHour72(true);
         const offset = Math.floor(3 * temporalHour);
         return new Date(alot72.getTime() + offset);
@@ -8069,7 +8103,6 @@ class Zmanim {
      * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
      * Based on the opinion of the MGA that the day is calculated from
      * dawn to nightfall with both being 16.1° below the horizon.
-     * @return {Date}
      */
     sofZmanShmaMGA16Point1() {
         const [alot, temporalHour] = this.getTemporalHourByDeg(16.1);
@@ -8084,7 +8117,6 @@ class Zmanim {
      * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
      * around the equinox / equilux which calculates to 19.8° below geometric zenith.
      * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
-     * @return {Date}
      */
     sofZmanShmaMGA19Point8() {
         const [alot, temporalHour] = this.getTemporalHourByDeg(19.8);
@@ -8093,9 +8125,9 @@ class Zmanim {
     }
     /**
      * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham
-     * @return {Date}
      */
     sofZmanTfillaMGA() {
+        // Magen Avraham
         const [alot72, temporalHour] = this.getTemporalHour72(true);
         const offset = Math.floor(4 * temporalHour);
         return new Date(alot72.getTime() + offset);
@@ -8104,7 +8136,6 @@ class Zmanim {
      * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
      * Based on the opinion of the MGA that the day is calculated from
      * dawn to nightfall with both being 16.1° below the horizon.
-     * @return {Date}
      */
     sofZmanTfillaMGA16Point1() {
         const [alot, temporalHour] = this.getTemporalHourByDeg(16.1);
@@ -8119,7 +8150,6 @@ class Zmanim {
      * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
      * around the equinox / equilux which calculates to 19.8° below geometric zenith.
      * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
-     * @return {Date}
      */
     sofZmanTfillaMGA19Point8() {
         const [alot, temporalHour] = this.getTemporalHourByDeg(19.8);
@@ -8138,7 +8168,6 @@ class Zmanim {
      * The Ramba"m is of the opinion that it is better to delay *mincha* until
      * *mincha ketana* while the Ra"sh, Tur, GRA and others are of the
      * opinion that *mincha* can be prayed *lechatchila* starting at *mincha gedola*.
-     * @return {Date}
      */
     minchaGedola() {
         return this.getShaahZmanisBasedZman(6.5);
@@ -8150,7 +8179,6 @@ class Zmanim {
      * This method returns the time of *mincha gedola* according to the Magen Avraham
      * with the day starting 72 minutes before sunrise and ending 72 minutes after sunset.
      * This is the earliest time to pray *mincha*.
-     * @return {Date}
      */
     minchaGedolaMGA() {
         const [alot72, temporalHour] = this.getTemporalHour72(false);
@@ -8166,7 +8194,6 @@ class Zmanim {
      * that is 9.5 *shaos zmaniyos* (solar hours) after sunrise or sea level sunrise
      * (depending on the `useElevation` setting), according
      * to the [GRA](https://en.wikipedia.org/wiki/Vilna_Gaon).
-     * @return {Date}
      */
     minchaKetana() {
         return this.getShaahZmanisBasedZman(9.5);
@@ -8178,7 +8205,6 @@ class Zmanim {
      * the [Rambam](https://en.wikipedia.org/wiki/Maimonides) and others.
      *
      * If elevation is enabled, this function will include elevation in the calculation.
-     * @return {Date}
      */
     minchaKetanaMGA() {
         const [alot72, temporalHour] = this.getTemporalHour72(false);
@@ -8187,31 +8213,27 @@ class Zmanim {
     /**
      * Plag haMincha; Sunrise plus 10.75 halachic hours.
      * If elevation is enabled, this function will include elevation in the calculation.
-     * @return {Date}
      */
     plagHaMincha() {
         return this.getShaahZmanisBasedZman(10.75);
     }
     /**
-     * @param {number} [angle=8.5] optional time for solar depression.
+     * @param [angle=8.5] optional time for solar depression.
      *   Default is 8.5 degrees for 3 small stars, use 7.083 degrees for 3 medium-sized stars.
      * Because degree-based functions estimate the amount of light in the sky,
      * the result is not impacted by elevation.
-     * @return {Date}
      */
     tzeit(angle = 8.5) {
         return this.timeAtAngle(angle, false);
     }
     /**
      * Alias for sunrise
-     * @return {Date}
      */
     neitzHaChama() {
         return this.sunrise();
     }
     /**
      * Alias for sunset
-     * @return {Date}
      */
     shkiah() {
         return this.sunset();
@@ -8223,7 +8245,6 @@ class Zmanim {
      * it is 13.5 minutes before tzies 7.083.
      * Because degree-based functions estimate the amount of light in the sky,
      * the result is not impacted by elevation.
-     * @return {Date}
      */
     beinHaShmashos() {
         const tzeit = this.tzeit(7.083);
@@ -8231,13 +8252,10 @@ class Zmanim {
         if (isNaN(millis)) {
             return tzeit;
         }
-        return new Date(millis - (13.5 * 60 * 1000));
+        return new Date(millis - 13.5 * 60 * 1000);
     }
     /**
      * Uses timeFormat to return a date like '20:34'
-     * @param {Date} dt
-     * @param {Intl.DateTimeFormat} timeFormat
-     * @return {string}
      */
     static formatTime(dt, timeFormat) {
         const time = timeFormat.format(dt);
@@ -8249,8 +8267,7 @@ class Zmanim {
     }
     /**
      * Discards seconds, rounding to nearest minute.
-     * @param {Date} dt
-     * @return {Date}
+     * @param dt
      */
     static roundTime(dt) {
         const millis = dt.getTime();
@@ -8263,15 +8280,14 @@ class Zmanim {
         if (seconds === 0 && millisOnly === 0) {
             return dt;
         }
-        const secAndMillis = (seconds * 1000) + millisOnly;
-        const delta = (secAndMillis >= 30000) ? 60000 - secAndMillis : -1 * secAndMillis;
+        const secAndMillis = seconds * 1000 + millisOnly;
+        const delta = secAndMillis >= 30000 ? 60000 - secAndMillis : -1 * secAndMillis;
         return new Date(millis + delta);
     }
     /**
      * Get offset string (like "+05:00" or "-08:00") from tzid (like "Europe/Moscow")
-     * @param {string} tzid
-     * @param {Date} date
-     * @return {string}
+     * @param tzid
+     * @param date
      */
     static timeZoneOffset(tzid, date) {
         const offset = getTimezoneOffset(tzid, date);
@@ -8282,24 +8298,23 @@ class Zmanim {
     }
     /**
      * Returns a string like "2022-04-01T13:06:00-11:00"
-     * @param {string} tzid
-     * @param {Date} date
-     * @return {string}
+     * @param tzid
+     * @param date
      */
     static formatISOWithTimeZone(tzid, date) {
         if (isNaN(date.getTime())) {
             return '0000-00-00T00:00:00Z';
         }
-        return getPseudoISO(tzid, date).substring(0, 19) + Zmanim.timeZoneOffset(tzid, date);
+        return (getPseudoISO(tzid, date).substring(0, 19) +
+            Zmanim.timeZoneOffset(tzid, date));
     }
     /**
      * Returns sunrise + `offset` minutes (either positive or negative).
      * If elevation is enabled, this function will include elevation in the calculation
      *  unless `forceSeaLevel` is `true`.
-     * @param {number} offset minutes
-     * @param {boolean} roundMinute round time to nearest minute (default true)
-     * @param {boolean} forceSeaLevel use sea-level sunrise (default false)
-     * @return {Date}
+     * @param offset minutes
+     * @param roundMinute round time to nearest minute (default true)
+     * @param forceSeaLevel use sea-level sunrise (default false)
      */
     sunriseOffset(offset, roundMinute = true, forceSeaLevel = false) {
         const sunrise = forceSeaLevel ? this.seaLevelSunrise() : this.sunrise();
@@ -8313,16 +8328,15 @@ class Zmanim {
             }
             sunrise.setSeconds(0, 0);
         }
-        return new Date(sunrise.getTime() + (offset * 60 * 1000));
+        return new Date(sunrise.getTime() + offset * 60 * 1000);
     }
     /**
      * Returns sunset + `offset` minutes (either positive or negative).
      * If elevation is enabled, this function will include elevation in the calculation
      *  unless `forceSeaLevel` is `true`.
-     * @param {number} offset minutes
-     * @param {boolean} roundMinute round time to nearest minute (default true)
-     * @param {boolean} forceSeaLevel use sea-level sunset (default false)
-     * @return {Date}
+     * @param offset minutes
+     * @param roundMinute round time to nearest minute (default true)
+     * @param forceSeaLevel use sea-level sunset (default false)
      */
     sunsetOffset(offset, roundMinute = true, forceSeaLevel = false) {
         const sunset = forceSeaLevel ? this.seaLevelSunset() : this.sunset();
@@ -8336,19 +8350,29 @@ class Zmanim {
             }
             sunset.setSeconds(0, 0);
         }
-        return new Date(sunset.getTime() + (offset * 60 * 1000));
+        return new Date(sunset.getTime() + offset * 60 * 1000);
     }
 }
 
 const hour12cc = {
-    US: 1, CA: 1, BR: 1, AU: 1, NZ: 1, DO: 1, PR: 1, GR: 1, IN: 1, KR: 1, NP: 1, ZA: 1,
+    US: 1,
+    CA: 1,
+    BR: 1,
+    AU: 1,
+    NZ: 1,
+    DO: 1,
+    PR: 1,
+    GR: 1,
+    IN: 1,
+    KR: 1,
+    NP: 1,
+    ZA: 1,
 };
 /**
  * @private
- * @param {string} timeStr - original time like "20:30"
- * @param {string} suffix - "p" or "pm" or " P.M.". Add leading space if you want it
- * @param {CalOptions} options
- * @return {string}
+ * @param timeStr - original time like "20:30"
+ * @param suffix - "p" or "pm" or " P.M.". Add leading space if you want it
+ * @param options
  */
 function reformatTimeStr(timeStr, suffix, options) {
     var _a;
@@ -8382,7 +8406,7 @@ function reformatTimeStr(timeStr, suffix, options) {
 /** An event that has an `eventTime` and `eventTimeStr` */
 class TimedEvent extends Event {
     /**
-     * @param {string} desc Description (not translated)
+     * @param desc Description (not translated)
      */
     constructor(date, desc, mask, eventTime, location, linkedEvent, options) {
         super(date, desc, mask);
@@ -8397,21 +8421,18 @@ class TimedEvent extends Event {
         }
     }
     /**
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         return Locale.gettext(this.getDesc(), locale) + ': ' + this.fmtTime;
     }
     /**
      * Returns translation of "Candle lighting" without the time.
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     renderBrief(locale) {
         return Locale.gettext(this.getDesc(), locale);
     }
-    /** @return {string[]} */
     getCategories() {
         const desc = this.getDesc();
         switch (desc) {
@@ -8435,7 +8456,6 @@ class CandleLightingEvent extends TimedEvent {
     constructor(date, mask, eventTime, location, linkedEvent, options) {
         super(date, 'Candle lighting', mask, eventTime, location, linkedEvent, options);
     }
-    /** @return {string} */
     getEmoji() {
         return '🕯️';
     }
@@ -8449,16 +8469,14 @@ class HavdalahEvent extends TimedEvent {
         }
     }
     /**
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         return this.renderBrief(locale) + ': ' + this.fmtTime;
     }
     /**
      * Returns translation of "Havdalah" without the time.
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     renderBrief(locale) {
         let str = Locale.gettext(this.getDesc(), locale);
@@ -8468,7 +8486,6 @@ class HavdalahEvent extends TimedEvent {
         }
         return str;
     }
-    /** @return {string} */
     getEmoji() {
         return '✨';
     }
@@ -8476,7 +8493,15 @@ class HavdalahEvent extends TimedEvent {
 
 /* eslint-disable camelcase */
 const shortDayNames = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
-const heDayNames = ['רִאשׁוֹן', 'שֵׁנִי', 'שְׁלִישִׁי', 'רְבִיעִי', 'חֲמִישִׁי', 'שִׁישִּׁי', 'שַׁבָּת'];
+const heDayNames = [
+    'רִאשׁוֹן',
+    'שֵׁנִי',
+    'שְׁלִישִׁי',
+    'רְבִיעִי',
+    'חֲמִישִׁי',
+    'שִׁישִּׁי',
+    'שַׁבָּת',
+];
 const night = 'בַּלַּ֥יְלָה';
 function getHebrewTimeOfDay(hour) {
     if (hour < 5)
@@ -8495,58 +8520,54 @@ function getHebrewTimeOfDay(hour) {
 class Molad {
     /**
      * Calculates the molad for a Hebrew month
-     * @param {number} year
-     * @param {number} month
+     * @param year
+     * @param month
      */
     constructor(year, month) {
         this.m = molad(year, month);
     }
     /**
-     * @return {number}
      */
     getYear() {
         return this.m.year;
     }
     /**
-     * @return {number}
      */
     getMonth() {
         return this.m.month;
     }
     /**
-     * @return {string}
      */
     getMonthName() {
         return HDate.getMonthName(this.m.month, this.m.year);
     }
     /**
-     * @return {number} Day of Week (0=Sunday, 6=Saturday)
+     * @returns Day of Week (0=Sunday, 6=Saturday)
      */
     getDow() {
         return this.m.dayOfWeek;
     }
     /**
-     * @return {number} hour of day (0-23)
+     * @returns hour of day (0-23)
      */
     getHour() {
         return this.m.hour;
     }
     /**
-     * @return {number} minutes past hour (0-59)
+     * @returns minutes past hour (0-59)
      */
     getMinutes() {
         return this.m.minutes;
     }
     /**
-     * @return {number} parts of a minute (0-17)
+     * @returns parts of a minute (0-17)
      */
     getChalakim() {
         return this.m.chalakim;
     }
     /**
-     * @param {string} [locale] Optional locale name (defaults to active locale)
-     * @param {CalOptions} options
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale)
+     * @param options
      */
     render(locale, options) {
         var _a;
@@ -8583,10 +8604,10 @@ class Molad {
 /** Represents a Molad announcement on Shabbat Mevarchim */
 class MoladEvent extends Event {
     /**
-     * @param {HDate} date Hebrew date event occurs
-     * @param {number} hyear molad year
-     * @param {number} hmonth molad month
-     * @param {CalOptions} options
+     * @param date Hebrew date event occurs
+     * @param hyear molad year
+     * @param hmonth molad month
+     * @param options
      */
     constructor(date, hyear, hmonth, options) {
         const m = new Molad(hyear, hmonth);
@@ -8596,8 +8617,7 @@ class MoladEvent extends Event {
         this.options = options;
     }
     /**
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         return this.molad.render(locale, this.options);
@@ -8607,8 +8627,8 @@ class MoladEvent extends Event {
 /** Represents a day 1-49 of counting the Omer from Pesach to Shavuot */
 class OmerEvent extends Event {
     /**
-     * @param {HDate} date
-     * @param {number} omerDay
+     * @param date
+     * @param omerDay
      */
     constructor(date, omerDay) {
         super(date, `Omer ${omerDay}`, flags.OMER_COUNT);
@@ -8616,12 +8636,11 @@ class OmerEvent extends Event {
             throw new RangeError(`Invalid Omer day ${omerDay}`);
         }
         this.weekNumber = Math.floor((omerDay - 1) / 7) + 1;
-        this.daysWithinWeeks = (omerDay % 7) || 7;
+        this.daysWithinWeeks = omerDay % 7 || 7;
         this.omer = omerDay;
     }
     /**
-     * @param {string} lang
-     * @return {string}
+     * @param lang
      */
     sefira(lang = 'en') {
         if (lang !== 'he' && lang !== 'translit') {
@@ -8631,8 +8650,7 @@ class OmerEvent extends Event {
     }
     /**
      * @todo use gettext()
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         locale = locale !== null && locale !== void 0 ? locale : Locale.getLocaleName();
@@ -8646,30 +8664,29 @@ class OmerEvent extends Event {
     }
     /**
      * Returns translation of "Omer day 22" without ordinal numbers.
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     renderBrief(locale) {
-        return Locale.gettext('Omer', locale) + ' ' + Locale.gettext('day', locale) + ' ' + this.omer;
+        return (Locale.gettext('Omer', locale) +
+            ' ' +
+            Locale.gettext('day', locale) +
+            ' ' +
+            this.omer);
     }
-    /** @return {string} */
     getEmoji() {
         if (typeof this.emoji === 'string')
             return this.emoji;
         return omerEmoji(this.omer);
     }
-    /** @return {number} */
     getWeeks() {
         const day7 = this.daysWithinWeeks === 7;
         return day7 ? this.weekNumber : this.weekNumber - 1;
     }
-    /** @return {number} */
     getDaysWithinWeeks() {
         return this.daysWithinWeeks;
     }
     /**
-     * @param {string} locale
-     * @return {string}
+     * @param locale
      */
     getTodayIs(locale) {
         locale = locale !== null && locale !== void 0 ? locale : Locale.getLocaleName();
@@ -8683,7 +8700,6 @@ class OmerEvent extends Event {
         }
         return str;
     }
-    /** @return {string} */
     url() {
         return `https://www.hebcal.com/omer/${this.getDate().getFullYear()}/${this.omer}`;
     }
@@ -9026,8 +9042,8 @@ function yearType(hyear) {
 class Sedra {
     /**
      * Caculates the Parashah HaShavua for an entire Hebrew year
-     * @param {number} hyear - Hebrew year (e.g. 5749)
-     * @param {boolean} il - Use Israel sedra schedule (false for Diaspora)
+     * @param hyear - Hebrew year (e.g. 5749)
+     * @param il - Use Israel sedra schedule (false for Diaspora)
      */
     constructor(hyear, il) {
         hyear = +hyear;
@@ -9045,7 +9061,7 @@ class Sedra {
             this.theSedraArray = types[key];
         }
         else {
-            key = key + (+this.il); // cast to num, then concat
+            key = key + +this.il; // cast to num, then concat
             this.theSedraArray = types[key];
         }
         if (!this.theSedraArray) {
@@ -9054,24 +9070,22 @@ class Sedra {
     }
     /**
      * Returns the parsha (or parshiyot) read on Hebrew date
-     * @param {HDate|number} hd Hebrew date or R.D. days
-     * @return {string[]}
+     * @param hd Hebrew date or R.D. days
      */
     get(hd) {
         return this.lookup(hd).parsha;
     }
     /**
      * Looks up parsha for the date, then returns a translated or transliterated string
-     * @param {HDate|number} hd Hebrew date or R.D. days
-     * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale
-     * @return {string}
+     * @param hd Hebrew date or R.D. days
+     * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale
      */
     getString(hd, locale) {
         const parsha = this.get(hd);
         const locale0 = locale || Locale.getLocaleName();
         let name = Locale.gettext(parsha[0], locale0);
-        if (parsha.length == 2) {
-            const hyphen = locale0 == 'he' ? '־' : '-';
+        if (parsha.length === 2) {
+            const hyphen = locale0 === 'he' ? '־' : '-';
             name += hyphen + Locale.gettext(parsha[1], locale0);
         }
         name = name.replace(/'/g, '’');
@@ -9080,8 +9094,7 @@ class Sedra {
     /**
      * Checks to see if this day would be a regular parasha HaShavua
      * Torah reading or special holiday reading
-     * @param {HDate|number} hd Hebrew date or R.D. days
-     * @return {boolean}
+     * @param hd Hebrew date or R.D. days
      */
     isParsha(hd) {
         return !this.lookup(hd).chag;
@@ -9089,8 +9102,6 @@ class Sedra {
     /**
      * Returns the date that a parsha occurs
      * or `null` if the parsha doesn't occur this year
-     * @param {number|string|string[]} parsha
-     * @return {HDate|null}
      */
     find(parsha) {
         if (typeof parsha === 'number') {
@@ -9101,7 +9112,7 @@ class Sedra {
             if (idx === -1) {
                 return null; // doesn't occur this year
             }
-            return new HDate(this.firstSaturday + (idx * 7));
+            return new HDate(this.firstSaturday + idx * 7);
         }
         else if (typeof parsha === 'string') {
             const num = parsha2id.get(parsha);
@@ -9117,15 +9128,18 @@ class Sedra {
                 if (idx === -1) {
                     return null; // doesn't occur this year
                 }
-                return new HDate(this.firstSaturday + (idx * 7));
+                return new HDate(this.firstSaturday + idx * 7);
             }
         }
-        else if (Array.isArray(parsha) && parsha.length === 1 &&
+        else if (Array.isArray(parsha) &&
+            parsha.length === 1 &&
             typeof parsha[0] === 'string') {
             return this.find(parsha[0]);
         }
-        else if (Array.isArray(parsha) && parsha.length === 2 &&
-            typeof parsha[0] === 'string' && typeof parsha[1] === 'string') {
+        else if (Array.isArray(parsha) &&
+            parsha.length === 2 &&
+            typeof parsha[0] === 'string' &&
+            typeof parsha[1] === 'string') {
             const p1 = parsha[0];
             const p2 = parsha[1];
             const num1 = parsha2id.get(p1);
@@ -9144,30 +9158,25 @@ class Sedra {
     /**
      * Returns the underlying annual sedra schedule.
      * Used by `@hebcal/triennial`
-     * @return {NumberOrString[]}
      */
     getSedraArray() {
         return this.theSedraArray;
     }
     /**
      * R.D. date of the first Saturday on or after Rosh Hashana
-     * @return {number}
      */
     getFirstSaturday() {
         return this.firstSaturday;
     }
-    /** @return {number} */
     getYear() {
         return this.year;
     }
     /**
      * Returns an object describing the parsha on the first Saturday on or after `hd`
-     * @param {HDate|number} hd Hebrew date or R.D. days
-     * @return {SedraResult}
+     * @param hd Hebrew date or R.D. days
      */
     lookup(hd) {
-        const abs = (typeof hd === 'number') ? hd :
-            HDate.isHDate(hd) ? hd.abs() : NaN;
+        const abs = typeof hd === 'number' ? hd : HDate.isHDate(hd) ? hd.abs() : NaN;
         if (isNaN(abs)) {
             throw new TypeError(`Bad date argument: ${hd}`);
         }
@@ -9236,8 +9245,8 @@ const parshiot = [
     'Bechukotai',
     'Bamidbar',
     'Nasso',
-    'Beha\'alotcha',
-    'Sh\'lach',
+    "Beha'alotcha",
+    "Sh'lach",
     'Korach',
     'Chukat',
     'Balak',
@@ -9247,13 +9256,13 @@ const parshiot = [
     'Devarim',
     'Vaetchanan',
     'Eikev',
-    'Re\'eh',
+    "Re'eh",
     'Shoftim',
     'Ki Teitzei',
     'Ki Tavo',
     'Nitzavim',
     'Vayeilech',
-    'Ha\'azinu',
+    "Ha'azinu",
 ];
 const parsha2id = new Map();
 for (let id = 0; id < parshiot.length; id++) {
@@ -9262,8 +9271,7 @@ for (let id = 0; id < parshiot.length; id++) {
 }
 /**
  * @private
- * @param {number} id
- * @return {boolean}
+ * @param id
  */
 function isValidDouble(id) {
     switch (id) {
@@ -9281,8 +9289,7 @@ function isValidDouble(id) {
 /**
  * parsha doubler/undoubler
  * @private
- * @param {number} p
- * @return {number}
+ * @param p
  */
 function D(p) {
     return -p;
@@ -9301,9 +9308,8 @@ const SHAVUOT$1 = 'Shavuot'; // 33
 /**
  * Returns an array from start to end
  * @private
- * @param {number} start beginning number, inclusive
- * @param {number} stop ending number, inclusive
- * @return {number[]}
+ * @param start beginning number, inclusive
+ * @param stop ending number, inclusive
  */
 function range$1(start, stop) {
     return Array.from({ length: stop - start + 1 }, (v, k) => k + start);
@@ -9324,64 +9330,64 @@ const r4350 = range$1(43, 50);
  */
 const types = {
     /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and
-       * Kislev each have 29 days), and has Passover start on Tuesday. */
+     * Kislev each have 29 days), and has Passover start on Tuesday. */
     // e.g. 5753
     '020': yearStartVayeilech.concat(r020, D(21), 23, 24, PESACH, 25, D(26), D(28), 30, D(31), r3340, D(41), r4349, D(50)),
     /* Hebrew year that starts on Monday, is `complete' (Heshvan and
-       * Kislev each have 30 days), and has Passover start on Thursday. */
+     * Kislev each have 30 days), and has Passover start on Thursday. */
     // e.g. 5756
     '0220': yearStartVayeilech.concat(r020, D(21), 23, 24, PESACH, 25, D(26), D(28), 30, D(31), 33, SHAVUOT$1, range$1(34, 37), D(38), 40, D(41), r4349, 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. */
+     * days and Kislev has 30 days), and has Passover start on Saturday. */
     // e.g. 5701
     '0510': yearStartHaazinu.concat(r020, D(21), 23, 24, PESACH1, PESACH8, 25, D(26), D(28), 30, D(31), r3340, D(41), r4350),
     /* Hebrew year that starts on Thursday, is `regular' (Heshvan has 29
-       * days and Kislev has 30 days), and has Passover start on Saturday. */
+     * days and Kislev has 30 days), and has Passover start on Saturday. */
     // e.g. 5745
     '0511': yearStartHaazinu.concat(r020, D(21), 23, 24, PESACH, 25, D(26), D(28), range$1(30, 40), D(41), r4350),
     /* Hebrew year that starts on Thursday, is `complete' (Heshvan and
-       * Kislev each have 30 days), and has Passover start on Sunday. */
+     * Kislev each have 30 days), and has Passover start on Sunday. */
     // e.g. 5754
     '052': yearStartHaazinu.concat(range$1(0, 24), PESACH7, 25, D(26), D(28), 30, D(31), r3340, D(41), r4350),
     /* Hebrew year that starts on Saturday, is `incomplete' (Heshvan and Kislev
-       * each have 29 days), and has Passover start on Sunday. */
+     * each have 29 days), and has Passover start on Sunday. */
     // e.g. 5761
     '070': yearStartRH.concat(r020, D(21), 23, 24, PESACH7, 25, D(26), D(28), 30, D(31), r3340, D(41), r4350),
     /* Hebrew year that starts on Saturday, is `complete' (Heshvan and
-       * Kislev each have 30 days), and has Passover start on Tuesday. */
+     * Kislev each have 30 days), and has Passover start on Tuesday. */
     // e.g. 5716
     '072': yearStartRH.concat(r020, D(21), 23, 24, CHMPESACH, 25, D(26), D(28), 30, D(31), r3340, D(41), r4349, 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. */
+     * Kislev each have 29 days), and has Passover start on Thursday. */
     // e.g. 5746
     '1200': yearStartVayeilech.concat(r027, CHMPESACH, range$1(28, 33), SHAVUOT$1, range$1(34, 37), D(38), 40, D(41), r4349, D(50)),
     /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and
-       * Kislev each have 29 days), and has Passover start on Thursday. */
+     * Kislev each have 29 days), and has Passover start on Thursday. */
     // e.g. 5746
     '1201': yearStartVayeilech.concat(r027, CHMPESACH, range$1(28, 40), D(41), r4349, D(50)),
     /* Hebrew year that starts on Monday, is `complete' (Heshvan and
-       * Kislev each have 30 days), and has Passover start on Saturday. */
+     * Kislev each have 30 days), and has Passover start on Saturday. */
     // e.g.5752
     '1220': yearStartVayeilech.concat(r027, PESACH1, PESACH8, range$1(28, 40), D(41), r4350),
     /* Hebrew year that starts on Monday, is `complete' (Heshvan and
-       * Kislev each have 30 days), and has Passover start on Saturday. */
+     * Kislev each have 30 days), and has Passover start on Saturday. */
     // e.g.5752
     '1221': yearStartVayeilech.concat(r027, 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. */
+     * Kislev both have 29 days), and has Passover start on Sunday. */
     // e.g. 5768
     '150': yearStartHaazinu.concat(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. */
+     * Kislev both have 30 days), and has Passover start on Tuesday. */
     // eg. 5771
     '152': yearStartHaazinu.concat(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. */
+     * Kislev each have 29 days), and has Passover start on Tuesday. */
     // e.g.5757
     '170': yearStartRH.concat(r027, CHMPESACH, range$1(28, 40), D(41), r4349, D(50)),
     /* Hebrew year that starts on Saturday, is `complete' (Heshvan and
-       * Kislev each have 30 days), and has Passover start on Thursday. */
+     * Kislev each have 30 days), and has Passover start on Thursday. */
     '1720': yearStartRH.concat(r027, CHMPESACH, range$1(28, 33), SHAVUOT$1, range$1(34, 37), D(38), 40, D(41), r4349, D(50)),
 };
 /* Hebrew year that starts on Monday, is `complete' (Heshvan and
@@ -9409,9 +9415,8 @@ const sedraCache = new QuickLRU({ maxSize: 400 });
  * Convenience function to create an instance of `Sedra` or reuse a previously
  * created and cached instance.
  * @private
- * @param {number} hyear
- * @param {boolean} il
- * @return {Sedra}
+ * @param hyear
+ * @param il
  */
 function getSedra_(hyear, il) {
     const cacheKey = `${hyear}-${il ? 1 : 0}`;
@@ -9428,11 +9433,8 @@ function getSedra_(hyear, il) {
  */
 class ParshaEvent extends Event {
     /**
-     * @param {HDate} date
-     * @param {string[]} parsha - untranslated name of single or double parsha,
+     * @param parsha - untranslated name of single or double parsha,
      *   such as ['Bereshit'] or ['Achrei Mot', 'Kedoshim']
-     * @param {boolean} [il]
-     * @param {number|number[]} [num]
      */
     constructor(date, parsha, il = false, num = -1) {
         if (!Array.isArray(parsha) || parsha.length === 0 || parsha.length > 2) {
@@ -9445,26 +9447,23 @@ class ParshaEvent extends Event {
         this.num = num || -1;
     }
     /**
-     * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
-     * @return {string}
+     * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
      */
     render(locale) {
         const locale0 = locale !== null && locale !== void 0 ? locale : Locale.getLocaleName();
         const parsha = this.parsha;
         let name = Locale.gettext(parsha[0], locale);
-        if (parsha.length == 2) {
-            const hyphen = locale0 == 'he' ? '־' : '-';
+        if (parsha.length === 2) {
+            const hyphen = locale0 === 'he' ? '־' : '-';
             name += hyphen + Locale.gettext(parsha[1], locale);
         }
         name = name.replace(/'/g, '’');
         const str = Locale.gettext('Parashat', locale) + ' ' + name;
         return str.normalize();
     }
-    /** @return {string} */
     basename() {
         return this.parsha.join('-');
     }
-    /** @return {string | undefined} */
     url() {
         const year = this.getDate().greg().getFullYear();
         if (year < 100) {
@@ -9472,10 +9471,11 @@ class ParshaEvent extends Event {
         }
         const dt = this.urlDateSuffix();
         const url = 'https://www.hebcal.com/sedrot/' +
-            this.basename().toLowerCase().replace(/'/g, '').replace(/ /g, '-') + '-' + dt;
+            this.basename().toLowerCase().replace(/'/g, '').replace(/ /g, '-') +
+            '-' +
+            dt;
         return this.il ? url + '?i=on' : url;
     }
-    /** @return {string} */
     urlDateSuffix() {
         const isoDate = isoDateString(this.getDate().greg());
         return isoDate.replace(/-/g, '');
@@ -9512,13 +9512,13 @@ const YOM_KIPPUR = 'Yom Kippur';
 const EREV_SUKKOT = 'Erev Sukkot';
 const SUKKOT_I = 'Sukkot I';
 const SUKKOT_II = 'Sukkot II';
-const SUKKOT_III_CHM = 'Sukkot III (CH\'\'M)';
-const SUKKOT_IV_CHM = 'Sukkot IV (CH\'\'M)';
-const SUKKOT_V_CHM = 'Sukkot V (CH\'\'M)';
-const SUKKOT_VI_CHM = 'Sukkot VI (CH\'\'M)';
+const SUKKOT_III_CHM = "Sukkot III (CH''M)";
+const SUKKOT_IV_CHM = "Sukkot IV (CH''M)";
+const SUKKOT_V_CHM = "Sukkot V (CH''M)";
+const SUKKOT_VI_CHM = "Sukkot VI (CH''M)";
 const SHMINI_ATZERET = 'Shmini Atzeret';
 const SIMCHAT_TORAH = 'Simchat Torah';
-const SUKKOT_II_CHM = 'Sukkot II (CH\'\'M)';
+const SUKKOT_II_CHM = "Sukkot II (CH''M)";
 const SUKKOT_VII_HOSHANA_RABA = 'Sukkot VII (Hoshana Raba)';
 const CHANUKAH_1_CANDLE = 'Chanukah: 1 Candle';
 const TU_BISHVAT = 'Tu BiShvat';
@@ -9528,11 +9528,11 @@ const SHUSHAN_PURIM = 'Shushan Purim';
 const EREV_PESACH = 'Erev Pesach';
 const PESACH_I = 'Pesach I';
 const PESACH_II = 'Pesach II';
-const PESACH_II_CHM = 'Pesach II (CH\'\'M)';
-const PESACH_III_CHM = 'Pesach III (CH\'\'M)';
-const PESACH_IV_CHM = 'Pesach IV (CH\'\'M)';
-const PESACH_V_CHM = 'Pesach V (CH\'\'M)';
-const PESACH_VI_CHM = 'Pesach VI (CH\'\'M)';
+const PESACH_II_CHM = "Pesach II (CH''M)";
+const PESACH_III_CHM = "Pesach III (CH''M)";
+const PESACH_IV_CHM = "Pesach IV (CH''M)";
+const PESACH_V_CHM = "Pesach V (CH''M)";
+const PESACH_VI_CHM = "Pesach VI (CH''M)";
 const PESACH_VII = 'Pesach VII';
 const PESACH_VIII = 'Pesach VIII';
 const PESACH_SHENI = 'Pesach Sheni';
@@ -9541,7 +9541,7 @@ const EREV_SHAVUOT = 'Erev Shavuot';
 const SHAVUOT = 'Shavuot';
 const SHAVUOT_I = 'Shavuot I';
 const SHAVUOT_II = 'Shavuot II';
-const TU_BAV = 'Tu B\'Av';
+const TU_BAV = "Tu B'Av";
 const ROSH_HASHANA_LABEHEMOT = 'Rosh Hashana LaBehemot';
 const EREV_ROSH_HASHANA = 'Erev Rosh Hashana';
 const YOM_YERUSHALAYIM = 'Yom Yerushalayim';
@@ -9561,7 +9561,7 @@ const HEBREW_LANGUAGE_DAY = 'Hebrew Language Day';
  */
 const holidayDesc = {
     /** Asara B'Tevet */
-    ASARA_BTEVET: 'Asara B\'Tevet',
+    ASARA_BTEVET: "Asara B'Tevet",
     /** Birkat Hachamah */
     BIRKAT_HACHAMAH: 'Birkat Hachamah',
     /** Chag HaBanot */
@@ -9569,7 +9569,7 @@ const holidayDesc = {
     /** Chanukah: 8th Day */
     CHANUKAH_8TH_DAY: 'Chanukah: 8th Day',
     /** Erev Tish'a B'Av */
-    EREV_TISHA_BAV: 'Erev Tish\'a B\'Av',
+    EREV_TISHA_BAV: "Erev Tish'a B'Av",
     /** Leil Selichot */
     LEIL_SELICHOT: 'Leil Selichot',
     /** Purim Katan */
@@ -9597,17 +9597,17 @@ const holidayDesc = {
     /** Shushan Purim Katan */
     SHUSHAN_PURIM_KATAN: 'Shushan Purim Katan',
     /** Ta'anit Bechorot */
-    TAANIT_BECHOROT: 'Ta\'anit Bechorot',
+    TAANIT_BECHOROT: "Ta'anit Bechorot",
     /** Ta'anit Esther */
-    TAANIT_ESTHER: 'Ta\'anit Esther',
+    TAANIT_ESTHER: "Ta'anit Esther",
     /** Tish'a B'Av */
-    TISHA_BAV: 'Tish\'a B\'Av',
+    TISHA_BAV: "Tish'a B'Av",
     /** Tzom Gedaliah */
     TZOM_GEDALIAH: 'Tzom Gedaliah',
     /** Tzom Tammuz */
     TZOM_TAMMUZ: 'Tzom Tammuz',
     /** Yom HaAtzma'ut */
-    YOM_HAATZMA_UT: 'Yom HaAtzma\'ut',
+    YOM_HAATZMA_UT: "Yom HaAtzma'ut",
     /** Yom HaShoah */
     YOM_HASHOAH: 'Yom HaShoah',
     /** Yom HaZikaron */
@@ -9710,110 +9710,396 @@ const holidayDesc = {
     YOM_YERUSHALAYIM,
 };
 const staticHolidays = [
-    { mm: Tishrei, dd: 2, desc: ROSH_HASHANA_II, flags: CHAG$1 | YOM_TOV_ENDS$1, emoji: '🍏🍯' },
+    {
+        mm: Tishrei,
+        dd: 2,
+        desc: ROSH_HASHANA_II,
+        flags: CHAG$1 | YOM_TOV_ENDS$1,
+        emoji: '🍏🍯',
+    },
     { mm: Tishrei, dd: 9, desc: EREV_YOM_KIPPUR, flags: EREV$2 | LIGHT_CANDLES$1 },
-    { mm: Tishrei, dd: 10, desc: YOM_KIPPUR, flags: CHAG$1 | MAJOR_FAST$2 | YOM_TOV_ENDS$1 },
-    { mm: Tishrei, dd: 14, desc: EREV_SUKKOT, flags: CHUL_ONLY$1 | EREV$2 | LIGHT_CANDLES$1, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 15, desc: SUKKOT_I, flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 16, desc: SUKKOT_II, flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 17, desc: SUKKOT_III_CHM, flags: CHUL_ONLY$1 | CHOL_HAMOED$1, chmDay: 1, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 18, desc: SUKKOT_IV_CHM, flags: CHUL_ONLY$1 | CHOL_HAMOED$1, chmDay: 2, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 19, desc: SUKKOT_V_CHM, flags: CHUL_ONLY$1 | CHOL_HAMOED$1, chmDay: 3, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 20, desc: SUKKOT_VI_CHM, flags: CHUL_ONLY$1 | CHOL_HAMOED$1, chmDay: 4, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 22, desc: SHMINI_ATZERET,
-        flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2 },
-    { mm: Tishrei, dd: 23, desc: SIMCHAT_TORAH,
-        flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1 },
-    { mm: Tishrei, dd: 14, desc: EREV_SUKKOT, flags: IL_ONLY$2 | EREV$2 | LIGHT_CANDLES$1, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 15, desc: SUKKOT_I, flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 16, desc: SUKKOT_II_CHM, flags: IL_ONLY$2 | CHOL_HAMOED$1, chmDay: 1, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 17, desc: SUKKOT_III_CHM, flags: IL_ONLY$2 | CHOL_HAMOED$1, chmDay: 2, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 18, desc: SUKKOT_IV_CHM, flags: IL_ONLY$2 | CHOL_HAMOED$1, chmDay: 3, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 19, desc: SUKKOT_V_CHM, flags: IL_ONLY$2 | CHOL_HAMOED$1, chmDay: 4, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 20, desc: SUKKOT_VI_CHM, flags: IL_ONLY$2 | CHOL_HAMOED$1, chmDay: 5, emoji: emojiSukkot },
-    { mm: Tishrei, dd: 22, desc: SHMINI_ATZERET,
-        flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1 },
-    { mm: Tishrei, dd: 21, desc: SUKKOT_VII_HOSHANA_RABA,
-        flags: LIGHT_CANDLES$1 | CHOL_HAMOED$1, chmDay: -1, emoji: emojiSukkot },
-    { mm: Kislev, dd: 24, desc: CHANUKAH_1_CANDLE,
-        flags: EREV$2 | MINOR_HOLIDAY$2 | CHANUKAH_CANDLES$2, emoji: '🕎1️⃣' },
+    {
+        mm: Tishrei,
+        dd: 10,
+        desc: YOM_KIPPUR,
+        flags: CHAG$1 | MAJOR_FAST$2 | YOM_TOV_ENDS$1,
+    },
+    {
+        mm: Tishrei,
+        dd: 14,
+        desc: EREV_SUKKOT,
+        flags: CHUL_ONLY$1 | EREV$2 | LIGHT_CANDLES$1,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 15,
+        desc: SUKKOT_I,
+        flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 16,
+        desc: SUKKOT_II,
+        flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 17,
+        desc: SUKKOT_III_CHM,
+        flags: CHUL_ONLY$1 | CHOL_HAMOED$1,
+        chmDay: 1,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 18,
+        desc: SUKKOT_IV_CHM,
+        flags: CHUL_ONLY$1 | CHOL_HAMOED$1,
+        chmDay: 2,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 19,
+        desc: SUKKOT_V_CHM,
+        flags: CHUL_ONLY$1 | CHOL_HAMOED$1,
+        chmDay: 3,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 20,
+        desc: SUKKOT_VI_CHM,
+        flags: CHUL_ONLY$1 | CHOL_HAMOED$1,
+        chmDay: 4,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 22,
+        desc: SHMINI_ATZERET,
+        flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2,
+    },
+    {
+        mm: Tishrei,
+        dd: 23,
+        desc: SIMCHAT_TORAH,
+        flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1,
+    },
+    {
+        mm: Tishrei,
+        dd: 14,
+        desc: EREV_SUKKOT,
+        flags: IL_ONLY$2 | EREV$2 | LIGHT_CANDLES$1,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 15,
+        desc: SUKKOT_I,
+        flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 16,
+        desc: SUKKOT_II_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1,
+        chmDay: 1,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 17,
+        desc: SUKKOT_III_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1,
+        chmDay: 2,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 18,
+        desc: SUKKOT_IV_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1,
+        chmDay: 3,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 19,
+        desc: SUKKOT_V_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1,
+        chmDay: 4,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 20,
+        desc: SUKKOT_VI_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1,
+        chmDay: 5,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Tishrei,
+        dd: 22,
+        desc: SHMINI_ATZERET,
+        flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1,
+    },
+    {
+        mm: Tishrei,
+        dd: 21,
+        desc: SUKKOT_VII_HOSHANA_RABA,
+        flags: LIGHT_CANDLES$1 | CHOL_HAMOED$1,
+        chmDay: -1,
+        emoji: emojiSukkot,
+    },
+    {
+        mm: Kislev,
+        dd: 24,
+        desc: CHANUKAH_1_CANDLE,
+        flags: EREV$2 | MINOR_HOLIDAY$2 | CHANUKAH_CANDLES$2,
+        emoji: '🕎1️⃣',
+    },
     { mm: Shvat, dd: 15, desc: TU_BISHVAT, flags: MINOR_HOLIDAY$2, emoji: '🌳' },
-    { mm: Adar2, dd: 13, desc: EREV_PURIM, flags: EREV$2 | MINOR_HOLIDAY$2, emoji: '🎭️📜' },
+    {
+        mm: Adar2,
+        dd: 13,
+        desc: EREV_PURIM,
+        flags: EREV$2 | MINOR_HOLIDAY$2,
+        emoji: '🎭️📜',
+    },
     { mm: Adar2, dd: 14, desc: PURIM, flags: MINOR_HOLIDAY$2, emoji: '🎭️📜' },
-    { mm: Adar2, dd: 15, desc: SHUSHAN_PURIM, flags: MINOR_HOLIDAY$2, emoji: '🎭️📜' },
+    {
+        mm: Adar2,
+        dd: 15,
+        desc: SHUSHAN_PURIM,
+        flags: MINOR_HOLIDAY$2,
+        emoji: '🎭️📜',
+    },
     // Pesach Israel
-    { mm: Nisan, dd: 14, desc: EREV_PESACH,
-        flags: IL_ONLY$2 | EREV$2 | LIGHT_CANDLES$1, emoji: '🫓🍷' },
-    { mm: Nisan, dd: 15, desc: PESACH_I,
-        flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1, emoji: emojiPesach },
-    { mm: Nisan, dd: 16, desc: PESACH_II_CHM,
-        flags: IL_ONLY$2 | CHOL_HAMOED$1, chmDay: 1, emoji: emojiPesach },
-    { mm: Nisan, dd: 17, desc: PESACH_III_CHM,
-        flags: IL_ONLY$2 | CHOL_HAMOED$1, chmDay: 2, emoji: emojiPesach },
-    { mm: Nisan, dd: 18, desc: PESACH_IV_CHM,
-        flags: IL_ONLY$2 | CHOL_HAMOED$1, chmDay: 3, emoji: emojiPesach },
-    { mm: Nisan, dd: 19, desc: PESACH_V_CHM,
-        flags: IL_ONLY$2 | CHOL_HAMOED$1, chmDay: 4, emoji: emojiPesach },
-    { mm: Nisan, dd: 20, desc: PESACH_VI_CHM,
-        flags: IL_ONLY$2 | CHOL_HAMOED$1 | LIGHT_CANDLES$1, chmDay: 5, emoji: emojiPesach },
-    { mm: Nisan, dd: 21, desc: PESACH_VII,
-        flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1, emoji: emojiPesach },
+    {
+        mm: Nisan,
+        dd: 14,
+        desc: EREV_PESACH,
+        flags: IL_ONLY$2 | EREV$2 | LIGHT_CANDLES$1,
+        emoji: '🫓🍷',
+    },
+    {
+        mm: Nisan,
+        dd: 15,
+        desc: PESACH_I,
+        flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 16,
+        desc: PESACH_II_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1,
+        chmDay: 1,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 17,
+        desc: PESACH_III_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1,
+        chmDay: 2,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 18,
+        desc: PESACH_IV_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1,
+        chmDay: 3,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 19,
+        desc: PESACH_V_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1,
+        chmDay: 4,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 20,
+        desc: PESACH_VI_CHM,
+        flags: IL_ONLY$2 | CHOL_HAMOED$1 | LIGHT_CANDLES$1,
+        chmDay: 5,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 21,
+        desc: PESACH_VII,
+        flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1,
+        emoji: emojiPesach,
+    },
     // Pesach chutz l'aretz
-    { mm: Nisan, dd: 14, desc: EREV_PESACH,
-        flags: CHUL_ONLY$1 | EREV$2 | LIGHT_CANDLES$1, emoji: '🫓🍷' },
-    { mm: Nisan, dd: 15, desc: PESACH_I,
-        flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2, emoji: '🫓🍷' },
-    { mm: Nisan, dd: 16, desc: PESACH_II,
-        flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1, emoji: emojiPesach },
-    { mm: Nisan, dd: 17, desc: PESACH_III_CHM,
-        flags: CHUL_ONLY$1 | CHOL_HAMOED$1, chmDay: 1, emoji: emojiPesach },
-    { mm: Nisan, dd: 18, desc: PESACH_IV_CHM,
-        flags: CHUL_ONLY$1 | CHOL_HAMOED$1, chmDay: 2, emoji: emojiPesach },
-    { mm: Nisan, dd: 19, desc: PESACH_V_CHM,
-        flags: CHUL_ONLY$1 | CHOL_HAMOED$1, chmDay: 3, emoji: emojiPesach },
-    { mm: Nisan, dd: 20, desc: PESACH_VI_CHM,
-        flags: CHUL_ONLY$1 | CHOL_HAMOED$1 | LIGHT_CANDLES$1, chmDay: 4, emoji: emojiPesach },
-    { mm: Nisan, dd: 21, desc: PESACH_VII,
-        flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2, emoji: emojiPesach },
-    { mm: Nisan, dd: 22, desc: PESACH_VIII,
-        flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1, emoji: emojiPesach },
+    {
+        mm: Nisan,
+        dd: 14,
+        desc: EREV_PESACH,
+        flags: CHUL_ONLY$1 | EREV$2 | LIGHT_CANDLES$1,
+        emoji: '🫓🍷',
+    },
+    {
+        mm: Nisan,
+        dd: 15,
+        desc: PESACH_I,
+        flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2,
+        emoji: '🫓🍷',
+    },
+    {
+        mm: Nisan,
+        dd: 16,
+        desc: PESACH_II,
+        flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 17,
+        desc: PESACH_III_CHM,
+        flags: CHUL_ONLY$1 | CHOL_HAMOED$1,
+        chmDay: 1,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 18,
+        desc: PESACH_IV_CHM,
+        flags: CHUL_ONLY$1 | CHOL_HAMOED$1,
+        chmDay: 2,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 19,
+        desc: PESACH_V_CHM,
+        flags: CHUL_ONLY$1 | CHOL_HAMOED$1,
+        chmDay: 3,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 20,
+        desc: PESACH_VI_CHM,
+        flags: CHUL_ONLY$1 | CHOL_HAMOED$1 | LIGHT_CANDLES$1,
+        chmDay: 4,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 21,
+        desc: PESACH_VII,
+        flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2,
+        emoji: emojiPesach,
+    },
+    {
+        mm: Nisan,
+        dd: 22,
+        desc: PESACH_VIII,
+        flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1,
+        emoji: emojiPesach,
+    },
     { mm: Iyyar, dd: 14, desc: PESACH_SHENI, flags: MINOR_HOLIDAY$2 },
     { mm: Iyyar, dd: 18, desc: LAG_BAOMER, flags: MINOR_HOLIDAY$2, emoji: '🔥' },
-    { mm: Sivan, dd: 5, desc: EREV_SHAVUOT,
-        flags: EREV$2 | LIGHT_CANDLES$1, emoji: '⛰️🌸' },
-    { mm: Sivan, dd: 6, desc: SHAVUOT,
-        flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1, emoji: '⛰️🌸' },
-    { mm: Sivan, dd: 6, desc: SHAVUOT_I,
-        flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2, emoji: '⛰️🌸' },
-    { mm: Sivan, dd: 7, desc: SHAVUOT_II,
-        flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1, emoji: '⛰️🌸' },
-    { mm: Av, dd: 15, desc: TU_BAV,
-        flags: MINOR_HOLIDAY$2, emoji: '❤️' },
-    { mm: Elul, dd: 1, desc: ROSH_HASHANA_LABEHEMOT,
-        flags: MINOR_HOLIDAY$2, emoji: '🐑' },
-    { mm: Elul, dd: 29, desc: EREV_ROSH_HASHANA,
-        flags: EREV$2 | LIGHT_CANDLES$1, emoji: '🍏🍯' },
+    {
+        mm: Sivan,
+        dd: 5,
+        desc: EREV_SHAVUOT,
+        flags: EREV$2 | LIGHT_CANDLES$1,
+        emoji: '⛰️🌸',
+    },
+    {
+        mm: Sivan,
+        dd: 6,
+        desc: SHAVUOT,
+        flags: IL_ONLY$2 | CHAG$1 | YOM_TOV_ENDS$1,
+        emoji: '⛰️🌸',
+    },
+    {
+        mm: Sivan,
+        dd: 6,
+        desc: SHAVUOT_I,
+        flags: CHUL_ONLY$1 | CHAG$1 | LIGHT_CANDLES_TZEIS$2,
+        emoji: '⛰️🌸',
+    },
+    {
+        mm: Sivan,
+        dd: 7,
+        desc: SHAVUOT_II,
+        flags: CHUL_ONLY$1 | CHAG$1 | YOM_TOV_ENDS$1,
+        emoji: '⛰️🌸',
+    },
+    { mm: Av, dd: 15, desc: TU_BAV, flags: MINOR_HOLIDAY$2, emoji: '❤️' },
+    {
+        mm: Elul,
+        dd: 1,
+        desc: ROSH_HASHANA_LABEHEMOT,
+        flags: MINOR_HOLIDAY$2,
+        emoji: '🐑',
+    },
+    {
+        mm: Elul,
+        dd: 29,
+        desc: EREV_ROSH_HASHANA,
+        flags: EREV$2 | LIGHT_CANDLES$1,
+        emoji: '🍏🍯',
+    },
 ];
 const staticModernHolidays = [
-    { firstYear: 5727, mm: Iyyar, dd: 28, desc: YOM_YERUSHALAYIM,
-        chul: true },
-    { firstYear: 5737, mm: Kislev, dd: 6, desc: BEN_GURION_DAY,
-        satPostponeToSun: true, friPostponeToSun: true },
+    { firstYear: 5727, mm: Iyyar, dd: 28, desc: YOM_YERUSHALAYIM, chul: true },
+    {
+        firstYear: 5737,
+        mm: Kislev,
+        dd: 6,
+        desc: BEN_GURION_DAY,
+        satPostponeToSun: true,
+        friPostponeToSun: true,
+    },
     { firstYear: 5750, mm: Shvat, dd: 30, desc: FAMILY_DAY },
-    { firstYear: 5758, mm: Cheshvan, dd: 12, desc: YITZHAK_RABIN_MEMORIAL_DAY,
-        friSatMovetoThu: true },
-    { firstYear: 5764, mm: Iyyar, dd: 10, desc: HERZL_DAY,
-        satPostponeToSun: true },
-    { firstYear: 5765, mm: Tamuz, dd: 29, desc: JABOTINSKY_DAY,
-        satPostponeToSun: true },
-    { firstYear: 5769, mm: Cheshvan, dd: 29, desc: SIGD,
-        chul: true, suppressEmoji: true },
-    { firstYear: 5777, mm: Nisan, dd: 10, desc: YOM_HAALIYAH,
-        chul: true },
+    {
+        firstYear: 5758,
+        mm: Cheshvan,
+        dd: 12,
+        desc: YITZHAK_RABIN_MEMORIAL_DAY,
+        friSatMovetoThu: true,
+    },
+    { firstYear: 5764, mm: Iyyar, dd: 10, desc: HERZL_DAY, satPostponeToSun: true },
+    {
+        firstYear: 5765,
+        mm: Tamuz,
+        dd: 29,
+        desc: JABOTINSKY_DAY,
+        satPostponeToSun: true,
+    },
+    {
+        firstYear: 5769,
+        mm: Cheshvan,
+        dd: 29,
+        desc: SIGD,
+        chul: true,
+        suppressEmoji: true,
+    },
+    { firstYear: 5777, mm: Nisan, dd: 10, desc: YOM_HAALIYAH, chul: true },
     { firstYear: 5777, mm: Cheshvan, dd: 7, desc: YOM_HAALIYAH_SCHOOL_OBSERVANCE },
     // https://www.gov.il/he/departments/policies/2012_des5234
-    { firstYear: 5773, mm: months.TEVET, dd: 21, desc: HEBREW_LANGUAGE_DAY,
-        friSatMovetoThu: true },
+    {
+        firstYear: 5773,
+        mm: months.TEVET,
+        dd: 21,
+        desc: HEBREW_LANGUAGE_DAY,
+        friSatMovetoThu: true,
+    },
 ];
 
 const minorHolidays = [
@@ -9829,9 +10115,9 @@ const minorHolidays = [
 ];
 /** Represents a built-in holiday like Pesach, Purim or Tu BiShvat */
 class HolidayEvent extends Event {
-    /** @return {string} */
     basename() {
-        return this.getDesc().replace(/ \d{4}$/, '')
+        return this.getDesc()
+            .replace(/ \d{4}$/, '')
             .replace(/ \(CH''M\)$/, '')
             .replace(/ \(observed\)$/, '')
             .replace(/ \(Hoshana Raba\)$/, '')
@@ -9840,23 +10126,21 @@ class HolidayEvent extends Event {
             .replace(/: 8th Day$/, '')
             .replace(/^Erev /, '');
     }
-    /** @return {string | undefined} */
     url() {
         const year = this.getDate().greg().getFullYear();
         if (year < 100) {
             return undefined;
         }
         const url = 'https://www.hebcal.com/holidays/' +
-            this.basename().toLowerCase().replace(/'/g, '').replace(/ /g, '-') + '-' +
+            this.basename().toLowerCase().replace(/'/g, '').replace(/ /g, '-') +
+            '-' +
             this.urlDateSuffix();
-        return (this.getFlags() & flags.IL_ONLY) ? url + '?i=on' : url;
+        return this.getFlags() & flags.IL_ONLY ? url + '?i=on' : url;
     }
-    /** @return {string} */
     urlDateSuffix() {
         const year = this.getDate().greg().getFullYear();
         return String(year);
     }
-    /** @return {string} */
     getEmoji() {
         if (this.emoji) {
             return this.emoji;
@@ -9868,7 +10152,6 @@ class HolidayEvent extends Event {
             return '✡️';
         }
     }
-    /** @return {string[]} */
     getCategories() {
         if (this.cholHaMoedDay) {
             return ['holiday', 'major', 'cholhamoed'];
@@ -9886,8 +10169,7 @@ class HolidayEvent extends Event {
     }
     /**
      * Returns (translated) description of this event
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         const str = super.render(locale);
@@ -9897,8 +10179,7 @@ class HolidayEvent extends Event {
      * Returns a brief (translated) description of this event.
      * For most events, this is the same as render(). For some events, it procudes
      * a shorter text (e.g. without a time or added description).
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     renderBrief(locale) {
         const str = super.renderBrief(locale);
@@ -9906,11 +10187,11 @@ class HolidayEvent extends Event {
     }
     /**
      * Makes a clone of this Event object
-     * @return {Event}
      */
     clone() {
         const ev = new HolidayEvent(this.date, this.desc, this.mask);
         for (const property in this) {
+            // eslint-disable-next-line no-prototype-builtins
             if (this.hasOwnProperty(property)) {
                 Object.defineProperty(ev, property, { value: this[property] });
             }
@@ -9923,7 +10204,6 @@ class HolidayEvent extends Event {
  * we subclass HolidayEvent to override the `url()` method.
  */
 class AsaraBTevetEvent extends HolidayEvent {
-    /** @return {string} */
     urlDateSuffix() {
         const isoDate = isoDateString(this.getDate().greg());
         return isoDate.replace(/-/g, '');
@@ -9933,9 +10213,9 @@ class AsaraBTevetEvent extends HolidayEvent {
 class RoshHashanaEvent extends HolidayEvent {
     /**
      * @private
-     * @param {HDate} date Hebrew date event occurs
-     * @param {number} hyear Hebrew year
-     * @param {number} mask optional holiday flags
+     * @param date Hebrew date event occurs
+     * @param hyear Hebrew year
+     * @param mask optional holiday flags
      */
     constructor(date, hyear, mask) {
         super(date, `Rosh Hashana ${hyear}`, mask);
@@ -9943,13 +10223,11 @@ class RoshHashanaEvent extends HolidayEvent {
     }
     /**
      * Returns (translated) description of this event
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         return Locale.gettext('Rosh Hashana', locale) + ' ' + this.hyear;
     }
-    /** @return {string} */
     getEmoji() {
         return '🍏🍯';
     }
@@ -9959,16 +10237,15 @@ const roshChodeshStr = 'Rosh Chodesh';
 class RoshChodeshEvent extends HolidayEvent {
     /**
      * Constructs Rosh Chodesh event
-     * @param {HDate} date Hebrew date event occurs
-     * @param {string} monthName Hebrew month name (not translated)
+     * @param date Hebrew date event occurs
+     * @param monthName Hebrew month name (not translated)
      */
     constructor(date, monthName) {
         super(date, `${roshChodeshStr} ${monthName}`, flags.ROSH_CHODESH);
     }
     /**
      * Returns (translated) description of this event
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         const monthName = this.getDesc().substring(roshChodeshStr.length + 1);
@@ -9976,11 +10253,9 @@ class RoshChodeshEvent extends HolidayEvent {
         const monthName1 = monthName0.replace(/'/g, '’');
         return Locale.gettext(roshChodeshStr, locale) + ' ' + monthName1;
     }
-    /** @return {string} */
     basename() {
         return this.getDesc();
     }
-    /** @return {string} */
     getEmoji() {
         return this.emoji || '🌒';
     }
@@ -9991,9 +10266,9 @@ const mevarchimChodeshStr = 'Shabbat Mevarchim Chodesh';
 class MevarchimChodeshEvent extends Event {
     /**
      * Constructs Mevarchim haChodesh event
-     * @param {HDate} date Hebrew date event occurs
-     * @param {string} monthName Hebrew month name (not translated)
-     * @param {string} [memo]
+     * @param date Hebrew date event occurs
+     * @param monthName Hebrew month name (not translated)
+     * @param [memo]
      */
     constructor(date, monthName, memo) {
         super(date, `${mevarchimChodeshStr} ${monthName}`, flags.SHABBAT_MEVARCHIM);
@@ -10004,19 +10279,17 @@ class MevarchimChodeshEvent extends Event {
         else {
             const hyear = date.getFullYear();
             const hmonth = date.getMonth();
-            const monNext = (hmonth == HDate.monthsInYear(hyear) ? months.NISAN : hmonth + 1);
+            const monNext = hmonth === HDate.monthsInYear(hyear) ? months.NISAN : hmonth + 1;
             const molad = new Molad(hyear, monNext);
             this.memo = molad.render('en', { hour12: false });
         }
     }
-    /** @return {string} */
     basename() {
         return this.getDesc();
     }
     /**
      * Returns (translated) description of this event
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         const monthName0 = Locale.gettext(this.monthName, locale);
@@ -10025,8 +10298,7 @@ class MevarchimChodeshEvent extends Event {
     }
     /**
      * Returns (translated) description of this event
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     renderBrief(locale) {
         const str = this.render(locale);
@@ -10045,8 +10317,6 @@ const cals = new Map();
 class DailyLearning {
     /**
      * Register a new learning calendar.
-     * @param {string} name
-     * @param {Function} calendar
      */
     static addCalendar(name, calendar) {
         if (typeof calendar !== 'function') {
@@ -10057,10 +10327,9 @@ class DailyLearning {
     /**
      * Returns an event from daily calendar for a given date. Returns `null` if there
      * is no learning from this calendar on this date.
-     * @param {string} name
-     * @param {HDate} hd
-     * @param {boolean} il
-     * @return {Event | null}
+     * @param name
+     * @param hd
+     * @param il
      */
     static lookup(name, hd, il) {
         const fn = cals.get(name);
@@ -10072,7 +10341,7 @@ class DailyLearning {
 }
 
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-const version = '5.4.7';
+const version = '5.4.9';
 
 /* eslint-disable max-len */
 /**
@@ -10099,11 +10368,15 @@ function makeCandleEvent(ev, hd, options, isFriday, isSaturday) {
         mask = flags.LIGHT_CANDLES_TZEIS;
     }
     // if offset is 0 or undefined, we'll use tzeit time
-    const offset = useHavdalahOffset ? options.havdalahMins : options.candleLightingMins;
+    const offset = useHavdalahOffset
+        ? options.havdalahMins
+        : options.candleLightingMins;
     const location = options.location;
     const useElevation = Boolean(options.useElevation);
     const zmanim = new Zmanim(location, hd, useElevation);
-    const time = offset ? zmanim.sunsetOffset(offset, true) : zmanim.tzeit(options.havdalahDeg);
+    const time = offset
+        ? zmanim.sunsetOffset(offset, true)
+        : zmanim.tzeit(options.havdalahDeg);
     if (isNaN(time.getTime())) {
         return undefined; // no sunset
     }
@@ -10132,13 +10405,13 @@ function makeFastStartEnd(ev, options) {
     const fastEndDeg = options.fastEndDeg;
     const useElevation = Boolean(options.useElevation);
     const zmanim = new Zmanim(location, dt, useElevation);
-    if (desc === 'Erev Tish\'a B\'Av') {
+    if (desc === "Erev Tish'a B'Av") {
         const sunset = zmanim.sunset();
         if (!isNaN(sunset.getTime())) {
             ev.startEvent = makeTimedEvent(ev, sunset, FAST_BEGINS, options);
         }
     }
-    else if (desc.startsWith('Tish\'a B\'Av')) {
+    else if (desc.startsWith("Tish'a B'Av")) {
         const tzeit = zmanim.tzeit(fastEndDeg);
         if (!isNaN(tzeit.getTime())) {
             ev.endEvent = makeTimedEvent(ev, tzeit, FAST_ENDS, options);
@@ -10149,7 +10422,8 @@ function makeFastStartEnd(ev, options) {
         if (!isNaN(dawn.getTime())) {
             ev.startEvent = makeTimedEvent(ev, dawn, FAST_BEGINS, options);
         }
-        if (dt.getDay() !== 5 && !(hd.getDate() === 14 && hd.getMonth() === months.NISAN)) {
+        if (dt.getDay() !== 5 &&
+            !(hd.getDate() === 14 && hd.getMonth() === months.NISAN)) {
             const tzeit = zmanim.tzeit(fastEndDeg);
             if (!isNaN(tzeit.getTime())) {
                 ev.endEvent = makeTimedEvent(ev, tzeit, FAST_ENDS, options);
@@ -10200,34 +10474,39 @@ const HALF = 1;
 const WHOLE = 2;
 /**
  * @private
- * @param {Event[]} events
- * @param {HDate} hdate
- * @return {number}
  */
 function hallel_(events, hdate) {
-    const whole = events.filter((ev) => {
+    const whole = events
+        .filter(ev => {
         const desc = ev.getDesc();
         const hd = ev.getDate();
         const month = hd.getMonth();
         const mday = hd.getDate();
-        return desc.startsWith('Chanukah') ||
+        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) => {
+            (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 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.getFlags() & flags.ROSH_CHODESH ||
+            (desc.startsWith('Pesach') &&
+                desc !== 'Pesach I' &&
+                desc !== 'Pesach II'));
+    })
+        .map(ev => {
         return ev.getDate().abs();
     });
     if (half.includes(abs)) {
@@ -10250,8 +10529,7 @@ const IYYAR = months.IYYAR;
  * on the following Monday.
  * http://www.ushmm.org/remembrance/dor/calendar/
  * @private
- * @param {number} year
- * @return {HDate|null}
+ * @param year
  */
 function dateYomHaShoah(year) {
     if (year < 5711) {
@@ -10269,8 +10547,7 @@ function dateYomHaShoah(year) {
 /**
  * Yom HaAtzma'ut only celebrated after 1948
  * @private
- * @param {number} year
- * @return {HDate|null}
+ * @param year
  */
 function dateYomHaZikaron(year) {
     if (year < 5708) {
@@ -10302,21 +10579,19 @@ const ykk = 'Yom Kippur Katan';
 class YomKippurKatanEvent extends HolidayEvent {
     /**
      * @private
-     * @param {HDate} date Hebrew date event occurs
-     * @param {string} nextMonthName name of the upcoming month
+     * @param date Hebrew date event occurs
+     * @param nextMonthName name of the upcoming month
      */
     constructor(date, nextMonthName) {
         super(date, `${ykk} ${nextMonthName}`, flags.MINOR_FAST | flags.YOM_KIPPUR_KATAN);
         this.nextMonthName = nextMonthName;
         this.memo = `Minor Day of Atonement on the day preceeding Rosh Chodesh ${nextMonthName}`;
     }
-    /** @return {string} */
     basename() {
         return this.getDesc();
     }
     /**
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     render(locale) {
         const monthName0 = Locale.gettext(this.nextMonthName, locale);
@@ -10324,13 +10599,11 @@ class YomKippurKatanEvent extends HolidayEvent {
         return Locale.gettext(ykk, locale) + ' ' + monthName;
     }
     /**
-     * @param {string} [locale] Optional locale name (defaults to active locale).
-     * @return {string}
+     * @param [locale] Optional locale name (defaults to active locale).
      */
     renderBrief(locale) {
         return Locale.gettext(ykk, locale);
     }
-    /** @return {string | undefined} */
     url() {
         return undefined;
     }
@@ -10383,8 +10656,16 @@ const emojiIsraelFlag = { emoji: '🇮🇱' };
 const chanukahEmoji = '🕎';
 const yearCache = new QuickLRU({ maxSize: 400 });
 const KEYCAP_DIGITS = [
-    '0️⃣', '1️⃣', '2️⃣', '3️⃣', '4️⃣',
-    '5️⃣', '6️⃣', '7️⃣', '8️⃣', '9️⃣',
+    '0️⃣',
+    '1️⃣',
+    '2️⃣',
+    '3️⃣',
+    '4️⃣',
+    '5️⃣',
+    '6️⃣',
+    '7️⃣',
+    '8️⃣',
+    '9️⃣',
 ];
 /**
  * Lower-level holidays interface, which returns a `Map` of `Event`s indexed by
@@ -10439,14 +10720,18 @@ function getHolidaysForYear_(year) {
     add(new HolidayEvent(new HDate(tzomGedaliahDay, TISHREI$2, 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));
-    const rchTevet = HDate.shortKislev(year) ?
-        new HDate(1, TEVET, year) : new HDate(30, KISLEV, year);
+    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));
     // yes, we know Kislev 30-32 are wrong
     // HDate() corrects the month automatically
     for (let candles = 2; candles <= 8; candles++) {
         const hd = new HDate(23 + candles, KISLEV, year);
-        add(new HolidayEvent(hd, `Chanukah: ${candles} Candles`, MINOR_HOLIDAY$1 | CHANUKAH_CANDLES$1, { chanukahDay: candles - 1, emoji: chanukahEmoji + KEYCAP_DIGITS[candles] }));
+        add(new HolidayEvent(hd, `Chanukah: ${candles} Candles`, MINOR_HOLIDAY$1 | CHANUKAH_CANDLES$1, {
+            chanukahDay: candles - 1,
+            emoji: chanukahEmoji + KEYCAP_DIGITS[candles],
+        }));
     }
     add(new HolidayEvent(new HDate(32, KISLEV, year), holidayDesc.CHANUKAH_8TH_DAY, MINOR_HOLIDAY$1, { chanukahDay: 8, emoji: chanukahEmoji }));
     add(new AsaraBTevetEvent(new HDate(10, TEVET, year), holidayDesc.ASARA_BTEVET, MINOR_FAST$1));
@@ -10455,9 +10740,9 @@ function getHolidaysForYear_(year) {
     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(
     // if the fast falls on Shabbat, move to Thursday
-    pesach.prev().getDay() === SAT$1 ?
-        pesach.onOrBefore(THU) :
-        new HDate(14, NISAN$1, year), holidayDesc.TAANIT_BECHOROT, MINOR_FAST$1));
+    pesach.prev().getDay() === SAT$1
+        ? 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$2, 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));
@@ -10487,7 +10772,7 @@ function getHolidaysForYear_(year) {
             else if (h.satPostponeToSun && dow === SAT$1) {
                 hd = hd.next();
             }
-            const mask = h.chul ? MODERN_HOLIDAY$1 : (MODERN_HOLIDAY$1 | IL_ONLY$1);
+            const mask = h.chul ? MODERN_HOLIDAY$1 : MODERN_HOLIDAY$1 | IL_ONLY$1;
             const ev = new HolidayEvent(hd, h.desc, mask);
             if (!h.suppressEmoji) {
                 ev.emoji = '🇮🇱';
@@ -10515,9 +10800,9 @@ function getHolidaysForYear_(year) {
     const monthsInYear = HDate.monthsInYear(year);
     for (let month = 1; month <= monthsInYear; month++) {
         const monthName = HDate.getMonthName(month, year);
-        if ((month === NISAN$1 ?
-            HDate.daysInMonth(HDate.monthsInYear(year - 1), year - 1) :
-            HDate.daysInMonth(month - 1, year)) === 30) {
+        if ((month === NISAN$1
+            ? HDate.daysInMonth(HDate.monthsInYear(year - 1), year - 1)
+            : HDate.daysInMonth(month - 1, year)) === 30) {
             add(new RoshChodeshEvent(new HDate(1, month, year), monthName));
             add(new RoshChodeshEvent(new HDate(30, month - 1, year), monthName));
         }
@@ -10532,7 +10817,9 @@ function getHolidaysForYear_(year) {
         // Yom Kippur Katan is not observed on the day before Rosh Hashanah.
         // Not observed prior to Rosh Chodesh Cheshvan because Yom Kippur has just passed.
         // Not observed before Rosh Chodesh Tevet, because that day is Hanukkah.
-        if (nextMonth === TISHREI$2 || nextMonth === months.CHESHVAN || nextMonth === TEVET) {
+        if (nextMonth === TISHREI$2 ||
+            nextMonth === months.CHESHVAN ||
+            nextMonth === TEVET) {
             continue;
         }
         let ykk = new HDate(29, month, year);
@@ -10621,7 +10908,7 @@ function tachanun0(hdate, il, checkNext) {
         ret.mincha = tmp.shacharit;
     }
     else {
-        ret.mincha = (dow !== 5);
+        ret.mincha = dow !== 5;
     }
     if (ret.allCongs && !ret.mincha && !ret.shacharit) {
         return NONE;
@@ -10643,37 +10930,31 @@ function tachanunYear(year, il) {
         new HDate(2, months.TISHREI, year), // Rosh Hashana II
     ].concat(
     // Rosh Chodesh - 1st of every month. Also includes RH day 1 (1 Tishrei)
-    range(1, monthsInYear)
-        .map((month) => new HDate(1, month, year)), 
+    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)), 
+        .filter(month => HDate.daysInMonth(month, year) === 30)
+        .map(month => new HDate(30, month, year)), 
     // 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
+    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
+    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)), 
+    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
+    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) : []);
+    shushPurim, leap ? new HDate(14, months.ADAR_I, year) : [] // Purim Katan
+    );
     const some = [
         new HDate(14, months.IYYAR, year), // Pesach Sheini
     ].concat(
     // Until 14 Sivan
-    range(1, 13)
-        .map((mday) => new HDate(mday, months.SIVAN, year)), 
+    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)), 
+    range(20, 31).map(mday => new HDate(mday, months.TISHREI, year)), 
     // Yom HaAtzma'ut, which changes based on day of week
     year >= 5708 ? dateYomHaZikaron(year).next() : [], 
     // Yom Yerushalayim
@@ -10684,9 +10965,9 @@ function tachanunYear(year, il) {
         new HDate(14, months.IYYAR, year), // Pesach Sheini
     ];
     return {
-        none: none.map((hd) => hd.abs()).sort((a, b) => a - b),
-        some: some.map((hd) => hd.abs()).sort((a, b) => a - b),
-        yesPrev: yesPrev.map((hd) => hd.abs()).sort((a, b) => a - b),
+        none: none.map(hd => hd.abs()).sort((a, b) => a - b),
+        some: some.map(hd => hd.abs()).sort((a, b) => a - b),
+        yesPrev: yesPrev.map(hd => hd.abs()).sort((a, b) => a - b),
     };
 }
 
@@ -10696,10 +10977,10 @@ const TISHREI$1 = months.TISHREI;
  * @private
  */
 function getAbs(d) {
-    if (typeof d == 'number')
+    if (typeof d === 'number')
         return d;
-    if (greg.isDate(d))
-        return greg.greg2abs(d);
+    if (isDate(d))
+        return greg2abs(d);
     if (HDate.isHDate(d))
         return d.abs();
     throw new TypeError(`Invalid date type: ${d}`);
@@ -10708,8 +10989,9 @@ function getYear(options) {
     if (typeof options.year !== 'undefined') {
         return Number(options.year);
     }
-    return options.isHebrewYear ? new HDate().getFullYear() :
-        new Date().getFullYear();
+    return options.isHebrewYear
+        ? new HDate().getFullYear()
+        : new Date().getFullYear();
 }
 /**
  * Parse options object to determine start & end days
@@ -10756,10 +11038,10 @@ function startEndGregorian(theMonth, theYear, numYears) {
     if (theYear < 100) {
         startGreg.setFullYear(theYear);
     }
-    const startAbs = greg.greg2abs(startGreg);
+    const startAbs = greg2abs(startGreg);
     let endAbs;
     if (theMonth) {
-        endAbs = startAbs + greg.daysInMonth(theMonth, theYear) - 1;
+        endAbs = startAbs + daysInGregMonth(theMonth, theYear) - 1;
     }
     else {
         const endYear = theYear + numYears;
@@ -10767,16 +11049,16 @@ function startEndGregorian(theMonth, theYear, numYears) {
         if (endYear < 100) {
             endGreg.setFullYear(endYear);
         }
-        endAbs = greg.greg2abs(endGreg) - 1;
+        endAbs = greg2abs(endGreg) - 1;
     }
     return [startAbs, endAbs];
 }
 function startEndHebrew(theMonth, theYear, numYears) {
     const startDate = new HDate(1, theMonth || TISHREI$1, theYear);
     let startAbs = startDate.abs();
-    const endAbs = theMonth ?
-        startAbs + startDate.daysInMonth() :
-        new HDate(1, TISHREI$1, theYear + numYears).abs() - 1;
+    const endAbs = theMonth
+        ? startAbs + startDate.daysInMonth()
+        : new HDate(1, TISHREI$1, theYear + numYears).abs() - 1;
     // for full Hebrew year, start on Erev Rosh Hashana which
     // is technically in the previous Hebrew year
     // (but conveniently lets us get candle-lighting time for Erev)
@@ -10874,19 +11156,20 @@ const RECOGNIZED_OPTIONS = {
  */
 function warnUnrecognizedOptions(options) {
     for (const k of Object.keys(options)) {
-        if (typeof RECOGNIZED_OPTIONS[k] === 'undefined' && !unrecognizedAlreadyWarned.has(k)) {
+        if (typeof RECOGNIZED_OPTIONS[k] === 'undefined' &&
+            !unrecognizedAlreadyWarned.has(k)) {
             console.warn(`Ignoring unrecognized HebrewCalendar option: ${k}`);
             unrecognizedAlreadyWarned.add(k);
         }
     }
 }
 const israelCityOffset = {
-    'Jerusalem': 40,
-    'Haifa': 30,
-    'Zikhron Ya\'aqov': 30,
-    'Zikhron Ya\'akov': 30,
+    Jerusalem: 40,
+    Haifa: 30,
+    "Zikhron Ya'aqov": 30,
+    "Zikhron Ya'akov": 30,
     'Zikhron Yaakov': 30,
-    'Zichron Ya\'akov': 30,
+    "Zichron Ya'akov": 30,
     'Zichron Yaakov': 30,
 };
 const geoIdCandleOffset = {
@@ -10916,7 +11199,6 @@ const TZEIT_3MEDIUM_STARS = 7.0833333;
 /**
  * Modifies options in-place
  * @private
- * @param {CalOptions} options
  */
 function checkCandleOptions(options) {
     if (!options.candlelighting) {
@@ -10926,7 +11208,8 @@ function checkCandleOptions(options) {
     if (typeof location === 'undefined' || !(location instanceof Location)) {
         throw new TypeError('options.candlelighting requires valid options.location');
     }
-    if (typeof options.havdalahMins === 'number' && typeof options.havdalahDeg === 'number') {
+    if (typeof options.havdalahMins === 'number' &&
+        typeof options.havdalahDeg === 'number') {
         throw new TypeError('options.havdalahMins and options.havdalahDeg are mutually exclusive');
     }
     let min = Number(options.candleLightingMins) || 18;
@@ -10967,8 +11250,6 @@ function overrideIsraelCandleMins(location, min) {
 /**
  * Mask to filter Holiday array
  * @private
- * @param {CalOptions} options
- * @return {number}
  */
 function getMaskFromOptions(options) {
     var _a;
@@ -10979,9 +11260,19 @@ function getMaskFromOptions(options) {
     let mask = 0;
     // default options
     if (!options.noHolidays) {
-        mask |= ROSH_CHODESH | YOM_TOV_ENDS | MINOR_FAST | SPECIAL_SHABBAT | MODERN_HOLIDAY | MAJOR_FAST |
-            MINOR_HOLIDAY | EREV | CHOL_HAMOED |
-            LIGHT_CANDLES | LIGHT_CANDLES_TZEIS | CHANUKAH_CANDLES;
+        mask |=
+            ROSH_CHODESH |
+                YOM_TOV_ENDS |
+                MINOR_FAST |
+                SPECIAL_SHABBAT |
+                MODERN_HOLIDAY |
+                MAJOR_FAST |
+                MINOR_HOLIDAY |
+                EREV |
+                CHOL_HAMOED |
+                LIGHT_CANDLES |
+                LIGHT_CANDLES_TZEIS |
+                CHANUKAH_CANDLES;
     }
     if (options.candlelighting) {
         mask |= LIGHT_CANDLES | LIGHT_CANDLES_TZEIS | YOM_TOV_ENDS;
@@ -11036,15 +11327,10 @@ function getMaskFromOptions(options) {
     }
     return mask;
 }
-const MASK_LIGHT_CANDLES = LIGHT_CANDLES |
-    LIGHT_CANDLES_TZEIS |
-    CHANUKAH_CANDLES |
-    YOM_TOV_ENDS;
+const MASK_LIGHT_CANDLES = LIGHT_CANDLES | LIGHT_CANDLES_TZEIS | CHANUKAH_CANDLES | YOM_TOV_ENDS;
 const defaultLocation = new Location(0, 0, false, 'UTC');
 /**
  * @private
- * @param {CalOptions} options
- * @return {number}
  */
 function setOptionsFromMask(options) {
     const m = options.mask || 0;
@@ -11083,16 +11369,12 @@ function setOptionsFromMask(options) {
 }
 /**
  * @private
- * @param {Event} ev
- * @return {boolean}
  */
 function observedInIsrael(ev) {
     return ev.observedInIsrael();
 }
 /**
  * @private
- * @param {Event} ev
- * @return {boolean}
  */
 function observedInDiaspora(ev) {
     return ev.observedInDiaspora();
@@ -11210,21 +11492,21 @@ class HebrewCalendar {
      *   const date = hd.greg();
      *   console.log(date.toLocaleDateString(), ev.render('en'), hd.toString());
      * }
-     * @param {CalOptions} [options={}]
-     * @return {Event[]}
      */
     static calendar(options = {}) {
         options = Object.assign({}, options); // so we can modify freely
         checkCandleOptions(options);
-        const location = options.location = options.location || defaultLocation;
-        const il = options.il = options.il || location.getIsrael() || false;
+        const location = (options.location = options.location || defaultLocation);
+        const il = (options.il = options.il || location.getIsrael() || false);
         const hasUserMask = typeof options.mask === 'number';
         options.mask = getMaskFromOptions(options);
         if (options.ashkenazi || options.locale) {
             if (options.locale && typeof options.locale !== 'string') {
                 throw new TypeError(`Invalid options.locale: ${options.locale}`);
             }
-            const locale = options.ashkenazi ? 'ashkenazi' : options.locale;
+            const locale = options.ashkenazi
+                ? 'ashkenazi'
+                : options.locale;
             const translationObj = Locale.useLocale(locale);
             if (!translationObj) {
                 throw new TypeError(`Locale '${locale}' not found; did you forget to import @hebcal/locales?`);
@@ -11243,14 +11525,14 @@ class HebrewCalendar {
         warnUnrecognizedOptions(options);
         const startAbs = startAndEnd[0];
         const endAbs = startAndEnd[1];
-        const startGreg = greg.abs2greg(startAbs);
+        const startGreg = abs2greg(startAbs);
         if (startGreg.getFullYear() < 100) {
             options.candlelighting = false;
         }
         for (let abs = startAbs; abs <= endAbs; abs++) {
             const hd = new HDate(abs);
             const hyear = hd.getFullYear();
-            if (hyear != currentYear) {
+            if (hyear !== currentYear) {
                 currentYear = hyear;
                 holidaysYear = getHolidaysForYear_(currentYear);
                 if (options.sedrot) {
@@ -11297,16 +11579,17 @@ class HebrewCalendar {
                 }
             }
             // suppress Havdalah when options.havdalahMins=0 or options.havdalahDeg=0
-            if (candlesEv instanceof HavdalahEvent && (options.havdalahMins === 0 || options.havdalahDeg === 0)) {
+            if (candlesEv instanceof HavdalahEvent &&
+                (options.havdalahMins === 0 || options.havdalahDeg === 0)) {
                 candlesEv = undefined;
             }
             if (candlesEv) {
                 evts.push(candlesEv);
             }
             if (options.addHebrewDates ||
-                (options.addHebrewDatesForEvents && prevEventsLength != evts.length)) {
+                (options.addHebrewDatesForEvents && prevEventsLength !== evts.length)) {
                 const e2 = new HebrewDateEvent(hd);
-                if (prevEventsLength == evts.length) {
+                if (prevEventsLength === evts.length) {
                     evts.push(e2);
                 }
                 else {
@@ -11338,9 +11621,9 @@ class HebrewCalendar {
      * const dt = new Date(2014, 2, 2); // '2014-03-02' == '30 Adar I 5774'
      * const hd = HebrewCalendar.getBirthdayOrAnniversary(5780, dt); // '1 Nisan 5780'
      * console.log(hd.greg().toLocaleDateString('en-US')); // '3/26/2020'
-     * @param {number} hyear Hebrew year
-     * @param {Date|HDate} gdate Gregorian or Hebrew date of event
-     * @return {HDate | undefined} anniversary occurring in `hyear`
+     * @param hyear Hebrew year
+     * @param gdate Gregorian or Hebrew date of event
+     * @returns anniversary occurring in `hyear`
      */
     static getBirthdayOrAnniversary(hyear, gdate) {
         const dt = getBirthdayHD(hyear, gdate);
@@ -11379,9 +11662,9 @@ class HebrewCalendar {
      * const dt = new Date(2014, 2, 2); // '2014-03-02' == '30 Adar I 5774'
      * const hd = HebrewCalendar.getYahrzeit(5780, dt); // '30 Sh\'vat 5780'
      * console.log(hd.greg().toLocaleDateString('en-US')); // '2/25/2020'
-     * @param {number} hyear Hebrew year
-     * @param {Date|HDate} gdate Gregorian or Hebrew date of death
-     * @return {HDate | undefined} anniversary occurring in hyear
+     * @param hyear Hebrew year
+     * @param gdate Gregorian or Hebrew date of death
+     * @returns anniversary occurring in hyear
      */
     static getYahrzeit(hyear, gdate) {
         const dt = getYahrzeitHD(hyear, gdate);
@@ -11394,18 +11677,15 @@ class HebrewCalendar {
      * Lower-level holidays interface, which returns a `Map` of `Event`s indexed by
      * `HDate.toString()`. These events must filtered especially for `flags.IL_ONLY`
      * or `flags.CHUL_ONLY` depending on Israel vs. Diaspora holiday scheme.
-     * @function
-     * @param {number} year Hebrew year
-     * @return {HolidayYearMap}
+     * @param year Hebrew year
      */
     static getHolidaysForYear(year) {
         return getHolidaysForYear_(year);
     }
     /**
      * Returns an array of holidays for the year
-     * @param {number} year Hebrew year
-     * @param {boolean} il use the Israeli schedule for holidays
-     * @return {HolidayEvent[]}
+     * @param year Hebrew year
+     * @param il use the Israeli schedule for holidays
      */
     static getHolidaysForYearArray(year, il) {
         const yearMap = getHolidaysForYear_(year);
@@ -11425,9 +11705,8 @@ class HebrewCalendar {
     }
     /**
      * Returns an array of Events on this date (or `undefined` if no events)
-     * @param {HDate|Date|number} date Hebrew Date, Gregorian date, or absolute R.D. day number
-     * @param {boolean} [il] use the Israeli schedule for holidays
-     * @return {HolidayEvent[] | undefined}
+     * @param date Hebrew Date, Gregorian date, or absolute R.D. day number
+     * @param [il] use the Israeli schedule for holidays
      */
     static getHolidaysOnDate(date, il) {
         const hd = HDate.isHDate(date) ? date : new HDate(date);
@@ -11444,9 +11723,6 @@ class HebrewCalendar {
     }
     /**
      * Eruv Tavshilin
-     * @param {Date | HDate} date
-     * @param {boolean} il
-     * @return {boolean}
      */
     static eruvTavshilin(date, il) {
         if (date.getDay() < 3 || date.getDay() > 4) {
@@ -11466,25 +11742,19 @@ class HebrewCalendar {
      * locale.
      * If `options.hour12` is `false`, locale is ignored and always returns 24-hour time.
      * If `options.hour12` is `true`, locale is ignored and always returns 12-hour time.
-     * @param {string} timeStr - original time like "20:30"
-     * @param {string} suffix - "p" or "pm" or " P.M.". Add leading space if you want it
-     * @param {CalOptions} options
-     * @return {string}
+     * @param timeStr - original time like "20:30"
+     * @param suffix - "p" or "pm" or " P.M.". Add leading space if you want it
+     * @param options
      */
     static reformatTimeStr(timeStr, suffix, options) {
         return reformatTimeStr(timeStr, suffix, options);
     }
-    /** @return {string} */
     static version() {
         return version;
     }
     /**
      * Convenience function to create an instance of `Sedra` or reuse a previously
      * created and cached instance.
-     * @function
-     * @param {number} hyear
-     * @param {boolean} il
-     * @return {Sedra}
      */
     static getSedra(hyear, il) {
         return getSedra_(hyear, il);
@@ -11502,10 +11772,6 @@ class HebrewCalendar {
      * 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);
@@ -11526,9 +11792,6 @@ class HebrewCalendar {
      * 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);
@@ -11536,13 +11799,10 @@ class HebrewCalendar {
 }
 /**
  * @private
- * @param {HDate} date
- * @param {boolean} il
- * @return {boolean}
  */
 function isChag(date, il) {
     const events = HebrewCalendar.getHolidaysOnDate(date, il) || [];
-    const chag = events.filter((ev) => ev.getFlags() & flags.CHAG);
+    const chag = events.filter(ev => ev.getFlags() & flags.CHAG);
     return chag.length !== 0;
 }
 /**
@@ -11556,19 +11816,20 @@ function appendHolidayAndRelated(candlesEv, events, ev, options, isFriday, isSat
         return candlesEv; // holiday isn't observed here; bail out early
     }
     const eFlags = ev.getFlags();
-    if ((!options.yomKippurKatan && (eFlags & YOM_KIPPUR_KATAN)) ||
-        (options.noModern && (eFlags & MODERN_HOLIDAY))) {
+    if ((!options.yomKippurKatan && eFlags & YOM_KIPPUR_KATAN) ||
+        (options.noModern && eFlags & MODERN_HOLIDAY)) {
         return candlesEv; // bail out early
     }
     const isMajorFast = Boolean(eFlags & MAJOR_FAST);
     const isMinorFast = Boolean(eFlags & MINOR_FAST);
     if (options.candlelighting && (isMajorFast || isMinorFast)) {
         ev = makeFastStartEnd(ev, options);
-        if (ev.startEvent && (isMajorFast || (isMinorFast && !options.noMinorFast))) {
+        if (ev.startEvent &&
+            (isMajorFast || (isMinorFast && !options.noMinorFast))) {
             events.push(ev.startEvent);
         }
     }
-    if ((eFlags & Number(options.mask)) || (!eFlags && !hasUserMask)) {
+    if (eFlags & Number(options.mask) || (!eFlags && !hasUserMask)) {
         if (options.candlelighting && eFlags & MASK_LIGHT_CANDLES) {
             const hd = ev.getDate();
             candlesEv = makeCandleEvent(ev, hd, options, isFriday, isSaturday);
@@ -11586,7 +11847,8 @@ function appendHolidayAndRelated(candlesEv, events, ev, options, isFriday, isSat
                 candlesEv = undefined;
             }
         }
-        if (!options.noHolidays || (options.yomKippurKatan && (eFlags & YOM_KIPPUR_KATAN))) {
+        if (!options.noHolidays ||
+            (options.yomKippurKatan && eFlags & YOM_KIPPUR_KATAN)) {
             events.push(ev); // the original event itself
         }
     }
@@ -11599,9 +11861,9 @@ function makeMoladAndMevarchimChodesh(hd, options) {
     const evts = [];
     const hmonth = hd.getMonth();
     const hdate = hd.getDate();
-    if (hmonth != ELUL && hdate >= 23 && hdate <= 29) {
+    if (hmonth !== ELUL && hdate >= 23 && hdate <= 29) {
         const hyear = hd.getFullYear();
-        const monNext = (hmonth == HDate.monthsInYear(hyear) ? NISAN : hmonth + 1);
+        const monNext = hmonth === HDate.monthsInYear(hyear) ? NISAN : hmonth + 1;
         if (options.molad) {
             evts.push(new MoladEvent(hd, hyear, monNext, options));
         }
@@ -11647,3 +11909,4 @@ function makeOmerEvent(hd, omerDay, options) {
 }
 
 export { AsaraBTevetEvent, CandleLightingEvent, DailyLearning, Event, GeoLocation, HDate, HavdalahEvent, HebrewCalendar, HebrewDateEvent, HolidayEvent, Locale, Location, MevarchimChodeshEvent, Molad, MoladEvent, NOAACalculator, OmerEvent, ParshaEvent, RoshChodeshEvent, RoshHashanaEvent, Sedra, TimedEvent, Zmanim, flags, gematriya, gematriyaStrToNum, greg, holidayDesc, months, parshiot, version };
+//# sourceMappingURL=index.mjs.map