@hebcal/core 5.4.10 → 5.5.0

package/dist/bundle.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v5.4.10 */
+/*! @hebcal/core v5.5.0 */
 var hebcal = (function (exports) {
 'use strict';
 
@@ -139,15 +139,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;
 /**
@@ -157,31 +157,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 = ['', 'Nisan', 'Iyyar', 'Sivan', 'Tamuz', 'Av', 'Elul', 'Tishrei', 'Cheshvan', 'Kislev', 'Tevet', "Sh'vat"];
 /**
@@ -420,74 +420,74 @@ 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;
+          return ADAR_II$2;
       }
       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;
+          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;
   }
@@ -514,13 +514,12 @@ function isSimpleHebrewDate$1(obj) {
 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) {
@@ -656,8 +655,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);
@@ -908,6 +907,35 @@ 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
@@ -956,34 +984,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
  */
@@ -1046,6 +1046,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
@@ -1087,13 +1109,11 @@ 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.
@@ -1102,15 +1122,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) {
@@ -1119,7 +1133,7 @@ class Locale {
         throw new TypeError(`Invalid translation array: ${translation}`);
       }
     } else if (typeof translation !== 'string') {
-      throw new TypeError(`Invalid translation: ${translation}`);
+      throw new TypeError(`Invalid translation string: ${translation}`);
     }
     loc[id] = isArray ? translation : [translation];
   }
