isolatedDeclarations — 선언 파일 생성 속도 혁신

// utils.ts
export function add(a: number, b: number) {
  return a + b; // 반환 타입을 추론해야 .d.ts를 생성할 수 있음
}

// app.ts
import { add } from './utils';
export const result = add(1, 2); // add의 반환 타입을 알아야 result의 타입을 추론

// tsconfig.json
{
  "compilerOptions": {
    "isolatedDeclarations": true,
    "declaration": true
  }
}

// ❌ isolatedDeclarations에서 에러
export function add(a: number, b: number) {
  return a + b;
  // Error: 반환 타입을 명시해야 합니다
  // (다른 파일 참조 없이 이 파일만으로 .d.ts를 생성할 수 없으므로)
}

// ✅ 반환 타입을 명시
export function add(a: number, b: number): number {
  return a + b;
}

// ❌ 타입 추론에 의존하는 export
export const config = { host: 'localhost', port: 3000 };
// Error: 타입을 명시하거나 as const를 사용해야 합니다

// ✅ 타입 명시
export const config: { host: string; port: number } = { host: 'localhost', port: 3000 };
// 또는
export const config = { host: 'localhost', port: 3000 } as const;

// ✅ 표기 불필요 — 이 파일만으로 타입을 알 수 있음
export const name = 'hello';           // 'hello' 리터럴
export const count: number = 42;       // 명시적 표기
export type User = { name: string };   // 타입 선언

// ❌ 표기 필요 — 추론에 다른 파일이 필요할 수 있음
export function getUser(id: number) { // 반환 타입이 없음
  return { id, name: 'test' };
}

// ✅ 수정
export function getUser(id: number): { id: number; name: string } {
  return { id, name: 'test' };
}

기존: 전체 프로젝트 타입 체크 → .d.ts 생성 (순차적, 단일 스레드)

isolatedDeclarations:
  파일 1 → .d.ts  ┐
  파일 2 → .d.ts  ├→ 병렬 실행 가능!
  파일 3 → .d.ts  ┘

// tsconfig.json — 단계적 적용
{
  "compilerOptions": {
    "isolatedDeclarations": true,
    "declaration": true,
    "declarationMap": true,
    "strict": true
  }
}

{
  "rules": {
    "@typescript-eslint/explicit-function-return-type": "error"
  }
}

{
  "compilerOptions": {
    "isolatedModules": true,        // 파일 단위 트랜스파일 가능
    "isolatedDeclarations": true    // 파일 단위 .d.ts 생성 가능
  }
}