@hebcal/core 5.0.1 → 5.0.2

package/dist/bundle.js

@@ -1,349 +1,7 @@
-/*! @hebcal/core v5.0.1 */
+/*! @hebcal/core v5.0.2 */
 var hebcal = (function (exports) {
 'use strict';
 
-const GERESH = '׳';
-const GERSHAYIM = '״';
-const heb2num = {
-  'א': 1,
-  'ב': 2,
-  'ג': 3,
-  'ד': 4,
-  'ה': 5,
-  'ו': 6,
-  'ז': 7,
-  'ח': 8,
-  'ט': 9,
-  'י': 10,
-  'כ': 20,
-  'ל': 30,
-  'מ': 40,
-  'נ': 50,
-  'ס': 60,
-  'ע': 70,
-  'פ': 80,
-  'צ': 90,
-  'ק': 100,
-  'ר': 200,
-  'ש': 300,
-  'ת': 400
-};
-const num2heb = new Map();
-for (const [key, val] of Object.entries(heb2num)) {
-  num2heb.set(val, key);
-}
-
-/**
- * @private
- * @param {number} num
- * @return {number[]}
- */
-function num2digits(num) {
-  const digits = [];
-  while (num > 0) {
-    if (num === 15 || num === 16) {
-      digits.push(9);
-      digits.push(num - 9);
-      break;
-    }
-    let incr = 100;
-    let i;
-    for (i = 400; i > num; i -= incr) {
-      if (i === incr) {
-        incr = incr / 10;
-      }
-    }
-    digits.push(i);
-    num -= i;
-  }
-  return digits;
-}
-
-/**
- * Converts a numerical value to a string of Hebrew letters.
- *
- * When specifying years of the Hebrew calendar in the present millennium,
- * we omit the thousands (which is presently 5 [ה]).
- * @example
- * gematriya(5774) // 'תשע״ד' - cropped to 774
- * gematriya(25) // 'כ״ה'
- * gematriya(60) // 'ס׳'
- * gematriya(3761) // 'ג׳תשס״א'
- * gematriya(1123) // 'א׳קכ״ג'
- * @param {number} number
- * @return {string}
- */
-function gematriya(number) {
-  const num = parseInt(number, 10);
-  if (!num) {
-    throw new TypeError(`invalid parameter to gematriya ${number}`);
-  }
-  let str = '';
-  const thousands = Math.floor(num / 1000);
-  if (thousands > 0 && thousands !== 5) {
-    const tdigits = num2digits(thousands);
-    for (const tdig of tdigits) {
-      str += num2heb.get(tdig);
-    }
-    str += GERESH;
-  }
-  const digits = num2digits(num % 1000);
-  if (digits.length == 1) {
-    return str + num2heb.get(digits[0]) + GERESH;
-  }
-  for (let i = 0; i < digits.length; i++) {
-    if (i + 1 === digits.length) {
-      str += GERSHAYIM;
-    }
-    str += num2heb.get(digits[i]);
-  }
-  return str;
-}
-
-/**
- * Converts a string of Hebrew letters to a numerical value.
- *
- * 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;
-  const gereshIdx = str.indexOf(GERESH);
-  if (gereshIdx !== -1 && gereshIdx !== str.length - 1) {
-    const thousands = str.substring(0, gereshIdx);
-    num += gematriyaStrToNum(thousands) * 1000;
-    str = str.substring(gereshIdx);
-  }
-  for (const ch of str) {
-    const n = heb2num[ch];
-    if (typeof n === 'number') {
-      num += n;
-    }
-  }
-  return num;
-}
-
-const noopLocale = {
-  headers: {
-    'plural-forms': 'nplurals=2; plural=(n!=1);'
-  },
-  contexts: {
-    '': {}
-  }
-};
-const alias = {
-  'h': 'he',
-  'a': 'ashkenazi',
-  's': 'en',
-  '': 'en'
-};
-
-/** @private */
-const locales = new Map();
-/** @private */
-let activeLocale = null;
-/** @private */
-let activeName = null;
-
-/**
- * A locale in Hebcal is used for translations/transliterations of
- * holidays. `@hebcal/core` supports four locales by default
- * * `en` - default, Sephardic transliterations (e.g. "Shabbat")
- * * `ashkenazi` - Ashkenazi transliterations (e.g. "Shabbos")
- * * `he` - Hebrew (e.g. "שַׁבָּת")
- * * `he-x-NoNikud` - Hebrew without nikud (e.g. "שבת")
- */
-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}
-   */
-  static lookupTranslation(id, locale) {
-    const locale0 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
-    const loc = typeof locale == 'string' && locales.get(locale0) || activeLocale;
-    const array = loc[id];
-    if (array && array.length && array[0].length) {
-      return array[0];
-    }
-    return undefined;
-  }
-
-  /**
-   * 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}
-   */
-  static gettext(id, locale) {
-    const text = this.lookupTranslation(id, locale);
-    if (typeof text == 'undefined') {
-      return id;
-    }
-    return text;
-  }
-
-  /**
-   * Register locale translations.
-   * @param {string} locale Locale name (i.e.: `'he'`, `'fr'`)
-   * @param {LocaleData} 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') {
-      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} translation Translation text
-   */
-  static addTranslation(locale, id, translation) {
-    if (typeof locale !== 'string') {
-      throw new TypeError(`Invalid locale name: ${locale}`);
-    }
-    const locale0 = locale.toLowerCase();
-    const loc = locales.get(locale0);
-    if (!loc) {
-      throw new TypeError(`Unknown locale: ${locale}`);
-    }
-    if (typeof id !== 'string' || id.length === 0) {
-      throw new TypeError(`Invalid id: ${id}`);
-    }
-    const isArray = Array.isArray(translation);
-    if (isArray) {
-      const t0 = translation[0];
-      if (typeof t0 !== 'string' || t0.length === 0) {
-        throw new TypeError(`Invalid translation array: ${translation}`);
-      }
-    } else if (typeof translation !== 'string') {
-      throw new TypeError(`Invalid translation: ${translation}`);
-    }
-    loc[id] = isArray ? translation : [translation];
-  }
-  /**
-   * 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.
-   */
-  static addTranslations(locale, data) {
-    if (typeof locale !== 'string') {
-      throw new TypeError(`Invalid locale name: ${locale}`);
-    }
-    const locale0 = locale.toLowerCase();
-    const loc = locales.get(locale0);
-    if (!loc) {
-      throw new TypeError(`Unknown locale: ${locale}`);
-    }
-    if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
-      throw new TypeError(`Locale '${locale}' invalid compact format`);
-    }
-    const ctx = data.contexts[''];
-    Object.assign(loc, ctx);
-  }
-  /**
-   * 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'`)
-   * @return {LocaleData}
-   */
-  static useLocale(locale) {
-    const locale0 = locale.toLowerCase();
-    const obj = locales.get(locale0);
-    if (!obj) {
-      throw new RangeError(`Locale '${locale}' not found`);
-    }
-    activeName = alias[locale0] || locale0;
-    activeLocale = obj;
-    return activeLocale;
-  }
-
-  /**
-   * 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}
-   */
-  static ordinal(n, locale) {
-    const locale1 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
-    const locale0 = locale1 || activeName;
-    if (!locale0) {
-      return this.getEnOrdinal(n);
-    }
-    switch (locale0) {
-      case 'en':
-      case 's':
-      case 'a':
-      case 'ashkenazi':
-      case 'ashkenazi_litvish':
-      case 'ashkenazi_poylish':
-      case 'ashkenazi_standard':
-        return this.getEnOrdinal(n);
-      case 'es':
-        return n + 'º';
-      case 'h':
-      case 'he':
-      case 'he-x-nonikud':
-        return String(n);
-      default:
-        return n + '.';
-    }
-  }
-
-  /**
-   * @private
-   * @param {number} n
-   * @return {string}
-   */
-  static getEnOrdinal(n) {
-    const s = ['th', 'st', 'nd', 'rd'];
-    const v = n % 100;
-    return n + (s[(v - 20) % 10] || s[v] || s[0]);
-  }
-
-  /**
-   * Removes nekudot from Hebrew string
-   * @param {string} str
-   * @return {string}
-   */
-  static hebrewStripNikkud(str) {
-    return str.replace(/[\u0590-\u05bd]/g, '').replace(/[\u05bf-\u05c7]/g, '');
-  }
-}
-Locale.addLocale('en', noopLocale);
-Locale.addLocale('s', noopLocale);
-Locale.addLocale('', noopLocale);
-Locale.useLocale('en');
-
 /** @private */
 const lengths = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
 /** @private */
