# SFilePicker

> 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.

### SFilePicker

#### Props

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `value?` | `SFilePickerValue` | `null` |  |
| `placeholder?` | `string` | `'Click to upload'` |  |
| `disabled?` | `boolean` | `false` |  |
| `focused?` | `boolean` | `false` | 포커스 상태 여부 |
| `hovered?` | `boolean` | `false` | 호버 상태 여부 |
| `inline?` | `boolean` | `false` | 인라인 표시 — SField 테두리 박스만 사라지고 label/rules/hint 는 그대로 동작 |
| `multiple?` | `boolean` | `false` |  |
| `useMultipleListBox?` | `boolean` | `false` | multiple 파일 목록을 필드 아래 칩 대신, caret(▼) 클릭 시 열리는 리스트박스 카드로 표시 (바깥 클릭 시 닫힘) |
| `accept?` | `string` | — |  |
| `maxFileSize?` | `number \| string` | — |  |
| `maxTotalSize?` | `number \| string` | — |  |
| `maxFiles?` | `number \| string` | — |  |
| `name?` | `string` | — |  |
| `rules?` | `Rule[]` | — |  |
| `status?` | `SFieldStatus` | — |  |
| `size?` | `SFieldSize` | `'sm'` |  |
| `label?` | `string` | — |  |
| `labelWidth?` | `number \| string` | — |  |
| `icon?` | `SIconName` | — |  |
| `iconColor?` | `SColor` | — |  |
| `labelTooltip?` | `string` | — |  |
| `labelTooltipProps?` | `Partial<STooltipProps>` | — |  |
| `addonLabel?` | `string` | — |  |
| `addonAlign?` | `SFieldAddonAlign` | `'start'` |  |
| `hint?` | `string` | — |  |
| `error?` | `boolean` | — |  |
| `errorMessage?` | `string` | — |  |
| `width?` | `number \| string` | — |  |
| `className?` | `string` | — |  |
| `style?` | `CSSProperties` | — |  |

#### Events

| Event | Type | Description |
|-------|------|-------------|
| `onValueChange` | `(value: SFilePickerValue) => void` | 파일 변경 (sdUpdate) |
| `onReject` | `(detail: { files: File[]; reason: SFilePickerRejectReason }) => void` | 제한 초과 거부 (sdReject) |

## Dependencies

### Used by

 - [SKeyValueTable](../SKeyValueTable)

### Depends on

- [SChip](../SChip)
- [SField](../SField)
- [SGhostButton](../SGhostButton)
- [SIcon](../SIcon)

### Graph

```mermaid
graph TD;
  SFilePicker --> SChip
  SFilePicker --> SField
  SFilePicker --> SGhostButton
  SFilePicker --> SIcon
  SKeyValueTable --> SFilePicker
  style SFilePicker fill:#f9f,stroke:#333,stroke-width:4px
```