Files

T

koriweb d8a80f6272 chore(wiki): dangling 링크 canonical 정규화 (768파일/1200건)

이름만 다른(표기 변형) [[위키링크]]를 대상 문서의 canonical 제목으로 치환해
끊겼던 1,200개 링크를 연결. 제목/파일명 정규화 일치만 적용하고 별칭 매칭은
과병합 위험으로 제외(애매성 가드). 원본은 _link_reconcile_backup/ 에 백업.
도구: Datacollect/scripts/link_reconcile_apply.mjs

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-08 12:24:15 +09:00

4.6 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by, tech_stack

title

선언 병합(Declaration Merging)

📌 한 줄 통찰 (The Karpathy Summary)

선언 병합(Declaration Merging)은 TypeScript에서 동일한 이름을 가진 여러 개의 인터페이스를 선언할 경우, 컴파일러가 이를 자동으로 하나의 단일 인터페이스로 합치는 고유한 기능입니다 [1]. 주로 라이브러리 제작자가 사용자에게 타입 확장 지점을 제공하거나 패치할 때 유용하게 사용되지만, 일반 애플리케이션 코드에서는 의도치 않은 타입 병합을 막기 위해 사용을 지양하는 경우도 많습니다 [2-4].

📖 구조화된 지식 (Synthesized Content)

동작 원리: TypeScript에서 인터페이스(Interface)를 동일한 이름으로 여러 번 선언하면, 타입 시스템이 이를 하나의 인터페이스로 합칩니다 [1].
주요 사용 사례 (라이브러리 수준): 이 기능은 특히 라이브러리 코드에서 진가를 발휘합니다 [4]. 라이브러리 소비자가 필요에 따라 기존 선언을 확장(extend)하거나 타입을 패치(patch)할 수 있도록 유용한 확장 지점을 제공하기 때문입니다 [1, 3, 4].
타입 별칭(Type Alias)과의 차이점: 인터페이스와 달리, 타입 별칭(Type)은 동일한 이름으로 재선언할 수 없으므로 선언 병합이 발생하지 않습니다 [1]. 이러한 특징 덕분에 타입 별칭을 사용하면 예기치 않은 병합을 방지하고 더 엄격하게 타입을 관리할 수 있습니다 [1, 5].
개발자 커뮤니티의 관점 및 주의점: 많은 개발자와 팀은 의도치 않은 선언 병합을 피하고자 애플리케이션 코드 내에서 인터페이스 대신 타입 별칭을 사용하는 방식을 채택합니다 [2, 6]. 호환되지 않는 필드를 가진 두 형태가 우연히 합쳐질 때 발생할 수 있는 오류를 피하기 위해, 선언 병합을 나쁜 관행(Bad Thing™)으로 간주하고 이를 방지하고자 린트(eslint) 규칙으로 인터페이스 사용을 금지하는 사례도 있습니다 [7, 8].

⚠️ 모순 및 업데이트 (Contradictions & Updates)

과거 데이터와의 충돌: 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
정책 변화: Design & Experience 분야의 자동 자산화 수행.

🔗 지식 연결 (Graph)

Related Topics: , 타입 별칭 (Type Alias)
Contradictions/Notes: 소스에 따르면 라이브러리 제작 관점에서는 소비자에게 확장을 허용하는 매우 유용한 기능으로 평가받지만 [1, 4], 애플리케이션 개발 팀 관점에서는 의도치 않은 병합 버그를 유발할 수 있어 피해야 할 기능으로 강하게 반대되기도 합니다 [2, 8].

Last updated: 2026-04-18

Raw Source: 00_Raw/2026-04-20/선언 병합(Declaration Merging).md

🤖 LLM 활용 힌트 (How to Use This Knowledge)

언제 이 지식을 쓰는가:

(TODO)

언제 쓰면 안 되는가:

(TODO)

🧪 검증 상태 (Validation)

정보 상태: needs_review
출처 신뢰도: A
검토 이유: (P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)

🧬 중복 검사 (Duplicate Check)

기존 유사 문서: (TODO: 인덱서 클러스터 리포트 참조)
처리 방식: UPDATE (자동 정규화)
처리 이유: Phase 1 정규화 — 옛 템플릿/누락 필드 보강.

🕓 변경 이력 (Changelog)

날짜	변경 내용	처리 방식	신뢰도
2026-05-08	P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화)	UPDATE	A

💻 코드 패턴 (Code Patterns)

패턴 1: (TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)

# TODO

🤔 의사결정 기준 (Decision Criteria)

선택 A를 써야 할 때:

(TODO)

선택 B를 써야 할 때:

(TODO)

기본값:

(TODO)

❌ 안티패턴 (Anti-Patterns)

[안티패턴]: (TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)

4.6 KiB Raw Blame History