@@ -849,104 +507,441 @@ function monthFromName(monthName) {
       }
       break;
   }
-  throw new RangeError(`Unable to parse month name: ${monthName}`);
-}
+  throw new RangeError(`Unable to parse month name: ${monthName}`);
+}
+
+const NISAN$3 = months.NISAN;
+const CHESHVAN = months.CHESHVAN;
+const KISLEV$1 = months.KISLEV;
+const TEVET$1 = months.TEVET;
+const SHVAT = months.SHVAT;
+const ADAR_I$1 = months.ADAR_I;
+const ADAR_II = months.ADAR_II;
+/**
+ * Returns true if the object is a Javascript Date
+ * @private
+ * @param {Object} obj
+ */
+function isSimpleHebrewDate(obj) {
+  return typeof obj === 'object' && obj !== null && typeof obj.yy === 'number' && typeof obj.mm === 'number' && typeof obj.dd === 'number';
+}
+/**
+ * @private
+ */
+function toSimpleHebrewDate(obj) {
+  if (isSimpleHebrewDate(obj)) {
+    return obj;
+  } else if (typeof obj === 'number') {
+    return abs2hebrew(obj);
+  } else if (exports.greg.isDate(obj)) {
+    const abs = exports.greg.greg2abs(obj);
+    return abs2hebrew(abs);
+  } else {
+    throw new TypeError(`Argument not a Date: ${obj}`);
+  }
+}
+function getYahrzeitHD(hyear, date) {
+  let hDeath = toSimpleHebrewDate(date);
+  if (hyear <= hDeath.yy) {
+    // Hebrew year ${hyear} occurs on or before original date in ${hDeath.yy}
+    return undefined;
+  }
+  if (hDeath.mm == CHESHVAN && hDeath.dd == 30 && !longCheshvan(hDeath.yy + 1)) {
+    // If it's Heshvan 30 it depends on the first anniversary;
+    // if that was not Heshvan 30, use the day before Kislev 1.
+    hDeath = abs2hebrew(hebrew2abs(hyear, KISLEV$1, 1) - 1);
+  } else if (hDeath.mm == KISLEV$1 && hDeath.dd == 30 && shortKislev(hDeath.yy + 1)) {
+    // If it's Kislev 30 it depends on the first anniversary;
+    // if that was not Kislev 30, use the day before Teveth 1.
+    hDeath = abs2hebrew(hebrew2abs(hyear, TEVET$1, 1) - 1);
+  } else if (hDeath.mm == ADAR_II) {
+    // If it's Adar II, use the same day in last month of year (Adar or Adar II).
+    hDeath.mm = monthsInYear(hyear);
+  } else if (hDeath.mm == ADAR_I$1 && hDeath.dd == 30 && !isLeapYear(hyear)) {
+    // If it's the 30th in Adar I and year is not a leap year
+    // (so Adar has only 29 days), use the last day in Shevat.
+    hDeath.dd = 30;
+    hDeath.mm = SHVAT;
+  }
+  // In all other cases, use the normal anniversary of the date of death.
+  // advance day to rosh chodesh if needed
+  if (hDeath.mm == CHESHVAN && hDeath.dd == 30 && !longCheshvan(hyear)) {
+    hDeath.mm = KISLEV$1;
+    hDeath.dd = 1;
+  } else if (hDeath.mm == KISLEV$1 && hDeath.dd == 30 && shortKislev(hyear)) {
+    hDeath.mm = TEVET$1;
+    hDeath.dd = 1;
+  }
+  hDeath.yy = hyear;
+  return hDeath;
+}
+function getBirthdayHD(hyear, date) {
+  const orig = toSimpleHebrewDate(date);
+  const origYear = orig.yy;
+  if (hyear === origYear) {
+    return orig;
+  } else if (hyear < origYear) {
+    // Hebrew year ${hyear} occurs on or before original date in ${origYear}
+    return undefined;
+  }
+  const isOrigLeap = isLeapYear(origYear);
+  let month = orig.mm;
+  let day = orig.dd;
+  if (month == ADAR_I$1 && !isOrigLeap || month == ADAR_II && isOrigLeap) {
+    month = monthsInYear(hyear);
+  } else if (month == CHESHVAN && day == 30 && !longCheshvan(hyear)) {
+    month = KISLEV$1;
+    day = 1;
+  } else if (month == KISLEV$1 && day == 30 && shortKislev(hyear)) {
+    month = TEVET$1;
+    day = 1;
+  } else if (month == ADAR_I$1 && day == 30 && isOrigLeap && !isLeapYear(hyear)) {
+    month = NISAN$3;
+    day = 1;
+  }
+  return {
+    yy: hyear,
+    mm: month,
+    dd: day
+  };
+}
+
+const GERESH = '׳';
+const GERSHAYIM = '״';
+const alefbet = {
+  'א': 1,
+  'ב': 2,
+  'ג': 3,
+  'ד': 4,
+  'ה': 5,
+  'ו': 6,
+  'ז': 7,
+  'ח': 8,
+  'ט': 9,
+  'י': 10,
+  'כ': 20,
+  'ל': 30,
+  'מ': 40,
+  'נ': 50,
+  'ס': 60,
+  'ע': 70,
+  'פ': 80,
+  'צ': 90,
+  'ק': 100,
+  'ר': 200,
+  'ש': 300,
+  'ת': 400
+};
+const heb2num = new Map();
+const num2heb = new Map();
+for (const [key, val] of Object.entries(alefbet)) {
+  heb2num.set(key, val);
+  num2heb.set(val, key);
+}
+function num2digits(num) {
+  const digits = [];
+  while (num > 0) {
+    if (num === 15 || num === 16) {
+      digits.push(9);
+      digits.push(num - 9);
+      break;
+    }
+    let incr = 100;
+    let i;
+    for (i = 400; i > num; i -= incr) {
+      if (i === incr) {
+        incr = incr / 10;
+      }
+    }
+    digits.push(i);
+    num -= i;
+  }
+  return digits;
+}
+/**
+ * Converts a numerical value to a string of Hebrew letters.
+ *
+ * When specifying years of the Hebrew calendar in the present millennium,
+ * we omit the thousands (which is presently 5 [ה]).
+ * @example
+ * gematriya(5774) // 'תשע״ד' - cropped to 774
+ * gematriya(25) // 'כ״ה'
+ * gematriya(60) // 'ס׳'
+ * gematriya(3761) // 'ג׳תשס״א'
+ * gematriya(1123) // 'א׳קכ״ג'
+ * @param {number} num
+ * @return {string}
+ */
+function gematriya(num) {
+  const num0 = num;
+  const num1 = parseInt(num0, 10);
+  if (!num1) {
+    throw new TypeError(`invalid parameter to gematriya ${num}`);
+  }
+  let str = '';
+  const thousands = Math.floor(num1 / 1000);
+  if (thousands > 0 && thousands !== 5) {
+    const tdigits = num2digits(thousands);
+    for (const tdig of tdigits) {
+      str += num2heb.get(tdig);
+    }
+    str += GERESH;
+  }
+  const digits = num2digits(num1 % 1000);
+  if (digits.length == 1) {
+    return str + num2heb.get(digits[0]) + GERESH;
+  }
+  for (let i = 0; i < digits.length; i++) {
+    if (i + 1 === digits.length) {
+      str += GERSHAYIM;
+    }
+    str += num2heb.get(digits[i]);
+  }
+  return str;
+}
+/**
+ * Converts a string of Hebrew letters to a numerical value.
+ *
+ * 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;
+  const gereshIdx = str.indexOf(GERESH);
+  if (gereshIdx !== -1 && gereshIdx !== str.length - 1) {
+    const thousands = str.substring(0, gereshIdx);
+    num += gematriyaStrToNum(thousands) * 1000;
+    str = str.substring(gereshIdx);
+  }
+  for (const ch of str) {
+    const n = heb2num.get(ch);
+    if (typeof n === 'number') {
+      num += n;
+    }
+  }
+  return num;
+}
+
+const noopLocale = {
+  headers: {
+    'plural-forms': 'nplurals=2; plural=(n!=1);'
+  },
+  contexts: {
+    '': {}
+  }
+};
+const alias = {
+  'h': 'he',
+  'a': 'ashkenazi',
+  's': 'en',
+  '': 'en'
+};
+
+/** @private */
+const locales = new Map();
+/** @private */
+let activeLocale = null;
+/** @private */
+let activeName = null;
+
+/**
+ * A locale in Hebcal is used for translations/transliterations of
+ * holidays. `@hebcal/core` supports four locales by default
+ * * `en` - default, Sephardic transliterations (e.g. "Shabbat")
+ * * `ashkenazi` - Ashkenazi transliterations (e.g. "Shabbos")
+ * * `he` - Hebrew (e.g. "שַׁבָּת")
+ * * `he-x-NoNikud` - Hebrew without nikud (e.g. "שבת")
+ */
+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}
+   */
+  static lookupTranslation(id, locale) {
+    const locale0 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
+    const loc = typeof locale == 'string' && locales.get(locale0) || activeLocale;
+    const array = loc[id];
+    if (array && array.length && array[0].length) {
+      return array[0];
+    }
+    return undefined;
+  }
 
