전역 값
declare var, declare function,
interface Window로 script 태그가 만든 값을 설명합니다.
declaration file
선언 파일은 값의 출처에 맞춰 고릅니다
.d.ts는 구현을 만들지 않고 이미 존재하는 JavaScript 값의 타입 표면만 설명합니다. 먼저 값이 전역인지, 모듈인지, 파일 에셋인지, 배포 산출물인지 구분합니다.
패키지 모듈
declare module 'pkg' 안에서 named export와 default
export를 실제 API에 맞춥니다.
파일 확장자
번들러 파일 import 결과 타입을 정합니다.
배포 선언
types 필드가 소비자 프로젝트에서 읽을 대표
.d.ts 위치를 가리킵니다.
구현을 쓰지 않습니다
함수 본문이나 초기화 코드는 선언 파일에 두지 않고 시그니처와 구조만 남깁니다.
공개 표면만 적습니다
내부 구현 세부사항보다 실제 사용자가 import하거나 전역에서 접근하는 이름을 우선합니다.
컴파일러가 읽어야 합니다
include, typeRoots, 패키지 메타데이터 안에
선언 파일이 들어오는지 확인합니다.