선언 파일과 생태계 타입

기본 패턴

npm install -D @types/node

설명

• 선언 파일(.d.ts)은 런타임 구현 없이 타입 정보만 담는 TypeScript 전용 파일입니다.
• 많은 라이브러리는 패키지 안에 타입을 직접 포함하고, 그렇지 않은 경우 @types/... 패키지로 별도 제공되기도 합니다.
• 그래서 TypeScript 프로젝트에서 외부 라이브러리를 쓸 때는 "실행 코드"와 함께 "타입 정의가 있는가"도 확인해야 합니다.
• 선언 파일 덕분에 JavaScript로 작성된 라이브러리도 TypeScript 프로젝트에서 자동완성과 타입 검사를 받을 수 있습니다.
• 실무에서는 직접 .d.ts를 자주 쓰지 않더라도, 타입을 못 찾는 오류를 이해하려면 이 생태계 구조를 아는 편이 중요합니다.

짧은 예제

import fs from "node:fs";

const content = fs.readFileSync("data.txt", "utf8");

npm install -D @types/node

빠른 정리

주의할 점