@choice-ui/react 1.4.3 → 1.4.5

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

@@ -8,25 +8,25 @@ import * as React$1 from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
- * 日期格式字符串
+ * Date format string
  *
- * 支持所有 date-fns 格式字符串，常用格式示例：
+ * Supports all date-fns format strings, common format examples:
  *
- * **年份**：
- * - yyyy: 2025 (4位年份)
- * - yy: 25 (2位年份)
+ * **Year**：
+ * - yyyy: 2025 (4-digit year)
+ * - yy: 25 (2-digit year)
  *
- * **月份**：
- * - MMMM: December (完整月份名)
- * - MMM: Dec (缩写月份名)
- * - MM: 12 (2位数字月份)
- * - M: 12 (1-2位数字月份)
+ * **Month**：
+ * - MMMM: December (full month name)
+ * - MMM: Dec (abbreviated month name)
+ * - MM: 12 (2-digit month)
+ * - M: 12 (1-2 digit month)
  *
- * **日期**：
- * - dd: 31 (2位日期)
- * - d: 31 (1-2位日期)
+ * **Date**：
+ * - dd: 31 (2-digit date)
+ * - d: 31 (1-2 digit date)
  *
- * **常用组合**：
+ * **Common combinations**：
  * - "yyyy-MM-dd" → 2025-12-31
  * - "yy-MM-dd" → 25-12-31
  * - "yyyy年MM月dd日" → 2025年12月31日
