@hebcal/core 5.4.8 → 5.4.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,6 @@
1
1
  import { HDate } from '@hebcal/hdate';
2
2
  import { Location } from './location';
3
+ export type DailyLearningValue = boolean | number | string;
3
4
  /**
4
5
  * Options to configure which events are returned
5
6
  */
@@ -152,6 +153,6 @@ export type CalOptions = {
152
153
  * the value should be a `number` for edition (`1` for Vilna, `2` for Schottenstein).
153
154
  */
154
155
  dailyLearning?: {
155
- [x: string]: any;
156
+ [x: string]: DailyLearningValue;
156
157
  };
157
158
  };
@@ -8,17 +8,14 @@ import { Event } from './event';
8
8
  export declare class DailyLearning {
9
9
  /**
10
10
  * Register a new learning calendar.
11
- * @param {string} name
12
- * @param {Function} calendar
13
11
  */
14
12
  static addCalendar(name: string, calendar: Function): void;
15
13
  /**
16
14
  * Returns an event from daily calendar for a given date. Returns `null` if there
17
15
  * is no learning from this calendar on this date.
18
- * @param {string} name
19
- * @param {HDate} hd
20
- * @param {boolean} il
21
- * @return {Event | null}
16
+ * @param name
17
+ * @param hd
18
+ * @param il
22
19
  */
23
20
  static lookup(name: string, hd: HDate, il: boolean): Event | null;
24
21
  }
@@ -4,11 +4,11 @@ import './locale';
4
4
  /** Daily Hebrew date ("11th of Sivan, 5780") */
5
5
  export declare class HebrewDateEvent extends Event {
6
6
  /**
7
- * @param {HDate} date
7
+ * @param date
8
8
  */
9
9
  constructor(date: HDate);
10
10
  /**
11
- * @param {string} [locale] Optional locale name (defaults to active locale).
11
+ * @param [locale] Optional locale name (defaults to active locale).
12
12
  * @example
13
13
  * import {HDate, HebrewDateEvent, months} from '@hebcal/core';
14
14
  *
@@ -16,17 +16,15 @@ export declare class HebrewDateEvent extends Event {
16
16
  * const ev = new HebrewDateEvent(hd);
17
17
  * console.log(ev.render('en')); // '15th of Cheshvan, 5769'
18
18
  * console.log(ev.render('he')); // 'ט״ו חֶשְׁוָן תשס״ט'
19
- * @return {string}
20
19
  */
21
20
  render(locale?: string): string;
22
21
  /**
23
22
  * @private
24
- * @param {string} locale
25
- * @return {string}
23
+ * @param locale
26
24
  */
27
25
  private renderBriefHebrew;
28
26
  /**
29
- * @param {string} [locale] Optional locale name (defaults to active locale).
27
+ * @param [locale] Optional locale name (defaults to active locale).
30
28
  * @example
31
29
  * import {HDate, HebrewDateEvent, months} from '@hebcal/core';
32
30
  *
@@ -34,7 +32,6 @@ export declare class HebrewDateEvent extends Event {
34
32
  * const ev = new HebrewDateEvent(hd);
35
33
  * console.log(ev.renderBrief()); // '15th of Cheshvan'
36
34
  * console.log(ev.renderBrief('he')); // 'ט״ו חֶשְׁוָן'
37
- * @return {string}
38
35
  */
39
36
  renderBrief(locale?: string): string;
40
37
  }
@@ -17,33 +17,25 @@ export declare class HolidayEvent extends Event {
17
17
  startEvent?: TimedEvent;
18
18
  /** For a Fast day, this will be a "Fast ends" event */
19
19
  endEvent?: TimedEvent;
20
- /** @return {string} */
21
20
  basename(): string;
22
- /** @return {string | undefined} */
23
21
  url(): string | undefined;
24
- /** @return {string} */
25
22
  urlDateSuffix(): string;
26
- /** @return {string} */
27
23
  getEmoji(): string;
28
- /** @return {string[]} */
29
24
  getCategories(): string[];
30
25
  /**
31
26
  * Returns (translated) description of this event
32
- * @param {string} [locale] Optional locale name (defaults to active locale).
33
- * @return {string}
27
+ * @param [locale] Optional locale name (defaults to active locale).
34
28
  */
35
29
  render(locale?: string): string;
36
30
  /**
37
31
  * Returns a brief (translated) description of this event.
38
32
  * For most events, this is the same as render(). For some events, it procudes
39
33
  * a shorter text (e.g. without a time or added description).
40
- * @param {string} [locale] Optional locale name (defaults to active locale).
41
- * @return {string}
34
+ * @param [locale] Optional locale name (defaults to active locale).
42
35
  */
43
36
  renderBrief(locale?: string): string;
44
37
  /**
45
38
  * Makes a clone of this Event object
46
- * @return {Event}
47
39
  */
48
40
  clone(): HolidayEvent;
49
41
  }
