/**
 * 한국 공공데이터포털 공휴일 API 서비스
 */
import type { Holiday, LocaleCode } from '../types';
export declare class HolidayService {
    private serviceKey;
    private locale;
    constructor(serviceKey?: string, locale?: LocaleCode | string);
    /**
     * 특정 년월의 공휴일 데이터 조회
     */
    getHolidays(year: number, month: number): Promise<Holiday[]>;
    /**
     * 한국 로케일 확인
     */
    private isKoreanLocale;
    /**
     * 연도별 공휴일 데이터 가져오기
     */
    private fetchYearHolidays;
    /**
     * API URL 생성
     */
    private buildApiUrl;
    /**
     * API 응답 파싱
     */
    private parseResponse;
    /**
     * XML 오류 응답 확인
     */
    private isXmlError;
    /**
     * XML 오류 로깅
     */
    private logXmlError;
    /**
     * 월별 공휴일 필터링
     */
    private filterHolidaysByMonth;
    /**
     * 여러 개월의 공휴일 데이터 일괄 조회
     */
    getHolidaysForRange(startDate: Date, endDate: Date): Promise<Holiday[]>;
    /**
     * API 응답 데이터를 내부 Holiday 타입으로 변환
     */
    private transformApiData;
    /**
     * 공휴일 여부 확인
     */
    private isHolidayItem;
    /**
     * API 아이템을 Holiday 타입으로 변환
     */
    private convertToHoliday;
    /**
     * YYYYMMDD 형식을 YYYY-MM-DD 형식으로 변환
     */
    private formatDate;
    /**
     * 캐시 클리어
     */
    clearCache(): void;
}
export declare const holidayService: HolidayService;