diff --git a/docs/styling/design-tokens.md b/docs/styling/design-tokens.md index 3af33c92..5ba8f92b 100644 --- a/docs/styling/design-tokens.md +++ b/docs/styling/design-tokens.md @@ -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) 정책: