@hebcal/core 6.6.0 → 6.7.0

package/dist/src/candles.d.ts

@@ -1,57 +0,0 @@
-import { HDate } from '@hebcal/hdate';
-import { CalOptions } from './CalOptions';
-import { Location } from './location';
-import { Event } from './event';
-import { ChanukahEvent, HolidayEvent } from './HolidayEvent';
-import { TimedEvent } from './TimedEvent';
-/**
- * @private
- */
-export declare function makeCandleEvent(ev: Event | undefined, hd: HDate, options: CalOptions, isFriday: boolean, isSaturday: boolean): TimedEvent | undefined;
-/**
- * A fast day holiday with attached start and end time events.
- *
- * Wraps an underlying fast-day {@link HolidayEvent} and (when computable
- * for the given location) exposes a "Fast begins" and "Fast ends"
- * {@link TimedEvent}. Generated by {@link HebrewCalendar.calendar} when
- * `options.candlelighting` is `true` and `options.location` is provided.
- *
- * - Minor fasts begin at *Alot HaShachar* (16.1° below horizon in the morning)
- *   and end at tzeit (7.083° by default — overridable via `options.fastEndDeg`).
- * - Tish'a B'Av begins at sunset on the previous day and ends at tzeit.
- * - When a minor fast falls on a Friday, the end time is suppressed
- *   (Shabbat begins before nightfall).
- */
-export declare class FastDayEvent extends HolidayEvent {
-    /** original event */
-    readonly linkedEvent: HolidayEvent;
-    /** this will be a "Fast begins" event */
-    readonly startEvent?: TimedEvent;
-    /** this will be a "Fast ends" event */
-    readonly endEvent?: TimedEvent;
-    constructor(linkedEvent: HolidayEvent, startEvent?: TimedEvent, endEvent?: TimedEvent);
-    render(locale?: string): string;
-    renderBrief(locale?: string): string;
-    urlDateSuffix(): string;
-    url(): string | undefined;
-    getEmoji(): string;
-    getCategories(): string[];
-}
-/**
- * Makes a pair of events representing fast start and end times
- * @private
- */
-export declare function makeFastStartEnd(ev: HolidayEvent, options: CalOptions): FastDayEvent;
-export declare class TimedChanukahEvent extends ChanukahEvent {
-    eventTime: Date;
-    eventTimeStr: string;
-    readonly location: Location;
-    constructor(ev: ChanukahEvent, eventTime: Date, location: Location);
-}
-/**
- * Makes a candle-lighting event for Chankah (not on Friday/Saturday).
- * At one point this used civil dusk (6 degrees below horizon).
- * Another source suggests 4.6667 degrees below horizon.
- * @private
- */
-export declare function makeWeekdayChanukahCandleLighting(ev: ChanukahEvent, options: CalOptions): TimedChanukahEvent | null;

package/dist/src/candles.js

