/** 最早支持的农历年份（含农历 1890 年正月初一） */
declare const MIN_SUPPORTED_YEAR = 1890;
/** 最晚支持的农历年份（含农历 2100 年腊月） */
declare const MAX_SUPPORTED_YEAR = 2100;
/** 归一化后的农历日期结构，所有字段均不可变 */
interface LunarDate {
    /** 农历年份，范围为 MIN_SUPPORTED_YEAR - MAX_SUPPORTED_YEAR */
    readonly year: number;
    /** 农历月份，1 表示正月，12 表示腊月 */
    readonly month: number;
    /** 农历日期，1 表示初一，最大为 30 */
    readonly day: number;
    /** 是否为闰月（仅当年份存在闰月且该月为闰月时为 true） */
    readonly isLeapMonth: boolean;
}
/** 数组形式的农历日期输入：[year, month, day, isLeapMonth?] */
type LunarDateTuple = [number, number, number, boolean?];
/** 对象形式的农历日期输入，month/day 与 LunarDate 相同（1 基） */
interface LunarDateObject {
    /** 农历年份 */
    year: number;
    /** 农历月份，取值 1-12 */
    month: number;
    /** 农历日期，取值 1-30 */
    day: number;
    /** 可选闰月标记 */
    isLeapMonth?: boolean;
}
/** 支持对象或数组输入 */
type LunarDateInput = LunarDateObject | LunarDateTuple;
/** 以对象方式提供的公历日期字段（全部采用公历常见的 1 基月份） */
interface GregorianDateFields {
    /** 公历年，例如 2024 */
    year: number;
    /** 公历月，1-12 */
    month: number;
    /** 公历日，1-31（会按实际月份校验） */
    day: number;
}
/** 支持 Date、时间戳（毫秒）或对象字段 */
type GregorianDateInput = Date | number | GregorianDateFields;
/** 转换选项 */
interface ConversionOptions {
    /** IANA 时区 ID（默认 Asia/Shanghai），用于解释/输出 “本地” 日期 */
    timezone?: string;
}
/** 附加在结果上的元数据 */
interface ConversionMetadata {
    /** 实际使用的时区 ID */
    timezone: string;
}
interface ToLunarResult {
    /** 转换后的农历日期 */
    lunar: LunarDate;
    /** 归一化后的原始公历输入 */
    source: Date;
    /** 与转换相关的上下文信息 */
    metadata: ConversionMetadata;
}
interface ToGregorianResult {
    /** 转换后的公历日期（永远是 UTC 时间） */
    date: Date;
    /** 归一化后的农历输入 */
    source: LunarDate;
    /** 与转换相关的上下文信息 */
    metadata: ConversionMetadata;
}
/** 控制 formatLunar 输出的风格 */
type FormatLunarStyle = 'long' | 'short';
/** formatLunar 的配置选项 */
interface FormatLunarOptions {
    /** 控制“农历”前缀，可传入字符串或 false（禁用前缀） */
    prefix?: boolean | string;
    /** 是否输出天干地支。true/'year' 仅输出年份，'all' 预留后续扩展 */
    stemBranch?: boolean | 'year' | 'all';
    /** 是否附带生肖（默认 false）。输出格式为 “（龙）” */
    zodiac?: boolean;
    /** 闰月前缀，默认 “闰” */
    leapMarker?: string;
    /** 月份/日期文案风格（当前 long/short 一致，预留扩展） */
    style?: FormatLunarStyle;
    /** 预留多语言支持，目前仅支持 'zh-CN' */
    locale?: string;
}
/** formatLunarParts 返回的片段类型 */
type FormatLunarPartType = 'prefix' | 'yearStem' | 'yearBranch' | 'yearNumber' | 'yearZodiac' | 'literal' | 'month' | 'day';
interface FormatLunarPart {
    type: FormatLunarPartType;
    value: string;
}

declare function toLunar(input: GregorianDateInput, options?: ConversionOptions): ToLunarResult;
declare function toGregorian(input: LunarDateInput, options?: ConversionOptions): ToGregorianResult;

declare function createLunarDate(input: LunarDateInput): LunarDate;

declare function formatLunar(input: LunarDateInput | LunarDate, options?: FormatLunarOptions): string;
declare function formatLunarParts(input: LunarDateInput | LunarDate, options?: FormatLunarOptions): FormatLunarPart[];

declare class LunarError extends Error {
    constructor(message: string);
}
declare class InvalidLunarDateError extends LunarError {
    constructor(message: string);
}
declare class InvalidGregorianDateError extends LunarError {
    constructor(message: string);
}
declare class NotImplementedError extends LunarError {
    constructor(feature: string);
}

export { type ConversionMetadata, type ConversionOptions, type FormatLunarOptions, type FormatLunarPart, type FormatLunarPartType, type FormatLunarStyle, type GregorianDateFields, type GregorianDateInput, InvalidGregorianDateError, InvalidLunarDateError, type LunarDate, type LunarDateInput, type LunarDateObject, type LunarDateTuple, LunarError, MAX_SUPPORTED_YEAR, MIN_SUPPORTED_YEAR, NotImplementedError, type ToGregorianResult, type ToLunarResult, createLunarDate, formatLunar, formatLunarParts, toGregorian, toLunar };