이 가이드는 고품질의 TypeScript 선언 파일을 작성하는 방법을 알려주기 위해 작성되었습니다.

이 가이드는, TypeScript 언어에 대한 기본 지식이 있다고 가정합니다. 만약 기본 지식이 없다면, TypeScript 핸드북을 반드시 읽고 기본 개념, 특히 타입과 모듈에 익숙해져야 합니다.

섹션 (Sections)

이 가이드는 다음 섹션들로 구성됩니다.

라이브러리 구조 (Library Structures)

라이브러리 구조는 일반적인 라이브러리 포맷과 각 포맷에 대한 올바른 선언 파일을 작성하는 방법에 대해 알려줍니다. 기존 파일을 수정하는 경우라면, 이 섹션을 읽으실 필요는 없습니다. 새로운 선언 파일을 작성해야 한다면 라이브러리의 포맷이 선언 파일 작성에 어떻게 영향을 미치는지 올바르게 이해하기 위해 반드시 읽어야 합니다.

예제를 통해 (By Example)

많은 경우, 기본 라이브러리 예제만 있을 때, 선언 파일을 작성해야 합니다. 예제를 통해 섹션은 많은 API 패턴들과 각 패턴들의 선언을 작성하는 방법을 보여줍니다. 이 가이드는 TypeScript의 모든 언어 구성에 아직 익숙하지 않은 TypeScript 초심자에 초점을 맞추고 있습니다.

해야 할 것과 하지 말아야 할 것 (“Do”s and “Don’t”s)

선언 파일의 많은 실수들은 쉽게 피할 수 있습니다. 해야 할 것과 하지 말아야 할 것 섹션은 흔한 오류들을 식별하고, 감지하는 방법과, 수정하는 방법을 설명합니다. 흔한 실수들을 피하기 위해 반드시 모두가 이 섹션을 읽어야 합니다.

깊게 들어가기 (Deep Dive)

선언 파일이 동작하는 메커니즘에 관심 있는 숙련된 사용자들에게, 깊게 들어가기 섹션은 선언 작성의 많은 고급 개념을 설명해 주고, 이 개념들을 활용하여 깔끔하고 더 직관적인 선언 파일을 만드는 방법을 보여줍니다.

템플릿 (Templates)

템플릿에서는 새로운 파일을 작성할 때, 유용한 시작점을 제공하는 여러 선언 파일들을 찾을 수 있습니다. 라이브러리 구조 문서를 참고하여 어떤 템플릿 파일을 사용할지 알아보세요.

npm에 배포하기 (Publish to npm)

배포 섹션은 선언 파일을 npm 패키지에 배포하는 방법과, 의존성 패키지를 관리하는 방법을 설명합니다.

선언 파일을 찾고 설치하기 (Find and Install Declaration Files)

JavaScript 라이브러리 사용자를 위해, 소비 섹션은 해당 선언 파일을 찾고 설치하는 몇 가지 간단한 방법을 제공합니다.