@hebcal/leyning 8.0.1 → 8.1.0

package/README.md

@@ -108,6 +108,9 @@ of full kriyah aliyot, special Maftir, special Haftarah</p>
 <dd><p>Looks up leyning for a given holiday. Returns some
 of full kriyah aliyot, special Maftir, special Haftarah</p>
 </dd>
+<dt><a href="#makeLeyningNames">makeLeyningNames(parsha)</a> ⇒ <code><a href="#LeyningNames">LeyningNames</a></code></dt>
+<dd><p>Transliterated English and Hebrew names of this parsha</p>
+</dd>
 <dt><a href="#getWeekdayReading">getWeekdayReading(parsha)</a> ⇒ <code>Object.&lt;string, Aliyah&gt;</code></dt>
 <dd><p>Looks up Monday/Thursday aliyot for a regular parsha</p>
 </dd>
@@ -357,6 +360,17 @@ of full kriyah aliyot, special Maftir, special Haftarah
 | ev | <code>Event</code> |  | the Hebcal event associated with this leyning |
 | [il] | <code>boolean</code> | <code>false</code> | true if Israel holiday scheme |
 
+<a name="makeLeyningNames"></a>
+
+## makeLeyningNames(parsha) ⇒ [<code>LeyningNames</code>](#LeyningNames)
+Transliterated English and Hebrew names of this parsha
+
+**Kind**: global function  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| parsha | <code>string</code> \| <code>Array.&lt;string&gt;</code> | untranslated name like 'Pinchas' or ['Pinchas'] or ['Matot','Masei'] |
+
 <a name="getWeekdayReading"></a>
 
 ## getWeekdayReading(parsha) ⇒ <code>Object.&lt;string, Aliyah&gt;</code>
