[G1-Sync] Manual knowledge update

10_Wiki/Topics/Coding/React_Component_Composition.md

@@ -0,0 +1,96 @@
+---
+id: react-component-composition
+title: 컴포넌트 합성 (Composition over Configuration)
+category: Coding
+status: draft
+source_trust_level: B
+verification_status: conceptual
+created_at: 2026-05-09
+updated_at: 2026-05-09
+tags: [react, composition, children, slots, vibe-coding]
+tech_stack: { language: "TypeScript / React 18+", applicable_to: ["Web", "React Native"] }
+applied_in: []
+aliases: [render props, compound components, slot pattern]
+---
+
+# 컴포넌트 합성 (Composition)
+
+> 새 옵션 props 추가가 답답해지면 멈춰라. **자식이 직접 채우게 하는 합성**이 prop 폭발보다 거의 항상 낫다. boolean prop 30개 컴포넌트는 anti-signal.
+
+## 📖 핵심 개념
+3가지 합성 패턴:
+1. **Children pass-through**: `{children}` 받아 가운데에 끼움
+2. **Slot props (named children)**: `header` / `footer` 등 이름 있는 영역
+3. **Compound components**: `<Tabs><Tab/><Tab/></Tabs>` 같이 부모 + 자식 협력
+
+## 💻 코드 패턴
+
+### Children pass-through
+```tsx
+function Card({ children }: { children: ReactNode }) {
+  return <div className="card-shell">{children}</div>;
+}
+<Card><h2>Title</h2><p>body</p></Card>
+```
+
+### Slot props
+```tsx
+function Modal({ title, body, actions }: { title: ReactNode; body: ReactNode; actions: ReactNode }) {
+  return <div className="modal">
+    <header>{title}</header>
+    <section>{body}</section>
+    <footer>{actions}</footer>
+  </div>;
+}
+<Modal title="삭제" body="정말?" actions={<><button>취소</button><button>삭제</button></>} />
+```
+
+### Compound components
+```tsx
+const TabsContext = createContext<{ active: string; setActive: (k: string) => void } | null>(null);
+
+function Tabs({ defaultActive, children }: ...) {
+  const [active, setActive] = useState(defaultActive);
+  return <TabsContext.Provider value={{ active, setActive }}>{children}</TabsContext.Provider>;
+}
+function TabList({ children }) { return <div role="tablist">{children}</div>; }
+function Tab({ id, children }: { id: string; children: ReactNode }) {
+  const ctx = useContext(TabsContext)!;
+  return <button onClick={() => ctx.setActive(id)} aria-selected={ctx.active === id}>{children}</button>;
+}
+function TabPanel({ id, children }) {
+  const ctx = useContext(TabsContext)!;
+  return ctx.active === id ? <div>{children}</div> : null;
+}
+
+Tabs.List = TabList; Tabs.Tab = Tab; Tabs.Panel = TabPanel;
+
+<Tabs defaultActive="a">
+  <Tabs.List><Tabs.Tab id="a">A</Tabs.Tab><Tabs.Tab id="b">B</Tabs.Tab></Tabs.List>
+  <Tabs.Panel id="a">…</Tabs.Panel><Tabs.Panel id="b">…</Tabs.Panel>
+</Tabs>
+```
+
+## 🤔 의사결정 기준
+| 상황 | 패턴 |
+|---|---|
+| 단순 wrapper (border, padding) | children |
+| 정해진 레이아웃, 영역 의미 다름 | slot props |
+| 부모-자식 상태 공유 (Tabs, Accordion, Menu) | compound components |
+| 외부에서 마음대로 조립 가능해야 | render props 또는 hook 노출 |
+| 옵션이 5개 이상의 boolean prop | composition 으로 리팩터 |
+
+## ❌ 안티패턴
+- **boolean prop 폭발**: `<Button primary danger small loading rounded outlined ... />`. variant prop 도입 또는 합성.
+- **자식 종류 검사 후 강제** (`children.type === Tab`): 깨지기 쉬움. Context 기반 통신.
+- **render props 남발**: hook 으로 충분한데 함수 prop 일렬. hook 권장.
+- **slot 인데 ReactNode 가 아닌 string 받기**: 유연성 손실. 보통 ReactNode.
+- **Compound 인데 Context 없이 구현**: prop drilling 또는 imperative 검사.
+
+## 🤖 LLM 활용 힌트
+- "이 컴포넌트의 prop 가 5개 이상 boolean 이면 합성으로" 강조.
+- compound 패턴은 ARIA 속성도 같이 챙겨야 — accessibility 검토 명시.
+
+## 🔗 관련 문서
+- [[React_Custom_Hook_Patterns]]
+- [[React_Refs_Patterns]]