@@ -1129,13 +1143,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`);
     }
@@ -1149,11 +1157,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;
@@ -1179,31 +1184,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
@@ -1388,7 +1386,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());
@@ -1626,7 +1624,8 @@ class HDate {
       return new HDate(this.abs() + 7 * amount);
     } 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);
@@ -1634,8 +1633,6 @@ class HDate {
         hd = new HDate(hd.abs() + sign * hd.daysInMonth());
       }
       return hd;
-    } else {
-      throw new TypeError(`Invalid units '${units}'`);
     }
   }
   /**
@@ -1678,9 +1675,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();
   }
   /**
@@ -1692,10 +1686,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
@@ -2302,7 +2293,7 @@ var check = function (it) {
 };
 
 // https://github.com/zloirock/core-js/issues/86#issuecomment-115759028
-var global$a =
+var globalThis_1 =
   // eslint-disable-next-line es/no-global-this -- safe
   check(typeof globalThis == 'object' && globalThis) ||
   check(typeof window == 'object' && window) ||
@@ -2453,7 +2444,7 @@ var isObject$5 = function (it) {
   return typeof it == 'object' ? it !== null : isCallable$9(it);
 };
 
-var global$9 = global$a;
+var globalThis$b = globalThis_1;
 var isCallable$8 = isCallable$a;
 
 var aFunction = function (argument) {
@@ -2461,20 +2452,25 @@ var aFunction = function (argument) {
 };
 
 var getBuiltIn$3 = function (namespace, method) {
-  return arguments.length < 2 ? aFunction(global$9[namespace]) : global$9[namespace] && global$9[namespace][method];
+  return arguments.length < 2 ? aFunction(globalThis$b[namespace]) : globalThis$b[namespace] && globalThis$b[namespace][method];
 };
 
 var uncurryThis$6 = functionUncurryThis;
 
 var objectIsPrototypeOf = uncurryThis$6({}.isPrototypeOf);
 
-var engineUserAgent = typeof navigator != 'undefined' && String(navigator.userAgent) || '';
+var globalThis$a = globalThis_1;
 
-var global$8 = global$a;
-var userAgent = engineUserAgent;
+var navigator = globalThis$a.navigator;
+var userAgent$1 = navigator && navigator.userAgent;
 
-var process = global$8.process;
-var Deno = global$8.Deno;
+var environmentUserAgent = userAgent$1 ? String(userAgent$1) : '';
+
+var globalThis$9 = globalThis_1;
+var userAgent = environmentUserAgent;
+
+var process = globalThis$9.process;
+var Deno = globalThis$9.Deno;
 var versions = process && process.versions || Deno && Deno.version;
 var v8 = versions && versions.v8;
 var match, version$1;
@@ -2496,14 +2492,14 @@ if (!version$1 && userAgent) {
   }
 }
 
-var engineV8Version = version$1;
+var environmentV8Version = version$1;
 
 /* eslint-disable es/no-symbol -- required for testing */
-var V8_VERSION = engineV8Version;
+var V8_VERSION = environmentV8Version;
 var fails$5 = fails$9;
-var global$7 = global$a;
+var globalThis$8 = globalThis_1;
 
-var $String$3 = global$7.String;
+var $String$3 = globalThis$8.String;
 
 // eslint-disable-next-line es/no-object-getownpropertysymbols -- required for testing
 var symbolConstructorDetection = !!Object.getOwnPropertySymbols && !fails$5(function () {
@@ -2587,30 +2583,30 @@ var ordinaryToPrimitive$1 = function (input, pref) {
 
 var sharedStore = {exports: {}};
 
-var global$6 = global$a;
+var globalThis$7 = globalThis_1;
 
 // eslint-disable-next-line es/no-object-defineproperty -- safe
 var defineProperty$2 = Object.defineProperty;
 
 var defineGlobalProperty$3 = function (key, value) {
   try {
-    defineProperty$2(global$6, key, { value: value, configurable: true, writable: true });
+    defineProperty$2(globalThis$7, key, { value: value, configurable: true, writable: true });
   } catch (error) {
-    global$6[key] = value;
+    globalThis$7[key] = value;
   } return value;
 };
 
-var globalThis$1 = global$a;
+var globalThis$6 = globalThis_1;
 var defineGlobalProperty$2 = defineGlobalProperty$3;
 
 var SHARED = '__core-js_shared__';
-var store$3 = sharedStore.exports = globalThis$1[SHARED] || defineGlobalProperty$2(SHARED, {});
+var store$3 = sharedStore.exports = globalThis$6[SHARED] || defineGlobalProperty$2(SHARED, {});
 
 (store$3.versions || (store$3.versions = [])).push({
-  version: '3.37.1',
+  version: '3.38.1',
   mode: 'global',
   copyright: '© 2014-2024 Denis Pushkarev (zloirock.ru)',
-  license: 'https://github.com/zloirock/core-js/blob/v3.37.1/LICENSE',
+  license: 'https://github.com/zloirock/core-js/blob/v3.38.1/LICENSE',
   source: 'https://github.com/zloirock/core-js'
 });
 
@@ -2654,14 +2650,14 @@ var uid$2 = function (key) {
   return 'Symbol(' + (key === undefined ? '' : key) + ')_' + toString$1(++id + postfix, 36);
 };
 
-var global$5 = global$a;
+var globalThis$5 = globalThis_1;
 var shared$2 = shared$3;
 var hasOwn$6 = hasOwnProperty_1;
 var uid$1 = uid$2;
 var NATIVE_SYMBOL = symbolConstructorDetection;
 var USE_SYMBOL_AS_UID = useSymbolAsUid;
 
-var Symbol$1 = global$5.Symbol;
+var Symbol$1 = globalThis$5.Symbol;
 var WellKnownSymbolsStore = shared$2('wks');
 var createWellKnownSymbol = USE_SYMBOL_AS_UID ? Symbol$1['for'] || Symbol$1 : Symbol$1 && Symbol$1.withoutSetter || uid$1;
 
@@ -2709,10 +2705,10 @@ var toPropertyKey$2 = function (argument) {
   return isSymbol(key) ? key : key + '';
 };
 
-var global$4 = global$a;
+var globalThis$4 = globalThis_1;
 var isObject$2 = isObject$5;
 
-var document$1 = global$4.document;
+var document$1 = globalThis$4.document;
 // typeof document.createElement is 'object' in old IE
 var EXISTS$1 = isObject$2(document$1) && isObject$2(document$1.createElement);
 
@@ -2871,10 +2867,10 @@ if (!isCallable$4(store$1.inspectSource)) {
 
 var inspectSource$1 = store$1.inspectSource;
 
-var global$3 = global$a;
+var globalThis$3 = globalThis_1;
 var isCallable$3 = isCallable$a;
 
-var WeakMap$2 = global$3.WeakMap;
+var WeakMap$2 = globalThis$3.WeakMap;
 
 var weakMapBasicDetection = isCallable$3(WeakMap$2) && /native code/.test(String(WeakMap$2));
 
@@ -2890,7 +2886,7 @@ var sharedKey$2 = function (key) {
 var hiddenKeys$4 = {};
 
 var NATIVE_WEAK_MAP = weakMapBasicDetection;
-var global$2 = global$a;
+var globalThis$2 = globalThis_1;
 var isObject = isObject$5;
 var createNonEnumerableProperty$1 = createNonEnumerableProperty$2;
 var hasOwn$3 = hasOwnProperty_1;
@@ -2899,8 +2895,8 @@ var sharedKey$1 = sharedKey$2;
 var hiddenKeys$3 = hiddenKeys$4;
 
 var OBJECT_ALREADY_INITIALIZED = 'Object already initialized';
-var TypeError$1 = global$2.TypeError;
-var WeakMap$1 = global$2.WeakMap;
+var TypeError$1 = globalThis$2.TypeError;
+var WeakMap$1 = globalThis$2.WeakMap;
 var set, get, has;
 
 var enforce = function (it) {
@@ -3238,7 +3234,7 @@ var POLYFILL = isForced$1.POLYFILL = 'P';
 
 var isForced_1 = isForced$1;
 
-var global$1 = global$a;
+var globalThis$1 = globalThis_1;
 var getOwnPropertyDescriptor = objectGetOwnPropertyDescriptor.f;
 var createNonEnumerableProperty = createNonEnumerableProperty$2;
 var defineBuiltIn = defineBuiltIn$1;
@@ -3267,11 +3263,11 @@ var _export = function (options, source) {
   var STATIC = options.stat;
   var FORCED, target, key, targetProperty, sourceProperty, descriptor;
   if (GLOBAL) {
-    target = global$1;
+    target = globalThis$1;
   } else if (STATIC) {
-    target = global$1[TARGET] || defineGlobalProperty(TARGET, {});
+    target = globalThis$1[TARGET] || defineGlobalProperty(TARGET, {});
   } else {
-    target = global$1[TARGET] && global$1[TARGET].prototype;
+    target = globalThis$1[TARGET] && globalThis$1[TARGET].prototype;
   }
   if (target) for (key in source) {
     sourceProperty = source[key];
@@ -3356,7 +3352,8 @@ var NullProtoObjectViaActiveX = function (activeXDocument) {
   activeXDocument.write(scriptTag(''));
   activeXDocument.close();
   var temp = activeXDocument.parentWindow.Object;
-  activeXDocument = null; // avoid memory leak
+  // eslint-disable-next-line no-useless-assignment -- avoid memory leak
+  activeXDocument = null;
   return temp;
 };
 
@@ -6400,7 +6397,7 @@ const expectedInteger = (e, n) => `Non-integer ${e}: ${n}`,
   Ta = "UTC",
   Da = 5184e3,
   Ia = /*@__PURE__*/isoArgsToEpochSec(1847),
-  Ma = /*@__PURE__*/isoArgsToEpochSec( /*@__PURE__*/( /*@__PURE__*/new Date()).getUTCFullYear() + 10),
+  Ma = /*@__PURE__*/isoArgsToEpochSec(/*@__PURE__*/(/*@__PURE__*/new Date()).getUTCFullYear() + 10),
   Na = /0+$/,
   fn = /*@__PURE__*/Jn(_zonedEpochSlotsToIso, WeakMap),
   ya = 2 ** 32 - 1,
@@ -6746,7 +6743,7 @@ const Pa = "([+−-])",
       return [];
     }
   },
-  Y = /*@__PURE__*/createNativeOpsCreator( /*@__PURE__*/Object.assign({}, Va, Ja, {
+  Y = /*@__PURE__*/createNativeOpsCreator(/*@__PURE__*/Object.assign({}, Va, Ja, {
     h: computeIsoDateParts,
     ee(e) {
       return this.id === gi ? computeGregoryEraParts(e) : this.id === Ti ? Gi(e) : [];
@@ -9181,6 +9178,7 @@ class Location extends GeoLocation {
      * @param dst single char 'Y' or 'N'
      */
     static getUsaTzid(state, tz, dst) {
+        tz = +tz;
         if (tz === 10 && state === 'AK') {
             return 'America/Adak';
         }
@@ -9748,6 +9746,40 @@ class Zmanim {
         }
         return new Date(sunset.getTime() + offset * 60 * 1000);
     }
+    /**
+     * Returns the Hebrew date relative to the specified location and Gregorian date,
+     * taking into consideration whether the time is before or after sunset.
+     *
+     * For example, if the given date and is `2024-09-22T10:35` (before sunset), and
+     * sunset for the specified location is **19:04**, then this function would
+     * return a Hebrew date of `19th of Elul, 5784`.
+     * If the given date is the same Gregorian day after sunset
+     * (for example `2024-09-22T20:07`), this function would return a
+     * Hebrew date of `20th of Elul, 5784`.
+     * @example
+     * const {GeoLocation, Zmanim, HDate} = require('@hebcal/core');
+     * const latitude = 48.85341;
+     * const longitude = 2.3488;
+     * const timezone = 'Europe/Paris';
+     * const gloc = new GeoLocation(null, latitude, longitude, 0, timezone);
+     * const before = Zmanim.makeSunsetAwareHDate(gloc, new Date('2024-09-22T17:38:46.123Z'), false);
+     * console.log(before.toString()); // '19 Elul 5784'
+     * const after = Zmanim.makeSunsetAwareHDate(gloc, new Date('2024-09-22T23:45:18.345Z'), false);
+     * console.log(after.toString()); // '20 Elul 5784'
+     */
+    static makeSunsetAwareHDate(gloc, date, useElevation) {
+        const zmanim = new Zmanim(gloc, date, useElevation);
+        const sunset = zmanim.sunset();
+        let hd = new HDate(date);
+        const sunsetMillis = sunset.getTime();
+        if (isNaN(sunsetMillis)) {
+            return hd;
+        }
+        if (date.getTime() >= sunsetMillis) {
+            hd = hd.next();
+        }
+        return hd;
+    }
 }
 
 const hour12cc = {
@@ -11693,7 +11725,7 @@ class DailyLearning {
 }
 
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-const version = '5.4.10';
+const version = '5.5.0';
 
 /* eslint-disable max-len */
 /**