# FE 표준 컴포넌트·Provider Adapter v2

## 의존 방향

`Feature → Ks Component → UiAdapter contract → Provider implementation`

Feature가 허용받는 import 경계:

- `@/shared/ui/components`
- `@/shared/ui/layouts`
- `@/shared/ui/screen-types`

금지: Feature의 `primevue/*`, `ag-grid-*` 직접 import.

## Adapter v2

필수 capability는 Button, TextField, TextArea, Select, Checkbox, DateField, NumberField, Dialog, StatusTag, DataGrid 10종이다. 공급자는 contractVersion `2.0`과 capability set을 제공하며 bootstrap에서 누락을 fail-fast한다.

- `primevue-aggrid`: 생산 후보
- `native-accessible`: 교체 가능성·계약 검증용 reference, 생산 비적격

교체는 환경변수 `VITE_UI_ADAPTER`와 provider resolver에서 수행한다. Feature 수정은 허용하지 않는다.

## 승격 규칙

공통 컴포넌트는 3회 반복만으로 승격하지 않는다. 의미, 실패 상태, 접근성, 변경축이 같아야 한다. 단순히 markup이 비슷하다는 이유로 공통화하지 않는다.

## 공급자 교체 Gate

1. Adapter contract test
2. 키보드·landmark·label 접근성
3. 화면 상태별 visual regression
4. T01~T10 상태 matrix
5. 대량목록 성능
6. 보안·라이선스 검토