summaryrefslogtreecommitdiff
path: root/components/client-table-v3/types.ts
blob: 4f2d8c82490cea358fa14627a59bec5ba16434bf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
import {
  ColumnDef,
  RowData,
  Table,
  PaginationState,
  SortingState,
  ColumnFiltersState,
  VisibilityState,
  ColumnPinningState,
  ColumnOrderState,
  GroupingState,
  ExpandedState,
  RowSelectionState,
  OnChangeFn,
  Row,
  Column,
} from "@tanstack/react-table";

// --- Column Meta ---
export interface ClientTableColumnMeta {
  filterType?: "text" | "select" | "boolean" | "date-range"; // Added date-range
  filterOptions?: { label: string; value: string }[];
  serverGroupable?: boolean; // For Pattern 2-B
}

export type ClientTableColumnDef<TData extends RowData, TValue = unknown> = ColumnDef<TData, TValue> & {
  meta?: ClientTableColumnMeta;
};

// --- Fetcher Types ---
export interface TableState {
  pagination: PaginationState;
  sorting: SortingState;
  columnFilters: ColumnFiltersState;
  globalFilter: string;
  grouping: GroupingState;
  expanded: ExpandedState;
}

export interface FetcherResult<TData> {
  data: TData[];
  totalRows: number;
  pageCount?: number;
  groups?: any[]; // For grouping response
}

export type TableFetcher<TData> = (
  state: TableState,
  additionalArgs?: any
) => Promise<FetcherResult<TData>>;

// --- Component Props ---
export interface ClientVirtualTableProps<TData> {
  table: Table<TData>;
  isLoading?: boolean;
  height?: string | number;
  estimateRowHeight?: number;
  className?: string;
  
  // UI Features
  actions?: React.ReactNode;
  customToolbar?: React.ReactNode;
  enableExport?: boolean;
  onExport?: (data: TData[]) => void;
  
  // Preset
  enableUserPreset?: boolean;
  tableKey?: string;

  // Styling
  getRowClassName?: (originalRow: TData, index: number) => string;
  onRowClick?: (row: Row<TData>, event: React.MouseEvent) => void;
  
  // Visuals
  renderHeaderVisualFeedback?: (props: {
    column: Column<TData, unknown>;
    isPinned: boolean | string;
    isSorted: boolean | string;
    isFiltered: boolean;
    isGrouped: boolean;
  }) => React.ReactNode;
}