.d.ts는 구현 없이 사용할 수 있는 타입 계약만 남긴다

JavaScript 구현은 따로 있고, TypeScript는 .d.ts를 통해 함수와 객체의 사용법을 검사한다.

Runtime JS

실제로 실행되는 구현 파일

.d.ts

값의 타입과 호출 계약만 선언

Consumer

import 후 타입 검사와 자동완성 사용

Drift risk

구현과 선언이 어긋나면 런타임 오류 가능

기준	해석
라이브러리	npm package가 types 필드로 선언 파일 제공
전역 API	ambient declaration으로 이름 설명
핵심	선언 파일은 실행 코드가 아니라 사용 설명서다

핵심 선언 파일은 실행 코드가 아니라 사용 설명서다