d.ts 파일

d.ts 파일은 c언어의 .h 파일처럼, 함수나 변수의 타입을 명세한 파일이다.

나는 처음에 d.ts 파일이 무슨 역할을 하는지 잘 몰랐고, 왜 필요한건지 궁금했다.
어차피 타입스크립트를 쓰면 개발할때 타입을 다 알려주는데 말이다.

그러다 아래 스택오버플로우에서 반짝이는 해답을 얻었다.
d.ts 파일은 무엇인가요? - stackoverflow

d.ts 파일을 쓰는 큰 이유는, 자바스크립트를 타입스크립트 환경에서 사용하기 위함이였다.
react 나 jquery 같은 js 기반 코드들을 ts 에서 쓰려면, 이미 만들어진 코드들을 다시 ts 로 작성하는게 아니라, d.ts 파일을 사용하면 된다.

d.ts 파일에 함수나 변수의 타입 명세를 적어두면, 타입스크립트를 사용하는 사용자가 js 로 만들어진 함수나 변수의 타입을 알 수 있는 것이다.

개발하다가 종종 node_modules 에서 라이브러리를 까봤었는데, 그때마다 특정 함수의 구현을 보고 싶어도 항상 d.ts 파일에 정의된 타입밖에 안보였던 이유가 이거였다.
함수 구현체는 번들러를 통해서 js 로 번들링 되버리고, d.ts 만 남은것이였다.