-const NISAN$3 = months.NISAN;
-const CHESHVAN = months.CHESHVAN;
-const KISLEV$1 = months.KISLEV;
-const TEVET$1 = months.TEVET;
-const SHVAT = months.SHVAT;
-const ADAR_I$1 = months.ADAR_I;
-const ADAR_II = months.ADAR_II;
-/**
- * Returns true if the object is a Javascript Date
- * @private
- * @param {Object} obj
- */
-function isSimpleHebrewDate(obj) {
-  return typeof obj === 'object' && obj !== null && typeof obj.yy === 'number' && typeof obj.mm === 'number' && typeof obj.dd === 'number';
-}
-/**
- * @private
- */
-function toSimpleHebrewDate(obj) {
-  if (isSimpleHebrewDate(obj)) {
-    return obj;
-  } else if (typeof obj === 'number') {
-    return abs2hebrew(obj);
-  } else if (exports.greg.isDate(obj)) {
-    const abs = exports.greg.greg2abs(obj);
-    return abs2hebrew(abs);
-  } else {
-    throw new TypeError(`Argument not a Date: ${obj}`);
+  /**
+   * 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}
+   */
+  static gettext(id, locale) {
+    const text = this.lookupTranslation(id, locale);
+    if (typeof text == 'undefined') {
+      return id;
+    }
+    return text;
   }
-}
-function getYahrzeitHD(hyear, date) {
-  let hDeath = toSimpleHebrewDate(date);
-  if (hyear <= hDeath.yy) {
-    // Hebrew year ${hyear} occurs on or before original date in ${hDeath.yy}
-    return undefined;
+
+  /**
+   * Register locale translations.
+   * @param {string} locale Locale name (i.e.: `'he'`, `'fr'`)
+   * @param {LocaleData} 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') {
+      throw new TypeError(`Locale '${locale}' invalid compact format`);
+    }
+    locales.set(locale.toLowerCase(), data.contexts['']);
   }
-  if (hDeath.mm == CHESHVAN && hDeath.dd == 30 && !longCheshvan(hDeath.yy + 1)) {
-    // If it's Heshvan 30 it depends on the first anniversary;
-    // if that was not Heshvan 30, use the day before Kislev 1.
-    hDeath = abs2hebrew(hebrew2abs(hyear, KISLEV$1, 1) - 1);
-  } else if (hDeath.mm == KISLEV$1 && hDeath.dd == 30 && shortKislev(hDeath.yy + 1)) {
-    // If it's Kislev 30 it depends on the first anniversary;
-    // if that was not Kislev 30, use the day before Teveth 1.
-    hDeath = abs2hebrew(hebrew2abs(hyear, TEVET$1, 1) - 1);
-  } else if (hDeath.mm == ADAR_II) {
-    // If it's Adar II, use the same day in last month of year (Adar or Adar II).
-    hDeath.mm = monthsInYear(hyear);
-  } else if (hDeath.mm == ADAR_I$1 && hDeath.dd == 30 && !isLeapYear(hyear)) {
-    // If it's the 30th in Adar I and year is not a leap year
-    // (so Adar has only 29 days), use the last day in Shevat.
-    hDeath.dd = 30;
-    hDeath.mm = SHVAT;
+
+  /**
+   * 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} translation Translation text
+   */
+  static addTranslation(locale, id, translation) {
+    if (typeof locale !== 'string') {
+      throw new TypeError(`Invalid locale name: ${locale}`);
+    }
+    const locale0 = locale.toLowerCase();
+    const loc = locales.get(locale0);
+    if (!loc) {
+      throw new TypeError(`Unknown locale: ${locale}`);
+    }
+    if (typeof id !== 'string' || id.length === 0) {
+      throw new TypeError(`Invalid id: ${id}`);
+    }
+    const isArray = Array.isArray(translation);
+    if (isArray) {
+      const t0 = translation[0];
+      if (typeof t0 !== 'string' || t0.length === 0) {
+        throw new TypeError(`Invalid translation array: ${translation}`);
+      }
+    } else if (typeof translation !== 'string') {
+      throw new TypeError(`Invalid translation: ${translation}`);
+    }
+    loc[id] = isArray ? translation : [translation];
   }
-  // In all other cases, use the normal anniversary of the date of death.
-  // advance day to rosh chodesh if needed
-  if (hDeath.mm == CHESHVAN && hDeath.dd == 30 && !longCheshvan(hyear)) {
-    hDeath.mm = KISLEV$1;
-    hDeath.dd = 1;
-  } else if (hDeath.mm == KISLEV$1 && hDeath.dd == 30 && shortKislev(hyear)) {
-    hDeath.mm = TEVET$1;
-    hDeath.dd = 1;
+  /**
+   * 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.
+   */
+  static addTranslations(locale, data) {
+    if (typeof locale !== 'string') {
+      throw new TypeError(`Invalid locale name: ${locale}`);
+    }
+    const locale0 = locale.toLowerCase();
+    const loc = locales.get(locale0);
+    if (!loc) {
+      throw new TypeError(`Unknown locale: ${locale}`);
+    }
+    if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
+      throw new TypeError(`Locale '${locale}' invalid compact format`);
+    }
+    const ctx = data.contexts[''];
+    Object.assign(loc, ctx);
   }
-  hDeath.yy = hyear;
-  return hDeath;
-}
-function getBirthdayHD(hyear, date) {
-  const orig = toSimpleHebrewDate(date);
-  const origYear = orig.yy;
-  if (hyear === origYear) {
-    return orig;
-  } else if (hyear < origYear) {
-    // Hebrew year ${hyear} occurs on or before original date in ${origYear}
-    return undefined;
+  /**
+   * 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'`)
+   * @return {LocaleData}
+   */
+  static useLocale(locale) {
+    const locale0 = locale.toLowerCase();
+    const obj = locales.get(locale0);
+    if (!obj) {
+      throw new RangeError(`Locale '${locale}' not found`);
+    }
+    activeName = alias[locale0] || locale0;
+    activeLocale = obj;
+    return activeLocale;
   }
-  const isOrigLeap = isLeapYear(origYear);
-  let month = orig.mm;
-  let day = orig.dd;
-  if (month == ADAR_I$1 && !isOrigLeap || month == ADAR_II && isOrigLeap) {
-    month = monthsInYear(hyear);
-  } else if (month == CHESHVAN && day == 30 && !longCheshvan(hyear)) {
-    month = KISLEV$1;
-    day = 1;
-  } else if (month == KISLEV$1 && day == 30 && shortKislev(hyear)) {
-    month = TEVET$1;
-    day = 1;
-  } else if (month == ADAR_I$1 && day == 30 && isOrigLeap && !isLeapYear(hyear)) {
-    month = NISAN$3;
-    day = 1;
+
+  /**
+   * 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}
+   */
+  static ordinal(n, locale) {
+    const locale1 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
+    const locale0 = locale1 || activeName;
+    if (!locale0) {
+      return this.getEnOrdinal(n);
+    }
+    switch (locale0) {
+      case 'en':
+      case 's':
+      case 'a':
+      case 'ashkenazi':
+      case 'ashkenazi_litvish':
+      case 'ashkenazi_poylish':
+      case 'ashkenazi_standard':
+        return this.getEnOrdinal(n);
+      case 'es':
+        return n + 'º';
+      case 'h':
+      case 'he':
+      case 'he-x-nonikud':
+        return String(n);
+      default:
+        return n + '.';
+    }
+  }
+
+  /**
+   * @private
+   * @param {number} n
+   * @return {string}
+   */
+  static getEnOrdinal(n) {
+    const s = ['th', 'st', 'nd', 'rd'];
+    const v = n % 100;
+    return n + (s[(v - 20) % 10] || s[v] || s[0]);
+  }
+
+  /**
+   * Removes nekudot from Hebrew string
+   * @param {string} str
+   * @return {string}
+   */
+  static hebrewStripNikkud(str) {
+    return str.replace(/[\u0590-\u05bd]/g, '').replace(/[\u05bf-\u05c7]/g, '');
   }
-  return {
-    yy: hyear,
-    mm: month,
-    dd: day
-  };
 }
+Locale.addLocale('en', noopLocale);
+Locale.addLocale('s', noopLocale);
+Locale.addLocale('', noopLocale);
+Locale.useLocale('en');
 
 /**
  * @private
@@ -9766,7 +9761,7 @@ class DailyLearning {
   }
 }
 
-const version="5.0.1";
+const version="5.0.2";
 
 const headers$1={"plural-forms":"nplurals=2; plural=(n > 1);"};const contexts$1={"":{Shabbat:["Shabbos"],"Achrei Mot":["Achrei Mos"],Bechukotai:["Bechukosai"],"Beha'alotcha":["Beha'aloscha"],Bereshit:["Bereshis"],Chukat:["Chukas"],"Erev Shavuot":["Erev Shavuos"],"Erev Sukkot":["Erev Sukkos"],"Ki Tavo":["Ki Savo"],"Ki Teitzei":["Ki Seitzei"],"Ki Tisa":["Ki Sisa"],Matot:["Matos"],"Purim Katan":["Purim Koton"],"Shabbat Chazon":["Shabbos Chazon"],"Shabbat HaChodesh":["Shabbos HaChodesh"],"Shabbat HaGadol":["Shabbos HaGadol"],"Shabbat Nachamu":["Shabbos Nachamu"],"Shabbat Parah":["Shabbos Parah"],"Shabbat Shekalim":["Shabbos Shekalim"],"Shabbat Shuva":["Shabbos Shuvah"],"Shabbat Zachor":["Shabbos Zachor"],Shavuot:["Shavuos"],"Shavuot I":["Shavuos I"],"Shavuot II":["Shavuos II"],Shemot:["Shemos"],"Shmini Atzeret":["Shmini Atzeres"],"Simchat Torah":["Simchas Torah"],Sukkot:["Sukkos"],"Sukkot I":["Sukkos I"],"Sukkot II":["Sukkos II"],"Sukkot II (CH''M)":["Sukkos II (CH''M)"],"Sukkot III (CH''M)":["Sukkos III (CH''M)"],"Sukkot IV (CH''M)":["Sukkos IV (CH''M)"],"Sukkot V (CH''M)":["Sukkos V (CH''M)"],"Sukkot VI (CH''M)":["Sukkos VI (CH''M)"],"Sukkot VII (Hoshana Raba)":["Sukkos VII (Hoshana Raba)"],"Ta'anit Bechorot":["Ta'anis Bechoros"],"Ta'anit Esther":["Ta'anis Esther"],Toldot:["Toldos"],Vaetchanan:["Vaeschanan"],Yitro:["Yisro"],"Vezot Haberakhah":["Vezos Haberakhah"],Parashat:["Parshas"],"Leil Selichot":["Leil Selichos"],"Shabbat Mevarchim Chodesh":["Shabbos Mevorchim Chodesh"],"Shabbat Shirah":["Shabbos Shirah"],Tevet:["Teves"],"Asara B'Tevet":["Asara B'Teves"],"Alot HaShachar":["Alos HaShachar"],"Kriat Shema, sof zeman":["Krias Shema, sof zman"],"Tefilah, sof zeman":["Tefilah, sof zman"],"Kriat Shema, sof zeman (MGA)":["Krias Shema, sof zman (MGA)"],"Tefilah, sof zeman (MGA)":["Tefilah, sof zman (MGA)"],"Chatzot HaLailah":["Chatzos HaLailah"],"Chatzot hayom":["Chatzos"],"Tzeit HaKochavim":["Tzeis HaKochavim"],"Birkat Hachamah":["Birkas Hachamah"],"Shushan Purim Katan":["Shushan Purim Koton"]}};var poAshkenazi = {headers:headers$1,contexts:contexts$1};
 
@@ -10940,6 +10935,7 @@ function observedInDiaspora(ev) {
   return ev.observedInDiaspora();
 }
 const yearArrayCache = new Map();
+const holidaysOnDate = new Map();
 
 /**
  * HebrewCalendar is the main interface to the `@hebcal/core` library.
@@ -11288,20 +11284,29 @@ class HebrewCalendar {
   }
 
   /**
-   * Returns an array of Events on this date (or undefined if no events)
+   * 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 {Event[]}
    */
   static getHolidaysOnDate(date, il) {
     const hd = HDate.isHDate(date) ? date : new HDate(date);
+    const hdStr = hd.toString();
+    const cacheKey = hdStr + '/' + (typeof il === 'undefined' ? 2 : il ? 1 : 0);
+    if (holidaysOnDate.has(cacheKey)) {
+      return holidaysOnDate.get(cacheKey);
+    }
     const yearMap = getHolidaysForYear_(hd.getFullYear());
-    const events = yearMap.get(hd.toString());
+    const events = yearMap.get(hdStr);
+    // if il isn't a boolean return both diaspora + IL for day
     if (typeof il === 'undefined' || typeof events === 'undefined') {
+      holidaysOnDate.set(cacheKey, events);
       return events;
     }
     const myFilter = il ? observedInIsrael : observedInDiaspora;
-    return events.filter(myFilter);
+    const filtered = events.filter(myFilter);
+    holidaysOnDate.set(cacheKey, filtered);
+    return filtered;
   }
 
   /**