모듈 경계

타입스크립트 모듈 경계 점검표

모듈을 나눌 때는 런타임 값 의존성과 타입 전용 의존성을 분리해야 번들 결과와 순환 참조를 예측하기 쉽습니다.

런타임 경계

value

실행되는 값을 가져온다

함수, 클래스, 상수는 실제 JavaScript import로 남습니다.

effect

초기화만 수행한다

사이드 이펙트 import는 실행 순서와 전역 변경을 따로 기록합니다.

타입 경계

type

컴파일 때만 필요하다

import type을 쓰면 런타임 의존성을 늘리지 않습니다.

barrel

재내보내기 경계를 둔다

배럴 파일은 공개 API를 모으되 순환 import가 생기는지 확인합니다.