선언 파일 작업 흐름

작성한 .d.ts가 실제 코드까지 이어지는 흐름

선언 파일은 작성만으로 끝나지 않습니다. JavaScript 구현, import 경로, 컴파일러 포함 범위, 배포 메타데이터가 같은 API를 가리키는지 확인해야 합니다.

1

구현 확인

StringUtils.js가 실제로 내보내는 함수와 값 이름을 먼저 적습니다.

2

선언 작성

각 함수의 매개변수, 반환 타입, null 가능성을 구현 동작에 맞춰 선언합니다.

3

경로 맞춤

declare module 문자열과 실제 import 문자열이 같은지 비교합니다.

4

포함 확인

include 또는 패키지 구조 안에 선언 파일이 들어와야 타입스크립트가 읽습니다.

5

배포 연결

types 필드가 npm 소비자가 읽을 대표 선언 파일을 가리키게 둡니다.

검증 질문

잘못된 인자를 넘겼을 때 편집기와 tsc가 같은 오류를 보여주나요?

빌드 산출물의 JS 구현과 .d.ts 선언이 같은 공개 API를 설명하나요?