panchang-ts 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,295 @@
+interface GeoLocation {
+    /** Latitude in decimal degrees. Range: -90 to 90. */
+    latitude: number;
+    /** Longitude in decimal degrees. Range: -180 to 180. */
+    longitude: number;
+    /** Elevation in meters above sea level. Default: 0. */
+    elevation?: number;
+}
+
+type AyanamsaType = 'lahiri' | 'raman' | 'krishnamurti';
+type Language = 'en' | 'sa' | 'hi';
+type Precision = 'standard' | 'high';
+interface PanchangOptions {
+    timezone: number | string;
+    ayanamsa?: AyanamsaType;
+    language?: Language;
+    computeEndTimes?: boolean;
+    precision?: Precision;
+}
+interface InstantPanchangOptions {
+    ayanamsa?: AyanamsaType;
+    language?: Language;
+    computeEndTimes?: boolean;
+    precision?: Precision;
+}
+
+interface TimePeriod {
+    start: Date;
+    end: Date;
+}
+interface ElementBase {
+    index: number;
+    name: string;
+    completionPercentage: number;
+    endTime: Date | null;
+}
+interface TithiInfo extends ElementBase {
+    paksha: 'Shukla' | 'Krishna';
+    number: number;
+}
+interface NakshatraInfo extends ElementBase {
+    pada: number;
+    degreesInNakshatra: number;
+}
+interface YogaInfo extends ElementBase {
+}
+interface KaranaInfo extends ElementBase {
+    type: 'fixed' | 'movable';
+}
+interface VaraInfo {
+    index: number;
+    name: string;
+    shortName: string;
+    englishName: string;
+}
+interface DailyElementBase {
+    startTime: Date | null;
+    isActiveAtSunrise: boolean;
+}
+interface DailyTithiInfo extends TithiInfo, DailyElementBase {
+}
+interface DailyNakshatraInfo extends NakshatraInfo, DailyElementBase {
+}
+interface DailyYogaInfo extends YogaInfo, DailyElementBase {
+}
+interface DailyKaranaInfo extends KaranaInfo, DailyElementBase {
+}
+
+interface MasaInfo {
+    index: number;
+    name: string;
+}
+interface DailyPanchangResult {
+    date: Date;
+    location: GeoLocation;
+    timezone: number;
+    sunrise: Date;
+    sunset: Date;
+    nextSunrise: Date;
+    dayDurationMinutes: number;
+    nightDurationMinutes: number;
+    tithis: DailyTithiInfo[];
+    nakshatras: DailyNakshatraInfo[];
+    yogas: DailyYogaInfo[];
+    karanas: DailyKaranaInfo[];
+    vara: VaraInfo;
+    rahuKalam: TimePeriod;
+    gulikaKalam: TimePeriod;
+    yamaganda: TimePeriod;
+    abhijitMuhurta: TimePeriod;
+    ayanamsa: number;
+    siderealSunAtSunrise: number;
+    siderealMoonAtSunrise: number;
+    masa: MasaInfo;
+    _debug?: {
+        totalMs: number;
+        sunriseMs: number;
+        elementsMs: number;
+        endTimesMs: number;
+    };
+}
+interface InstantPanchangResult {
+    timestamp: Date;
+    location: GeoLocation;
+    tithi: TithiInfo;
+    nakshatra: NakshatraInfo;
+    yoga: YogaInfo;
+    karana: KaranaInfo;
+    vara: VaraInfo;
+    ayanamsa: number;
+    siderealSun: number;
+    siderealMoon: number;
+}
+
+/**
+ * Returns the Panchang elements active at a single UTC moment.
+ *
+ * Use this for birth-chart calculations, muhurta selection, or any case
+ * where you need the exact element at a specific instant rather than a
+ * full sunrise-to-sunrise day.
+ *
+ * @param date     UTC instant to evaluate.
+ * @param location Observer coordinates `{ latitude, longitude, elevation? }`.
+ * @param options  Optional settings: `ayanamsa`, `language`, `computeEndTimes`,
+ *                 `precision`. No `timezone` required — the result is UTC-based.
+ * @returns        `InstantPanchangResult` with one value per element
+ *                 (tithi, nakshatra, yoga, karana, vara) plus sidereal longitudes.
+ * @throws         `PanchangError` for invalid inputs or polar locations with no sunrise.
+ *
+ * @example
+ * ```typescript
+ * import { getInstantPanchang } from 'panchang-ts';
+ *
+ * const p = getInstantPanchang(
+ *   new Date('2025-01-14T03:00:00Z'),
+ *   { latitude: 18.5204, longitude: 73.8567 },
+ *   { language: 'sa' },
+ * );
+ * console.log(p.tithi.name);     // "कृष्ण चतुर्दशी"
+ * console.log(p.tithi.endTime);  // Date (UTC) when this Tithi ends
+ * ```
+ */
+declare function getInstantPanchang(date: Date, location: GeoLocation, options?: InstantPanchangOptions): InstantPanchangResult;
+/**
+ * Returns the full Hindu Panchang for a sunrise-to-sunrise day.
+ *
+ * The "day" is defined as the window from the local sunrise to the following
+ * sunrise (as per Vedic convention). Multiple elements per category are
+ * returned when a transition occurs during the day — e.g. if Tithi changes
+ * at 14:30 the result has two `DailyTithiInfo` entries.
+ *
+ * All `Date` objects in the result are **offset-adjusted** to the requested
+ * timezone. Read their components via `getUTC*` methods:
+ * ```
+ * result.sunrise.getUTCHours()   // local sunrise hour
+ * result.sunrise.getHours()      // ← wrong, uses system timezone
+ * ```
+ *
+ * @param date     Any `Date` within the local calendar day you want.
+ *                 Only the calendar date is used; the time component is ignored.
+ * @param location Observer coordinates `{ latitude, longitude, elevation? }`.
+ * @param options  Settings — `timezone` is required (UTC offset in minutes,
+ *                 e.g. 330 for IST). Also accepts `ayanamsa`, `language`,
+ *                 `computeEndTimes`, `precision`.
+ * @returns        `DailyPanchangResult` with element arrays, sunrise/sunset,
+ *                 inauspicious periods, muhurta, ayanamsa, and Masa.
+ * @throws         `PanchangError` for invalid inputs or polar locations with no sunrise.
+ *
+ * @example
+ * ```typescript
+ * import { getDailyPanchang } from 'panchang-ts';
+ *
+ * const result = getDailyPanchang(
+ *   new Date(2025, 0, 14),                      // Jan 14, 2025
+ *   { latitude: 18.5204, longitude: 73.8567 },  // Pune, India
+ *   { timezone: 330 },                          // IST = UTC+5:30
+ * );
+ *
+ * result.tithis[0].name;           // "Krishna Chaturdashi"
+ * result.vara.name;                // "Mangalavara"
+ * result.rahuKalam.start;          // Date — read via getUTCHours()
+ *
+ * // Fast mode (names only, ~5× faster):
+ * const fast = getDailyPanchang(date, loc, { timezone: 330, computeEndTimes: false });
+ * ```
+ */
+declare function getDailyPanchang(date: Date, location: GeoLocation, options: PanchangOptions): DailyPanchangResult;
+
+/**
+ * Compute sunrise nearest to (and after) the given UTC search start.
+ *
+ * @param searchFromUtc  Start searching from this UTC instant.
+ *                       For daily mode, this is local midnight converted to UTC.
+ * @param location       Observer coordinates.
+ * @param limitDays      How far ahead to search. Default 2 (handles polar edge cases).
+ * @returns              Sunrise as a UTC Date.
+ * @throws PanchangError (NO_SUNRISE) for polar regions with no sunrise.
+ */
+declare function computeSunrise(searchFromUtc: Date, location: GeoLocation, limitDays?: number): Date;
+/**
+ * Compute sunset nearest to (and after) the given UTC search start.
+ *
+ * @param searchFromUtc  Start searching from this UTC instant (typically sunrise).
+ * @param location       Observer coordinates.
+ * @param limitDays      How far ahead to search. Default 2.
+ * @returns              Sunset as a UTC Date.
+ * @throws PanchangError (NO_SUNSET) for polar regions with no sunset.
+ */
+declare function computeSunset(searchFromUtc: Date, location: GeoLocation, limitDays?: number): Date;
+
+/**
+ * Sidereal longitude of the Sun at a given UTC instant.
+ * Returns degrees in range [0, 360).
+ *
+ * Uses SunPosition() for the geocentric ecliptic longitude of the Sun.
+ * EclipticLongitude(Body.Sun) is not valid — the Sun has no heliocentric longitude.
+ */
+declare function getSiderealSunLongitude(date: Date, ayanamsaType: AyanamsaType): number;
+
+/**
+ * Sidereal longitude of the Moon at a given UTC instant.
+ * Returns degrees in range [0, 360).
+ *
+ * Uses Ecliptic(GeoMoon(t)).elon for the geocentric ecliptic longitude.
+ * EclipticLongitude(Body.Moon) returns heliocentric longitude, which is
+ * inappropriate for panchang calculations.
+ */
+declare function getSiderealMoonLongitude(date: Date, ayanamsaType: AyanamsaType): number;
+
+/**
+ * Compute the ayanamsa (precession offset) for a given UTC date.
+ *
+ * The ayanamsa is subtracted from the tropical (ecliptic) longitude to obtain
+ * the sidereal longitude used in Vedic astrology.
+ *
+ * @param date UTC date to evaluate.
+ * @param type Ayanamsa system: `'lahiri'` (default), `'raman'`, or `'krishnamurti'`.
+ * @returns    Ayanamsa value in degrees. Typical range ~23–24° for dates near J2000.
+ * @throws     `PanchangError` (INVALID_AYANAMSA) for unrecognised type strings.
+ *
+ * @example
+ * ```typescript
+ * import { getAyanamsa } from 'panchang-ts';
+ * getAyanamsa(new Date('2025-01-01T00:00:00Z'), 'lahiri'); // ~24.10
+ * ```
+ */
+declare function computeAyanamsa(date: Date, type?: AyanamsaType): number;
+
+/**
+ * Compute Rahu Kalam — the inauspicious period ruled by Rahu.
+ * Daytime is divided into 8 equal slots; the slot index varies by weekday.
+ *
+ * @param sunrise   UTC sunrise Date.
+ * @param sunset    UTC sunset Date.
+ * @param varaIndex Weekday index: 0 = Sunday, 6 = Saturday.
+ * @returns         `{ start, end }` UTC Dates for the Rahu Kalam period.
+ */
+declare function computeRahuKalam(sunrise: Date, sunset: Date, varaIndex: number): TimePeriod;
+/**
+ * Compute Gulika Kalam — the inauspicious period ruled by Saturn's son Gulika.
+ *
+ * @param sunrise   UTC sunrise Date.
+ * @param sunset    UTC sunset Date.
+ * @param varaIndex Weekday index: 0 = Sunday, 6 = Saturday.
+ * @returns         `{ start, end }` UTC Dates for the Gulika Kalam period.
+ */
+declare function computeGulikaKalam(sunrise: Date, sunset: Date, varaIndex: number): TimePeriod;
+/**
+ * Compute Yamaganda — the inauspicious period associated with Yama (death).
+ *
+ * @param sunrise   UTC sunrise Date.
+ * @param sunset    UTC sunset Date.
+ * @param varaIndex Weekday index: 0 = Sunday, 6 = Saturday.
+ * @returns         `{ start, end }` UTC Dates for the Yamaganda period.
+ */
+declare function computeYamaganda(sunrise: Date, sunset: Date, varaIndex: number): TimePeriod;
+
+/**
+ * Abhijit Muhurta: the 8th muhurta when daytime is divided into 15 equal parts.
+ * This is the most auspicious muhurta, centered around local noon.
+ *
+ * For a 12-hour day: each muhurta = 48 min. Abhijit = ~11:36 AM to 12:24 PM.
+ *
+ * @param sunrise Sunrise UTC Date
+ * @param sunset  Sunset UTC Date
+ */
+declare function computeAbhijitMuhurta(sunrise: Date, sunset: Date): TimePeriod;
+
+type PanchangErrorCode = 'INVALID_LATITUDE' | 'INVALID_LONGITUDE' | 'INVALID_ELEVATION' | 'INVALID_DATE' | 'INVALID_TIMEZONE' | 'INVALID_AYANAMSA' | 'TIMEZONE_RESOLUTION_FAILED' | 'NO_SUNRISE' | 'NO_SUNSET' | 'SEARCH_DIVERGED';
+declare class PanchangError extends Error {
+    readonly code: PanchangErrorCode;
+    constructor(message: string, code: PanchangErrorCode);
+}
+
+export { type AyanamsaType, type DailyKaranaInfo, type DailyNakshatraInfo, type DailyPanchangResult, type DailyTithiInfo, type DailyYogaInfo, type GeoLocation, type InstantPanchangOptions, type InstantPanchangResult, type KaranaInfo, type Language, type MasaInfo, type NakshatraInfo, PanchangError, type PanchangErrorCode, type PanchangOptions, type Precision, type TimePeriod, type TithiInfo, type VaraInfo, type YogaInfo, computeAbhijitMuhurta, computeGulikaKalam, computeRahuKalam, computeYamaganda, computeAyanamsa as getAyanamsa, getDailyPanchang, getInstantPanchang, getSiderealMoonLongitude, getSiderealSunLongitude, computeSunrise as getSunrise, computeSunset as getSunset };

