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

2026-04-20 14:26:57 +09:00
commit f4e731b115
2141 changed files with 63988 additions and 0 deletions
@@ -0,0 +1,47 @@
+---
+id: P-REINFORCE-AUTO-844A65
+category: "[[10_Wiki/💡 Topics/Design & Experience]]"
+confidence_score: 0.90
+tags: [auto-reinforced]
+last_reinforced: 2026-04-20
+github_commit: "[P-Reinforce] Continuous Worker - TypeScript의 인터페이스 및 객체 타입 설계"
+---
+
+# [[TypeScript의 인터페이스 및 객체 타입 설계]]
+
+## 📌 한 줄 통찰 (The Karpathy Summary)
+> TypeScript의 인터페이스와 객체 타입 설계는 명시적인 이름이 아닌 객체의 실제 형태와 속성을 기준으로 타입 호환성을 결정하는 구조적 타이핑(Structural Typing)을 근간으로 합니다. 확장성과 컴파일 성능을 고려하여 인터페이스(Interface)와 타입 별칭(Type Alias)을 전략적으로 선택해야 하며, `readonly` 수식어, 초과 속성 검사(Excess Property Checking), `satisfies` 연산자 등의 도구를 활용해 런타임 오류를 방지하고 견고하고 예측 가능한 객체 경계를 구축하는 것이 설계의 핵심입니다.
+
+## 📖 구조화된 지식 (Synthesized Content)
+**구조적 타이핑 (Structural Typing) 메커니즘**
+TypeScript의 객체 타입은 명목적 타이핑(Nominal Typing)과 달리 명시적인 상속 선언 없이도 객체가 가진 속성과 메서드의 "구조"가 일치하면 동일한 타입으로 간주하는 덕 타이핑(Duck Typing) 방식을 따릅니다 [1-3]. 예를 들어, 객체 타입 `{}`는 단순히 빈 객체를 의미하는 것이 아니라 "속성에 접근할 수는 있으나 특정 속성을 강제하지 않는 값"의 집합을 의미합니다 [4]. 이러한 구조적 타이핑은 유연성을 제공하지만, 의도하지 않은 데이터가 객체에 유입될 위험이 있어 세심한 타입 설계가 필요합니다 [3, 5].
+
+**인터페이스(Interface)와 타입 별칭(Type Alias)의 전략적 선택**
+객체의 형태를 정의할 때 인터페이스와 타입 별칭은 각기 다른 성능과 확장성 특성을 가집니다.
+*   **성능과 캐싱**: TypeScript 컴파일러는 인터페이스를 처리할 때 해당 이름을 기준으로 타입 관계를 캐싱하여 재사용합니다 [6-8]. 반면 타입 별칭을 통한 교집합(`&`) 연산은 매번 객체의 구조를 평탄화하고 계산해야 하므로 대규모 프로젝트에서는 컴파일 성능을 저하시킬 수 있습니다 [7-9]. 따라서 객체 확장 시에는 교집합 대신 인터페이스의 `extends`를 사용하는 것이 성능상 권장됩니다 [7, 9, 10].
+*   **선언 병합(Declaration Merging)과 관리**: 인터페이스는 동일한 이름으로 여러 번 선언하면 하나의 인터페이스로 합쳐지는 선언 병합을 지원하여, 라이브러리 제작자가 사용자에게 확장 지점을 제공할 때 유용합니다 [11, 12]. 그러나 핵심 비즈니스 로직에서는 예기치 않은 병합으로 인한 오류를 방지하기 위해 타입 별칭을 선호하는 방식도 유효하며, 이를 적절히 이원화하여 사용하는 전략이 필요합니다 [12-14].
+
+**초과 속성 검사(EPC)와 `satisfies` 연산자를 통한 경계 방어**
+*   **초과 속성 검사 (Excess Property Checking)**: 객체 리터럴을 직접 할당하거나 함수 인자로 전달할 때 대상 인터페이스에 정의되지 않은 초과 속성이 포함되는 것을 차단하는 기능입니다 [3, 15]. 이는 오타나 잘못된 속성 전달을 컴파일 시점에 포착하게 해줍니다 [16, 17]. 하지만 변수에 먼저 선언 및 할당한 후 전달하면 구조적 타이핑의 "최소 요건 충족" 원칙에 따라 이 검사가 작동하지 않는 한계가 있습니다 [5, 18, 19].
+*   **`satisfies` 연산자 도입**: 이러한 한계를 극복하기 위해 `satisfies` 연산자를 활용할 수 있습니다. `satisfies`는 객체가 특정 인터페이스를 만족하는지 엄격히 검사하면서도, 타입 단언(`as`)이나 명시적 어노테이션(`:`)과 달리 객체가 가진 구체적인 리터럴 속성 타입과 추가된 속성에 대한 추론 정보를 잃지 않게 유지해 줍니다 [20-22].
+
+**선택적(Optional) 속성과 불변성(Immutability) 설계**
+*   **선택적 속성 (`?`)**: 인터페이스 내에서 불확실하거나 조건부로 존재하는 데이터를 모델링할 때 사용되며, 내부적으로는 `undefined`와의 유니온 타입으로 처리되어 타입 안전성을 제공합니다 [23, 24].
+*   **읽기 전용 속성 (`readonly`)**: 런타임 오버헤드 없이 컴파일 시점에 객체 속성의 수정을 금지하여 불변성을 보장합니다 [25-27]. 단, `readonly`는 해당 속성 자체에 대한 얕은(shallow) 보호만 제공하므로, 중첩된 객체 구조 전체를 보호해야 할 때는 재귀적 타입(DeepReadonly) 패턴을 구성해 활용해야 합니다 [28, 29]. 
+
+**객체지향 설계 원칙(SOLID)의 반영**
+거대한 인터페이스 하나에 너무 많은 책임을 부여하면 시스템이 변경에 취약해집니다 [30, 31]. 인터페이스 분리 원칙(Interface Segregation Principle)을 적용하여, 클라이언트가 실제로 사용하는 기능에만 의존하도록 인터페이스를 작게 나누고 이를 합성(Composition)하여 사용하는 것이 유연하고 견고한 설계의 핵심입니다 [12, 30, 32].
+
+## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
+- **과거 데이터와의 충돌:** 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
+- **정책 변화:** Design & Experience 분야의 자동 자산화 수행.
+
+## 🔗 지식 연결 (Graph)
+- **Related Topics:** [[구조적 타이핑 (Structural Typing)]], [[초과 속성 검사 (Excess Property Checking)]], [[선언 병합 (Declaration Merging)]], [[satisfies 연산자]]
+- **Projects/Contexts:** [[대규모 TypeScript 애플리케이션 아키텍처 구축]], [[SOLID 원칙 기반의 타입 시스템 설계]]
+- **Contradictions/Notes:** 소스 간 의견 대립이 존재합니다. 일부 개발자(소스 52, 138, 141)는 캐싱 성능 최적화와 외부 확장을 위한 선언 병합 기능 때문에 '인터페이스(Interface) 우선 사용'을 강력히 주장하지만, 또 다른 현업 개발자(소스 138, 140, 147)는 의도치 않은 선언 병합으로 인해 런타임 로직이 오염될 위험과 일관된 문법을 이유로 '모든 상황에서 타입 별칭(Type)만을 사용하는 규칙'을 조직 내에 강제하는 것이 장기 유지보수에 유리하다고 반박합니다.
+
+---
+*Last updated: 2026-04-18*
+- Raw Source: [[00_Raw/2026-04-20/TypeScript의 인터페이스 및 객체 타입 설계.md]]
+---