@ehfuse/mui-virtual-data-table 1.3.2 → 1.4.1

package/dist/types.d.ts

@@ -76,6 +76,27 @@ export interface DataColumn<T> {
      * 틀이 그보다 좁으면 가로로 민다 — 제목처럼 남는 폭을 다 가져가되 좁은 화면에서 0 으로 접히면 안 되는 열.
      */
     minWidth?: number;
+    /**
+     * 머리 우클릭 메뉴의 거르기 값 목록(1.4.0). onFilterChange 와 함께 주면 머리를 우클릭했을 때 이 값들이 고르기 목록으로 뜬다.
+     * 값은 글자다(빈 글자 = 비어 있음 같은 값도 그대로 쓴다). 거르는 일 자체는 소비처가 한다 — 표는 고른 값만 알린다.
+     */
+    filterOptions?: {
+        value: string;
+        label: string;
+    }[];
+    /** 지금 걸린 거르기 값(1.4.0). 하나라도 있으면 머리글이 강조색 + 거르기 아이콘으로 선다(걸린 줄 모르고 "왜 몇 줄 없지" 하지 않게). */
+    filterValues?: string[];
+    /** 거르기 값이 바뀔 때(1.4.0) — 다 풀면 빈 배열. */
+    onFilterChange?: (values: string[]) => void;
+    /** 여러 값을 함께 고르는지(기본 true). false 면 하나만 — 고르면 메뉴가 닫히고, 같은 값을 다시 고르면 풀린다. */
+    filterMultiple?: boolean;
+    /**
+     * 머리 우클릭 메뉴에 정렬 항목을 둘지(1.4.1, 기본: sortable 과 같다). 머리를 직접 그리는 열(자기 정렬 표시 · 머리 클릭을 headerProps 로 다는 열)은
+     * sortable 을 켜면 표의 정렬 표시 · 클릭이 겹치므로, sortable 없이 이것만 true 로 메뉴에 정렬을 둔다. sortable 열에서 false 면 메뉴에서 뺀다.
+     */
+    sortMenu?: boolean;
+    /** false 면 이 열은 머리 우클릭 메뉴를 띄우지 않는다(브라우저 메뉴는 여전히 막는다, 1.4.0). */
+    headerMenu?: boolean;
 }
 /** 정렬 방향 타입 */
 export type SortDirection = "asc" | "desc";
@@ -114,6 +135,17 @@ export interface VirtualDataTableProps<T> {
     striped?: string | boolean;
     rowDivider?: boolean;
     onSort?: (columnId: string, direction: SortDirection) => void;
+    /**
+     * 정렬 풀기(1.4.0) — 주면 머리 우클릭 메뉴에 "정렬 풀기" 가 서고(그 열로 정렬 중일 때), 같은 방향을 다시 고르면 이것을 부른다.
+     * 기본 정렬로 되돌릴 수 있는 목록만 준다.
+     */
+    onSortClear?: () => void;
+    /**
+     * 머리 칸 우클릭(1.4.0). 브라우저 메뉴는 늘 막는다. true 를 돌려주거나 event.preventDefault() 를 부르면 "처리했다" 로 보고
+     * 기본 머리 메뉴(정렬 · 거르기)를 띄우지 않는다 — 화면이 이미 가진 머리 메뉴를 우클릭에도 열 때 쓴다.
+     * 묶음 머리(group) 칸에서는 부르지 않는다.
+     */
+    onHeaderContextMenu?: (column: DataColumn<T>, event: React.MouseEvent<HTMLTableCellElement>) => boolean | void;
     onLoadMore?: (offset: number, limit: number) => void;
     sortBy?: string;
     sortDirection?: SortDirection;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ehfuse/mui-virtual-data-table",
-    "version": "1.3.2",
+    "version": "1.4.1",
     "description": "A high-performance virtual data table component for React with Material-UI integration",
     "type": "module",
     "main": "dist/index.js",