Declaration Files

.d.ts는 구현 없는 타입 설명서다

JavaScript 런타임 코드를 TypeScript가 이해하도록 공개 API의 모양만 선언한다.

선언 파일 역할

타입 경계

declare

이미 존재하는 전역 값이나 함수의 타입 모양을 알려준다.

declare module

외부 패키지의 모듈 이름과 내보내는 API 타입을 묶는다.

types 필드

패키지 진입점에서 선언 파일 위치를 컴파일러에 연결한다.

JS 코드타입 선언import검사
선언 계약

선언 파일은 구현을 대신하지 않는다. 실행은 JS가 맡고, .d.ts는 편집기와 컴파일러가 보는 계약이다.