# SChipInput

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

### SChipInput

#### Props

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `values?` | `string[]` | `[]` | 칩 값 목록 |
| `errors?` | `boolean[] \| ((value: string) => boolean)` | `[]` | 칩별 에러 (배열 또는 판별 함수) |
| `disabledChips?` | `boolean[] \| ((value: string) => boolean)` | `[]` | 칩별 비활성 (배열 또는 판별 함수) |
| `size?` | `SChipInputSize` | `'sm'` |  |
| `disabled?` | `boolean` | `false` |  |
| `placeholder?` | `string` | `'태그 입력 (Enter로 등록 / 콤마로 구분 / 띄어쓰기 불가)'` |  |
| `name?` | `string` | — |  |
| `rules?` | `Rule[]` | — |  |
| `error?` | `boolean` | — |  |
| `useReset?` | `boolean` | `false` | 입력 초기화 버튼 표시 |
| `maxCount?` | `number` | — | 최대 칩 개수 |
| `metaPlacement?` | `SChipInputMetaPlacement` | `'end'` | 최대 개수·초기화 meta 위치 |
| `duplicateLabel?` | `string` | — | 중복 에러 메시지 항목명 |
| `suggestions?` | `string[]` | `[]` | 자동완성 후보 |
| `loadingSuggestions?` | `boolean` | `false` |  |
| `recommendedItems?` | `string[]` | `[]` | 추천 항목 (입력값 없을 때) |
| `loadingRecommendedItems?` | `boolean` | `false` |  |
| `dropdownMinWidth?` | `number \| string` | `200` | 드롭다운 최소 너비 (숫자=px) |
| `label?` | `string` | — |  |
| `labelWidth?` | `number \| string` | — |  |
| `hint?` | `string` | — |  |
| `errorMessage?` | `string` | — |  |
| `width?` | `number \| string` | — |  |
| `status?` | `SFieldStatus` | — |  |
| `icon?` | `SIconName` | — |  |
| `iconColor?` | `SColor` | — |  |
| `labelTooltip?` | `string` | — |  |
| `labelTooltipProps?` | `Partial<STooltipProps>` | — |  |
| `className?` | `string` | — |  |
| `style?` | `CSSProperties` | — |  |

#### Events

| Event | Type | Description |
|-------|------|-------------|
| `onValueChange` | `(values: string[]) => void` | 값 변경 (sdUpdate) — 전체 배열 |
| `onInput` | `(value: string) => void` | 입력 중 문자열 변경 (sdInput) |
| `onFocus` | `() => void` |  |
| `onBlur` | `() => void` |  |

#### Methods (ref)

| Method | Type | Description |
|--------|------|-------------|
| `focus` | `() => void` | 입력 필드에 포커스를 이동합니다. |

## Dependencies

### Depends on

- [SChip](../SChip)
- [SField](../SField)
- [SIcon](../SIcon)
- [SPortal](../SPortal)
- [STextLink](../STextLink)

### Graph

```mermaid
graph TD;
  SChipInput --> SChip
  SChipInput --> SField
  SChipInput --> SIcon
  SChipInput --> SPortal
  SChipInput --> STextLink
  style SChipInput fill:#f9f,stroke:#333,stroke-width:4px
```