@hebcal/core 6.8.1 → 6.9.0

package/dist/esm/molad.js.map

@@ -1 +1 @@
-{"version":3,"file":"molad.js","sources":["../../../src/molad.ts"],"sourcesContent":["import 'temporal-polyfill/global';\nimport {Event, flags} from './event';\nimport {CalOptions} from './CalOptions';\nimport {HDate, Locale, pad2} from '@hebcal/hdate';\nimport {reformatTimeStr} from './reformatTimeStr';\nimport {MoladBase, calculateMolad} from './moladBase';\nimport {getMoladAsDate} from './moladDate';\nimport {smartApostrophe} from './string';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst enDoW = [\n  'Sunday',\n  'Monday',\n  'Tuesday',\n  'Wednesday',\n  'Thursday',\n  'Friday',\n  'Saturday',\n] as const;\n\nconst heDayNames = [\n  'רִאשׁוֹן',\n  'שֵׁנִי',\n  'שְׁלִישִׁי',\n  'רְבִיעִי',\n  'חֲמִישִׁי',\n  'שִׁישִּׁי',\n  'שַׁבָּת',\n] as const;\n\nconst frDoW = [\n  'Dimanche',\n  'Lundi',\n  'Mardi',\n  'Mercredi',\n  'Jeudi',\n  'Vendredi',\n  'Samedi',\n] as const;\nconst night = 'בַּלַּ֥יְלָה';\n\nfunction getDayNames(locale?: string): readonly string[] {\n  if (Locale.isHebrewLocale(locale)) {\n    return heDayNames;\n  }\n  if (locale === 'fr') {\n    return frDoW;\n  }\n  return enDoW;\n}\n\nfunction getHebrewTimeOfDay(hour: number): string {\n  if (hour < 5) return night;\n  if (hour < 12) return 'בַּבֹּקֶר';\n  if (hour < 17) return 'בַּצׇּהֳרַיִים';\n  if (hour < 21) return 'בָּעֶרֶב';\n  return night;\n}\n\n/**\n * Represents a *molad* — the calculated moment when the new moon is \"born\"\n * for a given Hebrew month.\n *\n * The molad is announced in synagogue on Shabbat Mevarchim (the Shabbat\n * before Rosh Chodesh) and is the anchor point for Kiddush Levana zmanim.\n * Calculations use the traditional chalakim arithmetic\n * (1 hour = 1080 chalakim) anchored to *Molad Tohu BaHaRaD*.\n *\n * @example\n * import {Molad, months} from '@hebcal/core';\n * const m = new Molad(5784, months.NISAN);\n * console.log(m.getMonthName()); // 'Nisan'\n * console.log(m.getHour(), m.getMinutes(), m.getChalakim()); // e.g. 1 31 12\n * console.log(m.render('en')); // 'Molad Nisan: Mon, 1:31am and 12 chalakim'\n */\nexport class Molad {\n  private readonly m: MoladBase;\n  private readonly year: number;\n  private readonly month: number;\n  private instant?: Temporal.ZonedDateTime;\n\n  /**\n   * Calculates the molad for a given Hebrew year and month.\n   * @param year Hebrew year\n   * @param month 1=NISAN, 7=TISHREI (uses Nisan-based numbering)\n   */\n  constructor(year: number, month: number) {\n    this.m = calculateMolad(year, month);\n    this.year = year;\n    this.month = month;\n  }\n  /**\n   * The exact Hebrew date of the molad, which often falls on the\n   * 28th or 30th of the preceeding month, occasionally on the first of the\n   * month, and in extremely rare circumstances the 27th of the month.\n   * - Molad Shevat 5541 occured on 27 Tevet / 1781-01-24T19:57:20.170Z\n   * - Molad Shevat 5788 will occur on 27 Tevet / 2028-01-26T19:07:03.504Z\n   * - Molad Nissan 5866 will occur on 27 Adar II / 2106-04-03T21:08:46.837Z\n   */\n  getMoladDate(): HDate {\n    return this.m.hdate;\n  }\n  /**\n   * The year of the molad (as constructed)\n   */\n  getYear(): number {\n    return this.year;\n  }\n  /**\n   * The month (1=NISSAN, 7=TISHREI) as constructed\n   */\n  getMonth(): number {\n    return this.month;\n  }\n  /**\n   * Returns a transliterated string name of the molad's Hebrew month,\n   * for example 'Elul' or 'Cheshvan'.\n   */\n  getMonthName(): string {\n    return HDate.getMonthName(this.month, this.year);\n  }\n  /**\n   * @returns Day of Week (0=Sunday, 6=Saturday)\n   */\n  getDow(): number {\n    return this.m.hdate.getDay();\n  }\n  /**\n   * @returns hour of day (0-23)\n   */\n  getHour(): number {\n    return this.m.hour;\n  }\n  /**\n   * @returns minutes past hour (0-59)\n   */\n  getMinutes(): number {\n    return this.m.minutes;\n  }\n  /**\n   * @returns parts of a minute (0-17)\n   */\n  getChalakim(): number {\n    return this.m.chalakim;\n  }\n  /**\n   * Returns the molad in Standard Time in Yerushalayim as a `Temporal.ZonedDateTime`.\n   * This method subtracts 20.94 minutes (20 minutes and 56.496 seconds) from the computed time (Har Habayis with a longitude\n   * of 35.2354&deg; is 5.2354&deg; away from the %15 timezone longitude) to get to standard time. This method\n   * intentionally uses standard time and not daylight savings time.\n   *\n   * The returned value is cached after the first call.\n   * @example\n   * import {Molad, months} from '@hebcal/core';\n   * const m = new Molad(5784, months.NISAN);\n   * const zdt = m.getInstant();\n   * console.log(zdt.toString()); // e.g. '2024-04-08T17:21:13.333+00:00[UTC]'\n   * @return the `Temporal.ZonedDateTime` representing the moment of the molad\n   */\n  getInstant(): Temporal.ZonedDateTime {\n    this.instant ??= getMoladAsDate(this.m);\n    return this.instant;\n  }\n  /**\n   * Returns the earliest time of _Kiddush Levana_ calculated as 3 days after the molad. This method returns the time\n   * even if it is during the day when _Kiddush Levana_ can't be said. Callers of this method should consider\n   * displaying the next _tzais_ if the zman is between _alos_ and _tzais_.\n   *\n   * @return the Temporal.ZonedDateTime representing the moment 3 days after the molad.\n   */\n  getTchilasZmanKidushLevana3Days(): Temporal.ZonedDateTime {\n    const zdt = this.getInstant();\n    return zdt.add({hours: 72});\n  }\n\n  /**\n   * Returns the earliest time of Kiddush Levana calculated as 7 days after the molad as mentioned by the <a\n   * href=\"https://en.wikipedia.org/wiki/Yosef_Karo\">Mechaber</a>. See the <a\n   * href=\"https://en.wikipedia.org/wiki/Yoel_Sirkis\">Bach's</a> opinion on this time. This method returns the time\n   * even if it is during the day when _Kiddush Levana_ can't be said. Callers of this method should consider\n   * displaying the next _tzais_ if the zman is between _alos_ and _tzais_.\n   *\n   * @return the Temporal.ZonedDateTime representing the moment 7 days after the molad.\n   */\n  getTchilasZmanKidushLevana7Days(): Temporal.ZonedDateTime {\n    const zdt = this.getInstant();\n    return zdt.add({hours: 168});\n  }\n\n  /**\n   * Returns the latest time of Kiddush Levana according to the <a\n   * href=\"https://en.wikipedia.org/wiki/Yaakov_ben_Moshe_Levi_Moelin\">Maharil's</a> opinion that it is calculated as\n   * halfway between molad and molad. This adds half the 29 days, 12 hours and 793 chalakim time between molad and\n   * molad (14 days, 18 hours, 22 minutes and 666 milliseconds) to the month's molad. This method returns the time\n   * even if it is during the day when _Kiddush Levana_ can't be said. Callers of this method should consider\n   * displaying _alos_ before this time if the zman is between _alos_ and _tzais_.\n   *\n   * @return the Temporal.ZonedDateTime representing the moment halfway between molad and molad.\n   */\n  getSofZmanKidushLevanaBetweenMoldos(): Temporal.ZonedDateTime {\n    const zdt = this.getInstant();\n    // add half the time between molad and molad (half of 29 days, 12 hours and 793 chalakim (44 minutes, 3.3\n    // seconds), or 14 days, 18 hours, 22 minutes and 666 milliseconds). Add it as hours, not days, to avoid\n    // DST/ST crossover issues.\n    return zdt.add({\n      hours: 24 * 14 + 18,\n      minutes: 22,\n      seconds: 1,\n      milliseconds: 666,\n    });\n  }\n\n  /**\n   * Returns the latest time of Kiddush Levana calculated as 15 days after the molad. This is the opinion brought down\n   * in the Shulchan Aruch (Orach Chaim 426). It should be noted that some opinions hold that the\n   * <a href=\"https://en.wikipedia.org/wiki/Moses_Isserles\">Rema</a> who brings down the opinion of the <a\n   * href=\"https://en.wikipedia.org/wiki/Yaakov_ben_Moshe_Levi_Moelin\">Maharil's</a> of calculating\n   * {@link Molad.getSofZmanKidushLevanaBetweenMoldos() half way between molad and mold} is of the opinion that Mechaber\n   * agrees to his opinion. Also see the Aruch Hashulchan. For additional details on the subject, See Rabbi Dovid\n   * Heber's very detailed writeup in Siman Daled (chapter 4) of <a\n   * href=\"https://www.worldcat.org/oclc/461326125\">Shaarei Zmanim</a>. This method returns the time even if it is during\n   * the day when _Kiddush Levana_ can't be said. Callers of this method should consider displaying _alos_\n   * before this time if the zman is between _alos_ and _tzais_.\n   *\n   * @return the Temporal.ZonedDateTime representing the moment 15 days after the molad.\n   */\n  getSofZmanKidushLevana15Days(): Temporal.ZonedDateTime {\n    const zdt = this.getInstant();\n    // 15 days after the molad. Add it as hours, not days, to avoid DST/ST crossover issues.\n    return zdt.add({hours: 24 * 15});\n  }\n\n  /**\n   * Returns a human-readable, localized string announcing the molad —\n   * suitable for use on Shabbat Mevarchim. The format includes the Hebrew\n   * month name, day of week, hour : minute, and chalakim if non-zero.\n   *\n   * Time format honors `options.hour12` and `options.location` (12-hour vs.\n   * 24-hour); see {@link HebrewCalendar.reformatTimeStr}.\n   * @example\n   * import {Molad, months} from '@hebcal/core';\n   * const m = new Molad(5784, months.NISAN);\n   * m.render('en', {hour12: true});\n   * // => 'Molad Nisan: Mon, 7:21pm and 6 chalakim'\n   * m.render('he');\n   * // => 'מוֹלָד נִיסָן יִהְיֶה בַּיּוֹם שֵׁנִי בשָׁבוּעַ, …'\n   * @param [locale] Optional locale name (defaults to empty locale)\n   * @param options used for time formatting (12-hour vs 24-hour)\n   */\n  render(locale?: string, options?: CalOptions): string {\n    const monthName = Locale.gettext(this.getMonthName(), locale);\n    const dayNames = getDayNames(locale);\n    const dow = dayNames[this.getDow()];\n    const minutes = this.getMinutes();\n    const hour = this.getHour();\n    const chalakim = this.getChalakim();\n    const moladStr = Locale.gettext('Molad', locale);\n    const minutesStr = Locale.lookupTranslation('min', locale) ?? 'minutes';\n    const chalakimStr = Locale.gettext('chalakim', locale);\n    const and = Locale.gettext('and', locale);\n    if (Locale.isHebrewLocale(locale)) {\n      const ampm = getHebrewTimeOfDay(hour);\n      let result =\n        `${moladStr} ${monthName} יִהְיֶה בַּיּוֹם ${dow} בשָׁבוּעַ, ` +\n        `בְּשָׁעָה ${hour} ${ampm}, ` +\n        `ו-${minutes} ${minutesStr}`;\n      if (chalakim !== 0) {\n        result += ` ו-${chalakim} ${chalakimStr}`;\n      }\n      if (locale!.toLocaleLowerCase() === 'he-x-nonikud') {\n        return Locale.hebrewStripNikkud(result);\n      }\n      return result;\n    }\n    const fmtTime = reformatTimeStr(`${hour}:${pad2(minutes)}`, 'pm', options);\n    const month = smartApostrophe(monthName);\n    const result = `${moladStr} ${month}: ${dow}, ${fmtTime}`;\n    if (chalakim === 0) {\n      return result;\n    }\n    return result + ` ${and} ${chalakim} ${chalakimStr}`;\n  }\n}\n\n/** Represents a Molad announcement on Shabbat Mevarchim */\nexport class MoladEvent extends Event {\n  readonly molad: Molad;\n  private readonly options: CalOptions;\n  /**\n   * @param date Hebrew date event occurs\n   * @param hyear molad year\n   * @param hmonth molad month\n   * @param options\n   */\n  constructor(date: HDate, hyear: number, hmonth: number, options: CalOptions) {\n    const m = new Molad(hyear, hmonth);\n    const monthName = m.getMonthName();\n    super(date, `Molad ${monthName} ${hyear}`, flags.MOLAD);\n    this.molad = m;\n    this.options = options;\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    return this.molad.render(locale, this.options);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"molad.js","sources":["../../../src/molad.ts"],"sourcesContent":["import 'temporal-polyfill/global';\nimport {Event, flags} from './event';\nimport {CalOptions} from './CalOptions';\nimport {HDate, Locale, pad2} from '@hebcal/hdate';\nimport {reformatTimeStr} from './reformatTimeStr';\nimport {MoladBase, calculateMolad} from './moladBase';\nimport {getMoladAsDate} from './moladDate';\nimport {smartApostrophe} from './string';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst enDoW = [\n  'Sunday',\n  'Monday',\n  'Tuesday',\n  'Wednesday',\n  'Thursday',\n  'Friday',\n  'Saturday',\n] as const;\n\nconst heDayNames = [\n  'רִאשׁוֹן',\n  'שֵׁנִי',\n  'שְׁלִישִׁי',\n  'רְבִיעִי',\n  'חֲמִישִׁי',\n  'שִׁישִּׁי',\n  'שַׁבָּת',\n] as const;\n\nconst frDoW = [\n  'Dimanche',\n  'Lundi',\n  'Mardi',\n  'Mercredi',\n  'Jeudi',\n  'Vendredi',\n  'Samedi',\n] as const;\nconst night = 'בַּלַּ֥יְלָה';\n\nfunction getDayNames(locale?: string): readonly string[] {\n  if (Locale.isHebrewLocale(locale)) {\n    return heDayNames;\n  }\n  if (locale === 'fr') {\n    return frDoW;\n  }\n  return enDoW;\n}\n\nfunction getHebrewTimeOfDay(hour: number): string {\n  if (hour < 5) return night;\n  if (hour < 12) return 'בַּבֹּקֶר';\n  if (hour < 17) return 'בַּצׇּהֳרַיִים';\n  if (hour < 21) return 'בָּעֶרֶב';\n  return night;\n}\n\n/**\n * Represents a *molad* — the calculated moment when the new moon is \"born\"\n * for a given Hebrew month.\n *\n * The molad is announced in synagogue on Shabbat Mevarchim (the Shabbat\n * before Rosh Chodesh) and is the anchor point for Kiddush Levana zmanim.\n * Calculations use the traditional chalakim arithmetic\n * (1 hour = 1080 chalakim) anchored to *Molad Tohu BaHaRaD*.\n *\n * @example\n * import {Molad, months} from '@hebcal/core';\n * const m = new Molad(5784, months.NISAN);\n * console.log(m.getMonthName()); // 'Nisan'\n * console.log(m.getHour(), m.getMinutes(), m.getChalakim()); // 22 57 7\n * console.log(m.render('en')); // 'Molad Nisan: Monday, 10:57pm and 7 chalakim'\n */\nexport class Molad {\n  private readonly m: MoladBase;\n  private readonly year: number;\n  private readonly month: number;\n  private instant?: Temporal.ZonedDateTime;\n\n  /**\n   * Calculates the molad for a given Hebrew year and month.\n   * @param year Hebrew year\n   * @param month 1=NISAN, 7=TISHREI (uses Nisan-based numbering)\n   */\n  constructor(year: number, month: number) {\n    this.m = calculateMolad(year, month);\n    this.year = year;\n    this.month = month;\n  }\n  /**\n   * The exact Hebrew date of the molad, which often falls on the\n   * 28th or 30th of the preceeding month, occasionally on the first of the\n   * month, and in extremely rare circumstances the 27th of the month.\n   * - Molad Shevat 5541 occured on 27 Tevet / 1781-01-24T19:57:20.170Z\n   * - Molad Shevat 5788 will occur on 27 Tevet / 2028-01-26T19:07:03.504Z\n   * - Molad Nissan 5866 will occur on 27 Adar II / 2106-04-03T21:08:46.837Z\n   */\n  getMoladDate(): HDate {\n    return this.m.hdate;\n  }\n  /**\n   * The year of the molad (as constructed)\n   */\n  getYear(): number {\n    return this.year;\n  }\n  /**\n   * The month (1=NISSAN, 7=TISHREI) as constructed\n   */\n  getMonth(): number {\n    return this.month;\n  }\n  /**\n   * Returns a transliterated string name of the molad's Hebrew month,\n   * for example 'Elul' or 'Cheshvan'.\n   */\n  getMonthName(): string {\n    return HDate.getMonthName(this.month, this.year);\n  }\n  /**\n   * @returns Day of Week (0=Sunday, 6=Saturday)\n   */\n  getDow(): number {\n    return this.m.hdate.getDay();\n  }\n  /**\n   * @returns hour of day (0-23)\n   */\n  getHour(): number {\n    return this.m.hour;\n  }\n  /**\n   * @returns minutes past hour (0-59)\n   */\n  getMinutes(): number {\n    return this.m.minutes;\n  }\n  /**\n   * @returns parts of a minute (0-17)\n   */\n  getChalakim(): number {\n    return this.m.chalakim;\n  }\n  /**\n   * Returns the moment of the molad as a `Temporal.ZonedDateTime` in the `UTC` zone.\n   *\n   * The molad is computed in Jerusalem *standard* time and then converted, so the\n   * returned instant is correct year-round; only the zone of the returned object\n   * is `UTC`. This method subtracts 20.94 minutes (20 minutes and 56.496 seconds)\n   * from the computed time — Har Habayis, at longitude 35.2354°, is 5.2354° away\n   * from the multiple-of-15 timezone longitude — to get to standard time. Daylight\n   * savings time is intentionally not applied; adjust when formatting for display.\n   *\n   * The returned value is cached after the first call.\n   * @example\n   * import {Molad, months} from '@hebcal/core';\n   * const m = new Molad(5784, months.NISAN);\n   * const zdt = m.getInstant();\n   * console.log(zdt.toString()); // '2024-04-08T20:36:26.837+00:00[UTC]'\n   * @return the `Temporal.ZonedDateTime` representing the moment of the molad\n   */\n  getInstant(): Temporal.ZonedDateTime {\n    this.instant ??= getMoladAsDate(this.m);\n    return this.instant;\n  }\n  /**\n   * Returns the earliest time of _Kiddush Levana_ calculated as 3 days after the molad. This method returns the time\n   * even if it is during the day when _Kiddush Levana_ can't be said. Callers of this method should consider\n   * displaying the next _tzais_ if the zman is between _alos_ and _tzais_.\n   *\n   * @return the Temporal.ZonedDateTime representing the moment 3 days after the molad.\n   */\n  getTchilasZmanKidushLevana3Days(): Temporal.ZonedDateTime {\n    const zdt = this.getInstant();\n    return zdt.add({hours: 72});\n  }\n\n  /**\n   * Returns the earliest time of Kiddush Levana calculated as 7 days after the molad as mentioned by the\n   * [Mechaber](https://en.wikipedia.org/wiki/Yosef_Karo). See the\n   * [Bach's](https://en.wikipedia.org/wiki/Yoel_Sirkis) opinion on this time. This method returns the time\n   * even if it is during the day when _Kiddush Levana_ can't be said. Callers of this method should consider\n   * displaying the next _tzais_ if the zman is between _alos_ and _tzais_.\n   *\n   * @return the Temporal.ZonedDateTime representing the moment 7 days after the molad.\n   */\n  getTchilasZmanKidushLevana7Days(): Temporal.ZonedDateTime {\n    const zdt = this.getInstant();\n    return zdt.add({hours: 168});\n  }\n\n  /**\n   * Returns the latest time of Kiddush Levana according to the\n   * [Maharil's](https://en.wikipedia.org/wiki/Yaakov_ben_Moshe_Levi_Moelin) opinion that it is calculated as\n   * halfway between molad and molad. This adds half the 29 days, 12 hours and 793 chalakim time between molad and\n   * molad (14 days, 18 hours, 22 minutes and 666 milliseconds) to the month's molad. This method returns the time\n   * even if it is during the day when _Kiddush Levana_ can't be said. Callers of this method should consider\n   * displaying _alos_ before this time if the zman is between _alos_ and _tzais_.\n   *\n   * @return the Temporal.ZonedDateTime representing the moment halfway between molad and molad.\n   */\n  getSofZmanKidushLevanaBetweenMoldos(): Temporal.ZonedDateTime {\n    const zdt = this.getInstant();\n    // add half the time between molad and molad (half of 29 days, 12 hours and 793 chalakim (44 minutes, 3.3\n    // seconds), or 14 days, 18 hours, 22 minutes and 666 milliseconds). Add it as hours, not days, to avoid\n    // DST/ST crossover issues.\n    return zdt.add({\n      hours: 24 * 14 + 18,\n      minutes: 22,\n      seconds: 1,\n      milliseconds: 666,\n    });\n  }\n\n  /**\n   * Returns the latest time of Kiddush Levana calculated as 15 days after the molad. This is the opinion brought down\n   * in the Shulchan Aruch (Orach Chaim 426). It should be noted that some opinions hold that the\n   * [Rema](https://en.wikipedia.org/wiki/Moses_Isserles) who brings down the opinion of the\n   * [Maharil's](https://en.wikipedia.org/wiki/Yaakov_ben_Moshe_Levi_Moelin) of calculating\n   * {@link Molad.getSofZmanKidushLevanaBetweenMoldos | half way between molad and molad} is of the opinion that Mechaber\n   * agrees to his opinion. Also see the Aruch Hashulchan. For additional details on the subject, See Rabbi Dovid\n   * Heber's very detailed writeup in Siman Daled (chapter 4) of\n   * [Shaarei Zmanim](https://www.worldcat.org/oclc/461326125). This method returns the time even if it is during\n   * the day when _Kiddush Levana_ can't be said. Callers of this method should consider displaying _alos_\n   * before this time if the zman is between _alos_ and _tzais_.\n   *\n   * @return the Temporal.ZonedDateTime representing the moment 15 days after the molad.\n   */\n  getSofZmanKidushLevana15Days(): Temporal.ZonedDateTime {\n    const zdt = this.getInstant();\n    // 15 days after the molad. Add it as hours, not days, to avoid DST/ST crossover issues.\n    return zdt.add({hours: 24 * 15});\n  }\n\n  /**\n   * Returns a human-readable, localized string announcing the molad —\n   * suitable for use on Shabbat Mevarchim. The format includes the Hebrew\n   * month name, day of week, hour : minute, and chalakim if non-zero.\n   *\n   * Time format honors `options.hour12` and `options.location` (12-hour vs.\n   * 24-hour); see {@link reformatTimeStr}.\n   * @example\n   * import {Molad, months} from '@hebcal/core';\n   * const m = new Molad(5784, months.NISAN);\n   * m.render('en', {hour12: true});\n   * // => 'Molad Nisan: Monday, 10:57pm and 7 chalakim'\n   * m.render('en', {hour12: false});\n   * // => 'Molad Nisan: Monday, 22:57 and 7 chalakim'\n   * m.render('he');\n   * // => 'מוֹלָד הָלְּבָנָה נִיסָן יִהְיֶה בַּיּוֹם שֵׁנִי בשָׁבוּעַ, …'\n   * @param [locale] Optional locale name (defaults to empty locale)\n   * @param options used for time formatting (12-hour vs 24-hour)\n   */\n  render(locale?: string, options?: CalOptions): string {\n    const monthName = Locale.gettext(this.getMonthName(), locale);\n    const dayNames = getDayNames(locale);\n    const dow = dayNames[this.getDow()];\n    const minutes = this.getMinutes();\n    const hour = this.getHour();\n    const chalakim = this.getChalakim();\n    const moladStr = Locale.gettext('Molad', locale);\n    const minutesStr = Locale.lookupTranslation('min', locale) ?? 'minutes';\n    const chalakimStr = Locale.gettext('chalakim', locale);\n    const and = Locale.gettext('and', locale);\n    if (Locale.isHebrewLocale(locale)) {\n      const ampm = getHebrewTimeOfDay(hour);\n      let result =\n        `${moladStr} ${monthName} יִהְיֶה בַּיּוֹם ${dow} בשָׁבוּעַ, ` +\n        `בְּשָׁעָה ${hour} ${ampm}, ` +\n        `ו-${minutes} ${minutesStr}`;\n      if (chalakim !== 0) {\n        result += ` ו-${chalakim} ${chalakimStr}`;\n      }\n      if (locale!.toLocaleLowerCase() === 'he-x-nonikud') {\n        return Locale.hebrewStripNikkud(result);\n      }\n      return result;\n    }\n    const fmtTime = reformatTimeStr(`${hour}:${pad2(minutes)}`, 'pm', options);\n    const month = smartApostrophe(monthName);\n    const result = `${moladStr} ${month}: ${dow}, ${fmtTime}`;\n    if (chalakim === 0) {\n      return result;\n    }\n    return result + ` ${and} ${chalakim} ${chalakimStr}`;\n  }\n}\n\n/** Represents a Molad announcement on Shabbat Mevarchim */\nexport class MoladEvent extends Event {\n  readonly molad: Molad;\n  private readonly options: CalOptions;\n  /**\n   * @param date Hebrew date event occurs\n   * @param hyear molad year\n   * @param hmonth molad month\n   * @param options\n   */\n  constructor(date: HDate, hyear: number, hmonth: number, options: CalOptions) {\n    const m = new Molad(hyear, hmonth);\n    const monthName = m.getMonthName();\n    super(date, `Molad ${monthName} ${hyear}`, flags.MOLAD);\n    this.molad = m;\n    this.options = options;\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    return this.molad.render(locale, this.options);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/moladBase.d.ts

@@ -12,4 +12,15 @@ export type MoladBase = {
     /** parts of a minute (0-17) */
     readonly chalakim: number;
 };
+/**
+ * Calculates the molad (birth of the new moon) for a Hebrew month using
+ * traditional chalakim arithmetic.
+ *
+ * Returns the raw components — day of week, hour, minutes and chalakim. Use
+ * {@link Molad} for a higher-level interface with rendering and Kiddush Levana
+ * times.
+ * @param year Hebrew year
+ * @param month Hebrew month (see `months` from `@hebcal/hdate`)
+ * @return the components of the molad for that month
+ */
 export declare function calculateMolad(year: number, month: number): MoladBase;

package/dist/esm/moladBase.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v6.8.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.9.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import { HDate, isLeapYear } from '@hebcal/hdate';
 
 /*
@@ -56,6 +56,17 @@ function getChalakimSinceMoladTohu(year, month) {
 function moladToAbsDate(chalakim) {
     return Math.trunc(chalakim / CHALAKIM_PER_DAY) + JEWISH_EPOCH;
 }
+/**
+ * Calculates the molad (birth of the new moon) for a Hebrew month using
+ * traditional chalakim arithmetic.
+ *
+ * Returns the raw components — day of week, hour, minutes and chalakim. Use
+ * {@link Molad} for a higher-level interface with rendering and Kiddush Levana
+ * times.
+ * @param year Hebrew year
+ * @param month Hebrew month (see `months` from `@hebcal/hdate`)
+ * @return the components of the molad for that month
+ */
 function calculateMolad(year, month) {
     const chalakim = getChalakimSinceMoladTohu(year, month);
     const absDate = moladToAbsDate(chalakim);

package/dist/esm/moladBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"moladBase.js","sources":["../../../src/moladBase.ts"],"sourcesContent":["import {HDate, isLeapYear} from '@hebcal/hdate';\n\n/**\n * Represents a molad, the moment when the new moon is \"born\"\n */\nexport type MoladBase = {\n  /** Hebrew date */\n  readonly hdate: HDate;\n  /** hour of day (0-23) */\n  readonly hour: number;\n  /** minutes past hour (0-59) */\n  readonly minutes: number;\n  /** parts of a minute (0-17) */\n  readonly chalakim: number;\n};\n\n/*\n * Includes code ported from KosherJava, copyright 2004 Eliyahu Hershfeld,\n * released under LGPL 2.1.\n */\n\n/**\n * the Jewish epoch using the RD (Rata Die/Fixed Date or Reingold Dershowitz) day used in Calendrical Calculations.\n * Day 1 is January 1, 0001 of the Gregorian calendar\n */\nconst JEWISH_EPOCH: number = -1373429;\n\n/** The number of _chalakim_ (18) in a minute. */\nconst CHALAKIM_PER_MINUTE: number = 18;\n\n/** The number of _chalakim_ (1080) in an hour. */\nconst CHALAKIM_PER_HOUR: number = 1080;\n\n/** The number of _chalakim_ (25,920) in a 24-hour day. */\nconst CHALAKIM_PER_DAY: number = 25920; // 24 * 1080\n\n/** The number of _chalakim_ in an average Jewish month. A month has 29 days, 12 hours and 793\n * _chalakim_ (44 minutes and 3.3 seconds) for a total of 765,433 _chalakim_ */\nconst CHALAKIM_PER_MONTH: number = 765433; // (29 * 24 + 12) * 1080 + 793\n\n/**\n * Days from the beginning of Sunday till _molad BaHaRaD_. Calculated as 1 day, 5 hours and 204 _chalakim_ =\n * (24 + 5) * 1080 + 204 = 31524\n */\nconst CHALAKIM_MOLAD_TOHU: number = 31524;\n\n/**\n * Converts the NISSAN-based constants used by this class to numeric month starting from\n * TISHREI. This is required for _molad_ calculations.\n */\nfunction getJewishMonthOfYear(year: number, month: number): number {\n  const leap: boolean = isLeapYear(year);\n  return ((month + (leap ? 6 : 5)) % (leap ? 13 : 12)) + 1;\n}\n\n/**\n * Returns the number of _chalakim_ (parts - 1080 to the hour) from\n * the original hypothetical _Molad Tohu_ to the year and month\n * passed in.\n */\nfunction getChalakimSinceMoladTohu(year: number, month: number): number {\n  // Jewish lunar month = 29 days, 12 hours and 793 chalakim\n  // chalakim since Molad Tohu BeHaRaD - 1 day, 5 hours and 204 chalakim\n  const monthOfYear: number = getJewishMonthOfYear(year, month);\n  const monthsElapsed: number =\n    235 * Math.trunc((year - 1) / 19) + // Months in complete 19-year lunar (Metonic) cycles so far\n    12 * ((year - 1) % 19) + // Regular months in this cycle\n    Math.trunc((7 * ((year - 1) % 19) + 1) / 19) + // Leap months this cycle\n    (monthOfYear - 1); // add elapsed months till the start of the molad of the month\n  // return chalakim prior to BeHaRaD + number of chalakim since\n  return CHALAKIM_MOLAD_TOHU + CHALAKIM_PER_MONTH * monthsElapsed;\n}\n\n/**\n * Returns the number of days from the Jewish epoch from the number of chalakim from the epoch passed in.\n * @param chalakim the number of _chalakim_ since the beginning of Sunday prior to BaHaRaD\n * @return the number of days from the Jewish epoch\n */\nfunction moladToAbsDate(chalakim: number): number {\n  return Math.trunc(chalakim / CHALAKIM_PER_DAY) + JEWISH_EPOCH;\n}\n\nexport function calculateMolad(year: number, month: number): MoladBase {\n  const chalakim = getChalakimSinceMoladTohu(year, month);\n  const absDate = moladToAbsDate(chalakim);\n  let hd = new HDate(absDate);\n  const conjunctionDay: number = Math.trunc(chalakim / CHALAKIM_PER_DAY);\n  const conjunctionParts: number = Math.trunc(\n    chalakim - conjunctionDay * CHALAKIM_PER_DAY\n  );\n\n  let adjustedChalakim: number = conjunctionParts;\n  let hour = Math.trunc(adjustedChalakim / CHALAKIM_PER_HOUR);\n  adjustedChalakim = adjustedChalakim - hour * CHALAKIM_PER_HOUR;\n  const minutes = Math.trunc(adjustedChalakim / CHALAKIM_PER_MINUTE);\n\n  if (hour >= 6) {\n    hd = hd.next();\n  }\n  hour = (hour + 18) % 24;\n\n  const m: MoladBase = {\n    hdate: hd,\n    hour,\n    minutes,\n    chalakim: adjustedChalakim - minutes * CHALAKIM_PER_MINUTE,\n  };\n\n  return m;\n}\n"],"names":[],"mappings":";;;AAgBA;;;AAGG;AAEH;;;AAGG;AACH,MAAM,YAAY,GAAW,QAAQ;AAErC;AACA,MAAM,mBAAmB,GAAW,EAAE;AAEtC;AACA,MAAM,iBAAiB,GAAW,IAAI;AAEtC;AACA,MAAM,gBAAgB,GAAW,KAAK,CAAC;AAEvC;AAC+E;AAC/E,MAAM,kBAAkB,GAAW,MAAM,CAAC;AAE1C;;;AAGG;AACH,MAAM,mBAAmB,GAAW,KAAK;AAEzC;;;AAGG;AACH,SAAS,oBAAoB,CAAC,IAAY,EAAE,KAAa,EAAA;AACvD,IAAA,MAAM,IAAI,GAAY,UAAU,CAAC,IAAI,CAAC;AACtC,IAAA,OAAO,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC;AAC1D;AAEA;;;;AAIG;AACH,SAAS,yBAAyB,CAAC,IAAY,EAAE,KAAa,EAAA;;;IAG5D,MAAM,WAAW,GAAW,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC;AAC7D,IAAA,MAAM,aAAa,GACjB,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACjC,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAC5C,SAAC,WAAW,GAAG,CAAC,CAAC,CAAC;;AAEpB,IAAA,OAAO,mBAAmB,GAAG,kBAAkB,GAAG,aAAa;AACjE;AAEA;;;;AAIG;AACH,SAAS,cAAc,CAAC,QAAgB,EAAA;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC,GAAG,YAAY;AAC/D;AAEM,SAAU,cAAc,CAAC,IAAY,EAAE,KAAa,EAAA;IACxD,MAAM,QAAQ,GAAG,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC;AACvD,IAAA,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC;AACxC,IAAA,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC;IAC3B,MAAM,cAAc,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC;AACtE,IAAA,MAAM,gBAAgB,GAAW,IAAI,CAAC,KAAK,CACzC,QAAQ,GAAG,cAAc,GAAG,gBAAgB,CAC7C;IAED,IAAI,gBAAgB,GAAW,gBAAgB;IAC/C,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,iBAAiB,CAAC;AAC3D,IAAA,gBAAgB,GAAG,gBAAgB,GAAG,IAAI,GAAG,iBAAiB;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,mBAAmB,CAAC;AAElE,IAAA,IAAI,IAAI,IAAI,CAAC,EAAE;AACb,QAAA,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE;IAChB;IACA,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE;AAEvB,IAAA,MAAM,CAAC,GAAc;AACnB,QAAA,KAAK,EAAE,EAAE;QACT,IAAI;QACJ,OAAO;AACP,QAAA,QAAQ,EAAE,gBAAgB,GAAG,OAAO,GAAG,mBAAmB;KAC3D;AAED,IAAA,OAAO,CAAC;AACV;;;;"}
+{"version":3,"file":"moladBase.js","sources":["../../../src/moladBase.ts"],"sourcesContent":["import {HDate, isLeapYear} from '@hebcal/hdate';\n\n/**\n * Represents a molad, the moment when the new moon is \"born\"\n */\nexport type MoladBase = {\n  /** Hebrew date */\n  readonly hdate: HDate;\n  /** hour of day (0-23) */\n  readonly hour: number;\n  /** minutes past hour (0-59) */\n  readonly minutes: number;\n  /** parts of a minute (0-17) */\n  readonly chalakim: number;\n};\n\n/*\n * Includes code ported from KosherJava, copyright 2004 Eliyahu Hershfeld,\n * released under LGPL 2.1.\n */\n\n/**\n * the Jewish epoch using the RD (Rata Die/Fixed Date or Reingold Dershowitz) day used in Calendrical Calculations.\n * Day 1 is January 1, 0001 of the Gregorian calendar\n */\nconst JEWISH_EPOCH: number = -1373429;\n\n/** The number of _chalakim_ (18) in a minute. */\nconst CHALAKIM_PER_MINUTE: number = 18;\n\n/** The number of _chalakim_ (1080) in an hour. */\nconst CHALAKIM_PER_HOUR: number = 1080;\n\n/** The number of _chalakim_ (25,920) in a 24-hour day. */\nconst CHALAKIM_PER_DAY: number = 25920; // 24 * 1080\n\n/** The number of _chalakim_ in an average Jewish month. A month has 29 days, 12 hours and 793\n * _chalakim_ (44 minutes and 3.3 seconds) for a total of 765,433 _chalakim_ */\nconst CHALAKIM_PER_MONTH: number = 765433; // (29 * 24 + 12) * 1080 + 793\n\n/**\n * Days from the beginning of Sunday till _molad BaHaRaD_. Calculated as 1 day, 5 hours and 204 _chalakim_ =\n * (24 + 5) * 1080 + 204 = 31524\n */\nconst CHALAKIM_MOLAD_TOHU: number = 31524;\n\n/**\n * Converts the NISSAN-based constants used by this class to numeric month starting from\n * TISHREI. This is required for _molad_ calculations.\n */\nfunction getJewishMonthOfYear(year: number, month: number): number {\n  const leap: boolean = isLeapYear(year);\n  return ((month + (leap ? 6 : 5)) % (leap ? 13 : 12)) + 1;\n}\n\n/**\n * Returns the number of _chalakim_ (parts - 1080 to the hour) from\n * the original hypothetical _Molad Tohu_ to the year and month\n * passed in.\n */\nfunction getChalakimSinceMoladTohu(year: number, month: number): number {\n  // Jewish lunar month = 29 days, 12 hours and 793 chalakim\n  // chalakim since Molad Tohu BeHaRaD - 1 day, 5 hours and 204 chalakim\n  const monthOfYear: number = getJewishMonthOfYear(year, month);\n  const monthsElapsed: number =\n    235 * Math.trunc((year - 1) / 19) + // Months in complete 19-year lunar (Metonic) cycles so far\n    12 * ((year - 1) % 19) + // Regular months in this cycle\n    Math.trunc((7 * ((year - 1) % 19) + 1) / 19) + // Leap months this cycle\n    (monthOfYear - 1); // add elapsed months till the start of the molad of the month\n  // return chalakim prior to BeHaRaD + number of chalakim since\n  return CHALAKIM_MOLAD_TOHU + CHALAKIM_PER_MONTH * monthsElapsed;\n}\n\n/**\n * Returns the number of days from the Jewish epoch from the number of chalakim from the epoch passed in.\n * @param chalakim the number of _chalakim_ since the beginning of Sunday prior to BaHaRaD\n * @return the number of days from the Jewish epoch\n */\nfunction moladToAbsDate(chalakim: number): number {\n  return Math.trunc(chalakim / CHALAKIM_PER_DAY) + JEWISH_EPOCH;\n}\n\n/**\n * Calculates the molad (birth of the new moon) for a Hebrew month using\n * traditional chalakim arithmetic.\n *\n * Returns the raw components — day of week, hour, minutes and chalakim. Use\n * {@link Molad} for a higher-level interface with rendering and Kiddush Levana\n * times.\n * @param year Hebrew year\n * @param month Hebrew month (see `months` from `@hebcal/hdate`)\n * @return the components of the molad for that month\n */\nexport function calculateMolad(year: number, month: number): MoladBase {\n  const chalakim = getChalakimSinceMoladTohu(year, month);\n  const absDate = moladToAbsDate(chalakim);\n  let hd = new HDate(absDate);\n  const conjunctionDay: number = Math.trunc(chalakim / CHALAKIM_PER_DAY);\n  const conjunctionParts: number = Math.trunc(\n    chalakim - conjunctionDay * CHALAKIM_PER_DAY\n  );\n\n  let adjustedChalakim: number = conjunctionParts;\n  let hour = Math.trunc(adjustedChalakim / CHALAKIM_PER_HOUR);\n  adjustedChalakim = adjustedChalakim - hour * CHALAKIM_PER_HOUR;\n  const minutes = Math.trunc(adjustedChalakim / CHALAKIM_PER_MINUTE);\n\n  if (hour >= 6) {\n    hd = hd.next();\n  }\n  hour = (hour + 18) % 24;\n\n  const m: MoladBase = {\n    hdate: hd,\n    hour,\n    minutes,\n    chalakim: adjustedChalakim - minutes * CHALAKIM_PER_MINUTE,\n  };\n\n  return m;\n}\n"],"names":[],"mappings":";;;AAgBA;;;AAGG;AAEH;;;AAGG;AACH,MAAM,YAAY,GAAW,QAAQ;AAErC;AACA,MAAM,mBAAmB,GAAW,EAAE;AAEtC;AACA,MAAM,iBAAiB,GAAW,IAAI;AAEtC;AACA,MAAM,gBAAgB,GAAW,KAAK,CAAC;AAEvC;AAC+E;AAC/E,MAAM,kBAAkB,GAAW,MAAM,CAAC;AAE1C;;;AAGG;AACH,MAAM,mBAAmB,GAAW,KAAK;AAEzC;;;AAGG;AACH,SAAS,oBAAoB,CAAC,IAAY,EAAE,KAAa,EAAA;AACvD,IAAA,MAAM,IAAI,GAAY,UAAU,CAAC,IAAI,CAAC;AACtC,IAAA,OAAO,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC;AAC1D;AAEA;;;;AAIG;AACH,SAAS,yBAAyB,CAAC,IAAY,EAAE,KAAa,EAAA;;;IAG5D,MAAM,WAAW,GAAW,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC;AAC7D,IAAA,MAAM,aAAa,GACjB,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACjC,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAC5C,SAAC,WAAW,GAAG,CAAC,CAAC,CAAC;;AAEpB,IAAA,OAAO,mBAAmB,GAAG,kBAAkB,GAAG,aAAa;AACjE;AAEA;;;;AAIG;AACH,SAAS,cAAc,CAAC,QAAgB,EAAA;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC,GAAG,YAAY;AAC/D;AAEA;;;;;;;;;;AAUG;AACG,SAAU,cAAc,CAAC,IAAY,EAAE,KAAa,EAAA;IACxD,MAAM,QAAQ,GAAG,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC;AACvD,IAAA,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC;AACxC,IAAA,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC;IAC3B,MAAM,cAAc,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC;AACtE,IAAA,MAAM,gBAAgB,GAAW,IAAI,CAAC,KAAK,CACzC,QAAQ,GAAG,cAAc,GAAG,gBAAgB,CAC7C;IAED,IAAI,gBAAgB,GAAW,gBAAgB;IAC/C,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,iBAAiB,CAAC;AAC3D,IAAA,gBAAgB,GAAG,gBAAgB,GAAG,IAAI,GAAG,iBAAiB;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,mBAAmB,CAAC;AAElE,IAAA,IAAI,IAAI,IAAI,CAAC,EAAE;AACb,QAAA,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE;IAChB;IACA,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE;AAEvB,IAAA,MAAM,CAAC,GAAc;AACnB,QAAA,KAAK,EAAE,EAAE;QACT,IAAI;QACJ,OAAO;AACP,QAAA,QAAQ,EAAE,gBAAgB,GAAG,OAAO,GAAG,mBAAmB;KAC3D;AAED,IAAA,OAAO,CAAC;AACV;;;;"}

package/dist/esm/moladDate.d.ts

@@ -1,12 +1,16 @@
 import 'temporal-polyfill/global';
 import { MoladBase } from './moladBase';
 /**
- * Returns the molad in UTC as a Temporal.ZonedDateTime.
- * This method subtracts 20.94 minutes (20 minutes and 56.496 seconds) from the computed time (Har Habayis with a longitude
- * of 35.2354° is 5.2354° away from the %15 timezone longitude) to get to standard time. This method
- * intentionally uses standard time and not daylight savings time.
+ * Returns the moment of the molad as a `Temporal.ZonedDateTime` in the `UTC` zone.
  *
- * @return the ZonedDateTime representing the moment of the molad in UTC
-
+ * The molad is computed in Jerusalem *standard* time and then converted, so the
+ * returned instant is correct year-round; only the zone of the returned object
+ * is `UTC`. This method subtracts 20.94 minutes (20 minutes and 56.496 seconds)
+ * from the computed time — Har Habayis, at longitude 35.2354°, is 5.2354° away
+ * from the multiple-of-15 timezone longitude — to get to standard time. Daylight
+ * savings time is intentionally not applied; adjust when formatting for display.
+ *
+ * @param molad the molad to convert
+ * @return the `Temporal.ZonedDateTime` representing the moment of the molad
  */
 export declare function getMoladAsDate(molad: MoladBase): Temporal.ZonedDateTime;

package/dist/esm/moladDate.js

@@ -1,24 +1,27 @@
-/*! @hebcal/core v6.8.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.9.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import 'temporal-polyfill/global';
 import { getTimezoneOffset } from '@hebcal/hdate';
 
 /** constant for milliseconds in a minute (60,000) */
 const MINUTE_MILLIS = 60 * 1000;
 /**
- * A method that will return the location's local mean time offset in milliseconds from local <a
- * href="https://en.wikipedia.org/wiki/Standard_time">standard time</a>. The globe is split into 360&deg;, with
- * 15&deg; per hour of the day. For a local that is at a longitude that is evenly divisible by 15 (longitude % 15 ==
- * 0), at solar {@link com.kosherjava.zmanim.AstronomicalCalendar#getSunTransit() noon} (with adjustment for the <a
- * href="https://en.wikipedia.org/wiki/Equation_of_time">equation of time</a>) the sun should be directly overhead,
- * so a user who is 1&deg; west of this will have noon at 4 minutes after standard time noon, and conversely, a user
- * who is 1&deg; east of the 15&deg; longitude will have noon at 11:56 AM. Lakewood, N.J., whose longitude is
- * -74.222, is 0.778 away from the closest multiple of 15 at -75&deg;. This is multiplied by 4 to yield 3 minutes
- * and 10 seconds earlier than standard time. The offset returned does not account for the <a
- * href="https://en.wikipedia.org/wiki/Daylight_saving_time">Daylight saving time</a> offset since this class is
+ * A method that will return the location's local mean time offset in milliseconds from local
+ * [standard time](https://en.wikipedia.org/wiki/Standard_time). The globe is split into 360°, with
+ * 15° per hour of the day. For a locale that is at a longitude that is evenly divisible by 15
+ * (longitude % 15 == 0), at solar noon (with adjustment for the
+ * [equation of time](https://en.wikipedia.org/wiki/Equation_of_time)) the sun should be directly overhead,
+ * so a user who is 1° west of this will have noon at 4 minutes after standard time noon, and conversely, a user
+ * who is 1° east of the 15° longitude will have noon at 11:56 AM. Lakewood, N.J., whose longitude is
+ * -74.222, is 0.778 away from the closest multiple of 15 at -75°. This is multiplied by 4 to yield 3 minutes
+ * and 10 seconds earlier than standard time. The offset returned does not account for the
+ * [Daylight saving time](https://en.wikipedia.org/wiki/Daylight_saving_time) offset since this function is
  * unaware of dates.
  *
+ * @param dt the date used to resolve the timezone offset
+ * @param longitude the location's longitude
+ * @param tzid IANA timezone identifier
  * @return the offset in milliseconds not accounting for Daylight saving time. A positive value will be returned
- *         East of the 15&deg; timezone line, and a negative value West of it.
+ *         East of the 15° timezone line, and a negative value West of it.
  */
 function getLocalMeanTimeOffset(dt, longitude, tzid) {
     const offset = -1 * getTimezoneOffset(tzid, dt);
@@ -26,13 +29,17 @@ function getLocalMeanTimeOffset(dt, longitude, tzid) {
     return Math.trunc(d);
 }
 /**
- * Returns the molad in UTC as a Temporal.ZonedDateTime.
- * This method subtracts 20.94 minutes (20 minutes and 56.496 seconds) from the computed time (Har Habayis with a longitude
- * of 35.2354&deg; is 5.2354&deg; away from the %15 timezone longitude) to get to standard time. This method
- * intentionally uses standard time and not daylight savings time.
+ * Returns the moment of the molad as a `Temporal.ZonedDateTime` in the `UTC` zone.
  *
- * @return the ZonedDateTime representing the moment of the molad in UTC
-
+ * The molad is computed in Jerusalem *standard* time and then converted, so the
+ * returned instant is correct year-round; only the zone of the returned object
+ * is `UTC`. This method subtracts 20.94 minutes (20 minutes and 56.496 seconds)
+ * from the computed time — Har Habayis, at longitude 35.2354°, is 5.2354° away
+ * from the multiple-of-15 timezone longitude — to get to standard time. Daylight
+ * savings time is intentionally not applied; adjust when formatting for display.
+ *
+ * @param molad the molad to convert
+ * @return the `Temporal.ZonedDateTime` representing the moment of the molad
  */
 function getMoladAsDate(molad) {
     const moladSeconds = (molad.chalakim * 10) / 3;

package/dist/esm/moladDate.js.map

@@ -1 +1 @@
-{"version":3,"file":"moladDate.js","sources":["../../../src/moladDate.ts"],"sourcesContent":["import 'temporal-polyfill/global';\nimport {getTimezoneOffset} from '@hebcal/hdate';\nimport {MoladBase} from './moladBase';\n\n/** constant for milliseconds in a minute (60,000) */\nconst MINUTE_MILLIS: number = 60 * 1000;\n\n/**\n * A method that will return the location's local mean time offset in milliseconds from local <a\n * href=\"https://en.wikipedia.org/wiki/Standard_time\">standard time</a>. The globe is split into 360&deg;, with\n * 15&deg; per hour of the day. For a local that is at a longitude that is evenly divisible by 15 (longitude % 15 ==\n * 0), at solar {@link com.kosherjava.zmanim.AstronomicalCalendar#getSunTransit() noon} (with adjustment for the <a\n * href=\"https://en.wikipedia.org/wiki/Equation_of_time\">equation of time</a>) the sun should be directly overhead,\n * so a user who is 1&deg; west of this will have noon at 4 minutes after standard time noon, and conversely, a user\n * who is 1&deg; east of the 15&deg; longitude will have noon at 11:56 AM. Lakewood, N.J., whose longitude is\n * -74.222, is 0.778 away from the closest multiple of 15 at -75&deg;. This is multiplied by 4 to yield 3 minutes\n * and 10 seconds earlier than standard time. The offset returned does not account for the <a\n * href=\"https://en.wikipedia.org/wiki/Daylight_saving_time\">Daylight saving time</a> offset since this class is\n * unaware of dates.\n *\n * @return the offset in milliseconds not accounting for Daylight saving time. A positive value will be returned\n *         East of the 15&deg; timezone line, and a negative value West of it.\n */\nfunction getLocalMeanTimeOffset(dt: Date, longitude: number, tzid: string): number {\n  const offset: number = -1 * getTimezoneOffset(tzid, dt);\n  const d = longitude * 4 * MINUTE_MILLIS - offset * MINUTE_MILLIS;\n  return Math.trunc(d);\n}\n\n/**\n * Returns the molad in UTC as a Temporal.ZonedDateTime.\n * This method subtracts 20.94 minutes (20 minutes and 56.496 seconds) from the computed time (Har Habayis with a longitude\n * of 35.2354&deg; is 5.2354&deg; away from the %15 timezone longitude) to get to standard time. This method\n * intentionally uses standard time and not daylight savings time.\n *\n * @return the ZonedDateTime representing the moment of the molad in UTC\n\n */\nexport function getMoladAsDate(molad: MoladBase): Temporal.ZonedDateTime {\n  const moladSeconds: number = (molad.chalakim * 10) / 3;\n  const millis: number = Math.trunc(\n    1000 * (moladSeconds - Math.trunc(moladSeconds))\n  );\n\n  const dt = molad.hdate.greg();\n\n  // The raw molad Date (point in time) must be generated using standard time. Using \"Asia/Jerusalem\" timezone will result in the time\n  // being incorrectly off by an hour in the summer due to DST. Proper adjustment for the actual time in DST will be done by the date\n  // formatter class used to display the Date.\n  const tzid: string = 'Etc/GMT+2';\n  const zdt = Temporal.ZonedDateTime.from({\n    year: dt.getFullYear(),\n    month: dt.getMonth() + 1,\n    day: dt.getDate(),\n    hour: molad.hour,\n    minute: molad.minutes,\n    second: Math.trunc(moladSeconds),\n    millisecond: millis,\n    timeZone: tzid,\n  });\n\n  const longitude: number = 35.2354; // Har Habayis longitude\n  const offset = getLocalMeanTimeOffset(dt, longitude, tzid);\n  // subtract local time difference of 20.94 minutes (20 minutes and 56.496 seconds) to get to Standard time\n  const zdt2 = zdt.subtract({milliseconds: offset});\n  return zdt2.withTimeZone('UTC');\n}\n"],"names":[],"mappings":";;;;AAIA;AACA,MAAM,aAAa,GAAW,EAAE,GAAG,IAAI;AAEvC;;;;;;;;;;;;;;;AAeG;AACH,SAAS,sBAAsB,CAAC,EAAQ,EAAE,SAAiB,EAAE,IAAY,EAAA;IACvE,MAAM,MAAM,GAAW,EAAE,GAAG,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;IACvD,MAAM,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,aAAa,GAAG,MAAM,GAAG,aAAa;AAChE,IAAA,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACtB;AAEA;;;;;;;;AAQG;AACG,SAAU,cAAc,CAAC,KAAgB,EAAA;IAC7C,MAAM,YAAY,GAAW,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,IAAI,CAAC;AACtD,IAAA,MAAM,MAAM,GAAW,IAAI,CAAC,KAAK,CAC/B,IAAI,IAAI,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CACjD;IAED,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;;;;IAK7B,MAAM,IAAI,GAAW,WAAW;AAChC,IAAA,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC;AACtC,QAAA,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE;AACtB,QAAA,KAAK,EAAE,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC;AACxB,QAAA,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,OAAO;AACrB,QAAA,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;AAChC,QAAA,WAAW,EAAE,MAAM;AACnB,QAAA,QAAQ,EAAE,IAAI;AACf,KAAA,CAAC;AAEF,IAAA,MAAM,SAAS,GAAW,OAAO,CAAC;IAClC,MAAM,MAAM,GAAG,sBAAsB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC;;AAE1D,IAAA,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAC,YAAY,EAAE,MAAM,EAAC,CAAC;AACjD,IAAA,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;AACjC;;;;"}
+{"version":3,"file":"moladDate.js","sources":["../../../src/moladDate.ts"],"sourcesContent":["import 'temporal-polyfill/global';\nimport {getTimezoneOffset} from '@hebcal/hdate';\nimport {MoladBase} from './moladBase';\n\n/** constant for milliseconds in a minute (60,000) */\nconst MINUTE_MILLIS: number = 60 * 1000;\n\n/**\n * A method that will return the location's local mean time offset in milliseconds from local\n * [standard time](https://en.wikipedia.org/wiki/Standard_time). The globe is split into 360°, with\n * 15° per hour of the day. For a locale that is at a longitude that is evenly divisible by 15\n * (longitude % 15 == 0), at solar noon (with adjustment for the\n * [equation of time](https://en.wikipedia.org/wiki/Equation_of_time)) the sun should be directly overhead,\n * so a user who is 1° west of this will have noon at 4 minutes after standard time noon, and conversely, a user\n * who is 1° east of the 15° longitude will have noon at 11:56 AM. Lakewood, N.J., whose longitude is\n * -74.222, is 0.778 away from the closest multiple of 15 at -75°. This is multiplied by 4 to yield 3 minutes\n * and 10 seconds earlier than standard time. The offset returned does not account for the\n * [Daylight saving time](https://en.wikipedia.org/wiki/Daylight_saving_time) offset since this function is\n * unaware of dates.\n *\n * @param dt the date used to resolve the timezone offset\n * @param longitude the location's longitude\n * @param tzid IANA timezone identifier\n * @return the offset in milliseconds not accounting for Daylight saving time. A positive value will be returned\n *         East of the 15° timezone line, and a negative value West of it.\n */\nfunction getLocalMeanTimeOffset(dt: Date, longitude: number, tzid: string): number {\n  const offset: number = -1 * getTimezoneOffset(tzid, dt);\n  const d = longitude * 4 * MINUTE_MILLIS - offset * MINUTE_MILLIS;\n  return Math.trunc(d);\n}\n\n/**\n * Returns the moment of the molad as a `Temporal.ZonedDateTime` in the `UTC` zone.\n *\n * The molad is computed in Jerusalem *standard* time and then converted, so the\n * returned instant is correct year-round; only the zone of the returned object\n * is `UTC`. This method subtracts 20.94 minutes (20 minutes and 56.496 seconds)\n * from the computed time — Har Habayis, at longitude 35.2354°, is 5.2354° away\n * from the multiple-of-15 timezone longitude — to get to standard time. Daylight\n * savings time is intentionally not applied; adjust when formatting for display.\n *\n * @param molad the molad to convert\n * @return the `Temporal.ZonedDateTime` representing the moment of the molad\n */\nexport function getMoladAsDate(molad: MoladBase): Temporal.ZonedDateTime {\n  const moladSeconds: number = (molad.chalakim * 10) / 3;\n  const millis: number = Math.trunc(\n    1000 * (moladSeconds - Math.trunc(moladSeconds))\n  );\n\n  const dt = molad.hdate.greg();\n\n  // The raw molad Date (point in time) must be generated using standard time. Using \"Asia/Jerusalem\" timezone will result in the time\n  // being incorrectly off by an hour in the summer due to DST. Proper adjustment for the actual time in DST will be done by the date\n  // formatter class used to display the Date.\n  const tzid: string = 'Etc/GMT+2';\n  const zdt = Temporal.ZonedDateTime.from({\n    year: dt.getFullYear(),\n    month: dt.getMonth() + 1,\n    day: dt.getDate(),\n    hour: molad.hour,\n    minute: molad.minutes,\n    second: Math.trunc(moladSeconds),\n    millisecond: millis,\n    timeZone: tzid,\n  });\n\n  const longitude: number = 35.2354; // Har Habayis longitude\n  const offset = getLocalMeanTimeOffset(dt, longitude, tzid);\n  // subtract local time difference of 20.94 minutes (20 minutes and 56.496 seconds) to get to Standard time\n  const zdt2 = zdt.subtract({milliseconds: offset});\n  return zdt2.withTimeZone('UTC');\n}\n"],"names":[],"mappings":";;;;AAIA;AACA,MAAM,aAAa,GAAW,EAAE,GAAG,IAAI;AAEvC;;;;;;;;;;;;;;;;;;AAkBG;AACH,SAAS,sBAAsB,CAAC,EAAQ,EAAE,SAAiB,EAAE,IAAY,EAAA;IACvE,MAAM,MAAM,GAAW,EAAE,GAAG,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;IACvD,MAAM,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,aAAa,GAAG,MAAM,GAAG,aAAa;AAChE,IAAA,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACtB;AAEA;;;;;;;;;;;;AAYG;AACG,SAAU,cAAc,CAAC,KAAgB,EAAA;IAC7C,MAAM,YAAY,GAAW,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,IAAI,CAAC;AACtD,IAAA,MAAM,MAAM,GAAW,IAAI,CAAC,KAAK,CAC/B,IAAI,IAAI,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CACjD;IAED,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;;;;IAK7B,MAAM,IAAI,GAAW,WAAW;AAChC,IAAA,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC;AACtC,QAAA,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE;AACtB,QAAA,KAAK,EAAE,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC;AACxB,QAAA,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,OAAO;AACrB,QAAA,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;AAChC,QAAA,WAAW,EAAE,MAAM;AACnB,QAAA,QAAQ,EAAE,IAAI;AACf,KAAA,CAAC;AAEF,IAAA,MAAM,SAAS,GAAW,OAAO,CAAC;IAClC,MAAM,MAAM,GAAG,sBAAsB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC;;AAE1D,IAAA,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAC,YAAY,EAAE,MAAM,EAAC,CAAC;AACjD,IAAA,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;AACjC;;;;"}

package/dist/esm/omer.d.ts

@@ -20,7 +20,7 @@ export type OmerLang = 'en' | 'he' | 'translit';
  * 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.sefira('translit');  // "Chesed sheb'Chesed"
  * ev.getTodayIs('en');    // 'Today is 1 day of the Omer'
  */
 export declare class OmerEvent extends Event {
@@ -68,12 +68,28 @@ export declare class OmerEvent extends Event {
      * @returns a single Unicode character from `①` through `㊾`
      */
     getEmoji(): string;
+    /**
+     * Number of *completed* weeks of the Omer. On day 7 this returns `1`; on
+     * day 8 it also returns `1`, because the second week is still in progress.
+     * Pair with {@link getDaysWithinWeeks} to render "N weeks and M days".
+     */
     getWeeks(): number;
+    /**
+     * Day within the current week, from `1` through `7`.
+     */
     getDaysWithinWeeks(): number;
     /**
      * Returns a sentence with that evening's omer count
-     * @returns a string such as `Today is 10 days, which is 1 week and 3 days of the Omer`
-     *  or `הַיוֹם עֲשָׂרָה יָמִים, שְׁהֵם שָׁבוּעַ אֶחָד וְשְׁלוֹשָׁה יָמִים לָעוֹמֶר`
+     * @example
+     * import {OmerEvent, HDate, months} from '@hebcal/core';
+     * const ev = new OmerEvent(new HDate(25, months.NISAN, 5784), 10);
+     * ev.getTodayIs('en');
+     * // => 'Today is 10 days, which are 1 week and 3 days of the Omer'
+     * ev.getTodayIs('he');
+     * // => 'הַיּוֹם עֲשָׂרָה יָמִים, שֶׁהֵם שָׁבֽוּעַ אֶחָד וּשְׁלוֹשָׁה יָמִים לָעֽוֹמֶר'
+     * @param locale locale name; Hebrew locales (`he`, `he-x-NoNikud`) produce
+     *  the Hebrew formula, anything else produces English. Defaults to `en`
+     *  when empty.
      */
     getTodayIs(locale: string): string;
     url(): string | undefined;

package/dist/esm/omer.js

@@ -1,4 +1,4 @@
-/*! @hebcal/core v6.8.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.9.0, 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';
@@ -204,7 +204,7 @@ const lamnatzeachLetters = sefira.lamnatzeachLetters.split('');
  * 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.sefira('translit');  // "Chesed sheb'Chesed"
  * ev.getTodayIs('en');    // 'Today is 1 day of the Omer'
  */
 class OmerEvent extends Event {
@@ -302,17 +302,33 @@ class OmerEvent extends Event {
         }
         return String.fromCodePoint(codePoint);
     }
+    /**
+     * Number of *completed* weeks of the Omer. On day 7 this returns `1`; on
+     * day 8 it also returns `1`, because the second week is still in progress.
+     * Pair with {@link getDaysWithinWeeks} to render "N weeks and M days".
+     */
     getWeeks() {
         const day7 = this.daysWithinWeeks === 7;
         return day7 ? this.weekNumber : this.weekNumber - 1;
     }
+    /**
+     * Day within the current week, from `1` through `7`.
+     */
     getDaysWithinWeeks() {
         return this.daysWithinWeeks;
     }
     /**
      * Returns a sentence with that evening's omer count
-     * @returns a string such as `Today is 10 days, which is 1 week and 3 days of the Omer`
-     *  or `הַיוֹם עֲשָׂרָה יָמִים, שְׁהֵם שָׁבוּעַ אֶחָד וְשְׁלוֹשָׁה יָמִים לָעוֹמֶר`
+     * @example
+     * import {OmerEvent, HDate, months} from '@hebcal/core';
+     * const ev = new OmerEvent(new HDate(25, months.NISAN, 5784), 10);
+     * ev.getTodayIs('en');
+     * // => 'Today is 10 days, which are 1 week and 3 days of the Omer'
+     * ev.getTodayIs('he');
+     * // => 'הַיּוֹם עֲשָׂרָה יָמִים, שֶׁהֵם שָׁבֽוּעַ אֶחָד וּשְׁלוֹשָׁה יָמִים לָעֽוֹמֶר'
+     * @param locale locale name; Hebrew locales (`he`, `he-x-NoNikud`) produce
+     *  the Hebrew formula, anything else produces English. Defaults to `en`
+     *  when empty.
      */
     getTodayIs(locale) {
         locale = (locale || 'en').toLowerCase();

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/**\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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"}
+{"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 sheb'Chesed\"\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  /**\n   * Number of *completed* weeks of the Omer. On day 7 this returns `1`; on\n   * day 8 it also returns `1`, because the second week is still in progress.\n   * Pair with {@link getDaysWithinWeeks} to render \"N weeks and M days\".\n   */\n  getWeeks(): number {\n    const day7 = this.daysWithinWeeks === 7;\n    return day7 ? this.weekNumber : this.weekNumber - 1;\n  }\n\n  /**\n   * Day within the current week, from `1` through `7`.\n   */\n  getDaysWithinWeeks(): number {\n    return this.daysWithinWeeks;\n  }\n  /**\n   * Returns a sentence with that evening's omer count\n   * @example\n   * import {OmerEvent, HDate, months} from '@hebcal/core';\n   * const ev = new OmerEvent(new HDate(25, months.NISAN, 5784), 10);\n   * ev.getTodayIs('en');\n   * // => 'Today is 10 days, which are 1 week and 3 days of the Omer'\n   * ev.getTodayIs('he');\n   * // => 'הַיּוֹם עֲשָׂרָה יָמִים, שֶׁהֵם שָׁבֽוּעַ אֶחָד וּשְׁלוֹשָׁה יָמִים לָעֽוֹמֶר'\n   * @param locale locale name; Hebrew locales (`he`, `he-x-NoNikud`) produce\n   *  the Hebrew formula, anything else produces English. Defaults to `en`\n   *  when empty.\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.8.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.9.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 import './locale.js';
 import { smartApostrophe } from './string.js';
 import { Locale } from '@hebcal/hdate';

package/dist/esm/parshaYear.d.ts

@@ -10,8 +10,8 @@ import { ParshaEvent } from './ParshaEvent';
  * @example
  * import {parshaYear} from '@hebcal/core';
  * const events = parshaYear(5784, false);
- * events[0].render('en'); // 'Parashat Vayeilech'
- * events[0].getDate().toString(); // '4 Tishrei 5784'
+ * events[0].render('en'); // 'Parashat Ha’azinu'
+ * events[0].getDate().toString(); // '8 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,4 +1,4 @@
-/*! @hebcal/core v6.8.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.9.0, 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';
@@ -14,8 +14,8 @@ import { getSedra } from './sedra.js';
  * @example
  * import {parshaYear} from '@hebcal/core';
  * const events = parshaYear(5784, false);
- * events[0].render('en'); // 'Parashat Vayeilech'
- * events[0].getDate().toString(); // '4 Tishrei 5784'
+ * events[0].render('en'); // 'Parashat Ha’azinu'
+ * events[0].getDate().toString(); // '8 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 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;;;;"}
+{"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 Ha’azinu'\n * events[0].getDate().toString(); // '8 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.8.1";
+export declare const version = "6.9.0";

package/dist/esm/pkgVersion.js

@@ -1,6 +1,6 @@
-/*! @hebcal/core v6.8.1, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
+/*! @hebcal/core v6.9.0, distributed under GPLv2 https://www.gnu.org/licenses/gpl-2.0.txt */
 /** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-const version = '6.8.1';
+const version = '6.9.0';
 
 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.8.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.9.0';\n"],"names":[],"mappings":";AAAA;AACO,MAAM,OAAO,GAAG;;;;"}

package/dist/esm/reformatTimeStr.d.ts

@@ -1,8 +1,20 @@
 import { CalOptions } from './CalOptions';
 /**
- * @private
+ * Helper function to format a 24-hour (00:00-23:59) time string in either
+ * 12-hour US format (e.g. `"8:13pm"`) or keep it in 24-hour format (e.g.
+ * `"20:13"`) for any other locale or country.
+ *
+ * The locale (and therefore default behavior) is derived from
+ * `options.location` / `options.locale`. The `options.hour12` override
+ * takes precedence: if `false`, locale is ignored and the result is always
+ * 24-hour; if `true`, locale is ignored and the result is always 12-hour.
+ * @example
+ * import {reformatTimeStr, Location} from '@hebcal/core';
+ * const opts = {location: Location.lookup('Chicago')};
+ * reformatTimeStr('20:30', 'pm', opts);          // '8:30pm'
+ * reformatTimeStr('20:30', 'pm', {hour12: false}); // '20:30'
  * @param timeStr - original time like "20:30"
  * @param suffix - "p" or "pm" or " P.M.". Add leading space if you want it
- * @param options
+ * @param options optional; `location`, `locale` and `hour12` are consulted
  */
 export declare function reformatTimeStr(timeStr: string, suffix: string, options?: CalOptions): string;