import { DateType, CalendarMode } from '@mezzanine-ui/core/calendar';
/**
 * 管理日曆導航控制項狀態的 Hook。
 *
 * 維護目前顯示的參考日期（`referenceDate`）與顯示模式（`currentMode`），
 * 並提供上一頁、下一頁、雙箭頭跳轉以及切換至月份／年份選擇模式等操作。
 *
 * @example
 * ```tsx
 * import { useCalendarControls } from '@mezzanine-ui/react';
 *
 * const {
 *   currentMode, referenceDate,
 *   onPrev, onNext, onMonthControlClick, onYearControlClick, popModeStack,
 * } = useCalendarControls(today, 'day');
 * ```
 *
 * @see {@link Calendar} 搭配的元件
 */
export declare function useCalendarControls(referenceDateProp: DateType, mode?: CalendarMode): {
    currentMode: CalendarMode;
    onMonthControlClick: () => void;
    onNext: (() => void) | undefined;
    onPrev: (() => void) | undefined;
    onDoubleNext: (() => void) | undefined;
    onDoublePrev: (() => void) | undefined;
    onYearControlClick: () => void;
    popModeStack: () => void;
    referenceDate: string;
    updateReferenceDate: import("react").Dispatch<import("react").SetStateAction<string>>;
};