@hebcal/core 6.5.1 → 6.5.3

package/dist/src/sedra.js

@@ -49,7 +49,23 @@ function yearType(hyear) {
     }
 }
 /**
- * Represents Parashah HaShavua for an entire Hebrew year
+ * Represents the weekly Torah-reading (Parashat HaShavua) schedule for an
+ * entire Hebrew year.
+ *
+ * The schedule depends on the year's *keviyah* — the day of week of Rosh
+ * Hashana, whether the year is leap, whether Cheshvan/Kislev are long or
+ * short, and whether the schedule is for Israel or the Diaspora (since
+ * Israel and the Diaspora diverge in some years when the 8th day of Pesach
+ * or the 2nd day of Shavuot fall on Shabbat).
+ *
+ * Prefer {@link getSedra} (or {@link HebrewCalendar.getSedra}) over
+ * calling this constructor directly, since both cache their results.
+ *
+ * @example
+ * import {Sedra, HDate, months} from '@hebcal/core';
+ * const sedra = new Sedra(5784, false);
+ * const result = sedra.lookup(new HDate(15, months.CHESHVAN, 5784));
+ * console.log(result.parsha); // ['Lech-Lecha']
  */
 export class Sedra {
     year;
@@ -59,7 +75,7 @@ export class Sedra {
     theSedraArray;
     yearKey;
     /**
-     * Caculates the Parashah HaShavua for an entire Hebrew year
+     * Calculates the Parashat HaShavua schedule for an entire Hebrew year.
      * @param hyear - Hebrew year (e.g. 5749)
      * @param il - Use Israel sedra schedule (false for Diaspora)
      */
@@ -89,8 +105,23 @@ export class Sedra {
         }
     }
     /**
-     * Returns the date that a parsha occurs
-     * or `null` if the parsha doesn't occur this year
+     * Returns the date a parsha is read this year, or `null` if it does not
+     * occur in this year's schedule.
+     *
+     * A doubled parsha (e.g. `'Matot-Masei'`) will only return a date in years
+     * where that pair is actually read together; in years where they are read
+     * separately, this returns `null`. Use {@link findContaining} to find the
+     * date a parsha is read regardless of whether it is doubled.
+     *
+     * Throws `RangeError` for an out-of-range numeric input or an invalid
+     * doubled-parsha pair, and `TypeError` for a malformed array argument.
+     * @example
+     * import {Sedra} from '@hebcal/core';
+     * const sedra = new Sedra(5784, false);
+     * sedra.find('Noach')?.toString();         // '15 Cheshvan 5784'
+     * sedra.find(1)?.toString();                // same, by 0-based index
+     * sedra.find('Matot-Masei')?.toString();   // null in 5784 — read separately
+     * sedra.find(['Matot', 'Masei']);          // also null in 5784
      * @param parsha if a `string`, specified with Sephardic transliterations
      *  like `'Noach'` or `'Matot-Masei'`. If an array, must be a 1- or 2-element
      *  array such as `['Noach']` or `['Matot', 'Masei']`. If a `number`, should
@@ -150,8 +181,22 @@ export class Sedra {
         return new HDate(this.firstSaturday + idx * 7);
     }
     /**
-     * Returns the date that a parsha (or its doubled or undoubled counterpart)
-     * occurs, or `null` if the parsha doesn't occur this year
+     * Returns the date a parsha is read this year, looking through both
+     * single and doubled forms.
+     *
+     * For example, if `'Matot'` is read individually this year, this returns
+     * its date; if it is read as part of `'Matot-Masei'` this year, this
+     * returns the date of `'Matot-Masei'` (and similarly for `'Masei'`).
+     * Conversely, asking for `'Matot-Masei'` in a year where they are split
+     * will return the date of `'Matot'` alone.
+     * @example
+     * import {Sedra} from '@hebcal/core';
+     * const sedra = new Sedra(5784, false);
+     * // Matot-Masei is split in 5784; both individual halves resolve:
+     * sedra.findContaining('Matot')?.toString();        // '22 Tamuz 5784'
+     * sedra.findContaining('Masei')?.toString();        // '29 Tamuz 5784'
+     * // Asking for the doubled name returns the date of the first half:
+     * sedra.findContaining('Matot-Masei')?.toString();  // '22 Tamuz 5784'
      */
     findContaining(parsha) {
         const hdate = this.find(parsha);
@@ -194,23 +239,50 @@ export class Sedra {
         }
     }
     /**
-     * Returns the underlying annual sedra schedule.
-     * Used by `@hebcal/triennial`
+     * Returns the underlying annual reading schedule as an array, where each
+     * entry corresponds to one Saturday (starting from the first Shabbat on
+     * or after Rosh Hashana). Entries are either:
+     * - a non-negative `number`: a 0-based parsha index (e.g. `0` for
+     *   *Bereshit*)
+     * - a negative `number`: the negated first index of a doubled parsha
+     *   (e.g. `-21` for *Vayakhel-Pekudei*)
+     * - a `string`: a holiday name when a Yom Tov displaces the weekly reading
+     *   (e.g. `'Pesach Shabbat Chol ha-Moed'`, `'Yom Kippur'`)
+     *
+     * Used by `@hebcal/triennial`.
      */
     getSedraArray() {
         return this.theSedraArray;
     }
     /**
-     * R.D. date of the first Saturday on or after Rosh Hashana
+     * Returns the R.D. (Rata Die / Fixed Date) absolute day number of the
+     * first Saturday on or after Rosh Hashana of this year. This is the
+     * anchor point for {@link getSedraArray} — index `0` of that array
+     * corresponds to this date.
      */
     getFirstSaturday() {
         return this.firstSaturday;
     }
+    /** Returns the Hebrew year this `Sedra` instance covers. */
     getYear() {
         return this.year;
     }
     /**
-     * Returns an object describing the parsha on the first Saturday on or after `hd`
+     * Returns details about the parsha read on the first Saturday on or after
+     * `hd`. If `hd` is itself a Saturday, the reading for that date is
+     * returned; otherwise the reading for the upcoming Saturday is returned.
+     *
+     * If the given date falls in the final days of the Hebrew year (after
+     * the last reading of this year's schedule), this method transparently
+     * delegates to the next year's `Sedra`.
+     * @example
+     * import {Sedra, HDate, months} from '@hebcal/core';
+     * const sedra = new Sedra(5784, false);
+     * // A weekday — returns the upcoming Shabbat's reading
+     * const result = sedra.lookup(new HDate(13, months.CHESHVAN, 5784));
+     * console.log(result.parsha); // ['Lech-Lecha']
+     * console.log(result.chag);   // false
+     * console.log(result.hdate.toString()); // '15 Cheshvan 5784' (Saturday)
      * @param hd Hebrew date or R.D. days
      */
     lookup(hd) {
@@ -467,10 +539,18 @@ types['1311'] = types['1221'];
 types['1721'] = types['170'];
 const sedraCache = new QuickLRU({ maxSize: 120 });
 /**
- * Convenience function to create an instance of `Sedra` or reuse a previously
- * created and cached instance.
- * @param hyear
- * @param il
+ * Convenience function to create an instance of {@link Sedra} or reuse a
+ * previously created and cached instance for the same year and schedule.
+ *
+ * Prefer this over `new Sedra(...)` when calling repeatedly — an internal
+ * LRU cache (~120 entries) avoids recomputing the keviyah-specific schedule.
+ * @example
+ * import {getSedra, HDate, months} from '@hebcal/core';
+ * const sedra = getSedra(5784, false);
+ * const {parsha} = sedra.lookup(new HDate(15, months.CHESHVAN, 5784));
+ * console.log(parsha); // ['Lech-Lecha']
+ * @param hyear Hebrew year
+ * @param il Use Israel sedra schedule (`false` for Diaspora)
  */
 export function getSedra(hyear, il) {
     const cacheKey = `${hyear}-${il ? 1 : 0}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hebcal/core",
-  "version": "6.5.1",
+  "version": "6.5.3",
   "author": "Michael J. Radwin (https://github.com/mjradwin)",
   "contributors": [
     "Eyal Schachter (https://github.com/Scimonster)",
@@ -46,7 +46,8 @@
   },
   "homepage": "https://hebcal.github.io/api/core/",
   "files": [
-    "dist"
+    "dist",
+    "po"
   ],
   "scripts": {
     "build:rollup": "rollup -c",
@@ -67,25 +68,28 @@
     "prepare": "npm run compile"
   },
   "license": "GPL-2.0",
+  "overrides": {
+    "tmp": "^0.2.6"
+  },
   "devDependencies": {
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^1.0.0",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@types/node": "^25.8.0",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@types/node": "^25.9.2",
+    "@vitest/coverage-v8": "^4.1.8",
     "gettext-parser": "^9.0.2",
     "gts": "^7.0.0",
     "pretty-bytes": "^7.1.0",
-    "rollup": "^4.60.4",
+    "rollup": "^4.61.1",
     "rollup-plugin-bundle-size": "^1.0.3",
     "rollup-plugin-visualizer": "^7.0.1",
     "typedoc": "^0.28.19",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.8"
   },
   "dependencies": {
-    "@hebcal/hdate": "^0.22.2",
+    "@hebcal/hdate": "^0.22.3",
     "@hebcal/noaa": "^0.11.0",
     "quick-lru": "^7.3.0",
     "temporal-polyfill": "^0.3.2"

package/po/ashkenazi.po

@@ -0,0 +1,240 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR Danny Sadinoff
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: hebcal 4.2\n"
+"Report-Msgid-Bugs-To: hebcal-bugs@sadinoff.com\n"
+"POT-Creation-Date: 2015-12-30 14:54-0500\n"
+"PO-Revision-Date: 2020-05-03 11:18-0800\n"
+"Language: en_CA@ashkenazi\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Last-Translator: \n"
+"Language-Team: \n"
+"X-Generator: Poedit 1.8.6\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+
+#: ../dafyomi.c:27
+msgid "Shabbat"
+msgstr "Shabbos"
+
+msgid "Achrei Mot"
+msgstr "Achrei Mos"
+
+msgid "Bechukotai"
+msgstr "Bechukosai"
+
+msgid "Beha'alotcha"
+msgstr "Beha’aloscha"
+
+msgid "Bereshit"
+msgstr "Bereshis"
+
+msgid "Chukat"
+msgstr "Chukas"
+
+msgid "Erev Shavuot"
+msgstr "Erev Shavuos"
+
+msgid "Erev Sukkot"
+msgstr "Erev Sukkos"
+
+msgid "Ki Tavo"
+msgstr "Ki Savo"
+
+msgid "Ki Teitzei"
+msgstr "Ki Seitzei"
+
+msgid "Ki Tisa"
+msgstr "Ki Sisa"
+
+msgid "Matot"
+msgstr "Matos"
+
+msgid "Pesach Shabbat Chol ha-Moed"
+msgstr "Pesach Shabbos Chol ha-Moed"
+
+msgid "Purim Katan"
+msgstr "Purim Koton"
+
+msgid "Rosh Hashana LaBehemot"
+msgstr "Rosh Hashana LaBeheimos"
+
+msgid "Shabbat Chazon"
+msgstr "Shabbos Chazon"
+
+msgid "Shabbat HaChodesh"
+msgstr "Shabbos HaChodesh"
+
+msgid "Shabbat HaGadol"
+msgstr "Shabbos HaGadol"
+
+msgid "Shabbat Nachamu"
+msgstr "Shabbos Nachamu"
+
+msgid "Shabbat Parah"
+msgstr "Shabbos Parah"
+
+msgid "Shabbat Shekalim"
+msgstr "Shabbos Shekalim"
+
+msgid "Shabbat Shuva"
+msgstr "Shabbos Shuvah"
+
+msgid "Shabbat Zachor"
+msgstr "Shabbos Zachor"
+
+msgid "Shavuot"
+msgstr "Shavuos"
+
+msgid "Shavuot I"
+msgstr "Shavuos I"
+
+msgid "Shavuot II"
+msgstr "Shavuos II"
+
+msgid "Shemot"
+msgstr "Shemos"
+
+msgid "Shmini Atzeret"
+msgstr "Shmini Atzeres"
+
+msgid "Simchat Torah"
+msgstr "Simchas Torah"
+
+msgid "Sukkot"
+msgstr "Sukkos"
+
+msgid "Sukkot I"
+msgstr "Sukkos I"
+
+msgid "Sukkot II"
+msgstr "Sukkos II"
+
+msgid "Sukkot II (CH''M)"
+msgstr "Sukkos II (CH’’M)"
+
+msgid "Sukkot III (CH''M)"
+msgstr "Sukkos III (CH’’M)"
+
+msgid "Sukkot IV (CH''M)"
+msgstr "Sukkos IV (CH’’M)"
+
+msgid "Sukkot V (CH''M)"
+msgstr "Sukkos V (CH’’M)"
+
+msgid "Sukkot VI (CH''M)"
+msgstr "Sukkos VI (CH’’M)"
+
+msgid "Sukkot VII (Hoshana Raba)"
+msgstr "Sukkos VII (Hoshana Raba)"
+
+msgid "Sukkot Shabbat Chol ha-Moed"
+msgstr "Sukkos Shabbos Chol ha-Moed"
+
+msgid "Ta'anit Bechorot"
+msgstr "Ta’anis Bechoros"
+
+msgid "Ta'anit BeHaB"
+msgstr "Ta’anis BeHaB"
+
+msgid "Ta'anit Esther"
+msgstr "Ta’anis Esther"
+
+msgid "Toldot"
+msgstr "Toldos"
+
+msgid "Vaetchanan"
+msgstr "Vaeschanan"
+
+msgid "Yitro"
+msgstr "Yisro"
+
+msgid "Vezot Haberakhah"
+msgstr "Vezos Haberakhah"
+
+msgid "Parashat"
+msgstr "Parshas"
+
+msgid "Leil Selichot"
+msgstr "Leil Selichos"
+
+msgid "Shabbat Mevarchim Chodesh"
+msgstr "Shabbos Mevorchim Chodesh"
+
+msgid "Shabbat Shirah"
+msgstr "Shabbos Shirah"
+
+msgid "Asara B'Tevet"
+msgstr "Asara B’Teves"
+
+msgid "Birkat Hachamah"
+msgstr "Birkas HaChamah"
+
+msgid "Birkat HaChamah"
+msgstr "Birkas HaChamah"
+
+msgid "Shushan Purim Katan"
+msgstr "Shushan Purim Koton"
+
+# hebcal/hebcal zmanim (unused by hebcal/hebcal-es6)
+msgid "Alot HaShachar"
+msgstr "Alos HaShachar"
+
+msgid "Misheyakir"
+msgstr "Misheyakir"
+
+msgid "Misheyakir Machmir"
+msgstr "Misheyakir Machmir"
+
+msgid "Sunrise"
+msgstr "Sunrise"
+
+msgid "Kriat Shema, sof zeman"
+msgstr "Krias Shema, sof zman"
+
+msgid "Tefilah, sof zeman"
+msgstr "Tefilah, sof zman"
+
+msgid "Kriat Shema, sof zeman (MGA)"
+msgstr "Krias Shema, sof zman (MGA)"
+
+msgid "Kriat Shema, sof zeman (GRA)"
+msgstr "Krias Shema, sof zman (GRA)"
+
+msgid "Tefilah, sof zeman (MGA)"
+msgstr "Tefilah, sof zman (MGA)"
+
+msgid "Tefilah, sof zeman (GRA)"
+msgstr "Tefilah, sof zman (GRA)"
+
+msgid "Chatzot HaLailah"
+msgstr "Chatzos HaLailah"
+
+msgid "Chatzot HaYom"
+msgstr "Chatzos"
+
+msgid "Chatzot hayom"
+msgstr "Chatzos"
+
+msgid "Mincha Gedolah"
+msgstr "Mincha Gedolah"
+
+msgid "Mincha Ketanah"
+msgstr "Mincha Ketanah"
+
+msgid "Plag HaMincha"
+msgstr "Plag HaMincha"
+
+msgid "Sunset"
+msgstr "Sunset"
+
+msgid "Bein HaShemashot"
+msgstr "Bein HaShemashos"
+
+msgid "Tzeit HaKochavim"
+msgstr "Tzeis HaKochavim"

package/po/he-x-NoNikud.po

@@ -0,0 +1,58 @@
+msgid ""
+msgstr ""
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Language: he-x-NoNikud\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+msgid "Korach"
+msgstr "קורח"
+
+msgid "Chukat"
+msgstr "חוקת"
+
+msgid "Erev Yom Kippur"
+msgstr "ערב יום כיפור"
+
+msgid "Yom Kippur"
+msgstr "יום כיפור"
+
+msgid "Yom Kippur Katan"
+msgstr "יום כיפור קטן"
+
+msgid "Pesach Shabbat Chol ha-Moed"
+msgstr "פסח שבת חול המועד"
+
+msgid "Sukkot Shabbat Chol ha-Moed"
+msgstr "סוכות שבת חול המועד"
+
+msgid "Erev Sukkot"
+msgstr "ערב סוכות"
+
+msgid "Sukkot"
+msgstr "סוכות"
+
+msgid "Sukkot I"
+msgstr "סוכות א׳"
+
+msgid "Sukkot II"
+msgstr "סוכות ב׳"
+
+msgid "Sukkot II (CH''M)"
+msgstr "סוכות ב׳ (חוה״מ)"
+
+msgid "Sukkot III (CH''M)"
+msgstr "סוכות ג׳ (חוה״מ)"
+
+msgid "Sukkot IV (CH''M)"
+msgstr "סוכות ד׳ (חוה״מ)"
+
+msgid "Sukkot V (CH''M)"
+msgstr "סוכות ה׳ (חוה״מ)"
+
+msgid "Sukkot VI (CH''M)"
+msgstr "סוכות ו׳ (חוה״מ)"
+
+msgid "Sukkot VII (Hoshana Raba)"
+msgstr "סוכות ז׳ (הושענא רבה)"