@hsu-react/ui 0.0.13 → 0.0.15

package/src/components/Form/ModalForm/_hooks/useColumnFormItems.ts

@@ -2,16 +2,16 @@ import { useCallback } from "react";
 import { FormItemProps } from "../../../FormItem";
 
 /**
- * 计算列布局中的表单项
- * @param columnNum 列数
- * @returns 计算列表单项的函数
+ * Compute the form items within a column layout
+ * @param columnNum Column count
+ * @returns Function that computes the form items of a column
  */
 export const useColumnFormItems = (columnNum: number) => {
   /**
-   * 获取指定索引之前所有全宽表单项（width === "100%"）的索引
-   * @param formItems 所有表单项
-   * @param endIndex 结束索引（包含）
-   * @returns 全宽表单项的索引数组
+   * Get the indices of all full-width form items (width === "100%") before the given index
+   * @param formItems All form items
+   * @param endIndex End index (inclusive)
+   * @returns Array of indices of full-width form items
    */
   const getFullWidthIndices = useCallback(
     (formItems: FormItemProps[], endIndex: number): number[] => {
@@ -27,18 +27,18 @@ export const useColumnFormItems = (columnNum: number) => {
   );
 
   /**
-   * 计算表单项在列布局中的实际列位置索引
-   * 考虑全宽项（width === "100%"）会占据整行，影响后续项的列位置
-   * @param formItems 所有表单项
-   * @param itemIndex 表单项的原始索引
-   * @returns 实际列位置索引
+   * Calculate the actual column position index of a form item within the column layout
+   * Accounts for full-width items (width === "100%") occupying an entire row, which affects the column positions of subsequent items
+   * @param formItems All form items
+   * @param itemIndex Original index of the form item
+   * @returns Actual column position index
    */
   const calculateActualColumnIndex = useCallback(
     (formItems: FormItemProps[], itemIndex: number): number => {
       const fullWidthIndices = getFullWidthIndices(formItems, itemIndex);
 
-      // 计算由于全宽项导致的列偏移量
-      // 使用 reduce 累积偏移量
+      // Calculate the column offset caused by full-width items
+      // Accumulate the offset using reduce
       const offset = fullWidthIndices.reduce(
         (acc, curr, idx) =>
           acc +
@@ -46,13 +46,13 @@ export const useColumnFormItems = (columnNum: number) => {
         0
       );
 
-      // 全宽项后的补充项数量
+      // Number of supplementary items after full-width items
       const supplementItemsCount = fullWidthIndices.filter(
         (idx) => idx !== itemIndex
       ).length;
       const additionalOffset = supplementItemsCount * (columnNum - 1);
 
-      // 返回实际列索引
+      // Return the actual column index
       return (itemIndex + offset + additionalOffset) % columnNum;
     },
     [columnNum, getFullWidthIndices]
@@ -60,10 +60,10 @@ export const useColumnFormItems = (columnNum: number) => {
 
   const columnFormItems = useCallback(
     (formItems: FormItemProps[], idx: number) => {
-      // 计算目标索引的实际列索引
+      // Calculate the actual column index for the target index
       const targetColumnIndex = calculateActualColumnIndex(formItems, idx);
 
-      // 筛选出与目标项在同一列的所有表单项
+      // Filter out all form items in the same column as the target item
       const sameColumnItems = formItems.filter((_, itemIndex) => {
         const itemColumnIndex = calculateActualColumnIndex(
           formItems,

package/src/components/Form/ModalForm/_hooks/useFormItems.ts

@@ -4,11 +4,11 @@ import useLabelWidth from "../../../../hooks/useLabelWidth";
 import { useColumnFormItems } from "./useColumnFormItems";
 
 /**
- * 处理表单项的布局和标签宽度计算
- * @param formItems 表单项配置
- * @param layout 布局方式
- * @param columnNum 列数
- * @returns 处理后的表单项
+ * Handle form item layout and label width calculation
+ * @param formItems Form item configuration
+ * @param layout Layout mode
+ * @param columnNum Column count
+ * @returns Processed form items
  */
 export const useFormItems = (
   formItems: FormItemProps[] | Record<string, FormItemProps[]>,

package/src/components/FormItem/FormCodeMirror/index.tsx

@@ -21,16 +21,16 @@ const FormCodeMirror: React.FC<FormCodeMirrorProps> = (props) => {
   const [errorMessage, setErrorMessage] = React.useState<string | null>(null);
   const form = Form.useFormInstance();
 
-  // 处理 CodeMirror 的错误回调
+  // Handle the CodeMirror error callback
   const handleError = React.useCallback(
     (error: string | null) => {
       setErrorMessage(error);
 
-      // 如果有错误，触发表单验证
+      // If there is an error, trigger form validation
       if (name && form) {
         try {
           if (error) {
-            // 设置字段错误
+            // Set the field error
             form.setFields([
               {
                 name: name,
@@ -38,7 +38,7 @@ const FormCodeMirror: React.FC<FormCodeMirrorProps> = (props) => {
               },
             ]);
           } else {
-            // 清除字段错误
+            // Clear the field error
             form.setFields([
               {
                 name: name,
@@ -47,14 +47,14 @@ const FormCodeMirror: React.FC<FormCodeMirrorProps> = (props) => {
             ]);
           }
         } catch (e) {
-          // 忽略错误，可能表单还未初始化
+          // Ignore the error; the form may not be initialized yet
         }
       }
     },
     [name, form],
   );
 
-  // 合并验证规则，仅在启用 lint 时添加语法错误验证
+  // Merge validation rules; add syntax error validation only when lint is enabled
   const mergedRules = React.useMemo(() => {
     if (!enableLint) {
       return rules;

package/src/components/FormItem/FormInput/FormPasswordStrength/index.module.scss

@@ -21,18 +21,18 @@
     border: 0;
     border-radius: 6px;
 
-    background-color: #00000040;
+    background-color: var(--cf-border);
   }
 
-  /* value 处于 [min, low]时 */
+  /* When value is in [min, low] */
   &::-webkit-meter-even-less-good-value {
     background: #ed6f6f;
   }
-  /* value 处于 [low, optimum]时 */
+  /* When value is in [low, optimum] */
   &::-webkit-meter-suboptimum-value {
     background: #efbd47;
   }
-  /* value 处于 [optimum, max]时 */
+  /* When value is in [optimum, max] */
   &::-webkit-meter-optimum-value {
     background: #55d187;
   }
@@ -53,7 +53,7 @@
 
     background-color: transparent;
 
-    border-color: #fff;
+    border-color: var(--cf-surface);
     border-style: solid;
     border-width: 0 5px;
   }

package/src/components/FormItem/FormRadio/index.module.scss

@@ -36,7 +36,7 @@
           height: 100%;
 
           border-radius: inherit;
-          border-color: rgba(204, 204, 204, 1) !important;
+          border-color: var(--cf-border) !important;
 
           background: transparent !important;
 
@@ -82,7 +82,7 @@
             background: rgba(0, 0, 0, 0.04) !important;
 
             &::after {
-              border-color: rgba(204, 204, 204, 1) !important;
+              border-color: var(--cf-border) !important;
             }
           }
 

package/src/components/FormItem/FormUpload/index.module.scss

@@ -20,7 +20,7 @@
       cursor: not-allowed;
 
       > div {
-        background-color: rgba(0, 0, 0, 0.04);
+        background-color: var(--cf-subtle);
 
         border-color: var(--cf-border);
 
@@ -47,7 +47,7 @@
       width: max-content;
       height: 46px;
 
-      border: 1px solid rgba(204, 204, 204, 1);
+      border: 1px solid var(--cf-border);
 
       > span {
         &:first-child {
@@ -61,9 +61,9 @@
           font-family: Noto Sans SC;
           font-size: 18px;
           font-weight: 500;
-          color: rgba(51, 51, 51, 1);
+          color: var(--cf-text);
 
-          border-right: 1px solid rgba(204, 204, 204, 1);
+          border-right: 1px solid var(--cf-border);
         }
 
         &:nth-child(2) {
@@ -77,7 +77,7 @@
           font-family: Noto Sans SC;
           font-size: 18px;
           font-weight: 500;
-          color: rgba(122, 122, 122, 1);
+          color: var(--cf-text-2);
 
           > a {
             white-space: nowrap;
@@ -93,7 +93,7 @@
       font-family: Noto Sans SC;
       font-size: 18px;
       font-weight: 500;
-      color: rgba(122, 122, 122, 1);
+      color: var(--cf-text-2);
     }
   }
 
@@ -101,25 +101,25 @@
     height: 180px;
 
     border-radius: 8px;
-    border: 1px dashed rgba(19, 76, 255, 0.6);
-    background: rgba(19, 76, 255, 0.02);
+    border: 1px dashed color-mix(in srgb, var(--primary-color) 60%, transparent);
+    background: color-mix(in srgb, var(--primary-color) 2%, transparent);
 
     transition: all 0.3s;
 
     &:hover {
-      background: rgba(19, 76, 255, 0.08);
+      background: color-mix(in srgb, var(--primary-color) 8%, transparent);
 
-      border-color: #134cff;
+      border-color: var(--primary-color);
     }
 
     .uploadIcon {
       font-size: 40px;
-      color: #134cff;
+      color: var(--primary-color);
     }
 
     .uploadText {
       font-size: 14px;
-      color: #212121;
+      color: var(--cf-text);
 
       > div:first-child {
         margin: 16px 0 8px;
@@ -127,7 +127,7 @@
 
       > div:last-child {
         font-size: 12px;
-        color: #8d8e99;
+        color: var(--cf-text-2);
       }
     }
   }

package/src/components/FormItem/ItemContainer/index.module.scss

@@ -185,7 +185,7 @@
             margin-inline-start: 0px;
             margin-inline-end: 4px;
 
-            color: #ff4d4f;
+            color: var(--cf-error);
             font-size: 14px;
             font-family: SimSun, sans-serif;
             line-height: 1;
@@ -201,7 +201,7 @@
             margin-inline-start: 0px;
             margin-inline-end: 4px;
 
-            color: #ff4d4f;
+            color: var(--cf-error);
             font-size: 14px;
             font-family: SimSun, sans-serif;
             line-height: 1;
@@ -226,7 +226,7 @@
           margin-inline-start: 4px;
           margin-inline-end: 0px;
 
-          color: #ff4d4f;
+          color: var(--cf-error);
           font-size: 14px;
           font-family: SimSun, sans-serif;
           line-height: 1;
@@ -255,7 +255,7 @@
             margin-inline-start: 4px;
             margin-inline-end: 0px;
 
-            color: #ff4d4f;
+            color: var(--cf-error);
             font-size: 14px;
             font-family: SimSun, sans-serif;
             line-height: 1;

package/src/components/FormItem/ItemContainer/index.tsx

@@ -46,7 +46,7 @@ export interface ItemContainerProps extends FormItemProps {
   labelBreak?: boolean;
   hideAdditiona?: boolean;
   hideLabel?: boolean;
-  /** 显隐开关，由 FormItem 消费；在此解构剥离，避免透传到 DOM */
+  /** Visibility switch, consumed by FormItem; destructured and stripped here to avoid passing it through to the DOM */
   visible?: boolean;
 }
 
@@ -114,8 +114,8 @@ const ItemContainer: React.FC<ItemContainerProps> = (props) => {
         <Tooltip
           arrow={false}
           placement="top"
-          color="#f2f4f5"
-          styles={{ body: { color: "#131212", padding: "6px 12px" } }}
+          color="var(--cf-subtle)"
+          styles={{ body: { color: "var(--cf-text)", padding: "6px 12px" } }}
           {...tipsConfig}
         >
           {typeof icon === "string" ? (
@@ -126,7 +126,7 @@ const ItemContainer: React.FC<ItemContainerProps> = (props) => {
                 e.stopPropagation();
               }}
               fontSize={16}
-              color="#999999"
+              color="var(--cf-text-3)"
             />
           ) : (
             <div

package/src/components/FormItem/databaseTypeMapping.ts

@@ -1,13 +1,13 @@
 import { FormItemType } from "./index";
 
 /**
- * 数据库类型到表单类型的映射
- * 支持 MySQL、PostgreSQL、Oracle、SQL Server、SQLite 等常见数据库
+ * Mapping from database types to form item types
+ * Supports common databases such as MySQL, PostgreSQL, Oracle, SQL Server, SQLite, etc.
  */
 
-// 数据库类型枚举（不区分大小写）
+// Database type enum (case-insensitive)
 export type DatabaseType =
-  // 字符串类型
+  // String types
   | "VARCHAR"
   | "CHAR"
   | "TEXT"
@@ -19,7 +19,7 @@ export type DatabaseType =
   | "NTEXT"
   | "CLOB"
   | "STRING"
-  // 数值类型
+  // Numeric types
   | "INT"
   | "INTEGER"
   | "BIGINT"
@@ -34,7 +34,7 @@ export type DatabaseType =
   | "NUMBER"
   | "MONEY"
   | "SMALLMONEY"
-  // 日期时间类型
+  // Date/time types
   | "DATE"
   | "TIME"
   | "DATETIME"
@@ -43,11 +43,11 @@ export type DatabaseType =
   | "DATETIME2"
   | "SMALLDATETIME"
   | "DATETIMEOFFSET"
-  // 布尔类型
+  // Boolean types
   | "BOOLEAN"
   | "BOOL"
   | "BIT"
-  // 二进制类型
+  // Binary types
   | "BLOB"
   | "TINYBLOB"
   | "MEDIUMBLOB"
@@ -56,19 +56,19 @@ export type DatabaseType =
   | "VARBINARY"
   | "IMAGE"
   | "BYTEA"
-  // JSON 类型
+  // JSON types
   | "JSON"
   | "JSONB"
-  // 其他类型
+  // Other types
   | "UUID"
   | "ENUM"
   | "SET";
 
 /**
- * 数据库类型到表单类型的映射表
+ * Mapping table from database types to form item types
  */
 export const DATABASE_TYPE_TO_FORM_ITEM_MAP: Record<string, FormItemType> = {
-  // ========== 字符串类型 ==========
+  // ========== String types ==========
   VARCHAR: "INPUT",
   CHAR: "INPUT",
   TEXT: "TEXTAREA",
@@ -81,7 +81,7 @@ export const DATABASE_TYPE_TO_FORM_ITEM_MAP: Record<string, FormItemType> = {
   CLOB: "TEXTAREA",
   STRING: "INPUT",
 
-  // ========== 数值类型 ==========
+  // ========== Numeric types ==========
   INT: "INPUTNUMBER",
   INTEGER: "INPUTNUMBER",
   BIGINT: "INPUTNUMBER",
@@ -97,7 +97,7 @@ export const DATABASE_TYPE_TO_FORM_ITEM_MAP: Record<string, FormItemType> = {
   MONEY: "INPUTNUMBER",
   SMALLMONEY: "INPUTNUMBER",
 
-  // ========== 日期时间类型 ==========
+  // ========== Date/time types ==========
   DATE: "DATEPICKER",
   TIME: "DATEPICKER",
   DATETIME: "DATEPICKER",
@@ -107,12 +107,12 @@ export const DATABASE_TYPE_TO_FORM_ITEM_MAP: Record<string, FormItemType> = {
   SMALLDATETIME: "DATEPICKER",
   DATETIMEOFFSET: "DATEPICKER",
 
-  // ========== 布尔类型 ==========
+  // ========== Boolean types ==========
   BOOLEAN: "SWITCH",
   BOOL: "SWITCH",
   BIT: "SWITCH",
 
-  // ========== 二进制类型 ==========
+  // ========== Binary types ==========
   BLOB: "FILE",
   TINYBLOB: "FILE",
   MEDIUMBLOB: "FILE",
@@ -122,21 +122,21 @@ export const DATABASE_TYPE_TO_FORM_ITEM_MAP: Record<string, FormItemType> = {
   IMAGE: "IMAGEFILE",
   BYTEA: "FILE",
 
-  // ========== JSON 类型 ==========
+  // ========== JSON types ==========
   JSON: "CODEMIRROR",
   JSONB: "CODEMIRROR",
 
-  // ========== 其他类型 ==========
+  // ========== Other types ==========
   UUID: "INPUT",
   ENUM: "SELECT",
   SET: "CHECKBOXGROUP",
 };
 
 /**
- * 根据数据库类型获取对应的表单类型
- * @param databaseType 数据库类型（不区分大小写）
- * @param defaultType 默认表单类型，如果找不到映射则返回此类型
- * @returns 表单类型
+ * Get the corresponding form item type by database type
+ * @param databaseType Database type (case-insensitive)
+ * @param defaultType Default form item type, returned when no mapping is found
+ * @returns Form item type
  */
 export function getFormItemTypeByDatabaseType(
   databaseType: string,
@@ -144,19 +144,19 @@ export function getFormItemTypeByDatabaseType(
 ): FormItemType {
   const upperType = databaseType.toUpperCase().trim();
 
-  // 处理带括号的类型，如 VARCHAR(255), INT(11) 等
+  // Handle types with parentheses, e.g. VARCHAR(255), INT(11), etc.
   const baseType = upperType.split("(")[0].trim();
 
   return DATABASE_TYPE_TO_FORM_ITEM_MAP[baseType] || defaultType;
 }
 
 /**
- * 根据数据库类型和长度判断是否应该使用 TEXTAREA
- * 如果字符串类型长度超过阈值，建议使用 TEXTAREA
- * @param databaseType 数据库类型
- * @param length 字段长度
- * @param threshold 阈值，默认 255
- * @returns 是否应该使用 TEXTAREA
+ * Determine whether TEXTAREA should be used based on database type and length
+ * If a string type's length exceeds the threshold, TEXTAREA is recommended
+ * @param databaseType Database type
+ * @param length Field length
+ * @param threshold Threshold, defaults to 255
+ * @returns Whether TEXTAREA should be used
  */
 export function shouldUseTextarea(
   databaseType: string,
@@ -166,7 +166,7 @@ export function shouldUseTextarea(
   const upperType = databaseType.toUpperCase().trim();
   const baseType = upperType.split("(")[0].trim();
 
-  // 如果已经是 TEXT 类型，直接返回 true
+  // If it is already a TEXT type, return true directly
   if (
     ["TEXT", "TINYTEXT", "MEDIUMTEXT", "LONGTEXT", "NTEXT", "CLOB"].includes(
       baseType
@@ -175,7 +175,7 @@ export function shouldUseTextarea(
     return true;
   }
 
-  // 如果是 VARCHAR 或 CHAR 类型，且长度超过阈值，建议使用 TEXTAREA
+  // If it is a VARCHAR or CHAR type and the length exceeds the threshold, TEXTAREA is recommended
   if (["VARCHAR", "CHAR", "NVARCHAR", "NCHAR"].includes(baseType)) {
     return length ? length > threshold : false;
   }
@@ -184,27 +184,27 @@ export function shouldUseTextarea(
 }
 
 /**
- * 根据数据库类型获取智能推荐的表单类型
- * 结合类型和长度等信息进行智能判断
- * @param databaseType 数据库类型
- * @param length 字段长度
- * @returns 推荐的表单类型
+ * Get the intelligently recommended form item type by database type
+ * Makes a smart decision combining type, length, and other information
+ * @param databaseType Database type
+ * @param length Field length
+ * @returns Recommended form item type
  */
 export function getRecommendedFormItemType(
   databaseType: string,
   length?: number
 ): FormItemType {
-  // 如果字符串类型长度较大，使用 TEXTAREA
+  // If the string type has a large length, use TEXTAREA
   if (shouldUseTextarea(databaseType, length)) {
     return "TEXTAREA";
   }
 
-  // 使用基础映射
+  // Use the base mapping
   return getFormItemTypeByDatabaseType(databaseType);
 }
 
 /**
- * 数据库类型分类
+ * Database type categories
  */
 export const DATABASE_TYPE_CATEGORIES = {
   STRING: [
@@ -262,9 +262,9 @@ export const DATABASE_TYPE_CATEGORIES = {
 } as const;
 
 /**
- * 获取数据库类型的分类
- * @param databaseType 数据库类型
- * @returns 类型分类
+ * Get the category of a database type
+ * @param databaseType Database type
+ * @returns Type category
  */
 export function getDatabaseTypeCategory(
   databaseType: string
@@ -282,7 +282,7 @@ export function getDatabaseTypeCategory(
 }
 
 /**
- * 反向映射：表单类型到推荐的数据库类型
+ * Reverse mapping: form item types to recommended database types
  */
 export const FORM_ITEM_TO_DATABASE_TYPE_MAP: Partial<
   Record<FormItemType, DatabaseType[]>

package/src/components/FormItem/index.tsx

@@ -38,14 +38,14 @@ import React from "react";
 export { ItemContainer as FormItemContainer };
 export type { ItemContainerProps as FormItemContainerProps };
 
-// 公共基础类型
+// Common base type
 interface BaseFormItem {
   visible?: boolean;
 }
 
-// 核心映射（按分组排序）
+// Core mapping (sorted by group)
 type FormItemMap = {
-  // 输入类
+  // Input types
   AUTO: FormAutoProps;
   INPUT: FormInputProps;
   TEXTAREA: FormTextAreaInputProps;
@@ -58,7 +58,7 @@ type FormItemMap = {
   CODEMIRROR: FormCodeMirrorProps;
   TEXT: FormTextProps;
 
-  // 选择类
+  // Selection types
   SELECT: FormSelectProps;
   TREESELECT: FormTreeSelectProps;
   AUTOCOMPLETESELECT: FormAutoCompleteSelectProps;
@@ -73,22 +73,22 @@ type FormItemMap = {
   TREE: FormTreeProps;
   ICONSELECT: FormIconSelectProps;
 
-  // 上传类
+  // Upload types
   FILE: FormUploadProps;
   IMAGEFILE: FormImageProps;
 };
 
-// 派生类型
+// Derived type
 export type FormItemType = keyof FormItemMap;
 
-// 表单项属性
+// Form item props
 export type FormItemProps = {
   [K in keyof FormItemMap]: { type: K } & BaseFormItem & FormItemMap[K];
 }[keyof FormItemMap];
 
-// 中文字典
+// Chinese dictionary
 export const PlaceholderDict: Record<FormItemType, string> = {
-  // 输入类
+  // Input types
   AUTO: "",
   INPUT: "请输入",
   TEXTAREA: "请输入",
@@ -101,7 +101,7 @@ export const PlaceholderDict: Record<FormItemType, string> = {
   CODEMIRROR: "请输入",
   TEXT: "请输入",
 
-  // 选择类
+  // Selection types
   SELECT: "请选择",
   TREESELECT: "请选择",
   AUTOCOMPLETESELECT: "请选择",
@@ -116,14 +116,14 @@ export const PlaceholderDict: Record<FormItemType, string> = {
   TREE: "请选择",
   ICONSELECT: "请选择",
 
-  // 上传类
+  // Upload types
   FILE: "请上传",
   IMAGEFILE: "请上传",
 };
 
-// 英文字典
+// English dictionary
 export const PlaceholderDictEn: Record<FormItemType, string> = {
-  // 输入类
+  // Input types
   AUTO: "",
   INPUT: "Please enter",
   TEXTAREA: "Please enter",
@@ -136,7 +136,7 @@ export const PlaceholderDictEn: Record<FormItemType, string> = {
   CODEMIRROR: "Please enter",
   TEXT: "Please enter",
 
-  // 选择类
+  // Selection types
   SELECT: "Please select",
   TREESELECT: "Please select",
   AUTOCOMPLETESELECT: "Please select",
@@ -151,7 +151,7 @@ export const PlaceholderDictEn: Record<FormItemType, string> = {
   TREE: "Please select",
   ICONSELECT: "Please select",
 
-  // 上传类
+  // Upload types
   FILE: "Please upload",
   IMAGEFILE: "Please upload",
 };