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

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

@@ -0,0 +1,37 @@
+---
+id: P-REINFORCE-AUTO-C17DEE
+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에서 변수가 가질 수 있는 여러 넓은 타입(예: 유니온 타입)을 특정 코드 블록 내에서 더 구체적인 타입으로 범위를 좁혀나가는 과정입니다 [1, 2]. 조건문과 같은 런타임 동작을 기반으로 제어 흐름 분석(Control flow analysis)을 수행하여 컴파일러가 타입을 안전하게 추론하게 만듭니다 [2]. 이를 통해 개발자는 런타임 에러를 방지하고, IDE의 자동 완성과 타입 안전성을 극대화할 수 있습니다 [3].
+
+## 📖 구조화된 지식 (Synthesized Content)
+- **제어 흐름 분석(Control Flow Analysis):** TypeScript는 런타임 타입 검사 코드를 이해하여 제어 흐름에 따라 변수의 타입을 좁힙니다. 예를 들어, `if (typeof x === 'string')` 조건문이 있는 블록 내부에서는 `x`가 자동으로 `string` 타입으로 취급됩니다 [2].
+- **기본 타입 가드(Type Guards):** 
+  - `typeof` 연산자: `number`, `string`, `boolean`, `symbol`과 같은 원시 타입의 범위를 좁힐 때 사용합니다 [2, 4].
+  - `instanceof` 연산자: 우측에 생성자 함수를 두어 해당 객체의 프로토타입 타입을 좁힙니다 [2, 4].
+  - 기타 방식: 동등성 검사(equality checks)나 `in` 연산자를 사용하여 객체가 특정 속성을 가지고 있는지 확인함으로써 타입을 좁힐 수도 있습니다 [2, 5].
+- **식별 가능한 유니온(Discriminated Unions) 기반 좁히기:** 유니온 타입의 각 멤버들이 공유하는 특정 리터럴 속성(판별자, Discriminator)을 기준으로 타입을 좁히는 강력한 패턴입니다 [6, 7]. `switch`문 등을 사용하여 판별자 속성의 값을 검사하면, TypeScript는 유니온을 구성하는 여러 타입 중 해당하는 특정 타입만 남기고 나머지를 배제합니다 [3, 8, 9].
+- **사용자 정의 타입 가드(Type Predicates):** 매개변수가 특정 타입인지 확인하는 로직을 별도의 함수로 분리할 때 사용합니다 [10]. 런타임에는 불리언(boolean) 값을 반환하지만, 반환 타입에 명시적인 타입 조건(예: `value is Positive`)을 작성해두면 타입 시스템이 이를 인지하고 타입 좁히기를 적용합니다 [10].
+- **타입 좁히기의 중요성 및 `satisfies` 연산자:** 유니온 타입의 값에서 특정 타입만의 고유 속성에 접근하려면 반드시 좁히기 과정을 먼저 거쳐야 안전합니다 [1]. 추가적으로, `satisfies` 연산자를 활용하면 유니온 타입 객체를 할당할 때 판별자의 리터럴 타입을 일반화(widening)시키지 않고 보존할 수 있어 안전한 타입 좁히기를 유지할 수 있습니다 [11].
+
+## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
+- **과거 데이터와의 충돌:** 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
+- **정책 변화:** Programming & Language 분야의 자동 자산화 수행.
+
+## 🔗 지식 연결 (Graph)
+- **Related Topics:** [[식별 가능한 유니온(Discriminated Unions)]], [[타입 가드(Type Guards)]], [[유니온 타입(Union Types)]]
+- **Projects/Contexts:** [[상태 관리 및 API 응답 모델링(State Management and API Response Modeling)]]
+- **Contradictions/Notes:** 소스 상에서 타입 좁히기 자체에 대한 모순된 주장은 존재하지 않습니다. 다만, 타입 좁히기를 통한 검증 과정을 생략하고 타입 단언(`as`)을 사용하여 강제로 타입을 캐스팅하는 방식은 런타임 타입 안전성을 보장하지 못하며 초과 속성 검사(Excess Property Checking)를 무력화할 수 있어 지양해야 한다는 점이 강조됩니다 [2, 12, 13].
+
+---
+*Last updated: 2026-04-18*
+- Raw Source: [[00_Raw/2026-04-20/타입 좁히기(Type Narrowing).md]]
+---