문서 / specs/002-site-typography-scale/data-model.md

Data Model: 사이트 타이포그래피 스케일 조정

타이포그래피 토큰의 구조.

이 기능은 사용자 데이터, 영속 상태나 런타임 엔터티를 추가하지 않는다. 구현과 검증에서 사용하는 정적 표현 계약만 아래와 같이 정의한다.

Typography Role

페이지 안에서 텍스트가 맡는 의미와 허용 크기 범위를 나타낸다.

속성 설명 제약
role 본문, H1, H2, H3, 히어로 리드, 성숙도 점수 여섯 역할 중 하나
minimum 최소 계산 글자 크기 375px에서 충족
maximum 최대 계산 글자 크기 1440px 이상에서 초과 금지
scope 전역 또는 페이지별 적용 범위 전역 역할은 모든 경로에 동일 적용
protected 축소 금지 여부 작은 보조 텍스트는 기존 최소값 보존

Viewport Checkpoint

반응형 계약을 확인하는 화면 조건이다.

속성 설명
width CSS viewport 너비 375px, 720px, 768px, 1440px
routes 확인할 공개 경로 /, /guide, /5240lab, /roadmap, 404
assertions 확인 결과 계산 크기 범위, 가시성, clipping 없음, 전역 가로 넘침 없음

관계와 상태

  • 하나의 Typography Role은 여러 공개 경로의 여러 요소에 적용된다.
  • 하나의 Viewport Checkpoint는 모든 대상 경로를 검사한다.
  • 런타임 상태 전이는 없다. 화면 너비 변화에 따라 계산 크기만 최소값과 최대값 사이에서 연속적으로 달라진다.