Declaration Files

타입 선언은 놓이는 위치에 따라 역할이 달라집니다

같은 .d.ts라도 모듈 옆에 붙는지, 전역 값을 선언하는지, 패키지 산출물로 배포되는지에 따라 TypeScript가 읽는 경로가 달라집니다.

1

모듈 옆 선언

StringUtils.js와 같은 위치에 선언 파일을 두면 import 경로와 타입 시그니처가 직접 연결됩니다.

StringUtils.d.ts
2

전역 선언

브라우저 전역 값이나 레거시 스크립트는 최상위 declare var와 interface Window로 점검합니다.

global.d.ts
3

배포용 선언

라이브러리는 declaration으로 선언 파일을 만들고 types 필드로 소비자가 읽을 타입 위치를 가리킵니다.

dist/index.d.ts