docs: finalized wiki integrity maintenance (v3.0 standard) - pruned 1400+ stubs and fixed 11k+ ghost links
This commit is contained in:
Antigravity Agent
@@ -1,5 +1,5 @@
|
||||
---
|
||||
id: [[P-Reinforce]]-AUTO-18CC73
|
||||
id: [[P-Reinforce|P-Reinforce]]-AUTO-18CC73
|
||||
category: "10_Wiki/💡 Topics/Design & Experience"
|
||||
confidence_score: 0.90
|
||||
tags: [auto-reinforced]
|
||||
@@ -7,7 +7,7 @@ last_reinforced: 2026-04-20
|
||||
github_commit: "[P-Reinforce] Continuous Worker - 선언 병합(Declaration Merging)"
|
||||
---
|
||||
|
||||
# [[선언 병합(Declaration Merging)]]
|
||||
# [[선언 병합(Declaration Merging)|선언 병합(Declaration Merging]]
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
> 선언 병합(Declaration Merging)은 TypeScript에서 동일한 이름을 가진 여러 개의 인터페이스를 선언할 경우, 컴파일러가 이를 자동으로 하나의 단일 인터페이스로 합치는 고유한 기능입니다 [1]. 주로 라이브러리 제작자가 사용자에게 타입 확장 지점을 제공하거나 패치할 때 유용하게 사용되지만, 일반 애플리케이션 코드에서는 의도치 않은 타입 병합을 막기 위해 사용을 지양하는 경우도 많습니다 [2-4].
|
||||
@@ -15,8 +15,8 @@ github_commit: "[P-Reinforce] Continuous Worker - 선언 병합(Declaration Merg
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
* **동작 원리**: TypeScript에서 인터페이스(Interface)를 동일한 이름으로 여러 번 선언하면, 타입 시스템이 이를 하나의 인터페이스로 합칩니다 [1].
|
||||
* **주요 사용 사례 (라이브러리 수준)**: 이 기능은 특히 라이브러리 코드에서 진가를 발휘합니다 [4]. 라이브러리 소비자가 필요에 따라 기존 선언을 확장(extend)하거나 타입을 패치(patch)할 수 있도록 유용한 확장 지점을 제공하기 때문입니다 [1, 3, 4].
|
||||
* **타입 별칭([[Type Alias]])과의 차이점**: 인터페이스와 달리, 타입 별칭(Type)은 동일한 이름으로 재선언할 수 없으므로 선언 병합이 발생하지 않습니다 [1]. 이러한 특징 덕분에 타입 별칭을 사용하면 예기치 않은 병합을 방지하고 더 엄격하게 타입을 관리할 수 있습니다 [1, 5].
|
||||
* **개발자 커뮤니티의 관점 및 주의점**: 많은 개발자와 팀은 의도치 않은 선언 병합을 피하고자 애플리케이션 코드 내에서 인터페이스 대신 타입 별칭을 사용하는 방식을 채택합니다 [2, 6]. 호환되지 않는 필드를 가진 두 형태가 우연히 합쳐질 때 발생할 수 있는 오류를 피하기 위해, 선언 병합을 나쁜 관행(Bad Thing™)으로 간주하고 이를 방지하고자 린트([[ESLint]]) 규칙으로 인터페이스 사용을 금지하는 사례도 있습니다 [7, 8].
|
||||
* **타입 별칭([[Type Alias|Type Alias]])과의 차이점**: 인터페이스와 달리, 타입 별칭(Type)은 동일한 이름으로 재선언할 수 없으므로 선언 병합이 발생하지 않습니다 [1]. 이러한 특징 덕분에 타입 별칭을 사용하면 예기치 않은 병합을 방지하고 더 엄격하게 타입을 관리할 수 있습니다 [1, 5].
|
||||
* **개발자 커뮤니티의 관점 및 주의점**: 많은 개발자와 팀은 의도치 않은 선언 병합을 피하고자 애플리케이션 코드 내에서 인터페이스 대신 타입 별칭을 사용하는 방식을 채택합니다 [2, 6]. 호환되지 않는 필드를 가진 두 형태가 우연히 합쳐질 때 발생할 수 있는 오류를 피하기 위해, 선언 병합을 나쁜 관행(Bad Thing™)으로 간주하고 이를 방지하고자 린트([[ESLint|ESLint]]) 규칙으로 인터페이스 사용을 금지하는 사례도 있습니다 [7, 8].
|
||||
|
||||
## ⚠️ 모순 및 업데이트 (Contradictions & RL Update)
|
||||
- **과거 데이터와의 충돌:** 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
|
||||
|
||||
Reference in New Issue
Block a user