# BeautifulGrid TypeScript API Reference

> beautiful-grid/types.ts에서 생성한 공개 인터페이스, 타입, enum 및 멤버의 기계 판독용 참조입니다.

Source page: https://bgrid.axisj.com/api/props

The TypeScript source is the final authority when this document and an installed package version differ. Internal Zustand store and rendering-only types are intentionally excluded.

## 핵심 컴포넌트 타입

### BGridProps

BGrid 컴포넌트에 전달하는 최상위 props입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L974

```ts
export interface BGridProps<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `ref` | `React.Ref<BGridRef<T>>` | no | no | BGridRef를 연결합니다. scrollToRow(rowIndex, { align })으로 현재 페이지의 표시 행까지 이동합니다. |
| `width` | `number` | yes | no | 그리드 또는 해당 항목의 너비입니다. |
| `height` | `number` | yes | no | 그리드의 전체 높이입니다. |
| `headerHeight` | `number` | no | no | 컬럼 헤더 영역 높이입니다. |
| `footerHeight` | `number` | no | yes | 더 이상 권장되지 않습니다. bottomBarHeight를 사용하세요. |
| `bottomBarHeight` | `number` | no | no | 상태 및 페이지네이션이 배치되는 하단 바 높이입니다. |
| `summaryHeight` | `number` | no | no | 요약 행 높이입니다. |
| `summaryRowHeight` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `itemHeight` | `number` | no | no | 데이터 행의 기준 높이입니다. |
| `itemPadding` | `number` | no | no | 행 높이를 계산할 때 적용하는 내부 여백입니다. |
| `getRowHeight` | `(row: T, index: number) => number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `frozenColumnIndex` | `number` | no | no | 이 인덱스 앞의 컬럼을 왼쪽에 고정합니다. |
| `frozenRowCount` | `number` | no | no | 현재 표시 데이터의 앞쪽 행을 상단에 고정합니다. 상단 Summary가 있으면 그 다음 줄부터 배치됩니다. |
| `columns` | `BGridColumnWithOptionalWidth<T>[]` | yes | no | 그리드에 표시할 컬럼 정의 배열입니다. |
| `columnsGroup` | `BGridColumnGroup[]` | no | yes | 더 이상 권장되지 않는 인덱스 범위 방식의 그룹 헤더 배열입니다. |
| `columnGroups` | `BGridColumnGroupNode[]` | no | no | 컬럼 ID를 참조하는 재귀적 다단 그룹 헤더 트리입니다. |
| `onChangeColumns` | `(columnIndex: number \| null, info: BGridChangeColumnsInfo<T>) => void` | no | no | 컬럼 너비 또는 순서가 바뀔 때 호출됩니다. |
| `data` | `BGridDataItem<T>[]` | no | no | BGridDataItem으로 감싼 행 데이터 배열입니다. |
| `onChangeData` | `(<br>    index: number,<br>    columnIndex: number \| null,<br>    item: T,<br>    column: BGridColumn<T> \| null,<br>    meta?: BGridChangeDataMeta<T>,<br>  ) => void` | no | no | 편집으로 행 데이터가 바뀔 때 source index와 선택적 트랜잭션 metadata를 전달합니다. |
| `page` | `BGridPage` | no | no | 페이지 상태와 변경 콜백입니다. |
| `enableLoadMore` | `boolean` | no | no | 스크롤 끝에서 추가 데이터 로드를 활성화합니다. |
| `onLoadMore` | `(params: { scrollLeft: number; scrollTop: number }) => void` | no | no | 추가 데이터를 요청해야 할 때 호출됩니다. |
| `endLoadMoreRender` | `() => React.ReactNode` | no | no | 추가 로드가 끝난 위치에 표시할 콘텐츠입니다. |
| `scrollbar` | `BGridScrollbarOptions` | no | no | 가로·세로 스크롤바의 표시와 변형을 설정합니다. |
| `status` | `BGridStatusOptions` | no | no | 행 변경 상태 또는 표시 상태 설정입니다. |
| `pagination` | `BGridPaginationViewOptions` | no | no | 하단 페이지네이션 UI를 설정합니다. |
| `className` | `string` | no | no | 요소에 추가할 CSS 클래스 이름입니다. |
| `style` | `React.CSSProperties` | no | no | 요소에 추가할 React 인라인 스타일입니다. |
| `loading` | `boolean` | no | no | 데이터 로딩 오버레이를 표시합니다. |
| `spinning` | `boolean` | no | no | 로딩 표시의 회전 상태를 제어합니다. |
| `disabled` | `boolean` | no | no | 스크롤을 제외한 그리드 UI 상호작용을 비활성화합니다. |
| `scrollTop` | `number` | no | no | 외부에서 지정하는 세로 스크롤 위치입니다. |
| `scrollLeft` | `number` | no | no | 외부에서 지정하는 가로 스크롤 위치입니다. |
| `rowChecked` | `BGridRowChecked<T>` | no | no | 체크박스 또는 라디오 행 선택을 설정합니다. |
| `sort` | `BGridSortInfo` | no | no | 제어형 컬럼 정렬 상태를 설정합니다. |
| `onClick` | `(params: BGridClickParams<T>) => void` | no | no | 해당 셀 또는 아이콘의 클릭 상호작용이 발생할 때 호출됩니다. |
| `msg` | `{<br>    emptyList?: string;<br>    toolbox?: {<br>      sort?: string;<br>      sortAscending?: string;<br>      sortDescending?: string;<br>      clearSort?: string;<br>      filterApplied?: string;<br>      openColumnOptions?: string;<br>      filter?: string;<br>      textFilter?: string;<br>      valueFilter?: string;<br>      numberFilter?: string;<br>      contains?: string;<br>      equals?: string;<br>      notEquals?: string;<br>      numberEquals?: string;<br>      numberNotEquals?: string;<br>      greaterThan?: string;<br>      greaterThanOrEqual?: string;<br>      lessThan?: string;<br>      lessThanOrEqual?: string;<br>      between?: string;<br>      searchPlaceholder?: string;<br>      textPlaceholder?: string;<br>      numberPlaceholder?: string;<br>      minimumPlaceholder?: string;<br>      maximumPlaceholder?: string;<br>      invalidRange?: string;<br>      clear?: string;<br>      apply?: string;<br>      emptyValue?: string;<br>      selectAll?: string;<br>      noValues?: string;<br>      noResults?: string;<br>      extraMenu?: string;<br>      columns?: string;<br>      hiddenColumns?: string;<br>      showAllColumns?: string;<br>      hideThisColumn?: string;<br>      lastVisibleColumn?: string;<br>      hiddenColumnCount?: (count: number) => string;<br>      moreValues?: (count: number) => string;<br>    };<br>  }` | no | no | 빈 데이터 등 그리드 메시지를 바꿉니다. |
| `rowKey` | `React.Key \| React.Key[]` | no | no | 행의 고유 키를 읽을 필드 경로입니다. |
| `selectedRowKey` | `React.Key \| React.Key[]` | no | no | 선택 강조할 행의 키입니다. |
| `editable` | `boolean` | no | no | 그리드 편집 기능을 활성화합니다. |
| `editTrigger` | `BGridEditTrigger` | no | no | 셀 편집 진입을 클릭 또는 더블클릭으로 선택합니다. 기본값은 dblclick입니다. |
| `showLineNumber` | `boolean` | no | no | 왼쪽에 행 번호 컬럼을 표시합니다. |
| `getRowClassName` | `(ri: number, item: BGridDataItem<T>) => string \| undefined` | no | no | 행 상태에 따라 CSS 클래스 이름을 반환합니다. |
| `cellMergeOptions` | `{<br>    columnsMap: Record<number, BGridCellMergeColumn>;<br>  }` | no | no | 연속된 동일 값 셀의 병합 기준을 설정합니다. |
| `cellSelectionOptions` | `{<br>    enabled?: boolean;<br>    /** Controls which cell remains active after a multi-cell selection. */<br>    multiSelectFocusMode?: 'first' \| 'last';<br>    clearOnEscape?: boolean;<br>    clearOnOutsideClick?: boolean;<br>    maxClipboardCells?: number;<br>    maxClipboardTextLength?: number;<br>    onCopyError?: (error: BGridCellSelectionCopyError) => void;<br>    onPasteError?: (error: BGridCellSelectionPasteError) => void;<br>    /** Creates missing trailing rows while pasting. Returned rows are always marked as `new`. */<br>    createRowOnPaste?: (context: BGridCellSelectionPasteRowContext<T>) => BGridDataItem<T> \| undefined;<br>  }` | no | no | 셀 범위 선택과 표 형태 복사·붙여넣기 제한을 설정합니다. |
| `cellNavigationOptions` | `BGridCellNavigationOptions` | no | no | 활성 셀과 키보드 이동·편집·클릭 활성화 정책을 설정합니다. |
| `variant` | `'default' \| 'vertical-bordered'` | no | no | 그리드 테두리 표현 변형을 선택합니다. |
| `summary` | `BGridSummaryOptions<T>` | no | no | 상단 또는 하단 요약 행을 설정합니다. |
| `columnSortable` | `boolean` | no | no | 컬럼 드래그 순서 변경을 활성화합니다. |
| `reorder` | `BGridReorderInfo<T>` | no | no | 행 드래그 순서 변경을 설정합니다. |
| `reorderingInfo` | `BGridReorderingInfo` | no | no | 외부에서 현재 행 드래그 위치를 전달합니다. |
| `pivot` | `BGridPivotOptions<T>` | no | no | 피벗 데이터 변환과 표시를 설정합니다. |
| `dataControl` | `BGridDataControl` | no | no | 정렬·필터 쿼리의 처리 방식을 제어합니다. |
| `icons` | `BGridToolboxIcons` | no | no | 컬럼 툴박스 아이콘을 교체합니다. |
| `columnVisibility` | `boolean \| BGridColumnVisibilityOptions<T>` | no | no | v1.0.6부터 컬럼 숨김과 복구 UI 및 상태 제어를 활성화합니다. |
| `searchOptions` | `BGridSearchOptions<T>` | no | no | 현재 로드된 표시 데이터에서 셀을 찾아 하이라이트하고 이전·다음 결과를 이동합니다. |
| `contextMenuOptions` | `BGridContextMenuOptions<T>` | no | no | 본문 셀의 우클릭 및 키보드 컨텍스트 메뉴에 사용자 항목을 추가합니다. |
| `tree` | `BGridTreeOptions<T>` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `masterDetail` | `BGridMasterDetailOptions<T>` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridColumn

