declaration files

.d.ts 선언 파일 역할

선언 파일은 구현 코드를 담지 않고 이미 존재하는 JavaScript 값과 모듈의 타입 모양을 TypeScript에 전달합니다.

declare

이미 존재함을 알림

런타임에 값이 있다고 가정하고 그 값의 타입만 컴파일러에 설명합니다.

declare const $
모듈 선언

패키지 타입 설명

타입이 없는 라이브러리나 자산 import에 대한 모듈 형태를 선언합니다.

declare module "*.css"
전역 선언

글로벌 API 점검

브라우저 전역 변수나 외부 스크립트가 제공하는 값을 타입으로 설명합니다.

declare global
검색 위치

tsconfig와 package types

include, typeRoots, package.json types 필드가 선언 파일 발견에 영향을 줍니다.

types: "index.d.ts"
구현 금지 선언 파일에는 실제 함수 본문이 아니라 시그니처만 둡니다.
경로 일치 declare module 이름은 import에서 쓰는 문자열과 맞아야 합니다.
포함 여부 작성한 .d.ts가 tsconfig include 범위 안에 있는지 확인합니다.

선언 파일을 읽을 수 있으면 타입이 없는 JavaScript와 TypeScript 프로젝트 사이의 경계를 안전하게 다룰 수 있습니다.