@choice-ui/react 1.4.3 → 1.4.6

package/dist/components/calendar/dist/index.js

@@ -218,7 +218,7 @@ function calculateWeekNumbers(calendarDays, locale = zhCN) {
     const weekNumber = getWeek(weekFirstDay, {
       locale: safeLocale,
       weekStartsOn: 1
-      // ISO周数标准，周一开始
+      // ISO week number standard, week starts on Monday
     });
     weekNumbers.push(weekNumber);
   }
@@ -297,8 +297,8 @@ function getEnglishMonths() {
   if (!englishMonthsCache) {
     englishMonthsCache = {
       ...generateMonthMapping(enUS, ["MMMM", "MMM", "MMM."]),
-      // 全称、缩写、带点缩写
-      // 常见变体
+      // Full name, abbreviation, dot abbreviation
+      // Common variations
       sept: 9,
       "sept.": 9
     };
@@ -309,7 +309,7 @@ function getChineseMonths() {
   if (!chineseMonthsCache) {
     chineseMonthsCache = {
       ...generateMonthMapping(zhCN, ["MMMM", "M月"])
-      // 中文月份名和数字月份
+      // Chinese month name and number month
     };
   }
   return chineseMonthsCache;
@@ -462,67 +462,68 @@ var naturalLanguageMap = {
   }
 };
 var relativeDatePatterns = [
-  // 数字 + 天/日
+  // Number + day/day
   { pattern: /(\d+)\s*天[后前]?/g, type: "day", multiplier: 1 },
   { pattern: /(\d+)\s*日[后前]?/g, type: "day", multiplier: 1 },
   { pattern: /(\d+)\s*days?\s*(later|ago)?/gi, type: "day", multiplier: 1 },
-  // 数字 + 周/星期
+  // Number + week/week
   { pattern: /(\d+)\s*周[后前]?/g, type: "week", multiplier: 1 },
   { pattern: /(\d+)\s*星期[后前]?/g, type: "week", multiplier: 1 },
   { pattern: /(\d+)\s*weeks?\s*(later|ago)?/gi, type: "week", multiplier: 1 },
-  // 数字 + 月
+  // Number + month
   { pattern: /(\d+)\s*个?月[后前]?/g, type: "month", multiplier: 1 },
   { pattern: /(\d+)\s*months?\s*(later|ago)?/gi, type: "month", multiplier: 1 },
-  // 数字 + 年
+  // Number + year
   { pattern: /(\d+)\s*年[后前]?/g, type: "year", multiplier: 1 },
   { pattern: /(\d+)\s*years?\s*(later|ago)?/gi, type: "year", multiplier: 1 }
 ];
 var commonDateFormats = [
   "yyyy-MM-dd",
-  // 最常用的 ISO 格式
+  // Most commonly used ISO format
   "MM/dd/yyyy",
-  // 美式格式
+  // American format
   "dd/MM/yyyy",
-  // 欧式格式
+  // European format
   "yyyy/MM/dd",
-  // 日式格式
+  // Japanese format
   "yyyyMMdd",
-  // 紧凑格式
+  // Compact format
   "yyyy-M-d",
-  // 宽松格式
+  // Loose format
   "yyyy/M/d",
   "M/d/yyyy",
   "d/M/yyyy",
+  // German format
   "dd.MM.yyyy",
-  // 德式格式
+  // German format
   "yyyy.MM.dd"
 ];
 var commonTimeFormats = [
   "HH:mm",
-  // 24小时制（最常用）
+  // 24 hour format (most commonly used)
   "H:mm",
-  // 24小时制不补零
+  // 24 hour format without zero padding
   "HH:mm:ss",
-  // 带秒
+  // With seconds
   "h:mm a",
-  // 12小时制
+  // 12 hour format without zero padding
   "hh:mm a",
-  // 12小时制补零
+  // 12 hour format with zero padding
   "h:mm aa",
   "HHmm",
-  // 紧凑格式
+  // Compact format
   "Hmm"
 ];
 var parserConfig = {
-  // 缓存配置
+  // Cache configuration
   cache: {
     enabled: true,
     maxSize: 100,
-    // 最大缓存条目数
+    // Maximum cache entries
     ttl: 6e4
-    // 缓存时间 (ms)
+    // Cache time (ms)
   },
-  // 性能阈值
+  // Performance threshold
   performance: {
     maxParseTime: 50
   }
@@ -586,17 +587,17 @@ function parseRelativeDate(input) {
 function parseExtendedRelativeDate(input) {
   const now = /* @__PURE__ */ new Date();
   const patterns = [
-    // +数字 (天数)
+    // +number (days)
     {
       regex: /^\+(\d+)$/,
       handler: (match) => addDays(now, parseInt(match[1], 10))
     },
-    // -数字 (天数)
+    // -number (days)
     {
       regex: /^-(\d+)$/,
       handler: (match) => subDays(now, parseInt(match[1], 10))
     },
-    // w+数字 (周数)
+    // w+number (weeks)
     {
       regex: /^w\+(\d+)$/i,
       handler: (match) => addWeeks(now, parseInt(match[1], 10))
@@ -605,7 +606,7 @@ function parseExtendedRelativeDate(input) {
       regex: /^w-(\d+)$/i,
       handler: (match) => subWeeks(now, parseInt(match[1], 10))
     },
-    // m+数字 (月数)
+    // m+number (months)
     {
       regex: /^m\+(\d+)$/i,
       handler: (match) => addMonths(now, parseInt(match[1], 10))
@@ -614,7 +615,7 @@ function parseExtendedRelativeDate(input) {
       regex: /^m-(\d+)$/i,
       handler: (match) => subMonths(now, parseInt(match[1], 10))
     },
-    // y+数字 (年数)
+    // y+number (years)
     {
       regex: /^y\+(\d+)$/i,
       handler: (match) => addYears(now, parseInt(match[1], 10))
@@ -623,7 +624,7 @@ function parseExtendedRelativeDate(input) {
       regex: /^y-(\d+)$/i,
       handler: (match) => subYears(now, parseInt(match[1], 10))
     },
-    // 中文相对表达
+    // Chinese relative expression
     {
       regex: /^(\d+)天后$/,
       handler: (match) => addDays(now, parseInt(match[1], 10))
@@ -765,27 +766,27 @@ var DigitExtractor = class {
   constructor(digits) {
     this.digits = digits;
   }
-  /** 提取指定位置的数字 */
+  /** Extract number at specified position */
   extract(start, length) {
     return parseInt(this.digits.substring(start, start + length), 10);
   }
-  /** 提取年份 (前2位) */
+  /** Extract year (first 2 digits) */
   getYear2() {
     return this.extract(0, 2);
   }
-  /** 提取年份 (前4位) */
+  /** Extract year (first 4 digits) */
   getYear4() {
     return this.extract(0, 4);
   }
-  /** 提取月份 (前2位) */
+  /** Extract month (first 2 digits) */
   getMonth() {
     return this.extract(0, 2);
   }
-  /** 提取日期 (第3-4位) */
+  /** Extract date (3-4th digits) */
   getDay() {
     return this.extract(2, 2);
   }
-  /** 提取6位数字的各个部分 (YYMMDD格式) */
+  /** Extract each part of 6 digits (YYMMDD format) */
   getYYMMDD() {
     return {
       year: this.extract(0, 2),
@@ -793,7 +794,7 @@ var DigitExtractor = class {
       day: this.extract(4, 2)
     };
   }
-  /** 提取8位数字的各个部分 (YYYYMMDD格式) */
+  /** Extract each part of 8 digits (YYYYMMDD format) */
   getYYYYMMDD() {
     return {
       year: this.extract(0, 4),
@@ -801,7 +802,7 @@ var DigitExtractor = class {
       day: this.extract(6, 2)
     };
   }
-  /** 提取3位数字的各个部分 */
+  /** Extract each part of 3 digits */
   get3DigitParts() {
     return {
       first: this.extract(0, 1),
@@ -1065,7 +1066,7 @@ function buildYYYYMMDDFormat(digitOnlyInput, length, currentYear, currentMonth,
     return `${year}-${monthTens}-${currentDay}`;
   } else if (length === 6) {
     const result = parseYYMMDD(digitOnlyInput, "yyyy-MM-dd");
-    return (result == null ? void 0 : result.formatted) || // 降级到智能修正，强制使用 YYMMDD 格式
+    return (result == null ? void 0 : result.formatted) || // Degrade to intelligent correction, force using YYMMDD format
     (() => {
       const yymmddYear = parseInt(digitOnlyInput.substring(0, 2), 10);
       const yymmddMonth = parseInt(digitOnlyInput.substring(2, 4), 10);
@@ -1082,7 +1083,7 @@ function buildYYYYMMDDFormat(digitOnlyInput, length, currentYear, currentMonth,
     return `${year}-${validMonth}-${dayTens}`;
   } else if (length === 8) {
     const result = parseYYYYMMDD(digitOnlyInput);
-    return (result == null ? void 0 : result.formatted) || // 降级到智能修正
+    return (result == null ? void 0 : result.formatted) || // Degrade to intelligent correction
     (() => {
       const year = parseInt(digitOnlyInput.substring(0, 4), 10);
       const month = parseInt(digitOnlyInput.substring(4, 6), 10);
@@ -1432,15 +1433,15 @@ var yearUtils = {
     }
     return void 0;
   },
-  /** 创建年份的开始日期 */
+  /** Create year start date */
   createYearDate(year) {
     return new Date(year, 0, 1);
   },
-  /** 获取当前年份 */
+  /** Get current year */
   getCurrentYear() {
     return (/* @__PURE__ */ new Date()).getFullYear();
   },
-  /** 验证年份是否在有效范围内 */
+  /** Validate if year is in valid range */
   isYearInRange(year, minYear, maxYear) {
     const minValid = minYear === void 0 || year >= minYear;
     const maxValid = maxYear === void 0 || year <= maxYear;
@@ -1448,7 +1449,7 @@ var yearUtils = {
   }
 };
 var quarterUtils = {
-  /** 安全地从各种输入中提取年份数字 */
+  /** Safely extract year number from various inputs */
   extractYear(input) {
     if (isDate(input) && isValid(input)) {
       return input.getFullYear();
@@ -1458,27 +1459,27 @@ var quarterUtils = {
     }
     return void 0;
   },
-  /** 获取当前年份 */
+  /** Get current year */
   getCurrentYear() {
     return (/* @__PURE__ */ new Date()).getFullYear();
   },
-  /** 获取当前季度数字 (1-4) */
+  /** Get current quarter number (1-4) */
   getCurrentQuarterNumber() {
     const currentMonth = (/* @__PURE__ */ new Date()).getMonth() + 1;
     return Math.ceil(currentMonth / 3);
   },
-  /** 验证年份是否在有效范围内 */
+  /** Validate if year is in valid range */
   isYearInRange(year, minYear, maxYear) {
     const minValid = minYear === void 0 || year >= minYear;
     const maxValid = maxYear === void 0 || year <= maxYear;
     return minValid && maxValid;
   },
-  /** 创建季度的开始日期 */
+  /** Create quarter start date */
   createQuarterStartDate(quarter, year) {
     const startMonth = (quarter - 1) * 3;
     return new Date(year, startMonth, 1);
   },
-  /** 创建季度的结束日期 */
+  /** Create quarter end date */
   createQuarterEndDate(quarter, year) {
     const endMonth = (quarter - 1) * 3 + 2;
     return new Date(year, endMonth + 1, 0);
@@ -3162,7 +3163,7 @@ var TimeCalendar = memo(function TimeCalendar2(props) {
       const previousSelectedIndex2 = lastSelectedIndexRef.current;
       const isSelectedIndexChanged2 = previousSelectedIndex2 !== selectedIndex;
       lastSelectedIndexRef.current = selectedIndex;
-      const shouldScroll2 = !hasInitialScrolled.current || // 初始化滚动
+      const shouldScroll2 = !hasInitialScrolled.current || // Initial scrolling
       isSelectedIndexChanged2 && !isInternalOperationRef.current;
       if (shouldScroll2) {
         const isInitialScroll = !hasInitialScrolled.current;
@@ -3192,7 +3193,7 @@ var TimeCalendar = memo(function TimeCalendar2(props) {
     const previousSelectedIndex = lastSelectedIndexRef.current;
     const isSelectedIndexChanged = previousSelectedIndex !== selectedIndex;
     lastSelectedIndexRef.current = selectedIndex;
-    const shouldScroll = !hasInitialScrolled.current || // 初始化滚动
+    const shouldScroll = !hasInitialScrolled.current || // Initial scrolling
     isSelectedIndexChanged && !isInternalOperationRef.current;
     if (shouldScroll) {
       const isInitialScroll = !hasInitialScrolled.current;
@@ -3605,7 +3606,7 @@ function useTimeInput(props) {
 }
 var TimeInput = forwardRef((props, ref) => {
   const {
-    // 时间相关属性
+    // Time related properties
     defaultValue,
     value,
     onChange,
@@ -3616,16 +3617,16 @@ var TimeInput = forwardRef((props, ref) => {
     step = 1,
     shiftStep = 15,
     metaStep = 60,
-    // 交互相关属性
+    // Interaction related properties
     enableCache = true,
     enableKeyboardNavigation = true,
     enableProfiling = false,
     onEnterKeyDown,
-    // UI 相关属性
+    // UI related properties
     placeholder = "Enter time...",
     prefixElement = /* @__PURE__ */ jsx(Clock, {}),
     suffixElement,
-    // TextField 属性
+    // TextField properties
     ...rest
   } = props;
   const locale = resolveLocale(propLocale);

package/dist/components/calendar/src/date-range-input/date-range-input.d.ts

@@ -16,11 +16,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;

package/dist/components/calendar/src/time-calendar/time-calendar.d.ts

@@ -2,11 +2,11 @@ import { default as React } from 'react';
 import { BaseTimeProps, StepProps } from '../types';
 export interface TimeCalendarProps extends BaseTimeProps, StepProps {
     children?: React.ReactNode;
-    /** 自定义类名 */
+    /** Custom class name */
     className?: string;
-    /** 小时步进，默认1小时 */
+    /** Hour step, default 1 hour */
     hourStep?: number;
-    /** 分钟步进，默认15分钟 */
+    /** Minute step, default 15 minutes */
     minuteStep?: number;
 }
 export declare const TimeCalendar: React.NamedExoticComponent<TimeCalendarProps>;

package/dist/components/calendar/src/time-calendar/time-calendar.js

@@ -134,7 +134,7 @@ const TimeCalendar = memo(function TimeCalendar2(props) {
       const previousSelectedIndex2 = lastSelectedIndexRef.current;
       const isSelectedIndexChanged2 = previousSelectedIndex2 !== selectedIndex;
       lastSelectedIndexRef.current = selectedIndex;
-      const shouldScroll2 = !hasInitialScrolled.current || // 初始化滚动
+      const shouldScroll2 = !hasInitialScrolled.current || // Initial scrolling
       isSelectedIndexChanged2 && !isInternalOperationRef.current;
       if (shouldScroll2) {
         const isInitialScroll = !hasInitialScrolled.current;
@@ -164,7 +164,7 @@ const TimeCalendar = memo(function TimeCalendar2(props) {
     const previousSelectedIndex = lastSelectedIndexRef.current;
     const isSelectedIndexChanged = previousSelectedIndex !== selectedIndex;
     lastSelectedIndexRef.current = selectedIndex;
-    const shouldScroll = !hasInitialScrolled.current || // 初始化滚动
+    const shouldScroll = !hasInitialScrolled.current || // Initial scrolling
     isSelectedIndexChanged && !isInternalOperationRef.current;
     if (shouldScroll) {
       const isInitialScroll = !hasInitialScrolled.current;

package/dist/components/calendar/src/time-input/time-input.d.ts

@@ -6,16 +6,16 @@ interface TimeInputProps extends Omit<TextFieldProps, "value" | "onChange" | "fo
     suffixElement?: React.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
  */
 export declare const TimeInput: React.ForwardRefExoticComponent<Omit<TimeInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
 export {};

package/dist/components/calendar/src/time-input/time-input.js

@@ -8,7 +8,7 @@ import { resolveLocale } from "../utils/locale.js";
 import { tcx } from "../../../../shared/utils/tcx/tcx.js";
 const TimeInput = forwardRef((props, ref) => {
   const {
-    // 时间相关属性
+    // Time related properties
     defaultValue,
     value,
     onChange,
@@ -19,16 +19,16 @@ const TimeInput = forwardRef((props, ref) => {
     step = 1,
     shiftStep = 15,
     metaStep = 60,
-    // 交互相关属性
+    // Interaction related properties
     enableCache = true,
     enableKeyboardNavigation = true,
     enableProfiling = false,
     onEnterKeyDown,
-    // UI 相关属性
+    // UI related properties
     placeholder = "Enter time...",
     prefixElement = /* @__PURE__ */ jsx(Clock, {}),
     suffixElement,
-    // TextField 属性
+    // TextField properties
     ...rest
   } = props;
   const locale = resolveLocale(propLocale);