@hsu-react/ui 0.0.12 → 0.0.14

package/lib/components/Search/_hooks/useSearchExpand.d.ts

@@ -1,18 +1,18 @@
 /// <reference types="react" />
 import { FormItemProps } from "../../FormItem";
 /**
- * 基于宽度自适应控制展开/收起的Hook
- * @param containerRef 容器引用
- * @param buttonGroupRef 按钮组引用
- * @param itemClassName 搜索项的className
- * @param itemCount 搜索项总数
- * @param columnNum 列数
- * @param autoAdaptWidth 是否启用自适应宽度
- * @param defaultExpanded 默认是否展开
- * @param onExpandChange 展开状态变化回调
- * @param searchItems 搜索项配置数组（可选）
- * @param showAllSearchItems 是否显示所有搜索项
- * @returns 展开状态及控制方法
+ * Hook that controls expand/collapse adaptively based on width
+ * @param containerRef Container ref
+ * @param buttonGroupRef Button group ref
+ * @param itemClassName className of the search items
+ * @param itemCount Total number of search items
+ * @param columnNum Column count
+ * @param autoAdaptWidth Whether adaptive width is enabled
+ * @param defaultExpanded Whether expanded by default
+ * @param onExpandChange Callback when expand state changes
+ * @param searchItems Search item config array (optional)
+ * @param showAllSearchItems Whether to show all search items
+ * @returns Expand state and control methods
  */
 export declare function useSearchExpand(containerRef: React.RefObject<HTMLDivElement>, buttonGroupRef: React.RefObject<HTMLDivElement>, itemClassName: string, itemCount: number, columnNum: number, autoAdaptWidth: boolean, defaultExpanded: boolean, onExpandChange?: (expand: boolean) => void, searchItems?: FormItemProps[], showAllSearchItems?: boolean, columnOffsetWidth?: number): {
     expand: boolean;

package/lib/components/Search/_hooks/useSearchExpand.js

@@ -7,18 +7,18 @@ exports.useSearchExpand = useSearchExpand;
 var _react = require("react");
 var _utils = require("../_utils");
 /**
- * 基于宽度自适应控制展开/收起的Hook
- * @param containerRef 容器引用
- * @param buttonGroupRef 按钮组引用
- * @param itemClassName 搜索项的className
- * @param itemCount 搜索项总数
- * @param columnNum 列数
- * @param autoAdaptWidth 是否启用自适应宽度
- * @param defaultExpanded 默认是否展开
- * @param onExpandChange 展开状态变化回调
- * @param searchItems 搜索项配置数组（可选）
- * @param showAllSearchItems 是否显示所有搜索项
- * @returns 展开状态及控制方法
+ * Hook that controls expand/collapse adaptively based on width
+ * @param containerRef Container ref
+ * @param buttonGroupRef Button group ref
+ * @param itemClassName className of the search items
+ * @param itemCount Total number of search items
+ * @param columnNum Column count
+ * @param autoAdaptWidth Whether adaptive width is enabled
+ * @param defaultExpanded Whether expanded by default
+ * @param onExpandChange Callback when expand state changes
+ * @param searchItems Search item config array (optional)
+ * @param showAllSearchItems Whether to show all search items
+ * @returns Expand state and control methods
  */
 function useSearchExpand(containerRef, buttonGroupRef, itemClassName, itemCount, columnNum, autoAdaptWidth, defaultExpanded, onExpandChange, searchItems, showAllSearchItems, columnOffsetWidth = 0) {
   const [expand, setExpand] = (0, _react.useState)(defaultExpanded);
@@ -31,38 +31,38 @@ function useSearchExpand(containerRef, buttonGroupRef, itemClassName, itemCount,
     const calculateVisibleItems = () => {
       if (!containerRef.current || !buttonGroupRef.current) return;
       const containerWidth = container.offsetWidth;
-      // 减去padding
+      // Subtract padding
       const availableWidth = containerWidth - 30; // 15px padding on each side
 
-      // 获取按钮组的实际宽度（计算所有子元素宽度总和）
+      // Get the actual width of the button group (sum of all child element widths)
       const buttonGroupWidth = (0, _utils.measureButtonGroupWidth)(buttonGroupRef.current) ?? 0;
 
-      // 获取所有搜索项元素
+      // Get all search item elements
       const items = container.querySelectorAll(`${itemClassName}`);
 
-      // 计算第一行能放下的搜索项数量
+      // Compute how many search items fit in the first row
       let count = 0;
       let usedWidth = 0;
-      const gap = 10; // 项之间的间距
+      const gap = 10; // Gap between items
 
-      // 计算默认单个项的宽度（容器宽度除以列数）
+      // Compute the default width of a single item (container width divided by column count)
       const defaultItemWidth = (availableWidth - (columnNum - 1) * gap) / columnNum - columnOffsetWidth;
 
-      // 遍历所有搜索项（包括未渲染的）
+      // Iterate over all search items (including unrendered ones)
       for (let i = 0; i < itemCount; i++) {
         let itemWidth = 0;
 
-        // 如果DOM中有这个item，使用实际宽度
+        // If this item exists in the DOM, use its actual width
         if (i < items.length) {
           const item = items[i];
           itemWidth = item.offsetWidth;
         } else if (searchItems && searchItems[i]?.width !== undefined) {
-          // 如果DOM中没有，但有设置宽度，使用设置的宽度
+          // If not in the DOM but a width is configured, use the configured width
           const configWidth = searchItems[i].width;
           if (typeof configWidth === "number") {
             itemWidth = configWidth;
           } else if (typeof configWidth === "string") {
-            // 处理百分比或像素值
+            // Handle percentage or pixel values
             if (configWidth.endsWith("%")) {
               const percent = parseFloat(configWidth) / 100;
               itemWidth = availableWidth * percent;
@@ -71,14 +71,14 @@ function useSearchExpand(containerRef, buttonGroupRef, itemClassName, itemCount,
             }
           }
         } else {
-          // 如果DOM中没有且没有设置宽度，使用默认计算宽度
+          // If not in the DOM and no width is configured, use the default computed width
           itemWidth = defaultItemWidth;
         }
 
-        // 计算加上当前项后的总宽度（包括gap）
+        // Compute the total width after adding the current item (including gap)
         const nextWidth = usedWidth + itemWidth + (i > 0 ? gap : 0);
 
-        // 检查是否还能放下按钮组（需要预留gap和按钮组宽度）
+        // Check whether the button group still fits (must reserve the gap and the button group width)
         if (nextWidth + gap + buttonGroupWidth <= availableWidth) {
           count++;
           usedWidth = nextWidth;
@@ -87,25 +87,25 @@ function useSearchExpand(containerRef, buttonGroupRef, itemClassName, itemCount,
         }
       }
 
-      // 至少显示1个搜索项
+      // Show at least 1 search item
       count = Math.max(1, count);
       setVisibleItemCount(count);
 
-      // 如果所有项都能显示，则不需要展开
+      // If all items can be displayed, expanding is not needed
       if (count >= itemCount) {
         setExpand(false);
       }
     };
     const resizeObserver = new ResizeObserver(() => {
-      // 使用 requestAnimationFrame 延迟到下一帧，确保DOM已更新
+      // Use requestAnimationFrame to defer to the next frame, ensuring the DOM has updated
       requestAnimationFrame(() => {
         calculateVisibleItems();
       });
     });
 
-    // MutationObserver 监听DOM变化
+    // MutationObserver watches for DOM changes
     const mutationObserver = new MutationObserver(() => {
-      // 使用 requestAnimationFrame 延迟到下一帧
+      // Use requestAnimationFrame to defer to the next frame
       requestAnimationFrame(() => {
         calculateVisibleItems();
       });
@@ -118,7 +118,7 @@ function useSearchExpand(containerRef, buttonGroupRef, itemClassName, itemCount,
       attributeFilter: ["class", "style"]
     });
 
-    // 监听窗口大小变化
+    // Listen for window resize
     const handleWindowResize = () => {
       requestAnimationFrame(() => {
         calculateVisibleItems();
@@ -126,7 +126,7 @@ function useSearchExpand(containerRef, buttonGroupRef, itemClassName, itemCount,
     };
     window.addEventListener("resize", handleWindowResize);
 
-    // 初始计算（延迟执行以确保DOM已渲染）
+    // Initial calculation (deferred to ensure the DOM has rendered)
     requestAnimationFrame(() => {
       calculateVisibleItems();
     });

package/lib/components/Search/_hooks/useSearchForm.d.ts

@@ -4,7 +4,7 @@ interface UseSearchFormProps {
     searchData?: Record<string, unknown>;
 }
 /**
- * 管理搜索表单数据
+ * Manages search form data
  */
 export declare function useSearchForm({ form, searchData }: UseSearchFormProps): void;
 export {};

package/lib/components/Search/_hooks/useSearchForm.js

@@ -7,7 +7,7 @@ exports.useSearchForm = useSearchForm;
 var _react = require("react");
 var _hsuUtils = require("hsu-utils");
 /**
- * 管理搜索表单数据
+ * Manages search form data
  */
 function useSearchForm({
   form,

package/lib/components/Search/_hooks/useSearchItems.d.ts

@@ -1,10 +1,11 @@
 import { FormItemProps } from "../../FormItem";
 /**
- * 管理搜索项状态
+ * Manages search item state
  *
- * 通过 useMemo 直接从入参派生，仅把用户在 FilterDropdown 里手动切换的
- * visible 覆盖保存为 state；避免 useEffect 镜像 prop 时因为父组件传入
- * 新数组引用而反复 setState，从而触发 Maximum update depth 循环。
+ * Derives directly from the input via useMemo, storing only the visible
+ * overrides the user manually toggles in FilterDropdown as state; this avoids
+ * repeated setState when a useEffect mirrors the prop and the parent passes a
+ * new array reference, which would trigger a Maximum update depth loop.
  */
 export declare function useSearchItems(searchItems: FormItemProps[]): {
     searchItems: FormItemProps[];

package/lib/components/Search/_hooks/useSearchItems.js

@@ -6,11 +6,12 @@ Object.defineProperty(exports, "__esModule", {
 exports.useSearchItems = useSearchItems;
 var _react = require("react");
 /**
- * 管理搜索项状态
+ * Manages search item state
  *
- * 通过 useMemo 直接从入参派生，仅把用户在 FilterDropdown 里手动切换的
- * visible 覆盖保存为 state；避免 useEffect 镜像 prop 时因为父组件传入
- * 新数组引用而反复 setState，从而触发 Maximum update depth 循环。
+ * Derives directly from the input via useMemo, storing only the visible
+ * overrides the user manually toggles in FilterDropdown as state; this avoids
+ * repeated setState when a useEffect mirrors the prop and the parent passes a
+ * new array reference, which would trigger a Maximum update depth loop.
  */
 function useSearchItems(searchItems) {
   const [visibilityOverrides, setVisibilityOverrides] = (0, _react.useState)({});

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

@@ -3,7 +3,7 @@ import { ReactNode } from "react";
 import { FormItemProps } from "../../FormItem";
 import { ChakraButtonProps } from "../../Button";
 /**
- * Search 组件的基础属性接口
+ * Base props interface for the Search component
  */
 export interface BaseSearchProps {
     searchItems?: FormItemProps[];
@@ -13,36 +13,36 @@ export interface BaseSearchProps {
     className?: string;
     externalForm?: FormInstance;
     hasPermi?: string[];
-    /** 搜索项列数（不包括按钮组，总列数为 columnNum + 1） */
+    /** Search item column count (excluding the button group; total column count is columnNum + 1) */
     columnNum?: number;
     beforeButtonGroup?: ChakraButtonProps[];
     affterButtonGroup?: ChakraButtonProps[];
     searchData?: Record<string, unknown>;
     minLabelWidth?: boolean | number;
-    /** 默认是否展开 */
+    /** Whether expanded by default */
     defaultExpanded?: boolean;
-    /** 展开状态变化时的回调 */
+    /** Callback when the expand state changes */
     onExpandChange?: (expand: boolean) => void;
-    /** 是否启用基于宽度的自适应布局（默认显示一行包括按钮） */
+    /** Whether to enable width-based adaptive layout (by default shows one row including buttons) */
     autoAdaptWidth?: boolean;
-    /** 自适应布局的基准宽度（默认1200px） */
+    /** Base width for adaptive layout (default 1200px) */
     baseWidth?: number;
     onValuesChange?: (value: Record<string, unknown>, values: Record<string, unknown>) => void;
     searchDisabled?: boolean;
     showAllSearchItems?: boolean;
-    /** 查询按钮文本 */
+    /** Search button text */
     searchText?: ReactNode;
-    /** 重置按钮文本 */
+    /** Reset button text */
     resetText?: ReactNode;
-    /** 列偏移宽度，用于调整列宽计算（默认 0） */
+    /** Column offset width, used to adjust column width calculation (default 0) */
     columnOffsetWidth?: number;
 }
 /**
- * 带筛选器的 Search 组件属性接口
+ * Props interface for the Search component with filter
  */
 export interface SearchPropsWithFilter extends BaseSearchProps {
-    /** 是否显示筛选器 */
+    /** Whether to show the filter */
     setFilter?: boolean;
-    /** FilterDropdown 勾选项变化时的回调 */
+    /** Callback when checked items change in FilterDropdown */
     onFilterChange?: (items: FormItemProps[]) => void;
 }

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

@@ -1,11 +1,11 @@
 import { RefObject } from "react";
 /**
- * 计算按钮组宽度和列宽
- * @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
  */
 export declare function calculateButtonGroupAndColumnWidth(containerRef: RefObject<HTMLDivElement>, buttonGroupRef: RefObject<HTMLDivElement>, adaptiveColumnNum: number, columnOffsetWidth?: number): {
     buttonGroupWidth: number | undefined;

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

@@ -63,7 +63,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,16 +81,16 @@ const AutoCompleteSelect = props => {
     });
   }, [options]);
 
-  // 处理 filterOption
+  // Handle filterOption
   const handleFilterOption = (0, _react.useMemo)(() => {
-    // 如果提供了自定义 filterOption，优先使用
+    // If a custom filterOption is provided, use it first
     if (customFilterOption) {
       return (inputValue, option) => {
         return customFilterOption(inputValue, option);
       };
     }
 
-    // 默认过滤逻辑：不区分大小写的包含匹配
+    // Default filtering logic: case-insensitive substring match
     return (inputValue, option) => {
       if (!isComposing && option) {
         const searchText = inputValue.toUpperCase();