feat: batch wikification of Skybound balance pass and scalable frontend architectures

Processed 80+ files including Skybound playtest feedback, Monorepo strategies, and Modern Component Patterns.

10_Wiki/Topics/Frontend_Mastery/CSS Variables.md

@@ -1,27 +1,25 @@
 # [[CSS Variables]]
 
 ## 📌 Brief Summary
-CSS Variables(사용자 지정 속성, Custom Properties)은 JavaScript 없이도 동적인 스타일 제어를 가능하게 하는 모던 CSS의 표준 기능입니다. 과거 Sass와 같은 전처리기(Preprocessor)에 의존해야 했던 변수 기능을 CSS 자체에 내장하여, 런타임 오버헤드를 최소화하면서도 전역적인 테마(Theming) 관리 및 상태 기반 스타일링을 쉽게 만들어 줍니다. 특히 대규모 애플리케이션에서 디자인 토큰을 구현하고 유지보수하기 쉬운 아키텍처를 구축하는 데 핵심적인 역할을 수행합니다.
+CSS Variables(사용자 지정 속성, CSS custom properties)은 React 및 최신 프론트엔드 프로젝트에서 디자인 토큰을 관리하고 동적 테마를 구현하는 데 사용되는 핵심 기반 기술입니다. 이 기술은 애플리케이션 전반에 걸쳐 하드코딩된 스타일 값을 대체하여 디자인의 일관성을 유지하고, 라이트/다크 모드와 같은 테마 전환을 쉽게 만듭니다. 특히 Tailwind CSS v4와 같은 최신 프레임워크나 styled-components와 같은 CSS-in-JS 환경에서 React Server Components(RSC) 호환성 및 런타임 성능 최적화를 달성하기 위한 필수적인 해결책으로 채택되고 있습니다.
 
 ## 📖 Core Content
-* **모던 CSS 표준으로의 진화와 동적 스타일링:**
-  CSS 사용자 지정 속성은 과거 전처리기의 전유물이었던 변수 기능을 표준 CSS에 도입한 주요 개선 사항입니다 [1]. 이를 통해 JavaScript의 개입 없이도 동적인 스타일링이 가능해졌으며, 컨테이너 쿼리와 함께 순수 CSS의 부흥(Renaissance)을 이끄는 핵심 기술로 자리 잡았습니다 [2, 3].
+* **디자인 토큰과 동적 테마(Dynamic Theming)의 핵심:**
+  CSS 변수는 색상, 타이포그래피, 간격 등의 디자인 토큰을 중앙 집중화하여 관리하는 단일 진실 공급원(Single Source of Truth) 역할을 합니다 [1, 2]. Style Dictionary와 같은 도구를 사용해 JSON 형식의 디자인 토큰을 CSS 변수(예: `--color-primary`)로 변환하고 이를 `:root` 레벨에 정의하면, JavaScript의 개입 없이도 기본 테마나 라이트/다크 모드를 동적으로 전환할 수 있습니다 [3-6].
 
-* **디자인 토큰(Design Tokens) 구현의 핵심:**
-  웹 환경에서 디자인 토큰을 코드로 구현할 때 CSS 변수가 적극적으로 활용됩니다 [4]. 효과적인 디자인 시스템을 구축하기 위해 CSS 변수는 주로 3단계 계층 구조를 가집니다 [5].
-  1. **글로벌 토큰 (Primitives):** 컨텍스트 없는 원시 값 (예: `--blue-500: #3b82f6`)
-  2. **별칭/시맨틱 토큰 (Alias):** 의미와 목적을 부여한 값 (예: `--color-primary: var(--blue-500)`)
-  3. **컴포넌트 토큰:** 특정 UI 요소에 종속된 값 (예: `--button-bg: var(--color-primary)`)
-  이와 같이 변수를 참조 연결하는 방식을 통해, 시맨틱 토큰의 값만 교체하여 손쉽게 테마 변경(다크 모드 등)을 적용할 수 있습니다 [6].
+* **Tailwind CSS v4의 CSS 우선(CSS-first) 아키텍처:**
+  Tailwind CSS v4는 기존의 JavaScript 설정 파일(tailwind.config.js)을 제거하고 `@theme` 디렉티브를 사용하여 디자인 토큰을 기본 CSS 변수로 직접 노출합니다 [7-10]. 이를 통해 개발자는 JavaScript 구동 컨텍스트 업데이트 없이 런타임 테마 적용과 타입 안정성(Type Safety)을 확보할 수 있습니다 [10, 11]. 또한, 생성된 정규 CSS 변수는 인라인 스타일이나 임의의 값(arbitrary values)에서 참조할 수 있으며, JavaScript의 `getComputedStyle`을 통해서도 쉽게 접근이 가능합니다 [12-14].
 
-* **유지보수 가능한 모던 아키텍처와의 결합:**
-  글로벌 단위에서 테마 변수를 CSS 사용자 지정 속성으로 관리하고, 개별 컴포넌트의 스타일은 CSS Modules를 통해 격리하는 하이브리드 아키텍처가 효율적인 실무 접근법으로 권장됩니다 [7, 8]. CSS 변수는 CSS Modules와 결합하여 런타임 오버헤드를 최소화하면서도 동적인 스코프 스타일링을 가능하게 합니다 [2]. 
-  또한 CSS Modules 단독으로는 JavaScript의 상태(State) 데이터를 스타일에 직접 주입하기 어렵다는 단점이 존재하는데, CSS 사용자 지정 속성을 인라인으로 전달함으로써 이 한계를 우회할 수 있습니다 [9]. 나아가 Linaria와 같은 Zero-Runtime CSS-in-JS 환경에서는 정적 CSS를 빌드 타임에 추출하고 동적 상태 제어는 CSS 변수에 위임하여 렌더링 성능을 최적화합니다 [10].
+* **styled-components 및 RSC 환경에서의 한계 극복:**
+  React Server Components(RSC) 환경에서는 React Context가 제공되지 않기 때문에, styled-components나 Emotion이 의존하던 `ThemeProvider`를 통한 동적 테마 주입이 작동하지 않습니다 [15-17]. 이를 해결하기 위해 styled-components v6.4+ 에서는 `createTheme` 함수를 도입하여 테마 객체의 모든 리프(leaf) 값을 CSS 변수 참조(`var(--prefix-path)`)로 변환합니다 [18]. 이 접근법을 사용하면 React 컨텍스트 없이도 클라이언트 컴포넌트와 RSC 모두에서 안정적으로 테마를 적용할 수 있습니다 [18].
+
+* **컴포넌트 아키텍처 내에서의 유연한 결합:**
+  정의된 CSS 변수는 인라인 스타일, CSS 모듈, 혹은 styled-components와 같은 CSS-in-JS 라이브러리 내부에서 모두 호환되어 사용 가능합니다 [19]. 이는 특정 스타일링 패러다임에 종속되지 않고 애플리케이션의 시각적 일관성을 유지할 수 있도록 도와줍니다 [19, 20].
 
 ## 🔗 Knowledge Connections
-- **Related Topics:** [[Design Tokens]], [[CSS Modules]], [[Zero-Runtime CSS-in-JS]]
-- **Projects/Contexts:** [[Design Systems]], [[Frontend Architecture]]
-- **Contradictions/Notes:** 소스에 따르면 CSS 사용자 지정 속성은 SCSS와 같은 기존 전처리기의 정적 변수나, 런타임 단계에서 스타일을 주입하는 기존 CSS-in-JS가 지닌 성능 저하 문제를 동시에 극복할 수 있는 이상적인 대안으로 평가받습니다 [1, 10]. 
+- **Related Topics:** `[[Design Tokens]]`, `[[Dynamic Theming]]`, `[[Tailwind CSS v4]]`, `[[React Server Components (RSC)]]`, `[[Styled Components]]`
+- **Projects/Contexts:** `[[Next.js App Router]]` (RSC 환경 도입으로 인한 CSS-in-JS의 한계 및 CSS 변수를 활용한 테마 관리 체계로의 전환 맥락 [15-17]), `[[Figma Design System Integration]]` (Figma에서 정의된 토큰을 CSS 변수로 변환하여 자동화된 워크플로우를 구축하는 프로젝트 환경 [21-23])
+- **Contradictions/Notes:** 기존 CSS-in-JS 라이브러리(styled-components, Emotion)는 런타임에 JavaScript로 스타일을 생성하여 컴포넌트 수준의 강력한 동적 스타일링을 제공했으나 렌더링 성능과 RSC 호환성에서 단점이 존재했습니다. 최근에는 런타임 오버헤드가 없는 정적 빌드타임 CSS 변수(Tailwind CSS v4, vanilla-extract) 기반 접근법이 규모가 큰 프로덕션 환경에서 더욱 선호되는 추세입니다 [16, 17, 24-26].
 
 ---
 *Last updated: 2026-04-26*