@hebcal/core 5.7.2 → 5.7.3

package/dist/module.d.ts

@@ -1,1618 +0,0 @@
-import { HDate } from '@hebcal/hdate';
-export { HDate, Headers, Locale, LocaleData, StringArrayMap, gematriya, gematriyaStrToNum, greg, months } from '@hebcal/hdate';
-import { GeoLocation } from '@hebcal/noaa';
-export { GeoLocation, NOAACalculator } from '@hebcal/noaa';
-
-/** DO NOT EDIT THIS AUTO-GENERATED FILE! */
-declare const version = "5.7.2";
-
-/** Class representing Location */
-declare class Location extends GeoLocation {
-    private readonly il;
-    private readonly cc?;
-    private readonly geoid?;
-    /**
-     * Initialize a Location instance
-     * @param latitude - Latitude as a decimal, valid range -90 thru +90 (e.g. 41.85003)
-     * @param longitude - Longitude as a decimal, valid range -180 thru +180 (e.g. -87.65005)
-     * @param il - in Israel (true) or Diaspora (false)
-     * @param tzid - Olson timezone ID, e.g. "America/Chicago"
-     * @param [cityName] - optional descriptive city name
-     * @param [countryCode] - ISO 3166 alpha-2 country code (e.g. "FR")
-     * @param [geoid] - optional string or numeric geographic ID
-     * @param [elevation] - in meters (default `0`)
-     */
-    constructor(latitude: number, longitude: number, il: boolean, tzid: string, cityName?: string, countryCode?: string, geoid?: string | number, elevation?: number);
-    getIsrael(): boolean;
-    getName(): string | null;
-    /**
-     * Returns the location name, up to the first comma
-     */
-    getShortName(): string | null;
-    getCountryCode(): string | undefined;
-    getTzid(): string;
-    /**
-     * Gets a 24-hour time formatter (e.g. 07:41 or 20:03) for this location
-     */
-    getTimeFormatter(): Intl.DateTimeFormat;
-    getGeoId(): string | number | undefined;
-    /**
-     * Creates a location object from one of 60 "classic" Hebcal city names.
-     * The following city names are supported:
-     * 'Ashdod', 'Atlanta', 'Austin', 'Baghdad', 'Beer Sheva',
-     * 'Berlin', 'Baltimore', 'Bogota', 'Boston', 'Budapest',
-     * 'Buenos Aires', 'Buffalo', 'Chicago', 'Cincinnati', 'Cleveland',
-     * 'Dallas', 'Denver', 'Detroit', 'Eilat', 'Gibraltar', 'Haifa',
-     * 'Hawaii', 'Helsinki', 'Houston', 'Jerusalem', 'Johannesburg',
-     * 'Kiev', 'La Paz', 'Livingston', 'Las Vegas', 'London', 'Los Angeles',
-     * 'Marseilles', 'Miami', 'Minneapolis', 'Melbourne', 'Mexico City',
-     * 'Montreal', 'Moscow', 'New York', 'Omaha', 'Ottawa', 'Panama City',
-     * 'Paris', 'Pawtucket', 'Petach Tikvah', 'Philadelphia', 'Phoenix',
-     * 'Pittsburgh', 'Providence', 'Portland', 'Saint Louis', 'Saint Petersburg',
-     * 'San Diego', 'San Francisco', 'Sao Paulo', 'Seattle', 'Sydney',
-     * 'Tel Aviv', 'Tiberias', 'Toronto', 'Vancouver', 'White Plains',
-     * 'Washington DC', 'Worcester'
-     * @param name
-     */
-    static lookup(name: string): Location | undefined;
-    toString(): string;
-    /**
-     * Converts legacy Hebcal timezone to a standard Olson tzid.
-     * @param tz integer, GMT offset in hours
-     * @param dst 'none', 'eu', 'usa', or 'israel'
-     */
-    static legacyTzToTzid(tz: number, dst: string): string | undefined;
-    /**
-     * Converts timezone info from Zip-Codes.com to a standard Olson tzid.
-     * @example
-     * Location.getUsaTzid('AZ', 7, 'Y') // 'America/Denver'
-     * @param state two-letter all-caps US state abbreviation like 'CA'
-     * @param tz positive number, 5=America/New_York, 8=America/Los_Angeles
-     * @param dst single char 'Y' or 'N'
-     */
-    static getUsaTzid(state: string, tz: number, dst: string): string;
-    /**
-     * Adds a location name for `Location.lookup()` only if the name isn't
-     * already being used. Returns `false` if the name is already taken
-     * and `true` if successfully added.
-     */
-    static addLocation(cityName: string, location: Location): boolean;
-}
-
-type DailyLearningValue = boolean | number | string;
-/**
- * Options to configure which events are returned
- */
-type CalOptions = {
-    /**
-     * latitude/longitude/tzid used for candle-lighting
-     */
-    location?: Location;
-    /**
-     * Gregorian or Hebrew year
-     */
-    year?: number;
-    /**
-     * to interpret year as Hebrew year
-     */
-    isHebrewYear?: boolean;
-    /**
-     * Gregorian or Hebrew month (to filter results to a single month)
-     */
-    month?: number | string;
-    /**
-     * generate calendar for multiple years (default 1)
-     */
-    numYears?: number;
-    /**
-     * use specific start date (requires end date)
-     */
-    start?: number | HDate | Date;
-    /**
-     * use specific end date (requires start date)
-     */
-    end?: number | HDate | Date;
-    /**
-     * calculate candle-lighting and havdalah times
-     */
-    candlelighting?: boolean;
-    /**
-     * minutes before sundown to light candles (default 18)
-     */
-    candleLightingMins?: number;
-    /**
-     * minutes after sundown for Havdalah (typical values are 42, 50, or 72).
-     * If `undefined` (the default), calculate Havdalah according to Tzeit Hakochavim -
-     * Nightfall (the point when 3 small stars are observable in the night time sky with
-     * the naked eye). If `0`, Havdalah times are suppressed.
-     */
-    havdalahMins?: number;
-    /**
-     * degrees for solar depression for Havdalah.
-     * Default is 8.5 degrees for 3 small stars. use 7.083 degrees for 3 medium-sized stars
-     * (observed by Dr. Baruch (Berthold) Cohn in his luach published in France in 1899).
-     * If `0`, Havdalah times are suppressed.
-     */
-    havdalahDeg?: number;
-    /**
-     * degrees for solar depression for end of fast days.
-     * Default is 7.083 degrees for 3 medium-sized stars. Other commonly-used values include
-     * 6.45 degrees, as calculated by Rabbi Yechiel Michel Tucazinsky.
-     */
-    fastEndDeg?: number;
-    /**
-     * use elevation for calculations (default `false`).
-     * If `true`, use elevation to affect the calculation of all sunrise/sunset based zmanim.
-     * Note: there are some zmanim such as degree-based zmanim that are driven by the amount
-     * of light in the sky and are not impacted by elevation.
-     * These zmanim intentionally do not support elevation adjustment.
-     */
-    useElevation?: boolean;
-    /**
-     * calculate parashah hashavua on Saturdays
-     */
-    sedrot?: boolean;
-    /**
-     * Israeli holiday and sedra schedule
-     */
-    il?: boolean;
-    /**
-     * suppress minor fasts
-     */
-    noMinorFast?: boolean;
-    /**
-     * suppress modern holidays
-     */
-    noModern?: boolean;
-    /**
-     * suppress Rosh Chodesh
-     */
-    noRoshChodesh?: boolean;
-    /**
-     * add Shabbat Mevarchim
-     */
-    shabbatMevarchim?: boolean;
-    /**
-     * suppress Special Shabbat
-     */
-    noSpecialShabbat?: boolean;
-    /**
-     * suppress regular holidays
-     */
-    noHolidays?: boolean;
-    /**
-     * include Days of the Omer
-     */
-    omer?: boolean;
-    /**
-     * include event announcing the molad
-     */
-    molad?: boolean;
-    /**
-     * use Ashkenazi transliterations for event titles (default Sephardi transliterations)
-     */
-    ashkenazi?: boolean;
-    /**
-     * translate event titles according to a locale
-     * Default value is `en`, also built-in are `he` and `ashkenazi`.
-     * Additional locales (such as `ru` or `fr`) are provided by the
-     * {@link https://github.com/hebcal/hebcal-locales @hebcal/locales} package
-     */
-    locale?: string;
-    /**
-     * print the Hebrew date for the entire date range
-     */
-    addHebrewDates?: boolean;
-    /**
-     * print the Hebrew date for dates with some events
-     */
-    addHebrewDatesForEvents?: boolean;
-    /**
-     * use bitmask from `flags` to filter events
-     */
-    mask?: number;
-    /**
-     * include Yom Kippur Katan (default `false`).
-     * יוֹם כִּפּוּר קָטָן is a minor day of atonement occurring monthly on the day preceeding each Rosh Chodesh.
-     * Yom Kippur Katan is omitted in Elul (on the day before Rosh Hashanah),
-     * Tishrei (Yom Kippur has just passed), Kislev (due to Chanukah)
-     * and Nisan (fasting not permitted during Nisan).
-     * When Rosh Chodesh occurs on Shabbat or Sunday, Yom Kippur Katan is observed on the preceding Thursday.
-     * See {@link https://en.wikipedia.org/wiki/Yom_Kippur_Katan#Practices Wikipedia Yom Kippur Katan practices}
-     */
-    yomKippurKatan?: boolean;
-    /**
-     * Whether to use 12-hour time (as opposed to 24-hour time).
-     * Possible values are `true` and `false`; the default is locale dependent.
-     */
-    hour12?: boolean;
-    /**
-     * map of options to enable daily study calendars
-     * such as `dafYomi`, `mishnaYomi`, `nachYomi` with value `true`. For `yerushalmi`
-     * the value should be a `number` for edition (`1` for Vilna, `2` for Schottenstein).
-     */
-    dailyLearning?: {
-        [x: string]: DailyLearningValue;
-    };
-};
-
-/**
- * Holiday flags for Event. These flags are typically
- * combined using bitwise arithmetic to form a mask.
- * @readonly
- * @enum {number}
- */
-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;
-};
-/**
- * Represents an Event with a title, date, and flags.
- *
- * Events are used to represent holidays, candle-lighting times,
- * Torah readings, and more.
- *
- * To get the title of the event a language other than English
- * with Sephardic transliterations, use the `render()` method.
- */
-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;
-    /**
-     * 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 active locale).
-     */
-    render(locale?: string): string;
-    /**
-     * Returns a brief (translated) description of this event.
-     * For most events, this is the same as render(). For some events, it procudes
-     * a shorter text (e.g. without a time or added description).
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    renderBrief(locale?: string): string;
-    /**
-     * Optional holiday-specific Emoji or `null`.
-     */
-    getEmoji(): string | null;
-    /**
-     * Returns a simplified (untranslated) description for this event. For example,
-     * the `HolidayEvent` class supports
-     * "Erev Pesach" => "Pesach", and "Sukkot III (CH''M)" => "Sukkot".
-     * For many holidays the basename and the event description are the same.
-     */
-    basename(): string;
-    /**
-     * Returns a URL to hebcal.com or sefaria.org for more detail on the event.
-     * Returns `undefined` for events with no detail page.
-     */
-    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;
-    /**
-     * Makes a clone of this Event object
-     * @deprecated
-     */
-    clone(): Event;
-    /**
-     * Returns a list of event categories
-     */
-    getCategories(): string[];
-}
-
-/** Daily Hebrew date ("11th of Sivan, 5780") */
-declare class HebrewDateEvent extends Event {
-    /**
-     * @param date
-     */
-    constructor(date: HDate);
-    /**
-     * @param [locale] Optional locale name (defaults to active locale).
-     * @example
-     * import {HDate, HebrewDateEvent, months} from '@hebcal/core';
-     *
-     * const hd = new HDate(15, months.CHESHVAN, 5769);
-     * const ev = new HebrewDateEvent(hd);
-     * console.log(ev.render('en')); // '15th of Cheshvan, 5769'
-     * console.log(ev.render('he')); // 'ט״ו חֶשְׁוָן תשס״ט'
-     */
-    render(locale?: string): string;
-    /**
-     * @private
-     * @param locale
-     */
-    private renderBriefHebrew;
-    /**
-     * @param [locale] Optional locale name (defaults to active locale).
-     * @example
-     * import {HDate, HebrewDateEvent, months} from '@hebcal/core';
-     *
-     * const hd = new HDate(15, months.CHESHVAN, 5769);
-     * const ev = new HebrewDateEvent(hd);
-     * console.log(ev.renderBrief()); // '15th of Cheshvan'
-     * console.log(ev.renderBrief('he')); // 'ט״ו חֶשְׁוָן'
-     */
-    renderBrief(locale?: string): string;
-}
-
-/**
- * Calculate halachic times (zmanim / זְמַנִּים) for a given day and location.
- * Calculations are available for tzeit / tzais (nightfall),
- * shkiah (sunset) and more.
- *
- * Zmanim are estimated using an algorithm published by the US National Oceanic
- * and Atmospheric Administration. The NOAA solar calculator is based on equations
- * from _Astronomical Algorithms_ by Jean Meeus.
- *
- * The sunrise and sunset results are theoretically accurate to within a minute for
- * locations between +/- 72° latitude, and within 10 minutes outside of those latitudes.
- * However, due to variations in atmospheric composition, temperature, pressure and
- * conditions, observed values may vary from calculations.
- * https://gml.noaa.gov/grad/solcalc/calcdetails.html
- *
- * @example
- * const {GeoLocation, Zmanim} = require('@hebcal/core');
- * const latitude = 41.822232;
- * const longitude = -71.448292;
- * const tzid = 'America/New_York';
- * const friday = new Date(2023, 8, 8);
- * const gloc = new GeoLocation(null, latitude, longitude, 0, tzid);
- * const zmanim = new Zmanim(gloc, friday, false);
- * const candleLighting = zmanim.sunsetOffset(-18, true);
- * const timeStr = Zmanim.formatISOWithTimeZone(tzid, candleLighting);
- */
-declare class Zmanim {
-    private readonly date;
-    private readonly gloc;
-    private readonly noaa;
-    private useElevation;
-    /**
-     * Initialize a Zmanim instance.
-     * @param gloc GeoLocation including latitude, longitude, and timezone
-     * @param date Regular or Hebrew Date. If `date` is a regular `Date`,
-     *    hours, minutes, seconds and milliseconds are ignored.
-     * @param useElevation use elevation for calculations (default `false`).
-     *    If `true`, use elevation to affect the calculation of all sunrise/sunset based
-     *    zmanim. Note: there are some zmanim such as degree-based zmanim that are driven
-     *    by the amount of light in the sky and are not impacted by elevation.
-     *    These zmanim intentionally do not support elevation adjustment.
-     */
-    constructor(gloc: GeoLocation, date: Date | HDate, useElevation: boolean);
-    /**
-     * Returns `true` if elevation adjustment is enabled
-     * for zmanim support elevation adjustment
-     */
-    getUseElevation(): boolean;
-    /**
-     * Enables or disables elevation adjustment for zmanim support elevation adjustment
-     * @param useElevation
-     */
-    setUseElevation(useElevation: boolean): void;
-    /**
-     * Convenience function to get the time when sun is above or below the horizon
-     * for a certain angle (in degrees).
-     * This function does not support elevation adjustment.
-     * @param angle
-     * @param rising
-     */
-    timeAtAngle(angle: number, rising: boolean): Date;
-    /**
-     * Upper edge of the Sun appears over the eastern horizon in the morning (0.833° above horizon)
-     * If elevation is enabled, this function will include elevation in the calculation.
-     */
-    sunrise(): Date;
-    /**
-     * Upper edge of the Sun appears over the eastern horizon in the morning (0.833° above horizon).
-     * This function does not support elevation adjustment.
-     */
-    seaLevelSunrise(): Date;
-    /**
-     * When the upper edge of the Sun disappears below the horizon (0.833° below horizon).
-     * If elevation is enabled, this function will include elevation in the calculation.
-     */
-    sunset(): Date;
-    /**
-     * When the upper edge of the Sun disappears below the horizon (0.833° below horizon).
-     * This function does not support elevation adjustment.
-     */
-    seaLevelSunset(): Date;
-    /**
-     * Civil dawn; Sun is 6° below the horizon in the morning.
-     * Because degree-based functions estimate the amount of light in the sky,
-     * the result is not impacted by elevation.
-     */
-    dawn(): Date;
-    /**
-     * Civil dusk; Sun is 6° below the horizon in the evening.
-     * Because degree-based functions estimate the amount of light in the sky,
-     * the result is not impacted by elevation.
-     */
-    dusk(): Date;
-    /**
-     * Returns sunset for the previous day.
-     * If elevation is enabled, this function will include elevation in the calculation.
-     */
-    gregEve(): Date;
-    /**
-     * @private
-     */
-    nightHour(): number;
-    /**
-     * Midday – Chatzot; Sunrise plus 6 halachic hours
-     */
-    chatzot(): Date;
-    /**
-     * Midnight – Chatzot; Sunset plus 6 halachic hours.
-     * If elevation is enabled, this function will include elevation in the calculation.
-     */
-    chatzotNight(): Date;
-    /**
-     * Dawn – Alot haShachar; Sun is 16.1° below the horizon in the morning.
-     * Because degree-based functions estimate the amount of light in the sky,
-     * the result is not impacted by elevation.
-     */
-    alotHaShachar(): Date;
-    /**
-     * Earliest talis & tefillin – Misheyakir; Sun is 11.5° below the horizon in the morning.
-     * Because degree-based functions estimate the amount of light in the sky,
-     * the result is not impacted by elevation.
-     */
-    misheyakir(): Date;
-    /**
-     * Earliest talis & tefillin – Misheyakir Machmir; Sun is 10.2° below the horizon in the morning.
-     * Because degree-based functions estimate the amount of light in the sky,
-     * the result is not impacted by elevation.
-     */
-    misheyakirMachmir(): Date;
-    /**
-     * Utility method for using elevation-aware sunrise/sunset
-     * @private
-     * @param hours
-     */
-    getShaahZmanisBasedZman(hours: number): Date;
-    /**
-     * Latest Shema (Gra); Sunrise plus 3 halachic hours, according to the Gra.
-     * If elevation is enabled, this function will include elevation in the calculation.
-     */
-    sofZmanShma(): Date;
-    /**
-     * Latest Shacharit (Gra); Sunrise plus 4 halachic hours, according to the Gra.
-     *
-     * This method returns the latest *zman tfila* (time to recite shema in the morning)
-     * that is 4 *shaos zmaniyos* (solar hours) after sunrise or sea level sunrise
-     * (depending on the `useElevation` setting), according
-     * to the [GRA](https://en.wikipedia.org/wiki/Vilna_Gaon).
-     *
-     * If elevation is enabled, this function will include elevation in the calculation.
-     */
-    sofZmanTfilla(): Date;
-    /**
-     * Returns an array with alot (Date) and ms in hour (number)
-     * @private
-     */
-    getTemporalHour72(forceSeaLevel: boolean): [Date, number];
-    /**
-     * Returns an array with alot (Date) and ms in hour (number)
-     * @private
-     */
-    getTemporalHourByDeg(angle: number): [Date, number];
-    /**
-     * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
-     * Based on the opinion of the MGA that the day is calculated from
-     * dawn being fixed 72 minutes before sea-level sunrise, and nightfall is fixed
-     * 72 minutes after sea-level sunset.
-     */
-    sofZmanShmaMGA(): Date;
-    /**
-     * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
-     * Based on the opinion of the MGA that the day is calculated from
-     * dawn to nightfall with both being 16.1° below the horizon.
-     */
-    sofZmanShmaMGA16Point1(): Date;
-    /**
-     * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
-     * Based on the opinion of the MGA that the day is calculated from
-     * dawn to nightfall with both being 19.8° below the horizon.
-     *
-     * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
-     * around the equinox / equilux which calculates to 19.8° below geometric zenith.
-     * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
-     */
-    sofZmanShmaMGA19Point8(): Date;
-    /**
-     * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham
-     */
-    sofZmanTfillaMGA(): Date;
-    /**
-     * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
-     * Based on the opinion of the MGA that the day is calculated from
-     * dawn to nightfall with both being 16.1° below the horizon.
-     */
-    sofZmanTfillaMGA16Point1(): Date;
-    /**
-     * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
-     * Based on the opinion of the MGA that the day is calculated from
-     * dawn to nightfall with both being 19.8° below the horizon.
-     *
-     * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
-     * around the equinox / equilux which calculates to 19.8° below geometric zenith.
-     * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
-     */
-    sofZmanTfillaMGA19Point8(): Date;
-    /**
-     * Earliest Mincha – Mincha Gedola (GRA); Sunrise plus 6.5 halachic hours.
-     * If elevation is enabled, this function will include elevation in the calculation.
-     *
-     * This method returns the latest mincha gedola, the earliest time one can pray mincha
-     * that is 6.5 shaos zmaniyos (solar hours) after sunrise or sea level sunrise
-     * (depending on the `useElevation` setting), according
-     * to the [GRA](https://en.wikipedia.org/wiki/Vilna_Gaon).
-     *
-     * The Ramba"m is of the opinion that it is better to delay *mincha* until
-     * *mincha ketana* while the Ra"sh, Tur, GRA and others are of the
-     * opinion that *mincha* can be prayed *lechatchila* starting at *mincha gedola*.
-     */
-    minchaGedola(): Date;
-    /**
-     * Earliest Mincha – Mincha Gedola (MGA); Sunrise plus 6.5 halachic hours.
-     * If elevation is enabled, this function will include elevation in the calculation.
-     *
-     * This method returns the time of *mincha gedola* according to the Magen Avraham
-     * with the day starting 72 minutes before sunrise and ending 72 minutes after sunset.
-     * This is the earliest time to pray *mincha*.
-     */
-    minchaGedolaMGA(): Date;
-    /**
-     * Preferable earliest time to recite Minchah – Mincha Ketana; Sunrise plus 9.5 halachic hours.
-     * If elevation is enabled, this function will include elevation in the calculation.
-     *
-     * This method returns *mincha ketana*, the preferred earliest time to pray *mincha* in the
-     * opinion of the [Rambam](https://en.wikipedia.org/wiki/Maimonides) and others,
-     * that is 9.5 *shaos zmaniyos* (solar hours) after sunrise or sea level sunrise
-     * (depending on the `useElevation` setting), according
-     * to the [GRA](https://en.wikipedia.org/wiki/Vilna_Gaon).
-     */
-    minchaKetana(): Date;
-    /**
-     * This method returns the time of *mincha ketana* according to the Magen Avraham
-     * with the day starting 72 minutes before sunrise and ending 72 minutes after sunset.
-     * This is the preferred earliest time to pray *mincha* according to the opinion of
-     * the [Rambam](https://en.wikipedia.org/wiki/Maimonides) and others.
-     *
-     * If elevation is enabled, this function will include elevation in the calculation.
-     */
-    minchaKetanaMGA(): Date;
-    /**
-     * Plag haMincha; Sunrise plus 10.75 halachic hours.
-     * If elevation is enabled, this function will include elevation in the calculation.
-     */
-    plagHaMincha(): Date;
-    /**
-     * @param [angle=8.5] optional time for solar depression.
-     *   Default is 8.5 degrees for 3 small stars, use 7.083 degrees for 3 medium-sized stars.
-     * Because degree-based functions estimate the amount of light in the sky,
-     * the result is not impacted by elevation.
-     */
-    tzeit(angle?: number): Date;
-    /**
-     * Alias for sunrise
-     */
-    neitzHaChama(): Date;
-    /**
-     * Alias for sunset
-     */
-    shkiah(): Date;
-    /**
-     * Rabbeinu Tam holds that bein hashmashos is a specific time
-     * between sunset and tzeis hakochavim.
-     * One opinion on how to calculate this time is that
-     * it is 13.5 minutes before tzies 7.083.
-     * Because degree-based functions estimate the amount of light in the sky,
-     * the result is not impacted by elevation.
-     */
-    beinHaShmashos(): Date;
-    /**
-     * Uses timeFormat to return a date like '20:34'
-     */
-    static formatTime(dt: Date, timeFormat: Intl.DateTimeFormat): string;
-    /**
-     * Discards seconds, rounding to nearest minute.
-     * @param dt
-     */
-    static roundTime(dt: Date): Date;
-    /**
-     * Get offset string (like "+05:00" or "-08:00") from tzid (like "Europe/Moscow")
-     * @param tzid
-     * @param date
-     */
-    static timeZoneOffset(tzid: string, date: Date): string;
-    /**
-     * Returns a string like "2022-04-01T13:06:00-11:00"
-     * @param tzid
-     * @param date
-     */
-    static formatISOWithTimeZone(tzid: string, date: Date): string;
-    /**
-     * Returns sunrise + `offset` minutes (either positive or negative).
-     * If elevation is enabled, this function will include elevation in the calculation
-     *  unless `forceSeaLevel` is `true`.
-     * @param offset minutes
-     * @param roundMinute round time to nearest minute (default true)
-     * @param forceSeaLevel use sea-level sunrise (default false)
-     */
-    sunriseOffset(offset: number, roundMinute?: boolean, forceSeaLevel?: boolean): Date;
-    /**
-     * Returns sunset + `offset` minutes (either positive or negative).
-     * If elevation is enabled, this function will include elevation in the calculation
-     *  unless `forceSeaLevel` is `true`.
-     * @param offset minutes
-     * @param roundMinute round time to nearest minute (default true)
-     * @param forceSeaLevel use sea-level sunset (default false)
-     */
-    sunsetOffset(offset: number, roundMinute?: boolean, forceSeaLevel?: boolean): Date;
-    /**
-     * Returns the Hebrew date relative to the specified location and Gregorian date,
-     * taking into consideration whether the time is before or after sunset.
-     *
-     * For example, if the given date and is `2024-09-22T10:35` (before sunset), and
-     * sunset for the specified location is **19:04**, then this function would
-     * return a Hebrew date of `19th of Elul, 5784`.
-     * If the given date is the same Gregorian day after sunset
-     * (for example `2024-09-22T20:07`), this function would return a
-     * Hebrew date of `20th of Elul, 5784`.
-     * @example
-     * const {GeoLocation, Zmanim, HDate} = require('@hebcal/core');
-     * const latitude = 48.85341;
-     * const longitude = 2.3488;
-     * const timezone = 'Europe/Paris';
-     * const gloc = new GeoLocation(null, latitude, longitude, 0, timezone);
-     * const before = Zmanim.makeSunsetAwareHDate(gloc, new Date('2024-09-22T17:38:46.123Z'), false);
-     * console.log(before.toString()); // '19 Elul 5784'
-     * const after = Zmanim.makeSunsetAwareHDate(gloc, new Date('2024-09-22T23:45:18.345Z'), false);
-     * console.log(after.toString()); // '20 Elul 5784'
-     */
-    static makeSunsetAwareHDate(gloc: GeoLocation, date: Date, useElevation: boolean): HDate;
-}
-
-/** An event that has an `eventTime` and `eventTimeStr` */
-declare class TimedEvent extends Event {
-    readonly eventTime: Date;
-    readonly location: Location;
-    readonly eventTimeStr: string;
-    readonly fmtTime: string;
-    readonly linkedEvent?: Event;
-    /**
-     * @param desc Description (not translated)
-     */
-    constructor(date: HDate, desc: string, mask: number, eventTime: Date, location: Location, linkedEvent?: Event, options?: CalOptions);
-    /**
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    render(locale?: string): string;
-    /**
-     * Returns translation of "Candle lighting" without the time.
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    renderBrief(locale?: string): string;
-    getCategories(): string[];
-}
-/** Candle lighting before Shabbat or holiday */
-declare class CandleLightingEvent extends TimedEvent {
-    constructor(date: HDate, mask: number, eventTime: Date, location: Location, linkedEvent?: Event, options?: CalOptions);
-    getEmoji(): string;
-}
-/** Havdalah after Shabbat or holiday */
-declare class HavdalahEvent extends TimedEvent {
-    private readonly havdalahMins?;
-    constructor(date: HDate, mask: number, eventTime: Date, location: Location, havdalahMins?: number, linkedEvent?: Event, options?: CalOptions);
-    /**
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    render(locale?: string): string;
-    /**
-     * Returns translation of "Havdalah" without the time.
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    renderBrief(locale?: string): string;
-    getEmoji(): string;
-}
-
-/** Represents a built-in holiday like Pesach, Purim or Tu BiShvat */
-declare class HolidayEvent extends Event {
-    /** During Sukkot or Pesach */
-    cholHaMoedDay?: number;
-    chanukahDay?: number;
-    /**
-     * `true` if the fast day was postponed a day to avoid Shabbat.
-     * - Tish'a B'Av postponed from the 9th to the 10th
-     * - Tzom Tammuz postponed from the 17th to the 18th
-     */
-    observed?: boolean;
-    basename(): string;
-    url(): string | undefined;
-    urlDateSuffix(): string;
-    getEmoji(): string;
-    getCategories(): string[];
-    /**
-     * Returns (translated) description of this event
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    render(locale?: string): string;
-    /**
-     * Returns a brief (translated) description of this event.
-     * For most events, this is the same as render(). For some events, it procudes
-     * a shorter text (e.g. without a time or added description).
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    renderBrief(locale?: string): string;
-    /**
-     * Makes a clone of this Event object
-     * @deprecated
-     */
-    clone(): HolidayEvent;
-}
-/**
- * Because Asara B'Tevet often occurs twice in the same Gregorian year,
- * we subclass HolidayEvent to override the `url()` method.
- */
-declare class AsaraBTevetEvent extends HolidayEvent {
-    urlDateSuffix(): string;
-}
-/** Represents Rosh Hashana, the Jewish New Year */
-declare class RoshHashanaEvent extends HolidayEvent {
-    private readonly hyear;
-    /**
-     * @private
-     * @param date Hebrew date event occurs
-     * @param hyear Hebrew year
-     * @param mask optional holiday flags
-     */
-    constructor(date: HDate, hyear: number, mask: number);
-    /**
-     * Returns (translated) description of this event
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    render(locale?: string): string;
-    getEmoji(): string;
-}
-/** Represents Rosh Chodesh, the beginning of a new month */
-declare class RoshChodeshEvent extends HolidayEvent {
-    /**
-     * Constructs Rosh Chodesh event
-     * @param date Hebrew date event occurs
-     * @param monthName Hebrew month name (not translated)
-     */
-    constructor(date: HDate, monthName: string);
-    /**
-     * Returns (translated) description of this event
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    render(locale?: string): string;
-    basename(): string;
-    getEmoji(): string;
-}
-
-/** A fast day also contains a start and end time */
-declare class FastDayEvent extends HolidayEvent {
-    /** this will be a "Fast begins" event */
-    readonly startEvent?: TimedEvent;
-    /** this will be a "Fast ends" event */
-    readonly endEvent?: TimedEvent;
-    constructor(date: HDate, desc: string, mask: number, startEvent?: TimedEvent, endEvent?: TimedEvent);
-    urlDateSuffix(): string;
-}
-
-/**
- * Represents a molad, the moment when the new moon is "born"
- */
-declare class Molad {
-    private readonly m;
-    /**
-     * Calculates the molad for a Hebrew month
-     * @param year
-     * @param month
-     */
-    constructor(year: number, month: number);
-    /**
-     */
-    getYear(): number;
-    /**
-     */
-    getMonth(): number;
-    /**
-     */
-    getMonthName(): string;
-    /**
-     * @returns Day of Week (0=Sunday, 6=Saturday)
-     */
-    getDow(): number;
-    /**
-     * @returns hour of day (0-23)
-     */
-    getHour(): number;
-    /**
-     * @returns minutes past hour (0-59)
-     */
-    getMinutes(): number;
-    /**
-     * @returns parts of a minute (0-17)
-     */
-    getChalakim(): number;
-    /**
-     * @param [locale] Optional locale name (defaults to active locale)
-     * @param options
-     */
-    render(locale?: string, options?: CalOptions): string;
-}
-/** Represents a Molad announcement on Shabbat Mevarchim */
-declare class MoladEvent extends Event {
-    readonly molad: Molad;
-    private readonly options;
-    /**
-     * @param date Hebrew date event occurs
-     * @param hyear molad year
-     * @param hmonth molad month
-     * @param options
-     */
-    constructor(date: HDate, hyear: number, hmonth: number, options: CalOptions);
-    /**
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    render(locale?: string): string;
-}
-
-/** Represents a day 1-49 of counting the Omer from Pesach to Shavuot */
-declare class OmerEvent extends Event {
-    private readonly weekNumber;
-    private readonly daysWithinWeeks;
-    readonly omer: number;
-    emoji?: string;
-    /**
-     * @param date
-     * @param omerDay
-     */
-    constructor(date: HDate, omerDay: number);
-    /**
-     * @param lang
-     */
-    sefira(lang?: string): string;
-    /**
-     * @todo use gettext()
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    render(locale?: string): string;
-    /**
-     * Returns translation of "Omer day 22" without ordinal numbers.
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    renderBrief(locale?: string): string;
-    getEmoji(): string;
-    getWeeks(): number;
-    getDaysWithinWeeks(): number;
-    /**
-     * @param locale
-     */
-    getTodayIs(locale: string): string;
-    url(): string;
-}
-
-/**
- * Is *tachanun* said today?
- */
-type TachanunResult = {
-    /** Tachanun is said at Shacharit */
-    shacharit: boolean;
-    /** Tachanun is said at Mincha */
-    mincha: boolean;
-    /** All congregations say Tachanun on the day */
-    allCongs: boolean;
-};
-
-/** The result from `Sedra.lookup()` */
-type SedraResult = {
-    /**
-     * Name of the parsha (or parshiyot) read on
-     * Hebrew date, e.g. `['Noach']` or `['Matot', 'Masei']`
-     */
-    parsha: string[];
-    /**
-     * True if this is a regular parasha HaShavua
-     * Torah reading, false if it's a special holiday reading
-     */
-    chag: boolean;
-    /**
-     * The parsha number (or numbers) using 1-indexing.
-     * A `number` for a regular (single) parsha, and a `number[]`
-     * for a doubled parsha.
-     * For Parashat *Bereshit*, `num` would be equal to `1`, and for
-     * *Matot-Masei* it would be `[42, 43]`
-     */
-    num?: number | number[];
-    /** The date of the Shabbat this parsha is read */
-    hdate: HDate;
-};
-/**
- * Represents Parashah HaShavua for an entire Hebrew year
- */
-declare class Sedra {
-    private readonly year;
-    private readonly il;
-    private readonly firstSaturday;
-    private readonly theSedraArray;
-    /**
-     * Caculates the Parashah HaShavua for an entire Hebrew year
-     * @param hyear - Hebrew year (e.g. 5749)
-     * @param il - Use Israel sedra schedule (false for Diaspora)
-     */
-    constructor(hyear: number, il: boolean);
-    /**
-     * Returns the parsha (or parshiyot) read on Hebrew date
-     * @deprecated Use {@link lookup} instead
-     * @param hd Hebrew date or R.D. days
-     */
-    get(hd: HDate | number): string[];
-    /**
-     * Looks up parsha for the date, then returns a translated or transliterated string
-     * @deprecated Use {@link lookup} instead
-     * @param hd Hebrew date or R.D. days
-     * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale
-     */
-    getString(hd: HDate | number, locale?: string): string;
-    /**
-     * Checks to see if this day would be a regular parasha HaShavua
-     * Torah reading or special holiday reading
-     * @deprecated Use {@link lookup} instead
-     * @param hd Hebrew date or R.D. days
-     */
-    isParsha(hd: HDate | number): boolean;
-    /**
-     * Returns the date that a parsha occurs
-     * or `null` if the parsha doesn't occur this year
-     * @param parsha if a `string`, specified with Sephardic transliterations
-     *  like `'Noach'` or `'Matot-Masei'`. If an array, must be a 1- or 2-element
-     *  array such as `['Noach']` or `['Matot', 'Masei']`. If a `number`, should
-     *  be a 0-based parsha index (`0` for Bereshit, `1` for Noach) or a negative
-     *  number for a doubled parsha (e.g. `-21` for Vayakhel-Pekudei)
-     */
-    find(parsha: number | string | string[]): HDate | null;
-    private findInternal;
-    /**
-     * Returns the date that a parsha (or its doubled or undoubled counterpart)
-     * occurs, or `null` if the parsha doesn't occur this year
-     */
-    findContaining(parsha: number | string): HDate | null;
-    /**
-     * Returns the underlying annual sedra schedule.
-     * Used by `@hebcal/triennial`
-     */
-    getSedraArray(): readonly NumberOrString[];
-    /**
-     * R.D. date of the first Saturday on or after Rosh Hashana
-     */
-    getFirstSaturday(): number;
-    getYear(): number;
-    /**
-     * Returns an object describing the parsha on the first Saturday on or after `hd`
-     * @param hd Hebrew date or R.D. days
-     */
-    lookup(hd: HDate | number): SedraResult;
-}
-/**
- * The 54 parshiyot of the Torah as transilterated strings.
- * parshiot[0] == 'Bereshit', parshiot[1] == 'Noach', parshiot[52] == "Ha'azinu".
- * @readonly
- * @type {string[]}
- */
-declare const parshiot: readonly string[];
-type NumberOrString = number | string;
-/**
- * Convenience function to create an instance of `Sedra` or reuse a previously
- * created and cached instance.
- * @param hyear
- * @param il
- */
-declare function getSedra(hyear: number, il: boolean): Sedra;
-
-/**
- * Represents one of 54 weekly Torah portions, always on a Saturday
- */
-declare class ParshaEvent extends Event {
-    readonly parsha: string[];
-    readonly il: boolean;
-    readonly num: number | number[];
-    /**
-     * @param parsha - untranslated name of single or double parsha,
-     *   such as ['Bereshit'] or ['Achrei Mot', 'Kedoshim']
-     */
-    constructor(date: HDate, parsha: string[], il?: boolean, num?: number | number[]);
-    /**
-     * @param [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
-     */
-    render(locale?: string): string;
-    basename(): string;
-    url(): string | undefined;
-    urlDateSuffix(): string;
-}
-
-/**
- * Returns an array of Events on this date (or `undefined` if no events)
- * @param date Hebrew Date, Gregorian date, or absolute R.D. day number
- * @param [il] use the Israeli schedule for holidays
- */
-declare function getHolidaysOnDate(date: HDate | Date | number, il?: boolean): HolidayEvent[] | undefined;
-type HolidayYearMap = Map<string, HolidayEvent[]>;
-
-/** Represents Mevarchim haChodesh, the announcement of the new month */
-declare class MevarchimChodeshEvent extends Event {
-    readonly monthName: string;
-    /**
-     * Constructs Mevarchim haChodesh event
-     * @param date Hebrew date event occurs
-     * @param monthName Hebrew month name (not translated)
-     * @param [memo]
-     */
-    constructor(date: HDate, monthName: string, memo: string);
-    basename(): string;
-    /**
-     * Returns (translated) description of this event
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    render(locale?: string): string;
-    /**
-     * Returns (translated) description of this event
-     * @param [locale] Optional locale name (defaults to active locale).
-     */
-    renderBrief(locale?: string): string;
-}
-
-/**
- * Transliterated names of holidays, used by `Event.getDesc()`
- * @readonly
- * @enum {string}
- */
-declare const holidayDesc: {
-    /** Asara B'Tevet */
-    readonly ASARA_BTEVET: "Asara B'Tevet";
-    /** Birkat Hachamah */
-    readonly BIRKAT_HACHAMAH: "Birkat Hachamah";
-    /** Chag HaBanot */
-    readonly CHAG_HABANOT: "Chag HaBanot";
-    /** Chanukah: 8th Day */
-    readonly CHANUKAH_8TH_DAY: "Chanukah: 8th Day";
-    /** Erev Tish'a B'Av */
-    readonly EREV_TISHA_BAV: "Erev Tish'a B'Av";
-    /** Leil Selichot */
-    readonly LEIL_SELICHOT: "Leil Selichot";
-    /** Purim Katan */
-    readonly PURIM_KATAN: "Purim Katan";
-    /** Purim Meshulash */
-    readonly PURIM_MESHULASH: "Purim Meshulash";
-    /** Shabbat Chazon */
-    readonly SHABBAT_CHAZON: "Shabbat Chazon";
-    /** Shabbat HaChodesh */
-    readonly SHABBAT_HACHODESH: "Shabbat HaChodesh";
-    /** Shabbat HaGadol */
-    readonly SHABBAT_HAGADOL: "Shabbat HaGadol";
-    /** Shabbat Nachamu */
-    readonly SHABBAT_NACHAMU: "Shabbat Nachamu";
-    /** Shabbat Parah */
-    readonly SHABBAT_PARAH: "Shabbat Parah";
-    /** Shabbat Shekalim */
-    readonly SHABBAT_SHEKALIM: "Shabbat Shekalim";
-    /** Shabbat Shirah */
-    readonly SHABBAT_SHIRAH: "Shabbat Shirah";
-    /** Shabbat Shuva */
-    readonly SHABBAT_SHUVA: "Shabbat Shuva";
-    /** Shabbat Zachor */
-    readonly SHABBAT_ZACHOR: "Shabbat Zachor";
-    /** Shushan Purim Katan */
-    readonly SHUSHAN_PURIM_KATAN: "Shushan Purim Katan";
-    /** Ta'anit Bechorot */
-    readonly TAANIT_BECHOROT: "Ta'anit Bechorot";
-    /** Ta'anit Esther */
-    readonly TAANIT_ESTHER: "Ta'anit Esther";
-    /** Tish'a B'Av */
-    readonly TISHA_BAV: "Tish'a B'Av";
-    /** Tzom Gedaliah */
-    readonly TZOM_GEDALIAH: "Tzom Gedaliah";
-    /** Tzom Tammuz */
-    readonly TZOM_TAMMUZ: "Tzom Tammuz";
-    /** Yom HaAtzma'ut */
-    readonly YOM_HAATZMA_UT: "Yom HaAtzma'ut";
-    /** Yom HaShoah */
-    readonly YOM_HASHOAH: "Yom HaShoah";
-    /** Yom HaZikaron */
-    readonly YOM_HAZIKARON: "Yom HaZikaron";
-    /** Ben-Gurion Day */
-    readonly BEN_GURION_DAY: "Ben-Gurion Day";
-    /** Chanukah: 1 Candle */
-    readonly CHANUKAH_1_CANDLE: "Chanukah: 1 Candle";
-    /** Erev Pesach */
-    readonly EREV_PESACH: "Erev Pesach";
-    /** Erev Purim */
-    readonly EREV_PURIM: "Erev Purim";
-    /** Erev Rosh Hashana */
-    readonly EREV_ROSH_HASHANA: "Erev Rosh Hashana";
-    /** Erev Shavuot */
-    readonly EREV_SHAVUOT: "Erev Shavuot";
-    /** Erev Sukkot */
-    readonly EREV_SUKKOT: "Erev Sukkot";
-    /** Erev Yom Kippur */
-    readonly EREV_YOM_KIPPUR: "Erev Yom Kippur";
-    /** Family Day */
-    readonly FAMILY_DAY: "Family Day";
-    /** Hebrew Language Day */
-    readonly HEBREW_LANGUAGE_DAY: "Hebrew Language Day";
-    /** Herzl Day */
-    readonly HERZL_DAY: "Herzl Day";
-    /** Jabotinsky Day */
-    readonly JABOTINSKY_DAY: "Jabotinsky Day";
-    /** Lag BaOmer */
-    readonly LAG_BAOMER: "Lag BaOmer";
-    /** Pesach I */
-    readonly PESACH_I: "Pesach I";
-    /** Pesach II */
-    readonly PESACH_II: "Pesach II";
-    /** Pesach III (CH''M) */
-    readonly PESACH_III_CHM: "Pesach III (CH''M)";
-    /** Pesach II (CH''M) */
-    readonly PESACH_II_CHM: "Pesach II (CH''M)";
-    /** Pesach IV (CH''M) */
-    readonly PESACH_IV_CHM: "Pesach IV (CH''M)";
-    /** Pesach Sheni */
-    readonly PESACH_SHENI: "Pesach Sheni";
-    /** Pesach VII */
-    readonly PESACH_VII: "Pesach VII";
-    /** Pesach VIII */
-    readonly PESACH_VIII: "Pesach VIII";
-    /** Pesach VI (CH''M) */
-    readonly PESACH_VI_CHM: "Pesach VI (CH''M)";
-    /** Pesach V (CH''M) */
-    readonly PESACH_V_CHM: "Pesach V (CH''M)";
-    /** Purim */
-    readonly PURIM: "Purim";
-    /** Rosh Hashana II */
-    readonly ROSH_HASHANA_II: "Rosh Hashana II";
-    /** Rosh Hashana LaBehemot */
-    readonly ROSH_HASHANA_LABEHEMOT: "Rosh Hashana LaBehemot";
-    /** Shavuot */
-    readonly SHAVUOT: "Shavuot";
-    /** Shavuot I */
-    readonly SHAVUOT_I: "Shavuot I";
-    /** Shavuot II */
-    readonly SHAVUOT_II: "Shavuot II";
-    /** Shmini Atzeret */
-    readonly SHMINI_ATZERET: "Shmini Atzeret";
-    /** Shushan Purim */
-    readonly SHUSHAN_PURIM: "Shushan Purim";
-    /** Sigd */
-    readonly SIGD: "Sigd";
-    /** Simchat Torah */
-    readonly SIMCHAT_TORAH: "Simchat Torah";
-    /** Sukkot I */
-    readonly SUKKOT_I: "Sukkot I";
-    /** Sukkot II */
-    readonly SUKKOT_II: "Sukkot II";
-    /** Sukkot III (CH''M) */
-    readonly SUKKOT_III_CHM: "Sukkot III (CH''M)";
-    /** Sukkot II (CH''M) */
-    readonly SUKKOT_II_CHM: "Sukkot II (CH''M)";
-    /** Sukkot IV (CH''M) */
-    readonly SUKKOT_IV_CHM: "Sukkot IV (CH''M)";
-    /** Sukkot VII (Hoshana Raba) */
-    readonly SUKKOT_VII_HOSHANA_RABA: "Sukkot VII (Hoshana Raba)";
-    /** Sukkot VI (CH''M) */
-    readonly SUKKOT_VI_CHM: "Sukkot VI (CH''M)";
-    /** Sukkot V (CH''M) */
-    readonly SUKKOT_V_CHM: "Sukkot V (CH''M)";
-    /** Tu B\'Av */
-    readonly TU_BAV: "Tu B'Av";
-    /** Tu BiShvat */
-    readonly TU_BISHVAT: "Tu BiShvat";
-    /** Yitzhak Rabin Memorial Day */
-    readonly YITZHAK_RABIN_MEMORIAL_DAY: "Yitzhak Rabin Memorial Day";
-    /** Yom HaAliyah */
-    readonly YOM_HAALIYAH: "Yom HaAliyah";
-    /** Yom HaAliyah School Observance */
-    readonly YOM_HAALIYAH_SCHOOL_OBSERVANCE: "Yom HaAliyah School Observance";
-    /** Yom Kippur */
-    readonly YOM_KIPPUR: "Yom Kippur";
-    /** Yom Yerushalayim */
-    readonly YOM_YERUSHALAYIM: "Yom Yerushalayim";
-};
-
-/**
- * Plug-ins for daily learning calendars such as Daf Yomi, Mishna Yomi, Nach Yomi, etc.
- *
- * Learning schedules are provided by the `@hebcal/learning` package.
- */
-declare class DailyLearning {
-    /**
-     * Register a new learning calendar.
-     */
-    static addCalendar(name: string, calendar: Function): void;
-    /**
-     * Returns an event from daily calendar for a given date. Returns `null` if there
-     * is no learning from this calendar on this date.
-     * @param name
-     * @param hd
-     * @param il
-     */
-    static lookup(name: string, hd: HDate, il: boolean): Event | null;
-}
-
-/**
- * HebrewCalendar is the main interface to the `@hebcal/core` library.
- * This namespace is used to calculate holidays, rosh chodesh, candle lighting & havdalah times,
- * Parashat HaShavua, Daf Yomi, days of the omer, and the molad.
- * Event names can be rendered in several languges using the `locale` option.
- */
-declare class HebrewCalendar {
-    private constructor();
-    /**
-     * Calculates holidays and other Hebrew calendar events based on {@link CalOptions}.
-     *
-     * Each holiday is represented by an {@link Event} object which includes a date,
-     * a description, flags and optional attributes.
-     * If given no options, returns holidays for the Diaspora for the current Gregorian year.
-     *
-     * The date range returned by this function can be controlled by:
-     * * `options.year` - Gregorian (e.g. 1993) or Hebrew year (e.g. 5749)
-     * * `options.isHebrewYear` - to interpret `year` as Hebrew year
-     * * `options.numYears` - generate calendar for multiple years (default 1)
-     * * `options.month` - Gregorian or Hebrew month (to filter results to a single month)
-     *
-     * Alternatively, specify start and end days with `Date` or {@link HDate} instances:
-     * * `options.start` - use specific start date (requires `end` date)
-     * * `options.end` - use specific end date (requires `start` date)
-     *
-     * Unless `options.noHolidays == true`, default holidays include:
-     * * Major holidays - Rosh Hashana, Yom Kippur, Pesach, Sukkot, etc.
-     * * Minor holidays - Purim, Chanukah, Tu BiShvat, Lag BaOmer, etc.
-     * * Minor fasts - Ta'anit Esther, Tzom Gedaliah, etc. (unless `options.noMinorFast`)
-     * * Special Shabbatot - Shabbat Shekalim, Zachor, etc. (unless `options.noSpecialShabbat`)
-     * * Modern Holidays - Yom HaShoah, Yom HaAtzma'ut, etc. (unless `options.noModern`)
-     * * Rosh Chodesh (unless `options.noRoshChodesh`)
-     *
-     * Holiday and Torah reading schedules differ between Israel and the Disapora.
-     * Set `options.il=true` to use the Israeli schedule.
-     *
-     * Additional non-default event types can be specified:
-     * * Parashat HaShavua - weekly Torah Reading on Saturdays (`options.sedrot`)
-     * * Counting of the Omer (`options.omer`)
-     * * Shabbat Mevarchim HaChodesh on Saturday before Rosh Chodesh (`options.shabbatMevarchim`)
-     * * Molad announcement on Saturday before Rosh Chodesh (`options.molad`)
-     * * Yom Kippur Katan (`options.yomKippurKatan`)
-     *
-     * Daily Study of texts are supported by the
-     * {@link https://github.com/hebcal/hebcal-learning @hebcal/learning} package,
-     * for example:
-     * * Babylonian Talmud Daf Yomi (`options.dailyLearning.dafYomi`)
-     * * Jerusalem Talmud (Yerushalmi) Yomi (`options.dailyLearning.yerushalmi`)
-     * * Mishna Yomi (`options.dailyLearning.mishnaYomi`)
-     * * Nach Yomi (`options.dailyLearning.nachYomi`)
-     *
-     * Candle-lighting and Havdalah times are approximated using latitude and longitude
-     * specified by the {@link Location} class. The `Location` class contains a small
-     * database of cities with their associated geographic information and time-zone information.
-     * If you ever have any doubts about Hebcal's times, consult your local halachic authority.
-     * If you enter geographic coordinates above the arctic circle or antarctic circle,
-     * the times are guaranteed to be wrong.
-     *
-     * To add candle-lighting options, set `options.candlelighting=true` and set
-     * `options.location` to an instance of `Location`. By default, candle lighting
-     * time is 18 minutes before sundown (40 minutes for Jerusalem,
-     * 30 minutes for Haifa and Zikhron Ya'akov) and Havdalah is
-     * calculated according to Tzeit Hakochavim - Nightfall (the point when 3 small stars
-     * are observable in the night time sky with the naked eye). The default Havdalah
-     * option (Tzeit Hakochavim) is calculated when the sun is 8.5° below the horizon.
-     * These defaults can be changed using these options:
-     * * `options.candleLightingMins` - minutes before sundown to light candles
-     * * `options.havdalahMins` - minutes after sundown for Havdalah (typical values are 42, 50, or 72).
-     *    Havdalah times are suppressed when `options.havdalahMins=0`.
-     * * `options.havdalahDeg` - degrees for solar depression for Havdalah.
-     *    Default is 8.5 degrees for 3 small stars. Use 7.083 degrees for 3 medium-sized stars.
-     *    Havdalah times are suppressed when `options.havdalahDeg=0`.
-     *
-     * If both `options.candlelighting=true` and `options.location` is specified,
-     * Chanukah candle-lighting times and minor fast start/end times will also be generated.
-     * Chanukah candle-lighting is at Bein HaShmashos (13.5 minutes before
-     * the sun is 7.083° below the horizon in the evening)
-     * on weekdays, at regular candle-lighting time on Fridays, and at regular Havdalah time on
-     * Saturday night (see above).
-     *
-     * Minor fasts begin at Alot HaShachar (sun is 16.1° below the horizon in the morning) and
-     * end when 3 medium-sized stars are observable in the night sky (sun is 7.083° below the horizon
-     * in the evening).
-     *
-     * Two options also exist for generating an Event with the Hebrew date:
-     * * `options.addHebrewDates` - print the Hebrew date for the entire date range
-     * * `options.addHebrewDatesForEvents` - print the Hebrew date for dates with some events
-     *
-     * Lastly, translation and transliteration of event titles is controlled by
-     * `options.locale` and the {@link Locale} API.
-     * `@hebcal/core` supports three locales by default:
-     * * `en` - default, Sephardic transliterations (e.g. "Shabbat")
-     * * `ashkenazi` - Ashkenazi transliterations (e.g. "Shabbos")
-     * * `he` - Hebrew (e.g. "שַׁבָּת")
-     *
-     * Additional locales (such as `ru` or `fr`) are supported by the
-     * {@link https://github.com/hebcal/hebcal-locales @hebcal/locales} package
-     *
-     * @example
-     * import {HebrewCalendar, HDate, Location, Event} from '@hebcal/core';
-     * const options: CalOptions = {
-     *   year: 1981,
-     *   isHebrewYear: false,
-     *   candlelighting: true,
-     *   location: Location.lookup('San Francisco'),
-     *   sedrot: true,
-     *   omer: true,
-     * };
-     * const events = HebrewCalendar.calendar(options);
-     * for (const ev of events) {
-     *   const hd = ev.getDate();
-     *   const date = hd.greg();
-     *   console.log(date.toLocaleDateString(), ev.render('en'), hd.toString());
-     * }
-     */
-    static calendar(options?: CalOptions): Event[];
-    /**
-     * Calculates a birthday or anniversary (non-yahrzeit).
-     * `hyear` must be after original `gdate` of anniversary.
-     * Returns `undefined` when requested year preceeds or is same as original year.
-     *
-     * Hebcal uses the algorithm defined in "Calendrical Calculations"
-     * by Edward M. Reingold and Nachum Dershowitz.
-     *
-     * The birthday of someone born in Adar of an ordinary year or Adar II of
-     * a leap year is also always in the last month of the year, be that Adar
-     * or Adar II. The birthday in an ordinary year of someone born during the
-     * first 29 days of Adar I in a leap year is on the corresponding day of Adar;
-     * in a leap year, the birthday occurs in Adar I, as expected.
-     *
-     * Someone born on the thirtieth day of Marcheshvan, Kislev, or Adar I
-     * has his birthday postponed until the first of the following month in
-     * years where that day does not occur. [Calendrical Calculations p. 111]
-     * @example
-     * import {HebrewCalendar} from '@hebcal/core';
-     * const dt = new Date(2014, 2, 2); // '2014-03-02' == '30 Adar I 5774'
-     * const hd = HebrewCalendar.getBirthdayOrAnniversary(5780, dt); // '1 Nisan 5780'
-     * console.log(hd.greg().toLocaleDateString('en-US')); // '3/26/2020'
-     * @param hyear Hebrew year
-     * @param gdate Gregorian or Hebrew date of event
-     * @returns anniversary occurring in `hyear`
-     */
-    static getBirthdayOrAnniversary(hyear: number, gdate: Date | HDate): HDate | undefined;
-    /**
-     * Calculates yahrzeit.
-     * `hyear` must be after original `gdate` of death.
-     * Returns `undefined` when requested year preceeds or is same as original year.
-     *
-     * Hebcal uses the algorithm defined in "Calendrical Calculations"
-     * by Edward M. Reingold and Nachum Dershowitz.
-     *
-     * The customary anniversary date of a death is more complicated and depends
-     * also on the character of the year in which the first anniversary occurs.
-     * There are several cases:
-     *
-     * * If the date of death is Marcheshvan 30, the anniversary in general depends
-     *   on the first anniversary; if that first anniversary was not Marcheshvan 30,
-     *   use the day before Kislev 1.
-     * * If the date of death is Kislev 30, the anniversary in general again depends
-     *   on the first anniversary — if that was not Kislev 30, use the day before
-     *   Tevet 1.
-     * * If the date of death is Adar II, the anniversary is the same day in the
-     *   last month of the Hebrew year (Adar or Adar II).
-     * * If the date of death is Adar I 30, the anniversary in a Hebrew year that
-     *   is not a leap year (in which Adar only has 29 days) is the last day in
-     *   Shevat.
-     * * In all other cases, use the normal (that is, same month number) anniversary
-     *   of the date of death. [Calendrical Calculations p. 113]
-     * @example
-     * import {HebrewCalendar} from '@hebcal/core';
-     * const dt = new Date(2014, 2, 2); // '2014-03-02' == '30 Adar I 5774'
-     * const hd = HebrewCalendar.getYahrzeit(5780, dt); // '30 Sh\'vat 5780'
-     * console.log(hd.greg().toLocaleDateString('en-US')); // '2/25/2020'
-     * @param hyear Hebrew year
-     * @param gdate Gregorian or Hebrew date of death
-     * @returns anniversary occurring in hyear
-     */
-    static getYahrzeit(hyear: number, gdate: Date | HDate): HDate | undefined;
-    /**
-     * Lower-level holidays interface, which returns a `Map` of `Event`s indexed by
-     * `HDate.toString()`. These events must filtered especially for `flags.IL_ONLY`
-     * or `flags.CHUL_ONLY` depending on Israel vs. Diaspora holiday scheme.
-     * @param year Hebrew year
-     */
-    static getHolidaysForYear(year: number): HolidayYearMap;
-    /**
-     * Returns an array of holidays for the year
-     * @param year Hebrew year
-     * @param il use the Israeli schedule for holidays
-     */
-    static getHolidaysForYearArray(year: number, il: boolean): HolidayEvent[];
-    /**
-     * Returns an array of Events on this date (or `undefined` if no events)
-     * @param date Hebrew Date, Gregorian date, or absolute R.D. day number
-     * @param [il] use the Israeli schedule for holidays
-     */
-    static getHolidaysOnDate(date: HDate | Date | number, il?: boolean): HolidayEvent[] | undefined;
-    /**
-     * Eruv Tavshilin
-     */
-    static eruvTavshilin(date: Date | HDate, il: boolean): boolean;
-    /**
-     * Helper function to format a 23-hour (00:00-23:59) time in US format ("8:13pm") or
-     * keep as "20:13" for any other locale/country. Uses {@link CalOptions} to determine
-     * locale.
-     * If `options.hour12` is `false`, locale is ignored and always returns 24-hour time.
-     * If `options.hour12` is `true`, locale is ignored and always returns 12-hour time.
-     * @param timeStr - original time like "20:30"
-     * @param suffix - "p" or "pm" or " P.M.". Add leading space if you want it
-     * @param options
-     */
-    static reformatTimeStr(timeStr: string, suffix: string, options: CalOptions): string;
-    static version(): string;
-    /**
-     * Convenience function to create an instance of `Sedra` or reuse a previously
-     * created and cached instance.
-     */
-    static getSedra(hyear: number, il: boolean): Sedra;
-    /**
-     * Return a number containing information on what Hallel is said on that day.
-     *
-     * Whole Hallel is said on Chanukah, the first Yom Tov of Pesach, Shavuot, Sukkot,
-     * Yom Ha'atzmaut, and Yom Yerushalayim.
-     *
-     * Half Hallel is said on Rosh Chodesh (not Rosh Hashanah), and the last 6 days of Pesach.
-     *
-     * The number is one of the following values:
-     *
-     * 0 - No Hallel
-     * 1 - Half Hallel
-     * 2 - Whole Hallel
-     */
-    static hallel(hdate: HDate, il: boolean): number;
-    /**
-     * Return details on what Tachanun (or Tzidchatcha on Shabbat) is said on `hdate`.
-     *
-     * Tachanun is not said on Rosh Chodesh, the month of Nisan, Lag Baomer,
-     * Rosh Chodesh Sivan until Isru Chag, Tisha B'av, 15 Av, Erev Rosh Hashanah,
-     * Rosh Hashanah, Erev Yom Kippur until after Simchat Torah, Chanukah,
-     * Tu B'shvat, Purim and Shushan Purim, and Purim and Shushan Purim Katan.
-     *
-     * In some congregations Tachanun is not said until from Rosh Chodesh Sivan
-     * until 14th Sivan, Sukkot until after Rosh Chodesh Cheshvan, Pesach Sheini,
-     * Yom Ha'atzmaut, and Yom Yerushalayim.
-     *
-     * Tachanun is not said at Mincha on days before it is not said at Shacharit.
-     *
-     * Tachanun is not said at Shacharit on Shabbat, but is at Mincha, usually.
-     */
-    static tachanun(hdate: HDate, il: boolean): TachanunResult;
-}
-
-export { AsaraBTevetEvent, type CalOptions, CandleLightingEvent, DailyLearning, type DailyLearningValue, Event, FastDayEvent, HavdalahEvent, HebrewCalendar, HebrewDateEvent, HolidayEvent, type HolidayYearMap, Location, MevarchimChodeshEvent, Molad, MoladEvent, OmerEvent, ParshaEvent, RoshChodeshEvent, RoshHashanaEvent, Sedra, type SedraResult, type TachanunResult, TimedEvent, Zmanim, flags, getHolidaysOnDate, getSedra, holidayDesc, parshiot, version };