@hebcal/core 5.0.7 → 5.0.9

package/README.md

@@ -167,17 +167,6 @@ parshiot[0] == 'Bereshit', parshiot[1] == 'Noach', parshiot[53]
 ## Functions
 
 <dl>
-<dt><a href="#gematriya">gematriya(number)</a> ⇒ <code>string</code></dt>
-<dd><p>Converts a numerical value to a string of Hebrew letters.</p>
-<p>When specifying years of the Hebrew calendar in the present millennium,
-we omit the thousands (which is presently 5 [ה]).</p>
-</dd>
-<dt><a href="#gematriyaStrToNum">gematriyaStrToNum(str)</a> ⇒ <code>number</code></dt>
-<dd><p>Converts a string of Hebrew letters to a numerical value.</p>
-<p>Only considers the value of Hebrew letters <code>א</code> through <code>ת</code>.
-Ignores final Hebrew letters such as <code>ך</code> (kaf sofit) or <code>ם</code> (mem sofit)
-and vowels (nekudot).</p>
-</dd>
 <dt><a href="#hebrew2abs">hebrew2abs(year, month, day)</a> ⇒ <code>number</code></dt>
 <dd><p>Converts Hebrew date to R.D. (Rata Die) fixed days.
 R.D. 1 is the imaginary date Monday, January 1, 1 on the Gregorian
@@ -217,6 +206,17 @@ A leap Hebrew calendar year can have a length of 383, 384 or 385 days</p>
 <dt><a href="#monthFromName">monthFromName(monthName)</a> ⇒ <code>number</code></dt>
 <dd><p>Converts Hebrew month string name to numeric</p>
 </dd>
+<dt><a href="#gematriya">gematriya(num)</a> ⇒ <code>string</code></dt>
+<dd><p>Converts a numerical value to a string of Hebrew letters.</p>
+<p>When specifying years of the Hebrew calendar in the present millennium,
+we omit the thousands (which is presently 5 [ה]).</p>
+</dd>
+<dt><a href="#gematriyaStrToNum">gematriyaStrToNum(str)</a> ⇒ <code>number</code></dt>
+<dd><p>Converts a string of Hebrew letters to a numerical value.</p>
+<p>Only considers the value of Hebrew letters <code>א</code> through <code>ת</code>.
+Ignores final Hebrew letters such as <code>ך</code> (kaf sofit) or <code>ם</code> (mem sofit)
+and vowels (nekudot).</p>
+</dd>
 </dl>
 
 ## Typedefs