한 개 데이터 컬럼의 키, 제목, 너비, 렌더링 및 편집 동작을 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L202

```ts
export interface BGridColumn<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `id` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `key` | `string \| string[]` | yes | no | 행 값에서 읽을 필드 이름 또는 중첩 경로입니다. |
| `label` | `ReactNode` | yes | no | 화면에 표시할 제목입니다. |
| `width` | `number` | yes | no | 그리드 또는 해당 항목의 너비입니다. |
| `align` | `AlignDirection` | no | no | 본문 셀 콘텐츠의 가로 정렬입니다. |
| `headerAlign` | `AlignDirection` | no | no | 헤더 콘텐츠의 가로 정렬입니다. |
| `sortDisable` | `boolean` | no | no | 해당 컬럼의 정렬을 비활성화합니다. |
| `className` | `string` | no | no | 요소에 추가할 CSS 클래스 이름입니다. |
| `getClassName` | `(item: BGridDataItem<T>) => string` | no | no | 데이터에 따라 CSS 클래스 이름을 반환합니다. |
| `headerClassName` | `string` | no | no | 헤더 셀에 추가할 CSS 클래스 이름입니다. |
| `headerStyle` | `React.CSSProperties` | no | no | 헤더 셀에 적용할 React 인라인 스타일입니다. |
| `itemRender` | `React.FC<BGridItemRenderProps<T>>` | no | no | 셀 콘텐츠를 렌더링하는 React 컴포넌트입니다. |
| `editor` | `BGridCellEditorConfig<T>` | no | no | 내장 text 또는 plugin 셀 편집기를 연결합니다. |
| `editTrigger` | `BGridEditTrigger` | no | no | 셀 편집 진입을 클릭 또는 더블클릭으로 선택합니다. 기본값은 dblclick입니다. |
| `editorIcon` | `BGridEditorIconConfig<T>` | no | no | 셀 값 옆에 editor 시작 또는 독립 callback 아이콘을 연결합니다. |
| `onChangeValue` | `(params: BGridChangeValueParams<T>) => void \| Promise<void>` | no | no | editor가 제안한 변경을 검증·보정한 뒤 commit 또는 cancel하는 컬럼 hook입니다. |
| `getClipboardText` | `(params: BGridCellClipboardTextParams<T>) => any` | no | no | 클립보드에 복사할 값을 반환합니다. |
| `parseClipboardText` | `(text: string, params: BGridCellClipboardParseParams<T>) => unknown` | no | no | 클립보드 문자열을 해당 컬럼에 저장할 셀 값으로 변환합니다. |
| `searchable` | `boolean` | no | no | 해당 컬럼을 Grid 검색 대상에 포함할지 설정합니다. |
| `getSearchText` | `(params: BGridSearchCellParams<T>) => unknown` | no | no | 렌더링된 DOM 대신 검색에 사용할 동기 문자열 값을 반환합니다. |
| `editable` | `boolean` | no | no | 그리드 편집 기능을 활성화합니다. |
| `hideable` | `boolean` | no | no | v1.0.6부터 사용자가 툴박스에서 이 컬럼을 숨길 수 있는지 설정합니다. |
| `toolbox` | `boolean \| BGridToolboxConfig<T>` | no | no | 컬럼 툴박스의 사용 여부 또는 상세 설정입니다. |
| `filter` | `false \| BGridColumnFilterConfig<T>` | no | no | 컬럼 필터의 사용 여부 또는 상세 설정입니다. |
| `sortComparator` | `(<br>    a: unknown,<br>    b: unknown,<br>    params: {<br>      column: BGridColumn<T>;<br>      aItem: BGridDataItem<T>;<br>      bItem: BGridDataItem<T>;<br>    },<br>  ) => number` | no | no | 클라이언트 정렬에 사용할 비교 함수입니다. |
| `exportable` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `exportHeader` | `string \| ((column: BGridColumn<T>) => string)` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `getExportValue` | `(params: BGridCellExportValueParams<T>) => unknown` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridDataItem

원본 행 값과 그리드 상태를 함께 전달하는 행 래퍼 타입입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L306

```ts
export type BGridDataItem<T> = {
  values: T;
  status?: BGridDataItemStatus;
  /** Column instances directly edited since the data owner last cleared the edit state. */
  editedColumnIds?: string[];
  /** Stable key tokens whose underlying values changed since the data owner last cleared the change state. */
  changedKeys?: string[];
  checked?: boolean;
  parentItemIndex?: number;
  meta?: Record<string, any>;
};
```


### AlignDirection

셀 또는 헤더 콘텐츠의 가로 정렬 방향입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L3

```ts
export type AlignDirection = 'left' | 'center' | 'right';
```


### BGridCellClipboardParseParams

parseClipboardText에서 붙여넣기 문자열을 셀 값으로 복원할 때 사용하는 컨텍스트입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L174

```ts
export interface BGridCellClipboardParseParams<T> extends BGridCellClipboardTextParams<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `text` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridCellClipboardTextParams

getClipboardText에서 복사 문자열을 만들 때 사용하는 셀 컨텍스트입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L165

