Declaration Files

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

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

선언 파일 역할

타입 경계

declare

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

declare module

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

types 필드

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

JS가 실행된다 실제 동작은 .js 파일의 코드가 맡는다.
.d.ts가 모양을 적는다 값과 함수의 타입 표면만 선언한다.
import가 연결한다 사용 코드는 구현을 쓰면서 타입 정보를 함께 받는다.
컴파일러가 검사한다 실행 전 API 사용 오류를 먼저 잡는다.
선언 계약

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