@hebcal/core 5.4.9 → 5.4.11

package/dist/event.d.ts

@@ -8,59 +8,59 @@ import './locale';
  */
 export declare const flags: {
     /** Chag, yontiff, yom tov */
-    CHAG: number;
+    readonly CHAG: 1;
     /** Light candles 18 minutes before sundown */
-    LIGHT_CANDLES: number;
+    readonly LIGHT_CANDLES: 2;
     /** End of holiday (end of Yom Tov)  */
-    YOM_TOV_ENDS: number;
+    readonly YOM_TOV_ENDS: 4;
     /** Observed only in the Diaspora (chutz l'aretz)  */
-    CHUL_ONLY: number;
+    readonly CHUL_ONLY: 8;
     /** Observed only in Israel */
-    IL_ONLY: number;
+    readonly IL_ONLY: 16;
     /** Light candles in the evening at Tzeit time (3 small stars) */
-    LIGHT_CANDLES_TZEIS: number;
+    readonly LIGHT_CANDLES_TZEIS: 32;
     /** Candle-lighting for Chanukah */
-    CHANUKAH_CANDLES: number;
+    readonly CHANUKAH_CANDLES: 64;
     /** Rosh Chodesh, beginning of a new Hebrew month */
-    ROSH_CHODESH: number;
+    readonly ROSH_CHODESH: 128;
     /** Minor fasts like Tzom Tammuz, Ta'anit Esther, ... */
-    MINOR_FAST: number;
+    readonly MINOR_FAST: 256;
     /** Shabbat Shekalim, Zachor, ... */
-    SPECIAL_SHABBAT: number;
+    readonly SPECIAL_SHABBAT: 512;
     /** Weekly sedrot on Saturdays */
-    PARSHA_HASHAVUA: number;
+    readonly PARSHA_HASHAVUA: 1024;
     /** Daily page of Talmud (Bavli) */
-    DAF_YOMI: number;
+    readonly DAF_YOMI: 2048;
     /** Days of the Omer */
-    OMER_COUNT: number;
+    readonly OMER_COUNT: 4096;
     /** Yom HaShoah, Yom HaAtzma'ut, ... */
-    MODERN_HOLIDAY: number;
+    readonly MODERN_HOLIDAY: 8192;
     /** Yom Kippur and Tish'a B'Av */
-    MAJOR_FAST: number;
+    readonly MAJOR_FAST: 16384;
     /** On the Saturday before Rosh Chodesh */
-    SHABBAT_MEVARCHIM: number;
+    readonly SHABBAT_MEVARCHIM: 32768;
     /** Molad */
-    MOLAD: number;
+    readonly MOLAD: 65536;
     /** Yahrzeit or Hebrew Anniversary */
-    USER_EVENT: number;
+    readonly USER_EVENT: 131072;
     /** Daily Hebrew date ("11th of Sivan, 5780") */
-    HEBREW_DATE: number;
+    readonly HEBREW_DATE: 262144;
     /** A holiday that's not major, modern, rosh chodesh, or a fast day */
-    MINOR_HOLIDAY: number;
+    readonly MINOR_HOLIDAY: 524288;
     /** Evening before a major or minor holiday */
-    EREV: number;
+    readonly EREV: 1048576;
     /** Chol haMoed, intermediate days of Pesach or Sukkot */
-    CHOL_HAMOED: number;
+    readonly CHOL_HAMOED: 2097152;
     /** Mishna Yomi */
-    MISHNA_YOMI: number;
+    readonly MISHNA_YOMI: 4194304;
     /** Yom Kippur Katan, minor day of atonement on the day preceeding each Rosh Chodesh */
-    YOM_KIPPUR_KATAN: number;
+    readonly YOM_KIPPUR_KATAN: 8388608;
     /** Daily page of Jerusalem Talmud (Yerushalmi) */
-    YERUSHALMI_YOMI: number;
+    readonly YERUSHALMI_YOMI: 16777216;
     /** Nach Yomi */
-    NACH_YOMI: number;
+    readonly NACH_YOMI: 33554432;
     /** Daily Learning */
-    DAILY_LEARNING: number;
+    readonly DAILY_LEARNING: 67108864;
 };
 /**
  * Represents an Event with a title, date, and flags.

package/dist/hebcal.d.ts

@@ -13,6 +13,7 @@ import { TachanunResult } from './tachanun';
  * Event names can be rendered in several languges using the `locale` option.
  */
 export declare class HebrewCalendar {
+    private constructor();
     /**
      * Calculates holidays and other Hebrew calendar events based on {@link CalOptions}.
      *

package/dist/index.cjs

@@ -1,4 +1,4 @@
-/*! @hebcal/core v5.4.9 */
+/*! @hebcal/core v5.4.11 */
 'use strict';
 
 /* eslint-disable @typescript-eslint/no-namespace, no-inner-declarations */
@@ -145,15 +145,15 @@ exports.greg.isLeapYear = isGregLeapYear;
  */
 const NISAN$4 = 1;
 const IYYAR$1 = 2;
-// const SIVAN = 3;
+const SIVAN$1 = 3;
 const TAMUZ$1 = 4;
-// const AV = 5;
+const AV$1 = 5;
 const ELUL$1 = 6;
 const TISHREI$3 = 7;
 const CHESHVAN$1 = 8;
 const KISLEV$2 = 9;
 const TEVET$2 = 10;
-// const SHVAT = 11;
+const SHVAT$1 = 11;
 const ADAR_I$2 = 12;
 const ADAR_II$2 = 13;
 /**
@@ -163,31 +163,31 @@ const ADAR_II$2 = 13;
  */
 const months = {
     /** Nissan / ניסן */
-    NISAN: 1,
+    NISAN: NISAN$4,
     /** Iyyar / אייר */
-    IYYAR: 2,
+    IYYAR: IYYAR$1,
     /** Sivan / סיון */
-    SIVAN: 3,
+    SIVAN: SIVAN$1,
     /** Tamuz (sometimes Tammuz) / תמוז */
-    TAMUZ: 4,
+    TAMUZ: TAMUZ$1,
     /** Av / אב */
-    AV: 5,
+    AV: AV$1,
     /** Elul / אלול */
-    ELUL: 6,
+    ELUL: ELUL$1,
     /** Tishrei / תִּשְׁרֵי */
-    TISHREI: 7,
+    TISHREI: TISHREI$3,
     /** Cheshvan / חשון */
-    CHESHVAN: 8,
+    CHESHVAN: CHESHVAN$1,
     /** Kislev / כסלו */
-    KISLEV: 9,
+    KISLEV: KISLEV$2,
     /** Tevet / טבת */
-    TEVET: 10,
+    TEVET: TEVET$2,
     /** Sh'vat / שבט */
-    SHVAT: 11,
+    SHVAT: SHVAT$1,
     /** Adar or Adar Rishon / אדר */
-    ADAR_I: 12,
+    ADAR_I: ADAR_I$2,
     /** Adar Sheini (only on leap years) / אדר ב׳ */
-    ADAR_II: 13,
+    ADAR_II: ADAR_II$2,
 };
 const monthNames0 = [
     '',
@@ -447,73 +447,73 @@ function monthFromName(monthName) {
             if (c[1] === 'o') {
                 break; /* this catches "november" */
             }
-            return months.NISAN;
+            return NISAN$4;
         case 'i':
-            return months.IYYAR;
+            return IYYAR$1;
         case 'e':
-            return months.ELUL;
+            return ELUL$1;
         case 'c':
         case 'ח':
-            return months.CHESHVAN;
+            return CHESHVAN$1;
         case 'k':
         case 'כ':
-            return months.KISLEV;
+            return KISLEV$2;
         case 's':
             switch (c[1]) {
                 case 'i':
-                    return months.SIVAN;
+                    return SIVAN$1;
                 case 'h':
-                    return months.SHVAT;
+                    return SHVAT$1;
             }
             break;
         case 't':
             switch (c[1]) {
                 case 'a':
-                    return months.TAMUZ;
+                    return TAMUZ$1;
                 case 'i':
-                    return months.TISHREI;
+                    return TISHREI$3;
                 case 'e':
-                    return months.TEVET;
+                    return TEVET$2;
             }
             break;
         case 'a':
             switch (c[1]) {
                 case 'v':
-                    return months.AV;
+                    return AV$1;
                 case 'd':
                     if (/(1|[^i]i|a|א)$/i.test(monthName)) {
-                        return months.ADAR_I;
+                        return ADAR_I$2;
                     }
-                    return months.ADAR_II; // else assume sheini
+                    return ADAR_II$2; // else assume sheini
             }
             break;
         case 'ס':
-            return months.SIVAN;
+            return SIVAN$1;
         case 'ט':
-            return months.TEVET;
+            return TEVET$2;
         case 'ש':
-            return months.SHVAT;
+            return SHVAT$1;
         case 'א':
             switch (c[1]) {
                 case 'ב':
-                    return months.AV;
+                    return AV$1;
                 case 'ד':
                     if (/(1|[^i]i|a|א)$/i.test(monthName)) {
-                        return months.ADAR_I;
+                        return ADAR_I$2;
                     }
-                    return months.ADAR_II; // else assume sheini
+                    return ADAR_II$2; // else assume sheini
                 case 'י':
-                    return months.IYYAR;
+                    return IYYAR$1;
                 case 'ל':
-                    return months.ELUL;
+                    return ELUL$1;
             }
             break;
         case 'ת':
             switch (c[1]) {
                 case 'מ':
-                    return months.TAMUZ;
+                    return TAMUZ$1;
                 case 'ש':
-                    return months.TISHREI;
+                    return TISHREI$3;
             }
             break;
     }
@@ -545,15 +545,13 @@ function toSimpleHebrewDate(obj) {
     if (isSimpleHebrewDate$1(obj)) {
         return obj;
     }
-    else if (typeof obj === 'number') {
-        return abs2hebrew(obj);
-    }
     else if (isDate(obj)) {
         const abs = greg2abs(obj);
         return abs2hebrew(abs);
     }
     else {
-        throw new TypeError(`Argument not a Date: ${obj}`);
+        // typeof obj === 'number'
+        return abs2hebrew(obj);
     }
 }
 function getYahrzeitHD(hyear, date) {
@@ -700,8 +698,8 @@ function num2digits(num) {
 function gematriya(num) {
     const num0 = num;
     const num1 = parseInt(num0, 10);
-    if (!num1) {
-        throw new TypeError(`invalid parameter to gematriya ${num}`);
+    if (!num1 || num1 < 0) {
+        throw new TypeError(`invalid gematriya number: ${num}`);
     }
     let str = '';
     const thousands = Math.floor(num1 / 1000);
@@ -1006,6 +1004,38 @@ function molad(year, month) {
     };
 }
 
+/**
+ * Formats a number with leading zeros so the resulting string is 4 digits long.
+ * 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`).
+ */
+function pad4(num) {
+    if (num < 0) {
+        return '-00' + pad4(-num);
+    }
+    else if (num < 10) {
+        return '000' + num;
+    }
+    else if (num < 100) {
+        return '00' + num;
+    }
+    else if (num < 1000) {
+        return '0' + num;
+    }
+    return String(num);
+}
+/**
+ * Formats a number with leading zeros so the resulting string is 2 digits long.
+ * Similar to `string.padStart(2, '0')`.
+ */
+function pad2(num) {
+    if (num >= 0 && num < 10) {
+        return '0' + num;
+    }
+    return String(num);
+}
+
 const _formatters = new Map();
 /**
  * @private
@@ -1055,37 +1085,6 @@ function getTimezoneOffset(tzid, date) {
     const diffMs = new Date(utcStr).getTime() - new Date(localStr).getTime();
     return Math.ceil(diffMs / 1000 / 60);
 }
-/**
- * Formats a number with leading zeros so the resulting string is 4 digits long.
- * 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`).
- */
-function pad4(number) {
-    if (number < 0) {
-        return '-00' + pad4(-number);
-    }
-    else if (number < 10) {
-        return '000' + number;
-    }
-    else if (number < 100) {
-        return '00' + number;
-    }
-    else if (number < 1000) {
-        return '0' + number;
-    }
-    return String(number);
-}
-/**
- * Formats a number with leading zeros so the resulting string is 2 digits long.
- * Similar to `string.padStart(2, '0')`.
- */
-function pad2(number) {
-    if (number < 10) {
-        return '0' + number;
-    }
-    return String(number);
-}
 /**
  * Returns YYYY-MM-DD in the local timezone
  */
@@ -1117,6 +1116,28 @@ const locales = new Map();
 let activeLocale;
 /** @private */
 let activeName;
+/** @private */
+function getEnOrdinal(n) {
+    const s = ['th', 'st', 'nd', 'rd'];
+    const v = n % 100;
+    return n + (s[(v - 20) % 10] || s[v] || s[0]);
+}
+/** @private */
+function checkLocale(locale) {
+    if (typeof locale !== 'string') {
+        throw new TypeError(`Invalid locale name: ${locale}`);
+    }
+    return locale.toLowerCase();
+}
+/** @private */
+function getExistingLocale(locale) {
+    const locale1 = checkLocale(locale);
+    const loc = locales.get(locale1);
+    if (!loc) {
+        throw new RangeError(`Locale '${locale}' not found`);
+    }
+    return loc;
+}
 /**
  * A locale in Hebcal is used for translations/transliterations of
  * holidays. `@hebcal/hdate` supports four locales by default
@@ -1159,14 +1180,12 @@ class Locale {
      * @param data parsed data from a `.po` file.
      */
     static addLocale(locale, data) {
-        if (typeof locale !== 'string') {
-            throw new TypeError(`Invalid locale name: ${locale}`);
-        }
+        locale = checkLocale(locale);
         if (typeof data.contexts !== 'object' ||
             typeof data.contexts[''] !== 'object') {
             throw new TypeError(`Locale '${locale}' invalid compact format`);
         }
-        locales.set(locale.toLowerCase(), data.contexts['']);
+        locales.set(locale, data.contexts['']);
     }
     /**
      * Adds a translation to `locale`, replacing any previous translation.
@@ -1175,15 +1194,9 @@ class Locale {
      * @param translation Translation text
      */
     static addTranslation(locale, id, translation) {
-        if (typeof locale !== 'string') {
-            throw new TypeError(`Invalid locale name: ${locale}`);
-        }
-        const loc = locales.get(locale.toLowerCase());
-        if (!loc) {
-            throw new TypeError(`Unknown locale: ${locale}`);
-        }
+        const loc = getExistingLocale(locale);
         if (typeof id !== 'string' || id.length === 0) {
-            throw new TypeError(`Invalid id: ${id}`);
+            throw new TypeError(`Invalid id string: ${id}`);
         }
         const isArray = Array.isArray(translation);
         if (isArray) {
@@ -1193,7 +1206,7 @@ class Locale {
             }
         }
         else if (typeof translation !== 'string') {
-            throw new TypeError(`Invalid translation: ${translation}`);
+            throw new TypeError(`Invalid translation string: ${translation}`);
         }
         loc[id] = isArray ? translation : [translation];
     }
@@ -1203,13 +1216,7 @@ class Locale {
      * @param data parsed data from a `.po` file.
      */
     static addTranslations(locale, data) {
-        if (typeof locale !== 'string') {
-            throw new TypeError(`Invalid locale name: ${locale}`);
-        }
-        const loc = locales.get(locale.toLowerCase());
-        if (!loc) {
-            throw new TypeError(`Unknown locale: ${locale}`);
-        }
+        const loc = getExistingLocale(locale);
         if (typeof data.contexts !== 'object' ||
             typeof data.contexts[''] !== 'object') {
             throw new TypeError(`Locale '${locale}' invalid compact format`);
@@ -1224,11 +1231,8 @@ class Locale {
      * @param locale Locale name (i.e: `'he'`, `'fr'`)
      */
     static useLocale(locale) {
-        const locale0 = locale.toLowerCase();
-        const obj = locales.get(locale0);
-        if (!obj) {
-            throw new RangeError(`Locale '${locale}' not found`);
-        }
+        const locale0 = checkLocale(locale);
+        const obj = getExistingLocale(locale0);
         activeName = alias[locale0] || locale0;
         activeLocale = obj;
         return activeLocale;
@@ -1254,31 +1258,24 @@ class Locale {
         const locale1 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
         const locale0 = locale1 || activeName;
         if (!locale0) {
-            return this.getEnOrdinal(n);
+            return 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);
+                return getEnOrdinal(n);
             case 'es':
                 return n + 'º';
             case 'h':
             case 'he':
             case 'he-x-nonikud':
                 return String(n);
-            default:
-                return n + '.';
         }
-    }
-    static getEnOrdinal(n) {
-        const s = ['th', 'st', 'nd', 'rd'];
-        const v = n % 100;
-        return n + (s[(v - 20) % 10] || s[v] || s[0]);
+        if (locale0.startsWith('ashkenazi')) {
+            return getEnOrdinal(n);
+        }
+        return n + '.';
     }
     /**
      * Removes nekudot from Hebrew string
@@ -1468,7 +1465,7 @@ class HDate {
      * @returns an integer 1-13
      * @example
      * const hd = new HDate(new Date(2008, 10, 13)); // 15 Cheshvan 5769
-     * hd.getMonth(); // 2
+     * hd.getTishreiMonth(); // 2
      */
     getTishreiMonth() {
         const nummonths = monthsInYear(this.getFullYear());
@@ -1708,7 +1705,8 @@ class HDate {
         else if (units === UNITS_YEAR) {
             return new HDate(this.getDate(), this.getMonth(), this.getFullYear() + amount);
         }
-        else if (units === UNITS_MONTH) {
+        else {
+            // units === UNITS_MONTH
             let hd = new HDate(this);
             const sign = amount > 0 ? 1 : -1;
             amount = Math.abs(amount);
@@ -1717,9 +1715,6 @@ class HDate {
             }
             return hd;
         }
-        else {
-            throw new TypeError(`Invalid units '${units}'`);
-        }
     }
     /**
      * Returns a cloned `HDate` object with a specified amount of time subracted
@@ -1760,9 +1755,6 @@ class HDate {
      * @param other Hebrew date to compare
      */
     deltaDays(other) {
-        if (!HDate.isHDate(other)) {
-            throw new TypeError(`Bad argument: ${other}`);
-        }
         return this.abs() - other.abs();
     }
     /**
@@ -1774,10 +1766,7 @@ class HDate {
      * hd1.isSameDate(hd2); // true
      */
     isSameDate(other) {
-        if (HDate.isHDate(other)) {
-            return (this.yy === other.yy && this.mm === other.mm && this.dd === other.dd);
-        }
-        return false;
+        return this.yy === other.yy && this.mm === other.mm && this.dd === other.dd;
     }
     /**
      * Returns a string representation of this Hebrew date using English transliterations
@@ -9107,7 +9096,7 @@ class Sedra {
      */
     find(parsha) {
         if (typeof parsha === 'number') {
-            if (parsha > 53 || (parsha < 0 && !isValidDouble(parsha))) {
+            if (parsha >= parshiot.length || (parsha < 0 && !isValidDouble(parsha))) {
                 throw new RangeError(`Invalid parsha number: ${parsha}`);
             }
             const idx = this.theSedraArray.indexOf(parsha);
@@ -9133,29 +9122,27 @@ class Sedra {
                 return new HDate(this.firstSaturday + idx * 7);
             }
         }
-        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)) {
+            const plen = parsha.length;
+            if ((plen !== 1 && plen !== 2) || typeof parsha[0] !== 'string') {
+                throw new TypeError(`Invalid parsha argument: ${JSON.stringify(parsha)}`);
+            }
+            if (plen === 1) {
+                return this.find(parsha[0]);
+            }
             const p1 = parsha[0];
             const p2 = parsha[1];
             const num1 = parsha2id.get(p1);
             const num2 = parsha2id.get(p2);
-            if (num2 === num1 + 1) {
-                return this.find(-num1);
-            }
-            else {
+            if (typeof num1 !== 'number' ||
+                typeof num2 !== 'number' ||
+                num2 !== num1 + 1 ||
+                !isValidDouble(-num1)) {
                 throw new RangeError(`Unrecognized parsha name: ${p1}-${p2}`);
             }
+            return this.find(-num1);
         }
-        else {
-            throw new TypeError(`Invalid parsha argument: ${parsha}`);
-        }
+        return null; /* NOTREACHED */
     }
     /**
      * Returns the underlying annual sedra schedule.
@@ -10104,17 +10091,6 @@ const staticModernHolidays = [
     },
 ];
 
-const minorHolidays = [
-    holidayDesc.LAG_BAOMER,
-    holidayDesc.LEIL_SELICHOT,
-    holidayDesc.PESACH_SHENI,
-    holidayDesc.EREV_PURIM,
-    holidayDesc.PURIM_KATAN,
-    holidayDesc.SHUSHAN_PURIM,
-    holidayDesc.TU_BAV,
-    holidayDesc.TU_BISHVAT,
-    holidayDesc.ROSH_HASHANA_LABEHEMOT,
-];
 /** Represents a built-in holiday like Pesach, Purim or Tu BiShvat */
 class HolidayEvent extends Event {
     basename() {
@@ -10164,8 +10140,17 @@ class HolidayEvent extends Event {
         }
         // Don't depend on flags.MINOR_HOLIDAY always being set. Look for minor holidays.
         const desc = this.getDesc();
-        if (minorHolidays.includes(desc)) {
-            return ['holiday', 'minor'];
+        switch (desc) {
+            case holidayDesc.LAG_BAOMER:
+            case holidayDesc.LEIL_SELICHOT:
+            case holidayDesc.PESACH_SHENI:
+            case holidayDesc.EREV_PURIM:
+            case holidayDesc.PURIM_KATAN:
+            case holidayDesc.SHUSHAN_PURIM:
+            case holidayDesc.TU_BAV:
+            case holidayDesc.TU_BISHVAT:
+            case holidayDesc.ROSH_HASHANA_LABEHEMOT:
+                return ['holiday', 'minor'];
         }
         return ['holiday', 'major'];
     }
@@ -10343,7 +10328,7 @@ class DailyLearning {
 }
 
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-const version = '5.4.9';
+const version = '5.4.11';
 
 /* eslint-disable max-len */
 /**
@@ -11388,6 +11373,7 @@ function observedInDiaspora(ev) {
  * Event names can be rendered in several languges using the `locale` option.
  */
 class HebrewCalendar {
+    constructor() { }
     /**
      * Calculates holidays and other Hebrew calendar events based on {@link CalOptions}.
      *