@@ -1916,7 +1916,9 @@ https://gml.noaa.gov/grad/solcalc/calcdetails.html
         * [.sofZmanShma()](#Zmanim+sofZmanShma) ⇒ <code>Date</code>
         * [.sofZmanTfilla()](#Zmanim+sofZmanTfilla) ⇒ <code>Date</code>
         * [.sofZmanShmaMGA()](#Zmanim+sofZmanShmaMGA) ⇒ <code>Date</code>
+        * [.sofZmanShmaMGA16Point1()](#Zmanim+sofZmanShmaMGA16Point1) ⇒ <code>Date</code>
         * [.sofZmanTfillaMGA()](#Zmanim+sofZmanTfillaMGA) ⇒ <code>Date</code>
+        * [.sofZmanTfillaMGA16Point1()](#Zmanim+sofZmanTfillaMGA16Point1) ⇒ <code>Date</code>
         * [.minchaGedola()](#Zmanim+minchaGedola) ⇒ <code>Date</code>
         * [.minchaKetana()](#Zmanim+minchaKetana) ⇒ <code>Date</code>
         * [.plagHaMincha()](#Zmanim+plagHaMincha) ⇒ <code>Date</code>
@@ -2053,7 +2055,18 @@ Latest Shacharit (Gra); Sunrise plus 4 halachic hours, according to the Gra
 <a name="Zmanim+sofZmanShmaMGA"></a>
 
 ### zmanim.sofZmanShmaMGA() ⇒ <code>Date</code>
-Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham
+Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
+Based on the opinion of the MGA that the day is calculated from
+dawn being fixed 72 minutes before sea-level sunrise, and nightfall is fixed
+72 minutes after sea-level sunset.
+
+**Kind**: instance method of [<code>Zmanim</code>](#Zmanim)  
+<a name="Zmanim+sofZmanShmaMGA16Point1"></a>
+
+### zmanim.sofZmanShmaMGA16Point1() ⇒ <code>Date</code>
+Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
+Based on the opinion of the MGA that the day is calculated from
+dawn to nightfall with both being 16.1° below the horizon.
 
 **Kind**: instance method of [<code>Zmanim</code>](#Zmanim)  
 <a name="Zmanim+sofZmanTfillaMGA"></a>
@@ -2061,6 +2074,14 @@ Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham
 ### zmanim.sofZmanTfillaMGA() ⇒ <code>Date</code>
 Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham
 
+**Kind**: instance method of [<code>Zmanim</code>](#Zmanim)  
+<a name="Zmanim+sofZmanTfillaMGA16Point1"></a>
+
+### zmanim.sofZmanTfillaMGA16Point1() ⇒ <code>Date</code>
+Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
+Based on the opinion of the MGA that the day is calculated from
+dawn to nightfall with both being 16.1° below the horizon.
+
 **Kind**: instance method of [<code>Zmanim</code>](#Zmanim)  
 <a name="Zmanim+minchaGedola"></a>
 
@@ -2182,14 +2203,14 @@ An event that has an `eventTime` and `eventTimeStr`
 **Kind**: global class  
 
 * [TimedEvent](#TimedEvent)
-    * [new TimedEvent(date, desc, mask, eventTime, location, linkedEvent)](#new_TimedEvent_new)
+    * [new TimedEvent(date, desc, mask, eventTime, location, linkedEvent, options)](#new_TimedEvent_new)
     * [.render([locale])](#TimedEvent+render) ⇒ <code>string</code>
     * [.renderBrief([locale])](#TimedEvent+renderBrief) ⇒ <code>string</code>
     * [.getCategories()](#TimedEvent+getCategories) ⇒ <code>Array.&lt;string&gt;</code>
 
 <a name="new_TimedEvent_new"></a>
 
-### new TimedEvent(date, desc, mask, eventTime, location, linkedEvent)
+### new TimedEvent(date, desc, mask, eventTime, location, linkedEvent, options)
 
 | Param | Type | Description |
 | --- | --- | --- |
@@ -2199,6 +2220,7 @@ An event that has an `eventTime` and `eventTimeStr`
 | eventTime | <code>Date</code> |  |
 | location | [<code>Location</code>](#Location) |  |
 | linkedEvent | [<code>Event</code>](#Event) |  |
+| options | [<code>CalOptions</code>](#CalOptions) |  |
 
 <a name="TimedEvent+render"></a>
 
@@ -2232,14 +2254,14 @@ Havdalah after Shabbat or holiday
 **Kind**: global class  
 
 * [HavdalahEvent](#HavdalahEvent)
-    * [new HavdalahEvent(date, mask, eventTime, location, havdalahMins, linkedEvent)](#new_HavdalahEvent_new)
+    * [new HavdalahEvent(date, mask, eventTime, location, havdalahMins, linkedEvent, options)](#new_HavdalahEvent_new)
     * [.render([locale])](#HavdalahEvent+render) ⇒ <code>string</code>
     * [.renderBrief([locale])](#HavdalahEvent+renderBrief) ⇒ <code>string</code>
     * [.getEmoji()](#HavdalahEvent+getEmoji) ⇒ <code>string</code>
 
 <a name="new_HavdalahEvent_new"></a>
 
-### new HavdalahEvent(date, mask, eventTime, location, havdalahMins, linkedEvent)
+### new HavdalahEvent(date, mask, eventTime, location, havdalahMins, linkedEvent, options)
 
 | Param | Type |
 | --- | --- |
@@ -2249,6 +2271,7 @@ Havdalah after Shabbat or holiday
 | location | [<code>Location</code>](#Location) | 
 | havdalahMins | <code>number</code> | 
 | linkedEvent | [<code>Event</code>](#Event) | 
+| options | [<code>CalOptions</code>](#CalOptions) | 
 
 <a name="HavdalahEvent+render"></a>
 
@@ -2282,12 +2305,12 @@ Candle lighting before Shabbat or holiday
 **Kind**: global class  
 
 * [CandleLightingEvent](#CandleLightingEvent)
-    * [new CandleLightingEvent(date, mask, eventTime, location, linkedEvent)](#new_CandleLightingEvent_new)
+    * [new CandleLightingEvent(date, mask, eventTime, location, linkedEvent, options)](#new_CandleLightingEvent_new)
     * [.getEmoji()](#CandleLightingEvent+getEmoji) ⇒ <code>string</code>
 
 <a name="new_CandleLightingEvent_new"></a>
 
-### new CandleLightingEvent(date, mask, eventTime, location, linkedEvent)
+### new CandleLightingEvent(date, mask, eventTime, location, linkedEvent, options)
 
 | Param | Type |
 | --- | --- |
@@ -2296,6 +2319,7 @@ Candle lighting before Shabbat or holiday
 | eventTime | <code>Date</code> | 
 | location | [<code>Location</code>](#Location) | 
 | linkedEvent | [<code>Event</code>](#Event) | 
+| options | [<code>CalOptions</code>](#CalOptions) | 
 
 <a name="CandleLightingEvent+getEmoji"></a>
 
@@ -2317,6 +2341,7 @@ Represents a molad, the moment when the new moon is "born"
     * [.getHour()](#Molad+getHour) ⇒ <code>number</code>
     * [.getMinutes()](#Molad+getMinutes) ⇒ <code>number</code>
     * [.getChalakim()](#Molad+getChalakim) ⇒ <code>number</code>
+    * [.render([locale], options)](#Molad+render) ⇒ <code>string</code>
 
 <a name="new_Molad_new"></a>
 
@@ -2361,6 +2386,16 @@ Calculates the molad for a Hebrew month
 ### molad.getChalakim() ⇒ <code>number</code>
 **Kind**: instance method of [<code>Molad</code>](#Molad)  
 **Returns**: <code>number</code> - parts of a minute (0-17)  
+<a name="Molad+render"></a>
+
+### molad.render([locale], options) ⇒ <code>string</code>
+**Kind**: instance method of [<code>Molad</code>](#Molad)  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| [locale] | <code>string</code> | Optional locale name (defaults to active locale) |
+| options | [<code>CalOptions</code>](#CalOptions) |  |
+
 <a name="MoladEvent"></a>
 
 ## MoladEvent
@@ -2369,18 +2404,19 @@ Represents a Molad announcement on Shabbat Mevarchim
 **Kind**: global class  
 
 * [MoladEvent](#MoladEvent)
-    * [new MoladEvent(date, hyear, hmonth)](#new_MoladEvent_new)
+    * [new MoladEvent(date, hyear, hmonth, options)](#new_MoladEvent_new)
     * [.render([locale])](#MoladEvent+render) ⇒ <code>string</code>
 
 <a name="new_MoladEvent_new"></a>
 
-### new MoladEvent(date, hyear, hmonth)
+### new MoladEvent(date, hyear, hmonth, options)
 
 | Param | Type | Description |
 | --- | --- | --- |
 | date | [<code>HDate</code>](#HDate) | Hebrew date event occurs |
 | hyear | <code>number</code> | molad year |
 | hmonth | <code>number</code> | molad month |
+| options | [<code>CalOptions</code>](#CalOptions) |  |
 
 <a name="MoladEvent+render"></a>
 
@@ -2489,6 +2525,7 @@ Represents Parashah HaShavua for an entire Hebrew year
     * [.getString(hDate, [locale])](#Sedra+getString) ⇒ <code>string</code>
     * [.isParsha(hDate)](#Sedra+isParsha) ⇒ <code>boolean</code>
     * [.find(parsha)](#Sedra+find) ⇒ [<code>HDate</code>](#HDate)
+    * [.getSedraArray()](#Sedra+getSedraArray) ⇒ <code>Array.&lt;Object&gt;</code>
     * [.getFirstSaturday()](#Sedra+getFirstSaturday) ⇒ <code>number</code>
     * [.getYear()](#Sedra+getYear) ⇒ <code>number</code>
     * [.lookup(hDate)](#Sedra+lookup) ⇒ [<code>SedraResult</code>](#SedraResult)
@@ -2550,6 +2587,10 @@ Returns the date that a parsha occurs
 | --- | --- |
 | parsha | <code>number</code> \| <code>string</code> \| <code>Array.&lt;string&gt;</code> | 
 
+<a name="Sedra+getSedraArray"></a>
+
+### sedra.getSedraArray() ⇒ <code>Array.&lt;Object&gt;</code>
+**Kind**: instance method of [<code>Sedra</code>](#Sedra)  
 <a name="Sedra+getFirstSaturday"></a>
 
 ### sedra.getFirstSaturday() ⇒ <code>number</code>
@@ -3025,7 +3066,7 @@ Returns an array of holidays for the year
 <a name="HebrewCalendar.getHolidaysOnDate"></a>
 
 ### HebrewCalendar.getHolidaysOnDate(date, [il]) ⇒ [<code>Array.&lt;Event&gt;</code>](#Event)
-Returns an array of Events on this date (or undefined if no events)
+Returns an array of Events on this date (or `undefined` if no events)
 
 **Kind**: static method of [<code>HebrewCalendar</code>](#HebrewCalendar)  
 
@@ -3193,43 +3234,6 @@ parshiot[0] == 'Bereshit', parshiot[1] == 'Noach', parshiot[53] == "Ha'azinu".
 
 **Kind**: global constant  
 **Read only**: true  
-<a name="gematriya"></a>
-
-## gematriya(number) ⇒ <code>string</code>
-Converts a numerical value to a string of Hebrew letters.
-
-When specifying years of the Hebrew calendar in the present millennium,
-we omit the thousands (which is presently 5 [ה]).
-
-**Kind**: global function  
-
-| Param | Type |
-| --- | --- |
-| number | <code>number</code> | 
-
-**Example**  
-```js
-gematriya(5774) // 'תשע״ד' - cropped to 774
-gematriya(25) // 'כ״ה'
-gematriya(60) // 'ס׳'
-gematriya(3761) // 'ג׳תשס״א'
-gematriya(1123) // 'א׳קכ״ג'
-```
-<a name="gematriyaStrToNum"></a>
-
-## gematriyaStrToNum(str) ⇒ <code>number</code>
-Converts a string of Hebrew letters to a numerical value.
-
-Only considers the value of Hebrew letters `א` through `ת`.
-Ignores final Hebrew letters such as `ך` (kaf sofit) or `ם` (mem sofit)
-and vowels (nekudot).
-
-**Kind**: global function  
-
-| Param | Type |
-| --- | --- |
-| str | <code>string</code> | 
-
 <a name="hebrew2abs"></a>
 
 ## hebrew2abs(year, month, day) ⇒ <code>number</code>
@@ -3361,6 +3365,43 @@ Converts Hebrew month string name to numeric
 | --- | --- | --- |
 | monthName | <code>string</code> | monthName |
 
+<a name="gematriya"></a>
+
+## gematriya(num) ⇒ <code>string</code>
+Converts a numerical value to a string of Hebrew letters.
+
+When specifying years of the Hebrew calendar in the present millennium,
+we omit the thousands (which is presently 5 [ה]).
+
+**Kind**: global function  
+
+| Param | Type |
+| --- | --- |
+| num | <code>number</code> | 
+
+**Example**  
+```js
+gematriya(5774) // 'תשע״ד' - cropped to 774
+gematriya(25) // 'כ״ה'
+gematriya(60) // 'ס׳'
+gematriya(3761) // 'ג׳תשס״א'
+gematriya(1123) // 'א׳קכ״ג'
+```
+<a name="gematriyaStrToNum"></a>
+
+## gematriyaStrToNum(str) ⇒ <code>number</code>
+Converts a string of Hebrew letters to a numerical value.
+
+Only considers the value of Hebrew letters `א` through `ת`.
+Ignores final Hebrew letters such as `ך` (kaf sofit) or `ם` (mem sofit)
+and vowels (nekudot).
+
+**Kind**: global function  
+
+| Param | Type |
+| --- | --- |
+| str | <code>string</code> | 
+
 <a name="SedraResult"></a>
 
 ## SedraResult : <code>Object</code>

package/dist/bundle.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v5.0.7 */
+/*! @hebcal/core v5.0.9 */
 var hebcal = (function (exports) {
 'use strict';
 
@@ -1229,7 +1229,8 @@ class HDate {
     let showYear = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
     const locale0 = locale || Locale.getLocaleName();
     const day = this.getDate();
-    const monthName = Locale.gettext(this.getMonthName(), locale0);
+    const monthName0 = Locale.gettext(this.getMonthName(), locale0);
+    const monthName = monthName0.replace(/'/g, '’');
     const nth = Locale.ordinal(day, locale0);
     const dayOf = HDate.getDayOfTranslation(locale0);
     const dateStr = `${nth}${dayOf} ${monthName}`;
@@ -7474,7 +7475,8 @@ class Molad {
       return `${moladStr} ${monthName} יִהְיֶה בַּיּוֹם ${dow} בשָׁבוּעַ, ` + `בְּשָׁעָה ${hour} ${ampm}, ` + `ו-${minutes} ${minutesStr} ` + `ו-${chalakim} ${chalakimStr}`;
     }
     const fmtTime = reformatTimeStr(`${hour}:00`, 'pm', options);
-    return `${moladStr} ${monthName}: ${dow}, ${minutes} ${minutesStr} and ${chalakim} ${chalakimStr} after ${fmtTime}`;
+    const month = monthName.replace(/'/g, '’');
+    return `${moladStr} ${month}: ${dow}, ${minutes} ${minutesStr} and ${chalakim} ${chalakimStr} after ${fmtTime}`;
   }
 }
 
@@ -8399,6 +8401,7 @@ class ParshaEvent extends Event {
       const hyphen = locale0 == 'he' ? '־' : '-';
       name += hyphen + Locale.gettext(parsha[1], locale);
     }
+    name = name.replace(/'/g, '’');
     const str = Locale.gettext('Parashat', locale) + ' ' + name;
     return str.normalize();
   }
@@ -9691,6 +9694,26 @@ class HolidayEvent extends Event {
         return ['holiday', 'major'];
     }
   }
+  /**
+   * Returns (translated) description of this event
+   * @param {string} [locale] Optional locale name (defaults to active locale).
+   * @return {string}
+   */
+  render(locale) {
+    const str = super.render(locale);
+    return str.replace(/'/g, '’');
+  }
+  /**
+   * Returns a brief (translated) description of this event.
+   * For most events, this is the same as render(). For some events, it procudes
+   * a shorter text (e.g. without a time or added description).
+   * @param {string} [locale] Optional locale name (defaults to active locale).
+   * @return {string}
+   */
+  renderBrief(locale) {
+    const str = super.renderBrief(locale);
+    return str.replace(/'/g, '’');
+  }
 }
 const roshChodeshStr = 'Rosh Chodesh';
 
@@ -9711,7 +9734,9 @@ class RoshChodeshEvent extends HolidayEvent {
    */
   render(locale) {
     const monthName = this.getDesc().substring(roshChodeshStr.length + 1);
-    return Locale.gettext(roshChodeshStr, locale) + ' ' + Locale.gettext(monthName, locale);
+    const monthName0 = Locale.gettext(monthName, locale);
+    const monthName1 = monthName0.replace(/'/g, '’');
+    return Locale.gettext(roshChodeshStr, locale) + ' ' + monthName1;
   }
   /** @return {string} */
   basename() {
@@ -9765,7 +9790,19 @@ class MevarchimChodeshEvent extends Event {
    * @return {string}
    */
   render(locale) {
-    return Locale.gettext(mevarchimChodeshStr, locale) + ' ' + Locale.gettext(this.monthName, locale);
+    const monthName0 = Locale.gettext(this.monthName, locale);
+    const monthName = monthName0.replace(/'/g, '’');
+    return Locale.gettext(mevarchimChodeshStr, locale) + ' ' + monthName;
+  }
+  /**
+   * Returns (translated) description of this event
+   * @param {string} [locale] Optional locale name (defaults to active locale).
+   * @return {string}
+   */
+  renderBrief(locale) {
+    const str = this.render(locale);
+    const space = str.indexOf(' ');
+    return str.substring(space + 1);
   }
 }
 
@@ -9817,7 +9854,9 @@ class YomKippurKatanEvent extends HolidayEvent {
    * @return {string}
    */
   render(locale) {
-    return Locale.gettext(ykk, locale) + ' ' + Locale.gettext(this.nextMonthName, locale);
+    const monthName0 = Locale.gettext(this.nextMonthName, locale);
+    const monthName = monthName0.replace(/'/g, '’');
+    return Locale.gettext(ykk, locale) + ' ' + monthName;
   }
   /**
    * @param {string} [locale] Optional locale name (defaults to active locale).
@@ -10110,7 +10149,7 @@ class DailyLearning {
 }
 
 // DO NOT EDIT THIS AUTO-GENERATED FILE!
-const version = '5.0.7';
+const version = '5.0.9';
 
 var objectGetOwnPropertyDescriptor = {};
 
@@ -10673,7 +10712,7 @@ var poAshkenazi = {
       "Shabbat": ["Shabbos"],
       "Achrei Mot": ["Achrei Mos"],
       "Bechukotai": ["Bechukosai"],
-      "Beha'alotcha": ["Beha'aloscha"],
+      "Beha'alotcha": ["Beha’aloscha"],
       "Bereshit": ["Bereshis"],
       "Chukat": ["Chukas"],
       "Erev Shavuot": ["Erev Shavuos"],
@@ -10700,14 +10739,14 @@ var poAshkenazi = {
       "Sukkot": ["Sukkos"],
       "Sukkot I": ["Sukkos I"],
       "Sukkot II": ["Sukkos II"],
-      "Sukkot II (CH''M)": ["Sukkos II (CH''M)"],
-      "Sukkot III (CH''M)": ["Sukkos III (CH''M)"],
-      "Sukkot IV (CH''M)": ["Sukkos IV (CH''M)"],
-      "Sukkot V (CH''M)": ["Sukkos V (CH''M)"],
-      "Sukkot VI (CH''M)": ["Sukkos VI (CH''M)"],
+      "Sukkot II (CH''M)": ["Sukkos II (CH’’M)"],
+      "Sukkot III (CH''M)": ["Sukkos III (CH’’M)"],
+      "Sukkot IV (CH''M)": ["Sukkos IV (CH’’M)"],
+      "Sukkot V (CH''M)": ["Sukkos V (CH’’M)"],
+      "Sukkot VI (CH''M)": ["Sukkos VI (CH’’M)"],
       "Sukkot VII (Hoshana Raba)": ["Sukkos VII (Hoshana Raba)"],
-      "Ta'anit Bechorot": ["Ta'anis Bechoros"],
-      "Ta'anit Esther": ["Ta'anis Esther"],
+      "Ta'anit Bechorot": ["Ta’anis Bechoros"],
+      "Ta'anit Esther": ["Ta’anis Esther"],
       "Toldot": ["Toldos"],
       "Vaetchanan": ["Vaeschanan"],
       "Yitro": ["Yisro"],
@@ -10717,7 +10756,7 @@ var poAshkenazi = {
       "Shabbat Mevarchim Chodesh": ["Shabbos Mevorchim Chodesh"],
       "Shabbat Shirah": ["Shabbos Shirah"],
       "Tevet": ["Teves"],
-      "Asara B'Tevet": ["Asara B'Teves"],
+      "Asara B'Tevet": ["Asara B’Teves"],
       "Alot HaShachar": ["Alos HaShachar"],
       "Kriat Shema, sof zeman": ["Krias Shema, sof zman"],
       "Tefilah, sof zeman": ["Tefilah, sof zman"],