@@ -1,185 +0,0 @@
-import { months } from '@hebcal/hdate';
-import { flags } from './event';
-import { ChanukahEvent, HolidayEvent } from './HolidayEvent';
-import { Zmanim } from './zmanim';
-import { TimedEvent, CandleLightingEvent, HavdalahEvent } from './TimedEvent';
-import { holidayDesc as hdesc } from './staticHolidays';
-const LIGHT_CANDLES = flags.LIGHT_CANDLES;
-const LIGHT_CANDLES_TZEIS = flags.LIGHT_CANDLES_TZEIS;
-/**
- * @private
- */
-export function makeCandleEvent(ev, hd, options, isFriday, isSaturday) {
-    let havdalahTitle = false;
-    let useHavdalahOffset = isSaturday;
-    let mask = ev ? ev.getFlags() : LIGHT_CANDLES;
-    if (ev !== undefined) {
-        // if linked event && dow == FRI, use Candle lighting time & title
-        if (!isFriday) {
-            if (mask & (LIGHT_CANDLES_TZEIS | flags.CHANUKAH_CANDLES)) {
-                useHavdalahOffset = true;
-            }
-            else if (mask & flags.YOM_TOV_ENDS) {
-                havdalahTitle = true;
-                useHavdalahOffset = true;
-            }
-        }
-    }
-    else if (isSaturday) {
-        havdalahTitle = true;
-        mask = LIGHT_CANDLES_TZEIS;
-    }
-    // if Havdalah offset is 0 or undefined, we'll use tzeit time
-    const offset = useHavdalahOffset
-        ? Number(options.havdalahMins)
-        : Number(options.candleLightingMins);
-    const location = options.location;
-    const useElevation = Boolean(options.useElevation);
-    const zmanim = new Zmanim(location, hd, useElevation);
-    const time = useHavdalahOffset && !offset
-        ? zmanim.tzeit(options.havdalahDeg)
-        : zmanim.sunsetOffset(offset, true);
-    if (isNaN(time.getTime())) {
-        return undefined; // no sunset
-    }
-    if (havdalahTitle) {
-        return new HavdalahEvent(hd, mask, time, location, options.havdalahMins, ev, options);
-    }
-    else {
-        mask |= LIGHT_CANDLES;
-        return new CandleLightingEvent(hd, mask, time, location, ev, options);
-    }
-}
-const FAST_BEGINS = hdesc.FAST_BEGINS;
-const FAST_ENDS = hdesc.FAST_ENDS;
-/**
- * A fast day holiday with attached start and end time events.
- *
- * Wraps an underlying fast-day {@link HolidayEvent} and (when computable
- * for the given location) exposes a "Fast begins" and "Fast ends"
- * {@link TimedEvent}. Generated by {@link HebrewCalendar.calendar} when
- * `options.candlelighting` is `true` and `options.location` is provided.
- *
- * - Minor fasts begin at *Alot HaShachar* (16.1° below horizon in the morning)
- *   and end at tzeit (7.083° by default — overridable via `options.fastEndDeg`).
- * - Tish'a B'Av begins at sunset on the previous day and ends at tzeit.
- * - When a minor fast falls on a Friday, the end time is suppressed
- *   (Shabbat begins before nightfall).
- */
-export class FastDayEvent extends HolidayEvent {
-    /** original event */
-    linkedEvent;
-    /** this will be a "Fast begins" event */
-    startEvent;
-    /** this will be a "Fast ends" event */
-    endEvent;
-    constructor(linkedEvent, startEvent, endEvent) {
-        super(linkedEvent.getDate(), linkedEvent.getDesc(), linkedEvent.getFlags());
-        this.linkedEvent = linkedEvent;
-        this.startEvent = startEvent;
-        this.endEvent = endEvent;
-    }
-    render(locale) {
-        return this.linkedEvent.render(locale);
-    }
-    renderBrief(locale) {
-        return this.linkedEvent.renderBrief(locale);
-    }
-    urlDateSuffix() {
-        return this.linkedEvent.urlDateSuffix();
-    }
-    url() {
-        return this.linkedEvent.url();
-    }
-    getEmoji() {
-        return this.linkedEvent.getEmoji();
-    }
-    getCategories() {
-        return this.linkedEvent.getCategories();
-    }
-}
-/**
- * Makes a pair of events representing fast start and end times
- * @private
- */
-export function makeFastStartEnd(ev, options) {
-    const desc = ev.getDesc();
-    if (desc === 'Yom Kippur') {
-        throw new RangeError('YK does not require this function');
-    }
-    const hd = ev.getDate();
-    const dt = hd.greg();
-    const location = options.location;
-    const fastEndDeg = options.fastEndDeg;
-    const useElevation = Boolean(options.useElevation);
-    const zmanim = new Zmanim(location, dt, useElevation);
-    let startEvent;
-    let endEvent;
-    if (desc === "Erev Tish'a B'Av") {
-        const sunset = zmanim.sunset();
-        if (!isNaN(sunset.getTime())) {
-            startEvent = makeTimedEvent(ev, sunset, FAST_BEGINS, options);
-        }
-    }
-    else if (desc.startsWith("Tish'a B'Av")) {
-        const tzeit = zmanim.tzeit(fastEndDeg);
-        if (!isNaN(tzeit.getTime())) {
-            endEvent = makeTimedEvent(ev, tzeit, FAST_ENDS, options);
-        }
-    }
-    else {
-        const dawn = zmanim.alotHaShachar();
-        if (!isNaN(dawn.getTime())) {
-            startEvent = makeTimedEvent(ev, dawn, FAST_BEGINS, options);
-        }
-        if (dt.getDay() !== 5 &&
-            !(hd.getDate() === 14 && hd.getMonth() === months.NISAN)) {
-            const tzeit = zmanim.tzeit(fastEndDeg);
-            if (!isNaN(tzeit.getTime())) {
-                endEvent = makeTimedEvent(ev, tzeit, FAST_ENDS, options);
-            }
-        }
-    }
-    const ev2 = new FastDayEvent(ev, startEvent, endEvent);
-    // copy properties such as memo or emoji
-    Object.assign(ev2, ev);
-    return ev2;
-}
-/**
- * @private
- */
-function makeTimedEvent(ev, time, desc, options) {
-    const location = options.location;
-    const hd = ev.getDate();
-    return new TimedEvent(hd, desc, ev.getFlags(), time, location, ev, options);
-}
-export class TimedChanukahEvent extends ChanukahEvent {
-    eventTime;
-    eventTimeStr;
-    location;
-    constructor(ev, eventTime, location) {
-        super(ev.getDate(), ev.getDesc(), ev.getFlags(), ev.chanukahDay);
-        this.eventTime = Zmanim.roundTime(eventTime);
-        const timeFormat = location.getTimeFormatter();
-        this.eventTimeStr = Zmanim.formatTime(this.eventTime, timeFormat);
-        this.location = location;
-        this.emoji = ev.emoji;
-    }
-}
-/**
- * Makes a candle-lighting event for Chankah (not on Friday/Saturday).
- * At one point this used civil dusk (6 degrees below horizon).
- * Another source suggests 4.6667 degrees below horizon.
- * @private
- */
-export function makeWeekdayChanukahCandleLighting(ev, options) {
-    const hd = ev.getDate();
-    const location = options.location;
-    const useElevation = Boolean(options.useElevation);
-    const zmanim = new Zmanim(location, hd.greg(), useElevation);
-    const candleLightingTime = zmanim.beinHaShmashos();
-    if (isNaN(candleLightingTime.getTime())) {
-        return null;
-    }
-    return new TimedChanukahEvent(ev, candleLightingTime, location);
-}

