@hebcal/core 6.8.1 → 6.9.0

package/dist/esm/CalOptions.d.ts

@@ -1,5 +1,13 @@
 import { HDate } from '@hebcal/hdate';
 import type { Location } from './location';
+/**
+ * Value for an entry in `CalOptions.dailyLearning`. Use `true` to enable a
+ * daily study calendar with its default schedule; a `number` or `string`
+ * selects a variant (for example the cycle number for Daf Yomi Yerushalmi).
+ * The calendars themselves are provided by the
+ * {@link https://github.com/hebcal/hebcal-learning @hebcal/learning} package
+ * via {@link DailyLearning.addCalendar}.
+ */
 export type DailyLearningValue = boolean | number | string;
 /**
  * Options to configure which events are returned
@@ -38,7 +46,9 @@ export type CalOptions = {
      */
     candlelighting?: boolean;
     /**
-     * minutes before sundown to light candles (default 18)
+     * minutes before sundown to light candles. Defaults to 18 minutes in the
+     * Diaspora and 20 minutes in Israel (40 minutes for Jerusalem, 30 minutes
+     * for Haifa and Zikhron Ya'akov).
      */
     candleLightingMins?: number;
     /**

package/dist/esm/DailyLearning.d.ts

@@ -7,7 +7,7 @@ import { Event } from './event';
  * `@hebcal/core` itself contains no learning schedules — they are provided
  * by the {@link https://github.com/hebcal/hebcal-learning @hebcal/learning}
  * package, which calls {@link DailyLearning.addCalendar} on import. After
- * `@hebcal/learning` is loaded, `HebrewCalendar.calendar()` will emit
+ * `@hebcal/learning` is loaded, `calendar()` will emit
  * learning events when the corresponding `options.dailyLearning` flag is set.
  *
  * @example
@@ -15,7 +15,7 @@ import { Event } from './event';
  * import {DailyLearning, HDate} from '@hebcal/core';
  *
  * const ev = DailyLearning.lookup('dafYomi', new HDate(), false);
- * console.log(ev?.render('en')); // e.g. 'Berakhot 2'
+ * console.log(ev?.render('en')); // e.g. 'Daf Yomi: Berakhot 2'
  */
 export declare class DailyLearning {
     /**
@@ -41,8 +41,8 @@ export declare class DailyLearning {
      * not registered).
      * @example
      * import '@hebcal/learning';
-     * import {DailyLearning, HDate} from '@hebcal/core';
-     * DailyLearning.lookup('dafYomi', new HDate(2024, 1, 15), false);
+     * import {DailyLearning, HDate, months} from '@hebcal/core';
+     * DailyLearning.lookup('dafYomi', new HDate(15, months.CHESHVAN, 5784), false);
      * @param name case insensitive
      * @param hd Hebrew Date
      * @param il true for Israel, false for Diaspora

package/dist/esm/DailyLearning.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 */
 const cals = new Map();
 /**
  * Plug-in registry for daily learning calendars such as Daf Yomi (Bavli),
@@ -7,7 +7,7 @@ const cals = new Map();
  * `@hebcal/core` itself contains no learning schedules — they are provided
  * by the {@link https://github.com/hebcal/hebcal-learning @hebcal/learning}
  * package, which calls {@link DailyLearning.addCalendar} on import. After
- * `@hebcal/learning` is loaded, `HebrewCalendar.calendar()` will emit
+ * `@hebcal/learning` is loaded, `calendar()` will emit
  * learning events when the corresponding `options.dailyLearning` flag is set.
  *
  * @example
@@ -15,7 +15,7 @@ const cals = new Map();
  * import {DailyLearning, HDate} from '@hebcal/core';
  *
  * const ev = DailyLearning.lookup('dafYomi', new HDate(), false);
- * console.log(ev?.render('en')); // e.g. 'Berakhot 2'
+ * console.log(ev?.render('en')); // e.g. 'Daf Yomi: Berakhot 2'
  */
 class DailyLearning {
     /**
@@ -49,8 +49,8 @@ class DailyLearning {
      * not registered).
      * @example
      * import '@hebcal/learning';
-     * import {DailyLearning, HDate} from '@hebcal/core';
-     * DailyLearning.lookup('dafYomi', new HDate(2024, 1, 15), false);
+     * import {DailyLearning, HDate, months} from '@hebcal/core';
+     * DailyLearning.lookup('dafYomi', new HDate(15, months.CHESHVAN, 5784), false);
      * @param name case insensitive
      * @param hd Hebrew Date
      * @param il true for Israel, false for Diaspora

package/dist/esm/DailyLearning.js.map

@@ -1 +1 @@
-{"version":3,"file":"DailyLearning.js","sources":["../../../src/DailyLearning.ts"],"sourcesContent":["import {HDate} from '@hebcal/hdate';\nimport {Event} from './event';\n\ntype LearningCalendar = {\n  fn: (hd: HDate, il: boolean) => Event | null;\n  startDate?: HDate;\n};\nconst cals = new Map<string, LearningCalendar>();\n\n/**\n * Plug-in registry for daily learning calendars such as Daf Yomi (Bavli),\n * Yerushalmi Yomi, Mishna Yomi, Nach Yomi, etc.\n *\n * `@hebcal/core` itself contains no learning schedules — they are provided\n * by the {@link https://github.com/hebcal/hebcal-learning @hebcal/learning}\n * package, which calls {@link DailyLearning.addCalendar} on import. After\n * `@hebcal/learning` is loaded, `HebrewCalendar.calendar()` will emit\n * learning events when the corresponding `options.dailyLearning` flag is set.\n *\n * @example\n * import '@hebcal/learning';\n * import {DailyLearning, HDate} from '@hebcal/core';\n *\n * const ev = DailyLearning.lookup('dafYomi', new HDate(), false);\n * console.log(ev?.render('en')); // e.g. 'Berakhot 2'\n */\nexport class DailyLearning {\n  /**\n   * Registers a new learning calendar.\n   *\n   * The provided function is called whenever a caller asks for an event\n   * from this calendar; if no learning occurs that day (e.g. the date is\n   * before the cycle's start) it should return `null`.\n   * @example\n   * DailyLearning.addCalendar(\n   *   'myCalendar',\n   *   (hd, il) => new Event(hd, 'Today\\'s learning', 0),\n   *   new HDate(1, 'Tishrei', 5780),\n   * );\n   * @param name case insensitive\n   * @param calendar a function that returns an `Event` or `null`\n   * @param startDate the first date for which this calendar is valid\n   */\n  static addCalendar(\n    name: string,\n    calendar: (hd: HDate, il: boolean) => Event | null,\n    startDate?: HDate\n  ) {\n    if (typeof calendar !== 'function') {\n      throw new TypeError(`Invalid calendar function: ${calendar}`);\n    }\n    cals.set(name.toLowerCase(), {\n      fn: calendar,\n      startDate: startDate,\n    });\n  }\n\n  /**\n   * Returns the learning event for the given date from the named calendar,\n   * or `null` if there is no learning that day (or the named calendar is\n   * not registered).\n   * @example\n   * import '@hebcal/learning';\n   * import {DailyLearning, HDate} from '@hebcal/core';\n   * DailyLearning.lookup('dafYomi', new HDate(2024, 1, 15), false);\n   * @param name case insensitive\n   * @param hd Hebrew Date\n   * @param il true for Israel, false for Diaspora\n   */\n  static lookup(name: string, hd: HDate, il: boolean): Event | null {\n    const cal = cals.get(name.toLowerCase());\n    if (typeof cal === 'object') {\n      return cal.fn(hd, il);\n    }\n    return null;\n  }\n\n  /**\n   * Returns the first Hebrew date for which the named learning calendar\n   * is valid (as registered by {@link addCalendar}), or `undefined` if the\n   * calendar was not registered with a start date or is not registered at all.\n   * @param name case insensitive\n   */\n  static getStartDate(name: string): HDate | undefined {\n    const cal = cals.get(name.toLowerCase());\n    if (typeof cal === 'object') {\n      return cal.startDate;\n    }\n    return undefined;\n  }\n\n  /**\n   * Returns `true` if a learning calendar with the given name has been\n   * registered via {@link addCalendar}.\n   * @param name case insensitive\n   */\n  static has(name: string): boolean {\n    return cals.has(name.toLowerCase());\n  }\n\n  /**\n   * Returns the (lower-cased) names of all currently-registered learning\n   * calendars.\n   */\n  static getCalendars(): string[] {\n    return Array.from(cals.keys());\n  }\n}\n"],"names":[],"mappings":";AAOA,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4B;AAEhD;;;;;;;;;;;;;;;;AAgBG;MACU,aAAa,CAAA;AACxB;;;;;;;;;;;;;;;AAeG;AACH,IAAA,OAAO,WAAW,CAChB,IAAY,EACZ,QAAkD,EAClD,SAAiB,EAAA;AAEjB,QAAA,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;AAClC,YAAA,MAAM,IAAI,SAAS,CAAC,8BAA8B,QAAQ,CAAA,CAAE,CAAC;QAC/D;AACA,QAAA,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;AAC3B,YAAA,EAAE,EAAE,QAAQ;AACZ,YAAA,SAAS,EAAE,SAAS;AACrB,SAAA,CAAC;IACJ;AAEA;;;;;;;;;;;AAWG;AACH,IAAA,OAAO,MAAM,CAAC,IAAY,EAAE,EAAS,EAAE,EAAW,EAAA;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AACxC,QAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YAC3B,OAAO,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACvB;AACA,QAAA,OAAO,IAAI;IACb;AAEA;;;;;AAKG;IACH,OAAO,YAAY,CAAC,IAAY,EAAA;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AACxC,QAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YAC3B,OAAO,GAAG,CAAC,SAAS;QACtB;AACA,QAAA,OAAO,SAAS;IAClB;AAEA;;;;AAIG;IACH,OAAO,GAAG,CAAC,IAAY,EAAA;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC;AAEA;;;AAGG;AACH,IAAA,OAAO,YAAY,GAAA;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAChC;AACD;;;;"}
+{"version":3,"file":"DailyLearning.js","sources":["../../../src/DailyLearning.ts"],"sourcesContent":["import {HDate} from '@hebcal/hdate';\nimport {Event} from './event';\n\ntype LearningCalendar = {\n  fn: (hd: HDate, il: boolean) => Event | null;\n  startDate?: HDate;\n};\nconst cals = new Map<string, LearningCalendar>();\n\n/**\n * Plug-in registry for daily learning calendars such as Daf Yomi (Bavli),\n * Yerushalmi Yomi, Mishna Yomi, Nach Yomi, etc.\n *\n * `@hebcal/core` itself contains no learning schedules — they are provided\n * by the {@link https://github.com/hebcal/hebcal-learning @hebcal/learning}\n * package, which calls {@link DailyLearning.addCalendar} on import. After\n * `@hebcal/learning` is loaded, `calendar()` will emit\n * learning events when the corresponding `options.dailyLearning` flag is set.\n *\n * @example\n * import '@hebcal/learning';\n * import {DailyLearning, HDate} from '@hebcal/core';\n *\n * const ev = DailyLearning.lookup('dafYomi', new HDate(), false);\n * console.log(ev?.render('en')); // e.g. 'Daf Yomi: Berakhot 2'\n */\nexport class DailyLearning {\n  /**\n   * Registers a new learning calendar.\n   *\n   * The provided function is called whenever a caller asks for an event\n   * from this calendar; if no learning occurs that day (e.g. the date is\n   * before the cycle's start) it should return `null`.\n   * @example\n   * DailyLearning.addCalendar(\n   *   'myCalendar',\n   *   (hd, il) => new Event(hd, 'Today\\'s learning', 0),\n   *   new HDate(1, 'Tishrei', 5780),\n   * );\n   * @param name case insensitive\n   * @param calendar a function that returns an `Event` or `null`\n   * @param startDate the first date for which this calendar is valid\n   */\n  static addCalendar(\n    name: string,\n    calendar: (hd: HDate, il: boolean) => Event | null,\n    startDate?: HDate\n  ) {\n    if (typeof calendar !== 'function') {\n      throw new TypeError(`Invalid calendar function: ${calendar}`);\n    }\n    cals.set(name.toLowerCase(), {\n      fn: calendar,\n      startDate: startDate,\n    });\n  }\n\n  /**\n   * Returns the learning event for the given date from the named calendar,\n   * or `null` if there is no learning that day (or the named calendar is\n   * not registered).\n   * @example\n   * import '@hebcal/learning';\n   * import {DailyLearning, HDate, months} from '@hebcal/core';\n   * DailyLearning.lookup('dafYomi', new HDate(15, months.CHESHVAN, 5784), false);\n   * @param name case insensitive\n   * @param hd Hebrew Date\n   * @param il true for Israel, false for Diaspora\n   */\n  static lookup(name: string, hd: HDate, il: boolean): Event | null {\n    const cal = cals.get(name.toLowerCase());\n    if (typeof cal === 'object') {\n      return cal.fn(hd, il);\n    }\n    return null;\n  }\n\n  /**\n   * Returns the first Hebrew date for which the named learning calendar\n   * is valid (as registered by {@link addCalendar}), or `undefined` if the\n   * calendar was not registered with a start date or is not registered at all.\n   * @param name case insensitive\n   */\n  static getStartDate(name: string): HDate | undefined {\n    const cal = cals.get(name.toLowerCase());\n    if (typeof cal === 'object') {\n      return cal.startDate;\n    }\n    return undefined;\n  }\n\n  /**\n   * Returns `true` if a learning calendar with the given name has been\n   * registered via {@link addCalendar}.\n   * @param name case insensitive\n   */\n  static has(name: string): boolean {\n    return cals.has(name.toLowerCase());\n  }\n\n  /**\n   * Returns the (lower-cased) names of all currently-registered learning\n   * calendars.\n   */\n  static getCalendars(): string[] {\n    return Array.from(cals.keys());\n  }\n}\n"],"names":[],"mappings":";AAOA,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4B;AAEhD;;;;;;;;;;;;;;;;AAgBG;MACU,aAAa,CAAA;AACxB;;;;;;;;;;;;;;;AAeG;AACH,IAAA,OAAO,WAAW,CAChB,IAAY,EACZ,QAAkD,EAClD,SAAiB,EAAA;AAEjB,QAAA,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;AAClC,YAAA,MAAM,IAAI,SAAS,CAAC,8BAA8B,QAAQ,CAAA,CAAE,CAAC;QAC/D;AACA,QAAA,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;AAC3B,YAAA,EAAE,EAAE,QAAQ;AACZ,YAAA,SAAS,EAAE,SAAS;AACrB,SAAA,CAAC;IACJ;AAEA;;;;;;;;;;;AAWG;AACH,IAAA,OAAO,MAAM,CAAC,IAAY,EAAE,EAAS,EAAE,EAAW,EAAA;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AACxC,QAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YAC3B,OAAO,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACvB;AACA,QAAA,OAAO,IAAI;IACb;AAEA;;;;;AAKG;IACH,OAAO,YAAY,CAAC,IAAY,EAAA;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AACxC,QAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YAC3B,OAAO,GAAG,CAAC,SAAS;QACtB;AACA,QAAA,OAAO,SAAS;IAClB;AAEA;;;;AAIG;IACH,OAAO,GAAG,CAAC,IAAY,EAAA;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC;AAEA;;;AAGG;AACH,IAAA,OAAO,YAAY,GAAA;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAChC;AACD;;;;"}

package/dist/esm/HebrewDateEvent.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, months } from '@hebcal/hdate';
 import { Event, flags } from './event.js';
 import './locale.js';

package/dist/esm/HolidayEvent.d.ts

@@ -4,7 +4,7 @@ import './locale';
 /**
  * Represents a built-in holiday like Pesach, Purim or Tu BiShvat.
  *
- * Most holiday-related events emitted by {@link HebrewCalendar.calendar}
+ * Most holiday-related events emitted by {@link calendar}
  * are instances of `HolidayEvent` or one of its subclasses
  * ({@link ChanukahEvent}, {@link AsaraBTevetEvent},
  * {@link RoshHashanaEvent}, {@link RoshChodeshEvent}).
@@ -47,6 +47,10 @@ export declare class HolidayEvent extends Event {
      * Returns `undefined` for years outside `[100, 2999]`.
      */
     url(): string | undefined;
+    /**
+     * The date portion of {@link url}. For most holidays this is just the
+     * Gregorian year; subclasses override it when a year alone is ambiguous.
+     */
     urlDateSuffix(): string;
     getEmoji(): string;
     getCategories(): string[];
@@ -68,6 +72,7 @@ export declare class HolidayEvent extends Event {
  * we subclass HolidayEvent to generate the correct URL.
  */
 export declare class AsaraBTevetEvent extends HolidayEvent {
+    /** Full `YYYYMMDD` date, since the Gregorian year alone is ambiguous here */
     urlDateSuffix(): string;
 }
 /**
@@ -86,7 +91,7 @@ export declare class ChanukahEvent extends HolidayEvent {
 export declare class RoshHashanaEvent extends HolidayEvent {
     private readonly hyear;
     /**
-     * @private
+     * Normally created by {@link calendar} rather than directly.
      * @param date Hebrew date event occurs
      * @param hyear Hebrew year
      * @param mask optional holiday flags

package/dist/esm/HolidayEvent.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 { isoDateString, Locale } from '@hebcal/hdate';
 import { Event, flags } from './event.js';
 import { holidayDesc } from './staticHolidays.js';
@@ -8,7 +8,7 @@ import './locale.js';
 /**
  * Represents a built-in holiday like Pesach, Purim or Tu BiShvat.
  *
- * Most holiday-related events emitted by {@link HebrewCalendar.calendar}
+ * Most holiday-related events emitted by {@link calendar}
  * are instances of `HolidayEvent` or one of its subclasses
  * ({@link ChanukahEvent}, {@link AsaraBTevetEvent},
  * {@link RoshHashanaEvent}, {@link RoshChodeshEvent}).
@@ -76,6 +76,10 @@ class HolidayEvent extends Event {
             this.urlDateSuffix();
         return this.getFlags() & flags.IL_ONLY ? url + '?i=on' : url;
     }
+    /**
+     * The date portion of {@link url}. For most holidays this is just the
+     * Gregorian year; subclasses override it when a year alone is ambiguous.
+     */
     urlDateSuffix() {
         const year = this.greg().getFullYear();
         return String(year);
@@ -137,6 +141,7 @@ class HolidayEvent extends Event {
  * we subclass HolidayEvent to generate the correct URL.
  */
 class AsaraBTevetEvent extends HolidayEvent {
+    /** Full `YYYYMMDD` date, since the Gregorian year alone is ambiguous here */
     urlDateSuffix() {
         const isoDate = isoDateString(this.greg());
         return isoDate.replaceAll('-', '');
@@ -186,7 +191,7 @@ class ChanukahEvent extends HolidayEvent {
 class RoshHashanaEvent extends HolidayEvent {
     hyear;
     /**
-     * @private
+     * Normally created by {@link calendar} rather than directly.
      * @param date Hebrew date event occurs
      * @param hyear Hebrew year
      * @param mask optional holiday flags

package/dist/esm/HolidayEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"HolidayEvent.js","sources":["../../../src/HolidayEvent.ts"],"sourcesContent":["import {HDate, Locale, isoDateString} from '@hebcal/hdate';\nimport {Event, flags} from './event';\nimport {holidayDesc as hdesc} from './staticHolidays';\nimport {smartApostrophe, urlFriendly} from './string';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\n/**\n * Represents a built-in holiday like Pesach, Purim or Tu BiShvat.\n *\n * Most holiday-related events emitted by {@link HebrewCalendar.calendar}\n * are instances of `HolidayEvent` or one of its subclasses\n * ({@link ChanukahEvent}, {@link AsaraBTevetEvent},\n * {@link RoshHashanaEvent}, {@link RoshChodeshEvent}).\n *\n * Adds two notable behaviors over the base {@link Event}:\n *\n * - {@link HolidayEvent.basename} strips qualifiers like `Erev `, ` I`/`II`,\n *   `(CH''M)`, `(observed)`, candle counts, etc. (e.g. `\"Erev Pesach\"` →\n *   `\"Pesach\"`).\n * - {@link HolidayEvent.url} returns a `https://www.hebcal.com/holidays/...`\n *   link for the holiday.\n */\nexport class HolidayEvent extends Event {\n  /** During Sukkot or Pesach */\n  readonly cholHaMoedDay?: number;\n  /**\n   * `true` if the fast day was postponed a day to avoid Shabbat.\n   * - Tish'a B'Av postponed from the 9th to the 10th\n   * - Tzom Tammuz postponed from the 17th to the 18th\n   */\n  readonly observed?: boolean;\n  constructor(date: HDate, desc: string, mask = 0, attrs?: object) {\n    super(date, desc, mask, attrs);\n    if (typeof attrs === 'object' && attrs !== null) {\n      Object.assign(this, attrs);\n    }\n  }\n\n  /**\n   * Returns a simplified (untranslated) name for this holiday, stripping\n   * qualifiers so that related events group under one name.\n   *\n   * Strips trailing 4-digit years, `(CH''M)`, `(observed)`, `(Hoshana Raba)`,\n   * Roman-numeral day numbers (` I`, ` II`, ...), Chanukah candle counts,\n   * `: 8th Day`, and a leading `\"Erev \"`.\n   * @example\n   * // 'Erev Pesach'           => 'Pesach'\n   * // 'Sukkot III (CH''M)'    => 'Sukkot'\n   * // 'Chanukah: 5 Candles'   => 'Chanukah'\n   * // 'Rosh Hashana 5784'     => 'Rosh Hashana'\n   */\n  basename(): string {\n    return this.getDesc()\n      .replace(/ \\d{4}$/, '')\n      .replace(/ \\(CH''M\\)$/, '')\n      .replace(/ \\(observed\\)$/, '')\n      .replace(/ \\(Hoshana Raba\\)$/, '')\n      .replace(/ [IV]+$/, '')\n      .replace(/: \\d Candles?$/, '')\n      .replace(/: 8th Day$/, '')\n      .replace(/^Erev /, '');\n  }\n\n  /**\n   * Returns a `https://www.hebcal.com/holidays/...` URL for more detail on\n   * this holiday. Israel-only holidays get an `?i=on` query parameter.\n   * Returns `undefined` for years outside `[100, 2999]`.\n   */\n  url(): string | undefined {\n    const year = this.greg().getFullYear();\n    if (year < 100 || year > 2999) {\n      return undefined;\n    }\n    const url =\n      'https://www.hebcal.com/holidays/' +\n      urlFriendly(this.basename()) +\n      '-' +\n      this.urlDateSuffix();\n    return this.getFlags() & flags.IL_ONLY ? url + '?i=on' : url;\n  }\n\n  urlDateSuffix(): string {\n    const year = this.greg().getFullYear();\n    return String(year);\n  }\n\n  getEmoji(): string {\n    if (this.emoji) {\n      return this.emoji;\n    }\n    if (this.getFlags() & flags.SPECIAL_SHABBAT) {\n      return '🕍';\n    }\n    return '✡️';\n  }\n\n  getCategories(): string[] {\n    if (this.cholHaMoedDay) {\n      return ['holiday', 'major', 'cholhamoed'];\n    }\n    const cats = super.getCategories();\n    if (cats[0] !== 'unknown') {\n      return cats;\n    }\n    // Don't depend on flags.MINOR_HOLIDAY always being set. Look for minor holidays.\n    const desc = this.getDesc();\n    switch (desc) {\n      case hdesc.LAG_BAOMER:\n      case hdesc.LEIL_SELICHOT:\n      case hdesc.PESACH_SHENI:\n      case hdesc.EREV_PURIM:\n      case hdesc.PURIM_KATAN:\n      case hdesc.SHUSHAN_PURIM:\n      case hdesc.TU_BAV:\n      case hdesc.TU_BISHVAT:\n      case hdesc.ROSH_HASHANA_LABEHEMOT:\n        return ['holiday', 'minor'];\n    }\n\n    return ['holiday', 'major'];\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const str = super.render(locale);\n    return smartApostrophe(str);\n  }\n  /**\n   * Returns a brief (translated) description of this event.\n   * For most events, this is the same as render(). For some events, it procudes\n   * a shorter text (e.g. without a time or added description).\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    const str = super.renderBrief(locale);\n    return smartApostrophe(str);\n  }\n}\n\n/**\n * Because Asara B'Tevet often occurs twice in the same Gregorian year,\n * we subclass HolidayEvent to generate the correct URL.\n */\nexport class AsaraBTevetEvent extends HolidayEvent {\n  urlDateSuffix(): string {\n    const isoDate = isoDateString(this.greg());\n    return isoDate.replaceAll('-', '');\n  }\n}\n\nconst chanukahEmoji = '🕎';\nconst KEYCAP_DIGITS = [\n  '0️⃣',\n  '1️⃣',\n  '2️⃣',\n  '3️⃣',\n  '4️⃣',\n  '5️⃣',\n  '6️⃣',\n  '7️⃣',\n  '8️⃣',\n  '9️⃣',\n] as const;\n\n/**\n * Because Chanukah sometimes starts in December and ends in January,\n * we subclass HolidayEvent to generate the correct URL.\n */\nexport class ChanukahEvent extends HolidayEvent {\n  readonly chanukahDay?: number;\n  /**\n   * @param chanukahDay should be undefined for 1st night of Chanukah\n   */\n  constructor(date: HDate, desc: string, mask: number, chanukahDay?: number) {\n    super(date, desc, mask);\n    this.chanukahDay = chanukahDay;\n    this.emoji = chanukahEmoji;\n    if (chanukahDay !== 8) {\n      const candles = chanukahDay ? chanukahDay + 1 : 1;\n      this.emoji += KEYCAP_DIGITS[candles];\n    }\n  }\n  urlDateSuffix(): string {\n    const dt = this.greg();\n    let year = dt.getFullYear();\n    if (dt.getMonth() === 0) {\n      year--;\n    }\n    return String(year);\n  }\n}\n\n/** Represents Rosh Hashana, the Jewish New Year */\nexport class RoshHashanaEvent extends HolidayEvent {\n  private readonly hyear: number;\n  /**\n   * @private\n   * @param date Hebrew date event occurs\n   * @param hyear Hebrew year\n   * @param mask optional holiday flags\n   */\n  constructor(date: HDate, hyear: number, mask: number) {\n    super(date, `Rosh Hashana ${hyear}`, mask);\n    this.hyear = hyear;\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    return Locale.gettext('Rosh Hashana', locale) + ' ' + this.hyear;\n  }\n\n  getEmoji(): string {\n    return '🍏🍯';\n  }\n}\n\nconst roshChodeshStr = 'Rosh Chodesh';\n\n/** Represents Rosh Chodesh, the beginning of a new month */\nexport class RoshChodeshEvent extends HolidayEvent {\n  /**\n   * Constructs Rosh Chodesh event\n   * @param date Hebrew date event occurs\n   * @param monthName Hebrew month name (not translated)\n   */\n  constructor(date: HDate, monthName: string) {\n    super(date, `${roshChodeshStr} ${monthName}`, flags.ROSH_CHODESH);\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const monthName = this.getDesc().substring(roshChodeshStr.length + 1);\n    const monthName0 = Locale.gettext(monthName, locale);\n    const monthName1 = smartApostrophe(monthName0);\n    return Locale.gettext(roshChodeshStr, locale) + ' ' + monthName1;\n  }\n\n  basename(): string {\n    return this.getDesc();\n  }\n\n  getEmoji(): string {\n    return this.emoji || '🌒';\n  }\n}\n"],"names":["hdesc"],"mappings":"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"}
+{"version":3,"file":"HolidayEvent.js","sources":["../../../src/HolidayEvent.ts"],"sourcesContent":["import {HDate, Locale, isoDateString} from '@hebcal/hdate';\nimport {Event, flags} from './event';\nimport {holidayDesc as hdesc} from './staticHolidays';\nimport {smartApostrophe, urlFriendly} from './string';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\n/**\n * Represents a built-in holiday like Pesach, Purim or Tu BiShvat.\n *\n * Most holiday-related events emitted by {@link calendar}\n * are instances of `HolidayEvent` or one of its subclasses\n * ({@link ChanukahEvent}, {@link AsaraBTevetEvent},\n * {@link RoshHashanaEvent}, {@link RoshChodeshEvent}).\n *\n * Adds two notable behaviors over the base {@link Event}:\n *\n * - {@link HolidayEvent.basename} strips qualifiers like `Erev `, ` I`/`II`,\n *   `(CH''M)`, `(observed)`, candle counts, etc. (e.g. `\"Erev Pesach\"` →\n *   `\"Pesach\"`).\n * - {@link HolidayEvent.url} returns a `https://www.hebcal.com/holidays/...`\n *   link for the holiday.\n */\nexport class HolidayEvent extends Event {\n  /** During Sukkot or Pesach */\n  readonly cholHaMoedDay?: number;\n  /**\n   * `true` if the fast day was postponed a day to avoid Shabbat.\n   * - Tish'a B'Av postponed from the 9th to the 10th\n   * - Tzom Tammuz postponed from the 17th to the 18th\n   */\n  readonly observed?: boolean;\n  constructor(date: HDate, desc: string, mask = 0, attrs?: object) {\n    super(date, desc, mask, attrs);\n    if (typeof attrs === 'object' && attrs !== null) {\n      Object.assign(this, attrs);\n    }\n  }\n\n  /**\n   * Returns a simplified (untranslated) name for this holiday, stripping\n   * qualifiers so that related events group under one name.\n   *\n   * Strips trailing 4-digit years, `(CH''M)`, `(observed)`, `(Hoshana Raba)`,\n   * Roman-numeral day numbers (` I`, ` II`, ...), Chanukah candle counts,\n   * `: 8th Day`, and a leading `\"Erev \"`.\n   * @example\n   * // 'Erev Pesach'           => 'Pesach'\n   * // 'Sukkot III (CH''M)'    => 'Sukkot'\n   * // 'Chanukah: 5 Candles'   => 'Chanukah'\n   * // 'Rosh Hashana 5784'     => 'Rosh Hashana'\n   */\n  basename(): string {\n    return this.getDesc()\n      .replace(/ \\d{4}$/, '')\n      .replace(/ \\(CH''M\\)$/, '')\n      .replace(/ \\(observed\\)$/, '')\n      .replace(/ \\(Hoshana Raba\\)$/, '')\n      .replace(/ [IV]+$/, '')\n      .replace(/: \\d Candles?$/, '')\n      .replace(/: 8th Day$/, '')\n      .replace(/^Erev /, '');\n  }\n\n  /**\n   * Returns a `https://www.hebcal.com/holidays/...` URL for more detail on\n   * this holiday. Israel-only holidays get an `?i=on` query parameter.\n   * Returns `undefined` for years outside `[100, 2999]`.\n   */\n  url(): string | undefined {\n    const year = this.greg().getFullYear();\n    if (year < 100 || year > 2999) {\n      return undefined;\n    }\n    const url =\n      'https://www.hebcal.com/holidays/' +\n      urlFriendly(this.basename()) +\n      '-' +\n      this.urlDateSuffix();\n    return this.getFlags() & flags.IL_ONLY ? url + '?i=on' : url;\n  }\n\n  /**\n   * The date portion of {@link url}. For most holidays this is just the\n   * Gregorian year; subclasses override it when a year alone is ambiguous.\n   */\n  urlDateSuffix(): string {\n    const year = this.greg().getFullYear();\n    return String(year);\n  }\n\n  getEmoji(): string {\n    if (this.emoji) {\n      return this.emoji;\n    }\n    if (this.getFlags() & flags.SPECIAL_SHABBAT) {\n      return '🕍';\n    }\n    return '✡️';\n  }\n\n  getCategories(): string[] {\n    if (this.cholHaMoedDay) {\n      return ['holiday', 'major', 'cholhamoed'];\n    }\n    const cats = super.getCategories();\n    if (cats[0] !== 'unknown') {\n      return cats;\n    }\n    // Don't depend on flags.MINOR_HOLIDAY always being set. Look for minor holidays.\n    const desc = this.getDesc();\n    switch (desc) {\n      case hdesc.LAG_BAOMER:\n      case hdesc.LEIL_SELICHOT:\n      case hdesc.PESACH_SHENI:\n      case hdesc.EREV_PURIM:\n      case hdesc.PURIM_KATAN:\n      case hdesc.SHUSHAN_PURIM:\n      case hdesc.TU_BAV:\n      case hdesc.TU_BISHVAT:\n      case hdesc.ROSH_HASHANA_LABEHEMOT:\n        return ['holiday', 'minor'];\n    }\n\n    return ['holiday', 'major'];\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const str = super.render(locale);\n    return smartApostrophe(str);\n  }\n  /**\n   * Returns a brief (translated) description of this event.\n   * For most events, this is the same as render(). For some events, it procudes\n   * a shorter text (e.g. without a time or added description).\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    const str = super.renderBrief(locale);\n    return smartApostrophe(str);\n  }\n}\n\n/**\n * Because Asara B'Tevet often occurs twice in the same Gregorian year,\n * we subclass HolidayEvent to generate the correct URL.\n */\nexport class AsaraBTevetEvent extends HolidayEvent {\n  /** Full `YYYYMMDD` date, since the Gregorian year alone is ambiguous here */\n  urlDateSuffix(): string {\n    const isoDate = isoDateString(this.greg());\n    return isoDate.replaceAll('-', '');\n  }\n}\n\nconst chanukahEmoji = '🕎';\nconst KEYCAP_DIGITS = [\n  '0️⃣',\n  '1️⃣',\n  '2️⃣',\n  '3️⃣',\n  '4️⃣',\n  '5️⃣',\n  '6️⃣',\n  '7️⃣',\n  '8️⃣',\n  '9️⃣',\n] as const;\n\n/**\n * Because Chanukah sometimes starts in December and ends in January,\n * we subclass HolidayEvent to generate the correct URL.\n */\nexport class ChanukahEvent extends HolidayEvent {\n  readonly chanukahDay?: number;\n  /**\n   * @param chanukahDay should be undefined for 1st night of Chanukah\n   */\n  constructor(date: HDate, desc: string, mask: number, chanukahDay?: number) {\n    super(date, desc, mask);\n    this.chanukahDay = chanukahDay;\n    this.emoji = chanukahEmoji;\n    if (chanukahDay !== 8) {\n      const candles = chanukahDay ? chanukahDay + 1 : 1;\n      this.emoji += KEYCAP_DIGITS[candles];\n    }\n  }\n  urlDateSuffix(): string {\n    const dt = this.greg();\n    let year = dt.getFullYear();\n    if (dt.getMonth() === 0) {\n      year--;\n    }\n    return String(year);\n  }\n}\n\n/** Represents Rosh Hashana, the Jewish New Year */\nexport class RoshHashanaEvent extends HolidayEvent {\n  private readonly hyear: number;\n  /**\n   * Normally created by {@link calendar} rather than directly.\n   * @param date Hebrew date event occurs\n   * @param hyear Hebrew year\n   * @param mask optional holiday flags\n   */\n  constructor(date: HDate, hyear: number, mask: number) {\n    super(date, `Rosh Hashana ${hyear}`, mask);\n    this.hyear = hyear;\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    return Locale.gettext('Rosh Hashana', locale) + ' ' + this.hyear;\n  }\n\n  getEmoji(): string {\n    return '🍏🍯';\n  }\n}\n\nconst roshChodeshStr = 'Rosh Chodesh';\n\n/** Represents Rosh Chodesh, the beginning of a new month */\nexport class RoshChodeshEvent extends HolidayEvent {\n  /**\n   * Constructs Rosh Chodesh event\n   * @param date Hebrew date event occurs\n   * @param monthName Hebrew month name (not translated)\n   */\n  constructor(date: HDate, monthName: string) {\n    super(date, `${roshChodeshStr} ${monthName}`, flags.ROSH_CHODESH);\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const monthName = this.getDesc().substring(roshChodeshStr.length + 1);\n    const monthName0 = Locale.gettext(monthName, locale);\n    const monthName1 = smartApostrophe(monthName0);\n    return Locale.gettext(roshChodeshStr, locale) + ' ' + monthName1;\n  }\n\n  basename(): string {\n    return this.getDesc();\n  }\n\n  getEmoji(): string {\n    return this.emoji || '🌒';\n  }\n}\n"],"names":["hdesc"],"mappings":"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"}

package/dist/esm/MevarchimChodeshEvent.d.ts

@@ -8,7 +8,8 @@ export declare class MevarchimChodeshEvent extends Event {
      * Constructs Mevarchim haChodesh event
      * @param date Hebrew date event occurs
      * @param monthName Hebrew month name (not translated)
-     * @param [memo]
+     * @param memo text for the event memo. When falsy, a memo announcing the
+     *   molad of the upcoming month is generated automatically
      * @param locale Optional locale name
      */
     constructor(date: HDate, monthName: string, memo: string, locale?: string);

package/dist/esm/MevarchimChodeshEvent.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, HDate, months } from '@hebcal/hdate';
 import { Event, flags } from './event.js';
 import { Molad } from './molad.js';
@@ -13,7 +13,8 @@ class MevarchimChodeshEvent extends Event {
      * Constructs Mevarchim haChodesh event
      * @param date Hebrew date event occurs
      * @param monthName Hebrew month name (not translated)
-     * @param [memo]
+     * @param memo text for the event memo. When falsy, a memo announcing the
+     *   molad of the upcoming month is generated automatically
      * @param locale Optional locale name
      */
     constructor(date, monthName, memo, locale) {

package/dist/esm/MevarchimChodeshEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"MevarchimChodeshEvent.js","sources":["../../../src/MevarchimChodeshEvent.ts"],"sourcesContent":["import {HDate, Locale, months} from '@hebcal/hdate';\nimport {Event, flags} from './event';\nimport {Molad} from './molad';\nimport {smartApostrophe} from './string';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst mevarchimChodeshStr = 'Shabbat Mevarchim Chodesh';\n\n/** Represents Mevarchim haChodesh, the announcement of the new month */\nexport class MevarchimChodeshEvent extends Event {\n  readonly monthName: string;\n  /**\n   * Constructs Mevarchim haChodesh event\n   * @param date Hebrew date event occurs\n   * @param monthName Hebrew month name (not translated)\n   * @param [memo]\n   * @param locale Optional locale name\n   */\n  constructor(date: HDate, monthName: string, memo: string, locale?: string) {\n    super(date, `${mevarchimChodeshStr} ${monthName}`, flags.SHABBAT_MEVARCHIM);\n    this.monthName = Locale.gettext(monthName, locale);\n    if (memo) {\n      this.memo = memo;\n    } else {\n      const hyear = date.getFullYear();\n      const hmonth = date.getMonth();\n      const monNext =\n        hmonth === HDate.monthsInYear(hyear) ? months.NISAN : hmonth + 1;\n      const molad = new Molad(hyear, monNext);\n      this.memo = molad.render('en', {hour12: false});\n    }\n  }\n\n  basename(): string {\n    return this.getDesc();\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const monthName0 = Locale.gettext(this.monthName, locale);\n    const monthName = smartApostrophe(monthName0);\n    return Locale.gettext(mevarchimChodeshStr, locale) + ' ' + monthName;\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    const str = this.render(locale);\n    const space = str.indexOf(' ');\n    return str.substring(space + 1);\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAMA,MAAM,mBAAmB,GAAG,2BAA2B;AAEvD;AACM,MAAO,qBAAsB,SAAQ,KAAK,CAAA;AACrC,IAAA,SAAS;AAClB;;;;;;AAMG;AACH,IAAA,WAAA,CAAY,IAAW,EAAE,SAAiB,EAAE,IAAY,EAAE,MAAe,EAAA;AACvE,QAAA,KAAK,CAAC,IAAI,EAAE,CAAA,EAAG,mBAAmB,CAAA,CAAA,EAAI,SAAS,CAAA,CAAE,EAAE,KAAK,CAAC,iBAAiB,CAAC;QAC3E,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;QAClD,IAAI,IAAI,EAAE;AACR,YAAA,IAAI,CAAC,IAAI,GAAG,IAAI;QAClB;aAAO;AACL,YAAA,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE;AAChC,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE;YAC9B,MAAM,OAAO,GACX,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC;AACvC,YAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAC,MAAM,EAAE,KAAK,EAAC,CAAC;QACjD;IACF;IAEA,QAAQ,GAAA;AACN,QAAA,OAAO,IAAI,CAAC,OAAO,EAAE;IACvB;AACA;;;AAGG;AACH,IAAA,MAAM,CAAC,MAAe,EAAA;AACpB,QAAA,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC;AACzD,QAAA,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,CAAC;AAC7C,QAAA,OAAO,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,GAAG,GAAG,GAAG,SAAS;IACtE;AACA;;;AAGG;AACH,IAAA,WAAW,CAAC,MAAe,EAAA;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC;QAC9B,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;IACjC;AACD;;;;"}
+{"version":3,"file":"MevarchimChodeshEvent.js","sources":["../../../src/MevarchimChodeshEvent.ts"],"sourcesContent":["import {HDate, Locale, months} from '@hebcal/hdate';\nimport {Event, flags} from './event';\nimport {Molad} from './molad';\nimport {smartApostrophe} from './string';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst mevarchimChodeshStr = 'Shabbat Mevarchim Chodesh';\n\n/** Represents Mevarchim haChodesh, the announcement of the new month */\nexport class MevarchimChodeshEvent extends Event {\n  readonly monthName: string;\n  /**\n   * Constructs Mevarchim haChodesh event\n   * @param date Hebrew date event occurs\n   * @param monthName Hebrew month name (not translated)\n   * @param memo text for the event memo. When falsy, a memo announcing the\n   *   molad of the upcoming month is generated automatically\n   * @param locale Optional locale name\n   */\n  constructor(date: HDate, monthName: string, memo: string, locale?: string) {\n    super(date, `${mevarchimChodeshStr} ${monthName}`, flags.SHABBAT_MEVARCHIM);\n    this.monthName = Locale.gettext(monthName, locale);\n    if (memo) {\n      this.memo = memo;\n    } else {\n      const hyear = date.getFullYear();\n      const hmonth = date.getMonth();\n      const monNext =\n        hmonth === HDate.monthsInYear(hyear) ? months.NISAN : hmonth + 1;\n      const molad = new Molad(hyear, monNext);\n      this.memo = molad.render('en', {hour12: false});\n    }\n  }\n\n  basename(): string {\n    return this.getDesc();\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const monthName0 = Locale.gettext(this.monthName, locale);\n    const monthName = smartApostrophe(monthName0);\n    return Locale.gettext(mevarchimChodeshStr, locale) + ' ' + monthName;\n  }\n  /**\n   * Returns (translated) description of this event\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    const str = this.render(locale);\n    const space = str.indexOf(' ');\n    return str.substring(space + 1);\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAMA,MAAM,mBAAmB,GAAG,2BAA2B;AAEvD;AACM,MAAO,qBAAsB,SAAQ,KAAK,CAAA;AACrC,IAAA,SAAS;AAClB;;;;;;;AAOG;AACH,IAAA,WAAA,CAAY,IAAW,EAAE,SAAiB,EAAE,IAAY,EAAE,MAAe,EAAA;AACvE,QAAA,KAAK,CAAC,IAAI,EAAE,CAAA,EAAG,mBAAmB,CAAA,CAAA,EAAI,SAAS,CAAA,CAAE,EAAE,KAAK,CAAC,iBAAiB,CAAC;QAC3E,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;QAClD,IAAI,IAAI,EAAE;AACR,YAAA,IAAI,CAAC,IAAI,GAAG,IAAI;QAClB;aAAO;AACL,YAAA,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE;AAChC,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE;YAC9B,MAAM,OAAO,GACX,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC;AACvC,YAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAC,MAAM,EAAE,KAAK,EAAC,CAAC;QACjD;IACF;IAEA,QAAQ,GAAA;AACN,QAAA,OAAO,IAAI,CAAC,OAAO,EAAE;IACvB;AACA;;;AAGG;AACH,IAAA,MAAM,CAAC,MAAe,EAAA;AACpB,QAAA,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC;AACzD,QAAA,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,CAAC;AAC7C,QAAA,OAAO,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,GAAG,GAAG,GAAG,SAAS;IACtE;AACA;;;AAGG;AACH,IAAA,WAAW,CAAC,MAAe,EAAA;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC;QAC9B,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;IACjC;AACD;;;;"}

package/dist/esm/ParshaEvent.d.ts

@@ -10,7 +10,16 @@ import './locale';
  * `@hebcal/leyning` when the display title and exact Torah readings are needed.
  */
 export declare class ParshaEvent extends Event {
+    /** The parsha name(s) and date this event was constructed from */
     readonly p: SedraResult;
+    /**
+     * Normally created by {@link calendar} (via `options.sedrot`)
+     * rather than directly.
+     * @param parsha result from {@link Sedra.lookup}
+     * @throws {TypeError} if called with anything other than exactly one argument
+     * @throws {TypeError} if `parsha` is not a valid {@link SedraResult} — it must
+     *   have an `HDate` and one or two parsha names
+     */
     constructor(parsha: SedraResult);
     /**
      * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to empty locale.
@@ -18,6 +27,10 @@ export declare class ParshaEvent extends Event {
     render(locale?: string): string;
     basename(): string;
     url(): string | undefined;
+    /**
+     * The date portion of {@link url}, as `YYYYMMDD` — a parsha name recurs every
+     * year, so the full date is needed to identify the reading.
+     */
     urlDateSuffix(): string;
     /** convenience function for compatibility with previous implementation */
     get parsha(): string[];

package/dist/esm/ParshaEvent.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 { Event, flags } from './event.js';
 import { HDate, isoDateString } from '@hebcal/hdate';
 import { renderParshaName } from './parshaName.js';
@@ -14,7 +14,16 @@ import './locale.js';
  * `@hebcal/leyning` when the display title and exact Torah readings are needed.
  */
 class ParshaEvent extends Event {
+    /** The parsha name(s) and date this event was constructed from */
     p;
+    /**
+     * Normally created by {@link calendar} (via `options.sedrot`)
+     * rather than directly.
+     * @param parsha result from {@link Sedra.lookup}
+     * @throws {TypeError} if called with anything other than exactly one argument
+     * @throws {TypeError} if `parsha` is not a valid {@link SedraResult} — it must
+     *   have an `HDate` and one or two parsha names
+     */
     constructor(parsha) {
         // eslint-disable-next-line prefer-rest-params
         if (arguments.length !== 1) {
@@ -51,6 +60,10 @@ class ParshaEvent extends Event {
         const url = 'https://www.hebcal.com/sedrot/' + urlFriendly(this.basename()) + '-' + dt;
         return this.p.il ? url + '?i=on' : url;
     }
+    /**
+     * The date portion of {@link url}, as `YYYYMMDD` — a parsha name recurs every
+     * year, so the full date is needed to identify the reading.
+     */
     urlDateSuffix() {
         const isoDate = isoDateString(this.greg());
         return isoDate.replaceAll('-', '');

package/dist/esm/ParshaEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"ParshaEvent.js","sources":["../../../src/ParshaEvent.ts"],"sourcesContent":["import {Event, flags} from './event';\nimport {HDate, isoDateString} from '@hebcal/hdate';\nimport {renderParshaName} from './parshaName';\nimport {urlFriendly} from './string';\nimport {SedraResult} from './sedra';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\n/**\n * Represents one of 54 weekly Torah portions, always on a Saturday.\n *\n * `ParshaEvent` is for regular Parashat HaShavua readings. For Shabbatot\n * with holiday readings such as Shabbat Chol ha-Moed, use\n * `getHolidaysOnDate()` from `@hebcal/core`, or `getLeyningOnDate()` from\n * `@hebcal/leyning` when the display title and exact Torah readings are needed.\n */\nexport class ParshaEvent extends Event {\n  readonly p: SedraResult;\n  constructor(parsha: SedraResult) {\n    // eslint-disable-next-line prefer-rest-params\n    if (arguments.length !== 1) {\n      throw new TypeError(\n        `ParshaEvent constructor takes a single SedraResult argument; ` +\n          `got ${arguments.length} arguments`\n      );\n    }\n    if (\n      typeof parsha !== 'object' ||\n      parsha === null ||\n      !Array.isArray(parsha.parsha) ||\n      parsha.parsha.length === 0 ||\n      parsha.parsha.length > 2 ||\n      !HDate.isHDate(parsha.hdate)\n    ) {\n      throw new TypeError(\n        `Invalid SedraResult argument: ${JSON.stringify(parsha)}`\n      );\n    }\n    const desc = 'Parashat ' + parsha.parsha.join('-');\n    super(parsha.hdate, desc, flags.PARSHA_HASHAVUA);\n    this.p = parsha;\n  }\n  /**\n   * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to empty locale.\n   */\n  render(locale?: string): string {\n    return renderParshaName(this.p.parsha, locale);\n  }\n\n  basename(): string {\n    return this.p.parsha.join('-');\n  }\n\n  url(): string | undefined {\n    const year = this.greg().getFullYear();\n    if (year < 100 || year > 2999) {\n      return undefined;\n    }\n    const dt = this.urlDateSuffix();\n    const url =\n      'https://www.hebcal.com/sedrot/' + urlFriendly(this.basename()) + '-' + dt;\n    return this.p.il ? url + '?i=on' : url;\n  }\n\n  urlDateSuffix(): string {\n    const isoDate = isoDateString(this.greg());\n    return isoDate.replaceAll('-', '');\n  }\n\n  /** convenience function for compatibility with previous implementation */\n  get parsha(): string[] {\n    return this.p.parsha;\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAOA;;;;;;;AAOG;AACG,MAAO,WAAY,SAAQ,KAAK,CAAA;AAC3B,IAAA,CAAC;AACV,IAAA,WAAA,CAAY,MAAmB,EAAA;;AAE7B,QAAA,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;YAC1B,MAAM,IAAI,SAAS,CACjB,CAAA,6DAAA,CAA+D;AAC7D,gBAAA,CAAA,IAAA,EAAO,SAAS,CAAC,MAAM,CAAA,UAAA,CAAY,CACtC;QACH;QACA,IACE,OAAO,MAAM,KAAK,QAAQ;AAC1B,YAAA,MAAM,KAAK,IAAI;AACf,YAAA,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;AAC7B,YAAA,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;AAC1B,YAAA,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAC5B;AACA,YAAA,MAAM,IAAI,SAAS,CACjB,CAAA,8BAAA,EAAiC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA,CAAE,CAC1D;QACH;AACA,QAAA,MAAM,IAAI,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAClD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC;AAChD,QAAA,IAAI,CAAC,CAAC,GAAG,MAAM;IACjB;AACA;;AAEG;AACH,IAAA,MAAM,CAAC,MAAe,EAAA;QACpB,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;IAChD;IAEA,QAAQ,GAAA;QACN,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IAChC;IAEA,GAAG,GAAA;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,IAAI,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,IAAI,EAAE;AAC7B,YAAA,OAAO,SAAS;QAClB;AACA,QAAA,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE;AAC/B,QAAA,MAAM,GAAG,GACP,gCAAgC,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE;AAC5E,QAAA,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,OAAO,GAAG,GAAG;IACxC;IAEA,aAAa,GAAA;QACX,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;IACpC;;AAGA,IAAA,IAAI,MAAM,GAAA;AACR,QAAA,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM;IACtB;AACD;;;;"}
+{"version":3,"file":"ParshaEvent.js","sources":["../../../src/ParshaEvent.ts"],"sourcesContent":["import {Event, flags} from './event';\nimport {HDate, isoDateString} from '@hebcal/hdate';\nimport {renderParshaName} from './parshaName';\nimport {urlFriendly} from './string';\nimport {SedraResult} from './sedra';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\n/**\n * Represents one of 54 weekly Torah portions, always on a Saturday.\n *\n * `ParshaEvent` is for regular Parashat HaShavua readings. For Shabbatot\n * with holiday readings such as Shabbat Chol ha-Moed, use\n * `getHolidaysOnDate()` from `@hebcal/core`, or `getLeyningOnDate()` from\n * `@hebcal/leyning` when the display title and exact Torah readings are needed.\n */\nexport class ParshaEvent extends Event {\n  /** The parsha name(s) and date this event was constructed from */\n  readonly p: SedraResult;\n  /**\n   * Normally created by {@link calendar} (via `options.sedrot`)\n   * rather than directly.\n   * @param parsha result from {@link Sedra.lookup}\n   * @throws {TypeError} if called with anything other than exactly one argument\n   * @throws {TypeError} if `parsha` is not a valid {@link SedraResult} — it must\n   *   have an `HDate` and one or two parsha names\n   */\n  constructor(parsha: SedraResult) {\n    // eslint-disable-next-line prefer-rest-params\n    if (arguments.length !== 1) {\n      throw new TypeError(\n        `ParshaEvent constructor takes a single SedraResult argument; ` +\n          `got ${arguments.length} arguments`\n      );\n    }\n    if (\n      typeof parsha !== 'object' ||\n      parsha === null ||\n      !Array.isArray(parsha.parsha) ||\n      parsha.parsha.length === 0 ||\n      parsha.parsha.length > 2 ||\n      !HDate.isHDate(parsha.hdate)\n    ) {\n      throw new TypeError(\n        `Invalid SedraResult argument: ${JSON.stringify(parsha)}`\n      );\n    }\n    const desc = 'Parashat ' + parsha.parsha.join('-');\n    super(parsha.hdate, desc, flags.PARSHA_HASHAVUA);\n    this.p = parsha;\n  }\n  /**\n   * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to empty locale.\n   */\n  render(locale?: string): string {\n    return renderParshaName(this.p.parsha, locale);\n  }\n\n  basename(): string {\n    return this.p.parsha.join('-');\n  }\n\n  url(): string | undefined {\n    const year = this.greg().getFullYear();\n    if (year < 100 || year > 2999) {\n      return undefined;\n    }\n    const dt = this.urlDateSuffix();\n    const url =\n      'https://www.hebcal.com/sedrot/' + urlFriendly(this.basename()) + '-' + dt;\n    return this.p.il ? url + '?i=on' : url;\n  }\n\n  /**\n   * The date portion of {@link url}, as `YYYYMMDD` — a parsha name recurs every\n   * year, so the full date is needed to identify the reading.\n   */\n  urlDateSuffix(): string {\n    const isoDate = isoDateString(this.greg());\n    return isoDate.replaceAll('-', '');\n  }\n\n  /** convenience function for compatibility with previous implementation */\n  get parsha(): string[] {\n    return this.p.parsha;\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAOA;;;;;;;AAOG;AACG,MAAO,WAAY,SAAQ,KAAK,CAAA;;AAE3B,IAAA,CAAC;AACV;;;;;;;AAOG;AACH,IAAA,WAAA,CAAY,MAAmB,EAAA;;AAE7B,QAAA,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;YAC1B,MAAM,IAAI,SAAS,CACjB,CAAA,6DAAA,CAA+D;AAC7D,gBAAA,CAAA,IAAA,EAAO,SAAS,CAAC,MAAM,CAAA,UAAA,CAAY,CACtC;QACH;QACA,IACE,OAAO,MAAM,KAAK,QAAQ;AAC1B,YAAA,MAAM,KAAK,IAAI;AACf,YAAA,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;AAC7B,YAAA,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;AAC1B,YAAA,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAC5B;AACA,YAAA,MAAM,IAAI,SAAS,CACjB,CAAA,8BAAA,EAAiC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA,CAAE,CAC1D;QACH;AACA,QAAA,MAAM,IAAI,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAClD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC;AAChD,QAAA,IAAI,CAAC,CAAC,GAAG,MAAM;IACjB;AACA;;AAEG;AACH,IAAA,MAAM,CAAC,MAAe,EAAA;QACpB,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;IAChD;IAEA,QAAQ,GAAA;QACN,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IAChC;IAEA,GAAG,GAAA;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,IAAI,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,IAAI,EAAE;AAC7B,YAAA,OAAO,SAAS;QAClB;AACA,QAAA,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE;AAC/B,QAAA,MAAM,GAAG,GACP,gCAAgC,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,GAAG,EAAE;AAC5E,QAAA,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,OAAO,GAAG,GAAG;IACxC;AAEA;;;AAGG;IACH,aAAa,GAAA;QACX,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;IACpC;;AAGA,IAAA,IAAI,MAAM,GAAA;AACR,QAAA,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM;IACtB;AACD;;;;"}

package/dist/esm/TimedEvent.d.ts

@@ -25,7 +25,14 @@ export declare class TimedEvent extends Event {
     /** Optional event this time is associated with (e.g. the Yom Tov being lit for) */
     readonly linkedEvent?: Event;
     /**
+     * Normally created by {@link calendar} rather than directly.
+     * @param date Hebrew date the event occurs
      * @param desc Description (not translated)
+     * @param mask optional holiday flags
+     * @param eventTime the exact moment of the event
+     * @param location geographic location used to format the time
+     * @param linkedEvent optional event this time is associated with
+     * @param options optional; `locale` and `hour12` affect {@link fmtTime}
      */
     constructor(date: HDate, desc: string, mask: number, eventTime: Date, location: Location, linkedEvent?: Event, options?: CalOptions);
     /**
@@ -42,10 +49,11 @@ export declare class TimedEvent extends Event {
 /**
  * Candle-lighting event for the eve of Shabbat or a Yom Tov.
  *
- * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`
+ * Generated by {@link calendar} when `options.candlelighting`
  * is `true` and `options.location` is provided. By default candle lighting
- * occurs 18 minutes before sundown (40 minutes in Jerusalem; 30 minutes in
- * Haifa and Zikhron Ya'akov), configurable via `options.candleLightingMins`.
+ * occurs 18 minutes before sundown in the Diaspora and 20 minutes before
+ * sundown in Israel (40 minutes in Jerusalem; 30 minutes in Haifa and
+ * Zikhron Ya'akov), configurable via `options.candleLightingMins`.
  */
 export declare class CandleLightingEvent extends TimedEvent {
     constructor(date: HDate, mask: number, eventTime: Date, location: Location, linkedEvent?: Event, options?: CalOptions);
@@ -54,7 +62,7 @@ export declare class CandleLightingEvent extends TimedEvent {
 /**
  * Havdalah event marking the end of Shabbat or a Yom Tov.
  *
- * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`
+ * Generated by {@link calendar} when `options.candlelighting`
  * is `true` and `options.location` is provided. By default Havdalah is
  * calculated by *tzeit hakochavim* (8.5° solar depression); pass
  * `options.havdalahMins` to use a fixed minute offset instead, or

package/dist/esm/TimedEvent.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 } from '@hebcal/hdate';
 import { Event } from './event.js';
 import { reformatTimeStr } from './reformatTimeStr.js';
@@ -30,7 +30,14 @@ class TimedEvent extends Event {
     /** Optional event this time is associated with (e.g. the Yom Tov being lit for) */
     linkedEvent;
     /**
+     * Normally created by {@link calendar} rather than directly.
+     * @param date Hebrew date the event occurs
      * @param desc Description (not translated)
+     * @param mask optional holiday flags
+     * @param eventTime the exact moment of the event
+     * @param location geographic location used to format the time
+     * @param linkedEvent optional event this time is associated with
+     * @param options optional; `locale` and `hour12` affect {@link fmtTime}
      */
     constructor(date, desc, mask, eventTime, location, linkedEvent, options) {
         super(date, desc, mask);
@@ -82,10 +89,11 @@ class TimedEvent extends Event {
 /**
  * Candle-lighting event for the eve of Shabbat or a Yom Tov.
  *
- * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`
+ * Generated by {@link calendar} when `options.candlelighting`
  * is `true` and `options.location` is provided. By default candle lighting
- * occurs 18 minutes before sundown (40 minutes in Jerusalem; 30 minutes in
- * Haifa and Zikhron Ya'akov), configurable via `options.candleLightingMins`.
+ * occurs 18 minutes before sundown in the Diaspora and 20 minutes before
+ * sundown in Israel (40 minutes in Jerusalem; 30 minutes in Haifa and
+ * Zikhron Ya'akov), configurable via `options.candleLightingMins`.
  */
 class CandleLightingEvent extends TimedEvent {
     constructor(date, mask, eventTime, location, linkedEvent, options) {
@@ -98,7 +106,7 @@ class CandleLightingEvent extends TimedEvent {
 /**
  * Havdalah event marking the end of Shabbat or a Yom Tov.
  *
- * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`
+ * Generated by {@link calendar} when `options.candlelighting`
  * is `true` and `options.location` is provided. By default Havdalah is
  * calculated by *tzeit hakochavim* (8.5° solar depression); pass
  * `options.havdalahMins` to use a fixed minute offset instead, or

package/dist/esm/TimedEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"TimedEvent.js","sources":["../../../src/TimedEvent.ts"],"sourcesContent":["import {HDate, Locale} from '@hebcal/hdate';\nimport {CalOptions} from './CalOptions';\nimport {Location} from './location';\nimport {Event} from './event';\nimport {reformatTimeStr} from './reformatTimeStr';\nimport {Zmanim} from './zmanim';\nimport {holidayDesc as hdesc} from './staticHolidays';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst HAVDALAH = hdesc.HAVDALAH;\nconst CANDLE_LIGHTING = hdesc.CANDLE_LIGHTING;\n\n/**\n * Base class for events that have an associated wall-clock time and\n * geographic location — for example, candle lighting, havdalah, and\n * fast begin/end times.\n *\n * Stores both a `Date` (`eventTime`) and pre-formatted 24-hour\n * (`eventTimeStr`) and locale-aware (`fmtTime`) strings. May reference a\n * \"linked\" event such as the holiday whose candle-lighting time this\n * represents.\n */\nexport class TimedEvent extends Event {\n  /** The exact moment of the event, rounded to the nearest minute */\n  readonly eventTime: Date;\n  /** Geographic location used to compute `eventTime` */\n  readonly location: Location;\n  /** 24-hour formatted time string in the location's timezone (e.g. `\"19:42\"`) */\n  readonly eventTimeStr: string;\n  /** Locale-aware formatted time string (e.g. `\"7:42pm\"` in US locale) */\n  readonly fmtTime: string;\n  /** Optional event this time is associated with (e.g. the Yom Tov being lit for) */\n  readonly linkedEvent?: Event;\n  /**\n   * @param desc Description (not translated)\n   */\n  constructor(\n    date: HDate,\n    desc: string,\n    mask: number,\n    eventTime: Date,\n    location: Location,\n    linkedEvent?: Event,\n    options?: CalOptions\n  ) {\n    super(date, desc, mask);\n    this.eventTime = Zmanim.roundTime(eventTime);\n    this.location = location;\n    const timeFormat = location.getTimeFormatter();\n    this.eventTimeStr = Zmanim.formatTime(this.eventTime, timeFormat);\n    const opts = {...options, location};\n    this.fmtTime = reformatTimeStr(this.eventTimeStr, 'pm', opts);\n    if (linkedEvent !== undefined) {\n      this.linkedEvent = linkedEvent;\n    }\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    return Locale.gettext(this.getDesc(), locale) + ': ' + this.fmtTime;\n  }\n  /**\n   * Returns translation of \"Candle lighting\" without the time.\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    return Locale.gettext(this.getDesc(), locale);\n  }\n\n  getCategories(): string[] {\n    const desc = this.getDesc();\n    switch (desc) {\n      // LIGHT_CANDLES or LIGHT_CANDLES_TZEIS\n      case CANDLE_LIGHTING:\n        return ['candles'];\n      // YOM_TOV_ENDS\n      case HAVDALAH:\n        return ['havdalah'];\n      // flags.MINOR_FAST or flags.MAJOR_FAST\n      case hdesc.FAST_BEGINS:\n      case hdesc.FAST_ENDS:\n        return ['zmanim', 'fast'];\n      case hdesc.SOF_ZMAN_ACHILAT_CHAMETZ:\n        return ['zmanim', 'achilasChametz'];\n      case hdesc.BIUR_CHAMETZ:\n        return ['zmanim', 'biurChametz'];\n    }\n    /* NOTREACHED */\n    return ['unknown'];\n  }\n}\n\n/**\n * Candle-lighting event for the eve of Shabbat or a Yom Tov.\n *\n * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`\n * is `true` and `options.location` is provided. By default candle lighting\n * occurs 18 minutes before sundown (40 minutes in Jerusalem; 30 minutes in\n * Haifa and Zikhron Ya'akov), configurable via `options.candleLightingMins`.\n */\nexport class CandleLightingEvent extends TimedEvent {\n  constructor(\n    date: HDate,\n    mask: number,\n    eventTime: Date,\n    location: Location,\n    linkedEvent?: Event,\n    options?: CalOptions\n  ) {\n    super(date, CANDLE_LIGHTING, mask, eventTime, location, linkedEvent, options);\n  }\n\n  getEmoji(): string {\n    return '🕯️';\n  }\n}\n\n/**\n * Havdalah event marking the end of Shabbat or a Yom Tov.\n *\n * Generated by {@link HebrewCalendar.calendar} when `options.candlelighting`\n * is `true` and `options.location` is provided. By default Havdalah is\n * calculated by *tzeit hakochavim* (8.5° solar depression); pass\n * `options.havdalahMins` to use a fixed minute offset instead, or\n * `options.havdalahDeg` to use a different degree.\n */\nexport class HavdalahEvent extends TimedEvent {\n  private readonly havdalahMins?: number;\n  constructor(\n    date: HDate,\n    mask: number,\n    eventTime: Date,\n    location: Location,\n    havdalahMins?: number,\n    linkedEvent?: Event,\n    options?: CalOptions\n  ) {\n    super(date, HAVDALAH, mask, eventTime, location, linkedEvent, options);\n    if (havdalahMins) {\n      this.havdalahMins = havdalahMins;\n    }\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    return this.renderBrief(locale) + ': ' + this.fmtTime;\n  }\n  /**\n   * Returns translation of \"Havdalah\" without the time.\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    let str = Locale.gettext(this.getDesc(), locale);\n    if (this.havdalahMins) {\n      const min = Locale.gettext('min', locale);\n      str += ` (${this.havdalahMins} ${min})`;\n    }\n    return str;\n  }\n\n  getEmoji(): string {\n    return '✨';\n  }\n}\n"],"names":["hdesc"],"mappings":"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"}
+{"version":3,"file":"TimedEvent.js","sources":["../../../src/TimedEvent.ts"],"sourcesContent":["import {HDate, Locale} from '@hebcal/hdate';\nimport {CalOptions} from './CalOptions';\nimport {Location} from './location';\nimport {Event} from './event';\nimport {reformatTimeStr} from './reformatTimeStr';\nimport {Zmanim} from './zmanim';\nimport {holidayDesc as hdesc} from './staticHolidays';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst HAVDALAH = hdesc.HAVDALAH;\nconst CANDLE_LIGHTING = hdesc.CANDLE_LIGHTING;\n\n/**\n * Base class for events that have an associated wall-clock time and\n * geographic location — for example, candle lighting, havdalah, and\n * fast begin/end times.\n *\n * Stores both a `Date` (`eventTime`) and pre-formatted 24-hour\n * (`eventTimeStr`) and locale-aware (`fmtTime`) strings. May reference a\n * \"linked\" event such as the holiday whose candle-lighting time this\n * represents.\n */\nexport class TimedEvent extends Event {\n  /** The exact moment of the event, rounded to the nearest minute */\n  readonly eventTime: Date;\n  /** Geographic location used to compute `eventTime` */\n  readonly location: Location;\n  /** 24-hour formatted time string in the location's timezone (e.g. `\"19:42\"`) */\n  readonly eventTimeStr: string;\n  /** Locale-aware formatted time string (e.g. `\"7:42pm\"` in US locale) */\n  readonly fmtTime: string;\n  /** Optional event this time is associated with (e.g. the Yom Tov being lit for) */\n  readonly linkedEvent?: Event;\n  /**\n   * Normally created by {@link calendar} rather than directly.\n   * @param date Hebrew date the event occurs\n   * @param desc Description (not translated)\n   * @param mask optional holiday flags\n   * @param eventTime the exact moment of the event\n   * @param location geographic location used to format the time\n   * @param linkedEvent optional event this time is associated with\n   * @param options optional; `locale` and `hour12` affect {@link fmtTime}\n   */\n  constructor(\n    date: HDate,\n    desc: string,\n    mask: number,\n    eventTime: Date,\n    location: Location,\n    linkedEvent?: Event,\n    options?: CalOptions\n  ) {\n    super(date, desc, mask);\n    this.eventTime = Zmanim.roundTime(eventTime);\n    this.location = location;\n    const timeFormat = location.getTimeFormatter();\n    this.eventTimeStr = Zmanim.formatTime(this.eventTime, timeFormat);\n    const opts = {...options, location};\n    this.fmtTime = reformatTimeStr(this.eventTimeStr, 'pm', opts);\n    if (linkedEvent !== undefined) {\n      this.linkedEvent = linkedEvent;\n    }\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    return Locale.gettext(this.getDesc(), locale) + ': ' + this.fmtTime;\n  }\n  /**\n   * Returns translation of \"Candle lighting\" without the time.\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    return Locale.gettext(this.getDesc(), locale);\n  }\n\n  getCategories(): string[] {\n    const desc = this.getDesc();\n    switch (desc) {\n      // LIGHT_CANDLES or LIGHT_CANDLES_TZEIS\n      case CANDLE_LIGHTING:\n        return ['candles'];\n      // YOM_TOV_ENDS\n      case HAVDALAH:\n        return ['havdalah'];\n      // flags.MINOR_FAST or flags.MAJOR_FAST\n      case hdesc.FAST_BEGINS:\n      case hdesc.FAST_ENDS:\n        return ['zmanim', 'fast'];\n      case hdesc.SOF_ZMAN_ACHILAT_CHAMETZ:\n        return ['zmanim', 'achilasChametz'];\n      case hdesc.BIUR_CHAMETZ:\n        return ['zmanim', 'biurChametz'];\n    }\n    /* NOTREACHED */\n    return ['unknown'];\n  }\n}\n\n/**\n * Candle-lighting event for the eve of Shabbat or a Yom Tov.\n *\n * Generated by {@link calendar} when `options.candlelighting`\n * is `true` and `options.location` is provided. By default candle lighting\n * occurs 18 minutes before sundown in the Diaspora and 20 minutes before\n * sundown in Israel (40 minutes in Jerusalem; 30 minutes in Haifa and\n * Zikhron Ya'akov), configurable via `options.candleLightingMins`.\n */\nexport class CandleLightingEvent extends TimedEvent {\n  constructor(\n    date: HDate,\n    mask: number,\n    eventTime: Date,\n    location: Location,\n    linkedEvent?: Event,\n    options?: CalOptions\n  ) {\n    super(date, CANDLE_LIGHTING, mask, eventTime, location, linkedEvent, options);\n  }\n\n  getEmoji(): string {\n    return '🕯️';\n  }\n}\n\n/**\n * Havdalah event marking the end of Shabbat or a Yom Tov.\n *\n * Generated by {@link calendar} when `options.candlelighting`\n * is `true` and `options.location` is provided. By default Havdalah is\n * calculated by *tzeit hakochavim* (8.5° solar depression); pass\n * `options.havdalahMins` to use a fixed minute offset instead, or\n * `options.havdalahDeg` to use a different degree.\n */\nexport class HavdalahEvent extends TimedEvent {\n  private readonly havdalahMins?: number;\n  constructor(\n    date: HDate,\n    mask: number,\n    eventTime: Date,\n    location: Location,\n    havdalahMins?: number,\n    linkedEvent?: Event,\n    options?: CalOptions\n  ) {\n    super(date, HAVDALAH, mask, eventTime, location, linkedEvent, options);\n    if (havdalahMins) {\n      this.havdalahMins = havdalahMins;\n    }\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    return this.renderBrief(locale) + ': ' + this.fmtTime;\n  }\n  /**\n   * Returns translation of \"Havdalah\" without the time.\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    let str = Locale.gettext(this.getDesc(), locale);\n    if (this.havdalahMins) {\n      const min = Locale.gettext('min', locale);\n      str += ` (${this.havdalahMins} ${min})`;\n    }\n    return str;\n  }\n\n  getEmoji(): string {\n    return '✨';\n  }\n}\n"],"names":["hdesc"],"mappings":"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"}

package/dist/esm/YomKippurKatanEvent.d.ts

@@ -5,7 +5,8 @@ import './locale';
 export declare class YomKippurKatanEvent extends HolidayEvent {
     private readonly nextMonthName;
     /**
-     * @private
+     * Normally created by {@link calendar} (via
+     * `options.yomKippurKatan`) rather than directly.
      * @param date Hebrew date event occurs
      * @param nextMonthName name of the upcoming month
      */

package/dist/esm/YomKippurKatanEvent.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 } from '@hebcal/hdate';
 import { flags } from './event.js';
 import { HolidayEvent } from './HolidayEvent.js';
@@ -10,7 +10,8 @@ const ykk = 'Yom Kippur Katan';
 class YomKippurKatanEvent extends HolidayEvent {
     nextMonthName;
     /**
-     * @private
+     * Normally created by {@link calendar} (via
+     * `options.yomKippurKatan`) rather than directly.
      * @param date Hebrew date event occurs
      * @param nextMonthName name of the upcoming month
      */

package/dist/esm/YomKippurKatanEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"YomKippurKatanEvent.js","sources":["../../../src/YomKippurKatanEvent.ts"],"sourcesContent":["import {HDate, Locale} from '@hebcal/hdate';\nimport {flags} from './event';\nimport {HolidayEvent} from './HolidayEvent';\nimport {smartApostrophe} from './string';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst ykk = 'Yom Kippur Katan';\n\n/** YKK is minor day of atonement on the day preceeding each Rosh Chodesh */\nexport class YomKippurKatanEvent extends HolidayEvent {\n  private readonly nextMonthName: string;\n  /**\n   * @private\n   * @param date Hebrew date event occurs\n   * @param nextMonthName name of the upcoming month\n   */\n  constructor(date: HDate, nextMonthName: string) {\n    super(\n      date,\n      `${ykk} ${nextMonthName}`,\n      flags.MINOR_FAST | flags.YOM_KIPPUR_KATAN\n    );\n    this.nextMonthName = nextMonthName;\n    this.memo = `Minor Day of Atonement on the day preceeding Rosh Chodesh ${nextMonthName}`;\n  }\n\n  basename(): string {\n    return this.getDesc();\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const monthName0 = Locale.gettext(this.nextMonthName, locale);\n    const monthName = smartApostrophe(monthName0);\n    return Locale.gettext(ykk, locale) + ' ' + monthName;\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    return Locale.gettext(ykk, locale);\n  }\n\n  url(): string | undefined {\n    return undefined;\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAMA,MAAM,GAAG,GAAG,kBAAkB;AAE9B;AACM,MAAO,mBAAoB,SAAQ,YAAY,CAAA;AAClC,IAAA,aAAa;AAC9B;;;;AAIG;IACH,WAAA,CAAY,IAAW,EAAE,aAAqB,EAAA;AAC5C,QAAA,KAAK,CACH,IAAI,EACJ,CAAA,EAAG,GAAG,IAAI,aAAa,CAAA,CAAE,EACzB,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAC1C;AACD,QAAA,IAAI,CAAC,aAAa,GAAG,aAAa;AAClC,QAAA,IAAI,CAAC,IAAI,GAAG,CAAA,0DAAA,EAA6D,aAAa,EAAE;IAC1F;IAEA,QAAQ,GAAA;AACN,QAAA,OAAO,IAAI,CAAC,OAAO,EAAE;IACvB;AACA;;AAEG;AACH,IAAA,MAAM,CAAC,MAAe,EAAA;AACpB,QAAA,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;AAC7D,QAAA,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,CAAC;AAC7C,QAAA,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,GAAG,GAAG,SAAS;IACtD;AACA;;AAEG;AACH,IAAA,WAAW,CAAC,MAAe,EAAA;QACzB,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC;IACpC;IAEA,GAAG,GAAA;AACD,QAAA,OAAO,SAAS;IAClB;AACD;;;;"}
+{"version":3,"file":"YomKippurKatanEvent.js","sources":["../../../src/YomKippurKatanEvent.ts"],"sourcesContent":["import {HDate, Locale} from '@hebcal/hdate';\nimport {flags} from './event';\nimport {HolidayEvent} from './HolidayEvent';\nimport {smartApostrophe} from './string';\nimport './locale'; // Adds Hebrew and Ashkenazic translations\n\nconst ykk = 'Yom Kippur Katan';\n\n/** YKK is minor day of atonement on the day preceeding each Rosh Chodesh */\nexport class YomKippurKatanEvent extends HolidayEvent {\n  private readonly nextMonthName: string;\n  /**\n   * Normally created by {@link calendar} (via\n   * `options.yomKippurKatan`) rather than directly.\n   * @param date Hebrew date event occurs\n   * @param nextMonthName name of the upcoming month\n   */\n  constructor(date: HDate, nextMonthName: string) {\n    super(\n      date,\n      `${ykk} ${nextMonthName}`,\n      flags.MINOR_FAST | flags.YOM_KIPPUR_KATAN\n    );\n    this.nextMonthName = nextMonthName;\n    this.memo = `Minor Day of Atonement on the day preceeding Rosh Chodesh ${nextMonthName}`;\n  }\n\n  basename(): string {\n    return this.getDesc();\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  render(locale?: string): string {\n    const monthName0 = Locale.gettext(this.nextMonthName, locale);\n    const monthName = smartApostrophe(monthName0);\n    return Locale.gettext(ykk, locale) + ' ' + monthName;\n  }\n  /**\n   * @param [locale] Optional locale name (defaults to empty locale)\n   */\n  renderBrief(locale?: string): string {\n    return Locale.gettext(ykk, locale);\n  }\n\n  url(): string | undefined {\n    return undefined;\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAMA,MAAM,GAAG,GAAG,kBAAkB;AAE9B;AACM,MAAO,mBAAoB,SAAQ,YAAY,CAAA;AAClC,IAAA,aAAa;AAC9B;;;;;AAKG;IACH,WAAA,CAAY,IAAW,EAAE,aAAqB,EAAA;AAC5C,QAAA,KAAK,CACH,IAAI,EACJ,CAAA,EAAG,GAAG,IAAI,aAAa,CAAA,CAAE,EACzB,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,gBAAgB,CAC1C;AACD,QAAA,IAAI,CAAC,aAAa,GAAG,aAAa;AAClC,QAAA,IAAI,CAAC,IAAI,GAAG,CAAA,0DAAA,EAA6D,aAAa,EAAE;IAC1F;IAEA,QAAQ,GAAA;AACN,QAAA,OAAO,IAAI,CAAC,OAAO,EAAE;IACvB;AACA;;AAEG;AACH,IAAA,MAAM,CAAC,MAAe,EAAA;AACpB,QAAA,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;AAC7D,QAAA,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,CAAC;AAC7C,QAAA,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,GAAG,GAAG,SAAS;IACtD;AACA;;AAEG;AACH,IAAA,WAAW,CAAC,MAAe,EAAA;QACzB,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC;IACpC;IAEA,GAAG,GAAA;AACD,QAAA,OAAO,SAAS;IAClB;AACD;;;;"}

package/dist/esm/ashkenazi.po.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 */
 var poAshkenazi = { "headers": { "plural-forms": "nplurals=2; plural=(n > 1);", "language": "und-x-ashkenaz" }, "contexts": { "": { "Shabbat": ["Shabbos"], "Achrei Mot": ["Achrei Mos"], "Bechukotai": ["Bechukosai"], "Beha'alotcha": ["Beha’aloscha"], "Bereshit": ["Bereshis"], "Chukat": ["Chukas"], "Erev Shavuot": ["Erev Shavuos"], "Erev Sukkot": ["Erev Sukkos"], "Ki Tavo": ["Ki Savo"], "Ki Teitzei": ["Ki Seitzei"], "Ki Tisa": ["Ki Sisa"], "Matot": ["Matos"], "Pesach Shabbat Chol ha-Moed": ["Pesach Shabbos Chol ha-Moed"], "Purim Katan": ["Purim Koton"], "Rosh Hashana LaBehemot": ["Rosh Hashana LaBeheimos"], "Shabbat Chazon": ["Shabbos Chazon"], "Shabbat HaChodesh": ["Shabbos HaChodesh"], "Shabbat HaGadol": ["Shabbos HaGadol"], "Shabbat Nachamu": ["Shabbos Nachamu"], "Shabbat Parah": ["Shabbos Parah"], "Shabbat Shekalim": ["Shabbos Shekalim"], "Shabbat Shuva": ["Shabbos Shuvah"], "Shabbat Zachor": ["Shabbos Zachor"], "Shavuot": ["Shavuos"], "Shavuot I": ["Shavuos I"], "Shavuot II": ["Shavuos II"], "Shemot": ["Shemos"], "Shmini Atzeret": ["Shmini Atzeres"], "Simchat Torah": ["Simchas Torah"], "Sukkot": ["Sukkos"], "Sukkot I": ["Sukkos I"], "Sukkot II": ["Sukkos II"], "Sukkot II (CH''M)": ["Sukkos II (CH’’M)"], "Sukkot III (CH''M)": ["Sukkos III (CH’’M)"], "Sukkot IV (CH''M)": ["Sukkos IV (CH’’M)"], "Sukkot V (CH''M)": ["Sukkos V (CH’’M)"], "Sukkot VI (CH''M)": ["Sukkos VI (CH’’M)"], "Sukkot VII (Hoshana Raba)": ["Sukkos VII (Hoshana Raba)"], "Sukkot Shabbat Chol ha-Moed": ["Sukkos Shabbos Chol ha-Moed"], "Ta'anit Bechorot": ["Ta’anis Bechoros"], "Ta'anit BeHaB": ["Ta’anis BeHaB"], "Ta'anit Esther": ["Ta’anis Esther"], "Toldot": ["Toldos"], "Vaetchanan": ["Vaeschanan"], "Yitro": ["Yisro"], "Vezot Haberakhah": ["Vezos Haberakhah"], "Parashat": ["Parshas"], "Leil Selichot": ["Leil Selichos"], "Shabbat Mevarchim Chodesh": ["Shabbos Mevorchim Chodesh"], "Shabbat Shirah": ["Shabbos Shirah"], "Asara B'Tevet": ["Asara B’Teves"], "Birkat Hachamah": ["Birkas HaChamah"], "Birkat HaChamah": ["Birkas HaChamah"], "Shushan Purim Katan": ["Shushan Purim Koton"], "Alot HaShachar": ["Alos HaShachar"], "Misheyakir": ["Misheyakir"], "Misheyakir Machmir": ["Misheyakir Machmir"], "Sunrise": ["Sunrise"], "Kriat Shema, sof zeman": ["Krias Shema, sof zman"], "Tefilah, sof zeman": ["Tefilah, sof zman"], "Kriat Shema, sof zeman (MGA)": ["Krias Shema, sof zman (MGA)"], "Kriat Shema, sof zeman (GRA)": ["Krias Shema, sof zman (GRA)"], "Tefilah, sof zeman (MGA)": ["Tefilah, sof zman (MGA)"], "Tefilah, sof zeman (GRA)": ["Tefilah, sof zman (GRA)"], "Chatzot HaLailah": ["Chatzos HaLailah"], "Chatzot HaYom": ["Chatzos"], "Chatzot hayom": ["Chatzos"], "Mincha Gedolah": ["Mincha Gedolah"], "Mincha Ketanah": ["Mincha Ketanah"], "Plag HaMincha": ["Plag HaMincha"], "Sunset": ["Sunset"], "Bein HaShemashot": ["Bein HaShemashos"], "Tzeit HaKochavim": ["Tzeis HaKochavim"] } } };
 
 export { poAshkenazi as default };