@hebcal/core 6.14.0 → 6.14.2

package/dist/bundle.js

@@ -1,11 +1,11 @@
-/*! @hebcal/core v6.14.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.14.2, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 var hebcal = (function (exports) {
 'use strict';
 
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-const version = '6.14.0';
+const version = '6.14.2';
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 /**
  * Days per Gregorian month (1-based), indexed first by `+isGregLeapYear()`.
  * @private
@@ -191,7 +191,7 @@ function abs2greg(abs) {
     return dt;
 }
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 /**
  * Gregorian date helper functions.
  *
@@ -219,7 +219,7 @@ const greg = {
     isLeapYear: isGregLeapYear,
 };
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 /**
  * Removes niqqud from Hebrew string
  * @example
@@ -235,7 +235,7 @@ function hebrewStripNikkud(str) {
     return a.replace(/[\u0590-\u05bd]/g, '').replace(/[\u05bf-\u05c7]/g, '');
 }
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 /*
  * More minimal HDate
  */
@@ -805,7 +805,7 @@ function monthFromName(monthName) {
     throw new RangeError(`bad monthName: ${monthName}`);
 }
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 const NISAN$5 = months.NISAN;
 const CHESHVAN$2 = months.CHESHVAN;
 const KISLEV$1 = months.KISLEV;