package/dist/index.d.ts

@@ -0,0 +1,295 @@
+interface GeoLocation {
+    /** Latitude in decimal degrees. Range: -90 to 90. */
+    latitude: number;
+    /** Longitude in decimal degrees. Range: -180 to 180. */
+    longitude: number;
+    /** Elevation in meters above sea level. Default: 0. */
+    elevation?: number;
+}
+
+type AyanamsaType = 'lahiri' | 'raman' | 'krishnamurti';
+type Language = 'en' | 'sa' | 'hi';
+type Precision = 'standard' | 'high';
+interface PanchangOptions {
+    timezone: number | string;
+    ayanamsa?: AyanamsaType;
+    language?: Language;
+    computeEndTimes?: boolean;
+    precision?: Precision;
+}
+interface InstantPanchangOptions {
+    ayanamsa?: AyanamsaType;
+    language?: Language;
+    computeEndTimes?: boolean;
+    precision?: Precision;
+}
+
+interface TimePeriod {
+    start: Date;
+    end: Date;
+}
+interface ElementBase {
+    index: number;
+    name: string;
+    completionPercentage: number;
+    endTime: Date | null;
+}
+interface TithiInfo extends ElementBase {
+    paksha: 'Shukla' | 'Krishna';
+    number: number;
+}
+interface NakshatraInfo extends ElementBase {
+    pada: number;
+    degreesInNakshatra: number;
+}
+interface YogaInfo extends ElementBase {
+}
+interface KaranaInfo extends ElementBase {
+    type: 'fixed' | 'movable';
+}
+interface VaraInfo {
+    index: number;
+    name: string;
+    shortName: string;
+    englishName: string;
+}
+interface DailyElementBase {
+    startTime: Date | null;
+    isActiveAtSunrise: boolean;
+}
+interface DailyTithiInfo extends TithiInfo, DailyElementBase {
+}
+interface DailyNakshatraInfo extends NakshatraInfo, DailyElementBase {
+}
+interface DailyYogaInfo extends YogaInfo, DailyElementBase {
+}
+interface DailyKaranaInfo extends KaranaInfo, DailyElementBase {
+}
+
+interface MasaInfo {
+    index: number;
+    name: string;
+}
+interface DailyPanchangResult {
+    date: Date;
+    location: GeoLocation;
+    timezone: number;
+    sunrise: Date;
+    sunset: Date;
+    nextSunrise: Date;
+    dayDurationMinutes: number;
+    nightDurationMinutes: number;
+    tithis: DailyTithiInfo[];
+    nakshatras: DailyNakshatraInfo[];
+    yogas: DailyYogaInfo[];
+    karanas: DailyKaranaInfo[];
+    vara: VaraInfo;
+    rahuKalam: TimePeriod;
+    gulikaKalam: TimePeriod;
+    yamaganda: TimePeriod;
+    abhijitMuhurta: TimePeriod;
+    ayanamsa: number;
+    siderealSunAtSunrise: number;
+    siderealMoonAtSunrise: number;
+    masa: MasaInfo;
+    _debug?: {
+        totalMs: number;
+        sunriseMs: number;
+        elementsMs: number;
+        endTimesMs: number;
+    };
+}
+interface InstantPanchangResult {
+    timestamp: Date;
+    location: GeoLocation;
+    tithi: TithiInfo;
+    nakshatra: NakshatraInfo;
+    yoga: YogaInfo;
+    karana: KaranaInfo;
+    vara: VaraInfo;
+    ayanamsa: number;
+    siderealSun: number;
+    siderealMoon: number;
+}
+
+/**
+ * Returns the Panchang elements active at a single UTC moment.
+ *
+ * Use this for birth-chart calculations, muhurta selection, or any case
+ * where you need the exact element at a specific instant rather than a
+ * full sunrise-to-sunrise day.
+ *
+ * @param date     UTC instant to evaluate.
+ * @param location Observer coordinates `{ latitude, longitude, elevation? }`.
+ * @param options  Optional settings: `ayanamsa`, `language`, `computeEndTimes`,
+ *                 `precision`. No `timezone` required — the result is UTC-based.
+ * @returns        `InstantPanchangResult` with one value per element
+ *                 (tithi, nakshatra, yoga, karana, vara) plus sidereal longitudes.
+ * @throws         `PanchangError` for invalid inputs or polar locations with no sunrise.
+ *
+ * @example
+ * ```typescript
+ * import { getInstantPanchang } from 'panchang-ts';
+ *
+ * const p = getInstantPanchang(
+ *   new Date('2025-01-14T03:00:00Z'),
+ *   { latitude: 18.5204, longitude: 73.8567 },
+ *   { language: 'sa' },
+ * );
+ * console.log(p.tithi.name);     // "कृष्ण चतुर्दशी"
+ * console.log(p.tithi.endTime);  // Date (UTC) when this Tithi ends
+ * ```
+ */
+declare function getInstantPanchang(date: Date, location: GeoLocation, options?: InstantPanchangOptions): InstantPanchangResult;
+/**
+ * Returns the full Hindu Panchang for a sunrise-to-sunrise day.
+ *
+ * The "day" is defined as the window from the local sunrise to the following
+ * sunrise (as per Vedic convention). Multiple elements per category are
+ * returned when a transition occurs during the day — e.g. if Tithi changes
+ * at 14:30 the result has two `DailyTithiInfo` entries.
+ *
+ * All `Date` objects in the result are **offset-adjusted** to the requested
+ * timezone. Read their components via `getUTC*` methods:
+ * ```
+ * result.sunrise.getUTCHours()   // local sunrise hour
+ * result.sunrise.getHours()      // ← wrong, uses system timezone
+ * ```
+ *
+ * @param date     Any `Date` within the local calendar day you want.
+ *                 Only the calendar date is used; the time component is ignored.
+ * @param location Observer coordinates `{ latitude, longitude, elevation? }`.
+ * @param options  Settings — `timezone` is required (UTC offset in minutes,
+ *                 e.g. 330 for IST). Also accepts `ayanamsa`, `language`,
+ *                 `computeEndTimes`, `precision`.
+ * @returns        `DailyPanchangResult` with element arrays, sunrise/sunset,
+ *                 inauspicious periods, muhurta, ayanamsa, and Masa.
+ * @throws         `PanchangError` for invalid inputs or polar locations with no sunrise.
+ *
+ * @example
+ * ```typescript
+ * import { getDailyPanchang } from 'panchang-ts';
+ *
+ * const result = getDailyPanchang(
+ *   new Date(2025, 0, 14),                      // Jan 14, 2025
+ *   { latitude: 18.5204, longitude: 73.8567 },  // Pune, India
+ *   { timezone: 330 },                          // IST = UTC+5:30
+ * );
+ *
+ * result.tithis[0].name;           // "Krishna Chaturdashi"
+ * result.vara.name;                // "Mangalavara"
+ * result.rahuKalam.start;          // Date — read via getUTCHours()
+ *
+ * // Fast mode (names only, ~5× faster):
+ * const fast = getDailyPanchang(date, loc, { timezone: 330, computeEndTimes: false });
+ * ```
+ */
+declare function getDailyPanchang(date: Date, location: GeoLocation, options: PanchangOptions): DailyPanchangResult;
+
+/**
+ * Compute sunrise nearest to (and after) the given UTC search start.
+ *
+ * @param searchFromUtc  Start searching from this UTC instant.
+ *                       For daily mode, this is local midnight converted to UTC.
+ * @param location       Observer coordinates.
+ * @param limitDays      How far ahead to search. Default 2 (handles polar edge cases).
+ * @returns              Sunrise as a UTC Date.
+ * @throws PanchangError (NO_SUNRISE) for polar regions with no sunrise.
+ */
+declare function computeSunrise(searchFromUtc: Date, location: GeoLocation, limitDays?: number): Date;
+/**
+ * Compute sunset nearest to (and after) the given UTC search start.
+ *
+ * @param searchFromUtc  Start searching from this UTC instant (typically sunrise).
+ * @param location       Observer coordinates.
+ * @param limitDays      How far ahead to search. Default 2.
+ * @returns              Sunset as a UTC Date.
+ * @throws PanchangError (NO_SUNSET) for polar regions with no sunset.
+ */
+declare function computeSunset(searchFromUtc: Date, location: GeoLocation, limitDays?: number): Date;
+
+/**
+ * Sidereal longitude of the Sun at a given UTC instant.
+ * Returns degrees in range [0, 360).
+ *
+ * Uses SunPosition() for the geocentric ecliptic longitude of the Sun.
+ * EclipticLongitude(Body.Sun) is not valid — the Sun has no heliocentric longitude.
+ */
+declare function getSiderealSunLongitude(date: Date, ayanamsaType: AyanamsaType): number;
+
+/**
+ * Sidereal longitude of the Moon at a given UTC instant.
+ * Returns degrees in range [0, 360).
+ *
+ * Uses Ecliptic(GeoMoon(t)).elon for the geocentric ecliptic longitude.
+ * EclipticLongitude(Body.Moon) returns heliocentric longitude, which is
+ * inappropriate for panchang calculations.
+ */
+declare function getSiderealMoonLongitude(date: Date, ayanamsaType: AyanamsaType): number;
+
+/**
+ * Compute the ayanamsa (precession offset) for a given UTC date.
+ *
+ * The ayanamsa is subtracted from the tropical (ecliptic) longitude to obtain
+ * the sidereal longitude used in Vedic astrology.
+ *
+ * @param date UTC date to evaluate.
+ * @param type Ayanamsa system: `'lahiri'` (default), `'raman'`, or `'krishnamurti'`.
+ * @returns    Ayanamsa value in degrees. Typical range ~23–24° for dates near J2000.
+ * @throws     `PanchangError` (INVALID_AYANAMSA) for unrecognised type strings.
+ *
+ * @example
+ * ```typescript
+ * import { getAyanamsa } from 'panchang-ts';
+ * getAyanamsa(new Date('2025-01-01T00:00:00Z'), 'lahiri'); // ~24.10
+ * ```
+ */
+declare function computeAyanamsa(date: Date, type?: AyanamsaType): number;
+
+/**
+ * Compute Rahu Kalam — the inauspicious period ruled by Rahu.
+ * Daytime is divided into 8 equal slots; the slot index varies by weekday.
+ *
+ * @param sunrise   UTC sunrise Date.
+ * @param sunset    UTC sunset Date.
+ * @param varaIndex Weekday index: 0 = Sunday, 6 = Saturday.
+ * @returns         `{ start, end }` UTC Dates for the Rahu Kalam period.
+ */
+declare function computeRahuKalam(sunrise: Date, sunset: Date, varaIndex: number): TimePeriod;
+/**
+ * Compute Gulika Kalam — the inauspicious period ruled by Saturn's son Gulika.
+ *
+ * @param sunrise   UTC sunrise Date.
+ * @param sunset    UTC sunset Date.
+ * @param varaIndex Weekday index: 0 = Sunday, 6 = Saturday.
+ * @returns         `{ start, end }` UTC Dates for the Gulika Kalam period.
+ */
+declare function computeGulikaKalam(sunrise: Date, sunset: Date, varaIndex: number): TimePeriod;
+/**
+ * Compute Yamaganda — the inauspicious period associated with Yama (death).
+ *
+ * @param sunrise   UTC sunrise Date.
+ * @param sunset    UTC sunset Date.
+ * @param varaIndex Weekday index: 0 = Sunday, 6 = Saturday.
+ * @returns         `{ start, end }` UTC Dates for the Yamaganda period.
+ */
+declare function computeYamaganda(sunrise: Date, sunset: Date, varaIndex: number): TimePeriod;
+
+/**
+ * Abhijit Muhurta: the 8th muhurta when daytime is divided into 15 equal parts.
+ * This is the most auspicious muhurta, centered around local noon.
+ *
+ * For a 12-hour day: each muhurta = 48 min. Abhijit = ~11:36 AM to 12:24 PM.
+ *
+ * @param sunrise Sunrise UTC Date
+ * @param sunset  Sunset UTC Date
+ */
+declare function computeAbhijitMuhurta(sunrise: Date, sunset: Date): TimePeriod;
+
+type PanchangErrorCode = 'INVALID_LATITUDE' | 'INVALID_LONGITUDE' | 'INVALID_ELEVATION' | 'INVALID_DATE' | 'INVALID_TIMEZONE' | 'INVALID_AYANAMSA' | 'TIMEZONE_RESOLUTION_FAILED' | 'NO_SUNRISE' | 'NO_SUNSET' | 'SEARCH_DIVERGED';
+declare class PanchangError extends Error {
+    readonly code: PanchangErrorCode;
+    constructor(message: string, code: PanchangErrorCode);
+}
+
+export { type AyanamsaType, type DailyKaranaInfo, type DailyNakshatraInfo, type DailyPanchangResult, type DailyTithiInfo, type DailyYogaInfo, type GeoLocation, type InstantPanchangOptions, type InstantPanchangResult, type KaranaInfo, type Language, type MasaInfo, type NakshatraInfo, PanchangError, type PanchangErrorCode, type PanchangOptions, type Precision, type TimePeriod, type TithiInfo, type VaraInfo, type YogaInfo, computeAbhijitMuhurta, computeGulikaKalam, computeRahuKalam, computeYamaganda, computeAyanamsa as getAyanamsa, getDailyPanchang, getInstantPanchang, getSiderealMoonLongitude, getSiderealSunLongitude, computeSunrise as getSunrise, computeSunset as getSunset };