docs(styling): 토큰 문서가 primitive 목록을 손으로 들지 않고 배럴과 story를 가리킨다
`docs/styling/design-tokens.md` 「들어 있는 primitive」가 Button·TextField· Card·Alert/Badge·Dialog·상태 surface 여섯만 적는다. 실제 배럴에는 primitive 25개, pattern 5개, 페이지 템플릿, 폼 구성요소가 있고, 문서는 스스로 "지금 구현된 primitive 기준선을 적는다"고 한다. fe-a11y 스킬이 이 절을 근거로 든다. 고른 방법: 손 목록을 지우고 정본(배럴 `index.ts`)과 상태를 여는 곳(갤러리· 카탈로그 story), 대조 시험을 가리킨다. 목록이 들고 있던 약속(색에만 기대지 않음, tooltip에만 두지 않음, overlay의 Escape·focus 복원)은 문장으로 남긴다. fe-a11y 스킬이 이 절을 인용하므로 절 제목은 그대로 둔다. 검증: 노트북 `scripts/verify.sh docs`, desktop `verify:documentation`(PR 본문). Refs: 1112/04-16
This commit is contained in:
@@ -70,14 +70,21 @@ component는 `--color-panel`, `--color-content`, `--color-border`,
|
||||
|
||||
## 들어 있는 primitive
|
||||
|
||||
- `Button`: primary, secondary, danger, ghost 의도
|
||||
- `TextField`: label, 도움말, 필수 상태, 연결된 검증 오류
|
||||
- `Card`: 이름이 붙은 surface와 선택적 footer
|
||||
- `Alert`와 `Badge`: 색에만 기대지 않는 status 피드백
|
||||
- `Dialog`: native modal 의미, Escape·backdrop으로 닫기, 닫은 뒤 trigger로 focus
|
||||
되돌리기
|
||||
- 비동기·접근 상태 surface: 로딩, 새로고침, 빈 상태, 끝난(terminal) 오류, 인증
|
||||
필요, 권한 없음, 찾을 수 없음
|
||||
primitive·pattern·페이지 템플릿·폼 구성요소의 목록은 공개 배럴
|
||||
`src/presentation/design-system/index.ts`가 정본이다. 이 문서는 목록을 손으로
|
||||
들지 않는다. 컴포넌트의 상태는 story에서 연다: 갤러리
|
||||
`src/presentation/design-system/galleries.stories.tsx`(primitive를 함께, 화면
|
||||
상태), 카탈로그 `src/presentation/design-system/catalog.stories.tsx`(나머지를
|
||||
묶음마다). 배럴의 화면 컴포넌트마다 story가 있는지는
|
||||
`tests/unit/design-system-story-coverage.test.ts`가 대조한다.
|
||||
|
||||
모든 primitive가 지키는 약속:
|
||||
|
||||
- status 피드백(`Alert`, `Badge`, 상태 surface)은 색에만 기대지 않는다. 글자와
|
||||
아이콘이 같은 뜻을 전한다.
|
||||
- 필요한 정보를 tooltip에만 두지 않는다.
|
||||
- overlay(`Dialog`, `Drawer`, `ConfirmationDialog`)는 native modal 의미를 쓰고,
|
||||
Escape로 닫고, 닫은 뒤 연 곳으로 focus를 돌린다.
|
||||
|
||||
임의 값(arbitrary value) 정책:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user