package/dist/src/cities.json

@@ -1,67 +0,0 @@
-[
-    "Ashdod|IL|31.79213|34.64966|Asia/Jerusalem|27",
-    "Atlanta|US|33.749|-84.38798|America/New_York|336",
-    "Austin|US|30.26715|-97.74306|America/Chicago|165",
-    "Baghdad|IQ|33.34058|44.40088|Asia/Baghdad|41",
-    "Beer Sheva|IL|31.25181|34.7913|Asia/Jerusalem|285",
-    "Berlin|DE|52.52437|13.41053|Europe/Berlin|43",
-    "Baltimore|US|39.29038|-76.61219|America/New_York|35",
-    "Bogota|CO|4.60971|-74.08175|America/Bogota|2582",
-    "Boston|US|42.35843|-71.05977|America/New_York|38",
-    "Budapest|HU|47.49801|19.03991|Europe/Budapest|104",
-    "Buenos Aires|AR|-34.61315|-58.37723|America/Argentina/Buenos_Aires|31",
-    "Buffalo|US|42.88645|-78.87837|America/New_York|191",
-    "Chicago|US|41.85003|-87.65005|America/Chicago|180",
-    "Cincinnati|US|39.162|-84.45689|America/New_York|267",
-    "Cleveland|US|41.4995|-81.69541|America/New_York|204",
-    "Dallas|US|32.78306|-96.80667|America/Chicago|139",
-    "Denver|US|39.73915|-104.9847|America/Denver|1636",
-    "Detroit|US|42.33143|-83.04575|America/Detroit|192",
-    "Eilat|IL|29.55805|34.94821|Asia/Jerusalem|63",
-    "Gibraltar|GI|36.14474|-5.35257|Europe/Gibraltar|11",
-    "Haifa|IL|32.81841|34.9885|Asia/Jerusalem|40",
-    "Hawaii|US|21.30694|-157.85833|Pacific/Honolulu|18",
-    "Helsinki|FI|60.16952|24.93545|Europe/Helsinki|26",
-    "Houston|US|29.76328|-95.36327|America/Chicago|30",
-    "Jerusalem|IL|31.76904|35.21633|Asia/Jerusalem|786",
-    "Johannesburg|ZA|-26.20227|28.04363|Africa/Johannesburg|1767",
-    "Kiev|UA|50.45466|30.5238|Europe/Kiev|187",
-    "La Paz|BO|-16.5|-68.15|America/La_Paz|3782",
-    "Livingston|US|40.79593|-74.31487|America/New_York|98",
-    "Las Vegas|US|36.17497|-115.13722|America/Los_Angeles|613",
-    "London|GB|51.50853|-0.12574|Europe/London|25",
-    "Los Angeles|US|34.05223|-118.24368|America/Los_Angeles|96",
-    "Marseilles|FR|43.29695|5.38107|Europe/Paris|28",
-    "Miami|US|25.77427|-80.19366|America/New_York|25",
-    "Minneapolis|US|44.97997|-93.26384|America/Chicago|262",
-    "Melbourne|AU|-37.814|144.96332|Australia/Melbourne|25",
-    "Mexico City|MX|19.42847|-99.12766|America/Mexico_City|2240",
-    "Montreal|CA|45.50884|-73.58781|America/Toronto|216",
-    "Moscow|RU|55.75222|37.61556|Europe/Moscow|144",
-    "New York|US|40.71427|-74.00597|America/New_York|57",
-    "Omaha|US|41.25861|-95.93779|America/Chicago|315",
-    "Ottawa|CA|45.41117|-75.69812|America/Toronto|71",
-    "Panama City|PA|8.9936|-79.51973|America/Panama|17",
-    "Paris|FR|48.85341|2.3488|Europe/Paris|42",
-    "Pawtucket|US|41.87871|-71.38256|America/New_York|0",
-    "Petach Tikvah|IL|32.08707|34.88747|Asia/Jerusalem|54",
-    "Philadelphia|US|39.95233|-75.16379|America/New_York|8",
-    "Phoenix|US|33.44838|-112.07404|America/Phoenix|366",
-    "Pittsburgh|US|40.44062|-79.99589|America/New_York|239",
-    "Providence|US|41.82399|-71.41283|America/New_York|0",
-    "Portland|US|45.52345|-122.67621|America/Los_Angeles|15",
-    "Saint Louis|US|38.62727|-90.19789|America/Chicago|149",
-    "Saint Petersburg|RU|59.93863|30.31413|Europe/Moscow|11",
-    "San Diego|US|32.71533|-117.15726|America/Los_Angeles|20",
-    "San Francisco|US|37.77493|-122.41942|America/Los_Angeles|28",
-    "Sao Paulo|BR|-23.5475|-46.63611|America/Sao_Paulo|769",
-    "Seattle|US|47.60621|-122.33207|America/Los_Angeles|56",
-    "Sydney|AU|-33.86785|151.20732|Australia/Sydney|58",
-    "Tel Aviv|IL|32.08088|34.78057|Asia/Jerusalem|15",
-    "Tiberias|IL|32.79221|35.53124|Asia/Jerusalem|0",
-    "Toronto|CA|43.70011|-79.4163|America/Toronto|175",
-    "Vancouver|CA|49.24966|-123.11934|America/Vancouver|70",
-    "White Plains|US|41.03399|-73.76291|America/New_York|82",
-    "Washington DC|US|38.89511|-77.03637|America/New_York|6",
-    "Worcester|US|42.26259|-71.80229|America/New_York|164"
-]

