refactor: clean code

ui/src/hooks/useAntdForm.ts

@@ -19,7 +19,8 @@ export interface UseAntdFormReturns<T extends NonNullable<unknown> = any> {
 }
 
 /**
- *
+ * 生成并获取一个 antd 表单的实例、属性等。
+ * 通常为配合 Form 组件使用，以减少样板代码。
  * @param {UseAntdFormOptions} options
  * @returns {UseAntdFormReturns}
  */
@@ -74,9 +75,9 @@ const useAntdForm = <T extends NonNullable<unknown> = any>({ form, initialValues
         .then(() => {
           resolve(
             Promise.resolve(onSubmit?.(values))
-              .then((data) => {
+              .then((ret) => {
                 setFormPending(false);
-                return data;
+                return ret;
               })
               .catch((err) => {
                 setFormPending(false);

ui/src/hooks/useAntdFormName.ts

@@ -6,6 +6,12 @@ export interface UseAntdFormNameOptions<T extends NonNullable<unknown> = any> {
   name?: string;
 }
 
+/**
+ * 生成并获取一个 antd 表单的唯一名称。
+ * 通常为配合 Form 组件使用，避免页面上同时存在多个表单时若有同名的 FormItem 会产生冲突。
+ * @param {UseAntdFormNameOptions} options
+ * @returns {string}
+ */
 const useAntdFormName = <T extends NonNullable<unknown> = any>(options: UseAntdFormNameOptions<T>) => {
   const formName = useCreation(() => `${options.name}_${Math.random().toString(36).substring(2, 10)}${new Date().getTime()}`, [options.name, options.form]);
   return formName;

ui/src/hooks/useTriggerElement.ts

@@ -5,7 +5,8 @@ export type UseTriggerElementOptions = {
 };
 
 /**
- * 获取一个触发器元素。通常为配合 Drawer、Modal 等组件使用。
+ * 获取一个触发器元素。
+ * 通常为配合 Drawer、Modal 等组件使用。
  * @param {React.ReactNode} trigger
  * @param {UseTriggerElementOptions} [options]
  * @returns {React.ReactElement}