값의 출처
전역 객체인지, npm 모듈인지, 로컬 JS 파일인지에 따라 선언 형태가 달라집니다.
기존 값 타입 선언
선언 파일을 쓰기 전에는 런타임 값의 출처, 노출 스코프, 컴파일러 포함 경로가 맞는지 먼저 정리합니다.
선언 스코프
최상위 export가 있으면 모듈 선언, 없으면 전역 선언으로
읽힐 수 있습니다.
포함 경로
include, typeRoots, 패키지
types가 선언 파일을 실제로 보게 해야 합니다.
구현 코드를 옮기지 말고 외부에 공개된 함수, 클래스, 객체의 모양만 적습니다.
사용 코드에서 자동완성, 오류 위치, import 경로가 의도와 맞는지 확인합니다.
선언 파일은 타입을 많이 쓰는 파일이 아니라 런타임 API와 타입 설명 사이의 거리를 가장 짧게 만든 파일입니다.