@hebcal/core 5.8.9 → 5.8.11

package/dist/HolidayEvent.d.ts

@@ -37,11 +37,18 @@ export declare class HolidayEvent extends Event {
 }
 /**
  * Because Asara B'Tevet often occurs twice in the same Gregorian year,
- * we subclass HolidayEvent to override the `url()` method.
+ * we subclass HolidayEvent to generate the correct URL.
  */
 export declare class AsaraBTevetEvent extends HolidayEvent {
     urlDateSuffix(): string;
 }
+/**
+ * Because Chanukah sometimes starts in December and ends in January,
+ * we subclass HolidayEvent to generate the correct URL.
+ */
+export declare class ChanukahEvent extends HolidayEvent {
+    urlDateSuffix(): string;
+}
 /** Represents Rosh Hashana, the Jewish New Year */
 export declare class RoshHashanaEvent extends HolidayEvent {
     private readonly hyear;

package/dist/bundle.js

@@ -1,11 +1,11 @@
-/*! @hebcal/core v5.8.9, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v5.8.11, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 var hebcal = (function (exports) {
 'use strict';
 
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-const version = '5.8.9';
+const version = '5.8.11';
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 /* 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];
@@ -86,7 +86,7 @@ function toFixed(year, month, day) {
  */
 function greg2abs(date) {
   if (!isDate(date)) {
-    throw new TypeError(`Argument not a Date: ${date}`);
+    throw new TypeError(`not a Date: ${date}`);
   }
   const abs = toFixed(date.getFullYear(), date.getMonth() + 1, date.getDate());
   /*
@@ -117,7 +117,7 @@ function greg2abs(date) {
  */
 function abs2greg(abs) {
   if (typeof abs !== 'number') {
-    throw new TypeError(`Argument not a Number: ${abs}`);
+    throw new TypeError(`not a Number: ${abs}`);
   }
   abs = Math.trunc(abs);
   /*
@@ -137,7 +137,7 @@ function abs2greg(abs) {
   return dt;
 }
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 
 /* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-namespace */
 /**
@@ -151,7 +151,7 @@ exports.greg.greg2abs = greg2abs;
 exports.greg.isDate = isDate;
 exports.greg.isLeapYear = isGregLeapYear;
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 /*
  * More minimal HDate
  */
@@ -201,13 +201,14 @@ const months = {
   /** Adar Sheini (only on leap years) / אדר ב׳ */
   ADAR_II: ADAR_II$2
 };
-const monthNames0 = ['', 'Nisan', 'Iyyar', 'Sivan', 'Tamuz', 'Av', 'Elul', 'Tishrei', 'Cheshvan', 'Kislev', 'Tevet', "Sh'vat"];
-/**
+const NISAN_STR = 'Nisan';
+const monthNames0 = ['', NISAN_STR, 'Iyyar', 'Sivan', 'Tamuz', 'Av', 'Elul', 'Tishrei', 'Cheshvan', 'Kislev', 'Tevet', "Sh'vat"];
+/*
  * Transliterations of Hebrew month names.
  * Regular years are index 0 and leap years are index 1.
  * @private
  */
-const monthNames = [[...monthNames0, 'Adar', 'Nisan'], [...monthNames0, 'Adar I', 'Adar II', 'Nisan']];
+const monthNames = [[...monthNames0, 'Adar', NISAN_STR], [...monthNames0, 'Adar I', 'Adar II', NISAN_STR]];
 const edCache = new Map();
 const EPOCH = -1373428;
 // Avg year length in the cycle (19 solar years with 235 lunar months)
@@ -217,7 +218,7 @@ const AVG_HEBYEAR_DAYS = 365.24682220597794;
  */
 function assertNumber(n, name) {
   if (typeof n !== 'number' || isNaN(n)) {
-    throw new TypeError(`invalid parameter '${name}' not a number: ${n}`);
+    throw new TypeError(`param '${name}' not a number: ${n}`);
   }
 }
 /**
@@ -329,7 +330,7 @@ function getMonthName(month, year) {
   assertNumber(month, 'month');
   assertNumber(year, 'year');
   if (month < 1 || month > 14) {
-    throw new TypeError(`bad month argument ${month}`);
+    throw new TypeError(`bad monthNum: ${month}`);
   }
   return monthNames[+isLeapYear(year)][month];
 }
@@ -404,7 +405,7 @@ function shortKislev(year) {
 function monthFromName(monthName) {
   if (typeof monthName === 'number') {
     if (isNaN(monthName) || monthName < 1 || monthName > 14) {
-      throw new RangeError(`Invalid month name: ${monthName}`);
+      throw new RangeError(`bad monthName: ${monthName}`);
     }
     return monthName;
   }
@@ -512,10 +513,10 @@ function monthFromName(monthName) {
       }
       break;
   }
-  throw new RangeError(`Unable to parse month name: ${monthName}`);
+  throw new RangeError(`bad monthName: ${monthName}`);
 }
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 const NISAN$3 = months.NISAN;
 const CHESHVAN = months.CHESHVAN;
 const KISLEV$1 = months.KISLEV;
@@ -610,10 +611,10 @@ function getBirthdayHD(hyear, date) {
   };
 }
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 const GERESH = '׳';
 const GERSHAYIM = '״';
-const alefbet = {
+const heb2num = {
   א: 1,
   ב: 2,
   ג: 3,
@@ -637,11 +638,9 @@ const alefbet = {
   ש: 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);
+const num2heb = {};
+for (const [key, val] of Object.entries(heb2num)) {
+  num2heb[val] = key;
 }
 function num2digits(num) {
   const digits = [];
@@ -676,29 +675,28 @@ function num2digits(num) {
  * gematriya(1123) // 'א׳קכ״ג'
  */
 function gematriya(num) {
-  const num0 = num;
-  const num1 = parseInt(num0, 10);
+  const num1 = parseInt(num, 10);
   if (!num1 || num1 < 0) {
-    throw new TypeError(`invalid gematriya number: ${num}`);
+    throw new TypeError(`invalid number: ${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 += num2heb[tdig];
     }
     str += GERESH;
   }
   const digits = num2digits(num1 % 1000);
   if (digits.length === 1) {
-    return str + num2heb.get(digits[0]) + GERESH;
+    return str + num2heb[digits[0]] + GERESH;
   }
   for (let i = 0; i < digits.length; i++) {
     if (i + 1 === digits.length) {
       str += GERSHAYIM;
     }
-    str += num2heb.get(digits[i]);
+    str += num2heb[digits[i]];
   }
   return str;
 }
@@ -718,7 +716,7 @@ function gematriyaStrToNum(str) {
     str = str.substring(gereshIdx);
   }
   for (const ch of str) {
-    const n = heb2num.get(ch);
+    const n = heb2num[ch];
     if (typeof n === 'number') {
       num += n;
     }
@@ -726,7 +724,7 @@ function gematriyaStrToNum(str) {
   return num;
 }
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 const sefirot = {
   en: {
     infix: 'within ',
@@ -901,7 +899,7 @@ function omerEmoji(omerDay) {
   return String.fromCodePoint(codePoint);
 }
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 
 /**
  * Calculates the molad for a Hebrew month
@@ -933,7 +931,7 @@ function molad(year, month) {
   };
 }
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 /**
  * Formats a number with leading zeros so the resulting string is 4 digits long.
  * Similar to `string.padStart(4, '0')` but will also format
@@ -963,7 +961,7 @@ function pad2(num) {
   return String(num);
 }
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 const _formatters = new Map();
 /**
  * @private
@@ -1019,7 +1017,7 @@ function isoDateString(dt) {
   return pad4(dt.getFullYear()) + '-' + pad2(dt.getMonth() + 1) + '-' + pad2(dt.getDate());
 }
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 var poAshkenazi$1 = {
   "headers": {
     "plural-forms": "nplurals=2; plural=(n > 1);",
@@ -1032,7 +1030,7 @@ var poAshkenazi$1 = {
   }
 };
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 var poHe$1 = {
   "headers": {
     "plural-forms": "nplurals=2; plural=(n > 1);",
@@ -1058,7 +1056,7 @@ var poHe$1 = {
   }
 };
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 const noopLocale = {
   headers: {
     'plural-forms': 'nplurals=2; plural=(n!=1);'
@@ -1269,7 +1267,7 @@ const poHeNoNikud$1 = {
 };
 Locale.addLocale('he-x-NoNikud', poHeNoNikud$1);
 
-/*! @hebcal/hdate v0.13.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.13.5, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 
 /*
     Hebcal - A Jewish Calendar Generator
@@ -1294,7 +1292,6 @@ Locale.addLocale('he-x-NoNikud', poHeNoNikud$1);
 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;
 }
@@ -1360,13 +1357,13 @@ class HDate {
       this.dd = this.mm = 1;
       const yy = typeof year === 'string' ? parseInt(year, 10) : year;
       if (isNaN(yy)) {
-        throw new TypeError(`HDate called with bad year argument: ${year}`);
+        throw new TypeError(`HDate called with bad year: ${year}`);
       }
       this.yy = yy;
       setMonth(this, month); // will throw if we can't parse
       const dd = typeof day === 'string' ? parseInt(day, 10) : day;
       if (isNaN(dd)) {
-        throw new TypeError(`HDate called with bad day argument: ${day}`);
+        throw new TypeError(`HDate called with bad day: ${day}`);
       }
       setDate(this, dd);
     } else {
@@ -1377,7 +1374,7 @@ class HDate {
       // 1 argument
       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}`);
+        throw new TypeError(`HDate called with bad arg: ${day}`);
       }
       const isNumber = typeof abs0 === 'number';
       const d = isNumber ? abs2hebrew(abs0) : abs0;
@@ -1799,7 +1796,7 @@ class HDate {
   static monthNum(month) {
     if (typeof month === 'number') {
       if (isNaN(month) || month > 14) {
-        throw new RangeError(`Invalid month number: ${month}`);
+        throw new RangeError(`bad monthNum: ${month}`);
       }
       return month;
     }
@@ -1848,7 +1845,7 @@ class HDate {
   static monthFromName(monthName) {
     if (typeof monthName === 'number') {
       if (isNaN(monthName) || monthName < 1 || monthName > 14) {
-        throw new RangeError(`Invalid month name: ${monthName}`);
+        throw new RangeError(`bad monthName: ${monthName}`);
       }
       return monthName;
     }
@@ -1892,7 +1889,7 @@ class HDate {
     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}"`);
+      throw new RangeError(`cannot parse gematriya str: "${str}"`);
     }
     const day = gematriyaStrToNum(parts[0]);
     const monthStr = numParts === 3 ? parts[1] : parts[1] + ' ' + parts[2];
@@ -11239,7 +11236,7 @@ class HolidayEvent extends Event {
 }
 /**
  * Because Asara B'Tevet often occurs twice in the same Gregorian year,
- * we subclass HolidayEvent to override the `url()` method.
+ * we subclass HolidayEvent to generate the correct URL.
  */
 class AsaraBTevetEvent extends HolidayEvent {
     urlDateSuffix() {
@@ -11247,6 +11244,20 @@ class AsaraBTevetEvent extends HolidayEvent {
         return isoDate.replace(/-/g, '');
     }
 }
+/**
+ * Because Chanukah sometimes starts in December and ends in January,
+ * we subclass HolidayEvent to generate the correct URL.
+ */
+class ChanukahEvent extends HolidayEvent {
+    urlDateSuffix() {
+        const dt = this.getDate().greg();
+        let year = dt.getFullYear();
+        if (dt.getMonth() === 0) {
+            year--;
+        }
+        return String(year);
+    }
+}
 /** Represents Rosh Hashana, the Jewish New Year */
 class RoshHashanaEvent extends HolidayEvent {
     /**
@@ -11430,7 +11441,7 @@ function makeTimedEvent(ev, time, desc, options) {
     const hd = ev.getDate();
     return new TimedEvent(hd, desc, ev.getFlags(), time, location, ev, options);
 }
-class TimedChanukahEvent extends HolidayEvent {
+class TimedChanukahEvent extends ChanukahEvent {
     constructor(date, desc, mask, eventTime, location) {
         super(date, desc, mask);
         this.eventTime = Zmanim.roundTime(eventTime);
@@ -12725,12 +12736,12 @@ function getHolidaysForYear_(year) {
     // 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, {
+        add(new ChanukahEvent(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 ChanukahEvent(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));
     const pesachAbs = pesach.abs();
     add(new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$1, pesachAbs - 43)), holidayDesc.SHABBAT_SHEKALIM, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(HDate.dayOnOrBefore(SAT$1, pesachAbs - 30)), holidayDesc.SHABBAT_ZACHOR, SPECIAL_SHABBAT$1), new HolidayEvent(new HDate(pesachAbs - (pesach.getDay() === TUE ? 33 : 31)), holidayDesc.TAANIT_ESTHER, MINOR_FAST$1));