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

This commit is contained in:
2026-04-20 14:26:57 +09:00
commit f4e731b115
2141 changed files with 63988 additions and 0 deletions
@@ -0,0 +1,35 @@
---
id: P-REINFORCE-AUTO-A211EA
category: "[[10_Wiki/💡 Topics/Programming & Language]]"
confidence_score: 0.90
tags: [auto-reinforced]
last_reinforced: 2026-04-20
github_commit: "[P-Reinforce] Continuous Worker - TypeScript Advanced Type System"
---
# [[TypeScript Advanced Type System]]
## 📌 한 줄 통찰 (The Karpathy Summary)
> TypeScript의 고급 타입 시스템은 구조적 타이핑(Structural Typing)을 기반으로 하면서도, 개발자가 코드의 예측 가능성과 안정성을 극대화할 수 있도록 돕는 강력한 도구 모음입니다 [1-3]. 이 시스템은 집합론에 기반하여 타입을 값들의 집합으로 다루며, 컴파일 시점에 런타임 에러를 방지합니다 [3-5]. 식별 가능한 유니온, 브랜디드 타입, `readonly` 수식어, 그리고 `satisfies` 연산자 등의 고급 기능을 통해 복잡한 비즈니스 로직을 안전하게 모델링할 수 있습니다 [6-10].
## 📖 구조화된 지식 (Synthesized Content)
- **집합론 기반의 타입 체계 (Set Theory Basis):** TypeScript의 타입은 가능한 값들의 집합으로 취급됩니다 [3-5]. 유니온(`|`)과 인터섹션(`&`)은 각각 집합의 합집합과 교집합을 의미하며, `extends` 키워드는 한 타입이 다른 타입의 부분집합(subset)임을 나타냅니다 [5, 11-14]. `never`는 어떠한 값도 가질 수 없는 공집합을 뜻하고, `unknown`은 모든 JavaScript 값을 포함하는 전체 집합(Universe)을 의미합니다 [5, 14, 15].
- **구조적 타이핑과 과잉 속성 체크 (Structural Typing & EPC):** 객체의 형태가 일치하면 호환성을 인정하는 '덕 타이핑(Duck Typing)' 방식을 사용합니다 [1-3]. 단, 객체 리터럴이 변수에 직접 할당되거나 함수의 인수로 전달될 때는 '과잉 속성 체크(Excess Property Checking)'가 발동하여 선언되지 않은 잉여 속성의 유입을 엄격하게 차단합니다 [3, 16-20].
- **식별 가능한 유니온과 완전성 검사 (Discriminated Unions & Exhaustiveness):** 객체가 가질 수 있는 여러 형태를 공통된 리터럴 속성(태그)을 기준으로 안전하게 좁혀내는(Narrowing) 패턴입니다 [6, 21-23]. `switch` 문과 공집합인 `never` 타입을 함께 활용하면, 유니온에 새로운 타입이 추가될 때 컴파일러가 누락된 처리 로직을 잡아내는 완전성 검사(Exhaustiveness Checking)가 가능해져 런타임 에러를 원천 차단합니다 [11, 23-26].
- **브랜디드/오패크 타입 (Branded/Opaque Types):** 구조적으로 동일한 원시 타입(예: `UserId`용 문자열과 `OrderId`용 문자열)을 구별하기 위해, 런타임에는 존재하지 않는 가상의 속성(예: `__brand`)이나 고유 심볼(unique symbol)을 교집합으로 묶어 명목적 타이핑(Nominal Typing)을 흉내 냅니다 [7, 27-31]. 이를 통해 의미론적으로 다른 데이터가 무분별하게 섞이는 것을 컴파일 수준에서 방지합니다 [7, 31].
- **불변성 확립 (`readonly`):** 객체 속성이나 배열을 수정 불가능하게 만듭니다 [8, 32-34]. 런타임 오버헤드가 있는 `Object.freeze()`나 변수 재할당만 막는 `const`와 달리, 컴파일 타임에 철저한 제어를 수행합니다 [34-37]. 매핑된 타입과 조건부 타입을 결합하면 중첩 객체까지 보호하는 `DeepReadonly` 구현이 가능합니다 [10, 38, 39].
- **`satisfies` 연산자:** 타입 단언(`as`)의 불안정성을 극복하기 위한 연산자입니다. 객체가 특정 타입의 요구사항을 충족하는지 검사하면서도, 타입을 넓히지(Widening) 않고 구체적인 리터럴 타입 형태를 그대로 유지하도록 돕습니다 [9, 40-43].
## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
- **과거 데이터와의 충돌:** 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
- **정책 변화:** Programming & Language 분야의 자동 자산화 수행.
## 🔗 지식 연결 (Graph)
- **Related Topics:** [[Structural Typing]], [[Discriminated Unions]], [[Branded Types]], [[Readonly Modifier]], [[Satisfies Operator]]
- **Projects/Contexts:** [[Large-scale Application Architecture]], [[Domain-Driven Design (DDD)]]
- **Contradictions/Notes:** 인터페이스(Interface)와 타입 별칭(Type Alias)의 사용 기준에 대해 개발자 간 선호도 차이가 있습니다. 일부는 일관성을 위해 Type만을 선호하기도 하지만 [44], TypeScript 공식 성능 가이드와 주요 문헌에서는 타입 관계 캐싱 및 선언 병합(Declaration Merging)의 장점 때문에 객체 구조를 확장할 때는 인터페이스(`extends`)를 우선적으로 사용할 것을 권장합니다 [45-49]. 또한, 복잡한 타입 분기 처리를 돕는 외부 라이브러리(ts-pattern 등)의 도입을 두고 단순한 제어문(`if`, `switch`) 대비 성능 오버헤드와 가독성 측면에서 의견 대립이 존재합니다 [50-52].
---
*Last updated: 2026-04-18*
- Raw Source: [[00_Raw/2026-04-20/TypeScript Advanced Type System.md]]
---