@@ -40,112 +40,112 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
  */
 type DateDataFormat = string;
 /**
- * 时间格式字符串
+ * Time format string
  *
- * 支持所有 date-fns 时间格式字符串，常用格式示例：
+ * Supports all date-fns time format strings, common format examples:
  *
- * **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 (紧凑格式)
+ * **24-hour format**：
+ * - "HH:mm" → 09:30, 14:45 (2-digit hour)
+ * - "H:mm" → 9:30, 14:45 (1-2 digit hour)
+ * - "HH:mm:ss" → 09:30:15 (with seconds)
+ * - "HHmm" → 0930, 1445 (compact format)
  *
- * **12小时制**：
+ * **12-hour format**：
  * - "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 (带秒)
+ * - "hh:mm a" → 09:30 AM, 02:45 PM (2-digit hour)
+ * - "h:mm aa" → 9:30 A.M., 2:45 P.M. (full AM/PM)
+ * - "h:mm:ss a" → 9:30:15 AM (with seconds)
  *
  * @see https://date-fns.org/v2.29.3/docs/format
  */
 type TimeDataFormat = string;
 
 /**
- * 时间对象（小时和分钟）
+ * Time object (hour and minute)
  */
 interface Time {
     hour: number;
     minute: number;
 }
 /**
- * 时间布局模式
+ * Time layout mode
  */
 type TimeLayout = "single" | "dual";
 /**
- * 时间输入解析结果
+ * Time input parsing result
  */
 interface TimeInputValue {
-    /** 解析错误信息 */
+    /** Parsing error message */
     error: string | null;
-    /** 格式化后的显示值 */
+    /** Formatted display value */
     formatted: string;
-    /** 原始输入值 */
+    /** Original input value */
     input: string;
-    /** 是否为有效时间 */
+    /** Whether it is a valid time */
     isValid: boolean;
-    /** 解析后的时间 Date 对象 */
+    /** Parsed time Date object */
     time: Date | null;
 }
 /**
- * 时间解析选项
+ * Time parsing options
  */
 interface TimeParserOptions {
-    /** 时间格式 */
+    /** Time format */
     format: TimeDataFormat;
-    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    /** Language environment - supports Locale object or string (e.g., "zh-CN", "en-US") */
     locale?: Locale | string;
-    /** 严格模式 */
+    /** Strict mode */
     strict?: boolean;
 }
 /**
- * 时间组件的基础属性
+ * Time component base properties
  */
 interface BaseTimeProps {
-    /** 默认值 */
+    /** Default value */
     defaultValue?: Date | null;
-    /** 是否禁用 */
+    /** Whether it is disabled */
     disabled?: boolean;
-    /** 时间格式，支持所有 date-fns 格式字符串 */
+    /** Time format, supports all date-fns format strings */
     format?: TimeDataFormat;
-    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    /** Language environment - supports Locale object or string (e.g., "zh-CN", "en-US") */
     locale?: Locale | string;
-    /** 最大时间 */
+    /** Maximum time */
     maxTime?: Date;
-    /** 最小时间 */
+    /** Minimum time */
     minTime?: Date;
-    /** 时间变化回调 */
+    /** Time change callback */
     onChange?: (time: Date | null) => void;
-    /** 是否只读（禁用选择但不改变样式） */
+    /** Whether it is read-only (disable selection but do not change style) */
     readOnly?: boolean;
-    /** 当前选中的时间 */
+    /** Currently selected time */
     value?: Date | null;
 }
 /**
- * 时间步长相关属性
+ * Time step related properties
  */
 interface StepProps {
-    /** Meta/Ctrl + 按键的步长（分钟），默认60分钟 */
+    /** Meta/Ctrl + key step (minutes), default 60 minutes */
     metaStep?: number;
-    /** Shift + 按键的步长（分钟），默认15分钟 */
+    /** Shift + key step (minutes), default 15 minutes */
     shiftStep?: number;
-    /** 基础步长（分钟），默认1分钟 */
+    /** Base step (minutes), default 1 minute */
     step?: number;
 }
 /**
- * 时间交互功能属性
+ * Time interaction properties
  */
 interface TimeInteractionProps {
-    /** 是否启用解析缓存 */
+    /** Whether to enable parsing cache */
     enableCache?: boolean;
-    /** 是否启用键盘导航（默认启用） */
+    /** Whether to enable keyboard navigation (default enabled) */
     enableKeyboardNavigation?: boolean;
-    /** 是否启用性能分析 */
+    /** Whether to enable performance analysis */
     enableProfiling?: boolean;
-    /** 按下 Enter 键的回调 */
+    /** Callback when Enter key is pressed */
     onEnterKeyDown?: () => void;
 }
 /**
- * 时间选项项
+ * Time option item
  */
 interface TimeOptionItem {
     disabled?: boolean;
@@ -153,78 +153,78 @@ interface TimeOptionItem {
     value: Time;
 }
 interface SmartInputOptions {
-    /** 去抖延迟（毫秒） */
+    /** Debounce delay (milliseconds) */
     debounceMs?: number;
-    /** 是否启用自动完成 */
+    /** Whether to enable auto complete */
     enableAutoComplete?: boolean;
-    /** 是否启用键盘导航 */
+    /** Whether to enable keyboard navigation */
     enableKeyboardNavigation?: boolean;
-    /** 是否启用实时验证 */
+    /** Whether to enable real-time validation */
     enableLiveValidation?: boolean;
-    /** 是否显示解析预览 */
+    /** Whether to show parse preview */
     showParsePreview?: boolean;
 }
 /**
- * 日期范围对象
+ * Date range object
  */
 interface DateRange {
     end: Date;
     start: Date;
 }
 /**
- * 一周开始的日期
+ * Date of the week starts
  */
 type WeekStartsOn = Day;
 /**
- * 日期比较模式
+ * Date comparison mode
  */
 type DateComparisonMode$1 = "exact-time" | "date-only";
 /**
- * 日历选择值的类型
+ * Calendar selection value type
  */
 type CalendarValue = Date | Date[] | DateRange | null;
 /**
- * 选择模式
+ * Selection mode
  */
 type SelectionMode = "single" | "multiple" | "range";
 /**
- * 日期输入解析结果
+ * Date input parsing result
  */
 interface DateInputValue {
-    /** 解析后的日期对象 */
+    /** Parsed date object */
     date: Date | null;
-    /** 解析错误信息 */
+    /** Parsing error message */
     error: string | null;
-    /** 格式化后的显示值 */
+    /** Formatted display value */
     formatted: string;
-    /** 原始输入值 */
+    /** Original input value */
     input: string;
-    /** 是否为有效日期 */
+    /** Whether it is a valid date */
     isValid: boolean;
 }
 /**
- * 日期解析选项
+ * Date parsing options
  */
 interface DateParserOptions {
-    /** 是否启用自然语言解析 */
+    /** Whether to enable natural language parsing */
     enableNaturalLanguage?: boolean;
-    /** 是否启用相对日期解析 */
+    /** Whether to enable relative date parsing */
     enableRelativeDate?: boolean;
-    /** 是否启用智能修正 */
+    /** Whether to enable smart correction */
     enableSmartCorrection?: boolean;
-    /** 日期格式 */
+    /** Date format */
     format: DateDataFormat;
-    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    /** Language environment - supports Locale object or string (e.g., "zh-CN", "en-US") */
     locale?: Locale | string;
-    /** 最大日期 */
+    /** Maximum date */
     maxDate?: Date;
-    /** 最小日期 */
+    /** Minimum date */
     minDate?: Date;
-    /** 严格模式（不允许无效日期） */
+    /** Strict mode (not allowed invalid date) */
     strict?: boolean;
 }
 /**
- * 自然语言关键词映射
+ * Natural language keyword mapping
  */
 interface NaturalLanguageMap {
     afternoon: string[];
@@ -246,7 +246,7 @@ interface NaturalLanguageMap {
     yesterday: string[];
 }
 /**
- * 相对日期模式
+ * Relative date pattern
  */
 interface RelativeDatePattern {
     multiplier: number;
@@ -254,100 +254,100 @@ interface RelativeDatePattern {
     type: "day" | "week" | "month" | "year";
 }
 /**
- * 日期组件的基础属性
+ * Date component base properties
  */
 interface BaseDateProps {
-    /** 默认值 */
+    /** Default value */
     defaultValue?: Date | null;
-    /** 是否禁用 */
+    /** Whether it is disabled */
     disabled?: boolean;
-    /** 日期格式，支持所有 date-fns 格式字符串 */
+    /** Date format, supports all date-fns format strings */
     format?: DateDataFormat;
-    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    /** Language environment - supports Locale object or string (e.g., "zh-CN", "en-US") */
     locale?: Locale | string;
-    /** 最大日期 */
+    /** Maximum date */
     maxDate?: Date;
-    /** 最小日期 */
+    /** Minimum date */
     minDate?: Date;
-    /** 日期变化回调 */
+    /** Date change callback */
     onChange?: (date: Date | null) => void;
-    /** 当前选中的日期 */
+    /** Currently selected date */
     value?: Date | null;
 }
 /**
- * 日期交互功能属性
+ * Date interaction properties
  */
 interface DateInteractionProps {
-    /** 是否启用解析缓存 */
+    /** Whether to enable parsing cache */
     enableCache?: boolean;
-    /** 是否启用键盘导航（默认启用） */
+    /** Whether to enable keyboard navigation (default enabled) */
     enableKeyboardNavigation?: boolean;
-    /** 是否启用预测功能 */
+    /** Whether to enable prediction */
     enablePrediction?: boolean;
-    /** 是否启用性能分析 */
+    /** Whether to enable performance analysis */
     enableProfiling?: boolean;
-    /** 按下 Enter 键的回调 */
+    /** Callback when Enter key is pressed */
     onEnterKeyDown?: () => void;
 }
 /**
- * 月历组件的基础属性
+ * Month calendar component base properties
  */
 interface BaseCalendarProps {
     children?: React.ReactNode;
-    /** 自定义类名 */
+    /** Custom class name */
     className?: string;
-    /** 当前显示的月份 */
+    /** Currently displayed month */
     currentMonth?: Date;
-    /** 日期比较模式 */
+    /** Date comparison mode */
     dateComparisonMode?: DateComparisonMode$1;
-    /** 非受控模式的默认值 */
+    /** Non-controlled mode default value */
     defaultValue?: CalendarValue;
-    /** 禁用的日期数组 */
+    /** Disabled dates array */
     disabledDates?: Date[];
-    /** 是否固定6行显示（42天），默认true确保高度一致 */
+    /** Whether to fix 6 rows display (42 days), default true to ensure height consistency */
     fixedGrid?: boolean;
-    /** 需要高亮的日期数组 */
+    /** Dates to highlight */
     highlightDates?: Date[];
-    /** 是否高亮今天 */
+    /** Whether to highlight today */
     highlightToday?: boolean;
-    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    /** Language environment - supports Locale object or string (e.g., "zh-CN", "en-US") */
     locale?: Locale | string;
-    /** 最大可选日期 */
+    /** Maximum可选日期 */
     maxDate?: Date;
-    /** 最小可选日期 */
+    /** Minimum可选日期 */
     minDate?: Date;
-    /** 值变更回调 */
+    /** Value change callback */
     onChange?: (value: CalendarValue) => void;
-    /** 月份变更回调 */
+    /** Month change callback */
     onMonthChange?: (month: Date) => void;
-    /** 是否只读（禁用选择但不改变样式） */
+    /** Whether it is read-only (disable selection but do not change style) */
     readOnly?: boolean;
-    /** 选择模式，如果未指定，会根据 value 类型自动推断 */
+    /** Selection mode, if not specified, will be automatically inferred based on value type */
     selectionMode?: SelectionMode;
-    /** 是否显示非当前月份的日期 */
+    /** Whether to show dates of non-current months */
     showOutsideDays?: boolean;
-    /** 是否显示周数，默认false */
+    /** Whether to show week numbers, default false */
     showWeekNumbers?: boolean;
-    /** 时区 */
+    /** Time zone */
     timeZone?: string;
-    /** 受控模式的值 */
+    /** Controlled mode value */
     value?: CalendarValue;
-    /** 一周开始的日期（0=周日, 1=周一） */
+    /** Week starts on (0=Sunday, 1=Monday) */
     weekStartsOn?: WeekStartsOn;
-    /** 自定义星期名称 */
+    /** Custom weekday names */
     weekdayNames?: string[];
 }
 /**
- * 月历布局相关属性
+ * Month calendar layout related properties
  */
 interface CalendarLayoutProps {
-    /** 方向 */
+    /** Direction */
     direction?: "horizontal" | "vertical";
-    /** 变体样式 */
+    /** Variant style */
     variant?: "default" | "dark";
 }
 /**
- * 日历状态接口
+ * Calendar state interface
  */
 interface CalendarState {
     isSingleDay: boolean;
@@ -359,7 +359,7 @@ interface CalendarState {
     } | null;
 }
 /**
- * 季度对象
+ * Quarter object
  */
 interface Quarter {
     label: string;
@@ -368,7 +368,7 @@ interface Quarter {
     year: number;
 }
 /**
- * 季度项目状态
+ * Quarter item state
  */
 interface QuarterItem {
     isCurrent: boolean;
@@ -378,7 +378,7 @@ interface QuarterItem {
     quarter: Quarter;
 }
 /**
- * 年份项目状态
+ * Year item state
  */
 interface YearItem {
     isCurrent: boolean;
@@ -388,96 +388,96 @@ interface YearItem {
     year: Date;
 }
 /**
- * 季度组件的基础属性
+ * Quarter component base properties
  */
 interface BaseQuarterProps {
     children?: React.ReactNode;
-    /** 当前显示的年份 */
+    /** Currently displayed year */
     currentYear?: number;
-    /** 默认值 */
+    /** Default value */
     defaultValue?: Quarter;
-    /** 是否禁用 */
+    /** Whether it is disabled */
     disabled?: boolean;
-    /** 禁用的季度数组 */
+    /** Disabled quarters array */
     disabledQuarters?: Array<{
         quarter: number;
         year: number;
     }>;
-    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    /** Language environment - supports Locale object or string (e.g., "zh-CN", "en-US") */
     locale?: Locale | string;
-    /** 最大可选年份 */
+    /** Maximum selectable year */
     maxYear?: number;
-    /** 最小可选年份 */
+    /** Minimum selectable year */
     minYear?: number;
-    /** 季度选择变化回调 */
+    /** Quarter change callback */
     onChange?: (quarter: Quarter | null) => void;
-    /** 是否只读（禁用选择但不改变样式） */
+    /** Whether it is read-only (disable selection but do not change style) */
     readOnly?: boolean;
-    /** 显示的年份 */
+    /** Displayed year */
     startYear?: number;
-    /** 当前选中的季度 */
+    /** Currently selected quarter */
     value?: Quarter | null;
 }
 /**
- * 季度导航相关属性
+ * Quarter navigation related properties
  */
 interface QuarterNavigationProps {
-    /** 年份范围导航回调 */
+    /** Year range navigation callback */
     onNavigate?: (direction: "prev" | "next", newYear: number) => void;
 }
 /**
- * 季度布局相关属性
+ * Quarter layout related properties
  */
 interface QuarterLayoutProps {
-    /** 自定义类名 */
+    /** Custom class name */
     className?: string;
-    /** 变体样式 */
+    /** Variant style */
     variant?: "default" | "dark";
 }
 /**
- * 年份组件的基础属性
+ * Year component base properties
  */
 interface BaseYearProps {
     children?: React.ReactNode;
-    /** 当前显示的年份（用于高亮） */
+    /** Currently displayed year (for highlighting) */
     currentYear?: Date;
-    /** 默认值 */
+    /** Default value */
     defaultValue?: Date;
-    /** 是否禁用 */
+    /** Whether it is disabled */
     disabled?: boolean;
-    /** 禁用的年份数组 */
+    /** Disabled years array */
     disabledYears?: Date[];
-    /** 语言区域 - 支持 Locale 对象或字符串（如 "zh-CN", "en-US"） */
+    /** Language environment - supports Locale object or string (e.g., "zh-CN", "en-US") */
     locale?: Locale | string;
-    /** 最大可选年份 */
+    /** Maximum selectable year */
     maxYear?: Date;
-    /** 最小可选年份 */
+    /** Minimum selectable year */
     minYear?: Date;
-    /** 年份选择变化回调 */
+    /** Year change callback */
     onChange?: (year: Date | null) => void;
-    /** 是否只读（禁用选择但不改变样式） */
+    /** Whether it is read-only (disable selection but do not change style) */
     readOnly?: boolean;
-    /** 显示年份范围的起始年份，默认为当前年份-10 */
+    /** Displayed year range start year, default current year - 10 */
     startYear?: Date;
-    /** 当前选中的年份 */
+    /** Currently selected year */
     value?: Date | null;
-    /** 显示年份的数量，默认12个 */
+    /** Displayed year count, default 12 */
     yearCount?: number;
 }
 /**
- * 年份导航相关属性
+ * Year navigation related properties
  */
 interface YearNavigationProps {
-    /** 年份范围导航回调 */
+    /** Year range navigation callback */
     onNavigate?: (direction: "prev" | "next", newStartYear: Date) => void;
 }
 /**
- * 年份布局相关属性
+ * Year layout related properties
  */
 interface YearLayoutProps {
-    /** 自定义类名 */
+    /** Custom class name */
     className?: string;
-    /** 变体样式 */
+    /** Variant style */
     variant?: "default" | "dark";
 }
 
@@ -553,11 +553,11 @@ interface DateRangeInputProps extends Omit<TextFieldProps, "value" | "onChange"
     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小时）
+     * Range length display precision, control the minimum unit of range calculation
+     * @default 1 - Minimum unit is 1 day
+     * @example 0.5 - Minimum unit is 0.5 days (half a day)
+     * @example 0.1 - Minimum unit is 0.1 days (2.4 hours)
+     * @example 0.25 - Minimum unit is 0.25 days (6 hours)
      */
     rangePrecision?: number;
     startDisabled?: boolean;
@@ -569,11 +569,11 @@ declare const DateRangeInput: (props: DateRangeInputProps) => react_jsx_runtime.
 
 interface TimeCalendarProps extends BaseTimeProps, StepProps {
     children?: React__default.ReactNode;
-    /** 自定义类名 */
+    /** Custom class name */
     className?: string;
-    /** 小时步进，默认1小时 */
+    /** Hour step, default 1 hour */
     hourStep?: number;
-    /** 分钟步进，默认15分钟 */
+    /** Minute step, default 15 minutes */
     minuteStep?: number;
 }
 declare const TimeCalendar: React__default.NamedExoticComponent<TimeCalendarProps>;
@@ -583,16 +583,16 @@ interface TimeInputProps extends Omit<TextFieldProps, "value" | "onChange" | "fo
     suffixElement?: React__default.ReactNode;
 }
 /**
- * 高级时间输入组件
+ * Advanced time input component
  *
- * 特性：
- * - 🎯 智能时间解析：支持多种格式和自然语言
- * - ⌨️ 键盘导航：上键减少，下键增加（符合列表导航逻辑）
- * - 🔄 竞态保护：智能检测数据流方向，避免循环更新
- * - 🚀 性能优化：使用 useEventCallback 和缓存机制
- * - 🛡️ 类型安全：完整的 TypeScript 支持
- * - 🌍 国际化支持：可配置语言区域
- * - 📱 拖拽交互：支持通过前缀图标拖拽调整时间
+ * Features:
+ * - 🎯 Intelligent time parsing: support multiple formats and natural language
+ * - ⌨️ Keyboard navigation: up key decreases, down key increases (符合列表导航逻辑)
+ * - 🔄 Race protection: smartly detect data flow direction, avoid loop updates
+ * - 🚀 Performance optimization: use useEventCallback and caching mechanism
+ * - 🛡️ Type safety: complete TypeScript support
+ * - 🌍 Internationalization support: configurable language region
+ * - 📱 Drag interaction: support dragging adjustment through prefix icon
  */
 declare const TimeInput: React__default.ForwardRefExoticComponent<Omit<TimeInputProps, "ref"> & React__default.RefAttributes<HTMLInputElement>>;
 
@@ -641,29 +641,29 @@ declare function generateCalendarDays(currentMonth: Date, weekStartsOn?: number,
 declare function formatMonthTitle(date: Date, locale?: Locale | string): string;
 declare function calculateWeekNumbers(calendarDays: Date[], locale?: Locale | string): number[];
 /**
- * 根据值类型推断选择模式
+ * Infer selection mode based on value type
  */
 declare function inferSelectionMode(value: CalendarValue): SelectionMode;
 /**
- * 从 CalendarValue 推断应该显示的月份
+ * Infer month from CalendarValue
  */
 declare function inferMonthFromValue(value: CalendarValue): Date | null;
 /**
- * 比较两个 CalendarValue 是否相等（支持时区感知和比较精度）
+ * Compare two CalendarValue for equality (supports time zone aware and comparison precision)
  */
 declare function isCalendarValueEqual(a: CalendarValue, b: CalendarValue, timeZone?: string, dateComparisonMode?: "exact-time" | "date-only"): boolean;
 
 declare const LOCALE_MAP: Record<string, Locale>;
 /**
- * 🔧 安全的 locale 解析函数
+ * 🔧 Safe locale parsing function
  *
- * 支持以下输入格式：
- * - Locale 对象：直接返回
- * - 字符串：自动映射到对应的 Locale 对象
- * - 无效值：返回中文 locale (zhCN)
+ * Supports the following input formats:
+ * - Locale object: return directly
+ * - String: automatically map to the corresponding Locale object
+ * - Invalid value: return Chinese locale (zhCN)
  *
- * @param locale - 可以是 Locale 对象或字符串
- * @returns 解析后的 Locale 对象
+ * @param locale - Can be a Locale object or string
+ * @returns Parsed Locale object
  *
  * @example
  * ```ts
@@ -675,83 +675,83 @@ declare const LOCALE_MAP: Record<string, Locale>;
  */
 declare function resolveLocale(locale: Locale | string | undefined | null): Locale;
 /**
- * 🔍 获取所有支持的 locale 列表
- * @returns 支持的 locale 字符串数组
+ * 🔍 Get all supported locale list
+ * @returns Supported locale string array
  */
 declare function getSupportedLocales(): string[];
 /**
- * 🎯 检查是否为中文 locale
- * @param locale - Locale 对象或字符串
- * @returns 是否为中文
+ * 🎯 Check if it is a Chinese locale
+ * @param locale - Locale object or string
+ * @returns Whether it is a Chinese locale
  */
 declare function isChineseLocale(locale: Locale | string | undefined | null): boolean;
 
 /**
- * 日期比较精度模式
- * - 'exact-time': 精确时间比较（包含时、分、秒、毫秒）
- * - 'date-only': 仅日期比较（忽略时间部分，比较年、月、日）
+ * Date comparison precision mode
+ * - 'exact-time': Exact time comparison (includes hours, minutes, seconds, milliseconds)
+ * - 'date-only': Date only comparison (ignores time part, compares year, month, day)
  */
 type DateComparisonMode = "exact-time" | "date-only";
 /**
- * 时区感知的日期部分
+ * Time zone aware date parts
  */
 interface DateParts {
-    /** 日期（1-31） */
+    /** Day (1-31) */
     day: number;
-    /** 月份（0-11） */
+    /** Month (0-11) */
     month: number;
-    /** 星期几（0-6，0为周日） */
+    /** Weekday (0-6, 0 is Sunday) */
     weekday: number;
-    /** 年份 */
+    /** Year */
     year: number;
 }
 /**
- * 创建时区上下文选项（用于 date-fns 4.0+）
+ * Create time zone context options (for date-fns 4.0+)
  */
 declare function createTimeZoneContext(timeZone?: string): {
     in: (value: Date | number | string) => TZDate;
 } | undefined;
 /**
- * 时区感知的日期比较（仅比较日期部分）
+ * Time zone aware date comparison (only compares date part)
  *
- * @param date1 第一个日期
- * @param date2 第二个日期
- * @param timeZone 时区（可选，默认使用本地时区）
- * @returns 是否为同一天
+ * @param date1 First date
+ * @param date2 Second date
+ * @param timeZone Time zone (optional, default uses local timezone)
+ * @returns Whether they are the same day
  *
  * @example
  * ```typescript
  * const date1 = new Date('2025-01-15T23:30:00Z')    // UTC
- * const date2 = new Date('2025-01-16T08:30:00+09:00') // JST (同一天)
+ * const date2 = new Date('2025-01-16T08:30:00+09:00') // JST (same day)
  * isSameDayInTimeZone(date1, date2, 'Asia/Tokyo') // true
  * ```
  */
 declare function isSameDayInTimeZone(date1: Date, date2: Date, timeZone?: string): boolean;
 /**
- * 时区感知的月份比较
+ * Time zone aware month comparison
  */
 declare function isSameMonthInTimeZone(date1: Date, date2: Date, timeZone?: string): boolean;
 /**
- * 时区感知的年份比较
+ * Time zone aware year comparison
  */
 declare function isSameYearInTimeZone(date1: Date, date2: Date, timeZone?: string): boolean;
 /**
- * 时区感知的星期比较
+ * Time zone aware week comparison
  */
 declare function isSameWeekInTimeZone(date1: Date, date2: Date, timeZone?: string): boolean;
 /**
- * 时区感知的今天判断
+ * Time zone aware today check
  */
 declare function isTodayInTimeZone(date: Date, timeZone?: string): boolean;
 /**
- * 判断日期是否在指定范围内（支持时区和比较模式）
+ * Check if date is within specified range (supports time zone and comparison mode)
  *
- * @param date 要检查的日期
- * @param rangeStart 范围开始日期
- * @param rangeEnd 范围结束日期
- * @param timeZone 时区（可选）
- * @param mode 比较模式（默认仅日期）
- * @returns 是否在范围内
+ * @param date Date to check
+ * @param rangeStart Range start date
+ * @param rangeEnd Range end date
+ * @param timeZone Time zone (optional)
+ * @param mode Comparison mode (default is date-only)
+ * @returns Whether it is within the range
  *
  * @example
  * ```typescript
@@ -764,16 +764,16 @@ declare function isTodayInTimeZone(date: Date, timeZone?: string): boolean;
  */
 declare function isWithinRange(date: Date, rangeStart: Date, rangeEnd: Date, timeZone?: string, mode?: DateComparisonMode): boolean;
 /**
- * 获取时区感知的详细日期部分
+ * Get time zone aware detailed date parts
  */
 declare function getDateParts(date: Date, timeZone?: string): DateParts;
 /**
- * 获取日期的唯一键（用于 Map/Set 等数据结构）
+ * Get the unique key of the date (for Map/Set etc. data structures)
  *
- * @param date 日期对象
- * @param timeZone 时区（可选）
- * @param includeTime 是否包含时间部分（默认false）
- * @returns 格式化的日期键
+ * @param date Date object
+ * @param timeZone Time zone (optional)
+ * @param includeTime Whether to include time part (default is false)
+ * @returns Formatted date key
  *
  * @example
  * ```typescript
@@ -783,11 +783,11 @@ declare function getDateParts(date: Date, timeZone?: string): DateParts;
  */
 declare function getDateKey(date: Date, timeZone?: string, includeTime?: boolean): string;
 /**
- * 批量比较日期数组是否相等（时区感知）
+ * Batch compare date arrays for equality (time zone aware)
  */
 declare function areDatesEqual(dates1: Date[], dates2: Date[], timeZone?: string, mode?: DateComparisonMode): boolean;
 /**
- * 清除时区日期缓存（用于测试或内存管理）
+ * Clear time zone date cache (for testing or memory management)
  */
 declare function clearTimeZoneCache(): void;
 
@@ -823,33 +823,33 @@ declare function detectDateFormat(input: string): DateDataFormat;
 type ParseResult = Date | null;
 type DetailedParseResult = DateInputValue;
 interface ParseOptions {
-    /** 是否返回详细信息 */
+    /** Whether to return detailed information */
     detailed?: boolean;
-    /** 是否启用自然语言解析 */
+    /** Whether to enable natural language parsing */
     enableNaturalLanguage?: boolean;
-    /** 是否启用相对日期解析 */
+    /** Whether to enable relative date parsing */
     enableRelativeDate?: boolean;
-    /** 是否启用智能修正 */
+    /** Whether to enable smart correction */
     enableSmartCorrection?: boolean;
-    /** 目标格式 */
+    /** Target format */
     format?: DateDataFormat;
-    /** 语言环境 */
+    /** Language environment */
     locale?: Locale;
-    /** 是否严格模式 */
+    /** Whether to strict mode */
     strict?: boolean;
 }
 /**
- * 统一的日期解析器 - 合并了原来的 tryRelaxedParsing 和 smartParseDate
+ * Unified date parser - merged the original tryRelaxedParsing and smartParseDate
  *
- * 解析策略按优先级排序（修正为正确的优先级）：
- * 1. 标准格式解析 - 严格按照指定格式解析
- * 2. 智能数字解析（核心功能） - 纯数字输入的智能猜测 [最重要]
- * 3. 快捷键解析 - today, tomorrow, yesterday 等
- * 4. 扩展相对日期解析 - "3 days ago", "next week" 等
- * 5. 自然语言解析 - "今天", "明天", "下周三" 等
- * 6. 相对日期解析 - "+3d", "-1w" 等简短格式
- * 7. 英文日期解析 - "Jan 15, 2024", "March 3rd" 等
- * 8. 常见格式尝试 - 尝试其他常用日期格式
+ * Parsing strategy sorted by priority (corrected to correct priority):
+ * 1. Standard format parsing - strictly parse according to the specified format
+ * 2. Intelligent numeric parsing (core function) - intelligent guess of pure numeric input [most important]
+ * 3. Shortcut parsing - today, tomorrow, yesterday, etc.
+ * 4. Extended relative date parsing - "3 days ago", "next week", etc.
+ * 5. Natural language parsing - "today", "tomorrow", "next Wednesday", etc.
+ * 6. Relative date parsing - "+3d", "-1w", etc. short format
+ * 7. English date parsing - "Jan 15, 2024", "March 3rd", etc.
+ * 8. Common format attempt - try other commonly used date formats
  */
 declare function parseDate(input: string, options: ParseOptions & {
     detailed: true;
@@ -869,139 +869,139 @@ declare const tryRelaxedParsing: (input: string, format: DateDataFormat, locale?
 declare const smartParseDate: (input: string, options: DateParserOptions) => DateInputValue;
 
 interface PredictionResult {
-    /** 置信度 (0-1) */
+    /** Confidence (0-1) */
     confidence: number;
-    /** 描述信息 */
+    /** Description */
     description: string;
-    /** 预测的日期字符串 */
+    /** Predicted date string */
     prediction: string;
-    /** 预测类型 */
+    /** Prediction type */
     type: "numeric" | "shortcut" | "relative" | "parsed";
 }
 /**
- * 增强的智能预测功能
- * 直接使用 parseDate 函数，确保预测结果与实际格式化100%一致
+ * Enhanced intelligent prediction function
+ * Directly use parseDate function, ensure prediction result is 100% consistent with actual formatting
  */
 declare function getEnhancedPrediction(input: string, targetFormat?: DateDataFormat): PredictionResult | null;
 
 /**
- * 数字解析统一工具函数
- * 用于消除parsers中的重复代码
+ * Unified numeric parsing tool functions
+ * Used to eliminate duplicate code in parsers
  */
-/** 提取纯数字字符串 */
+/** Extract pure numeric string */
 declare function extractDigits(input: string): string;
-/** 数字段提取器 */
+/** Numeric segment extractor */
 declare class DigitExtractor {
     private digits;
     constructor(digits: string);
-    /** 提取指定位置的数字 */
+    /** Extract number at specified position */
     extract(start: number, length: number): number;
-    /** 提取年份 (前2位) */
+    /** Extract year (first 2 digits) */
     getYear2(): number;
-    /** 提取年份 (前4位) */
+    /** Extract year (first 4 digits) */
     getYear4(): number;
-    /** 提取月份 (前2位) */
+    /** Extract month (first 2 digits) */
     getMonth(): number;
-    /** 提取日期 (第3-4位) */
+    /** Extract date (3-4th digits) */
     getDay(): number;
-    /** 提取6位数字的各个部分 (YYMMDD格式) */
+    /** Extract each part of 6 digits (YYMMDD format) */
     getYYMMDD(): {
         day: number;
         month: number;
         year: number;
     };
-    /** 提取8位数字的各个部分 (YYYYMMDD格式) */
+    /** Extract each part of 8 digits (YYYYMMDD format) */
     getYYYYMMDD(): {
         day: number;
         month: number;
         year: number;
     };
-    /** 提取3位数字的各个部分 */
+    /** Extract each part of 3 digits */
     get3DigitParts(): {
         first: number;
         lastTwo: number;
     };
 }
-/** 年份转换工具 */
+/** Year conversion tool */
 declare function convertTwoDigitYear(year: number): number;
-/** 检查是否为有效的月日组合 */
+/** Check if it is a valid month and day combination */
 declare function isValidMonthDay(month: number, day: number): boolean;
-/** 检查3位数字是否可以解释为月日 */
+/** Check if 3 digits can be interpreted as month and day */
 declare function canBeMonthDay(firstDigit: number, lastTwoDigits: number): boolean;
-/** 检查是否为合理的年份 */
+/** Check if it is a reasonable year */
 declare function isReasonableYear(year: number): boolean;
-/** 数字解析结果 */
+/** Numeric parsing result */
 interface NumericParseResult {
     day: number;
     formatted: string;
     month: number;
     year: number;
 }
-/** 通用的6位数字解析器 (YYMMDD) */
+/** General 6-digit parser (YYMMDD) */
 declare function parseYYMMDD(digits: string, targetFormat: string): NumericParseResult | null;
-/** 通用的8位数字解析器 (YYYYMMDD) */
+/** General 8-digit parser (YYYYMMDD) */
 declare function parseYYYYMMDD(digits: string, targetFormat: string): NumericParseResult | null;
-/** 智能的3位数字解析器 */
+/** Intelligent 3-digit parser */
 declare function parse3Digits(digits: string, currentYear: number, targetFormat: string): NumericParseResult | null;
 
 declare const yearUtils: {
     extractYear(input: Date | number | undefined): number | undefined;
-    /** 创建年份的开始日期 */
+    /** Create year start date */
     createYearDate(year: number): Date;
-    /** 获取当前年份 */
+    /** Get current year */
     getCurrentYear(): number;
-    /** 验证年份是否在有效范围内 */
+    /** Validate if year is in valid range */
     isYearInRange(year: number, minYear?: number, maxYear?: number): boolean;
 };
 
 declare const quarterUtils: {
-    /** 安全地从各种输入中提取年份数字 */
+    /** Safely extract year number from various inputs */
     extractYear(input: Date | number | undefined): number | undefined;
-    /** 获取当前年份 */
+    /** Get current year */
     getCurrentYear(): number;
-    /** 获取当前季度数字 (1-4) */
+    /** Get current quarter number (1-4) */
     getCurrentQuarterNumber(): Quarter$1;
-    /** 验证年份是否在有效范围内 */
+    /** Validate if year is in valid range */
     isYearInRange(year: number, minYear?: number, maxYear?: number): boolean;
-    /** 创建季度的开始日期 */
+    /** Create quarter start date */
     createQuarterStartDate(quarter: number, year: number): Date;
-    /** 创建季度的结束日期 */
+    /** Create quarter end date */
     createQuarterEndDate(quarter: number, year: number): Date;
 };
-/** 获取季度的月份名称 */
+/** Get quarter month names */
 declare function getQuarterMonths(quarter: number, locale?: Locale | string): string[];
-/** 创建季度对象 */
+/** Create quarter object */
 declare function createQuarter(quarter: Quarter$1, year: number, locale?: Locale | string): Quarter;
-/** 获取当前季度 */
+/** Get current quarter */
 declare function getCurrentQuarter(year?: number, locale?: Locale | string): Quarter;
-/** 获取年份的所有季度 */
+/** Get all quarters of a year */
 declare function getYearQuarters(year: number, locale?: Locale | string): Quarter[];
-/** 检查两个季度是否相等 */
+/** Check if two quarters are equal */
 declare function isQuarterEqual(quarter1: Quarter, quarter2: Quarter): boolean;
-/** 格式化季度显示 */
+/** Format quarter display */
 declare function formatQuarter(quarter: Quarter): string;
-/** 获取季度的日期范围 */
+/** Get quarter date range */
 declare function getQuarterDateRange(quarter: Quarter): {
     end: Date;
     start: Date;
 };
 
 /**
- * 将 Date 对象转换为时间字符串 (HH:mm)
+ * Convert Date object to time string (HH:mm)
  * @param date - Date 对象
- * @returns 时间字符串，格式为 "HH:mm"，如果 date 为 null 则返回 null
+ * @returns Time string, format is "HH:mm", if date is null then return null
  */
 declare function dateToTimeString(date: Date | null): string | null;
 /**
- * 将时间字符串转换为 Date 对象（今天的日期 + 指定时间）
- * @param timeStr - 时间字符串，格式为 "HH:mm"
- * @returns Date 对象，包含今天的日期和指定的时间
+ * Convert time string to Date object (today's date + specified time)
+ * @param timeStr - Time string, format is "HH:mm"
+ * @returns Date object, contains today's date and specified time
  */
 declare function timeStringToDate(timeStr: string): Date;
 /**
- * 将任意 Date 值标准化为时间字符串格式
- * @param value - Date 对象或 null
- * @returns 标准化的时间字符串 (HH:mm) 或 null
+ * Normalize any Date value to time string format
+ * @param value - Date object or null
+ * @returns Normalized time string (HH:mm) or null
  */
 declare function normalizeTimeValue(value: Date | null | undefined): string | null;
 declare function smartParseTimeValue(input: string, options: TimeParserOptions): TimeInputValue;