@hsu-react/ui 0.0.13 → 0.0.15

package/lib/components/Search/_utils/calculateButtonGroupAndColumnWidth.js

@@ -6,25 +6,25 @@ Object.defineProperty(exports, "__esModule", {
 exports.calculateButtonGroupAndColumnWidth = calculateButtonGroupAndColumnWidth;
 var _measureButtonGroupWidth = require("./measureButtonGroupWidth");
 /**
- * 计算按钮组宽度和列宽
- * @param containerRef 容器引用
- * @param buttonGroupRef 按钮组引用
- * @param adaptiveColumnNum 自适应列数
- * @param columnOffsetWidth 列偏移宽度（默认 0）
- * @returns 按钮组宽度和列宽
+ * Computes the button group width and column width
+ * @param containerRef Container ref
+ * @param buttonGroupRef Button group ref
+ * @param adaptiveColumnNum Adaptive column count
+ * @param columnOffsetWidth Column offset width (default 0)
+ * @returns Button group width and column width
  */
 function calculateButtonGroupAndColumnWidth(containerRef, buttonGroupRef, adaptiveColumnNum, columnOffsetWidth = 0) {
   let buttonGroupWidth;
   let columnWidth;
   if (containerRef.current && buttonGroupRef.current) {
     const containerWidth = containerRef.current.offsetWidth;
-    const availableWidth = containerWidth - 30; // 减去padding
-    const gap = 10; // 项之间的间距
+    const availableWidth = containerWidth - 30; // Subtract padding
+    const gap = 10; // Gap between items
 
-    // 计算按钮组宽度
+    // Compute the button group width
     buttonGroupWidth = (0, _measureButtonGroupWidth.measureButtonGroupWidth)(buttonGroupRef.current);
 
-    // 计算列宽（单个搜索项的默认宽度）
+    // Compute the column width (default width of a single search item)
     if (adaptiveColumnNum > 0) {
       columnWidth = availableWidth - (((availableWidth - adaptiveColumnNum * gap) / (adaptiveColumnNum + 1) - columnOffsetWidth) * adaptiveColumnNum + adaptiveColumnNum * gap);
     }

package/lib/components/Search/_utils/calculateVisibleItems.d.ts

@@ -1,13 +1,13 @@
 import { FormItemProps } from "../../FormItem";
 /**
- * 计算当前应该显示的搜索项
- * @param searchItems 所有搜索项
- * @param expand 是否展开
- * @param columnNum 列数
- * @param visibleItemCount 可见项数量（自适应宽度时使用）
- * @param autoAdaptWidth 是否启用自适应宽度
- * @param buttonGroupWidth 按钮组宽度（可选）
- * @param columnWidth 列宽（可选）
- * @returns 当前应该显示的搜索项
+ * Computes the search items that should currently be displayed
+ * @param searchItems All search items
+ * @param expand Whether expanded
+ * @param columnNum Column count
+ * @param visibleItemCount Visible item count (used with adaptive width)
+ * @param autoAdaptWidth Whether adaptive width is enabled
+ * @param buttonGroupWidth Button group width (optional)
+ * @param columnWidth Column width (optional)
+ * @returns The search items that should currently be displayed
  */
 export declare function calculateVisibleItems(searchItems: FormItemProps[], expand: boolean, columnNum: number, visibleItemCount: number, autoAdaptWidth: boolean, buttonGroupWidth?: number, columnWidth?: number): FormItemProps[];

package/lib/components/Search/_utils/calculateVisibleItems.js

@@ -6,28 +6,28 @@ Object.defineProperty(exports, "__esModule", {
 exports.calculateVisibleItems = calculateVisibleItems;
 var _shouldDisplayExtraItem = require("./shouldDisplayExtraItem");
 /**
- * 计算当前应该显示的搜索项
- * @param searchItems 所有搜索项
- * @param expand 是否展开
- * @param columnNum 列数
- * @param visibleItemCount 可见项数量（自适应宽度时使用）
- * @param autoAdaptWidth 是否启用自适应宽度
- * @param buttonGroupWidth 按钮组宽度（可选）
- * @param columnWidth 列宽（可选）
- * @returns 当前应该显示的搜索项
+ * Computes the search items that should currently be displayed
+ * @param searchItems All search items
+ * @param expand Whether expanded
+ * @param columnNum Column count
+ * @param visibleItemCount Visible item count (used with adaptive width)
+ * @param autoAdaptWidth Whether adaptive width is enabled
+ * @param buttonGroupWidth Button group width (optional)
+ * @param columnWidth Column width (optional)
+ * @returns The search items that should currently be displayed
  */
 function calculateVisibleItems(searchItems, expand, columnNum, visibleItemCount, autoAdaptWidth, buttonGroupWidth, columnWidth) {
   const visibleItems = searchItems.filter(item => item.visible);
   const hasCustomWidth = searchItems.some(item => item.width !== undefined);
   if (!expand) {
-    // 当有自定义宽度时，使用自适应计算
+    // When there are custom widths, use adaptive calculation
     if (hasCustomWidth && autoAdaptWidth) {
       if (visibleItems.length > visibleItemCount) {
         return visibleItems.slice(0, visibleItemCount);
       }
     } else if (!hasCustomWidth) {
-      // 没有自定义宽度时，使用 columnNum（实际搜索项数量）
-      // 判断按钮组宽度是否大于列宽，如果是，则显示 实际搜索项数量+1
+      // Without custom widths, use columnNum (actual search item count)
+      // If the button group is wider than a column, display actual search item count + 1
       const displayCount = (0, _shouldDisplayExtraItem.shouldDisplayExtraItem)(buttonGroupWidth, columnWidth, columnNum, visibleItems.length) ? columnNum + 1 : columnNum;
       if (visibleItems.length >= displayCount) {
         return visibleItems.slice(0, displayCount);

package/lib/components/Search/_utils/cleanSearchData.d.ts

@@ -1,6 +1,6 @@
 /**
- * 清理搜索数据，移除 undefined 值
- * @param data 原始搜索数据
- * @returns 清理后的搜索数据
+ * Cleans search data by removing undefined values
+ * @param data Raw search data
+ * @returns Cleaned search data
  */
 export declare function cleanSearchData<T = Record<string, unknown>>(data: Record<string, unknown>): Partial<T> | undefined;

package/lib/components/Search/_utils/cleanSearchData.js

@@ -5,9 +5,9 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.cleanSearchData = cleanSearchData;
 /**
- * 清理搜索数据，移除 undefined 值
- * @param data 原始搜索数据
- * @returns 清理后的搜索数据
+ * Cleans search data by removing undefined values
+ * @param data Raw search data
+ * @returns Cleaned search data
  */
 function cleanSearchData(data) {
   const cleaned = {};

package/lib/components/Search/_utils/measureButtonGroupWidth.d.ts

@@ -1,6 +1,6 @@
 /**
- * 计算按钮组的实际宽度（所有子元素宽度总和 + 子元素间距）
- * @param buttonGroupEl 按钮组元素
- * @returns 按钮组宽度；无子元素时返回 undefined
+ * Computes the actual width of the button group (sum of all child element widths + gaps between children)
+ * @param buttonGroupEl Button group element
+ * @returns Button group width; undefined when there are no children
  */
 export declare function measureButtonGroupWidth(buttonGroupEl: HTMLElement | null): number | undefined;

package/lib/components/Search/_utils/measureButtonGroupWidth.js

@@ -5,9 +5,9 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.measureButtonGroupWidth = measureButtonGroupWidth;
 /**
- * 计算按钮组的实际宽度（所有子元素宽度总和 + 子元素间距）
- * @param buttonGroupEl 按钮组元素
- * @returns 按钮组宽度；无子元素时返回 undefined
+ * Computes the actual width of the button group (sum of all child element widths + gaps between children)
+ * @param buttonGroupEl Button group element
+ * @returns Button group width; undefined when there are no children
  */
 function measureButtonGroupWidth(buttonGroupEl) {
   if (!buttonGroupEl) return undefined;
@@ -17,7 +17,7 @@ function measureButtonGroupWidth(buttonGroupEl) {
   buttonChildren.forEach(child => {
     totalWidth += child.offsetWidth;
   });
-  // 加上子元素之间的间距
+  // Add the gaps between child elements
   const childGap = 5;
   totalWidth += (buttonChildren.length - 1) * childGap;
   return totalWidth;

package/lib/components/Search/_utils/shouldDisplayExtraItem.d.ts

@@ -1,11 +1,11 @@
 /**
- * 判断收起状态下是否应多显示一个搜索项
+ * Determines whether one extra search item should be displayed in collapsed state
  *
- * 规则：按钮组宽度大于列宽（按钮组独占更宽空间，首行有富余）；
- * 或按钮组宽度小于列宽且可见项刚好比列数多 1（此时收起只会藏起 1 项，不如直接放下）。
- * @param buttonGroupWidth 按钮组宽度
- * @param columnWidth 列宽
- * @param columnNum 搜索项列数（不含按钮组）
- * @param visibleCount 可见搜索项总数
+ * Rules: the button group is wider than a column (the button group takes up more space on its own, leaving spare room in the first row);
+ * or the button group is narrower than a column and the visible items exceed the column count by exactly 1 (collapsing would only hide 1 item, so it's better to just fit it in).
+ * @param buttonGroupWidth Button group width
+ * @param columnWidth Column width
+ * @param columnNum Search item column count (excluding the button group)
+ * @param visibleCount Total number of visible search items
  */
 export declare function shouldDisplayExtraItem(buttonGroupWidth: number | undefined, columnWidth: number | undefined, columnNum: number, visibleCount: number): boolean;

package/lib/components/Search/_utils/shouldDisplayExtraItem.js

@@ -5,14 +5,14 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.shouldDisplayExtraItem = shouldDisplayExtraItem;
 /**
- * 判断收起状态下是否应多显示一个搜索项
+ * Determines whether one extra search item should be displayed in collapsed state
  *
- * 规则：按钮组宽度大于列宽（按钮组独占更宽空间，首行有富余）；
- * 或按钮组宽度小于列宽且可见项刚好比列数多 1（此时收起只会藏起 1 项，不如直接放下）。
- * @param buttonGroupWidth 按钮组宽度
- * @param columnWidth 列宽
- * @param columnNum 搜索项列数（不含按钮组）
- * @param visibleCount 可见搜索项总数
+ * Rules: the button group is wider than a column (the button group takes up more space on its own, leaving spare room in the first row);
+ * or the button group is narrower than a column and the visible items exceed the column count by exactly 1 (collapsing would only hide 1 item, so it's better to just fit it in).
+ * @param buttonGroupWidth Button group width
+ * @param columnWidth Column width
+ * @param columnNum Search item column count (excluding the button group)
+ * @param visibleCount Total number of visible search items
  */
 function shouldDisplayExtraItem(buttonGroupWidth, columnWidth, columnNum, visibleCount) {
   return buttonGroupWidth !== undefined && columnWidth !== undefined && (buttonGroupWidth > columnWidth || buttonGroupWidth < columnWidth && columnNum + 1 === visibleCount);

package/lib/components/Search/index.d.ts

@@ -27,8 +27,8 @@ export type SearchModePropsMap = {
     WithMore: React.ComponentProps<SearchFC["WithMore"]>;
 };
 /**
- * 基础 Search 组件
- * - 标准的搜索表单布局，自适应列数与展开/收起
+ * Base Search component
+ * - Standard search form layout with adaptive column count and expand/collapse
  */
 declare const Search: SearchFC;
 export default Search;

package/lib/components/Search/index.js

@@ -13,13 +13,13 @@ var _SearchWithMore = _interopRequireDefault(require("./SearchWithMore"));
 var _SearchBase = _interopRequireDefault(require("./_components/SearchBase"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-// 导出所有可用的 Search 模式键名
+// Export all available Search mode key names
 
-// 导出 Search 模式映射类型
+// Export the Search mode props mapping type
 
 /**
- * 基础 Search 组件
- * - 标准的搜索表单布局，自适应列数与展开/收起
+ * Base Search component
+ * - Standard search form layout with adaptive column count and expand/collapse
  */
 const Search = props => {
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_SearchBase.default, {

package/lib/components/Search/index.module.scss

@@ -8,7 +8,7 @@
   width: 100%;
   padding: 14px 16px;
 
-  // CF 风格：描边白卡片（随外观切换），去投影
+  // CF style: outlined white card (follows appearance switching), no shadow
   background: var(--cf-surface);
 
   border-radius: 8px;

package/lib/components/SecondConf/index.module.scss

@@ -13,7 +13,7 @@
 
     .icon {
       font-size: 50px;
-      color: #ff9900;
+      color: var(--cf-warning);
     }
 
     .content {

package/lib/components/Select/AutoCompleteSelect/index.js

@@ -38,21 +38,29 @@ const AutoCompleteSelect = props => {
     popupMatchSelectWidth,
     popupMatchContentWidth,
     optionFontSize = 14,
+    value,
     ...antdAutoCompleteConfig
   } = props;
   const [focused, setFocused] = (0, _react.useState)(false);
   const autoCompleteRef = (0, _react.useRef)(null);
   const [open, setOpen] = (0, _react.useState)(false);
+  const [searchText, setSearchText] = (0, _react.useState)("");
   const [legacyHasErrorStatus, setLegacyHasErrorStatus] = (0, _react.useState)(false);
   const [legacyHasArrowOrClear, setLegacyHasArrowOrClear] = (0, _react.useState)(true);
   const legacyHasSelector = (0, _cssSupports.isLegacyHasSelectorBrowser)();
   const cls = (0, _react.useMemo)(() => (0, _hsuUtils.generateRandomStr)(10), []);
+  const handleSearch = (0, _react.useCallback)(searchValue => {
+    setSearchText(searchValue);
+    onSearch?.(searchValue);
+  }, [onSearch]);
+
+  // Always pass handleSearch so IME composition events stay observed
+  // (an in-progress pinyin input must not wipe out the option list)
   const {
     isComposing
   } = (0, _hooks.useSelectComposition)({
-    onSearch
+    onSearch: handleSearch
   });
-  (0, _hooks.useSelectPopupPosition)(autoCompleteRef, open, cls);
   const autoCompleteWidth = autoCompleteRef.current ? autoCompleteRef.current.offsetWidth : 0;
   const calculatedPopupWidth = popupMatchContentWidth ? (0, _utils.calculatePopupWidth)({
     options: options?.map(opt => ({
@@ -63,7 +71,7 @@ const AutoCompleteSelect = props => {
     optionFontSize
   }) : autoCompleteWidth;
 
-  // 转换 options 格式为 AutoComplete 需要的格式
+  // Convert options into the format AutoComplete requires
   const autoCompleteOptions = (0, _react.useMemo)(() => {
     return options?.map(option => {
       const {
@@ -81,26 +89,48 @@ const AutoCompleteSelect = props => {
     });
   }, [options]);
 
-  // 处理 filterOption
-  const handleFilterOption = (0, _react.useMemo)(() => {
-    // 如果提供了自定义 filterOption，优先使用
+  // Filter rule: prefer the custom filterOption, otherwise fall back to a
+  // case-insensitive substring match
+  const matchOption = (0, _react.useMemo)(() => {
     if (customFilterOption) {
-      return (inputValue, option) => {
-        return customFilterOption(inputValue, option);
-      };
+      return customFilterOption;
     }
-
-    // 默认过滤逻辑：不区分大小写的包含匹配
     return (inputValue, option) => {
-      if (!isComposing && option) {
-        const searchText = inputValue.toUpperCase();
-        const optionValue = (option.value ?? "").toString().toUpperCase();
-        const optionLabel = (option.label ?? option.value ?? "").toString().toUpperCase();
-        return optionValue.includes(searchText) || optionLabel.includes(searchText);
+      if (!option) {
+        return true;
       }
-      return true;
+      const keyword = inputValue.toUpperCase();
+      const optionValue = (option.value ?? "").toString().toUpperCase();
+      const optionLabel = (option.label ?? option.value ?? "").toString().toUpperCase();
+      return optionValue.includes(keyword) || optionLabel.includes(keyword);
     };
-  }, [customFilterOption, isComposing]);
+  }, [customFilterOption]);
+
+  // Text the filter runs against: the controlled value wins, otherwise use the
+  // internally tracked search keyword
+  const filterText = (0, _react.useMemo)(() => {
+    if (value !== undefined && value !== null) {
+      return String(value);
+    }
+    return searchText;
+  }, [value, searchText]);
+
+  // Filter inside the component (antd's own filterOption is turned off) so we
+  // know whether any candidate survives, keeping controlled open in sync
+  const filteredOptions = (0, _react.useMemo)(() => {
+    // Skip filtering while composing so an in-progress pinyin input does not
+    // empty the candidate list
+    if (isComposing || !filterText) {
+      return autoCompleteOptions;
+    }
+    return autoCompleteOptions.filter(option => matchOption(filterText, option));
+  }, [autoCompleteOptions, filterText, isComposing, matchOption]);
+
+  // In combobox mode antd hides the popup by itself when there is no candidate
+  // and skips onDropdownVisibleChange, so fold "no candidate" into open to stop
+  // the controlled state from drifting and leaving an empty popup behind
+  const mergedOpen = open && filteredOptions.length > 0;
+  (0, _hooks.useSelectPopupPosition)(autoCompleteRef, mergedOpen, cls);
   (0, _react.useEffect)(() => {
     if (!legacyHasSelector) {
       return;
@@ -140,7 +170,7 @@ const AutoCompleteSelect = props => {
     return () => {
       observer.disconnect();
     };
-  }, [legacyHasSelector, open]);
+  }, [legacyHasSelector, mergedOpen]);
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
     className: (0, _classnames.default)({
       [_indexModule.default.autoCompleteSelect]: true,
@@ -156,19 +186,23 @@ const AutoCompleteSelect = props => {
     }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.AutoComplete, {
       allowClear: true,
       ...antdAutoCompleteConfig,
+      value,
       onFocus: e => {
         setFocused(true);
         onFocus?.(e);
       },
       onBlur: e => {
         setFocused(false);
+        // antd skips onDropdownVisibleChange when there is no candidate,
+        // so collapse the controlled state manually on blur
+        setOpen(false);
         onBlur?.(e);
       },
-      options: autoCompleteOptions,
-      filterOption: handleFilterOption,
+      options: filteredOptions,
+      filterOption: false,
       onChange,
-      onSearch,
-      open,
+      onSearch: handleSearch,
+      open: mergedOpen,
       onDropdownVisibleChange: visible => {
         setOpen(visible);
         onDropdownVisibleChange?.(visible);

package/lib/components/Select/AutoCompleteSelect/index.module.scss

@@ -8,7 +8,7 @@
   height: 100%;
   padding: 0px 11px;
 
-  // CF 风格：随外观切换的描边输入控件
+  // CF style: outlined input control that follows appearance switching
   border: 1px solid var(--cf-border);
   border-radius: 6px;
 
@@ -49,7 +49,7 @@
   &.focused {
     border-color: var(--primary-color);
 
-    box-shadow: 0 0 0 2px rgba(19, 194, 194, 0.12);
+    box-shadow: 0 0 0 2px color-mix(in srgb, var(--primary-color) 12%, transparent);
 
     outline: 0;
   }
@@ -76,20 +76,20 @@
   }
 
   &:has(:global(.ant-select-status-error)) {
-    border: 1px solid #ff4d4f;
+    border: 1px solid var(--cf-error);
 
     .prefix,
     .suffix {
-      color: #ff4d4f;
+      color: var(--cf-error);
     }
   }
 
   &.legacyHasErrorStatus {
-    border: 1px solid #ff4d4f;
+    border: 1px solid var(--cf-error);
 
     .prefix,
     .suffix {
-      color: #ff4d4f;
+      color: var(--cf-error);
     }
   }
 

package/lib/components/Select/IconSelect/index.module.scss

@@ -54,12 +54,12 @@
 
       font-size: 16px;
 
-      border: 1px solid #f0edea;
+      border: 1px solid var(--cf-border-weak);
 
       cursor: pointer;
 
       &.active {
-        background: #dddddd;
+        background: var(--cf-row-hover);
       }
     }
   }

package/lib/components/Select/TreeSelect/_utils/getExpandedKeysByLevel.d.ts

@@ -1,8 +1,8 @@
 import { DataNode, SafeKey } from "rc-tree-select/lib/interface";
 /**
- * 根据默认展开层级计算应该展开的节点 keys（用于 TreeSelect）
- * @param treeData 树数据（DataNode 类型）
- * @param level 展开层级（从 1 开始，1 表示第一层，2 表示第二层，以此类推）
- * @returns 应该展开的节点 keys 数组
+ * Compute the node keys that should be expanded based on the default expand level (for TreeSelect)
+ * @param treeData Tree data (DataNode type)
+ * @param level Expand level (starting from 1; 1 means the first level, 2 the second, and so on)
+ * @returns Array of node keys that should be expanded
  */
 export declare const getExpandedKeysByLevel: (treeData: DataNode[], level: number) => SafeKey[];

package/lib/components/Select/TreeSelect/_utils/getExpandedKeysByLevel.js

@@ -5,10 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.getExpandedKeysByLevel = void 0;
 /**
- * 根据默认展开层级计算应该展开的节点 keys（用于 TreeSelect）
- * @param treeData 树数据（DataNode 类型）
- * @param level 展开层级（从 1 开始，1 表示第一层，2 表示第二层，以此类推）
- * @returns 应该展开的节点 keys 数组
+ * Compute the node keys that should be expanded based on the default expand level (for TreeSelect)
+ * @param treeData Tree data (DataNode type)
+ * @param level Expand level (starting from 1; 1 means the first level, 2 the second, and so on)
+ * @returns Array of node keys that should be expanded
  */
 const getExpandedKeysByLevel = (treeData, level) => {
   if (level < 1 || !treeData?.length) {
@@ -17,7 +17,7 @@ const getExpandedKeysByLevel = (treeData, level) => {
   const expandedKeys = [];
   const traverse = (nodes, currentLevel) => {
     for (const node of nodes) {
-      // 如果当前层级小于目标层级，则展开该节点
+      // Expand this node if the current level is below the target level
       if (currentLevel < level && node.children?.length && node.key !== undefined) {
         expandedKeys.push(node.key);
         traverse(node.children, currentLevel + 1);

package/lib/components/Select/TreeSelect/index.module.scss

@@ -6,7 +6,7 @@
   width: 100%;
   height: 100%;
 
-  // CF 风格：随外观切换的描边输入控件
+  // CF style: outlined input control that follows appearance switching
   background: var(--cf-surface);
   border: 1px solid var(--cf-border);
   border-radius: 6px;

package/lib/components/Select/_hooks/useSelectComposition.d.ts

@@ -2,7 +2,7 @@ interface UseSelectCompositionProps {
     onSearch?: (value: string) => void;
 }
 /**
- * 管理输入法组合状态
+ * Manage IME composition state
  */
 export declare function useSelectComposition({ onSearch, }: UseSelectCompositionProps): {
     isComposing: boolean;

package/lib/components/Select/_hooks/useSelectComposition.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.useSelectComposition = useSelectComposition;
 var _react = require("react");
 /**
- * 管理输入法组合状态
+ * Manage IME composition state
  */
 function useSelectComposition({
   onSearch

package/lib/components/Select/_hooks/useSelectInputOptions.d.ts

@@ -8,7 +8,7 @@ interface UseSelectInputOptionsProps {
     optionsLength: number;
 }
 /**
- * 管理输入选项（当没有匹配项时）
+ * Manage input options (when there are no matching options)
  */
 export declare function useSelectInputOptions({ searchValue, isComposing, onChange, onSearch, optionsLength, }: UseSelectInputOptionsProps): {
     inputOptions: SelectOption<string | number>[];

package/lib/components/Select/_hooks/useSelectInputOptions.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.useSelectInputOptions = useSelectInputOptions;
 var _react = require("react");
 /**
- * 管理输入选项（当没有匹配项时）
+ * Manage input options (when there are no matching options)
  */
 function useSelectInputOptions({
   searchValue,

package/lib/components/Select/_utils/calculatePopupWidth.d.ts

@@ -7,7 +7,7 @@ interface CalculatePopupWidthOptions {
     valueInlabel?: "before" | "after";
 }
 /**
- * 计算弹出层宽度
+ * Calculate popup width
  */
 export declare function calculatePopupWidth({ options, selectWidth, mode, optionFontSize, valueInlabel, }: CalculatePopupWidthOptions): number;
 export {};

package/lib/components/Select/_utils/calculatePopupWidth.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.calculatePopupWidth = calculatePopupWidth;
 var _hsuUtils = require("hsu-utils");
 /**
- * 计算弹出层宽度
+ * Calculate popup width
  */
 function calculatePopupWidth({
   options,

package/lib/components/Select/_utils/filterOption.d.ts

@@ -7,7 +7,7 @@ interface FilterOptionParams {
     valueInlabel?: "before" | "after";
 }
 /**
- * 过滤选项
+ * Filter options
  */
 export declare function filterOption({ searchValue, option, isComposing, customFilterOption, valueInlabel, }: FilterOptionParams): boolean;
 export {};

package/lib/components/Select/_utils/filterOption.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.filterOption = filterOption;
 /**
- * 过滤选项
+ * Filter options
  */
 function filterOption({
   searchValue,

package/lib/components/Select/_utils/getElementPosition.d.ts

@@ -1,12 +1,13 @@
 /**
- * 获取元素相对于视口的顶部位置。
- * 下拉框为 position: fixed（相对视口定位），故此处必须返回视口坐标，
- * 不能叠加 document.scrollTop——否则当文档本身可滚动时（如文档站长页面），
- * 下拉框会被定位到 scrollTop 像素之外而“消失”。
- * 在固定布局（document 不滚动，scrollTop=0）下与原行为一致。
+ * Get the element's top position relative to the viewport.
+ * The dropdown uses position: fixed (positioned relative to the viewport), so this must
+ * return viewport coordinates and must NOT add document.scrollTop — otherwise, when the
+ * document itself is scrollable (e.g. docs-site long pages), the dropdown would be
+ * positioned scrollTop pixels away and "disappear".
+ * In fixed layouts (document does not scroll, scrollTop=0) this matches the original behavior.
  */
 export declare function getElementTop(element: HTMLDivElement): number;
 /**
- * 获取元素相对于视口的左侧位置（同上，配合 position: fixed）。
+ * Get the element's left position relative to the viewport (same as above, for position: fixed).
  */
 export declare function getElementLeft(element: HTMLDivElement): number;

package/lib/components/Select/_utils/getElementPosition.js

@@ -6,18 +6,19 @@ Object.defineProperty(exports, "__esModule", {
 exports.getElementLeft = getElementLeft;
 exports.getElementTop = getElementTop;
 /**
- * 获取元素相对于视口的顶部位置。
- * 下拉框为 position: fixed（相对视口定位），故此处必须返回视口坐标，
- * 不能叠加 document.scrollTop——否则当文档本身可滚动时（如文档站长页面），
- * 下拉框会被定位到 scrollTop 像素之外而“消失”。
- * 在固定布局（document 不滚动，scrollTop=0）下与原行为一致。
+ * Get the element's top position relative to the viewport.
+ * The dropdown uses position: fixed (positioned relative to the viewport), so this must
+ * return viewport coordinates and must NOT add document.scrollTop — otherwise, when the
+ * document itself is scrollable (e.g. docs-site long pages), the dropdown would be
+ * positioned scrollTop pixels away and "disappear".
+ * In fixed layouts (document does not scroll, scrollTop=0) this matches the original behavior.
  */
 function getElementTop(element) {
   return element.getBoundingClientRect().top;
 }
 
 /**
- * 获取元素相对于视口的左侧位置（同上，配合 position: fixed）。
+ * Get the element's left position relative to the viewport (same as above, for position: fixed).
  */
 function getElementLeft(element) {
   return element.getBoundingClientRect().left;