d.ts 작업 흐름

타입 선언 파일 역할

자바스크립트 유틸리티의 실제 export를 확인하고 .d.ts에서 함수, 객체, 전역 타입을 맞춰 선언해야 합니다.

API 관찰

실제 export 확인

라이브러리가 함수 하나를 내보내는지 객체 여러 개를 내보내는지 먼저 봅니다.

module exports
선언 작성

시그니처 번역

함수 인자, 반환값, 객체 속성을 .d.ts에 구현 없이 적습니다.

index.d.ts
사용 연결

import 방식 일치

선언한 모듈 이름과 실제 import 문자열이 같아야 타입이 연결됩니다.

import util
배포 포함

타입 전달

패키지의 types 필드나 파일 배치를 통해 사용자 프로젝트가 선언을 찾게 합니다.

types