릴리즈 노트
MAJOR(v4→v5)는 기존 값이 바뀌거나 삭제된 것 — 마이그레이션이 필요합니다. MINOR(v5.0→v5.1)는 추가만 된 것 — 그대로 두면 됩니다.
v5.0 — 2026-08 (현재) · MAJOR
v4.0의 문제는 값이 틀린 게 아니라 좁았던 것이었습니다. 실제 앱에 얹으면 글씨가 작고, 레이아웃 선택지가 하나뿐이고, 로고 위치가 묶여 화면이 깨졌습니다. v5.0은 “규칙은 줄이고 선택지는 넓히되, 안전장치는 토큰과 코드로 강제” 하는 방향으로 개정했습니다.
| # | 바뀐 것 | 왜 |
|---|---|---|
| 1 | 본문 기준 14px → 16px | 브라우저·프레임워크 기본값과 일치. v4.0 §2-2가 경고하던 “기준 크기 충돌”이 근본 소멸 |
| 2 | 타입 세트 2벌 (Productive 12~32 / Expressive 40·48·56) | 업무도구와 브랜드 페이지는 필요한 크기가 다름. 시스템은 하나로 유지 (IBM Carbon 방식) |
| 3 | 컨테이너 4종 (720 / 1200 / 1440 / full) | 단일 1200px 강제가 문서형·대시보드형 화면을 동시에 못 담았음 |
| 4 | 로고 규격 완화 — 최소 크기·최소 여백·무결성 3개만 규칙 | 위치·크기 강제가 히어로·표지 디자인을 막고 있었음 |
| 5 | 웹폰트 로드를 토큰 파일에 내장 | 각 HTML에 손으로 <link>를 복붙하던 구조 → 빠뜨린 곳은 폰트가 안 실렸음(개발자센터가 그 사례) |
| 6 | 폰트 조합 확정 — 본문 Pretendard 단독 / 숫자·영문대형 Figtree | Pretendard 라틴이 Inter 파생이라 영문 폰트 중복. 본문에 Figtree를 섞으면 베트남어에서 폰트가 갈림 |
| 7 | 0단계 토큰 층 보강 — z-index·상호작용 상태·포커스·아이콘 크기·딤 4단계·품질 판정색 | 값이 없으면 개발자가 지어내고, 그 순간 어긋남이 시작됨 |
| 8 | 컴포넌트 층 신설 — jt-utilities.css Tier 1(12종) + Tier 2(12종) | “이렇게 생기면 된다”는 설명만으로는 앱마다 다르게 구현됨 |
| 9 | 컴포넌트 계약 명문화 | 복잡한 앱이 시스템을 포크하지 않고도 필요한 조정을 할 수 있는 통로 |
| 10 | 다국어 견고성 5건 | keep-all :lang(ko) 한정 · 전역 안전망 · 태국/인도계 폰트 스택 · 텍스트 팽창 규칙 · 행간 안전 |
| 11 | 접근성 강화 | 대체 텍스트 규칙 · 터치 타깃 토큰화 · 고대비 모드 · tertiary 텍스트 사용 금지 |
| 12 | 모바일 하단 탭바 | 모바일 주요 메뉴는 상단이 아니라 엄지 닿는 하단 |
| 13 | 결정로그 운영 개시 | 대화에서 나온 결정이 파일에 반영되지 않아 어긋나던 근본 원인 차단 (§17-7) |
마이그레이션 요약: v5.0은 이름은 그대로 두고 값이 바뀐 토큰이 많습니다. 따라서 찾아 바꾸기가 아니라 파일 교체 + 화면 확인이 방법입니다. 상세는 §17-6.
전체 변경 이력
| 버전 | 일자 | 변경 | 구분 |
|---|---|---|---|
| v5.0 | 2026-08 | 본문 기준 14→16px 전환 · 타입 세트 2벌 신설(Productive 12~32 / Expressive 40·48·56) · 폰트 조합 확정(본문 Pretendard 단독 / 숫자·영문대형 Figtree / Inter·Noto Sans 제외) · 웹폰트 로드를 토큰 파일에 내장 · 컨테이너 4종 · 로고 규격 완화(최소값만 규칙화) · 0단계 토큰 보강(z-index·상호작용 상태·포커스·아이콘 크기·딤 4단계·품질 판정 4종·고대비) · jt-utilities.css 신설(Tier 1·2·3 컴포넌트 47종, Carbon 40종 전수 대조) · 컴포넌트 계약 명문화 · 아이콘 정책 확정(Material Symbols Rounded, SVG mask 병행, display=block) · 모바일 하단 탭바 · 대체 텍스트 규칙 · 다국어 견고성 5건 · purple·teal 팔레트 8단계 통일 · --fs-2xs 폐기 예정 · 결정로그 운영 개시 | MAJOR |
| v4.0 | 2026-08 | MASTER_v3.0 + Foundation_v1.0 통합. 값 충돌 4건 확정 · §2 안전 적용 규칙 신설 | MAJOR |
| v3.0 | 2026-08 | Seed→Map→Alias 3계층 아키텍처 도입 | MAJOR |
| v2.0 | 2026-07 | MUST/SHOULD 강제 수준 체계 | MAJOR |
| v1.0 | 2026-07 | 최초 — 9색 팔레트·다국어 폰트 | — |
다음 버전 예정
| 항목 | 언제 |
|---|---|
--fs-2xs 제거 | v6.0 — 현재 @deprecated. --fs-xs(12px)를 쓰세요 |
| CI 문서 폰트 스택을 토큰 참조로 교체 | 다음 CI 개정 (미해소 충돌 C2·C3) |
| 개발자센터 Phase 2·3 | 컴포넌트 개별 페이지 · 디자인 킷 · 패턴 |