@amaoaaaaa/search-table 0.1.0-beta.1

package/dist/SearchTable/types.d.ts

@@ -0,0 +1,118 @@
+import { ProTableProps, TableRow } from '../ProTable/types';
+import { PaginationProps } from 'element-plus';
+import { SortState } from './useTableSort';
+export type SearchTableProps<T extends TableRow = any> = Omit<ProTableProps<T>, 'data' | 'defaultSort'> & {
+    /**
+     * 是否显示搜索区域
+     * @default true
+     */
+    showSearch?: boolean;
+    /**
+     * 搜索输入框的提示语
+     */
+    searchInputPlaceholder?: string;
+    /**
+     * 是否显示新增按钮
+     *
+     * @default false
+     */
+    showAddButton?: boolean;
+    /**
+     * 是否显示批量删除按钮
+     *
+     * @default false
+     */
+    showBatchDeleteButton?: boolean;
+    /**
+     * 每页条数，不传则自动计算可显示的最大行数
+     */
+    pageSize?: number;
+    /**
+     * element-plus 分页组件属性
+     */
+    elPaginationProps?: Partial<Pick<PaginationProps, 'size' | 'pagerCount'>>;
+    /**
+     * 默认排序
+     */
+    defaultSort?: SortState;
+    fetchFn: SearchTableFetchFn<T>;
+    /**
+     * 搜索参数处理函数
+     * @param params 当前参数
+     * @returns 返回处理后的参数
+     */
+    searchParamsHandler?: (params: Record<string, any>) => Record<string, any>;
+};
+/**
+ * 分页请求参数
+ */
+export interface PageParams {
+    /**
+     * 每页元素数量
+     */
+    limit?: number;
+    /**
+     * 当前页起始索引（第一页为0，第n页为(n-1)*limit）
+     */
+    offset?: number;
+    /**
+     * 排序顺序，升序还是降序 `asc` or `desc`
+     */
+    order?: string;
+    /**
+     * 查询关键词（需要模糊检索时使用）
+     */
+    search?: string;
+    /**
+     * 排序字段
+     */
+    sort?: string;
+    [key: string]: any;
+}
+export type SearchTableFetchFn<T = any> = (params?: PageParams, options?: {
+    /**
+     * 请求中断的信号
+     */
+    signal?: AbortSignal;
+}) => Promise<PageResp<T>>;
+/**
+ * 通用分页响应结构
+ */
+export interface PageResp<T = any> {
+    /**
+     * 请求是否成功
+     */
+    success: boolean;
+    /**
+     * 错误代码-0为成功
+     */
+    code: number;
+    /**
+     * 错误信息
+     */
+    message?: string;
+    /**
+     * 响应数据
+     */
+    data?: Array<T>;
+    /**
+     * 开始索引
+     */
+    offset: number;
+    /**
+     * 每页数量
+     */
+    limit: number;
+    /**
+     * 元素总数
+     */
+    totalCount: number;
+    /**
+     * 当前页数（从1开始）
+     */
+    currPageIndex: number;
+    /**
+     * 总页数
+     */
+    pageCount: number;
+}

package/dist/SearchTable/useTableSort.d.ts

@@ -0,0 +1,25 @@
+export interface SortState<T extends Record<string, any> = Record<string, any>> {
+    /**
+     * 排序方式
+     */
+    order: 'asc' | 'desc';
+    /**
+     * 排序字段
+     */
+    sort: keyof T;
+}
+export interface UseTableSortOption {
+    defaultSort?: SortState;
+    fetchFn: () => void;
+    onReset?: () => void;
+}
+export declare function useTableSort({ defaultSort, fetchFn, onReset }: UseTableSortOption): {
+    sortState: {
+        order: "asc" | "desc";
+        sort: string;
+    };
+    onSortChange: ({ prop, order, }: {
+        prop: string;
+        order: "ascending" | "descending" | null;
+    }) => void;
+};

package/dist/hooks/useDelayedRef.d.ts

@@ -0,0 +1,41 @@
+import { Ref } from 'vue';
+/**
+ * 创建一个带延迟的布尔 Ref。
+ *
+ * 当 source 为 true 时，延迟指定时间后才同步为 true；
+ * 当 source 为 false 时，立即同步为 false。
+ *
+ * @param source 源 Ref<boolean>
+ * @param delay 延迟时间（毫秒），默认 300ms
+ * @returns 延迟后的 Ref<boolean>
+ *
+ * @example
+ * const loading = ref(false);
+ * const delayedLoading = useDelayedRef(loading, 500);
+ *
+ * loading.value = true;  // 500ms 后 delayedLoading.value 才变为 true
+ * loading.value = false; // 立即变为 false
+ */
+export declare function useDelayedRef(source: Ref<boolean>, delay?: number): Ref<boolean>;
+/**
+ * 创建一个带延迟的布尔 Ref（对象属性版本）。
+ *
+ * 当指定对象属性为 true 时，延迟指定时间后才同步为 true；
+ * 当为 false 时，立即同步为 false。
+ *
+ * @typeParam T 源对象类型
+ * @typeParam K 属性键（必须是 boolean 类型属性）
+ *
+ * @param source 源对象
+ * @param property 需要监听的属性名
+ * @param delay 延迟时间（毫秒），默认 300ms
+ * @returns 延迟后的 Ref<boolean>
+ *
+ * @example
+ * const state = reactive({ loading: false });
+ * const delayedLoading = useDelayedRef(state, 'loading', 500);
+ *
+ * state.loading = true;  // 500ms 后 delayedLoading.value 才变为 true
+ * state.loading = false; // 立即变为 false
+ */
+export declare function useDelayedRef<T extends object, K extends keyof T>(source: T, property: K, delay?: number): Ref<boolean>;

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { default as SearchTable } from './SearchTable/index.vue';
+export { default as ProTable } from './ProTable/index.vue';
+export type { ProTableInstance } from './ProTable';
+export type { SearchTableProps, SearchTableFetchFn, PageParams, PageResp, } from './SearchTable/types';
+export type { ProTableProps, ProTableColumn, ProTableAction, TableRow, FilterOption, FilterType, ActionButtonVisibility, ApplyFilterPayload, CellEditPayload, } from './ProTable/types';
+export { SelectionStore } from './SearchTable/SelectionStore';
+export { useTableSort } from './SearchTable/useTableSort';
+export type { SortState, UseTableSortOption } from './SearchTable/useTableSort';
+export { useDelayedRef } from './hooks/useDelayedRef';
+export { parseErrorReason } from './utils/parseErrorReason';