@topgrid/grid-features 0.3.0

package/dist/index.d.cts

@@ -0,0 +1,655 @@
+export { DragThProps, DropIndicator, SortBadge, SortBadgeProps, SortClearButton, SortClearButtonProps, UseColumnDragProps, UseColumnDragReturn, UseColumnOrderPersistProps, useColumnDrag, useColumnOrderPersist } from '@topgrid/grid-core';
+import * as React from 'react';
+import { Column, Table, FilterFn } from '@tanstack/react-table';
+
+/**
+ * Multi-sort feature types.
+ * @package @topgrid/grid-features
+ *
+ * Note: `SortClearButtonProps` moved to `@topgrid/grid-core` per ADR-009 (옵션 A).
+ * Note: `SortBadgeProps` moved to `@topgrid/grid-core` per ADR-010.
+ * Both are re-exported from `@topgrid/grid-core` as deprecation aliases (see grid-features/src/index.ts).
+ */
+/**
+ * `useMultiSort` 훅 옵션 (비-wrapper 소비자용).
+ *
+ * @remarks
+ * `<Grid enableMultiSort />` wrapper 사용자는 이 훅 불필요 — Grid.tsx가 직접 처리. (D6)
+ */
+interface UseMultiSortOptions {
+    /** 다중 정렬 활성 여부 (default false). */
+    enableMultiSort?: boolean;
+    /** TanStack maxMultiSortColCount에 직접 전달 (AC-001). 미설정 시 무제한. */
+    maxMultiSortColCount?: number;
+}
+/**
+ * `useMultiSort` 반환값.
+ * useReactTable 옵션에 spread하여 사용.
+ *
+ * @example
+ * const opts = useMultiSort({ enableMultiSort: true });
+ * const table = useReactTable({ ...opts, ... });
+ */
+interface UseMultiSortResult {
+    /** TanStack TableOptions.enableMultiSort에 전달. */
+    enableMultiSort: boolean;
+    /**
+     * TanStack TableOptions.isMultiSortEvent에 전달.
+     * (e) => e.shiftKey — TanStack 내장 기본값과 동일.
+     * 명시적으로 설정하여 문서화 목적 달성.
+     */
+    isMultiSortEvent: (e: unknown) => boolean;
+    /** C-29: 미설정 시 undefined — spread 시 TanStack에 전달 안 됨 (무제한). */
+    maxMultiSortColCount?: number;
+}
+
+/**
+ * useReactTable 직접 사용자가 다중 정렬 옵션을 구성할 때 사용하는 헬퍼.
+ *
+ * @remarks
+ * `<Grid enableMultiSort />` wrapper 사용자는 이 훅 불필요 — Grid.tsx 내부에서
+ * `buildTableOptions.ts`가 props.enableMultiSort를 직접 처리. (D6)
+ *
+ * C-31 wiring audit: Grid.tsx는 이 훅을 import하지 않음. 외부 소비자용 유틸.
+ *
+ * @example
+ * const { enableMultiSort, isMultiSortEvent } = useMultiSort({ enableMultiSort: true });
+ * const table = useReactTable({
+ *   data,
+ *   columns,
+ *   getCoreRowModel: getCoreRowModel(),
+ *   getSortedRowModel: getSortedRowModel(),
+ *   enableMultiSort,
+ *   isMultiSortEvent,
+ * });
+ */
+declare function useMultiSort(opts?: UseMultiSortOptions): UseMultiSortResult;
+
+/**
+ * @topgrid/grid-features — filter-ui 타입 정의.
+ *
+ * MOD-GRID-09 G-001: TextFilter, FilterPopover, FilterIndicator 공유 타입.
+ *
+ * 모든 Props 인터페이스는 index.ts export + Section 9 re-export 계획에 따라
+ * 이 단일 파일에 통합. (C-4: no any, C-29: optional prop 명시)
+ *
+ * @remarks
+ * `verbatimModuleSyntax: true` 환경 — import type 필수.
+ * `exactOptionalPropertyTypes: true` 환경 — optional prop 전달 시
+ * C-29 spread-skip 패턴 사용 (Section 4.6).
+ */
+
+/** 텍스트 필터 연산자. contains/equals/startsWith/endsWith 4종. */
+type TextFilterOperator = 'contains' | 'equals' | 'startsWith' | 'endsWith';
+/**
+ * TanStack columnFilters에 저장되는 TextFilter 값.
+ * `column.setFilterValue(v: TextFilterValue | undefined)` 로 설정.
+ * undefined = 필터 해제.
+ */
+interface TextFilterValue {
+    operator: TextFilterOperator;
+    value: string;
+}
+/**
+ * FilterPopover 컴포넌트 Props.
+ *
+ * 네이티브 div position:absolute 기반 팝오버 (D2: @radix-ui 없음).
+ * 외부클릭(mousedown) / Escape 해제 / 포커스 관리 포함 (D4).
+ */
+interface FilterPopoverProps {
+    /** 팝오버 트리거 요소 렌더 함수 */
+    trigger: React.ReactNode;
+    /** 팝오버 내용 */
+    children: React.ReactNode;
+    /**
+     * 정렬 방향 — 기본 'left'.
+     * C-29: optional prop — 하위 전달 시 spread-skip 패턴 사용 (Section 4.6).
+     */
+    align?: 'left' | 'right';
+}
+/**
+ * FilterIndicator 컴포넌트 Props.
+ * `column.getIsFiltered()` 결과값을 그대로 전달.
+ */
+interface FilterIndicatorProps {
+    /** column.getIsFiltered() 결과값 */
+    isFiltered: boolean;
+}
+/**
+ * TextFilter 컴포넌트 Props.
+ *
+ * @template TData - TanStack Row data 타입.
+ *
+ * C-4: Column<TData, unknown> — unknown cellValue로 any 방지.
+ * C-29: optional prop (defaultOperator, popoverAlign) — spread-skip 패턴 사용처.
+ */
+interface TextFilterProps<TData> {
+    /** TanStack Column 인스턴스. Column<TData, unknown> — cell value 타입 unknown (C-4). */
+    column: Column<TData, unknown>;
+    /**
+     * 기본 연산자 — 기본 'contains'.
+     * C-29: optional prop.
+     */
+    defaultOperator?: TextFilterOperator;
+    /**
+     * 팝오버 정렬 — 기본 'left'.
+     * C-29: optional prop — FilterPopover align으로 spread-skip 전달.
+     */
+    popoverAlign?: 'left' | 'right';
+}
+/** 숫자 필터 연산자. 7종. */
+type NumberFilterOperator = '=' | '!=' | '>' | '<' | '>=' | '<=' | 'between';
+/**
+ * TanStack columnFilters에 저장되는 NumberFilter 값.
+ * `column.setFilterValue(v: NumberFilterValue | undefined)` 로 설정.
+ * - 단항 연산자: `value` 사용, `min`/`max` undefined.
+ * - `between`: `min`/`max` 사용, `value` undefined.
+ * - undefined = 필터 해제.
+ */
+interface NumberFilterValue {
+    operator: NumberFilterOperator;
+    /** 단항 연산자용 값 (=, !=, >, <, >=, <=). between 시 미사용. */
+    value?: number;
+    /** between 하한값 (min <= cell). */
+    min?: number;
+    /** between 상한값 (cell <= max). */
+    max?: number;
+}
+/**
+ * NumberFilter 컴포넌트 Props.
+ *
+ * @template TData - TanStack Row data 타입.
+ * C-4: Column<TData, unknown> — cell value 타입 unknown (any 방지).
+ * C-29: optional prop spread-skip 패턴 적용 (defaultOperator, popoverAlign).
+ */
+interface NumberFilterProps<TData> {
+    /** TanStack Column 인스턴스. Column<TData, unknown>. */
+    column: Column<TData, unknown>;
+    /**
+     * 기본 연산자 — 기본 '='.
+     * C-29: optional prop.
+     */
+    defaultOperator?: NumberFilterOperator;
+    /**
+     * 팝오버 정렬 — 기본 'left'.
+     * C-29: optional prop — FilterPopover align으로 spread-skip 전달.
+     */
+    popoverAlign?: 'left' | 'right';
+}
+/**
+ * TanStack columnFilters에 저장되는 DateFilter 값.
+ * `column.setFilterValue(v: DateFilterValue | undefined)` 로 설정.
+ * - from?: 범위 시작일 (inclusive, startOfDay 정규화)
+ * - to?: 범위 종료일 (inclusive, endOfDay 정규화)
+ * - 양쪽 모두 undefined = 필터 해제 (autoRemove)
+ */
+interface DateFilterValue {
+    from?: Date;
+    to?: Date;
+}
+/**
+ * DateFilter 컴포넌트 Props.
+ *
+ * @template TData - TanStack Row data 타입.
+ * C-4: Column<TData, unknown> — cell value 타입 unknown (any 방지).
+ * C-29: optional prop spread-skip 패턴 적용 (popoverAlign).
+ */
+interface DateFilterProps<TData> {
+    /** TanStack Column 인스턴스. Column<TData, unknown>. */
+    column: Column<TData, unknown>;
+    /**
+     * 팝오버 정렬 — 기본 'left'.
+     * C-29: optional prop — FilterPopover align으로 spread-skip 전달.
+     */
+    popoverAlign?: 'left' | 'right';
+}
+/**
+ * SelectFilter 컴포넌트 Props.
+ *
+ * @template TData - TanStack Row data 타입.
+ * C-4: Column<TData, unknown> — cell value 타입 unknown (any 방지).
+ * C-29: optional prop (searchThreshold, popoverAlign) — spread-skip 패턴 적용.
+ *
+ * 주의: consumer useReactTable options에
+ * `getFacetedRowModel: getFacetedRowModel()` 와
+ * `getFacetedUniqueValues: getFacetedUniqueValues()` 등록 필수 (D3).
+ */
+interface SelectFilterProps<TData> {
+    /** TanStack Column 인스턴스. Column<TData, unknown>. */
+    column: Column<TData, unknown>;
+    /**
+     * 내부 검색 표시 임계값 — 기본 50.
+     * 옵션 수 >= searchThreshold 시 검색 input 자동 노출.
+     * C-29: optional prop.
+     */
+    searchThreshold?: number;
+    /**
+     * 팝오버 정렬 — 기본 'left'.
+     * C-29: optional prop — FilterPopover align으로 spread-skip 전달.
+     */
+    popoverAlign?: 'left' | 'right';
+}
+/**
+ * GlobalSearchInput 컴포넌트 Props.
+ *
+ * @template TData - TanStack Row data 타입.
+ * C-4: Table<TData> — table 인스턴스 직접 수신.
+ * C-29: optional prop (debounceMs, placeholder) — spread-skip 패턴 적용.
+ *
+ * 주의: consumer useReactTable options에 globalFilter state 등록 필요.
+ */
+interface GlobalSearchInputProps<TData> {
+    /** TanStack Table 인스턴스. */
+    table: Table<TData>;
+    /**
+     * 디바운스 ms — 기본 300.
+     * C-29: optional prop.
+     */
+    debounceMs?: number;
+    /**
+     * 입력 placeholder — 기본 'Search all columns…'.
+     * C-29: optional prop.
+     */
+    placeholder?: string;
+}
+/**
+ * FilterResetButton 컴포넌트 Props.
+ *
+ * @template TData - TanStack Row data 타입.
+ * C-4: Table<TData>.
+ * C-29: children optional.
+ */
+interface FilterResetButtonProps<TData> {
+    /** TanStack Table 인스턴스. */
+    table: Table<TData>;
+    /**
+     * 버튼 레이블 — 기본 'Reset Filters'.
+     * C-29: optional prop.
+     */
+    children?: React.ReactNode;
+}
+
+/**
+ * @topgrid/grid-features — TextFilter 메인 컴포넌트.
+ *
+ * MOD-GRID-09 G-001:
+ * 컬럼 헤더 Popover + contains/equals/startsWith/endsWith 연산자 + 필터 인디케이터.
+ *
+ * AC-001: TextFilterValue 타입 + column.setFilterValue / getFilterValue 사용
+ * AC-002: filterFn 등록 패턴 문서화 (Section 12 예시)
+ * AC-003: FilterPopover 사용 (네이티브 div, D2)
+ * AC-004: FilterIndicator (파란 dot, column.getIsFiltered())
+ * AC-005: clear 버튼 → column.setFilterValue(undefined)
+ * AC-006: tsc 0 error (C-29 spread-skip 패턴 적용)
+ *
+ * @remarks
+ * `verbatimModuleSyntax: true` — import type 분리.
+ * `exactOptionalPropertyTypes: true` — popoverAlign → FilterPopover align 전달 시
+ * C-29 spread-skip 패턴 (Section 4.6).
+ * `noUnusedLocals/noUnusedParameters: true` — 모든 변수 사용.
+ * Tailwind className 전용 (C-5).
+ */
+
+/**
+ * 텍스트 필터 UI — 연산자 select + 값 input + clear 버튼.
+ *
+ * `FilterPopover` + `FilterIndicator`를 조합한 메인 컴포넌트.
+ * `column.setFilterValue`로 TanStack columnFilters에 연결.
+ * 디바운스 300ms (D6, Section 4.5).
+ *
+ * @template TData - TanStack Row data 타입.
+ *
+ * @example
+ * ```tsx
+ * // columnDef header에 렌더:
+ * header: ({ column }) => (
+ *   <div className="flex items-center gap-1">
+ *     <span>이름</span>
+ *     <TextFilter column={column} defaultOperator="contains" />
+ *   </div>
+ * ),
+ * filterFn: textFilterFn,
+ * ```
+ */
+declare function TextFilter<TData>({ column, defaultOperator, popoverAlign, }: TextFilterProps<TData>): JSX.Element;
+
+/**
+ * @topgrid/grid-features — FilterPopover 컴포넌트.
+ *
+ * MOD-GRID-09 G-001 AC-003:
+ * 네이티브 div position:absolute 팝오버 구현 (@radix-ui 없음, D2).
+ *
+ * 필수 동작 (D4):
+ * 1. 외부 클릭 해제 (mousedown on document)
+ * 2. Escape 키 해제 + trigger 포커스 복귀
+ * 3. open 시 첫 번째 input 포커스
+ * 4. close 시 trigger 버튼 포커스 복귀
+ * 5. z-index z-[50] — sticky header(z-[10], MOD-GRID-02)보다 높음 (D7)
+ *
+ * @remarks
+ * `verbatimModuleSyntax: true` — import type 분리.
+ * `exactOptionalPropertyTypes: true` — FilterPopoverProps align prop 전달 시
+ * spread-skip 패턴 사용 (C-29, Section 4.6).
+ * Tailwind className 전용 (C-5). style={{}} 없음.
+ */
+
+/**
+ * 텍스트 필터용 Popover 컨테이너.
+ *
+ * trigger prop으로 트리거 요소를 받고, children으로 팝오버 내용을 렌더.
+ * open/close 상태를 내부적으로 관리 (외부 제어 불필요).
+ *
+ * @param props.trigger - 팝오버를 열/닫는 트리거 요소 (아이콘 버튼 등)
+ * @param props.children - 팝오버 내부 콘텐츠 (TextFilter 내용)
+ * @param props.align - 팝오버 정렬 방향. 'left'(기본) | 'right'
+ */
+declare function FilterPopover({ trigger, children, align }: FilterPopoverProps): JSX.Element;
+
+/**
+ * @topgrid/grid-features — FilterIndicator 컴포넌트.
+ *
+ * MOD-GRID-09 G-001 AC-004:
+ * 활성 필터 상태를 헤더에 표시하는 파란 dot 인디케이터.
+ * `column.getIsFiltered() === true` 일 때만 렌더.
+ *
+ * Section 5.2 truth table:
+ * - isFiltered=true  → 파란 dot (w-2 h-2 rounded-full bg-blue-500)
+ * - isFiltered=false → null (렌더 없음)
+ *
+ * @remarks
+ * Tailwind className 전용 (C-5). style={{}} 없음.
+ * `jsx: "react-jsx"` 환경 — `import React` 불필요.
+ */
+
+/**
+ * 활성 필터 인디케이터 — 파란 dot.
+ *
+ * `column.getIsFiltered()` 결과값을 isFiltered prop으로 전달.
+ * 필터 비활성 시 null 반환 (DOM 요소 없음).
+ *
+ * @example
+ * ```tsx
+ * <FilterIndicator isFiltered={column.getIsFiltered()} />
+ * ```
+ */
+declare function FilterIndicator({ isFiltered }: FilterIndicatorProps): JSX.Element | null;
+
+/**
+ * @topgrid/grid-features — TextFilter 커스텀 filterFn.
+ *
+ * MOD-GRID-09 G-001 AC-002: TanStack FilterFn<unknown> 구현.
+ *
+ * 동작 정의 (Section 4.4, D5):
+ * - 대소문자 무시 (case-insensitive toLowerCase 변환)
+ * - 공백 trim (filterValue.value.trim())
+ * - empty value → autoRemove 트리거 → 필터 자동 해제
+ * - null/undefined cellValue → false (null-safe)
+ *
+ * @remarks
+ * `verbatimModuleSyntax: true` — import type 필수.
+ * `noUnusedParameters: true` — row.getValue(columnId) 로 columnId 사용.
+ */
+
+/**
+ * TanStack 커스텀 filterFn — 4가지 텍스트 연산자 지원.
+ *
+ * columnDef에 `filterFn: textFilterFn` 으로 직접 참조 방식 등록.
+ * (타입 안전 + tree-shaking 친화적 — Section 4.3)
+ *
+ * `autoRemove`: filterValue.value.trim() === '' 일 때 TanStack이 필터를 자동 제거.
+ *
+ * @example
+ * ```typescript
+ * columnHelper.accessor('name', {
+ *   filterFn: textFilterFn,
+ *   header: ({ column }) => <TextFilter column={column} />,
+ * });
+ * ```
+ */
+declare const textFilterFn: FilterFn<unknown>;
+/**
+ * TanStack 커스텀 filterFn — 7가지 숫자 연산자 지원.
+ *
+ * 연산자: = / != / > / < / >= / <= / between
+ * - between: min <= cell <= max (양끝 inclusive, inNumberRange semantics — D2)
+ * - null-safe: rawCell == null → false
+ * - NaN-safe: Number(rawCell) isNaN → false
+ *
+ * `autoRemove`:
+ * - 단항 연산자: value === undefined 또는 isNaN(value)
+ * - between: (min === undefined || isNaN(min)) && (max === undefined || isNaN(max))
+ *
+ * columnDef에 `filterFn: numberFilterFn` 으로 직접 참조 방식 등록.
+ *
+ * @example
+ * ```typescript
+ * columnHelper.accessor('price', {
+ *   filterFn: numberFilterFn,
+ *   header: ({ column }) => <NumberFilter column={column} />,
+ * });
+ * ```
+ */
+declare const numberFilterFn: FilterFn<unknown>;
+/**
+ * TanStack 커스텀 filterFn — 날짜 범위(from/to) 필터.
+ *
+ * - cell value: Date instance | ISO string | number(epoch ms) — `new Date(cell)` 변환
+ * - startOfDay(from) / endOfDay(to) 자정 정규화 (D6 로컬 타임존 기준)
+ * - 단일 bound 지원: from-only → cell ≥ startOfDay(from), to-only → cell ≤ endOfDay(to)
+ * - isWithinInterval RangeError (from > to) → try-catch → false (E1)
+ * - null-safe / NaN-safe / empty-string-safe (T1~T4, E4)
+ *
+ * `autoRemove`: from과 to 모두 undefined 일 때 TanStack이 필터를 자동 제거.
+ *
+ * @example
+ * ```typescript
+ * columnHelper.accessor('orderDate', {
+ *   filterFn: dateRangeFilterFn,
+ *   header: ({ column }) => <DateFilter column={column} />,
+ * });
+ * ```
+ */
+declare const dateRangeFilterFn: FilterFn<unknown>;
+/**
+ * TanStack 커스텀 filterFn — 다중선택 배열 포함 필터.
+ *
+ * `filterFns.arrIncludes` re-export: cell value가 filterValue 배열의
+ * 임의 요소와 일치하면 true.
+ *
+ * `autoRemove`: filterValue?.length === 0 시 TanStack이 자동 필터 해제.
+ *
+ * columnDef에 `filterFn: selectFilterFn` 으로 직접 참조 방식 등록.
+ *
+ * 주의: consumer useReactTable options에
+ * `getFacetedRowModel: getFacetedRowModel()` 과
+ * `getFacetedUniqueValues: getFacetedUniqueValues()` 등록 필수 (D3).
+ *
+ * @example
+ * ```typescript
+ * columnHelper.accessor('category', {
+ *   filterFn: selectFilterFn,
+ *   header: ({ column }) => <SelectFilter column={column} />,
+ * });
+ * ```
+ */
+declare const selectFilterFn: FilterFn<any>;
+
+/**
+ * @topgrid/grid-features — NumberFilter 메인 컴포넌트.
+ *
+ * MOD-GRID-09 G-002:
+ * 컬럼 헤더 Popover + 7가지 숫자 연산자(=, !=, >, <, >=, <=, between) + 필터 인디케이터.
+ *
+ * AC-001: NumberFilterValue 타입 + column.setFilterValue / getFilterValue 사용
+ * AC-002: numberFilterFn 등록 패턴 문서화 (Section 12 예시)
+ * AC-003: 단항 연산자 → 단일 value input; between → min/max 두 input (조건부 렌더)
+ * AC-004: G-001 FilterPopover 재사용 (DRY, D7)
+ * AC-005: G-001 FilterIndicator 재사용 (column.getIsFiltered() 기반, D7)
+ * AC-006: tsc 0 error (C-29 spread-skip 패턴 적용)
+ *
+ * @remarks
+ * `verbatimModuleSyntax: true` — import type 분리.
+ * `exactOptionalPropertyTypes: true` — popoverAlign → FilterPopover align 전달 시
+ * C-29 spread-skip 패턴 (Section 4.7).
+ * `noUnusedLocals/noUnusedParameters: true` — 모든 변수 사용.
+ * Tailwind className 전용 (C-5). style={{}} 없음.
+ */
+
+/**
+ * 숫자 필터 UI — 7가지 연산자 select + 조건부 input + clear 버튼.
+ *
+ * `FilterPopover` + `FilterIndicator`를 조합한 메인 컴포넌트 (G-001 재사용).
+ * `column.setFilterValue`로 TanStack columnFilters에 연결.
+ * 디바운스 300ms (D10, Section 4.6).
+ * between 연산자: min/max 두 input 조건부 렌더 (AC-003, D9, Section 5.3).
+ *
+ * @template TData - TanStack Row data 타입.
+ *
+ * @example
+ * ```tsx
+ * // columnDef header에 렌더:
+ * header: ({ column }) => (
+ *   <div className="flex items-center gap-1">
+ *     <span>가격</span>
+ *     <NumberFilter column={column} defaultOperator="=" />
+ *   </div>
+ * ),
+ * filterFn: numberFilterFn,
+ * ```
+ */
+declare function NumberFilter<TData>({ column, defaultOperator, popoverAlign, }: NumberFilterProps<TData>): JSX.Element;
+
+/**
+ * @topgrid/grid-features — DateFilter 컴포넌트.
+ *
+ * MOD-GRID-09 G-003:
+ * react-datepicker 기반 날짜 범위(from/to) 선택 필터.
+ * FilterPopover + FilterIndicator 재사용 (G-001).
+ *
+ * 핵심 동작:
+ * - from/to DatePicker (한국어 locale, locale="ko")
+ * - maxDate/minDate 역전 방지 (E1)
+ * - 초기화 버튼: column.setFilterValue(undefined)
+ * - C-29: popoverAlign → FilterPopover align spread-skip 패턴
+ * - D4: CSS import 없음 — 소비자가 react-datepicker/dist/react-datepicker.css import
+ *
+ * @remarks
+ * `verbatimModuleSyntax: true` — import type 필수.
+ * `exactOptionalPropertyTypes: true` — optional prop 전달 시 C-29 spread-skip 패턴.
+ * Tailwind className 전용 (C-5). 내부 CSS import 없음 (D4).
+ */
+
+/**
+ * 날짜 범위 필터 컴포넌트.
+ *
+ * FilterPopover + FilterIndicator를 재사용하여 from/to DatePicker를 렌더.
+ * `column.setFilterValue` 로 TanStack Table 필터링을 트리거.
+ *
+ * @template TData - TanStack Row data 타입.
+ *
+ * @example
+ * ```tsx
+ * columnHelper.accessor('orderDate', {
+ *   filterFn: dateRangeFilterFn,
+ *   header: ({ column }) => (
+ *     <div>
+ *       주문일
+ *       <DateFilter column={column} />
+ *     </div>
+ *   ),
+ * });
+ * ```
+ */
+declare function DateFilter<TData>({ column, popoverAlign }: DateFilterProps<TData>): JSX.Element;
+
+/**
+ * @topgrid/grid-features — SelectFilter 컴포넌트.
+ *
+ * MOD-GRID-09 G-004 AC-001:
+ * column.getFacetedUniqueValues() Map 읽어 체크박스 옵션 렌더.
+ * 선택 시 column.setFilterValue(string[] | undefined) 호출.
+ *
+ * AC-003: 옵션 수 >= searchThreshold(기본 50) 시 내부 검색 input 자동 노출.
+ *         String.includes 대소문자 무시 — 신규 dep 없음 (D4).
+ *
+ * C-29: popoverAlign optional prop → FilterPopover align에 spread-skip 전달.
+ * C-4: no any — Column<TData, unknown>.
+ * C-5: Tailwind className만.
+ * NFR-5: 체크박스 <input type="checkbox"> 네이티브, label 연결 필수.
+ *
+ * @remarks
+ * consumer useReactTable options에 반드시 등록 필요 (D3):
+ *   getFacetedRowModel: getFacetedRowModel(),
+ *   getFacetedUniqueValues: getFacetedUniqueValues(),
+ */
+
+/**
+ * Excel-style 다중선택 체크박스 필터 컴포넌트.
+ *
+ * @template TData - TanStack Row data 타입.
+ * @param props.column - TanStack Column 인스턴스.
+ * @param props.searchThreshold - 내부 검색 노출 임계값 (기본 50).
+ * @param props.popoverAlign - 팝오버 정렬 방향 (기본 'left').
+ */
+declare function SelectFilter<TData>({ column, searchThreshold, popoverAlign, }: SelectFilterProps<TData>): JSX.Element;
+
+/**
+ * @topgrid/grid-features — GlobalSearchInput 컴포넌트.
+ *
+ * MOD-GRID-09 G-004 AC-004:
+ * 입력값 변경 후 300ms debounce → table.setGlobalFilter(value) 호출.
+ *
+ * Truth Table 5.3:
+ * - "" (빈 문자열) → setGlobalFilter(undefined) (autoRemove)
+ * - "   " (공백만) → trim 후 빈 문자열 → setGlobalFilter(undefined)
+ * - "abc" → setGlobalFilter("abc")
+ *
+ * D5: useEffect + setTimeout 기반 debounce — 신규 dep 없음.
+ * C-4: no any — Table<TData>.
+ * C-5: Tailwind className만.
+ *
+ * @remarks
+ * consumer useReactTable options에 globalFilter state 등록 필요:
+ *   state: { ..., globalFilter },
+ *   onGlobalFilterChange: setGlobalFilter,
+ */
+
+/**
+ * 전체 행 검색 입력 컴포넌트 (debounce 300ms).
+ *
+ * @template TData - TanStack Row data 타입.
+ * @param props.table - TanStack Table 인스턴스.
+ * @param props.debounceMs - 디바운스 ms (기본 300).
+ * @param props.placeholder - 입력 placeholder (기본 'Search all columns…').
+ */
+declare function GlobalSearchInput<TData>({ table, debounceMs, placeholder, }: GlobalSearchInputProps<TData>): JSX.Element;
+
+/**
+ * @topgrid/grid-features — FilterResetButton 컴포넌트.
+ *
+ * MOD-GRID-09 G-004 AC-005:
+ * table.resetColumnFilters() + table.setGlobalFilter(undefined) 호출.
+ * columnFilters.length === 0 && !globalFilter 시 disabled.
+ *
+ * D6: disabled 조건 — Truth Table 5.2:
+ * - columnFilters=[], globalFilter=undefined → disabled=true
+ * - 그 외 → disabled=false
+ *
+ * C-4: no any — Table<TData>.
+ * C-5: Tailwind className만.
+ *
+ * @remarks
+ * children prop은 버튼 레이블 오버라이드 용도.
+ * 기본 레이블: 'Reset Filters'.
+ */
+
+/**
+ * 필터 전체 초기화 버튼 컴포넌트.
+ *
+ * @template TData - TanStack Row data 타입.
+ * @param props.table - TanStack Table 인스턴스.
+ * @param props.children - 버튼 레이블 (기본 'Reset Filters').
+ */
+declare function FilterResetButton<TData>({ table, children, }: FilterResetButtonProps<TData>): JSX.Element;
+
+export { DateFilter, type DateFilterProps, type DateFilterValue, FilterIndicator, type FilterIndicatorProps, FilterPopover, type FilterPopoverProps, FilterResetButton, type FilterResetButtonProps, GlobalSearchInput, type GlobalSearchInputProps, NumberFilter, type NumberFilterOperator, type NumberFilterProps, type NumberFilterValue, SelectFilter, type SelectFilterProps, TextFilter, type TextFilterOperator, type TextFilterProps, type TextFilterValue, type UseMultiSortOptions, type UseMultiSortResult, dateRangeFilterFn, numberFilterFn, selectFilterFn, textFilterFn, useMultiSort };