reference QA

프로젝트 레퍼런스는 설정 네 곳이 함께 맞아야 한다

생산자는 선언 파일을 만들고, 소비자는 references로 의존하며, 루트 tsconfig는 빌드 순서를 고정해야 합니다.

Composite

참조 가능

의존 대상 프로젝트는 composite true를 가져야 합니다.

Types

선언 산출물

declaration과 declarationMap으로 소비자가 타입을 읽습니다.

Refs

의존 방향

references 배열은 소비자에서 생산자로 향합니다.

경로

경로 일치

tsconfig paths와 번들러 alias가 다른 이름을 가리키지 않아야 합니다.

Root

빌드 조정

루트 tsconfig는 직접 컴파일 대신 하위 프로젝트를 나열합니다.

Cycle

순환 차단

A가 B를, B가 A를 참조하면 빌드 그래프가 깨집니다.

1

생산자 빌드

dist와 .d.ts가 생성되는지 확인합니다.

2

소비자 참조

references path가 실제 폴더를 가리킵니다.

3

루트 실행

tsc -b가 올바른 순서로 빌드합니다.

4

IDE 확인

정의 이동이 선언 맵과 원본으로 이어집니다.

verify: producer composite -> consumer references -> root tsc -b -> bundler alias match
프로젝트 참조 기준

프로젝트 레퍼런스는 타입 경계를 문서화하는 설정입니다. 빌드가 빠른지만 보지 말고 의존 방향이 아키텍처와 맞는지 확인합니다.