refactor(table): add transformParams option to useTable and useHookTable for enhanced parameter handling

Author: Ohh-889

packages/hooks/src/use-table.ts

@@ -61,10 +61,26 @@ export type TableConfig<A extends ApiFn, T, C> = {
   onFetched?: (transformed: TransformedData<T>) => MaybePromise<void>;
   /** transform api response to table data */
   transformer: Transformer<T, Awaited<ReturnType<A>>>;
+  /**
+   * transform params before sending to backend
+   *
+   * @param params formatted params
+   * @returns transformed params
+   */
+  transformParams?: (params: Parameters<A>[0]) => Parameters<A>[0];
 };
 
 export default function useHookTable<A extends ApiFn, T, C>(config: TableConfig<A, T, C>) {
-  const { apiFn, apiParams, getColumnChecks, getColumns, immediate = true, isChangeURL, transformer } = config;
+  const {
+    apiFn,
+    apiParams,
+    getColumnChecks,
+    getColumns,
+    immediate = true,
+    isChangeURL,
+    transformer,
+    transformParams
+  } = config;
 
   const { endLoading, loading, startLoading } = useLoading();
 
@@ -91,7 +107,11 @@ export default function useHookTable<A extends ApiFn, T, C>(config: TableConfig<
     startLoading();
 
     try {
-      const formattedParams = formatSearchParams(searchParams.current);
+      let formattedParams = formatSearchParams(searchParams.current);
+
+      if (transformParams) {
+        formattedParams = transformParams(formattedParams);
+      }
 
       if (isChangeURL) {
         setSearchParams(formattedParams as URLSearchParamsInit, { replace: true });

src/features/table/use-table.ts

@@ -31,6 +31,7 @@ export function useTable<A extends AntDesign.TableApiFn>(config: Config<A>) {
     onChange: onChangeCallback,
     pagination: paginationConfig,
     rowKey = 'id',
+    transformParams,
     ...rest
   } = config;
 
@@ -103,7 +104,8 @@ export function useTable<A extends AntDesign.TableApiFn>(config: Config<A>) {
         pageSize: size,
         total: totalNum
       };
-    }
+    },
+    transformParams
   });
 
   // this is for mobile, if the system does not support mobile, you can use `pagination` directly
@@ -149,6 +151,7 @@ export function useTable<A extends AntDesign.TableApiFn>(config: Config<A>) {
         other = params;
       }
     }
+
     updateSearchParams(other);
   }
 

src/types/antd.d.ts

@@ -38,7 +38,7 @@ declare namespace AntDesign {
 
   type AntDesignTableConfig<A extends TableApiFn> = Pick<
     import('@sa/hooks').TableConfig<A, GetTableData<A>, TableColumn<TableDataWithIndex<GetTableData<A>>>>,
-    'apiFn' | 'apiParams' | 'columns' | 'immediate' | 'isChangeURL'
+    'apiFn' | 'apiParams' | 'columns' | 'immediate' | 'isChangeURL' | 'transformParams'
   > & {
     onChange?: (
       ...args: TableOnChange