@hebcal/core 5.4.2 → 5.4.4

package/dist/HebrewDateEvent.d.ts

@@ -1,6 +1,6 @@
 import { HDate } from '@hebcal/hdate';
 import { Event } from './event';
-import '../src/locale';
+import './locale';
 /** Daily Hebrew date ("11th of Sivan, 5780") */
 export declare class HebrewDateEvent extends Event {
     /**

package/dist/HolidayEvent.d.ts

@@ -1,7 +1,7 @@
 import { HDate } from '@hebcal/hdate';
 import { Event } from './event';
 import { TimedEvent } from './TimedEvent';
-import '../src/locale';
+import './locale';
 /** Represents a built-in holiday like Pesach, Purim or Tu BiShvat */
 export declare class HolidayEvent extends Event {
     /** During Sukkot or Pesach */

package/dist/MevarchimChodeshEvent.d.ts

@@ -1,6 +1,6 @@
 import { HDate } from '@hebcal/hdate';
 import { Event } from './event';
-import '../src/locale';
+import './locale';
 /** Represents Mevarchim haChodesh, the announcement of the new month */
 export declare class MevarchimChodeshEvent extends Event {
     readonly monthName: string;

package/dist/ParshaEvent.d.ts

@@ -1,6 +1,6 @@
 import { Event } from './event';
 import { HDate } from '@hebcal/hdate';
-import '../src/locale';
+import './locale';
 /**
  * Represents one of 54 weekly Torah portions, always on a Saturday
  */

package/dist/TimedEvent.d.ts

@@ -2,7 +2,7 @@ import { HDate } from '@hebcal/hdate';
 import { CalOptions } from './CalOptions';
 import { Location } from './location';
 import { Event } from './event';
-import '../src/locale';
+import './locale';
 /** An event that has an `eventTime` and `eventTimeStr` */
 export declare class TimedEvent extends Event {
     readonly eventTime: Date;

package/dist/YomKippurKatanEvent.d.ts

@@ -1,6 +1,6 @@
 import { HDate } from '@hebcal/hdate';
 import { HolidayEvent } from './HolidayEvent';
-import '../src/locale';
+import './locale';
 export declare const ykk = "Yom Kippur Katan";
 /** YKK is minor day of atonement on the day preceeding each Rosh Chodesh */
 export declare class YomKippurKatanEvent extends HolidayEvent {

package/dist/bundle.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v5.4.2 */
+/*! @hebcal/core v5.4.4 */
 var hebcal = (function (exports) {
 'use strict';
 
@@ -9432,6 +9432,12 @@ class Zmanim {
     }
     /**
      * Latest Shacharit (Gra); Sunrise plus 4 halachic hours, according to the Gra.
+     *
+     * This method returns the latest *zman tfila* (time to recite shema in the morning)
+     * that is 4 *shaos zmaniyos* (solar hours) after sunrise or sea level sunrise
+     * (depending on the `useElevation` setting), according
+     * to the [GRA](https://en.wikipedia.org/wiki/Vilna_Gaon).
+     *
      * If elevation is enabled, this function will include elevation in the calculation.
      * @return {Date}
      */
@@ -9441,19 +9447,16 @@ class Zmanim {
     /**
      * Returns an array with alot (Date) and ms in hour (number)
      * @private
-     * @return {any[]}
      */
-    getTemporalHour72() {
-        const alot72 = this.sunriseOffset(-72, false, true);
-        const tzeit72 = this.sunsetOffset(72, false, true);
+    getTemporalHour72(forceSeaLevel) {
+        const alot72 = this.sunriseOffset(-72, false, forceSeaLevel);
+        const tzeit72 = this.sunsetOffset(72, false, forceSeaLevel);
         const temporalHour = (tzeit72.getTime() - alot72.getTime()) / 12;
         return [alot72, temporalHour];
     }
     /**
      * Returns an array with alot (Date) and ms in hour (number)
      * @private
-     * @param {number} angle
-     * @return {any[]}
      */
     getTemporalHourByDeg(angle) {
         const alot = this.timeAtAngle(angle, true);
@@ -9469,8 +9472,9 @@ class Zmanim {
      * @return {Date}
      */
     sofZmanShmaMGA() {
-        const [alot72, temporalHour] = this.getTemporalHour72();
-        return new Date(alot72.getTime() + (3 * temporalHour));
+        const [alot72, temporalHour] = this.getTemporalHour72(true);
+        const offset = Math.floor(3 * temporalHour);
+        return new Date(alot72.getTime() + offset);
     }
     /**
      * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
@@ -9480,7 +9484,8 @@ class Zmanim {
      */
     sofZmanShmaMGA16Point1() {
         const [alot, temporalHour] = this.getTemporalHourByDeg(16.1);
-        return new Date(alot.getTime() + (3 * temporalHour));
+        const offset = Math.floor(3 * temporalHour);
+        return new Date(alot.getTime() + offset);
     }
     /**
      * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
@@ -9494,15 +9499,17 @@ class Zmanim {
      */
     sofZmanShmaMGA19Point8() {
         const [alot, temporalHour] = this.getTemporalHourByDeg(19.8);
-        return new Date(alot.getTime() + (3 * temporalHour));
+        const offset = Math.floor(3 * temporalHour);
+        return new Date(alot.getTime() + offset);
     }
     /**
      * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham
      * @return {Date}
      */
     sofZmanTfillaMGA() {
-        const [alot72, temporalHour] = this.getTemporalHour72();
-        return new Date(alot72.getTime() + (4 * temporalHour));
+        const [alot72, temporalHour] = this.getTemporalHour72(true);
+        const offset = Math.floor(4 * temporalHour);
+        return new Date(alot72.getTime() + offset);
     }
     /**
      * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
@@ -9512,7 +9519,8 @@ class Zmanim {
      */
     sofZmanTfillaMGA16Point1() {
         const [alot, temporalHour] = this.getTemporalHourByDeg(16.1);
-        return new Date(alot.getTime() + (4 * temporalHour));
+        const offset = Math.floor(4 * temporalHour);
+        return new Date(alot.getTime() + offset);
     }
     /**
      * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
@@ -9526,24 +9534,67 @@ class Zmanim {
      */
     sofZmanTfillaMGA19Point8() {
         const [alot, temporalHour] = this.getTemporalHourByDeg(19.8);
-        return new Date(alot.getTime() + (4 * temporalHour));
+        const offset = Math.floor(4 * temporalHour);
+        return new Date(alot.getTime() + offset);
     }
     /**
-     * Earliest Mincha – Mincha Gedola; Sunrise plus 6.5 halachic hours.
+     * Earliest Mincha – Mincha Gedola (GRA); Sunrise plus 6.5 halachic hours.
      * If elevation is enabled, this function will include elevation in the calculation.
+     *
+     * This method returns the latest mincha gedola, the earliest time one can pray mincha
+     * that is 6.5 shaos zmaniyos (solar hours) after sunrise or sea level sunrise
+     * (depending on the `useElevation` setting), according
+     * to the [GRA](https://en.wikipedia.org/wiki/Vilna_Gaon).
+     *
+     * The Ramba"m is of the opinion that it is better to delay *mincha* until
+     * *mincha ketana* while the Ra"sh, Tur, GRA and others are of the
+     * opinion that *mincha* can be prayed *lechatchila* starting at *mincha gedola*.
      * @return {Date}
      */
     minchaGedola() {
         return this.getShaahZmanisBasedZman(6.5);
     }
+    /**
+     * Earliest Mincha – Mincha Gedola (MGA); Sunrise plus 6.5 halachic hours.
+     * If elevation is enabled, this function will include elevation in the calculation.
+     *
+     * This method returns the time of *mincha gedola* according to the Magen Avraham
+     * with the day starting 72 minutes before sunrise and ending 72 minutes after sunset.
+     * This is the earliest time to pray *mincha*.
+     * @return {Date}
+     */
+    minchaGedolaMGA() {
+        const [alot72, temporalHour] = this.getTemporalHour72(false);
+        const offset = Math.floor(6.5 * temporalHour);
+        return new Date(alot72.getTime() + offset);
+    }
     /**
      * Preferable earliest time to recite Minchah – Mincha Ketana; Sunrise plus 9.5 halachic hours.
      * If elevation is enabled, this function will include elevation in the calculation.
+     *
+     * This method returns *mincha ketana*, the preferred earliest time to pray *mincha* in the
+     * opinion of the [Rambam](https://en.wikipedia.org/wiki/Maimonides) and others,
+     * that is 9.5 *shaos zmaniyos* (solar hours) after sunrise or sea level sunrise
+     * (depending on the `useElevation` setting), according
+     * to the [GRA](https://en.wikipedia.org/wiki/Vilna_Gaon).
      * @return {Date}
      */
     minchaKetana() {
         return this.getShaahZmanisBasedZman(9.5);
     }
+    /**
+     * This method returns the time of *mincha ketana* according to the Magen Avraham
+     * with the day starting 72 minutes before sunrise and ending 72 minutes after sunset.
+     * This is the preferred earliest time to pray *mincha* according to the opinion of
+     * the [Rambam](https://en.wikipedia.org/wiki/Maimonides) and others.
+     *
+     * If elevation is enabled, this function will include elevation in the calculation.
+     * @return {Date}
+     */
+    minchaKetanaMGA() {
+        const [alot72, temporalHour] = this.getTemporalHour72(false);
+        return new Date(alot72.getTime() + Math.floor(9.5 * temporalHour));
+    }
     /**
      * Plag haMincha; Sunrise plus 10.75 halachic hours.
      * If elevation is enabled, this function will include elevation in the calculation.
@@ -10486,7 +10537,7 @@ class Sedra {
         const weekNum = (saturday - this.firstSaturday) / 7;
         const index = this.theSedraArray[weekNum];
         if (typeof index === 'undefined') {
-            const sedra = new Sedra(this.year + 1, this.il);
+            const sedra = getSedra_(this.year + 1, this.il);
             return sedra.lookup(saturday); // must be next year
         }
         if (typeof index === 'string') {
@@ -11375,7 +11426,7 @@ class DailyLearning {
 }
 
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-const version = '5.4.2';
+const version = '5.4.4';
 
 /* eslint-disable max-len */
 /**
@@ -12231,20 +12282,7 @@ function checkCandleOptions(options) {
     }
     let min = Number(options.candleLightingMins) || 18;
     if (location.getIsrael() && Math.abs(min) === 18) {
-        const geoid = location.getGeoId();
-        if (geoid) {
-            const offset = geoIdCandleOffset[geoid];
-            if (typeof offset === 'number') {
-                min = offset;
-            }
-        }
-        const shortName = location.getShortName();
-        if (shortName) {
-            const offset = israelCityOffset[shortName];
-            if (typeof offset === 'number') {
-                min = offset;
-            }
-        }
+        min = overrideIsraelCandleMins(location, min);
     }
     options.candleLightingMins = -1 * Math.abs(min);
     if (typeof options.havdalahMins === 'number') {
@@ -12260,6 +12298,23 @@ function checkCandleOptions(options) {
         options.fastEndDeg = TZEIT_3MEDIUM_STARS;
     }
 }
+function overrideIsraelCandleMins(location, min) {
+    const geoid = location.getGeoId();
+    if (geoid) {
+        const offset = geoIdCandleOffset[geoid];
+        if (typeof offset === 'number') {
+            return offset;
+        }
+    }
+    const shortName = location.getShortName();
+    if (shortName) {
+        const offset = israelCityOffset[shortName];
+        if (typeof offset === 'number') {
+            return offset;
+        }
+    }
+    return min;
+}
 /**
  * Mask to filter Holiday array
  * @private