@hebcal/core 6.5.1 → 6.5.3

package/dist/esm/sedra.js.map

@@ -1 +1 @@
-{"version":3,"file":"sedra.js","sources":["../../../src/sedra.ts"],"sourcesContent":["/*\n    Hebcal - A Jewish Calendar Generator\n    Copyright (c) 1994-2020 Danny Sadinoff\n    Portions copyright Eyal Schachter and Michael J. Radwin\n\n    https://github.com/hebcal/hebcal-es6\n\n    This program is free software; you can redistribute it and/or\n    modify it under the terms of the GNU General Public License\n    as published by the Free Software Foundation; either version 2\n    of the License, or (at your option) any later version.\n\n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU General Public License for more details.\n\n    You should have received a copy of the GNU General Public License\n    along with this program. If not, see <http://www.gnu.org/licenses/>.\n */\n\n/*\n * Many of the following algorithms were taken from hebrew calendar\n * routines by Maimonedes, from his Mishneh Torah, and implemented by\n *  Nachum Dershowitz                Department of Computer Science\n *  (217) 333-4219                   University of Illinois at Urbana-Champaign\n *  nachum@cs.uiuedu               1304 West Springfield Avenue\n *                                   Urbana, Illinois 61801\n *\n * The routines were included in the emacs 19 distribution.\n *\n */\nimport {HDate, months} from '@hebcal/hdate';\nimport QuickLRU from 'quick-lru';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst INCOMPLETE = 0;\nconst REGULAR = 1;\nconst COMPLETE = 2;\n\nfunction yearType(hyear: number): number {\n  const longC = HDate.longCheshvan(hyear);\n  const shortK = HDate.shortKislev(hyear);\n  if (longC && !shortK) {\n    return COMPLETE;\n  } else if (!longC && shortK) {\n    return INCOMPLETE;\n  } else {\n    return REGULAR;\n  }\n}\n\n/** The result from `Sedra.lookup()` */\nexport type SedraResult = {\n  /**\n   * Name of the parsha (or parshiyot) read on\n   * Hebrew date, e.g. `['Noach']` or `['Matot', 'Masei']`\n   */\n  parsha: string[];\n  /**\n   * False if this is a regular parashat HaShavua reading.\n   * True if it's a special holiday reading.\n   */\n  chag: boolean;\n  /**\n   * The parsha number (or numbers) using 1-indexing.\n   * A `number` for a regular (single) parsha, and a `number[]`\n   * for a doubled parsha.\n   * For Parashat *Bereshit*, `num` would be equal to `1`, and for\n   * *Matot-Masei* it would be `[42, 43]`\n   * For a chag (holiday) reading, `num` will be `0`.\n   */\n  num: number | number[];\n  /** The date of the Shabbat this parsha is read */\n  hdate: HDate;\n  /** true if Israel, false for Diaspora */\n  il: boolean;\n};\n\n/**\n * Represents Parashah HaShavua for an entire Hebrew year\n */\nexport class Sedra {\n  private readonly year: number;\n  private readonly il: boolean;\n  private readonly rh: number;\n  private readonly firstSaturday: number;\n  private readonly theSedraArray: readonly NumberOrString[];\n  private readonly yearKey: string;\n  /**\n   * Caculates the Parashah HaShavua for an entire Hebrew year\n   * @param hyear - Hebrew year (e.g. 5749)\n   * @param il - Use Israel sedra schedule (false for Diaspora)\n   */\n  constructor(hyear: number, il: boolean) {\n    hyear = +hyear;\n    this.year = hyear;\n\n    const rh0 = new HDate(1, months.TISHREI, hyear);\n    const rh = (this.rh = rh0.abs());\n    const rhDay = rh0.getDay() + 1;\n\n    // find the first Saturday on or after Rosh Hashana\n    this.firstSaturday = HDate.dayOnOrBefore(6, rh + 6);\n    const leap = +HDate.isLeapYear(hyear);\n    this.il = Boolean(il);\n\n    const type = yearType(hyear);\n    let key = `${leap}${rhDay}${type}`;\n    if (types[key]) {\n      this.theSedraArray = types[key];\n      this.yearKey = key;\n    } else {\n      key = key + +this.il; // cast to num, then concat\n      this.theSedraArray = types[key];\n      this.yearKey = key;\n    }\n\n    if (!this.theSedraArray) {\n      throw new Error(\n        `improper sedra year type ${key} calculated for ${hyear}`\n      );\n    }\n  }\n\n  /**\n   * Returns the date that a parsha occurs\n   * or `null` if the parsha doesn't occur this year\n   * @param parsha if a `string`, specified with Sephardic transliterations\n   *  like `'Noach'` or `'Matot-Masei'`. If an array, must be a 1- or 2-element\n   *  array such as `['Noach']` or `['Matot', 'Masei']`. If a `number`, should\n   *  be a 0-based parsha index (`0` for Bereshit, `1` for Noach) or a negative\n   *  number for a doubled parsha (e.g. `-21` for Vayakhel-Pekudei)\n   */\n  find(parsha: number | string | string[]): HDate | null {\n    if (typeof parsha === 'number') {\n      if (parsha >= parshiot.length || (parsha < 0 && !isValidDouble(parsha))) {\n        throw new RangeError(`Invalid parsha number: ${parsha}`);\n      }\n      return this.findInternal(parsha);\n    } else if (typeof parsha === 'string') {\n      const num = parsha2id.get(parsha);\n      if (typeof num === 'number') {\n        return this.find(num);\n      } else if (parsha.includes('-')) {\n        if (parsha === CHMPESACH || parsha === CHMSUKOT) {\n          return this.findInternal(parsha);\n        }\n        return this.find(parsha.split('-'));\n      } else {\n        // try to find Saturday holiday like 'Yom Kippur'\n        return this.findInternal(parsha);\n      }\n    } else if (Array.isArray(parsha)) {\n      const plen = parsha.length;\n      if ((plen !== 1 && plen !== 2) || typeof parsha[0] !== 'string') {\n        throw new TypeError(\n          `Invalid parsha argument: ${JSON.stringify(parsha)}`\n        );\n      }\n      if (plen === 1) {\n        return this.find(parsha[0]);\n      }\n      const p1 = parsha[0];\n      const p2 = parsha[1];\n      const num1 = parsha2id.get(p1);\n      const num2 = parsha2id.get(p2);\n      if (\n        typeof num1 !== 'number' ||\n        typeof num2 !== 'number' ||\n        num2 !== num1 + 1 ||\n        !isValidDouble(-num1)\n      ) {\n        throw new RangeError(`Unrecognized parsha name: ${p1}-${p2}`);\n      }\n      return this.find(-num1);\n    }\n    return null; /* NOTREACHED */\n  }\n\n  private findInternal(parsha: NumberOrString): HDate | null {\n    const idx = this.theSedraArray.indexOf(parsha);\n    if (idx === -1) {\n      return null; // doesn't occur this year\n    }\n    return new HDate(this.firstSaturday + idx * 7);\n  }\n\n  /**\n   * Returns the date that a parsha (or its doubled or undoubled counterpart)\n   * occurs, or `null` if the parsha doesn't occur this year\n   */\n  findContaining(parsha: number | string): HDate | null {\n    const hdate = this.find(parsha);\n    if (hdate) {\n      return hdate;\n    }\n    if (typeof parsha === 'number') {\n      // a valid negative number (double parsha in a year where they are\n      // combined) would've been found above, and a invalid negative number\n      // would've thrown an error, so this parsha must be a positive number\n      // representing either p1 or p2\n      const p1 = -parsha;\n      if (isValidDouble(p1)) {\n        return this.find(p1);\n      } else {\n        // this must be the second individual parsha of a doubled pair\n        // for example 29 for Kedoshim, so check for -28 for Achrei Mot-Kedoshim\n        return this.find(p1 + 1);\n      }\n    } else {\n      const num = parsha2id.get(parsha);\n      if (num) {\n        // parsha is either the first or second individual parsha of\n        // a pair that is doubled this year\n        const p1 = -num;\n        if (isValidDouble(p1)) {\n          return this.find(p1);\n        } else {\n          return this.find(p1 + 1);\n        }\n      } else {\n        // this was indeed a doubled parsha, so return date of the first half\n        const [p1] = parsha.split('-');\n        return this.find(p1);\n      }\n    }\n  }\n\n  /**\n   * Returns the underlying annual sedra schedule.\n   * Used by `@hebcal/triennial`\n   */\n  getSedraArray(): readonly NumberOrString[] {\n    return this.theSedraArray;\n  }\n\n  /**\n   * R.D. date of the first Saturday on or after Rosh Hashana\n   */\n  getFirstSaturday(): number {\n    return this.firstSaturday;\n  }\n\n  getYear(): number {\n    return this.year;\n  }\n\n  /**\n   * Returns an object describing the parsha on the first Saturday on or after `hd`\n   * @param hd Hebrew date or R.D. days\n   */\n  lookup(hd: HDate | number): SedraResult {\n    const abs =\n      typeof hd === 'number' ? hd : HDate.isHDate(hd) ? hd.abs() : NaN;\n\n    if (isNaN(abs)) {\n      throw new TypeError(`Bad date argument: ${hd}`);\n    } else if (abs < this.rh) {\n      throw new RangeError(\n        `Date ${hd} before start of Hebrew year ${this.year}`\n      );\n    }\n\n    // find the first saturday on or after today's date\n    const saturday = HDate.dayOnOrBefore(6, abs + 6);\n\n    const weekNum = (saturday - this.firstSaturday) / 7;\n    const index = this.theSedraArray[weekNum];\n\n    if (index === undefined) {\n      const sedra = getSedra(this.year + 1, this.il);\n      return sedra.lookup(saturday); // must be next year\n    }\n    const hdate = new HDate(saturday);\n    if (typeof index === 'string') {\n      // Shabbat has a chag. Return a description\n      return {parsha: [index], chag: true, hdate, il: this.il, num: 0};\n    }\n    if (index >= 0) {\n      return {\n        parsha: [parshiot[index]],\n        chag: false,\n        num: index + 1,\n        hdate,\n        il: this.il,\n      };\n    }\n\n    const p1 = D(index); // undouble the parsha\n    return {\n      parsha: [parshiot[p1], parshiot[p1 + 1]],\n      chag: false,\n      num: [p1 + 1, p1 + 2],\n      hdate,\n      il: this.il,\n    };\n  }\n}\n\n/**\n * The 54 parshiyot of the Torah as transilterated strings.\n * * parshiot[0] == `Bereshit`\n * * parshiot[1] == `Noach`\n * * parshiot[52] == `Ha'azinu`\n * * parshiot[53] == `Vezot Haberakhah`\n * @readonly\n * @type {string[]}\n */\nexport const parshiot: readonly string[] = [\n  'Bereshit',\n  'Noach',\n  'Lech-Lecha',\n  'Vayera',\n  'Chayei Sara',\n  'Toldot',\n  'Vayetzei',\n  'Vayishlach',\n  'Vayeshev',\n  'Miketz',\n  'Vayigash',\n  'Vayechi',\n  'Shemot',\n  'Vaera',\n  'Bo',\n  'Beshalach',\n  'Yitro',\n  'Mishpatim',\n  'Terumah',\n  'Tetzaveh',\n  'Ki Tisa',\n  'Vayakhel',\n  'Pekudei',\n  'Vayikra',\n  'Tzav',\n  'Shmini',\n  'Tazria',\n  'Metzora',\n  'Achrei Mot',\n  'Kedoshim',\n  'Emor',\n  'Behar',\n  'Bechukotai',\n  'Bamidbar',\n  'Nasso',\n  \"Beha'alotcha\",\n  \"Sh'lach\",\n  'Korach',\n  'Chukat',\n  'Balak',\n  'Pinchas',\n  'Matot',\n  'Masei',\n  'Devarim',\n  'Vaetchanan',\n  'Eikev',\n  \"Re'eh\",\n  'Shoftim',\n  'Ki Teitzei',\n  'Ki Tavo',\n  'Nitzavim',\n  'Vayeilech',\n  \"Ha'azinu\",\n  'Vezot Haberakhah',\n] as const;\n\n// 0-based parsha IDs\nconst parsha2id = new Map<string, number>();\nfor (let id = 0; id < parshiot.length; id++) {\n  const name = parshiot[id];\n  parsha2id.set(name, id);\n}\n\n// 0-based parsha IDs\nconst doubles = new Set([\n  21, // Vayakhel-Pekudei\n  26, // Tazria-Metzora\n  28, // Achrei Mot-Kedoshim\n  31, // Behar-Bechukotai\n  38, // Chukat-Balak\n  41, // Matot-Masei\n  50, // Nitzavim-Vayeilech\n]);\n\n/**\n * @private\n * @param id a negative number\n */\nfunction isValidDouble(id: number): boolean {\n  return doubles.has(-id);\n}\n\n/**\n * parsha doubler/undoubler\n * @private\n * @param p\n */\nfunction D(p: number): number {\n  return -p;\n}\n\nconst RH = 'Rosh Hashana'; // 0\nconst YK = 'Yom Kippur'; // 1\n\nconst SUKKOT = 'Sukkot'; // 0\nconst CHMSUKOT = 'Sukkot Shabbat Chol ha-Moed'; // 0\nconst SHMINI = 'Shmini Atzeret'; // 0\n\nconst PESACH = 'Pesach'; // 25\nconst PESACH1 = 'Pesach I';\nconst CHMPESACH = 'Pesach Shabbat Chol ha-Moed'; // 25\nconst PESACH7 = 'Pesach VII'; // 25\nconst PESACH8 = 'Pesach VIII';\nconst SHAVUOT = 'Shavuot'; // 33\n\n/**\n * Returns an array from start to end\n * @private\n * @param start beginning number, inclusive\n * @param stop ending number, inclusive\n */\nfunction range(start: number, stop: number): readonly number[] {\n  return Array.from({length: stop - start + 1}, (v, k) => k + start);\n}\n\ntype NumberOrString = number | string;\n\nconst yearStartVayeilech: readonly NumberOrString[] = [51, 52, CHMSUKOT];\nconst yearStartHaazinu: readonly NumberOrString[] = [52, YK, CHMSUKOT];\nconst yearStartRH: readonly NumberOrString[] = [RH, 52, SUKKOT, SHMINI];\nconst r020 = range(0, 20);\nconst r027 = range(0, 27);\nconst r3340 = range(33, 40);\nconst r4349 = range(43, 49);\nconst r4350 = range(43, 50);\n\n/**\n * The ordinary year types (keviot)\n * names are leap/nonleap - day - incomplete/regular/complete - diaspora/Israel\n * @private\n * @readonly\n */\nconst types: Record<string, readonly NumberOrString[]> = {\n  /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and\n   * Kislev each have 29 days), and has Passover start on Tuesday. */\n  // e.g. 5753\n  '020': yearStartVayeilech.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    CHMPESACH,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Monday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Thursday. */\n  // e.g. 5756\n  '0220': yearStartVayeilech.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    CHMPESACH,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    33,\n    SHAVUOT,\n    range(34, 37),\n    D(38),\n    40,\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Thursday, is `regular' (Heshvan has 29\n   * days and Kislev has 30 days), and has Passover start on Saturday. */\n  // e.g. 5701\n  '0510': yearStartHaazinu.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    PESACH1,\n    PESACH8,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Thursday, is `regular' (Heshvan has 29\n   * days and Kislev has 30 days), and has Passover start on Saturday. */\n  // e.g. 5745\n  '0511': yearStartHaazinu.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    PESACH,\n    25,\n    D(26),\n    D(28),\n    range(30, 40),\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Thursday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Sunday. */\n  // e.g. 5754\n  '052': yearStartHaazinu.concat(\n    range(0, 24),\n    PESACH7,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Saturday, is `incomplete' (Heshvan and Kislev\n   * each have 29 days), and has Passover start on Sunday. */\n  // e.g. 5761\n  '070': yearStartRH.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    PESACH7,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Saturday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Tuesday. */\n  // e.g. 5716\n  '072': yearStartRH.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    CHMPESACH,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* --  The leap year types (keviot) -- */\n  /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and\n   * Kislev each have 29 days), and has Passover start on Thursday. */\n  // e.g. 5746\n  '1200': yearStartVayeilech.concat(\n    r027,\n    CHMPESACH,\n    range(28, 33),\n    SHAVUOT,\n    range(34, 37),\n    D(38),\n    40,\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and\n   * Kislev each have 29 days), and has Passover start on Thursday. */\n  // e.g. 5746\n  '1201': yearStartVayeilech.concat(\n    r027,\n    CHMPESACH,\n    range(28, 40),\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Monday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Saturday. */\n  // e.g.5752\n  '1220': yearStartVayeilech.concat(\n    r027,\n    PESACH1,\n    PESACH8,\n    range(28, 40),\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Monday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Saturday. */\n  // e.g.5752\n  '1221': yearStartVayeilech.concat(r027, PESACH, range(28, 50)),\n\n  /* Hebrew year that starts on Thursday, is `incomplete' (Heshvan and\n   * Kislev both have 29 days), and has Passover start on Sunday. */\n  // e.g. 5768\n  '150': yearStartHaazinu.concat(range(0, 28), PESACH7, range(29, 50)),\n\n  /* Hebrew year that starts on Thursday, is `complete' (Heshvan and\n   * Kislev both have 30 days), and has Passover start on Tuesday. */\n  // eg. 5771\n  '152': yearStartHaazinu.concat(range(0, 28), CHMPESACH, range(29, 49), D(50)),\n\n  /* Hebrew year that starts on Saturday, is `incomplete' (Heshvan and\n   * Kislev each have 29 days), and has Passover start on Tuesday. */\n  // e.g.5757\n  '170': yearStartRH.concat(\n    r027,\n    CHMPESACH,\n    range(28, 40),\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Saturday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Thursday. */\n  '1720': yearStartRH.concat(\n    r027,\n    CHMPESACH,\n    range(28, 33),\n    SHAVUOT,\n    range(34, 37),\n    D(38),\n    40,\n    D(41),\n    r4349,\n    D(50)\n  ),\n} as const;\n\n/* Hebrew year that starts on Monday, is `complete' (Heshvan and\n * Kislev each have 30 days), and has Passover start on Thursday. */\ntypes['0221'] = types['020'];\n\n/* Hebrew year that starts on Tuesday, is `regular' (Heshvan has 29\n * days and Kislev has 30 days), and has Passover start on Thursday. */\n// e.g. 5715\ntypes['0310'] = types['0220'];\n\n/* Hebrew year that starts on Tuesday, is `regular' (Heshvan has 29\n * days and Kislev has 30 days), and has Passover start on Thursday. */\ntypes['0311'] = types['020'];\n\n/* Hebrew year that starts on Tuesday, is `regular' (Heshvan has 29\n * days and Kislev has 30 days), and has Passover start on Saturday. */\n// e.g. 5715\ntypes['1310'] = types['1220'];\n/* Hebrew year that starts on Tuesday, is `regular' (Heshvan has 29\n * days and Kislev has 30 days), and has Passover start on Saturday. */\ntypes['1311'] = types['1221'];\n\n/* Hebrew year that starts on Saturday, is `complete' (Heshvan and\n * Kislev each have 30 days), and has Passover start on Thursday. */\ntypes['1721'] = types['170'];\n\nconst sedraCache = new QuickLRU<string, Sedra>({maxSize: 120});\n\n/**\n * Convenience function to create an instance of `Sedra` or reuse a previously\n * created and cached instance.\n * @param hyear\n * @param il\n */\nexport function getSedra(hyear: number, il: boolean): Sedra {\n  const cacheKey = `${hyear}-${il ? 1 : 0}`;\n  let sedra = sedraCache.get(cacheKey);\n  if (!sedra) {\n    sedra = new Sedra(hyear, il);\n    sedraCache.set(cacheKey, sedra);\n  }\n  return sedra;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"sedra.js","sources":["../../../src/sedra.ts"],"sourcesContent":["/*\n    Hebcal - A Jewish Calendar Generator\n    Copyright (c) 1994-2020 Danny Sadinoff\n    Portions copyright Eyal Schachter and Michael J. Radwin\n\n    https://github.com/hebcal/hebcal-es6\n\n    This program is free software; you can redistribute it and/or\n    modify it under the terms of the GNU General Public License\n    as published by the Free Software Foundation; either version 2\n    of the License, or (at your option) any later version.\n\n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU General Public License for more details.\n\n    You should have received a copy of the GNU General Public License\n    along with this program. If not, see <http://www.gnu.org/licenses/>.\n */\n\n/*\n * Many of the following algorithms were taken from hebrew calendar\n * routines by Maimonedes, from his Mishneh Torah, and implemented by\n *  Nachum Dershowitz                Department of Computer Science\n *  (217) 333-4219                   University of Illinois at Urbana-Champaign\n *  nachum@cs.uiuedu               1304 West Springfield Avenue\n *                                   Urbana, Illinois 61801\n *\n * The routines were included in the emacs 19 distribution.\n *\n */\nimport {HDate, months} from '@hebcal/hdate';\nimport QuickLRU from 'quick-lru';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst INCOMPLETE = 0;\nconst REGULAR = 1;\nconst COMPLETE = 2;\n\nfunction yearType(hyear: number): number {\n  const longC = HDate.longCheshvan(hyear);\n  const shortK = HDate.shortKislev(hyear);\n  if (longC && !shortK) {\n    return COMPLETE;\n  } else if (!longC && shortK) {\n    return INCOMPLETE;\n  } else {\n    return REGULAR;\n  }\n}\n\n/** The result from `Sedra.lookup()` */\nexport type SedraResult = {\n  /**\n   * Name of the parsha (or parshiyot) read on\n   * Hebrew date, e.g. `['Noach']` or `['Matot', 'Masei']`\n   */\n  parsha: string[];\n  /**\n   * False if this is a regular parashat HaShavua reading.\n   * True if it's a special holiday reading.\n   */\n  chag: boolean;\n  /**\n   * The parsha number (or numbers) using 1-indexing.\n   * A `number` for a regular (single) parsha, and a `number[]`\n   * for a doubled parsha.\n   * For Parashat *Bereshit*, `num` would be equal to `1`, and for\n   * *Matot-Masei* it would be `[42, 43]`\n   * For a chag (holiday) reading, `num` will be `0`.\n   */\n  num: number | number[];\n  /** The date of the Shabbat this parsha is read */\n  hdate: HDate;\n  /** true if Israel, false for Diaspora */\n  il: boolean;\n};\n\n/**\n * Represents the weekly Torah-reading (Parashat HaShavua) schedule for an\n * entire Hebrew year.\n *\n * The schedule depends on the year's *keviyah* — the day of week of Rosh\n * Hashana, whether the year is leap, whether Cheshvan/Kislev are long or\n * short, and whether the schedule is for Israel or the Diaspora (since\n * Israel and the Diaspora diverge in some years when the 8th day of Pesach\n * or the 2nd day of Shavuot fall on Shabbat).\n *\n * Prefer {@link getSedra} (or {@link HebrewCalendar.getSedra}) over\n * calling this constructor directly, since both cache their results.\n *\n * @example\n * import {Sedra, HDate, months} from '@hebcal/core';\n * const sedra = new Sedra(5784, false);\n * const result = sedra.lookup(new HDate(15, months.CHESHVAN, 5784));\n * console.log(result.parsha); // ['Lech-Lecha']\n */\nexport class Sedra {\n  private readonly year: number;\n  private readonly il: boolean;\n  private readonly rh: number;\n  private readonly firstSaturday: number;\n  private readonly theSedraArray: readonly NumberOrString[];\n  private readonly yearKey: string;\n  /**\n   * Calculates the Parashat HaShavua schedule for an entire Hebrew year.\n   * @param hyear - Hebrew year (e.g. 5749)\n   * @param il - Use Israel sedra schedule (false for Diaspora)\n   */\n  constructor(hyear: number, il: boolean) {\n    hyear = +hyear;\n    this.year = hyear;\n\n    const rh0 = new HDate(1, months.TISHREI, hyear);\n    const rh = (this.rh = rh0.abs());\n    const rhDay = rh0.getDay() + 1;\n\n    // find the first Saturday on or after Rosh Hashana\n    this.firstSaturday = HDate.dayOnOrBefore(6, rh + 6);\n    const leap = +HDate.isLeapYear(hyear);\n    this.il = Boolean(il);\n\n    const type = yearType(hyear);\n    let key = `${leap}${rhDay}${type}`;\n    if (types[key]) {\n      this.theSedraArray = types[key];\n      this.yearKey = key;\n    } else {\n      key = key + +this.il; // cast to num, then concat\n      this.theSedraArray = types[key];\n      this.yearKey = key;\n    }\n\n    if (!this.theSedraArray) {\n      throw new Error(\n        `improper sedra year type ${key} calculated for ${hyear}`\n      );\n    }\n  }\n\n  /**\n   * Returns the date a parsha is read this year, or `null` if it does not\n   * occur in this year's schedule.\n   *\n   * A doubled parsha (e.g. `'Matot-Masei'`) will only return a date in years\n   * where that pair is actually read together; in years where they are read\n   * separately, this returns `null`. Use {@link findContaining} to find the\n   * date a parsha is read regardless of whether it is doubled.\n   *\n   * Throws `RangeError` for an out-of-range numeric input or an invalid\n   * doubled-parsha pair, and `TypeError` for a malformed array argument.\n   * @example\n   * import {Sedra} from '@hebcal/core';\n   * const sedra = new Sedra(5784, false);\n   * sedra.find('Noach')?.toString();         // '15 Cheshvan 5784'\n   * sedra.find(1)?.toString();                // same, by 0-based index\n   * sedra.find('Matot-Masei')?.toString();   // null in 5784 — read separately\n   * sedra.find(['Matot', 'Masei']);          // also null in 5784\n   * @param parsha if a `string`, specified with Sephardic transliterations\n   *  like `'Noach'` or `'Matot-Masei'`. If an array, must be a 1- or 2-element\n   *  array such as `['Noach']` or `['Matot', 'Masei']`. If a `number`, should\n   *  be a 0-based parsha index (`0` for Bereshit, `1` for Noach) or a negative\n   *  number for a doubled parsha (e.g. `-21` for Vayakhel-Pekudei)\n   */\n  find(parsha: number | string | string[]): HDate | null {\n    if (typeof parsha === 'number') {\n      if (parsha >= parshiot.length || (parsha < 0 && !isValidDouble(parsha))) {\n        throw new RangeError(`Invalid parsha number: ${parsha}`);\n      }\n      return this.findInternal(parsha);\n    } else if (typeof parsha === 'string') {\n      const num = parsha2id.get(parsha);\n      if (typeof num === 'number') {\n        return this.find(num);\n      } else if (parsha.includes('-')) {\n        if (parsha === CHMPESACH || parsha === CHMSUKOT) {\n          return this.findInternal(parsha);\n        }\n        return this.find(parsha.split('-'));\n      } else {\n        // try to find Saturday holiday like 'Yom Kippur'\n        return this.findInternal(parsha);\n      }\n    } else if (Array.isArray(parsha)) {\n      const plen = parsha.length;\n      if ((plen !== 1 && plen !== 2) || typeof parsha[0] !== 'string') {\n        throw new TypeError(\n          `Invalid parsha argument: ${JSON.stringify(parsha)}`\n        );\n      }\n      if (plen === 1) {\n        return this.find(parsha[0]);\n      }\n      const p1 = parsha[0];\n      const p2 = parsha[1];\n      const num1 = parsha2id.get(p1);\n      const num2 = parsha2id.get(p2);\n      if (\n        typeof num1 !== 'number' ||\n        typeof num2 !== 'number' ||\n        num2 !== num1 + 1 ||\n        !isValidDouble(-num1)\n      ) {\n        throw new RangeError(`Unrecognized parsha name: ${p1}-${p2}`);\n      }\n      return this.find(-num1);\n    }\n    return null; /* NOTREACHED */\n  }\n\n  private findInternal(parsha: NumberOrString): HDate | null {\n    const idx = this.theSedraArray.indexOf(parsha);\n    if (idx === -1) {\n      return null; // doesn't occur this year\n    }\n    return new HDate(this.firstSaturday + idx * 7);\n  }\n\n  /**\n   * Returns the date a parsha is read this year, looking through both\n   * single and doubled forms.\n   *\n   * For example, if `'Matot'` is read individually this year, this returns\n   * its date; if it is read as part of `'Matot-Masei'` this year, this\n   * returns the date of `'Matot-Masei'` (and similarly for `'Masei'`).\n   * Conversely, asking for `'Matot-Masei'` in a year where they are split\n   * will return the date of `'Matot'` alone.\n   * @example\n   * import {Sedra} from '@hebcal/core';\n   * const sedra = new Sedra(5784, false);\n   * // Matot-Masei is split in 5784; both individual halves resolve:\n   * sedra.findContaining('Matot')?.toString();        // '22 Tamuz 5784'\n   * sedra.findContaining('Masei')?.toString();        // '29 Tamuz 5784'\n   * // Asking for the doubled name returns the date of the first half:\n   * sedra.findContaining('Matot-Masei')?.toString();  // '22 Tamuz 5784'\n   */\n  findContaining(parsha: number | string): HDate | null {\n    const hdate = this.find(parsha);\n    if (hdate) {\n      return hdate;\n    }\n    if (typeof parsha === 'number') {\n      // a valid negative number (double parsha in a year where they are\n      // combined) would've been found above, and a invalid negative number\n      // would've thrown an error, so this parsha must be a positive number\n      // representing either p1 or p2\n      const p1 = -parsha;\n      if (isValidDouble(p1)) {\n        return this.find(p1);\n      } else {\n        // this must be the second individual parsha of a doubled pair\n        // for example 29 for Kedoshim, so check for -28 for Achrei Mot-Kedoshim\n        return this.find(p1 + 1);\n      }\n    } else {\n      const num = parsha2id.get(parsha);\n      if (num) {\n        // parsha is either the first or second individual parsha of\n        // a pair that is doubled this year\n        const p1 = -num;\n        if (isValidDouble(p1)) {\n          return this.find(p1);\n        } else {\n          return this.find(p1 + 1);\n        }\n      } else {\n        // this was indeed a doubled parsha, so return date of the first half\n        const [p1] = parsha.split('-');\n        return this.find(p1);\n      }\n    }\n  }\n\n  /**\n   * Returns the underlying annual reading schedule as an array, where each\n   * entry corresponds to one Saturday (starting from the first Shabbat on\n   * or after Rosh Hashana). Entries are either:\n   * - a non-negative `number`: a 0-based parsha index (e.g. `0` for\n   *   *Bereshit*)\n   * - a negative `number`: the negated first index of a doubled parsha\n   *   (e.g. `-21` for *Vayakhel-Pekudei*)\n   * - a `string`: a holiday name when a Yom Tov displaces the weekly reading\n   *   (e.g. `'Pesach Shabbat Chol ha-Moed'`, `'Yom Kippur'`)\n   *\n   * Used by `@hebcal/triennial`.\n   */\n  getSedraArray(): readonly NumberOrString[] {\n    return this.theSedraArray;\n  }\n\n  /**\n   * Returns the R.D. (Rata Die / Fixed Date) absolute day number of the\n   * first Saturday on or after Rosh Hashana of this year. This is the\n   * anchor point for {@link getSedraArray} — index `0` of that array\n   * corresponds to this date.\n   */\n  getFirstSaturday(): number {\n    return this.firstSaturday;\n  }\n\n  /** Returns the Hebrew year this `Sedra` instance covers. */\n  getYear(): number {\n    return this.year;\n  }\n\n  /**\n   * Returns details about the parsha read on the first Saturday on or after\n   * `hd`. If `hd` is itself a Saturday, the reading for that date is\n   * returned; otherwise the reading for the upcoming Saturday is returned.\n   *\n   * If the given date falls in the final days of the Hebrew year (after\n   * the last reading of this year's schedule), this method transparently\n   * delegates to the next year's `Sedra`.\n   * @example\n   * import {Sedra, HDate, months} from '@hebcal/core';\n   * const sedra = new Sedra(5784, false);\n   * // A weekday — returns the upcoming Shabbat's reading\n   * const result = sedra.lookup(new HDate(13, months.CHESHVAN, 5784));\n   * console.log(result.parsha); // ['Lech-Lecha']\n   * console.log(result.chag);   // false\n   * console.log(result.hdate.toString()); // '15 Cheshvan 5784' (Saturday)\n   * @param hd Hebrew date or R.D. days\n   */\n  lookup(hd: HDate | number): SedraResult {\n    const abs =\n      typeof hd === 'number' ? hd : HDate.isHDate(hd) ? hd.abs() : NaN;\n\n    if (isNaN(abs)) {\n      throw new TypeError(`Bad date argument: ${hd}`);\n    } else if (abs < this.rh) {\n      throw new RangeError(\n        `Date ${hd} before start of Hebrew year ${this.year}`\n      );\n    }\n\n    // find the first saturday on or after today's date\n    const saturday = HDate.dayOnOrBefore(6, abs + 6);\n\n    const weekNum = (saturday - this.firstSaturday) / 7;\n    const index = this.theSedraArray[weekNum];\n\n    if (index === undefined) {\n      const sedra = getSedra(this.year + 1, this.il);\n      return sedra.lookup(saturday); // must be next year\n    }\n    const hdate = new HDate(saturday);\n    if (typeof index === 'string') {\n      // Shabbat has a chag. Return a description\n      return {parsha: [index], chag: true, hdate, il: this.il, num: 0};\n    }\n    if (index >= 0) {\n      return {\n        parsha: [parshiot[index]],\n        chag: false,\n        num: index + 1,\n        hdate,\n        il: this.il,\n      };\n    }\n\n    const p1 = D(index); // undouble the parsha\n    return {\n      parsha: [parshiot[p1], parshiot[p1 + 1]],\n      chag: false,\n      num: [p1 + 1, p1 + 2],\n      hdate,\n      il: this.il,\n    };\n  }\n}\n\n/**\n * The 54 parshiyot of the Torah as transilterated strings.\n * * parshiot[0] == `Bereshit`\n * * parshiot[1] == `Noach`\n * * parshiot[52] == `Ha'azinu`\n * * parshiot[53] == `Vezot Haberakhah`\n * @readonly\n * @type {string[]}\n */\nexport const parshiot: readonly string[] = [\n  'Bereshit',\n  'Noach',\n  'Lech-Lecha',\n  'Vayera',\n  'Chayei Sara',\n  'Toldot',\n  'Vayetzei',\n  'Vayishlach',\n  'Vayeshev',\n  'Miketz',\n  'Vayigash',\n  'Vayechi',\n  'Shemot',\n  'Vaera',\n  'Bo',\n  'Beshalach',\n  'Yitro',\n  'Mishpatim',\n  'Terumah',\n  'Tetzaveh',\n  'Ki Tisa',\n  'Vayakhel',\n  'Pekudei',\n  'Vayikra',\n  'Tzav',\n  'Shmini',\n  'Tazria',\n  'Metzora',\n  'Achrei Mot',\n  'Kedoshim',\n  'Emor',\n  'Behar',\n  'Bechukotai',\n  'Bamidbar',\n  'Nasso',\n  \"Beha'alotcha\",\n  \"Sh'lach\",\n  'Korach',\n  'Chukat',\n  'Balak',\n  'Pinchas',\n  'Matot',\n  'Masei',\n  'Devarim',\n  'Vaetchanan',\n  'Eikev',\n  \"Re'eh\",\n  'Shoftim',\n  'Ki Teitzei',\n  'Ki Tavo',\n  'Nitzavim',\n  'Vayeilech',\n  \"Ha'azinu\",\n  'Vezot Haberakhah',\n] as const;\n\n// 0-based parsha IDs\nconst parsha2id = new Map<string, number>();\nfor (let id = 0; id < parshiot.length; id++) {\n  const name = parshiot[id];\n  parsha2id.set(name, id);\n}\n\n// 0-based parsha IDs\nconst doubles = new Set([\n  21, // Vayakhel-Pekudei\n  26, // Tazria-Metzora\n  28, // Achrei Mot-Kedoshim\n  31, // Behar-Bechukotai\n  38, // Chukat-Balak\n  41, // Matot-Masei\n  50, // Nitzavim-Vayeilech\n]);\n\n/**\n * @private\n * @param id a negative number\n */\nfunction isValidDouble(id: number): boolean {\n  return doubles.has(-id);\n}\n\n/**\n * parsha doubler/undoubler\n * @private\n * @param p\n */\nfunction D(p: number): number {\n  return -p;\n}\n\nconst RH = 'Rosh Hashana'; // 0\nconst YK = 'Yom Kippur'; // 1\n\nconst SUKKOT = 'Sukkot'; // 0\nconst CHMSUKOT = 'Sukkot Shabbat Chol ha-Moed'; // 0\nconst SHMINI = 'Shmini Atzeret'; // 0\n\nconst PESACH = 'Pesach'; // 25\nconst PESACH1 = 'Pesach I';\nconst CHMPESACH = 'Pesach Shabbat Chol ha-Moed'; // 25\nconst PESACH7 = 'Pesach VII'; // 25\nconst PESACH8 = 'Pesach VIII';\nconst SHAVUOT = 'Shavuot'; // 33\n\n/**\n * Returns an array from start to end\n * @private\n * @param start beginning number, inclusive\n * @param stop ending number, inclusive\n */\nfunction range(start: number, stop: number): readonly number[] {\n  return Array.from({length: stop - start + 1}, (v, k) => k + start);\n}\n\ntype NumberOrString = number | string;\n\nconst yearStartVayeilech: readonly NumberOrString[] = [51, 52, CHMSUKOT];\nconst yearStartHaazinu: readonly NumberOrString[] = [52, YK, CHMSUKOT];\nconst yearStartRH: readonly NumberOrString[] = [RH, 52, SUKKOT, SHMINI];\nconst r020 = range(0, 20);\nconst r027 = range(0, 27);\nconst r3340 = range(33, 40);\nconst r4349 = range(43, 49);\nconst r4350 = range(43, 50);\n\n/**\n * The ordinary year types (keviot)\n * names are leap/nonleap - day - incomplete/regular/complete - diaspora/Israel\n * @private\n * @readonly\n */\nconst types: Record<string, readonly NumberOrString[]> = {\n  /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and\n   * Kislev each have 29 days), and has Passover start on Tuesday. */\n  // e.g. 5753\n  '020': yearStartVayeilech.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    CHMPESACH,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Monday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Thursday. */\n  // e.g. 5756\n  '0220': yearStartVayeilech.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    CHMPESACH,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    33,\n    SHAVUOT,\n    range(34, 37),\n    D(38),\n    40,\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Thursday, is `regular' (Heshvan has 29\n   * days and Kislev has 30 days), and has Passover start on Saturday. */\n  // e.g. 5701\n  '0510': yearStartHaazinu.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    PESACH1,\n    PESACH8,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Thursday, is `regular' (Heshvan has 29\n   * days and Kislev has 30 days), and has Passover start on Saturday. */\n  // e.g. 5745\n  '0511': yearStartHaazinu.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    PESACH,\n    25,\n    D(26),\n    D(28),\n    range(30, 40),\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Thursday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Sunday. */\n  // e.g. 5754\n  '052': yearStartHaazinu.concat(\n    range(0, 24),\n    PESACH7,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Saturday, is `incomplete' (Heshvan and Kislev\n   * each have 29 days), and has Passover start on Sunday. */\n  // e.g. 5761\n  '070': yearStartRH.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    PESACH7,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Saturday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Tuesday. */\n  // e.g. 5716\n  '072': yearStartRH.concat(\n    r020,\n    D(21),\n    23,\n    24,\n    CHMPESACH,\n    25,\n    D(26),\n    D(28),\n    30,\n    D(31),\n    r3340,\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* --  The leap year types (keviot) -- */\n  /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and\n   * Kislev each have 29 days), and has Passover start on Thursday. */\n  // e.g. 5746\n  '1200': yearStartVayeilech.concat(\n    r027,\n    CHMPESACH,\n    range(28, 33),\n    SHAVUOT,\n    range(34, 37),\n    D(38),\n    40,\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Monday, is `incomplete' (Heshvan and\n   * Kislev each have 29 days), and has Passover start on Thursday. */\n  // e.g. 5746\n  '1201': yearStartVayeilech.concat(\n    r027,\n    CHMPESACH,\n    range(28, 40),\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Monday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Saturday. */\n  // e.g.5752\n  '1220': yearStartVayeilech.concat(\n    r027,\n    PESACH1,\n    PESACH8,\n    range(28, 40),\n    D(41),\n    r4350\n  ),\n\n  /* Hebrew year that starts on Monday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Saturday. */\n  // e.g.5752\n  '1221': yearStartVayeilech.concat(r027, PESACH, range(28, 50)),\n\n  /* Hebrew year that starts on Thursday, is `incomplete' (Heshvan and\n   * Kislev both have 29 days), and has Passover start on Sunday. */\n  // e.g. 5768\n  '150': yearStartHaazinu.concat(range(0, 28), PESACH7, range(29, 50)),\n\n  /* Hebrew year that starts on Thursday, is `complete' (Heshvan and\n   * Kislev both have 30 days), and has Passover start on Tuesday. */\n  // eg. 5771\n  '152': yearStartHaazinu.concat(range(0, 28), CHMPESACH, range(29, 49), D(50)),\n\n  /* Hebrew year that starts on Saturday, is `incomplete' (Heshvan and\n   * Kislev each have 29 days), and has Passover start on Tuesday. */\n  // e.g.5757\n  '170': yearStartRH.concat(\n    r027,\n    CHMPESACH,\n    range(28, 40),\n    D(41),\n    r4349,\n    D(50)\n  ),\n\n  /* Hebrew year that starts on Saturday, is `complete' (Heshvan and\n   * Kislev each have 30 days), and has Passover start on Thursday. */\n  '1720': yearStartRH.concat(\n    r027,\n    CHMPESACH,\n    range(28, 33),\n    SHAVUOT,\n    range(34, 37),\n    D(38),\n    40,\n    D(41),\n    r4349,\n    D(50)\n  ),\n} as const;\n\n/* Hebrew year that starts on Monday, is `complete' (Heshvan and\n * Kislev each have 30 days), and has Passover start on Thursday. */\ntypes['0221'] = types['020'];\n\n/* Hebrew year that starts on Tuesday, is `regular' (Heshvan has 29\n * days and Kislev has 30 days), and has Passover start on Thursday. */\n// e.g. 5715\ntypes['0310'] = types['0220'];\n\n/* Hebrew year that starts on Tuesday, is `regular' (Heshvan has 29\n * days and Kislev has 30 days), and has Passover start on Thursday. */\ntypes['0311'] = types['020'];\n\n/* Hebrew year that starts on Tuesday, is `regular' (Heshvan has 29\n * days and Kislev has 30 days), and has Passover start on Saturday. */\n// e.g. 5715\ntypes['1310'] = types['1220'];\n/* Hebrew year that starts on Tuesday, is `regular' (Heshvan has 29\n * days and Kislev has 30 days), and has Passover start on Saturday. */\ntypes['1311'] = types['1221'];\n\n/* Hebrew year that starts on Saturday, is `complete' (Heshvan and\n * Kislev each have 30 days), and has Passover start on Thursday. */\ntypes['1721'] = types['170'];\n\nconst sedraCache = new QuickLRU<string, Sedra>({maxSize: 120});\n\n/**\n * Convenience function to create an instance of {@link Sedra} or reuse a\n * previously created and cached instance for the same year and schedule.\n *\n * Prefer this over `new Sedra(...)` when calling repeatedly — an internal\n * LRU cache (~120 entries) avoids recomputing the keviyah-specific schedule.\n * @example\n * import {getSedra, HDate, months} from '@hebcal/core';\n * const sedra = getSedra(5784, false);\n * const {parsha} = sedra.lookup(new HDate(15, months.CHESHVAN, 5784));\n * console.log(parsha); // ['Lech-Lecha']\n * @param hyear Hebrew year\n * @param il Use Israel sedra schedule (`false` for Diaspora)\n */\nexport function getSedra(hyear: number, il: boolean): Sedra {\n  const cacheKey = `${hyear}-${il ? 1 : 0}`;\n  let sedra = sedraCache.get(cacheKey);\n  if (!sedra) {\n    sedra = new Sedra(hyear, il);\n    sedraCache.set(cacheKey, sedra);\n  }\n  return sedra;\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/sefira.json.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v6.5.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.5.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 const ps67lines=["אֱלֹהִים יְחָנֵּנוּ וִיבָרְכֵנוּ יָאֵר־פָּנָיו אִתָּנוּ סֶלָה","לָדַעַת בָּאָרֶץ דַּרְכֶּךָ בְּכָל־גּוֹיִם יְשׁוּעָתֶךָ","יוֹדוּךָ עַמִּים אֱלֹהִים יוֹדוּךָ עַמִּים כֻּלָּם","יִשְׂמְחוּ וִירַנְּנוּ לְאֻמִּים כִּי־תִשְׁפֹּט עַמִּים מִישׁוֹר וּלְאֻמִּים בָּאָרֶץ תַּנחֵם סֶלָה","יוֹדוּךָ עַמִּים אֱלֹהִים יוֹדוּךָ עַמִּים כֻּלָּם","אֶרֶץ נָתְנָה יְבוּלָהּ יְבָרְכֵנוּ אֱלֹהִים אֱלֹהֵינוּ","יְבָרְכֵנוּ אֱלֹהִים וְיִירְאוּ אוֹתוֹ כָּל־אַפְסֵי־אָרֶץ"];const lamnatzeachLetters="ישמחווירננולאמיםכיתשפוטעמיםמישורולאמיםבארץתנחםסלה";const anaBekoach=["אָנָּא","בְּכֹחַ","גְּדֻלַּת","יְמִינְךָ","תַּתִּיר","צְרוּרָה","אב״ג ית״ץ","קַבֵּל","רִנַּת","עַמְּךָ","שַׂגְּבֵנוּ","טַהֲרֵנוּ","נוֹרָא","קר״ע שט״ן","נָא","גִבּוֹר","דּוֹרְשֵׁי","יִחוּדְךָ","כְּבָבַת","שָׁמְרֵם","נג״ד יכ״ש","בָּרְכֵם","טַהֲרֵם","רַחֲמֵי","צִדְקָתְךָ","תָּמִיד","גָּמְלֵם","בט״ר צת״ג","חֲסִין","קָדוֹשׁ","בְּרֹב","טוּבְךָ","נַהֵל","עֲדָתֶךָ","חק״ב תנ״ע","יָחִיד","גֵּאֶה","לְעַמְּךָ","פְּנֵה","זוֹכְרֵי","קְדֻשָּׁתֶךָ","יג״ל פז״ק","שַׁוְעָתֵנוּ","קַבֵּל","וּשְׁמַע","צַעֲקָתֵנוּ","יוֹדֵעַ","תַּעֲלוּמוֹת","שק״ו צי״ת"];var sefira = {ps67lines:ps67lines,lamnatzeachLetters:lamnatzeachLetters,anaBekoach:anaBekoach};
 
 export { anaBekoach, sefira as default, lamnatzeachLetters, ps67lines };

package/dist/esm/staticHolidays.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v6.5.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.5.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import { months } from '@hebcal/hdate';
 import { flags } from './event.js';
 

package/dist/esm/tachanun.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v6.5.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.5.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import { HDate, months } from '@hebcal/hdate';
 import { dateYomHaZikaron } from './modern.js';
 

package/dist/esm/temporal-shim.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v6.5.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.5.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import { Temporal } from 'temporal-polyfill';
 
 /// <reference types="temporal-polyfill/global" />

package/dist/esm/zmanim.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v6.5.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.5.3, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import './temporal-shim.js';
 import { NOAACalculator } from '@hebcal/noaa';
 import { HDate, isDate, getTimezoneOffset, pad2, getPseudoISO } from '@hebcal/hdate';

package/dist/src/CalOptions.d.ts

@@ -22,7 +22,7 @@ export type CalOptions = {
      */
     month?: number | string;
     /**
-     * generate calendar for multiple years (default 1)
+     * generate calendar for multiple years (default 1, maximum 2000)
      */
     numYears?: number;
     /**
@@ -50,8 +50,7 @@ export type CalOptions = {
     havdalahMins?: number;
     /**
      * degrees for solar depression for Havdalah.
-     * Default is 8.5 degrees for 3 small stars. use 7.083 degrees for 3 medium-sized stars
-     * (observed by Dr. Baruch (Berthold) Cohn in his luach published in France in 1899).
+     * Default is 8.5 degrees for 3 small stars. use 7.083 degrees for 3 medium-sized stars.
      * If `0`, Havdalah times are suppressed.
      */
     havdalahDeg?: number;
@@ -70,7 +69,7 @@ export type CalOptions = {
      */
     useElevation?: boolean;
     /**
-     * calculate parashah hashavua on Saturdays
+     * calculate Parashat HaShavua on Saturdays
      */
     sedrot?: boolean;
     /**

package/dist/src/DailyLearning.d.ts

@@ -1,32 +1,69 @@
 import { HDate } from '@hebcal/hdate';
 import { Event } from './event';
 /**
- * Plug-ins for daily learning calendars such as Daf Yomi, Mishna Yomi, Nach Yomi, etc.
+ * Plug-in registry for daily learning calendars such as Daf Yomi (Bavli),
+ * Yerushalmi Yomi, Mishna Yomi, Nach Yomi, etc.
  *
- * Learning schedules are provided by the `@hebcal/learning` package.
+ * `@hebcal/core` itself contains no learning schedules — they are provided
+ * by the {@link https://github.com/hebcal/hebcal-learning @hebcal/learning}
+ * package, which calls {@link DailyLearning.addCalendar} on import. After
+ * `@hebcal/learning` is loaded, `HebrewCalendar.calendar()` will emit
+ * learning events when the corresponding `options.dailyLearning` flag is set.
+ *
+ * @example
+ * import '@hebcal/learning';
+ * import {DailyLearning, HDate} from '@hebcal/core';
+ *
+ * const ev = DailyLearning.lookup('dafYomi', new HDate(), false);
+ * console.log(ev?.render('en')); // e.g. 'Berakhot 2'
  */
 export declare class DailyLearning {
     /**
-     * Register a new learning calendar.
+     * Registers a new learning calendar.
+     *
+     * The provided function is called whenever a caller asks for an event
+     * from this calendar; if no learning occurs that day (e.g. the date is
+     * before the cycle's start) it should return `null`.
+     * @example
+     * DailyLearning.addCalendar(
+     *   'myCalendar',
+     *   (hd, il) => new Event(hd, 'Today\'s learning', 0),
+     *   new HDate(1, 'Tishrei', 5780),
+     * );
      * @param name case insensitive
      * @param calendar a function that returns an `Event` or `null`
      * @param startDate the first date for which this calendar is valid
      */
     static addCalendar(name: string, calendar: (hd: HDate, il: boolean) => Event | null, startDate?: HDate): void;
     /**
-     * Returns an event from daily calendar for a given date. Returns `null` if there
-     * is no learning from this calendar on this date.
+     * Returns the learning event for the given date from the named calendar,
+     * or `null` if there is no learning that day (or the named calendar is
+     * not registered).
+     * @example
+     * import '@hebcal/learning';
+     * import {DailyLearning, HDate} from '@hebcal/core';
+     * DailyLearning.lookup('dafYomi', new HDate(2024, 1, 15), false);
      * @param name case insensitive
      * @param hd Hebrew Date
      * @param il true for Israel, false for Diaspora
      */
     static lookup(name: string, hd: HDate, il: boolean): Event | null;
+    /**
+     * Returns the first Hebrew date for which the named learning calendar
+     * is valid (as registered by {@link addCalendar}), or `undefined` if the
+     * calendar was not registered with a start date or is not registered at all.
+     * @param name case insensitive
+     */
     static getStartDate(name: string): HDate | undefined;
     /**
-     * Tests to see if learning calendar has been registered
+     * Returns `true` if a learning calendar with the given name has been
+     * registered via {@link addCalendar}.
      * @param name case insensitive
      */
     static has(name: string): boolean;
-    /** Returns the names of all calendars registered */
+    /**
+     * Returns the (lower-cased) names of all currently-registered learning
+     * calendars.
+     */
     static getCalendars(): string[];
 }

package/dist/src/DailyLearning.js

@@ -1,12 +1,34 @@
 const cals = new Map();
 /**
- * Plug-ins for daily learning calendars such as Daf Yomi, Mishna Yomi, Nach Yomi, etc.
+ * Plug-in registry for daily learning calendars such as Daf Yomi (Bavli),
+ * Yerushalmi Yomi, Mishna Yomi, Nach Yomi, etc.
  *
- * Learning schedules are provided by the `@hebcal/learning` package.
+ * `@hebcal/core` itself contains no learning schedules — they are provided
+ * by the {@link https://github.com/hebcal/hebcal-learning @hebcal/learning}
+ * package, which calls {@link DailyLearning.addCalendar} on import. After
+ * `@hebcal/learning` is loaded, `HebrewCalendar.calendar()` will emit
+ * learning events when the corresponding `options.dailyLearning` flag is set.
+ *
+ * @example
+ * import '@hebcal/learning';
+ * import {DailyLearning, HDate} from '@hebcal/core';
+ *
+ * const ev = DailyLearning.lookup('dafYomi', new HDate(), false);
+ * console.log(ev?.render('en')); // e.g. 'Berakhot 2'
  */
 export class DailyLearning {
     /**
-     * Register a new learning calendar.
+     * Registers a new learning calendar.
+     *
+     * The provided function is called whenever a caller asks for an event
+     * from this calendar; if no learning occurs that day (e.g. the date is
+     * before the cycle's start) it should return `null`.
+     * @example
+     * DailyLearning.addCalendar(
+     *   'myCalendar',
+     *   (hd, il) => new Event(hd, 'Today\'s learning', 0),
+     *   new HDate(1, 'Tishrei', 5780),
+     * );
      * @param name case insensitive
      * @param calendar a function that returns an `Event` or `null`
      * @param startDate the first date for which this calendar is valid
@@ -21,8 +43,13 @@ export class DailyLearning {
         });
     }
     /**
-     * Returns an event from daily calendar for a given date. Returns `null` if there
-     * is no learning from this calendar on this date.
+     * Returns the learning event for the given date from the named calendar,
+     * or `null` if there is no learning that day (or the named calendar is
+     * not registered).
+     * @example
+     * import '@hebcal/learning';
+     * import {DailyLearning, HDate} from '@hebcal/core';
+     * DailyLearning.lookup('dafYomi', new HDate(2024, 1, 15), false);
      * @param name case insensitive
      * @param hd Hebrew Date
      * @param il true for Israel, false for Diaspora
@@ -34,6 +61,12 @@ export class DailyLearning {
         }
         return null;
     }
+    /**
+     * Returns the first Hebrew date for which the named learning calendar
+     * is valid (as registered by {@link addCalendar}), or `undefined` if the
+     * calendar was not registered with a start date or is not registered at all.
+     * @param name case insensitive
+     */
     static getStartDate(name) {
         const cal = cals.get(name.toLowerCase());
         if (typeof cal === 'object') {
@@ -42,13 +75,17 @@ export class DailyLearning {
         return undefined;
     }
     /**
-     * Tests to see if learning calendar has been registered
+     * Returns `true` if a learning calendar with the given name has been
+     * registered via {@link addCalendar}.
      * @param name case insensitive
      */
     static has(name) {
         return cals.has(name.toLowerCase());
     }
-    /** Returns the names of all calendars registered */
+    /**
+     * Returns the (lower-cased) names of all currently-registered learning
+     * calendars.
+     */
     static getCalendars() {
         return Array.from(cals.keys());
     }

package/dist/src/HolidayEvent.d.ts

@@ -1,7 +1,22 @@
 import { HDate } from '@hebcal/hdate';
 import { Event } from './event';
 import './locale';
-/** Represents a built-in holiday like Pesach, Purim or Tu BiShvat */
+/**
+ * Represents a built-in holiday like Pesach, Purim or Tu BiShvat.
+ *
+ * Most holiday-related events emitted by {@link HebrewCalendar.calendar}
+ * are instances of `HolidayEvent` or one of its subclasses
+ * ({@link ChanukahEvent}, {@link AsaraBTevetEvent},
+ * {@link RoshHashanaEvent}, {@link RoshChodeshEvent}).
+ *
+ * Adds two notable behaviors over the base {@link Event}:
+ *
+ * - {@link HolidayEvent.basename} strips qualifiers like `Erev `, ` I`/`II`,
+ *   `(CH''M)`, `(observed)`, candle counts, etc. (e.g. `"Erev Pesach"` →
+ *   `"Pesach"`).
+ * - {@link HolidayEvent.url} returns a `https://www.hebcal.com/holidays/...`
+ *   link for the holiday.
+ */
 export declare class HolidayEvent extends Event {
     /** During Sukkot or Pesach */
     cholHaMoedDay?: number;
@@ -12,7 +27,25 @@ export declare class HolidayEvent extends Event {
      */
     observed?: boolean;
     constructor(date: HDate, desc: string, mask?: number, attrs?: object);
+    /**
+     * Returns a simplified (untranslated) name for this holiday, stripping
+     * qualifiers so that related events group under one name.
+     *
+     * Strips trailing 4-digit years, `(CH''M)`, `(observed)`, `(Hoshana Raba)`,
+     * Roman-numeral day numbers (` I`, ` II`, ...), Chanukah candle counts,
+     * `: 8th Day`, and a leading `"Erev "`.
+     * @example
+     * // 'Erev Pesach'           => 'Pesach'
+     * // 'Sukkot III (CH''M)'    => 'Sukkot'
+     * // 'Chanukah: 5 Candles'   => 'Chanukah'
+     * // 'Rosh Hashana 5784'     => 'Rosh Hashana'
+     */
     basename(): string;
+    /**
+     * Returns a `https://www.hebcal.com/holidays/...` URL for more detail on
+     * this holiday. Israel-only holidays get an `?i=on` query parameter.
+     * Returns `undefined` for years outside `[100, 2999]`.
+     */
     url(): string | undefined;
     urlDateSuffix(): string;
     getEmoji(): string;

package/dist/src/HolidayEvent.js

@@ -2,7 +2,22 @@ import { Locale, isoDateString } from '@hebcal/hdate';
 import { Event, flags } from './event';
 import { holidayDesc as hdesc } from './staticHolidays';
 import './locale'; // Adds Hebrew and Ashkenazic translations
-/** Represents a built-in holiday like Pesach, Purim or Tu BiShvat */
+/**
+ * Represents a built-in holiday like Pesach, Purim or Tu BiShvat.
+ *
+ * Most holiday-related events emitted by {@link HebrewCalendar.calendar}
+ * are instances of `HolidayEvent` or one of its subclasses
+ * ({@link ChanukahEvent}, {@link AsaraBTevetEvent},
+ * {@link RoshHashanaEvent}, {@link RoshChodeshEvent}).
+ *
+ * Adds two notable behaviors over the base {@link Event}:
+ *
+ * - {@link HolidayEvent.basename} strips qualifiers like `Erev `, ` I`/`II`,
+ *   `(CH''M)`, `(observed)`, candle counts, etc. (e.g. `"Erev Pesach"` →
+ *   `"Pesach"`).
+ * - {@link HolidayEvent.url} returns a `https://www.hebcal.com/holidays/...`
+ *   link for the holiday.
+ */
 export class HolidayEvent extends Event {
     /** During Sukkot or Pesach */
     cholHaMoedDay;
@@ -18,6 +33,19 @@ export class HolidayEvent extends Event {
             Object.assign(this, attrs);
         }
     }
+    /**
+     * Returns a simplified (untranslated) name for this holiday, stripping
+     * qualifiers so that related events group under one name.
+     *
+     * Strips trailing 4-digit years, `(CH''M)`, `(observed)`, `(Hoshana Raba)`,
+     * Roman-numeral day numbers (` I`, ` II`, ...), Chanukah candle counts,
+     * `: 8th Day`, and a leading `"Erev "`.
+     * @example
+     * // 'Erev Pesach'           => 'Pesach'
+     * // 'Sukkot III (CH''M)'    => 'Sukkot'
+     * // 'Chanukah: 5 Candles'   => 'Chanukah'
+     * // 'Rosh Hashana 5784'     => 'Rosh Hashana'
+     */
     basename() {
         return this.getDesc()
             .replace(/ \d{4}$/, '')
@@ -29,6 +57,11 @@ export class HolidayEvent extends Event {
             .replace(/: 8th Day$/, '')
             .replace(/^Erev /, '');
     }
+    /**
+     * Returns a `https://www.hebcal.com/holidays/...` URL for more detail on
+     * this holiday. Israel-only holidays get an `?i=on` query parameter.
+     * Returns `undefined` for years outside `[100, 2999]`.
+     */
     url() {
         const year = this.greg().getFullYear();
         if (year < 100 || year > 2999) {

package/dist/src/TimedEvent.d.ts

@@ -3,12 +3,26 @@ import { CalOptions } from './CalOptions';
 import { Location } from './location';
 import { Event } from './event';
 import './locale';
-/** An event that has an `eventTime` and `eventTimeStr` */
+/**
+ * Base class for events that have an associated wall-clock time and
+ * geographic location — for example, candle lighting, havdalah, and
+ * fast begin/end times.
+ *
+ * Stores both a `Date` (`eventTime`) and pre-formatted 24-hour
+ * (`eventTimeStr`) and locale-aware (`fmtTime`) strings. May reference a
+ * "linked" event such as the holiday whose candle-lighting time this
+ * represents.
+ */
 export declare class TimedEvent extends Event {
+    /** The exact moment of the event, rounded to the nearest minute */
     readonly eventTime: Date;
+    /** Geographic location used to compute `eventTime` */
     readonly location: Location;
+    /** 24-hour formatted time string in the location's timezone (e.g. `"19:42"`) */
     readonly eventTimeStr: string;
+    /** Locale-aware formatted time string (e.g. `"7:42pm"` in US locale) */
     readonly fmtTime: string;
+    /** Optional event this time is associated with (e.g. the Yom Tov being lit for) */
     readonly linkedEvent?: Event;
     /**
      * @param desc Description (not translated)
@@ -25,12 +39,27 @@ export declare class TimedEvent extends Event {
     renderBrief(locale?: string): string;
     getCategories(): string[];
 }
-/** Candle lighting before Shabbat or holiday */
+/**
+ * Candle-lighting event for the eve of Shabbat or a Yom Tov.
+ *
+ * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`
+ * is `true` and `options.location` is provided. By default candle lighting
+ * occurs 18 minutes before sundown (40 minutes in Jerusalem; 30 minutes in
+ * Haifa and Zikhron Ya'akov), configurable via `options.candleLightingMins`.
+ */
 export declare class CandleLightingEvent extends TimedEvent {
     constructor(date: HDate, mask: number, eventTime: Date, location: Location, linkedEvent?: Event, options?: CalOptions);
     getEmoji(): string;
 }
-/** Havdalah after Shabbat or holiday */
+/**
+ * Havdalah event marking the end of Shabbat or a Yom Tov.
+ *
+ * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`
+ * is `true` and `options.location` is provided. By default Havdalah is
+ * calculated by *tzeit hakochavim* (8.5° solar depression); pass
+ * `options.havdalahMins` to use a fixed minute offset instead, or
+ * `options.havdalahDeg` to use a different degree.
+ */
 export declare class HavdalahEvent extends TimedEvent {
     private readonly havdalahMins?;
     constructor(date: HDate, mask: number, eventTime: Date, location: Location, havdalahMins?: number, linkedEvent?: Event, options?: CalOptions);

package/dist/src/TimedEvent.js

@@ -6,12 +6,26 @@ import { holidayDesc as hdesc } from './staticHolidays';
 import './locale'; // Adds Hebrew and Ashkenazic translations
 const HAVDALAH = hdesc.HAVDALAH;
 const CANDLE_LIGHTING = hdesc.CANDLE_LIGHTING;
-/** An event that has an `eventTime` and `eventTimeStr` */
+/**
+ * Base class for events that have an associated wall-clock time and
+ * geographic location — for example, candle lighting, havdalah, and
+ * fast begin/end times.
+ *
+ * Stores both a `Date` (`eventTime`) and pre-formatted 24-hour
+ * (`eventTimeStr`) and locale-aware (`fmtTime`) strings. May reference a
+ * "linked" event such as the holiday whose candle-lighting time this
+ * represents.
+ */
 export class TimedEvent extends Event {
+    /** The exact moment of the event, rounded to the nearest minute */
     eventTime;
+    /** Geographic location used to compute `eventTime` */
     location;
+    /** 24-hour formatted time string in the location's timezone (e.g. `"19:42"`) */
     eventTimeStr;
+    /** Locale-aware formatted time string (e.g. `"7:42pm"` in US locale) */
     fmtTime;
+    /** Optional event this time is associated with (e.g. the Yom Tov being lit for) */
     linkedEvent;
     /**
      * @param desc Description (not translated)
@@ -63,7 +77,14 @@ export class TimedEvent extends Event {
         return ['unknown'];
     }
 }
-/** Candle lighting before Shabbat or holiday */
+/**
+ * Candle-lighting event for the eve of Shabbat or a Yom Tov.
+ *
+ * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`
+ * is `true` and `options.location` is provided. By default candle lighting
+ * occurs 18 minutes before sundown (40 minutes in Jerusalem; 30 minutes in
+ * Haifa and Zikhron Ya'akov), configurable via `options.candleLightingMins`.
+ */
 export class CandleLightingEvent extends TimedEvent {
     constructor(date, mask, eventTime, location, linkedEvent, options) {
         super(date, CANDLE_LIGHTING, mask, eventTime, location, linkedEvent, options);
@@ -72,7 +93,15 @@ export class CandleLightingEvent extends TimedEvent {
         return '🕯️';
     }
 }
-/** Havdalah after Shabbat or holiday */
+/**
+ * Havdalah event marking the end of Shabbat or a Yom Tov.
+ *
+ * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`
+ * is `true` and `options.location` is provided. By default Havdalah is
+ * calculated by *tzeit hakochavim* (8.5° solar depression); pass
+ * `options.havdalahMins` to use a fixed minute offset instead, or
+ * `options.havdalahDeg` to use a different degree.
+ */
 export class HavdalahEvent extends TimedEvent {
     havdalahMins;
     constructor(date, mask, eventTime, location, havdalahMins, linkedEvent, options) {

package/dist/src/ashkenazi.po.d.ts

@@ -19,6 +19,7 @@ declare const _default: {
             Matot: string[];
             "Pesach Shabbat Chol ha-Moed": string[];
             "Purim Katan": string[];
+            "Rosh Hashana LaBehemot": string[];
             "Shabbat Chazon": string[];
             "Shabbat HaChodesh": string[];
             "Shabbat HaGadol": string[];