@hebcal/core 5.0.1 → 5.0.2

package/dist/index.js

@@ -1,348 +1,6 @@
-/*! @hebcal/core v5.0.1 */
+/*! @hebcal/core v5.0.2 */
 '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 */
@@ -920,92 +578,429 @@ function isSimpleHebrewDate(obj) {
         typeof obj.dd === 'number';
 }
 /**
- * @private
+ * @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. "שבת")
  */
-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}`);
+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];
     }
-}
-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;
+    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;
     }
-    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);
+    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}`);
     }
-    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);
+    if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
+      throw new TypeError(`Locale '${locale}' invalid compact format`);
     }
-    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);
+    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}`);
     }
-    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;
+    const locale0 = locale.toLowerCase();
+    const loc = locales.get(locale0);
+    if (!loc) {
+      throw new TypeError(`Unknown locale: ${locale}`);
     }
-    // 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;
+    if (typeof id !== 'string' || id.length === 0) {
+      throw new TypeError(`Invalid id: ${id}`);
     }
-    else if (hDeath.mm == KISLEV$1 && hDeath.dd == 30 && shortKislev(hyear)) {
-        hDeath.mm = TEVET$1;
-        hDeath.dd = 1;
+    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}`);
     }
-    hDeath.yy = hyear;
-    return hDeath;
-}
-function getBirthdayHD(hyear, date) {
-    const orig = toSimpleHebrewDate(date);
-    const origYear = orig.yy;
-    if (hyear === origYear) {
-        return orig;
+    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}`);
     }
-    else if (hyear < origYear) {
-        // Hebrew year ${hyear} occurs on or before original date in ${origYear}
-        return undefined;
+    const locale0 = locale.toLowerCase();
+    const loc = locales.get(locale0);
+    if (!loc) {
+      throw new TypeError(`Unknown locale: ${locale}`);
     }
-    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);
+    if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
+      throw new TypeError(`Locale '${locale}' invalid compact format`);
     }
-    else if (month == CHESHVAN && day == 30 && !longCheshvan(hyear)) {
-        month = KISLEV$1;
-        day = 1;
+    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`);
     }
-    else if (month == KISLEV$1 && day == 30 && shortKislev(hyear)) {
-        month = TEVET$1;
-        day = 1;
+    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);
     }
-    else if (month == ADAR_I$1 && day == 30 && isOrigLeap && !isLeapYear(hyear)) {
-        month = NISAN$3;
-        day = 1;
+    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 + '.';
     }
-    return { yy: hyear, mm: month, dd: day };
+  }
+
+  /**
+   * @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
@@ -5885,7 +5880,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};
 
@@ -6547,6 +6542,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.
@@ -6894,20 +6890,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;
   }
 
   /**