From 27da6d8d53ff427208b820c4787e5e3041a08e81 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 18:36:24 +0900 Subject: [PATCH] =?UTF-8?q?docs(styling):=20=ED=86=A0=ED=81=B0=20=EB=AC=B8?= =?UTF-8?q?=EC=84=9C=EA=B0=80=20primitive=20=EB=AA=A9=EB=A1=9D=EC=9D=84=20?= =?UTF-8?q?=EC=86=90=EC=9C=BC=EB=A1=9C=20=EB=93=A4=EC=A7=80=20=EC=95=8A?= =?UTF-8?q?=EA=B3=A0=20=EB=B0=B0=EB=9F=B4=EA=B3=BC=20story=EB=A5=BC=20?= =?UTF-8?q?=EA=B0=80=EB=A6=AC=ED=82=A8=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `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 --- docs/styling/design-tokens.md | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) 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) 정책: