@hebcal/leyning 5.2.0 → 6.0.0

package/README.md

@@ -3,27 +3,10 @@ Javascript Torah Reading API for Parashat HaShavua and holidays
 
 [![Build Status](https://circleci.com/gh/hebcal/hebcal-leyning.svg?style=svg)](https://circleci.com/gh/hebcal/hebcal-leyning)
 
-This package includes both traditional (full kriyah), triennial and weekday
+This package includes both traditional (full kriyah) and weekday
 Torah readings.
 
-“Many congregations pattern their weekly Torah reading cycle after a system
-similar to the one used in ancient Israel during the rabbinic period. In
-this system, the traditional parashiot are each divided into three shorter
-segments, and the whole Torah is completed once every three years. The
-system has both advantages and disadvantages, but its ability to shorten
-the length of Torah reading without sacrificing the complete reading of the
-Torah on a regular basis has made it the choice of some synagogues in the
-Conservative Movement.”
-
-[A Complete Triennial System for Reading the Torah, Committee on Jewish Law and Standards of the Rabbinical Assembly](https://www.rabbinicalassembly.org/sites/default/files/public/halakhah/teshuvot/19861990/eisenberg_triennial.pdf)
-
-Update December 2021: In November 2020, the CJLS modified the triennial
-cycle for some combined parshiyot to change the reading for year 3 to be
-the third section of the parashah.
-
-[Modification of the Triennial Cycle Readings for Combined Parashot in Certain Years](https://www.rabbinicalassembly.org/sites/default/files/2021-09/cohen-triennial.pdf), Rabbi Miles B. Cohen
-
-Update August 2022: Incorporated [An Emendation to Richard Eisenberg’s Complete Triennial System for Reading Torah, to Address a Rare Situation](https://www.rabbinicalassembly.org/sites/default/files/public/halakhah/teshuvot/2011-2020/heller-triennial-emendation.pdf), Rabbi Joshua Heller, 2012
+Triennial Torah Readings have moved to [@hebcal/triennial](https://github.com/hebcal/hebcal-triennial)
 
 ## Installation
 ```bash
@@ -33,8 +16,7 @@ $ npm install @hebcal/leyning
 ## Synopsis
 ```javascript
 import {HebrewCalendar, HDate, Event} from '@hebcal/core';
-import {getLeyningForParshaHaShavua, getTriennialForParshaHaShavua,
- formatAliyahWithBook} from '@hebcal/leyning';
+import {getLeyningForParshaHaShavua, formatAliyahWithBook} from '@hebcal/leyning';
 
 const events = HebrewCalendar.calendar({sedrot: true, noHolidays: true});
 const ev = events.find((ev) => ev.getDesc() == 'Parashat Pinchas');
@@ -50,22 +32,8 @@ for (const [num, aliyah] of Object.entries(reading.fullkriyah)) {
   str += ` (${aliyah.v} verses)`;
   console.log(`${number}: ${str}`);
 }
-const triReading = getTriennialForParshaHaShavua(ev);
-for (const [num, aliyah] of Object.entries(triReading)) {
-  const number = num == 'M' ? 'maftir' : `aliyah ${num}`;
-  const str = formatAliyahWithBook(aliyah);
-  console.log(`Triennial ${number}: ${str}`);
-}
 ```
 
-## Classes
-
-<dl>
-<dt><a href="#Triennial">Triennial</a></dt>
-<dd><p>Triennial Torah readings</p>
-</dd>
-</dl>
-
 ## Constants
 
 <dl>
@@ -120,6 +88,15 @@ e.g. <code>Genesis 21:1-34; Numbers 29:1-6</code>.</p>
 <dt><a href="#getLeyningKeyForEvent">getLeyningKeyForEvent(ev, [il])</a> ⇒ <code>string</code></dt>
 <dd><p>Based on the event date, type and title, finds the relevant leyning key</p>
 </dd>
+<dt><a href="#specialReadings">specialReadings(hd, il, aliyot, reason)</a> ⇒ <code><a href="#Aliyah">Aliyah</a></code> | <code><a href="#Aliyah">Array.&lt;Aliyah&gt;</a></code></dt>
+<dd><p>Determines if the regular parashat haShavua coincides with an event that requires
+a special maftir or Haftara (for example Shabbat HaGadol, Shabbat Chanukah, Rosh
+Chodesh or Machar Chodesh, etc.).</p>
+<p>If a special maftir occurs, modifies <code>aliyot</code> to replace <code>M</code> and sets <code>reason.M</code>
+(and in some cases modifies the 6th and 7th aliyah, setting <code>reason[&#39;7&#39;]</code>).</p>
+<p>If a special Haftarah applies, returns the Haftarah object and sets <code>reason.haftara</code>.
+If no special Haftarah, returns <code>undefined</code></p>
+</dd>
 <dt><a href="#getLeyningForHoliday">getLeyningForHoliday(ev, [il])</a> ⇒ <code><a href="#Leyning">Leyning</a></code></dt>
 <dd><p>Looks up leyning for a given holiday. Returns some
 of full kriyah aliyot, special Maftir, special Haftarah</p>
@@ -148,14 +125,8 @@ Parashat haShavua, containing only the <code>weekday</code> aliyot (no <code>ful
 <dt><a href="#lookupParsha">lookupParsha(parsha)</a> ⇒ <code><a href="#ParshaMeta">ParshaMeta</a></code></dt>
 <dd><p>Returns the parsha metadata</p>
 </dd>
-<dt><a href="#getTriennial">getTriennial(year)</a> ⇒ <code><a href="#Triennial">Triennial</a></code></dt>
-<dd><p>Calculates the 3-year readings for a given year</p>
-</dd>
-<dt><a href="#getTriennialForParshaHaShavua">getTriennialForParshaHaShavua(ev)</a> ⇒ <code><a href="#TriennialAliyot">TriennialAliyot</a></code></dt>
-<dd><p>Looks up the triennial leyning for this Parashat HaShavua</p>
-</dd>
-<dt><a href="#getTriennialHaftaraForHoliday">getTriennialHaftaraForHoliday(key, yearNum)</a> ⇒ <code>Object</code></dt>
-<dd><p>Looks up the alternative triennial Haftara for a holiday</p>
+<dt><a href="#writeCsvLines">writeCsvLines(stream, ev, reading, il, isParsha)</a></dt>
+<dd><p>Formats reading for CSV</p>
 </dd>
 </dl>
 
@@ -174,79 +145,8 @@ Parashat haShavua, containing only the <code>weekday</code> aliyot (no <code>ful
 <dt><a href="#ParshaMeta">ParshaMeta</a> : <code>Object</code></dt>
 <dd><p>Parsha metadata</p>
 </dd>
-<dt><a href="#TriennialAliyot">TriennialAliyot</a> : <code>Object</code></dt>
-<dd><p>Represents triennial aliyot for a given date</p>
-</dd>
 </dl>
 
-<a name="Triennial"></a>
-
-## Triennial
-Triennial Torah readings
-
-**Kind**: global class  
-
-* [Triennial](#Triennial)
-    * [new Triennial([hebrewYear])](#new_Triennial_new)
-    * _instance_
-        * [.getReading(parsha, yearNum)](#Triennial+getReading) ⇒ <code>Object.&lt;string, Aliyah&gt;</code>
-        * [.getStartYear()](#Triennial+getStartYear) ⇒ <code>number</code>
-        * [.debug()](#Triennial+debug) ⇒ <code>string</code>
-    * _static_
-        * [.getYearNumber(year)](#Triennial.getYearNumber) ⇒ <code>number</code>
-        * [.getCycleStartYear(year)](#Triennial.getCycleStartYear) ⇒ <code>number</code>
-
-<a name="new_Triennial_new"></a>
-
-### new Triennial([hebrewYear])
-Builds a Triennial object
-
-
-| Param | Type | Description |
-| --- | --- | --- |
-| [hebrewYear] | <code>number</code> | Hebrew Year (default current year) |
-
-<a name="Triennial+getReading"></a>
-
-### triennial.getReading(parsha, yearNum) ⇒ <code>Object.&lt;string, Aliyah&gt;</code>
-**Kind**: instance method of [<code>Triennial</code>](#Triennial)  
-**Returns**: <code>Object.&lt;string, Aliyah&gt;</code> - a map of aliyot 1-7 plus "M"  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| parsha | <code>string</code> | parsha name ("Bereshit" or "Achrei Mot-Kedoshim") |
-| yearNum | <code>number</code> | 0 through 2 for which year of Triennial cycle |
-
-<a name="Triennial+getStartYear"></a>
-
-### triennial.getStartYear() ⇒ <code>number</code>
-**Kind**: instance method of [<code>Triennial</code>](#Triennial)  
-<a name="Triennial+debug"></a>
-
-### triennial.debug() ⇒ <code>string</code>
-**Kind**: instance method of [<code>Triennial</code>](#Triennial)  
-<a name="Triennial.getYearNumber"></a>
-
-### Triennial.getYearNumber(year) ⇒ <code>number</code>
-Returns triennial year 1, 2 or 3 based on this Hebrew year
-
-**Kind**: static method of [<code>Triennial</code>](#Triennial)  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| year | <code>number</code> | Hebrew year |
-
-<a name="Triennial.getCycleStartYear"></a>
-
-### Triennial.getCycleStartYear(year) ⇒ <code>number</code>
-Returns Hebrew year that this 3-year triennial cycle began
-
-**Kind**: static method of [<code>Triennial</code>](#Triennial)  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| year | <code>number</code> | Hebrew year |
-
 <a name="BOOK"></a>
 
 ## BOOK : <code>Array.&lt;string&gt;</code>
@@ -348,7 +248,7 @@ e.g. `Genesis 21:1-34; Numbers 29:1-6`.
 
 | Param | Type |
 | --- | --- |
-| parts | [<code>Array.&lt;Aliyah&gt;</code>](#Aliyah) | 
+| parts | [<code>Aliyah</code>](#Aliyah) \| [<code>Array.&lt;Aliyah&gt;</code>](#Aliyah) | 
 
 <a name="makeLeyningSummary"></a>
 
@@ -396,6 +296,28 @@ Based on the event date, type and title, finds the relevant leyning key
 | ev | <code>Event</code> |  | event |
 | [il] | <code>boolean</code> | <code>false</code> | true if Israel holiday scheme |
 
+<a name="specialReadings"></a>
+
+## specialReadings(hd, il, aliyot, reason) ⇒ [<code>Aliyah</code>](#Aliyah) \| [<code>Array.&lt;Aliyah&gt;</code>](#Aliyah)
+Determines if the regular parashat haShavua coincides with an event that requires
+a special maftir or Haftara (for example Shabbat HaGadol, Shabbat Chanukah, Rosh
+Chodesh or Machar Chodesh, etc.).
+
+If a special maftir occurs, modifies `aliyot` to replace `M` and sets `reason.M`
+(and in some cases modifies the 6th and 7th aliyah, setting `reason['7']`).
+
+If a special Haftarah applies, returns the Haftarah object and sets `reason.haftara`.
+If no special Haftarah, returns `undefined`
+
+**Kind**: global function  
+
+| Param | Type |
+| --- | --- |
+| hd | <code>HDate</code> | 
+| il | <code>boolean</code> | 
+| aliyot | <code>Object.&lt;string, Aliyah&gt;</code> | 
+| reason | <code>Object.&lt;string, string&gt;</code> | 
+
 <a name="getLeyningForHoliday"></a>
 
 ## getLeyningForHoliday(ev, [il]) ⇒ [<code>Leyning</code>](#Leyning)
@@ -489,40 +411,20 @@ Returns the parsha metadata
 | --- | --- |
 | parsha | <code>string</code> \| <code>Array.&lt;string&gt;</code> | 
 
-<a name="getTriennial"></a>
-
-## getTriennial(year) ⇒ [<code>Triennial</code>](#Triennial)
-Calculates the 3-year readings for a given year
-
-**Kind**: global function  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| year | <code>number</code> | Hebrew year |
+<a name="writeCsvLines"></a>
 
-<a name="getTriennialForParshaHaShavua"></a>
-
-## getTriennialForParshaHaShavua(ev) ⇒ [<code>TriennialAliyot</code>](#TriennialAliyot)
-Looks up the triennial leyning for this Parashat HaShavua
+## writeCsvLines(stream, ev, reading, il, isParsha)
+Formats reading for CSV
 
 **Kind**: global function  
-**Returns**: [<code>TriennialAliyot</code>](#TriennialAliyot) - a map of aliyot 1-7 plus "M"  
 
 | Param | Type |
 | --- | --- |
+| stream | <code>fs.WriteStream</code> | 
 | ev | <code>Event</code> | 
-
-<a name="getTriennialHaftaraForHoliday"></a>
-
-## getTriennialHaftaraForHoliday(key, yearNum) ⇒ <code>Object</code>
-Looks up the alternative triennial Haftara for a holiday
-
-**Kind**: global function  
-
-| Param | Type |
-| --- | --- |
-| key | <code>string</code> | 
-| yearNum | <code>number</code> | 
+| reading | [<code>Leyning</code>](#Leyning) | 
+| il | <code>boolean</code> | 
+| isParsha | <code>boolean</code> | 
 
 <a name="Aliyah"></a>
 
@@ -594,20 +496,3 @@ Parsha metadata
 | [seph] | [<code>Aliyah</code>](#Aliyah) \| [<code>Array.&lt;Aliyah&gt;</code>](#Aliyah) | Haftarah object(s) for Sephardim |
 | fullkriyah | <code>Object.&lt;string, Array.&lt;string&gt;&gt;</code> | Map of aliyot `1` through `7` plus `M` for maftir |
 | weekday | <code>Object.&lt;string, Array.&lt;string&gt;&gt;</code> | Map of weekday Torah Readings    aliyot `1` through `3` for Monday and Thursday |
-
-<a name="TriennialAliyot"></a>
-
-## TriennialAliyot : <code>Object</code>
-Represents triennial aliyot for a given date
-
-**Kind**: global typedef  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| aliyot | <code>Object.&lt;string, Aliyah&gt;</code> | a map of aliyot 1-7 plus "M" |
-| yearNum | <code>number</code> | year number, 0-2 |
-| date | <code>Date</code> | Shabbat date for when this parsha is read in this 3-year cycle |
-| [readSeparately] | <code>boolean</code> | true if a double parsha is read separately in year `yearNum` |
-| [date1] | <code>Date</code> | Shabbat date of the first part of a read-separately aliyah pair |
-| [date2] | <code>Date</code> | Shabbat date of the second part of a read-separately aliyah pair |