@@ -52,7 +44,6 @@ export declare class HolidayEvent extends Event {
52
44
  * we subclass HolidayEvent to override the `url()` method.
53
45
  */
54
46
  export declare class AsaraBTevetEvent extends HolidayEvent {
55
- /** @return {string} */
56
47
  urlDateSuffix(): string;
57
48
  }
58
49
  /** Represents Rosh Hashana, the Jewish New Year */
@@ -60,36 +51,31 @@ export declare class RoshHashanaEvent extends HolidayEvent {
60
51
  private readonly hyear;
61
52
  /**
62
53
  * @private
63
- * @param {HDate} date Hebrew date event occurs
64
- * @param {number} hyear Hebrew year
65
- * @param {number} mask optional holiday flags
54
+ * @param date Hebrew date event occurs
55
+ * @param hyear Hebrew year
56
+ * @param mask optional holiday flags
66
57
  */
67
58
  constructor(date: HDate, hyear: number, mask: number);
68
59
  /**
69
60
  * Returns (translated) description of this event
70
- * @param {string} [locale] Optional locale name (defaults to active locale).
71
- * @return {string}
61
+ * @param [locale] Optional locale name (defaults to active locale).
72
62
  */
73
63
  render(locale?: string): string;
74
- /** @return {string} */
75
64
  getEmoji(): string;
76
65
  }
77
66
  /** Represents Rosh Chodesh, the beginning of a new month */
78
67
  export declare class RoshChodeshEvent extends HolidayEvent {
79
68
  /**
80
69
  * Constructs Rosh Chodesh event
81
- * @param {HDate} date Hebrew date event occurs
82
- * @param {string} monthName Hebrew month name (not translated)
70
+ * @param date Hebrew date event occurs
71
+ * @param monthName Hebrew month name (not translated)
83
72
  */
84
73
  constructor(date: HDate, monthName: string);
85
74
  /**
86
75
  * Returns (translated) description of this event
87
- * @param {string} [locale] Optional locale name (defaults to active locale).
88
- * @return {string}
76
+ * @param [locale] Optional locale name (defaults to active locale).
89
77
  */
90
78
  render(locale?: string): string;
91
- /** @return {string} */
92
79
  basename(): string;
93
- /** @return {string} */
94
80
  getEmoji(): string;
95
81
  }
@@ -6,23 +6,20 @@ export declare class MevarchimChodeshEvent extends Event {
6
6
  readonly monthName: string;
7
7
  /**
8
8
  * Constructs Mevarchim haChodesh event
9
- * @param {HDate} date Hebrew date event occurs
10
- * @param {string} monthName Hebrew month name (not translated)
11
- * @param {string} [memo]
9
+ * @param date Hebrew date event occurs
10
+ * @param monthName Hebrew month name (not translated)
11
+ * @param [memo]
12
12
  */
13
13
  constructor(date: HDate, monthName: string, memo: string);
14
- /** @return {string} */
15
14
  basename(): string;
16
15
  /**
17
16
  * Returns (translated) description of this event
18
- * @param {string} [locale] Optional locale name (defaults to active locale).
19
- * @return {string}
17
+ * @param [locale] Optional locale name (defaults to active locale).
20
18
  */
21
19
  render(locale?: string): string;
22
20
  /**
23
21
  * Returns (translated) description of this event
24
- * @param {string} [locale] Optional locale name (defaults to active locale).
25
- * @return {string}
22
+ * @param [locale] Optional locale name (defaults to active locale).
26
23
  */
27
24
  renderBrief(locale?: string): string;
28
25
  }
@@ -9,22 +9,15 @@ export declare class ParshaEvent extends Event {
9
9
  readonly il: boolean;
10
10
  readonly num: number | number[];
11
11
  /**
12
- * @param {HDate} date
13
- * @param {string[]} parsha - untranslated name of single or double parsha,
12
+ * @param parsha - untranslated name of single or double parsha,
14
13
  * such as ['Bereshit'] or ['Achrei Mot', 'Kedoshim']
15
- * @param {boolean} [il]
16
- * @param {number|number[]} [num]
17
14
  */
18
15
  constructor(date: HDate, parsha: string[], il?: boolean, num?: number | number[]);
19
16
  /**
20
- * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
21
- * @return {string}
17
+ * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
22
18
  */
23
19
  render(locale?: string): string;
24
- /** @return {string} */
25
20
  basename(): string;
26
- /** @return {string | undefined} */
27
21
  url(): string | undefined;
28
- /** @return {string} */
29
22
  urlDateSuffix(): string;
30
23
  }
@@ -11,27 +11,23 @@ export declare class TimedEvent extends Event {
11
11
  readonly fmtTime: string;
12
12
  readonly linkedEvent?: Event;
13
13
  /**
14
- * @param {string} desc Description (not translated)
14
+ * @param desc Description (not translated)
15
15
  */
16
16
  constructor(date: HDate, desc: string, mask: number, eventTime: Date, location: Location, linkedEvent?: Event, options?: CalOptions);
17
17
  /**
18
- * @param {string} [locale] Optional locale name (defaults to active locale).
19
- * @return {string}
18
+ * @param [locale] Optional locale name (defaults to active locale).
20
19
  */
21
20
  render(locale?: string): string;
22
21
  /**
23
22
  * Returns translation of "Candle lighting" without the time.
24
- * @param {string} [locale] Optional locale name (defaults to active locale).
25
- * @return {string}
23
+ * @param [locale] Optional locale name (defaults to active locale).
26
24
  */
27
25
  renderBrief(locale?: string): string;
28
- /** @return {string[]} */
29
26
  getCategories(): string[];
30
27
  }
31
28
  /** Candle lighting before Shabbat or holiday */
32
29
  export declare class CandleLightingEvent extends TimedEvent {
33
30
  constructor(date: HDate, mask: number, eventTime: Date, location: Location, linkedEvent?: Event, options?: CalOptions);
34
- /** @return {string} */
35
31
  getEmoji(): string;
36
32
  }
37
33
  /** Havdalah after Shabbat or holiday */
@@ -39,16 +35,13 @@ export declare class HavdalahEvent extends TimedEvent {
39
35
  private readonly havdalahMins?;
40
36
  constructor(date: HDate, mask: number, eventTime: Date, location: Location, havdalahMins?: number, linkedEvent?: Event, options?: CalOptions);
41
37
  /**
42
- * @param {string} [locale] Optional locale name (defaults to active locale).
43
- * @return {string}
38
+ * @param [locale] Optional locale name (defaults to active locale).
44
39
  */
45
40
  render(locale?: string): string;
46
41
  /**
47
42
  * Returns translation of "Havdalah" without the time.
48
- * @param {string} [locale] Optional locale name (defaults to active locale).
49
- * @return {string}
43
+ * @param [locale] Optional locale name (defaults to active locale).
50
44
  */
51
45
  renderBrief(locale?: string): string;
52
- /** @return {string} */
53
46
  getEmoji(): string;
54
47
  }
@@ -7,22 +7,18 @@ export declare class YomKippurKatanEvent extends HolidayEvent {
7
7
  private readonly nextMonthName;
8
8
  /**
9
9
  * @private
10
- * @param {HDate} date Hebrew date event occurs
11
- * @param {string} nextMonthName name of the upcoming month
10
+ * @param date Hebrew date event occurs
11
+ * @param nextMonthName name of the upcoming month
12
12
  */
13
13
  constructor(date: HDate, nextMonthName: string);
14
- /** @return {string} */
15
14
  basename(): string;
16
15
  /**
17
- * @param {string} [locale] Optional locale name (defaults to active locale).
18
- * @return {string}
16
+ * @param [locale] Optional locale name (defaults to active locale).
19
17
  */
20
18
  render(locale?: string): string;
21
19
  /**
22
- * @param {string} [locale] Optional locale name (defaults to active locale).
23
- * @return {string}
20
+ * @param [locale] Optional locale name (defaults to active locale).
24
21
  */
25
22
  renderBrief(locale?: string): string;
26
- /** @return {string | undefined} */
27
23
  url(): string | undefined;
28
24
  }