@hebcal/core 6.5.1 → 6.5.2

package/dist/esm/omer.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.2, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import { Locale, gematriya } from '@hebcal/hdate';
 import { Event, flags } from './event.js';
 import './locale.js';
@@ -190,14 +190,33 @@ const anaBekoach = sefira.anaBekoach;
 const ps67lines = sefira.ps67lines;
 const lamnatzeach = ps67lines.flatMap((x) => x.split(/[ ־]/));
 const lamnatzeachLetters = sefira.lamnatzeachLetters.split('');
-/** Represents a day 1-49 of counting the Omer from Pesach to Shavuot */
+/**
+ * Represents one of the 49 days of counting the Omer between Pesach and
+ * Shavuot (16 Nisan through 5 Sivan).
+ *
+ * Each day has an associated Sefirah pairing (e.g. *Chesed shebiGevurah*),
+ * a word from Psalm 67 (Lamnatzeach), a letter from verse 5 of Psalm 67,
+ * and a word/acrostic from the Ana BeKoach prayer — all accessible via
+ * the methods on this class.
+ *
+ * @example
+ * import {OmerEvent, HDate, months} from '@hebcal/core';
+ * const ev = new OmerEvent(new HDate(16, months.NISAN, 5784), 1);
+ * ev.render('en');        // '1st day of the Omer'
+ * ev.render('he');        // 'א׳ בָּעוֹמֶר'
+ * ev.sefira('translit');  // 'Chesed shebChesed'
+ * ev.getTodayIs('en');    // 'Today is 1 day of the Omer'
+ */
 class OmerEvent extends Event {
     weekNumber;
     daysWithinWeeks;
     omer;
     /**
-     * @param date
-     * @param omerDay
+     * Constructs an Omer event for a given day (1–49).
+     *
+     * Throws `RangeError` if `omerDay` is outside 1–49.
+     * @param date Hebrew date this Omer day is counted on (the evening of)
+     * @param omerDay day of the Omer, 1 through 49
      */
     constructor(date, omerDay) {
         super(date, `Omer ${omerDay}`, flags.OMER_COUNT);
@@ -207,10 +226,19 @@ class OmerEvent extends Event {
         this.omer = omerDay;
     }
     /**
-     * Returns the sefira. For example, on day 8:
+     * Returns the Sefirah pairing associated with this Omer day —
+     * one of the seven lower Sefirot within another, calculated as
+     * `day-within-week` of `week-within-cycle`. For example, on day 8
+     * (week 2, day 1):
      *  * חֶֽסֶד שֶׁבִּגְבוּרָה
      *  * Chesed shebiGevurah
      *  * Lovingkindness within Might
+     * @example
+     * import {OmerEvent, HDate, months} from '@hebcal/core';
+     * const day8 = new OmerEvent(new HDate(23, months.NISAN, 5784), 8);
+     * day8.sefira('en');        // 'Lovingkindness within Might'
+     * day8.sefira('he');        // 'חֶֽסֶד שֶׁבִּגְבוּרָה'
+     * day8.sefira('translit');  // 'Chesed shebiGevurah'
      * @param lang `en` (English), `he` (Hebrew with nikud), or `translit` (Hebrew in Sephardic transliteration)
      * @returns a string such as `Lovingkindness within Might` or `חֶֽסֶד שֶׁבִּגְבוּרָה`
      */

package/dist/esm/omer.js.map

@@ -1 +1 @@
-{"version":3,"file":"omer.js","sources":["../../../src/omer.ts"],"sourcesContent":["import {HDate, Locale, gematriya} from '@hebcal/hdate';\nimport {Event, flags} from './event';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\nimport sefira from './sefira.json';\n\n/**\n * Language for counting the Omer can be English or Hebrew.\n * Lang for the Sefira can be English, Hebrew, or Hebrew in Sephardic transliteration.\n */\nexport type OmerLang = 'en' | 'he' | 'translit';\n\nconst sefirot = {\n  en: {\n    infix: 'within ',\n    infix26: 'within ',\n    words: [\n      '',\n      'Lovingkindness',\n      'Might',\n      'Beauty',\n      'Eternity',\n      'Splendor',\n      'Foundation',\n      'Majesty',\n    ],\n    pfxWords: null,\n  },\n  he: {\n    infix: null,\n    infix26: null,\n    words: [\n      '',\n      'חֶֽסֶד',\n      'גְּבוּרָה',\n      'תִּפְאֶֽרֶת',\n      'נֶּֽצַח',\n      'הוֹד',\n      'יְּסוֹד',\n      'מַלְכוּת',\n    ],\n    pfxWords: [\n      '',\n      'שֶׁבְּחֶֽסֶד',\n      'שֶׁבִּגְבוּרָה',\n      'שֶׁבְּתִפְאֶֽרֶת',\n      'שֶׁבְּנֶֽצַח',\n      'שֶׁבְּהוֹד',\n      'שֶׁבִּיְסוֹד',\n      'שֶׁבְּמַלְכוּת',\n    ],\n  },\n  translit: {\n    infix: \"sheb'\",\n    infix26: 'shebi',\n    words: [\n      '',\n      'Chesed',\n      'Gevurah',\n      'Tiferet',\n      'Netzach',\n      'Hod',\n      'Yesod',\n      'Malkhut',\n    ],\n    pfxWords: null,\n  },\n} as const;\n\nfunction checkDay(omerDay: number): void {\n  if (omerDay < 1 || omerDay > 49) {\n    throw new RangeError(`Invalid Omer day ${omerDay}`);\n  }\n}\n\nfunction getWeeks(omerDay: number): number[] {\n  const weekNum: number = Math.floor((omerDay - 1) / 7) + 1;\n  const daysWithinWeeks: number = omerDay % 7 || 7;\n  return [weekNum, daysWithinWeeks];\n}\n\nfunction omerTodayIsEn(omerDay: number): string {\n  const [weekNumber, daysWithinWeeks]: number[] = getWeeks(omerDay);\n\n  const totalDaysStr: string = omerDay === 1 ? 'day' : 'days';\n  let str = `Today is ${omerDay} ${totalDaysStr}`;\n\n  if (weekNumber > 1 || omerDay === 7) {\n    const day7: boolean = daysWithinWeeks === 7;\n    const numWeeks: number = day7 ? weekNumber : weekNumber - 1;\n    const weeksStr: string = numWeeks === 1 ? 'week' : 'weeks';\n    str += `, which are ${numWeeks} ${weeksStr}`;\n    if (!day7) {\n      const daysStr: string = daysWithinWeeks === 1 ? 'day' : 'days';\n      str += ` and ${daysWithinWeeks} ${daysStr}`;\n    }\n  }\n  return str + ' of the Omer';\n}\n\n// adapted from pip hdate package (GPL)\n// https://github.com/py-libhdate/py-libhdate/blob/master/hdate/date.py\n\nconst tens = ['', 'עֲשָׂרָה', 'עֶשְׂרִים', 'שְׁלוֹשִׁים', 'אַרְבָּעִים'];\nconst ones = [\n  '',\n  'אֶחָד',\n  'שְׁנַיִם',\n  'שְׁלוֹשָׁה',\n  'אַרְבָּעָה',\n  'חֲמִשָּׁה',\n  'שִׁשָּׁה',\n  'שִׁבְעָה',\n  'שְׁמוֹנָה',\n  'תִּשְׁעָה',\n];\n\nconst shnei = 'שְׁנֵי';\nconst yamim = 'יָמִים';\nconst shneiYamim = shnei + ' ' + yamim;\nconst shavuot = 'שָׁבוּעוֹת';\nconst yom = 'יוֹם';\nconst yomEchad = yom + ' ' + ones[1];\nconst asar = 'עָשָׂר';\n\nfunction omerTodayIsHe(omerDay: number): string {\n  const ten: number = Math.floor(omerDay / 10);\n  const one: number = omerDay % 10;\n  let str = 'הַיּוֹם ';\n  if (omerDay === 11) {\n    str += 'אַחַד ' + asar;\n  } else if (omerDay === 12) {\n    str += 'שְׁנֵים ' + asar;\n  } else if (12 < omerDay && omerDay < 20) {\n    str += ones[one] + ' ' + asar;\n  } else if (omerDay > 9) {\n    str += ones[one];\n    if (one) {\n      str += ' ';\n      str += ten === 3 ? 'וּ' : 'וְ';\n    }\n  }\n  if (omerDay > 2) {\n    if (omerDay > 20 || omerDay === 10 || omerDay === 20) {\n      str += tens[ten];\n    }\n    if (omerDay < 11) {\n      str += ones[one] + ' ' + yamim + ' ';\n    } else {\n      str += ' ' + yom + ' ';\n    }\n  } else if (omerDay === 1) {\n    str += yomEchad + ' ';\n  } else {\n    // omer == 2\n    str += shneiYamim + ' ';\n  }\n  if (omerDay > 6) {\n    str = str.trim(); // remove trailing space before comma\n    str += ', שֶׁהֵם ';\n    const weeks: number = Math.floor(omerDay / 7);\n    const days: number = omerDay % 7;\n    if (weeks > 2) {\n      str += ones[weeks] + ' ' + shavuot + ' ';\n    } else if (weeks === 1) {\n      str += 'שָׁבֽוּעַ' + ' ' + ones[1] + ' ';\n    } else {\n      // weeks == 2\n      str += shnei + ' ' + shavuot + ' ';\n    }\n    if (days) {\n      if (days === 2 || days === 3) {\n        str += 'וּ';\n      } else if (days === 5) {\n        str += 'וַ';\n      } else {\n        str += 'וְ';\n      }\n      if (days > 2) {\n        str += ones[days] + ' ' + yamim + ' ';\n      } else if (days === 1) {\n        str += yomEchad + ' ';\n      } else {\n        // days == 2\n        str += shneiYamim + ' ';\n      }\n    }\n  }\n  str += 'לָעֽוֹמֶר';\n  return str.normalize();\n}\n\nconst anaBekoach = sefira.anaBekoach;\n\nconst ps67lines = sefira.ps67lines;\n\nconst lamnatzeach = ps67lines.flatMap((x: string) => x.split(/[ ־]/));\n\nconst lamnatzeachLetters = sefira.lamnatzeachLetters.split('');\n\n/** Represents a day 1-49 of counting the Omer from Pesach to Shavuot */\nexport class OmerEvent extends Event {\n  private readonly weekNumber: number;\n  private readonly daysWithinWeeks: number;\n  readonly omer: number;\n\n  /**\n   * @param date\n   * @param omerDay\n   */\n  constructor(date: HDate, omerDay: number) {\n    super(date, `Omer ${omerDay}`, flags.OMER_COUNT);\n    checkDay(omerDay);\n    this.weekNumber = Math.floor((omerDay - 1) / 7) + 1;\n    this.daysWithinWeeks = omerDay % 7 || 7;\n    this.omer = omerDay;\n  }\n\n  /**\n   * Returns the sefira. For example, on day 8:\n   *  * חֶֽסֶד שֶׁבִּגְבוּרָה\n   *  * Chesed shebiGevurah\n   *  * Lovingkindness within Might\n   * @param lang `en` (English), `he` (Hebrew with nikud), or `translit` (Hebrew in Sephardic transliteration)\n   * @returns a string such as `Lovingkindness within Might` or `חֶֽסֶד שֶׁבִּגְבוּרָה`\n   */\n  sefira(lang: OmerLang = 'en'): string {\n    if (lang !== 'he' && lang !== 'translit') {\n      lang = 'en';\n    }\n    const [weekNum, daysWithinWeeks]: number[] = getWeeks(this.omer);\n    const config = sefirot[lang as OmerLang];\n    const pfxWords = config.pfxWords;\n    const words = config.words;\n    const week = pfxWords ? pfxWords[weekNum] : words[weekNum];\n    const dayWithinWeek = words[daysWithinWeeks];\n    const infix = pfxWords\n      ? ''\n      : weekNum === 2 || weekNum === 6\n        ? config.infix26\n        : config.infix;\n    return (dayWithinWeek + ' ' + infix + week).normalize();\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const isHebrewLocale = Locale.isHebrewLocale(locale);\n    const omer = this.omer;\n    const nth = isHebrewLocale ? gematriya(omer) : Locale.ordinal(omer, locale);\n    return nth + ' ' + Locale.gettext('day of the Omer', locale);\n  }\n  /**\n   * Returns translation of \"Omer day 22\" without ordinal numbers.\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    return (\n      Locale.gettext('Omer', locale) +\n      ' ' +\n      Locale.gettext('day', locale) +\n      ' ' +\n      this.omer\n    );\n  }\n  /**\n   * Returns an emoji number symbol with a circle, for example `㊲`\n   *  from the “Enclosed CJK Letters and Months” block of the Unicode standard\n   * @returns a single Unicode character from `①` through `㊾`\n   */\n  getEmoji(): string {\n    if (typeof this.emoji === 'string') return this.emoji;\n    let codePoint: number;\n    const omerDay = this.omer;\n    if (omerDay <= 20) {\n      codePoint = 9312 + omerDay - 1;\n    } else if (omerDay <= 35) {\n      // between 21 and 35 inclusive\n      codePoint = 12881 + omerDay - 21;\n    } else {\n      // between 36 and 49 inclusive\n      codePoint = 12977 + omerDay - 36;\n    }\n    return String.fromCodePoint(codePoint);\n  }\n\n  getWeeks(): number {\n    const day7 = this.daysWithinWeeks === 7;\n    return day7 ? this.weekNumber : this.weekNumber - 1;\n  }\n\n  getDaysWithinWeeks(): number {\n    return this.daysWithinWeeks;\n  }\n  /**\n   * Returns a sentence with that evening's omer count\n   * @returns a string such as `Today is 10 days, which is 1 week and 3 days of the Omer`\n   *  or `הַיוֹם עֲשָׂרָה יָמִים, שְׁהֵם שָׁבוּעַ אֶחָד וְשְׁלוֹשָׁה יָמִים לָעוֹמֶר`\n   */\n  getTodayIs(locale: string): string {\n    locale = (locale || 'en').toLowerCase();\n    const isHebrew = Locale.isHebrewLocale(locale);\n    const str = isHebrew ? omerTodayIsHe(this.omer) : omerTodayIsEn(this.omer);\n    if (locale === 'he-x-nonikud') {\n      return Locale.hebrewStripNikkud(str);\n    }\n    return str;\n  }\n\n  url(): string | undefined {\n    const year = this.getDate().getFullYear();\n    if (year < 5000 || year > 6759) {\n      return undefined;\n    }\n    return `https://www.hebcal.com/omer/${year}/${this.omer}`;\n  }\n\n  /**\n   * Returns the word from Psalm 67 (לַמְנַצֵּחַ, \"Lamnatzeach\") corresponding\n   * to this Omer day. Psalm 67 contains 49 words (excluding its opening verse),\n   * one for each day of the Omer. The words are taken from verses 2–8, split on\n   * spaces and maqef (־).\n   * @returns a Hebrew word from Psalm 67\n   * @example\n   * const ev = new OmerEvent(new HDate(16, 'Nisan', 5785), 1);\n   * ev.getLamnatzeachWord(); // 'אֱלֹהִים' (day 1, first word of verse 2)\n   * @example\n   * const ev = new OmerEvent(new HDate(3, 'Sivan', 5785), 49);\n   * ev.getLamnatzeachWord(); // 'אָרֶץ' (day 49, last word of verse 8)\n   */\n  getLamnatzeachWord(): string {\n    return lamnatzeach[this.omer - 1];\n  }\n\n  /**\n   * Returns the letter from verse 5 of Psalm 67 corresponding to this Omer day.\n   * Verse 5 (יִשְׂמְחוּ וִירַנְּנוּ לְאֻמִּים…) contains exactly 49 letters,\n   * one for each day of the Omer, and is used as a Kabbalistic meditation during\n   * the counting.\n   * @returns a single Hebrew letter from verse 5 of Psalm 67\n   * @example\n   * const ev = new OmerEvent(new HDate(16, 'Nisan', 5785), 1);\n   * ev.getLamnatzeachLetter(); // 'י' (day 1, first letter of verse 5)\n   * @example\n   * const ev = new OmerEvent(new HDate(3, 'Sivan', 5785), 49);\n   * ev.getLamnatzeachLetter(); // 'ה' (day 49, last letter of verse 5)\n   */\n  getLamnatzeachLetter(): string {\n    return lamnatzeachLetters[this.omer - 1];\n  }\n\n  /**\n   * Returns the word from the Ana BeKoach prayer (אָנָּא בְּכֹחַ) corresponding\n   * to this Omer day. Ana BeKoach is a 42-word Kabbalistic prayer whose initial\n   * letters spell out the 42-letter name of God. The prayer has 7 verses of\n   * 6 words each; the 7th entry of each group is the abbreviation of the acrostic\n   * letters for that verse (e.g. `אב״ג ית״ץ` for verse 1). Together the 49\n   * entries (7 verses × 7 entries) align with the 49 days of the Omer, connecting\n   * each day to one of the lower seven Sefirot within a Sefirah.\n   * @returns a Hebrew word or verse-abbreviation string from Ana BeKoach\n   * @example\n   * const ev = new OmerEvent(new HDate(16, 'Nisan', 5785), 1);\n   * ev.getAnaBekoachWord(); // 'אָנָּא' (day 1, first word of verse 1)\n   * @example\n   * const ev = new OmerEvent(new HDate(22, 'Nisan', 5785), 7);\n   * ev.getAnaBekoachWord(); // 'אב״ג ית״ץ' (day 7, acrostic abbreviation for verse 1)\n   * @example\n   * const ev = new OmerEvent(new HDate(3, 'Sivan', 5785), 49);\n   * ev.getAnaBekoachWord(); // 'שק״ו צי״ת' (day 49, acrostic abbreviation for verse 7)\n   */\n  getAnaBekoachWord(): string {\n    return anaBekoach[this.omer - 1].normalize();\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"omer.js","sources":["../../../src/omer.ts"],"sourcesContent":["import {HDate, Locale, gematriya} from '@hebcal/hdate';\nimport {Event, flags} from './event';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\nimport sefira from './sefira.json';\n\n/**\n * Language for counting the Omer can be English or Hebrew.\n * Lang for the Sefira can be English, Hebrew, or Hebrew in Sephardic transliteration.\n */\nexport type OmerLang = 'en' | 'he' | 'translit';\n\nconst sefirot = {\n  en: {\n    infix: 'within ',\n    infix26: 'within ',\n    words: [\n      '',\n      'Lovingkindness',\n      'Might',\n      'Beauty',\n      'Eternity',\n      'Splendor',\n      'Foundation',\n      'Majesty',\n    ],\n    pfxWords: null,\n  },\n  he: {\n    infix: null,\n    infix26: null,\n    words: [\n      '',\n      'חֶֽסֶד',\n      'גְּבוּרָה',\n      'תִּפְאֶֽרֶת',\n      'נֶּֽצַח',\n      'הוֹד',\n      'יְּסוֹד',\n      'מַלְכוּת',\n    ],\n    pfxWords: [\n      '',\n      'שֶׁבְּחֶֽסֶד',\n      'שֶׁבִּגְבוּרָה',\n      'שֶׁבְּתִפְאֶֽרֶת',\n      'שֶׁבְּנֶֽצַח',\n      'שֶׁבְּהוֹד',\n      'שֶׁבִּיְסוֹד',\n      'שֶׁבְּמַלְכוּת',\n    ],\n  },\n  translit: {\n    infix: \"sheb'\",\n    infix26: 'shebi',\n    words: [\n      '',\n      'Chesed',\n      'Gevurah',\n      'Tiferet',\n      'Netzach',\n      'Hod',\n      'Yesod',\n      'Malkhut',\n    ],\n    pfxWords: null,\n  },\n} as const;\n\nfunction checkDay(omerDay: number): void {\n  if (omerDay < 1 || omerDay > 49) {\n    throw new RangeError(`Invalid Omer day ${omerDay}`);\n  }\n}\n\nfunction getWeeks(omerDay: number): number[] {\n  const weekNum: number = Math.floor((omerDay - 1) / 7) + 1;\n  const daysWithinWeeks: number = omerDay % 7 || 7;\n  return [weekNum, daysWithinWeeks];\n}\n\nfunction omerTodayIsEn(omerDay: number): string {\n  const [weekNumber, daysWithinWeeks]: number[] = getWeeks(omerDay);\n\n  const totalDaysStr: string = omerDay === 1 ? 'day' : 'days';\n  let str = `Today is ${omerDay} ${totalDaysStr}`;\n\n  if (weekNumber > 1 || omerDay === 7) {\n    const day7: boolean = daysWithinWeeks === 7;\n    const numWeeks: number = day7 ? weekNumber : weekNumber - 1;\n    const weeksStr: string = numWeeks === 1 ? 'week' : 'weeks';\n    str += `, which are ${numWeeks} ${weeksStr}`;\n    if (!day7) {\n      const daysStr: string = daysWithinWeeks === 1 ? 'day' : 'days';\n      str += ` and ${daysWithinWeeks} ${daysStr}`;\n    }\n  }\n  return str + ' of the Omer';\n}\n\n// adapted from pip hdate package (GPL)\n// https://github.com/py-libhdate/py-libhdate/blob/master/hdate/date.py\n\nconst tens = ['', 'עֲשָׂרָה', 'עֶשְׂרִים', 'שְׁלוֹשִׁים', 'אַרְבָּעִים'];\nconst ones = [\n  '',\n  'אֶחָד',\n  'שְׁנַיִם',\n  'שְׁלוֹשָׁה',\n  'אַרְבָּעָה',\n  'חֲמִשָּׁה',\n  'שִׁשָּׁה',\n  'שִׁבְעָה',\n  'שְׁמוֹנָה',\n  'תִּשְׁעָה',\n];\n\nconst shnei = 'שְׁנֵי';\nconst yamim = 'יָמִים';\nconst shneiYamim = shnei + ' ' + yamim;\nconst shavuot = 'שָׁבוּעוֹת';\nconst yom = 'יוֹם';\nconst yomEchad = yom + ' ' + ones[1];\nconst asar = 'עָשָׂר';\n\nfunction omerTodayIsHe(omerDay: number): string {\n  const ten: number = Math.floor(omerDay / 10);\n  const one: number = omerDay % 10;\n  let str = 'הַיּוֹם ';\n  if (omerDay === 11) {\n    str += 'אַחַד ' + asar;\n  } else if (omerDay === 12) {\n    str += 'שְׁנֵים ' + asar;\n  } else if (12 < omerDay && omerDay < 20) {\n    str += ones[one] + ' ' + asar;\n  } else if (omerDay > 9) {\n    str += ones[one];\n    if (one) {\n      str += ' ';\n      str += ten === 3 ? 'וּ' : 'וְ';\n    }\n  }\n  if (omerDay > 2) {\n    if (omerDay > 20 || omerDay === 10 || omerDay === 20) {\n      str += tens[ten];\n    }\n    if (omerDay < 11) {\n      str += ones[one] + ' ' + yamim + ' ';\n    } else {\n      str += ' ' + yom + ' ';\n    }\n  } else if (omerDay === 1) {\n    str += yomEchad + ' ';\n  } else {\n    // omer == 2\n    str += shneiYamim + ' ';\n  }\n  if (omerDay > 6) {\n    str = str.trim(); // remove trailing space before comma\n    str += ', שֶׁהֵם ';\n    const weeks: number = Math.floor(omerDay / 7);\n    const days: number = omerDay % 7;\n    if (weeks > 2) {\n      str += ones[weeks] + ' ' + shavuot + ' ';\n    } else if (weeks === 1) {\n      str += 'שָׁבֽוּעַ' + ' ' + ones[1] + ' ';\n    } else {\n      // weeks == 2\n      str += shnei + ' ' + shavuot + ' ';\n    }\n    if (days) {\n      if (days === 2 || days === 3) {\n        str += 'וּ';\n      } else if (days === 5) {\n        str += 'וַ';\n      } else {\n        str += 'וְ';\n      }\n      if (days > 2) {\n        str += ones[days] + ' ' + yamim + ' ';\n      } else if (days === 1) {\n        str += yomEchad + ' ';\n      } else {\n        // days == 2\n        str += shneiYamim + ' ';\n      }\n    }\n  }\n  str += 'לָעֽוֹמֶר';\n  return str.normalize();\n}\n\nconst anaBekoach = sefira.anaBekoach;\n\nconst ps67lines = sefira.ps67lines;\n\nconst lamnatzeach = ps67lines.flatMap((x: string) => x.split(/[ ־]/));\n\nconst lamnatzeachLetters = sefira.lamnatzeachLetters.split('');\n\n/**\n * Represents one of the 49 days of counting the Omer between Pesach and\n * Shavuot (16 Nisan through 5 Sivan).\n *\n * Each day has an associated Sefirah pairing (e.g. *Chesed shebiGevurah*),\n * a word from Psalm 67 (Lamnatzeach), a letter from verse 5 of Psalm 67,\n * and a word/acrostic from the Ana BeKoach prayer — all accessible via\n * the methods on this class.\n *\n * @example\n * import {OmerEvent, HDate, months} from '@hebcal/core';\n * const ev = new OmerEvent(new HDate(16, months.NISAN, 5784), 1);\n * ev.render('en');        // '1st day of the Omer'\n * ev.render('he');        // 'א׳ בָּעוֹמֶר'\n * ev.sefira('translit');  // 'Chesed shebChesed'\n * ev.getTodayIs('en');    // 'Today is 1 day of the Omer'\n */\nexport class OmerEvent extends Event {\n  private readonly weekNumber: number;\n  private readonly daysWithinWeeks: number;\n  readonly omer: number;\n\n  /**\n   * Constructs an Omer event for a given day (1–49).\n   *\n   * Throws `RangeError` if `omerDay` is outside 1–49.\n   * @param date Hebrew date this Omer day is counted on (the evening of)\n   * @param omerDay day of the Omer, 1 through 49\n   */\n  constructor(date: HDate, omerDay: number) {\n    super(date, `Omer ${omerDay}`, flags.OMER_COUNT);\n    checkDay(omerDay);\n    this.weekNumber = Math.floor((omerDay - 1) / 7) + 1;\n    this.daysWithinWeeks = omerDay % 7 || 7;\n    this.omer = omerDay;\n  }\n\n  /**\n   * Returns the Sefirah pairing associated with this Omer day —\n   * one of the seven lower Sefirot within another, calculated as\n   * `day-within-week` of `week-within-cycle`. For example, on day 8\n   * (week 2, day 1):\n   *  * חֶֽסֶד שֶׁבִּגְבוּרָה\n   *  * Chesed shebiGevurah\n   *  * Lovingkindness within Might\n   * @example\n   * import {OmerEvent, HDate, months} from '@hebcal/core';\n   * const day8 = new OmerEvent(new HDate(23, months.NISAN, 5784), 8);\n   * day8.sefira('en');        // 'Lovingkindness within Might'\n   * day8.sefira('he');        // 'חֶֽסֶד שֶׁבִּגְבוּרָה'\n   * day8.sefira('translit');  // 'Chesed shebiGevurah'\n   * @param lang `en` (English), `he` (Hebrew with nikud), or `translit` (Hebrew in Sephardic transliteration)\n   * @returns a string such as `Lovingkindness within Might` or `חֶֽסֶד שֶׁבִּגְבוּרָה`\n   */\n  sefira(lang: OmerLang = 'en'): string {\n    if (lang !== 'he' && lang !== 'translit') {\n      lang = 'en';\n    }\n    const [weekNum, daysWithinWeeks]: number[] = getWeeks(this.omer);\n    const config = sefirot[lang as OmerLang];\n    const pfxWords = config.pfxWords;\n    const words = config.words;\n    const week = pfxWords ? pfxWords[weekNum] : words[weekNum];\n    const dayWithinWeek = words[daysWithinWeeks];\n    const infix = pfxWords\n      ? ''\n      : weekNum === 2 || weekNum === 6\n        ? config.infix26\n        : config.infix;\n    return (dayWithinWeek + ' ' + infix + week).normalize();\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const isHebrewLocale = Locale.isHebrewLocale(locale);\n    const omer = this.omer;\n    const nth = isHebrewLocale ? gematriya(omer) : Locale.ordinal(omer, locale);\n    return nth + ' ' + Locale.gettext('day of the Omer', locale);\n  }\n  /**\n   * Returns translation of \"Omer day 22\" without ordinal numbers.\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    return (\n      Locale.gettext('Omer', locale) +\n      ' ' +\n      Locale.gettext('day', locale) +\n      ' ' +\n      this.omer\n    );\n  }\n  /**\n   * Returns an emoji number symbol with a circle, for example `㊲`\n   *  from the “Enclosed CJK Letters and Months” block of the Unicode standard\n   * @returns a single Unicode character from `①` through `㊾`\n   */\n  getEmoji(): string {\n    if (typeof this.emoji === 'string') return this.emoji;\n    let codePoint: number;\n    const omerDay = this.omer;\n    if (omerDay <= 20) {\n      codePoint = 9312 + omerDay - 1;\n    } else if (omerDay <= 35) {\n      // between 21 and 35 inclusive\n      codePoint = 12881 + omerDay - 21;\n    } else {\n      // between 36 and 49 inclusive\n      codePoint = 12977 + omerDay - 36;\n    }\n    return String.fromCodePoint(codePoint);\n  }\n\n  getWeeks(): number {\n    const day7 = this.daysWithinWeeks === 7;\n    return day7 ? this.weekNumber : this.weekNumber - 1;\n  }\n\n  getDaysWithinWeeks(): number {\n    return this.daysWithinWeeks;\n  }\n  /**\n   * Returns a sentence with that evening's omer count\n   * @returns a string such as `Today is 10 days, which is 1 week and 3 days of the Omer`\n   *  or `הַיוֹם עֲשָׂרָה יָמִים, שְׁהֵם שָׁבוּעַ אֶחָד וְשְׁלוֹשָׁה יָמִים לָעוֹמֶר`\n   */\n  getTodayIs(locale: string): string {\n    locale = (locale || 'en').toLowerCase();\n    const isHebrew = Locale.isHebrewLocale(locale);\n    const str = isHebrew ? omerTodayIsHe(this.omer) : omerTodayIsEn(this.omer);\n    if (locale === 'he-x-nonikud') {\n      return Locale.hebrewStripNikkud(str);\n    }\n    return str;\n  }\n\n  url(): string | undefined {\n    const year = this.getDate().getFullYear();\n    if (year < 5000 || year > 6759) {\n      return undefined;\n    }\n    return `https://www.hebcal.com/omer/${year}/${this.omer}`;\n  }\n\n  /**\n   * Returns the word from Psalm 67 (לַמְנַצֵּחַ, \"Lamnatzeach\") corresponding\n   * to this Omer day. Psalm 67 contains 49 words (excluding its opening verse),\n   * one for each day of the Omer. The words are taken from verses 2–8, split on\n   * spaces and maqef (־).\n   * @returns a Hebrew word from Psalm 67\n   * @example\n   * const ev = new OmerEvent(new HDate(16, 'Nisan', 5785), 1);\n   * ev.getLamnatzeachWord(); // 'אֱלֹהִים' (day 1, first word of verse 2)\n   * @example\n   * const ev = new OmerEvent(new HDate(3, 'Sivan', 5785), 49);\n   * ev.getLamnatzeachWord(); // 'אָרֶץ' (day 49, last word of verse 8)\n   */\n  getLamnatzeachWord(): string {\n    return lamnatzeach[this.omer - 1];\n  }\n\n  /**\n   * Returns the letter from verse 5 of Psalm 67 corresponding to this Omer day.\n   * Verse 5 (יִשְׂמְחוּ וִירַנְּנוּ לְאֻמִּים…) contains exactly 49 letters,\n   * one for each day of the Omer, and is used as a Kabbalistic meditation during\n   * the counting.\n   * @returns a single Hebrew letter from verse 5 of Psalm 67\n   * @example\n   * const ev = new OmerEvent(new HDate(16, 'Nisan', 5785), 1);\n   * ev.getLamnatzeachLetter(); // 'י' (day 1, first letter of verse 5)\n   * @example\n   * const ev = new OmerEvent(new HDate(3, 'Sivan', 5785), 49);\n   * ev.getLamnatzeachLetter(); // 'ה' (day 49, last letter of verse 5)\n   */\n  getLamnatzeachLetter(): string {\n    return lamnatzeachLetters[this.omer - 1];\n  }\n\n  /**\n   * Returns the word from the Ana BeKoach prayer (אָנָּא בְּכֹחַ) corresponding\n   * to this Omer day. Ana BeKoach is a 42-word Kabbalistic prayer whose initial\n   * letters spell out the 42-letter name of God. The prayer has 7 verses of\n   * 6 words each; the 7th entry of each group is the abbreviation of the acrostic\n   * letters for that verse (e.g. `אב״ג ית״ץ` for verse 1). Together the 49\n   * entries (7 verses × 7 entries) align with the 49 days of the Omer, connecting\n   * each day to one of the lower seven Sefirot within a Sefirah.\n   * @returns a Hebrew word or verse-abbreviation string from Ana BeKoach\n   * @example\n   * const ev = new OmerEvent(new HDate(16, 'Nisan', 5785), 1);\n   * ev.getAnaBekoachWord(); // 'אָנָּא' (day 1, first word of verse 1)\n   * @example\n   * const ev = new OmerEvent(new HDate(22, 'Nisan', 5785), 7);\n   * ev.getAnaBekoachWord(); // 'אב״ג ית״ץ' (day 7, acrostic abbreviation for verse 1)\n   * @example\n   * const ev = new OmerEvent(new HDate(3, 'Sivan', 5785), 49);\n   * ev.getAnaBekoachWord(); // 'שק״ו צי״ת' (day 49, acrostic abbreviation for verse 7)\n   */\n  getAnaBekoachWord(): string {\n    return anaBekoach[this.omer - 1].normalize();\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/parshaName.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.2, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import './locale.js';
 import { Locale } from '@hebcal/hdate';
 

package/dist/esm/parshaYear.d.ts

@@ -1,6 +1,17 @@
 import { ParshaEvent } from './ParshaEvent';
 /**
- * Calculates weekly Torah Reading on Saturdays for entire year
+ * Calculates the weekly Torah Reading (Parashat HaShavua) on Saturdays for
+ * an entire Hebrew year.
+ *
+ * Saturdays on which a Yom Tov reading displaces the regular parsha
+ * (e.g. Shabbat Chol ha-Moed Pesach/Sukkot, Yom Kippur on Shabbat) are
+ * skipped — for those use {@link getHolidaysOnDate} or
+ * {@link Sedra.lookup}.
+ * @example
+ * import {parshaYear} from '@hebcal/core';
+ * const events = parshaYear(5784, false);
+ * events[0].render('en'); // 'Parashat Vayeilech'
+ * events[0].getDate().toString(); // '4 Tishrei 5784'
  * @param year Hebrew year
  * @param il Israel (false for Diaspora)
  * @returns an array of `ParshaEvent` occurring on Saturdays that contain a regular

package/dist/esm/parshaYear.js

@@ -1,10 +1,21 @@
-/*! @hebcal/core v6.5.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.5.2, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import { HDate, months } from '@hebcal/hdate';
 import { ParshaEvent } from './ParshaEvent.js';
 import { getSedra } from './sedra.js';
 
 /**
- * Calculates weekly Torah Reading on Saturdays for entire year
+ * Calculates the weekly Torah Reading (Parashat HaShavua) on Saturdays for
+ * an entire Hebrew year.
+ *
+ * Saturdays on which a Yom Tov reading displaces the regular parsha
+ * (e.g. Shabbat Chol ha-Moed Pesach/Sukkot, Yom Kippur on Shabbat) are
+ * skipped — for those use {@link getHolidaysOnDate} or
+ * {@link Sedra.lookup}.
+ * @example
+ * import {parshaYear} from '@hebcal/core';
+ * const events = parshaYear(5784, false);
+ * events[0].render('en'); // 'Parashat Vayeilech'
+ * events[0].getDate().toString(); // '4 Tishrei 5784'
  * @param year Hebrew year
  * @param il Israel (false for Diaspora)
  * @returns an array of `ParshaEvent` occurring on Saturdays that contain a regular

package/dist/esm/parshaYear.js.map

@@ -1 +1 @@
-{"version":3,"file":"parshaYear.js","sources":["../../../src/parshaYear.ts"],"sourcesContent":["import {HDate, months} from '@hebcal/hdate';\nimport {ParshaEvent} from './ParshaEvent';\nimport {getSedra} from './sedra';\n\n/**\n * Calculates weekly Torah Reading on Saturdays for entire year\n * @param year Hebrew year\n * @param il Israel (false for Diaspora)\n * @returns an array of `ParshaEvent` occurring on Saturdays that contain a regular\n *  (non-holiday) Parashat HaShavua\n */\nexport function parshaYear(year: number, il: boolean): ParshaEvent[] {\n  const sedra = getSedra(year, il);\n  const startAbs = sedra.getFirstSaturday();\n  const endAbs = HDate.hebrew2abs(year, months.ELUL, 29);\n  const events: ParshaEvent[] = [];\n  for (let absDt = startAbs; absDt <= endAbs; absDt += 7) {\n    const parsha = sedra.lookup(absDt);\n    if (!parsha.chag) {\n      const ev = new ParshaEvent(parsha);\n      events.push(ev);\n    }\n  }\n  return events;\n}\n"],"names":[],"mappings":";;;;;AAIA;;;;;;AAMG;AACG,SAAU,UAAU,CAAC,IAAY,EAAE,EAAW,EAAA;IAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;AAChC,IAAA,MAAM,QAAQ,GAAG,KAAK,CAAC,gBAAgB,EAAE;AACzC,IAAA,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACtD,MAAM,MAAM,GAAkB,EAAE;AAChC,IAAA,KAAK,IAAI,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE;QACtD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;AAClC,QAAA,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;AAChB,YAAA,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;AAClC,YAAA,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACjB;IACF;AACA,IAAA,OAAO,MAAM;AACf;;;;"}
+{"version":3,"file":"parshaYear.js","sources":["../../../src/parshaYear.ts"],"sourcesContent":["import {HDate, months} from '@hebcal/hdate';\nimport {ParshaEvent} from './ParshaEvent';\nimport {getSedra} from './sedra';\n\n/**\n * Calculates the weekly Torah Reading (Parashat HaShavua) on Saturdays for\n * an entire Hebrew year.\n *\n * Saturdays on which a Yom Tov reading displaces the regular parsha\n * (e.g. Shabbat Chol ha-Moed Pesach/Sukkot, Yom Kippur on Shabbat) are\n * skipped — for those use {@link getHolidaysOnDate} or\n * {@link Sedra.lookup}.\n * @example\n * import {parshaYear} from '@hebcal/core';\n * const events = parshaYear(5784, false);\n * events[0].render('en'); // 'Parashat Vayeilech'\n * events[0].getDate().toString(); // '4 Tishrei 5784'\n * @param year Hebrew year\n * @param il Israel (false for Diaspora)\n * @returns an array of `ParshaEvent` occurring on Saturdays that contain a regular\n *  (non-holiday) Parashat HaShavua\n */\nexport function parshaYear(year: number, il: boolean): ParshaEvent[] {\n  const sedra = getSedra(year, il);\n  const startAbs = sedra.getFirstSaturday();\n  const endAbs = HDate.hebrew2abs(year, months.ELUL, 29);\n  const events: ParshaEvent[] = [];\n  for (let absDt = startAbs; absDt <= endAbs; absDt += 7) {\n    const parsha = sedra.lookup(absDt);\n    if (!parsha.chag) {\n      const ev = new ParshaEvent(parsha);\n      events.push(ev);\n    }\n  }\n  return events;\n}\n"],"names":[],"mappings":";;;;;AAIA;;;;;;;;;;;;;;;;;AAiBG;AACG,SAAU,UAAU,CAAC,IAAY,EAAE,EAAW,EAAA;IAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;AAChC,IAAA,MAAM,QAAQ,GAAG,KAAK,CAAC,gBAAgB,EAAE;AACzC,IAAA,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACtD,MAAM,MAAM,GAAkB,EAAE;AAChC,IAAA,KAAK,IAAI,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE;QACtD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;AAClC,QAAA,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;AAChB,YAAA,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC;AAClC,YAAA,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACjB;IACF;AACA,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/esm/pkgVersion.d.ts

@@ -1,2 +1,2 @@
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-export declare const version = "6.5.1";
+export declare const version = "6.5.2";

package/dist/esm/pkgVersion.js

@@ -1,6 +1,6 @@
-/*! @hebcal/core v6.5.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.5.2, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-const version = '6.5.1';
+const version = '6.5.2';
 
 export { version };
 //# sourceMappingURL=pkgVersion.js.map

package/dist/esm/pkgVersion.js.map

@@ -1 +1 @@
-{"version":3,"file":"pkgVersion.js","sources":["../../../src/pkgVersion.ts"],"sourcesContent":["/** DO NOT EDIT THIS AUTO-GENERATED FILE! */\nexport const version = '6.5.1';\n"],"names":[],"mappings":";AAAA;AACO,MAAM,OAAO,GAAG;;;;"}
+{"version":3,"file":"pkgVersion.js","sources":["../../../src/pkgVersion.ts"],"sourcesContent":["/** DO NOT EDIT THIS AUTO-GENERATED FILE! */\nexport const version = '6.5.2';\n"],"names":[],"mappings":";AAAA;AACO,MAAM,OAAO,GAAG;;;;"}

package/dist/esm/reformatTimeStr.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.2, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 const hour12cc = {
     US: 1,
     CA: 1,

package/dist/esm/sedra.d.ts

@@ -27,7 +27,23 @@ export type SedraResult = {
     il: boolean;
 };
 /**
- * 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 declare class Sedra {
     private readonly year;
@@ -37,14 +53,29 @@ export declare class Sedra {
     private readonly theSedraArray;
     private readonly 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)
      */
     constructor(hyear: number, il: boolean);
     /**
-     * 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
@@ -54,22 +85,63 @@ export declare class Sedra {
     find(parsha: number | string | string[]): HDate | null;
     private findInternal;
     /**
-     * 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: number | string): HDate | null;
     /**
-     * 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(): readonly NumberOrString[];
     /**
-     * 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(): number;
+    /** Returns the Hebrew year this `Sedra` instance covers. */
     getYear(): number;
     /**
-     * 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: HDate | number): SedraResult;
@@ -86,10 +158,18 @@ export declare class Sedra {
 export declare const parshiot: readonly string[];
 type NumberOrString = number | string;
 /**
- * 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 declare function getSedra(hyear: number, il: boolean): Sedra;
 export {};

package/dist/esm/sedra.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.2, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import { HDate, months } from '@hebcal/hdate';
 import QuickLRU from 'quick-lru';
 import './locale.js';
@@ -51,7 +51,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']
  */
 class Sedra {
     year;
@@ -61,7 +77,7 @@ 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)
      */
@@ -91,8 +107,23 @@ 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
@@ -152,8 +183,22 @@ 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);
@@ -196,23 +241,50 @@ 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) {
@@ -469,10 +541,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)
  */
 function getSedra(hyear, il) {
     const cacheKey = `${hyear}-${il ? 1 : 0}`;