/* =========================================================================
   tokens.css — 디자인 토큰
   -------------------------------------------------------------------------
   사이트 전체의 색, 폰트, 크기, 간격을 "변수"로 한곳에 모아둔 파일.
   다른 CSS 파일은 여기 값을 var(--이름) 으로 가져다 쓰기만 한다.
   → 색이나 간격을 바꾸고 싶으면 이 파일만 고치면 됨.

   구조
   1) :root            라이트 모드(기본값) + 크기/간격
   2) @media (dark)    OS가 다크모드일 때 "색 토큰만" 덮어씀

   ── 단위 원칙 ────────────────────────────────────────────────────────────
   - 크기·간격은 전부 rem (1rem = 브라우저 기본 글자 크기, 보통 16px).
     사용자가 브라우저 글자 크기를 키우면 레이아웃도 같이 커짐.
   - 예외: 1px 구분선(border)과 2px 포커스 링만 px. 화면 크기와 상관없이
     "가장 얇은 선"이어야 하는 값이라서.

   ── 유동 값 clamp(최소, 선호, 최대) 읽는 법 ───────────────────────────────
   clamp(1.25rem, 5vw, 5rem)
         └ 최소 20px  └ 화면 폭의 5%  └ 최대 80px
   → 320px 화면: 5vw=16px라 최소값 20px 사용
   → 1000px 화면: 50px
   → 1600px 이상: 최대값 80px 고정

   글자 크기는 "rem + vw" 조합으로 씀 (예: 1.5rem + 3vw).
   vw만 쓰면 브라우저 확대(⌘+)를 해도 글자가 안 커져서 접근성 문제가 생김.
   ========================================================================= */

:root {
  /* ---- Color : 라이트 ------------------------------------------------- */
  --color-bg:          #fbfbfa;  /* 페이지 배경 */
  --color-surface:     #ffffff;  /* 카드 등 한 단계 올라온 면 */
  --color-text:        #17171a;  /* 본문 */
  --color-text-muted:  #5e5e66;  /* 보조 텍스트 (대비 4.5:1 이상 유지) */
  --color-border:      #e4e4e0;  /* 구분선, 카드 테두리 */
  --color-accent:      #2f5bea;  /* 링크, 강조 */
  --color-accent-text: #ffffff;  /* accent 배경 위에 올라가는 글자 */
  --color-focus:       #2f5bea;  /* 키보드 포커스 링 */
  --color-code-bg:     #f1f1ee;  /* 코드 블록 배경 */

  color-scheme: light;           /* 스크롤바·폼 등 브라우저 UI도 라이트로 */

  /* ---- Typography : 폰트 ---------------------------------------------- */
  /* 시스템 폰트 우선 → Pretendard(설치돼 있으면) → 한글 시스템 폰트 → 기본.
     외부에서 폰트를 불러오지 않으므로 네트워크 의존 없음. */
  --font-sans:
    -apple-system, BlinkMacSystemFont, system-ui,
    "Pretendard", "Pretendard Variable",
    "Apple SD Gothic Neo", "Malgun Gothic", "Noto Sans KR",
    "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
  --font-mono: ui-monospace, "SF Mono", Menlo, Consolas, monospace;

  /* ---- Typography : 크기 (320px → 1536px 사이에서 부드럽게 커짐) ------- */
  --text-sm:   0.875rem;                                  /* 14px 고정 — 캡션, 메타 */
  --text-base: clamp(1rem, 0.95rem + 0.2vw, 1.125rem);    /* 16 → 18px  본문 */
  --text-lg:   clamp(1.0625rem, 1rem + 0.3vw, 1.25rem);   /* 17 → 20px  카드 제목 */
  --text-xl:   clamp(1.25rem, 1.1rem + 0.6vw, 1.625rem);  /* 20 → 26px  리드 문장 */
  --text-2xl:  clamp(1.5rem, 1.15rem + 1.6vw, 2.5rem);    /* 24 → 40px  이메일 */
  --text-hero: clamp(2.5rem, 1.5rem + 5vw, 5.5rem);       /* 40 → 88px  이름 (h1) */

  --leading-tight: 1.15;  /* 제목용 줄간격 */
  --leading-snug:  1.5;   /* 리드 문장 */
  --leading-body:  1.7;   /* 본문 (한글은 넉넉하게) */

  --weight-regular: 400;
  --weight-medium:  500;
  --weight-bold:    700;

  /* 본문 한 줄 최대 길이. 이보다 길면 읽기 피곤함.
     (ch = 숫자 "0"의 폭. 한글은 대략 1글자 ≈ 2ch → 65ch ≈ 한글 32~35자) */
  --measure: 65ch;
  --measure-narrow: 36ch;  /* 리드 문장, Hero 소개처럼 큰 글씨 */

  /* ---- Spacing (4px 기반, 고정 간격) --------------------------------- */
  --space-1:  0.25rem;  /*  4 */
  --space-2:  0.5rem;   /*  8 */
  --space-3:  0.75rem;  /* 12 */
  --space-4:  1rem;     /* 16 */
  --space-6:  1.5rem;   /* 24 */
  --space-8:  2rem;     /* 32 */
  --space-12: 3rem;     /* 48 */
  --space-16: 4rem;     /* 64 */

  /* ---- Spacing (유동 간격) ------------------------------------------- */
  --space-section: clamp(4rem, 2.5rem + 6vw, 10rem);  /* 섹션 사이 세로 여백: 64 → 160px */
  --space-hero-top: clamp(4.5rem, 2rem + 11vw, 12rem); /* Hero 위쪽 여백: 72 → 192px */
  --gap-grid: clamp(2rem, 1.25rem + 2.5vw, 3.5rem);   /* 카드 그리드 간격: 32 → 56px */

  /* ---- Layout -------------------------------------------------------- */
  --container-max: 75rem;                 /* 콘텐츠 최대 폭 1200px (여백 제외) */
  --gutter: clamp(1.25rem, 5vw, 5rem);    /* 화면 좌우 여백: 20 → 80px */
  --header-height: 3.5rem;                /* 헤더 높이 56px (노치 영역 제외) */

  /* 노치·홈바 영역. iPhone 등에서만 값이 생기고 나머지 기기는 0.
     viewport-fit=cover (index.html 메타태그)가 있어야 동작함. */
  --safe-top:    env(safe-area-inset-top, 0rem);
  --safe-right:  env(safe-area-inset-right, 0rem);
  --safe-bottom: env(safe-area-inset-bottom, 0rem);
  --safe-left:   env(safe-area-inset-left, 0rem);

  /* ---- Touch --------------------------------------------------------- */
  --tap-min: 2.75rem;  /* 44px — 손가락으로 누를 수 있는 최소 크기 (Apple HIG / WCAG) */

  /* ---- Shape & Motion ------------------------------------------------ */
  --radius-sm:   0.375rem;  /*  6px */
  --radius-md:   0.75rem;   /* 12px */
  --radius-pill: 999rem;
  --duration: 160ms;
  --ease: cubic-bezier(0.2, 0, 0, 1);

  /* ---- Breakpoints (참고용) -----------------------------------------
     CSS 변수는 @media 조건 안에서 쓸 수 없어서, 실제 값은 sections.css의
     @media 줄에 직접 적혀 있음. 바꿀 땐 거기를 고칠 것.
       기본    ~767px   모바일 (1단)
       48em    768px~   태블릿 세로
       64em    1024px~  태블릿 가로 / 작은 노트북
       80em    1280px~  데스크톱
       96em    1536px~  큰 화면 (콘텐츠 폭 고정, 여백만 늘어남)
     ※ @media 에는 rem 대신 em을 씀 — 브라우저 확대 시 Safari에서도
       일관되게 동작하는 단위. 값은 rem과 같음 (1em = 16px). */
}

/* ---- Color : 다크 -------------------------------------------------------
   OS 설정이 다크모드면 자동 적용. 색 토큰만 바꾸면 나머지는 따라옴. */
@media (prefers-color-scheme: dark) {
  :root {
    --color-bg:          #111113;
    --color-surface:     #1a1a1d;
    --color-text:        #ececee;
    --color-text-muted:  #a0a0aa;
    --color-border:      #2c2c31;
    --color-accent:      #8aa6ff;
    --color-accent-text: #0b0b0d;
    --color-focus:       #8aa6ff;
    --color-code-bg:     #1a1a1d;

    color-scheme: dark;
  }
}
