프로젝트 레퍼런스 — 모노레포에서 TS 빌드 최적화

my-monorepo/
├── packages/
│   ├── shared/         # 공용 유틸리티
│   │   ├── src/
│   │   └── tsconfig.json
│   ├── api/            # API 서버
│   │   ├── src/
│   │   └── tsconfig.json
│   └── web/            # 프론트엔드
│       ├── src/
│       └── tsconfig.json
└── tsconfig.json       # 루트 설정

// packages/shared/tsconfig.json
{
  "compilerOptions": {
    "composite": true,        // 필수: 프로젝트 레퍼런스에 참여
    "declaration": true,      // 필수: .d.ts 생성
    "declarationMap": true,   // 권장: Go to Definition 지원
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "include": ["src/**/*"]
}

// packages/api/tsconfig.json
{
  "compilerOptions": {
    "composite": true,
    "declaration": true,
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "references": [
    { "path": "../shared" }   // shared 프로젝트를 참조
  ],
  "include": ["src/**/*"]
}

// tsconfig.json (루트)
{
  "files": [],                // 루트는 직접 컴파일할 파일 없음
  "references": [
    { "path": "packages/shared" },
    { "path": "packages/api" },
    { "path": "packages/web" }
  ]
}

# 전체 빌드 — 의존성 순서대로 컴파일
npx tsc --build

# 약자
npx tsc -b

# 변경된 것만 증분 빌드
npx tsc -b

# 깨끗하게 다시 빌드
npx tsc -b --clean
npx tsc -b --force

# 워치 모드
npx tsc -b --watch

첫 빌드: shared → api → web (전체 컴파일)
shared 수정: shared → api → web (shared에 의존하는 것만 재컴파일)
api만 수정: api (api만 재컴파일)

// 참조 프로젝트의 출력을 현재 출력 앞에 붙이기
{
  "references": [
    { "path": "../shared", "prepend": true }
  ]
}

// tsconfig.json — 소스 코드
{
  "compilerOptions": {
    "composite": true,
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "include": ["src/**/*"]
}

// tsconfig.test.json — 테스트 코드
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "composite": true,
    "rootDir": ".",
    "outDir": "./dist-test",
    "types": ["node", "jest"]
  },
  "references": [
    { "path": "./" }  // 소스 프로젝트를 참조
  ],
  "include": ["src/**/*", "tests/**/*"]
}

// tsconfig.json (루트 — solution style)
{
  "files": [],
  "references": [
    { "path": "./tsconfig.app.json" },
    { "path": "./tsconfig.test.json" }
  ]
}