@choice-ui/react 1.3.10

package/dist/core/app/components/calendar/dist/index.d.ts

@@ -0,0 +1,1119 @@
+import { default as React__default } from 'react';
+import { Locale, Quarter as Quarter$1, Day, isSameDay, isSameMonth, isSameYear, addMonths, startOfMonth, endOfMonth, startOfWeek, endOfWeek } from 'date-fns';
+import { TextFieldProps } from '@choice-ui/text-field';
+import { TZDate } from '@date-fns/tz';
+import { Locale as Locale$1 } from 'date-fns/locale';
+import { PressMoveProps } from '../../../../../shared/src';
+import * as React$1 from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * 日期格式字符串
+ *
+ * 支持所有 date-fns 格式字符串，常用格式示例：
+ *
+ * **年份**：
+ * - yyyy: 2025 (4位年份)
+ * - yy: 25 (2位年份)
+ *
+ * **月份**：
+ * - MMMM: December (完整月份名)
+ * - MMM: Dec (缩写月份名)
+ * - MM: 12 (2位数字月份)
+ * - M: 12 (1-2位数字月份)
+ *
+ * **日期**：
+ * - dd: 31 (2位日期)
+ * - d: 31 (1-2位日期)
+ *
+ * **常用组合**：
+ * - "yyyy-MM-dd" → 2025-12-31
+ * - "yy-MM-dd" → 25-12-31
+ * - "yyyy年MM月dd日" → 2025年12月31日
+ * - "yy年M月d日" → 25年12月31日
+ * - "MMMM dd, yyyy" → December 31, 2025
+ * - "MMM dd, yy" → Dec 31, 25
+ * - "MM/dd/yyyy" → 12/31/2025
+ * - "dd.MM.yy" → 31.12.25
+ *
+ * @see https://date-fns.org/v2.29.3/docs/format
+ */
+type DateDataFormat = string;
+/**
+ * 时间格式字符串
+ *
+ * 支持所有 date-fns 时间格式字符串，常用格式示例：
+ *
+ * **24小时制**：
+ * - "HH:mm" → 09:30, 14:45 (2位小时)
+ * - "H:mm" → 9:30, 14:45 (1-2位小时)
+ * - "HH:mm:ss" → 09:30:15 (带秒)
+ * - "HHmm" → 0930, 1445 (紧凑格式)
+ *
+ * **12小时制**：
+ * - "h:mm a" → 9:30 AM, 2:45 PM
+ * - "hh:mm a" → 09:30 AM, 02:45 PM (2位小时)
+ * - "h:mm aa" → 9:30 A.M., 2:45 P.M. (完整AM/PM)
+ * - "h:mm:ss a" → 9:30:15 AM (带秒)
+ *
+ * @see https://date-fns.org/v2.29.3/docs/format
+ */
+type TimeDataFormat = string;
+
+/**
+ * 时间对象（小时和分钟）
+ */
+interface Time {
+    hour: number;
+    minute: number;
+}
+/**
+ * 时间布局模式
+ */
+type TimeLayout = "single" | "dual";
+/**
+ * 时间输入解析结果
+ */
+interface TimeInputValue {
+    /** 解析错误信息 */
+    error: string | null;
+    /** 格式化后的显示值 */
+    formatted: string;
+    /** 原始输入值 */
+    input: string;
+    /** 是否为有效时间 */
+    isValid: boolean;
+    /** 解析后的时间 Date 对象 */
+    time: Date | null;
+}
+/**
+ * 时间解析选项
+ */
+interface TimeParserOptions {
+    /** 时间格式 */
+    format: TimeDataFormat;
+    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    locale?: Locale | string;
+    /** 严格模式 */
+    strict?: boolean;
+}
+/**
+ * 时间组件的基础属性
+ */
+interface BaseTimeProps {
+    /** 默认值 */
+    defaultValue?: Date | null;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 时间格式，支持所有 date-fns 格式字符串 */
+    format?: TimeDataFormat;
+    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    locale?: Locale | string;
+    /** 最大时间 */
+    maxTime?: Date;
+    /** 最小时间 */
+    minTime?: Date;
+    /** 时间变化回调 */
+    onChange?: (time: Date | null) => void;
+    /** 是否只读（禁用选择但不改变样式） */
+    readOnly?: boolean;
+    /** 当前选中的时间 */
+    value?: Date | null;
+}
+/**
+ * 时间步长相关属性
+ */
+interface StepProps {
+    /** Meta/Ctrl + 按键的步长（分钟），默认60分钟 */
+    metaStep?: number;
+    /** Shift + 按键的步长（分钟），默认15分钟 */
+    shiftStep?: number;
+    /** 基础步长（分钟），默认1分钟 */
+    step?: number;
+}
+/**
+ * 时间交互功能属性
+ */
+interface TimeInteractionProps {
+    /** 是否启用解析缓存 */
+    enableCache?: boolean;
+    /** 是否启用键盘导航（默认启用） */
+    enableKeyboardNavigation?: boolean;
+    /** 是否启用性能分析 */
+    enableProfiling?: boolean;
+    /** 按下 Enter 键的回调 */
+    onEnterKeyDown?: () => void;
+}
+/**
+ * 时间选项项
+ */
+interface TimeOptionItem {
+    disabled?: boolean;
+    label: string;
+    value: Time;
+}
+interface SmartInputOptions {
+    /** 去抖延迟（毫秒） */
+    debounceMs?: number;
+    /** 是否启用自动完成 */
+    enableAutoComplete?: boolean;
+    /** 是否启用键盘导航 */
+    enableKeyboardNavigation?: boolean;
+    /** 是否启用实时验证 */
+    enableLiveValidation?: boolean;
+    /** 是否显示解析预览 */
+    showParsePreview?: boolean;
+}
+/**
+ * 日期范围对象
+ */
+interface DateRange {
+    end: Date;
+    start: Date;
+}
+/**
+ * 一周开始的日期
+ */
+type WeekStartsOn = Day;
+/**
+ * 日期比较模式
+ */
+type DateComparisonMode$1 = "exact-time" | "date-only";
+/**
+ * 日历选择值的类型
+ */
+type CalendarValue = Date | Date[] | DateRange | null;
+/**
+ * 选择模式
+ */
+type SelectionMode = "single" | "multiple" | "range";
+/**
+ * 日期输入解析结果
+ */
+interface DateInputValue {
+    /** 解析后的日期对象 */
+    date: Date | null;
+    /** 解析错误信息 */
+    error: string | null;
+    /** 格式化后的显示值 */
+    formatted: string;
+    /** 原始输入值 */
+    input: string;
+    /** 是否为有效日期 */
+    isValid: boolean;
+}
+/**
+ * 日期解析选项
+ */
+interface DateParserOptions {
+    /** 是否启用自然语言解析 */
+    enableNaturalLanguage?: boolean;
+    /** 是否启用相对日期解析 */
+    enableRelativeDate?: boolean;
+    /** 是否启用智能修正 */
+    enableSmartCorrection?: boolean;
+    /** 日期格式 */
+    format: DateDataFormat;
+    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    locale?: Locale | string;
+    /** 最大日期 */
+    maxDate?: Date;
+    /** 最小日期 */
+    minDate?: Date;
+    /** 严格模式（不允许无效日期） */
+    strict?: boolean;
+}
+/**
+ * 自然语言关键词映射
+ */
+interface NaturalLanguageMap {
+    afternoon: string[];
+    evening: string[];
+    lastMonth: string[];
+    lastWeek: string[];
+    lastYear: string[];
+    morning: string[];
+    nextMonth: string[];
+    nextWeek: string[];
+    nextYear: string[];
+    night: string[];
+    now: string[];
+    thisMonth: string[];
+    thisWeek: string[];
+    thisYear: string[];
+    today: string[];
+    tomorrow: string[];
+    yesterday: string[];
+}
+/**
+ * 相对日期模式
+ */
+interface RelativeDatePattern {
+    multiplier: number;
+    pattern: RegExp;
+    type: "day" | "week" | "month" | "year";
+}
+/**
+ * 日期组件的基础属性
+ */
+interface BaseDateProps {
+    /** 默认值 */
+    defaultValue?: Date | null;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 日期格式，支持所有 date-fns 格式字符串 */
+    format?: DateDataFormat;
+    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    locale?: Locale | string;
+    /** 最大日期 */
+    maxDate?: Date;
+    /** 最小日期 */
+    minDate?: Date;
+    /** 日期变化回调 */
+    onChange?: (date: Date | null) => void;
+    /** 当前选中的日期 */
+    value?: Date | null;
+}
+/**
+ * 日期交互功能属性
+ */
+interface DateInteractionProps {
+    /** 是否启用解析缓存 */
+    enableCache?: boolean;
+    /** 是否启用键盘导航（默认启用） */
+    enableKeyboardNavigation?: boolean;
+    /** 是否启用预测功能 */
+    enablePrediction?: boolean;
+    /** 是否启用性能分析 */
+    enableProfiling?: boolean;
+    /** 按下 Enter 键的回调 */
+    onEnterKeyDown?: () => void;
+}
+/**
+ * 月历组件的基础属性
+ */
+interface BaseCalendarProps {
+    children?: React.ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 当前显示的月份 */
+    currentMonth?: Date;
+    /** 日期比较模式 */
+    dateComparisonMode?: DateComparisonMode$1;
+    /** 非受控模式的默认值 */
+    defaultValue?: CalendarValue;
+    /** 禁用的日期数组 */
+    disabledDates?: Date[];
+    /** 是否固定6行显示（42天），默认true确保高度一致 */
+    fixedGrid?: boolean;
+    /** 需要高亮的日期数组 */
+    highlightDates?: Date[];
+    /** 是否高亮今天 */
+    highlightToday?: boolean;
+    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    locale?: Locale | string;
+    /** 最大可选日期 */
+    maxDate?: Date;
+    /** 最小可选日期 */
+    minDate?: Date;
+    /** 值变更回调 */
+    onChange?: (value: CalendarValue) => void;
+    /** 月份变更回调 */
+    onMonthChange?: (month: Date) => void;
+    /** 是否只读（禁用选择但不改变样式） */
+    readOnly?: boolean;
+    /** 选择模式，如果未指定，会根据 value 类型自动推断 */
+    selectionMode?: SelectionMode;
+    /** 是否显示非当前月份的日期 */
+    showOutsideDays?: boolean;
+    /** 是否显示周数，默认false */
+    showWeekNumbers?: boolean;
+    /** 时区 */
+    timeZone?: string;
+    /** 受控模式的值 */
+    value?: CalendarValue;
+    /** 一周开始的日期（0=周日, 1=周一） */
+    weekStartsOn?: WeekStartsOn;
+    /** 自定义星期名称 */
+    weekdayNames?: string[];
+}
+/**
+ * 月历布局相关属性
+ */
+interface CalendarLayoutProps {
+    /** 方向 */
+    direction?: "horizontal" | "vertical";
+    /** 变体样式 */
+    variant?: "default" | "dark";
+}
+/**
+ * 日历状态接口
+ */
+interface CalendarState {
+    isSingleDay: boolean;
+    selectedRange: {
+        end: Date;
+        endTime: Time;
+        start: Date;
+        startTime: Time;
+    } | null;
+}
+/**
+ * 季度对象
+ */
+interface Quarter {
+    label: string;
+    months: string[];
+    quarter: Quarter$1;
+    year: number;
+}
+/**
+ * 季度项目状态
+ */
+interface QuarterItem {
+    isCurrent: boolean;
+    isDisabled: boolean;
+    isInRange: boolean;
+    isSelected: boolean;
+    quarter: Quarter;
+}
+/**
+ * 年份项目状态
+ */
+interface YearItem {
+    isCurrent: boolean;
+    isDisabled: boolean;
+    isInRange: boolean;
+    isSelected: boolean;
+    year: Date;
+}
+/**
+ * 季度组件的基础属性
+ */
+interface BaseQuarterProps {
+    children?: React.ReactNode;
+    /** 当前显示的年份 */
+    currentYear?: number;
+    /** 默认值 */
+    defaultValue?: Quarter;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 禁用的季度数组 */
+    disabledQuarters?: Array<{
+        quarter: number;
+        year: number;
+    }>;
+    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    locale?: Locale | string;
+    /** 最大可选年份 */
+    maxYear?: number;
+    /** 最小可选年份 */
+    minYear?: number;
+    /** 季度选择变化回调 */
+    onChange?: (quarter: Quarter | null) => void;
+    /** 是否只读（禁用选择但不改变样式） */
+    readOnly?: boolean;
+    /** 显示的年份 */
+    startYear?: number;
+    /** 当前选中的季度 */
+    value?: Quarter | null;
+}
+/**
+ * 季度导航相关属性
+ */
+interface QuarterNavigationProps {
+    /** 年份范围导航回调 */
+    onNavigate?: (direction: "prev" | "next", newYear: number) => void;
+}
+/**
+ * 季度布局相关属性
+ */
+interface QuarterLayoutProps {
+    /** 自定义类名 */
+    className?: string;
+    /** 变体样式 */
+    variant?: "default" | "dark";
+}
+/**
+ * 年份组件的基础属性
+ */
+interface BaseYearProps {
+    children?: React.ReactNode;
+    /** 当前显示的年份（用于高亮） */
+    currentYear?: Date;
+    /** 默认值 */
+    defaultValue?: Date;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 禁用的年份数组 */
+    disabledYears?: Date[];
+    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    locale?: Locale | string;
+    /** 最大可选年份 */
+    maxYear?: Date;
+    /** 最小可选年份 */
+    minYear?: Date;
+    /** 年份选择变化回调 */
+    onChange?: (year: Date | null) => void;
+    /** 是否只读（禁用选择但不改变样式） */
+    readOnly?: boolean;
+    /** 显示年份范围的起始年份，默认为当前年份-10 */
+    startYear?: Date;
+    /** 当前选中的年份 */
+    value?: Date | null;
+    /** 显示年份的数量，默认12个 */
+    yearCount?: number;
+}
+/**
+ * 年份导航相关属性
+ */
+interface YearNavigationProps {
+    /** 年份范围导航回调 */
+    onNavigate?: (direction: "prev" | "next", newStartYear: Date) => void;
+}
+/**
+ * 年份布局相关属性
+ */
+interface YearLayoutProps {
+    /** 自定义类名 */
+    className?: string;
+    /** 变体样式 */
+    variant?: "default" | "dark";
+}
+
+interface MonthCalendarProps extends BaseCalendarProps, CalendarLayoutProps {
+}
+declare const MonthCalendar: React$1.NamedExoticComponent<MonthCalendarProps>;
+
+interface DateInputProps extends Omit<TextFieldProps, "value" | "onChange" | "format"> {
+    /**
+     * Whether to enable cache
+     * @default true
+     */
+    enableCache?: boolean;
+    /**
+     * Whether to enable keyboard navigation (default enabled)
+     *
+     * Keyboard shortcuts:
+     * - ↑ key: Decrease 1 day (past)
+     * - ↓ key: Increase 1 day (future)
+     * - Shift + ↑ key: Decrease 1 week
+     * - Shift + ↓ key: Increase 1 week
+     * - Ctrl/Cmd + ↑ key: Decrease 1 month
+     * - Ctrl/Cmd + ↓ key: Increase 1 month
+     * - Enter key: Confirm input
+     * @default true
+     */
+    enableKeyboardNavigation?: boolean;
+    /**
+     * Whether to enable intelligent prediction
+     * @default false
+     */
+    enablePrediction?: boolean;
+    /**
+     * Whether to enable performance analysis
+     * @default false
+     */
+    enableProfiling?: boolean;
+    format?: DateDataFormat;
+    locale?: Locale | string;
+    maxDate?: Date;
+    minDate?: Date;
+    onChange?: (date: Date | null) => void;
+    onEnterKeyDown?: () => void;
+    prefixElement?: React__default.ReactNode;
+    suffixElement?: React__default.ReactNode;
+    value?: Date | null;
+}
+/**
+ * Advanced date input component
+ *
+ * Features:
+ * - 🎯 Intelligent date parsing: Supports multiple formats and natural language
+ * - ⌨️ Keyboard navigation: Up key to past, down key to future (intuitive operation)
+ * - 🔄 Race protection: Smartly detect data flow direction, avoid loop updates
+ * - 🛡️ Type safety: Complete TypeScript support
+ * - 🌍 Internationalization support: Configurable language region
+ * - 💡 Intelligent prediction: Real-time prediction prompts and holiday recognition
+ */
+declare const DateInput: React__default.ForwardRefExoticComponent<Omit<DateInputProps, "ref"> & React__default.RefAttributes<HTMLInputElement>>;
+
+interface DateRangeInputProps extends Omit<TextFieldProps, "value" | "onChange" | "step" | "defaultValue"> {
+    endDisabled?: boolean;
+    endPlaceholder?: string;
+    endSuffixElement?: React.ReactNode;
+    endValue?: Date | null;
+    format?: DateDataFormat;
+    locale?: Locale | string;
+    maxDate?: Date;
+    minDate?: Date;
+    onEndChange?: (date: Date | null) => void;
+    onEndFocus?: () => void;
+    onEnterKeyDown?: () => void;
+    onStartChange?: (date: Date | null) => void;
+    onStartFocus?: () => void;
+    /**
+     * 范围长度显示精度，控制范围计算的最小单位
+     * @default 1 - 最小单位为1天
+     * @example 0.5 - 最小单位为0.5天（半天）
+     * @example 0.1 - 最小单位为0.1天（2.4小时）
+     * @example 0.25 - 最小单位为0.25天（6小时）
+     */
+    rangePrecision?: number;
+    startDisabled?: boolean;
+    startPlaceholder?: string;
+    startSuffixElement?: React.ReactNode;
+    startValue?: Date | null;
+}
+declare const DateRangeInput: (props: DateRangeInputProps) => react_jsx_runtime.JSX.Element;
+
+interface TimeCalendarProps extends BaseTimeProps, StepProps {
+    children?: React__default.ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 小时步进，默认1小时 */
+    hourStep?: number;
+    /** 分钟步进，默认15分钟 */
+    minuteStep?: number;
+}
+declare const TimeCalendar: React__default.NamedExoticComponent<TimeCalendarProps>;
+
+interface TimeInputProps extends Omit<TextFieldProps, "value" | "onChange" | "format" | "defaultValue" | "step">, BaseTimeProps, StepProps, TimeInteractionProps {
+    prefixElement?: React__default.ReactNode;
+    suffixElement?: React__default.ReactNode;
+}
+/**
+ * 高级时间输入组件
+ *
+ * 特性：
+ * - 🎯 智能时间解析：支持多种格式和自然语言
+ * - ⌨️ 键盘导航：上键减少，下键增加（符合列表导航逻辑）
+ * - 🔄 竞态保护：智能检测数据流方向，避免循环更新
+ * - 🚀 性能优化：使用 useEventCallback 和缓存机制
+ * - 🛡️ 类型安全：完整的 TypeScript 支持
+ * - 🌍 国际化支持：可配置语言区域
+ * - 📱 拖拽交互：支持通过前缀图标拖拽调整时间
+ */
+declare const TimeInput: React__default.ForwardRefExoticComponent<Omit<TimeInputProps, "ref"> & React__default.RefAttributes<HTMLInputElement>>;
+
+interface TimeRangeInputProps extends Omit<TextFieldProps, "value" | "onChange" | "step" | "defaultValue"> {
+    endDisabled?: boolean;
+    endPlaceholder?: string;
+    endSuffixElement?: React.ReactNode;
+    endValue?: Date | null;
+    format?: TimeDataFormat;
+    locale?: Locale | string;
+    maxTime?: Date;
+    minTime?: Date;
+    onEndChange?: (time: Date | null) => void;
+    onEndFocus?: () => void;
+    onEnterKeyDown?: () => void;
+    onStartChange?: (time: Date | null) => void;
+    onStartFocus?: () => void;
+    startDisabled?: boolean;
+    startPlaceholder?: string;
+    startSuffixElement?: React.ReactNode;
+    startValue?: Date | null;
+}
+declare const TimeRangeInput: (props: TimeRangeInputProps) => react_jsx_runtime.JSX.Element;
+
+interface QuarterCalendarProps extends BaseQuarterProps, QuarterNavigationProps, QuarterLayoutProps {
+}
+declare const QuarterCalendar: React$1.ForwardRefExoticComponent<QuarterCalendarProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface YearCalendarProps extends BaseYearProps, YearNavigationProps, YearLayoutProps {
+}
+declare const YearCalendar: React$1.ForwardRefExoticComponent<YearCalendarProps & React$1.RefAttributes<HTMLDivElement>>;
+
+declare const dateUtils: {
+    now: () => Date;
+    isSameDay: typeof isSameDay;
+    isSameMonth: typeof isSameMonth;
+    isSameYear: typeof isSameYear;
+    addMonths: typeof addMonths;
+    startOfMonth: typeof startOfMonth;
+    endOfMonth: typeof endOfMonth;
+    startOfWeek: typeof startOfWeek;
+    endOfWeek: typeof endOfWeek;
+};
+declare function generateWeekdayNames(locale?: Locale | string, weekStartsOn?: number): string[];
+declare function generateCalendarDays(currentMonth: Date, weekStartsOn?: number, fixedGrid?: boolean): Date[];
+declare function formatMonthTitle(date: Date, locale?: Locale | string): string;
+declare function calculateWeekNumbers(calendarDays: Date[], locale?: Locale | string): number[];
+/**
+ * 根据值类型推断选择模式
+ */
+declare function inferSelectionMode(value: CalendarValue): SelectionMode;
+/**
+ * 从 CalendarValue 推断应该显示的月份
+ */
+declare function inferMonthFromValue(value: CalendarValue): Date | null;
+/**
+ * 比较两个 CalendarValue 是否相等（支持时区感知和比较精度）
+ */
+declare function isCalendarValueEqual(a: CalendarValue, b: CalendarValue, timeZone?: string, dateComparisonMode?: "exact-time" | "date-only"): boolean;
+
+declare const LOCALE_MAP: Record<string, Locale>;
+/**
+ * 🔧 安全的 locale 解析函数
+ *
+ * 支持以下输入格式：
+ * - Locale 对象：直接返回
+ * - 字符串：自动映射到对应的 Locale 对象
+ * - 无效值：返回中文 locale (zhCN)
+ *
+ * @param locale - 可以是 Locale 对象或字符串
+ * @returns 解析后的 Locale 对象
+ *
+ * @example
+ * ```ts
+ * resolveLocale("zh-CN") // → zhCN
+ * resolveLocale("en-US") // → enUS
+ * resolveLocale(enUS) // → enUS
+ * resolveLocale("invalid") // → zhCN (with warning)
+ * ```
+ */
+declare function resolveLocale(locale: Locale | string | undefined | null): Locale;
+/**
+ * 🔍 获取所有支持的 locale 列表
+ * @returns 支持的 locale 字符串数组
+ */
+declare function getSupportedLocales(): string[];
+/**
+ * 🎯 检查是否为中文 locale
+ * @param locale - Locale 对象或字符串
+ * @returns 是否为中文
+ */
+declare function isChineseLocale(locale: Locale | string | undefined | null): boolean;
+
+/**
+ * 日期比较精度模式
+ * - 'exact-time': 精确时间比较（包含时、分、秒、毫秒）
+ * - 'date-only': 仅日期比较（忽略时间部分，比较年、月、日）
+ */
+type DateComparisonMode = "exact-time" | "date-only";
+/**
+ * 时区感知的日期部分
+ */
+interface DateParts {
+    /** 日期（1-31） */
+    day: number;
+    /** 月份（0-11） */
+    month: number;
+    /** 星期几（0-6，0为周日） */
+    weekday: number;
+    /** 年份 */
+    year: number;
+}
+/**
+ * 创建时区上下文选项（用于 date-fns 4.0+）
+ */
+declare function createTimeZoneContext(timeZone?: string): {
+    in: (value: Date | number | string) => TZDate;
+} | undefined;
+/**
+ * 时区感知的日期比较（仅比较日期部分）
+ *
+ * @param date1 第一个日期
+ * @param date2 第二个日期
+ * @param timeZone 时区（可选，默认使用本地时区）
+ * @returns 是否为同一天
+ *
+ * @example
+ * ```typescript
+ * const date1 = new Date('2025-01-15T23:30:00Z')    // UTC
+ * const date2 = new Date('2025-01-16T08:30:00+09:00') // JST (同一天)
+ * isSameDayInTimeZone(date1, date2, 'Asia/Tokyo') // true
+ * ```
+ */
+declare function isSameDayInTimeZone(date1: Date, date2: Date, timeZone?: string): boolean;
+/**
+ * 时区感知的月份比较
+ */
+declare function isSameMonthInTimeZone(date1: Date, date2: Date, timeZone?: string): boolean;
+/**
+ * 时区感知的年份比较
+ */
+declare function isSameYearInTimeZone(date1: Date, date2: Date, timeZone?: string): boolean;
+/**
+ * 时区感知的星期比较
+ */
+declare function isSameWeekInTimeZone(date1: Date, date2: Date, timeZone?: string): boolean;
+/**
+ * 时区感知的今天判断
+ */
+declare function isTodayInTimeZone(date: Date, timeZone?: string): boolean;
+/**
+ * 判断日期是否在指定范围内（支持时区和比较模式）
+ *
+ * @param date 要检查的日期
+ * @param rangeStart 范围开始日期
+ * @param rangeEnd 范围结束日期
+ * @param timeZone 时区（可选）
+ * @param mode 比较模式（默认仅日期）
+ * @returns 是否在范围内
+ *
+ * @example
+ * ```typescript
+ * const date = new Date('2025-01-15T14:30:00')
+ * const start = new Date('2025-01-10T00:00:00')
+ * const end = new Date('2025-01-20T23:59:59')
+ *
+ * isWithinRange(date, start, end, 'Asia/Shanghai', 'date-only') // true
+ * ```
+ */
+declare function isWithinRange(date: Date, rangeStart: Date, rangeEnd: Date, timeZone?: string, mode?: DateComparisonMode): boolean;
+/**
+ * 获取时区感知的详细日期部分
+ */
+declare function getDateParts(date: Date, timeZone?: string): DateParts;
+/**
+ * 获取日期的唯一键（用于 Map/Set 等数据结构）
+ *
+ * @param date 日期对象
+ * @param timeZone 时区（可选）
+ * @param includeTime 是否包含时间部分（默认false）
+ * @returns 格式化的日期键
+ *
+ * @example
+ * ```typescript
+ * getDateKey(new Date('2025-01-15'), 'Asia/Shanghai') // "2025-01-15"
+ * getDateKey(new Date('2025-01-15T14:30:00'), 'Asia/Shanghai', true) // "2025-01-15T14:30:00"
+ * ```
+ */
+declare function getDateKey(date: Date, timeZone?: string, includeTime?: boolean): string;
+/**
+ * 批量比较日期数组是否相等（时区感知）
+ */
+declare function areDatesEqual(dates1: Date[], dates2: Date[], timeZone?: string, mode?: DateComparisonMode): boolean;
+/**
+ * 清除时区日期缓存（用于测试或内存管理）
+ */
+declare function clearTimeZoneCache(): void;
+
+declare function parseMonthName(input: string, locale?: string): number | null;
+declare const englishMonths: Record<string, number>;
+declare const chineseMonths: Record<string, number>;
+
+declare function validateDateRange(date: Date, minDate?: Date, maxDate?: Date): boolean;
+declare function validateTimeRange(time: string, minTime?: string, maxTime?: string): boolean;
+declare function isValidDateExists(year: number, month: number, day: number): boolean;
+declare function getLastDayOfMonth(year: number, month: number): number;
+declare function smartCorrectDate(year: number, month: number, day: number): {
+    day: number;
+    month: number;
+    year: number;
+};
+declare function smartCorrectYear(year: number): number;
+declare function quickValidateDate(date: Date): boolean;
+
+declare function handleShortcuts(input: string): Date | null;
+
+declare function parseRelativeDate(input: string): Date | null;
+declare function parseExtendedRelativeDate(input: string): Date | null;
+
+declare function parseNaturalLanguage(input: string, localeKey?: string): Date | null;
+declare function getLocaleKey(locale?: Locale): string;
+
+declare function parseEnglishDate(input: string): Date | null;
+
+declare function getLocale(localeKey?: string): Locale;
+declare function detectDateFormat(input: string): DateDataFormat;
+
+type ParseResult = Date | null;
+type DetailedParseResult = DateInputValue;
+interface ParseOptions {
+    /** 是否返回详细信息 */
+    detailed?: boolean;
+    /** 是否启用自然语言解析 */
+    enableNaturalLanguage?: boolean;
+    /** 是否启用相对日期解析 */
+    enableRelativeDate?: boolean;
+    /** 是否启用智能修正 */
+    enableSmartCorrection?: boolean;
+    /** 目标格式 */
+    format?: DateDataFormat;
+    /** 语言环境 */
+    locale?: Locale;
+    /** 是否严格模式 */
+    strict?: boolean;
+}
+/**
+ * 统一的日期解析器 - 合并了原来的 tryRelaxedParsing 和 smartParseDate
+ *
+ * 解析策略按优先级排序（修正为正确的优先级）：
+ * 1. 标准格式解析 - 严格按照指定格式解析
+ * 2. 智能数字解析（核心功能） - 纯数字输入的智能猜测 [最重要]
+ * 3. 快捷键解析 - today, tomorrow, yesterday 等
+ * 4. 扩展相对日期解析 - "3 days ago", "next week" 等
+ * 5. 自然语言解析 - "今天", "明天", "下周三" 等
+ * 6. 相对日期解析 - "+3d", "-1w" 等简短格式
+ * 7. 英文日期解析 - "Jan 15, 2024", "March 3rd" 等
+ * 8. 常见格式尝试 - 尝试其他常用日期格式
+ */
+declare function parseDate(input: string, options: ParseOptions & {
+    detailed: true;
+}): DetailedParseResult;
+declare function parseDate(input: string, options?: ParseOptions): ParseResult;
+/**
+ * 输入预测和补全信息 - 为用户提供输入提示（修正3位数字逻辑）
+ *
+ * 根据当前输入预测用户可能想要的日期，并提供中文描述
+ * 主要用于输入提示和自动补全功能
+ */
+declare function getPredictionInfo(input: string, targetFormat: DateDataFormat): {
+    description: string;
+    prediction: string;
+} | null;
+declare const tryRelaxedParsing: (input: string, format: DateDataFormat, locale?: Locale) => ParseResult;
+declare const smartParseDate: (input: string, options: DateParserOptions) => DateInputValue;
+
+interface PredictionResult {
+    /** 置信度 (0-1) */
+    confidence: number;
+    /** 描述信息 */
+    description: string;
+    /** 预测的日期字符串 */
+    prediction: string;
+    /** 预测类型 */
+    type: "numeric" | "shortcut" | "relative" | "parsed";
+}
+/**
+ * 增强的智能预测功能
+ * 直接使用 parseDate 函数，确保预测结果与实际格式化100%一致
+ */
+declare function getEnhancedPrediction(input: string, targetFormat?: DateDataFormat): PredictionResult | null;
+
+/**
+ * 数字解析统一工具函数
+ * 用于消除parsers中的重复代码
+ */
+/** 提取纯数字字符串 */
+declare function extractDigits(input: string): string;
+/** 数字段提取器 */
+declare class DigitExtractor {
+    private digits;
+    constructor(digits: string);
+    /** 提取指定位置的数字 */
+    extract(start: number, length: number): number;
+    /** 提取年份 (前2位) */
+    getYear2(): number;
+    /** 提取年份 (前4位) */
+    getYear4(): number;
+    /** 提取月份 (前2位) */
+    getMonth(): number;
+    /** 提取日期 (第3-4位) */
+    getDay(): number;
+    /** 提取6位数字的各个部分 (YYMMDD格式) */
+    getYYMMDD(): {
+        day: number;
+        month: number;
+        year: number;
+    };
+    /** 提取8位数字的各个部分 (YYYYMMDD格式) */
+    getYYYYMMDD(): {
+        day: number;
+        month: number;
+        year: number;
+    };
+    /** 提取3位数字的各个部分 */
+    get3DigitParts(): {
+        first: number;
+        lastTwo: number;
+    };
+}
+/** 年份转换工具 */
+declare function convertTwoDigitYear(year: number): number;
+/** 检查是否为有效的月日组合 */
+declare function isValidMonthDay(month: number, day: number): boolean;
+/** 检查3位数字是否可以解释为月日 */
+declare function canBeMonthDay(firstDigit: number, lastTwoDigits: number): boolean;
+/** 检查是否为合理的年份 */
+declare function isReasonableYear(year: number): boolean;
+/** 数字解析结果 */
+interface NumericParseResult {
+    day: number;
+    formatted: string;
+    month: number;
+    year: number;
+}
+/** 通用的6位数字解析器 (YYMMDD) */
+declare function parseYYMMDD(digits: string, targetFormat: string): NumericParseResult | null;
+/** 通用的8位数字解析器 (YYYYMMDD) */
+declare function parseYYYYMMDD(digits: string, targetFormat: string): NumericParseResult | null;
+/** 智能的3位数字解析器 */
+declare function parse3Digits(digits: string, currentYear: number, targetFormat: string): NumericParseResult | null;
+
+declare const yearUtils: {
+    extractYear(input: Date | number | undefined): number | undefined;
+    /** 创建年份的开始日期 */
+    createYearDate(year: number): Date;
+    /** 获取当前年份 */
+    getCurrentYear(): number;
+    /** 验证年份是否在有效范围内 */
+    isYearInRange(year: number, minYear?: number, maxYear?: number): boolean;
+};
+
+declare const quarterUtils: {
+    /** 安全地从各种输入中提取年份数字 */
+    extractYear(input: Date | number | undefined): number | undefined;
+    /** 获取当前年份 */
+    getCurrentYear(): number;
+    /** 获取当前季度数字 (1-4) */
+    getCurrentQuarterNumber(): Quarter$1;
+    /** 验证年份是否在有效范围内 */
+    isYearInRange(year: number, minYear?: number, maxYear?: number): boolean;
+    /** 创建季度的开始日期 */
+    createQuarterStartDate(quarter: number, year: number): Date;
+    /** 创建季度的结束日期 */
+    createQuarterEndDate(quarter: number, year: number): Date;
+};
+/** 获取季度的月份名称 */
+declare function getQuarterMonths(quarter: number, locale?: Locale | string): string[];
+/** 创建季度对象 */
+declare function createQuarter(quarter: Quarter$1, year: number, locale?: Locale | string): Quarter;
+/** 获取当前季度 */
+declare function getCurrentQuarter(year?: number, locale?: Locale | string): Quarter;
+/** 获取年份的所有季度 */
+declare function getYearQuarters(year: number, locale?: Locale | string): Quarter[];
+/** 检查两个季度是否相等 */
+declare function isQuarterEqual(quarter1: Quarter, quarter2: Quarter): boolean;
+/** 格式化季度显示 */
+declare function formatQuarter(quarter: Quarter): string;
+/** 获取季度的日期范围 */
+declare function getQuarterDateRange(quarter: Quarter): {
+    end: Date;
+    start: Date;
+};
+
+/**
+ * 将 Date 对象转换为时间字符串 (HH:mm)
+ * @param date - Date 对象
+ * @returns 时间字符串，格式为 "HH:mm"，如果 date 为 null 则返回 null
+ */
+declare function dateToTimeString(date: Date | null): string | null;
+/**
+ * 将时间字符串转换为 Date 对象（今天的日期 + 指定时间）
+ * @param timeStr - 时间字符串，格式为 "HH:mm"
+ * @returns Date 对象，包含今天的日期和指定的时间
+ */
+declare function timeStringToDate(timeStr: string): Date;
+/**
+ * 将任意 Date 值标准化为时间字符串格式
+ * @param value - Date 对象或 null
+ * @returns 标准化的时间字符串 (HH:mm) 或 null
+ */
+declare function normalizeTimeValue(value: Date | null | undefined): string | null;
+declare function smartParseTimeValue(input: string, options: TimeParserOptions): TimeInputValue;
+declare function tryRelaxedTimeParsing(input: string, targetFormat: TimeDataFormat, locale: Locale | string): string | null;
+declare function createTimeValue(hour: number, minute: number): Time;
+declare function timeToDate(time: Time): Date;
+declare function dateToTime(date: Date): Time;
+declare function formatTimeValue(time: Time, timeFormat?: TimeDataFormat, locale?: Locale): string;
+declare function formatHourValue(hour: number, timeFormat?: TimeDataFormat, locale?: Locale): string;
+declare function formatMinuteValue(minute: number): string;
+declare function generateHourOptions(hourStep?: number, timeFormat?: TimeDataFormat, locale?: Locale): Array<{
+    label: string;
+    value: number;
+}>;
+declare function generateMinuteOptions(minuteStep?: number): Array<{
+    label: string;
+    value: number;
+}>;
+declare function isTimeEqual(time1: Time, time2: Time): boolean;
+declare function findClosestValidTime(time: Time, minuteStep?: number, hourStep?: number): Time;
+declare const generateTimeOptions: (format: TimeDataFormat, step?: number) => {
+    label: string;
+    value: string;
+}[];
+declare const createTimeToday: (hours: number, minutes?: number) => Date;
+
+declare const defaultLocaleMap: Record<string, Locale$1>;
+declare const naturalLanguageMap: Record<string, NaturalLanguageMap>;
+declare const relativeDatePatterns: RelativeDatePattern[];
+declare const commonDateFormats: string[];
+declare const commonTimeFormats: string[];
+declare const parserConfig: {
+    priority: {
+        digits: number;
+        shortcuts: number;
+        standardFormat: number;
+        naturalLanguage: number;
+        relativeDate: number;
+        englishDate: number;
+        fuzzyMatch: number;
+    };
+    cache: {
+        enabled: boolean;
+        maxSize: number;
+        ttl: number;
+    };
+    performance: {
+        maxParseTime: number;
+        enableProfiling: boolean;
+    };
+};
+declare class SimpleCache<T> {
+    private cache;
+    private maxSize;
+    private ttl;
+    constructor(maxSize?: number, ttl?: number);
+    get(key: string): T | null;
+    set(key: string, value: T): void;
+    clear(): void;
+}
+declare const parseCache: SimpleCache<Date | null>;
+
+interface UseDateInputProps extends BaseDateProps, StepProps, DateInteractionProps {
+    onPressEnd?: PressMoveProps["onPressEnd"];
+    onPressStart?: PressMoveProps["onPressStart"];
+    readOnly?: boolean;
+    ref?: React__default.Ref<HTMLInputElement>;
+}
+declare function useDateInput(props: UseDateInputProps): {
+    handlerPressed: boolean;
+    inputProps: {
+        ref: (node: HTMLInputElement | null) => void;
+        disabled: boolean;
+        readOnly: boolean;
+        value: string;
+        onChange: (newValue: string) => void;
+        onKeyDown: (event: React__default.KeyboardEvent<Element>) => void;
+        onBlur: () => void;
+    };
+    handlerProps: {
+        ref: (el: HTMLElement | null) => void;
+        onPointerDown: (e: React__default.PointerEvent<HTMLElement>) => void;
+        style?: React__default.CSSProperties;
+    };
+    updateValue: (updateFn?: (currentDate: Date) => Date) => void;
+    currentValue: Date | null;
+};
+
+interface UseTimeInputProps extends BaseTimeProps, StepProps, TimeInteractionProps {
+    onPressEnd?: PressMoveProps["onPressEnd"];
+    onPressStart?: PressMoveProps["onPressStart"];
+    readOnly?: boolean;
+    ref?: React__default.Ref<HTMLInputElement>;
+}
+declare function useTimeInput(props: UseTimeInputProps): {
+    handlerPressed: boolean;
+    inputProps: {
+        ref: (node: HTMLInputElement | null) => void;
+        disabled: boolean;
+        readOnly: boolean;
+        value: string;
+        onChange: (newValue: string) => void;
+        onKeyDown: (event: React__default.KeyboardEvent<Element>) => void;
+        onBlur: () => void;
+    };
+    handlerProps: {
+        ref: (el: HTMLElement | null) => void;
+        onPointerDown: (e: React__default.PointerEvent<HTMLElement>) => void;
+        style?: React__default.CSSProperties;
+    };
+    updateValue: (updateFn?: (currentTime: Date) => Date) => void;
+    currentValue: Date | null;
+};
+
+export { type BaseCalendarProps, type BaseDateProps, type BaseQuarterProps, type BaseTimeProps, type BaseYearProps, type CalendarLayoutProps, type CalendarState, type CalendarValue, type DateComparisonMode, type DateDataFormat, DateInput, type DateInputValue, type DateInteractionProps, type DateParserOptions, type DateParts, type DateRange, DateRangeInput, type DetailedParseResult, DigitExtractor, LOCALE_MAP, MonthCalendar, type MonthCalendarProps, type NaturalLanguageMap, type NumericParseResult, type ParseOptions, type ParseResult, type PredictionResult, type Quarter, QuarterCalendar, type QuarterCalendarProps, type QuarterItem, type QuarterLayoutProps, type QuarterNavigationProps, type RelativeDatePattern, type SmartInputOptions, type StepProps, type Time, TimeCalendar, type TimeCalendarProps, type TimeDataFormat, TimeInput, type TimeInputValue, type TimeInteractionProps, type TimeLayout, type TimeOptionItem, type TimeParserOptions, TimeRangeInput, YearCalendar, type YearCalendarProps, type YearItem, type YearLayoutProps, type YearNavigationProps, areDatesEqual, calculateWeekNumbers, canBeMonthDay, chineseMonths, clearTimeZoneCache, commonDateFormats, commonTimeFormats, convertTwoDigitYear, createQuarter, createTimeToday, createTimeValue, createTimeZoneContext, dateToTime, dateToTimeString, dateUtils, defaultLocaleMap, detectDateFormat, englishMonths, extractDigits, findClosestValidTime, formatHourValue, formatMinuteValue, formatMonthTitle, formatQuarter, formatTimeValue, generateCalendarDays, generateHourOptions, generateMinuteOptions, generateTimeOptions, generateWeekdayNames, getCurrentQuarter, getDateKey, getDateParts, getEnhancedPrediction, getLastDayOfMonth, getLocale, getLocaleKey, getPredictionInfo, getQuarterDateRange, getQuarterMonths, getSupportedLocales, getYearQuarters, handleShortcuts, inferMonthFromValue, inferSelectionMode, isCalendarValueEqual, isChineseLocale, isQuarterEqual, isReasonableYear, isSameDayInTimeZone, isSameMonthInTimeZone, isSameWeekInTimeZone, isSameYearInTimeZone, isTimeEqual, isTodayInTimeZone, isValidDateExists, isValidMonthDay, isWithinRange, naturalLanguageMap, normalizeTimeValue, parse3Digits, parseCache, parseDate, parseEnglishDate, parseExtendedRelativeDate, parseMonthName, parseNaturalLanguage, parseRelativeDate, parseYYMMDD, parseYYYYMMDD, parserConfig, quarterUtils, quickValidateDate, relativeDatePatterns, resolveLocale, smartCorrectDate, smartCorrectYear, smartParseDate, smartParseTimeValue, timeStringToDate, timeToDate, tryRelaxedParsing, tryRelaxedTimeParsing, useDateInput, useTimeInput, validateDateRange, validateTimeRange, yearUtils };