@@ -1024,7 +1024,7 @@ function getBirthdayHD(hyear, date) {
     return { yy: hyear, mm: month, dd: day };
 }
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 const GERESH = '׳';
 const GERSHAYIM = '״';
 const heb2num = {
@@ -1159,7 +1159,7 @@ function gematriyaStrToNum(str) {
     return num;
 }
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later 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
@@ -1199,7 +1199,7 @@ function pad2(num) {
     return String(num);
 }
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 const _formatters = new Map();
 /**
  * @private
@@ -1280,13 +1280,13 @@ function isoDateString(dt) {
         pad2(dt.getDate()));
 }
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 var poAshkenazi$1 = { "headers": { "plural-forms": "nplurals=2; plural=(n > 1);", "language": "und-x-ashkenaz" }, "contexts": { "": { "Tevet": ["Teves"] } } };
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 var poHe$1 = { "headers": { "plural-forms": "nplurals=2; plural=(n > 1);", "language": "he" }, "contexts": { "": { "Adar": ["אֲדָר"], "Adar I": ["אֲדָר א׳"], "Adar II": ["אֲדָר ב׳"], "Av": ["אָב"], "Cheshvan": ["חֶשְׁוָן"], "Elul": ["אֱלוּל"], "Iyyar": ["אִיָּיר"], "Kislev": ["כִּסְלֵו"], "Nisan": ["נִיסָן"], "Sh'vat": ["שְׁבָט"], "Sivan": ["סִיוָן"], "Tamuz": ["תַּמּוּז"], "Tammuz": ["תַּמּוּז"], "Tevet": ["טֵבֵת"], "Tishrei": ["תִּשְׁרֵי"] } } };
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 const noopLocale = {
     headers: { 'plural-forms': 'nplurals=2; plural=(n!=1);' },
     contexts: { '': {} },
@@ -1570,7 +1570,7 @@ Locale.addLocale('he', poHe$1);
 const poHeNoNikud$1 = Locale.copyLocaleNoNikud(poHe$1);
 Locale.addLocale('he-x-NoNikud', poHeNoNikud$1);
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 /*
     Hebcal - A Jewish Calendar Generator
     Copyright (c) 1994-2020 Danny Sadinoff
@@ -2406,7 +2406,7 @@ function onOrBefore(day, t, offset) {
     return new HDate(HDate.dayOnOrBefore(day, t.abs() + offset));
 }
 
-/*! @hebcal/hdate v0.23.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/hdate v0.23.1, distributed under GPLv2 or later https://www.gnu.org/licenses/gpl-2.0.txt */
 /**
  * Calculates yahrzeit, the anniversary of a death, and returns it as an
  * {@link HDate}.
@@ -7704,6 +7704,60 @@ class GeoLocation {
         }
         this.timeZoneId = timeZoneId;
     }
+    /**
+     * A method that will return the location's local mean time offset in milliseconds from local
+     * [standard time](https://en.wikipedia.org/wiki/Standard_time). The globe is split into 360°, with
+     * 15° per hour of the day. For a local that is at a longitude that is evenly divisible by 15
+     * (longitude % 15 == 0), at solar noon (with adjustment for the
+     * [equation of time](https://en.wikipedia.org/wiki/Equation_of_time)) the sun should be directly overhead,
+     * so a user who is 1° west of this will have noon at 4 minutes after standard time noon, and conversely,
+     * a user who is 1° east of the 15° longitude will have noon at 11:56 AM.
+     * @param instant the instant at which to read the time zone offset (DST is taken into account)
+     * @return the offset in milliseconds not accounting for Daylight saving time. A positive value will be returned
+     *         East of the 15° timezone line, and a negative value West of it.
+     */
+    getLocalMeanTimeOffset(instant) {
+        const timezoneOffsetMillis = instant.toZonedDateTimeISO(this.timeZoneId).offsetNanoseconds / 1e6;
+        return this.longitude * 4 * 60 * 1000 - timezoneOffsetMillis;
+    }
+    /**
+     * Adjust the date for [antimeridian](https://en.wikipedia.org/wiki/180th_meridian) crossover. This is
+     * needed to deal with edge cases such as Samoa that use a different calendar date than expected based on their
+     * geographic location.
+     *
+     * The actual Time Zone offset may deviate from the expected offset based on the longitude. Since the 'absolute time'
+     * calculations are always based on longitudinal offset from UTC for a given date, the date is presumed to only
+     * increase East of the Prime Meridian, and to only decrease West of it. For Time Zones that cross the antimeridian,
+     * the date will be artificially adjusted before calculation to conform with this presumption.
+     *
+     * For example, Apia, Samoa with a longitude of -171.75 uses a local offset of +14:00. When calculating sunrise for
+     * 2018-02-03, the calculator should operate using 2018-02-02 since the expected zone is -11. After determining the
+     * UTC time, the local DST offset of [UTC+14:00](https://en.wikipedia.org/wiki/UTC%2B14:00) should be applied
+     * to bring the date back to 2018-02-03.
+     * @param date the date, at the start of which (in this location's time zone) the offset is read
+     * @return the number of days to adjust the date This will typically be 0 unless the date crosses the antimeridian
+     */
+    getAntimeridianAdjustment(date) {
+        // Time zone offsets range from -12:00 to +14:00, so an offset of 20 hours
+        // or more needs a longitude of at least 120 degrees east or 90 degrees
+        // west. Skip resolving the time zone for the rest of the world.
+        if (this.longitude > -90 && this.longitude < 120) {
+            return 0;
+        }
+        const midnight = date.toZonedDateTime(this.timeZoneId).toInstant();
+        const localHoursOffset = this.getLocalMeanTimeOffset(midnight) / 3600000;
+        if (localHoursOffset >= 20) {
+            // a location far east using a time zone from across the antimeridian to
+            // the west (none are known today, but better safe than sorry)
+            return 1; // roll the date forward a day
+        }
+        else if (localHoursOffset <= -20) {
+            // a location far west using a time zone from across the antimeridian to
+            // the east, such as Samoa or Kiritimati
+            return -1; // roll the date back a day
+        }
+        return 0; // 99.999% of the world will have no adjustment
+    }
 }
 /**
  * The commonly used average solar refraction. Calendrical Calculations lists a more accurate global average of
@@ -8056,8 +8110,15 @@ class NOAACalculator {
      * @return the adjusted Calendar
      */
     getAdjustedDate() {
-        return this.date;
+        if (this.adjustedDate === undefined) {
+            const offset = this.geoLocation.getAntimeridianAdjustment(this.date);
+            this.adjustedDate =
+                offset === 0 ? this.date : this.date.add({ days: offset });
+        }
+        return this.adjustedDate;
     }
+    /** Memoized result of {@link getAdjustedDate} */
+    adjustedDate;
     /**
      * Method to return the adjustment to the zenith required to account for the elevation. Since a person at a higher
      * elevation can see farther below the horizon, the calculation for sunrise / sunset is calculated below the horizon
@@ -8337,8 +8398,11 @@ class NOAACalculator {
             year -= 1;
             month += 12;
         }
+        // Integer division, as in the Java original: truncating `2 - a + a / 4`
+        // as a whole is off by one day whenever `a` is not a multiple of 4
+        // (e.g. every year from 1900 through 1999).
         const a = Math.trunc(year / 100);
-        const b = Math.trunc(2 - a + a / 4);
+        const b = 2 - a + Math.trunc(a / 4);
         return (Math.floor(365.25 * (year + 4716)) +
             Math.floor(30.6001 * (month + 1)) +
             day +