package/dist/src/event.d.ts

@@ -1,233 +0,0 @@
-import { HDate } from '@hebcal/hdate';
-import './locale';
-/**
- * Holiday flags for Event. These flags are typically
- * combined using bitwise arithmetic to form a mask.
- * @readonly
- * @enum {number}
- */
-export declare const flags: {
-    /** Chag, yontiff, yom tov */
-    readonly CHAG: 1;
-    /** Light candles 18 minutes before sundown */
-    readonly LIGHT_CANDLES: 2;
-    /** End of holiday (end of Yom Tov)  */
-    readonly YOM_TOV_ENDS: 4;
-    /** Observed only in the Diaspora (chutz l'aretz)  */
-    readonly CHUL_ONLY: 8;
-    /** Observed only in Israel */
-    readonly IL_ONLY: 16;
-    /** Light candles in the evening at Tzeit time (3 small stars) */
-    readonly LIGHT_CANDLES_TZEIS: 32;
-    /** Candle-lighting for Chanukah */
-    readonly CHANUKAH_CANDLES: 64;
-    /** Rosh Chodesh, beginning of a new Hebrew month */
-    readonly ROSH_CHODESH: 128;
-    /** Minor fasts like Tzom Tammuz, Ta'anit Esther, ... */
-    readonly MINOR_FAST: 256;
-    /** Shabbat Shekalim, Zachor, ... */
-    readonly SPECIAL_SHABBAT: 512;
-    /** Weekly sedrot on Saturdays */
-    readonly PARSHA_HASHAVUA: 1024;
-    /** Daily page of Talmud (Bavli) */
-    readonly DAF_YOMI: 2048;
-    /** Days of the Omer */
-    readonly OMER_COUNT: 4096;
-    /** Yom HaShoah, Yom HaAtzma'ut, ... */
-    readonly MODERN_HOLIDAY: 8192;
-    /** Yom Kippur and Tish'a B'Av */
-    readonly MAJOR_FAST: 16384;
-    /** On the Saturday before Rosh Chodesh */
-    readonly SHABBAT_MEVARCHIM: 32768;
-    /** Molad */
-    readonly MOLAD: 65536;
-    /** Yahrzeit or Hebrew Anniversary */
-    readonly USER_EVENT: 131072;
-    /** Daily Hebrew date ("11th of Sivan, 5780") */
-    readonly HEBREW_DATE: 262144;
-    /** A holiday that's not major, modern, rosh chodesh, or a fast day */
-    readonly MINOR_HOLIDAY: 524288;
-    /** Evening before a major or minor holiday */
-    readonly EREV: 1048576;
-    /** Chol haMoed, intermediate days of Pesach or Sukkot */
-    readonly CHOL_HAMOED: 2097152;
-    /** Mishna Yomi */
-    readonly MISHNA_YOMI: 4194304;
-    /** Yom Kippur Katan, minor day of atonement on the day preceeding each Rosh Chodesh */
-    readonly YOM_KIPPUR_KATAN: 8388608;
-    /** Daily page of Jerusalem Talmud (Yerushalmi) */
-    readonly YERUSHALMI_YOMI: 16777216;
-    /** Nach Yomi */
-    readonly NACH_YOMI: 33554432;
-    /** Daily Learning */
-    readonly DAILY_LEARNING: 67108864;
-    /** Yizkor */
-    readonly YIZKOR: 134217728;
-    /** BeHaB fast days on Monday, Thursday and Monday after Pesach and Sukkot */
-    readonly BEHAB: 268435456;
-};
-/**
- * Represents an Event with a title, date, and flags.
- *
- * Events are used to represent holidays, candle-lighting times,
- * Torah readings, Omer days, Hebrew dates, and more. Most concrete event
- * types are subclasses (e.g. {@link HolidayEvent}, {@link TimedEvent},
- * {@link ParshaEvent}, {@link OmerEvent}) and are produced by
- * {@link HebrewCalendar.calendar}.
- *
- * To get the title of the event in a language other than English with
- * Sephardic transliterations, use the {@link Event.render} method.
- *
- * @example
- * import {Event, HDate, flags} from '@hebcal/core';
- * const ev = new Event(new HDate(6, 'Sivan', 5749), 'Shavuot', flags.CHAG);
- * ev.getDate().toString(); // '6 Sivan 5749'
- * ev.getDesc();             // 'Shavuot'
- * ev.render('he');          // 'שָׁבוּעוֹת'
- */
-export declare class Event {
-    /** Hebrew date of this event */
-    readonly date: HDate;
-    /**
-     * Untranslated title of this event. Note that these description
-     * strings are always in English and will remain stable across releases.
-     * To get the title of the event in another language, use the
-     * `render()` method.
-     */
-    readonly desc: string;
-    /** Bitmask of optional event flags. See {@link flags} */
-    readonly mask: number;
-    /** Optional emoji character such as ✡️, 🕯️, 🕎, 🕍, 🌒 */
-    emoji?: string;
-    /** Optional longer description or memo text */
-    memo?: string;
-    /** Alarms are used by iCalendar feeds */
-    alarm?: Date | string | boolean;
-    /**
-     * Constructs Event
-     * @param date Hebrew date event occurs
-     * @param desc Description (not translated)
-     * @param [mask=0] optional bitmask of holiday flags (see {@link flags})
-     * @param [attrs={}] optional additional attributes (e.g. `eventTimeStr`, `cholHaMoedDay`)
-     */
-    constructor(date: HDate, desc: string, mask?: number, attrs?: object);
-    /**
-     * Hebrew date of this event
-     */
-    getDate(): HDate;
-    /**
-     * Gregorian date of this event
-     */
-    greg(): Date;
-    /**
-     * Untranslated title of this event. Note that these description
-     * strings are always in English and will remain stable across releases.
-     * To get the title of the event in another language, use the
-     * `render()` method.
-     */
-    getDesc(): string;
-    /**
-     * Bitmask of optional event flags. See {@link flags}
-     */
-    getFlags(): number;
-    /**
-     * Returns (translated) description of this event
-     * @example
-     * const ev = new Event(new HDate(6, 'Sivan', 5749), 'Shavuot', flags.CHAG);
-     * ev.render('en'); // 'Shavuot'
-     * ev.render('he'); // 'שָׁבוּעוֹת'
-     * ev.render('ashkenazi'); // 'Shavuos'
-     * @param [locale] Optional locale name (defaults to empty locale)
-     */
-    render(locale?: string): string;
-    /**
-     * Returns a brief (translated) description of this event.
-     *
-     * For most events this is the same as {@link render}. Some subclasses
-     * (e.g. {@link CandleLightingEvent}, {@link HavdalahEvent},
-     * {@link OmerEvent}) produce shorter text without an attached time or
-     * extra qualifier — useful for compact UI display.
-     * @example
-     * import {CandleLightingEvent} from '@hebcal/core';
-     * // For a regular Event, renderBrief() == render():
-     * const ev = new Event(new HDate(6, 'Sivan', 5749), 'Shavuot', flags.CHAG);
-     * ev.renderBrief('en'); // 'Shavuot'
-     * @param [locale] Optional locale name (defaults to empty locale)
-     */
-    renderBrief(locale?: string): string;
-    /**
-     * Returns the event's emoji character (e.g. `🕯️`, `🕎`, `🇮🇱`, `🍏🍯`),
-     * or `null` if no emoji is associated with this event.
-     * Subclasses override this to provide holiday-specific emoji.
-     */
-    getEmoji(): string | null;
-    /**
-     * Returns a simplified (untranslated) description for this event, suitable
-     * for grouping related events under a single name.
-     *
-     * For example, {@link HolidayEvent} strips qualifiers so that
-     * `"Erev Pesach"` → `"Pesach"` and `"Sukkot III (CH''M)"` → `"Sukkot"`.
-     * For many events the basename and the event description are identical.
-     * @example
-     * import {HolidayEvent, HDate, months, flags} from '@hebcal/core';
-     * const ev = new HolidayEvent(
-     *   new HDate(14, months.NISAN, 5784), 'Erev Pesach', flags.EREV);
-     * ev.getDesc();    // 'Erev Pesach'
-     * ev.basename();   // 'Pesach'
-     */
-    basename(): string;
-    /**
-     * Returns a URL to hebcal.com or sefaria.org for more detail on the event,
-     * or `undefined` for events with no detail page.
-     *
-     * Subclasses such as {@link HolidayEvent}, {@link ChanukahEvent},
-     * {@link AsaraBTevetEvent}, {@link ParshaEvent}, and {@link OmerEvent}
-     * override this with their own URL patterns.
-     */
-    url(): string | undefined;
-    /**
-     * Is this event observed in Israel?
-     * @example
-     * const ev1 = new Event(new HDate(7, 'Sivan', 5749), 'Shavuot II', flags.CHAG | flags.CHUL_ONLY);
-     * ev1.observedInIsrael(); // false
-     * const ev2 = new Event(new HDate(26, 'Kislev', 5749), 'Chanukah: 3 Candles', 0);
-     * ev2.observedInIsrael(); // true
-     */
-    observedInIsrael(): boolean;
-    /**
-     * Is this event observed in the Diaspora?
-     * @example
-     * const ev1 = new Event(new HDate(7, 'Sivan', 5749), 'Shavuot II', flags.CHAG | flags.CHUL_ONLY);
-     * ev1.observedInDiaspora(); // true
-     * const ev2 = new Event(new HDate(26, 'Kislev', 5749), 'Chanukah: 3 Candles', 0);
-     * ev2.observedInDiaspora(); // true
-     */
-    observedInDiaspora(): boolean;
-    /**
-     * Is this event observed in Israel/Diaspora?
-     * @example
-     * const ev1 = new Event(new HDate(7, 'Sivan', 5749), 'Shavuot II', flags.CHAG | flags.CHUL_ONLY);
-     * ev1.observedIn(false); // true
-     * ev1.observedIn(true); // false
-     * const ev2 = new Event(new HDate(26, 'Kislev', 5749), 'Chanukah: 3 Candles', 0);
-     * ev2.observedIn(false); // true
-     * ev2.observedIn(true); // true
-     * @param il
-     */
-    observedIn(il: boolean): boolean;
-    /**
-     * Returns an array of category strings classifying this event, derived
-     * from its {@link flags} bitmask. The first element is the broad category
-     * (e.g. `'holiday'`, `'roshchodesh'`, `'parashat'`, `'omer'`), followed
-     * by zero or more refinements (e.g. `'major'`, `'minor'`, `'fast'`).
-     *
-     * Returns `['unknown']` if no flag maps to a known category.
-     * @example
-     * import {Event, HDate, flags} from '@hebcal/core';
-     * new Event(new HDate(10, 'Tishrei', 5784), 'Yom Kippur', flags.MAJOR_FAST)
-     *   .getCategories(); // ['holiday', 'major', 'fast']
-     * new Event(new HDate(1, 'Shvat', 5784), 'Rosh Chodesh Sh\'vat', flags.ROSH_CHODESH)
-     *   .getCategories(); // ['roshchodesh']
-     */
-    getCategories(): string[];
-}