@@ -501,7 +515,7 @@ Leyning for a parsha hashavua or holiday
 | --- | --- | --- |
 | name | [<code>LeyningNames</code>](#LeyningNames) |  |
 | [parsha] | <code>Array.&lt;string&gt;</code> | An array of either 1 (regular) or 2 (doubled parsha).    `undefined` for holiday readings |
-| [parshaNum] | <code>number</code> | 1 for Bereshit, 2 for Noach, etc. `undefined` for holiday readings |
+| [parshaNum] | <code>number</code> \| <code>Array.&lt;number&gt;</code> | 1 for Bereshit, 2 for Noach, etc. `undefined` for holiday readings |
 | summary | <code>string</code> | Such as `Genesis 1:1 - 6:8` |
 | haft | [<code>Aliyah</code>](#Aliyah) \| [<code>Array.&lt;Aliyah&gt;</code>](#Aliyah) | Haftarah object(s) |
 | haftara | <code>string</code> | Haftarah, such as `Isaiah 42:5 – 43:11` |

package/dist/bundle.js

@@ -1,4 +1,4 @@
-/*! @hebcal/leyning v8.0.1 */
+/*! @hebcal/leyning v8.1.0 */
 var hebcal__leyning = (function (exports, core) {
 'use strict';
 
@@ -262,11 +262,11 @@ function lookupFestival(holiday) {
   }
   const result = src.fullkriyah ? clone(src) : src;
   if (result.fullkriyah) {
-    Object.values(result.fullkriyah).forEach(aliyah => {
+    for (const aliyah of Object.values(result.fullkriyah)) {
       if (typeof aliyah.k === 'number') {
         aliyah.k = BOOK[aliyah.k];
       }
-    });
+    }
   }
   if (src.note) {
     result.note = src.note;
@@ -483,14 +483,16 @@ function specialReadings2(parsha, hd, il, aliyot) {
     if (special.fullkriyah) {
       const aliyotMap = clone(aliyot);
       mergeAliyotWithSpecial(aliyotMap, special.fullkriyah);
-      Object.keys(special.fullkriyah).map(k => reason[k] = key);
+      for (const num of Object.keys(special.fullkriyah)) {
+        reason[num] = key;
+      }
       aliyot = aliyotMap;
     }
   }
   const parshaName = parshaToString(parsha);
   const events0 = core.HebrewCalendar.getHolidaysOnDate(hd, il) || [];
   const events = events0.filter(ev => !(ev.getFlags() & core.flags.ROSH_CHODESH));
-  events.forEach(ev => {
+  for (const ev of events) {
     if (ev.getDesc() === 'Shabbat Shuva') {
       handleSpecial(`Shabbat Shuva (with ${parshaName})`);
     } else {
@@ -499,7 +501,7 @@ function specialReadings2(parsha, hd, il, aliyot) {
         handleSpecial(key);
       }
     }
-  });
+  }
   if (!haft) {
     const day = hd.getDate();
     if (parshaName === 'Pinchas' && day > 17) {
@@ -658,7 +660,7 @@ const Bereshit={num:1,hebrew:"בְּרֵאשִׁית",book:1,haft:{k:"Isaiah",b:
  * @property {LeyningNames} name
  * @property {string[]} [parsha] - An array of either 1 (regular) or 2 (doubled parsha).
  *    `undefined` for holiday readings
- * @property {number} [parshaNum] - 1 for Bereshit, 2 for Noach, etc. `undefined` for holiday readings
+ * @property {number|number[]} [parshaNum] - 1 for Bereshit, 2 for Noach, etc. `undefined` for holiday readings
  * @property {string} summary - Such as `Genesis 1:1 - 6:8`
  * @property {Aliyah|Aliyah[]} haft - Haftarah object(s)
  * @property {string} haftara - Haftarah, such as `Isaiah 42:5 – 43:11`
@@ -692,6 +694,19 @@ function getHaftaraKey(parsha) {
   }
 }
 
+/**
+ * Transliterated English and Hebrew names of this parsha
+ * @param {string|string[]} parsha untranslated name like 'Pinchas' or ['Pinchas'] or ['Matot','Masei']
+ * @return {LeyningNames}
+ */
+function makeLeyningNames(parsha) {
+  const name = parshaToString(parsha);
+  return {
+    en: name,
+    he: parsha.map(s => core.Locale.lookupTranslation(s, 'he')).join('־')
+  };
+}
+
 /**
  * Looks up regular leyning for a weekly parsha with no special readings
  * @private
@@ -702,26 +717,22 @@ function getLeyningForParshaShabbatOnly(parsha) {
   const raw = lookupParsha(parsha);
   const fullkriyah = {};
   const book = BOOK[raw.book];
-  Object.keys(raw.fullkriyah).forEach(num => {
-    const src = raw.fullkriyah[num];
-    const reading = {
+  for (const [num, src] of Object.entries(raw.fullkriyah)) {
+    const aliyah = {
       k: book,
       b: src[0],
       e: src[1]
     };
-    fullkriyah[num] = reading;
-  });
-  Object.values(fullkriyah).map(aliyah => calculateNumVerses(aliyah));
+    calculateNumVerses(aliyah);
+    fullkriyah[num] = aliyah;
+  }
   const name = parshaToString(parsha);
   const parshaNameArray = raw.combined ? [raw.p1, raw.p2] : [name];
   const parts = makeLeyningParts(fullkriyah);
   const summary = makeSummaryFromParts(parts);
   /** @type {Leyning} */
   const result = {
-    name: {
-      en: name,
-      he: parshaNameArray.map(s => core.Locale.lookupTranslation(s, 'he')).join('־')
-    },
+    name: makeLeyningNames(parshaNameArray),
     parsha: parshaNameArray,
     parshaNum: raw.num,
     summary,
@@ -824,18 +835,20 @@ function getLeyningForParshaHaShavua(ev) {
   const reasons = Object.keys(reason);
   if (reasons.length !== 0) {
     result.reason = reason;
-    reasons.forEach(num => {
+    for (const num of reasons) {
       if (num === 'haftara' || num === 'sephardic') {
         const haftObj = result[num === 'haftara' ? 'haft' : 'seph'];
         const hafts = Array.isArray(haftObj) ? haftObj : [haftObj];
-        hafts.forEach(haft => haft.reason = reason[num]);
+        for (const haft of hafts) {
+          haft.reason = reason[num];
+        }
       } else {
         const aliyah = result.fullkriyah[num];
         if (typeof aliyah === 'object') {
           aliyah.reason = reason[num];
         }
       }
-    });
+    }
   }
   return result;
 }
@@ -927,48 +940,44 @@ function findParshaHaShavua(saturday, il) {
 function getLeyningOnDate(hdate, il) {
   let wantarray = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
   const dow = hdate.getDay();
-  const hyear = hdate.getFullYear();
-  const sedra = core.HebrewCalendar.getSedra(hyear, il);
-  const parsha = sedra.lookup(hdate);
-  if (dow === 6 && !parsha.chag) {
-    const parshaEvent = new core.ParshaEvent(hdate, parsha.parsha, il);
-    const reading = getLeyningForParshaHaShavua(parshaEvent, il);
-    return wantarray ? [reading] : reading;
+  if (dow === 6) {
+    const hyear = hdate.getFullYear();
+    const sedra = core.HebrewCalendar.getSedra(hyear, il);
+    const parsha = sedra.lookup(hdate);
+    if (!parsha.chag) {
+      const parshaEvent = new core.ParshaEvent(hdate, parsha.parsha, il);
+      const reading = getLeyningForParshaHaShavua(parshaEvent, il);
+      return wantarray ? [reading] : reading;
+    }
   }
   const events = core.HebrewCalendar.getHolidaysOnDate(hdate, il) || [];
   const arr = [];
-  for (let i = 0; i < events.length; i++) {
-    const ev = events[i];
+  let hasFullKriyah = false;
+  for (const ev of events) {
     const reading = getLeyningForHoliday(ev, il);
     if (reading) {
-      if (wantarray) {
-        arr.push(reading);
-        const mincha = getMincha(ev, il);
-        if (mincha) {
-          arr.push(mincha);
-        }
-      } else {
-        return reading;
+      arr.push(reading);
+      if (reading.fullkriyah) {
+        hasFullKriyah = true;
+      }
+      const mincha = getMincha(ev, il);
+      if (mincha) {
+        arr.push(mincha);
       }
     }
   }
-  if (wantarray && arr.length !== 0) {
-    return arr;
-  }
-  if (dow === 1 || dow === 4) {
+  if (!hasFullKriyah && (dow === 1 || dow === 4)) {
     const saturday = hdate.onOrAfter(6);
-    const parsha2 = findParshaHaShavua(saturday);
-    const reading = getLeyningForParsha(parsha2.parsha);
-    const result = {
-      name: reading.name,
-      parsha: reading.parsha,
-      parshaNum: reading.parshaNum,
-      weekday: reading.weekday
+    const parsha = findParshaHaShavua(saturday);
+    const reading = {
+      name: makeLeyningNames(parsha.parsha),
+      parsha: parsha.parsha,
+      parshaNum: parsha.num,
+      weekday: getWeekdayReading(parsha.parsha)
     };
-    return wantarray ? [result] : result;
+    arr.unshift(reading);
   }
-  // no reading today: it's not Shabbat, Mon/Thu, or a Torah-reading holiday
-  return wantarray ? [] : undefined;
+  return wantarray ? arr : arr[0];
 }
 const minchaSuffix = ' (Mincha)';
 
@@ -1040,11 +1049,11 @@ function writeFullKriyahCsv(stream, hyear, il) {
   const events = events0.filter(ev => ev.getDesc() !== 'Rosh Chodesh Tevet');
   const parshaDates = getParshaDates(events);
   stream.write('"Date","Parashah","Aliyah","Reading","Verses"\r\n');
-  events.forEach(ev => {
+  for (const ev of events) {
     if (ev.getFlags() === core.flags.PARSHA_HASHAVUA || !parshaDates[ev.getDate().toString()]) {
       writeFullKriyahEvent(stream, ev, il);
     }
-  });
+  }
 }
 
 /**
@@ -1113,13 +1122,13 @@ function writeCsvLines(stream, ev, reading, il, isParsha) {
   const parsha = isParsha ? ev.basename() : getLeyningKeyForEvent(ev, il) || ev.render();
   const date = fmtDate(ev.getDate().greg());
   const lines = getFullKriyahLines(reading);
-  lines.forEach(s => {
+  for (const s of lines) {
     const code = s[0].charCodeAt(0);
     if (code < 48 || code > 57) {
       s[0] = `"${s[0]}"`;
     }
     stream.write(`${date},"${parsha}",${s[0]},"${s[1]}",${s[2]}\r\n`);
-  });
+  }
   stream.write('\r\n');
 }
 
@@ -1131,8 +1140,7 @@ function writeCsvLines(stream, ev, reading, il, isParsha) {
 function getFullKriyahLines(reading) {
   const lines = [];
   if (reading.fullkriyah) {
-    Object.keys(reading.fullkriyah).forEach(num => {
-      const a = reading.fullkriyah[num];
+    for (const [num, a] of Object.entries(reading.fullkriyah)) {
       if (typeof a !== 'undefined') {
         var _reading$reason;
         const k = num == 'M' ? 'maf' : num;
@@ -1142,7 +1150,7 @@ function getFullKriyahLines(reading) {
         }
         lines.push([k, aliyah, a.v || '']);
       }
-    });
+    }
   }
   let specialHaftara = false;
   if (reading.haftara) {
@@ -1163,13 +1171,12 @@ function getFullKriyahLines(reading) {
     lines.push(['Alternate Haftara', haftara, reading.triHaftaraNumV || '']);
   }
   if (reading.megillah) {
-    Object.keys(reading.megillah).forEach(num => {
-      const a = reading.megillah[num];
+    for (const [num, a] of Object.entries(reading.megillah)) {
       if (typeof a !== 'undefined') {
         const aliyah = formatAliyahWithBook(a);
         lines.push([`Megillah Ch. ${num}`, aliyah, a.v || '']);
       }
-    });
+    }
   }
   return lines;
 }
@@ -1191,6 +1198,7 @@ exports.getWeekdayReading = getWeekdayReading;
 exports.hasFestival = hasFestival;
 exports.lookupFestival = lookupFestival;
 exports.lookupParsha = lookupParsha;
+exports.makeLeyningNames = makeLeyningNames;
 exports.makeLeyningParts = makeLeyningParts;
 exports.makeLeyningSummary = makeLeyningSummary;
 exports.makeSummaryFromParts = makeSummaryFromParts;