.d.ts 파일 작성법

.d.ts 타입 표면

자바스크립트 라이브러리나 전역 값처럼 구현은 따로 있지만 타입 정보가 없는 대상을 TypeScript가 이해하도록 선언합니다.

필요성

타입 정보 점검

레거시 자바스크립트나 외부 라이브러리를 안전하게 쓰기 위해 공개 API의 타입을 적습니다.

.d.ts
declare

구현 없는 선언

실제 값은 어딘가에 존재한다고 가정하고 타입 형태만 컴파일러에 전달합니다.

declare
공개 API 선언 구조

공개 API 중심

내부 구현이 아니라 외부 사용자가 호출하는 함수, 객체, 모듈 형태를 기준으로 작성합니다.

declare function
위치

컴파일러 포함

tsconfig include, typeRoots, 패키지 구조에 맞춰 선언 파일이 프로젝트에 잡히게 해야 합니다.

typeRoots