```ts
export interface BGridCellClipboardTextParams<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `index` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `value` | `any` | yes | no | 현재 셀 또는 필터의 값입니다. |


### BGridColumnWithOptionalWidth

최상위 columns prop에서 width를 생략할 수 있게 만든 컬럼 입력 타입입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L788

```ts
export type BGridColumnWithOptionalWidth<T> = Partial<Pick<BGridColumn<T>, 'width'>> & Omit<BGridColumn<T>, 'width'>;
```


### BGridDataItemStatus

행의 신규·수정·삭제 상태를 나타냅니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L300

```ts
export enum BGridDataItemStatus
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `new` | `number` | yes | no | 열거형 값입니다. |
| `edit` | `number` | yes | no | 열거형 값입니다. |
| `remove` | `number` | yes | no | 열거형 값입니다. |


### BGridItemRenderProps

컬럼 itemRender에 전달되는 셀 렌더링 컨텍스트입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L13

```ts
export interface BGridItemRenderProps<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `index` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `value` | `any` | yes | no | 현재 셀 또는 필터의 값입니다. |
| `editable` | `boolean` | no | no | 그리드 편집 기능을 활성화합니다. |
| `handleSave` | `(value: any, columnDirection?: MoveDirection, rowDirection?: MoveDirection) => void` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `handleCancel` | `() => void` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `handleMove` | `(columnDirection: MoveDirection, rowDirection: MoveDirection) => void` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridRef

ref로 접근하는 Grid API입니다. scrollToRow 스크롤, getExportData 논리 데이터 추출, exportCsv 및 exportExcel 파일 다운로드를 제공합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L904

```ts
export interface BGridRef<T = any>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `scrollToRow` | `(rowIndex: number, options?: BGridScrollToRowOptions) => void` | yes | no | 정렬·필터 후 0 기반 표시 행 인덱스로 이동합니다. 데이터 반영 후 실행하며 가로 스크롤과 선택은 유지합니다. |
| `getExportData` | `(options?: BGridExportDataOptions) => BGridExportData<T>` | yes | no | 화면 가상 스크롤과 무관하게 전체 논리 행과 컬럼의 Export 데이터 모델을 추출합니다. |
| `exportCsv` | `(options?: BGridCsvExportOptions) => void` | yes | no | RFC 4180 호환 CSV 파일로 직렬화하여 브라우저 다운로드를 실행합니다. |
| `exportExcel` | `(options?: BGridExcelExportOptions) => void` | yes | no | 외부 의존성 없이 표준 OpenXML Excel (.xlsx) 파일로 직렬화하여 브라우저 다운로드를 실행합니다. |


### MoveDirection

편집 중 다음 셀로 이동할 방향입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L4

```ts
export type MoveDirection = 'prev' | 'next' | 'current';
```


## 데이터와 이벤트

### BGridCellExportValueParams

컬럼별 getExportValue 변환 함수에 전달되는 셀 문맥입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L192

```ts
export interface BGridCellExportValueParams<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnId` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `visibleIndex` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `sourceIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `value` | `unknown` | yes | no | 현재 셀 또는 필터의 값입니다. |


### BGridChangeColumnsInfo

컬럼 너비나 순서 변경 뒤 전달되는 컬럼 상태입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L486

```ts
export interface BGridChangeColumnsInfo<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `width` | `number` | no | no | 그리드 또는 해당 항목의 너비입니다. |
| `columns` | `BGridColumn<T>[]` | yes | no | 그리드에 표시할 컬럼 정의 배열입니다. |
| `columnsGroup` | `BGridColumnGroup[]` | no | no | 더 이상 권장되지 않는 인덱스 범위 방식의 그룹 헤더 배열입니다. |
| `columnGroups` | `BGridColumnGroupNode[]` | no | no | 컬럼 ID를 참조하는 재귀적 다단 그룹 헤더 트리입니다. |


### BGridChangeDataMeta

onChangeData에 전달되는 실제 변경 목록과 병합 트랜잭션 범위입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L1228

```ts
export interface BGridChangeDataMeta<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `source` | `BGridEditSource` | yes | no | 편집 요청을 시작한 입력 경로입니다. |
| `originColumn` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `changes` | `readonly BGridCellValueChange<T>[]` | yes | no | key 또는 columnId로 식별한 컬럼 변경 목록입니다. |
| `dataItem` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `tree` | `BGridTreeChangeDataMeta` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `transaction` | `{<br>    merged: boolean;<br>    canonicalCell: BGridCellAddress;<br>    visibleIndexes: readonly number[];<br>    sourceIndexes: readonly number[];<br>  }` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridClickParams

셀 클릭 콜백에 전달되는 행과 컬럼 정보입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L479

```ts
export interface BGridClickParams<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `index` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `item` | `T` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridCsvExportOptions

exportCsv에 전달하는 export 범위 및 CSV 파일 다운로드 옵션입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L886

```ts
export interface BGridCsvExportOptions extends BGridExportDataOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `fileName` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `delimiter` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `newline` | `'\n' \| '\r\n'` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `includeHeader` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `bom` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `preventFormulaInjection` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridCsvSerializeOptions

Export 데이터를 CSV 문자열로 직렬화할 때의 구분자, 줄바꿈, BOM, 수식 인젝션 방지 설정입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L878

```ts
export interface BGridCsvSerializeOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `delimiter` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `newline` | `'\n' \| '\r\n'` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `includeHeader` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `bom` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `preventFormulaInjection` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridExcelExportOptions

exportExcel에 전달하는 export 범위 및 Excel 파일 다운로드 옵션입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L900

```ts
export interface BGridExcelExportOptions extends BGridExportDataOptions, BGridExcelSerializeOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `fileName` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridExcelSerializeOptions

Export 데이터를 Excel(.xlsx)로 직렬화할 때의 시트 이름 및 헤더 포함 여부 설정입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L895

```ts
export interface BGridExcelSerializeOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `sheetName` | `string` | no | no | Excel 워크시트 탭 이름을 지정합니다. (기본값 Sheet1, 최대 31자) |
| `includeHeader` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridExportColumn

Export 결과의 컬럼 메타데이터(columnId, header, column, columnIndex)입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L852

```ts
export interface BGridExportColumn<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `columnId` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `header` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |


### BGridExportColumnScope

Export 대상 컬럼 범위(visible, all 또는 컬럼 ID 배열)를 지정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L850

```ts
export type BGridExportColumnScope = 'visible' | 'all' | readonly string[];
```


### BGridExportData

컬럼과 행 cells 2차원 배열로 구성된 Grid 논리 Export 데이터 모델입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L868

```ts
export interface BGridExportData<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `columns` | `BGridExportColumn<T>[]` | yes | no | 그리드에 표시할 컬럼 정의 배열입니다. |
| `rows` | `BGridExportRow<T>[]` | yes | no | 해당 컨텍스트의 행 목록 또는 피벗 행 축 필드 배열입니다. |


### BGridExportDataOptions

getExportData, exportCsv, exportExcel에 전달하는 행과 컬럼 export 범위 옵션입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L873

```ts
export interface BGridExportDataOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `rows` | `BGridExportRowScope` | no | no | 해당 컨텍스트의 행 목록 또는 피벗 행 축 필드 배열입니다. |
| `columns` | `BGridExportColumnScope` | no | no | 그리드에 표시할 컬럼 정의 배열입니다. |


### BGridExportRow

Export 결과의 행 데이터(표시·원본 인덱스, rowKey, values, cells 배열)입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L859

```ts
export interface BGridExportRow<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `visibleIndex` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `sourceIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `rowKey` | `React.Key` | no | no | 행의 고유 키를 읽을 필드 경로입니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `cells` | `unknown[]` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridExportRowScope

Export 대상 행 범위(displayed, checked, source)를 지정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L848

```ts
export type BGridExportRowScope = 'displayed' | 'checked' | 'source';
```


### BGridPage

페이지 번호, 크기, 전체 개수와 페이지 변경 콜백을 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L324

```ts
export interface BGridPage
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `currentPage` | `number` | no | no | 현재 페이지 번호입니다. |
| `pageSize` | `number` | no | no | 페이지 또는 PageUp/PageDown 이동 단위의 행 수입니다. |
| `totalPages` | `number` | no | no | 전체 페이지 수입니다. |
| `totalElements` | `number` | no | no | 전체 데이터 행 수입니다. |
| `loading` | `boolean` | no | no | 데이터 로딩 오버레이를 표시합니다. |
| `onChange` | `(currentPage: number, pageSize?: number) => void` | no | no | 상태가 변경될 때 호출됩니다. |
| `displayPaginationLength` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `statusRender` | `() => void` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `paginationRender` | `() => void` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridProcessedRow

정렬·필터 처리 후 원본 인덱스를 보존하는 처리 행입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L318

```ts
export interface BGridProcessedRow<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `sourceIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `rowKey` | `React.Key` | no | no | 행의 고유 키를 읽을 필드 경로입니다. |


### BGridRowChecked

체크박스 또는 라디오 방식의 행 선택 상태와 변경 콜백입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L336

```ts
export interface BGridRowChecked<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `isRadio` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `checkedIndexes` | `number[]` | no | no | 선택한 행의 현재 표시 인덱스 배열입니다. |
| `checkedRowKeys` | `React.Key[]` | no | no | 선택한 행의 rowKey 값 배열입니다. |
| `disabled` | `(index: number, item: BGridDataItem<T>) => boolean` | no | no | 해당 항목의 상호작용 비활성 여부입니다. |
| `onChange` | `(checkedIndexes: number[], checkedRowKeys: React.Key[], checkedAll?: CheckedAll) => void` | yes | no | 상태가 변경될 때 호출됩니다. |


### CheckedAll

전체 선택 상태를 선택·해제·부분 선택으로 표현합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L1226

```ts
export type CheckedAll = true | false | 'indeterminate';
```


## 정렬·필터·툴박스

### BGridColumnFilterConfig

컬럼별 필터 형식, 값 추출 및 사용자 조건식을 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L402

```ts
export interface BGridColumnFilterConfig<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `type` | `'values' \| 'text' \| 'number'` | yes | no | 판별 가능한 설정 또는 이벤트 종류입니다. |
| `caseSensitive` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `BGridFilterValue[]` | no | no | 원본 행 값 또는 집계 대상 값입니다. |
| `getValue` | `(item: BGridDataItem<T>) => unknown` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `predicate` | `(params: { item: BGridDataItem<T>; value: unknown; filter: BGridFilterParam }) => boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `formatValue` | `(value: unknown) => React.ReactNode` | no | no | 셀 값을 text input 문자열로 변환합니다. |
| `maxValueListItems` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridColumnVisibilityChangeEvent

v1.0.6부터 컬럼 숨김, 표시 또는 전체 표시 동작을 설명합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L442

```ts
export interface BGridColumnVisibilityChangeEvent<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `type` | `'hide' \| 'show' \| 'showAll'` | yes | no | 판별 가능한 설정 또는 이벤트 종류입니다. |
| `columnId` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `column` | `BGridColumn<T>` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridColumnVisibilityOptions

v1.0.6부터 controlled 또는 uncontrolled 컬럼 숨김 상태를 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L449

```ts
export interface BGridColumnVisibilityOptions<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `enabled` | `boolean` | no | no | 기능 활성화 여부입니다. |
| `hiddenColumnIds` | `readonly string[]` | no | no | 숨길 컬럼의 고유 id 목록입니다. |
| `defaultHiddenColumnIds` | `readonly string[]` | no | no | uncontrolled 모드에서 처음 숨길 컬럼 id 목록입니다. |
| `onChange` | `(hiddenColumnIds: string[], event: BGridColumnVisibilityChangeEvent<T>) => void` | no | no | 상태가 변경될 때 호출됩니다. |


### BGridContextMenuItem

본문 셀 메뉴의 실행 항목 또는 구분선을 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L633

```ts
export type BGridContextMenuItem<T> =
  | {
      type?: 'item';
      id: string;
      label: React.ReactNode;
      icon?: React.ReactNode;
      shortcut?: string;
      disabled?: boolean;
      onSelect: (target: BGridContextMenuTarget<T>) => void | Promise<void>;
    }
  | {
      type: 'separator';
      id: string;
    };
```


### BGridContextMenuOptions

본문 셀에서 확장 가능한 컨텍스트 메뉴 항목을 구성합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L648

```ts
export interface BGridContextMenuOptions<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `enabled` | `boolean` | no | no | 기능 활성화 여부입니다. |
| `items` | `(target: BGridContextMenuTarget<T>) => readonly BGridContextMenuItem<T>[]` | no | no | 대상 셀 문맥으로 컨텍스트 메뉴 항목을 만듭니다. |
| `onOpenChange` | `(open: boolean, target?: BGridContextMenuTarget<T>) => void` | no | no | 검색 또는 컨텍스트 메뉴의 열림 상태 변경을 알립니다. |


### BGridContextMenuTarget

본문 셀 컨텍스트 메뉴에 전달되는 표시·원본 행과 셀 문맥입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L620

```ts
export interface BGridContextMenuTarget<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `cell` | `BGridCellAddress` | yes | no | 편집 또는 이동 대상 셀 주소입니다. |
| `visibleIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `sourceIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `rowKey` | `React.Key` | no | no | 행의 고유 키를 읽을 필드 경로입니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `columnId` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `value` | `unknown` | yes | no | 현재 셀 또는 필터의 값입니다. |


### BGridDataControl

클라이언트 처리 또는 수동 서버 처리 방식의 데이터 쿼리를 제어합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L395

```ts
export interface BGridDataControl
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `mode` | `'manual' \| 'client'` | no | no | 쿼리를 수동 처리할지 클라이언트에서 처리할지 선택합니다. |
| `multiSort` | `boolean` | no | no | 여러 컬럼 동시 정렬을 허용합니다. |
| `query` | `BGridDataQuery` | yes | no | 현재 정렬 및 필터 쿼리입니다. |
| `onChange` | `(query: BGridDataQuery, event: BGridDataQueryChangeEvent) => void` | yes | no | 상태가 변경될 때 호출됩니다. |


### BGridDataQuery

현재 적용된 정렬 및 필터 조건 전체입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L384

```ts
export interface BGridDataQuery
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `sortParams` | `BGridSortParam[]` | yes | no | 현재 적용된 정렬 조건 배열입니다. |
| `filterParams` | `BGridFilterParam[]` | yes | no | 현재 적용된 필터 조건 배열입니다. |


### BGridDataQueryChangeEvent

데이터 쿼리가 변경된 원인과 대상 컬럼을 설명합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L389

```ts
export interface BGridDataQueryChangeEvent
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `type` | `'sort' \| 'filter'` | yes | no | 판별 가능한 설정 또는 이벤트 종류입니다. |
| `columnId` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `action` | `'apply' \| 'clear'` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridFilterOperator

텍스트 및 숫자 필터에서 지원하는 비교 연산자입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L357

```ts
export type BGridFilterOperator = 'contains' | 'equals' | 'notEquals' | 'gt' | 'gte' | 'lt' | 'lte' | 'between';
```


### BGridFilterParam

값·텍스트·숫자 필터 조건의 판별 유니온입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L366

```ts
export type BGridFilterParam =
  | (BGridFilterParamBase & {
      type: 'values';
      values: BGridFilterValue[];
    })
  | (BGridFilterParamBase & {
      type: 'text';
      operator: 'contains' | 'equals' | 'notEquals';
      value: string;
    })
  | (BGridFilterParamBase & {
      type: 'number';
      operator: Exclude<BGridFilterOperator, 'contains'>;
      value?: number;
      min?: number;
      max?: number;
    });
```


### BGridFilterValue

값 목록 필터에서 사용할 수 있는 원시 값입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L359

