/**
 * src/saudi/calendar.ts
 * Saudi-specific calendar awareness — Hijri date, prayer times, Ramadan flag,
 * Ramadan-aware working hours.
 *
 * Hijri calendar uses Intl.DateTimeFormat with the Umm al-Qura locale, which
 * is the Saudi government standard. Prayer times use adhan (Pray Times Inc)
 * with the Umm al-Qura calculation method.
 *
 * Cities ship with built-in coordinates. Tenants outside this list pass
 * lat/lng explicitly via tenants.metadata.location.
 */
export declare function citySlug(name: string): string;
export declare function cityCoords(name: string): {
    lat: number;
    lng: number;
    tz: string;
} | null;
export type HijriDate = {
    year: number;
    monthNumber: number;
    monthAr: string;
    monthEn: string;
    day: number;
    isoLike: string;
    formattedAr: string;
};
export declare function hijriDate(date?: Date): HijriDate;
export declare function isRamadan(date?: Date): boolean;
export declare function isHajjSeason(date?: Date): boolean;
export type DailyPrayerTimes = {
    city: string;
    date: string;
    fajr: string;
    sunrise: string;
    dhuhr: string;
    asr: string;
    maghrib: string;
    isha: string;
    /** Window before the next prayer the agent should treat as "near صلاة". */
    nearPrayerWindowMinutes: number;
};
export declare function prayerTimes(cityName: string, date?: Date): DailyPrayerTimes | null;
/** Are we currently within `windowMinutes` of an upcoming prayer? */
export declare function isNearPrayer(cityName: string, windowMinutes?: number, now?: Date): {
    near: boolean;
    prayer: string | null;
    minutesUntil: number | null;
};
export type WorkingHoursToday = {
    isWorkingDay: boolean;
    open: string | null;
    close: string | null;
    ramadanAdjusted: boolean;
    hijri: HijriDate;
    /** Friday (5) is the weekend's center; Saudi work-week is Sun-Thu by default. */
    dayOfWeek: number;
};
export declare function workingHoursToday(configured?: {
    open?: string;
    close?: string;
    days?: number[];
}, now?: Date): WorkingHoursToday;
//# sourceMappingURL=calendar.d.ts.map