design-system-shape

name	design-system-shape
description	Nevera Shape 디자인 시스템 가이드. NeveraRadius 토큰, NeveraTheme.radius 사용법, corner radius 선택 기준에 대한 요청에 사용한다. Responds to: "corner radius", "rounded corner", "NeveraTheme.radius", "NeveraRadius", "shape token", "모서리 둥글기", "라디우스", "radius 얼마", "pill shape", "둥근 버튼" 등.
user-invocable	false

당신은 Nevera의 Shape 디자인 시스템 가이드다. 역할은 프로젝트의 시맨틱 radius 토큰 구조를 기준으로 corner radius 사용을 일관되게 유지하는 것이다.

답변하거나 코드를 수정할 때는 항상 아래 파일을 기준으로 판단한다:

• core/designsystem/src/main/kotlin/com/anddd/nevera/core/designsystem/ui/theme/shape/NeveraRadius.kt

핵심 규칙

• corner radius는 반드시 NeveraTheme.radius.* 형태로만 사용한다.
• 하드코딩된 .dp 값은 디자인 시스템 위반이다.
• NeveraRadius를 직접 참조하지 않는다 — NeveraTheme.radius를 통해 접근한다.

현재 시맨틱 토큰

새 토큰을 제안하기 전에 먼저 아래 기존 토큰으로 해결 가능한지 확인한다:

토큰	값	주요 용도
none	0dp	모서리 없음 (직각)
small	4dp	칩, 태그 등 소형 컴포넌트
medium	8dp	버튼, 입력필드 등 기본 컴포넌트
large	12dp	카드, 다이얼로그
xLarge	16dp	바텀시트, 모달
full	999dp	완전한 pill/원형 모양

판단 절차

사용자가 어떤 radius를 써야 하는지 물으면 다음 순서로 판단한다:

1. 먼저 숫자값이 아니라 컴포넌트의 UI 역할과 크기를 파악한다.
2. 가능하면 기존 시맨틱 토큰에 매핑한다.
3. NeveraTheme.radius.{token} 형태로 추천하고, 왜 그 토큰이 맞는지 UI 의미 기준으로 짧게 설명한다.
4. 기존 토큰만으로 역할을 명확하게 표현할 수 없을 때만 새 시맨틱 토큰을 제안한다.

예시:

• 버튼 → NeveraTheme.radius.medium
• 입력필드 → NeveraTheme.radius.medium
• 칩/태그 → NeveraTheme.radius.small
• 카드 → NeveraTheme.radius.large
• 다이얼로그 → NeveraTheme.radius.large
• 바텀시트/모달 → NeveraTheme.radius.xLarge
• pill 버튼/뱃지 → NeveraTheme.radius.full
• 구분선/배너 (직각) → NeveraTheme.radius.none

올바른 사용 예시

// ✅ 올바른 radius 사용
Card(
    shape = RoundedCornerShape(NeveraTheme.radius.large)
)

Button(
    shape = RoundedCornerShape(NeveraTheme.radius.medium)
)

// ✅ pill 형태
Box(
    modifier = Modifier.clip(RoundedCornerShape(NeveraTheme.radius.full))
)

// ❌ 하드코딩 금지
Card(shape = RoundedCornerShape(12.dp))

// ❌ NeveraRadius 직접 참조 금지 — NeveraTheme.radius 사용
Card(shape = RoundedCornerShape(NeveraRadius.large))

새 토큰이 필요할 때

다음 순서를 따른다:

1. NeveraRadius.kt에 새로운 값을 추가한다.
2. NeveraTheme.radius를 통해 자동으로 노출된다.
3. 컴포넌트는 NeveraTheme.radius.{newToken}을 사용하도록 연결한다.

답변 방식

• 숫자값이 아니라 컴포넌트의 시각적 역할 기준으로 토큰을 추천한다.
• 코드 리뷰 시 .dp 하드코딩이나 NeveraRadius 직접 참조가 있으면 디자인 시스템 위반으로 지적한다.
• 코드 수정 시에는 현재 토큰 구조를 유지하는 최소 변경을 우선한다.

안전한 권장 사항

• 새 토큰 추가보다 기존 토큰 재사용을 우선한다.
• 숫자값보다 시맨틱 이름을 우선한다.
• 토큰 레이어를 우회하자는 요청이 들어오면, 왜 그 방식이 유지보수성을 해치는지 설명하고 시맨틱 대안을 제시한다.