```ts
export type BGridFilterValue = string | number | boolean | null;
```


### BGridSearchCellParams

검색 문자열 getter에 전달되는 표시·원본 행과 셀 문맥입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L179

```ts
export interface BGridSearchCellParams<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `cell` | `BGridCellAddress` | yes | no | 편집 또는 이동 대상 셀 주소입니다. |
| `visibleIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `sourceIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `rowKey` | `React.Key` | no | no | 행의 고유 키를 읽을 필드 경로입니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `columnId` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `value` | `unknown` | yes | no | 현재 셀 또는 필터의 값입니다. |


### BGridSearchIcons

검색 입력과 이전·다음·닫기 버튼의 아이콘 슬롯입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L581

```ts
export interface BGridSearchIcons
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `search` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `previous` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `next` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `close` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridSearchLabels

검색 UI의 접근 가능한 이름, 상태 문구와 결과 수 형식을 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L588

```ts
export interface BGridSearchLabels
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `inputAriaLabel` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `placeholder` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `previousAriaLabel` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `nextAriaLabel` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `closeAriaLabel` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `searching` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `noResults` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `contextMenuItem` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `formatResultCount` | `(params: {<br>    activeResult: number;<br>    totalResults: number;<br>    loadedRowCount: number;<br>    paged: boolean;<br>  }) => React.ReactNode` | no | no | 현재 결과, 전체 결과와 로드된 행 수를 표시할 React 노드를 만듭니다. |


### BGridSearchOpenReason

검색 UI 열림 상태가 변경된 사용자 또는 surface 원인입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L573

```ts
export type BGridSearchOpenReason =
  | 'shortcut'
  | 'contextMenu'
  | 'external'
  | 'escape'
  | 'closeButton'
  | 'surfaceConflict';
```


### BGridSearchOptions

현재 로드된 Grid 데이터의 셀 검색과 제어형 UI 상태를 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L605

```ts
export interface BGridSearchOptions<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `enabled` | `boolean` | no | no | 기능 활성화 여부입니다. |
| `shortcut` | `boolean` | no | no | Grid에 포커스가 있을 때 Ctrl/Cmd+F 검색 진입을 사용할지 설정합니다. |
| `contextMenu` | `boolean` | no | no | 기본 컨텍스트 메뉴에 검색 항목을 포함할지 설정합니다. |
| `open` | `boolean` | no | no | 검색 UI의 제어형 열림 상태입니다. |
| `defaultOpen` | `boolean` | no | no | 비제어 검색 UI의 최초 열림 상태입니다. |
| `onOpenChange` | `(open: boolean, reason: BGridSearchOpenReason) => void` | no | no | 검색 또는 컨텍스트 메뉴의 열림 상태 변경을 알립니다. |
| `query` | `string` | no | no | 현재 정렬 및 필터 쿼리입니다. |
| `defaultQuery` | `string` | no | no | 비제어 검색 입력의 최초 검색어입니다. |
| `onQueryChange` | `(query: string) => void` | no | no | 사용자가 검색어 변경을 요청할 때 호출됩니다. |
| `getSearchText` | `(params: BGridSearchCellParams<T>) => unknown` | no | no | 렌더링된 DOM 대신 검색에 사용할 동기 문자열 값을 반환합니다. |
| `icons` | `BGridSearchIcons` | no | no | 컬럼 툴박스 아이콘을 교체합니다. |
| `labels` | `BGridSearchLabels` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridSortInfo

제어형 정렬 상태와 변경 콜백입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L351

```ts
export interface BGridSortInfo
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `multiSort` | `boolean` | no | no | 여러 컬럼 동시 정렬을 허용합니다. |
| `sortParams` | `BGridSortParam[]` | yes | no | 현재 적용된 정렬 조건 배열입니다. |
| `onChange` | `(sortParams: BGridSortParam[]) => void` | yes | no | 상태가 변경될 때 호출됩니다. |


### BGridSortParam

한 컬럼의 정렬 키와 방향입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L344

```ts
export interface BGridSortParam
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `columnId` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `key` | `string` | no | no | 행 값에서 읽을 필드 이름 또는 중첩 경로입니다. |
| `index` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `orderBy` | `'asc' \| 'desc'` | yes | no | 오름차순 또는 내림차순 방향입니다. |


### BGridToolboxConfig

컬럼별 정렬·필터 툴박스 기능과 사용자 UI를 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L471

```ts
export interface BGridToolboxConfig<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `sort` | `boolean` | no | no | 제어형 컬럼 정렬 상태를 설정합니다. |
| `filter` | `boolean` | no | no | 컬럼 필터의 사용 여부 또는 상세 설정입니다. |
| `icons` | `BGridToolboxIcons` | no | no | 컬럼 툴박스 아이콘을 교체합니다. |
| `extraItems` | `BGridToolboxItem<T>[]` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `render` | `React.FC<BGridToolboxRenderProps<T>>` | no | no | 셀 문맥으로 편집 아이콘 React 노드를 렌더링합니다. |


### BGridToolboxIcons

정렬·필터 툴박스의 아이콘을 교체하는 슬롯입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L426

```ts
export interface BGridToolboxIcons
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `sortAsc` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `sortDesc` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `filter` | `React.ReactNode` | no | no | 컬럼 필터의 사용 여부 또는 상세 설정입니다. |
| `filterBadge` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `dropdown` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `sortClear` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `hideColumn` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `showColumn` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columns` | `React.ReactNode` | no | no | 그리드에 표시할 컬럼 정의 배열입니다. |


### BGridToolboxItem

컬럼 툴박스에 추가할 사용자 작업 항목입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L412

```ts
export interface BGridToolboxItem<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `id` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `label` | `React.ReactNode` | yes | no | 화면에 표시할 제목입니다. |
| `disabled` | `boolean` | no | no | 해당 항목의 상호작용 비활성 여부입니다. |
| `onClick` | `(params: { column: BGridColumn<T>; columnId: string; columnIndex: number }) => void` | yes | no | 해당 셀 또는 아이콘의 클릭 상호작용이 발생할 때 호출됩니다. |


### BGridToolboxRenderProps

사용자 정의 컬럼 툴박스 렌더러에 전달되는 컨텍스트입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L419

```ts
export interface BGridToolboxRenderProps<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnId` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `close` | `() => void` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


## 선택과 편집

### BGridCellAddress

활성 셀의 절대 행·컬럼 인덱스를 나타냅니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L568

```ts
export interface BGridCellAddress
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `rowIndex` | `number` | yes | no | 데이터 배열 기준의 절대 행 인덱스입니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |


### BGridCellCommitController

변경 목록을 저장하거나 현재 편집 상호작용을 취소합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L55

```ts
export interface BGridCellCommitController<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `commit` | `(changes: readonly BGridCellValueChange<T>[], options?: BGridCommitOptions) => Promise<void>` | yes | no | 한 개 이상의 컬럼 변경 목록을 원자적으로 저장하고 편집을 종료합니다. |
| `cancel` | `() => void` | yes | no | 값을 저장하지 않고 편집을 종료합니다. |


### BGridCellEditorConfig

내장 text·checkbox 또는 plugin 편집기를 구분하는 컬럼 editor 설정입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L160

```ts
export type BGridCellEditorConfig<T> =
  | BGridTextEditorConfig<T>
  | BGridCheckboxEditorConfig<T>
  | BGridPluginEditorConfig<T>;
```


### BGridCellEditSession

현재 편집 셀과 시작 모드, 원래 값을 나타내는 편집 세션입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L685

```ts
export interface BGridCellEditSession extends BGridCellInteractionSessionBase
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `kind` | `'editor'` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `mode` | `'preserve' \| 'replace'` | yes | no | 쿼리를 수동 처리할지 클라이언트에서 처리할지 선택합니다. |
| `activation` | `BGridCellEditActivation` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `originalValue` | `unknown` | yes | no | 편집 시작 시점의 원래 셀 값입니다. |


### BGridCellMoveDirection

활성 셀을 이동할 키보드 방향과 경계 이동 종류입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L707

```ts
export type BGridCellMoveDirection =
  | 'up'
  | 'down'
  | 'left'
  | 'right'
  | 'home'
  | 'end'
  | 'pageUp'
  | 'pageDown'
  | 'first'
  | 'last'
  | 'next'
  | 'prev';
```


### BGridCellNavigationOptions

활성 셀의 제어 상태와 키보드 이동·편집·클릭 활성화 정책을 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L728

```ts
export interface BGridCellNavigationOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `enabled` | `boolean` | no | no | 기능 활성화 여부입니다. |
| `activeCell` | `BGridCellAddress` | no | no | 외부에서 제어하는 현재 활성 셀 주소입니다. |
| `defaultActiveCell` | `BGridCellAddress` | no | no | 비제어 모드의 초기 활성 셀 주소입니다. |
| `onActiveCellChange` | `(cell?: BGridCellAddress) => void` | no | no | 활성 셀 이동을 요청하거나 내부 활성 셀이 바뀔 때 호출됩니다. |
| `wrap` | `boolean` | no | no | 경계에서 반대쪽 셀로 순환할지 설정합니다. |
| `editOnEnter` | `boolean` | no | no | Enter 키로 활성 셀의 편집을 시작할지 설정합니다. 비활성화하면 onClick 콜백을 실행합니다. |
| `keyRepeat` | `{<br>    enabled?: boolean;<br>    interval?: number;<br>  }` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridCellSelectionCopyError

셀 복사 제한 또는 Clipboard API 오류 정보입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L750

```ts
export interface BGridCellSelectionCopyError
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `reason` | `BGridCellSelectionCopyErrorReason` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `actual` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `limit` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `selectedCellCount` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `maxClipboardCells` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `maxClipboardTextLength` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `error` | `unknown` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridCellSelectionCopyErrorReason

셀 복사가 실패한 원인을 구분하는 문자열 유니온입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L748

```ts
export type BGridCellSelectionCopyErrorReason = 'maxClipboardCells' | 'maxClipboardTextLength' | 'clipboardWriteFailed';
```


### BGridCellSelectionRange

셀 선택 영역의 시작과 끝 행·컬럼 인덱스입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L741

```ts
export interface BGridCellSelectionRange
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `startRowIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `startColumnIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `endRowIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `endColumnIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridCellValueChange

key 또는 columnId로 지정하는 한 컬럼의 변경 제안입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L39

```ts
export type BGridCellValueChange<T> =
  | {
      key: BGridColumn<T>['key'];
      columnId?: never;
      value: unknown;
    }
  | {
      columnId: string;
      key?: never;
      value: unknown;
    };
```


### BGridChangeValueParams

컬럼 onChangeValue에 전달되는 변경 제안, 행 범위 및 최종 commit controller입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L70

```ts
export interface BGridChangeValueParams<T> extends BGridCellCommitController<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `source` | `BGridEditSource` | yes | no | 편집 요청을 시작한 입력 경로입니다. |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `index` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `nextValues` | `T` | yes | no | 제안된 변경을 immutable하게 미리 적용한 행 값입니다. |
| `changes` | `readonly BGridCellValueChange<T>[]` | yes | no | key 또는 columnId로 식별한 컬럼 변경 목록입니다. |
| `rows` | `readonly BGridChangeValueRow<T>[]` | yes | no | 해당 컨텍스트의 행 목록 또는 피벗 행 축 필드 배열입니다. |


### BGridChangeValueRow

병합 셀 전파 대상 행과 변경 전후 값의 immutable preview입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L62

```ts
export interface BGridChangeValueRow<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `index` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `sourceIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `nextValues` | `T` | yes | no | 제안된 변경을 immutable하게 미리 적용한 행 값입니다. |


### BGridCheckboxEditorConfig

내장 checkbox의 값 매핑, 행별 비활성화와 헤더 일괄 제어를 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L123

```ts
export interface BGridCheckboxEditorConfig<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `type` | `'checkbox'` | yes | no | 판별 가능한 설정 또는 이벤트 종류입니다. |
| `trueValue` | `unknown` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `falseValue` | `unknown` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `header` | `boolean \| BGridCheckboxHeaderConfig` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `ariaLabel` | `string \| ((context: BGridCheckboxEditorContext<T>) => string)` | no | no | 편집 input 또는 아이콘의 접근 가능한 이름입니다. |
| `label` | `ReactNode \| ((context: BGridCheckboxEditorContext<T>) => ReactNode)` | no | no | 화면에 표시할 제목입니다. |
| `disabled` | `boolean \| ((context: BGridCheckboxEditorContext<T>) => boolean)` | no | no | 해당 항목의 상호작용 비활성 여부입니다. |


### BGridCheckboxEditorContext

checkbox의 접근성 이름, 라벨과 비활성화 함수에 전달되는 행·셀 컨텍스트입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L34

```ts
export interface BGridCheckboxEditorContext<T> extends BGridTextEditorContext<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `sourceIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `value` | `unknown` | yes | no | 현재 셀 또는 필터의 값입니다. |


### BGridCheckboxHeaderConfig

checkbox 컬럼 헤더의 접근성 이름과 일괄 제어 비활성화를 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L118

```ts
export interface BGridCheckboxHeaderConfig
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `ariaLabel` | `string` | no | no | 편집 input 또는 아이콘의 접근 가능한 이름입니다. |
| `disabled` | `boolean` | no | no | 해당 항목의 상호작용 비활성 여부입니다. |


### BGridCommitOptions

commit 완료 뒤 활성 셀 이동을 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L51

```ts
export interface BGridCommitOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `move` | `BGridCellMoveDirection` | no | no | 편집 세션에서 활성 셀 이동을 요청합니다. |


### BGridEditorIconClickHandler

아이콘 편집 세션을 실행하고 선택적으로 cleanup을 반환하는 callback입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L94

```ts
export type BGridEditorIconClickHandler<T> = (
  params: BGridEditorIconClickParams<T>,
) => void | (() => void) | Promise<void | (() => void)>;
```


### BGridEditorIconClickParams

editorIcon callback에 전달되는 셀 문맥과 commit controller입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L92

```ts
export interface BGridEditorIconClickParams<T> extends BGridEditorIconParams<T>, BGridCellCommitController<T>
```


### BGridEditorIconConfig

셀 값 옆 편집 아이콘의 모양, 표시 조건과 callback을 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L98

```ts
export interface BGridEditorIconConfig<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `render` | `React.ReactNode \| ((params: BGridEditorIconParams<T>) => React.ReactNode)` | yes | no | 셀 문맥으로 편집 아이콘 React 노드를 렌더링합니다. |
| `ariaLabel` | `string \| ((params: BGridEditorIconParams<T>) => string)` | no | no | 편집 input 또는 아이콘의 접근 가능한 이름입니다. |
| `visibility` | `'always' \| 'hover' \| 'active'` | no | no | 아이콘을 항상, hover 또는 활성 셀에서 표시할지 선택합니다. |
| `onClick` | `BGridEditorIconClickHandler<T>` | no | no | 해당 셀 또는 아이콘의 클릭 상호작용이 발생할 때 호출됩니다. |


### BGridEditorIconParams

editorIcon 렌더링에 전달되는 canonical 셀 문맥입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L82

```ts
export interface BGridEditorIconParams<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `index` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `value` | `unknown` | yes | no | 현재 셀 또는 필터의 값입니다. |
| `active` | `boolean` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridEditorPluginProps

에디터 플러그인 component에 전달되는 셀 문맥과 편집 수명주기 함수입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L136

```ts
export interface BGridEditorPluginProps<T> extends BGridTextEditorContext<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `sessionId` | `number` | yes | no | 현재 편집 세션의 고유 번호입니다. |
| `value` | `unknown` | yes | no | 현재 셀 또는 필터의 값입니다. |
| `mode` | `'preserve' \| 'replace'` | yes | no | 쿼리를 수동 처리할지 클라이언트에서 처리할지 선택합니다. |
| `activation` | `BGridCellEditActivation` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `commit` | `BGridCellCommitController<T>['commit']` | yes | no | 한 개 이상의 컬럼 변경 목록을 원자적으로 저장하고 편집을 종료합니다. |
| `cancel` | `BGridCellCommitController<T>['cancel']` | yes | no | 값을 저장하지 않고 편집을 종료합니다. |
| `move` | `(direction: BGridCellMoveDirection) => void` | yes | no | 편집 세션에서 활성 셀 이동을 요청합니다. |
| `getPortalContainer` | `() => HTMLElement` | yes | no | plugin popup을 연결할 Grid 전용 floating portal 컨테이너를 반환합니다. |


### BGridEditSource

변경 요청을 시작한 text, checkbox, plugin, itemRender 또는 아이콘 경로입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L60

```ts
export type BGridEditSource = 'text' | 'plugin' | 'checkbox' | 'itemRender' | 'editorIcon';
```


### BGridEditTrigger

셀 영역에서 편집을 시작할 클릭 또는 더블클릭 조건입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L5

```ts
export type BGridEditTrigger = 'click' | 'dblclick';
```


### BGridMoveActiveCellOptions

내부 셀 이동에서 범위 확장, 경계 이동과 페이지 크기를 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L721

```ts
export interface BGridMoveActiveCellOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `extendSelection` | `boolean` | no | no | 이동한 셀까지 현재 선택 범위를 확장합니다. |
| `toBoundary` | `boolean` | no | no | 인접 셀 대신 현재 방향의 경계로 이동합니다. |
| `pageSize` | `number` | no | no | 페이지 또는 PageUp/PageDown 이동 단위의 행 수입니다. |
| `selectionEnabled` | `boolean` | no | no | 이동과 함께 셀 선택 상태를 갱신할지 설정합니다. |


### BGridPluginEditorConfig

앱 전용 에디터 플러그인의 식별자와 component를 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L147

```ts
export interface BGridPluginEditorConfig<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `type` | `'plugin'` | yes | no | 판별 가능한 설정 또는 이벤트 종류입니다. |
| `id` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `component` | `React.ComponentType<BGridEditorPluginProps<T>>` | yes | no | 편집 상태에서 렌더링할 plugin component입니다. |
| `getClipboardText` | `(params: BGridCellClipboardTextParams<T>) => any` | no | no | 클립보드에 복사할 값을 반환합니다. |
| `parseClipboardText` | `(text: string, params: BGridCellClipboardParseParams<T>) => unknown` | no | no | 클립보드 문자열을 해당 컬럼에 저장할 셀 값으로 변환합니다. |


### BGridTextEditorConfig

내장 text 편집기의 직접 입력, blur와 값 변환 동작을 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L105

```ts
export interface BGridTextEditorConfig<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `type` | `'text'` | yes | no | 판별 가능한 설정 또는 이벤트 종류입니다. |
| `startOnInput` | `boolean` | no | no | 문자 입력으로 text 편집을 바로 시작할지 설정합니다. |
| `commitOnBlur` | `boolean` | no | no | text 편집기에서 포커스가 나갈 때 값을 저장할지 설정합니다. |
| `formatValue` | `(value: unknown, context: BGridTextEditorContext<T>) => string` | no | no | 셀 값을 text input 문자열로 변환합니다. |
| `parseValue` | `(text: string, context: BGridTextEditorContext<T>) => unknown` | no | no | 입력 문자열을 저장할 셀 값으로 변환합니다. |
| `ariaLabel` | `string \| ((context: BGridTextEditorContext<T>) => string)` | no | no | 편집 input 또는 아이콘의 접근 가능한 이름입니다. |
| `inputProps` | `Pick<<br>    React.InputHTMLAttributes<HTMLInputElement>,<br>    'placeholder' \| 'maxLength' \| 'inputMode' \| 'autoComplete' \| 'spellCheck'<br>  >` | no | no | 내장 text input에 전달할 안전한 HTML 속성입니다. |


### BGridTextEditorContext

text 편집기의 값 변환 함수에 전달되는 셀 컨텍스트입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L26

```ts
export interface BGridTextEditorContext<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `index` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `item` | `BGridDataItem<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `values` | `T` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


## 레이아웃과 표시

### BGridCellMergeColumn

지정 컬럼의 연속된 동일 값을 병합하는 기준입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L264

```ts
export interface BGridCellMergeColumn
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `wordWrap` | `boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `mergeBy` | `string \| string[]` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridColumnGroup

기존 인덱스 범위 방식의 2단 그룹 헤더를 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L247

```ts
export interface BGridColumnGroup
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `label` | `ReactNode` | yes | no | 화면에 표시할 제목입니다. |
| `groupStartIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `groupEndIndex` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `align` | `AlignDirection` | no | no | 본문 셀 콘텐츠의 가로 정렬입니다. |
| `headerAlign` | `AlignDirection` | no | no | 헤더 콘텐츠의 가로 정렬입니다. |


### BGridColumnGroupNode

컬럼 ID와 자식 그룹을 재귀적으로 구성하는 임의 깊이 그룹 헤더 노드입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L255

```ts
export interface BGridColumnGroupNode
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `id` | `string` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `label` | `ReactNode` | yes | no | 화면에 표시할 제목입니다. |
| `headerAlign` | `AlignDirection` | no | no | 헤더 콘텐츠의 가로 정렬입니다. |
| `className` | `string` | no | no | 요소에 추가할 CSS 클래스 이름입니다. |
| `headerStyle` | `React.CSSProperties` | no | no | 헤더 셀에 적용할 React 인라인 스타일입니다. |
| `children` | `Array<string \| BGridColumnGroupNode>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridHorizontalScrollbarOptions

Bottom Bar에 고정된 가로 스크롤바의 표시 여부와 스타일을 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L814

```ts
export interface BGridHorizontalScrollbarOptions extends BGridViewStyleProps
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `visible` | `boolean` | no | no | 해당 UI 영역의 표시 여부입니다. |


### BGridPaginationViewOptions

페이지네이션 표시 여부와 스타일을 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L810

```ts
export interface BGridPaginationViewOptions extends BGridViewStyleProps
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `visible` | `boolean` | no | no | 해당 UI 영역의 표시 여부입니다. |


### BGridScrollbarOptions

가로·세로 스크롤바 동작과 스타일 변형을 함께 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L822

```ts
export interface BGridScrollbarOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `variant` | `BGridScrollbarVariant` | no | no | 그리드 테두리 표현 변형을 선택합니다. |
| `horizontal` | `BGridHorizontalScrollbarOptions` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `vertical` | `BGridVerticalScrollbarOptions` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridScrollbarVariant

스크롤바 표현 방식을 선택합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L790

```ts
export type BGridScrollbarVariant = 'native' | 'classic' | 'modern';
```


### BGridScrollToRowOptions

행 스크롤의 정렬 위치를 설정합니다. 기본값은 nearest입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L843

```ts
export interface BGridScrollToRowOptions
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `align` | `'start' \| 'center' \| 'end' \| 'nearest'` | no | no | 본문 셀 콘텐츠의 가로 정렬입니다. |


### BGridStatusContent

상태 표시줄에 표시할 React 노드 또는 렌더 함수입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L798

```ts
export type BGridStatusContent = React.ReactNode | ((context: BGridStatusContext) => React.ReactNode);
```


### BGridStatusContext

상태 표시줄 콘텐츠 함수에 전달되는 데이터 개수 정보입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L792

