Initial Commit: Reinforced Knowledge Wiki v1.0 - Pure Origin

Programming & Language/타입 좁히기 (Type Narrowing).md

@@ -0,0 +1,42 @@
+---
+id: P-REINFORCE-AUTO-4245C8
+category: "[[10_Wiki/💡 Topics/Programming & Language]]"
+confidence_score: 0.90
+tags: [auto-reinforced]
+last_reinforced: 2026-04-20
+github_commit: "[P-Reinforce] Continuous Worker - 타입 좁히기 (Type Narrowing)"
+---
+
+# [[타입 좁히기 (Type Narrowing)]]
+
+## 📌 한 줄 통찰 (The Karpathy Summary)
+> 타입 좁히기(Type Narrowing)는 TypeScript에서 유니온 타입과 같이 여러 타입의 가능성을 내포하는 변수를 다룰 때, 코드 흐름 분석(Code Flow Analysis)을 통해 더 구체적이고 한정된 타입으로 줄여나가는 과정입니다 [1, 2]. 이를 통해 컴파일러는 특정 코드 블록 내에서 값의 형태를 확신할 수 있게 되며, 개발자는 특정 타입에만 존재하는 속성에 안전하게 접근할 수 있습니다 [2-4]. 주로 `typeof`, `instanceof`, `in` 연산자 또는 사용자 정의 타입 가드 및 판별자(Discriminant)를 활용하여 수행됩니다 [5, 6].
+
+## 📖 구조화된 지식 (Synthesized Content)
+**타입 좁히기의 목적 및 작동 원리**
+TypeScript의 타입 검사는 값의 런타임 형태(구조)에 기반하며, 코드 제어 흐름 분석을 통해 타입을 추론합니다 [2, 7]. 값이 여러 타입 중 하나일 수 있을 때(예: `string | number`), 해당 타입에 고유한 메서드나 속성을 사용하기 위해서는 사전에 타입 좁히기를 수행해야 합니다 [2, 8]. 
+
+**타입을 좁히는 주요 기법**
+* **내장 타입 가드 (Built-in Type Guards):** 
+  `typeof`, `instanceof`, 동등성 검사(equality checks), `in` 연산자 등을 사용하여 제어문에서 조건을 검사하면, TypeScript는 내부적으로 이를 인식하고 블록 내부의 변수 타입을 자동으로 좁혀줍니다 [2, 5, 6]. 예를 들어 `typeof x === 'string'` 조건문 블록 내부에서 `x`는 `string` 타입으로 취급됩니다 [2].
+* **사용자 정의 타입 서술어 (Type Predicates / Custom Type Guards):**
+  특정 타입인지 검사하는 로직이 복잡할 경우, 반환 타입에 `is` 키워드를 사용하는 함수를 정의할 수 있습니다 [6, 9]. 함수가 `true` 혹은 `false`를 반환하는 결과에 따라 TypeScript의 타입 시스템이 매개변수의 타입을 좁히게 됩니다 [6, 9].
+* **식별 가능한 유니온 (Discriminated Unions / Tagged Unions):**
+  유니온을 구성하는 각 객체 타입이 공유하는 공통 리터럴 속성(판별자)을 두는 기법입니다 [3, 10, 11]. `switch`문이나 `if`문으로 이 판별자를 검사하여 타입을 좁히면, 타입 시스템은 해당 블록 안에서 객체의 타입을 안전하게 한 가지로 확정해줍니다 [12-14]. 이는 런타임 타입 검사의 부담을 줄이고 에러 처리와 상태 관리에 매우 효과적입니다 [14].
+
+**보조 연산자의 활용**
+TypeScript의 `satisfies` 연산자를 식별 가능한 유니온과 함께 사용하면, 객체가 특정 타입 구조를 만족하는지 검사하면서도 판별자의 리터럴 타입(Literal Type)을 보존해 주어 올바른 타입 좁히기가 원활하게 이루어지도록 돕습니다 [15].
+
+## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
+- **과거 데이터와의 충돌:** 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
+- **정책 변화:** Programming & Language 분야의 자동 자산화 수행.
+
+## 🔗 지식 연결 (Graph)
+- **Related Topics:** [[유니온 타입 (Union Types)]], [[식별 가능한 유니온 (Discriminated Unions)]], [[타입 가드 (Type Guards)]], [[타입 서술어 (Type Predicates)]]
+- **Projects/Contexts:** [[제어 흐름 분석 (Control Flow Analysis)]], [[API 응답 및 상태 모델링 (State Modeling and API Responses)]]
+- **Contradictions/Notes:** 타입 서술어(Type Predicates)를 사용하여 타입을 좁힐 때, TypeScript 컴파일러는 함수 내부의 로직이 개발자가 의도한 브랜드 타입이나 좁히기 조건과 실제로 일치하는지까지는 검사하지 않고 전적으로 코드 작성자의 논리에 의존하므로 주의가 필요합니다 [9].
+
+---
+*Last updated: 2026-04-18*
+- Raw Source: [[00_Raw/2026-04-20/타입 좁히기 (Type Narrowing).md]]
+---