```ts
export interface BGridStatusContext
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `totalItems` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `visibleItems` | `number` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `page` | `BGridPage` | no | no | 페이지 상태와 변경 콜백입니다. |


### BGridStatusOptions

상태 표시줄의 표시 여부, 콘텐츠 및 스타일을 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L805

```ts
export interface BGridStatusOptions extends BGridViewStyleProps
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `visible` | `boolean` | no | no | 해당 UI 영역의 표시 여부입니다. |
| `content` | `BGridStatusContent` | no | no | 표시할 콘텐츠 또는 렌더 함수입니다. |


### BGridSummaryColumn

요약 행의 대상 컬럼, 병합 범위 및 렌더러를 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L276

```ts
export interface BGridSummaryColumn<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `align` | `AlignDirection` | no | no | 본문 셀 콘텐츠의 가로 정렬입니다. |
| `colSpan` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `className` | `string` | no | no | 요소에 추가할 CSS 클래스 이름입니다. |
| `style` | `React.CSSProperties` | no | no | 요소에 추가할 React 인라인 스타일입니다. |
| `getClassName` | `(key: string \| string[]) => string` | no | no | 데이터에 따라 CSS 클래스 이름을 반환합니다. |
| `itemRender` | `(props: BGridSummaryItemRenderProps<T>) => React.ReactNode` | no | no | 셀 콘텐츠를 렌더링하는 React 컴포넌트입니다. |


### BGridSummaryItemRenderProps

요약 셀 렌더러에 전달되는 컬럼과 전체 데이터입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L269

```ts
export interface BGridSummaryItemRenderProps<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `column` | `BGridColumn<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnIndex` | `number` | yes | no | 컬럼 배열 기준의 절대 컬럼 인덱스입니다. |
| `rowIndex` | `number` | no | no | 데이터 배열 기준의 절대 행 인덱스입니다. |
| `data` | `BGridDataItem<T>[]` | yes | no | BGridDataItem으로 감싼 행 데이터 배열입니다. |


### BGridVerticalScrollbarOptions

세로 스크롤바의 표시 및 스타일을 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L818

```ts
export interface BGridVerticalScrollbarOptions extends BGridViewStyleProps
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `visible` | `boolean` | no | no | 해당 UI 영역의 표시 여부입니다. |


### BGridViewStyleProps

하위 표시 영역에 className과 인라인 style을 전달합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L800

```ts
export interface BGridViewStyleProps
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `className` | `string` | no | no | 요소에 추가할 CSS 클래스 이름입니다. |
| `style` | `React.CSSProperties` | no | no | 요소에 추가할 React 인라인 스타일입니다. |


## 순서 변경

### BGridReorderInfo

행 드래그 순서 변경의 활성화, 핸들 및 완료 콜백을 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L493

```ts
export interface BGridReorderInfo<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `enabled` | `boolean` | no | no | 기능 활성화 여부입니다. |
| `handleIcon` | `React.ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `onReorder` | `(data: BGridDataItem<T>[]) => void \| boolean` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridReorderingInfo

현재 드래그 중인 행의 출발 및 도착 인덱스입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L498

```ts
export interface BGridReorderingInfo
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `fromIndex` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `toIndex` | `number` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `phase` | `'dragging' \| 'settling' \| 'cancelling'` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `input` | `'pointer' \| 'keyboard'` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


## 피벗

### BGridPivotAggregate

기본 집계 방식 또는 사용자 정의 집계 함수입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L524

```ts
export type BGridPivotAggregate<T> =
  | 'sum'
  | 'count'
  | 'avg'
  | 'min'
  | 'max'
  | 'first'
  | ((params: BGridPivotAggregateParams<T>) => any);
```


### BGridPivotAggregateParams

사용자 정의 피벗 집계 함수에 전달되는 값과 원본 행입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L516

```ts
export interface BGridPivotAggregateParams<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `values` | `any[]` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `items` | `BGridDataItem<T>[]` | yes | no | 대상 셀 문맥으로 컨텍스트 메뉴 항목을 만듭니다. |
| `rowValues` | `any[]` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnValues` | `any[]` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `value` | `BGridPivotValue<T>` | yes | no | 현재 셀 또는 필터의 값입니다. |


### BGridPivotField

피벗 행·컬럼 축에서 사용할 필드를 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L505

```ts
export interface BGridPivotField
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `key` | `string \| string[]` | yes | no | 행 값에서 읽을 필드 이름 또는 중첩 경로입니다. |
| `label` | `ReactNode` | no | no | 화면에 표시할 제목입니다. |
| `width` | `number` | no | no | 그리드 또는 해당 항목의 너비입니다. |
| `align` | `AlignDirection` | no | no | 본문 셀 콘텐츠의 가로 정렬입니다. |
| `headerAlign` | `AlignDirection` | no | no | 헤더 콘텐츠의 가로 정렬입니다. |
| `className` | `string` | no | no | 요소에 추가할 CSS 클래스 이름입니다. |
| `headerClassName` | `string` | no | no | 헤더 셀에 추가할 CSS 클래스 이름입니다. |
| `headerStyle` | `React.CSSProperties` | no | no | 헤더 셀에 적용할 React 인라인 스타일입니다. |


### BGridPivotOptions

피벗의 행 축, 컬럼 축, 값 및 빈 값 표시를 설정합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L559

```ts
export interface BGridPivotOptions<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `enabled` | `boolean` | no | no | 기능 활성화 여부입니다. |
| `rows` | `BGridPivotField[]` | yes | no | 해당 컨텍스트의 행 목록 또는 피벗 행 축 필드 배열입니다. |
| `columns` | `BGridPivotField[]` | yes | no | 그리드에 표시할 컬럼 정의 배열입니다. |
| `values` | `BGridPivotValue<T>[]` | yes | no | 원본 행 값 또는 집계 대상 값입니다. |
| `columnLabelSeparator` | `string` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `emptyValue` | `ReactNode` | no | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridPivotValue

피벗 값 영역의 집계와 셀 표시 방식을 정의합니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L533

```ts
export interface BGridPivotValue<T> extends BGridPivotField
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `aggregate` | `BGridPivotAggregate<T>` | no | no | 피벗 집계 방식 또는 사용자 집계 함수입니다. |
| `itemRender` | `React.FC<BGridPivotValueItemRenderProps<T>>` | no | no | 셀 콘텐츠를 렌더링하는 React 컴포넌트입니다. |
| `getClipboardText` | `(params: BGridPivotValueClipboardTextParams<T>) => any` | no | no | 클립보드에 복사할 값을 반환합니다. |


### BGridPivotValueClipboardTextParams

피벗 값 셀을 복사할 때 전달되는 전체 컨텍스트입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L553

```ts
export interface BGridPivotValueClipboardTextParams<T> extends Omit<BGridCellClipboardTextParams<Record<string, any>>, 'column'>,
    BGridPivotValueContext<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `column` | `BGridColumn<Record<string, any>>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |


### BGridPivotValueContext

피벗 결과 셀의 원본 데이터 및 축 컨텍스트입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L539

```ts
export interface BGridPivotValueContext<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `sourceItems` | `BGridDataItem<T>[]` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `rowValues` | `any[]` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `columnValues` | `any[]` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `pivotValue` | `BGridPivotValue<T>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |
| `aggregate` | `BGridPivotAggregate<T>` | no | no | 피벗 집계 방식 또는 사용자 집계 함수입니다. |


### BGridPivotValueItemRenderProps

피벗 값 셀 렌더러에 전달되는 전체 컨텍스트입니다.

Source: https://github.com/axisj/beautiful-grid/blob/main/beautiful-grid/types.ts#L547

```ts
export interface BGridPivotValueItemRenderProps<T> extends Omit<BGridItemRenderProps<Record<string, any>>, 'column'>,
    BGridPivotValueContext<T>
```

| Member | Type | Required | Deprecated | Description |
| --- | --- | --- | --- | --- |
| `column` | `BGridColumn<Record<string, any>>` | yes | no | 타입 시그니처와 연결된 인터페이스를 기준으로 값을 설정합니다. |